Kanshō/Run controls

Run control bar

Compact pill that exposes supplied transitions valid for the current run state. Actions without callbacks are omitted; Start and Resume share one Play control.

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

Interactive

state = running
Running

All states

Status-only specimens: no transition callbacks are supplied
idle
Idle
running
Running
paused
Paused
needs_input
Needs input
failed
Failed
complete
Complete

Included components

This page is the canonical destination for these components. All ship in the single Kansho pack.

Run control bar

components/agent/run-control-bar.tsx

Component documentation

Run control bar

components/agent/run-control-bar.tsx

Purpose

Offers only the run controls valid for the current run state.

Appropriate use

Use beside an agent run when the host can enact and visibly reflect every offered transition.

Example

components/agent/run-control-bar.tsx has a representative live example in the "Interactive" section on /components/run-controls.

States

States are idle, running, paused, needs_input, failed, and complete, each with its appropriate subset of actions.

API and props

RunControlBar accepts state, callbacks for start, pause, resume, cancel, retry, reset, and className.

Dependencies

Direct imports are React, Lucide icons, Tooltip, and cn.

Accessibility

Every icon button is a named native control with tooltip text; state is also visible, not conveyed by the pulsing dot alone.

Limitations

It does not enforce a state machine, confirm cancellation, or show pending/error results; omitted callbacks remove their actions.

Source

Source: components/agent/run-control-bar.tsx.

Full pack

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