AmbientAgentStatus
stableNon-intrusive background activity indicator. Shows agents working without demanding attention. Three variants: dot (toolbar), strip (bottom bar), tray (collapsible side panel).
import { AmbientAgentStatus } from "@nodus/design-system/patterns"Props
| Prop | Type | Default | Description |
|---|---|---|---|
agentsreq | AmbientAgent[] | — | Agents and their current background activity state. |
variant | "dot" | "strip" | "tray" | "tray" | Display variant — dot for toolbar, strip for bottom bar, tray for collapsible side panel. |
dismissAfterMs | number | 3000 | Auto-dismiss completed agents after this delay. 0 disables auto-dismiss. |
maxVisible | number | 3 | Max agents shown before collapsing to overflow count. |
position | AmbientPosition | "bottom-right" | Viewport position when using fixed variants. 'inline' renders in flow. |
onExpand | () => void | — | Called when user clicks to expand/view details. |
agentsrequiredAmbientAgent[]Default —Agents and their current background activity state.
variant"dot" | "strip" | "tray"Default "tray"Display variant — dot for toolbar, strip for bottom bar, tray for collapsible side panel.
dismissAfterMsnumberDefault 3000Auto-dismiss completed agents after this delay. 0 disables auto-dismiss.
maxVisiblenumberDefault 3Max agents shown before collapsing to overflow count.
positionAmbientPositionDefault "bottom-right"Viewport position when using fixed variants. 'inline' renders in flow.
onExpand() => voidDefault —Called when user clicks to expand/view details.
This component was designed to express:
Explore Related
Three-surface agent identity signal — inline @mention chip, card with capabilities, full sidebar panel. Encodes role, execution state, and approval-gated capabilities using semantic tokens.
Multi-user + agent co-presence indicator. Visually distinguishes humans (round avatars) from agents (square monograms). Shows execution state, ghost presence, and typed participant counts.
In-progress LLM reasoning indicator with temporal pulse, elapsed timer, and optional chain-of-thought trace
Colored dot indicating idle, active, pending, error, or completed state