Components / AI components / Tools & execution
ToolsExperimental alpha

ToolCall

Make inputs, results and failures inspectable.

ToolCall preview

search_accounts
Complete

3 inactive accounts found
Acme Sandbox · Example Studio · Demo Works
Host duration: 820 ms

Interactions use local sample data.

Usage and props

Show a tool request and the result reported by your server. Update value as input arrives or execution changes, and preserve outcome-unknown until the server resolves it. The host executes tools and reports authoritative outcomes.

valueToolCallData
The tool id, name, revision, state and input, with optional output, error and durationMs.
variant'card' | 'terminal' | 'compact' (optional)
Defaults to card. Compact keeps execution details behind a disclosure.
childrenReactNode (optional)
Replace the default layout with Summary, Input and Result inside ToolCall.Root.
How state and callbacks work

These are the main props for the example. The package's TypeScript declarations include the full API.

Customize and use with a keyboard