@ai-matrx/agents 0.1.0 → 0.2.1

package/dist/projection/workflow.cjs

@@ -0,0 +1,118 @@
+'use strict';
+
+// projection/workflow.ts
+var MAX_OPEN_FRAME_SETS = 32;
+function createWorkflowNodeProjection(input) {
+  return {
+    runId: input.runId,
+    nodeId: input.nodeId,
+    answer: "",
+    reasoning: "",
+    blockShadowed: false,
+    renderBlocks: {},
+    renderBlockOrder: [],
+    openFrames: {},
+    chunksReceived: 0,
+    charsStreamed: 0,
+    lastStreamingTs: null,
+    lastPhase: null,
+    lastTool: null,
+    lastWarning: null,
+    lastTransportSeq: 0
+  };
+}
+function asRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function asString(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function toRenderBlock(value) {
+  const data = asRecord(value);
+  if (!data) return null;
+  const blockId = asString(data.blockId);
+  const blockIndex = asNumber(data.blockIndex);
+  const type = asString(data.type);
+  if (blockId === null || blockIndex === null || type === null) return null;
+  return {
+    blockId,
+    blockIndex,
+    type,
+    status: data.status === "complete" || data.status === "error" ? data.status : "streaming",
+    content: asString(data.content),
+    data: asRecord(data.data),
+    metadata: asRecord(data.metadata)
+  };
+}
+function projectRenderFrame(current, event, next) {
+  const frameId = event.frame_id;
+  const frameCount = event.frame_count ?? 1;
+  const frameIndex = event.frame_index ?? 0;
+  if (!frameId || frameCount < 1 || frameIndex < 0 || frameIndex >= frameCount) {
+    return next;
+  }
+  const prior = current.openFrames[frameId];
+  const set = {
+    frameCount,
+    slices: { ...prior?.frameCount === frameCount ? prior.slices : {}, [frameIndex]: event.delta }
+  };
+  const openFrames = { ...current.openFrames, [frameId]: set };
+  const keys = Object.keys(openFrames);
+  const oldestKey = keys[0];
+  if (keys.length > MAX_OPEN_FRAME_SETS && oldestKey !== void 0) {
+    delete openFrames[oldestKey];
+  }
+  if (Object.keys(set.slices).length !== frameCount) return { ...next, openFrames };
+  delete openFrames[frameId];
+  let block = null;
+  try {
+    block = toRenderBlock(JSON.parse(
+      Array.from({ length: frameCount }, (_, index) => set.slices[index] ?? "").join("")
+    ));
+  } catch {
+    return { ...next, openFrames };
+  }
+  if (!block) return { ...next, openFrames };
+  return {
+    ...next,
+    openFrames,
+    renderBlocks: { ...current.renderBlocks, [block.blockId]: block },
+    renderBlockOrder: Object.hasOwn(current.renderBlocks, block.blockId) ? current.renderBlockOrder : [...current.renderBlockOrder, block.blockId]
+  };
+}
+function projectWorkflowNodeEvent(current, event) {
+  if (event.run_id !== current.runId || (event.node_id ?? "") !== current.nodeId) return current;
+  if (event.stream_seq <= current.lastTransportSeq) return current;
+  const next = {
+    ...current,
+    chunksReceived: event.chunks_received,
+    charsStreamed: event.chars_streamed,
+    lastStreamingTs: event.ts,
+    lastTransportSeq: event.stream_seq,
+    blockShadowed: current.blockShadowed || Boolean(event.block_shadowed)
+  };
+  switch (event.kind) {
+    case "chunk":
+      return { ...next, answer: current.answer + event.delta };
+    case "reasoning":
+      return { ...next, reasoning: current.reasoning + event.delta };
+    case "phase":
+      return { ...next, lastPhase: event.delta };
+    case "tool":
+      return { ...next, lastTool: event.delta };
+    case "warning":
+      return { ...next, lastWarning: event.delta };
+    case "render_block":
+      return projectRenderFrame(current, event, next);
+    default:
+      return next;
+  }
+}
+
+exports.createWorkflowNodeProjection = createWorkflowNodeProjection;
+exports.projectWorkflowNodeEvent = projectWorkflowNodeEvent;
+//# sourceMappingURL=workflow.cjs.map
+//# sourceMappingURL=workflow.cjs.map

package/dist/projection/workflow.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../projection/workflow.ts"],"names":[],"mappings":"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","file":"workflow.cjs","sourcesContent":["import type { AgentProjectionRenderBlock } from \"./request\";\n\nexport interface WorkflowNodeStreamEvent {\n  run_id: string;\n  node_id?: string | null;\n  kind:\n    | \"chunk\"\n    | \"reasoning\"\n    | \"phase\"\n    | \"tool\"\n    | \"warning\"\n    | \"record_update\"\n    | \"resource_changed\"\n    | \"render_block\";\n  delta: string;\n  stream_seq: number;\n  ts: string;\n  chunks_received: number;\n  chars_streamed: number;\n  frame_id?: string | null;\n  frame_index?: number;\n  frame_count?: number;\n  block_shadowed?: boolean;\n}\n\nexport interface WorkflowRenderFrameSet {\n  frameCount: number;\n  slices: Record<number, string>;\n}\n\nexport interface WorkflowNodeProjection {\n  runId: string;\n  nodeId: string;\n  answer: string;\n  reasoning: string;\n  blockShadowed: boolean;\n  renderBlocks: Record<string, AgentProjectionRenderBlock>;\n  renderBlockOrder: string[];\n  openFrames: Record<string, WorkflowRenderFrameSet>;\n  chunksReceived: number;\n  charsStreamed: number;\n  lastStreamingTs: string | null;\n  lastPhase: string | null;\n  lastTool: string | null;\n  lastWarning: string | null;\n  lastTransportSeq: number;\n}\n\nconst MAX_OPEN_FRAME_SETS = 32;\n\nexport function createWorkflowNodeProjection(input: {\n  runId: string;\n  nodeId: string;\n}): WorkflowNodeProjection {\n  return {\n    runId: input.runId,\n    nodeId: input.nodeId,\n    answer: \"\",\n    reasoning: \"\",\n    blockShadowed: false,\n    renderBlocks: {},\n    renderBlockOrder: [],\n    openFrames: {},\n    chunksReceived: 0,\n    charsStreamed: 0,\n    lastStreamingTs: null,\n    lastPhase: null,\n    lastTool: null,\n    lastWarning: null,\n    lastTransportSeq: 0,\n  };\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nfunction asString(value: unknown): string | null {\n  return typeof value === \"string\" ? value : null;\n}\n\nfunction asNumber(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n\nfunction toRenderBlock(value: unknown): AgentProjectionRenderBlock | null {\n  const data = asRecord(value);\n  if (!data) return null;\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 null;\n  return {\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: asRecord(data.data),\n    metadata: asRecord(data.metadata),\n  };\n}\n\nfunction projectRenderFrame(\n  current: WorkflowNodeProjection,\n  event: WorkflowNodeStreamEvent,\n  next: WorkflowNodeProjection,\n): WorkflowNodeProjection {\n  const frameId = event.frame_id;\n  const frameCount = event.frame_count ?? 1;\n  const frameIndex = event.frame_index ?? 0;\n  if (!frameId || frameCount < 1 || frameIndex < 0 || frameIndex >= frameCount) {\n    return next;\n  }\n  const prior = current.openFrames[frameId];\n  const set: WorkflowRenderFrameSet = {\n    frameCount,\n    slices: { ...(prior?.frameCount === frameCount ? prior.slices : {}), [frameIndex]: event.delta },\n  };\n  const openFrames = { ...current.openFrames, [frameId]: set };\n  const keys = Object.keys(openFrames);\n  const oldestKey = keys[0];\n  if (keys.length > MAX_OPEN_FRAME_SETS && oldestKey !== undefined) {\n    delete openFrames[oldestKey];\n  }\n  if (Object.keys(set.slices).length !== frameCount) return { ...next, openFrames };\n\n  delete openFrames[frameId];\n  let block: AgentProjectionRenderBlock | null = null;\n  try {\n    block = toRenderBlock(JSON.parse(\n      Array.from({ length: frameCount }, (_, index) => set.slices[index] ?? \"\").join(\"\"),\n    ));\n  } catch {\n    return { ...next, openFrames };\n  }\n  if (!block) return { ...next, openFrames };\n  return {\n    ...next,\n    openFrames,\n    renderBlocks: { ...current.renderBlocks, [block.blockId]: block },\n    renderBlockOrder: Object.hasOwn(current.renderBlocks, block.blockId)\n      ? current.renderBlockOrder\n      : [...current.renderBlockOrder, block.blockId],\n  };\n}\n\nexport function projectWorkflowNodeEvent(\n  current: WorkflowNodeProjection,\n  event: WorkflowNodeStreamEvent,\n): WorkflowNodeProjection {\n  if (event.run_id !== current.runId || (event.node_id ?? \"\") !== current.nodeId) return current;\n  if (event.stream_seq <= current.lastTransportSeq) return current;\n  const next: WorkflowNodeProjection = {\n    ...current,\n    chunksReceived: event.chunks_received,\n    charsStreamed: event.chars_streamed,\n    lastStreamingTs: event.ts,\n    lastTransportSeq: event.stream_seq,\n    blockShadowed: current.blockShadowed || Boolean(event.block_shadowed),\n  };\n  switch (event.kind) {\n    case \"chunk\":\n      return { ...next, answer: current.answer + event.delta };\n    case \"reasoning\":\n      return { ...next, reasoning: current.reasoning + event.delta };\n    case \"phase\":\n      return { ...next, lastPhase: event.delta };\n    case \"tool\":\n      return { ...next, lastTool: event.delta };\n    case \"warning\":\n      return { ...next, lastWarning: event.delta };\n    case \"render_block\":\n      return projectRenderFrame(current, event, next);\n    default:\n      return next;\n  }\n}\n"]}

