chore: update docs

docs/python-repl.md

@@ -160,7 +160,7 @@ The runner additionally receives `PYTHONUNBUFFERED=1` and `PYTHONIOENCODING=utf-
 
 If Python preflight fails and `eval.js` is enabled, `eval` remains available for `js` cells; `py` cells fail with a Python-backend availability error.
 
-Python prelude helpers include `agent(prompt, *, agent_type="task", model=None, label=None, schema=None)`. It synchronously calls the host bridge, runs one subagent through the task executor, and returns the final text. When `schema` is supplied, the helper parses the subagent's JSON output and returns the object.
+Python prelude helpers include `agent(prompt, *, agent_type="task", model=None, label=None, schema=None, return_handle=False)`. It synchronously calls the host bridge, runs one subagent through the task executor, and returns the final text. When `schema` is supplied, the helper parses the subagent's JSON output and returns the object. When `return_handle=True`, it instead returns a DAG node dict (`{"text", "output", "handle", "id", "agent"}`) whose `handle` is the spawned agent's recoverable `agent://<id>` URI (the parsed object lands under `"data"` when `schema` is also set), so a downstream `pipeline`/`parallel` stage can reference the transcript by handle instead of re-inlining it.
 
 ## Execution flow and cancellation/timeout
 
@@ -218,7 +218,7 @@ Output is streamed through `OutputSink` and may be persisted to artifact storage
 
 ### Renderer behavior
 
-- Tool renderer (`eval.ts`):
+- Tool renderer (`eval-render.ts`, re-exported from `eval.ts`):
   - shows code-cell blocks with per-cell status
   - collapsed preview defaults to 10 lines
   - supports expanded mode for all output retained in the tool result