@guuey/chat 0.4.0

package/src/corpus/capture.ts

@@ -0,0 +1,67 @@
+/**
+ * Capture-derived corpus inputs (guuey#135 wave 3c — the lesson from 3b's
+ * dogfood finding 1: the hand-driven corpus passed while the PRODUCTION
+ * fold shape failed, because real pods fold tool results into separate
+ * `role: "tool"` messages the hand-built sequences never produce).
+ *
+ * The rule this module enforces: at least one corpus family is derived
+ * from a REAL redacted production capture, replayed through the REAL
+ * `invokeTurn` (parse → status → text fold → AgEvent ingest) — so the
+ * corpus can never again be green while production shapes are broken.
+ *
+ * Provenance: `captures/issue2627-render-capture.coalesced.sse.txt` is a byte copy
+ * of `apps/widget/src/fixtures/issue2627-render-capture.coalesced.sse.txt` — the
+ * redacted production SSE capture of a ggui-render turn (every id
+ * remapped to a stable synthetic one of the same shape, credentials
+ * dummied; see the widget's `scripts/derive-coalesced-capture.mjs`).
+ * COALESCED is the valid production shape; the RAW variant of the same
+ * capture deliberately parks the Reducer and stays in the widget as that
+ * regression's pin. Captures are immutable records, so the copy cannot
+ * drift.
+ */
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { invokeTurn, type InvokeTurnEvent } from "@guuey/agent-client";
+import { driveTurn, type DriveOptions } from "./drive.js";
+import type { TranscriptInputs } from "../types.js";
+
+const CAPTURES = join(import.meta.dirname, "captures");
+
+/** The capture's (redacted) render locator — what R6's actionScope must be. */
+export const CAPTURE_RENDER_URI =
+  "ui://ggui/render/render_00000000-0000-4000-8000-300000000001/c10a20553df2349b";
+
+/**
+ * Replay a capture through the REAL `invokeTurn`, chunked adversarially
+ * (fixed-size slices that split SSE frames mid-line) so the parse path is
+ * exercised the way a network delivers it, not a fixture's convenience.
+ */
+export async function captureTurnEvents(
+  file: string,
+  chunkSize = 512,
+): Promise<InvokeTurnEvent[]> {
+  const text = readFileSync(join(CAPTURES, file), "utf8");
+  const transport = async function* (): AsyncGenerator<string> {
+    for (let at = 0; at < text.length; at += chunkSize) {
+      yield text.slice(at, at + chunkSize);
+    }
+  };
+  const events: InvokeTurnEvent[] = [];
+  const req = {
+    url: "https://capture.replay.invalid/agent/invoke",
+    body: { input: "capture replay" },
+    signal: new AbortController().signal,
+  };
+  for await (const event of invokeTurn(req, transport)) events.push(event);
+  return events;
+}
+
+/** The ggui-render production capture as `TranscriptInputs`. */
+export async function productionGguiRenderCapture(
+  opts: DriveOptions = {},
+): Promise<TranscriptInputs> {
+  const events = await captureTurnEvents("issue2627-render-capture.coalesced.sse.txt");
+  // The capture ends without a `done` frame (capture-time truncation);
+  // the corpus family asserts the SETTLED plan, so the drive settles it.
+  return driveTurn(events, { userText: "capture replay", finalStatus: "ready", ...opts });
+}

package/src/corpus/captures/issue2627-render-capture.coalesced.sse.txt

