# ActivityStatus

Compact agent activity status with elapsed time, task progress, and one live announcement.

Use ActivityStatus for one observable operation. Supply visible status text. Let only one owner announce each transition.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `activityId` | `string` | prop | Yes | - | No additional description. |
| `announcement` | `string` | prop | No | `undefined` | Message for the owned live region. An empty value keeps the region mounted without announcing. |
| `elapsed` | `string` | prop | No | `undefined` | No additional description. |
| `label` | `string` | prop | Yes | - | No additional description. |
| `politeness` | `'polite' \| 'assertive'` | prop | No | `'polite'` | No additional description. |
| `progress` | `ActivityProgress` | prop | No | `undefined` | No additional description. |
| `status` | `AgentStatus` | prop | Yes | - | No additional description. |
| `statusLabel` | `string` | prop | Yes | - | No additional description. |

## Related

- [AgentTrace](/docs/components/agent-trace): Controlled disclosure of observable stages, searches, tools, files, and checks.
- [AgentResponse](/docs/components/agent-response): Assistant result with consumer-rendered content, streaming state, sources, actions, and follow-up prompts.
- [ApprovalRequest](/docs/components/approval-request): Explicit approve-or-reject workflow with consequences, optional editing, and separate decision submission.