@langchain/core 1.2.0-dev-1765937705265 → 1.2.0

package/dist/language_models/compat.js

@@ -0,0 +1,404 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { AIMessageChunk } from "../messages/ai.js";
+//#region src/language_models/compat.ts
+/**
+* Compatibility bridge: converts legacy `_streamResponseChunks`
+* (`ChatGenerationChunk` / `AIMessageChunk`) output to the new
+* `ChatModelStreamEvent` protocol.
+*
+* @module
+*/
+var compat_exports = /* @__PURE__ */ __exportAll({
+	convertChunksToEvents: () => convertChunksToEvents,
+	finalizeContentBlock: () => finalizeContentBlock
+});
+const MIME_TYPE_BY_AUDIO_FORMAT = {
+	wav: "audio/wav",
+	mp3: "audio/mpeg",
+	flac: "audio/flac",
+	opus: "audio/opus",
+	aac: "audio/aac",
+	pcm16: "audio/pcm"
+};
+const MIME_TYPE_BY_IMAGE_FORMAT = {
+	png: "image/png",
+	jpeg: "image/jpeg",
+	jpg: "image/jpeg",
+	webp: "image/webp",
+	gif: "image/gif"
+};
+function nextBlockIndex(activeBlocks) {
+	let next = 0;
+	for (const index of activeBlocks.keys()) if (index >= next) next = index + 1;
+	return next;
+}
+function getAdditionalKwargs(message) {
+	const additional = message.additional_kwargs;
+	return additional != null && typeof additional === "object" ? additional : {};
+}
+function extractImageBlocksFromToolOutputs(message) {
+	const toolOutputs = getAdditionalKwargs(message).tool_outputs;
+	if (!Array.isArray(toolOutputs)) return [];
+	const blocks = [];
+	for (const entry of toolOutputs) {
+		if (entry == null || typeof entry !== "object") continue;
+		const record = entry;
+		if (record.type !== "image_generation_call") continue;
+		const data = typeof record.result === "string" ? record.result : void 0;
+		const url = typeof record.url === "string" ? record.url : void 0;
+		if (data == null && url == null) continue;
+		const outputFormat = typeof record.output_format === "string" ? record.output_format.toLowerCase() : void 0;
+		const mimeType = (outputFormat != null ? MIME_TYPE_BY_IMAGE_FORMAT[outputFormat] : void 0) ?? "image/png";
+		blocks.push({
+			type: "image",
+			...typeof record.id === "string" ? { id: record.id } : {},
+			...url != null ? { url } : {},
+			...data != null ? { data } : {},
+			mimeType
+		});
+	}
+	return blocks;
+}
+/**
+* Get the audio payload from the message.
+*
+* This handles the OpenAI-shaped `additional_kwargs.audio` payload used by
+* legacy chunk streams; other providers must normalize into this shape first.
+*
+* @param message - The message to get the audio payload from.
+* @returns The audio payload.
+* @internal
+*/
+function getAudioPayload(message) {
+	const audio = getAdditionalKwargs(message).audio;
+	if (audio == null || typeof audio !== "object") return void 0;
+	const record = audio;
+	const data = typeof record.data === "string" ? record.data : void 0;
+	const url = typeof record.url === "string" ? record.url : void 0;
+	const transcript = typeof record.transcript === "string" ? record.transcript : void 0;
+	if (data == null && url == null && transcript == null) return void 0;
+	const explicitMimeType = typeof record.mime_type === "string" ? record.mime_type : typeof record.mimeType === "string" ? record.mimeType : void 0;
+	const format = typeof record.format === "string" ? record.format.toLowerCase() : void 0;
+	const mimeType = explicitMimeType ?? (format != null ? MIME_TYPE_BY_AUDIO_FORMAT[format] : void 0) ?? (data != null ? "audio/wav" : "audio/pcm");
+	return {
+		...typeof record.id === "string" ? { id: record.id } : {},
+		...data != null ? { data } : {},
+		...url != null ? { url } : {},
+		...transcript != null ? { transcript } : {},
+		mimeType
+	};
+}
+/**
+* Convert an async iterable of legacy `ChatGenerationChunk`s into
+* `ChatModelStreamEvent`s with typed deltas.
+*/
+async function* convertChunksToEvents(chunks, options) {
+	const activeBlocks = /* @__PURE__ */ new Map();
+	let messageStarted = false;
+	let lastUsage;
+	let audioStream;
+	const emittedImageKeys = /* @__PURE__ */ new Set();
+	for await (const chunk of chunks) {
+		options?.signal?.throwIfAborted();
+		const msg = chunk.message;
+		let usageHandledInStart = false;
+		if (!messageStarted) {
+			messageStarted = true;
+			const startEvent = {
+				event: "message-start",
+				id: msg.id ?? void 0
+			};
+			if (AIMessageChunk.isInstance(msg) && msg.usage_metadata) {
+				startEvent.usage = msg.usage_metadata;
+				lastUsage = { ...msg.usage_metadata };
+				usageHandledInStart = true;
+			}
+			yield startEvent;
+		}
+		const content = msg.content;
+		if (typeof content === "string") {
+			if (content !== "") {
+				const blockIndex = 0;
+				if (!activeBlocks.has(blockIndex)) {
+					const initial = {
+						type: "text",
+						text: ""
+					};
+					activeBlocks.set(blockIndex, {
+						type: "text",
+						accumulated: initial
+					});
+					yield {
+						event: "content-block-start",
+						index: blockIndex,
+						content: initial
+					};
+				}
+				const block = activeBlocks.get(blockIndex);
+				block.accumulated = {
+					...block.accumulated,
+					text: (block.accumulated.text ?? "") + content
+				};
+				yield {
+					event: "content-block-delta",
+					index: blockIndex,
+					delta: {
+						type: "text-delta",
+						text: content
+					}
+				};
+			}
+		} else if (Array.isArray(content)) for (const part of content) {
+			const blockIndex = typeof part.index === "number" ? part.index : activeBlocks.size;
+			if (!activeBlocks.has(blockIndex)) {
+				activeBlocks.set(blockIndex, {
+					type: part.type,
+					accumulated: { ...part }
+				});
+				yield {
+					event: "content-block-start",
+					index: blockIndex,
+					content: { ...part }
+				};
+			} else {
+				const block = activeBlocks.get(blockIndex);
+				const delta = contentBlockToDelta(part);
+				block.accumulated = applyDeltaToBlock(block.accumulated, delta);
+				yield {
+					event: "content-block-delta",
+					index: blockIndex,
+					delta
+				};
+			}
+		}
+		if (AIMessageChunk.isInstance(msg) && msg.tool_call_chunks && msg.tool_call_chunks.length > 0) for (const toolChunk of msg.tool_call_chunks) {
+			const blockIndex = typeof toolChunk.index === "number" ? toolChunk.index : activeBlocks.size;
+			if (!activeBlocks.has(blockIndex)) {
+				const initial = {
+					type: "tool_call_chunk",
+					id: toolChunk.id,
+					name: toolChunk.name,
+					args: "",
+					index: blockIndex
+				};
+				activeBlocks.set(blockIndex, {
+					type: "tool_call_chunk",
+					accumulated: initial
+				});
+				yield {
+					event: "content-block-start",
+					index: blockIndex,
+					content: initial
+				};
+			}
+			const acc = activeBlocks.get(blockIndex).accumulated;
+			if (toolChunk.id != null) acc.id = toolChunk.id;
+			if (toolChunk.name != null) acc.name = toolChunk.name;
+			acc.args = (acc.args ?? "") + (toolChunk.args ?? "");
+			yield {
+				event: "content-block-delta",
+				index: blockIndex,
+				delta: {
+					type: "block-delta",
+					fields: {
+						type: "tool_call_chunk",
+						..."id" in acc && acc.id != null ? { id: acc.id } : {},
+						..."name" in acc && acc.name != null ? { name: acc.name } : {},
+						args: acc.args
+					}
+				}
+			};
+		}
+		const audioPayload = getAudioPayload(msg);
+		if (audioPayload != null) {
+			if (audioStream == null) {
+				const index = nextBlockIndex(activeBlocks);
+				audioStream = {
+					index,
+					id: audioPayload.id,
+					mimeType: audioPayload.mimeType,
+					transcript: ""
+				};
+				const initial = {
+					type: "audio",
+					...audioPayload.id != null ? { id: audioPayload.id } : {},
+					...audioPayload.url != null ? { url: audioPayload.url } : {},
+					data: "",
+					mimeType: audioPayload.mimeType
+				};
+				activeBlocks.set(index, {
+					type: "audio",
+					accumulated: initial
+				});
+				yield {
+					event: "content-block-start",
+					index,
+					content: initial
+				};
+			}
+			const activeAudio = activeBlocks.get(audioStream.index);
+			if (activeAudio != null) {
+				const accumulated = activeAudio.accumulated;
+				if (audioPayload.id != null && audioStream.id == null) {
+					audioStream.id = audioPayload.id;
+					accumulated.id = audioPayload.id;
+				}
+				if (audioPayload.transcript != null) {
+					audioStream.transcript += audioPayload.transcript;
+					accumulated.transcript = audioStream.transcript;
+					yield {
+						event: "content-block-delta",
+						index: audioStream.index,
+						delta: {
+							type: "block-delta",
+							fields: {
+								type: "audio",
+								transcript: audioStream.transcript
+							}
+						}
+					};
+				}
+				if (audioPayload.data != null && audioPayload.data.length > 0) {
+					accumulated.data = (accumulated.data ?? "") + audioPayload.data;
+					yield {
+						event: "content-block-delta",
+						index: audioStream.index,
+						delta: {
+							type: "data-delta",
+							data: audioPayload.data,
+							encoding: "base64"
+						}
+					};
+				}
+			}
+		}
+		for (const imageBlock of extractImageBlocksFromToolOutputs(msg)) {
+			const imageRecord = imageBlock;
+			const imageKey = imageRecord.id ?? imageRecord.url ?? (imageRecord.data != null ? `${imageRecord.data.length}:${imageRecord.data.slice(0, 32)}` : void 0);
+			if (imageKey != null && emittedImageKeys.has(imageKey)) continue;
+			if (imageKey != null) emittedImageKeys.add(imageKey);
+			const index = nextBlockIndex(activeBlocks);
+			activeBlocks.set(index, {
+				type: "image",
+				accumulated: imageBlock
+			});
+			yield {
+				event: "content-block-start",
+				index,
+				content: imageBlock
+			};
+		}
+		if (!usageHandledInStart && AIMessageChunk.isInstance(msg) && msg.usage_metadata) {
+			const chunkUsage = msg.usage_metadata;
+			if (!lastUsage) lastUsage = { ...chunkUsage };
+			else lastUsage = {
+				input_tokens: lastUsage.input_tokens + chunkUsage.input_tokens,
+				output_tokens: lastUsage.output_tokens + chunkUsage.output_tokens,
+				total_tokens: lastUsage.total_tokens + chunkUsage.total_tokens
+			};
+			yield {
+				event: "usage",
+				usage: { ...lastUsage }
+			};
+		}
+	}
+	for (const [index, block] of activeBlocks) yield {
+		event: "content-block-finish",
+		index,
+		content: finalizeContentBlock(block.accumulated)
+	};
+	yield {
+		event: "message-finish",
+		reason: "stop",
+		...lastUsage ? { usage: lastUsage } : {}
+	};
+}
+/**
+* Apply a typed delta to an accumulated content block.
+* @internal
+*/
+function applyDeltaToBlock(block, delta) {
+	switch (delta.type) {
+		case "text-delta":
+			if (block.type === "text") return {
+				...block,
+				text: (block.text ?? "") + delta.text
+			};
+			return block;
+		case "reasoning-delta":
+			if (block.type === "thinking") return {
+				...block,
+				thinking: (block.thinking ?? "") + delta.reasoning
+			};
+			if (block.type === "reasoning") return {
+				...block,
+				reasoning: (block.reasoning ?? "") + delta.reasoning
+			};
+			return block;
+		case "data-delta": return {
+			...block,
+			data: (block.data ?? "") + delta.data
+		};
+		case "block-delta": return {
+			...block,
+			...delta.fields
+		};
+		default: throw new Error(`Unknown delta type: ${JSON.stringify(delta)}`);
+	}
+}
+function contentBlockToDelta(block) {
+	if (block.type === "text") return {
+		type: "text-delta",
+		text: block.text
+	};
+	if (block.type === "reasoning") return {
+		type: "reasoning-delta",
+		reasoning: block.reasoning
+	};
+	if (block.type === "thinking" && typeof block.thinking === "string") return {
+		type: "reasoning-delta",
+		reasoning: block.thinking
+	};
+	if (typeof block.data === "string") return {
+		type: "data-delta",
+		data: block.data,
+		encoding: "base64"
+	};
+	if (typeof block.type === "string") return {
+		type: "block-delta",
+		fields: { ...block }
+	};
+	throw new Error(`Unsupported content block delta: ${JSON.stringify(block)}`);
+}
+/**
+* Finalize a content block for the finish event.
+* For tool calls, parse the accumulated JSON args string.
+*/
+function finalizeContentBlock(block) {
+	if (block.type === "tool_call_chunk") {
+		const chunk = block;
+		let parsedArgs;
+		try {
+			parsedArgs = JSON.parse(chunk.args ?? "{}");
+		} catch {
+			return {
+				type: "invalid_tool_call",
+				id: chunk.id,
+				name: chunk.name,
+				args: chunk.args,
+				error: "Failed to parse tool call arguments as JSON"
+			};
+		}
+		return {
+			type: "tool_call",
+			id: chunk.id,
+			name: chunk.name,
+			args: parsedArgs
+		};
+	}
+	return block;
+}
+//#endregion
+export { compat_exports, convertChunksToEvents, finalizeContentBlock };
+
+//# sourceMappingURL=compat.js.map

