Get Started
Components
- Accordion
- Attachment
- Avatar
- Badge
- Breadcrumb
- Button
- Button Group
- Card
- Checkbox
- Code Block
- Collapsible
- Dialog
- Dropdown Menu
- Empty
- Field
- Hover Card
- Input
- Input Group
- Input OTP
- Item
- Label
- Marker
- Message
- Number Flow
- Pagination
- Popover
- Progress
- Radio Group
- Select
- Slider
- Sonner
- Spinner
- Switch
- Tooltip
- Separator
- Sheet
- Tabs
- Textarea
- Toggle
- Toggle Group
- Trace
AI Elements
Libraries
Utilities
Run the checkout tests.
adds an itemremoves an itemapplies a discount code
charges the saved card
Expected 2 charge attempts, received 1
at Object.<anonymous> (src/payment.test.ts:58:22)One test failed. The payment client does not retry a declined card, so the second charge attempt never happens.
"use client";
import { useChat } from "@ai-sdk/react";
import type { UIDataTypes, UIMessage } from "ai";
import {
CheckIcon,
CircleDashedIcon,
FileCodeIcon,
FlaskConicalIcon,
XIcon,
} from "lucide-react";
import { Button } from "@/components/ui/button";
import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block";
import {
Bubble,
BubbleContent,
Message,
MessageContent,
} from "@/components/ui/message";
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
import { createChat, getMessageText } from "@/lib/ai";
interface Test {
error?: string;
name: string;
status: "passed" | "failed" | "skipped";
}
type ChatMessage = UIMessage<
unknown,
UIDataTypes,
{
runTests: {
input: { command: string };
output: { suites: { name: string; tests: Test[] }[] };
};
}
>;
type ToolPart = Extract<
ChatMessage["parts"][number],
{ type: "tool-runTests" }
>;
const chat = createChat<ChatMessage>()
.user("Run the checkout tests.")
.assistant(({ writer }) => {
writer
.tool("runTests", { input: { command: "pnpm test checkout" } })
.sleep(1500)
.output({
suites: [
{
name: "cart.test.ts",
tests: [
{ name: "adds an item", status: "passed" },
{ name: "removes an item", status: "passed" },
{ name: "applies a discount code", status: "passed" },
],
},
{
name: "payment.test.ts",
tests: [
{ name: "charges the saved card", status: "passed" },
{
error: `Expected 2 charge attempts, received 1
at Object.<anonymous> (src/payment.test.ts:58:22)`,
name: "retries a declined card",
status: "failed",
},
],
},
],
});
writer.text(
"One test failed. The payment client does not retry a declined card, so the second charge attempt never happens."
);
});
const transcript = chat.get();
const [question] = chat.get(1);
const transport = chat.transport({ delayMs: 20 });
function countTests(tests: Test[]) {
return {
failed: tests.filter((test) => test.status === "failed").length,
skipped: tests.filter((test) => test.status === "skipped").length,
total: tests.length,
};
}
function formatCounts({
total,
failed,
skipped,
}: ReturnType<typeof countTests>) {
return [
`${total} tests`,
failed > 0 && `${failed} failed`,
skipped > 0 && `${skipped} skipped`,
]
.filter(Boolean)
.join(", ");
}
function TestRow({ test }: { test: Test }) {
if (test.status === "failed") {
return (
<TraceCollapsible defaultOpen>
<TraceCollapsibleTrigger>
<TraceLine status="error">
<TraceIcon>
<XIcon />
</TraceIcon>
<TraceTitle>{test.name}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<CodeBlock size="sm">
<CodeBlockContent className="max-h-64" wrap>
{test.error}
</CodeBlockContent>
</CodeBlock>
</TraceCollapsibleContent>
</TraceCollapsible>
);
}
return (
<TraceLine>
<TraceIcon>
{test.status === "skipped" ? <CircleDashedIcon /> : <CheckIcon />}
</TraceIcon>
<TraceTitle>
{test.status === "skipped" ? `Skipped ${test.name}` : test.name}
</TraceTitle>
</TraceLine>
);
}
function TestResultsRow({
part,
streaming,
}: {
part: ToolPart;
streaming: boolean;
}) {
const command = part.input?.command;
if (part.state !== "output-available") {
const running = streaming && part.state !== "output-error";
return (
<TraceLine status={running ? "running" : "error"}>
<TraceIcon>
<FlaskConicalIcon />
</TraceIcon>
<TraceTitle>
{running ? "Running" : "Failed to run"} {command}
</TraceTitle>
</TraceLine>
);
}
const { suites } = part.output;
const summary = countTests(suites.flatMap((suite) => suite.tests));
return (
<TraceCollapsible defaultOpen={summary.failed > 0}>
<TraceCollapsibleTrigger>
<TraceLine status={summary.failed > 0 ? "error" : undefined}>
<TraceIcon>
<FlaskConicalIcon />
</TraceIcon>
<TraceTitle>Ran {formatCounts(summary)}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent keepMounted>
<Trace>
{suites.map((suite) => {
const counts = countTests(suite.tests);
return (
<TraceCollapsible
defaultOpen={counts.failed > 0}
key={suite.name}
>
<TraceCollapsibleTrigger>
<TraceLine status={counts.failed > 0 ? "error" : undefined}>
<TraceIcon>
<FileCodeIcon />
</TraceIcon>
<TraceTitle>
{suite.name}, {formatCounts(counts)}
</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent keepMounted>
<Trace>
{suite.tests.map((test) => (
<TestRow key={test.name} test={test} />
))}
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
);
})}
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
);
}
export function TestResultsDemo() {
const { messages, sendMessage, setMessages, status } = useChat<ChatMessage>({
messages: transcript,
transport,
});
const busy = status === "submitted" || status === "streaming";
return (
<div className="flex min-h-72 w-full max-w-sm flex-col gap-4 py-6 text-sm">
{messages.map((message) => {
if (message.role === "user") {
return (
<Message align="end" key={message.id}>
<MessageContent>
<Bubble align="end" variant="muted">
<BubbleContent>{getMessageText(message)}</BubbleContent>
</Bubble>
</MessageContent>
</Message>
);
}
const streaming = busy && message === messages.at(-1);
const tools = message.parts.filter(
(part) => part.type === "tool-runTests"
);
const text = getMessageText(message);
return (
<Message key={message.id}>
<MessageContent className="gap-4">
{tools.length > 0 && (
<Trace>
{tools.map((part) => (
<TestResultsRow
key={part.toolCallId}
part={part}
streaming={streaming}
/>
))}
</Trace>
)}
{text && <p>{text}</p>}
</MessageContent>
</Message>
);
})}
{!busy && question && (
<Button
className="mt-auto self-start"
onClick={() => {
if (!question) {
return;
}
setMessages([]);
sendMessage(question);
}}
size="sm"
variant="outline"
>
Replay
</Button>
)}
</div>
);
}Test Results renders a test run as a nested trace. The header shows the total count and failure summary, each suite collapses into its tests, and failing tests expand into the assertion output.
Test Results is a composition, not a primitive. It composes Trace and Code Block.
Installation
$ bunx --bun frakment add trace code-block message bubble button$ npx frakment add trace code-block message bubble button$ pnpm dlx frakment add trace code-block message bubble button$ yarn dlx frakment add trace code-block message bubble button
Install the primitives:
$ bunx --bun frakment add trace code-block message bubble button$ npx frakment add trace code-block message bubble button$ pnpm dlx frakment add trace code-block message bubble button$ yarn dlx frakment add trace code-block message bubble button
Copy the demo into your project:
"use client";
import { useChat } from "@ai-sdk/react";
import type { UIDataTypes, UIMessage } from "ai";
import {
CheckIcon,
CircleDashedIcon,
FileCodeIcon,
FlaskConicalIcon,
XIcon,
} from "lucide-react";
import { Button } from "@/components/ui/button";
import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block";
import {
Bubble,
BubbleContent,
Message,
MessageContent,
} from "@/components/ui/message";
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
import { createChat, getMessageText } from "@/lib/ai";
interface Test {
error?: string;
name: string;
status: "passed" | "failed" | "skipped";
}
type ChatMessage = UIMessage<
unknown,
UIDataTypes,
{
runTests: {
input: { command: string };
output: { suites: { name: string; tests: Test[] }[] };
};
}
>;
type ToolPart = Extract<
ChatMessage["parts"][number],
{ type: "tool-runTests" }
>;
const chat = createChat<ChatMessage>()
.user("Run the checkout tests.")
.assistant(({ writer }) => {
writer
.tool("runTests", { input: { command: "pnpm test checkout" } })
.sleep(1500)
.output({
suites: [
{
name: "cart.test.ts",
tests: [
{ name: "adds an item", status: "passed" },
{ name: "removes an item", status: "passed" },
{ name: "applies a discount code", status: "passed" },
],
},
{
name: "payment.test.ts",
tests: [
{ name: "charges the saved card", status: "passed" },
{
error: `Expected 2 charge attempts, received 1
at Object.<anonymous> (src/payment.test.ts:58:22)`,
name: "retries a declined card",
status: "failed",
},
],
},
],
});
writer.text(
"One test failed. The payment client does not retry a declined card, so the second charge attempt never happens."
);
});
const transcript = chat.get();
const [question] = chat.get(1);
const transport = chat.transport({ delayMs: 20 });
function countTests(tests: Test[]) {
return {
failed: tests.filter((test) => test.status === "failed").length,
skipped: tests.filter((test) => test.status === "skipped").length,
total: tests.length,
};
}
function formatCounts({
total,
failed,
skipped,
}: ReturnType<typeof countTests>) {
return [
`${total} tests`,
failed > 0 && `${failed} failed`,
skipped > 0 && `${skipped} skipped`,
]
.filter(Boolean)
.join(", ");
}
function TestRow({ test }: { test: Test }) {
if (test.status === "failed") {
return (
<TraceCollapsible defaultOpen>
<TraceCollapsibleTrigger>
<TraceLine status="error">
<TraceIcon>
<XIcon />
</TraceIcon>
<TraceTitle>{test.name}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<CodeBlock size="sm">
<CodeBlockContent className="max-h-64" wrap>
{test.error}
</CodeBlockContent>
</CodeBlock>
</TraceCollapsibleContent>
</TraceCollapsible>
);
}
return (
<TraceLine>
<TraceIcon>
{test.status === "skipped" ? <CircleDashedIcon /> : <CheckIcon />}
</TraceIcon>
<TraceTitle>
{test.status === "skipped" ? `Skipped ${test.name}` : test.name}
</TraceTitle>
</TraceLine>
);
}
function TestResultsRow({
part,
streaming,
}: {
part: ToolPart;
streaming: boolean;
}) {
const command = part.input?.command;
if (part.state !== "output-available") {
const running = streaming && part.state !== "output-error";
return (
<TraceLine status={running ? "running" : "error"}>
<TraceIcon>
<FlaskConicalIcon />
</TraceIcon>
<TraceTitle>
{running ? "Running" : "Failed to run"} {command}
</TraceTitle>
</TraceLine>
);
}
const { suites } = part.output;
const summary = countTests(suites.flatMap((suite) => suite.tests));
return (
<TraceCollapsible defaultOpen={summary.failed > 0}>
<TraceCollapsibleTrigger>
<TraceLine status={summary.failed > 0 ? "error" : undefined}>
<TraceIcon>
<FlaskConicalIcon />
</TraceIcon>
<TraceTitle>Ran {formatCounts(summary)}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent keepMounted>
<Trace>
{suites.map((suite) => {
const counts = countTests(suite.tests);
return (
<TraceCollapsible
defaultOpen={counts.failed > 0}
key={suite.name}
>
<TraceCollapsibleTrigger>
<TraceLine status={counts.failed > 0 ? "error" : undefined}>
<TraceIcon>
<FileCodeIcon />
</TraceIcon>
<TraceTitle>
{suite.name}, {formatCounts(counts)}
</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent keepMounted>
<Trace>
{suite.tests.map((test) => (
<TestRow key={test.name} test={test} />
))}
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
);
})}
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
);
}
export function TestResultsDemo() {
const { messages, sendMessage, setMessages, status } = useChat<ChatMessage>({
messages: transcript,
transport,
});
const busy = status === "submitted" || status === "streaming";
return (
<div className="flex min-h-72 w-full max-w-sm flex-col gap-4 py-6 text-sm">
{messages.map((message) => {
if (message.role === "user") {
return (
<Message align="end" key={message.id}>
<MessageContent>
<Bubble align="end" variant="muted">
<BubbleContent>{getMessageText(message)}</BubbleContent>
</Bubble>
</MessageContent>
</Message>
);
}
const streaming = busy && message === messages.at(-1);
const tools = message.parts.filter(
(part) => part.type === "tool-runTests"
);
const text = getMessageText(message);
return (
<Message key={message.id}>
<MessageContent className="gap-4">
{tools.length > 0 && (
<Trace>
{tools.map((part) => (
<TestResultsRow
key={part.toolCallId}
part={part}
streaming={streaming}
/>
))}
</Trace>
)}
{text && <p>{text}</p>}
</MessageContent>
</Message>
);
})}
{!busy && question && (
<Button
className="mt-auto self-start"
onClick={() => {
if (!question) {
return;
}
setMessages([]);
sendMessage(question);
}}
size="sm"
variant="outline"
>
Replay
</Button>
)}
</div>
);
}Update the import paths to match your project setup.
Usage
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
import { FlaskConicalIcon, FileCodeIcon, XIcon, CheckIcon } from "lucide-react";Anatomy
<TraceCollapsible>
<TraceCollapsibleTrigger>
<TraceLine>
<TraceIcon />
<TraceTitle />
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<Trace>
<TraceCollapsible>
<TraceCollapsibleTrigger>
<TraceLine>
<TraceIcon />
<TraceTitle />
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<Trace>
<TraceLine />
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>- TraceCollapsible (top) — the run, header shows total count and failure summary
- TraceCollapsible (per suite) — one per test file, header shows suite name and its own counts
- TraceLine (per test) — a single test, marked
errorwhen failed - Code Block — the failure output, collapsible under the failed test
Counts
Both the run header and each suite header render a count string: total tests, failures, skips. Compute the run counts by flattening all suites.
function countTests(tests: Test[]) {
return {
total: tests.length,
failed: tests.filter((test) => test.status === "failed").length,
skipped: tests.filter((test) => test.status === "skipped").length,
}
}Static suites
Render a fixed run without a chat transport for a read-only summary.
logs in with valid credentialsrejects an invalid passwordrefreshes an expired token
creates a userSkipped deletes a user
Expected status 200, received 500
at Object.<anonymous> (src/user-api.test.ts:45:12)connects to the database
Exceeded timeout of 5000 ms for a test.
at Object.<anonymous> (src/db.test.ts:22:3)import {
CheckIcon,
CircleDashedIcon,
FileCodeIcon,
FlaskConicalIcon,
XIcon,
} from "lucide-react";
import { CodeBlock, CodeBlockContent } from "@/components/ui/code-block";
import {
Trace,
TraceCollapsible,
TraceCollapsibleContent,
TraceCollapsibleTrigger,
TraceIcon,
TraceLine,
TraceTitle,
} from "@/components/ui/trace";
interface Test {
error?: string;
name: string;
status: "passed" | "failed" | "skipped";
}
const suites: { name: string; tests: Test[] }[] = [
{
name: "auth.test.ts",
tests: [
{ name: "logs in with valid credentials", status: "passed" },
{ name: "rejects an invalid password", status: "passed" },
{ name: "refreshes an expired token", status: "passed" },
],
},
{
name: "user-api.test.ts",
tests: [
{ name: "creates a user", status: "passed" },
{
error: `Expected status 200, received 500
at Object.<anonymous> (src/user-api.test.ts:45:12)`,
name: "updates a user profile",
status: "failed",
},
{ name: "deletes a user", status: "skipped" },
],
},
{
name: "db.test.ts",
tests: [
{ name: "connects to the database", status: "passed" },
{
error: `Exceeded timeout of 5000 ms for a test.
at Object.<anonymous> (src/db.test.ts:22:3)`,
name: "times out a slow query",
status: "failed",
},
],
},
];
function countTests(tests: Test[]) {
return {
failed: tests.filter((test) => test.status === "failed").length,
skipped: tests.filter((test) => test.status === "skipped").length,
total: tests.length,
};
}
function formatCounts({
total,
failed,
skipped,
}: ReturnType<typeof countTests>) {
return [
`${total} tests`,
failed > 0 && `${failed} failed`,
skipped > 0 && `${skipped} skipped`,
]
.filter(Boolean)
.join(", ");
}
function TestRow({ test }: { test: Test }) {
if (test.status === "failed") {
return (
<TraceCollapsible>
<TraceCollapsibleTrigger>
<TraceLine status="error">
<TraceIcon>
<XIcon />
</TraceIcon>
<TraceTitle>{test.name}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent>
<CodeBlock size="sm">
<CodeBlockContent className="max-h-64" wrap>
{test.error}
</CodeBlockContent>
</CodeBlock>
</TraceCollapsibleContent>
</TraceCollapsible>
);
}
return (
<TraceLine>
<TraceIcon>
{test.status === "skipped" ? <CircleDashedIcon /> : <CheckIcon />}
</TraceIcon>
<TraceTitle>
{test.status === "skipped" ? `Skipped ${test.name}` : test.name}
</TraceTitle>
</TraceLine>
);
}
export function TestResultsSuites() {
const summary = countTests(suites.flatMap((suite) => suite.tests));
return (
<Trace className="max-w-sm">
<TraceCollapsible defaultOpen>
<TraceCollapsibleTrigger>
<TraceLine status={summary.failed > 0 ? "error" : undefined}>
<TraceIcon>
<FlaskConicalIcon />
</TraceIcon>
<TraceTitle>Ran {formatCounts(summary)}</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent keepMounted>
<Trace>
{suites.map((suite) => {
const counts = countTests(suite.tests);
return (
<TraceCollapsible
defaultOpen={counts.failed > 0}
key={suite.name}
>
<TraceCollapsibleTrigger>
<TraceLine status={counts.failed > 0 ? "error" : undefined}>
<TraceIcon>
<FileCodeIcon />
</TraceIcon>
<TraceTitle>
{suite.name}, {formatCounts(counts)}
</TraceTitle>
</TraceLine>
</TraceCollapsibleTrigger>
<TraceCollapsibleContent keepMounted>
<Trace>
{suite.tests.map((test) => (
<TestRow key={test.name} test={test} />
))}
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
);
})}
</Trace>
</TraceCollapsibleContent>
</TraceCollapsible>
</Trace>
);
}Accessibility
- Each test row is text. Status is conveyed by the icon and by the
errorcolor. - Failed tests auto-expand their assertion output. Screen readers announce the open state via the trigger.
- The suite header carries the counts, so a collapsed suite still announces its status.
prefers-reduced-motiondisables collapse animation.
Best Practices
- Group by file. A suite is a test file, not a category.
- Open failing suites by default. Passing suites can stay collapsed.
- Show the raw failure output. Do not rewrite the assertion message.
- Pair with a plain-text summary. The results are evidence, not the answer.