event-trace

# Event Trace Build a chronological, annotated event timeline for a single session. ## Input The user provides: **$ARGUMENTS** This is a session ID. It may also be: - `latest` / `last` — trace the most recently updated session - `errors` — trace the most recent session whose status is `error` ## Data Sources | Endpoint | Returns | |----------|---------| | `GET /api/sessions?limit=N` | session list (used to resolve `latest`/`errors` and the target id) | | `GET /api/sessions/:id` | full session detail (status, model, cwd, started_at, ended_at, cost, nested agents + events) | | `GET /api/events?session_id=X` | the ordered event stream: event_type, tool_name, summary, data, timestamp | ## Report Sections ### 1. Resolve the session If `$ARGUMENTS` is a raw id, use it. If `latest`/`last`, call `GET /api/sessions?limit=1`. If `errors`, call `GET /api/sessions?limit=10&status=error` and pick the newest. Confirm the id resolves via `GET /api/sessions/:id`; if not, report it as missing and stop. ### 2. Session header From `GET /api/sessions/:id`: id, status, model, cwd, started_at → ended_at, total duration, cost (USD to 4 decimals), and counts (events, agents). ### 3. Ordered timeline From `GET /api/events?session_id=X`, list every event in timestamp order. One row per event: `| # | time | Δ since prev | event_type | tool_name | summary |` Cover all event types present: SessionStart, PreToolUse, PostToolUse, Stop, SubagentStop, Compaction, APIError, TurnDuration, Notificat...