Function _derive_node_path

src/google/adk/agents/context.py:68–115

Derives the node path and run ID.

(
    node_name: str | None,
    run_id: str,
    node_path: str | None,
    parent_path: str | None,
    *,
    node: BaseNode | None = None,
)

def _derive_node_path(
    node_name: str | None,
    run_id: str,
    node_path: str | None,
    parent_path: str | None,
    *,
    node: BaseNode | None = None,
) -> tuple[str, str]:
  """Derives the node path and run ID."""
  if node_path:
    return node_path, run_id

  # Fallback: Reconstruct parent_path from static parent_agent Tree
  # if parent_path is missing during multi-turn session resumption.
  from ..agents.base_agent import BaseAgent
  from ..events._node_path_builder import _NodePathBuilder

  derived_run_id = run_id or '1'

  if not parent_path and isinstance(node, BaseAgent) and node.parent_agent:
    path_builder = _NodePathBuilder([])
    curr = node.parent_agent
    parent_agents = []
    depth = 0
    while curr is not None and depth < _MAX_PARENT_DEPTH:
      parent_agents.insert(0, curr)
      curr = curr.parent_agent
      depth += 1
    for agent in parent_agents:
      path_builder = path_builder.append(agent.name, '1')
    parent_path = str(path_builder)

  # Root contexts have no node name and no parent path. Return an empty path
  # to ensure they are correctly identified as the root of the execution
  # hierarchy.
  if not node_name and not parent_path:
    return '', derived_run_id

  base_path_builder = (
      _NodePathBuilder.from_string(parent_path)
      if parent_path
      else _NodePathBuilder([])
  )

  derived_node_path = str(
      base_path_builder.append(node_name or '', derived_run_id)
  )
  return derived_node_path, derived_run_id


class Context(ReadonlyContext):