@langchain/core 1.1.39 → 1.1.40-dev-1777073688723

package/dist/language_models/compat.js

@@ -0,0 +1,216 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+import { isAIMessageChunk } 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
+});
+/**
+* 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;
+	for await (const chunk of chunks) {
+		options?.signal?.throwIfAborted();
+		const msg = chunk.message;
+		let usageHandledInStart = false;
+		if (!messageStarted) {
+			messageStarted = true;
+			const startEvent = {
+				type: "message-start",
+				id: msg.id ?? void 0
+			};
+			if (isAIMessageChunk(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 {
+						type: "content-block-start",
+						index: blockIndex,
+						content: initial
+					};
+				}
+				const block = activeBlocks.get(blockIndex);
+				block.accumulated = {
+					...block.accumulated,
+					text: (block.accumulated.text ?? "") + content
+				};
+				yield {
+					type: "content-block-delta",
+					index: blockIndex,
+					content: {
+						type: "text",
+						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 {
+					type: "content-block-start",
+					index: blockIndex,
+					content: { ...part }
+				};
+			} else {
+				const block = activeBlocks.get(blockIndex);
+				block.accumulated = applyDeltaToBlock(block.accumulated, part);
+				yield {
+					type: "content-block-delta",
+					index: blockIndex,
+					content: part
+				};
+			}
+		}
+		if (isAIMessageChunk(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 {
+					type: "content-block-start",
+					index: blockIndex,
+					content: initial
+				};
+			}
+			const block = activeBlocks.get(blockIndex);
+			const acc = block.accumulated;
+			if (toolChunk.id != null) acc.id = toolChunk.id;
+			if (toolChunk.name != null) acc.name = toolChunk.name;
+			acc.args = (acc.args ?? "") + (toolChunk.args ?? "");
+			yield {
+				type: "content-block-delta",
+				index: blockIndex,
+				content: { ...block.accumulated }
+			};
+		}
+		if (!usageHandledInStart && isAIMessageChunk(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 {
+				type: "usage",
+				usage: { ...lastUsage }
+			};
+		}
+	}
+	for (const [index, block] of activeBlocks) yield {
+		type: "content-block-finish",
+		index,
+		content: finalizeContentBlock(block.accumulated)
+	};
+	yield {
+		type: "message-finish",
+		reason: "stop",
+		...lastUsage ? { usage: lastUsage } : {}
+	};
+}
+/**
+* Apply a typed delta to an accumulated content block.
+* @internal
+*/
+function applyDeltaToBlock(block, delta) {
+	if (block.type !== delta.type) return { ...delta };
+	switch (delta.type) {
+		case "text": return {
+			...block,
+			...delta,
+			text: (block.text ?? "") + delta.text
+		};
+		case "reasoning": return {
+			...block,
+			...delta,
+			reasoning: (block.reasoning ?? "") + delta.reasoning
+		};
+		case "tool_call_chunk":
+		case "server_tool_call_chunk": {
+			const merged = {
+				...block,
+				...delta
+			};
+			if (delta.id == null && "id" in block && block.id != null) merged.id = block.id;
+			if (delta.name == null && "name" in block && block.name != null) merged.name = block.name;
+			merged.args = `${("args" in block ? block.args : "") ?? ""}${delta.args ?? ""}`;
+			return merged;
+		}
+		default: return {
+			...block,
+			...delta
+		};
+	}
+}
+/**
+* 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 { isAIMessageChunk } 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 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\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        type: \"message-start\" as const,\n        id: msg.id ?? undefined,\n      };\n      if (isAIMessageChunk(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            type: \"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          type: \"content-block-delta\" as const,\n          index: blockIndex,\n          content: { type: \"text\" 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            type: \"content-block-start\" as const,\n            index: blockIndex,\n            content: { ...part },\n          };\n        } else {\n          const block = activeBlocks.get(blockIndex)!;\n          block.accumulated = applyDeltaToBlock(block.accumulated, part);\n          yield {\n            type: \"content-block-delta\" as const,\n            index: blockIndex,\n            content: part,\n          };\n        }\n      }\n    }\n\n    // Tool call chunks\n    if (\n      isAIMessageChunk(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            type: \"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          type: \"content-block-delta\" as const,\n          index: blockIndex,\n          content: { ...(block.accumulated as ContentBlock) },\n        };\n      }\n    }\n\n    // Usage\n    if (!usageHandledInStart && isAIMessageChunk(msg) && msg.usage_metadata) {\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  // Finish all 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  yield {\n    type: \"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: ContentBlock\n): ContentBlock {\n  if (block.type !== delta.type) {\n    return { ...delta };\n  }\n\n  switch (delta.type) {\n    case \"text\":\n      return {\n        ...block,\n        ...delta,\n        text: ((block as { text?: string }).text ?? \"\") + delta.text,\n      };\n    case \"reasoning\":\n      return {\n        ...block,\n        ...delta,\n        reasoning:\n          ((block as { reasoning?: string }).reasoning ?? \"\") + delta.reasoning,\n      };\n    case \"tool_call_chunk\":\n    case \"server_tool_call_chunk\": {\n      const merged = { ...block, ...delta } as Record<string, unknown>;\n      if (delta.id == null && \"id\" in block && block.id != null) {\n        merged.id = block.id;\n      }\n      if (delta.name == null && \"name\" in block && block.name != null) {\n        merged.name = block.name;\n      }\n      merged.args = `${(\"args\" in block ? block.args : \"\") ?? \"\"}${delta.args ?? \"\"}`;\n      return merged as unknown as ContentBlock;\n    }\n    default:\n      return { ...block, ...delta };\n  }\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 as incremental content updates during streaming.\n *\n * ## Design Principles\n *\n * 1. **Content-block deltas use the content block shape.** Text, reasoning,\n *    and tool-call chunks are emitted as partial {@link ContentBlock} values\n *    with explicit append semantics.\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, content={ type: \"text\", text: \"Hello\" })\n *   -> ContentBlockDelta(index=0, content={ type: \"text\", 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  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// ─── Content Block Lifecycle ────────────────────────────────────\n\n/**\n * Emitted when a new content block begins streaming.\n *\n * @example\n * ```ts\n * { type: \"content-block-start\", index: 0,\n *   content: { type: \"text\", text: \"\" } }\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 * The `content` field carries the incremental content block update.\n * Accumulation rules:\n * - `text` → append `text` to the block's text field\n * - `reasoning` → append `reasoning` to the block's reasoning field\n * - `tool_call_chunk` / `server_tool_call_chunk` → append `args`,\n *   preserving stable `id`/`name` when later chunks omit them\n * - all other fields are shallow-merged\n *\n * @example\n * ```ts\n * // Text token\n * { type: \"content-block-delta\", index: 0,\n *   content: { type: \"text\", text: \" world\" } }\n *\n * // Tool call args chunk\n * { type: \"content-block-delta\", index: 1,\n *   content: { type: \"tool_call_chunk\", args: '{\"q\":\"wea' } }\n *\n * // Provider-specific field (e.g., signature)\n * { type: \"content-block-delta\", index: 0,\n *   content: { type: \"reasoning\", signature: \"sig_abc\" } }\n * ```\n */\nexport interface ContentBlockDeltaEvent {\n  type: \"content-block-delta\";\n  /** Positional index of the block being updated. */\n  index: number;\n  /** Incremental content block update. */\n  content: ContentBlock;\n}\n\n/**\n * Emitted when a content block is complete.\n *\n * @example\n * ```ts\n * { type: \"content-block-finish\", index: 0,\n *   content: { type: \"text\", text: \"Hello world\" } }\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// ─── 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  type: \"usage\";\n  /** Current usage snapshot. */\n  usage: 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  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// ─── Error ──────────────────────────────────────────────────────\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// ─── 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,141 @@
+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 {
+  type: "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?: 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 {
+  type: "message-finish";
+  /** Why the model stopped generating. */
+  reason?: FinishReason;
+  /** Final usage snapshot. */
+  usage?: 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
+ * { type: "content-block-start", index: 0,
+ *   content: { type: "text", text: "" } }
+ * ```
+ */
+interface ContentBlockStartEvent {
+  type: "content-block-start";
+  /** Positional index of this block within the message. */
+  index: number;
+  /** Initial state of the content block. */
+  content: ContentBlock;
+}
+/**
+ * Emitted for each incremental update within a content block.
+ *
+ * The `content` field carries the incremental content block update.
+ * Accumulation rules:
+ * - `text` → append `text` to the block's text field
+ * - `reasoning` → append `reasoning` to the block's reasoning field
+ * - `tool_call_chunk` / `server_tool_call_chunk` → append `args`,
+ *   preserving stable `id`/`name` when later chunks omit them
+ * - all other fields are shallow-merged
+ *
+ * @example
+ * ```ts
+ * // Text token
+ * { type: "content-block-delta", index: 0,
+ *   content: { type: "text", text: " world" } }
+ *
+ * // Tool call args chunk
+ * { type: "content-block-delta", index: 1,
+ *   content: { type: "tool_call_chunk", args: '{"q":"wea' } }
+ *
+ * // Provider-specific field (e.g., signature)
+ * { type: "content-block-delta", index: 0,
+ *   content: { type: "reasoning", signature: "sig_abc" } }
+ * ```
+ */
+interface ContentBlockDeltaEvent {
+  type: "content-block-delta";
+  /** Positional index of the block being updated. */
+  index: number;
+  /** Incremental content block update. */
+  content: ContentBlock;
+}
+/**
+ * Emitted when a content block is complete.
+ *
+ * @example
+ * ```ts
+ * { type: "content-block-finish", index: 0,
+ *   content: { type: "text", text: "Hello world" } }
+ * ```
+ */
+interface ContentBlockFinishEvent {
+  type: "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 {
+  type: "usage";
+  /** Current usage snapshot. */
+  usage: UsageMetadata;
+}
+/**
+ * Passthrough for native provider events that don't map to standard types.
+ */
+interface ProviderEvent {
+  type: "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 {
+  type: "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 { ChatModelStreamEvent, ContentBlockDeltaEvent, ContentBlockFinishEvent, ContentBlockStartEvent, FinishReason, MessageFinishEvent, MessageStartEvent, ProviderEvent, StreamErrorEvent, 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":";;;;;;;UA8CiB,iBAAA;EACf,IAAA;EAiDqB;EA/CrB,EAAA;EA4Ee;;;;EAvEf,KAAA,GAAQ,aAAA;AAAA;;;;;AAwFV;;;;KA7EY,YAAA;;;;UAKK,kBAAA;EACf,IAAA;EAqFe;EAnFf,MAAA,GAAS,YAAA;;EAET,KAAA,GAAQ,aAAA;EAkFR;EAhFA,gBAAA,GAAmB,MAAA;AAAA;;;AA0FrB;;;;;;;UA5EiB,sBAAA;EACf,IAAA;EAkFO;EAhFP,KAAA;EAwF+B;EAtF/B,OAAA,EAAS,YAAA;AAAA;;;;;;AAmGX;;;;;;;;;;;;;;;;;;;;;UAtEiB,sBAAA;EACf,IAAA;;EAEA,KAAA;;EAEA,OAAA,EAAS,YAAA;AAAA;;;;;;;;;;UAYM,uBAAA;EACf,IAAA;;EAEA,KAAA;;EAEA,OAAA,EAAS,YAAA;AAAA;;;;;UASM,gBAAA;EACf,IAAA;;EAEA,KAAA,EAAO,aAAA;AAAA;;;;UAQQ,aAAA;EACf,IAAA;;EAEA,QAAA;;EAEA,IAAA;;EAEA,OAAA;AAAA;;;;UAQe,gBAAA;EACf,IAAA;;EAEA,OAAA;;EAEA,IAAA;AAAA;;;;KAQU,oBAAA,GACR,iBAAA,GACA,kBAAA,GACA,sBAAA,GACA,sBAAA,GACA,uBAAA,GACA,gBAAA,GACA,aAAA,GACA,gBAAA"}

package/dist/language_models/event.d.ts

@@ -0,0 +1,141 @@
+import { ContentBlock } from "../messages/content/index.js";
+import { UsageMetadata } from "../messages/metadata.js";
+
+//#region src/language_models/event.d.ts
+/**
+ * Emitted once at the start of a model response.
+ */
+interface MessageStartEvent {
+  type: "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?: 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 {
+  type: "message-finish";
+  /** Why the model stopped generating. */
+  reason?: FinishReason;
+  /** Final usage snapshot. */
+  usage?: 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
+ * { type: "content-block-start", index: 0,
+ *   content: { type: "text", text: "" } }
+ * ```
+ */
+interface ContentBlockStartEvent {
+  type: "content-block-start";
+  /** Positional index of this block within the message. */
+  index: number;
+  /** Initial state of the content block. */
+  content: ContentBlock;
+}
+/**
+ * Emitted for each incremental update within a content block.
+ *
+ * The `content` field carries the incremental content block update.
+ * Accumulation rules:
+ * - `text` → append `text` to the block's text field
+ * - `reasoning` → append `reasoning` to the block's reasoning field
+ * - `tool_call_chunk` / `server_tool_call_chunk` → append `args`,
+ *   preserving stable `id`/`name` when later chunks omit them
+ * - all other fields are shallow-merged
+ *
+ * @example
+ * ```ts
+ * // Text token
+ * { type: "content-block-delta", index: 0,
+ *   content: { type: "text", text: " world" } }
+ *
+ * // Tool call args chunk
+ * { type: "content-block-delta", index: 1,
+ *   content: { type: "tool_call_chunk", args: '{"q":"wea' } }
+ *
+ * // Provider-specific field (e.g., signature)
+ * { type: "content-block-delta", index: 0,
+ *   content: { type: "reasoning", signature: "sig_abc" } }
+ * ```
+ */
+interface ContentBlockDeltaEvent {
+  type: "content-block-delta";
+  /** Positional index of the block being updated. */
+  index: number;
+  /** Incremental content block update. */
+  content: ContentBlock;
+}
+/**
+ * Emitted when a content block is complete.
+ *
+ * @example
+ * ```ts
+ * { type: "content-block-finish", index: 0,
+ *   content: { type: "text", text: "Hello world" } }
+ * ```
+ */
+interface ContentBlockFinishEvent {
+  type: "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 {
+  type: "usage";
+  /** Current usage snapshot. */
+  usage: UsageMetadata;
+}
+/**
+ * Passthrough for native provider events that don't map to standard types.
+ */
+interface ProviderEvent {
+  type: "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 {
+  type: "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 { ChatModelStreamEvent, ContentBlockDeltaEvent, ContentBlockFinishEvent, ContentBlockStartEvent, FinishReason, MessageFinishEvent, MessageStartEvent, ProviderEvent, StreamErrorEvent, UsageUpdateEvent };
+//# sourceMappingURL=event.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","names":[],"sources":["../../src/language_models/event.ts"],"mappings":";;;;;;;UA8CiB,iBAAA;EACf,IAAA;EAiDqB;EA/CrB,EAAA;EA4Ee;;;;EAvEf,KAAA,GAAQ,aAAA;AAAA;;;;;AAwFV;;;;KA7EY,YAAA;;;;UAKK,kBAAA;EACf,IAAA;EAqFe;EAnFf,MAAA,GAAS,YAAA;;EAET,KAAA,GAAQ,aAAA;EAkFR;EAhFA,gBAAA,GAAmB,MAAA;AAAA;;;AA0FrB;;;;;;;UA5EiB,sBAAA;EACf,IAAA;EAkFO;EAhFP,KAAA;EAwF+B;EAtF/B,OAAA,EAAS,YAAA;AAAA;;;;;;AAmGX;;;;;;;;;;;;;;;;;;;;;UAtEiB,sBAAA;EACf,IAAA;;EAEA,KAAA;;EAEA,OAAA,EAAS,YAAA;AAAA;;;;;;;;;;UAYM,uBAAA;EACf,IAAA;;EAEA,KAAA;;EAEA,OAAA,EAAS,YAAA;AAAA;;;;;UASM,gBAAA;EACf,IAAA;;EAEA,KAAA,EAAO,aAAA;AAAA;;;;UAQQ,aAAA;EACf,IAAA;;EAEA,QAAA;;EAEA,IAAA;;EAEA,OAAA;AAAA;;;;UAQe,gBAAA;EACf,IAAA;;EAEA,OAAA;;EAEA,IAAA;AAAA;;;;KAQU,oBAAA,GACR,iBAAA,GACA,kBAAA,GACA,sBAAA,GACA,sBAAA,GACA,uBAAA,GACA,gBAAA,GACA,aAAA,GACA,gBAAA"}

package/dist/language_models/event.js

@@ -0,0 +1,7 @@
+import { __exportAll } from "../_virtual/_rolldown/runtime.js";
+//#region src/language_models/event.ts
+var event_exports = /* @__PURE__ */ __exportAll({});
+//#endregion
+export { event_exports };
+
+//# sourceMappingURL=event.js.map

package/dist/language_models/event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","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 as incremental content updates during streaming.\n *\n * ## Design Principles\n *\n * 1. **Content-block deltas use the content block shape.** Text, reasoning,\n *    and tool-call chunks are emitted as partial {@link ContentBlock} values\n *    with explicit append semantics.\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, content={ type: \"text\", text: \"Hello\" })\n *   -> ContentBlockDelta(index=0, content={ type: \"text\", 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  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// ─── Content Block Lifecycle ────────────────────────────────────\n\n/**\n * Emitted when a new content block begins streaming.\n *\n * @example\n * ```ts\n * { type: \"content-block-start\", index: 0,\n *   content: { type: \"text\", text: \"\" } }\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 * The `content` field carries the incremental content block update.\n * Accumulation rules:\n * - `text` → append `text` to the block's text field\n * - `reasoning` → append `reasoning` to the block's reasoning field\n * - `tool_call_chunk` / `server_tool_call_chunk` → append `args`,\n *   preserving stable `id`/`name` when later chunks omit them\n * - all other fields are shallow-merged\n *\n * @example\n * ```ts\n * // Text token\n * { type: \"content-block-delta\", index: 0,\n *   content: { type: \"text\", text: \" world\" } }\n *\n * // Tool call args chunk\n * { type: \"content-block-delta\", index: 1,\n *   content: { type: \"tool_call_chunk\", args: '{\"q\":\"wea' } }\n *\n * // Provider-specific field (e.g., signature)\n * { type: \"content-block-delta\", index: 0,\n *   content: { type: \"reasoning\", signature: \"sig_abc\" } }\n * ```\n */\nexport interface ContentBlockDeltaEvent {\n  type: \"content-block-delta\";\n  /** Positional index of the block being updated. */\n  index: number;\n  /** Incremental content block update. */\n  content: ContentBlock;\n}\n\n/**\n * Emitted when a content block is complete.\n *\n * @example\n * ```ts\n * { type: \"content-block-finish\", index: 0,\n *   content: { type: \"text\", text: \"Hello world\" } }\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// ─── 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  type: \"usage\";\n  /** Current usage snapshot. */\n  usage: 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  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// ─── Error ──────────────────────────────────────────────────────\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// ─── 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":""}