# ToolCallList

Controlled tool-call disclosures with status, duration, inputs, output, and changed artifacts.

Use ToolCallList for observable tool activity. Keep each closed row on one scan line when content fits. Wrap long technical values in narrow containers. Show inputs, output, and changed artifacts after expansion. On failure, state whether side effects occurred.

## API

The package declarations define these public members.

| Member | Type | Kind | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `announcement` | `string` | prop | No | `undefined` | No additional description. |
| `calls` | `readonly ToolCall[]` | prop | Yes | - | 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. |

## 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.