package/dist/language_models/compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compat.js","names":[],"sources":["../../src/language_models/compat.ts"],"sourcesContent":["/**\n * Compatibility bridge: converts legacy `_streamResponseChunks`\n * (`ChatGenerationChunk` / `AIMessageChunk`) output to the new\n * `ChatModelStreamEvent` protocol.\n *\n * @module\n */\n\nimport { AIMessageChunk } from \"../messages/ai.js\";\nimport type { ContentBlock } from \"../messages/content/index.js\";\nimport type { ChatGenerationChunk } from \"../outputs.js\";\nimport type { ChatModelStreamEvent, ContentBlockDelta } from \"./event.js\";\n\nconst MIME_TYPE_BY_AUDIO_FORMAT: Record<string, string> = {\n  wav: \"audio/wav\",\n  mp3: \"audio/mpeg\",\n  flac: \"audio/flac\",\n  opus: \"audio/opus\",\n  aac: \"audio/aac\",\n  pcm16: \"audio/pcm\",\n};\n\nconst MIME_TYPE_BY_IMAGE_FORMAT: Record<string, string> = {\n  png: \"image/png\",\n  jpeg: \"image/jpeg\",\n  jpg: \"image/jpeg\",\n  webp: \"image/webp\",\n  gif: \"image/gif\",\n};\n\ntype AudioStreamState = {\n  index: number;\n  id?: string;\n  mimeType: string;\n  transcript: string;\n};\n\nfunction nextBlockIndex(activeBlocks: Map<number, unknown>): number {\n  let next = 0;\n  for (const index of activeBlocks.keys()) {\n    if (index >= next) next = index + 1;\n  }\n  return next;\n}\n\nfunction getAdditionalKwargs(message: unknown): Record<string, unknown> {\n  const additional = (message as { additional_kwargs?: unknown })\n    .additional_kwargs;\n  return additional != null && typeof additional === \"object\"\n    ? (additional as Record<string, unknown>)\n    : {};\n}\n\nfunction extractImageBlocksFromToolOutputs(message: unknown): ContentBlock[] {\n  const toolOutputs = getAdditionalKwargs(message).tool_outputs;\n  if (!Array.isArray(toolOutputs)) return [];\n\n  const blocks: ContentBlock[] = [];\n  for (const entry of toolOutputs) {\n    if (entry == null || typeof entry !== \"object\") continue;\n    const record = entry as Record<string, unknown>;\n    if (record.type !== \"image_generation_call\") continue;\n\n    const data = typeof record.result === \"string\" ? record.result : undefined;\n    const url = typeof record.url === \"string\" ? record.url : undefined;\n    if (data == null && url == null) continue;\n\n    const outputFormat =\n      typeof record.output_format === \"string\"\n        ? record.output_format.toLowerCase()\n        : undefined;\n    const mimeType =\n      (outputFormat != null\n        ? MIME_TYPE_BY_IMAGE_FORMAT[outputFormat]\n        : undefined) ?? \"image/png\";\n\n    blocks.push({\n      type: \"image\",\n      ...(typeof record.id === \"string\" ? { id: record.id } : {}),\n      ...(url != null ? { url } : {}),\n      ...(data != null ? { data } : {}),\n      mimeType,\n    } as ContentBlock);\n  }\n  return blocks;\n}\n\n/**\n * Get the audio payload from the message.\n *\n * This handles the OpenAI-shaped `additional_kwargs.audio` payload used by\n * legacy chunk streams; other providers must normalize into this shape first.\n *\n * @param message - The message to get the audio payload from.\n * @returns The audio payload.\n * @internal\n */\nfunction getAudioPayload(message: unknown):\n  | {\n      id?: string;\n      data?: string;\n      url?: string;\n      transcript?: string;\n      mimeType: string;\n    }\n  | undefined {\n  const audio = getAdditionalKwargs(message).audio;\n  if (audio == null || typeof audio !== \"object\") return undefined;\n  const record = audio as Record<string, unknown>;\n\n  const data = typeof record.data === \"string\" ? record.data : undefined;\n  const url = typeof record.url === \"string\" ? record.url : undefined;\n  const transcript =\n    typeof record.transcript === \"string\" ? record.transcript : undefined;\n  if (data == null && url == null && transcript == null) return undefined;\n\n  const explicitMimeType =\n    typeof record.mime_type === \"string\"\n      ? record.mime_type\n      : typeof record.mimeType === \"string\"\n        ? record.mimeType\n        : undefined;\n  const format =\n    typeof record.format === \"string\" ? record.format.toLowerCase() : undefined;\n  const mimeType =\n    explicitMimeType ??\n    (format != null ? MIME_TYPE_BY_AUDIO_FORMAT[format] : undefined) ??\n    (data != null ? \"audio/wav\" : \"audio/pcm\");\n\n  return {\n    ...(typeof record.id === \"string\" ? { id: record.id } : {}),\n    ...(data != null ? { data } : {}),\n    ...(url != null ? { url } : {}),\n    ...(transcript != null ? { transcript } : {}),\n    mimeType,\n  };\n}\n\n/**\n * Convert an async iterable of legacy `ChatGenerationChunk`s into\n * `ChatModelStreamEvent`s with typed deltas.\n */\nexport async function* convertChunksToEvents(\n  chunks: AsyncIterable<ChatGenerationChunk>,\n  options?: { signal?: AbortSignal }\n): AsyncGenerator<ChatModelStreamEvent> {\n  const activeBlocks = new Map<\n    number,\n    { type: string; accumulated: ContentBlock }\n  >();\n  let messageStarted = false;\n  let lastUsage:\n    | { input_tokens: number; output_tokens: number; total_tokens: number }\n    | undefined;\n  let audioStream: AudioStreamState | undefined;\n  const emittedImageKeys = new Set<string>();\n\n  for await (const chunk of chunks) {\n    options?.signal?.throwIfAborted();\n\n    const msg = chunk.message;\n\n    // Message start\n    let usageHandledInStart = false;\n    if (!messageStarted) {\n      messageStarted = true;\n      const startEvent: ChatModelStreamEvent = {\n        event: \"message-start\" as const,\n        id: msg.id ?? undefined,\n      };\n      if (AIMessageChunk.isInstance(msg) && msg.usage_metadata) {\n        (startEvent as { usage?: unknown }).usage = msg.usage_metadata;\n        lastUsage = { ...msg.usage_metadata };\n        usageHandledInStart = true;\n      }\n      yield startEvent;\n    }\n\n    // Process content\n    const content = msg.content;\n    if (typeof content === \"string\") {\n      if (content !== \"\") {\n        const blockIndex = 0;\n        if (!activeBlocks.has(blockIndex)) {\n          const initial: ContentBlock.Text = { type: \"text\", text: \"\" };\n          activeBlocks.set(blockIndex, {\n            type: \"text\",\n            accumulated: initial,\n          });\n          yield {\n            event: \"content-block-start\" as const,\n            index: blockIndex,\n            content: initial,\n          };\n        }\n        const block = activeBlocks.get(blockIndex)!;\n        block.accumulated = {\n          ...block.accumulated,\n          text: ((block.accumulated as { text?: string }).text ?? \"\") + content,\n        };\n        yield {\n          event: \"content-block-delta\" as const,\n          index: blockIndex,\n          delta: { type: \"text-delta\" as const, text: content },\n        };\n      }\n    } else if (Array.isArray(content)) {\n      for (const part of content) {\n        const blockIndex =\n          typeof part.index === \"number\" ? part.index : activeBlocks.size;\n\n        if (!activeBlocks.has(blockIndex)) {\n          activeBlocks.set(blockIndex, {\n            type: part.type,\n            accumulated: { ...part },\n          });\n          yield {\n            event: \"content-block-start\" as const,\n            index: blockIndex,\n            content: { ...part },\n          };\n        } else {\n          const block = activeBlocks.get(blockIndex)!;\n          const delta = contentBlockToDelta(part);\n          block.accumulated = applyDeltaToBlock(block.accumulated, delta);\n          yield {\n            event: \"content-block-delta\" as const,\n            index: blockIndex,\n            delta,\n          };\n        }\n      }\n    }\n\n    // Tool call chunks\n    if (\n      AIMessageChunk.isInstance(msg) &&\n      msg.tool_call_chunks &&\n      msg.tool_call_chunks.length > 0\n    ) {\n      for (const toolChunk of msg.tool_call_chunks) {\n        const blockIndex =\n          typeof toolChunk.index === \"number\"\n            ? toolChunk.index\n            : activeBlocks.size;\n\n        if (!activeBlocks.has(blockIndex)) {\n          const initial: ContentBlock = {\n            type: \"tool_call_chunk\" as const,\n            id: toolChunk.id,\n            name: toolChunk.name,\n            args: \"\",\n            index: blockIndex,\n          };\n          activeBlocks.set(blockIndex, {\n            type: \"tool_call_chunk\",\n            accumulated: initial,\n          });\n          yield {\n            event: \"content-block-start\" as const,\n            index: blockIndex,\n            content: initial,\n          };\n        }\n\n        // Accumulate tool call args internally, emit incremental content chunks.\n        const block = activeBlocks.get(blockIndex)!;\n        const acc = block.accumulated as {\n          args?: string;\n          id?: string;\n          name?: string;\n        };\n        if (toolChunk.id != null) acc.id = toolChunk.id;\n        if (toolChunk.name != null) acc.name = toolChunk.name;\n        acc.args = (acc.args ?? \"\") + (toolChunk.args ?? \"\");\n        yield {\n          event: \"content-block-delta\" as const,\n          index: blockIndex,\n          delta: {\n            type: \"block-delta\" as const,\n            fields: {\n              type: \"tool_call_chunk\",\n              ...(\"id\" in acc && acc.id != null ? { id: acc.id } : {}),\n              ...(\"name\" in acc && acc.name != null ? { name: acc.name } : {}),\n              args: acc.args,\n            },\n          },\n        };\n      }\n    }\n\n    const audioPayload = getAudioPayload(msg);\n    if (audioPayload != null) {\n      if (audioStream == null) {\n        const index = nextBlockIndex(activeBlocks);\n        audioStream = {\n          index,\n          id: audioPayload.id,\n          mimeType: audioPayload.mimeType,\n          transcript: \"\",\n        };\n        const initial = {\n          type: \"audio\",\n          ...(audioPayload.id != null ? { id: audioPayload.id } : {}),\n          ...(audioPayload.url != null ? { url: audioPayload.url } : {}),\n          data: \"\",\n          mimeType: audioPayload.mimeType,\n        } as ContentBlock;\n        activeBlocks.set(index, {\n          type: \"audio\",\n          accumulated: initial,\n        });\n        yield {\n          event: \"content-block-start\" as const,\n          index,\n          content: initial,\n        };\n      }\n\n      const activeAudio = activeBlocks.get(audioStream.index);\n      if (activeAudio != null) {\n        const accumulated = activeAudio.accumulated as ContentBlock & {\n          data?: string;\n          transcript?: string;\n        };\n        if (audioPayload.id != null && audioStream.id == null) {\n          audioStream.id = audioPayload.id;\n          (accumulated as { id?: string }).id = audioPayload.id;\n        }\n        if (audioPayload.transcript != null) {\n          audioStream.transcript += audioPayload.transcript;\n          accumulated.transcript = audioStream.transcript;\n          yield {\n            event: \"content-block-delta\" as const,\n            index: audioStream.index,\n            delta: {\n              type: \"block-delta\" as const,\n              fields: {\n                type: \"audio\",\n                transcript: audioStream.transcript,\n              },\n            },\n          };\n        }\n        if (audioPayload.data != null && audioPayload.data.length > 0) {\n          accumulated.data = (accumulated.data ?? \"\") + audioPayload.data;\n          yield {\n            event: \"content-block-delta\" as const,\n            index: audioStream.index,\n            delta: {\n              type: \"data-delta\" as const,\n              data: audioPayload.data,\n              encoding: \"base64\" as const,\n            },\n          };\n        }\n      }\n    }\n\n    for (const imageBlock of extractImageBlocksFromToolOutputs(msg)) {\n      const imageRecord = imageBlock as ContentBlock & {\n        id?: string;\n        url?: string;\n        data?: string;\n      };\n      const imageKey =\n        imageRecord.id ??\n        imageRecord.url ??\n        (imageRecord.data != null\n          ? `${imageRecord.data.length}:${imageRecord.data.slice(0, 32)}`\n          : undefined);\n      if (imageKey != null && emittedImageKeys.has(imageKey)) continue;\n      if (imageKey != null) emittedImageKeys.add(imageKey);\n\n      const index = nextBlockIndex(activeBlocks);\n      activeBlocks.set(index, {\n        type: \"image\",\n        accumulated: imageBlock,\n      });\n      yield {\n        event: \"content-block-start\" as const,\n        index,\n        content: imageBlock,\n      };\n    }\n\n    // Usage\n    if (\n      !usageHandledInStart &&\n      AIMessageChunk.isInstance(msg) &&\n      msg.usage_metadata\n    ) {\n      const chunkUsage = msg.usage_metadata;\n      if (!lastUsage) {\n        lastUsage = { ...chunkUsage };\n      } else {\n        lastUsage = {\n          input_tokens: lastUsage.input_tokens + chunkUsage.input_tokens,\n          output_tokens: lastUsage.output_tokens + chunkUsage.output_tokens,\n          total_tokens: lastUsage.total_tokens + chunkUsage.total_tokens,\n        };\n      }\n      yield { event: \"usage\" as const, usage: { ...lastUsage } };\n    }\n  }\n\n  // Finish all blocks\n  for (const [index, block] of activeBlocks) {\n    const finalized = finalizeContentBlock(block.accumulated);\n    yield {\n      event: \"content-block-finish\" as const,\n      index,\n      content: finalized,\n    };\n  }\n\n  yield {\n    event: \"message-finish\" as const,\n    reason: \"stop\" as const,\n    ...(lastUsage ? { usage: lastUsage } : {}),\n  };\n}\n\n/**\n * Apply a typed delta to an accumulated content block.\n * @internal\n */\nfunction applyDeltaToBlock(\n  block: ContentBlock,\n  delta: ContentBlockDelta\n): ContentBlock {\n  switch (delta.type) {\n    case \"text-delta\":\n      if (block.type === \"text\") {\n        return {\n          ...block,\n          text: (block.text ?? \"\") + delta.text,\n        };\n      }\n      return block;\n    case \"reasoning-delta\":\n      if (block.type === \"thinking\") {\n        return {\n          ...block,\n          thinking: (block.thinking ?? \"\") + delta.reasoning,\n        };\n      }\n      if (block.type === \"reasoning\") {\n        return {\n          ...block,\n          reasoning: (block.reasoning ?? \"\") + delta.reasoning,\n        };\n      }\n      return block;\n    case \"data-delta\":\n      return {\n        ...block,\n        data: (block.data ?? \"\") + delta.data,\n      };\n    case \"block-delta\":\n      return { ...block, ...delta.fields } as ContentBlock;\n    default:\n      throw new Error(`Unknown delta type: ${JSON.stringify(delta)}`);\n  }\n}\n\nfunction contentBlockToDelta(block: ContentBlock): ContentBlockDelta {\n  if (block.type === \"text\") {\n    return { type: \"text-delta\", text: (block as ContentBlock.Text).text };\n  }\n  if (block.type === \"reasoning\") {\n    return {\n      type: \"reasoning-delta\",\n      reasoning: (block as ContentBlock.Reasoning).reasoning,\n    };\n  }\n  if (block.type === \"thinking\" && typeof block.thinking === \"string\") {\n    return {\n      type: \"reasoning-delta\",\n      reasoning: block.thinking,\n    };\n  }\n  if (typeof block.data === \"string\") {\n    return {\n      type: \"data-delta\",\n      data: block.data,\n      encoding: \"base64\",\n    };\n  }\n  if (typeof block.type === \"string\") {\n    return {\n      type: \"block-delta\",\n      fields: {\n        ...(block as unknown as { type: string } & Record<string, unknown>),\n      },\n    };\n  }\n\n  throw new Error(`Unsupported content block delta: ${JSON.stringify(block)}`);\n}\n\n/**\n * Finalize a content block for the finish event.\n * For tool calls, parse the accumulated JSON args string.\n */\nexport function finalizeContentBlock(block: ContentBlock): ContentBlock {\n  if (block.type === \"tool_call_chunk\") {\n    const chunk = block as ContentBlock.Tools.ToolCallChunk;\n    let parsedArgs: unknown;\n    try {\n      parsedArgs = JSON.parse(chunk.args ?? \"{}\");\n    } catch {\n      return {\n        type: \"invalid_tool_call\" as const,\n        id: chunk.id,\n        name: chunk.name,\n        args: chunk.args,\n        error: \"Failed to parse tool call arguments as JSON\",\n      } as ContentBlock.Tools.InvalidToolCall;\n    }\n    return {\n      type: \"tool_call\" as const,\n      id: chunk.id,\n      name: chunk.name!,\n      args: parsedArgs,\n    } as ContentBlock.Tools.ToolCall;\n  }\n\n  return block;\n}\n"],"mappings":"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"}

