For AI agents: the documentation index is at /llms.txt, and any docs page is available as Markdown by appending .md to its URL.

Tool call

Verified

One tool invocation as a collapsible row with a state badge, the input, and the output or error.

When to use

Use when: Showing an agent's tool use with its state, input, and output.
Avoid when: A final answer; use Message.

Installation

bunx shelf add tool-call

The source lands in src/components/ui/tool-call.tsx, along with any Shelf items it builds on, and .shelf/lock.json records what was installed. It's yours to edit.

Usage

import { Approval } from "@/components/ui/approval";
import { ToolCall } from "@/components/ui/tool-call";

<ToolCall part={part}>
  {part.state === "approval-requested" && <Approval onRespond={respond} />}
</ToolCall>

Built on

Packages: @stylexjs/stylex
Shelf items: Badge, Code Block, Collapsible, foundations, Icons, Message, Spinner, utils
Figma: Optional native Figma library. See Designers.

Verified

Size: 1.8 kB gzipped on its own, 310 kB with the Shelf items and packages it builds on. JS and CSS in a production build, without React.
Accessibility: Axe passes on 3 stories
Behavior: 3 interaction tests in Storybook
React Compiler: Compiles with React Compiler
React Doctor: React Doctor finds nothing