# Application AI Assistant: Agent Run Trace

Vertical timeline of agent tool steps with status icons, tool badges, mono query detail lines, durations, and a raw log link.

- Page: https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/agent-run-trace
- Collection: [Application](https://www.shadcn-ui-blocks.com/blocks/application-pro), Standard tier
- Group: [AI Assistant](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant)
- Created: 2026-07-04
- Preview image: https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/agent-run-trace.png

## Install

```bash
npx shadcn@latest add @shadcn-ui-blocks/application-pro-ai-assistant-agent-run-trace
```

Needs an API key from a Pro or Team plan: add `@shadcn-ui-blocks` to the registries in components.json with the key as an `Authorization: Bearer` header. Setup: https://www.shadcn-ui-blocks.com/docs/shadcn-cli. The MCP server installs it without the setup: https://www.shadcn-ui-blocks.com/docs/mcp.

## Depends on

- npm packages: class-variance-authority, lucide-react, radix-ui
- shadcn/ui components: badge, button
- Installs to: `@/components/blocks/application-pro/ai-assistant/agent-run-trace`

## About this block

Agent Run Trace is the step-by-step timeline the assistant
shows while it works a request. A vertical rail lists five
steps: interpreted the request, queried renewals, searched
support tickets, cross referenced both result sets, and a
final drafting step still in progress. Each step pairs a
plain language label with a tool badge (Plan, SQL, Search,
Analyze, Compose), a right-aligned duration, and a detail
line; the SQL and Search steps render their exact query in
a scrollable monospace strip. The footer is honest about
depth: every run is logged step by step, and the raw log
holds each query and the exact rows the assistant read.

Steps is one typed array; the status field flips the rail
marker between a filled check and a spinning loader, and the
mono flag swaps the plain detail line for the code strip.
Showing the literal query beside a readable summary is what
lets a reviewer confirm the agent did what it claimed.

## When to use

Reach for this block inline in the conversation while an
agent answers a multi-step question, or in a run detail
drawer opened from a job log. Wire the steps to your agent
event stream so the last row stays in the running state
until the tool call returns.

A natural flow around it on an Application Pro page:

**Before**

- [Prompt composer](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant)

**After**

- [Citations panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant)
- [Activity feed](https://www.shadcn-ui-blocks.com/blocks/application-pro/activity)

## What you can display

One strong use is the live agent reasoning trace. Other
step-timeline shapes:

- **Automation run log.** Workflow steps with a status
  badge and the record each step touched.
- **Deploy pipeline.** Build, test, and release stages
  with per-stage duration and output.
- **Import job trace.** File parse, validate, and write
  steps with a row count on each detail line.

> Tip: keep the running step visible at the bottom so users
> read the agent as working, not stalled.

## More in Application AI Assistant

- [Action Approval Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/action-approval-card)
- [Ai Usage Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/ai-usage-card)
- [Assistant Chat Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/assistant-chat-panel)
- [Assistant Empty State](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/assistant-empty-state)
- [Citations Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/citations-panel)
- [Context Sources Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/context-sources-panel)
- [Conversation History List](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/conversation-history-list)
- [Feedback Thumbs Row](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/feedback-thumbs-row)
- [Guardrails Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/guardrails-panel)
- [Inline Suggestion Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/inline-suggestion-card)
- [Memory Panel](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/memory-panel)
- [Model Picker Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/model-picker-card)
- [Prompt Composer](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/prompt-composer)
- [Prompt Library Grid](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/prompt-library-grid)
- [Response Compare](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/response-compare)
- [Scheduled Agents List](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/scheduled-agents-list)
- [Thread Summary Card](https://www.shadcn-ui-blocks.com/blocks/application-pro/ai-assistant/thread-summary-card)
