@codehz/ai 0.9.0 → 0.9.1

package/dist/index.d.mts

@@ -5,9 +5,11 @@
  * KnownAdapterKind 覆盖内置 adapter；
  * AdapterKind 额外接受任意 string，便于自定义 backend 扩展（无需改库联合类型）。
  */
-declare const KNOWN_ADAPTER_KINDS: readonly ["chat-completions", "messages", "responses", "ollama", "gemini", "mock"];
+/** 内置 adapter kind 列表。 */
+declare const KNOWN_ADAPTER_KINDS: readonly ["chat-completions", "delta-completions", "messages", "responses", "ollama", "gemini", "mock"];
+/** 内置 adapter kind 的字面量联合。 */
 type KnownAdapterKind = (typeof KNOWN_ADAPTER_KINDS)[number];
-/** 内置 kind 自动补全 + 自定义 string 扩展 */
+/** 内置 kind 自动补全 + 自定义 string 扩展。 */
 type AdapterKind = KnownAdapterKind | (string & {});
 //#endregion
 //#region src/types/content.d.ts
@@ -16,15 +18,21 @@ type AdapterKind = KnownAdapterKind | (string & {});
  *
  * 覆盖文本、JSON、图片、二进制引用和后端私有内容。
  */
+/** 文本内容块；用于 instructions、消息内容和流增量。 */
 type TextContentBlock = {
   type: "text";
   text: string;
 };
+/** JSON 内容块；`json` 保留调用方提供的任意 JSON 兼容值。 */
 type JsonContentBlock = {
   type: "json";
   json: unknown;
 };
+/** 可作为请求 instructions 的内容块联合。 */
 type InstructionBlock = TextContentBlock | JsonContentBlock;
