YuhuanStudioYunUIDocs
AI

Agent Run Status

An accessible host-fed status summary for the current agent phase or completed/failed/cancelled terminal state.

A layout-stable status for the agent's current or terminal phase, announced via role="status" / aria-live. The host supplies the phase and localized label; the component owns only its status presentation and does not advance a run.

It is deliberately separate from Agent Timeline: the status stays in one place for the whole run, while timeline rows accumulate as durable process history. You supply the localized runtime label; YunUI owns the motion and geometry.

Import

tsx1 line
import { AgentRunStatus } from "@yuhuanowo/yunui/ai";

Basic

Basic

Thinking…

Phases

The legacy AgentRunPhase remains thinking, acting, observing, reflecting, responding, and waiting. The phase prop also accepts additive terminal values completed, failed, and cancelled through AgentRunState; terminal states and waiting default to active={false}. The host owns every phase transition and its localized label.

Phases

Reading files…
Reviewing the results…
Writing response…
Waiting for approval
Turn completed
Tool failed

Paused

Pass active={false} at any phase to hold the row still (e.g. the run is suspended) without collapsing it.

Paused

Paused

Props

AgentRunStatus also forwards any <div> HTML attributes.

PropTypeDefaultDescription
activeboolean!["waiting", "completed", "failed", "cancelled"].includes(phase)Keeps the row layout stable while disabling decorative motion.
label*string—Runtime-owned summary of the one activity currently in progress.
phase"thinking" | "acting" | "observing" | "reflecting" | "responding" | "waiting" | "completed" | "failed" | "cancelled"thinking

On this page