package/dist/projection/workflow.d.cts

@@ -0,0 +1,44 @@
+import { AgentProjectionRenderBlock } from './request.cjs';
+
+interface WorkflowNodeStreamEvent {
+    run_id: string;
+    node_id?: string | null;
+    kind: "chunk" | "reasoning" | "phase" | "tool" | "warning" | "record_update" | "resource_changed" | "render_block";
+    delta: string;
+    stream_seq: number;
+    ts: string;
+    chunks_received: number;
+    chars_streamed: number;
+    frame_id?: string | null;
+    frame_index?: number;
+    frame_count?: number;
+    block_shadowed?: boolean;
+}
+interface WorkflowRenderFrameSet {
+    frameCount: number;
+    slices: Record<number, string>;
+}
+interface WorkflowNodeProjection {
+    runId: string;
+    nodeId: string;
+    answer: string;
+    reasoning: string;
+    blockShadowed: boolean;
+    renderBlocks: Record<string, AgentProjectionRenderBlock>;
+    renderBlockOrder: string[];
+    openFrames: Record<string, WorkflowRenderFrameSet>;
+    chunksReceived: number;
+    charsStreamed: number;
+    lastStreamingTs: string | null;
+    lastPhase: string | null;
+    lastTool: string | null;
+    lastWarning: string | null;
+    lastTransportSeq: number;
+}
+declare function createWorkflowNodeProjection(input: {
+    runId: string;
+    nodeId: string;
+}): WorkflowNodeProjection;
+declare function projectWorkflowNodeEvent(current: WorkflowNodeProjection, event: WorkflowNodeStreamEvent): WorkflowNodeProjection;
+
+export { type WorkflowNodeProjection, type WorkflowNodeStreamEvent, type WorkflowRenderFrameSet, createWorkflowNodeProjection, projectWorkflowNodeEvent };

