@huyooo/ai-chat-core 0.2.45 → 0.3.3

package/dist/index.d.ts

@@ -1,805 +1,73 @@
-import { A as AgentConfig, T as ToolExecutor$1, M as ModelFamilyConfig, R as RouteResult, C as ChatOptions, a as ChatEvent, b as ModelOption, c as McpConnectionInfo, J as JsonSchemaObject, d as Tool, e as ChatMessage } from './events-CU5D5ray.js';
-export { ax as AbortEvent, N as ActionType, B as AutoRunConfig, z as AutoRunMode, b5 as CHAT_EVENT_TYPES, i as CLAUDE_FAMILY, aC as ChatEventType, x as ChatMode, g as DEEPSEEK_FAMILY, D as DOUBAO_FAMILY, av as DoneEvent, aa as ErrorCategory, ab as ErrorDetails, aw as ErrorEvent, O as ExecResult, G as GEMINI_FAMILY, h as GPT_FAMILY, Z as MODELS, f as MODEL_FAMILIES, j as MODEL_REGISTRY, bb as McpConnectionStatus, ba as McpServerConfig, t as ModelFamilyId, w as ModelRegistryEntry, at as PlanStep, au as PlanStepStatus, P as ProtocolId, H as ProviderType, Q as QWEN_FAMILY, L as RenderType, F as ResponsesApiTool, aj as SearchEndEvent, ak as SearchEvent, a6 as SearchResult, ai as SearchResultEvent, ah as SearchStartEvent, S as SearchStrategy, ay as StatusEvent, aA as StepEndEvent, aB as StepEvent, az as StepStartEvent, ar as TextDeltaEvent, as as TextEvent, ae as ThinkingDeltaEvent, af as ThinkingEndEvent, ag as ThinkingEvent, u as ThinkingFormat, y as ThinkingMode, ad as ThinkingStartEvent, a9 as TokenUsage, ao as ToolApprovalRequestEvent, v as ToolCallFormat, a8 as ToolCallInfo, an as ToolCallOutputEvent, ap as ToolCallRequestEvent, am as ToolCallResultEvent, al as ToolCallStartEvent, a7 as ToolCallStatus, X as ToolConfigItem, I as ToolContext, E as ToolDefinition, U as ToolError, V as ToolErrorCode, U as ToolErrorShape, aq as ToolEvent, W as ToolPlugin, K as ToolUI, ac as ToolUIShape, Y as UserToolDefinition, aV as createAbort, aQ as createApiError, aO as createDone, aP as createError, aU as createParseError, aR as createRateLimitError, aI as createSearchEnd, aH as createSearchResult, aG as createSearchStart, aX as createStepEnd, aW as createStepStart, aN as createTextDelta, aE as createThinkingDelta, aF as createThinkingEnd, aD as createThinkingStart, aT as createTimeoutError, aL as createToolCallOutput, aM as createToolCallRequest, aK as createToolCallResult, aJ as createToolCallStart, aS as createToolError, a5 as getArg, b8 as getDefaultProvider, _ as getModelByModelId, k as getModelEntry, l as getModelFamily, m as getModelProtocol, s as getModelSearchStrategy, o as getModelsByFamily, p as getModelsByProtocol, n as getVisibleModels, b2 as isAbortEvent, b1 as isErrorEvent, b9 as isModelForProvider, b4 as isRetryableError, aZ as isSearchEvent, b0 as isStatusEvent, b3 as isStepEvent, a$ as isTextEvent, aY as isThinkingEvent, a4 as isThrowableToolError, a4 as isToolError, a_ as isToolEvent, r as modelSupportsNativeSearch, q as modelSupportsThinking, $ as resolveTools, a3 as rethrowToolError, b6 as routeModelToProvider, b7 as routeModelWithDetails, a2 as throwToolError, a0 as tool, a1 as tools } from './events-CU5D5ray.js';
-
-/** 运行时配置（API Keys 和 URLs） */
-interface RuntimeConfig {
-    arkApiKey: string;
-    arkApiUrl: string;
-    qwenApiKey: string;
-    qwenApiUrl: string;
-    openrouterApiKey: string;
-    openrouterApiUrl: string;
-    vercelApiKey: string;
-    tavilyApiKey: string;
-    geminiApiKey: string;
-    cwd: string;
-}
 /**
- * 混合 Agent 类
- *
- * 职责：
- * 1. 管理 UnifiedAdapter（统一适配器）
- * 2. 使用 ChatOrchestrator 统一处理工具调用
- * 3. 管理工具注册
- */
-declare class HybridAgent {
-    private config;
-    private adapter;
-    private orchestrator;
-    private toolExecutor;
-    private abortController;
-    /** 已注册的工具 */
-    private tools;
-    /** 工具配置（用于异步初始化） */
-    private toolConfig;
-    /** MCP 客户端管理器 */
-    private mcpManager;
-    /** MCP 服务器配置 */
-    private mcpConfigs;
-    constructor(config: AgentConfig, toolExecutor?: ToolExecutor$1);
-    /** 异步初始化工具（在第一次 chat 前调用） */
-    private asyncInit;
-    /** 获取模型的家族配置 */
-    getModelFamilyConfig(model: string): ModelFamilyConfig | undefined;
-    /**
-     * 判断模型提供商（兼容旧接口）
-     */
-    private getModelProvider;
-    /**
-     * 调试：获取模型路由信息
-     */
-    getModelRouteInfo(model: string): RouteResult & {
-        available: boolean;
-        familyConfig?: ModelFamilyConfig;
-    };
-    /** 构建系统提示词 */
-    private buildSystemPrompt;
-    /** 获取默认深度思考模式 */
-    private getDefaultThinkingMode;
-    /** 创建工具执行上下文 */
-    private createToolContext;
-    /** 执行工具 */
-    private executeTool;
-    /** 获取工具定义列表 */
-    private getToolDefinitions;
-    /** 获取所有工具列表（用于设置面板） */
-    getAllTools(): Array<{
-        name: string;
-        description: string;
-    }>;
-    /**
-     * 聊天入口
-     *
-     * 使用 ChatOrchestrator 统一处理所有 Provider 的工具调用循环
-     */
-    chat(message: string, options?: ChatOptions, images?: string[]): AsyncGenerator<ChatEvent>;
-    /** 中断当前请求 */
-    abort(): void;
-    /** 设置当前工作目录 */
-    setCwd(dir: string): void;
-    /** 获取当前配置 */
-    getConfig(): RuntimeConfig;
-    /** 获取所有支持的模型 */
-    getSupportedModels(): ModelOption[];
-    /** 获取 MCP 连接状态 */
-    getMcpConnections(): McpConnectionInfo[];
-    /**
-     * 销毁 Agent（优雅关闭所有 MCP 连接）
-     *
-     * 桌面客户端退出时应调用此方法。
-     */
-    destroy(): Promise<void>;
-}
-
-/**
- * Provider 统一类型定义
- *
- * 核心设计原则：
- * 1. Adapter 只负责 API 格式转换，不处理业务逻辑
- * 2. Orchestrator 统一处理工具调用循环、消息历史、事件发射
- * 3. 所有 Adapter 返回标准化的 StreamChunk
- */
-
-interface SimpleToolDefinition {
-    name: string;
-    description: string;
-    parameters: JsonSchemaObject;
-}
-/** 流式响应块类型 */
-type StreamChunkType = 'text' | 'thinking' | 'thinking_done' | 'tool_call' | 'search_result' | 'done' | 'error';
-/** 工具调用请求 */
-interface ToolCallRequest {
-    id: string;
-    name: string;
-    arguments: string;
-    /** Gemini 模型需要的 thought_signature（用于工具调用循环） */
-    thought_signature?: string;
-}
-/** 搜索结果项 */
-interface SearchResultItem {
-    title: string;
-    url: string;
-    snippet: string;
-}
-/** 流式响应块 - 所有 Adapter 必须返回此格式 */
-/** Token 使用统计 */
-interface StreamTokenUsage {
-    promptTokens?: number;
-    completionTokens?: number;
-    totalTokens?: number;
-    reasoningTokens?: number;
-    cachedTokens?: number;
-}
-interface StreamChunk {
-    type: StreamChunkType;
-    text?: string;
-    thinking?: string;
-    toolCall?: ToolCallRequest;
-    searchResults?: SearchResultItem[];
-    finishReason?: 'stop' | 'tool_calls' | 'length' | 'error';
-    /** Token 使用统计（done 事件携带） */
-    usage?: StreamTokenUsage;
-    error?: string;
-}
-/** 标准化消息 - Orchestrator 内部使用 */
-interface StandardMessage {
-    role: 'system' | 'user' | 'assistant' | 'tool';
-    content: string;
-    images?: string[];
-    toolCalls?: ToolCallRequest[];
-    toolCallId?: string;
-    toolName?: string;
-}
-/** Adapter 配置 */
-interface AdapterConfig {
-    apiKey: string;
-    apiUrl?: string;
-    /** Tavily API Key（用于统一 Web Search） */
-    tavilyApiKey?: string;
-}
-/** 单次调用选项 */
-interface StreamOnceOptions {
-    /** 模型 ID */
-    model: string;
-    /** 是否启用思考 */
-    enableThinking?: boolean;
-    /** 是否启用搜索 */
-    enableSearch?: boolean;
-    /** 中断信号 */
-    signal: AbortSignal;
-}
-/**
- * Provider Adapter 接口
- *
- * 职责：
- * - 将标准消息转换为 API 特定格式
- * - 调用 API 并返回标准化的 StreamChunk
- * - 不处理工具执行、消息历史维护
- */
-interface ProviderAdapter {
-    /** 适配器名称 */
-    readonly name: string;
-    /** 支持的模型列表 */
-    readonly supportedModels: string[];
-    /**
-     * 单次流式调用
-     *
-     * @param messages 标准化消息列表
-     * @param tools 工具定义列表
-     * @param options 调用选项
-     * @returns 标准化的流式响应
-     */
-    streamOnce(messages: StandardMessage[], tools: SimpleToolDefinition[], options: StreamOnceOptions): AsyncGenerator<StreamChunk>;
-    /**
-     * 检查是否支持指定模型
-     */
-    supportsModel(model: string): boolean;
-}
-interface ToolExecutionHooks {
-    /** 工具调用 ID（用于把输出归属到具体 tool_call 卡片） */
-    toolCallId: string;
-    /** 工具名称 */
-    toolName: string;
-    /** stdout 增量 */
-    onStdout?: (chunk: string) => void;
-    /** stderr 增量 */
-    onStderr?: (chunk: string) => void;
-}
-type ToolExecutor = (name: string, args: Record<string, unknown>, signal?: AbortSignal, hooks?: ToolExecutionHooks) => Promise<object>;
-/** 自动运行配置 */
-interface AutoRunConfig {
-    /**
-     * 自动运行模式
-     * - 'run-everything': 运行所有内容（自动执行）
-     * - 'manual': 手动批准（每次执行前询问）
-     */
-    mode?: 'run-everything' | 'manual';
-}
-/** 工具批准回调函数 */
-type ToolApprovalCallback = (toolCall: {
-    id: string;
-    name: string;
-    args: Record<string, unknown>;
-}) => Promise<boolean>;
-/** 获取自动运行配置回调 */
-type GetAutoRunConfigCallback = () => Promise<AutoRunConfig | undefined>;
-/** Orchestrator 配置 */
-interface OrchestratorConfig {
-    /** 最大迭代次数 */
-    maxIterations?: number;
-    /** 工具执行器 */
-    executeTool: ToolExecutor;
-    /** 完整的工具列表（用于获取 ui/requiresApproval/timeout），key: 工具名称 */
-    tools?: Map<string, Tool>;
-    /** 自动运行配置（静态配置，优先使用 getAutoRunConfig） */
-    autoRunConfig?: AutoRunConfig;
-    /**
-     * 动态获取自动运行配置回调
-     * 每次检查工具批准时调用，获取最新配置
-     */
-    getAutoRunConfig?: GetAutoRunConfigCallback;
-    /**
-     * 工具批准回调（manual 模式使用）
-     * 返回 true 表示批准执行，false 表示跳过
-     */
-    onToolApprovalRequest?: ToolApprovalCallback;
-    /**
-     * 客户端工具名称集合（透传模式）
-     *
-     * 这些工具不在服务端执行，而是：
-     * 1. 发送 tool_call_request 事件给客户端
-     * 2. 结束本轮对话
-     * 3. 客户端执行后，发新请求继续对话
-     */
-    clientToolNames?: Set<string>;
-    /** 上下文总结回调（走 ai-server 等外部服务） */
-    summarize?: (systemPrompt: string, userPrompt: string) => Promise<string>;
-}
-/** Orchestrator 上下文 */
-interface OrchestratorContext {
-    /** 系统提示 */
-    systemPrompt: string;
-    /** 对话历史（会被修改） */
-    history: ChatMessage[];
-    /** 工具定义 */
-    tools: SimpleToolDefinition[];
-    /** 中断信号 */
-    signal: AbortSignal;
-    /** 图片列表 */
-    images?: string[];
-    /**
-     * 客户端工具名称集合（透传模式）
-     *
-     * 这些工具不在服务端执行，而是发送 tool_call_request 事件给客户端
-     */
-    clientToolNames?: Set<string>;
-}
-/** Orchestrator 选项 */
-interface OrchestratorOptions {
-    /** 模型 ID */
-    model: string;
-    /** 是否启用思考 */
-    enableThinking?: boolean;
-    /** 是否启用搜索 */
-    enableSearch?: boolean;
-    /** 自动运行配置 */
-    autoRunConfig?: AutoRunConfig;
-}
-
-/**
- * UnifiedAdapter - 统一适配器
- *
- * 组合 Protocol + FamilyConfig，产出标准 StreamChunk
- *
- * 设计原则：
- * 1. Protocol 只负责 HTTP/SSE 通信，产出 RawEvent
- * 2. UnifiedAdapter 根据 FamilyConfig 将 RawEvent 转换为 StreamChunk
- * 3. 所有模型都使用同一个 UnifiedAdapter，行为差异由 FamilyConfig 决定
- * 4. 实现 ProviderAdapter 接口，可与现有 Orchestrator 无缝集成
- */
-
-/**
- * UnifiedAdapter 配置
- */
-interface UnifiedAdapterConfig {
-    /** ARK API Key（豆包/DeepSeek） */
-    arkApiKey?: string;
-    arkApiUrl?: string;
-    /** Qwen API Key（通义千问） */
-    qwenApiKey?: string;
-    qwenApiUrl?: string;
-    /** Gemini API Key */
-    geminiApiKey?: string;
-    geminiApiUrl?: string;
-    /** OpenRouter API Key */
-    openrouterApiKey?: string;
-    openrouterApiUrl?: string;
-    /** Vercel API Key（用于 Vercel AI Gateway 访问 Claude） */
-    vercelApiKey?: string;
-}
-/**
- * 流式调用选项
- */
-interface StreamOptions {
-    /** 模型 ID */
-    model: string;
-    /** 是否启用 thinking */
-    enableThinking?: boolean;
-    /** 是否启用搜索 */
-    enableSearch?: boolean;
-    /** 中断信号 */
-    signal: AbortSignal;
-}
-/**
- * 统一适配器
- *
- * 实现 ProviderAdapter 接口，根据模型自动选择 Protocol，并根据 FamilyConfig 转换事件
- */
-declare class UnifiedAdapter implements ProviderAdapter {
-    readonly name = "unified";
-    /** 支持的模型列表（从 Registry 获取） */
-    get supportedModels(): string[];
-    private protocols;
-    constructor(config: UnifiedAdapterConfig);
-    /**
-     * 检查是否支持指定模型
-     */
-    supportsModel(model: string): boolean;
-    /**
-     * 获取模型的家族配置
-     */
-    getModelFamilyConfig(model: string): ModelFamilyConfig | undefined;
-    /**
-     * 实现 ProviderAdapter.streamOnce 接口
-     *
-     * @param messages 标准消息列表
-     * @param tools 工具定义
-     * @param options 调用选项
-     * @returns 标准 StreamChunk 流
-     */
-    streamOnce(messages: StandardMessage[], tools: SimpleToolDefinition[], options: StreamOnceOptions): AsyncGenerator<StreamChunk>;
-    /**
-     * 流式调用（内部方法）
-     */
-    private stream;
-    /**
-     * 将 RawEvent 转换为 StreamChunk
-     *
-     * 根据 FamilyConfig 处理行为差异
-     */
-    private transformEvents;
-}
-/**
- * 创建 UnifiedAdapter
- */
-declare function createUnifiedAdapter(config: UnifiedAdapterConfig): UnifiedAdapter;
-
-/**
- * Protocol Layer 类型定义
- *
- * Protocol 只负责：
- * 1. HTTP 请求发送
- * 2. SSE 流解析
- * 3. 认证处理
- *
- * 不负责：
- * - thinking 格式转换（由 Family 处理）
- * - 搜索行为差异（由 Family 处理）
- * - 工具调用格式差异（由 Family 处理）
- */
-
-/**
- * Protocol 原始事件类型
- *
- * 这是 Protocol 层产出的"原始"事件，
- * 后续由 FamilyBehavior 转换为标准 StreamChunk
- */
-type RawEventType = 'text_delta' | 'thinking_delta' | 'thinking_done' | 'tool_call_start' | 'tool_call_delta' | 'tool_call_done' | 'search_query' | 'search_result' | 'done' | 'error';
-/**
- * 原始工具调用
- */
-interface RawToolCall {
-    id: string;
-    name: string;
-    arguments: string;
-    /** Gemini 需要的 thoughtSignature（用于工具调用循环） */
-    thoughtSignature?: string;
-}
-/**
- * Protocol 消息中的工具调用
- */
-interface ProtocolToolCall {
-    id: string;
-    name: string;
-    arguments: string;
-    /** Gemini 需要的 thoughtSignature */
-    thoughtSignature?: string;
-}
-/**
- * 原始搜索结果
- */
-interface RawSearchResult {
-    title: string;
-    url: string;
-    snippet: string;
-}
-/**
- * Protocol 原始事件
- */
-/** Token 使用统计（Protocol 层） */
-interface RawTokenUsage {
-    promptTokens?: number;
-    completionTokens?: number;
-    totalTokens?: number;
-    reasoningTokens?: number;
-    cachedTokens?: number;
-}
-interface RawEvent {
-    type: RawEventType;
-    delta?: string;
-    toolCall?: Partial<RawToolCall>;
-    searchQuery?: string;
-    searchResults?: RawSearchResult[];
-    finishReason?: 'stop' | 'tool_calls' | 'length' | 'error';
-    /** Token 使用统计（done 事件携带） */
-    usage?: RawTokenUsage;
-    error?: string;
-}
-/**
- * Protocol 请求消息（标准化格式）
- */
-interface ProtocolMessage {
-    role: 'system' | 'user' | 'assistant' | 'tool';
-    content: string;
-    /** 图片列表（base64 或 URL） */
-    images?: string[];
-    /** 工具调用（assistant 消息） */
-    toolCalls?: ProtocolToolCall[];
-    /** 工具调用 ID（tool 消息） */
-    toolCallId?: string;
-    /** 工具名称（tool 消息，Gemini 需要） */
-    toolName?: string;
-}
-
-interface ProtocolToolDefinition {
-    name: string;
-    description: string;
-    parameters: JsonSchemaObject;
-}
-/**
- * Protocol 请求选项
- */
-interface ProtocolRequestOptions {
-    /** 模型 ID */
-    model: string;
-    /** 模型家族配置 */
-    familyConfig: ModelFamilyConfig;
-    /** 是否启用 thinking */
-    enableThinking: boolean;
-    /** 是否启用搜索 */
-    enableSearch: boolean;
-    /** 中断信号 */
-    signal: AbortSignal;
-}
-/**
- * Protocol 配置
- */
-interface ProtocolConfig {
-    apiKey: string;
-    apiUrl?: string;
-}
-/**
- * Protocol 接口
- *
- * 只负责 HTTP/SSE 通信，不处理任何业务逻辑
- */
-interface Protocol {
-    /** 协议名称 */
-    readonly name: string;
-    /**
-     * 发送请求并返回原始事件流
-     *
-     * @param messages 消息列表
-     * @param tools 工具定义
-     * @param options 请求选项
-     * @returns 原始事件流
-     */
-    stream(messages: ProtocolMessage[], tools: ProtocolToolDefinition[], options: ProtocolRequestOptions): AsyncGenerator<RawEvent>;
-}
-
-/**
- * ARK Protocol（火山引擎 Responses API）
- *
- * 只负责：
- * - HTTP 请求发送
- * - SSE 流解析
- * - 原始事件产出
- */
-
-/**
- * ARK Protocol 实现
- */
-declare class ArkProtocol implements Protocol {
-    readonly name = "ark";
-    private apiKey;
-    private apiUrl;
-    constructor(config: ProtocolConfig);
-    /**
-     * 发送请求并返回原始事件流
-     */
-    stream(messages: ProtocolMessage[], tools: ProtocolToolDefinition[], options: ProtocolRequestOptions): AsyncGenerator<RawEvent>;
-    /**
-     * 构建请求体
-     */
-    private buildRequestBody;
-    /**
-     * 转换消息格式
-     */
-    private convertMessages;
-    /**
-     * 解析 SSE 流
-     */
-    private parseSSE;
-}
-/**
- * 创建 ARK Protocol
- */
-declare function createArkProtocol(config: ProtocolConfig): ArkProtocol;
-
-/**
- * DeepSeek Protocol（通过火山引擎 ARK API 访问）
- *
- * 特点：
- * - 支持 reasoning（深度思考）
- * - 支持 web_search 原生搜索
- * - 与豆包共用 ARK API，但行为可能有差异
- */
-
-/**
- * DeepSeek Protocol 实现
- */
-declare class DeepSeekProtocol implements Protocol {
-    readonly name = "deepseek";
-    private apiKey;
-    private apiUrl;
-    constructor(config: ProtocolConfig);
-    stream(messages: ProtocolMessage[], tools: ProtocolToolDefinition[], options: ProtocolRequestOptions): AsyncGenerator<RawEvent>;
-    /**
-     * 构建请求体（DeepSeek 专用）
-     */
-    private buildRequestBody;
-    private convertMessages;
-    /**
-     * 解析 SSE 流（DeepSeek 专用）
-     */
-    private parseSSE;
-}
-declare function createDeepSeekProtocol(config: ProtocolConfig): DeepSeekProtocol;
-
-/**
- * Qwen Protocol（通义千问 OpenAI 兼容模式 API）
- *
- * 使用 OpenAI 兼容端点以支持工具调用：
- * https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions
- */
-
-/**
- * Qwen Protocol 实现（OpenAI 兼容模式）
- */
-declare class QwenProtocol implements Protocol {
-    readonly name = "qwen";
-    private apiKey;
-    private apiUrl;
-    constructor(config: ProtocolConfig);
-    /**
-     * 发送请求并返回原始事件流
-     */
-    stream(messages: ProtocolMessage[], tools: ProtocolToolDefinition[], options: ProtocolRequestOptions): AsyncGenerator<RawEvent>;
-    /**
-     * 构建请求体（OpenAI 格式）
-     */
-    private buildRequestBody;
-    /**
-     * 转换消息格式（OpenAI 标准格式）
-     */
-    private convertMessages;
-    /**
-     * 解析 SSE 流（OpenAI 格式）
-     */
-    private parseSSE;
-}
-/**
- * 创建 Qwen Protocol
- */
-declare function createQwenProtocol(config: ProtocolConfig): QwenProtocol;
-
-/**
- * Gemini Protocol（Google Gemini API）
- *
- * 只负责：
- * - HTTP 请求发送
- * - SSE 流解析
- * - 原始事件产出
- */
-
-/**
- * Gemini Protocol 实现
- */
-declare class GeminiProtocol implements Protocol {
-    readonly name = "gemini";
-    private apiKey;
-    private apiUrl;
-    constructor(config: ProtocolConfig);
-    /**
-     * 发送请求并返回原始事件流
-     */
-    stream(messages: ProtocolMessage[], tools: ProtocolToolDefinition[], options: ProtocolRequestOptions): AsyncGenerator<RawEvent>;
-    /**
-     * 构建请求体
-     */
-    private buildRequestBody;
-    /**
-     * 转换消息格式
-     */
-    private convertMessages;
-    /**
-     * 解析 SSE 流
-     */
-    private parseSSE;
-}
-/**
- * 创建 Gemini Protocol
- */
-declare function createGeminiProtocol(config: ProtocolConfig): GeminiProtocol;
-
-/**
- * OpenAI Protocol（通过 OpenRouter 访问 OpenAI/GPT 模型）
- *
- * 特点：
- * - GPT-5.x 支持 reasoning（思考模式）
- * - 支持工具调用
- */
-
-/**
- * OpenAI Protocol 实现（通过 OpenRouter）
- */
-declare class OpenAIProtocol implements Protocol {
-    readonly name = "openai";
-    private apiKey;
-    private apiUrl;
-    constructor(config: ProtocolConfig);
-    stream(messages: ProtocolMessage[], tools: ProtocolToolDefinition[], options: ProtocolRequestOptions): AsyncGenerator<RawEvent>;
-    /**
-     * 构建请求体（OpenAI/GPT 专用）
-     */
-    private buildRequestBody;
-    private convertMessages;
-    /**
-     * 解析 SSE 流（OpenAI/GPT 专用）
-     */
-    private parseSSE;
-}
-declare function createOpenAIProtocol(config: ProtocolConfig): OpenAIProtocol;
-
-/**
- * Anthropic Protocol（通过 Vercel AI Gateway）
- *
- * 特点：
- * - 使用 Vercel AI SDK 的 createGateway
- * - 支持 extended thinking
- * - 支持工具调用
- * - 自动处理流式输出
- *
- * 参考: https://vercel.com/docs/ai-gateway
- */
-
-/**
- * Anthropic Protocol 实现（通过 Vercel AI Gateway）
- */
-declare class AnthropicProtocol implements Protocol {
-    readonly name = "anthropic";
-    private gateway;
-    constructor(config: ProtocolConfig);
-    stream(messages: ProtocolMessage[], tools: ProtocolToolDefinition[], options: ProtocolRequestOptions): AsyncGenerator<RawEvent>;
-    /**
-     * 转换消息格式（ProtocolMessage → AI SDK CoreMessage）
-     * 简化版：主要处理文本消息，工具调用通过历史上下文传递
-     */
-    private convertMessages;
-    /**
-     * 转换工具格式（ProtocolToolDefinition → AI SDK tools）
-     * 注意：Vercel Gateway 对工具格式有特殊要求，这里使用标准格式
-     */
-    private convertTools;
-    /**
-     * 将 JSON Schema 转换为 Zod Schema
-     */
-    private jsonSchemaToZod;
-    /**
-     * 解析 AI SDK 流式响应
-     */
-    private parseStream;
-}
-declare function createAnthropicProtocol(config: ProtocolConfig): AnthropicProtocol;
-
-/**
- * Chat Orchestrator
- *
- * 统一处理：
- * 1. 工具调用循环 (while iterations < MAX)
- * 2. 消息历史维护 (assistant + tool 消息)
- * 3. 事件发射 (ChatEvent)
- * 4. 错误处理
- *
- * 所有 Provider 通过此类执行，确保行为一致
- */
-
-/**
- * Chat Orchestrator
- *
- * 核心职责：统一处理工具调用循环，所有 Provider 共享相同的逻辑
- */
-declare class ChatOrchestrator {
-    private config;
-    constructor(config: OrchestratorConfig);
-    /**
-     * 执行聊天
-     *
-     * @param adapter Provider 适配器
-     * @param message 用户消息
-     * @param context Orchestrator 上下文
-     * @param options 选项
-     */
-    chat(adapter: ProviderAdapter, message: string, context: OrchestratorContext, options: OrchestratorOptions): AsyncGenerator<ChatEvent>;
-    /**
-     * 构建标准化消息列表
-     */
-    private buildMessages;
-    /** 检测并执行上下文压缩，通过注入的 summarize 回调走 ai-server */
-    private compactIfNeeded;
-}
-/**
- * 创建 Orchestrator 实例
- */
-declare function createOrchestrator(config: OrchestratorConfig): ChatOrchestrator;
-
-declare const DEFAULT_MODEL: string;
-
-/**
- * 工具执行器
- */
-
-/**
- * 创建默认工具执行器（Node.js 环境）
- *
- * 用于执行 shell 命令，包含基本安全检查
- * 支持通过 AbortSignal 取消命令执行
- */
-declare function createDefaultToolExecutor(defaultCwd?: string): ToolExecutor$1;
-
-/**
- * 调试日志工具
- *
- * 通过 DebugLogger.enable(true) 全局开启，
- * 通过 DebugLogger.setLogFile(path) 同时写入 JSONL 文件，
- * 各模块通过 DebugLogger.module('Name') 创建带前缀的 logger。
- */
-declare class DebugLogger {
-    private prefix;
-    private constructor();
-    /** 全局启停调试日志 */
-    static enable(value: boolean): void;
-    /** 查询是否已启用 */
-    static isEnabled(): boolean;
-    /** 设置日志文件路径（JSONL 格式，追加写入） */
-    static setLogFile(filePath: string): void;
-    /** 创建模块专用 logger */
-    static module(name: string): DebugLogger;
-    debug(...args: unknown[]): void;
-    info(...args: unknown[]): void;
-    warn(...args: unknown[]): void;
-    error(...args: unknown[]): void;
-    private writeToFile;
-}
-
-export { type AdapterConfig, AgentConfig, AnthropicProtocol, ArkProtocol, ChatEvent, ChatMessage, ChatOptions, ChatOrchestrator, DEFAULT_MODEL, DebugLogger, DeepSeekProtocol, GeminiProtocol, HybridAgent, McpConnectionInfo, ModelFamilyConfig, ModelOption, OpenAIProtocol, type OrchestratorConfig, type OrchestratorContext, type OrchestratorOptions, type ToolExecutor as OrchestratorToolExecutor, type Protocol, type ProtocolConfig, type ProtocolMessage, type ProtocolToolCall, type ProtocolToolDefinition, type ProviderAdapter, QwenProtocol, type RawEvent, type RawEventType, type RawSearchResult, type RawToolCall, RouteResult, type RuntimeConfig, type SearchResultItem, type SimpleToolDefinition, type StandardMessage, type StreamChunk, type StreamChunkType, type StreamOnceOptions, type StreamOptions, Tool, type ToolCallRequest, ToolExecutor$1 as ToolExecutor, UnifiedAdapter, type UnifiedAdapterConfig, createAnthropicProtocol, createArkProtocol, createDeepSeekProtocol, createDefaultToolExecutor, createGeminiProtocol, createOpenAIProtocol, createOrchestrator, createQwenProtocol, createUnifiedAdapter };
+ * @huyooo/ai-chat-core
+ *
+ * AI Chat 核心包 — 环境无关，浏览器安全
+ *
+ * 分层架构：
+ * ┌─────────────────────────────────────────────────┐
+ * │  families/      模型行为差异（thinking/工具格式） │
+ * │  protocols/     HTTP/SSE 通信 + 协议标识          │
+ * ├─────────────────────────────────────────────────┤
+ * │  adapter/       协议路由 + 模型列表构建           │
+ * │  orchestrator/  工具调用循环 + 上下文压缩 + 类型   │
+ * ├─────────────────────────────────────────────────┤
+ * │  tool-manager/  统一工具管理（Provider + Manager） │
+ * │  skills/        技能注册表 + 管理 API             │
+ * │  parts/         UI 组件注册表 + 管理 API          │
+ * ├─────────────────────────────────────────────────┤
+ * │  governance/    资产治理策略（审批/副作用/命令安全）│
+ * │  extension/     扩展元数据类型 + 构建常量          │
+ * └─────────────────────────────────────────────────┘
+ *
+ * Node.js 宿主能力（文件操作 / 工具执行器 / LLM 配置加载）
+ * 均在 @huyooo/ai-chat-host-node 中提供。
+ */
+export { ChatRuntime, type RuntimeConfig } from './chat-runtime';
+export { MODEL_FAMILIES, DOUBAO_FAMILY, DEEPSEEK_FAMILY, QWEN_FAMILY, GEMINI_FAMILY, GPT_FAMILY, CLAUDE_FAMILY, resolveModelFamilyConfig, } from './families';
+export type { ModelFamilyId, ThinkingFormat, ToolCallFormat, ModelFamilyConfig, } from './families';
+export type { ProtocolId } from './protocols';
+export { getBaseProtocol } from './protocols';
+export { ModelAdapter } from './adapter';
+export { buildModelOptions, getModelContextConfigFromLLM, formatContextWindow, formatPricing, } from './adapter';
+export type { ModelOption, ModelContextConfig, } from './adapter';
+export type { ProviderAdapter, AdapterConfig, StreamOnceOptions, } from './adapter';
+export type { OrchestratorConfig, OrchestratorContext, OrchestratorOptions, OrchestratorToolExecutor, ToolExecutionHooks, GetAutoRunConfigCallback, } from './orchestrator';
+export { ArkProtocol, createArkProtocol, DeepSeekProtocol, createDeepSeekProtocol, QwenProtocol, createQwenProtocol, createVercelGatewayProtocol, AnthropicProtocol, createAnthropicProtocol, } from './protocols';
+export type { Protocol, ProtocolConfig, ProtocolAttachment, ProtocolMessage, ProtocolToolDefinition, RawEvent, RawEventType, RawOutputPart, RawToolCall, RawTokenUsage, } from './protocols';
+export { ChatOrchestrator, createOrchestrator } from './orchestrator';
+export type { AgentConfig, ChatOptions, ChatMode, ThinkingMode, AutoRunMode, AutoRunConfig, ToolExecutor, ToolDefinition, ChatMessage, ResponsesApiTool, Tool, ToolContext, DataEngineContext, ToolUI, RenderType, ActionType, ExecResult, ExecOptions, ToolResult, ToolSuccess, ToolExecuteResult, ToolError, ToolErrorCode, ToolErrorCategory, ToolPlugin, ToolConfigItem, ToolExecutionAuditHooks, UserToolDefinition, JsonSchemaObject, } from './types';
+export { resolveTools, tool, tools, ToolException, normalizeToolResult, serializeToolResult, isToolResult, toolOk, createResolvedOutputSchema, STANDARD_TOOL_ERROR_SCHEMA, resolveToolResultUi, mergeToolGovernance, resolveToolGovernanceSnapshot, throwToolError, isToolError, } from './types';
+export { DEFAULT_MODEL } from './constants';
+export type { ToolCallStatus, ToolCallInfo, TokenUsage, ErrorCategory, ErrorDetails, FinishReason, ToolFailureReason, } from './events';
+export type { ThinkingStartEvent, ThinkingDeltaEvent, ThinkingEndEvent, ThinkingEvent } from './events';
+export type { ToolCallStartEvent, ToolCallResultEvent, ToolCallOutputEvent, ToolApprovalRequestEvent, ToolCallRequestEvent, ToolEvent } from './events';
+export type { TextStartEvent, TextDeltaEvent, TextEndEvent, TextEvent } from './events';
+export type { DataEvent, } from './events';
+export type { PlanStep, PlanStepStatus, } from './events';
+export type { DoneEvent, ErrorEvent, AbortEvent, StatusEvent } from './events';
+export type { StepStartEvent, StepEndEvent, StepEvent } from './events';
+export type { ChatEvent, ChatEventType, AssistantSegmentReason, AssistantSegmentStartEvent, AssistantSegmentEvent, } from './events';
+export { createThinkingStart, createThinkingDelta, createThinkingEnd, createToolCallStart, createToolCallResult, createToolCallOutput, createToolCallRequest, createTextDelta, createDone, createError, createApiError, createRateLimitError, createToolError, createTimeoutError, createParseError, createAbort, createStepStart, createStepEnd, createAssistantSegmentStart, isThinkingEvent, isToolEvent, isTextEvent, isStatusEvent, isErrorEvent, isAbortEvent, isStepEvent, isAssistantSegmentEvent, isRetryableError, CHAT_EVENT_TYPES } from './events';
+export { Type } from '@sinclair/typebox';
+export type { Static, TSchema, TObject } from '@sinclair/typebox';
+export { createToolRuntimeManager, createInProcessProvider, createMcpProvider, createManagedToolSummary, createManagedToolDetail, createManagedMcpServerSummary, createManagedMcpServerDetail, defineTool, TOOL_FORMATS, validateJsonSchemaArgs, validateTypeBoxArgs, registerToolFormats, registerToolFormat, hasToolFormat, } from './tool-manager';
+export type { ToolDescriptor, ToolChangeEvent, ToolChangeListener, SessionToolsChangeEvent, SessionToolsChangeListener, ToolProvider, InProcessProvider, McpProviderExtended, McpServerConfig, McpConnectionStatus, McpConnectionInfo, ManagedToolSummary, ManagedToolDetail, ManagedMcpServerSummary, ManagedMcpServerDetail, ToolSearchQuery, CategorySummary, ProviderInfo, ToolRuntimeManager, TypeBoxToolConfig, ToolFormat, } from './tool-manager';
+export { skillRegistry } from './skills';
+export type { SkillRegistry } from './skills';
+export type { SkillMeta, SkillSearchQuery, ManagedSkillSummary, ManagedSkillDetail, } from './skills';
+export { skillManagementPlugin } from './skills';
+export { createManagedSkillSummary, createManagedSkillDetail } from './skills';
+export type { SkillManagementOptions, OnSkillCreate, OnSkillUpdate, OnSkillDelete, OnSkillSetEnabled, OnSkillLoadContent, OnSkillLoadReference, } from './skills';
+export { getRouteChain, resolveRouteUrl, findRouteByProtocol, } from './llm-config';
+export type { LLMConfig, ModelRoute, ModelConfig, ModelPricing, CompressionConfig, } from './llm-config';
+export { partRegistry } from './parts';
+export type { PartMeta, PartSearchQuery, PartRegistry, ManagedPartSummary, ManagedPartDetail, } from './parts';
+export { createManagedPartSummary, createManagedPartDetail } from './parts';
+export { analyzeCommandRisk, createAssetSummaryBase, createCommandGovernanceSnapshot, createCommandToolMetadata, createLocalMcpServerGovernance, createLocalToolGovernance, createPartAssetGovernance, readAssetGovernanceOverrides, toAssetGovernanceOverrides, } from './governance';
+export type { AssetApprovalPolicy, AssetExecutionIsolation, AssetGovernance, AssetGovernanceOverrides, AssetHostDependency, AssetKind, AssetRuntime, AssetScope, AssetSideEffectLevel, AssetSource, CommandRiskAssessment, CommandRiskTag, CommandSafetyPolicy, CommandToolMetadata, ManagedAssetSummaryBase, } from './governance';
+export type { AssetType, AssetMeta, AssetToolMeta, } from './extension';
+export { getRequiredString, getOptionalString, getBooleanWithDefault, getStringArray, getStringRecord, splitCommaSeparatedStrings, } from './internal/management-args';
+export { createCollectionResult, createInspectResult, createActionResult, createToggleResult, } from './internal/management-results';
+export { initLogger, getLogger, createModuleLogger } from './logger';
+export type { LogLevel, LoggerConfig } from './logger';
+//# sourceMappingURL=index.d.ts.map