@ai-matrx/agents 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.2.0 — 2026-08-22
+
+- Added a framework-free request event projector for identity, status, answer/reasoning, phases, operations, tools, render blocks, Content IR metadata, completion, and errors.
+- Added golden lifecycle fixtures, replay suppression, and copy-on-write guarantees.
+- Added conditional ESM/CommonJS artifacts and loader canaries for mixed Vite, Next.js, and Jest consumers.
+
 ## 0.1.0 — 2026-08-22
 
 - Published the canonical NDJSON stream reader and envelope normalizer.

package/dist/index.cjs

@@ -0,0 +1,366 @@
+'use strict';
+
+// stream/ndjson.ts
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function normalizeMatrxStreamEnvelope(value) {
+  if (!isRecord(value)) return null;
+  if (typeof value.event === "string") {
+    return { event: value.event, data: value.data };
+  }
+  if (value.e === "c" && typeof value.t === "string") {
+    return { event: "chunk", data: { text: value.t } };
+  }
+  if (value.e === "r" && typeof value.t === "string") {
+    return { event: "reasoning_chunk", data: { text: value.t } };
+  }
+  return null;
+}
+async function* readMatrxNdjsonStream(body, options = {}) {
+  const queue = [];
+  let wakeConsumer = null;
+  let readerFinished = false;
+  const enqueue = (item) => {
+    queue.push(item);
+    const wake = wakeConsumer;
+    wakeConsumer = null;
+    wake?.();
+  };
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  const parseLine = (line) => {
+    const trimmed = line.trim();
+    if (!trimmed) return;
+    let parsed;
+    try {
+      parsed = JSON.parse(trimmed);
+    } catch (error) {
+      options.onMalformedLine?.({ line: trimmed, error });
+      return;
+    }
+    const envelope = normalizeMatrxStreamEnvelope(parsed);
+    if (envelope) {
+      enqueue({ kind: "event", value: envelope });
+    } else {
+      options.onUnknownEnvelope?.(parsed);
+    }
+  };
+  const onAbort = () => {
+    void reader.cancel(options.signal?.reason).catch(() => void 0);
+  };
+  options.signal?.addEventListener("abort", onAbort, { once: true });
+  const readerPromise = (async () => {
+    let buffer = "";
+    try {
+      while (!options.signal?.aborted) {
+        const { value, done } = await reader.read();
+        if (done) break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split("\n");
+        buffer = lines.pop() ?? "";
+        for (const line of lines) parseLine(line);
+      }
+      buffer += decoder.decode();
+      if (!options.signal?.aborted && buffer.trim()) parseLine(buffer);
+    } catch (error) {
+      const aborted = options.signal?.aborted || error instanceof Error && error.name === "AbortError";
+      if (!aborted) enqueue({ kind: "error", error });
+    } finally {
+      readerFinished = true;
+      reader.releaseLock();
+      enqueue({ kind: "done" });
+    }
+  })();
+  try {
+    while (true) {
+      if (queue.length === 0) {
+        await new Promise((resolve) => {
+          wakeConsumer = resolve;
+        });
+      }
+      const item = queue.shift();
+      if (!item || item.kind === "done") return;
+      if (item.kind === "error") throw item.error;
+      yield item.value;
+    }
+  } finally {
+    options.signal?.removeEventListener("abort", onAbort);
+    if (!readerFinished) {
+      await reader.cancel().catch(() => void 0);
+    }
+    await readerPromise;
+  }
+}
+
+// presentation/result.ts
+var PRIVATE_REASONING_TYPES = /* @__PURE__ */ new Set([
+  "thinking",
+  "redacted_thinking",
+  "reasoning"
+]);
+var PRIVATE_PROVIDER_KEYS = /* @__PURE__ */ new Set([
+  "thought_signature",
+  "thoughtSignature",
+  "google_thought_signature",
+  "anthropic_signature",
+  "encrypted_content",
+  "signature_encoding"
+]);
+var SIGNATURE_PROVIDERS = /* @__PURE__ */ new Set([
+  "anthropic",
+  "google",
+  "openai"
+]);
+var OPAQUE_SIGNATURE_MIN_LENGTH = 200;
+var OMIT = /* @__PURE__ */ Symbol("omit-provider-private-value");
+function isRecord2(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isPrivateReasoningBlock(value) {
+  return typeof value.type === "string" && PRIVATE_REASONING_TYPES.has(value.type.toLowerCase());
+}
+function isPrivateProviderKey(key, value, parent) {
+  if (PRIVATE_PROVIDER_KEYS.has(key)) return true;
+  if (key !== "signature") return false;
+  const provider = typeof parent.provider === "string" ? parent.provider.toLowerCase() : "";
+  return "signature_encoding" in parent || SIGNATURE_PROVIDERS.has(provider) || typeof value === "string" && value.length >= OPAQUE_SIGNATURE_MIN_LENGTH;
+}
+function project(value) {
+  if (Array.isArray(value)) {
+    let changed2 = false;
+    const output2 = [];
+    for (const item of value) {
+      const projected = project(item);
+      if (projected === OMIT) {
+        changed2 = true;
+        continue;
+      }
+      if (projected !== item) changed2 = true;
+      output2.push(projected);
+    }
+    return changed2 ? output2 : value;
+  }
+  if (!isRecord2(value)) return value;
+  if (isPrivateReasoningBlock(value)) return OMIT;
+  let changed = false;
+  const output = {};
+  for (const [key, child] of Object.entries(value)) {
+    if (isPrivateProviderKey(key, child, value)) {
+      changed = true;
+      continue;
+    }
+    const projected = project(child);
+    if (projected === OMIT) {
+      changed = true;
+      continue;
+    }
+    if (projected !== child) changed = true;
+    output[key] = projected;
+  }
+  return changed ? output : value;
+}
+function projectAgentResultForDisplay(value) {
+  const projected = project(value);
+  return projected === OMIT ? null : projected;
+}
+
+// projection/request.ts
+var asRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+var asString = (value) => typeof value === "string" ? value : null;
+var asNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : null;
+function createAgentRequestProjection(input) {
+  return {
+    requestId: input.requestId,
+    conversationId: input.conversationId ?? null,
+    status: "pending",
+    answer: "",
+    reasoning: "",
+    reasoningActive: false,
+    phase: null,
+    phaseHistory: [],
+    operations: {},
+    tools: {},
+    renderBlocks: {},
+    renderBlockOrder: [],
+    completion: null,
+    error: null,
+    lastTransportSeq: 0,
+    eventCount: 0
+  };
+}
+function toolStatus(event) {
+  switch (event) {
+    case "tool_started":
+      return "started";
+    case "tool_step":
+      return "step";
+    case "tool_result_preview":
+      return "preview";
+    case "tool_completed":
+      return "completed";
+    case "tool_error":
+      return "error";
+    case "tool_delegated":
+      return "delegated";
+    default:
+      return "progress";
+  }
+}
+function projectAgentEvent(current, event) {
+  const streamSeq = asNumber(event.stream_seq);
+  if (streamSeq !== null && streamSeq <= current.lastTransportSeq) return current;
+  const data = asRecord(event.data);
+  const next = {
+    ...current,
+    status: current.status === "pending" ? "streaming" : current.status,
+    lastTransportSeq: streamSeq ?? current.lastTransportSeq,
+    eventCount: current.eventCount + 1
+  };
+  switch (event.event) {
+    case "chunk": {
+      const text = asString(data.text);
+      return text === null ? next : { ...next, answer: current.answer + text };
+    }
+    case "reasoning_chunk": {
+      const text = asString(data.text);
+      return text === null ? next : {
+        ...next,
+        reasoning: current.reasoning + text,
+        reasoningActive: true
+      };
+    }
+    case "reasoning":
+      return {
+        ...next,
+        reasoningActive: data.state === "started"
+      };
+    case "phase": {
+      const phase = asString(data.phase);
+      if (phase === null) return next;
+      return {
+        ...next,
+        phase,
+        phaseHistory: [...current.phaseHistory, phase]
+      };
+    }
+    case "init": {
+      const operationId = asString(data.operation_id);
+      const operation = asString(data.operation);
+      if (operationId === null || operation === null) return next;
+      return {
+        ...next,
+        operations: {
+          ...current.operations,
+          [operationId]: {
+            operationId,
+            operation,
+            parentOperationId: asString(data.parent_operation_id),
+            status: "active",
+            metadata: Object.keys(asRecord(data.metadata)).length ? asRecord(data.metadata) : null,
+            result: null
+          }
+        }
+      };
+    }
+    case "completion": {
+      const operationId = asString(data.operation_id);
+      const operation = asString(data.operation);
+      const rawStatus = asString(data.status);
+      const status = rawStatus === "failed" || rawStatus === "cancelled" ? rawStatus : "success";
+      const result = asRecord(data.result);
+      const operations = operationId ? {
+        ...current.operations,
+        [operationId]: {
+          ...current.operations[operationId] ?? {
+            operationId,
+            operation: operation ?? "unknown",
+            parentOperationId: null,
+            metadata: null
+          },
+          status,
+          result
+        }
+      } : current.operations;
+      if (operation === "user_request") {
+        return {
+          ...next,
+          operations,
+          completion: data,
+          status: status === "success" ? "complete" : status === "cancelled" ? "cancelled" : "error"
+        };
+      }
+      return { ...next, operations };
+    }
+    case "tool_event": {
+      const callId = asString(data.call_id);
+      const toolName = asString(data.tool_name);
+      const lifecycle = asString(data.event);
+      if (callId === null || toolName === null || lifecycle === null) return next;
+      const status = toolStatus(lifecycle);
+      return {
+        ...next,
+        status: status === "started" || status === "delegated" ? "awaiting-tools" : status === "completed" || status === "error" ? "streaming" : next.status,
+        tools: {
+          ...current.tools,
+          [callId]: {
+            callId,
+            toolName,
+            status,
+            message: asString(data.message),
+            data: Object.keys(asRecord(data.data)).length ? asRecord(data.data) : null
+          }
+        }
+      };
+    }
+    case "render_block": {
+      const blockId = asString(data.blockId);
+      const blockIndex = asNumber(data.blockIndex);
+      const type = asString(data.type);
+      if (blockId === null || blockIndex === null || type === null) return next;
+      const alreadyKnown = Object.hasOwn(current.renderBlocks, blockId);
+      return {
+        ...next,
+        renderBlocks: {
+          ...current.renderBlocks,
+          [blockId]: {
+            blockId,
+            blockIndex,
+            type,
+            status: data.status === "complete" || data.status === "error" ? data.status : "streaming",
+            content: asString(data.content),
+            data: Object.keys(asRecord(data.data)).length ? asRecord(data.data) : null,
+            metadata: Object.keys(asRecord(data.metadata)).length ? asRecord(data.metadata) : null
+          }
+        },
+        renderBlockOrder: alreadyKnown ? current.renderBlockOrder : [...current.renderBlockOrder, blockId]
+      };
+    }
+    case "error":
+      return { ...next, status: "error", error: data };
+    case "end":
+      return {
+        ...next,
+        status: current.status === "error" || current.status === "cancelled" ? current.status : "complete",
+        reasoningActive: false
+      };
+    case "data": {
+      const conversationId = data.type === "conversation_id" ? asString(data.conversation_id) : null;
+      return conversationId === null ? next : { ...next, conversationId };
+    }
+    default:
+      return next;
+  }
+}
+function projectAgentEvents(initial, events) {
+  return events.reduce(projectAgentEvent, initial);
+}
+
+exports.createAgentRequestProjection = createAgentRequestProjection;
+exports.normalizeMatrxStreamEnvelope = normalizeMatrxStreamEnvelope;
+exports.projectAgentEvent = projectAgentEvent;
+exports.projectAgentEvents = projectAgentEvents;
+exports.projectAgentResultForDisplay = projectAgentResultForDisplay;
+exports.readMatrxNdjsonStream = readMatrxNdjsonStream;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../stream/ndjson.ts","../presentation/result.ts","../projection/request.ts"],"names":["isRecord","changed","output"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Canonical AI Matrx NDJSON wire kernel.\n *\n * This module is deliberately independent of React, Redux, Next.js, Supabase,\n * and generated application types. Every Matrx client uses it to turn the\n * backend's byte stream into the same normalized `{ event, data }` envelopes.\n * Host runtimes remain responsible for HTTP/auth errors and for deciding what\n * each event means in their state model.\n */\n\nexport interface MatrxStreamEnvelope<TData = unknown> {\n  event: string;\n  data: TData;\n}\n\nexport interface MatrxNdjsonIssue {\n  line: string;\n  error: unknown;\n}\n\nexport interface ReadMatrxNdjsonOptions {\n  signal?: AbortSignal;\n  /** Malformed JSON is non-fatal, but it must never disappear silently. */\n  onMalformedLine?: (issue: MatrxNdjsonIssue) => void;\n  /** Valid JSON with no recognized Matrx event envelope is also non-fatal. */\n  onUnknownEnvelope?: (value: unknown) => void;\n}\n\ntype QueueItem =\n  | { kind: \"event\"; value: MatrxStreamEnvelope }\n  | { kind: \"error\"; error: unknown }\n  | { kind: \"done\" };\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/**\n * Normalize both supported Matrx wire shapes:\n *\n * - full: `{ \"event\": \"chunk\", \"data\": { \"text\": \"...\" } }`\n * - compact chunk: `{ \"e\": \"c\", \"t\": \"...\" }`\n * - compact reasoning: `{ \"e\": \"r\", \"t\": \"...\" }`\n */\nexport function normalizeMatrxStreamEnvelope(\n  value: unknown,\n): MatrxStreamEnvelope | null {\n  if (!isRecord(value)) return null;\n\n  if (typeof value.event === \"string\") {\n    return { event: value.event, data: value.data };\n  }\n  if (value.e === \"c\" && typeof value.t === \"string\") {\n    return { event: \"chunk\", data: { text: value.t } };\n  }\n  if (value.e === \"r\" && typeof value.t === \"string\") {\n    return { event: \"reasoning_chunk\", data: { text: value.t } };\n  }\n  return null;\n}\n\n/**\n * Read and normalize a Matrx NDJSON response body without applying consumer\n * backpressure to the network reader. The background read-ahead is important:\n * large tool payloads must keep draining even while React or another host is\n * processing the previous event.\n */\nexport async function* readMatrxNdjsonStream(\n  body: ReadableStream<Uint8Array>,\n  options: ReadMatrxNdjsonOptions = {},\n): AsyncGenerator<MatrxStreamEnvelope, void, undefined> {\n  const queue: QueueItem[] = [];\n  let wakeConsumer: (() => void) | null = null;\n  let readerFinished = false;\n\n  const enqueue = (item: QueueItem): void => {\n    queue.push(item);\n    const wake = wakeConsumer;\n    wakeConsumer = null;\n    wake?.();\n  };\n\n  const reader = body.getReader();\n  const decoder = new TextDecoder();\n\n  const parseLine = (line: string): void => {\n    const trimmed = line.trim();\n    if (!trimmed) return;\n\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(trimmed) as unknown;\n    } catch (error) {\n      options.onMalformedLine?.({ line: trimmed, error });\n      return;\n    }\n\n    const envelope = normalizeMatrxStreamEnvelope(parsed);\n    if (envelope) {\n      enqueue({ kind: \"event\", value: envelope });\n    } else {\n      options.onUnknownEnvelope?.(parsed);\n    }\n  };\n\n  const onAbort = (): void => {\n    void reader.cancel(options.signal?.reason).catch(() => undefined);\n  };\n  options.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n  const readerPromise = (async (): Promise<void> => {\n    let buffer = \"\";\n    try {\n      while (!options.signal?.aborted) {\n        const { value, done } = await reader.read();\n        if (done) break;\n\n        buffer += decoder.decode(value, { stream: true });\n        const lines = buffer.split(\"\\n\");\n        buffer = lines.pop() ?? \"\";\n        for (const line of lines) parseLine(line);\n      }\n\n      buffer += decoder.decode();\n      if (!options.signal?.aborted && buffer.trim()) parseLine(buffer);\n    } catch (error) {\n      const aborted =\n        options.signal?.aborted ||\n        (error instanceof Error && error.name === \"AbortError\");\n      if (!aborted) enqueue({ kind: \"error\", error });\n    } finally {\n      readerFinished = true;\n      reader.releaseLock();\n      enqueue({ kind: \"done\" });\n    }\n  })();\n\n  try {\n    while (true) {\n      if (queue.length === 0) {\n        await new Promise<void>((resolve) => {\n          wakeConsumer = resolve;\n        });\n      }\n\n      const item = queue.shift();\n      if (!item || item.kind === \"done\") return;\n      if (item.kind === \"error\") throw item.error;\n      yield item.value;\n    }\n  } finally {\n    options.signal?.removeEventListener(\"abort\", onAbort);\n    if (!readerFinished) {\n      await reader.cancel().catch(() => undefined);\n    }\n    await readerPromise;\n  }\n}\n","/**\n * Creator-facing projection of an agent execution result.\n *\n * Provider reasoning blocks and their signatures are replay material, not\n * workflow data. The execution engine must retain them so a later turn can be\n * continued correctly, but no result renderer, JSON tab, clipboard export, or\n * Content IR classifier should receive them as displayable values.\n *\n * This is a pure copy-on-write projection: values without private material\n * keep their original reference, while affected branches are cloned. Never\n * feed the projected value back into execution or persistence.\n */\n\nconst PRIVATE_REASONING_TYPES: ReadonlySet<string> = new Set([\n  \"thinking\",\n  \"redacted_thinking\",\n  \"reasoning\",\n]);\n\nconst PRIVATE_PROVIDER_KEYS: ReadonlySet<string> = new Set([\n  \"thought_signature\",\n  \"thoughtSignature\",\n  \"google_thought_signature\",\n  \"anthropic_signature\",\n  \"encrypted_content\",\n  \"signature_encoding\",\n]);\n\nconst SIGNATURE_PROVIDERS: ReadonlySet<string> = new Set([\n  \"anthropic\",\n  \"google\",\n  \"openai\",\n]);\n\nconst OPAQUE_SIGNATURE_MIN_LENGTH = 200;\nconst OMIT = Symbol(\"omit-provider-private-value\");\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isPrivateReasoningBlock(value: Record<string, unknown>): boolean {\n  return (\n    typeof value.type === \"string\" &&\n    PRIVATE_REASONING_TYPES.has(value.type.toLowerCase())\n  );\n}\n\nfunction isPrivateProviderKey(\n  key: string,\n  value: unknown,\n  parent: Record<string, unknown>,\n): boolean {\n  if (PRIVATE_PROVIDER_KEYS.has(key)) return true;\n  if (key !== \"signature\") return false;\n\n  const provider =\n    typeof parent.provider === \"string\" ? parent.provider.toLowerCase() : \"\";\n  return (\n    \"signature_encoding\" in parent ||\n    SIGNATURE_PROVIDERS.has(provider) ||\n    (typeof value === \"string\" && value.length >= OPAQUE_SIGNATURE_MIN_LENGTH)\n  );\n}\n\nfunction project(value: unknown): unknown | typeof OMIT {\n  if (Array.isArray(value)) {\n    let changed = false;\n    const output: unknown[] = [];\n    for (const item of value) {\n      const projected = project(item);\n      if (projected === OMIT) {\n        changed = true;\n        continue;\n      }\n      if (projected !== item) changed = true;\n      output.push(projected);\n    }\n    return changed ? output : value;\n  }\n\n  if (!isRecord(value)) return value;\n  if (isPrivateReasoningBlock(value)) return OMIT;\n\n  let changed = false;\n  const output: Record<string, unknown> = {};\n  for (const [key, child] of Object.entries(value)) {\n    if (isPrivateProviderKey(key, child, value)) {\n      changed = true;\n      continue;\n    }\n    const projected = project(child);\n    if (projected === OMIT) {\n      changed = true;\n      continue;\n    }\n    if (projected !== child) changed = true;\n    output[key] = projected;\n  }\n  return changed ? output : value;\n}\n\n/**\n * Remove provider-private reasoning material from a value crossing a\n * Creator-facing presentation or export boundary.\n */\nexport function projectAgentResultForDisplay(value: unknown): unknown {\n  const projected = project(value);\n  return projected === OMIT ? null : projected;\n}\n","export type AgentProjectionStatus =\n  | \"pending\"\n  | \"streaming\"\n  | \"awaiting-tools\"\n  | \"complete\"\n  | \"error\"\n  | \"cancelled\";\n\nexport interface AgentProjectionOperation {\n  operationId: string;\n  operation: string;\n  parentOperationId: string | null;\n  status: \"active\" | \"success\" | \"failed\" | \"cancelled\";\n  metadata: Record<string, unknown> | null;\n  result: Record<string, unknown> | null;\n}\n\nexport interface AgentProjectionTool {\n  callId: string;\n  toolName: string;\n  status:\n    | \"started\"\n    | \"progress\"\n    | \"step\"\n    | \"preview\"\n    | \"completed\"\n    | \"error\"\n    | \"delegated\";\n  message: string | null;\n  data: Record<string, unknown> | null;\n}\n\nexport interface AgentProjectionRenderBlock {\n  blockId: string;\n  blockIndex: number;\n  type: string;\n  status: \"streaming\" | \"complete\" | \"error\";\n  content: string | null;\n  data: Record<string, unknown> | null;\n  metadata: Record<string, unknown> | null;\n}\n\nexport interface AgentRequestProjection {\n  requestId: string;\n  conversationId: string | null;\n  status: AgentProjectionStatus;\n  answer: string;\n  reasoning: string;\n  reasoningActive: boolean;\n  phase: string | null;\n  phaseHistory: string[];\n  operations: Record<string, AgentProjectionOperation>;\n  tools: Record<string, AgentProjectionTool>;\n  renderBlocks: Record<string, AgentProjectionRenderBlock>;\n  renderBlockOrder: string[];\n  completion: Record<string, unknown> | null;\n  error: Record<string, unknown> | null;\n  lastTransportSeq: number;\n  eventCount: number;\n}\n\nexport interface AgentProjectionEvent {\n  event: string;\n  data?: unknown;\n  stream_seq?: number;\n}\n\nconst asRecord = (value: unknown): Record<string, unknown> =>\n  value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : {};\n\nconst asString = (value: unknown): string | null =>\n  typeof value === \"string\" ? value : null;\n\nconst asNumber = (value: unknown): number | null =>\n  typeof value === \"number\" && Number.isFinite(value) ? value : null;\n\nexport function createAgentRequestProjection(input: {\n  requestId: string;\n  conversationId?: string | null;\n}): AgentRequestProjection {\n  return {\n    requestId: input.requestId,\n    conversationId: input.conversationId ?? null,\n    status: \"pending\",\n    answer: \"\",\n    reasoning: \"\",\n    reasoningActive: false,\n    phase: null,\n    phaseHistory: [],\n    operations: {},\n    tools: {},\n    renderBlocks: {},\n    renderBlockOrder: [],\n    completion: null,\n    error: null,\n    lastTransportSeq: 0,\n    eventCount: 0,\n  };\n}\n\nfunction toolStatus(event: string): AgentProjectionTool[\"status\"] {\n  switch (event) {\n    case \"tool_started\":\n      return \"started\";\n    case \"tool_step\":\n      return \"step\";\n    case \"tool_result_preview\":\n      return \"preview\";\n    case \"tool_completed\":\n      return \"completed\";\n    case \"tool_error\":\n      return \"error\";\n    case \"tool_delegated\":\n      return \"delegated\";\n    default:\n      return \"progress\";\n  }\n}\n\nexport function projectAgentEvent(\n  current: AgentRequestProjection,\n  event: AgentProjectionEvent,\n): AgentRequestProjection {\n  const streamSeq = asNumber(event.stream_seq);\n  if (streamSeq !== null && streamSeq <= current.lastTransportSeq) return current;\n\n  const data = asRecord(event.data);\n  const next: AgentRequestProjection = {\n    ...current,\n    status: current.status === \"pending\" ? \"streaming\" : current.status,\n    lastTransportSeq: streamSeq ?? current.lastTransportSeq,\n    eventCount: current.eventCount + 1,\n  };\n\n  switch (event.event) {\n    case \"chunk\": {\n      const text = asString(data.text);\n      return text === null ? next : { ...next, answer: current.answer + text };\n    }\n    case \"reasoning_chunk\": {\n      const text = asString(data.text);\n      return text === null\n        ? next\n        : {\n            ...next,\n            reasoning: current.reasoning + text,\n            reasoningActive: true,\n          };\n    }\n    case \"reasoning\":\n      return {\n        ...next,\n        reasoningActive: data.state === \"started\",\n      };\n    case \"phase\": {\n      const phase = asString(data.phase);\n      if (phase === null) return next;\n      return {\n        ...next,\n        phase,\n        phaseHistory: [...current.phaseHistory, phase],\n      };\n    }\n    case \"init\": {\n      const operationId = asString(data.operation_id);\n      const operation = asString(data.operation);\n      if (operationId === null || operation === null) return next;\n      return {\n        ...next,\n        operations: {\n          ...current.operations,\n          [operationId]: {\n            operationId,\n            operation,\n            parentOperationId: asString(data.parent_operation_id),\n            status: \"active\",\n            metadata: Object.keys(asRecord(data.metadata)).length\n              ? asRecord(data.metadata)\n              : null,\n            result: null,\n          },\n        },\n      };\n    }\n    case \"completion\": {\n      const operationId = asString(data.operation_id);\n      const operation = asString(data.operation);\n      const rawStatus = asString(data.status);\n      const status: AgentProjectionOperation[\"status\"] =\n        rawStatus === \"failed\" || rawStatus === \"cancelled\"\n          ? rawStatus\n          : \"success\";\n      const result = asRecord(data.result);\n      const operations = operationId\n        ? {\n            ...current.operations,\n            [operationId]: {\n              ...(current.operations[operationId] ?? {\n                operationId,\n                operation: operation ?? \"unknown\",\n                parentOperationId: null,\n                metadata: null,\n              }),\n              status,\n              result,\n            },\n          }\n        : current.operations;\n      if (operation === \"user_request\") {\n        return {\n          ...next,\n          operations,\n          completion: data,\n          status:\n            status === \"success\"\n              ? \"complete\"\n              : status === \"cancelled\"\n                ? \"cancelled\"\n                : \"error\",\n        };\n      }\n      return { ...next, operations };\n    }\n    case \"tool_event\": {\n      const callId = asString(data.call_id);\n      const toolName = asString(data.tool_name);\n      const lifecycle = asString(data.event);\n      if (callId === null || toolName === null || lifecycle === null) return next;\n      const status = toolStatus(lifecycle);\n      return {\n        ...next,\n        status:\n          status === \"started\" || status === \"delegated\"\n            ? \"awaiting-tools\"\n            : status === \"completed\" || status === \"error\"\n              ? \"streaming\"\n              : next.status,\n        tools: {\n          ...current.tools,\n          [callId]: {\n            callId,\n            toolName,\n            status,\n            message: asString(data.message),\n            data: Object.keys(asRecord(data.data)).length ? asRecord(data.data) : null,\n          },\n        },\n      };\n    }\n    case \"render_block\": {\n      const blockId = asString(data.blockId);\n      const blockIndex = asNumber(data.blockIndex);\n      const type = asString(data.type);\n      if (blockId === null || blockIndex === null || type === null) return next;\n      const alreadyKnown = Object.hasOwn(current.renderBlocks, blockId);\n      return {\n        ...next,\n        renderBlocks: {\n          ...current.renderBlocks,\n          [blockId]: {\n            blockId,\n            blockIndex,\n            type,\n            status:\n              data.status === \"complete\" || data.status === \"error\"\n                ? data.status\n                : \"streaming\",\n            content: asString(data.content),\n            data: Object.keys(asRecord(data.data)).length ? asRecord(data.data) : null,\n            metadata: Object.keys(asRecord(data.metadata)).length\n              ? asRecord(data.metadata)\n              : null,\n          },\n        },\n        renderBlockOrder: alreadyKnown\n          ? current.renderBlockOrder\n          : [...current.renderBlockOrder, blockId],\n      };\n    }\n    case \"error\":\n      return { ...next, status: \"error\", error: data };\n    case \"end\":\n      return {\n        ...next,\n        status:\n          current.status === \"error\" || current.status === \"cancelled\"\n            ? current.status\n            : \"complete\",\n        reasoningActive: false,\n      };\n    case \"data\": {\n      const conversationId =\n        data.type === \"conversation_id\" ? asString(data.conversation_id) : null;\n      return conversationId === null ? next : { ...next, conversationId };\n    }\n    default:\n      return next;\n  }\n}\n\nexport function projectAgentEvents(\n  initial: AgentRequestProjection,\n  events: readonly AgentProjectionEvent[],\n): AgentRequestProjection {\n  return events.reduce(projectAgentEvent, initial);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,3 @@
+export { MatrxNdjsonIssue, MatrxStreamEnvelope, ReadMatrxNdjsonOptions, normalizeMatrxStreamEnvelope, readMatrxNdjsonStream } from './stream/ndjson.cjs';
+export { projectAgentResultForDisplay } from './presentation/result.cjs';
+export { AgentProjectionEvent, AgentProjectionOperation, AgentProjectionRenderBlock, AgentProjectionStatus, AgentProjectionTool, AgentRequestProjection, createAgentRequestProjection, projectAgentEvent, projectAgentEvents } from './projection/request.cjs';

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export { MatrxNdjsonIssue, MatrxStreamEnvelope, ReadMatrxNdjsonOptions, normalizeMatrxStreamEnvelope, readMatrxNdjsonStream } from './stream/ndjson.js';
 export { projectAgentResultForDisplay } from './presentation/result.js';
+export { AgentProjectionEvent, AgentProjectionOperation, AgentProjectionRenderBlock, AgentProjectionStatus, AgentProjectionTool, AgentRequestProjection, createAgentRequestProjection, projectAgentEvent, projectAgentEvents } from './projection/request.js';

package/dist/index.js

@@ -163,6 +163,197 @@ function projectAgentResultForDisplay(value) {
   return projected === OMIT ? null : projected;
 }
 
-export { normalizeMatrxStreamEnvelope, projectAgentResultForDisplay, readMatrxNdjsonStream };
+// projection/request.ts
+var asRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value) ? value : {};
+var asString = (value) => typeof value === "string" ? value : null;
+var asNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : null;
+function createAgentRequestProjection(input) {
+  return {
+    requestId: input.requestId,
+    conversationId: input.conversationId ?? null,
+    status: "pending",
+    answer: "",
+    reasoning: "",
+    reasoningActive: false,
+    phase: null,
+    phaseHistory: [],
+    operations: {},
+    tools: {},
+    renderBlocks: {},
+    renderBlockOrder: [],
+    completion: null,
+    error: null,
+    lastTransportSeq: 0,
+    eventCount: 0
+  };
+}
+function toolStatus(event) {
+  switch (event) {
+    case "tool_started":
+      return "started";
+    case "tool_step":
+      return "step";
+    case "tool_result_preview":
+      return "preview";
+    case "tool_completed":
+      return "completed";
+    case "tool_error":
+      return "error";
+    case "tool_delegated":
+      return "delegated";
+    default:
+      return "progress";
+  }
+}
+function projectAgentEvent(current, event) {
+  const streamSeq = asNumber(event.stream_seq);
+  if (streamSeq !== null && streamSeq <= current.lastTransportSeq) return current;
+  const data = asRecord(event.data);
+  const next = {
+    ...current,
+    status: current.status === "pending" ? "streaming" : current.status,
+    lastTransportSeq: streamSeq ?? current.lastTransportSeq,
+    eventCount: current.eventCount + 1
+  };
+  switch (event.event) {
+    case "chunk": {
+      const text = asString(data.text);
+      return text === null ? next : { ...next, answer: current.answer + text };
+    }
+    case "reasoning_chunk": {
+      const text = asString(data.text);
+      return text === null ? next : {
+        ...next,
+        reasoning: current.reasoning + text,
+        reasoningActive: true
+      };
+    }
+    case "reasoning":
+      return {
+        ...next,
+        reasoningActive: data.state === "started"
+      };
+    case "phase": {
+      const phase = asString(data.phase);
+      if (phase === null) return next;
+      return {
+        ...next,
+        phase,
+        phaseHistory: [...current.phaseHistory, phase]
+      };
+    }
+    case "init": {
+      const operationId = asString(data.operation_id);
+      const operation = asString(data.operation);
+      if (operationId === null || operation === null) return next;
+      return {
+        ...next,
+        operations: {
+          ...current.operations,
+          [operationId]: {
+            operationId,
+            operation,
+            parentOperationId: asString(data.parent_operation_id),
+            status: "active",
+            metadata: Object.keys(asRecord(data.metadata)).length ? asRecord(data.metadata) : null,
+            result: null
+          }
+        }
+      };
+    }
+    case "completion": {
+      const operationId = asString(data.operation_id);
+      const operation = asString(data.operation);
+      const rawStatus = asString(data.status);
+      const status = rawStatus === "failed" || rawStatus === "cancelled" ? rawStatus : "success";
+      const result = asRecord(data.result);
+      const operations = operationId ? {
+        ...current.operations,
+        [operationId]: {
+          ...current.operations[operationId] ?? {
+            operationId,
+            operation: operation ?? "unknown",
+            parentOperationId: null,
+            metadata: null
+          },
+          status,
+          result
+        }
+      } : current.operations;
+      if (operation === "user_request") {
+        return {
+          ...next,
+          operations,
+          completion: data,
+          status: status === "success" ? "complete" : status === "cancelled" ? "cancelled" : "error"
+        };
+      }
+      return { ...next, operations };
+    }
+    case "tool_event": {
+      const callId = asString(data.call_id);
+      const toolName = asString(data.tool_name);
+      const lifecycle = asString(data.event);
+      if (callId === null || toolName === null || lifecycle === null) return next;
+      const status = toolStatus(lifecycle);
+      return {
+        ...next,
+        status: status === "started" || status === "delegated" ? "awaiting-tools" : status === "completed" || status === "error" ? "streaming" : next.status,
+        tools: {
+          ...current.tools,
+          [callId]: {
+            callId,
+            toolName,
+            status,
+            message: asString(data.message),
+            data: Object.keys(asRecord(data.data)).length ? asRecord(data.data) : null
+          }
+        }
+      };
+    }
+    case "render_block": {
+      const blockId = asString(data.blockId);
+      const blockIndex = asNumber(data.blockIndex);
+      const type = asString(data.type);
+      if (blockId === null || blockIndex === null || type === null) return next;
+      const alreadyKnown = Object.hasOwn(current.renderBlocks, blockId);
+      return {
+        ...next,
+        renderBlocks: {
+          ...current.renderBlocks,
+          [blockId]: {
+            blockId,
+            blockIndex,
+            type,
+            status: data.status === "complete" || data.status === "error" ? data.status : "streaming",
+            content: asString(data.content),
+            data: Object.keys(asRecord(data.data)).length ? asRecord(data.data) : null,
+            metadata: Object.keys(asRecord(data.metadata)).length ? asRecord(data.metadata) : null
+          }
+        },
+        renderBlockOrder: alreadyKnown ? current.renderBlockOrder : [...current.renderBlockOrder, blockId]
+      };
+    }
+    case "error":
+      return { ...next, status: "error", error: data };
+    case "end":
+      return {
+        ...next,
+        status: current.status === "error" || current.status === "cancelled" ? current.status : "complete",
+        reasoningActive: false
+      };
+    case "data": {
+      const conversationId = data.type === "conversation_id" ? asString(data.conversation_id) : null;
+      return conversationId === null ? next : { ...next, conversationId };
+    }
+    default:
+      return next;
+  }
+}
+function projectAgentEvents(initial, events) {
+  return events.reduce(projectAgentEvent, initial);
+}
+
+export { createAgentRequestProjection, normalizeMatrxStreamEnvelope, projectAgentEvent, projectAgentEvents, projectAgentResultForDisplay, readMatrxNdjsonStream };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map