@codehz/ai 0.4.6 → 0.7.0

package/dist/index.d.mts

@@ -1,3 +1,15 @@
+//#region src/types/kind.d.ts
+/**
+ * Adapter kind 标识
+ *
+ * KnownAdapterKind 覆盖内置 adapter；
+ * AdapterKind 额外接受任意 string，便于自定义 backend 扩展（无需改库联合类型）。
+ */
+declare const KNOWN_ADAPTER_KINDS: readonly ["chat-completions", "messages", "responses", "ollama", "gemini", "mock"];
+type KnownAdapterKind = (typeof KNOWN_ADAPTER_KINDS)[number];
+/** 内置 kind 自动补全 + 自定义 string 扩展 */
+type AdapterKind = KnownAdapterKind | (string & {});
+//#endregion
 //#region src/types/content.d.ts
 /**
  * ContentBlock — 统一内容块类型
@@ -25,11 +37,28 @@ type ContentBlock = InstructionBlock | {
 };
 //#endregion
 //#region src/types/items.d.ts
+type UrlCitation = {
+  type: "url";
+  url: string;
+  title?: string;
+  startIndex?: number;
+  endIndex?: number;
+};
+type ContainerFileCitation = {
+  type: "container_file";
+  containerId: string;
+  fileId: string;
+  filename?: string;
+  startIndex?: number;
+  endIndex?: number;
+};
+type Citation = UrlCitation | ContainerFileCitation;
 type MessageItem = {
   type: "message";
   id?: string;
   role: "user" | "assistant";
   content: ContentBlock[];
+  citations?: Citation[];
 };
 type ReasoningItem = {
   type: "reasoning";
@@ -57,10 +86,44 @@ type OpaqueItem = {
   purpose: "replay" | "provider_state" | "unknown";
   payload: unknown;
 };
+/** Provider 托管工具调用（调用方不执行） */
+type ServerToolCallItem = {
+  type: "server_tool_call";
+  id: string;
+  tool: "web_search" | "code_execution" | "mcp" | string;
+  name?: string;
+  argumentsText?: string;
+  status?: "in_progress" | "completed" | "failed";
+  serverLabel?: string;
+  providerPayload?: unknown;
+};
+/** Provider 托管工具结果 */
+type ServerToolResultItem = {
+  type: "server_tool_result";
+  id?: string;
+  callId: string;
+  tool: string;
+  outcome: "success" | "error";
+  content: ContentBlock[];
+  providerPayload?: unknown;
+};
+/** MCP 等远端工具发现列表 */
+type ServerToolDiscoveryItem = {
+  type: "server_tool_discovery";
+  id: string;
+  tool: "mcp";
+  serverLabel: string;
+  tools: Array<{
+    name: string;
+    description?: string;
+    inputSchema?: unknown;
+  }>;
+  providerPayload?: unknown;
+};
 /** 可出现在请求 input 中的 item 类型 */
-type InputItem = MessageItem | ReasoningItem | ToolCallItem | ToolResultItem | OpaqueItem;
-/** 可出现在响应 output 中的 item 类型（不含 ToolResultItem） */
-type OutputItem = MessageItem | ReasoningItem | ToolCallItem | OpaqueItem;
+type InputItem = MessageItem | ReasoningItem | ToolCallItem | ToolResultItem | OpaqueItem | ServerToolCallItem | ServerToolResultItem | ServerToolDiscoveryItem;
+/** 可出现在响应 output 中的 item 类型（不含客户端 ToolResultItem） */
+type OutputItem = MessageItem | ReasoningItem | ToolCallItem | OpaqueItem | ServerToolCallItem | ServerToolResultItem | ServerToolDiscoveryItem;
 /** replay 材料的类型等价于 InputItem */
 type ReplayItem = InputItem;
 //#endregion
@@ -74,6 +137,39 @@ type ToolChoice = "auto" | "none" | {
   type: "tool";
   name: string;
 };