package/dist/language_models/event.cjs

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/language_models/event.ts
+var event_exports = /* @__PURE__ */ require("../_virtual/_rolldown/runtime.cjs").__exportAll({});
+//#endregion
+Object.defineProperty(exports, "event_exports", {
+	enumerable: true,
+	get: function() {
+		return event_exports;
+	}
+});
+
+//# sourceMappingURL=event.cjs.map

package/dist/language_models/event.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.cjs","names":[],"sources":["../../src/language_models/event.ts"],"sourcesContent":["/**\n * Chat model streaming event protocol.\n *\n * Defines a content-block-centric event model for streaming chat model responses.\n * Events carry LangChain {@link ContentBlock} types on lifecycle boundaries\n * and explicit delta variants for incremental updates during streaming.\n *\n * ## Design Principles\n *\n * 1. **Content-block deltas have explicit merge semantics.** Text,\n *    reasoning, and data deltas append to named fields. Generic block deltas\n *    shallow-merge fields onto the active content block.\n *\n * 2. **Lifecycle completeness.** Every streamable entity has explicit start and finish\n *    events. Consumers never need to infer boundaries from absence of events.\n *\n * 3. **Interleaving allowed.** Content blocks may interleave (e.g., parallel tool calls).\n *    The only invariant: a block's start precedes its deltas, and its deltas precede\n *    its finish. No ordering constraint between different blocks.\n *\n * 4. **Provider passthrough.** Native provider events that don't map to standard types\n *    are forwarded as {@link ProviderEvent} rather than silently dropped.\n *\n * ## Lifecycle Contract\n *\n * ```\n * MessageStart\n *   -> ContentBlockStart(index=0, content=...)\n *   -> ContentBlockDelta(index=0, delta={ type: \"text-delta\", text: \"Hello\" })\n *   -> ContentBlockDelta(index=0, delta={ type: \"text-delta\", text: \" world\" })\n *   -> ContentBlockFinish(index=0, content=...)\n *   -> UsageUpdate(...)\n * -> MessageFinish(reason, usage?)\n * ```\n *\n * @module\n */\n\nimport type { ContentBlock } from \"../messages/content/index.js\";\nimport type { UsageMetadata } from \"../messages/metadata.js\";\n\n// ─── Message Lifecycle ──────────────────────────────────────────\n\n/**\n * Emitted once at the start of a model response.\n */\nexport interface MessageStartEvent {\n  event: \"message-start\";\n  /** Optional message ID assigned by the provider. */\n  id?: string;\n  /**\n   * Initial usage snapshot, if the provider reports input token counts\n   * before content begins streaming (e.g., Anthropic's `message_start`).\n   */\n  usage?: Partial<UsageMetadata>;\n}\n\n/**\n * Finish reason for a model response.\n *\n * - `\"stop\"`: Natural end of generation.\n * - `\"length\"`: Hit max token limit.\n * - `\"tool_use\"`: Model is requesting tool execution.\n * - `\"content_filter\"`: Content was filtered by safety systems.\n */\nexport type FinishReason = \"stop\" | \"length\" | \"tool_use\" | \"content_filter\";\n\n/**\n * Emitted once when the model response is complete.\n */\nexport interface MessageFinishEvent {\n  event: \"message-finish\";\n  /** Why the model stopped generating. */\n  reason?: FinishReason;\n  /** Final usage snapshot. */\n  usage?: Partial<UsageMetadata>;\n  /** Provider-specific response metadata (model name, response ID, headers, etc.). */\n  responseMetadata?: Record<string, unknown>;\n}\n\n// ─── Content Block Lifecycle ────────────────────────────────────\n// See https://github.com/langchain-ai/agent-protocol/blob/main/streaming/protocol.cddl\n\n/**\n * Emitted when a new content block begins streaming.\n *\n * @example\n * ```ts\n * { event: \"content-block-start\", index: 0,\n *   content: { type: \"text\", text: \"\" } }\n * ```\n */\nexport interface ContentBlockStartEvent {\n  event: \"content-block-start\";\n  /** Positional index of this block within the message. */\n  index: number;\n  /** Initial state of the content block. */\n  content: ContentBlock;\n}\n\n// ─── Content Block Deltas ───────────────────────────────────────\n\n/**\n * Incremental text content. Append `text` to the active block's `text` field.\n */\nexport interface TextDelta {\n  type: \"text-delta\";\n  /** The new text to append. */\n  text: string;\n}\n\n/**\n * Incremental reasoning content. Append `reasoning` to the active block's\n * `reasoning` field.\n */\nexport interface ReasoningDelta {\n  type: \"reasoning-delta\";\n  /** The new reasoning text to append. */\n  reasoning: string;\n}\n\n/**\n * Incremental encoded data. Append `data` to the active multimodal block's\n * data field.\n */\nexport interface DataDelta {\n  type: \"data-delta\";\n  /** Encoded data chunk to append. */\n  data: string;\n  /** Encoding for the data chunk. Defaults to `\"base64\"` when omitted. */\n  encoding?: \"base64\";\n}\n\n/**\n * Generic content block field update. Shallow-merge `fields` onto the active\n * content block.\n */\nexport interface BlockDelta {\n  type: \"block-delta\";\n  /** Fields to shallow-merge onto the active content block. */\n  fields: { type: string } & Record<string, unknown>;\n}\n\n/**\n * Union of all content block delta types.\n */\nexport type ContentBlockDelta =\n  | TextDelta\n  | ReasoningDelta\n  | DataDelta\n  | BlockDelta;\n\n/**\n * Emitted for each incremental update within a content block.\n *\n * The `delta` field carries the incremental content block update.\n * Accumulation rules:\n * - `text-delta` → append `text` to the active block's text field\n * - `reasoning-delta` → append `reasoning` to the active block's reasoning field\n * - `data-delta` → append `data` to the active block's data field\n * - `block-delta` → shallow-merge `fields` onto the active block\n *\n * @example\n * ```ts\n * // Text token\n * { event: \"content-block-delta\", index: 0,\n *   delta: { type: \"text-delta\", text: \" world\" } }\n *\n * // Tool call args snapshot\n * { event: \"content-block-delta\", index: 1,\n *   delta: { type: \"block-delta\",\n *     fields: { type: \"tool_call_chunk\", args: '{\"q\":\"wea' } } } }\n *\n * // Provider-specific field (e.g., signature)\n * { event: \"content-block-delta\", index: 0,\n *   delta: { type: \"block-delta\",\n *     fields: { type: \"reasoning\", signature: \"sig_abc\" } } }\n * ```\n */\nexport interface ContentBlockDeltaEvent {\n  event: \"content-block-delta\";\n  /** Positional index of the block being updated. */\n  index: number;\n  /** Incremental content block delta. */\n  delta: ContentBlockDelta;\n}\n\n/**\n * Emitted when a content block is complete.\n *\n * @example\n * ```ts\n * { event: \"content-block-finish\", index: 0,\n *   content: { type: \"text\", text: \"Hello world\" } }\n * ```\n */\nexport interface ContentBlockFinishEvent {\n  event: \"content-block-finish\";\n  /** Positional index of the completed block. */\n  index: number;\n  /** Finalized content block. */\n  content: ContentBlock;\n}\n\n// ─── Usage ──────────────────────────────────────────────────────\n\n/**\n * Emitted whenever the provider reports updated usage information.\n * Each event carries a **running snapshot** (not an additive delta).\n */\nexport interface UsageUpdateEvent {\n  event: \"usage\";\n  /** Current usage snapshot. */\n  usage: Partial<UsageMetadata>;\n}\n\n// ─── Provider Passthrough ───────────────────────────────────────\n\n/**\n * Passthrough for native provider events that don't map to standard types.\n */\nexport interface ProviderEvent {\n  event: \"provider\";\n  /** Provider identifier (e.g., `\"openai\"`, `\"anthropic\"`, `\"google\"`). */\n  provider: string;\n  /** Raw event type name from the provider SDK. */\n  name: string;\n  /** Raw event payload from the provider SDK. */\n  payload: unknown;\n}\n\n// ─── Error ──────────────────────────────────────────────────────\n\n/**\n * Emitted on unrecoverable stream errors.\n */\nexport interface StreamErrorEvent {\n  event: \"error\";\n  /** Human-readable error message. */\n  message: string;\n  /** Optional error code for programmatic handling. */\n  code?: string;\n}\n\n// ─── Union ──────────────────────────────────────────────────────\n\n/**\n * Union of all chat model stream event types.\n */\nexport type ChatModelStreamEvent =\n  | MessageStartEvent\n  | MessageFinishEvent\n  | ContentBlockStartEvent\n  | ContentBlockDeltaEvent\n  | ContentBlockFinishEvent\n  | UsageUpdateEvent\n  | ProviderEvent\n  | StreamErrorEvent;\n"],"mappings":""}

