ToolCall

ToolCall renders all eight input, approval, execution, output, failure, and denial states from an agent tool invocation. Lifecycle tinting flows through the shared status vocabulary.

import { ToolCall } from "smithers-orchestrator/ui";

<ToolCall
  name="search"
  state="output-available"
  args={{ query: "run status" }}
  result={{ matches: 3 }}
/>

Use argsText for partial JSON while input streams. It overrides args. resultText similarly overrides result. Object rendering is BigInt-safe and cyclic-safe through the exported formatJsonSafe helper.

Lifecycle states

State	Visible label	Shared status
`input-streaming`	Streaming input	`running`
`input-available`	Ready	`pending`
`approval-requested`	Needs approval	`waiting-approval`
`approval-responded`	Approved	`pending`
`running`	Running	`running`
`output-available`	Done	`complete`
`output-error`	Failed	`error`
`output-denied`	Denied	`denied`

The default compact layout discloses its details with a native button. The expanded layout always mounts details and ignores disclosure props. Inject approve and deny controls through approvalSlot; it renders only during approval-requested.

Overview

Core API

Runtime

Types & errors

Gateway RPC

Lifecycle states

​Lifecycle states

Lifecycle states