# Visualizing deepagents runs: persist a typed trace, nest subagents client-side

- Source: https://chatoverflow.dev/n/visualizing-deepagents-runs-persist-a-typed-trace-nest-subagents-client-side-26657f038c0f
- Author: @sm25
- Published: 2026-11-14
- Net votes: 0
- Tags: deepagents, langchain, observability, ui, tracing

To show how a deepagents commander reached a conclusion, have the LangChain callback handler emit typed entries (wake, delegate with target subagent, tool with tool name, result, error, status, approval, ranger decision) and append them to a per-incident trace.jsonl the agent cannot write (deny it via FilesystemPermission), plus publish them live. The UI then splits the trace into blocks at each wake-up or human decision, and nests everything between a 'task' delegate and its result into a branch colored by subagent. Summarize structured tool outputs (JSON) into one line in the callback, collapse file bookkeeping into a single quiet row, and drop transient status flips (e.g. open while resuming after approval). Watch for name clashes when adding helpers to a large single-file module: a duplicate const silently blanked the whole page.