package/dist/language_models/event.d.cts

@@ -0,0 +1,185 @@
+import { ContentBlock } from "../messages/content/index.cjs";
+import { UsageMetadata } from "../messages/metadata.cjs";
+
+//#region src/language_models/event.d.ts
+/**
+ * Emitted once at the start of a model response.
+ */
+interface MessageStartEvent {
+  event: "message-start";
+  /** Optional message ID assigned by the provider. */
+  id?: string;
+  /**
+   * Initial usage snapshot, if the provider reports input token counts
+   * before content begins streaming (e.g., Anthropic's `message_start`).
+   */
+  usage?: Partial<UsageMetadata>;
+}
+/**
+ * Finish reason for a model response.
+ *
+ * - `"stop"`: Natural end of generation.
+ * - `"length"`: Hit max token limit.
+ * - `"tool_use"`: Model is requesting tool execution.
+ * - `"content_filter"`: Content was filtered by safety systems.
+ */
+type FinishReason = "stop" | "length" | "tool_use" | "content_filter";
+/**
+ * Emitted once when the model response is complete.
+ */
+interface MessageFinishEvent {
+  event: "message-finish";
+  /** Why the model stopped generating. */
+  reason?: FinishReason;
+  /** Final usage snapshot. */
+  usage?: Partial<UsageMetadata>;
+  /** Provider-specific response metadata (model name, response ID, headers, etc.). */
+  responseMetadata?: Record<string, unknown>;
+}
+/**
+ * Emitted when a new content block begins streaming.
+ *
+ * @example
+ * ```ts
+ * { event: "content-block-start", index: 0,
+ *   content: { type: "text", text: "" } }
+ * ```
+ */
+interface ContentBlockStartEvent {
+  event: "content-block-start";
+  /** Positional index of this block within the message. */
+  index: number;
+  /** Initial state of the content block. */
+  content: ContentBlock;
+}
+/**
+ * Incremental text content. Append `text` to the active block's `text` field.
+ */
+interface TextDelta {
+  type: "text-delta";
+  /** The new text to append. */
+  text: string;
+}
+/**
+ * Incremental reasoning content. Append `reasoning` to the active block's
+ * `reasoning` field.
+ */
+interface ReasoningDelta {
+  type: "reasoning-delta";
+  /** The new reasoning text to append. */
+  reasoning: string;
+}
+/**
+ * Incremental encoded data. Append `data` to the active multimodal block's
+ * data field.
+ */
+interface DataDelta {
+  type: "data-delta";
+  /** Encoded data chunk to append. */
+  data: string;
+  /** Encoding for the data chunk. Defaults to `"base64"` when omitted. */
+  encoding?: "base64";
+}
+/**
+ * Generic content block field update. Shallow-merge `fields` onto the active
+ * content block.
+ */
+interface BlockDelta {
+  type: "block-delta";
+  /** Fields to shallow-merge onto the active content block. */
+  fields: {
+    type: string;
+  } & Record<string, unknown>;
+}
+/**
+ * Union of all content block delta types.
+ */
+type ContentBlockDelta = TextDelta | ReasoningDelta | DataDelta | BlockDelta;
+/**
+ * Emitted for each incremental update within a content block.
+ *
+ * The `delta` field carries the incremental content block update.
+ * Accumulation rules:
+ * - `text-delta` → append `text` to the active block's text field
+ * - `reasoning-delta` → append `reasoning` to the active block's reasoning field
+ * - `data-delta` → append `data` to the active block's data field
+ * - `block-delta` → shallow-merge `fields` onto the active block
+ *
+ * @example
+ * ```ts
+ * // Text token
+ * { event: "content-block-delta", index: 0,
+ *   delta: { type: "text-delta", text: " world" } }
+ *
+ * // Tool call args snapshot
+ * { event: "content-block-delta", index: 1,
+ *   delta: { type: "block-delta",
+ *     fields: { type: "tool_call_chunk", args: '{"q":"wea' } } } }
+ *
+ * // Provider-specific field (e.g., signature)
+ * { event: "content-block-delta", index: 0,
+ *   delta: { type: "block-delta",
+ *     fields: { type: "reasoning", signature: "sig_abc" } } }
+ * ```
+ */
+interface ContentBlockDeltaEvent {
+  event: "content-block-delta";
+  /** Positional index of the block being updated. */
+  index: number;
+  /** Incremental content block delta. */
+  delta: ContentBlockDelta;
+}
+/**
+ * Emitted when a content block is complete.
+ *
+ * @example
+ * ```ts
+ * { event: "content-block-finish", index: 0,
+ *   content: { type: "text", text: "Hello world" } }
+ * ```
+ */
+interface ContentBlockFinishEvent {
+  event: "content-block-finish";
+  /** Positional index of the completed block. */
+  index: number;
+  /** Finalized content block. */
+  content: ContentBlock;
+}
+/**
+ * Emitted whenever the provider reports updated usage information.
+ * Each event carries a **running snapshot** (not an additive delta).
+ */
+interface UsageUpdateEvent {
+  event: "usage";
+  /** Current usage snapshot. */
+  usage: Partial<UsageMetadata>;
+}
+/**
+ * Passthrough for native provider events that don't map to standard types.
+ */
+interface ProviderEvent {
+  event: "provider";
+  /** Provider identifier (e.g., `"openai"`, `"anthropic"`, `"google"`). */
+  provider: string;
+  /** Raw event type name from the provider SDK. */
+  name: string;
+  /** Raw event payload from the provider SDK. */
+  payload: unknown;
+}
+/**
+ * Emitted on unrecoverable stream errors.
+ */
+interface StreamErrorEvent {
+  event: "error";
+  /** Human-readable error message. */
+  message: string;
+  /** Optional error code for programmatic handling. */
+  code?: string;
+}
+/**
+ * Union of all chat model stream event types.
+ */
+type ChatModelStreamEvent = MessageStartEvent | MessageFinishEvent | ContentBlockStartEvent | ContentBlockDeltaEvent | ContentBlockFinishEvent | UsageUpdateEvent | ProviderEvent | StreamErrorEvent;
+//#endregion
+export { BlockDelta, ChatModelStreamEvent, ContentBlockDelta, ContentBlockDeltaEvent, ContentBlockFinishEvent, ContentBlockStartEvent, DataDelta, FinishReason, MessageFinishEvent, MessageStartEvent, ProviderEvent, ReasoningDelta, StreamErrorEvent, TextDelta, UsageUpdateEvent };
+//# sourceMappingURL=event.d.cts.map

