KQ-761 · TOOL/CALL

Tool Call

One tool call as a row the reader can open. While the call runs the ring's arc turns on a linear loop; marked done, the arc fades and a tick disc stamps in from 1.3× on recoil, while a failure stamps a danger disc on snap with no bounce. Enter, Space or a click expands the row on glide to a height measured by a ResizeObserver — the arguments as a definition list, then the result box growing with each line the host passes — and a polite live region says the status once per change, never per line.

KQ-761 · TOOL/CALL

Idle · press play

Install

One command — the source lands in your repo. Or copy it from the Code tab.

$ pnpm dlx shadcn@latest add @kinetiq/tool-call

Props

name
string
default
The tool's name, printed in mono.
args
ToolCallArg[]
default []
Key–value pairs, previewed on the row and listed when open.
status
"queued" | "running" | "done" | "error"
default "queued"
Where the call is; drives the ring and the stamp.
result
string
default ""
The result text arrived so far, one line per newline. Append-only.
error
string
default
Why the call failed; printed in the result box with the word Error.
elapsed
number
default
Milliseconds the call has taken, owned by the host. Shown once running.
open / defaultOpen
boolean
default false
Controlled or initial expanded state.
onOpenChange
(open: boolean) => void
default
Fires from the row press.