Agent Plan

Live agent task plan. Pro · AI chat and agents › Agents and reasoning

An agent's live plan: steps and sub-steps with status, timings, collapsible logs, approval gates that pause the run, and a segmented progress summary.

Installation

npx valyro-cli@latest login
npx valyro-cli@latest add agent-plan

npm install valyro-ui-pro

import 'valyro-ui-pro/styles.css';
import { AgentPlan } from 'valyro-ui-pro';

Props

Prop	Type	Default
`steps` *	`AgentPlanStep[]`		Steps in run order, each with a status; nested `substeps` are counted in place of their parent.
`title`	`ReactNode`		Heading. Defaults to `labels.title`.
`startedAt`	`DateInput`		When the run started: the header counts up while steps remain.
`duration`	`number`		Total run time in ms once finished.
`onApprove`	`(stepId: string) => void`		Approval gates show Approve / Reject when these are given.
`onReject`	`(stepId: string) => void`		Called with the step id when Reject is clicked at a `needs-approval` step.
`onRetry`	`(stepId: string) => void`		Adds Retry to failed steps.
`open`	`boolean`		The step list is shown. Default true.
`defaultOpen`	`boolean`	`true`	Initial `open` when uncontrolled.
`onOpenChange`	`(open: boolean) => void`		Called with the new `open` when it changes.
`openLogs`	`string[]`		Ids of steps whose logs are shown.
`defaultOpenLogs`	`string[]`	`[]`	Initial `openLogs` when uncontrolled.
`onOpenLogsChange`	`(ids: string[]) => void`		Called with the new `openLogs` when it changes.
`locale`	`string`		BCP 47 locale for timings; defaults to the ThemeProvider's.
`labels`	`Partial<AgentPlanLabels>`		Overrides for the built-in English text; keys left out keep their defaults.

Related components

Chain of Thought — Model reasoning steps
Tool Call — Tool call with approval
Agent Trace Timeline — Agent steps as a waterfall: time, tokens, cost, inputs and outputs with secrets redacted
Agent Approval Gate — Agent action approval: risk, diff, explicit consent and a decision log
Memory Panel — What the assistant remembers
AI Chat Window — AI chat window
Chat Message — Messages with streaming output
Message Branches — Message versions and a conversation branch tree
Streaming Text — Smooth token streaming
Markdown Preview — Rendered Markdown
Response Feedback — Answer rating and a rubric for reviewers
Prompt Composer — Prompt field with attachments

Previous: Tool Call · Next: Agent Trace Timeline · All AI chat and agents