# Failed Run Triage block

> Failed Agent Run Triage Board with Detail Sheet and Retry Ladder

Triage failed agent runs in a data grid with metric cards, then open a detail sheet tabbed into error, retry attempts, and payload. ReUI Data Grid, Badge, Alert, Timeline; shadcn Sheet, Card, Button, Tabs. Agent ops, error monitoring, run dashboards.

- Type: Pro block
- Category: [Agents](https://web.dev.reui.io/blocks/solutions/agents.md)
- Page: https://web.dev.reui.io/blocks/solutions/agents/solution-agents-7
- MCP: `get_block("solution-agents-7")`
- Built with: Alert, Avatar, Badge, Button, Card, Data Grid, Empty, Field, Input Group, Item, Popover, Progress, Scroll Area, Select, Separator, Sheet, Spinner, Switch, Tabs, Timeline, Tooltip
- Installs with a ReUI Pro or Ultimate license; setup: https://web.dev.reui.io/docs/license-setup

## Best for

Failed runs with a sheet open on the first row, Error, Attempts and Payload tabs, and Retry or Dismiss written back to the row

## Agent notes

- Sample failures live in `FAILED_RUNS` with their `attempts` and `payload` rows in data.tsx, replace them with your run errors
- `handleRetry` and `handleDismiss` only set the row status and fire a `toast`, so call your retry API there
- The detail sheet is open on first render, set `sheetOpen` and `selectedRunId` to start with it closed

## When not to use

- One run opened as a full page with its step trace and editable settings: use [Run Step Trace](https://web.dev.reui.io/blocks/solutions/agents/solution-agents-3.md) (`get_block("solution-agents-3")`)
- Pending agent actions that wait for a human to approve or reject them: use [Action Approval Inbox](https://web.dev.reui.io/blocks/solutions/agents/solution-agents-5.md) (`get_block("solution-agents-5")`)

## Third-party libraries

- TanStack Table v9: [API reference](https://tanstack.com/table/v9/docs/framework/react/reference/index), [docs](https://tanstack.com/table/v9/docs/framework/react/quick-start)
- Sonner v2: [API reference](https://sonner.emilkowal.ski/toast), [docs](https://sonner.emilkowal.ski/getting-started)

## Install

```bash
npx shadcn@latest add @reui/solution-agents-7
```

## About Agents blocks

### When to use

- Run monitoring for a fleet of agents: a live overview, a run queue and failed run triage
- Human review of agent work: an approval inbox, one run's step trace and a nightly evaluation report
- Control pages for agent behavior: tool access, playbooks, run settings and stored memory

### When not to use

- One run narrated live to the person who started it, inside a chat or task view: use the [Agent Activity blocks](https://web.dev.reui.io/blocks/ai-agents/agent-activity.md)
- Model provider routing, prompt reviews, token spend and safety policies for LLM features: use the [AI Ops blocks](https://web.dev.reui.io/blocks/solutions/ai-ops.md)
- An account, workspace, notification or integration page of labeled switches and selects: use the [Settings blocks](https://web.dev.reui.io/blocks/application/settings.md)

### Agent notes

- Every block sets a `min-h-svh` wrapper with its own padding and max width in page.tsx, its root component or both; drop them inside an app shell
- No block mounts the `sonner` toaster, so every `toast` call stays invisible until your layout renders one
- No handler reaches a backend: actions change local `useState` and fire a `toast`, so wire each one to your agent API

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.