# AI Agent Run Trace

Agent debug panel showing reasoning, tool calls with input/output, and the final response.

- id: `ai-agent-run-trace`
- Page: https://agentic-ui-kit.com/components/ai-agent-run-trace
- Live preview: https://agentic-ui-kit.com/live/component/ai-agent-run-trace

## Install

```bash
agentic-ui add ai-agent-run-trace
npx shadcn@4.17.0 add @agentic-ui/ai-agent-run-trace
```

## Metadata

- **Level:** feature
- **Category:** feature
- **Installable in:** Radix UI (registry variant new-york)
- **Capabilities:** step-timeline, thought-tool-result-steps, collapsible-steps, kind-filter, roving-keyboard-navigation, live-announcement, run-summary, step-retry, run-error-state, empty-state, streaming-steps, reduced-motion
- **Intents:** orchestrate-agents, audit-trail, monitor-live, explore-detail
- **Suits domains:** ai-agents, ai-workspace, devtools, operations, analytics
- **Interaction:** expand-collapse, filter, keyboard-navigation, live-announcement, retry
- **Screen role:** detail
- **Density:** medium
- **Dark mode:** yes
- **Use it for:** agent debug panel showing reasoning, tool calls with input/output, and the final response, live run that receives steps via streaming and announces each new step, post-mortem audit of a failed run with retry of the tool step that failed, filter only the tool calls of a long run
- **Avoid when:** a single tool call with no run context (use ai-tool-call-card), only the agent state is needed (use ai-agent-status-badge), HTTP logs/system events with no agent semantics (use devtools-event-log), several agents in parallel with messages between them (use ai-multi-agent-view)
- **Preserve when adapting:** thought-tool-result-grammar, ordered-timeline-semantics, single-tab-stop-roving-focus, status-text-not-colour-only, change-only-announcements
- **Replace when adapting:** domain-copy, step-fixtures, token-tints
- **Adaptation effort:** low
- **Coupling:** low
- **Quality score:** 8.7/10
- **Quality breakdown:** visual 8/10, responsive 8/10, accessibility 9/10, code 9/10
- **Uses primitives:** badge, button
- **npm dependencies:** @agentic-ui/ai-tool-call-card, @agentic-ui/ai-agent-status-badge
- **Motion:** profile subtle, library css, reduced-motion fallback yes
- **Registry dependencies:** ai-agent-status-badge, ai-tool-call-card, lib-primitives