@n0ts123/mcplink-core 0.0.12 → 0.0.14

package/dist/index.d.ts

@@ -1,131 +1,36 @@
-import { LanguageModel } from 'ai';
-export { createOpenAI } from '@ai-sdk/openai';
-export { createAnthropic } from '@ai-sdk/anthropic';
-
-/** 文本内容部分 */
-interface TextPart {
-    type: 'text';
-    text: string;
-}
-/** 图片内容部分 */
-interface ImagePart {
-    type: 'image';
-    /** 图片 URL 或 base64 数据 */
-    image: string | URL;
-    /** 可选的 MIME 类型 */
-    mimeType?: string;
-}
-/** 文件内容部分 */
-interface FilePart {
-    type: 'file';
-    /** 文件 URL 或 base64 数据 */
-    data: string | URL;
-    /** MIME 类型 */
-    mimeType: string;
-}
-/** 多模态消息内容部分 */
-type MessageContentPart = TextPart | ImagePart | FilePart;
-/** 用户消息类型 - 支持字符串或多模态数组 */
-type UserMessage = string | MessageContentPart[];
-/** MCP 服务器配置 - stdio 模式 */
-interface MCPServerConfigStdio {
-    type?: 'stdio';
-    /** 启动命令 */
-    command: string;
-    /** 命令参数 */
-    args?: string[];
-    /** 环境变量 */
-    env?: Record<string, string>;
-}
-/** MCP 服务器配置 - Streamable HTTP 模式 */
-interface MCPServerConfigStreamableHTTP {
-    type: 'streamable-http';
-    /** HTTP 服务地址 */
-    url: string;
-    /** 请求头 */
-    headers?: Record<string, string>;
-}
-/** MCP 服务器配置 */
-type MCPServerConfig = MCPServerConfigStdio | MCPServerConfigStreamableHTTP;
 /**
- * 即时结果匹配器
- * 用于检测 MCP 工具返回的特殊格式数据
- * 当工具返回的 JSON 包含匹配器中所有的 key-value 时，会立即发送 IMMEDIATE_RESULT 事件
- *
- * @example
- * // 匹配包含 { type: "card" } 的返回结果
- * { type: "card" }
- *
- * // 匹配包含 { type: "product_list", isCard: true } 的返回结果
- * { type: "product_list", isCard: true }
+ * MCPLink 核心类型定义
+ * 极简设计：只做 MCP + HTTP 桥接
  */