+type WebSearchUserLocation = {
+  type: "approximate";
+  country?: string;
+  city?: string;
+  region?: string;
+  timezone?: string;
+};
+type WebSearchServerTool = {
+  type: "web_search";
+  allowedDomains?: string[];
+  blockedDomains?: string[];
+  userLocation?: WebSearchUserLocation;
+  searchContextSize?: "low" | "medium" | "high";
+};
+type CodeExecutionServerTool = {
+  type: "code_execution";
+  container?: {
+    type: "auto";
+    memoryLimit?: "1g" | "4g" | "16g" | "64g";
+    fileIds?: string[];
+  };
+};
+type McpServerTool = {
+  type: "mcp";
+  serverLabel: string;
+  serverUrl: string;
+  serverDescription?: string; /** 每请求由调用方提供；不得写入日志或 opaque 回放。 */
+  authorization?: string;
+  allowedTools?: string[]; /** 首版仅支持 never */
+  requireApproval: "never";
+};
+/** Provider 托管执行的工具声明（不进客户端 tool loop） */
+type ServerToolDefinition = WebSearchServerTool | CodeExecutionServerTool | McpServerTool;
 type IncludeSettings = {
   usage?: "off" | "best_effort";
   billing?: "off" | "best_effort";
@@ -81,10 +177,15 @@ type IncludeSettings = {
 };
 /** Portable reasoning / thinking effort. Mapped per-adapter to provider wire fields. */
 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>;
 type AIRequest = {
   instructions?: string | InstructionBlock[];
   input: InputItem[];
-  tools?: ToolDefinition[];
+  tools?: ToolDefinition[]; /** Provider 托管工具（web_search / code_execution / mcp 等）；与 tools 可共存 */
+  serverTools?: ServerToolDefinition[];
   toolChoice?: ToolChoice;
   include?: IncludeSettings;
   metadata?: Record<string, string>;
@@ -93,12 +194,57 @@ type AIRequest = {
   /**
    * Portable reasoning effort. Adapters map this to provider-native fields
    * (e.g. Responses `reasoning.effort`, Chat Completions `reasoning_effort`,
-   * Messages `thinking`, Ollama `think`). Unsupported levels throw.
+   * Messages `thinking`, Ollama `think`, Gemini `thinkingConfig`).
+   * Unsupported levels throw.
    */
   reasoningLevel?: ReasoningLevel; /** AbortSignal 用于打断请求。abort 时 fetch 调用会被取消，流迭代器抛出 AbortError。 */
   signal?: AbortSignal;
 };
 //#endregion
+//#region src/types/warning-codes.d.ts
+/**
+ * 标准 warning 代码 — types 层单源
+ *
+ * runtime.errors 与 events 均从此导出，避免手工双表漂移。
+ */
+declare const WarningCode: {
+  /** replay fidelity 低于预期 */readonly REPLAY_FIDELITY_LOW: "REPLAY_FIDELITY_LOW"; /** usage 字段缺失 */
+  readonly USAGE_MISSING: "USAGE_MISSING"; /** billing 字段缺失 */
+  readonly BILLING_MISSING: "BILLING_MISSING"; /** billing 只能给估算值 */
+  readonly BILLING_ESTIMATED: "BILLING_ESTIMATED"; /** follow-up lookup 失败 */
+  readonly LOOKUP_FAILED: "LOOKUP_FAILED"; /** lookup 超时 */
+  readonly LOOKUP_TIMEOUT: "LOOKUP_TIMEOUT"; /** 流提前中断 */
+  readonly STREAM_INCOMPLETE: "STREAM_INCOMPLETE"; /** 流帧/行解析失败 */
+  readonly STREAM_ERROR: "STREAM_ERROR"; /** 能力降级 */
+  readonly CAPABILITY_DOWNGRADE: "CAPABILITY_DOWNGRADE"; /** 模拟流式 */
+  readonly SYNTHETIC_STREAM: "SYNTHETIC_STREAM"; /** 工具调用以批量方式到达（非 token 级流式） */
+  readonly TOOL_CALL_BATCHED: "TOOL_CALL_BATCHED"; /** AIMappingError 降级为 warning */
+  readonly MAPPING_ERROR: "MAPPING_ERROR"; /** 入站 tool_call.argumentsText 非合法 JSON object（object-wire adapter soft-complete） */
+  readonly TOOL_CALL_ARGUMENTS_INVALID: "TOOL_CALL_ARGUMENTS_INVALID"; /** 请求 metadata 不被该 adapter 支持 */
+  readonly UNSUPPORTED_METADATA: "UNSUPPORTED_METADATA"; /** 重复 finish / done 信号被忽略 */
+  readonly DUPLICATE_FINISH: "DUPLICATE_FINISH"; /** provider 发出未知事件类型 */
+  readonly UNKNOWN_PROVIDER_EVENT: "UNKNOWN_PROVIDER_EVENT"; /** 内容被安全/策略过滤 */
+  readonly CONTENT_FILTER: "CONTENT_FILTER"; /** 多 choice 仅支持 index 0，其余忽略 */
+  readonly MULTIPLE_CHOICES_IGNORED: "MULTIPLE_CHOICES_IGNORED"; /** MCP 审批流不被支持 */
+  readonly MCP_APPROVAL_REQUIRED: "MCP_APPROVAL_REQUIRED"; /** provider 侧 response.failed 等失败 */
+  readonly PROVIDER_FAILURE: "PROVIDER_FAILURE";
+};
+type WarningCodeName = (typeof WarningCode)[keyof typeof WarningCode];
+/** 与 WarningCodeName 同义；保留以兼容既有 KnownWarningCode 命名 */
+type KnownWarningCode = WarningCodeName;
+/** 已知码 + 开放字符串扩展 */
+type WarningCodeValue = KnownWarningCode | (string & {});
+/** 结构化 warning（AIResponse / response.completed / factory 共用） */
+type StreamWarning = {
+  message: string;
+  code?: WarningCodeValue;
+};
+/**
+ * 去重键：以 message 为主（与旧 string[] 行为一致）。
+ * 同一 message 若先无 code 后有 code，保留先到的那条。
+ */
+declare function streamWarningKey(warning: StreamWarning): string;
+//#endregion
 //#region src/types/response.d.ts
 type StopReason = "end_turn" | "tool_call" | "max_output_tokens" | "content_filter" | "error" | "unknown";
 type Usage = {
@@ -126,22 +272,24 @@ type AuxiliaryInfo = {
 type BackendTrace = {
   requestId?: string;
   rawResponseId?: string;
-  adapter: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
+  adapter: AdapterKind;
   isSyntheticStream: boolean;
   metadataSources?: string[];
-  warnings?: string[];
+  warnings?: StreamWarning[];
 };
 type AIResponse = {
   id?: string;
   output: OutputItem[];
   replay: ReplayItem[];
   text: string;
-  toolCalls: ToolCallItem[];
+  toolCalls: ToolCallItem[]; /** Provider 托管工具调用列表（web_search / code_execution / mcp 等） */
+  serverToolCalls: ServerToolCallItem[]; /** Provider 托管工具结果列表 */
+  serverToolResults: ServerToolResultItem[];
   stopReason?: StopReason;
   usage?: Usage;
   billing?: BillingInfo;
-  auxiliary?: AuxiliaryInfo;
-  warnings?: string[];
+  auxiliary?: AuxiliaryInfo; /** 结构化 warning；权威源含 message + 可选 code */
+  warnings?: StreamWarning[];
   backend: BackendTrace;
 };
 //#endregion
@@ -152,7 +300,7 @@ type StreamEventBase = {
   sequence: number;
   timestamp: string;
   backend: {
-    kind: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
+    kind: AdapterKind;
     isSynthetic: boolean;
   };
 };
@@ -163,7 +311,7 @@ type ResponseStartedEvent = StreamEventBase & {
 type ResponseWarningEvent = StreamEventBase & {
   type: "response.warning";
   message: string;
-  code?: string;
+  code?: WarningCodeValue;
 };
 type ResponseAuxiliaryEvent = StreamEventBase & {
   type: "response.auxiliary";
@@ -178,7 +326,7 @@ type ResponseCompletedEvent = StreamEventBase & {
   usage?: Usage;
   billing?: BillingInfo;
   auxiliary?: AuxiliaryInfo;
-  warnings?: string[];
+  warnings?: StreamWarning[];
   opaqueOutput?: OpaqueItem[];
   trace?: Partial<BackendTrace>;
 };
@@ -197,6 +345,7 @@ type MessageDeltaEvent = StreamEventBase & {
 type MessageCompletedEvent = StreamEventBase & {
   type: "message.completed";
   itemId: string;
+  citations?: Citation[];
 };
 type ReasoningStartedEvent = StreamEventBase & {
   type: "reasoning.started";
@@ -232,7 +381,37 @@ type ToolCallCompletedEvent = StreamEventBase & {
   type: "tool_call.completed";
   itemId: string;
 };
-type AIStreamEvent = ResponseStartedEvent | ResponseWarningEvent | ResponseAuxiliaryEvent | MessageStartedEvent | MessageDeltaEvent | MessageCompletedEvent | ReasoningStartedEvent | ReasoningDeltaEvent | ReasoningCompletedEvent | ToolCallStartedEvent | ToolCallDeltaEvent | ToolCallCompletedEvent | ResponseCompletedEvent;
+type ServerToolStartedEvent = StreamEventBase & {
+  type: "server_tool.started";
+  item: {
+    id: string;
+    tool: string;
+    name?: string;
+    serverLabel?: string;
+  };
+};
+type ServerToolDeltaEvent = StreamEventBase & {
+  type: "server_tool.delta";
+  itemId: string;
+  delta: {
+    argumentsText?: string;
+  };
+};
+type ServerToolCompletedEvent = StreamEventBase & {
+  type: "server_tool.completed";
+  itemId: string;
+  status?: "completed" | "failed";
+  providerPayload?: unknown;
+};
+type ServerToolResultCompletedEvent = StreamEventBase & {
+  type: "server_tool_result.completed";
+  item: ServerToolResultItem;
+};
+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 函数签名，用于注入自定义请求实现（测试／代理） */
@@ -242,7 +421,7 @@ type NormalizedRequest = AIRequest & {
   requestId: string;
 };
 interface BackendAdapter {
-  readonly kind: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
+  readonly kind: AdapterKind;
   readonly isSyntheticStream: boolean;
   stream(request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
 }
@@ -256,50 +435,39 @@ interface AIClient {
   stream(request: AIRequest): AsyncIterable<AIStreamEvent>;
 }
 //#endregion
-//#region src/core/client.d.ts
-declare function createAIClient(options: CreateAIClientOptions): AIClient;
-//#endregion
-//#region src/core/normalize.d.ts
-type NormalizeOptions = {
+//#region src/types/compress.d.ts
+/** 显式上下文压缩请求（独立于 stream） */
+type CompressRequest = {
   model: string;
-  defaults?: Partial<AIRequest>;
+  input: InputItem[];
+  instructions?: string | InstructionBlock[];
+  include?: IncludeSettings; /** AbortSignal 用于打断压缩请求。 */
+  signal?: AbortSignal;
 };
-/**
- * 归一化请求：
- * 1. 合并 defaults
- * 2. 填充 include 默认值
- * 3. 生成 requestId
- * 4. 校验请求合法性
- */
-declare function normalizeRequest(request: AIRequest, options: NormalizeOptions): NormalizedRequest;
-//#endregion
-//#region src/core/validation.d.ts
-type ValidationIssue = {
-  field: string;
-  code: string;
-  message: string;
+/** 压缩结果：调用方用 replay 替换旧 transcript（非 append 全文） */
+type CompressResult = {
+  replay: ReplayItem[];
+  usage?: Usage;
+  auxiliary?: AuxiliaryInfo;
+  rawResponseId?: string;
 };
-/**
- * 校验 AIRequest，返回校验问题列表。
- * 空数组表示无问题。
- */
-declare function validateRequest(request: AIRequest): ValidationIssue[];
-/**
- * 校验请求并抛出首个问题。
- * 适用于客户端入口的快速失败检查。
- */
-declare function assertValidRequest(request: AIRequest): void;
+/** Adapter 可选能力：原生上下文压缩 */
+interface ContextCompressCapable {
+  compress(request: CompressRequest): Promise<CompressResult>;
+}
+/** 探测 adapter 是否实现 compress（不依赖 kind 硬编码）。 */
+declare function supportsContextCompress(adapter: BackendAdapter): adapter is BackendAdapter & ContextCompressCapable;
 //#endregion
-//#region src/core/errors.d.ts
+//#region src/runtime/client.d.ts
+declare function createAIClient(options: CreateAIClientOptions): AIClient;
+//#endregion
+//#region src/runtime/errors.d.ts
 /**
- * 公共错误模型
- *
- * 把失败、降级、断流三类情况明确区分：
- * - 致命错误 → 同步抛错或迭代器抛错
- * - 非致命差异 → warning 通道
- * - 流中断 → 不伪造 response.completed
+ * 已知错误码。保留补全；未知码用 `string & {}` 扩展，避免 `| string` 吞掉字面量提示。
+ * ValidationIssue.code 可更细，不强制全部列入此处；以作为 AIError.code 传入的码为主。
  */
-type ErrorCode = "INPUT_EMPTY" | "TEMPERATURE_OUT_OF_RANGE" | "MAX_OUTPUT_TOKENS_INVALID" | "TOOL_CHOICE_NO_TOOLS" | "TOOL_CHOICE_UNKNOWN_TOOL" | "PROVIDER_ERROR" | "AUTH_ERROR" | "STREAM_ERROR" | "MAPPING_ERROR" | "STREAM_INCOMPLETE" | "LOOKUP_FAILED" | "LOOKUP_TIMEOUT" | string;
+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";
+type ErrorCode = KnownErrorCode | (string & {});
 declare class AIError extends Error {
   readonly code: ErrorCode;
   readonly name: string;
@@ -318,40 +486,109 @@ declare class AIRequestError extends AIError {
     message: string;
   }[] | undefined);
 }
-/** Provider 调用失败 — HTTP 非 2xx、网络错误。由 AdapterBase 捕获转为 warning。 */
+/**
+ * Provider 调用失败 — HTTP 非 2xx、网络错误。
+ * AdapterBase **rethrow**（致命），不会转为 warning。
+ */
 declare class AIProviderError extends AIError {
   readonly statusCode?: number | undefined;
   readonly responseBody?: string | undefined;
   constructor(message: string, code: ErrorCode, statusCode?: number | undefined, responseBody?: string | undefined);
 }
-/** 流协议损坏 — SSE 解析失败、chunk 格式异常。 */
+/**
+ * 流协议/传输损坏 — SSE 解析失败、chunk 格式异常、body 不可读等。
+ * 致命：同步或在异步迭代中抛出，不伪造 response.completed。
+ */
 declare class AIStreamError extends AIError {
   constructor(message: string, code: ErrorCode);
 }
-/** Canonical 映射失败 — 无法将 provider 响应映射到 canonical 类型。 */
+/**
+ * Canonical 映射失败 — 无法将 provider 响应映射到 canonical 类型。
+ *
+ * AdapterBase 捕获后降级为：
+ * - `response.warning`（code = MAPPING_ERROR）
+ * - 空 output 的 `response.completed`
+ *
+ * 生产 adapter 原则上不应抛出；此路径是协议级降级通道（测试 / 防御性边界）。
+ */
 declare class AIMappingError extends AIError {
   constructor(message: string, code: ErrorCode);
 }
 /**
- * 标准 warning 代码列表。
- * 用于非致命差异的记录。
+ * 可恢复的回合失败 — buildRequest / runStream 中可安全 soft-complete 的语义错误。
+ *
+ * AdapterBase 在 `response.started` 之后捕获后降级为：
+ * - `response.warning`（code = 错误 code，通常对齐 WarningCode）
+ * - 空 replay 的 `response.completed`（`stopReason` 默认 `"error"`）
+ *
+ * 与 AIMappingError 的区别：recoverable 携带显式 stopReason，表示调用方应清理
+ * 中毒历史后重试；mapping 是协议级降级通道，通常不带 stopReason。
  */
-declare const WarningCode: {
-  /** replay fidelity 低于预期 */readonly REPLAY_FIDELITY_LOW: "REPLAY_FIDELITY_LOW"; /** usage 字段缺失 */
-  readonly USAGE_MISSING: "USAGE_MISSING"; /** billing 字段缺失 */
-  readonly BILLING_MISSING: "BILLING_MISSING"; /** billing 只能给估算值 */
-  readonly BILLING_ESTIMATED: "BILLING_ESTIMATED"; /** follow-up lookup 失败 */
-  readonly LOOKUP_FAILED: "LOOKUP_FAILED"; /** lookup 超时 */
-  readonly LOOKUP_TIMEOUT: "LOOKUP_TIMEOUT"; /** 流提前中断 */
-  readonly STREAM_INCOMPLETE: "STREAM_INCOMPLETE"; /** 能力降级 */
-  readonly CAPABILITY_DOWNGRADE: "CAPABILITY_DOWNGRADE"; /** 模拟流式 */
-  readonly SYNTHETIC_STREAM: "SYNTHETIC_STREAM"; /** 工具调用以批量方式到达（非 token 级流式） */
-  readonly TOOL_CALL_BATCHED: "TOOL_CALL_BATCHED";
+declare class AIRecoverableError extends AIError {
+  readonly stopReason: StopReason;
+  constructor(message: string, code: ErrorCode, stopReason?: StopReason);
+}
+//#endregion
+//#region src/stream/collect-stream.d.ts
+declare function collectStream(stream: AsyncIterable<AIStreamEvent>): Promise<AIResponse>;
+//#endregion
+//#region src/canonical/stop-reason.d.ts
+declare function mapStopReason(providerReason: string): StopReason;
+declare function mapReasoningVisibility(hasThinking: boolean, hasRedacted: boolean): ReasoningItem["visibility"];
+//#endregion
+//#region src/canonical/content.d.ts
+declare function textBlock(text: string): ContentBlock & {
+  type: "text";
 };
+declare function jsonBlock(json: unknown): ContentBlock & {
+  type: "json";
+};
+declare function imageBlock(imageUrl: string): ContentBlock & {
+  type: "image";
+};
+declare function opaqueBlock(payload: unknown): ContentBlock & {
+  type: "opaque";
+};
+/**
+ * 将单个 ContentBlock 转为纯文本。
+ * text 块直接返回文本，json 块序列化，其余返回空串。
+ */
+declare function blockToText(b: ContentBlock): string;
+/**
+ * 将 ContentBlock 数组拼接为纯文本，块间以换行符分隔。
+ */
+declare function contentBlocksToText(blocks: ContentBlock[]): string;
+/**
+ * 合并相邻 text content blocks（直接拼接、不插入分隔符）。
+ * 非 text block 保留边界。供 aggregator 与 StreamingItemSession 共用。
+ */
+declare function coalesceContentBlocks(blocks: readonly ContentBlock[]): ContentBlock[];
+//#endregion
+//#region src/canonical/items.d.ts
+declare function messageItem(content: ContentBlock[], overrides?: Partial<Omit<MessageItem, "type" | "content">>): MessageItem;
+declare function reasoningItem(content: ContentBlock[], visibility?: ReasoningItem["visibility"], id?: string): ReasoningItem;
+declare function toolCallItem(id: string, name: string, argumentsText: string): ToolCallItem;
+declare function toolResultItem(callId: string, toolName: string, outcome: ToolResultItem["outcome"], content: ContentBlock[]): ToolResultItem;
+declare function opaqueItem(source: OpaqueItem["source"], purpose: OpaqueItem["purpose"], payload: unknown, id?: string): OpaqueItem;
+declare function serverToolCallItem(id: string, tool: ServerToolCallItem["tool"], overrides?: Partial<Omit<ServerToolCallItem, "type" | "id" | "tool">>): ServerToolCallItem;
+declare function serverToolResultItem(callId: string, tool: string, outcome: ServerToolResultItem["outcome"], content: ContentBlock[], overrides?: Partial<Omit<ServerToolResultItem, "type" | "callId" | "tool" | "outcome" | "content">>): ServerToolResultItem;
+declare function serverToolDiscoveryItem(id: string, serverLabel: string, tools: ServerToolDiscoveryItem["tools"], overrides?: Partial<Omit<ServerToolDiscoveryItem, "type" | "id" | "tool" | "serverLabel" | "tools">>): ServerToolDiscoveryItem;
 //#endregion
-//#region src/core/event-factory.d.ts
+//#region src/canonical/replay.d.ts
+/**
+ * 从 output items 构建标准 replay items。
+ * 简单场景下 replay 与 output 一致。
+ * 复杂场景（需要 opaque continuation）由 adapter 自行扩展。
+ */
+declare function replayFromOutput(output: readonly OutputItem[]): ReplayItem[];
+/**
+ * 从 OutputItem 数组中提取所有 message 类型 item 的文本内容。
+ */
+declare function extractText(output: OutputItem[]): string;
+//#endregion
+//#region src/stream/event-factory.d.ts
 type EventFactoryBackend = {
-  kind: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
+  kind: AdapterKind;
   isSynthetic: boolean;
 };
 type EventFactoryState = {
@@ -360,7 +597,7 @@ type EventFactoryState = {
 };
 declare function createEventFactory(state: EventFactoryState): {
   responseStarted(model: string): ResponseStartedEvent;
-  responseWarning(message: string, code?: string): ResponseWarningEvent;
+  responseWarning(message: string, code?: WarningCodeValue): ResponseWarningEvent;
   responseAuxiliary(data: {
     usage?: Usage;
     billing?: BillingInfo;
@@ -372,13 +609,15 @@ declare function createEventFactory(state: EventFactoryState): {
     usage?: Usage;
     billing?: BillingInfo;
     auxiliary?: AuxiliaryInfo;
-    warnings?: string[];
+    warnings?: StreamWarning[];
     opaqueOutput?: OpaqueItem[];
     trace?: Partial<BackendTrace>;
   }): ResponseCompletedEvent;
   messageStarted(id: string): MessageStartedEvent;
   messageDelta(itemId: string, delta: ContentBlock): MessageDeltaEvent;
-  messageCompleted(itemId: string): MessageCompletedEvent;
+  messageCompleted(itemId: string, options?: {
+    citations?: Citation[];
+  }): MessageCompletedEvent;
   reasoningStarted(id: string, visibility: ReasoningItem["visibility"]): ReasoningStartedEvent;
   reasoningDelta(itemId: string, delta: ContentBlock): ReasoningDeltaEvent;
   reasoningCompleted(itemId: string): ReasoningCompletedEvent;
@@ -386,23 +625,26 @@ declare function createEventFactory(state: EventFactoryState): {
   toolCallDelta(itemId: string, delta: {
     argumentsText?: string;
   }): ToolCallDeltaEvent;
-  toolCallCompleted(itemId: string): ToolCallCompletedEvent; /** 返回当前已发出的 sequence 计数（用于断言） */
+  toolCallCompleted(itemId: string): ToolCallCompletedEvent;
+  serverToolStarted(id: string, tool: string, options?: {
+    name?: string;
+    serverLabel?: string;
+  }): ServerToolStartedEvent;
+  serverToolDelta(itemId: string, delta: {
+    argumentsText?: string;
+  }): ServerToolDeltaEvent;
+  serverToolCompleted(itemId: string, options?: {
+    status?: "completed" | "failed";
+    providerPayload?: unknown;
+  }): ServerToolCompletedEvent;
+  serverToolResultCompleted(item: ServerToolResultItem): ServerToolResultCompletedEvent;
+  serverToolDiscoveryCompleted(item: ServerToolDiscoveryItem): ServerToolDiscoveryCompletedEvent; /** 返回当前已发出的 sequence 计数（用于断言） */
   readonly sequence: number; /** 返回当前已记录的 warning 副本。 */
-  readonly warnings: string[];
+  readonly warnings: StreamWarning[];
 };
 type EventFactory = ReturnType<typeof createEventFactory>;
 //#endregion
-//#region src/core/aggregator.d.ts
-/**
- * 将事件数组聚合为 AIResponse。
- * 适用于测试和离线处理场景。
- */
-declare function aggregateEvents(events: readonly AIStreamEvent[]): AIResponse;
-//#endregion
-//#region src/core/collect-stream.d.ts
-declare function collectStream(stream: AsyncIterable<AIStreamEvent>): Promise<AIResponse>;
-//#endregion
-//#region src/helpers/auxiliary-collector.d.ts
+//#region src/provider/auxiliary-collector.d.ts
 type UsageSource = NonNullable<AuxiliaryInfo["usageSource"]>;
 type BillingSource = NonNullable<AuxiliaryInfo["billingSource"]>;
 type LookupResult = {
@@ -410,70 +652,26 @@ type LookupResult = {
   billing?: Partial<BillingInfo>;
   providerMetadata?: Record<string, unknown>;
 };
-declare class AuxiliaryCollector {
-  private usage;
-  private usageSource;
-  private billing;
-  private billingSource;
-  private providerMetadata;
-  private providerUsage;
-  private providerBilling;
-  private warnings;
-  private lookupAttempted;
-  /**
-   * 记录 usage 信息。
-   * 后调用的覆盖先调用的（优先级由调用方控制）。
-   */
-  recordUsage(usage: Partial<Usage>, source: UsageSource, raw?: unknown): this;
-  /**
-   * 记录 billing 信息。
-   * 后调用的覆盖先调用的。
-   */
-  recordBilling(billing: Partial<BillingInfo>, source: BillingSource, raw?: unknown): this;
-  /**
-   * 记录 provider 元数据（非 canonical 的 key-value 信息）。
-   */
-  recordMetadata(metadata: Record<string, unknown>): this;
-  /**
-   * 记录一条 warning。
-   */
-  recordWarning(message: string): this;
-  /**
-   * 执行一次有界 follow-up lookup。
-   * 最多调用一次；后续调用被忽略。
-   * lookup 失败（抛错）仅记录 warning，不传播异常。
-   */
-  tryLookup(lookupFn: () => Promise<LookupResult>, timeoutMs?: number): Promise<void>;
-  /**
-   * 构建最终的 usage / billing / auxiliary。
-   * 所有字段均为可选的 — 拿不到就不给。
-   */
-  build(): {
-    usage?: Usage;
-    billing?: BillingInfo;
-    auxiliary?: AuxiliaryInfo;
-    warnings?: string[];
-  };
-  /**
-   * 已使用的来源列表（用于 debugging）。
-   */
-  get sources(): {
-    usage?: UsageSource;
-    billing?: BillingSource;
-  };
-}
 //#endregion
-//#region src/helpers/adapter-auxiliary.d.ts
+//#region src/provider/auxiliary.d.ts
 type MaybePromise<T> = T | Promise<T>;
+/**
+ * 实验性：由调用方接线；库内 HTTP adapter **未**默认启用。
+ * 用于从 usage/auxiliary 派生 billing 的后处理钩子。
+ */
 type BillingPostprocessHook = (context: {
   request: NormalizedRequest;
   usage?: Usage;
   billing?: BillingInfo;
   auxiliary?: AuxiliaryInfo;
 }) => MaybePromise<Partial<BillingInfo> | undefined>;
+/**
+ * finalize 选项。`lookup` / `postprocessBilling` 为 experimental unused 扩展点：
+ * 生产 adapter 当前不传入；仅测试或宿主自定义 wiring 使用。
+ */
 type AuxiliaryFinalizeOptions = {
-  lookup?: () => Promise<LookupResult>;
-  lookupTimeoutMs?: number;
+  /** experimental：异步补查 usage/billing */lookup?: () => Promise<LookupResult>;
+  lookupTimeoutMs?: number; /** experimental：在尚无 billing 时派生估算账单 */
   postprocessBilling?: BillingPostprocessHook;
   postprocessBillingSource?: BillingSource;
 };
@@ -482,7 +680,7 @@ type AuxiliaryFinalizeResult = {
   usage?: Usage;
   billing?: BillingInfo;
   auxiliary?: AuxiliaryInfo;
-  warnings?: string[];
+  warnings?: StreamWarning[];
   metadataSources?: string[];
 };
 declare class AdapterAuxiliaryState {
@@ -496,32 +694,36 @@ declare class AdapterAuxiliaryState {
   finalize(factory: EventFactory, options?: AuxiliaryFinalizeOptions): Promise<AuxiliaryFinalizeResult>;
   private shouldAttemptLookup;
 }
-declare function emitMalformedStreamWarning(factory: EventFactory, options: {
-  count: number;
-  providerLabel: string;
-  transportLabel: string;
-}): AIStreamEvent | undefined;
 //#endregion
-//#region src/helpers/adapter-base.d.ts
+//#region src/provider/base.d.ts
 type ProviderResponse = unknown;
 /**
- * adapter 完成一轮处理后返回的最终结果。
- * 用于 buildResponse() 构建 AIResponse。
+ * adapter 完成一轮流处理后交给 emitStreamCompleted 的元数据。
+ * 不含 output/text/toolCalls — 那些由事件聚合得到。
  */
 type StreamResult = {
-  output: OutputItem[];
   replay: ReplayItem[];
   stopReason?: StopReason;
   usage?: Usage;
   billing?: BillingInfo;
   providerMetadata?: Record<string, unknown>;
   auxiliary?: Partial<AuxiliaryInfo>;
-  warnings?: string[];
+  warnings?: StreamWarning[];
   metadataSources?: string[];
   rawResponseId?: string;
 };
+/** response.completed 所需的完成元数据（无 output 账本） */
+type StreamCompletedPayload = {
+  replay: ReplayItem[];
+  stopReason?: StopReason;
+  usage?: Usage;
+  billing?: BillingInfo;
+  auxiliary?: AuxiliaryInfo;
+  warnings?: StreamWarning[] | undefined;
+  trace: Partial<BackendTrace>;
+};
 declare abstract class AdapterBase implements BackendAdapter {
-  abstract readonly kind: "chat-completions" | "messages" | "responses" | "ollama" | "mock";
+  abstract readonly kind: AdapterKind;
   abstract readonly isSyntheticStream: boolean;
   /**
    * stream 模板方法：
@@ -537,32 +739,133 @@ declare abstract class AdapterBase implements BackendAdapter {
    * 子类负责：
    * - 调用 provider
    * - 解析每个 chunk
-   * - 通过 factory 发射 item 事件
-   * - 构建 StreamResult
-   * - 发射 factory.responseCompleted(buildResponse(…))
+   * - 通过 StreamingItemSession / factory 发射 item 事件
+   * - 组装 StreamResult（replay + 元数据）
+   * - 发射 response.completed（通常经 emitStreamCompleted）
    */
   protected abstract runStream(providerRequest: ProviderResponse, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
   /**
-   * 从 StreamResult 构建完整 AIResponse。
-   * 子类可在返回前自定义覆盖。
+   * 从 StreamResult 构建 response.completed 载荷（无 output/text/toolCalls）。
    */
-  protected buildResponse(request: NormalizedRequest, result: StreamResult, _factory: EventFactory): AIResponse;
+  protected buildCompletedPayload(request: NormalizedRequest, result: StreamResult, factory: EventFactory): StreamCompletedPayload;
   /**
    * 统一 finalize auxiliary → response.completed。
-   * adapter 在调用前组装 output / replay / stopReason 等业务字段。
+   * adapter 在调用前组装 replay / stopReason 等业务字段（不含 output 账本）。
    */
   protected emitStreamCompleted(factory: EventFactory, request: NormalizedRequest, auxiliary: AdapterAuxiliaryState, result: StreamResult): AsyncIterable<AIStreamEvent>;
   protected createAuxiliaryState(request: NormalizedRequest): AdapterAuxiliaryState;
 }
 //#endregion
-//#region src/adapters/responses.d.ts
-type ResponsesAdapterOptions = {
-  apiKey: string;
-  baseUrl?: string; /** 可注入自定义 fetch 实现（用于测试／代理） */
-  fetch?: FetchFn; /** 额外请求头；后写覆盖内置 Authorization / Content-Type */
+//#region src/provider/transport/parser.d.ts
+type StreamSplitResult = {
+  items: string[];
+  rest: string;
+};
+type StreamParseResult<T> = {
+  status: "parsed";
+  value: T;
+} | {
+  status: "ignored";
+} | {
+  status: "malformed";
+};
+declare class IncrementalStreamParser<T> {
+  private readonly split;
+  private readonly parse;
+  /** Pending decoded fragments; compacted to at most one rest string after each consume. */
+  private chunks;
+  private readonly decoder;
+  constructor(split: (buffer: string, allowEOF: boolean) => StreamSplitResult, parse: (item: string) => StreamParseResult<T>);
+  feed(value: Uint8Array): {
+    items: T[];
+    malformed: number;
+  };
+  flush(): {
+    items: T[];
+    malformed: number;
+  };
+  getRemaining(): string;
+  private materializeBuffer;
+  private consume;
+}
+//#endregion
+//#region src/provider/transport/open-stream.d.ts
+type ProviderStreamBatch<T> = {
+  items: T[];
+  warnings: AIStreamEvent[];
+};
+//#endregion
+//#region src/provider/transport/run-json-stream.d.ts
+type ProviderJsonStreamOpenOptions = {
+  url: string;
+  headers: Record<string, string>;
+  body: unknown;
+};
+type ProviderJsonStreamBatchOptions<T> = {
+  parser: IncrementalStreamParser<T>;
+  providerLabel: string;
+  transportLabel: string;
+  incompleteMessage: string;
+};
+type ProviderJsonStreamCompleteOptions = {
+  /**
+   * 重复 complete 时：`warn` 发 DUPLICATE_FINISH（默认，对齐 chat/gemini/ollama）；
+   * `silent` 静默忽略（messages/responses 历史路径几乎不会触发）。
+   */
+  onDuplicate?: "warn" | "silent";
+};
+type ProviderJsonStreamSession = {
+  readonly auxiliary: AdapterAuxiliaryState;
+  readonly gate: {
+    readonly completed: boolean;
+    tryComplete(): boolean;
+  }; /** open 成功后填充的 response headers */
+  readonly headers: Headers | undefined;
+  open(options: ProviderJsonStreamOpenOptions): Promise<{
+    headers: Headers;
+  }>;
+  batches<T>(options: ProviderJsonStreamBatchOptions<T>): AsyncGenerator<ProviderStreamBatch<T>, void, undefined>;
+  complete(result: StreamResult, options?: ProviderJsonStreamCompleteOptions): AsyncIterable<AIStreamEvent>;
+};
+//#endregion
+//#region src/provider/http-adapter.d.ts
+/** 真实 HTTP adapter 的公共构造选项；apiKey 由各 adapter 收紧或保持可选。 */
+type HttpAdapterOptions = {
+  apiKey?: string;
+  baseUrl?: string; /** 可注入自定义 fetch 实现（测试 / 代理） */
+  fetch?: FetchFn; /** 额外请求头；后写覆盖内置鉴权 / Content-Type 等 */
   headers?: Record<string, string>; /** 额外 body 顶层字段；浅层合并，同名键可覆盖 */
   extraBody?: Record<string, unknown>;
 };
+type HttpAdapterDefaults = {
+  baseUrl: string;
+};
+/**
+ * HTTP adapter 薄基类：统一字段、默认值与 JSON 流 session。
+ */
+declare abstract class HttpAdapterBase extends AdapterBase {
+  protected apiKey: string | undefined;
+  protected baseUrl: string;
+  protected fetchFn: FetchFn;
+  protected headers: Record<string, string> | undefined;
+  protected extraBody: Record<string, unknown> | undefined;
+  constructor(options: HttpAdapterOptions, defaults: HttpAdapterDefaults);
+  /** 合并内置 headers 与构造期自定义 headers。 */
+  protected mergeHeaders(base: Record<string, string>): Record<string, string>;
+  /** 将构造期 extraBody 浅层合并进已构建 body。 */
+  protected withExtraBody<T extends object>(body: T): T;
+  /**
+   * 开启 JSON provider 流 session（auxiliary + gate + open/batches/complete）。
+   * 不自动 complete；调用方在业务 finish 点 `yield* session.complete(...)`。
+   */
+  protected beginJsonStream(factory: EventFactory, request: NormalizedRequest): ProviderJsonStreamSession;
+}
+//#endregion
+//#region src/adapters/responses/types.d.ts
+/** apiKey 必填；默认 baseUrl https://api.openai.com/v1 */
+type ResponsesAdapterOptions = HttpAdapterOptions & {
+  apiKey: string;
+};
 type ResponsesAPIRequest = {
   model: string;
   input: ResponsesInputItem[];
@@ -636,36 +939,83 @@ type ResponsesItemReference = {
   type: "item_reference";
   id: string;
 };
-type ResponsesInputItem = ResponsesEasyMessage | ResponsesFunctionCall | ResponsesFunctionCallOutput | ResponsesReasoningInput | ResponsesItemReference;
-type ResponsesTool = {
+/** compact 输出中的加密 compaction 项（可原样回传为 input） */
+type ResponsesCompactionInput = {
+  type: "compaction";
+  id?: string;
+  encrypted_content?: string;
+  [key: string]: unknown;
+};
+/**
+ * 保真透传的 wire item（compact window 中可能含 message/function_call/compaction 等）。
+ * 用于 compacted_window 原样展开，不在此做严格 shape 收窄。
+ */
+type ResponsesWirePassthroughItem = {
+  type: string;
+  [key: string]: unknown;
+};
+type ResponsesInputItem = ResponsesEasyMessage | ResponsesFunctionCall | ResponsesFunctionCallOutput | ResponsesReasoningInput | ResponsesItemReference | ResponsesCompactionInput | ResponsesWirePassthroughItem;
+type ResponsesFunctionTool = {
   type: "function";
   name: string;
   description?: string;
   parameters: Record<string, unknown>;
   strict?: boolean | null;
 };
-declare class ResponsesAdapter extends AdapterBase {
+type ResponsesWebSearchTool = {
+  type: "web_search";
+  filters?: {
+    allowed_domains?: string[];
+    blocked_domains?: string[];
+  };
+  user_location?: {
+    type: "approximate";
+    country?: string;
+    city?: string;
+    region?: string;
+    timezone?: string;
+  };
+  search_context_size?: "low" | "medium" | "high";
+};
+type ResponsesCodeInterpreterTool = {
+  type: "code_interpreter";
+  container: string | {
+    type: "auto";
+    memory_limit?: "1g" | "4g" | "16g" | "64g";
+    file_ids?: string[];
+  };
+};
+type ResponsesMcpTool = {
+  type: "mcp";
+  server_label: string;
+  server_url: string;
+  server_description?: string;
+  authorization?: string;
+  allowed_tools?: string[];
+  require_approval: "never";
+};
+/** Responses API tools 联合：客户端 function + 内置 server tools */
+type ResponsesTool = ResponsesFunctionTool | ResponsesWebSearchTool | ResponsesCodeInterpreterTool | ResponsesMcpTool;
+//#endregion
+//#region src/adapters/responses/adapter.d.ts
+declare class ResponsesAdapter extends HttpAdapterBase implements ContextCompressCapable {
   readonly kind: "responses";
   readonly isSyntheticStream = false;
-  private apiKey;
-  private baseUrl;
-  private fetchFn;
-  private headers;
-  private extraBody;
   constructor(options: ResponsesAdapterOptions);
   protected buildRequest(request: NormalizedRequest): ResponsesAPIRequest;
+  /**
+   * 原生上下文压缩：POST /responses/compact。
+   * 结果以单个 opaque(kind=compacted_window) 回传；调用方用 replay 替换旧 transcript。
+   */
+  compress(request: CompressRequest): Promise<CompressResult>;
   protected runStream(providerRequest: ResponsesAPIRequest, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
-  private inferStopReason;
 }
 //#endregion
-//#region src/adapters/messages.d.ts
-type MessagesAdapterOptions = {
-  apiKey: string;
+//#region src/adapters/messages/types.d.ts
+/** apiKey 必填；默认 baseUrl https://api.anthropic.com/v1 */
+type MessagesAdapterOptions = HttpAdapterOptions & {
+  apiKey: string; /** Anthropic API 版本头，默认 2023-06-01 */
   apiVersion?: string;
-  baseUrl?: string; /** 可注入自定义 fetch 实现（用于测试／代理） */
-  fetch?: FetchFn; /** 额外请求头；后写覆盖内置 x-api-key / Content-Type / anthropic-version */
-  headers?: Record<string, string>; /** 额外 body 顶层字段；浅层合并，同名键可覆盖 */
-  extraBody?: Record<string, unknown>;
 };
 type MessagesAPIRequest = {
   model: string;
@@ -718,27 +1068,21 @@ type MessagesAPITool = {
   description?: string;
   input_schema: Record<string, unknown>;
 };
-declare class MessagesAdapter extends AdapterBase {
+//#endregion
+//#region src/adapters/messages/adapter.d.ts
+declare class MessagesAdapter extends HttpAdapterBase {
   readonly kind: "messages";
   readonly isSyntheticStream = false;
-  private apiKey;
   private apiVersion;
-  private baseUrl;
-  private fetchFn;
-  private headers;
-  private extraBody;
   constructor(options: MessagesAdapterOptions);
   protected buildRequest(request: NormalizedRequest): MessagesAPIRequest;
   protected runStream(providerRequest: MessagesAPIRequest, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
 }
 //#endregion
-//#region src/adapters/chat-completions.d.ts
-type ChatCompletionsAdapterOptions = {
+//#region src/adapters/chat-completions/types.d.ts
+/** apiKey 必填；默认 baseUrl https://api.openai.com/v1 */
+type ChatCompletionsAdapterOptions = HttpAdapterOptions & {
   apiKey: string;
-  baseUrl?: string;
-  fetch?: FetchFn; /** 额外请求头；后写覆盖内置 Authorization / Content-Type */
-  headers?: Record<string, string>; /** 额外 body 顶层字段；浅层合并，同名键可覆盖 */
-  extraBody?: Record<string, unknown>;
 };
 type ChatRequest = {
   model: string;
@@ -781,27 +1125,21 @@ type ChatTool = {
     parameters: Record<string, unknown>;
   };
 };
-declare class ChatCompletionsAdapter extends AdapterBase {
+//#endregion
+//#region src/adapters/chat-completions/adapter.d.ts
+declare class ChatCompletionsAdapter extends HttpAdapterBase {
   readonly kind: "chat-completions";
   readonly isSyntheticStream = false;
-  private apiKey;
-  private baseUrl;
-  private fetchFn;
-  private headers;
-  private extraBody;
   constructor(options: ChatCompletionsAdapterOptions);
   protected buildRequest(request: NormalizedRequest): ChatRequest;
   protected runStream(providerRequest: ChatRequest, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
 }
 //#endregion
-//#region src/adapters/ollama.d.ts
-type OllamaAdapterOptions = {
-  /** Ollama 服务地址，默认 http://localhost:11434 */baseUrl?: string; /** 可选 API key（用于需要认证的代理场景） */
-  apiKey?: string; /** 可注入自定义 fetch 实现 */
-  fetch?: FetchFn; /** 额外请求头；后写覆盖内置 Content-Type / Authorization */
-  headers?: Record<string, string>; /** 额外 body 顶层字段；浅层合并，同名键可覆盖 */
-  extraBody?: Record<string, unknown>;
-};
+//#region src/adapters/ollama/types.d.ts
+/**
+ * apiKey 可选（代理鉴权）；默认 baseUrl http://localhost:11434
+ */
+type OllamaAdapterOptions = HttpAdapterOptions;
 type OllamaChatRequest = {
   model: string;
   messages: OllamaMessage[];
@@ -834,20 +1172,86 @@ type OllamaTool = {
     parameters: Record<string, unknown>;
   };
 };
-declare class OllamaAdapter extends AdapterBase {
+//#endregion
+//#region src/adapters/ollama/adapter.d.ts
+declare class OllamaAdapter extends HttpAdapterBase {
   readonly kind: "ollama";
   readonly isSyntheticStream = false;
-  private baseUrl;
-  private apiKey;
-  private fetchFn;
-  private headers;
-  private extraBody;
   constructor(options?: OllamaAdapterOptions);
   protected buildRequest(request: NormalizedRequest): OllamaChatRequest;
   protected runStream(providerRequest: OllamaChatRequest, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
 }
 //#endregion
-//#region src/adapters/mock.d.ts
+//#region src/adapters/gemini/types.d.ts
+/** apiKey 必填；默认 baseUrl https://generativelanguage.googleapis.com/v1beta */
+type GeminiAdapterOptions = HttpAdapterOptions & {
+  apiKey: string;
+};
+type GeminiPart = {
+  text?: string;
+  thought?: boolean;
+  thoughtSignature?: string;
+  functionCall?: {
+    name: string;
+    args?: Record<string, unknown>;
+    id?: string;
+  };
+  functionResponse?: {
+    name: string;
+    response?: Record<string, unknown>;
+    id?: string;
+  };
+  [key: string]: unknown;
+};
+type GeminiContent = {
+  role: "user" | "model";
+  parts: GeminiPart[];
+};
+type GeminiFunctionDeclaration = {
+  name: string;
+  description?: string;
+  parameters: Record<string, unknown>;
+};
+type GeminiTool = {
+  functionDeclarations: GeminiFunctionDeclaration[];
+};
+type GeminiFunctionCallingConfig = {
+  mode: "AUTO" | "ANY" | "NONE";
+  allowedFunctionNames?: string[];
+};
+type GeminiGenerateContentRequest = {
+  contents: GeminiContent[];
+  systemInstruction?: {
+    parts: Array<{
+      text: string;
+    }>;
+  };
+  tools?: GeminiTool[];
+  toolConfig?: {
+    functionCallingConfig: GeminiFunctionCallingConfig;
+  };
+  generationConfig?: {
+    temperature?: number;
+    maxOutputTokens?: number;
+    thinkingConfig?: {
+      includeThoughts: false;
+    } | {
+      includeThoughts: true;
+      thinkingLevel: "MINIMAL" | "LOW" | "MEDIUM" | "HIGH";
+    };
+  };
+};
+//#endregion
+//#region src/adapters/gemini/adapter.d.ts
+declare class GeminiAdapter extends HttpAdapterBase {
+  readonly kind: "gemini";
+  readonly isSyntheticStream = false;
+  constructor(options: GeminiAdapterOptions);
+  protected buildRequest(request: NormalizedRequest): GeminiGenerateContentRequest;
+  protected runStream(providerRequest: GeminiGenerateContentRequest, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
+}
+//#endregion
+//#region src/adapters/mock/types.d.ts
 type MockInputExpectation = {
   type: InputItem["type"];
   id?: string;
@@ -855,7 +1259,7 @@ type MockInputExpectation = {
   name?: string;
   toolName?: string;
   callId?: string;
-  outcome?: ToolResultItem["outcome"];
+  outcome?: ToolResultItem["outcome"] | ServerToolResultItem["outcome"];
   visibility?: Extract<InputItem, {
     type: "reasoning";
   }>["visibility"];
@@ -874,6 +1278,7 @@ type MockRequestExpectation = {
   requireReplayFromPreviousTurn?: boolean;
   requireToolResultsForPendingCalls?: boolean;
   tools?: "ignore" | "present" | "absent";
+  serverTools?: "ignore" | "present" | "absent";
   toolChoice?: "ignore" | "present" | "absent";
   items?: MockInputExpectation[];
 };
@@ -920,8 +1325,29 @@ type MockMessageStep = {
   type: "message";
   id?: string;
   content: string | ContentBlock[];
+  citations?: Citation[];
   stream?: MockTextStreamOptions | false;
 };
+type MockServerToolCallStep = {
+  type: "server_tool_call";
+  id: string;
+  tool: ServerToolCallItem["tool"];
+  name?: string;
+  argumentsText?: string;
+  serverLabel?: string;
+  status?: ServerToolCallItem["status"];
+  providerPayload?: unknown;
+  streamArguments?: boolean;
+  stream?: MockTextStreamOptions | false;
+};
+type MockServerToolResultStep = {
+  type: "server_tool_result";
+  item: ServerToolResultItem;
+};
+type MockServerToolDiscoveryStep = {
+  type: "server_tool_discovery";
+  item: ServerToolDiscoveryItem;
+};
 type MockReasoningStep = {
   type: "reasoning";
   id?: string;
@@ -955,7 +1381,7 @@ type MockCompleteStep = {
   auxiliary?: Partial<AuxiliaryInfo>;
   providerMetadata?: Record<string, unknown>;
   rawResponseId?: string;
-  warnings?: string[];
+  warnings?: StreamWarning[];
 };
 type MockErrorStep = {
   type: "error";
@@ -971,13 +1397,16 @@ type MockThrowStep = {
   type: "throw";
   error: string | Error;
 };
-type MockStep = MockWarningStep | MockAuxiliaryStep | MockMessageStep | MockReasoningStep | MockToolCallStep | MockOutputStep | MockCompleteStep | MockErrorStep | MockInterruptStep | MockThrowStep;
+type MockStep = MockWarningStep | MockAuxiliaryStep | MockMessageStep | MockReasoningStep | MockToolCallStep | MockServerToolCallStep | MockServerToolResultStep | MockServerToolDiscoveryStep | MockOutputStep | MockCompleteStep | MockErrorStep | MockInterruptStep | MockThrowStep;
 type MockHandler = (request: NormalizedRequest, context: MockHandlerContext) => AsyncIterable<MockStep>;
 type MockHandlerSource = Iterable<MockStep> | AsyncIterable<MockStep>;
 type MockStaticHandler = (request: NormalizedRequest, context: MockHandlerContext) => MockHandlerSource | Promise<MockHandlerSource>;
+/** Mock compress 夹具；未配置时 compress() 抛 MOCK_COMPRESS_NOT_CONFIGURED */
+type MockCompressHandler = (request: CompressRequest) => CompressResult | Promise<CompressResult>;
 type MockAdapterOptions = {
   handler: MockHandler;
-  providerMetadata?: Record<string, unknown>;
+  providerMetadata?: Record<string, unknown>; /** 可选：实现 ContextCompressCapable 供 compress 契约测试 */
+  compressHandler?: MockCompressHandler;
 };
 type MockProviderRequest = {
   request: NormalizedRequest;
@@ -985,326 +1414,36 @@ type MockProviderRequest = {
   turnIndex: number;
   remainingPendingToolCalls: ToolCallItem[];
 };
-declare function assertMockRequest(request: NormalizedRequest, expectation: MockRequestExpectation, context: MockHandlerContext): void;
-declare class MockAdapter extends AdapterBase {
+//#endregion
+//#region src/adapters/mock/adapter.d.ts
+declare class MockAdapter extends AdapterBase implements ContextCompressCapable {
   readonly kind: "mock";
   readonly isSyntheticStream = true;
   private readonly handler;
   private readonly providerMetadata?;
+  private readonly compressHandler?;
   private cursor;
   private previousReplay;
   private pendingToolCalls;
   private history;
   private activeStream;
   constructor(options: MockAdapterOptions);
+  /**
+   * 可选压缩夹具：需构造时提供 compressHandler，否则抛 MOCK_COMPRESS_NOT_CONFIGURED。
+   * 始终存在 compress 方法以便 supportsContextCompress(mock) === true。
+   */
+  compress(request: CompressRequest): Promise<CompressResult>;
   protected buildRequest(request: NormalizedRequest): Promise<MockProviderRequest>;
   protected runStream(providerRequest: unknown, factory: EventFactory, request: NormalizedRequest): AsyncIterable<AIStreamEvent>;
   private finalizeTurn;
   private buildHandlerContext;
 }
-declare function withMockStreaming(handler: MockStaticHandler, options: MockTextStreamOptions): MockHandler;
 //#endregion
-//#region src/helpers/mapping.d.ts
-declare function mapStopReason(providerReason: string): StopReason;
-declare function mapReasoningVisibility(hasThinking: boolean, hasRedacted: boolean): ReasoningItem["visibility"];
-declare function textBlock(text: string): ContentBlock & {
-  type: "text";
-};
-declare function jsonBlock(json: unknown): ContentBlock & {
-  type: "json";
-};
-declare function imageBlock(imageUrl: string): ContentBlock & {
-  type: "image";
-};
-declare function opaqueBlock(payload: unknown): ContentBlock & {
-  type: "opaque";
-};
-declare function messageItem(content: ContentBlock[], overrides?: Partial<Omit<MessageItem, "type" | "content">>): MessageItem;
-declare function reasoningItem(content: ContentBlock[], visibility?: ReasoningItem["visibility"], id?: string): ReasoningItem;
-declare function toolCallItem(id: string, name: string, argumentsText: string): ToolCallItem;
-declare function toolResultItem(callId: string, toolName: string, outcome: ToolResultItem["outcome"], content: ContentBlock[]): ToolResultItem;
-declare function opaqueItem(source: OpaqueItem["source"], purpose: OpaqueItem["purpose"], payload: unknown, id?: string): OpaqueItem;
-/**
- * 从 output items 构建标准 replay items。
- * 简单场景下 replay 与 output 一致。
- * 复杂场景（需要 opaque continuation）由 adapter 自行扩展。
- */
-declare function replayFromOutput(output: readonly OutputItem[]): ReplayItem[];
-/**
- * 将单个 ContentBlock 转为纯文本。
- * text 块直接返回文本，json 块序列化，其余返回空串。
- */
-declare function blockToText(b: ContentBlock): string;
-/**
- * 将 ContentBlock 数组拼接为纯文本，块间以换行符分隔。
- */
-declare function contentBlocksToText(blocks: ContentBlock[]): string;
-/**
- * 从 OutputItem 数组中提取所有 message 类型 item 的文本内容。
- */
-declare function extractText(output: OutputItem[]): string;
-//#endregion
-//#region src/helpers/synthetic-stream.d.ts
-type SyntheticStreamOptions = {
-  model: string;
-  responseId: string;
-  backend: {
-    kind: "chat-completions" | "messages" | "responses" | "mock";
-  };
-  output: OutputItem[];
-  replay?: ReplayItem[];
-  stopReason?: StopReason;
-  usage?: Usage;
-  billing?: BillingInfo;
-  providerMetadata?: Record<string, unknown>;
-  rawResponseId?: string;
-  warnings?: string[];
-};
-/**
- * 将已解析的 output items 包装为完整规范事件流。
- *
- * 用法示例（在 adapter 的 runStream 中）：
- * ```ts
- * const result = parseNonStreamingResponse(data);
- * yield* syntheticStream({
- *   model: request.model,
- *   responseId: request.requestId,
- *   backend: { kind: "chat-completions" },
- *   output: result.output,
- *   stopReason: result.stopReason,
- *   usage: result.usage,
- * });
- * ```
- */
-declare function syntheticStream(options: SyntheticStreamOptions): AsyncIterable<AIStreamEvent>;
-//#endregion
-//#region src/helpers/usage-mapping.d.ts
-/** OpenAI Chat Completions `usage` */
-declare function usageFromChatCompletions(raw: {
-  prompt_tokens?: number;
-  completion_tokens?: number;
-  total_tokens?: number;
-  prompt_tokens_details?: {
-    cached_tokens?: number;
-    [key: string]: unknown;
-  };
-  completion_tokens_details?: {
-    reasoning_tokens?: number;
-    [key: string]: unknown;
-  };
-}): Partial<Usage>;
-/** OpenAI Responses API `usage` */
-declare function usageFromOpenAIResponses(raw: {
-  input_tokens?: number;
-  output_tokens?: number;
-  total_tokens?: number;
-  input_tokens_details?: {
-    cached_tokens?: number;
-    [key: string]: unknown;
-  };
-  output_tokens_details?: {
-    reasoning_tokens?: number;
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}): Partial<Usage>;
-/** Anthropic Messages `usage`（message_start / message_delta） */
-declare function usageFromAnthropicMessages(raw: {
-  input_tokens?: number;
-  output_tokens?: number;
-  cache_creation_input_tokens?: number;
-  cache_read_input_tokens?: number;
-  [key: string]: unknown;
-}): Partial<Usage>;
-/** Ollama 流式 chunk */
-declare function usageFromOllama(raw: {
-  prompt_eval_count?: number;
-  eval_count?: number;
-}): Partial<Usage>;
-//#endregion
-//#region src/helpers/adapter-security.d.ts
-declare const MAX_OPAQUE_PAYLOAD_BYTES = 65536;
-declare const MAX_OPAQUE_JSON_DEPTH = 8;
-declare const PROVIDER_ERROR_MESSAGE_MAX_LEN = 500;
-declare const PROVIDER_ERROR_RAW_BODY_THRESHOLD = 200;
-type OpaqueEnvelopeResult = {
-  ok: true;
-} | {
-  ok: false;
-  reason: string;
-};
-/** 测量 JSON 值嵌套深度（对象/数组）；循环引用按已访问节点深度计。 */
-declare function measureJsonDepth(value: unknown, seen?: WeakSet<object>): number;
-/**
- * Opaque replay 通用 envelope：必须是 object、体积 ≤ 64KB、深度 ≤ 8。
- * 不校验 adapter 专用字段形状。
- */
-declare function validateOpaqueReplayEnvelope(payload: unknown): OpaqueEnvelopeResult;
-/** envelope 失败时抛 AIRequestError。 */
-declare function assertOpaqueReplayEnvelope(payload: unknown): void;
-/**
- * 从 provider HTTP 错误 body 提取可对外暴露的短消息，避免泄漏 HTML / 内部路径等。
- */
-declare function extractProviderErrorMessage(body: string, status: number): string;
-/** 统一构造脱敏后的 AIProviderError。 */
-declare function providerHttpError(status: number, body: string): AIProviderError;
-//#endregion
-//#region src/helpers/incremental-stream-parser.d.ts
-type StreamSplitResult = {
-  items: string[];
-  rest: string;
-};
-type StreamParseResult<T> = {
-  status: "parsed";
-  value: T;
-} | {
-  status: "ignored";
-} | {
-  status: "malformed";
-};
-declare class IncrementalStreamParser<T> {
-  private readonly split;
-  private readonly parse;
-  private buffer;
-  private readonly decoder;
-  constructor(split: (buffer: string, allowEOF: boolean) => StreamSplitResult, parse: (item: string) => StreamParseResult<T>);
-  feed(value: Uint8Array): {
-    items: T[];
-    malformed: number;
-  };
-  flush(): {
-    items: T[];
-    malformed: number;
-  };
-  getRemaining(): string;
-  private consume;
-}
-declare function splitLines(buffer: string, allowEOF: boolean): StreamSplitResult;
-declare function splitSSEFrames(buffer: string, allowEOF: boolean): StreamSplitResult;
-type SseJsonEvent = {
-  type: string;
-  data: unknown;
-};
-/** 解析标准 SSE frame（event: + data:），用于 Messages / Responses。 */
-declare function parseSseJsonFrame(frame: string): StreamParseResult<SseJsonEvent>;
-declare function createSseJsonParser<T extends SseJsonEvent = SseJsonEvent>(): IncrementalStreamParser<T>;
-/** OpenAI Chat Completions 简化 SSE：仅 `data: ...` 行，忽略 `[DONE]`。 */
-declare function parseChatCompletionsDataLine(item: string): StreamParseResult<unknown>;
-declare function createChatCompletionsSseParser<T>(): IncrementalStreamParser<T>;
-/** NDJSON 行解析（Ollama 等）：空行忽略，JSON 失败为 malformed。 */
-declare function createNdjsonLineParser<T>(isValid: (value: unknown) => value is T): IncrementalStreamParser<T>;
-//#endregion
-//#region src/helpers/provider-stream.d.ts
-type OpenProviderJsonStreamOptions = {
-  fetchFn: FetchFn;
-  url: string;
-  headers: Record<string, string>;
-  body: unknown;
-  signal?: AbortSignal;
-};
-type OpenedProviderStream = {
-  reader: ReadableStreamDefaultReader<Uint8Array>;
-  headers: Headers;
-};
-/** POST JSON 并返回可读 body reader + response headers；统一网络/HTTP/空 body 错误。 */
-declare function openProviderJsonStream(options: OpenProviderJsonStreamOptions): Promise<OpenedProviderStream>;
-type ProviderStreamBatchOptions<T> = {
-  reader: ReadableStreamDefaultReader<Uint8Array>;
-  parser: IncrementalStreamParser<T>;
-  factory: EventFactory;
-  providerLabel: string;
-  transportLabel: string;
-  incompleteMessage: string;
-};
-type ProviderStreamBatch<T> = {
-  items: T[];
-  warnings: AIStreamEvent[];
-};
-/**
- * 读取并解析 provider 流。
- * 每个 batch 携带本轮解析出的 items 与（可选）malformed / incomplete warning。
- * 调用方应 `for await` 消费完毕；reader 在迭代结束时 cancel/release。
- */
-declare function iterateProviderStreamBatches<T>(options: ProviderStreamBatchOptions<T>): AsyncGenerator<ProviderStreamBatch<T>, void, undefined>;
-/** 一次性 complete 守卫：首次成功，后续返回 false。 */
-declare function createCompletionGate(): {
-  readonly completed: boolean;
-  tryComplete(): boolean;
-};
-//#endregion
-//#region src/helpers/provider-request-options.d.ts
-/**
- * Provider 请求 headers / body 扩展合并
- *
- * 供真实后端 adapter 构造选项 `headers` / `extraBody` 使用：
- * - headers：内置鉴权头为基，自定义后写覆盖
- * - extraBody：已构建 body 为基，额外字段浅层 spread，同名顶层键可覆盖
- */
-/** 合并内置 headers 与自定义 headers；自定义后写覆盖同名键。 */
-declare function mergeProviderHeaders(base: Record<string, string>, custom?: Record<string, string>): Record<string, string>;
-/**
- * 将构造期 extraBody 浅层合并到已构建的 provider body。
- * 无 extraBody 时原样返回；有则允许覆盖同名顶层键。
- */
-declare function applyExtraBody<T extends object>(body: T, extraBody?: Record<string, unknown>): T;
-//#endregion
-//#region src/helpers/reasoning-level.d.ts
-declare const REASONING_LEVELS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
-declare const REASONING_LEVEL_SET: ReadonlySet<string>;
-type OpenAIReasoningEffort = ReasoningLevel;
-type MessagesThinkingConfig = {
-  type: "disabled";
-} | {
-  type: "enabled";
-  budget_tokens: number;
-};
-type OllamaThinkValue = false | "low" | "medium" | "high";
-/** 若 level 不在 supported 集合内则抛 AIRequestError。 */
-declare function assertSupportedReasoningLevel(level: ReasoningLevel, supported: ReadonlySet<ReasoningLevel>, adapterKind: string): void;
-/** Responses API：`reasoning: { effort }` */
-declare function mapResponsesReasoning(level: ReasoningLevel): {
-  effort: OpenAIReasoningEffort;
-};
-/** Chat Completions：顶层 `reasoning_effort` */
-declare function mapChatCompletionsReasoningEffort(level: ReasoningLevel): OpenAIReasoningEffort;
-/**
- * Messages thinking budget。
- * 基于 maxTokens 按比例推导，clamp 到 [1024, max(1024, maxTokens - 1)]，
- * 满足 Anthropic budget_tokens < max_tokens。
- */
-declare function mapMessagesThinkingBudget(level: Exclude<ReasoningLevel, "none">, maxTokens: number): number;
-/** Messages API：`thinking` 字段 */
-declare function mapMessagesThinking(level: ReasoningLevel, maxTokens: number): MessagesThinkingConfig;
-/** Ollama：`think` 字段；minimal/xhigh/max 不支持 */
-declare function mapOllamaThink(level: ReasoningLevel): OllamaThinkValue;
+//#region src/adapters/mock/expectations.d.ts
+declare function assertMockRequest(request: NormalizedRequest, expectation: MockRequestExpectation, context: MockHandlerContext): void;
 //#endregion
-//#region src/helpers/request-mapper.d.ts
-declare class NormalizedRequestMapper {
-  readonly kind: string;
-  constructor(kind: string);
-  mapInstructions(instructions: string | InstructionBlock[]): string;
-  ensureTextBlocks(blocks: ContentBlock[], field: string): ContentBlock[];
-  ensureReasoningBlocks(blocks: ContentBlock[], field: string): Array<Extract<ContentBlock, {
-    type: "text";
-  }>>;
-  /** ensureTextBlocks + contentBlocksToText 的常见组合。 */
-  textFromBlocks(blocks: ContentBlock[], field: string): string;
-  parseToolArguments(item: ToolCallItem): Record<string, unknown>;
-  rollbackTrailingAssistantMessages<T extends {
-    role: string;
-  }>(messages: T[]): void;
-  mapToolsIfPresent<T>(tools: ToolDefinition[] | undefined, map: (tool: ToolDefinition) => T): T[] | undefined;
-  /**
-   * 将 canonical toolChoice 映射为 provider 形状。
-   * 返回 undefined 表示调用方无需写入 body 字段。
-   */
-  mapToolChoice<T>(toolChoice: ToolChoice | undefined, mappers: {
-    auto: T;
-    none: T;
-    tool: (name: string) => T;
-  }): T | undefined;
-  private ensureBlocks;
-}
+//#region src/adapters/mock/streaming.d.ts
+declare function withMockStreaming(handler: MockStaticHandler, options: MockTextStreamOptions): MockHandler;
 //#endregion
-export { type AIClient, AIError, AIMappingError, AIProviderError, type AIRequest, AIRequestError, type AIResponse, AIStreamError, type AIStreamEvent, AdapterAuxiliaryState, AdapterBase, AuxiliaryCollector, type AuxiliaryFinalizeOptions, type AuxiliaryFinalizeResult, type AuxiliaryInfo, type BackendAdapter, type BackendTrace, type BillingInfo, type BillingPostprocessHook, type BillingSource, ChatCompletionsAdapter, type ChatCompletionsAdapterOptions, type ContentBlock, type CreateAIClientOptions, type EventFactory, type EventFactoryBackend, type EventFactoryState, type FetchFn, type IncludeSettings, IncrementalStreamParser, type InputItem, type InstructionBlock, type JsonContentBlock, type LookupResult, MAX_OPAQUE_JSON_DEPTH, MAX_OPAQUE_PAYLOAD_BYTES, type MessageCompletedEvent, type MessageDeltaEvent, type MessageItem, type MessageStartedEvent, MessagesAdapter, type MessagesAdapterOptions, type MessagesThinkingConfig, MockAdapter, type MockAdapterOptions, type MockAuxiliaryStep, type MockCompleteStep, type MockErrorStep, type MockHandler, type MockHandlerContext, type MockHistoryRecord, type MockInputExpectation, type MockInterruptStep, type MockMessageStep, type MockOutputStep, type MockReasoningStep, type MockRequestExpectation, type MockStaticHandler, type MockStep, type MockTextStreamOptions, type MockThrowStep, type MockToolCallStep, type MockWarningStep, type NormalizeOptions, type NormalizedRequest, NormalizedRequestMapper, OllamaAdapter, type OllamaAdapterOptions, type OllamaThinkValue, type OpaqueEnvelopeResult, type OpaqueItem, type OpenAIReasoningEffort, type OpenProviderJsonStreamOptions, type OpenedProviderStream, type OutputItem, PROVIDER_ERROR_MESSAGE_MAX_LEN, PROVIDER_ERROR_RAW_BODY_THRESHOLD, type ProviderStreamBatch, type ProviderStreamBatchOptions, 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 SseJsonEvent, type StopReason, type StreamEventBase, type StreamParseResult, type StreamResult, type StreamSplitResult, type SyntheticStreamOptions, type TextContentBlock, type ToolCallCompletedEvent, type ToolCallDeltaEvent, type ToolCallItem, type ToolCallStartedEvent, type ToolChoice, type ToolDefinition, type ToolResultItem, type Usage, type UsageSource, type ValidationIssue, WarningCode, aggregateEvents, applyExtraBody, assertMockRequest, assertOpaqueReplayEnvelope, assertSupportedReasoningLevel, assertValidRequest, blockToText, collectStream, contentBlocksToText, createAIClient, createChatCompletionsSseParser, createCompletionGate, createEventFactory, createNdjsonLineParser, createSseJsonParser, emitMalformedStreamWarning, extractProviderErrorMessage, extractText, imageBlock, iterateProviderStreamBatches, jsonBlock, mapChatCompletionsReasoningEffort, mapMessagesThinking, mapMessagesThinkingBudget, mapOllamaThink, mapReasoningVisibility, mapResponsesReasoning, mapStopReason, measureJsonDepth, mergeProviderHeaders, messageItem, normalizeRequest, opaqueBlock, opaqueItem, openProviderJsonStream, parseChatCompletionsDataLine, parseSseJsonFrame, providerHttpError, reasoningItem, replayFromOutput, splitLines, splitSSEFrames, syntheticStream, textBlock, toolCallItem, toolResultItem, usageFromAnthropicMessages, usageFromChatCompletions, usageFromOllama, usageFromOpenAIResponses, validateOpaqueReplayEnvelope, validateRequest, 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, 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, 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