package/dist/language_models/event.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.cts","names":[],"sources":["../../src/language_models/event.ts"],"mappings":";;;;AA4FA;;;AAAA,UA9CiB,iBAAA;EACf,KAAA;EAgDA;EA9CA,EAAA;EAgDS;;;AAQX;EAnDE,KAAA,GAAQ,OAAA,CAAQ,aAAA;AAAA;;;AA6DlB;;;;;AAUA;KA5DY,YAAA;;;;UAKK,kBAAA;EACf,KAAA;EA2DQ;EAzDR,MAAA,GAAS,YAAA;EAgEM;EA9Df,KAAA,GAAQ,OAAA,CAAQ,aAAA;;EAEhB,gBAAA,GAAmB,MAAA;AAAA;;;;;;AAqErB;;;;UAtDiB,sBAAA;EACf,KAAA;EAyDE;EAvDF,KAAA;EAuDY;EArDZ,OAAA,EAAS,YAAA;AAAA;;;;UAQM,SAAA;EACf,IAAA;EAyEqC;EAvErC,IAAA;AAAA;;;;;UAOe,cAAA;EACf,IAAA;EAgFe;EA9Ef,SAAA;AAAA;;;;;UAOe,SAAA;EACf,IAAA;EA2EqB;EAzErB,IAAA;EAkF+B;EAhF/B,QAAA;AAAA;;;;;UAOe,UAAA;EACf,IAAA;EAmFe;EAjFf,MAAA;IAAU,IAAA;EAAA,IAAiB,MAAA;AAAA;;;;KAMjB,iBAAA,GACR,SAAA,GACA,cAAA,GACA,SAAA,GACA,UAAA;;AAsFJ;;;;;;;;;AAaA;;;;;;;;;;;;;;;;;UAtEiB,sBAAA;EACf,KAAA;EA4EE;EA1EF,KAAA;EA2EkB;EAzElB,KAAA,EAAO,iBAAA;AAAA;;;;;;;;;;UAYQ,uBAAA;EACf,KAAA;;EAEA,KAAA;;EAEA,OAAA,EAAS,YAAA;AAAA;;;;;UASM,gBAAA;EACf,KAAA;;EAEA,KAAA,EAAO,OAAA,CAAQ,aAAA;AAAA;;;;UAQA,aAAA;EACf,KAAA;;EAEA,QAAA;;EAEA,IAAA;;EAEA,OAAA;AAAA;;;;UAQe,gBAAA;EACf,KAAA;;EAEA,OAAA;;EAEA,IAAA;AAAA;;;;KAQU,oBAAA,GACR,iBAAA,GACA,kBAAA,GACA,sBAAA,GACA,sBAAA,GACA,uBAAA,GACA,gBAAA,GACA,aAAA,GACA,gBAAA"}