@@ -89,7 +142,7 @@ export function TraceList({
{trace.summary}
- {trace.kind.replace(/_/g, " ")}
+ {trace.kind.replaceAll(".", " ")}
{trace.eventCount} events
@@ -101,13 +154,17 @@ export function TraceList({
- {selected.kind.replace(/_/g, " ")} · {selected.eventCount} events
+ {selected.kind.replaceAll(".", " ")} · {selected.eventCount} events
@@ -116,6 +173,12 @@ export function TraceList({
Source: {selected.source}
Scope: {selected.scope}
+
+ Detail: {selected.detailSource === "live" ? "Live trace detail" : "Fixture trace detail"}
+
+
+ Events: {selected.eventSource === "live" ? "Live event review" : "Fixture event review"}
+
{selected.related.threadId ? (
Thread: {selected.related.threadId}
) : null}
@@ -128,13 +191,16 @@ export function TraceList({
{selected.related.executionId ? (
Execution: {selected.related.executionId}
) : null}
+ {selected.related.compilerVersion ? (
+ Compiler: {selected.related.compilerVersion}
+ ) : null}
-
Evidence in view
+
Key metadata
- {selected.evidence.map((item) => (
+ {selected.metadata.map((item) => (
{item}
@@ -142,21 +208,55 @@ export function TraceList({
+
Review notes
+
+ {selected.evidence.map((item) => (
+
+ {item}
+
+ ))}
+
+
-
Key events
-
- {selected.events.map((event) => (
- -
-
-
-
{event.kind}
-
{event.title}
+
Ordered events
+ {selected.eventsUnavailable ? (
+
+ ) : selected.events.length === 0 ? (
+
+ ) : (
+
+ {selected.events.map((event) => (
+ -
+
+
+ {event.kind}
+
{event.title}
+
-
{event.detail}
-
- ))}
-
+
{event.detail}
+ {event.facts?.length ? (
+
+ {event.facts.map((fact) => (
+
+ {fact}
+
+ ))}
+
+ ) : null}
+
+ ))}
+
+ )}
diff --git a/apps/web/lib/api.test.ts b/apps/web/lib/api.test.ts
index c6a5e05..e65d95d 100644
--- a/apps/web/lib/api.test.ts
+++ b/apps/web/lib/api.test.ts
@@ -3,6 +3,9 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import {
ApiError,
combinePageModes,
+ getTraceDetail,
+ getTraceEvents,
+ listTraces,
pageModeLabel,
resolveApproval,
submitApprovalRequest,
@@ -154,4 +157,99 @@ describe("api helpers", () => {
}),
);
});
+
+ it("reads the shipped trace review endpoints with user-scoped query params", async () => {
+ fetchMock.mockResolvedValueOnce(
+ new Response(
+ JSON.stringify({
+ items: [
+ {
+ id: "trace-1",
+ thread_id: "thread-1",
+ kind: "context.compile",
+ compiler_version: "continuity_v0",
+ status: "completed",
+ created_at: "2026-03-17T00:00:00Z",
+ trace_event_count: 2,
+ },
+ ],
+ summary: {
+ total_count: 1,
+ order: ["created_at_desc", "id_desc"],
+ },
+ }),
+ { status: 200, headers: { "Content-Type": "application/json" } },
+ ),
+ );
+ fetchMock.mockResolvedValueOnce(
+ new Response(
+ JSON.stringify({
+ trace: {
+ id: "trace-1",
+ thread_id: "thread-1",
+ kind: "context.compile",
+ compiler_version: "continuity_v0",
+ status: "completed",
+ created_at: "2026-03-17T00:00:00Z",
+ trace_event_count: 2,
+ limits: {
+ max_sessions: 3,
+ max_events: 8,
+ },
+ },
+ }),
+ { status: 200, headers: { "Content-Type": "application/json" } },
+ ),
+ );
+ fetchMock.mockResolvedValueOnce(
+ new Response(
+ JSON.stringify({
+ items: [
+ {
+ id: "event-1",
+ trace_id: "trace-1",
+ sequence_no: 1,
+ kind: "context.summary",
+ payload: {
+ thread_id: "thread-1",
+ },
+ created_at: "2026-03-17T00:00:01Z",
+ },
+ ],
+ summary: {
+ trace_id: "trace-1",
+ total_count: 1,
+ order: ["sequence_no_asc", "id_asc"],
+ },
+ }),
+ { status: 200, headers: { "Content-Type": "application/json" } },
+ ),
+ );
+
+ await listTraces("https://api.example.com", "user-1");
+ await getTraceDetail("https://api.example.com", "trace-1", "user-1");
+ await getTraceEvents("https://api.example.com", "trace-1", "user-1");
+
+ expect(fetchMock.mock.calls).toEqual([
+ [
+ "https://api.example.com/v0/traces?user_id=user-1",
+ expect.objectContaining({
+ cache: "no-store",
+ headers: expect.objectContaining({ "Content-Type": "application/json" }),
+ }),
+ ],
+ [
+ "https://api.example.com/v0/traces/trace-1?user_id=user-1",
+ expect.objectContaining({
+ cache: "no-store",
+ }),
+ ],
+ [
+ "https://api.example.com/v0/traces/trace-1/events?user_id=user-1",
+ expect.objectContaining({
+ cache: "no-store",
+ }),
+ ],
+ ]);
+ });
});
diff --git a/apps/web/lib/api.ts b/apps/web/lib/api.ts
index e96b945..0102866 100644
--- a/apps/web/lib/api.ts
+++ b/apps/web/lib/api.ts
@@ -117,6 +117,40 @@ export type TaskStepListSummary = {
order: string[];
};
+export type TraceReviewSummaryItem = {
+ id: string;
+ thread_id: string;
+ kind: string;
+ compiler_version: string;
+ status: string;
+ created_at: string;
+ trace_event_count: number;
+};
+
+export type TraceReviewItem = TraceReviewSummaryItem & {
+ limits: Record
;
+};
+
+export type TraceReviewEventItem = {
+ id: string;
+ trace_id: string;
+ sequence_no: number;
+ kind: string;
+ payload: unknown;
+ created_at: string;
+};
+
+export type TraceReviewListSummary = {
+ total_count: number;
+ order: string[];
+};
+
+export type TraceReviewEventListSummary = {
+ trace_id: string;
+ total_count: number;
+ order: string[];
+};
+
export type ApprovalRequestPayload = {
user_id: string;
thread_id: string;
@@ -346,3 +380,30 @@ export function getTaskSteps(apiBaseUrl: string, taskId: string, userId: string)
{ user_id: userId },
);
}
+
+export function listTraces(apiBaseUrl: string, userId: string) {
+ return requestJson<{ items: TraceReviewSummaryItem[]; summary: TraceReviewListSummary }>(
+ apiBaseUrl,
+ "/v0/traces",
+ undefined,
+ { user_id: userId },
+ );
+}
+
+export function getTraceDetail(apiBaseUrl: string, traceId: string, userId: string) {
+ return requestJson<{ trace: TraceReviewItem }>(
+ apiBaseUrl,
+ `/v0/traces/${traceId}`,
+ undefined,
+ { user_id: userId },
+ );
+}
+
+export function getTraceEvents(apiBaseUrl: string, traceId: string, userId: string) {
+ return requestJson<{ items: TraceReviewEventItem[]; summary: TraceReviewEventListSummary }>(
+ apiBaseUrl,
+ `/v0/traces/${traceId}/events`,
+ undefined,
+ { user_id: userId },
+ );
+}
diff --git a/apps/web/lib/fixtures.ts b/apps/web/lib/fixtures.ts
index 46b3d0f..43d4e9c 100644
--- a/apps/web/lib/fixtures.ts
+++ b/apps/web/lib/fixtures.ts
@@ -7,6 +7,7 @@ import type {
TaskStepListSummary,
ToolRecord,
} from "./api";
+import type { TraceItem } from "../components/trace-list";
const PURCHASE_TOOL: ToolRecord = {
id: "22222222-2222-4222-8222-222222222222",
@@ -28,6 +29,178 @@ const PURCHASE_TOOL: ToolRecord = {
const THREAD_MAGNESIUM = "11111111-1111-4111-8111-111111111111";
const THREAD_VITAMIN_D = "11111111-1111-4111-8111-111111111112";
+export const traceFixtures: TraceItem[] = [
+ {
+ id: "trace-ctx-401",
+ kind: "context.compile",
+ status: "completed",
+ title: "Context compile review",
+ summary:
+ "Compiled prior task state, admitted memories, and recent thread continuity before assistant response assembly.",
+ eventCount: 3,
+ createdAt: "2026-03-17T08:45:00Z",
+ source: "continuity_v0",
+ scope: "Thread magnesium review",
+ related: {
+ threadId: "thread-magnesium",
+ compilerVersion: "continuity_v0",
+ },
+ metadata: [
+ "Trace: trace-ctx-401",
+ "Thread: thread-magnesium",
+ "Compiler: continuity_v0",
+ "Status: completed",
+ "Limit max_sessions: 3",
+ "Limit max_events: 8",
+ ],
+ evidence: [
+ "Memory evidence admitted for supplement preference and merchant history.",
+ "Recent approval state included as part of the continuity pack.",
+ "Task-step lineage referenced before response generation.",
+ ],
+ events: [
+ {
+ id: "event-1",
+ kind: "compiler.scope",
+ title: "Scope resolved",
+ detail: "Single-user thread scope and compile limits were established for the request.",
+ facts: ["Sequence 1", "Captured at Mar 17, 08:45"],
+ },
+ {
+ id: "event-2",
+ kind: "memory.retrieve",
+ title: "Memory evidence attached",
+ detail: "Preference and purchase-history memories were ranked into the response context pack.",
+ facts: ["Sequence 2", "Captured at Mar 17, 08:45"],
+ },
+ {
+ id: "event-3",
+ kind: "task.retrieve",
+ title: "Task lifecycle linked",
+ detail: "Open task and step state were included so the answer could acknowledge the approval dependency.",
+ facts: ["Sequence 3", "Captured at Mar 17, 08:45"],
+ },
+ ],
+ detailSource: "fixture",
+ eventSource: "fixture",
+ },
+ {
+ id: "trace-approval-101",
+ kind: "approval.request",
+ status: "requires_review",
+ title: "Approval request review",
+ summary:
+ "Routing required user approval before the merchant proxy could execute the purchase request.",
+ eventCount: 3,
+ createdAt: "2026-03-17T06:50:00Z",
+ source: "approval_request_v0",
+ scope: "Supplement purchase review",
+ related: {
+ threadId: "thread-magnesium",
+ taskId: "task-201",
+ approvalId: "approval-101",
+ compilerVersion: "approval_request_v0",
+ },
+ metadata: [
+ "Trace: trace-approval-101",
+ "Thread: thread-magnesium",
+ "Task: task-201",
+ "Approval: approval-101",
+ "Compiler: approval_request_v0",
+ "Status: requires_review",
+ ],
+ evidence: [
+ "Policy rule marked purchase actions as approval-gated.",
+ "Tool metadata matched the requested action and scope.",
+ "Task-step trace link points back to the original governed request.",
+ ],
+ events: [
+ {
+ id: "event-4",
+ kind: "tool.route",
+ title: "Routing completed",
+ detail: "The merchant proxy was selected as the governing tool for the request.",
+ facts: ["Sequence 1", "Captured at Mar 17, 06:50"],
+ },
+ {
+ id: "event-5",
+ kind: "approval.state",
+ title: "Approval opened",
+ detail: "Approval record persisted with pending resolution state and task-step linkage.",
+ facts: ["Sequence 2", "Captured at Mar 17, 06:50"],
+ },
+ {
+ id: "event-6",
+ kind: "task.lifecycle",
+ title: "Task updated",
+ detail: "Task lifecycle moved into a pending approval state while retaining request provenance.",
+ facts: ["Sequence 3", "Captured at Mar 17, 06:50"],
+ },
+ ],
+ detailSource: "fixture",
+ eventSource: "fixture",
+ },
+ {
+ id: "trace-exec-311",
+ kind: "tool.proxy.execute",
+ status: "completed",
+ title: "Proxy execution review",
+ summary:
+ "Approved supplement purchase request executed through the proxy handler with task and trace linkage preserved.",
+ eventCount: 3,
+ createdAt: "2026-03-16T14:24:00Z",
+ source: "proxy_execution_v0",
+ scope: "Supplement execution review",
+ related: {
+ threadId: "thread-vitamin-d",
+ taskId: "task-182",
+ approvalId: "approval-100",
+ executionId: "execution-311",
+ compilerVersion: "proxy_execution_v0",
+ },
+ metadata: [
+ "Trace: trace-exec-311",
+ "Thread: thread-vitamin-d",
+ "Task: task-182",
+ "Approval: approval-100",
+ "Execution: execution-311",
+ "Compiler: proxy_execution_v0",
+ "Status: completed",
+ ],
+ evidence: [
+ "Execution occurred only after approval resolution.",
+ "Handler output and trace references stayed attached to the governed action record.",
+ "Task and task-step lifecycle traces were appended alongside execution status.",
+ ],
+ events: [
+ {
+ id: "event-7",
+ kind: "approval.check",
+ title: "Approval validated",
+ detail: "Execution preflight confirmed the approval was in an executable state.",
+ facts: ["Sequence 1", "Captured at Mar 16, 14:24"],
+ },
+ {
+ id: "event-8",
+ kind: "budget.check",
+ title: "Budget check passed",
+ detail: "Execution budget constraints did not block the governed action.",
+ facts: ["Sequence 2", "Captured at Mar 16, 14:24"],
+ },
+ {
+ id: "event-9",
+ kind: "execution.result",
+ title: "Handler completed",
+ detail:
+ "Proxy output was recorded for the approved supplement reorder with a linked execution trace and task-step status update.",
+ facts: ["Sequence 3", "Captured at Mar 16, 14:24"],
+ },
+ ],
+ detailSource: "fixture",
+ eventSource: "fixture",
+ },
+];
+
export const requestHistoryFixtures: RequestHistoryEntry[] = [
{
id: "trace-request-101",
@@ -332,6 +505,10 @@ export function getFixtureApproval(approvalId: string) {
return approvalFixtures.find((item) => item.id === approvalId) ?? null;
}
+export function getFixtureTrace(traceId: string) {
+ return traceFixtures.find((item) => item.id === traceId) ?? null;
+}
+
export function getFixtureTask(taskId: string) {
return taskFixtures.find((item) => item.id === taskId) ?? null;
}