@kortyx/stream 0.5.2 → 0.6.0

package/dist/browser.js

@@ -19,8 +19,11 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/browser.ts
 var browser_exports = {};
 __export(browser_exports, {
+  applyStructuredChunk: () => applyStructuredChunk,
   consumeStream: () => consumeStream,
+  createStructuredStreamAccumulator: () => createStructuredStreamAccumulator,
   readStream: () => readStream,
+  reduceStructuredChunks: () => reduceStructuredChunks,
   streamFromRoute: () => streamFromRoute
 });
 module.exports = __toCommonJS(browser_exports);
@@ -124,10 +127,146 @@ async function* streamFromRoute(args) {
   }
   yield* readStream(response.body);
 }
+
+// src/structured/apply-structured-chunk.ts
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var cloneContainer = (value) => {
+  if (Array.isArray(value)) return [...value];
+  if (isPlainObject(value)) return { ...value };
+  return {};
+};
+var isArrayIndex = (value) => /^\d+$/.test(value);
+var setByParts = (input, parts, value) => {
+  if (parts.length === 0) return value;
+  const [part, ...rest] = parts;
+  if (part === void 0) return value;
+  if (Array.isArray(input) || isArrayIndex(part)) {
+    const nextArray = Array.isArray(input) ? [...input] : [];
+    const index = Number(part);
+    if (!Number.isInteger(index)) return nextArray;
+    nextArray[index] = setByParts(nextArray[index], rest, value);
+    return nextArray;
+  }
+  const nextObject = isPlainObject(input) ? { ...input } : {};
+  nextObject[part] = setByParts(nextObject[part], rest, value);
+  return nextObject;
+};
+var getByPath = (input, path) => {
+  const parts = path.split(".").filter(Boolean);
+  let current = input;
+  for (const part of parts) {
+    if (Array.isArray(current)) {
+      const index = Number(part);
+      current = Number.isInteger(index) ? current[index] : void 0;
+      continue;
+    }
+    if (isPlainObject(current)) {
+      current = current[part];
+      continue;
+    }
+    return void 0;
+  }
+  return current;
+};
+var setByPath = (input, path, value) => {
+  const parts = path.split(".").filter(Boolean);
+  return parts.length === 0 ? value : setByParts(cloneContainer(input), parts, value);
+};
+function applyStructuredChunk(current, chunk) {
+  if (current && current.streamId !== chunk.streamId) {
+    throw new Error(
+      `Structured chunk streamId mismatch: expected ${current.streamId}, received ${chunk.streamId}.`
+    );
+  }
+  if (current?.status === "done") {
+    throw new Error(
+      `Structured stream ${chunk.streamId} already completed with a final chunk.`
+    );
+  }
+  const nextBase = {
+    streamId: chunk.streamId,
+    dataType: chunk.dataType,
+    status: chunk.kind === "final" ? "done" : "streaming",
+    ...chunk.node ? { node: chunk.node } : {},
+    ...chunk.id ? { id: chunk.id } : {},
+    ...chunk.schemaId ? { schemaId: chunk.schemaId } : {},
+    ...chunk.schemaVersion ? { schemaVersion: chunk.schemaVersion } : {}
+  };
+  if (chunk.kind === "final") {
+    return {
+      ...nextBase,
+      data: chunk.data
+    };
+  }
+  const previousData = current?.data !== void 0 ? current.data : {};
+  if (chunk.kind === "set") {
+    return {
+      ...nextBase,
+      data: setByPath(previousData, chunk.path, chunk.value)
+    };
+  }
+  if (chunk.kind === "append") {
+    const existing2 = getByPath(previousData, chunk.path);
+    const nextItems = Array.isArray(existing2) ? [...existing2, ...chunk.items] : [...chunk.items];
+    return {
+      ...nextBase,
+      data: setByPath(previousData, chunk.path, nextItems)
+    };
+  }
+  const existing = getByPath(previousData, chunk.path);
+  const text = typeof existing === "string" ? existing : "";
+  return {
+    ...nextBase,
+    data: setByPath(previousData, chunk.path, text + chunk.delta)
+  };
+}
+function reduceStructuredChunks(chunks) {
+  return chunks.reduce(
+    (acc, chunk) => {
+      acc[chunk.streamId] = applyStructuredChunk(acc[chunk.streamId], chunk);
+      return acc;
+    },
+    {}
+  );
+}
+
+// src/structured/structured-stream-accumulator.ts
+var isStructuredDataChunk = (chunk) => chunk.type === "structured-data";
+function createStructuredStreamAccumulator(initialChunks = []) {
+  const states = /* @__PURE__ */ new Map();
+  const apply = (chunk) => {
+    const nextState = applyStructuredChunk(states.get(chunk.streamId), chunk);
+    states.set(chunk.streamId, nextState);
+    return nextState;
+  };
+  for (const chunk of initialChunks) {
+    apply(chunk);
+  }
+  return {
+    apply,
+    applyStreamChunk: (chunk) => {
+      if (!isStructuredDataChunk(chunk)) return void 0;
+      return apply(chunk);
+    },
+    get: (streamId) => states.get(streamId),
+    has: (streamId) => states.has(streamId),
+    delete: (streamId) => states.delete(streamId),
+    clear: () => {
+      states.clear();
+    },
+    size: () => states.size,
+    entries: () => Array.from(states.entries()),
+    values: () => Array.from(states.values()),
+    toRecord: () => Object.fromEntries(states.entries())
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  applyStructuredChunk,
   consumeStream,
+  createStructuredStreamAccumulator,
   readStream,
+  reduceStructuredChunks,
   streamFromRoute
 });
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/browser.ts","../src/client/consume-stream.ts","../src/client/read-stream.ts","../src/client/stream-from-route.ts"],"sourcesContent":["// Browser-safe exports for client bundles.\n// Keep this file free of Node-only imports (fs, path, etc).\n\nexport type { ConsumeStreamHandlers } from \"./client/consume-stream\";\nexport { consumeStream } from \"./client/consume-stream\";\nexport { readStream } from \"./client/read-stream\";\nexport type { StreamFromRouteArgs } from \"./client/stream-from-route\";\nexport { streamFromRoute } from \"./client/stream-from-route\";\nexport type { StreamChunk } from \"./types/stream-chunk\";\n","import type { StreamChunk } from \"../types/stream-chunk\";\n\nexport interface ConsumeStreamHandlers {\n  onChunk?: (\n    chunk: StreamChunk,\n  ) => void | boolean | Promise<boolean | undefined>;\n  onDone?: () => void | Promise<void>;\n  onError?: (error: Error, chunk?: StreamChunk) => void | Promise<void>;\n}\n\nconst toError = (value: unknown): Error =>\n  value instanceof Error ? value : new Error(String(value));\n\n/**\n * Consume a stream of StreamChunk events with callback handlers.\n * Returns when a `done` chunk is seen, the stream ends, or `onChunk` returns `false`.\n */\nexport async function consumeStream(\n  stream: AsyncIterable<StreamChunk>,\n  handlers: ConsumeStreamHandlers = {},\n): Promise<void> {\n  let doneCalled = false;\n\n  const callDone = async () => {\n    if (doneCalled) return;\n    doneCalled = true;\n    await handlers.onDone?.();\n  };\n\n  try {\n    for await (const chunk of stream) {\n      const shouldContinue = await handlers.onChunk?.(chunk);\n\n      if (chunk.type === \"error\") {\n        await handlers.onError?.(\n          new Error(chunk.message || \"Stream error.\"),\n          chunk,\n        );\n      }\n\n      if (chunk.type === \"done\" || shouldContinue === false) {\n        await callDone();\n        return;\n      }\n    }\n\n    await callDone();\n  } catch (error) {\n    const normalized = toError(error);\n    await handlers.onError?.(normalized);\n    throw normalized;\n  }\n}\n","// packages/stream/src/client/read-stream.ts\nimport type { StreamChunk } from \"../types/stream-chunk\";\n\n/**\n * Reads a server-sent event (SSE) Response body and yields StreamChunk objects.\n */\nexport async function* readStream(\n  body: ReadableStream<Uint8Array> | null,\n): AsyncGenerator<StreamChunk, void, void> {\n  if (!body) return;\n\n  const reader = body.getReader();\n  const decoder = new TextDecoder(\"utf-8\");\n  let buffer = \"\";\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n\n    buffer += decoder.decode(value, { stream: true });\n    const parts = buffer.split(\"\\n\\n\");\n    buffer = parts.pop() ?? \"\";\n\n    for (const part of parts) {\n      if (!part.startsWith(\"data: \")) continue;\n      const payload = part.slice(6);\n      if (payload.trim() === \"[DONE]\") return;\n      try {\n        yield JSON.parse(payload) as StreamChunk;\n      } catch (err: any) {\n        console.warn(\"Invalid JSON in stream chunk:\", payload);\n        console.error(err);\n      }\n    }\n  }\n}\n","import type { StreamChunk } from \"../types/stream-chunk\";\nimport { readStream } from \"./read-stream\";\n\nexport interface StreamFromRouteArgs<TBody = unknown> {\n  endpoint: string;\n  body: TBody;\n  method?: string | undefined;\n  fetchImpl?: typeof fetch;\n  headers?: Record<string, string> | undefined;\n}\n\nconst toErrorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n\nconst readErrorMessage = async (response: Response): Promise<string> => {\n  let message = `Request failed (${response.status})`;\n  try {\n    const payload = (await response.json()) as unknown;\n    if (\n      payload &&\n      typeof payload === \"object\" &&\n      \"error\" in payload &&\n      typeof (payload as { error?: unknown }).error === \"string\"\n    ) {\n      message = (payload as { error: string }).error;\n    }\n  } catch {}\n  return message;\n};\n\nexport async function* streamFromRoute<TBody = unknown>(\n  args: StreamFromRouteArgs<TBody>,\n): AsyncGenerator<StreamChunk, void, void> {\n  const fetchFn = args.fetchImpl ?? globalThis.fetch;\n  if (!fetchFn) {\n    yield { type: \"error\", message: \"No fetch implementation available.\" };\n    yield { type: \"done\" };\n    return;\n  }\n\n  let response: Response;\n  try {\n    response = await fetchFn(args.endpoint, {\n      method: args.method ?? \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(args.headers ?? {}),\n      },\n      body: JSON.stringify(args.body),\n    });\n  } catch (error) {\n    yield { type: \"error\", message: toErrorMessage(error) };\n    yield { type: \"done\" };\n    return;\n  }\n\n  if (!response.ok) {\n    yield { type: \"error\", message: await readErrorMessage(response) };\n    yield { type: \"done\" };\n    return;\n  }\n\n  yield* readStream(response.body);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/browser.ts","../src/client/consume-stream.ts","../src/client/read-stream.ts","../src/client/stream-from-route.ts","../src/structured/apply-structured-chunk.ts","../src/structured/structured-stream-accumulator.ts"],"sourcesContent":["// Browser-safe exports for client bundles.\n// Keep this file free of Node-only imports (fs, path, etc).\n\nexport type { ConsumeStreamHandlers } from \"./client/consume-stream\";\nexport { consumeStream } from \"./client/consume-stream\";\nexport { readStream } from \"./client/read-stream\";\nexport type { StreamFromRouteArgs } from \"./client/stream-from-route\";\nexport { streamFromRoute } from \"./client/stream-from-route\";\nexport * from \"./structured/apply-structured-chunk\";\nexport * from \"./structured/structured-stream-accumulator\";\nexport type { StreamChunk } from \"./types/stream-chunk\";\nexport type { StructuredDataChunk } from \"./types/structured-data\";\n","import type { StreamChunk } from \"../types/stream-chunk\";\n\nexport interface ConsumeStreamHandlers {\n  onChunk?: (\n    chunk: StreamChunk,\n  ) => undefined | boolean | Promise<boolean | undefined>;\n  onDone?: () => void | Promise<void>;\n  onError?: (error: Error, chunk?: StreamChunk) => void | Promise<void>;\n}\n\nconst toError = (value: unknown): Error =>\n  value instanceof Error ? value : new Error(String(value));\n\n/**\n * Consume a stream of StreamChunk events with callback handlers.\n * Returns when a `done` chunk is seen, the stream ends, or `onChunk` returns `false`.\n */\nexport async function consumeStream(\n  stream: AsyncIterable<StreamChunk>,\n  handlers: ConsumeStreamHandlers = {},\n): Promise<void> {\n  let doneCalled = false;\n\n  const callDone = async () => {\n    if (doneCalled) return;\n    doneCalled = true;\n    await handlers.onDone?.();\n  };\n\n  try {\n    for await (const chunk of stream) {\n      const shouldContinue = await handlers.onChunk?.(chunk);\n\n      if (chunk.type === \"error\") {\n        await handlers.onError?.(\n          new Error(chunk.message || \"Stream error.\"),\n          chunk,\n        );\n      }\n\n      if (chunk.type === \"done\" || shouldContinue === false) {\n        await callDone();\n        return;\n      }\n    }\n\n    await callDone();\n  } catch (error) {\n    const normalized = toError(error);\n    await handlers.onError?.(normalized);\n    throw normalized;\n  }\n}\n","// packages/stream/src/client/read-stream.ts\nimport type { StreamChunk } from \"../types/stream-chunk\";\n\n/**\n * Reads a server-sent event (SSE) Response body and yields StreamChunk objects.\n */\nexport async function* readStream(\n  body: ReadableStream<Uint8Array> | null,\n): AsyncGenerator<StreamChunk, void, void> {\n  if (!body) return;\n\n  const reader = body.getReader();\n  const decoder = new TextDecoder(\"utf-8\");\n  let buffer = \"\";\n\n  while (true) {\n    const { done, value } = await reader.read();\n    if (done) break;\n\n    buffer += decoder.decode(value, { stream: true });\n    const parts = buffer.split(\"\\n\\n\");\n    buffer = parts.pop() ?? \"\";\n\n    for (const part of parts) {\n      if (!part.startsWith(\"data: \")) continue;\n      const payload = part.slice(6);\n      if (payload.trim() === \"[DONE]\") return;\n      try {\n        yield JSON.parse(payload) as StreamChunk;\n      } catch (err: any) {\n        console.warn(\"Invalid JSON in stream chunk:\", payload);\n        console.error(err);\n      }\n    }\n  }\n}\n","import type { StreamChunk } from \"../types/stream-chunk\";\nimport { readStream } from \"./read-stream\";\n\nexport interface StreamFromRouteArgs<TBody = unknown> {\n  endpoint: string;\n  body: TBody;\n  method?: string | undefined;\n  fetchImpl?: typeof fetch;\n  headers?: Record<string, string> | undefined;\n}\n\nconst toErrorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n\nconst readErrorMessage = async (response: Response): Promise<string> => {\n  let message = `Request failed (${response.status})`;\n  try {\n    const payload = (await response.json()) as unknown;\n    if (\n      payload &&\n      typeof payload === \"object\" &&\n      \"error\" in payload &&\n      typeof (payload as { error?: unknown }).error === \"string\"\n    ) {\n      message = (payload as { error: string }).error;\n    }\n  } catch {}\n  return message;\n};\n\nexport async function* streamFromRoute<TBody = unknown>(\n  args: StreamFromRouteArgs<TBody>,\n): AsyncGenerator<StreamChunk, void, void> {\n  const fetchFn = args.fetchImpl ?? globalThis.fetch;\n  if (!fetchFn) {\n    yield { type: \"error\", message: \"No fetch implementation available.\" };\n    yield { type: \"done\" };\n    return;\n  }\n\n  let response: Response;\n  try {\n    response = await fetchFn(args.endpoint, {\n      method: args.method ?? \"POST\",\n      headers: {\n        \"content-type\": \"application/json\",\n        ...(args.headers ?? {}),\n      },\n      body: JSON.stringify(args.body),\n    });\n  } catch (error) {\n    yield { type: \"error\", message: toErrorMessage(error) };\n    yield { type: \"done\" };\n    return;\n  }\n\n  if (!response.ok) {\n    yield { type: \"error\", message: await readErrorMessage(response) };\n    yield { type: \"done\" };\n    return;\n  }\n\n  yield* readStream(response.body);\n}\n","import type { StructuredDataChunk } from \"../types/structured-data\";\n\nexport type StructuredStreamState<TData = unknown> = {\n  streamId: string;\n  dataType: string;\n  status: \"streaming\" | \"done\";\n  data: TData;\n  node?: string;\n  id?: string;\n  schemaId?: string;\n  schemaVersion?: string;\n};\n\nconst isPlainObject = (value: unknown): value is Record<string, unknown> =>\n  typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst cloneContainer = (value: unknown): unknown => {\n  if (Array.isArray(value)) return [...value];\n  if (isPlainObject(value)) return { ...value };\n  return {};\n};\n\nconst isArrayIndex = (value: string): boolean => /^\\d+$/.test(value);\n\nconst setByParts = (\n  input: unknown,\n  parts: string[],\n  value: unknown,\n): unknown => {\n  if (parts.length === 0) return value;\n\n  const [part, ...rest] = parts;\n  if (part === undefined) return value;\n\n  if (Array.isArray(input) || isArrayIndex(part)) {\n    const nextArray = Array.isArray(input) ? [...input] : [];\n    const index = Number(part);\n    if (!Number.isInteger(index)) return nextArray;\n    nextArray[index] = setByParts(nextArray[index], rest, value);\n    return nextArray;\n  }\n\n  const nextObject = isPlainObject(input) ? { ...input } : {};\n  nextObject[part] = setByParts(nextObject[part], rest, value);\n  return nextObject;\n};\n\nconst getByPath = (input: unknown, path: string): unknown => {\n  const parts = path.split(\".\").filter(Boolean);\n  let current: unknown = input;\n\n  for (const part of parts) {\n    if (Array.isArray(current)) {\n      const index = Number(part);\n      current = Number.isInteger(index) ? current[index] : undefined;\n      continue;\n    }\n\n    if (isPlainObject(current)) {\n      current = current[part];\n      continue;\n    }\n\n    return undefined;\n  }\n\n  return current;\n};\n\nconst setByPath = (input: unknown, path: string, value: unknown): unknown => {\n  const parts = path.split(\".\").filter(Boolean);\n  return parts.length === 0\n    ? value\n    : setByParts(cloneContainer(input), parts, value);\n};\n\nexport function applyStructuredChunk<TData = unknown>(\n  current: StructuredStreamState<TData> | undefined,\n  chunk: StructuredDataChunk,\n): StructuredStreamState<TData> {\n  if (current && current.streamId !== chunk.streamId) {\n    throw new Error(\n      `Structured chunk streamId mismatch: expected ${current.streamId}, received ${chunk.streamId}.`,\n    );\n  }\n\n  if (current?.status === \"done\") {\n    throw new Error(\n      `Structured stream ${chunk.streamId} already completed with a final chunk.`,\n    );\n  }\n\n  const nextBase = {\n    streamId: chunk.streamId,\n    dataType: chunk.dataType,\n    status: chunk.kind === \"final\" ? (\"done\" as const) : (\"streaming\" as const),\n    ...(chunk.node ? { node: chunk.node } : {}),\n    ...(chunk.id ? { id: chunk.id } : {}),\n    ...(chunk.schemaId ? { schemaId: chunk.schemaId } : {}),\n    ...(chunk.schemaVersion ? { schemaVersion: chunk.schemaVersion } : {}),\n  };\n\n  if (chunk.kind === \"final\") {\n    return {\n      ...nextBase,\n      data: chunk.data as TData,\n    };\n  }\n\n  const previousData =\n    current?.data !== undefined\n      ? current.data\n      : ({} as TData | Record<string, unknown>);\n\n  if (chunk.kind === \"set\") {\n    return {\n      ...nextBase,\n      data: setByPath(previousData, chunk.path, chunk.value) as TData,\n    };\n  }\n\n  if (chunk.kind === \"append\") {\n    const existing = getByPath(previousData, chunk.path);\n    const nextItems = Array.isArray(existing)\n      ? [...existing, ...chunk.items]\n      : [...chunk.items];\n    return {\n      ...nextBase,\n      data: setByPath(previousData, chunk.path, nextItems) as TData,\n    };\n  }\n\n  const existing = getByPath(previousData, chunk.path);\n  const text = typeof existing === \"string\" ? existing : \"\";\n  return {\n    ...nextBase,\n    data: setByPath(previousData, chunk.path, text + chunk.delta) as TData,\n  };\n}\n\nexport function reduceStructuredChunks<TData = unknown>(\n  chunks: StructuredDataChunk[],\n): Record<string, StructuredStreamState<TData>> {\n  return chunks.reduce<Record<string, StructuredStreamState<TData>>>(\n    (acc, chunk) => {\n      acc[chunk.streamId] = applyStructuredChunk(acc[chunk.streamId], chunk);\n      return acc;\n    },\n    {},\n  );\n}\n","import type { StreamChunk } from \"../types/stream-chunk\";\nimport type { StructuredDataChunk } from \"../types/structured-data\";\nimport {\n  applyStructuredChunk,\n  type StructuredStreamState,\n} from \"./apply-structured-chunk\";\n\nexport type StructuredStreamAccumulator<TData = unknown> = {\n  apply: (chunk: StructuredDataChunk) => StructuredStreamState<TData>;\n  applyStreamChunk: (\n    chunk: StreamChunk,\n  ) => StructuredStreamState<TData> | undefined;\n  get: (streamId: string) => StructuredStreamState<TData> | undefined;\n  has: (streamId: string) => boolean;\n  delete: (streamId: string) => boolean;\n  clear: () => void;\n  size: () => number;\n  entries: () => Array<[string, StructuredStreamState<TData>]>;\n  values: () => StructuredStreamState<TData>[];\n  toRecord: () => Record<string, StructuredStreamState<TData>>;\n};\n\nconst isStructuredDataChunk = (\n  chunk: StreamChunk,\n): chunk is StructuredDataChunk => chunk.type === \"structured-data\";\n\nexport function createStructuredStreamAccumulator<TData = unknown>(\n  initialChunks: Iterable<StructuredDataChunk> = [],\n): StructuredStreamAccumulator<TData> {\n  const states = new Map<string, StructuredStreamState<TData>>();\n\n  const apply = (chunk: StructuredDataChunk): StructuredStreamState<TData> => {\n    const nextState = applyStructuredChunk(states.get(chunk.streamId), chunk);\n    states.set(chunk.streamId, nextState);\n    return nextState;\n  };\n\n  for (const chunk of initialChunks) {\n    apply(chunk);\n  }\n\n  return {\n    apply,\n    applyStreamChunk: (chunk) => {\n      if (!isStructuredDataChunk(chunk)) return undefined;\n      return apply(chunk);\n    },\n    get: (streamId) => states.get(streamId),\n    has: (streamId) => states.has(streamId),\n    delete: (streamId) => states.delete(streamId),\n    clear: () => {\n      states.clear();\n    },\n    size: () => states.size,\n    entries: () => Array.from(states.entries()),\n    values: () => Array.from(states.values()),\n    toRecord: () => Object.fromEntries(states.entries()),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACUA,IAAM,UAAU,CAAC,UACf,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,KAAK,CAAC;AAM1D,eAAsB,cACpB,QACA,WAAkC,CAAC,GACpB;AACf,MAAI,aAAa;AAEjB,QAAM,WAAW,YAAY;AAC3B,QAAI,WAAY;AAChB,iBAAa;AACb,UAAM,SAAS,SAAS;AAAA,EAC1B;AAEA,MAAI;AACF,qBAAiB,SAAS,QAAQ;AAChC,YAAM,iBAAiB,MAAM,SAAS,UAAU,KAAK;AAErD,UAAI,MAAM,SAAS,SAAS;AAC1B,cAAM,SAAS;AAAA,UACb,IAAI,MAAM,MAAM,WAAW,eAAe;AAAA,UAC1C;AAAA,QACF;AAAA,MACF;AAEA,UAAI,MAAM,SAAS,UAAU,mBAAmB,OAAO;AACrD,cAAM,SAAS;AACf;AAAA,MACF;AAAA,IACF;AAEA,UAAM,SAAS;AAAA,EACjB,SAAS,OAAO;AACd,UAAM,aAAa,QAAQ,KAAK;AAChC,UAAM,SAAS,UAAU,UAAU;AACnC,UAAM;AAAA,EACR;AACF;;;AC9CA,gBAAuB,WACrB,MACyC;AACzC,MAAI,CAAC,KAAM;AAEX,QAAM,SAAS,KAAK,UAAU;AAC9B,QAAM,UAAU,IAAI,YAAY,OAAO;AACvC,MAAI,SAAS;AAEb,SAAO,MAAM;AACX,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,OAAO,KAAK;AAC1C,QAAI,KAAM;AAEV,cAAU,QAAQ,OAAO,OAAO,EAAE,QAAQ,KAAK,CAAC;AAChD,UAAM,QAAQ,OAAO,MAAM,MAAM;AACjC,aAAS,MAAM,IAAI,KAAK;AAExB,eAAW,QAAQ,OAAO;AACxB,UAAI,CAAC,KAAK,WAAW,QAAQ,EAAG;AAChC,YAAM,UAAU,KAAK,MAAM,CAAC;AAC5B,UAAI,QAAQ,KAAK,MAAM,SAAU;AACjC,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AAAA,MAC1B,SAAS,KAAU;AACjB,gBAAQ,KAAK,iCAAiC,OAAO;AACrD,gBAAQ,MAAM,GAAG;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AACF;;;ACxBA,IAAM,iBAAiB,CAAC,UACtB,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AAEvD,IAAM,mBAAmB,OAAO,aAAwC;AACtE,MAAI,UAAU,mBAAmB,SAAS,MAAM;AAChD,MAAI;AACF,UAAM,UAAW,MAAM,SAAS,KAAK;AACrC,QACE,WACA,OAAO,YAAY,YACnB,WAAW,WACX,OAAQ,QAAgC,UAAU,UAClD;AACA,gBAAW,QAA8B;AAAA,IAC3C;AAAA,EACF,QAAQ;AAAA,EAAC;AACT,SAAO;AACT;AAEA,gBAAuB,gBACrB,MACyC;AACzC,QAAM,UAAU,KAAK,aAAa,WAAW;AAC7C,MAAI,CAAC,SAAS;AACZ,UAAM,EAAE,MAAM,SAAS,SAAS,qCAAqC;AACrE,UAAM,EAAE,MAAM,OAAO;AACrB;AAAA,EACF;AAEA,MAAI;AACJ,MAAI;AACF,eAAW,MAAM,QAAQ,KAAK,UAAU;AAAA,MACtC,QAAQ,KAAK,UAAU;AAAA,MACvB,SAAS;AAAA,QACP,gBAAgB;AAAA,QAChB,GAAI,KAAK,WAAW,CAAC;AAAA,MACvB;AAAA,MACA,MAAM,KAAK,UAAU,KAAK,IAAI;AAAA,IAChC,CAAC;AAAA,EACH,SAAS,OAAO;AACd,UAAM,EAAE,MAAM,SAAS,SAAS,eAAe,KAAK,EAAE;AACtD,UAAM,EAAE,MAAM,OAAO;AACrB;AAAA,EACF;AAEA,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,EAAE,MAAM,SAAS,SAAS,MAAM,iBAAiB,QAAQ,EAAE;AACjE,UAAM,EAAE,MAAM,OAAO;AACrB;AAAA,EACF;AAEA,SAAO,WAAW,SAAS,IAAI;AACjC;;;AClDA,IAAM,gBAAgB,CAAC,UACrB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAErE,IAAM,iBAAiB,CAAC,UAA4B;AAClD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC,GAAG,KAAK;AAC1C,MAAI,cAAc,KAAK,EAAG,QAAO,EAAE,GAAG,MAAM;AAC5C,SAAO,CAAC;AACV;AAEA,IAAM,eAAe,CAAC,UAA2B,QAAQ,KAAK,KAAK;AAEnE,IAAM,aAAa,CACjB,OACA,OACA,UACY;AACZ,MAAI,MAAM,WAAW,EAAG,QAAO;AAE/B,QAAM,CAAC,MAAM,GAAG,IAAI,IAAI;AACxB,MAAI,SAAS,OAAW,QAAO;AAE/B,MAAI,MAAM,QAAQ,KAAK,KAAK,aAAa,IAAI,GAAG;AAC9C,UAAM,YAAY,MAAM,QAAQ,KAAK,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC;AACvD,UAAM,QAAQ,OAAO,IAAI;AACzB,QAAI,CAAC,OAAO,UAAU,KAAK,EAAG,QAAO;AACrC,cAAU,KAAK,IAAI,WAAW,UAAU,KAAK,GAAG,MAAM,KAAK;AAC3D,WAAO;AAAA,EACT;AAEA,QAAM,aAAa,cAAc,KAAK,IAAI,EAAE,GAAG,MAAM,IAAI,CAAC;AAC1D,aAAW,IAAI,IAAI,WAAW,WAAW,IAAI,GAAG,MAAM,KAAK;AAC3D,SAAO;AACT;AAEA,IAAM,YAAY,CAAC,OAAgB,SAA0B;AAC3D,QAAM,QAAQ,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAC5C,MAAI,UAAmB;AAEvB,aAAW,QAAQ,OAAO;AACxB,QAAI,MAAM,QAAQ,OAAO,GAAG;AAC1B,YAAM,QAAQ,OAAO,IAAI;AACzB,gBAAU,OAAO,UAAU,KAAK,IAAI,QAAQ,KAAK,IAAI;AACrD;AAAA,IACF;AAEA,QAAI,cAAc,OAAO,GAAG;AAC1B,gBAAU,QAAQ,IAAI;AACtB;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAEA,IAAM,YAAY,CAAC,OAAgB,MAAc,UAA4B;AAC3E,QAAM,QAAQ,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAC5C,SAAO,MAAM,WAAW,IACpB,QACA,WAAW,eAAe,KAAK,GAAG,OAAO,KAAK;AACpD;AAEO,SAAS,qBACd,SACA,OAC8B;AAC9B,MAAI,WAAW,QAAQ,aAAa,MAAM,UAAU;AAClD,UAAM,IAAI;AAAA,MACR,gDAAgD,QAAQ,QAAQ,cAAc,MAAM,QAAQ;AAAA,IAC9F;AAAA,EACF;AAEA,MAAI,SAAS,WAAW,QAAQ;AAC9B,UAAM,IAAI;AAAA,MACR,qBAAqB,MAAM,QAAQ;AAAA,IACrC;AAAA,EACF;AAEA,QAAM,WAAW;AAAA,IACf,UAAU,MAAM;AAAA,IAChB,UAAU,MAAM;AAAA,IAChB,QAAQ,MAAM,SAAS,UAAW,SAAoB;AAAA,IACtD,GAAI,MAAM,OAAO,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;AAAA,IACzC,GAAI,MAAM,KAAK,EAAE,IAAI,MAAM,GAAG,IAAI,CAAC;AAAA,IACnC,GAAI,MAAM,WAAW,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC;AAAA,IACrD,GAAI,MAAM,gBAAgB,EAAE,eAAe,MAAM,cAAc,IAAI,CAAC;AAAA,EACtE;AAEA,MAAI,MAAM,SAAS,SAAS;AAC1B,WAAO;AAAA,MACL,GAAG;AAAA,MACH,MAAM,MAAM;AAAA,IACd;AAAA,EACF;AAEA,QAAM,eACJ,SAAS,SAAS,SACd,QAAQ,OACP,CAAC;AAER,MAAI,MAAM,SAAS,OAAO;AACxB,WAAO;AAAA,MACL,GAAG;AAAA,MACH,MAAM,UAAU,cAAc,MAAM,MAAM,MAAM,KAAK;AAAA,IACvD;AAAA,EACF;AAEA,MAAI,MAAM,SAAS,UAAU;AAC3B,UAAMA,YAAW,UAAU,cAAc,MAAM,IAAI;AACnD,UAAM,YAAY,MAAM,QAAQA,SAAQ,IACpC,CAAC,GAAGA,WAAU,GAAG,MAAM,KAAK,IAC5B,CAAC,GAAG,MAAM,KAAK;AACnB,WAAO;AAAA,MACL,GAAG;AAAA,MACH,MAAM,UAAU,cAAc,MAAM,MAAM,SAAS;AAAA,IACrD;AAAA,EACF;AAEA,QAAM,WAAW,UAAU,cAAc,MAAM,IAAI;AACnD,QAAM,OAAO,OAAO,aAAa,WAAW,WAAW;AACvD,SAAO;AAAA,IACL,GAAG;AAAA,IACH,MAAM,UAAU,cAAc,MAAM,MAAM,OAAO,MAAM,KAAK;AAAA,EAC9D;AACF;AAEO,SAAS,uBACd,QAC8C;AAC9C,SAAO,OAAO;AAAA,IACZ,CAAC,KAAK,UAAU;AACd,UAAI,MAAM,QAAQ,IAAI,qBAAqB,IAAI,MAAM,QAAQ,GAAG,KAAK;AACrE,aAAO;AAAA,IACT;AAAA,IACA,CAAC;AAAA,EACH;AACF;;;AChIA,IAAM,wBAAwB,CAC5B,UACiC,MAAM,SAAS;AAE3C,SAAS,kCACd,gBAA+C,CAAC,GACZ;AACpC,QAAM,SAAS,oBAAI,IAA0C;AAE7D,QAAM,QAAQ,CAAC,UAA6D;AAC1E,UAAM,YAAY,qBAAqB,OAAO,IAAI,MAAM,QAAQ,GAAG,KAAK;AACxE,WAAO,IAAI,MAAM,UAAU,SAAS;AACpC,WAAO;AAAA,EACT;AAEA,aAAW,SAAS,eAAe;AACjC,UAAM,KAAK;AAAA,EACb;AAEA,SAAO;AAAA,IACL;AAAA,IACA,kBAAkB,CAAC,UAAU;AAC3B,UAAI,CAAC,sBAAsB,KAAK,EAAG,QAAO;AAC1C,aAAO,MAAM,KAAK;AAAA,IACpB;AAAA,IACA,KAAK,CAAC,aAAa,OAAO,IAAI,QAAQ;AAAA,IACtC,KAAK,CAAC,aAAa,OAAO,IAAI,QAAQ;AAAA,IACtC,QAAQ,CAAC,aAAa,OAAO,OAAO,QAAQ;AAAA,IAC5C,OAAO,MAAM;AACX,aAAO,MAAM;AAAA,IACf;AAAA,IACA,MAAM,MAAM,OAAO;AAAA,IACnB,SAAS,MAAM,MAAM,KAAK,OAAO,QAAQ,CAAC;AAAA,IAC1C,QAAQ,MAAM,MAAM,KAAK,OAAO,OAAO,CAAC;AAAA,IACxC,UAAU,MAAM,OAAO,YAAY,OAAO,QAAQ,CAAC;AAAA,EACrD;AACF;","names":["existing"]}

