# Tool Chips

> Compact chips for the tools an agent calls, with running, done and failed states.

```tsx
import { ToolChips } from '@brand-studio/ui';

export default function ToolChipsDemo() {
  return (
    <ToolChips
      tools={[
        { id: '1', name: 'orders.search', detail: '14 results', status: 'done' },
        { id: '2', name: 'catalog.list', status: 'running' },
        { id: '3', name: 'stock.check', detail: 'timed out', status: 'error' },
      ]}
    />
  );
}
```

## Installation

```sh
npm install @brand-studio/ui
```

React 18 or 19 is a peer dependency. Import the stylesheet once and wrap the app in a brand theme:

```tsx
import '@brand-studio/ui/styles.css';
import { BrandTheme, ToolChips } from '@brand-studio/ui';
import brand from './brand.json';

<BrandTheme palette={brand.tokens} mode="system">
  {/* your app */}
</BrandTheme>
```

## Usage

```tsx
import { ToolChips } from '@brand-studio/ui';
```

```tsx
<ToolChips tools={[{ id: '1', name: 'orders.search', status: 'done' }]} />
```

## Accessibility

- The list is a polite live region, so status changes are announced.
- Each chip spells out its status for screen readers.

## API Reference

| Prop | Type | Default |
|---|---|---|
| `tools` | `ToolCall[]` | – |
| `className?` | `string` | `''` |

Source: https://brandstudio.js.org/docs/components/tool-chips/