package/dist/projection/workflow.d.ts

@@ -0,0 +1,44 @@
+import { AgentProjectionRenderBlock } from './request.js';
+
+interface WorkflowNodeStreamEvent {
+    run_id: string;
+    node_id?: string | null;
+    kind: "chunk" | "reasoning" | "phase" | "tool" | "warning" | "record_update" | "resource_changed" | "render_block";
+    delta: string;
+    stream_seq: number;
+    ts: string;
+    chunks_received: number;
+    chars_streamed: number;
+    frame_id?: string | null;
+    frame_index?: number;
+    frame_count?: number;
+    block_shadowed?: boolean;
+}
+interface WorkflowRenderFrameSet {
+    frameCount: number;
+    slices: Record<number, string>;
+}
+interface WorkflowNodeProjection {
+    runId: string;
+    nodeId: string;
+    answer: string;
+    reasoning: string;
+    blockShadowed: boolean;
+    renderBlocks: Record<string, AgentProjectionRenderBlock>;
+    renderBlockOrder: string[];
+    openFrames: Record<string, WorkflowRenderFrameSet>;
+    chunksReceived: number;
+    charsStreamed: number;
+    lastStreamingTs: string | null;
+    lastPhase: string | null;
+    lastTool: string | null;
+    lastWarning: string | null;
+    lastTransportSeq: number;
+}
+declare function createWorkflowNodeProjection(input: {
+    runId: string;
+    nodeId: string;
+}): WorkflowNodeProjection;
+declare function projectWorkflowNodeEvent(current: WorkflowNodeProjection, event: WorkflowNodeStreamEvent): WorkflowNodeProjection;
+
+export { type WorkflowNodeProjection, type WorkflowNodeStreamEvent, type WorkflowRenderFrameSet, createWorkflowNodeProjection, projectWorkflowNodeEvent };

