@langchain/core 1.1.42 → 1.1.43

package/dist/language_models/event.d.cts

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

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

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

package/dist/language_models/event.d.ts

@@ -0,0 +1,185 @@
+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 {
+  event: "message-start";
+  /** Optional message ID assigned by the provider. */
+  id?: string;
+  /**
+   * Initial usage snapshot, if the provider reports input token counts
+   * before content begins streaming (e.g., Anthropic's `message_start`).
+   */
+  usage?: Partial<UsageMetadata>;
+}
+/**
+ * Finish reason for a model response.
+ *
+ * - `"stop"`: Natural end of generation.
+ * - `"length"`: Hit max token limit.
+ * - `"tool_use"`: Model is requesting tool execution.
+ * - `"content_filter"`: Content was filtered by safety systems.
+ */
+type FinishReason = "stop" | "length" | "tool_use" | "content_filter";
+/**
+ * Emitted once when the model response is complete.
+ */
+interface MessageFinishEvent {
+  event: "message-finish";
+  /** Why the model stopped generating. */
+  reason?: FinishReason;
+  /** Final usage snapshot. */
+  usage?: Partial<UsageMetadata>;
+  /** Provider-specific response metadata (model name, response ID, headers, etc.). */
+  responseMetadata?: Record<string, unknown>;
+}
+/**
+ * Emitted when a new content block begins streaming.
+ *
+ * @example
+ * ```ts
+ * { event: "content-block-start", index: 0,
+ *   content: { type: "text", text: "" } }
+ * ```
+ */
+interface ContentBlockStartEvent {
+  event: "content-block-start";
+  /** Positional index of this block within the message. */
+  index: number;
+  /** Initial state of the content block. */
+  content: ContentBlock;
+}
+/**
+ * Incremental text content. Append `text` to the active block's `text` field.
+ */
+interface TextDelta {
+  type: "text-delta";
+  /** The new text to append. */
+  text: string;
+}
+/**
+ * Incremental reasoning content. Append `reasoning` to the active block's
+ * `reasoning` field.
+ */
+interface ReasoningDelta {
+  type: "reasoning-delta";
+  /** The new reasoning text to append. */
+  reasoning: string;
+}
+/**
+ * Incremental encoded data. Append `data` to the active multimodal block's
+ * data field.
+ */
+interface DataDelta {
+  type: "data-delta";
+  /** Encoded data chunk to append. */
+  data: string;
+  /** Encoding for the data chunk. Defaults to `"base64"` when omitted. */
+  encoding?: "base64";
+}
+/**
+ * Generic content block field update. Shallow-merge `fields` onto the active
+ * content block.
+ */
+interface BlockDelta {
+  type: "block-delta";
+  /** Fields to shallow-merge onto the active content block. */
+  fields: {
+    type: string;
+  } & Record<string, unknown>;
+}
+/**
+ * Union of all content block delta types.
+ */
+type ContentBlockDelta = TextDelta | ReasoningDelta | DataDelta | BlockDelta;
+/**
+ * Emitted for each incremental update within a content block.
+ *
+ * The `delta` field carries the incremental content block update.
+ * Accumulation rules:
+ * - `text-delta` → append `text` to the active block's text field
+ * - `reasoning-delta` → append `reasoning` to the active block's reasoning field
+ * - `data-delta` → append `data` to the active block's data field
+ * - `block-delta` → shallow-merge `fields` onto the active block
+ *
+ * @example
+ * ```ts
+ * // Text token
+ * { event: "content-block-delta", index: 0,
+ *   delta: { type: "text-delta", text: " world" } }
+ *
+ * // Tool call args snapshot
+ * { event: "content-block-delta", index: 1,
+ *   delta: { type: "block-delta",
+ *     fields: { type: "tool_call_chunk", args: '{"q":"wea' } } } }
+ *
+ * // Provider-specific field (e.g., signature)
+ * { event: "content-block-delta", index: 0,
+ *   delta: { type: "block-delta",
+ *     fields: { type: "reasoning", signature: "sig_abc" } } }
+ * ```
+ */
+interface ContentBlockDeltaEvent {
+  event: "content-block-delta";
+  /** Positional index of the block being updated. */
+  index: number;
+  /** Incremental content block delta. */
+  delta: ContentBlockDelta;
+}
+/**
+ * Emitted when a content block is complete.
+ *
+ * @example
+ * ```ts
+ * { event: "content-block-finish", index: 0,
+ *   content: { type: "text", text: "Hello world" } }
+ * ```
+ */
+interface ContentBlockFinishEvent {
+  event: "content-block-finish";
+  /** Positional index of the completed block. */
+  index: number;
+  /** Finalized content block. */
+  content: ContentBlock;
+}
+/**
+ * Emitted whenever the provider reports updated usage information.
+ * Each event carries a **running snapshot** (not an additive delta).
+ */
+interface UsageUpdateEvent {
+  event: "usage";
+  /** Current usage snapshot. */
+  usage: Partial<UsageMetadata>;
+}
+/**
+ * Passthrough for native provider events that don't map to standard types.
+ */
+interface ProviderEvent {
+  event: "provider";
+  /** Provider identifier (e.g., `"openai"`, `"anthropic"`, `"google"`). */
+  provider: string;
+  /** Raw event type name from the provider SDK. */
+  name: string;
+  /** Raw event payload from the provider SDK. */
+  payload: unknown;
+}
+/**
+ * Emitted on unrecoverable stream errors.
+ */
+interface StreamErrorEvent {
+  event: "error";
+  /** Human-readable error message. */
+  message: string;
+  /** Optional error code for programmatic handling. */
+  code?: string;
+}
+/**
+ * Union of all chat model stream event types.
+ */
+type ChatModelStreamEvent = MessageStartEvent | MessageFinishEvent | ContentBlockStartEvent | ContentBlockDeltaEvent | ContentBlockFinishEvent | UsageUpdateEvent | ProviderEvent | StreamErrorEvent;
+//#endregion
+export { BlockDelta, ChatModelStreamEvent, ContentBlockDelta, ContentBlockDeltaEvent, ContentBlockFinishEvent, ContentBlockStartEvent, DataDelta, FinishReason, MessageFinishEvent, MessageStartEvent, ProviderEvent, ReasoningDelta, StreamErrorEvent, TextDelta, UsageUpdateEvent };
+//# sourceMappingURL=event.d.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":";;;;AA4FA;;;AAAA,UA9CiB,iBAAA;EACf,KAAA;EAgDA;EA9CA,EAAA;EAgDS;;;AAQX;EAnDE,KAAA,GAAQ,OAAA,CAAQ,aAAA;AAAA;;;AA6DlB;;;;;AAUA;KA5DY,YAAA;;;;UAKK,kBAAA;EACf,KAAA;EA2DQ;EAzDR,MAAA,GAAS,YAAA;EAgEM;EA9Df,KAAA,GAAQ,OAAA,CAAQ,aAAA;;EAEhB,gBAAA,GAAmB,MAAA;AAAA;;;;;;AAqErB;;;;UAtDiB,sBAAA;EACf,KAAA;EAyDE;EAvDF,KAAA;EAuDY;EArDZ,OAAA,EAAS,YAAA;AAAA;;;;UAQM,SAAA;EACf,IAAA;EAyEqC;EAvErC,IAAA;AAAA;;;;;UAOe,cAAA;EACf,IAAA;EAgFe;EA9Ef,SAAA;AAAA;;;;;UAOe,SAAA;EACf,IAAA;EA2EqB;EAzErB,IAAA;EAkF+B;EAhF/B,QAAA;AAAA;;;;;UAOe,UAAA;EACf,IAAA;EAmFe;EAjFf,MAAA;IAAU,IAAA;EAAA,IAAiB,MAAA;AAAA;;;;KAMjB,iBAAA,GACR,SAAA,GACA,cAAA,GACA,SAAA,GACA,UAAA;;AAsFJ;;;;;;;;;AAaA;;;;;;;;;;;;;;;;;UAtEiB,sBAAA;EACf,KAAA;EA4EE;EA1EF,KAAA;EA2EkB;EAzElB,KAAA,EAAO,iBAAA;AAAA;;;;;;;;;;UAYQ,uBAAA;EACf,KAAA;;EAEA,KAAA;;EAEA,OAAA,EAAS,YAAA;AAAA;;;;;UASM,gBAAA;EACf,KAAA;;EAEA,KAAA,EAAO,OAAA,CAAQ,aAAA;AAAA;;;;UAQA,aAAA;EACf,KAAA;;EAEA,QAAA;;EAEA,IAAA;;EAEA,OAAA;AAAA;;;;UAQe,gBAAA;EACf,KAAA;;EAEA,OAAA;;EAEA,IAAA;AAAA;;;;KAQU,oBAAA,GACR,iBAAA,GACA,kBAAA,GACA,sBAAA,GACA,sBAAA,GACA,uBAAA,GACA,gBAAA,GACA,aAAA,GACA,gBAAA"}

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 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":""}