YuhuanStudioYunUIDocs
AI

Agent Run Status

A layout-stable live surface for the one activity an agent is doing now — a shimmering label with a pulsing dot trio, announced politely.

A layout-stable live surface for the one activity an agent is doing right now — "Reading files", "Running tests", "Writing response" — with a shimmering label and a pulsing dot trio. It is announced politely to assistive tech via role="status" / aria-live.

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

tsx
1import { AgentRunStatus } from "@yuhuanowo/yunui/ai";

Basic

Basic

Thinking…

Phases

phase is a semantic hint the host maps its runtime state onto — thinking, acting, observing, reflecting, responding, waiting. The waiting phase defaults active to false, freezing the motion while the layout stays put.

Phases

Reading files…
Reviewing the results…
Writing response…
Waiting for approval

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
activebooleanphase !== "waiting"Keeps the row layout stable while disabling decorative motion.
label*stringRuntime-owned summary of the one activity currently in progress.
phase"thinking" | "acting" | "observing" | "reflecting" | "responding" | "waiting"thinking

On this page