# November 8, 2026

Plan and Prompt Input AI element tutorials, monochrome token consistency, and clearer disabled states.

> For the complete documentation index, see [llms.txt](/llms.txt). Markdown variants are available by appending `.md` to any URL or sending an `Accept: text/markdown` header. An agent skill is available at [/.well-known/agent-skills/site-skill.md](/.well-known/agent-skills/site-skill.md).

This release adds eleven AI element tutorials — **Plan** and **Prompt Input** — plus a monochrome token pass that fixes disabled states across buttons, input groups, OTP inputs, and native selects.

- [Plan](#plan): Stream an agent plan with step status.
- [Prompt Input](#prompt-input): Composer with attachments, model, and effort pickers.
- [Queue](#queue): Grouped todo list with pending and completed sections.
- [Reasoning](#reasoning): Streaming thinking block with collapsible trace.
- [Sources](#sources): Collapsible list of agent source citations.
- [Stack Trace](#stack-trace): Failed command with parsed stack frames.
- [Subagent](#subagent): Live trace of a delegated task with nested tool calls.
- [Suggestion](#suggestion): Starter prompts above the composer.
- [Task](#task): Multi-step agent task with running, done, and error states.
- [Test Results](#test-results): Grouped trace of suites, tests, and failures.
- [Tool](#tool): Tool call with running, done, error, denied, and approval states.
- [Disabled state](#disabled-state): Muted background replaces reduced opacity.
- [Tokens](#tokens): `--subtle-foreground` and higher contrast for `--input` and `--border`.

<hr className="my-16 border-border/40" />

### Plan [#plan]

<ComponentPreview name="plan-demo" title="plan-demo.tsx" src="examples/plan-demo.tsx" previewClassName="h-auto py-8">
<PlanDemo />
</ComponentPreview>

**Plan** renders an agent plan as a collapsible list of steps. Each step is `done`, `running`, or `pending`. The header shows progress and the whole block collapses. It is a composition over [Trace](/docs/components/trace).

#### Installation [#installation]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace message bubble button
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceDescription,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage]

```tsx
<Trace>
  <TraceCollapsible defaultOpen>
    <TraceCollapsibleTrigger>
      <TraceLine status="running">
        <TraceIcon><RouteIcon /></TraceIcon>
        <TraceTitle>{"Plan: migrate to Base UI"}</TraceTitle>
        <TraceDescription>{"1 of 4 done"}</TraceDescription>
      </TraceLine>
    </TraceCollapsibleTrigger>
    <TraceCollapsibleContent>
      <Trace>{/* steps */}</Trace>
    </TraceCollapsibleContent>
  </TraceCollapsible>
</Trace>
```

See the [Plan docs](/docs/ai-elements/plan) for the full composition.

<hr className="my-16 border-border/40" />

### Prompt Input [#prompt-input]

<ComponentPreview name="prompt-input-demo" title="prompt-input-demo.tsx" src="examples/prompt-input-demo.tsx" previewClassName="h-auto py-8">
<PromptInputDemo />
</ComponentPreview>

**Prompt Input** is a composer for chat and agent surfaces. Attachment chips sit above a textarea, and a bottom bar holds the attach action, two pickers, and the send button. It is a composition over InputGroup, Attachment, Dropdown Menu, and Button.

#### Installation [#installation-1]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add input-group attachment dropdown-menu button
```

<Step>
Use it in your app
</Step>

```tsx
import {
InputGroup,
InputGroupAddon,
InputGroupButton,
InputGroupTextarea,
} from "@/components/ui/input-group";
```
</Steps>

#### Minimal usage [#minimal-usage-1]

```tsx
<InputGroup>
  <InputGroupAddon align="block-start">{/* attachments */}</InputGroupAddon>
  <InputGroupTextarea placeholder="Ask the agent..." />
  <InputGroupAddon align="block-end">
    <InputGroupButton aria-label="Attach files" size="icon-sm" variant="outline">
      <PlusIcon />
    </InputGroupButton>
    <InputGroupButton type="submit" size="icon-sm" variant="default" aria-label="Send">
      <ArrowUpIcon />
    </InputGroupButton>
  </InputGroupAddon>
</InputGroup>
```

See the [Prompt Input docs](/docs/ai-elements/prompt-input) for the full composition.

<hr className="my-16 border-border/40" />

### Queue [#queue]

<ComponentPreview name="queue-demo" title="queue-demo.tsx" src="examples/queue-demo.tsx" previewClassName="h-auto py-8">
<QueueDemo />
</ComponentPreview>

**Queue** renders an agent todo list as two grouped trace sections — pending and completed. Each row carries a status glyph and the group headers show counts. It is a composition over [Trace](/docs/components/trace).

#### Installation [#installation-2]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace message bubble button
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage-2]

```tsx
<Trace>
  <TraceCollapsible defaultOpen>
    <TraceCollapsibleTrigger>
      <TraceLine>
        <TraceIcon><ListTodoIcon /></TraceIcon>
        <TraceTitle>{"3 to do"}</TraceTitle>
      </TraceLine>
    </TraceCollapsibleTrigger>
    <TraceCollapsibleContent>
      <Trace>{/* pending todos */}</Trace>
    </TraceCollapsibleContent>
  </TraceCollapsible>
</Trace>
```

See the [Queue docs](/docs/ai-elements/queue) for the full composition.

<hr className="my-16 border-border/40" />

### Reasoning [#reasoning]

<ComponentPreview name="reasoning-demo" title="reasoning-demo.tsx" src="examples/reasoning-demo.tsx" previewClassName="h-auto py-8">
<ReasoningDemo />
</ComponentPreview>

**Reasoning** renders an agent thinking block as a collapsible trace. The line shimmers while streaming, stays open until the run finishes, then collapses. It is a composition over [Trace](/docs/components/trace).

#### Installation [#installation-3]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace message bubble button
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage-3]

```tsx
<Trace>
  <TraceCollapsible open={running} onOpenChange={setOpen}>
    <TraceCollapsibleTrigger>
      <TraceLine status={running ? "running" : undefined}>
        <TraceTitle>{running ? "Thinking" : "Thought"}</TraceTitle>
      </TraceLine>
    </TraceCollapsibleTrigger>
    <TraceCollapsibleContent className="whitespace-pre-wrap">
      {text}
    </TraceCollapsibleContent>
  </TraceCollapsible>
</Trace>
```

See the [Reasoning docs](/docs/ai-elements/reasoning) for the full composition.

<hr className="my-16 border-border/40" />

### Sources [#sources]

<ComponentPreview name="sources-demo" title="sources-demo.tsx" src="examples/sources-demo.tsx" previewClassName="h-auto py-8">
<SourcesDemo />
</ComponentPreview>

**Sources** collects `source-url` parts from an assistant message and renders them as a collapsible trace list. Duplicates are removed and the header shows the count. It is a composition over [Trace](/docs/components/trace).

#### Installation [#installation-4]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace message bubble button
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage-4]

```tsx
<Trace>
  <TraceCollapsible defaultOpen>
    <TraceCollapsibleTrigger>
      <TraceLine>
        <TraceIcon><GlobeIcon /></TraceIcon>
        <TraceTitle>{`Used ${sources.length} sources`}</TraceTitle>
      </TraceLine>
    </TraceCollapsibleTrigger>
    <TraceCollapsibleContent>
      <Trace>
        {sources.map((source) => (
          <a key={source.url} href={source.url} target="_blank" rel="noreferrer" className="block">
            <TraceLine>
              <TraceTitle>{source.title ?? source.url}</TraceTitle>
              <TraceIcon><ArrowUpRightIcon /></TraceIcon>
            </TraceLine>
          </a>
        ))}
      </Trace>
    </TraceCollapsibleContent>
  </TraceCollapsible>
</Trace>
```

See the [Sources docs](/docs/ai-elements/sources) for the full composition.

<hr className="my-16 border-border/40" />

### Stack Trace [#stack-trace]

<ComponentPreview name="stack-trace-demo" title="stack-trace-demo.tsx" src="examples/stack-trace-demo.tsx" previewClassName="h-auto py-8">
<StackTraceDemo />
</ComponentPreview>

**Stack Trace** renders a failed command as a collapsible trace. App frames are links, framework frames collapse into a monospace list. It is a composition over [Trace](/docs/components/trace) and [Code Block](/docs/components/code-block).

#### Installation [#installation-5]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace code-block message bubble button
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage-5]

```tsx
<TraceCollapsible defaultOpen>
  <TraceCollapsibleTrigger>
    <TraceLine status="error">
      <TraceIcon><TerminalIcon /></TraceIcon>
      <TraceTitle>{`Failed: ${error}`}</TraceTitle>
    </TraceLine>
  </TraceCollapsibleTrigger>
  <TraceCollapsibleContent>
    <p className="text-destructive font-mono text-xs">{error}</p>
    <Trace>{/* frames */}</Trace>
  </TraceCollapsibleContent>
</TraceCollapsible>
```

See the [Stack Trace docs](/docs/ai-elements/stack-trace) for the full composition.

<hr className="my-16 border-border/40" />

### Subagent [#subagent]

<ComponentPreview name="subagent-demo" title="subagent-demo.tsx" src="examples/subagent-demo.tsx" previewClassName="h-auto py-8">
<SubagentDemo />
</ComponentPreview>

**Subagent** renders a delegated task as a live trace. The subagent streams its own tool calls as partial output and lands the final report at the bottom. It is a composition over [Trace](/docs/components/trace) and [Code Block](/docs/components/code-block).

#### Installation [#installation-6]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace code-block message bubble button
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage-6]

```tsx
const subagent = writer.tool("researchAgent", { input: { task } })

steps.forEach((_, index) => {
  subagent.output(getSubagentMessage(index), { preliminary: true })
  writer.sleep(1000)
})

subagent.output(getSubagentMessage(steps.length, report))
```

See the [Subagent docs](/docs/ai-elements/subagent) for the full composition.

<hr className="my-16 border-border/40" />

### Suggestion [#suggestion]

<ComponentPreview name="suggestion-demo" title="suggestion-demo.tsx" src="examples/suggestion-demo.tsx" previewClassName="h-auto py-8">
<SuggestionDemo />
</ComponentPreview>

**Suggestion** renders a horizontal row of starter prompts above the composer. Clicking one sends it immediately. The row scrolls horizontally and fades its edges.

#### Installation [#installation-7]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add input-group bubble message button
```

<Step>
Use it in your app
</Step>

```tsx
import { Button } from "@/components/ui/button";
```
</Steps>

#### Minimal usage [#minimal-usage-7]

```tsx
<div className="scroll-fade-x no-scrollbar flex gap-2 overflow-x-auto">
  {suggestions.map((suggestion) => (
    <Button key={suggestion} variant="outline" size="sm" onClick={() => send(suggestion)}>
      {suggestion}
    </Button>
  ))}
</div>
```

See the [Suggestion docs](/docs/ai-elements/suggestion) for the full composition.

<hr className="my-16 border-border/40" />

### Task [#task]

<ComponentPreview name="task-demo" title="task-demo.tsx" src="examples/task-demo.tsx" previewClassName="h-auto py-8">
<TaskDemo />
</ComponentPreview>

**Task** renders a multi-step agent operation as a collapsible trace. Each step updates in place as the task advances.

#### Installation [#installation-8]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace message bubble button
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage-8]

```tsx
<TraceCollapsible>
  <TraceCollapsibleTrigger>
    <TraceLine status={status}>
      <TraceIcon><StatusIcon status={status} /></TraceIcon>
      <TraceTitle>{task.title}</TraceTitle>
    </TraceLine>
  </TraceCollapsibleTrigger>
  <TraceCollapsibleContent>
    <Trace>{/* steps */}</Trace>
  </TraceCollapsibleContent>
</TraceCollapsible>
```

See the [Task docs](/docs/ai-elements/task) for the full composition.

<hr className="my-16 border-border/40" />

### Test Results [#test-results]

<ComponentPreview name="test-results-demo" title="test-results-demo.tsx" src="examples/test-results-demo.tsx" previewClassName="h-auto py-8">
<TestResultsDemo />
</ComponentPreview>

**Test Results** renders a test run as a nested trace. The header shows counts, each suite collapses into its tests, and failures expand into the assertion output.

#### Installation [#installation-9]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace code-block message bubble button
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage-9]

```tsx
<TraceCollapsible>
  <TraceCollapsibleTrigger>
    <TraceLine status={summary.failed > 0 ? "error" : undefined}>
      <TraceIcon><FlaskConicalIcon /></TraceIcon>
      <TraceTitle>Ran {formatCounts(summary)}</TraceTitle>
    </TraceLine>
  </TraceCollapsibleTrigger>
  <TraceCollapsibleContent>
    <Trace>{/* suites */}</Trace>
  </TraceCollapsibleContent>
</TraceCollapsible>
```

See the [Test Results docs](/docs/ai-elements/test-results) for the full composition.

<hr className="my-16 border-border/40" />

### Tool [#tool]

<ComponentPreview name="tool-demo" title="tool-demo.tsx" src="examples/tool-demo.tsx" previewClassName="h-auto py-8">
<ToolDemo />
</ComponentPreview>

**Tool** renders a tool call as a trace row with running, done, error, denied, and approval states. Failing calls auto-expand their output.

#### Installation [#installation-10]

<Steps>
<Step>
Install the primitives
</Step>

```bash
npx frakment add trace code-block message bubble button item
```

<Step>
Use it in your app
</Step>

```tsx
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
```
</Steps>

#### Minimal usage [#minimal-usage-10]

```tsx
<TraceCollapsible>
  <TraceCollapsibleTrigger>
    <TraceLine status={failed ? "error" : undefined}>
      <TraceIcon><TerminalIcon /></TraceIcon>
      <TraceTitle>{failed ? "Failed to run" : "Ran"} {command}</TraceTitle>
    </TraceLine>
  </TraceCollapsibleTrigger>
  <TraceCollapsibleContent>
    <CodeBlock><CodeBlockContent wrap>{output}</CodeBlockContent></CodeBlock>
  </TraceCollapsibleContent>
</TraceCollapsible>
```

See the [Tool docs](/docs/ai-elements/tool) for the full composition.

<hr className="my-16 border-border/40" />

### Engine packages now on npm [#engine-packages-now-on-npm]

`@frakment/ai` and `@frakment/react` are now published npm packages. AI and message scroller engines install with `npm install`, matching the shadcn pattern where logic lives in a package and styling lives in the registry.

```bash
npm install @frakment/ai @frakment/react
```

`message-scroller` now depends on `@frakment/react`, and `message-animated` depends on `@frakment/ai`. Running `npx frakment add message-scroller` or `message-animated` installs the engine package automatically.

#### Migration [#migration]

If you previously installed the `ai` registry item, delete the `lib/ai/` folder — it is no longer used. Import the engine from `@frakment/ai` instead:

```tsx
- import { createChat } from "@/lib/ai"
+ import { createChat } from "@frakment/ai"
```

See the [AI engine docs](/docs/libraries/ai) and [React engine docs](/docs/libraries/react) for the full API.

<hr className="my-16 border-border/40" />

### Disabled state [#disabled-state]

Disabled buttons now use a solid muted background instead of reduced opacity. Icons and labels stay readable while the control reads as inactive.

`InputGroup`, `InputOTP`, and `NativeSelect` no longer fade their entire container when a single child is disabled.

See the [Button docs](/docs/components/button) and [Input Group docs](/docs/components/input-group) for the updated variants.

<hr className="my-16 border-border/40" />

### Tokens [#tokens]

`--subtle-foreground` is available for interactive values inside muted surfaces, sitting between `--foreground` and `--muted-foreground`. `--input` and `--border` are lifted in both light and dark mode so form borders read against the surface. `--sidebar-primary` is monochrome in both modes. `<body>` now applies `bg-background` by default.

See the [Theming guide](/docs/guides/theming) for the full token reference.