package/dist/projection/workflow.js

@@ -0,0 +1,115 @@
+// projection/workflow.ts
+var MAX_OPEN_FRAME_SETS = 32;
+function createWorkflowNodeProjection(input) {
+  return {
+    runId: input.runId,
+    nodeId: input.nodeId,
+    answer: "",
+    reasoning: "",
+    blockShadowed: false,
+    renderBlocks: {},
+    renderBlockOrder: [],
+    openFrames: {},
+    chunksReceived: 0,
+    charsStreamed: 0,
+    lastStreamingTs: null,
+    lastPhase: null,
+    lastTool: null,
+    lastWarning: null,
+    lastTransportSeq: 0
+  };
+}
+function asRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function asString(value) {
+  return typeof value === "string" ? value : null;
+}
+function asNumber(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function toRenderBlock(value) {
+  const data = asRecord(value);
+  if (!data) return null;
+  const blockId = asString(data.blockId);
+  const blockIndex = asNumber(data.blockIndex);
+  const type = asString(data.type);
+  if (blockId === null || blockIndex === null || type === null) return null;
+  return {
+    blockId,
+    blockIndex,
+    type,
+    status: data.status === "complete" || data.status === "error" ? data.status : "streaming",
+    content: asString(data.content),
+    data: asRecord(data.data),
+    metadata: asRecord(data.metadata)
+  };
+}
+function projectRenderFrame(current, event, next) {
+  const frameId = event.frame_id;
+  const frameCount = event.frame_count ?? 1;
+  const frameIndex = event.frame_index ?? 0;
+  if (!frameId || frameCount < 1 || frameIndex < 0 || frameIndex >= frameCount) {
+    return next;
+  }
+  const prior = current.openFrames[frameId];
+  const set = {
+    frameCount,
+    slices: { ...prior?.frameCount === frameCount ? prior.slices : {}, [frameIndex]: event.delta }
+  };
+  const openFrames = { ...current.openFrames, [frameId]: set };
+  const keys = Object.keys(openFrames);
+  const oldestKey = keys[0];
+  if (keys.length > MAX_OPEN_FRAME_SETS && oldestKey !== void 0) {
+    delete openFrames[oldestKey];
+  }
+  if (Object.keys(set.slices).length !== frameCount) return { ...next, openFrames };
+  delete openFrames[frameId];
+  let block = null;
+  try {
+    block = toRenderBlock(JSON.parse(
+      Array.from({ length: frameCount }, (_, index) => set.slices[index] ?? "").join("")
+    ));
+  } catch {
+    return { ...next, openFrames };
+  }
+  if (!block) return { ...next, openFrames };
+  return {
+    ...next,
+    openFrames,
+    renderBlocks: { ...current.renderBlocks, [block.blockId]: block },
+    renderBlockOrder: Object.hasOwn(current.renderBlocks, block.blockId) ? current.renderBlockOrder : [...current.renderBlockOrder, block.blockId]
+  };
+}
+function projectWorkflowNodeEvent(current, event) {
+  if (event.run_id !== current.runId || (event.node_id ?? "") !== current.nodeId) return current;
+  if (event.stream_seq <= current.lastTransportSeq) return current;
+  const next = {
+    ...current,
+    chunksReceived: event.chunks_received,
+    charsStreamed: event.chars_streamed,
+    lastStreamingTs: event.ts,
+    lastTransportSeq: event.stream_seq,
+    blockShadowed: current.blockShadowed || Boolean(event.block_shadowed)
+  };
+  switch (event.kind) {
+    case "chunk":
+      return { ...next, answer: current.answer + event.delta };
+    case "reasoning":
+      return { ...next, reasoning: current.reasoning + event.delta };
+    case "phase":
+      return { ...next, lastPhase: event.delta };
+    case "tool":
+      return { ...next, lastTool: event.delta };
+    case "warning":
+      return { ...next, lastWarning: event.delta };
+    case "render_block":
+      return projectRenderFrame(current, event, next);
+    default:
+      return next;
+  }
+}
+
+export { createWorkflowNodeProjection, projectWorkflowNodeEvent };
+//# sourceMappingURL=workflow.js.map
+//# sourceMappingURL=workflow.js.map

package/dist/projection/workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../projection/workflow.ts"],"names":[],"mappings":"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","file":"workflow.js","sourcesContent":["import type { AgentProjectionRenderBlock } from \"./request\";\n\nexport interface WorkflowNodeStreamEvent {\n  run_id: string;\n  node_id?: string | null;\n  kind:\n    | \"chunk\"\n    | \"reasoning\"\n    | \"phase\"\n    | \"tool\"\n    | \"warning\"\n    | \"record_update\"\n    | \"resource_changed\"\n    | \"render_block\";\n  delta: string;\n  stream_seq: number;\n  ts: string;\n  chunks_received: number;\n  chars_streamed: number;\n  frame_id?: string | null;\n  frame_index?: number;\n  frame_count?: number;\n  block_shadowed?: boolean;\n}\n\nexport interface WorkflowRenderFrameSet {\n  frameCount: number;\n  slices: Record<number, string>;\n}\n\nexport interface WorkflowNodeProjection {\n  runId: string;\n  nodeId: string;\n  answer: string;\n  reasoning: string;\n  blockShadowed: boolean;\n  renderBlocks: Record<string, AgentProjectionRenderBlock>;\n  renderBlockOrder: string[];\n  openFrames: Record<string, WorkflowRenderFrameSet>;\n  chunksReceived: number;\n  charsStreamed: number;\n  lastStreamingTs: string | null;\n  lastPhase: string | null;\n  lastTool: string | null;\n  lastWarning: string | null;\n  lastTransportSeq: number;\n}\n\nconst MAX_OPEN_FRAME_SETS = 32;\n\nexport function createWorkflowNodeProjection(input: {\n  runId: string;\n  nodeId: string;\n}): WorkflowNodeProjection {\n  return {\n    runId: input.runId,\n    nodeId: input.nodeId,\n    answer: \"\",\n    reasoning: \"\",\n    blockShadowed: false,\n    renderBlocks: {},\n    renderBlockOrder: [],\n    openFrames: {},\n    chunksReceived: 0,\n    charsStreamed: 0,\n    lastStreamingTs: null,\n    lastPhase: null,\n    lastTool: null,\n    lastWarning: null,\n    lastTransportSeq: 0,\n  };\n}\n\nfunction asRecord(value: unknown): Record<string, unknown> | null {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value)\n    ? (value as Record<string, unknown>)\n    : null;\n}\n\nfunction asString(value: unknown): string | null {\n  return typeof value === \"string\" ? value : null;\n}\n\nfunction asNumber(value: unknown): number | null {\n  return typeof value === \"number\" && Number.isFinite(value) ? value : null;\n}\n\nfunction toRenderBlock(value: unknown): AgentProjectionRenderBlock | null {\n  const data = asRecord(value);\n  if (!data) return null;\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 null;\n  return {\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: asRecord(data.data),\n    metadata: asRecord(data.metadata),\n  };\n}\n\nfunction projectRenderFrame(\n  current: WorkflowNodeProjection,\n  event: WorkflowNodeStreamEvent,\n  next: WorkflowNodeProjection,\n): WorkflowNodeProjection {\n  const frameId = event.frame_id;\n  const frameCount = event.frame_count ?? 1;\n  const frameIndex = event.frame_index ?? 0;\n  if (!frameId || frameCount < 1 || frameIndex < 0 || frameIndex >= frameCount) {\n    return next;\n  }\n  const prior = current.openFrames[frameId];\n  const set: WorkflowRenderFrameSet = {\n    frameCount,\n    slices: { ...(prior?.frameCount === frameCount ? prior.slices : {}), [frameIndex]: event.delta },\n  };\n  const openFrames = { ...current.openFrames, [frameId]: set };\n  const keys = Object.keys(openFrames);\n  const oldestKey = keys[0];\n  if (keys.length > MAX_OPEN_FRAME_SETS && oldestKey !== undefined) {\n    delete openFrames[oldestKey];\n  }\n  if (Object.keys(set.slices).length !== frameCount) return { ...next, openFrames };\n\n  delete openFrames[frameId];\n  let block: AgentProjectionRenderBlock | null = null;\n  try {\n    block = toRenderBlock(JSON.parse(\n      Array.from({ length: frameCount }, (_, index) => set.slices[index] ?? \"\").join(\"\"),\n    ));\n  } catch {\n    return { ...next, openFrames };\n  }\n  if (!block) return { ...next, openFrames };\n  return {\n    ...next,\n    openFrames,\n    renderBlocks: { ...current.renderBlocks, [block.blockId]: block },\n    renderBlockOrder: Object.hasOwn(current.renderBlocks, block.blockId)\n      ? current.renderBlockOrder\n      : [...current.renderBlockOrder, block.blockId],\n  };\n}\n\nexport function projectWorkflowNodeEvent(\n  current: WorkflowNodeProjection,\n  event: WorkflowNodeStreamEvent,\n): WorkflowNodeProjection {\n  if (event.run_id !== current.runId || (event.node_id ?? \"\") !== current.nodeId) return current;\n  if (event.stream_seq <= current.lastTransportSeq) return current;\n  const next: WorkflowNodeProjection = {\n    ...current,\n    chunksReceived: event.chunks_received,\n    charsStreamed: event.chars_streamed,\n    lastStreamingTs: event.ts,\n    lastTransportSeq: event.stream_seq,\n    blockShadowed: current.blockShadowed || Boolean(event.block_shadowed),\n  };\n  switch (event.kind) {\n    case \"chunk\":\n      return { ...next, answer: current.answer + event.delta };\n    case \"reasoning\":\n      return { ...next, reasoning: current.reasoning + event.delta };\n    case \"phase\":\n      return { ...next, lastPhase: event.delta };\n    case \"tool\":\n      return { ...next, lastTool: event.delta };\n    case \"warning\":\n      return { ...next, lastWarning: event.delta };\n    case \"render_block\":\n      return projectRenderFrame(current, event, next);\n    default:\n      return next;\n  }\n}\n"]}

