# AgentTaskList

Ordered agent task plan with status, summaries, and controlled detail disclosures.

Use AgentTaskList for a consumer-owned execution plan. Keep each closed task on one scan line when content fits, with visible status text. Wrap long content in narrow containers. Preserve blocked and failed tasks until the plan changes.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `announcement` | `string` | prop | No | `undefined` | No additional description. |
| `emptyMessage` | `string` | prop | No | `undefined` | No additional description. |
| `expandedIds` | `string[]` | binding | No | `[]` | No additional description. |
| `headingLevel` | `1 \| 2 \| 3 \| 4 \| 5 \| 6` | prop | No | `2` | Heading level for the list label. Nested headings use the next level, capped at 6. |
| `label` | `string` | prop | Yes | - | No additional description. |
| `onExpandedIdsChange` | `(ids: string[]) => void` | callback | No | `undefined` | No additional description. |
| `tasks` | `readonly AgentTask[]` | prop | Yes | - | 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.