Agentic control
Agent status
Use when the agent runs for more than a few seconds and people need to know what it is doing and how to stop or steer it.
Live status pill with rolling phases, a stop control, and a mid-run redirect.
Part of Agentic control. The stage where the agent stops answering and starts doing. It covers the whole handover: agreeing what the agent may do, watching it work, stepping in, and checking what changed afterwards. Reach for these as soon as an action touches a customer, money or a record.
Do
- Name the current phase in words the user would use, such as Drafting replies.
- Keep Stop and Redirect beside the status at all times during a run.
- Keep progress when the run is stopped, and say so.
Don't
- Don't show a bare spinner. A status with no words tells the user nothing.
- Don't make redirecting mean starting again. A note should re-plan from where the agent is.
- Don't leave the pill animating once the agent is waiting on the user.
States
- Working: An animated orb, the current phase, a step count and an elapsed clock. Stop and Redirect sit to the right.
- Stopped: A grey dot and a line saying progress was kept. The clock pauses and Stop becomes Resume.
- Redirecting: A note field opens under the pill. Send is disabled until something is typed.
- Re-planning: After a note is sent, the pill runs the redirect phases with a new step count.
- Waiting on you: An amber spark and a line saying what needs a look. The clock stops.
- Done: A green dot and a line saying what was finished. The controls are removed.
Usage
import { AgentStatusPattern } from "./halaska-kit";
<AgentStatusPattern
phases={["Reading new threads…", "Matching to HubSpot…", "Drafting replies…"]}
waitingLabel="Waiting on you · 2 replies need a look"
onPause={() => agent.pause()}
onResume={() => agent.resume()}
onRedirect={(note) => agent.redirect(note)}
/>
AgentStatusPattern props
phases(string | { label: string, orb?: "pulse" | "orbit" | "sweep" | "globe" | "spark" })[](default AGENTSTATUS_MAIN_PHASES): Main working phases, shown in order (default: AGENTSTATUS_MAIN_PHASES with orbit → globe → sweep orbs)redirectPhases(string | { label: string, orb?: "pulse" | "orbit" | "sweep" | "globe" | "spark" })[](default AGENTSTATUS_REDIRECT_PHASES): Phases run after a redirect note is sent (default: AGENTSTATUS_REDIRECT_PHASES with globe → sweep orbs)waitingLabelstring(default "Waiting on you · 2 replies need a look"): Pill text once the main cycle ends and the agent needs the user (default: "Waiting on you · 2 replies need a look")pausedLabelstring(default "Stopped · progress kept"): Pill text while stopped (default: "Stopped · progress kept")doneLabelstring(default "Done · replies redrafted to your note"): Pill text once the redirect cycle finishes (default: "Done · replies redrafted to your note")phaseMsnumber(default 1800): Milliseconds per phase (default: 1800)contextLabelstring | ((step: number, total: number) => string)(default agentstatusContextLabel): Footer line under the pill (default: (step, total) => `Alpha · step ${step} of ${total}`)redirectPlaceholderstring(default "Tell Alpha what to do instead…"): Placeholder for the redirect note input (default: "Tell Alpha what to do instead…")autoplayboolean(default true): Cycle phases on mount; false renders the waiting state immediately and a redirect jumps straight to done (default: true)onPause() => void: Fires when the user stops the run (the control reads Stop)onResume() => void: Fires when the user resumesonRedirect(note: string) => void: Fires with the trimmed note when the user sends a redirectonWaiting() => void: Fires when the main cycle ends and the agent needs the useronDone() => void: Fires when the redirect cycle finishes
Built from
Button, Field, Orb, Stack, Typography
Related patterns
Halaska UI · Components · Patterns · Screens · Install