# AgentSteering

Queue a note for a running agent’s next step without stopping it, and see whether each note was applied.

- **Use it for**: Changing what a running agent does next without cancelling it.
- **Not for**: Starting a new run or answering a question the agent asked. Try [PromptInput](https://unseenui.com/components/prompt-input/), [ClarificationRequest](https://unseenui.com/components/clarification-request/).

## Installation

```bash
npm install @stackunseen/ui
```

## Usage

```tsx
import { AgentSteering } from '@stackunseen/ui/conversation-flow';
import '@stackunseen/ui/styles.css';
import '@stackunseen/ui/conversation-flow.css';

<AgentSteering variant="panel" run={run} notes={notes} onSubmit={send} submission={submission} />
```

## All props

| Prop | Type | Description |
| --- | --- | --- |
| `disabledReason` | `string` | Why no note can be sent now, such as "The run has finished". |
| `label` | `string` |  |
| `locale` | `string` |  |
| `maxLength` | `number` |  |
| `notes` (required) | `readonly SteeringNote[]` | Notes the host holds for this run, newest last. |
| `onSubmit` (required) | `(request: SteeringRequest) => void` |  |
| `placeholder` | `string` |  |
| `run` (required) | `Run` |  |
| `submission` | `SubmissionState` | State of the last submission; the composer clears only on acknowledgement. |
| `timeZone` | `string` |  |
| `variant` | `"panel" \| "inline"` |  |

## Keyboard

Tab to the field; Enter in the form sends; the button is disabled while sending.

## Works with

[RunBoard](https://unseenui.com/components/run-board/), [AgentLanes](https://unseenui.com/components/agent-lanes/), [SubagentTree](https://unseenui.com/components/subagent-tree/), [ExecutionTimeline](https://unseenui.com/components/execution-timeline/), [WorkflowGraph](https://unseenui.com/components/workflow-graph/), [AttentionQueue](https://unseenui.com/components/attention-queue/), [RunCompare](https://unseenui.com/components/run-compare/), [ContextBar](https://unseenui.com/components/context-bar/), [Plan](https://unseenui.com/components/plan/), [CostLedger](https://unseenui.com/components/cost-ledger/), [ContextWindowMeter](https://unseenui.com/components/context-window-meter/), [MemoryPanel](https://unseenui.com/components/memory-panel/)

Page: https://unseenui.com/components/agent-steering/
