---
title: "Tool"
description: "Inspect a tool call with structured input and output."
---

# Tool

Inspect a tool call with structured input and output.

## Usage

Expand command calls to inspect their outputs and errors. Replay runs the scripted sequence without executing commands.

## Example

```contract
use uiFontFamily, BubbleFrame from "@rightui/ui"
use ButtonAI as ButtonContent from "@rightui/ui"
use TraceFrame, TraceLine, TraceCollapsible, TraceDisclosure, TraceSource, CodeBlockContent from "@rightui/ui"

component Demo
  props
    width: number
    reduced: bool
  inject
    uiFont: string
    rightuiDemoTime: number
    rightuiRunDemo: action
  state started = -1
  derive elapsed = started < 0 ? 12700 : max(0, rightuiDemoTime - started)
  derive busy = elapsed < 2700
  action replay
    started = rightuiDemoTime
    rightuiRunDemo(6700)
  view
    column gap="ui.space-16" min-width=0 min-height=288 max-width="24rem" width="100%" padding="ui.space-24 ui.space-0"
      BubbleFrame(id="ai-tool-question", align="end", variant="muted")
        text "Which package managers are installed?" font-family=uiFontFamily(uiFont) data-rightui-font="body"
      TraceFrame()
        if elapsed >= 0
          if elapsed < 900
            TraceLine(title="Running node --version", icon="terminal", status="running", reduced=reduced)
          else
            TraceCollapsible(id="ai-tool-0", title="Ran node --version", icon="terminal", status="", initiallyOpen=false, reduced=reduced)
              CodeBlockContent(id="ai-tool-0-output", code="v24.18.0")
        if elapsed >= 900
          if elapsed < 1800
            TraceLine(title="Running npm --version", icon="terminal", status="running", reduced=reduced)
          else
            TraceCollapsible(id="ai-tool-1", title="Ran npm --version", icon="terminal", status="", initiallyOpen=false, reduced=reduced)
              CodeBlockContent(id="ai-tool-1-output", code="11.6.2")
        if elapsed >= 1800
          if elapsed < 2700
            TraceLine(title="Running pnpm --version", icon="terminal", status="running", reduced=reduced)
          else
            TraceCollapsible(id="ai-tool-reveal", title="Failed to run pnpm --version", icon="terminal", status="error", initiallyOpen=true, reduced=reduced)
              CodeBlockContent(id="ai-tool-2-output", code="command not found: pnpm")
      if elapsed >= 2700
        text "Node 24 and npm 11 are installed. pnpm is not.".slice(0, started < 0 or reduced ? 46 : floor((elapsed - 2700) / 20)) font-size="ui.text-sm" line-height="ui.leading-relaxed" font-family=uiFontFamily(uiFont) data-rightui-font="body"
      if not busy
        row margin-top="auto" align-items="flex-start"
          ButtonContent(id="ai-tool-replay", label="Replay", variant="outline", size="sm", disabled=false, press=replay)
            text "Replay" font-family=uiFontFamily(uiFont) data-rightui-font="body"

```

## Keyboard

Tab to actions and disclosures; Enter or Space activates them.

## Demo runtime

Timed examples use an injected clock. Add these members to your root component. Replace the scripted state with events from your TypeScript or Rust data source when connecting a model.

```contract
use defaultFontWeights from "@rightui/ui"
  state demoTime = 0
  state demoUntil = 0
  provide
    uiFont = "theme"
    uiWeights = defaultFontWeights()
    rightuiDemoTime = demoTime
    rightuiRunDemo = runDemo
  action runDemo(duration: number)
    demoUntil = max(demoUntil, demoTime + duration)
  action tickDemo
    demoTime = min(demoUntil, demoTime + 32)
  task demoClock when demoTime < demoUntil
    every(32, tickDemo)
```

## Source

File: patterns/ai-elements/tool.contract

```contract
use uiFontFamily, BubbleFrame from "@rightui/ui"
use ButtonAI as ButtonContent from "@rightui/ui"
use TraceFrame, TraceLine, TraceCollapsible, TraceDisclosure, TraceSource, CodeBlockContent from "@rightui/ui"

component Demo
  props
    width: number
    reduced: bool
  inject
    uiFont: string
    rightuiDemoTime: number
    rightuiRunDemo: action
  state started = -1
  derive elapsed = started < 0 ? 12700 : max(0, rightuiDemoTime - started)
  derive busy = elapsed < 2700
  action replay
    started = rightuiDemoTime
    rightuiRunDemo(6700)
  view
    column gap="ui.space-16" min-width=0 min-height=288 max-width="24rem" width="100%" padding="ui.space-24 ui.space-0"
      BubbleFrame(id="ai-tool-question", align="end", variant="muted")
        text "Which package managers are installed?" font-family=uiFontFamily(uiFont) data-rightui-font="body"
      TraceFrame()
        if elapsed >= 0
          if elapsed < 900
            TraceLine(title="Running node --version", icon="terminal", status="running", reduced=reduced)
          else
            TraceCollapsible(id="ai-tool-0", title="Ran node --version", icon="terminal", status="", initiallyOpen=false, reduced=reduced)
              CodeBlockContent(id="ai-tool-0-output", code="v24.18.0")
        if elapsed >= 900
          if elapsed < 1800
            TraceLine(title="Running npm --version", icon="terminal", status="running", reduced=reduced)
          else
            TraceCollapsible(id="ai-tool-1", title="Ran npm --version", icon="terminal", status="", initiallyOpen=false, reduced=reduced)
              CodeBlockContent(id="ai-tool-1-output", code="11.6.2")
        if elapsed >= 1800
          if elapsed < 2700
            TraceLine(title="Running pnpm --version", icon="terminal", status="running", reduced=reduced)
          else
            TraceCollapsible(id="ai-tool-reveal", title="Failed to run pnpm --version", icon="terminal", status="error", initiallyOpen=true, reduced=reduced)
              CodeBlockContent(id="ai-tool-2-output", code="command not found: pnpm")
      if elapsed >= 2700
        text "Node 24 and npm 11 are installed. pnpm is not.".slice(0, started < 0 or reduced ? 46 : floor((elapsed - 2700) / 20)) font-size="ui.text-sm" line-height="ui.leading-relaxed" font-family=uiFontFamily(uiFont) data-rightui-font="body"
      if not busy
        row margin-top="auto" align-items="flex-start"
          ButtonContent(id="ai-tool-replay", label="Replay", variant="outline", size="sm", disabled=false, press=replay)
            text "Replay" font-family=uiFontFamily(uiFont) data-rightui-font="body"

```
