broaden graph_name docstring beyond add_node-only case

The namespace segment name is whatever pregel registered the
dispatching node as in the parent scope (`_algo.py:615`/`:988`),
not specifically an `add_node` mount. For a subagent invoked from
inside a tool's body, that's the tool's name; for Send fan-out,
the target node's name.
This commit is contained in:
Nick Hollon
2026-05-08 11:43:04 -04:00
parent 58e0773ec6
commit c6dc0c32c1
@@ -410,11 +410,10 @@ class LifecyclePayload(TypedDict, total=False):
`started → terminal` pair for the same subgraph instance.
"""
graph_name: NotRequired[str]
"""Compiled name of the subgraph (e.g. the `add_node` name in the parent).
Set on `started` when the namespace tail segment carries a `name:id`
split (it does for normally-dispatched subgraphs). Absent if the segment
has no `:` separator.
"""Name of the parent-scope node that dispatched this subgraph
(`add_node` name, surrounding tool's name for in-tool invokes,
`Send` target name, etc.) — parsed from the namespace tail
segment. Absent when the segment has no `:` separator.
"""
parent_task_id: str
"""Pregel task id of the dispatching task — the task whose execution