+/**
+ * 统一内容块：文本、JSON、图片、二进制引用或 provider 专有 opaque 数据。
+ */
 type ContentBlock = InstructionBlock | {
   type: "image";
   imageUrl: string;
@@ -37,6 +45,7 @@ type ContentBlock = InstructionBlock | {
 };
 //#endregion
 //#region src/types/items.d.ts
+/** URL 网页引用及其在原文中的可选位置。 */
 type UrlCitation = {
   type: "url";
   url: string;
@@ -44,6 +53,7 @@ type UrlCitation = {
   startIndex?: number;
   endIndex?: number;
 };
+/** Provider 容器文件引用及其可选文件名和位置。 */
 type ContainerFileCitation = {
   type: "container_file";
   containerId: string;
@@ -52,7 +62,9 @@ type ContainerFileCitation = {
   startIndex?: number;
   endIndex?: number;
 };
+/** 统一引用联合。 */
 type Citation = UrlCitation | ContainerFileCitation;
+/** 文本或多模态消息 item。 */
 type MessageItem = {
   type: "message";
   id?: string;
@@ -60,18 +72,21 @@ type MessageItem = {
   content: ContentBlock[];
   citations?: Citation[];
 };
+/** 模型 reasoning/thinking 内容及其可见性。 */
 type ReasoningItem = {
   type: "reasoning";
   id?: string;
   visibility: "full" | "summary" | "redacted" | "opaque";
   content: ContentBlock[];
 };
+/** 模型请求客户端工具调用。 */
 type ToolCallItem = {
   type: "tool_call";
   id: string;
   name: string;
   argumentsText: string;
 };
+/** 客户端工具调用结果。 */
 type ToolResultItem = {
   type: "tool_result";
   callId: string;
@@ -79,6 +94,7 @@ type ToolResultItem = {
   outcome: "success" | "error" | "rejected";
   content: ContentBlock[];
 };
+/** Provider 专有状态或 wire replay 数据。 */
 type OpaqueItem = {
   type: "opaque";
   id?: string;
@@ -86,7 +102,7 @@ type OpaqueItem = {
   purpose: "replay" | "provider_state" | "unknown";
   payload: unknown;
 };
-/** Provider 托管工具调用（调用方不执行） */
+/** Provider 托管工具调用（调用方不执行）。 */
 type ServerToolCallItem = {
   type: "server_tool_call";
   id: string;
@@ -97,7 +113,7 @@ type ServerToolCallItem = {
   serverLabel?: string;
   providerPayload?: unknown;
 };
-/** Provider 托管工具结果 */
+/** Provider 托管工具结果。 */
 type ServerToolResultItem = {
   type: "server_tool_result";
   id?: string;
@@ -107,7 +123,7 @@ type ServerToolResultItem = {
   content: ContentBlock[];
   providerPayload?: unknown;
 };
-/** MCP 等远端工具发现列表 */
+/** MCP 等远端工具发现列表。 */
 type ServerToolDiscoveryItem = {
   type: "server_tool_discovery";
   id: string;
@@ -120,21 +136,24 @@ type ServerToolDiscoveryItem = {
   }>;
   providerPayload?: unknown;
 };
-/** 可出现在请求 input 中的 item 类型 */
+/** 可出现在请求 input 中的 item 类型。 */
 type InputItem = MessageItem | ReasoningItem | ToolCallItem | ToolResultItem | OpaqueItem | ServerToolCallItem | ServerToolResultItem | ServerToolDiscoveryItem;
-/** 可出现在响应 output 中的 item 类型（不含客户端 ToolResultItem） */
+/** 可出现在响应 output 中的 item 类型（不含客户端 ToolResultItem）。 */
 type OutputItem = MessageItem | ReasoningItem | ToolCallItem | OpaqueItem | ServerToolCallItem | ServerToolResultItem | ServerToolDiscoveryItem;
-/** replay 材料的类型等价于 InputItem */
+/** replay 材料的类型等价于 InputItem。 */
 type ReplayItem = InputItem;
 //#endregion
 //#region src/types/cache.d.ts
 /** Request-level portable prompt cache controls and provider extensions. */
+/** Prompt cache 的跨 provider 策略。 */
 type PromptCacheMode = "off" | "auto" | "explicit";
+/** 请求级 prompt cache 控制和路由提示。 */
 type PromptCacheSettings = {
   /** Cache strategy; when omitted, the adapter/provider decides. */mode?: PromptCacheMode; /** Session or tenant routing hint; providers may ignore it. */
   key?: string; /** Provider-specific retention hint. */
   ttl?: "short" | "long" | string;
 };
+/** Provider-specific prompt cache extensions. */
 type ProviderCacheOptions = {
   responses?: {
     promptCacheKey?: string;
@@ -156,6 +175,7 @@ type ProviderCacheOptions = {
     keepAlive?: string | number;
   };
 };
+/** Response metadata describing the effective cache behavior. */
 type PromptCacheMetadata = {
   requestedMode: PromptCacheMode;
   appliedMode: "off" | "implicit" | "explicit" | "unsupported";
@@ -164,15 +184,18 @@ type PromptCacheMetadata = {
 };
 //#endregion
 //#region src/types/request.d.ts
+/** 客户端工具声明；`inputSchema` 使用 JSON Schema 对象。 */
 type ToolDefinition = {
   name: string;
   description?: string;
   inputSchema: Record<string, unknown>;
 };
+/** 客户端工具选择策略。 */
 type ToolChoice = "auto" | "none" | {
   type: "tool";
   name: string;
 };
+/** Web 搜索的近似用户位置。 */
 type WebSearchUserLocation = {
   type: "approximate";
   country?: string;
@@ -180,6 +203,7 @@ type WebSearchUserLocation = {
   region?: string;
   timezone?: string;
 };
+/** Provider 托管的 Web 搜索工具配置。 */
 type WebSearchServerTool = {
   type: "web_search";
   allowedDomains?: string[];
@@ -187,6 +211,7 @@ type WebSearchServerTool = {
   userLocation?: WebSearchUserLocation;
   searchContextSize?: "low" | "medium" | "high";
 };
+/** Provider 托管的代码执行工具配置。 */
 type CodeExecutionServerTool = {
   type: "code_execution";
   container?: {
@@ -195,28 +220,31 @@ type CodeExecutionServerTool = {
     fileIds?: string[];
   };
 };
+/** MCP 远端工具服务配置。authorization 仅用于当前请求。 */
 type McpServerTool = {
   type: "mcp";
   serverLabel: string;
   serverUrl: string;
   serverDescription?: string; /** 每请求由调用方提供；不得写入日志或 opaque 回放。 */
   authorization?: string;
-  allowedTools?: string[]; /** 首版仅支持 never */
+  allowedTools?: string[]; /** 首版仅支持 never。 */
   requireApproval: "never";
 };
-/** Provider 托管执行的工具声明（不进客户端 tool loop） */
+/** Provider 托管执行的工具声明（不进客户端 tool loop）。 */
 type ServerToolDefinition = WebSearchServerTool | CodeExecutionServerTool | McpServerTool;
+/** 控制 usage、billing 和 provider metadata 的返回策略。 */
 type IncludeSettings = {
   usage?: "off" | "best_effort" | "required";
   billing?: "off" | "best_effort" | "required";
   providerMetadata?: "off" | "best_effort";
 };
-/** Portable reasoning / thinking effort. Mapped per-adapter to provider wire fields. */
+/** Portable reasoning/thinking effort；由各 adapter 映射到 provider 字段。 */
 type ReasoningLevel = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 /** 可移植 reasoning level 枚举（单源；validation / provider 共用）。 */
 declare const REASONING_LEVELS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
 /** 用于校验任意字符串 membership；值域与 REASONING_LEVELS 一致。 */
 declare const REASONING_LEVEL_SET: ReadonlySet<string>;
+/** 统一 AI 请求；`input` 为当前请求携带的规范化历史和用户输入。 */
 type AIRequest = {
   instructions?: string | InstructionBlock[];
   input: InputItem[];
@@ -247,6 +275,7 @@ type AIRequest = {
  *
  * runtime.errors 与 events 均从此导出，避免手工双表漂移。
  */
+/** 标准 warning 代码常量；事件和响应均可携带这些代码。 */
 declare const WarningCode: {
   /** replay fidelity 低于预期 */readonly REPLAY_FIDELITY_LOW: "REPLAY_FIDELITY_LOW"; /** usage 字段缺失 */
   readonly USAGE_MISSING: "USAGE_MISSING"; /** billing 字段缺失 */
@@ -335,6 +364,7 @@ type AIResponse = {
 };
 //#endregion
 //#region src/types/events.d.ts
+/** 所有流事件共享的顺序、时间和后端信息。 */
 type StreamEventBase = {
   type: string;
   responseId?: string;
@@ -345,21 +375,25 @@ type StreamEventBase = {
     isSynthetic: boolean;
   };
 };
+/** 响应开始事件。 */
 type ResponseStartedEvent = StreamEventBase & {
   type: "response.started";
   model: string;
 };
+/** 非致命响应 warning 事件。 */
 type ResponseWarningEvent = StreamEventBase & {
   type: "response.warning";
   message: string;
   code?: WarningCodeValue;
 };
+/** 流中的 usage、billing 或 provider 辅助信息事件。 */
 type ResponseAuxiliaryEvent = StreamEventBase & {
   type: "response.auxiliary";
   usage?: Usage;
   billing?: BillingInfo;
   auxiliary?: Partial<AuxiliaryInfo>;
 };
+/** 响应完成事件；包含 replay 和完成元数据。 */
 type ResponseCompletedEvent = StreamEventBase & {
   type: "response.completed";
   replay: ReplayItem[];
@@ -371,6 +405,7 @@ type ResponseCompletedEvent = StreamEventBase & {
   opaqueOutput?: OpaqueItem[];
   trace?: Partial<BackendTrace>;
 };
+/** 消息 item 开始事件。 */
 type MessageStartedEvent = StreamEventBase & {
   type: "message.started";
   item: {
@@ -378,16 +413,19 @@ type MessageStartedEvent = StreamEventBase & {
     role: "assistant";
   };
 };
+/** 消息内容增量事件。 */
 type MessageDeltaEvent = StreamEventBase & {
   type: "message.delta";
   itemId: string;
   delta: ContentBlock;
 };
+/** 消息 item 完成事件。 */
 type MessageCompletedEvent = StreamEventBase & {
   type: "message.completed";
   itemId: string;
   citations?: Citation[];
 };
+/** reasoning item 开始事件。 */
 type ReasoningStartedEvent = StreamEventBase & {
   type: "reasoning.started";
   item: {
@@ -395,15 +433,18 @@ type ReasoningStartedEvent = StreamEventBase & {
     visibility: "full" | "summary" | "redacted" | "opaque";
   };
 };
+/** reasoning 内容增量事件。 */
 type ReasoningDeltaEvent = StreamEventBase & {
   type: "reasoning.delta";
   itemId: string;
   delta: ContentBlock;
 };
+/** reasoning item 完成事件。 */
 type ReasoningCompletedEvent = StreamEventBase & {
   type: "reasoning.completed";
   itemId: string;
 };
+/** 客户端工具调用开始事件。 */
 type ToolCallStartedEvent = StreamEventBase & {
   type: "tool_call.started";
   item: {
@@ -411,6 +452,7 @@ type ToolCallStartedEvent = StreamEventBase & {
     name: string;
   };
 };
+/** 客户端工具调用参数增量事件。 */
 type ToolCallDeltaEvent = StreamEventBase & {
   type: "tool_call.delta";
   itemId: string;
@@ -418,10 +460,12 @@ type ToolCallDeltaEvent = StreamEventBase & {
     argumentsText?: string;
   };
 };
+/** 客户端工具调用完成事件。 */
 type ToolCallCompletedEvent = StreamEventBase & {
   type: "tool_call.completed";
   itemId: string;
 };
+/** Provider 托管工具调用开始事件。 */
 type ServerToolStartedEvent = StreamEventBase & {
   type: "server_tool.started";
   item: {
@@ -431,6 +475,7 @@ type ServerToolStartedEvent = StreamEventBase & {
     serverLabel?: string;
   };
 };
+/** Provider 托管工具调用参数增量事件。 */
 type ServerToolDeltaEvent = StreamEventBase & {
   type: "server_tool.delta";
   itemId: string;
@@ -438,46 +483,54 @@ type ServerToolDeltaEvent = StreamEventBase & {
     argumentsText?: string;
   };
 };
+/** Provider 托管工具调用完成事件。 */
 type ServerToolCompletedEvent = StreamEventBase & {
   type: "server_tool.completed";
   itemId: string;
   status?: "completed" | "failed";
   providerPayload?: unknown;
 };
+/** Provider 托管工具结果完成事件。 */
 type ServerToolResultCompletedEvent = StreamEventBase & {
   type: "server_tool_result.completed";
   item: ServerToolResultItem;
 };
+/** Provider 托管工具发现列表完成事件。 */
 type ServerToolDiscoveryCompletedEvent = StreamEventBase & {
   type: "server_tool_discovery.completed";
   item: ServerToolDiscoveryItem;
 };
+/** 所有规范化流事件的联合类型。 */
 type AIStreamEvent = ResponseStartedEvent | ResponseWarningEvent | ResponseAuxiliaryEvent | MessageStartedEvent | MessageDeltaEvent | MessageCompletedEvent | ReasoningStartedEvent | ReasoningDeltaEvent | ReasoningCompletedEvent | ToolCallStartedEvent | ToolCallDeltaEvent | ToolCallCompletedEvent | ServerToolStartedEvent | ServerToolDeltaEvent | ServerToolCompletedEvent | ServerToolResultCompletedEvent | ServerToolDiscoveryCompletedEvent | ResponseCompletedEvent;
 //#endregion
 //#region src/types/adapter.d.ts
-/** HTTP fetch 函数签名，用于注入自定义请求实现（测试／代理） */
+/** HTTP fetch 函数签名，用于注入自定义请求实现（测试／代理）。 */
 type FetchFn = (url: string, init: RequestInit) => Promise<Response>;
+/** 经过模型选择和默认值合并后的请求。 */
 type NormalizedRequest = AIRequest & {
   model: string;
   requestId: string;
 };
+/** AI 后端适配器必须实现的统一流式协议。 */
 interface BackendAdapter {
   readonly kind: AdapterKind;
   readonly isSyntheticStream: boolean;
   stream(request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
 }
+/** createAIClient 的配置。 */
 type CreateAIClientOptions = {
   adapter: BackendAdapter;
   model: string;
   defaults?: Partial<AIRequest>; /** 全局默认 AbortSignal，当 request.signal 未设置时生效。 */
   signal?: AbortSignal;
 };
+/** 面向调用方的统一 AI 客户端。 */
 interface AIClient {
   stream(request: AIRequest): AsyncIterable<AIStreamEvent>;
 }
 //#endregion
 //#region src/types/compress.d.ts
-/** 显式上下文压缩请求（独立于 stream） */
+/** 显式上下文压缩请求（独立于 stream）。 */
 type CompressRequest = {
   model: string;
   input: InputItem[];
@@ -485,21 +538,22 @@ type CompressRequest = {
   include?: IncludeSettings; /** AbortSignal 用于打断压缩请求。 */
   signal?: AbortSignal;
 };
-/** 压缩结果：调用方用 replay 替换旧 transcript（非 append 全文） */
+/** 压缩结果；调用方用 replay 替换旧 transcript，而不是追加全文。 */
 type CompressResult = {
   replay: ReplayItem[];
   usage?: Usage;
   auxiliary?: AuxiliaryInfo;
   rawResponseId?: string;
 };
-/** Adapter 可选能力：原生上下文压缩 */
+/** Adapter 可选的原生上下文压缩能力。 */
 interface ContextCompressCapable {
   compress(request: CompressRequest): Promise<CompressResult>;
 }
-/** 探测 adapter 是否实现 compress（不依赖 kind 硬编码）。 */
+/** 探测 adapter 是否实现上下文压缩能力。 */
 declare function supportsContextCompress(adapter: BackendAdapter): adapter is BackendAdapter & ContextCompressCapable;
 //#endregion
 //#region src/runtime/client.d.ts
+/** 创建统一 AI 客户端；请求级字段覆盖 defaults，signal 可在客户端级设置。 */
 declare function createAIClient(options: CreateAIClientOptions): AIClient;
 //#endregion
 //#region src/runtime/errors.d.ts
@@ -508,7 +562,9 @@ declare function createAIClient(options: CreateAIClientOptions): AIClient;
  * ValidationIssue.code 可更细，不强制全部列入此处；以作为 AIError.code 传入的码为主。
  */
 type KnownErrorCode = "INPUT_EMPTY" | "TEMPERATURE_OUT_OF_RANGE" | "MAX_OUTPUT_TOKENS_INVALID" | "TOOL_CHOICE_NO_TOOLS" | "TOOL_CHOICE_UNKNOWN_TOOL" | "TOOL_CALL_ARGUMENTS_INVALID" | "PROVIDER_ERROR" | "AUTH_ERROR" | "STREAM_ERROR" | "STREAM_PROTOCOL_ERROR" | "MAPPING_ERROR" | "STREAM_INCOMPLETE" | "LOOKUP_FAILED" | "LOOKUP_TIMEOUT" | "INVALID_OPAQUE_REPLAY" | "UNSUPPORTED_CONTENT_BLOCK" | "UNSUPPORTED_SERVER_TOOL" | "UNSUPPORTED_REASONING_LEVEL" | "UNSUPPORTED_COMPRESS" | "MOCK_CONCURRENT_STREAM" | "MOCK_COMPRESS_NOT_CONFIGURED" | "MOCK_EXPECTATION_FAILED" | "MOCK_STREAM_CONFIG_INVALID" | "MOCK_OPAQUE_OUTPUT" | "MOCK_MESSAGE_ID_MISSING" | "MOCK_REASONING_ID_MISSING";
+/** 错误码；内置错误码之外允许 provider 或扩展使用字符串。 */
 type ErrorCode = KnownErrorCode | (string & {});
+/** 所有运行时错误的基类。 */
 declare class AIError extends Error {
   readonly code: ErrorCode;
   readonly name: string;
@@ -571,22 +627,29 @@ declare class AIRecoverableError extends AIError {
 }
 //#endregion
 //#region src/stream/collect-stream.d.ts
+/** 消费完整个事件流并聚合为 AIResponse；适用于不需要逐事件处理的调用方。 */
 declare function collectStream(stream: AsyncIterable<AIStreamEvent>): Promise<AIResponse>;
 //#endregion
 //#region src/canonical/stop-reason.d.ts
+/** 将 provider stop/finish reason 映射为规范化 StopReason。 */
 declare function mapStopReason(providerReason: string): StopReason;
+/** 根据 thinking 和 redacted 标记推断 reasoning 可见性。 */
 declare function mapReasoningVisibility(hasThinking: boolean, hasRedacted: boolean): ReasoningItem["visibility"];
 //#endregion
 //#region src/canonical/content.d.ts
+/** 创建文本内容块。 */
 declare function textBlock(text: string): ContentBlock & {
   type: "text";
 };
+/** 创建 JSON 内容块。 */
 declare function jsonBlock(json: unknown): ContentBlock & {
   type: "json";
 };
+/** 创建图片内容块；imageUrl 可为 URL 或 data URL。 */
 declare function imageBlock(imageUrl: string): ContentBlock & {
   type: "image";
 };
+/** 创建 provider 专有 opaque 内容块。 */
 declare function opaqueBlock(payload: unknown): ContentBlock & {
   type: "opaque";
 };
@@ -606,13 +669,21 @@ declare function contentBlocksToText(blocks: ContentBlock[]): string;
 declare function coalesceContentBlocks(blocks: readonly ContentBlock[]): ContentBlock[];
 //#endregion
 //#region src/canonical/items.d.ts
+/** 创建消息 item；可用 overrides 补充 id、role 和 citations。 */
 declare function messageItem(content: ContentBlock[], overrides?: Partial<Omit<MessageItem, "type" | "content">>): MessageItem;
+/** 创建 reasoning item。 */
 declare function reasoningItem(content: ContentBlock[], visibility?: ReasoningItem["visibility"], id?: string): ReasoningItem;
+/** 创建客户端工具调用 item。 */
 declare function toolCallItem(id: string, name: string, argumentsText: string): ToolCallItem;
+/** 创建客户端工具结果 item。 */
 declare function toolResultItem(callId: string, toolName: string, outcome: ToolResultItem["outcome"], content: ContentBlock[]): ToolResultItem;
+/** 创建 opaque item，通常用于 provider replay。 */
 declare function opaqueItem(source: OpaqueItem["source"], purpose: OpaqueItem["purpose"], payload: unknown, id?: string): OpaqueItem;
+/** 创建 provider 托管工具调用 item。 */
 declare function serverToolCallItem(id: string, tool: ServerToolCallItem["tool"], overrides?: Partial<Omit<ServerToolCallItem, "type" | "id" | "tool">>): ServerToolCallItem;
+/** 创建 provider 托管工具结果 item。 */
 declare function serverToolResultItem(callId: string, tool: string, outcome: ServerToolResultItem["outcome"], content: ContentBlock[], overrides?: Partial<Omit<ServerToolResultItem, "type" | "callId" | "tool" | "outcome" | "content">>): ServerToolResultItem;
+/** 创建 MCP 等 provider 托管工具发现 item。 */
 declare function serverToolDiscoveryItem(id: string, serverLabel: string, tools: ServerToolDiscoveryItem["tools"], overrides?: Partial<Omit<ServerToolDiscoveryItem, "type" | "id" | "tool" | "serverLabel" | "tools">>): ServerToolDiscoveryItem;
 //#endregion
 //#region src/canonical/replay.d.ts
@@ -621,10 +692,12 @@ declare function serverToolDiscoveryItem(id: string, serverLabel: string, tools:
  * 简单场景下 replay 与 output 一致。
  * 复杂场景（需要 opaque continuation）由 adapter 自行扩展。
  */
+/** 从 output items 构建 replay；opaque continuation 可由 adapter 额外扩展。 */
 declare function replayFromOutput(output: readonly OutputItem[]): ReplayItem[];
 /**
  * 从 OutputItem 数组中提取所有 message 类型 item 的文本内容。
  */
+/** 从 output 中提取所有消息 item 的文本内容。 */
 declare function extractText(output: OutputItem[]): string;
 //#endregion
 //#region src/stream/event-factory.d.ts
@@ -910,6 +983,7 @@ declare abstract class HttpAdapterBase extends AdapterBase {
 type ResponsesAdapterOptions = HttpAdapterOptions & {
   apiKey: string;
 };
+/** OpenAI Responses API 的流式请求体。 */
 type ResponsesAPIRequest = {
   model: string;
   input: ResponsesInputItem[];
@@ -933,12 +1007,13 @@ type ResponsesAPIRequest = {
   };
   stream: true;
 };
-/** EasyInputMessage：content 可为 string，或 input_* content parts */
+/** Responses API 的消息输入 item。 */
 type ResponsesEasyMessage = {
   type: "message";
   role: "user" | "assistant" | "system" | "developer";
   content: string | ResponsesInputContentPart[];
 };
+/** Responses API 的输入内容 part。 */
 type ResponsesInputContentPart = {
   type: "input_text";
   text: string;
@@ -952,7 +1027,7 @@ type ResponsesInputContentPart = {
   file_id?: string;
   filename?: string;
 };
-/** function_call：call_id 必填；id 是可选的 item id */
+/** Responses API 的客户端 function call item。 */
 type ResponsesFunctionCall = {
   type: "function_call";
   call_id: string;
@@ -961,6 +1036,7 @@ type ResponsesFunctionCall = {
   id?: string;
   status?: "in_progress" | "completed" | "incomplete";
 };
+/** Responses API 的 function call 结果 item。 */
 type ResponsesFunctionCallOutput = {
   type: "function_call_output";
   call_id: string;
@@ -1003,7 +1079,9 @@ type ResponsesWirePassthroughItem = {
   type: string;
   [key: string]: unknown;
 };
+/** Responses API 可接受的输入 item 联合。 */
 type ResponsesInputItem = ResponsesEasyMessage | ResponsesFunctionCall | ResponsesFunctionCallOutput | ResponsesReasoningInput | ResponsesItemReference | ResponsesCompactionInput | ResponsesWirePassthroughItem;
+/** Responses API 的客户端 function 工具。 */
 type ResponsesFunctionTool = {
   type: "function";
   name: string;
@@ -1011,6 +1089,7 @@ type ResponsesFunctionTool = {
   parameters: Record<string, unknown>;
   strict?: boolean | null;
 };
+/** Responses API 的 Web Search 工具。 */
 type ResponsesWebSearchTool = {
   type: "web_search";
   filters?: {
@@ -1026,6 +1105,7 @@ type ResponsesWebSearchTool = {
   };
   search_context_size?: "low" | "medium" | "high";
 };
+/** Responses API 的代码解释器工具。 */
 type ResponsesCodeInterpreterTool = {
   type: "code_interpreter";
   container: string | {
@@ -1034,6 +1114,7 @@ type ResponsesCodeInterpreterTool = {
     file_ids?: string[];
   };
 };
+/** Responses API 的 MCP 工具。 */
 type ResponsesMcpTool = {
   type: "mcp";
   server_label: string;
@@ -1043,10 +1124,11 @@ type ResponsesMcpTool = {
   allowed_tools?: string[];
   require_approval: "never";
 };
-/** Responses API tools 联合：客户端 function + 内置 server tools */
+/** Responses API 的工具联合。 */
 type ResponsesTool = ResponsesFunctionTool | ResponsesWebSearchTool | ResponsesCodeInterpreterTool | ResponsesMcpTool;
 //#endregion
 //#region src/adapters/responses/adapter.d.ts
+/** OpenAI Responses API 适配器；支持原生流式响应和上下文压缩。 */
 declare class ResponsesAdapter extends HttpAdapterBase implements ContextCompressCapable {
   readonly kind: "responses";
   readonly isSyntheticStream = false;
@@ -1061,11 +1143,12 @@ declare class ResponsesAdapter extends HttpAdapterBase implements ContextCompres
 }
 //#endregion
 //#region src/adapters/messages/types.d.ts
-/** apiKey 必填；默认 baseUrl https://api.anthropic.com/v1 */
+/** Anthropic Messages adapter 配置；apiKey 必填，apiVersion 默认 2023-06-01。 */
 type MessagesAdapterOptions = HttpAdapterOptions & {
   apiKey: string; /** Anthropic API 版本头，默认 2023-06-01 */
   apiVersion?: string;
 };
+/** Anthropic Messages API 的流式请求体。 */
 type MessagesAPIRequest = {
   model: string;
   max_tokens: number;
@@ -1087,11 +1170,14 @@ type MessagesAPIRequest = {
   };
   stream: true;
 };
+/** Anthropic Messages API 消息。 */
 type MessagesAPIMessage = {
   role: "user" | "assistant";
   content: string | MessagesAPIContentBlock[];
 };
+/** Anthropic 支持的图片媒体类型。 */
 type MessagesAPIImageMediaType = "image/jpeg" | "image/png" | "image/gif" | "image/webp";
+/** Anthropic 图片内容来源。 */
 type MessagesAPIImageSource = {
   type: "base64";
   media_type: MessagesAPIImageMediaType;
@@ -1100,10 +1186,12 @@ type MessagesAPIImageSource = {
   type: "url";
   url: string;
 };
+/** Anthropic prompt cache 控制。 */
 type MessagesCacheControl = {
   type: "ephemeral";
   ttl?: "5m" | "1h";
 };
+/** Anthropic 消息内容 block。 */
 type MessagesAPIContentBlock = {
   type: "text";
   text: string;
@@ -1134,6 +1222,7 @@ type MessagesAPIContentBlock = {
   is_error?: boolean;
   cache_control?: MessagesCacheControl;
 };
+/** Anthropic 客户端工具声明。 */
 type MessagesAPITool = {
   name: string;
   description?: string;
@@ -1142,6 +1231,7 @@ type MessagesAPITool = {
 };
 //#endregion
 //#region src/adapters/messages/adapter.d.ts
+/** Anthropic Messages API 适配器。 */
 declare class MessagesAdapter extends HttpAdapterBase {
   readonly kind: "messages";
   readonly isSyntheticStream = false;
@@ -1152,10 +1242,11 @@ declare class MessagesAdapter extends HttpAdapterBase {
 }
 //#endregion
 //#region src/adapters/chat-completions/types.d.ts
-/** apiKey 必填；默认 baseUrl https://api.openai.com/v1 */
+/** OpenAI Chat Completions adapter 配置；apiKey 必填。 */
 type ChatCompletionsAdapterOptions = HttpAdapterOptions & {
   apiKey: string;
 };
+/** OpenAI Chat Completions API 的流式请求体。 */
 type ChatRequest = {
   model: string;
   messages: ChatMessage[];
@@ -1175,10 +1266,12 @@ type ChatRequest = {
   stream: true;
   n: 1;
 };
+/** Chat Completions 文本内容 part。 */
 type ChatTextPart = {
   type: "text";
   text: string;
 };
+/** Chat Completions 图片内容 part。 */
 type ChatImagePart = {
   type: "image_url";
   image_url: {
@@ -1186,7 +1279,9 @@ type ChatImagePart = {
     detail?: "auto" | "low" | "high";
   };
 };
+/** Chat Completions 内容 part 联合。 */
 type ChatContentPart = ChatTextPart | ChatImagePart;
+/** Chat Completions 消息。 */
 type ChatMessage = {
   role: "system" | "user" | "assistant" | "tool";
   content: string | null | ChatContentPart[];
@@ -1195,6 +1290,7 @@ type ChatMessage = {
   name?: string;
   [key: string]: unknown;
 };
+/** Chat Completions 工具调用。 */
 type ChatToolCall = {
   id: string;
   type: "function";
@@ -1203,6 +1299,7 @@ type ChatToolCall = {
     arguments: string;
   };
 };
+/** Chat Completions 客户端工具。 */
 type ChatTool = {
   type: "function";
   function: {
@@ -1213,6 +1310,7 @@ type ChatTool = {
 };
 //#endregion
 //#region src/adapters/chat-completions/adapter.d.ts
+/** OpenAI Chat Completions API 适配器。 */
 declare class ChatCompletionsAdapter extends HttpAdapterBase {
   readonly kind: "chat-completions";
   readonly isSyntheticStream = false;
@@ -1221,11 +1319,39 @@ declare class ChatCompletionsAdapter extends HttpAdapterBase {
   protected runStream(providerRequest: ChatRequest, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
 }
 //#endregion
+//#region src/adapters/delta-completions/types.d.ts
+/** 残缺 chat/completions 兼容适配器；必须显式 baseUrl，避免误打 OpenAI。 */
+type DeltaCompletionsAdapterOptions = HttpAdapterOptions & {
+  baseUrl: string;
+};
+/** 出站请求：仅文本 messages + stream。不发送 n / tools / reasoning。 */
+type DeltaChatRequest = {
+  model: string;
+  messages: DeltaChatMessage[];
+  stream: true;
+  temperature?: number;
+  max_tokens?: number;
+};
+/** 仅文本 chat 消息。 */
+type DeltaChatMessage = {
+  role: "system" | "user" | "assistant";
+  content: string;
+};
+//#endregion
+//#region src/adapters/delta-completions/adapter.d.ts
+/** 残缺 chat/completions SSE 适配器。 */
+declare class DeltaCompletionsAdapter extends HttpAdapterBase {
+  readonly kind: "delta-completions";
+  readonly isSyntheticStream = false;
+  constructor(options: DeltaCompletionsAdapterOptions);
+  protected buildRequest(request: NormalizedRequest): DeltaChatRequest;
+  protected runStream(providerRequest: DeltaChatRequest, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
+}
+//#endregion
 //#region src/adapters/ollama/types.d.ts
-/**
- * apiKey 可选（代理鉴权）；默认 baseUrl http://localhost:11434
- */
+/** Ollama adapter 配置；apiKey 可选，默认连接本地服务。 */
 type OllamaAdapterOptions = HttpAdapterOptions;
+/** Ollama Chat API 的流式请求体。 */
 type OllamaChatRequest = {
   model: string;
   messages: OllamaMessage[];
@@ -1239,18 +1365,21 @@ type OllamaChatRequest = {
     [key: string]: unknown;
   };
 };
+/** Ollama 消息。 */
 type OllamaMessage = {
   role: "system" | "user" | "assistant" | "tool";
   content: string;
   images?: string[];
   tool_calls?: OllamaToolCall[];
 };
+/** Ollama 工具调用。 */
 type OllamaToolCall = {
   function: {
     name: string;
     arguments: Record<string, unknown>;
   };
 };
+/** Ollama 客户端工具。 */
 type OllamaTool = {
   type: "function";
   function: {
@@ -1261,6 +1390,7 @@ type OllamaTool = {
 };
 //#endregion
 //#region src/adapters/ollama/adapter.d.ts
+/** Ollama Chat API 适配器。 */
 declare class OllamaAdapter extends HttpAdapterBase {
   readonly kind: "ollama";
   readonly isSyntheticStream = false;
@@ -1270,10 +1400,11 @@ declare class OllamaAdapter extends HttpAdapterBase {
 }
 //#endregion
 //#region src/adapters/gemini/types.d.ts
-/** apiKey 必填；默认 baseUrl https://generativelanguage.googleapis.com/v1beta */
+/** Gemini adapter 配置；apiKey 必填。 */
 type GeminiAdapterOptions = HttpAdapterOptions & {
   apiKey: string;
 };
+/** Gemini 内容 part。 */
 type GeminiPart = {
   text?: string;
   thought?: boolean;
@@ -1294,22 +1425,27 @@ type GeminiPart = {
   };
   [key: string]: unknown;
 };
+/** Gemini 对话内容。 */
 type GeminiContent = {
   role: "user" | "model";
   parts: GeminiPart[];
 };
+/** Gemini function declaration。 */
 type GeminiFunctionDeclaration = {
   name: string;
   description?: string;
   parameters: Record<string, unknown>;
 };
+/** Gemini 工具容器。 */
 type GeminiTool = {
   functionDeclarations: GeminiFunctionDeclaration[];
 };
+/** Gemini function calling 配置。 */
 type GeminiFunctionCallingConfig = {
   mode: "AUTO" | "ANY" | "NONE";
   allowedFunctionNames?: string[];
 };
+/** Gemini generateContent 请求体。 */
 type GeminiGenerateContentRequest = {
   contents: GeminiContent[];
   cachedContent?: string;
@@ -1335,6 +1471,7 @@ type GeminiGenerateContentRequest = {
 };
 //#endregion
 //#region src/adapters/gemini/adapter.d.ts
+/** Google Gemini generateContent API 适配器。 */
 declare class GeminiAdapter extends HttpAdapterBase {
   readonly kind: "gemini";
   readonly isSyntheticStream = false;
@@ -1344,6 +1481,7 @@ declare class GeminiAdapter extends HttpAdapterBase {
 }
 //#endregion
 //#region src/adapters/mock/types.d.ts
+/** Mock handler 对单个输入 item 的匹配条件。 */
 type MockInputExpectation = {
   type: InputItem["type"];
   id?: string;
@@ -1363,6 +1501,7 @@ type MockInputExpectation = {
   }>["purpose"];
   textIncludes?: string;
 };
+/** Mock 请求整体的断言条件。 */
 type MockRequestExpectation = {
   minItems?: number;
   maxItems?: number;
@@ -1374,12 +1513,14 @@ type MockRequestExpectation = {
   toolChoice?: "ignore" | "present" | "absent";
   items?: MockInputExpectation[];
 };
+/** Mock adapter 记录的一轮请求历史。 */
 type MockHistoryRecord = {
   turnIndex: number;
   requestId: string;
   replay: ReplayItem[];
   toolCalls: ToolCallItem[];
 };
+/** Mock handler 可读取的当前回合上下文。 */
 type MockHandlerContext = {
   turnIndex: number;
   previousReplay: ReplayItem[];
@@ -1388,17 +1529,20 @@ type MockHandlerContext = {
   signal?: AbortSignal; /** 当前请求的 portable reasoningLevel（若设置）。 */
   reasoningLevel?: ReasoningLevel;
 };
+/** 在 Mock 流中发出 warning。 */
 type MockWarningStep = {
   type: "warning";
   message: string;
   code?: string;
 };
+/** 在 Mock 流中发出辅助响应信息。 */
 type MockAuxiliaryStep = {
   type: "auxiliary";
   usage?: Usage;
   billing?: BillingInfo;
   auxiliary?: Partial<AuxiliaryInfo>;
 };
+/** Mock 文本/参数增量的切分和延迟配置。 */
 type MockTextStreamOptions = {
   /**
    * 每秒吐出的字符数。未设置时仍会按 chunk 拆分，但不会额外等待。
@@ -1413,6 +1557,7 @@ type MockTextStreamOptions = {
    */
   initialDelayMs?: number;
 };
+/** 在 Mock 流中发出消息 item。 */
 type MockMessageStep = {
   type: "message";
   id?: string;
@@ -1420,6 +1565,7 @@ type MockMessageStep = {
   citations?: Citation[];
   stream?: MockTextStreamOptions | false;
 };
+/** 在 Mock 流中发出 provider 托管工具调用。 */
 type MockServerToolCallStep = {
   type: "server_tool_call";
   id: string;
@@ -1432,14 +1578,17 @@ type MockServerToolCallStep = {
   streamArguments?: boolean;
   stream?: MockTextStreamOptions | false;
 };
+/** 在 Mock 流中发出 provider 托管工具结果。 */
 type MockServerToolResultStep = {
   type: "server_tool_result";
   item: ServerToolResultItem;
 };
+/** 在 Mock 流中发出 provider 工具发现列表。 */
 type MockServerToolDiscoveryStep = {
   type: "server_tool_discovery";
   item: ServerToolDiscoveryItem;
 };
+/** 在 Mock 流中发出 reasoning item。 */
 type MockReasoningStep = {
   type: "reasoning";
   id?: string;
@@ -1449,6 +1598,7 @@ type MockReasoningStep = {
   content: string | ContentBlock[];
   stream?: MockTextStreamOptions | false;
 };
+/** 在 Mock 流中发出客户端工具调用。 */
 type MockToolCallStep = {
   type: "tool_call";
   id: string;
@@ -1457,6 +1607,7 @@ type MockToolCallStep = {
   streamArguments?: boolean;
   stream?: MockTextStreamOptions | false;
 };
+/** 在 Mock 流中直接发出完整 output item。 */
 type MockOutputStep = {
   type: "output";
   item: Extract<OutputItem, {
@@ -1464,6 +1615,7 @@ type MockOutputStep = {
   }>;
   stream?: MockTextStreamOptions | false;
 };
+/** 在 Mock 流中完成当前响应并提供完成元数据。 */
 type MockCompleteStep = {
   type: "complete";
   stopReason?: StopReason;
@@ -1475,6 +1627,7 @@ type MockCompleteStep = {
   rawResponseId?: string;
   warnings?: StreamWarning[];
 };
+/** 在 Mock 流中发出可恢复错误。 */
 type MockErrorStep = {
   type: "error";
   message: string;
@@ -1482,19 +1635,26 @@ type MockErrorStep = {
   stopReason?: StopReason;
   providerMetadata?: Record<string, unknown>;
 };
+/** 在 Mock 流中模拟中断。 */
 type MockInterruptStep = {
   type: "interrupt";
 };
+/** 在 Mock 流中抛出异常。 */
 type MockThrowStep = {
   type: "throw";
   error: string | Error;
 };
+/** Mock handler 可发出的所有步骤。 */
 type MockStep = MockWarningStep | MockAuxiliaryStep | MockMessageStep | MockReasoningStep | MockToolCallStep | MockServerToolCallStep | MockServerToolResultStep | MockServerToolDiscoveryStep | MockOutputStep | MockCompleteStep | MockErrorStep | MockInterruptStep | MockThrowStep;
+/** 按规范化请求和上下文生成 Mock 流步骤。 */
 type MockHandler = (request: NormalizedRequest, context: MockHandlerContext) => AsyncIterable<MockStep>;
+/** 可同步或异步消费的 Mock 步骤来源。 */
 type MockHandlerSource = Iterable<MockStep> | AsyncIterable<MockStep>;
+/** 可返回同步/异步步骤来源的 Mock handler。 */
 type MockStaticHandler = (request: NormalizedRequest, context: MockHandlerContext) => MockHandlerSource | Promise<MockHandlerSource>;
 /** Mock compress 夹具；未配置时 compress() 抛 MOCK_COMPRESS_NOT_CONFIGURED */
 type MockCompressHandler = (request: CompressRequest) => CompressResult | Promise<CompressResult>;
+/** Mock adapter 的构造选项。 */
 type MockAdapterOptions = {
   handler: MockHandler;
   providerMetadata?: Record<string, unknown>; /** 可选：实现 ContextCompressCapable 供 compress 契约测试 */
@@ -1508,6 +1668,7 @@ type MockProviderRequest = {
 };
 //#endregion
 //#region src/adapters/mock/adapter.d.ts
+/** 用于测试和本地场景的确定性模拟适配器。 */
 declare class MockAdapter extends AdapterBase implements ContextCompressCapable {
   readonly kind: "mock";
   readonly isSyntheticStream = true;
@@ -1532,10 +1693,12 @@ declare class MockAdapter extends AdapterBase implements ContextCompressCapable
 }
 //#endregion
 //#region src/adapters/mock/expectations.d.ts
+/** 按 MockRequestExpectation 校验规范化请求；失败时抛出断言错误。 */
 declare function assertMockRequest(request: NormalizedRequest, expectation: MockRequestExpectation, context: MockHandlerContext): void;
 //#endregion
 //#region src/adapters/mock/streaming.d.ts
+/** 为静态 Mock handler 添加可配置的文本/参数流式切分。 */
 declare function withMockStreaming(handler: MockStaticHandler, options: MockTextStreamOptions): MockHandler;
 //#endregion
-export { type AIClient, AIError, AIMappingError, AIProviderError, AIRecoverableError, type AIRequest, AIRequestError, type AIResponse, AIStreamError, type AIStreamEvent, type AdapterKind, type AuxiliaryInfo, type BackendAdapter, type BackendTrace, type BillingInfo, ChatCompletionsAdapter, type ChatCompletionsAdapterOptions, type Citation, type CodeExecutionServerTool, type CompressRequest, type CompressResult, type ContainerFileCitation, type ContentBlock, type ContextCompressCapable, type CreateAIClientOptions, type ErrorCode, type FetchFn, GeminiAdapter, type GeminiAdapterOptions, type IncludeSettings, type InputItem, type InstructionBlock, type JsonContentBlock, KNOWN_ADAPTER_KINDS, type KnownAdapterKind, type KnownErrorCode, type KnownWarningCode, type McpServerTool, type MessageCompletedEvent, type MessageDeltaEvent, type MessageItem, type MessageStartedEvent, MessagesAdapter, type MessagesAdapterOptions, MockAdapter, type MockAdapterOptions, type MockAuxiliaryStep, type MockCompleteStep, type MockCompressHandler, type MockErrorStep, type MockHandler, type MockHandlerContext, type MockHistoryRecord, type MockInputExpectation, type MockInterruptStep, type MockMessageStep, type MockOutputStep, type MockReasoningStep, type MockRequestExpectation, type MockServerToolCallStep, type MockServerToolDiscoveryStep, type MockServerToolResultStep, type MockStaticHandler, type MockStep, type MockTextStreamOptions, type MockThrowStep, type MockToolCallStep, type MockWarningStep, type NormalizedRequest, OllamaAdapter, type OllamaAdapterOptions, type OpaqueItem, type OutputItem, type PromptCacheMetadata, type PromptCacheMode, type PromptCacheSettings, type ProviderCacheOptions, REASONING_LEVELS, REASONING_LEVEL_SET, type ReasoningCompletedEvent, type ReasoningDeltaEvent, type ReasoningItem, type ReasoningLevel, type ReasoningStartedEvent, type ReplayItem, type ResponseAuxiliaryEvent, type ResponseCompletedEvent, type ResponseStartedEvent, type ResponseWarningEvent, ResponsesAdapter, type ResponsesAdapterOptions, type ServerToolCallItem, type ServerToolCompletedEvent, type ServerToolDefinition, type ServerToolDeltaEvent, type ServerToolDiscoveryCompletedEvent, type ServerToolDiscoveryItem, type ServerToolResultCompletedEvent, type ServerToolResultItem, type ServerToolStartedEvent, type StopReason, type StreamEventBase, type StreamWarning, type TextContentBlock, type ToolCallCompletedEvent, type ToolCallDeltaEvent, type ToolCallItem, type ToolCallStartedEvent, type ToolChoice, type ToolDefinition, type ToolResultItem, type UrlCitation, type Usage, WarningCode, type WarningCodeName, type WarningCodeValue, type WebSearchServerTool, type WebSearchUserLocation, assertMockRequest, blockToText, coalesceContentBlocks, collectStream, contentBlocksToText, createAIClient, extractText, imageBlock, jsonBlock, mapReasoningVisibility, mapStopReason, messageItem, opaqueBlock, opaqueItem, reasoningItem, replayFromOutput, serverToolCallItem, serverToolDiscoveryItem, serverToolResultItem, streamWarningKey, supportsContextCompress, textBlock, toolCallItem, toolResultItem, withMockStreaming };
+export { type AIClient, AIError, AIMappingError, AIProviderError, AIRecoverableError, type AIRequest, AIRequestError, type AIResponse, AIStreamError, type AIStreamEvent, type AdapterKind, type AuxiliaryInfo, type BackendAdapter, type BackendTrace, type BillingInfo, ChatCompletionsAdapter, type ChatCompletionsAdapterOptions, type Citation, type CodeExecutionServerTool, type CompressRequest, type CompressResult, type ContainerFileCitation, type ContentBlock, type ContextCompressCapable, type CreateAIClientOptions, DeltaCompletionsAdapter, type DeltaCompletionsAdapterOptions, type ErrorCode, type FetchFn, GeminiAdapter, type GeminiAdapterOptions, type IncludeSettings, type InputItem, type InstructionBlock, type JsonContentBlock, KNOWN_ADAPTER_KINDS, type KnownAdapterKind, type KnownErrorCode, type KnownWarningCode, type McpServerTool, type MessageCompletedEvent, type MessageDeltaEvent, type MessageItem, type MessageStartedEvent, MessagesAdapter, type MessagesAdapterOptions, MockAdapter, type MockAdapterOptions, type MockAuxiliaryStep, type MockCompleteStep, type MockCompressHandler, type MockErrorStep, type MockHandler, type MockHandlerContext, type MockHistoryRecord, type MockInputExpectation, type MockInterruptStep, type MockMessageStep, type MockOutputStep, type MockReasoningStep, type MockRequestExpectation, type MockServerToolCallStep, type MockServerToolDiscoveryStep, type MockServerToolResultStep, type MockStaticHandler, type MockStep, type MockTextStreamOptions, type MockThrowStep, type MockToolCallStep, type MockWarningStep, type NormalizedRequest, OllamaAdapter, type OllamaAdapterOptions, type OpaqueItem, type OutputItem, type PromptCacheMetadata, type PromptCacheMode, type PromptCacheSettings, type ProviderCacheOptions, REASONING_LEVELS, REASONING_LEVEL_SET, type ReasoningCompletedEvent, type ReasoningDeltaEvent, type ReasoningItem, type ReasoningLevel, type ReasoningStartedEvent, type ReplayItem, type ResponseAuxiliaryEvent, type ResponseCompletedEvent, type ResponseStartedEvent, type ResponseWarningEvent, ResponsesAdapter, type ResponsesAdapterOptions, type ServerToolCallItem, type ServerToolCompletedEvent, type ServerToolDefinition, type ServerToolDeltaEvent, type ServerToolDiscoveryCompletedEvent, type ServerToolDiscoveryItem, type ServerToolResultCompletedEvent, type ServerToolResultItem, type ServerToolStartedEvent, type StopReason, type StreamEventBase, type StreamWarning, type TextContentBlock, type ToolCallCompletedEvent, type ToolCallDeltaEvent, type ToolCallItem, type ToolCallStartedEvent, type ToolChoice, type ToolDefinition, type ToolResultItem, type UrlCitation, type Usage, WarningCode, type WarningCodeName, type WarningCodeValue, type WebSearchServerTool, type WebSearchUserLocation, assertMockRequest, blockToText, coalesceContentBlocks, collectStream, contentBlocksToText, createAIClient, extractText, imageBlock, jsonBlock, mapReasoningVisibility, mapStopReason, messageItem, opaqueBlock, opaqueItem, reasoningItem, replayFromOutput, serverToolCallItem, serverToolDiscoveryItem, serverToolResultItem, streamWarningKey, supportsContextCompress, textBlock, toolCallItem, toolResultItem, withMockStreaming };
 //# sourceMappingURL=index.d.mts.map