package/dist/index.d.ts

@@ -1,22 +1,11 @@
-import { S as StreamChunk } from './browser-ojdAqLMO.js';
-export { C as ConsumeStreamHandlers, a as StreamChunkSchema, b as StreamFromRouteArgs, c as consumeStream, r as readStream, s as streamFromRoute } from './browser-ojdAqLMO.js';
+import { S as StreamChunk, a as StructuredDataChunk } from './browser-DBfCMmkm.js';
+export { C as ConsumeStreamHandlers, b as StreamChunkSchema, c as StreamFromRouteArgs, d as StructuredDataChunkSchema, e as StructuredStreamAccumulator, f as StructuredStreamState, g as applyStructuredChunk, h as consumeStream, i as createStructuredStreamAccumulator, r as readStream, j as reduceStructuredChunks, s as streamFromRoute } from './browser-DBfCMmkm.js';
 import 'zod';
 
-type StructuredStreamChunk = {
-    type: "structured-data";
-    data: unknown;
-    dataType?: string;
-    mode?: "final" | "patch" | "snapshot";
-    schemaId?: string;
-    schemaVersion?: string;
-    id?: string;
-    opId?: string;
-    node?: string;
-};
 interface BufferedStreamResult {
     chunks: StreamChunk[];
     text: string;
-    structured: StructuredStreamChunk[];
+    structured: StructuredDataChunk[];
 }
 /**
  * Derive convenient buffered fields from raw chunks.
@@ -51,4 +40,4 @@ declare function createStreamResponse(stream: AsyncIterable<StreamChunk>): Respo
  */
 declare function toSSE(stream: AsyncIterable<StreamChunk>): Response;
 