@@ -0,0 +1,173 @@
+event: session
+data: {"sessionId":"00000000-0000-4000-8000-100000000001","userId":"g_000000000000000000000000000001","authMode":"anonymous","threadId":"00000000-0000-4000-8000-100000000002"}
+
+event: message
+data: {"type":"turn.start","seq":0,"turnId":"turn_00000000-0000-4000-8000-200000000001","threadId":"00000000-0000-4000-8000-100000000003"}
+
+event: message
+data: {"type":"message.start","seq":1,"id":"msg_000000000000000000000001","turnId":"turn_00000000-0000-4000-8000-200000000001","threadId":"00000000-0000-4000-8000-100000000003","role":"assistant","model":"claude-sonnet-5"}
+
+event: message
+data: {"type":"reasoning.start","seq":2,"id":"msg_000000000000000000000001:reasoning:0","messageId":"msg_000000000000000000000001","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.delta","seq":3,"id":"msg_000000000000000000000001:reasoning:0","messageId":"msg_000000000000000000000001","delta":"","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.end","seq":4,"id":"msg_000000000000000000000001:reasoning:0","messageId":"msg_000000000000000000000001","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.opaque","seq":5,"id":"msg_000000000000000000000001:reasoning:0","messageId":"msg_000000000000000000000001","kind":"signature","value":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","turnId":"turn_00000000-0000-4000-8000-200000000001","provider":"anthropic"}
+
+event: message
+data: {"type":"tool.start","seq":6,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000001","name":"mcp__todo__todo_create","index":0,"messageId":"msg_000000000000000000000001","providerExecuted":false}
+
+event: message
+data: {"type":"tool.args.delta","seq":7,"toolCallId":"toolu_000000000000000000000001","delta":"{\"title\":\"Buy milk\"}"}
+
+event: message
+data: {"type":"tool.args.assembled","seq":8,"toolCallId":"toolu_000000000000000000000001","input":{"title":"Buy milk"}}
+
+event: message
+data: {"type":"message.end","seq":9,"id":"msg_000000000000000000000001","usage":{"inputTokens":2,"outputTokens":2,"cacheReadTokens":11664,"cacheWriteTokens":206,"cumulative":true}}
+
+event: message
+data: {"type":"tool.done","seq":10,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000001","content":[{"type":"text","text":"{\"id\":\"00000000-0000-4000-8000-100000000004\",\"title\":\"Buy milk\",\"done\":false}"}],"outcome":"ok","isError":false,"messageId":"toolu_000000000000000000000001:result","structuredContent":{"id":"00000000-0000-4000-8000-100000000004","title":"Buy milk","done":false}}
+
+event: message
+data: {"type":"message.start","seq":11,"id":"msg_000000000000000000000002","turnId":"turn_00000000-0000-4000-8000-200000000001","threadId":"00000000-0000-4000-8000-100000000003","role":"assistant","model":"claude-sonnet-5"}
+
+event: message
+data: {"type":"reasoning.start","seq":12,"id":"msg_000000000000000000000002:reasoning:0","messageId":"msg_000000000000000000000002","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.delta","seq":13,"id":"msg_000000000000000000000002:reasoning:0","messageId":"msg_000000000000000000000002","delta":"","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.end","seq":14,"id":"msg_000000000000000000000002:reasoning:0","messageId":"msg_000000000000000000000002","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.opaque","seq":15,"id":"msg_000000000000000000000002:reasoning:0","messageId":"msg_000000000000000000000002","kind":"signature","value":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","turnId":"turn_00000000-0000-4000-8000-200000000001","provider":"anthropic"}
+
+event: message
+data: {"type":"tool.start","seq":16,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000002","name":"mcp__todo__todo_list","index":0,"messageId":"msg_000000000000000000000002","providerExecuted":false}
+
+event: message
+data: {"type":"tool.args.delta","seq":17,"toolCallId":"toolu_000000000000000000000002","delta":"{}"}
+
+event: message
+data: {"type":"tool.args.assembled","seq":18,"toolCallId":"toolu_000000000000000000000002","input":{}}
+
+event: message
+data: {"type":"tool.start","seq":19,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000003","name":"mcp__ggui__ggui_discover","index":0,"messageId":"msg_000000000000000000000002","providerExecuted":false}
+
+event: message
+data: {"type":"tool.args.delta","seq":20,"toolCallId":"toolu_000000000000000000000003","delta":"{}"}
+
+event: message
+data: {"type":"tool.args.assembled","seq":21,"toolCallId":"toolu_000000000000000000000003","input":{}}
+
+event: message
+data: {"type":"message.end","seq":22,"id":"msg_000000000000000000000002","usage":{"inputTokens":2,"outputTokens":2,"cacheReadTokens":11870,"cacheWriteTokens":128,"cumulative":true}}
+
+event: message
+data: {"type":"tool.done","seq":23,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000002","content":[{"type":"text","text":"{\"todos\":[{\"id\":\"00000000-0000-4000-8000-100000000004\",\"title\":\"Buy milk\",\"done\":false}]}"}],"outcome":"ok","isError":false,"messageId":"toolu_000000000000000000000002:result","structuredContent":{"todos":[{"id":"00000000-0000-4000-8000-100000000004","title":"Buy milk","done":false}]}}
+
+event: message
+data: {"type":"tool.done","seq":24,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000003","content":[{"type":"text","text":"{\"protocolVersion\":\"draft-2026-06-12\",\"contentTypes\":[\"application/javascript+react\"],\"shellTypes\":[\"chat\",\"fullscreen\",\"spatial\"],\"adapterTypes\":[\"voice\",\"camera\",\"location\",\"bluetooth\"],\"componentCapabilities\":[\"network\",\"storage\",\"dom\",\"eval\",\"navigation\",\"device\"]}"}],"outcome":"ok","isError":false,"messageId":"toolu_000000000000000000000003:result","structuredContent":{"protocolVersion":"draft-2026-06-12","contentTypes":["application/javascript+react"],"shellTypes":["chat","fullscreen","spatial"],"adapterTypes":["voice","camera","location","bluetooth"],"componentCapabilities":["network","storage","dom","eval","navigation","device"]}}
+
+event: message
+data: {"type":"message.start","seq":25,"id":"msg_000000000000000000000003","turnId":"turn_00000000-0000-4000-8000-200000000001","threadId":"00000000-0000-4000-8000-100000000003","role":"assistant","model":"claude-sonnet-5"}
+
+event: message
+data: {"type":"reasoning.start","seq":26,"id":"msg_000000000000000000000003:reasoning:0","messageId":"msg_000000000000000000000003","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.delta","seq":27,"id":"msg_000000000000000000000003:reasoning:0","messageId":"msg_000000000000000000000003","delta":"","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.end","seq":28,"id":"msg_000000000000000000000003:reasoning:0","messageId":"msg_000000000000000000000003","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"reasoning.opaque","seq":29,"id":"msg_000000000000000000000003:reasoning:0","messageId":"msg_000000000000000000000003","kind":"signature","value":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","turnId":"turn_00000000-0000-4000-8000-200000000001","provider":"anthropic"}
+
+event: message
+data: {"type":"tool.start","seq":30,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000004","name":"mcp__ggui__ggui_handshake","index":0,"messageId":"msg_000000000000000000000003","providerExecuted":false}
+
+event: message
+data: {"type":"tool.args.delta","seq":31,"toolCallId":"toolu_000000000000000000000004","delta":"{\"intent\":\"Show a rich todo list card with items that can be toggled done/undone\",\"blueprintDraft\":{\"contract\":{\"propsSpec\":{\"properties\":{\"todos\":{\"schema\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"},\"title\":{\"type\":\"string\"},\"done\":{\"type\":\"boolean\"}},\"required\":[\"id\",\"title\",\"done\"]}},\"description\":\"List of todo items\"}}},\"actionSpec\":{\"toggle\":{\"label\":\"Toggle done\",\"description\":\"Toggle a todo's done state\",\"schema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\"}},\"required\":[\"id\"]},\"nextStep\":\"todo_toggle\"}},\"agentCapabilities\":{\"tools\":{\"todo_toggle\":{\"toolInfo\":{\"description\":\"Flip a todo's done state.\",\"inputSchema\":{\"type\":\"object\",\"properties\":{\"id\":{\"type\":\"string\",\"description\":\"Todo id.\"}},\"required\":[\"id\"]}},\"serverInfo\":{\"name\":\"todo\"}}}}}}}"}
+
+event: message
+data: {"type":"tool.args.assembled","seq":32,"toolCallId":"toolu_000000000000000000000004","input":{"intent":"Show a rich todo list card with items that can be toggled done/undone","blueprintDraft":{"contract":{"propsSpec":{"properties":{"todos":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"},"done":{"type":"boolean"}},"required":["id","title","done"]}},"description":"List of todo items"}}},"actionSpec":{"toggle":{"label":"Toggle done","description":"Toggle a todo's done state","schema":{"type":"object","properties":{"id":{"type":"string"}},"required":["id"]},"nextStep":"todo_toggle"}},"agentCapabilities":{"tools":{"todo_toggle":{"toolInfo":{"description":"Flip a todo's done state.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Todo id."}},"required":["id"]}},"serverInfo":{"name":"todo"}}}}}}}}
+
+event: message
+data: {"type":"message.end","seq":33,"id":"msg_000000000000000000000003","usage":{"inputTokens":2,"outputTokens":4,"cacheReadTokens":11998,"cacheWriteTokens":320,"cumulative":true}}
+
+event: message
+data: {"type":"tool.done","seq":34,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000004","content":[{"type":"text","text":"{\"handshakeId\":\"00000000-0000-4000-8000-100000000005\",\"action\":\"create\",\"suggestion\":{\"origin\":\"agent\",\"rationale\":\"agent draft passed validateContract; accepted verbatim (origin: agent)\",\"blueprintMeta\":{\"contractHash\":\"c10a20553df2349b\",\"variance\":{}},\"proposedContractSummary\":\"slots=∅; actions=toggle(id); streams=∅; props=todos:array\",\"validationFindings\":[{\"code\":\"LINT_MISSING_USAGE\",\"severity\":\"warn\",\"path\":\"agentCapabilities.tools.todo_toggle.usage\",\"message\":\"agentCapabilities.tools.todo_toggle has no 'usage' prose. The agent's reasoning loop reads usage as context-of-use; tools without it tend to get invoked at the wrong time.\"},{\"code\":\"LINT_MISSING_EXAMPLE\",\"severity\":\"warn\",\"path\":\"agentCapabilities.tools.todo_toggle.example\",\"message\":\"agentCapabilities.tools.todo_toggle has no 'example'. Examples ground the agent's invocation patterns; tools without one are harder to use correctly on the first call.\"}]},\"nextStep\":{\"tool\":\"ggui_render\",\"example\":\"ggui_render({\\\"handshakeId\\\":\\\"00000000-0000-4000-8000-100000000005\\\",\\\"props\\\":{}})\"}}"}],"outcome":"ok","isError":false,"messageId":"toolu_000000000000000000000004:result","structuredContent":{"handshakeId":"00000000-0000-4000-8000-100000000005","action":"create","suggestion":{"origin":"agent","rationale":"agent draft passed validateContract; accepted verbatim (origin: agent)","blueprintMeta":{"contractHash":"c10a20553df2349b","variance":{}},"proposedContractSummary":"slots=∅; actions=toggle(id); streams=∅; props=todos:array","validationFindings":[{"code":"LINT_MISSING_USAGE","severity":"warn","path":"agentCapabilities.tools.todo_toggle.usage","message":"agentCapabilities.tools.todo_toggle has no 'usage' prose. The agent's reasoning loop reads usage as context-of-use; tools without it tend to get invoked at the wrong time."},{"code":"LINT_MISSING_EXAMPLE","severity":"warn","path":"agentCapabilities.tools.todo_toggle.example","message":"agentCapabilities.tools.todo_toggle has no 'example'. Examples ground the agent's invocation patterns; tools without one are harder to use correctly on the first call."}]},"nextStep":{"tool":"ggui_render","example":"ggui_render({\"handshakeId\":\"00000000-0000-4000-8000-100000000005\",\"props\":{}})"}}}
+
+event: message
+data: {"type":"message.start","seq":35,"id":"msg_000000000000000000000004","turnId":"turn_00000000-0000-4000-8000-200000000001","threadId":"00000000-0000-4000-8000-100000000003","role":"assistant","model":"claude-sonnet-5"}
+
+event: message
+data: {"type":"tool.start","seq":36,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000005","name":"mcp__ggui__ggui_render","index":0,"messageId":"msg_000000000000000000000004","providerExecuted":false}
+
+event: message
+data: {"type":"tool.args.delta","seq":37,"toolCallId":"toolu_000000000000000000000005","delta":"{\"handshakeId\":\"00000000-0000-4000-8000-100000000005\",\"props\":{\"todos\":[{\"id\":\"00000000-0000-4000-8000-100000000004\",\"title\":\"Buy milk\",\"done\":false}]}}"}
+
+event: message
+data: {"type":"tool.args.assembled","seq":38,"toolCallId":"toolu_000000000000000000000005","input":{"handshakeId":"00000000-0000-4000-8000-100000000005","props":{"todos":[{"id":"00000000-0000-4000-8000-100000000004","title":"Buy milk","done":false}]}}}
+
+event: message
+data: {"type":"message.end","seq":39,"id":"msg_000000000000000000000004","usage":{"inputTokens":2,"outputTokens":66,"cacheReadTokens":12318,"cacheWriteTokens":956,"cumulative":true}}
+
+event: message
+data: {"type":"tool.done","seq":40,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000005","content":[{"type":"text","text":"{\"sessionId\":\"render_00000000-0000-4000-8000-300000000001\",\"resourceUri\":\"ui://ggui/render/render_00000000-0000-4000-8000-300000000001/c10a20553df2349b\",\"action\":\"create\",\"contractHash\":\"c10a20553df2349b\",\"blueprintId\":\"bp_00000000-0000-4000-8000-400000000001\",\"variantKey\":\"44136fa355b3678a\",\"cache\":{\"hit\":false,\"llmCallsAvoided\":0,\"kind\":\"cold\",\"reason\":\"cold: generated fresh — no stored component was reused for this render\"},\"nextStep\":{\"tool\":\"ggui_consume\",\"description\":\"Drain the action pipe for this render — long-polls until a user gesture arrives or 15s timeout.\",\"example\":\"ggui_consume({ sessionId: \\\"render_00000000-0000-4000-8000-300000000001\\\" })\",\"args\":{\"sessionId\":\"render_00000000-0000-4000-8000-300000000001\"}}}"}],"outcome":"ok","isError":false,"messageId":"toolu_000000000000000000000005:result","uiData":{"sessionId":"render_00000000-0000-4000-8000-300000000001","resourceUri":"ui://ggui/render/render_00000000-0000-4000-8000-300000000001/c10a20553df2349b","action":"create","contractHash":"c10a20553df2349b","blueprintId":"bp_00000000-0000-4000-8000-400000000001","variantKey":"44136fa355b3678a","cache":{"hit":false,"llmCallsAvoided":0,"kind":"cold","reason":"cold: generated fresh — no stored component was reused for this render"},"nextStep":{"tool":"ggui_consume","description":"Drain the action pipe for this render — long-polls until a user gesture arrives or 15s timeout.","example":"ggui_consume({ sessionId: \"render_00000000-0000-4000-8000-300000000001\" })","args":{"sessionId":"render_00000000-0000-4000-8000-300000000001"}}},"_meta":{"ai.ggui/render":{"sessionId":"render_00000000-0000-4000-8000-300000000001","appId":"APP00000","runtimeUrl":"https://dev.mcp.sandbox.ggui.ai/_ggui/iframe-runtime.js","wsUrl":"wss://dev.mcp.sandbox.ggui.ai/ws","wsToken":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJraW5kIjoid3MiLCJpYXQiOjAsImV4cCI6MH0.AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","expiresAt":"2026-07-29T11:07:58.000Z","lastSequence":0,"propsJson":"{\"todos\":[{\"id\":\"00000000-0000-4000-8000-100000000004\",\"title\":\"Buy milk\",\"done\":false}]}"},"ui":{"resourceUri":"ui://ggui/render/render_00000000-0000-4000-8000-300000000001/c10a20553df2349b"},"ui/resourceUri":"ui://ggui/render/render_00000000-0000-4000-8000-300000000001/c10a20553df2349b"}}
+
+event: message
+data: {"type":"message.start","seq":41,"id":"msg_000000000000000000000005","turnId":"turn_00000000-0000-4000-8000-200000000001","threadId":"00000000-0000-4000-8000-100000000003","role":"assistant","model":"claude-sonnet-5"}
+
+event: message
+data: {"type":"text.start","seq":42,"id":"msg_000000000000000000000005:text:0","messageId":"msg_000000000000000000000005","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"text.delta","seq":43,"id":"msg_000000000000000000000005:text:0","messageId":"msg_000000000000000000000005","delta":"I created \"Buy milk\" and rendered your todo list as a rich UI card — it currently shows that one item, unchecked. I'll keep listening for any toggle actions you make in the card.","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"text.end","seq":44,"id":"msg_000000000000000000000005:text:0","messageId":"msg_000000000000000000000005","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"tool.start","seq":45,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000006","name":"mcp__ggui__ggui_consume","index":0,"messageId":"msg_000000000000000000000005","providerExecuted":false}
+
+event: message
+data: {"type":"tool.args.delta","seq":46,"toolCallId":"toolu_000000000000000000000006","delta":"{\"sessionId\":\"render_00000000-0000-4000-8000-300000000001\",\"timeout\":20}"}
+
+event: message
+data: {"type":"tool.args.assembled","seq":47,"toolCallId":"toolu_000000000000000000000006","input":{"sessionId":"render_00000000-0000-4000-8000-300000000001","timeout":20}}
+
+event: message
+data: {"type":"message.end","seq":48,"id":"msg_000000000000000000000005","usage":{"inputTokens":2,"outputTokens":1,"cacheReadTokens":13274,"cacheWriteTokens":543,"cumulative":true}}
+
+event: message
+data: {"type":"tool.done","seq":49,"turnId":"turn_00000000-0000-4000-8000-200000000001","toolCallId":"toolu_000000000000000000000006","content":[{"type":"text","text":"{\"events\":[],\"status\":\"active\"}"}],"outcome":"ok","isError":false,"messageId":"toolu_000000000000000000000006:result","structuredContent":{"events":[],"status":"active"}}
+
+event: message
+data: {"type":"message.start","seq":50,"id":"msg_000000000000000000000006","turnId":"turn_00000000-0000-4000-8000-200000000001","threadId":"00000000-0000-4000-8000-100000000003","role":"assistant","model":"claude-sonnet-5"}
+
+event: message
+data: {"type":"text.start","seq":51,"id":"msg_000000000000000000000006:text:0","messageId":"msg_000000000000000000000006","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"text.delta","seq":52,"id":"msg_000000000000000000000006:text:0","messageId":"msg_000000000000000000000006","delta":"No actions yet — the card is live and waiting for you. Let me know if you'd like to check it off, add more todos, or anything else, and I'll update the UI accordingly.","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"text.end","seq":53,"id":"msg_000000000000000000000006:text:0","messageId":"msg_000000000000000000000006","turnId":"turn_00000000-0000-4000-8000-200000000001"}
+
+event: message
+data: {"type":"message.end","seq":54,"id":"msg_000000000000000000000006","usage":{"inputTokens":2,"outputTokens":1,"cacheReadTokens":13817,"cacheWriteTokens":189,"cumulative":true}}
+
+event: message
+data: {"type":"turn.done","seq":55,"turnId":"turn_00000000-0000-4000-8000-200000000001","outcome":{"type":"success","result":"No actions yet — the card is live and waiting for you. Let me know if you'd like to check it off, add more todos, or anything else, and I'll update the UI accordingly."},"finishReason":"stop","usage":{"inputTokens":12,"outputTokens":1112,"cacheReadTokens":74941,"cacheWriteTokens":2342,"serverToolRequests":0,"costUsd":0.0479808,"cumulative":true,"byModel":{"claude-sonnet-5":{"inputTokens":12,"outputTokens":1112,"cacheReadTokens":74941,"cacheWriteTokens":2342,"costUsd":0.0479808,"serverToolRequests":0,"cumulative":true}}}}
+
+event: done
+data: {"stopReason":"end_turn","threadId":"00000000-0000-4000-8000-100000000002","userSeq":1,"agentSeq":2}

package/src/corpus/drive.ts

@@ -0,0 +1,184 @@
+/**
+ * The corpus's turn driver: recorded `InvokeTurnEvent[]` sequences →
+ * `TranscriptInputs`, applying the SAME accumulation rules the live hook
+ * documents (status transitions, cumulative text, agEvents → the REAL
+ * `@silverprotocol/core` Reducer). Test-only plumbing — excluded from the
+ * build; the 3b live/history assemblers are the production twins.
+ */
+import { Reducer, type AgEvent } from "@silverprotocol/core";
+import type { InvokeTurnEvent } from "@guuey/agent-client";
+import type { PromptItemInput, TranscriptInputs, TranscriptMessage } from "../types.js";
+
+export interface DriveOptions {
+  userText?: string;
+  clientMessageId?: string;
+  /** Override the derived status (mid-stream plan points). */
+  finalStatus?: TranscriptInputs["status"];
+  statusElapsedMs?: number;
+  aborted?: boolean;
+  adopted?: boolean;
+  sendStates?: TranscriptInputs["sendStates"];
+  viewPhases?: TranscriptInputs["viewPhases"];
+  historyCards?: TranscriptInputs["historyCards"];
+  historyState?: TranscriptInputs["historyState"];
+  /** Resolve accumulated prompts to this state (fixture 4's answered leg). */
+  promptState?: PromptItemInput["state"];
+}
+
+export function driveTurn(events: InvokeTurnEvent[], opts: DriveOptions = {}): TranscriptInputs {
+  const reducer = new Reducer();
+  let sawAgEvents = false;
+  let status: TranscriptInputs["status"] = "connecting";
+  let assistantText = "";
+  let activeTool: string | null = null;
+  let error: TranscriptInputs["error"] = null;
+  const prompts: PromptItemInput[] = [];
+  let done = false;
+
+  for (const ev of events) {
+    switch (ev.kind) {
+      case "session":
+        if (status === "connecting") status = "thinking";
+        break;
+      case "message":
+        if (ev.status !== undefined) status = ev.status;
+        if (ev.activeTool !== undefined) activeTool = ev.activeTool;
+        assistantText = ev.assistantText;
+        for (const ag of ev.agEvents) {
+          sawAgEvents = true;
+          reducer.push(ag);
+        }
+        break;
+      case "error":
+        error = { message: ev.message, code: ev.code };
+        status = "ready";
+        break;
+      case "profile-consent":
+        prompts.push({
+          id: `consent-${prompts.length}`,
+          kind: "consent",
+          appId: ev.request.appId,
+          requested: ev.request.requested,
+          state: opts.promptState ?? "pending",
+        });
+        break;
+      case "profile-link":
+        prompts.push({
+          id: `link-${prompts.length}`,
+          kind: "link",
+          appId: ev.request.appId,
+          requested: ev.request.requested,
+          state: opts.promptState ?? "pending",
+        });
+        break;
+      case "done":
+        done = true;
+        status = "ready";
+        activeTool = null;
+        break;
+    }
+  }
+  if (opts.aborted === true) status = "ready";
+
+  const messages: TranscriptMessage[] = [];
+  if (opts.userText !== undefined) {
+    messages.push({
+      role: "user",
+      text: opts.userText,
+      ...(opts.clientMessageId !== undefined ? { clientMessageId: opts.clientMessageId } : {}),
+    });
+  }
+  // A settled BYPASS turn's text moves into the flat transcript (the hook's
+  // behaviour); silver turns stay owned by the fold.
+  if (done && !sawAgEvents && assistantText !== "" && opts.aborted !== true) {
+    messages.push({ role: "assistant", text: assistantText });
+  }
+
+  return {
+    result: sawAgEvents ? reducer.result() : null,
+    assistantText,
+    status: opts.finalStatus ?? status,
+    statusElapsedMs: opts.statusElapsedMs ?? 0,
+    activeTool,
+    error,
+    prompts,
+    messages,
+    ...(opts.sendStates !== undefined ? { sendStates: opts.sendStates } : {}),
+    ...(opts.viewPhases !== undefined ? { viewPhases: opts.viewPhases } : {}),
+    ...(opts.historyCards !== undefined ? { historyCards: opts.historyCards } : {}),
+    ...(opts.historyState !== undefined ? { historyState: opts.historyState } : {}),
+    ...(opts.aborted === true ? { aborted: true } : {}),
+    ...(opts.adopted === true ? { adopted: true } : {}),
+  };
+}
+
+// ─── Event builders (shared fixture vocabulary) ───────────────────────────
+
+export const THREAD = "thread-corpus";
+export const TURN = "turn-corpus";
+export const MSG = "msg-corpus";
+
+/** A per-fixture monotonically increasing seq source. */
+export function seqSource(): () => number {
+  let n = 0;
+  return () => n++;
+}
+
+/** The silver turn's lifecycle boot: turn.start + an open assistant message. */
+export function boot(next: () => number): AgEvent[] {
+  return [
+    { type: "turn.start", threadId: THREAD, turnId: TURN, seq: next() },
+    { type: "message.start", id: MSG, role: "assistant", turnId: TURN, threadId: THREAD, seq: next() },
+  ];
+}
+
+/** A complete streamed text part. */
+export function textPart(next: () => number, id: string, text: string): AgEvent[] {
+  return [
+    { type: "text.start", id, seq: next() },
+    { type: "text.delta", id, delta: text, seq: next() },
+    { type: "text.end", id, seq: next() },
+  ];
+}
+
+/** A complete tool call: start + assembled args + done. */
+export function toolPart(
+  next: () => number,
+  toolCallId: string,
+  name: string,
+  result: Partial<Extract<AgEvent, { type: "tool.done" }>> = {},
+): AgEvent[] {
+  return [
+    { type: "tool.start", toolCallId, name, seq: next() },
+    { type: "tool.args.assembled", toolCallId, input: { q: name }, seq: next() },
+    {
+      type: "tool.done",
+      toolCallId,
+      content: [{ type: "text", text: "ok" }],
+      outcome: "ok",
+      ...result,
+      seq: next(),
+    },
+  ];
+}
+
+/** Wrap agEvents into the `message` frame the pod emits. */
+export function frame(
+  agEvents: AgEvent[],
+  extra: {
+    status?: "thinking" | "using-tool" | "responding";
+    activeTool?: string | null;
+    text?: string;
+  } = {},
+): InvokeTurnEvent {
+  return {
+    kind: "message",
+    ...(extra.status !== undefined ? { status: extra.status } : {}),
+    ...(extra.activeTool !== undefined ? { activeTool: extra.activeTool } : {}),
+    assistantText: extra.text ?? "",
+    agEvents,
+  };
+}
+
+export const session: InvokeTurnEvent = { kind: "session", threadId: THREAD };
+export const doneEvent: InvokeTurnEvent = { kind: "done", stopReason: "end_turn" };