From b666b7e4942f7c951954204b3044aa6c585644db Mon Sep 17 00:00:00 2001 From: Alex Clarke Date: Thu, 10 Sep 2026 12:48:53 -0600 Subject: [PATCH] docs(graph): illustrate the inputs map on the example agent node Comment-only block on deep_dive; the example's parsed YAML is unchanged. --- graph.example.yaml | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/graph.example.yaml b/graph.example.yaml index b753765..dbd553f 100644 --- a/graph.example.yaml +++ b/graph.example.yaml @@ -333,6 +333,20 @@ nodes: prompt: | # User message sent to the child (templated) Research {{topic}} in depth. Existing context: {{context}} + # inputs: # Optional. Only valid when `agent` is a GRAPH agent + # max_parallel: "{{n}}" # (has a graph.yaml; deep-research is one). Each value + # context: "Repo: {{r}}" # is a template against THIS graph's state. The resolved + # # map is overlaid on the child's `initial_state` before + # # its graph starts, so the child can read {{max_parallel}} + # # and {{context}} from its first node on. A lone {{key}} + # # keeps the value's JSON type (numbers stay numbers, lists + # # stay lists, null overlays the child's default); mixed text + # # becomes a string. `initial_prompt` is reserved (always + # # seeded from `prompt:`) and is rejected as an input key. + # # `inputs:` on a config-only agent is a load-time error, + # # and `inputs` values count as reads for the cross-branch + # # read check. See the wiki: Graph Agents → "Passing state + # # into a child graph agent (inputs)". timeout: 600 # Optional wall-clock cap, seconds. Default 300. teammates: false # Optional. When true and this node runs concurrently # with other flagged agent nodes (map fan-out branches