package/dist/stream/ndjson.cjs

@@ -0,0 +1,99 @@
+'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;
+  }
+}
+
+exports.normalizeMatrxStreamEnvelope = normalizeMatrxStreamEnvelope;
+exports.readMatrxNdjsonStream = readMatrxNdjsonStream;
+//# sourceMappingURL=ndjson.cjs.map
+//# sourceMappingURL=ndjson.cjs.map

package/dist/stream/ndjson.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../stream/ndjson.ts"],"names":[],"mappings":"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","file":"ndjson.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"]}

package/dist/stream/ndjson.d.cts

@@ -0,0 +1,41 @@
+/**
+ * Canonical AI Matrx NDJSON wire kernel.
+ *
+ * This module is deliberately independent of React, Redux, Next.js, Supabase,
+ * and generated application types. Every Matrx client uses it to turn the
+ * backend's byte stream into the same normalized `{ event, data }` envelopes.
+ * Host runtimes remain responsible for HTTP/auth errors and for deciding what
+ * each event means in their state model.
+ */
+interface MatrxStreamEnvelope<TData = unknown> {
+    event: string;
+    data: TData;
+}
+interface MatrxNdjsonIssue {
+    line: string;
+    error: unknown;
+}
+interface ReadMatrxNdjsonOptions {
+    signal?: AbortSignal;
+    /** Malformed JSON is non-fatal, but it must never disappear silently. */
+    onMalformedLine?: (issue: MatrxNdjsonIssue) => void;
+    /** Valid JSON with no recognized Matrx event envelope is also non-fatal. */
+    onUnknownEnvelope?: (value: unknown) => void;
+}
+/**
+ * Normalize both supported Matrx wire shapes:
+ *
+ * - full: `{ "event": "chunk", "data": { "text": "..." } }`
+ * - compact chunk: `{ "e": "c", "t": "..." }`
+ * - compact reasoning: `{ "e": "r", "t": "..." }`
+ */
+declare function normalizeMatrxStreamEnvelope(value: unknown): MatrxStreamEnvelope | null;
+/**
+ * Read and normalize a Matrx NDJSON response body without applying consumer
+ * backpressure to the network reader. The background read-ahead is important:
+ * large tool payloads must keep draining even while React or another host is
+ * processing the previous event.
+ */
+declare function readMatrxNdjsonStream(body: ReadableStream<Uint8Array>, options?: ReadMatrxNdjsonOptions): AsyncGenerator<MatrxStreamEnvelope, void, undefined>;
+
+export { type MatrxNdjsonIssue, type MatrxStreamEnvelope, type ReadMatrxNdjsonOptions, normalizeMatrxStreamEnvelope, readMatrxNdjsonStream };

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@ai-matrx/agents",
-  "version": "0.1.0",
-  "description": "Portable AI Matrx agent stream protocol and safe result-presentation primitives.",
+  "version": "0.2.1",
+  "description": "Portable AI Matrx agent stream protocol, event projection, and safe result-presentation primitives.",
   "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "license": "MIT",
   "keywords": [
     "agents",
@@ -27,16 +30,54 @@
   ],
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./stream/ndjson": {
-      "types": "./dist/stream/ndjson.d.ts",
-      "import": "./dist/stream/ndjson.js"
+      "import": {
+        "types": "./dist/stream/ndjson.d.ts",
+        "default": "./dist/stream/ndjson.js"
+      },
+      "require": {
+        "types": "./dist/stream/ndjson.d.cts",
+        "default": "./dist/stream/ndjson.cjs"
+      }
     },
     "./presentation/result": {
-      "types": "./dist/presentation/result.d.ts",
-      "import": "./dist/presentation/result.js"
+      "import": {
+        "types": "./dist/presentation/result.d.ts",
+        "default": "./dist/presentation/result.js"
+      },
+      "require": {
+        "types": "./dist/presentation/result.d.cts",
+        "default": "./dist/presentation/result.cjs"
+      }
+    },
+    "./projection/request": {
+      "import": {
+        "types": "./dist/projection/request.d.ts",
+        "default": "./dist/projection/request.js"
+      },
+      "require": {
+        "types": "./dist/projection/request.d.cts",
+        "default": "./dist/projection/request.cjs"
+      }
+    },
+    "./projection/workflow": {
+      "import": {
+        "types": "./dist/projection/workflow.d.ts",
+        "default": "./dist/projection/workflow.js"
+      },
+      "require": {
+        "types": "./dist/projection/workflow.d.cts",
+        "default": "./dist/projection/workflow.cjs"
+      }
     },
     "./package.json": "./package.json"
   },
@@ -50,7 +91,6 @@
   },
   "publishConfig": {
     "access": "public",
-    "provenance": true,
     "registry": "https://registry.npmjs.org/"
   },
   "engines": {