ThinkingTrace

Expandable agent thinking / tool / search trace, driven by real agent state. While streaming is true the trace is open, shows every row it is given and shimmers activeLabel. When it turns false the trace collapses to doneLabel; rows stay mounted and the header re-expands them. A manual toggle of the header pins expansion until the component unmounts.

Reading finish briefs

Scanning supplier lists

Comparing grain patterns6 finishes

Writing the summary

Usage

import { ThinkingTrace, ThinkingTraceProps, ThinkingTraceRow, ThinkingTraceVariant } from "@instruments/materia-ui/compositions/thinking-trace";

Best practices

Pair above streaming answers in chat. Use ThinkingLoader when you only need a one-line narrated header without an expandable timeline.

Props

Prop	Type	Description
className	`string`
activeLabel	`string`	Header label while streaming. Defaults to `"Thinking"`.
doneLabel	`string`	Settled header label. Defaults to `"Finished thinking"`.
query	`string`	Search query shown above the rows.
rows(required)	`ThinkingTraceRow[]`	Trace rows, in order.
streaming	`boolean`	Whether the agent is still working. `true` shows the shimmering `activeLabel` with the trace open; `false` collapses it to `doneLabel`. Defaults to `false`.
variant	`ThinkingTraceVariant`	Presentation variant. Defaults to `"steps"`.

Also exports

interfaceThinkingTraceProps
interfaceThinkingTraceRow
typeThinkingTraceVariant

Composition

Builds on

Center, Flex, Grid, Icon, Text