@langchain/core 1.2.0-dev-1775763803878 → 1.2.0

package/dist/language_models/compat.js

@@ -6,33 +6,98 @@ import { AIMessageChunk } from "../messages/ai.js";
 * (`ChatGenerationChunk` / `AIMessageChunk`) output to the new
 * `ChatModelStreamEvent` protocol.
 *
-* This module is used by `BaseChatModel._streamChatModelEvents` as
-* the default implementation when a provider has not yet implemented
-* native event streaming.
-*
 * @module
 */
 var compat_exports = /* @__PURE__ */ __exportAll({
-	accumulateContentBlock: () => accumulateContentBlock,
 	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;
+}
 /**
-* Convert an async iterable of legacy `ChatGenerationChunk`s into
-* `ChatModelStreamEvent`s.
+* Get the audio payload from the message.
 *
-* Tracks content blocks by index, synthesizes start/delta/finish events,
-* and emits usage updates. Handles both string content and array content
-* blocks, as well as tool call chunks.
+* This handles the OpenAI-shaped `additional_kwargs.audio` payload used by
+* legacy chunk streams; other providers must normalize into this shape first.
 *
-* @param chunks - The legacy chunk stream from `_streamResponseChunks`.
-* @param options - Optional signal for abort handling.
-* @returns An async generator of {@link ChatModelStreamEvent}.
+* @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;
@@ -40,7 +105,7 @@ async function* convertChunksToEvents(chunks, options) {
 		if (!messageStarted) {
 			messageStarted = true;
 			const startEvent = {
-				type: "message-start",
+				event: "message-start",
 				id: msg.id ?? void 0
 			};
 			if (AIMessageChunk.isInstance(msg) && msg.usage_metadata) {
@@ -60,79 +125,168 @@ async function* convertChunksToEvents(chunks, options) {
 						text: ""
 					};
 					activeBlocks.set(blockIndex, {
-						started: true,
+						type: "text",
 						accumulated: initial
 					});
 					yield {
-						type: "content-block-start",
+						event: "content-block-start",
 						index: blockIndex,
 						content: initial
 					};
 				}
 				const block = activeBlocks.get(blockIndex);
-				const accumulated = {
-					type: "text",
-					text: block.accumulated.text + content
+				block.accumulated = {
+					...block.accumulated,
+					text: (block.accumulated.text ?? "") + content
 				};
-				block.accumulated = accumulated;
 				yield {
-					type: "content-block-delta",
+					event: "content-block-delta",
 					index: blockIndex,
-					content: accumulated
+					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, {
-					started: true,
+					type: part.type,
 					accumulated: { ...part }
 				});
 				yield {
-					type: "content-block-start",
+					event: "content-block-start",
 					index: blockIndex,
 					content: { ...part }
 				};
 			} else {
 				const block = activeBlocks.get(blockIndex);
-				const accumulated = accumulateContentBlock(block.accumulated, part);
-				block.accumulated = accumulated;
+				const delta = contentBlockToDelta(part);
+				block.accumulated = applyDeltaToBlock(block.accumulated, delta);
 				yield {
-					type: "content-block-delta",
+					event: "content-block-delta",
 					index: blockIndex,
-					content: accumulated
+					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;
-			const delta = {
-				type: "tool_call_chunk",
-				id: toolChunk.id,
-				name: toolChunk.name,
-				args: toolChunk.args,
-				index: blockIndex
-			};
 			if (!activeBlocks.has(blockIndex)) {
+				const initial = {
+					type: "tool_call_chunk",
+					id: toolChunk.id,
+					name: toolChunk.name,
+					args: "",
+					index: blockIndex
+				};
 				activeBlocks.set(blockIndex, {
-					started: true,
-					accumulated: { ...delta }
+					type: "tool_call_chunk",
+					accumulated: initial
 				});
 				yield {
-					type: "content-block-start",
+					event: "content-block-start",
 					index: blockIndex,
-					content: { ...delta }
+					content: initial
 				};
-			} else {
-				const block = activeBlocks.get(blockIndex);
-				const accumulated = accumulateContentBlock(block.accumulated, delta);
-				block.accumulated = accumulated;
+			}
+			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 {
-					type: "content-block-delta",
-					index: blockIndex,
-					content: accumulated
+					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;
@@ -143,58 +297,82 @@ async function* convertChunksToEvents(chunks, options) {
 				total_tokens: lastUsage.total_tokens + chunkUsage.total_tokens
 			};
 			yield {
-				type: "usage",
+				event: "usage",
 				usage: { ...lastUsage }
 			};
 		}
 	}
 	for (const [index, block] of activeBlocks) yield {
-		type: "content-block-finish",
+		event: "content-block-finish",
 		index,
 		content: finalizeContentBlock(block.accumulated)
 	};
 	yield {
-		type: "message-finish",
+		event: "message-finish",
 		reason: "stop",
 		...lastUsage ? { usage: lastUsage } : {}
 	};
 }
 /**
-* Accumulate a content block delta into the running snapshot.
+* Apply a typed delta to an accumulated content block.
+* @internal
 */
-function accumulateContentBlock(accumulated, delta) {
-	if (accumulated.type === "text" && delta.type === "text") return {
-		...accumulated,
-		type: "text",
-		text: accumulated.text + (delta.text ?? "")
-	};
-	if (accumulated.type === "reasoning" && delta.type === "reasoning") return {
-		...accumulated,
-		type: "reasoning",
-		reasoning: accumulated.reasoning + (delta.reasoning ?? "")
-	};
-	if ((accumulated.type === "tool_call_chunk" || accumulated.type === "tool_call") && (delta.type === "tool_call_chunk" || delta.type === "tool_call")) {
-		const accTC = accumulated;
-		const deltaTC = delta;
-		return {
-			...accumulated,
-			type: "tool_call_chunk",
-			id: accTC.id ?? deltaTC.id,
-			name: accTC.name ?? deltaTC.name,
-			args: (accTC.args ?? "") + (deltaTC.args ?? ""),
-			index: accTC.index ?? deltaTC.index
+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)}`);
 	}
-	return {
-		...accumulated,
-		...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, attempts to parse the accumulated args JSON string
-* into an object, upgrading from `tool_call_chunk` to `tool_call`.
+* For tool calls, parse the accumulated JSON args string.
 */
 function finalizeContentBlock(block) {
 	if (block.type === "tool_call_chunk") {
@@ -221,6 +399,6 @@ function finalizeContentBlock(block) {
 	return block;
 }
 //#endregion
-export { accumulateContentBlock, compat_exports, convertChunksToEvents, finalizeContentBlock };
+export { compat_exports, convertChunksToEvents, finalizeContentBlock };
 
 //# sourceMappingURL=compat.js.map

package/dist/language_models/compat.js.map

@@ -1 +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 * This module is used by `BaseChatModel._streamChatModelEvents` as\n * the default implementation when a provider has not yet implemented\n * native event streaming.\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 } from \"./event.js\";\n\n/**\n * Convert an async iterable of legacy `ChatGenerationChunk`s into\n * `ChatModelStreamEvent`s.\n *\n * Tracks content blocks by index, synthesizes start/delta/finish events,\n * and emits usage updates. Handles both string content and array content\n * blocks, as well as tool call chunks.\n *\n * @param chunks - The legacy chunk stream from `_streamResponseChunks`.\n * @param options - Optional signal for abort handling.\n * @returns An async generator of {@link ChatModelStreamEvent}.\n */\nexport async function* convertChunksToEvents(\n  chunks: AsyncIterable<ChatGenerationChunk>,\n  options?: { signal?: AbortSignal }\n): AsyncGenerator<ChatModelStreamEvent> {\n  // Track active content blocks for the bridge\n  const activeBlocks = new Map<\n    number,\n    { started: boolean; accumulated: ContentBlock }\n  >();\n  let messageStarted = false;\n  let lastUsage:\n    | { input_tokens: number; output_tokens: number; total_tokens: number }\n    | undefined;\n\n  for await (const chunk of chunks) {\n    options?.signal?.throwIfAborted();\n\n    const msg = chunk.message;\n\n    // Emit message-start on the first chunk\n    let usageHandledInStart = false;\n    if (!messageStarted) {\n      messageStarted = true;\n      const startEvent: ChatModelStreamEvent = {\n        type: \"message-start\" as const,\n        id: msg.id ?? undefined,\n      };\n      // If first chunk has usage (e.g., Anthropic input tokens)\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 from the chunk\n    const content = msg.content;\n    if (typeof content === \"string\") {\n      if (content !== \"\") {\n        // Simple string content → single text block at index 0\n        const blockIndex = 0;\n\n        if (!activeBlocks.has(blockIndex)) {\n          const initial: ContentBlock.Text = { type: \"text\", text: \"\" };\n          activeBlocks.set(blockIndex, {\n            started: true,\n            accumulated: initial,\n          });\n          yield {\n            type: \"content-block-start\" as const,\n            index: blockIndex,\n            content: initial,\n          };\n        }\n\n        const block = activeBlocks.get(blockIndex)!;\n        const prevText = (block.accumulated as ContentBlock.Text).text;\n        const accumulated: ContentBlock.Text = {\n          type: \"text\",\n          text: prevText + content,\n        };\n        block.accumulated = accumulated;\n\n        yield {\n          type: \"content-block-delta\" as const,\n          index: blockIndex,\n          content: accumulated,\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            started: true,\n            accumulated: { ...part },\n          });\n          yield {\n            type: \"content-block-start\" as const,\n            index: blockIndex,\n            content: { ...part },\n          };\n        } else {\n          // Accumulate into existing block\n          const block = activeBlocks.get(blockIndex)!;\n          const accumulated = accumulateContentBlock(block.accumulated, part);\n          block.accumulated = accumulated;\n\n          yield {\n            type: \"content-block-delta\" as const,\n            index: blockIndex,\n            content: accumulated,\n          };\n        }\n      }\n    }\n\n    // Handle tool call chunks from the legacy path\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        const delta: ContentBlock = {\n          type: \"tool_call_chunk\" as const,\n          id: toolChunk.id,\n          name: toolChunk.name,\n          args: toolChunk.args,\n          index: blockIndex,\n        };\n\n        if (!activeBlocks.has(blockIndex)) {\n          activeBlocks.set(blockIndex, {\n            started: true,\n            accumulated: { ...delta },\n          });\n          yield {\n            type: \"content-block-start\" as const,\n            index: blockIndex,\n            content: { ...delta },\n          };\n        } else {\n          const block = activeBlocks.get(blockIndex)!;\n          const accumulated = accumulateContentBlock(block.accumulated, delta);\n          block.accumulated = accumulated;\n\n          yield {\n            type: \"content-block-delta\" as const,\n            index: blockIndex,\n            content: accumulated,\n          };\n        }\n      }\n    }\n\n    // Accumulate usage (legacy chunks use additive usage, not snapshots)\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 { type: \"usage\" as const, usage: { ...lastUsage } };\n    }\n  }\n\n  // Emit content-block-finish for all active blocks\n  for (const [index, block] of activeBlocks) {\n    const finalized = finalizeContentBlock(block.accumulated);\n    yield {\n      type: \"content-block-finish\" as const,\n      index,\n      content: finalized,\n    };\n  }\n\n  // Emit message-finish\n  yield {\n    type: \"message-finish\" as const,\n    reason: \"stop\" as const,\n    ...(lastUsage ? { usage: lastUsage } : {}),\n  };\n}\n\n/**\n * Accumulate a content block delta into the running snapshot.\n */\nexport function accumulateContentBlock(\n  accumulated: ContentBlock,\n  delta: ContentBlock\n): ContentBlock {\n  if (accumulated.type === \"text\" && delta.type === \"text\") {\n    return {\n      ...accumulated,\n      type: \"text\" as const,\n      text:\n        (accumulated as ContentBlock.Text).text +\n        ((delta as ContentBlock.Text).text ?? \"\"),\n    } as ContentBlock.Text;\n  }\n\n  if (accumulated.type === \"reasoning\" && delta.type === \"reasoning\") {\n    return {\n      ...accumulated,\n      type: \"reasoning\" as const,\n      reasoning:\n        (accumulated as ContentBlock.Reasoning).reasoning +\n        ((delta as ContentBlock.Reasoning).reasoning ?? \"\"),\n    } as ContentBlock.Reasoning;\n  }\n\n  if (\n    (accumulated.type === \"tool_call_chunk\" ||\n      accumulated.type === \"tool_call\") &&\n    (delta.type === \"tool_call_chunk\" || delta.type === \"tool_call\")\n  ) {\n    const accTC = accumulated as ContentBlock.Tools.ToolCallChunk;\n    const deltaTC = delta as ContentBlock.Tools.ToolCallChunk;\n    return {\n      ...accumulated,\n      type: \"tool_call_chunk\" as const,\n      id: accTC.id ?? deltaTC.id,\n      name: accTC.name ?? deltaTC.name,\n      args: (accTC.args ?? \"\") + (deltaTC.args ?? \"\"),\n      index: accTC.index ?? deltaTC.index,\n    } as ContentBlock.Tools.ToolCallChunk;\n  }\n\n  // For block types we don't know how to merge, just spread the delta over\n  return { ...accumulated, ...delta };\n}\n\n/**\n * Finalize a content block for the finish event.\n *\n * For tool calls, attempts to parse the accumulated args JSON string\n * into an object, upgrading from `tool_call_chunk` to `tool_call`.\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      // If JSON parsing fails, return as invalid tool call\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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"}
+{"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.map

@@ -1 +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 directly as accumulated\n * snapshots.\n *\n * ## Design Principles\n *\n * 1. **Content blocks are the universal carrier.** Events carry {@link ContentBlock}\n *    instances directly — the block's `type` field is the discriminant. New content\n *    block types automatically work without protocol changes.\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. **Accumulated snapshots.** Each {@link ContentBlockDeltaEvent} carries the\n *    accumulated state of the content block so far. Aggregation logic lives in the\n *    provider adapter, not the consumer. Consumers who need incremental deltas\n *    track previous state and diff.\n *\n * 4. **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 * 5. **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, ...)\n *   -> ContentBlockStart(index=1, ...)        // can start before 0 finishes\n *   -> ContentBlockDelta(index=0, ...)\n *   -> ContentBlockDelta(index=1, ...)        // interleaved\n *   -> ContentBlockFinish(index=0, ...)       // blocks finish independently\n *   -> ContentBlockDelta(index=1, ...)\n *   -> ContentBlockFinish(index=1, ...)\n *   -> UsageUpdate(...)                       // may appear at any point\n * -> MessageFinish(reason, usage?)\n * ```\n *\n * @module\n */\n\nimport type {\n  ContentBlock,\n  PartialContentBlock,\n} from \"../messages/content/index.js\";\nimport type { UsageMetadata } from \"../messages/metadata.js\";\n\n/**\n * Emitted once at the start of a model response.\n */\nexport interface MessageStartEvent {\n  type: \"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?: 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  type: \"message-finish\";\n  /** Why the model stopped generating. */\n  reason: FinishReason;\n  /** Final usage snapshot. */\n  usage?: UsageMetadata;\n  /** Provider-specific response metadata (model name, response ID, headers, etc.). */\n  responseMetadata?: Record<string, unknown>;\n}\n\n/**\n * Emitted when a new content block begins streaming.\n *\n * @example\n * ```ts\n * // Text block starting\n * { type: \"content-block-start\", index: 0,\n *   content: { type: \"text\", text: \"\" } }\n *\n * // Tool call starting\n * { type: \"content-block-start\", index: 1,\n *   content: { type: \"tool_call\", id: \"call_1\", name: \"search\", args: \"\" } }\n *\n * // Reasoning starting\n * { type: \"content-block-start\", index: 2,\n *   content: { type: \"reasoning\", reasoning: \"\" } }\n * ```\n */\nexport interface ContentBlockStartEvent {\n  type: \"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/**\n * Emitted for each incremental update within a content block.\n *\n * Carries the **accumulated state** of the content block so far.\n * The content is deeply partial — not all fields may be populated during\n * streaming (e.g., a tool call may have `name` but `args` is still being\n * streamed as a partial JSON string).\n *\n * Consumers who need incremental deltas (e.g., new tokens only) should\n * track the previous state and diff against the new accumulated state.\n *\n * Aggregation into `AIMessage` is trivial:\n * `message.content[event.index] = event.content`\n *\n * @example\n * ```ts\n * // First text delta — accumulated so far\n * { type: \"content-block-delta\", index: 0,\n *   content: { type: \"text\", text: \"Hello\" } }\n *\n * // Second text delta — accumulated so far\n * { type: \"content-block-delta\", index: 0,\n *   content: { type: \"text\", text: \"Hello world\" } }\n *\n * // Tool call args — accumulated so far\n * { type: \"content-block-delta\", index: 1,\n *   content: { type: \"tool_call\", id: \"call_1\", name: \"search\", args: '{\"q\":\"wea' } }\n * ```\n */\nexport interface ContentBlockDeltaEvent {\n  type: \"content-block-delta\";\n  /** Positional index of the block being updated. */\n  index: number;\n  /** Accumulated state of the content block after this update. Deeply partial. */\n  content: PartialContentBlock;\n}\n\n/**\n * Emitted when a content block is complete.\n *\n * The `content` carries the **finalized** block. For tool calls, this means\n * args have been parsed from a JSON string into an object.\n *\n * @example\n * ```ts\n * // Finalized text block\n * { type: \"content-block-finish\", index: 0,\n *   content: { type: \"text\", text: \"The weather is sunny.\" } }\n *\n * // Finalized tool call (args parsed)\n * { type: \"content-block-finish\", index: 1,\n *   content: { type: \"tool_call\", id: \"call_1\", name: \"search\",\n *              args: { q: \"weather\" } } }\n * ```\n */\nexport interface ContentBlockFinishEvent {\n  type: \"content-block-finish\";\n  /** Positional index of the completed block. */\n  index: number;\n  /** Finalized content block. */\n  content: ContentBlock;\n}\n\n/**\n * Emitted whenever the provider reports updated usage information.\n *\n * May appear at any point during streaming. Each event carries a\n * **running snapshot** of usage (not an additive delta), so consumers\n * can simply take the latest value.\n *\n * @example\n * ```ts\n * // After message_start (Anthropic: input tokens known)\n * { type: \"usage\", usage: { input_tokens: 1234, output_tokens: 0, total_tokens: 1234 } }\n *\n * // After streaming completes\n * { type: \"usage\", usage: { input_tokens: 1234, output_tokens: 567, total_tokens: 1801 } }\n * ```\n */\nexport interface UsageUpdateEvent {\n  type: \"usage\";\n  /** Current usage snapshot. */\n  usage: UsageMetadata;\n}\n\n/**\n * Passthrough for native provider events that don't map to standard types.\n *\n * Provider adapters map recognized events to standard {@link ChatModelStreamEvent}\n * types and forward everything else as `ProviderEvent`. This ensures no information\n * is silently dropped.\n *\n * @example\n * ```ts\n * // OpenAI server-side web search in progress\n * { type: \"provider\", provider: \"openai\",\n *   name: \"response.web_search_call.searching\",\n *   payload: { item_id: \"ws_123\", output_index: 0 } }\n *\n * // Anthropic context management signal\n * { type: \"provider\", provider: \"anthropic\",\n *   name: \"context_management\",\n *   payload: { ... } }\n * ```\n */\nexport interface ProviderEvent {\n  type: \"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/**\n * Emitted on unrecoverable stream errors.\n */\nexport interface StreamErrorEvent {\n  type: \"error\";\n  /** Human-readable error message. */\n  message: string;\n  /** Optional error code for programmatic handling. */\n  code?: string;\n}\n\n/**\n * Union of all chat model stream event types.\n *\n * This is the type yielded by `ChatModelStream[Symbol.asyncIterator]()`.\n */\nexport type ChatModelStreamEvent =\n  | MessageStartEvent\n  | MessageFinishEvent\n  | ContentBlockStartEvent\n  | ContentBlockDeltaEvent\n  | ContentBlockFinishEvent\n  | UsageUpdateEvent\n  | ProviderEvent\n  | StreamErrorEvent;\n"],"mappings":""}
+{"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":""}