# ContextList

Retrieved context records with source metadata, state, and optional open or remove actions.

Use ContextList for a named set of evidence or prompt context. Show source type, location, size, and state when available. Keep open and remove actions explicit. Announce each semantic state change once.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `announcement` | `string` | prop | No | `undefined` | Consumer-owned text for one semantic state change. |
| `empty` | `Snippet` | snippet | No | `undefined` | No additional description. |
| `items` | `readonly ContextItem[]` | prop | Yes | - | No additional description. |
| `label` | `string` | prop | Yes | - | Accessible name for the context list. |
| `onOpen` | `(item: ContextItem) => void` | callback | No | `undefined` | No additional description. |
| `onRemove` | `(item: ContextItem) => void` | callback | No | `undefined` | No additional description. |

## Related

- [ActivityStatus](/docs/components/activity-status): Compact agent activity status with elapsed time, task progress, and one live announcement.
- [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.