Kanshō/Agent run checklist

Agent run checklist

Nested checklist of steps inside a run. Operator-grade timeline with status icons, sub-steps, durations, token spend, and a 'needs input' state distinct from paused.

Included in the single kansho full pack. Components are not offered as separate installs.

Nested run with mixed states

R-1041 · Compact audit log payloads above 4KB
Success: Pull mission spec from queueorchestrator
0.4s320
Success: Plan: compact audit logclaude-opus-4-7

Decide on hourly aggregation window and validate against staging schema.

8.1s2.8k$0.04
Success: Read schema from stagingpostgres
0.7s
Success: Sketch chunk windowclaude-opus-4-7
1.4s380
Running: Apply compaction migrationpostgres

Run the chunk job against staging and diff row counts.

running 1m12s
Success: Lock target tablepostgres
0.1s
Running: Backfill hourly aggregatespostgres
Pending: Verify row deltas
Needs input: Ask operator to approve production cut-overAvery
Pending: Ship diff to staging warehouse
Skipped: Notify ops channel

Skipped — channel paused during incident window.

Compact density

R-1039 · Vault rotation
Success: Fetch credentials from vault
Failed: Cycle rotation key

Vault returned 503 after 3 retries.

Pending: Notify oncall

Component documentation

Agent Run Checklist

components/control-plane/agent-run-checklist.tsx

Purpose

Shows a hierarchical run checklist with actor, progress, timing, spend, and nested steps.

Appropriate use

Use for read-only execution progress when the run engine supplies the complete tree.

Example

components/control-plane/agent-run-checklist.tsx has a representative live example in the "Nested run with mixed states" section on /components/agent-run-checklist.

States

Statuses are pending, running, success, error, skipped, paused, and needs-input; items can nest recursively and density is comfortable or compact.

API and props

AgentRunChecklist accepts items, density, className, and caption; each item supplies id, label, detail, status, actor, duration, tokens, cost, and children.

Dependencies

Direct imports are React, Lucide icons, Spinner, CostChip, and cn.

Accessibility

The list caption and nested order are visible; every state has a text treatment or labelled loader, and decorative connectors are hidden.

Limitations

It does not execute steps, collapse hierarchy, calculate progress, virtualise deep trees, or validate duplicate ids.

Source

Source: components/control-plane/agent-run-checklist.tsx.

Full pack

components/control-plane/agent-run-checklist.tsx is documented at /components/agent-run-checklist and installs only through the single Kansho full pack; no individual component install is offered.