Kanshō/Tool call group

Tool call group

Collapses a burst of tool calls into a single rollup line — 'Ran N tools · Ns' led by the shared status glyph — expanding into the tool-call row variants. The rollup never reads calmer than its worst child.

Included in the single kansho full pack. Components are not offered as separate installs.

Collapsed rollup

Click the line to expand into the individual tool rows

Expanded by default

Running — any child still running

The rollup glyph shows the running state until every tool settles

Failed — one child errored

A single failure escalates the whole rollup to error

Error & recovery

Static preview: onRetry shows the recovery action without changing tool data

With onToolClick

Row clicks bubble to a parent — e.g. to focus the tool in a side panel

Component documentation

Tool Call Group

components/agent/tool-call-group.tsx

Purpose

Rolls multiple tool calls into one aggregate status line with expandable ToolCallCard rows.

Appropriate use

Use when consecutive tool calls would otherwise dominate an agent response.

Example

components/agent/tool-call-group.tsx has a representative live example in the "Expanded by default" section on /components/tool-call-group.

States

Aggregate priority is running, then error, then success; the group can start collapsed/open and supports row click and per-error retry callbacks.

API and props

ToolCallGroup accepts tools, defaultOpen, onToolClick, onRetry, and className.

Dependencies

Direct imports are React, Disclosure, StatusGlyph, StatusPill, ToolCallCard, status metadata, duration formatting, and cn.

Accessibility

Disclosure supplies keyboard expansion, each child preserves its semantics, and aggregate status is repeated in visible text.

Limitations

The rollup recognises running, error, and success for aggregation; callers must decide how other shared statuses should be represented.

Source

Source: components/agent/tool-call-group.tsx.

Full pack

components/agent/tool-call-group.tsx is documented at /components/tool-call-group and installs only through the single Kansho full pack; no individual component install is offered.