dsh-step-trace

dsh-step-trace

Record every step the agent took, and walk through it forwards and backwards to find where it went wrong.

Install

dsh plugin --profile web add dsh-step-trace

Or from source:

dsh plugin --profile web add github:hj01857655/dsh-step-trace

What it does

• Record. Every model response and tool call is stored as a trace step in .replay/<session-id>.jsonl (append-only, one file per session).
• Step through. Inspect the full input and output at each step, forward and backward. Each step carries a timestamp and duration, so you can see where time was spent.
• Branch. Fork a new session from any step — "what if the agent had done X instead?"
• Divergence detection. Given two sessions for the same task, find the first step where they diverge — useful for understanding why a retry gave a different result.
• Session stats. Total steps, total duration, average step latency, and the slowest step per session.
• Panel. Session list with step-through viewer, timeline visualization, and divergence comparator.

CLI

dsh-step-trace list              # list recorded sessions
dsh-step-trace trace <id>        # show all steps in a session
dsh-step-trace step <id> <n>     # inspect step N
dsh-step-trace diverge <a> <b>   # find where two sessions diverge

Panel

A Step trace page inside Settings. The host registers GET /api/step-trace.panel and rebuilds the payload from the replay files on every request. A headless host simply skips the route.

The panel shows:

• Session list sorted by recency, with step count and total duration
• Step-through viewer with full input/output per step
• Timeline visualization showing step durations
• Divergence view comparing two sessions side by side

Layout

Develop

npm ci
npm run typecheck
npm run build
npm test

License

MIT