-export { type BufferedStreamResult, STREAM_HEADERS, StreamChunk, type StructuredStreamChunk, collectBufferedStream, collectStream, createStreamResponse, summarizeStreamChunks, toSSE };
+export { type BufferedStreamResult, STREAM_HEADERS, StreamChunk, StructuredDataChunk, collectBufferedStream, collectStream, createStreamResponse, summarizeStreamChunks, toSSE };

package/dist/index.js

@@ -21,11 +21,15 @@ var index_exports = {};
 __export(index_exports, {
   STREAM_HEADERS: () => STREAM_HEADERS,
   StreamChunkSchema: () => StreamChunkSchema,
+  StructuredDataChunkSchema: () => StructuredDataChunkSchema,
+  applyStructuredChunk: () => applyStructuredChunk,
   collectBufferedStream: () => collectBufferedStream,
   collectStream: () => collectStream,
   consumeStream: () => consumeStream,
   createStreamResponse: () => createStreamResponse,
+  createStructuredStreamAccumulator: () => createStructuredStreamAccumulator,
   readStream: () => readStream,
+  reduceStructuredChunks: () => reduceStructuredChunks,
   streamFromRoute: () => streamFromRoute,
   summarizeStreamChunks: () => summarizeStreamChunks,
   toSSE: () => toSSE
@@ -223,155 +227,289 @@ function toSSE(stream) {
   return createStreamResponse(stream);
 }
 
-// src/types/stream-chunk.ts
-var import_zod3 = require("zod");
+// src/structured/apply-structured-chunk.ts
+var isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var cloneContainer = (value) => {
+  if (Array.isArray(value)) return [...value];
+  if (isPlainObject(value)) return { ...value };
+  return {};
+};
+var isArrayIndex = (value) => /^\d+$/.test(value);
+var setByParts = (input, parts, value) => {
+  if (parts.length === 0) return value;
+  const [part, ...rest] = parts;
+  if (part === void 0) return value;
+  if (Array.isArray(input) || isArrayIndex(part)) {
+    const nextArray = Array.isArray(input) ? [...input] : [];
+    const index = Number(part);
+    if (!Number.isInteger(index)) return nextArray;
+    nextArray[index] = setByParts(nextArray[index], rest, value);
+    return nextArray;
+  }
+  const nextObject = isPlainObject(input) ? { ...input } : {};
+  nextObject[part] = setByParts(nextObject[part], rest, value);
+  return nextObject;
+};
+var getByPath = (input, path) => {
+  const parts = path.split(".").filter(Boolean);
+  let current = input;
+  for (const part of parts) {
+    if (Array.isArray(current)) {
+      const index = Number(part);
+      current = Number.isInteger(index) ? current[index] : void 0;
+      continue;
+    }
+    if (isPlainObject(current)) {
+      current = current[part];
+      continue;
+    }
+    return void 0;
+  }
+  return current;
+};
+var setByPath = (input, path, value) => {
+  const parts = path.split(".").filter(Boolean);
+  return parts.length === 0 ? value : setByParts(cloneContainer(input), parts, value);
+};
+function applyStructuredChunk(current, chunk) {
+  if (current && current.streamId !== chunk.streamId) {
+    throw new Error(
+      `Structured chunk streamId mismatch: expected ${current.streamId}, received ${chunk.streamId}.`
+    );
+  }
+  if (current?.status === "done") {
+    throw new Error(
+      `Structured stream ${chunk.streamId} already completed with a final chunk.`
+    );
+  }
+  const nextBase = {
+    streamId: chunk.streamId,
+    dataType: chunk.dataType,
+    status: chunk.kind === "final" ? "done" : "streaming",
+    ...chunk.node ? { node: chunk.node } : {},
+    ...chunk.id ? { id: chunk.id } : {},
+    ...chunk.schemaId ? { schemaId: chunk.schemaId } : {},
+    ...chunk.schemaVersion ? { schemaVersion: chunk.schemaVersion } : {}
+  };
+  if (chunk.kind === "final") {
+    return {
+      ...nextBase,
+      data: chunk.data
+    };
+  }
+  const previousData = current?.data !== void 0 ? current.data : {};
+  if (chunk.kind === "set") {
+    return {
+      ...nextBase,
+      data: setByPath(previousData, chunk.path, chunk.value)
+    };
+  }
+  if (chunk.kind === "append") {
+    const existing2 = getByPath(previousData, chunk.path);
+    const nextItems = Array.isArray(existing2) ? [...existing2, ...chunk.items] : [...chunk.items];
+    return {
+      ...nextBase,
+      data: setByPath(previousData, chunk.path, nextItems)
+    };
+  }
+  const existing = getByPath(previousData, chunk.path);
+  const text = typeof existing === "string" ? existing : "";
+  return {
+    ...nextBase,
+    data: setByPath(previousData, chunk.path, text + chunk.delta)
+  };
+}
+function reduceStructuredChunks(chunks) {
+  return chunks.reduce(
+    (acc, chunk) => {
+      acc[chunk.streamId] = applyStructuredChunk(acc[chunk.streamId], chunk);
+      return acc;
+    },
+    {}
+  );
+}
 
-// src/types/structured-data/index.ts
+// src/structured/structured-stream-accumulator.ts
+var isStructuredDataChunk = (chunk) => chunk.type === "structured-data";
+function createStructuredStreamAccumulator(initialChunks = []) {
+  const states = /* @__PURE__ */ new Map();
+  const apply = (chunk) => {
+    const nextState = applyStructuredChunk(states.get(chunk.streamId), chunk);
+    states.set(chunk.streamId, nextState);
+    return nextState;
+  };
+  for (const chunk of initialChunks) {
+    apply(chunk);
+  }
+  return {
+    apply,
+    applyStreamChunk: (chunk) => {
+      if (!isStructuredDataChunk(chunk)) return void 0;
+      return apply(chunk);
+    },
+    get: (streamId) => states.get(streamId),
+    has: (streamId) => states.has(streamId),
+    delete: (streamId) => states.delete(streamId),
+    clear: () => {
+      states.clear();
+    },
+    size: () => states.size,
+    entries: () => Array.from(states.entries()),
+    values: () => Array.from(states.values()),
+    toRecord: () => Object.fromEntries(states.entries())
+  };
+}
+
+// src/types/stream-chunk.ts
 var import_zod2 = require("zod");
 
-// src/types/structured-data/jobs.ts
+// src/types/structured-data/index.ts
 var import_zod = require("zod");
-var JobsStructuredData = import_zod.z.object({
-  jobs: import_zod.z.array(
-    import_zod.z.object({
-      id: import_zod.z.string(),
-      title: import_zod.z.string(),
-      company: import_zod.z.string(),
-      location: import_zod.z.string(),
-      match: import_zod.z.number()
-    })
-  ),
-  reasoning: import_zod.z.string().optional()
+var StructuredDataBase = import_zod.z.object({
+  type: import_zod.z.literal("structured-data"),
+  streamId: import_zod.z.string(),
+  dataType: import_zod.z.string(),
+  kind: import_zod.z.enum(["set", "append", "text-delta", "final"]),
+  schemaId: import_zod.z.string().optional(),
+  schemaVersion: import_zod.z.string().optional(),
+  id: import_zod.z.string().optional(),
+  node: import_zod.z.string().optional()
 });
-
-// src/types/structured-data/index.ts
-var StructuredDataBase = import_zod2.z.object({
-  type: import_zod2.z.literal("structured-data"),
-  dataType: import_zod2.z.string().optional(),
-  mode: import_zod2.z.enum(["final", "patch", "snapshot"]).optional(),
-  schemaId: import_zod2.z.string().optional(),
-  schemaVersion: import_zod2.z.string().optional(),
-  id: import_zod2.z.string().optional(),
-  opId: import_zod2.z.string().optional(),
-  node: import_zod2.z.string().optional()
+var StructuredSetChunkSchema = StructuredDataBase.extend({
+  kind: import_zod.z.literal("set"),
+  path: import_zod.z.string().min(1),
+  value: import_zod.z.unknown()
 });
-var JobsStructuredDataChunkSchema = StructuredDataBase.extend({
-  dataType: import_zod2.z.literal("jobs"),
-  data: JobsStructuredData
+var StructuredAppendChunkSchema = StructuredDataBase.extend({
+  kind: import_zod.z.literal("append"),
+  path: import_zod.z.string().min(1),
+  items: import_zod.z.array(import_zod.z.unknown())
 });
-var GenericStructuredDataChunkSchema = StructuredDataBase.extend({
-  data: import_zod2.z.unknown()
+var StructuredTextDeltaChunkSchema = StructuredDataBase.extend({
+  kind: import_zod.z.literal("text-delta"),
+  path: import_zod.z.string().min(1),
+  delta: import_zod.z.string()
 });
-var StructuredDataChunkSchema = import_zod2.z.union([
-  JobsStructuredDataChunkSchema,
-  GenericStructuredDataChunkSchema
+var StructuredFinalChunkSchema = StructuredDataBase.extend({
+  kind: import_zod.z.literal("final"),
+  data: import_zod.z.unknown()
+});
+var StructuredDataChunkSchema = import_zod.z.union([
+  StructuredSetChunkSchema,
+  StructuredAppendChunkSchema,
+  StructuredTextDeltaChunkSchema,
+  StructuredFinalChunkSchema
 ]);
 
 // src/types/stream-chunk.ts
-var StreamChunkSchema = import_zod3.z.union([
-  import_zod3.z.object({
-    type: import_zod3.z.literal("session"),
-    sessionId: import_zod3.z.string()
+var StreamChunkSchema = import_zod2.z.union([
+  import_zod2.z.object({
+    type: import_zod2.z.literal("session"),
+    sessionId: import_zod2.z.string()
   }),
-  import_zod3.z.object({
-    type: import_zod3.z.literal("status"),
-    message: import_zod3.z.string(),
-    node: import_zod3.z.string().optional()
+  import_zod2.z.object({
+    type: import_zod2.z.literal("status"),
+    message: import_zod2.z.string(),
+    node: import_zod2.z.string().optional()
   }),
-  import_zod3.z.object({
-    type: import_zod3.z.literal("message"),
-    content: import_zod3.z.string(),
-    node: import_zod3.z.string().optional()
+  import_zod2.z.object({
+    type: import_zod2.z.literal("message"),
+    content: import_zod2.z.string(),
+    node: import_zod2.z.string().optional()
   }),
-  import_zod3.z.object({
-    type: import_zod3.z.literal("text-start"),
-    node: import_zod3.z.string().optional(),
-    id: import_zod3.z.string().optional(),
-    opId: import_zod3.z.string().optional(),
-    segmentId: import_zod3.z.string().optional()
+  import_zod2.z.object({
+    type: import_zod2.z.literal("text-start"),
+    node: import_zod2.z.string().optional(),
+    id: import_zod2.z.string().optional(),
+    opId: import_zod2.z.string().optional(),
+    segmentId: import_zod2.z.string().optional()
   }),
-  import_zod3.z.object({
-    type: import_zod3.z.literal("text-delta"),
-    delta: import_zod3.z.string(),
-    node: import_zod3.z.string().optional(),
-    id: import_zod3.z.string().optional(),
-    opId: import_zod3.z.string().optional(),
-    segmentId: import_zod3.z.string().optional()
+  import_zod2.z.object({
+    type: import_zod2.z.literal("text-delta"),
+    delta: import_zod2.z.string(),
+    node: import_zod2.z.string().optional(),
+    id: import_zod2.z.string().optional(),
+    opId: import_zod2.z.string().optional(),
+    segmentId: import_zod2.z.string().optional()
   }),
-  import_zod3.z.object({
-    type: import_zod3.z.literal("text-end"),
-    node: import_zod3.z.string().optional(),
-    id: import_zod3.z.string().optional(),
-    opId: import_zod3.z.string().optional(),
-    segmentId: import_zod3.z.string().optional()
+  import_zod2.z.object({
+    type: import_zod2.z.literal("text-end"),
+    node: import_zod2.z.string().optional(),
+    id: import_zod2.z.string().optional(),
+    opId: import_zod2.z.string().optional(),
+    segmentId: import_zod2.z.string().optional()
   }),
-  import_zod3.z.object({
-    type: import_zod3.z.literal("tool-result"),
-    tool: import_zod3.z.string().optional(),
-    node: import_zod3.z.string().optional(),
-    content: import_zod3.z.unknown()
+  import_zod2.z.object({
+    type: import_zod2.z.literal("tool-result"),
+    tool: import_zod2.z.string().optional(),
+    node: import_zod2.z.string().optional(),
+    content: import_zod2.z.unknown()
   }),
   // Interrupt request chunk (used to render interactive options in UI)
-  import_zod3.z.object({
-    type: import_zod3.z.literal("interrupt"),
-    requestId: import_zod3.z.string(),
-    resumeToken: import_zod3.z.string(),
-    workflow: import_zod3.z.string().optional(),
-    node: import_zod3.z.string().optional(),
-    id: import_zod3.z.string().optional(),
-    opId: import_zod3.z.string().optional(),
-    schemaId: import_zod3.z.string().optional(),
-    schemaVersion: import_zod3.z.string().optional(),
-    input: import_zod3.z.discriminatedUnion("kind", [
+  import_zod2.z.object({
+    type: import_zod2.z.literal("interrupt"),
+    requestId: import_zod2.z.string(),
+    resumeToken: import_zod2.z.string(),
+    workflow: import_zod2.z.string().optional(),
+    node: import_zod2.z.string().optional(),
+    id: import_zod2.z.string().optional(),
+    opId: import_zod2.z.string().optional(),
+    schemaId: import_zod2.z.string().optional(),
+    schemaVersion: import_zod2.z.string().optional(),
+    input: import_zod2.z.discriminatedUnion("kind", [
       // Text input: question optional, no options
-      import_zod3.z.object({
-        kind: import_zod3.z.literal("text"),
-        multiple: import_zod3.z.boolean(),
-        question: import_zod3.z.string().optional(),
-        id: import_zod3.z.string().optional(),
-        schemaId: import_zod3.z.string().optional(),
-        schemaVersion: import_zod3.z.string().optional(),
-        meta: import_zod3.z.record(import_zod3.z.unknown()).optional(),
-        options: import_zod3.z.array(import_zod3.z.never()).optional()
+      import_zod2.z.object({
+        kind: import_zod2.z.literal("text"),
+        multiple: import_zod2.z.boolean(),
+        question: import_zod2.z.string().optional(),
+        id: import_zod2.z.string().optional(),
+        schemaId: import_zod2.z.string().optional(),
+        schemaVersion: import_zod2.z.string().optional(),
+        meta: import_zod2.z.record(import_zod2.z.unknown()).optional(),
+        options: import_zod2.z.array(import_zod2.z.never()).optional()
       }),
       // Choice/multi-choice: question + options required
-      import_zod3.z.object({
-        kind: import_zod3.z.enum(["choice", "multi-choice"]),
-        multiple: import_zod3.z.boolean(),
-        question: import_zod3.z.string(),
-        id: import_zod3.z.string().optional(),
-        schemaId: import_zod3.z.string().optional(),
-        schemaVersion: import_zod3.z.string().optional(),
-        meta: import_zod3.z.record(import_zod3.z.unknown()).optional(),
-        options: import_zod3.z.array(
-          import_zod3.z.object({
-            id: import_zod3.z.string(),
-            label: import_zod3.z.string(),
-            description: import_zod3.z.string().optional()
+      import_zod2.z.object({
+        kind: import_zod2.z.enum(["choice", "multi-choice"]),
+        multiple: import_zod2.z.boolean(),
+        question: import_zod2.z.string(),
+        id: import_zod2.z.string().optional(),
+        schemaId: import_zod2.z.string().optional(),
+        schemaVersion: import_zod2.z.string().optional(),
+        meta: import_zod2.z.record(import_zod2.z.unknown()).optional(),
+        options: import_zod2.z.array(
+          import_zod2.z.object({
+            id: import_zod2.z.string(),
+            label: import_zod2.z.string(),
+            description: import_zod2.z.string().optional()
           })
         )
       })
     ]),
-    meta: import_zod3.z.record(import_zod3.z.unknown()).optional()
+    meta: import_zod2.z.record(import_zod2.z.unknown()).optional()
   }),
   StructuredDataChunkSchema,
-  import_zod3.z.object({
-    type: import_zod3.z.literal("transition"),
-    transitionTo: import_zod3.z.string(),
-    payload: import_zod3.z.any().optional()
+  import_zod2.z.object({
+    type: import_zod2.z.literal("transition"),
+    transitionTo: import_zod2.z.string(),
+    payload: import_zod2.z.any().optional()
   }),
-  import_zod3.z.object({ type: import_zod3.z.literal("done"), data: import_zod3.z.any().optional() }),
-  import_zod3.z.object({ type: import_zod3.z.literal("error"), message: import_zod3.z.string() })
+  import_zod2.z.object({ type: import_zod2.z.literal("done"), data: import_zod2.z.any().optional() }),
+  import_zod2.z.object({ type: import_zod2.z.literal("error"), message: import_zod2.z.string() })
 ]);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   STREAM_HEADERS,
   StreamChunkSchema,
+  StructuredDataChunkSchema,
+  applyStructuredChunk,
   collectBufferedStream,
   collectStream,
   consumeStream,
   createStreamResponse,
+  createStructuredStreamAccumulator,
   readStream,
+  reduceStructuredChunks,
   streamFromRoute,
   summarizeStreamChunks,
   toSSE