-type ImmediateResultMatcher = Record<string, unknown>;
-/** MCPLink 配置 */
-interface MCPLinkConfig {
-    /** AI 模型实例 (Vercel AI SDK) */
-    model: LanguageModel;
-    /** 模型名称（用于自动检测是否支持原生工具调用） */
-    modelName?: string;
-    /** MCP 服务器配置 */
-    mcpServers?: Record<string, MCPServerConfig>;
-    /** 系统提示词 */
-    systemPrompt?: string;
-    /** 最大迭代次数 (防止无限循环) */
-    maxIterations?: number;
-    /** 是否允许并行工具调用 */
-    parallelToolCalls?: boolean;
-    /**
-     * 是否使用基于 Prompt 的工具调用
-     * - true: 使用 prompt 让模型输出特定格式来调用工具（支持所有模型）
-     * - false: 使用原生 function calling（需要模型支持）
-     * - 'auto': 自动检测（默认）
-     */
-    usePromptBasedTools?: boolean | 'auto';
-    /**
-     * 即时结果匹配器列表
-     * 当 MCP 工具返回的结果匹配任意一个匹配器时，会立即发送 IMMEDIATE_RESULT 事件
-     * 匹配规则：结果 JSON 中包含匹配器的所有 key 且对应的 value 相等
-     *
-     * @example
-     * immediateResultMatchers: [
-     *   { type: "card" },           // 匹配 { type: "card", ... }
-     *   { type: "product_list" },   // 匹配 { type: "product_list", ... }
-     * ]
-     */
-    immediateResultMatchers?: ImmediateResultMatcher[];
-    /**
-     * 是否启用思考阶段（两阶段调用）
-     * - true: 每次迭代先让 AI 思考分析，再执行工具调用（默认，推荐）
-     * - false: 直接调用 AI 并执行工具（更快但可能不够准确）
-     *
-     * 启用后的流程：
-     * 1. 思考阶段：AI 分析需求，输出思考过程，决定调用什么工具
-     * 2. 执行阶段：根据思考结果执行工具调用
-     *
-     * 优点：
-     * - 任何模型都能看到思考过程
-     * - Chain-of-Thought 效应，显著提高复杂任务准确性
-     *
-     * 缺点：
-     * - 每次迭代多一次 API 调用，增加延迟和成本
-     *
-     * @default false
-     */
-    enableThinkingPhase?: boolean;
-    /**
-     * 自定义思考阶段提示词
-     * 用于引导 AI 在调用工具前进行分析
-     *
-     * 如果不设置，使用默认提示词
-     */
-    thinkingPhasePrompt?: string;
-    /**
-     * 思考阶段的最大 token 数
-     * 用于限制思考输出长度，不设置则不限制
-     */
-    thinkingMaxTokens?: number;
+/** AI 提供商适配器类型 */
+type AIAdapterType = 'openai' | 'anthropic' | 'gemini' | 'ollama' | 'custom';
+/** AI 请求配置 - 完全开放，任意参数 */
+interface AIRequestConfig {
+    /** AI 服务地址 */
+    baseURL: string;
+    /** API 密钥 */
+    apiKey: string;
+    /** 模型名称 */
+    model: string;
+    /** 请求头（可选） */
+    headers?: Record<string, string>;
+    /** 请求超时（毫秒，默认 120000） */
+    timeout?: number;
+    /** 任意其他参数，原封不动传给 AI */
+    [key: string]: unknown;
 }
-/** 工具调用 */
+/** AI 消息角色 */
+type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
+/** AI 消息 */
+interface Message {
+    role: MessageRole;
+    content: string;
+    /** 工具调用（assistant 消息） */
+    toolCalls?: ToolCall[];
+    /** 工具结果（tool 消息） */
+    toolResults?: ToolResult[];
+}
+/** 工具调用定义 */
 interface ToolCall {
     id: string;
     name: string;
@@ -137,115 +42,80 @@ interface ToolResult {
     toolName: string;
     result: unknown;
     isError?: boolean;
-    duration?: number;
 }
-/** 消息角色 */
-type MessageRole = 'system' | 'user' | 'assistant' | 'tool';
-/** 消息 */
-interface Message {
-    role: MessageRole;
+/** AI 流式事件 */
+type AIStreamEvent = {
+    type: 'text';
+    content: string;
+} | {
+    type: 'tool_call';
+    toolCall: ToolCall;
+} | {
+    type: 'done';
+} | {
+    type: 'error';
+    error: Error;
+};
+/** AI 响应（非流式） */
+interface AIResponse {
     content: string;
     toolCalls?: ToolCall[];
-    toolResults?: ToolResult[];
 }
-/** 事件类型 */
-declare enum MCPLinkEventType {
-    /** AI 开始思考 */
-    THINKING_START = "thinking_start",
-    /** AI 思考内容 (流式) */
-    THINKING_DELTA = "thinking_delta",
-    /** AI 思考结束 */
-    THINKING_END = "thinking_end",
-    /** AI 开始回复 */
-    TEXT_START = "text_start",
-    /** AI 回复内容 (流式) */
-    TEXT_DELTA = "text_delta",
-    /** AI 回复结束 */
-    TEXT_END = "text_end",
-    /** 开始调用工具 */
-    TOOL_CALL_START = "tool_call_start",
-    /** 工具参数 (流式) */
-    TOOL_CALL_DELTA = "tool_call_delta",
-    /** 工具正在执行 */
-    TOOL_EXECUTING = "tool_executing",
-    /** 工具返回结果 */
-    TOOL_RESULT = "tool_result",
-    /** 工具返回的即时结果（匹配 immediateResultMatchers 时触发） */
-    IMMEDIATE_RESULT = "immediate_result",
-    /** 开始新一轮迭代 */
-    ITERATION_START = "iteration_start",
-    /** 迭代结束 */
-    ITERATION_END = "iteration_end",
-    /** 全部完成 */
-    COMPLETE = "complete",
-    /** 发生错误 */
-    ERROR = "error"
+/** 工具定义（传递给 AI 的函数定义） */
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
 }
-/** 事件数据 */
-interface MCPLinkEventData {
-    content?: string;
-    toolName?: string;
-    toolArgs?: Record<string, unknown>;
-    toolResult?: unknown;
-    toolCallId?: string;
-    duration?: number;
-    iteration?: number;
-    maxIterations?: number;
-    totalIterations?: number;
-    totalDuration?: number;
-    argsTextDelta?: string;
-    isError?: boolean;
-    error?: Error;
-    /** 即时结果数据（原封不动的工具返回结果） */
-    immediateResult?: unknown;
+/** 适配器接口 - 用于转换不同 AI 提供商的格式 */
+interface AIAdapter {
+    /** 适配器名称 */
+    name: string;
+    /** 构建请求体 */
+    buildRequestBody: (config: AIRequestConfig, messages: Message[], tools?: ToolDefinition[]) => unknown;
+    /** 获取请求头 */
+    getHeaders: (config: AIRequestConfig) => Record<string, string>;
+    /** 获取请求端点 */
+    getEndpoint: (baseURL: string) => string;
+    /** 解析非流式响应 */
+    parseResponse: (data: unknown) => AIResponse;
+    /** 解析流式数据块（SSE） */
+    parseStreamChunk: (line: string) => AIStreamEvent | null;
 }
-/** 事件 */
-interface MCPLinkEvent {
-    type: MCPLinkEventType;
-    timestamp: number;
-    data: MCPLinkEventData;
+/** 用户回调函数 - 处理 AI 响应 */
+interface AIResponseHandler {
+    /**
+     * 处理 AI 流式响应
+     * @param event 流式事件
+     * @returns 是否继续接收（返回 false 可中止）
+     */
+    onStream?: (event: AIStreamEvent) => boolean | void;
+    /**
+     * 处理需要工具调用的请求
+     * @param toolCalls 工具调用列表
+     * @returns 工具执行结果（MCPLink 会自动执行 MCP 工具后再次调用 AI）
+     */
+    onToolCalls?: (toolCalls: ToolCall[]) => Promise<ToolResult[]> | ToolResult[];
 }
-/** 对话回调选项 */
-interface ChatCallbacks {
-    /** AI 思考内容 */
-    onThinking?: (content: string) => void;
-    /** 开始调用工具 */
-    onToolCallStart?: (toolName: string, args: Record<string, unknown>) => void;
-    /** 工具返回结果 */
-    onToolResult?: (toolName: string, result: unknown, duration: number) => void;
-    /** AI 输出文本 (流式) */
-    onTextDelta?: (delta: string) => void;
-    /** 迭代开始 */
-    onIterationStart?: (iteration: number) => void;
-    /** 迭代结束 */
-    onIterationEnd?: (iteration: number) => void;
-    /** 发生错误 */
-    onError?: (error: Error) => void;
+/** MCP 服务器配置 - stdio 模式 */
+interface MCPServerConfigStdio {
+    type?: 'stdio';
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
 }
-/** 对话结果 */
-interface ChatResult {
-    /** 最终回复内容 */
-    content: string;
-    /** 执行过的工具调用记录 */
-    toolCalls: Array<{
-        name: string;
-        arguments: Record<string, unknown>;
-        result: unknown;
-        duration: number;
-    }>;
-    /** 完整消息历史 */
-    messages: Message[];
-    /** Token 使用量 */
-    usage: {
-        promptTokens: number;
-        completionTokens: number;
-        totalTokens: number;
-    };
-    /** 总迭代次数 */
-    iterations: number;
-    /** 总耗时 (ms) */
-    duration: number;
+/** MCP 服务器配置 - Streamable HTTP 模式 */
+interface MCPServerConfigStreamableHTTP {
+    type: 'streamable-http';
+    url: string;
+    headers?: Record<string, string>;
 }
+/** MCP 服务器配置 */
+type MCPServerConfig = MCPServerConfigStdio | MCPServerConfigStreamableHTTP;
 /** MCP 工具定义 */
 interface MCPTool {
     name: string;
@@ -265,19 +135,55 @@ interface MCPServerStatus {
     tools: MCPTool[];
     error?: string;
 }
+/** MCPLink 配置 */
+interface MCPLinkConfig {
+    /** AI 请求配置 */
+    ai: AIRequestConfig;
+    /** 适配器类型或自定义适配器（默认 'openai'） */
+    adapter?: AIAdapterType | AIAdapter;
+    /** MCP 服务器配置 */
+    mcpServers?: Record<string, MCPServerConfig>;
+    /** 最大迭代次数（防止无限循环，默认 10） */
+    maxIterations?: number;
+}
+/** 对话选项 */
+interface ChatOptions {
+    /** 消息历史 */
+    messages: Message[];
+    /** 可用工具 */
+    tools?: ToolDefinition[];
+    /** 流式处理回调 */
+    onStream?: (event: AIStreamEvent) => boolean | void;
+    /** 是否启用流式（默认 true） */
+    stream?: boolean;
+}
+/** 对话结果 */
+interface ChatResult {
+    content: string;
+    messages: Message[];
+    iterations: number;
+    duration: number;
+}
 
 /**
- * MCPLink 主类
- * AI Agent 工具调用框架的入口
+ * MCPLink - 极简 MCP + AI HTTP 桥接
+ *
+ * 职责：
+ * 1. 管理 MCP 服务器连接
+ * 2. 发起 AI HTTP 请求
+ * 3. 发现工具调用 → 执行 MCP 工具 → 回调结果
+ *
+ * 不职责：
+ * 1. 不管理消息历史（用户自己维护）
+ * 2. 不处理 AI 响应格式（用户通过 onStream 回调处理）
+ * 3. 不做复杂的 Agent 循环（用户控制迭代）
  */
 declare class MCPLink {
-    private model;
-    private mcpManager;
-    private agent;
-    private promptBasedAgent;
     private config;
+    private mcpManager;
+    private httpClient;
+    private adapter;
     private initialized;
-    private detectedNativeSupport;
     constructor(config: MCPLinkConfig);
     /**
      * 初始化 - 连接所有 MCP 服务器
@@ -288,63 +194,44 @@ declare class MCPLink {
      */
     close(): Promise<void>;
     /**
-     * 发起对话
+     * 对话 - 极简设计
+     *
+     * 流程：
+     * 1. 发送消息给 AI
+     * 2. AI 返回文本/工具调用
+     * 3. 如果有工具调用，执行 MCP 工具
+     * 4. 返回结果（包括新的消息历史，用户可选择是否继续）
+     *
+     * 用户需要自己：
+     * - 维护 messages 历史
+     * - 处理流式响应（通过 onStream）
+     * - 决定是否继续迭代（如果返回了 toolCalls）
      */
-    chat(message: string, callbacks?: ChatCallbacks): Promise<ChatResult>;
+    chat(options: ChatOptions): Promise<ChatResult>;
     /**
-     * 流式对话
-     * @param message 用户消息（支持字符串或多模态数组）
-     * @param options 可选参数
-     * @param options.allowedTools 允许使用的工具名称列表
-     * @param options.history 历史消息列表
+     * 单次 AI 调用（非流式）
      */
-    chatStream(message: UserMessage, options?: {
-        allowedTools?: string[];
-        history?: Array<{
-            role: 'user' | 'assistant';
-            content: string;
-        }>;
-    }): AsyncGenerator<MCPLinkEvent>;
+    private singleChat;
     /**
-     * 获取当前使用的模式
+     * 流式 AI 调用
      */
-    getToolCallingMode(): 'native' | 'prompt-based';
+    private streamChat;
     /**
-     * 添加 MCP 服务器
+     * 流式对话 - 公共方法
+     * 直接发起流式请求并返回结果
      */
-    addMCPServer(id: string, config: MCPServerConfig): void;
+    chatStream(messages: Message[], onStream?: (event: AIStreamEvent) => boolean | void): Promise<ChatResult>;
     /**
-     * 移除 MCP 服务器
+     * 根据类型获取适配器
      */
+    private getAdapterByType;
+    addMCPServer(id: string, config: MCPServerConfig): void;
     removeMCPServer(id: string): Promise<void>;
-    /**
-     * 启动指定 MCP 服务器
-     */
     startMCPServer(id: string): Promise<void>;
-    /**
-     * 停止指定 MCP 服务器
-     */
     stopMCPServer(id: string): Promise<void>;
-    /**
-     * 获取所有 MCP 服务器状态
-     */
     getMCPServerStatuses(): MCPServerStatus[];
-    /**
-     * 获取所有可用工具
-     */
     getTools(): MCPTool[];
-    /**
-     * 手动调用工具
-     */
     callTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
-    /**
-     * 更新系统提示词
-     */
-    setSystemPrompt(prompt: string): void;
-    /**
-     * 更新 AI 模型
-     */
-    setModel(model: LanguageModel): void;
 }
 
 /**
@@ -400,169 +287,166 @@ declare class MCPManager {
 }
 
 /**
- * 默认用户提示词
- * 这只是用户自定义的部分，核心工具调用逻辑已内置到代码中
- */
-declare const DEFAULT_SYSTEM_PROMPT = "\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u3001\u53CB\u597D\u7684\u667A\u80FD\u52A9\u624B\u3002\n\n## \u56DE\u590D\u8981\u6C42\n- \u7B80\u6D01\u6E05\u6670\uFF0C\u91CD\u70B9\u7A81\u51FA\n- \u7528\u5217\u8868\u5448\u73B0\u5173\u952E\u4FE1\u606F\n- \u8BED\u6C14\u793C\u8C8C\u81EA\u7136\uFF0C\u50CF\u4E13\u4E1A\u52A9\u624B\n- \u6709\u7ED3\u8BBA\u65F6\u76F4\u63A5\u7ED9\u51FA\uFF0C\u9700\u8981\u8865\u5145\u4FE1\u606F\u65F6\u7B80\u5355\u8BE2\u95EE";
-/**
- * 默认思考阶段提示词
- * 用于引导 AI 进行内部思考（类似 Cursor 的思考风格）
- */
-declare const DEFAULT_THINKING_PHASE_PROMPT = "\n---\n\u8FD9\u662F\u4F60\u7684\u5185\u5FC3\u72EC\u767D\uFF0C\u7528\u6237\u770B\u4E0D\u5230\u3002\n\n\u5224\u65AD\u5F53\u524D\u72B6\u6001\uFF1A\u6211\u62FF\u5230\u4E86\u4EC0\u4E48\uFF1F\u4EFB\u52A1\u5B8C\u6210\u4E86\u5417\uFF1F\u8FD8\u9700\u8981\u67E5\u4EC0\u4E48\uFF1F\n\n\u91CD\u8981\uFF1A\u8FD9\u91CC\u53EA\u662F\u601D\u8003\u5224\u65AD\uFF0C\u4E0D\u8981\u5728\u8FD9\u91CC\u5199\u56DE\u590D\u5185\u5BB9\uFF08\u56DE\u590D\u662F\u4E0B\u4E00\u6B65\u7684\u4E8B\uFF09\u3002\n---";
-/**
- * Agent 引擎
- * 负责执行 AI 对话循环，处理工具调用
+ * HTTP 客户端 - 基于 axios
+ * 支持 SSE 流式响应
  */
-declare class Agent {
-    private model;
-    private mcpManager;
-    private systemPrompt;
-    private maxIterations;
-    private immediateResultMatchers;
-    private parallelToolCalls;
-    private enableThinkingPhase;
-    private thinkingPhasePrompt;
-    private thinkingMaxTokens?;
-    constructor(model: LanguageModel, mcpManager: MCPManager, options?: {
-        systemPrompt?: string;
-        maxIterations?: number;
-        immediateResultMatchers?: ImmediateResultMatcher[];
-        parallelToolCalls?: boolean;
-        enableThinkingPhase?: boolean;
-        thinkingPhasePrompt?: string;
-        thinkingMaxTokens?: number;
-    });
-    /**
-     * 生成工具描述文本（用于思考阶段）
-     */
-    private generateToolsDescription;
-    /**
-     * 摘要化工具返回结果（用于思考阶段，避免 AI 直接格式化输出数据）
-     * @param toolName 工具名称
-     * @param result 工具返回的结果
-     * @returns 摘要字符串
-     */
-    private summarizeToolResult;
-    /**
-     * 检查工具返回结果是否匹配即时结果匹配器
-     * @param result 工具返回的结果
-     * @returns 如果匹配返回 true，否则返回 false
-     */
-    private matchImmediateResult;
-    /**
-     * 将 MCP 工具转换为 Vercel AI SDK 格式
-     */
-    private convertMCPToolsToAITools;
-    /**
-     * JSON Schema 到 Zod 的完整递归转换
-     * 支持嵌套对象、对象数组、枚举等所有常见类型
-     */
-    private jsonSchemaToZod;
-    /**
-     * 递归转换 JSON Schema 节点为 Zod 类型
-     */
-    private convertSchemaToZod;
-    /**
-     * 执行对话
-     */
-    chat(userMessage: string, callbacks?: ChatCallbacks): Promise<ChatResult>;
+
+declare class HttpClient {
+    private client;
+    constructor();
     /**
-     * 将 UserMessage 转换为 Vercel AI SDK 的消息内容格式
+     * 非流式请求
      */
-    private convertUserMessageToContent;
+    chat(aiConfig: AIRequestConfig, adapter: AIAdapter, messages: Message[], tools?: ToolDefinition[]): Promise<AIResponse>;
     /**
-     * 从 UserMessage 提取纯文本内容（用于日志等）
+     * 流式请求 - SSE
      */
-    private extractTextFromMessage;
+    streamChat(aiConfig: AIRequestConfig, adapter: AIAdapter, messages: Message[], tools?: ToolDefinition[]): AsyncGenerator<AIStreamEvent>;
     /**
-     * 流式对话 - 返回事件生成器
-     * @param userMessage 用户消息（支持字符串或多模态数组）
-     * @param options 可选参数
-     * @param options.allowedTools 允许使用的工具名称列表，为空或不传则使用所有工具
-     * @param options.history 历史消息列表
+     * 解析 SSE 流
      */
-    chatStream(userMessage: UserMessage, options?: {
-        allowedTools?: string[];
-        history?: Array<{
-            role: 'user' | 'assistant';
-            content: string;
-        }>;
-    }): AsyncGenerator<MCPLinkEvent>;
+    private parseSSE;
 }
 
 /**
- * 基于 Prompt 的 Agent
- * 通过 prompt 工程让任意模型支持工具调用和思考过程
- *
- * 设计原则：
- * 1. 简洁 - 不做过多干预，让 AI 自己思考和决策
- * 2. 通用 - 支持任何模型，不依赖特定 API
- * 3. 可靠 - 稳定的状态机解析
+ * OpenAI 适配器
+ * 支持任意自定义参数（如 enable_thinking）
  */
-declare class PromptBasedAgent {
-    private model;
-    private mcpManager;
-    private systemPrompt;
-    private maxIterations;
-    private immediateResultMatchers;
-    private parallelToolCalls;
-    private enableThinkingPhase;
-    constructor(model: LanguageModel, mcpManager: MCPManager, options?: {
-        systemPrompt?: string;
-        maxIterations?: number;
-        immediateResultMatchers?: ImmediateResultMatcher[];
-        parallelToolCalls?: boolean;
-        enableThinkingPhase?: boolean;
-        thinkingPhasePrompt?: string;
-        thinkingMaxTokens?: number;
-    });
-    /**
-     * 检查工具返回结果是否匹配即时结果匹配器
-     * @param result 工具返回的结果
-     * @returns 如果匹配返回 true，否则返回 false
-     */
-    private matchImmediateResult;
+
+declare class OpenAIAdapter implements AIAdapter {
+    name: string;
+    private pendingToolCall;
     /**
-     * 生成工具列表描述
+     * 检查 tool_call 参数是否完整（可以解析为 JSON）
      */
-    private generateToolsDescription;
+    private isToolCallComplete;
     /**
-     * 内置系统提示词 - 强调格式约束
+     * 返回并清空 pending tool_call
      */
-    private readonly BUILT_IN_PROMPT;
+    private flushPendingToolCall;
     /**
-     * 构建完整的系统提示词
+     * 构建请求体
+     * 完全开放：除必要字段外，其他参数原封不动传递
      */
-    private buildSystemPrompt;
+    buildRequestBody(config: AIRequestConfig, messages: Message[], tools?: ToolDefinition[]): Record<string, unknown>;
     /**
-     * 解析工具调用
+     * 获取请求头
      */
-    private parseToolCall;
+    getHeaders(config: AIRequestConfig): Record<string, string>;
     /**
-     * 智能压缩历史消息
-     * - 用户消息完整保留
-     * - AI 回复保留关键信息（ID、名称、数量、价格等）
-     * - 去除冗长的 JSON 原始数据
+     * 获取请求端点
      */
-    private compressHistory;
+    getEndpoint(baseURL: string): string;
     /**
-     * 将 UserMessage 转换为 Vercel AI SDK 的消息内容格式
+     * 解析非流式响应
      */
-    private convertUserMessageToContent;
+    parseResponse(data: unknown): AIResponse;
     /**
-     * 从 UserMessage 提取纯文本内容（用于日志等）
+     * 解析流式数据块
      */
-    private extractTextFromMessage;
+    parseStreamChunk(line: string): AIStreamEvent | null;
     /**
-     * 流式对话（支持多模态消息）
+     * 转换消息格式
      */
-    chatStream(userMessage: UserMessage, options?: {
-        allowedTools?: string[];
-        history?: Array<{
-            role: 'user' | 'assistant';
-            content: string;
-        }>;
-    }): AsyncGenerator<MCPLinkEvent>;
+    private convertMessage;
 }
+/** OpenAI 适配器实例 */
+declare const openaiAdapter: OpenAIAdapter;
+
+/**
+ * 标准事件流转换器
+ * 将底层 AI 事件转换为完整的标准事件流
+ * 用户可选择使用底层事件或标准事件
+ */
+
+/** 标准流式事件类型 */
+type StandardStreamEvent = {
+    type: 'text_start';
+} | {
+    type: 'text_delta';
+    content: string;
+} | {
+    type: 'text_end';
+} | {
+    type: 'thinking_start';
+} | {
+    type: 'thinking_delta';
+    content: string;
+} | {
+    type: 'thinking_end';
+} | {
+    type: 'tool_call_start';
+    toolCallId: string;
+    toolName: string;
+    toolArgs: Record<string, unknown>;
+} | {
+    type: 'tool_call_delta';
+    toolCallId: string;
+    argsTextDelta: string;
+} | {
+    type: 'tool_call_end';
+    toolCallId: string;
+} | {
+    type: 'tool_executing';
+    toolCallId: string;
+    toolName: string;
+} | {
+    type: 'tool_result';
+    toolCallId: string;
+    toolName: string;
+    toolResult: unknown;
+    duration: number;
+    isError?: boolean;
+} | {
+    type: 'iteration_start';
+    iteration: number;
+    maxIterations: number;
+} | {
+    type: 'iteration_end';
+    iteration: number;
+} | {
+    type: 'complete';
+    totalIterations: number;
+    totalDuration: number;
+} | {
+    type: 'error';
+    error: Error;
+};
+/**
+ * 标准事件流生成器选项
+ */
+interface StandardStreamOptions {
+    /** 最大迭代次数 */
+    maxIterations?: number;
+    /** 工具执行函数 */
+    executeTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
+    /** 底层事件回调（可选，用于自定义处理） */
+    onRawEvent?: (event: AIStreamEvent) => boolean | void;
+}
+/**
+ * 将底层事件流转换为标准事件流
+ */
+declare function toStandardStream(rawStream: AsyncGenerator<AIStreamEvent>, options: StandardStreamOptions): AsyncGenerator<StandardStreamEvent>;
+/**
+ * 标准响应处理器 - 非流式
+ * 收集完整响应内容
+ */
+interface StandardResponse {
+    content: string;
+    toolCalls: Array<{
+        id: string;
+        name: string;
+        arguments: Record<string, unknown>;
+        result?: unknown;
+        duration?: number;
+        isError?: boolean;
+    }>;
+    iterations: number;
+    duration: number;
+}
+/**
+ * 从标准事件流收集完整响应
+ */
+declare function collectStandardResponse(stream: AsyncGenerator<StandardStreamEvent>): Promise<StandardResponse>;
 
-export { Agent, type ChatCallbacks, type ChatResult, DEFAULT_SYSTEM_PROMPT, DEFAULT_THINKING_PHASE_PROMPT, type FilePart, type ImagePart, type ImmediateResultMatcher, MCPLink, type MCPLinkConfig, type MCPLinkEvent, type MCPLinkEventData, MCPLinkEventType, MCPManager, type MCPServerConfig, type MCPServerConfigStdio, type MCPServerConfigStreamableHTTP, type MCPServerStatus, type MCPTool, type Message, type MessageContentPart, type MessageRole, PromptBasedAgent, type TextPart, type ToolCall, type ToolResult, type UserMessage };
+export { type AIAdapter, type AIAdapterType, type AIRequestConfig, type AIResponseHandler, type AIStreamEvent, type ChatOptions, type ChatResult, HttpClient, MCPLink, type MCPLinkConfig, MCPManager, type MCPServerConfig, type MCPServerConfigStdio, type MCPServerConfigStreamableHTTP, type MCPServerStatus, type MCPTool, type Message, type MessageRole, OpenAIAdapter, type StandardResponse, type StandardStreamEvent, type StandardStreamOptions, type ToolCall, type ToolDefinition, type ToolResult, collectStandardResponse, openaiAdapter, toStandardStream };