@cicctencent/agent-core 0.1.1 → 0.1.4

package/dist/esm/llm/openai-provider.js

@@ -0,0 +1,182 @@
+/**
+ * @file OpenAI 兼容 LLM Provider
+ * @description 使用原生 fetch 实现，支持任意 OpenAI 兼容端点（OpenAI / DeepSeek / Ollama / vLLM 等）
+ */
+export class OpenAIProvider {
+    config;
+    constructor(config) {
+        this.config = {
+            ...config,
+            provider: config.provider || 'openai',
+            model: config.model || 'gpt-4',
+            baseUrl: config.baseUrl || 'https://api.openai.com/v1',
+            temperature: config.temperature ?? 0.7,
+            maxTokens: (typeof config.maxTokens === 'number' && config.maxTokens > 0) ? config.maxTokens : 4096,
+            timeout: config.timeout ?? 120000,
+        };
+    }
+    getModel() {
+        return {
+            provider: this.config.provider,
+            model: this.config.model,
+            contextWindow: 128000,
+            supportsTools: true,
+            supportsStreaming: true,
+        };
+    }
+    async ping() {
+        try {
+            const res = await this.doRequest({
+                model: this.config.model,
+                messages: [{ role: 'user', content: 'ping' }],
+                max_tokens: 5,
+            });
+            return res.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    async chat(params) {
+        const body = this.buildRequestBody(params, false);
+        const res = await this.doRequest(body, params.abortSignal);
+        if (!res.ok) {
+            const errText = await res.text().catch(() => 'Unknown error');
+            throw new Error(`LLM API error ${res.status}: ${errText}`);
+        }
+        const data = await res.json();
+        return {
+            choices: data.choices?.map((c) => ({
+                message: c.message,
+                finish_reason: c.finish_reason || 'stop',
+            })) || [],
+            usage: data.usage
+                ? {
+                    promptTokens: data.usage.prompt_tokens || 0,
+                    completionTokens: data.usage.completion_tokens || 0,
+                    totalTokens: data.usage.total_tokens || 0,
+                }
+                : undefined,
+        };
+    }
+    async *chatStream(params) {
+        const body = this.buildRequestBody(params, true);
+        const res = await this.doRequest(body, params.abortSignal);
+        if (!res.ok) {
+            const errText = await res.text().catch(() => 'Unknown error');
+            throw new Error(`LLM API error ${res.status}: ${errText}`);
+        }
+        const reader = res.body?.getReader();
+        if (!reader)
+            throw new Error('No response body');
+        const decoder = new TextDecoder();
+        let buffer = '';
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines) {
+                    const trimmed = line.trim();
+                    if (!trimmed || trimmed === 'data: [DONE]')
+                        continue;
+                    if (!trimmed.startsWith('data: '))
+                        continue;
+                    try {
+                        const json = JSON.parse(trimmed.slice(6));
+                        const delta = json.choices?.[0]?.delta;
+                        const finish = json.choices?.[0]?.finish_reason;
+                        // 解析 usage（通常在最后一个 chunk 中，stream_options.include_usage=true）
+                        if (json.usage) {
+                            yield {
+                                delta: {},
+                                finish_reason: finish || undefined,
+                                usage: {
+                                    promptTokens: json.usage.prompt_tokens || 0,
+                                    completionTokens: json.usage.completion_tokens || 0,
+                                    totalTokens: json.usage.total_tokens || 0,
+                                },
+                            };
+                            continue;
+                        }
+                        if (delta || finish) {
+                            yield {
+                                delta: {
+                                    content: delta?.content || null,
+                                    reasoning_content: delta?.reasoning_content || null,
+                                    role: delta?.role,
+                                    tool_calls: delta?.tool_calls,
+                                },
+                                finish_reason: finish || undefined,
+                            };
+                        }
+                    }
+                    catch {
+                        // skip malformed chunks
+                    }
+                }
+            }
+        }
+        finally {
+            reader.releaseLock();
+        }
+    }
+    /** 更新配置（如 API Key 变更后） */
+    updateConfig(updates) {
+        Object.assign(this.config, updates);
+    }
+    // ---- 内部方法 ----
+    buildRequestBody(params, stream) {
+        const body = {
+            model: this.config.model,
+            messages: params.messages,
+            temperature: params.temperature ?? this.config.temperature,
+            max_tokens: (typeof params.maxTokens === 'number' && params.maxTokens > 0)
+                ? params.maxTokens
+                : (typeof this.config.maxTokens === 'number' && this.config.maxTokens > 0)
+                    ? this.config.maxTokens
+                    : 4096,
+            stream,
+        };
+        if (params.tools?.length) {
+            body.tools = params.tools;
+            if (params.toolChoice)
+                body.tool_choice = params.toolChoice;
+        }
+        if (stream) {
+            body.stream_options = { include_usage: true };
+        }
+        return body;
+    }
+    async doRequest(body, signal) {
+        const url = `${this.config.baseUrl.replace(/\/$/, '')}/chat/completions`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.config.timeout);
+        // 合并外部 signal
+        if (signal) {
+            if (signal.aborted)
+                controller.abort();
+            else
+                signal.addEventListener('abort', () => controller.abort(), { once: true });
+        }
+        try {
+            return await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    ...(this.config.apiKey ? { Authorization: `Bearer ${this.config.apiKey}` } : {}),
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+                ...(this.config.proxy ? { dispatcher: this.config.proxy } : {}),
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/esm/llm/openai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.js","sourceRoot":"","sources":["../../../src/llm/openai-provider.ts"],"names":[],"mappings":"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"}

package/{src/llm/provider.ts → dist/esm/llm/provider.d.ts}

@@ -1,15 +1,7 @@
-// ============================================================
-// LLM Provider — 类型接口 + 实现 + 工厂
-// ============================================================
-
-// 类型接口
 export type { LLMProvider, ModelConfig, ModelInfo, ChatParams, ChatResponse, ChatChunk } from './types.ts';
-
-// 实现
 export { OpenAIProvider } from './openai-provider.ts';
 export { AnthropicProvider } from './anthropic-provider.ts';
 export { OllamaProvider } from './ollama-provider.ts';
-
-// 工厂
 export { createLLMProvider, BUILTIN_PROVIDERS } from './factory.ts';
 export type { BuiltinProvider } from './factory.ts';
+//# sourceMappingURL=provider.d.ts.map

package/dist/esm/llm/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../src/llm/provider.ts"],"names":[],"mappings":"AAKA,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG3G,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACpE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/llm/provider.js

@@ -0,0 +1,10 @@
+// ============================================================
+// LLM Provider — 类型接口 + 实现 + 工厂
+// ============================================================
+// 实现
+export { OpenAIProvider } from "./openai-provider.js";
+export { AnthropicProvider } from "./anthropic-provider.js";
+export { OllamaProvider } from "./ollama-provider.js";
+// 工厂
+export { createLLMProvider, BUILTIN_PROVIDERS } from "./factory.js";
+//# sourceMappingURL=provider.js.map

package/dist/esm/llm/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../../src/llm/provider.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gCAAgC;AAChC,+DAA+D;AAK/D,KAAK;AACL,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,KAAK;AACL,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/llm/types.d.ts

@@ -0,0 +1,78 @@
+import type { Message, TokenUsage } from '../types.ts';
+import type { ToolDefinition } from '../tool/types.ts';
+import type { Dispatcher } from 'undici';
+export interface ModelConfig {
+    /** 供应商标识：'openai' | 'anthropic' | 'azure' | 'ollama' | 自定义 */
+    provider: string;
+    /** 模型名称 */
+    model: string;
+    /** API Key */
+    apiKey?: string;
+    /** API Base URL（自定义端点） */
+    baseUrl?: string;
+    /** 温度参数，默认 0.7 */
+    temperature?: number;
+    /** 最大输出 token 数 */
+    maxTokens?: number;
+    /** 请求超时（毫秒） */
+    timeout?: number;
+    /** 供应商特定参数透传 */
+    extra?: Record<string, unknown>;
+    /** 网络代理 dispatcher（运行时注入，不持久化） */
+    proxy?: Dispatcher;
+}
+export interface ModelInfo {
+    provider: string;
+    model: string;
+    contextWindow: number;
+    supportsTools: boolean;
+    supportsStreaming: boolean;
+}
+/** LLM 推理请求参数 */
+export interface ChatParams {
+    messages: Message[];
+    /** 可用工具列表（OpenAI Function Calling 格式） */
+    tools?: ToolDefinition[];
+    /** 工具调用策略 */
+    toolChoice?: 'auto' | 'none' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    };
+    /** 覆盖 ModelConfig 中的 temperature */
+    temperature?: number;
+    /** 覆盖 ModelConfig 中的 maxTokens */
+    maxTokens?: number;
+    /** 中止信号 */
+    abortSignal?: AbortSignal;
+}
+/** LLM 推理响应 */
+export interface ChatResponse {
+    choices: Array<{
+        message: Message;
+        /** 结束原因：'stop' | 'tool_calls' | 'length' | 'content_filter' */
+        finish_reason: string;
+    }>;
+    usage?: TokenUsage;
+}
+/** 流式响应片段 */
+export interface ChatChunk {
+    /** 增量内容 */
+    delta: Partial<Message>;
+    finish_reason?: string;
+    /** Token 使用统计（仅最后一个 chunk 可能包含） */
+    usage?: TokenUsage;
+}
+/** LLM 供应商统一接口 */
+export interface LLMProvider {
+    /** 非流式推理 */
+    chat(params: ChatParams): Promise<ChatResponse>;
+    /** 流式推理（返回 AsyncGenerator 逐片段推送） */
+    chatStream(params: ChatParams): AsyncGenerator<ChatChunk>;
+    /** 获取当前模型信息 */
+    getModel(): ModelInfo;
+    /** 测试连接是否正常 */
+    ping(): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/llm/types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAIzC,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,KAAK,EAAE,MAAM,CAAC;IACd,cAAc;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,kCAAkC;IAClC,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAID,iBAAiB;AACjB,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,yCAAyC;IACzC,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAChF,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,+DAA+D;QAC/D,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,aAAa;AACb,MAAM,WAAW,SAAS;IACxB,WAAW;IACX,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAID,kBAAkB;AAClB,MAAM,WAAW,WAAW;IAC1B,YAAY;IACZ,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhD,oCAAoC;IACpC,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAE1D,eAAe;IACf,QAAQ,IAAI,SAAS,CAAC;IAEtB,eAAe;IACf,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B"}

package/dist/esm/llm/types.js

@@ -0,0 +1,5 @@
+// ============================================================
+// LLM Provider 类型定义
+// ============================================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/llm/types.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D"}

package/dist/esm/mcp/base-client.d.ts

@@ -0,0 +1,50 @@
+import type { MCPClient, MCPServerConfig } from './types.ts';
+import type { ToolDefinition } from '../tool/types.ts';
+/** JSON-RPC 请求 */
+interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** JSON-RPC 响应 */
+interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * MCPClient 抽象基类
+ * 子类只需实现 send() 和 doConnect() / doDisconnect()
+ */
+export declare abstract class MCPClientBase implements MCPClient {
+    protected config: MCPServerConfig;
+    protected connected: boolean;
+    private requestId;
+    /** 等待响应的 Promise 队列：id → { resolve, reject, timer } */
+    private pending;
+    /** 建立物理连接 */
+    protected abstract doConnect(config: MCPServerConfig): Promise<void>;
+    /** 断开物理连接 */
+    protected abstract doDisconnect(): void;
+    /** 发送 JSON-RPC 消息到 MCP 服务端 */
+    protected abstract send(request: JsonRpcRequest): void;
+    connect(config: MCPServerConfig): Promise<void>;
+    listTools(): Promise<ToolDefinition[]>;
+    callTool(name: string, args: Record<string, unknown>): Promise<string>;
+    disconnect(): void;
+    isConnected(): boolean;
+    /** 发送 JSON-RPC 请求并等待响应 */
+    protected call(method: string, params?: Record<string, unknown>): Promise<unknown>;
+    /** 发送 JSON-RPC 通知（无 id，无响应） */
+    protected notify(method: string, params?: Record<string, unknown>): void;
+    /** 子类收到 JSON-RPC 响应时调用此方法 */
+    protected handleResponse(data: JsonRpcResponse): void;
+}
+export {};
+//# sourceMappingURL=base-client.d.ts.map

package/dist/esm/mcp/base-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.d.ts","sourceRoot":"","sources":["../../../src/mcp/base-client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,kBAAkB;AAClB,UAAU,cAAc;IACtB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,kBAAkB;AAClB,UAAU,eAAe;IACvB,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED;;;GAGG;AACH,8BAAsB,aAAc,YAAW,SAAS;IACtD,SAAS,CAAC,MAAM,EAAG,eAAe,CAAC;IACnC,SAAS,CAAC,SAAS,UAAS;IAC5B,OAAO,CAAC,SAAS,CAAK;IACtB,uDAAuD;IACvD,OAAO,CAAC,OAAO,CAIV;IAIL,aAAa;IACb,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAEpE,aAAa;IACb,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI;IAEvC,8BAA8B;IAC9B,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIhD,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAe/C,SAAS,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IActC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAe5E,UAAU,IAAI,IAAI;IAWlB,WAAW,IAAI,OAAO;IAMtB,0BAA0B;IAC1B,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBlF,+BAA+B;IAC/B,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQxE,6BAA6B;IAC7B,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;CAatD"}

package/dist/esm/mcp/base-client.js

@@ -0,0 +1,108 @@
+// ============================================================
+// MCPClientBase — JSON-RPC 2.0 基础层
+// ============================================================
+/**
+ * MCPClient 抽象基类
+ * 子类只需实现 send() 和 doConnect() / doDisconnect()
+ */
+export class MCPClientBase {
+    config;
+    connected = false;
+    requestId = 0;
+    /** 等待响应的 Promise 队列：id → { resolve, reject, timer } */
+    pending = new Map();
+    // ---- 公共接口 ----
+    async connect(config) {
+        this.config = config;
+        await this.doConnect(config);
+        this.connected = true;
+        // MCP 协议握手
+        await this.call('initialize', {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'work_agent', version: '1.0.0' },
+        });
+        // 通知初始化完成
+        this.notify('notifications/initialized');
+    }
+    async listTools() {
+        const result = await this.call('tools/list', {});
+        if (!result?.tools)
+            return [];
+        return result.tools.map((t) => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description || '',
+                parameters: t.inputSchema || { type: 'object', properties: {} },
+            },
+        }));
+    }
+    async callTool(name, args) {
+        const result = await this.call('tools/call', { name, arguments: args });
+        if (result?.isError) {
+            const errMsg = result.content?.map(c => c.text || '').join('\n') || 'MCP tool returned error';
+            throw new Error(errMsg);
+        }
+        // 提取文本结果
+        return result?.content?.map(c => c.text || JSON.stringify(c)).join('\n') || '';
+    }
+    disconnect() {
+        // 拒绝所有等待中的请求
+        for (const [id, p] of this.pending) {
+            clearTimeout(p.timer);
+            p.reject(new Error('MCP client disconnected'));
+        }
+        this.pending.clear();
+        this.connected = false;
+        this.doDisconnect();
+    }
+    isConnected() {
+        return this.connected;
+    }
+    // ---- JSON-RPC 核心 ----
+    /** 发送 JSON-RPC 请求并等待响应 */
+    call(method, params) {
+        const id = ++this.requestId;
+        const timeout = this.config.timeout || 30000;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`MCP call '${method}' timed out after ${timeout}ms`));
+            }, timeout);
+            this.pending.set(id, { resolve, reject, timer });
+            try {
+                this.send({ jsonrpc: '2.0', id, method, params });
+            }
+            catch (e) {
+                clearTimeout(timer);
+                this.pending.delete(id);
+                reject(e);
+            }
+        });
+    }
+    /** 发送 JSON-RPC 通知（无 id，无响应） */
+    notify(method, params) {
+        try {
+            this.send({ jsonrpc: '2.0', id: 0, method, params });
+        }
+        catch {
+            // 通知失败静默忽略
+        }
+    }
+    /** 子类收到 JSON-RPC 响应时调用此方法 */
+    handleResponse(data) {
+        const pending = this.pending.get(data.id);
+        if (!pending)
+            return;
+        this.pending.delete(data.id);
+        clearTimeout(pending.timer);
+        if (data.error) {
+            pending.reject(new Error(`MCP error ${data.error.code}: ${data.error.message}`));
+        }
+        else {
+            pending.resolve(data.result);
+        }
+    }
+}
+//# sourceMappingURL=base-client.js.map

package/dist/esm/mcp/base-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-client.js","sourceRoot":"","sources":["../../../src/mcp/base-client.ts"],"names":[],"mappings":"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"}

package/dist/esm/mcp/client.d.ts

@@ -0,0 +1,27 @@
+import type { MCPClient } from './types.ts';
+import type { ToolRegistry } from '../tool/registry.ts';
+/** MCP 工具名前缀，用于与 builtin/skill 等工具区分 */
+export declare const MCP_TOOL_PREFIX = "mcp_";
+/**
+ * 将名称中的非安全字符替换为下划线，确保可安全用于工具名拼接
+ */
+export declare function sanitizeForToolName(name: string): string;
+/**
+ * 构建带命名空间的 MCP 工具名
+ *
+ * - 连接器工具：`mcp_{connectorId}_{serverName}_{toolName}`
+ * - 独立工具：`mcp_{serverName}_{toolName}`
+ *
+ * 命名空间从根源上解决多 MCP 服务器工具名冲突问题。
+ */
+export declare function buildMCPToolName(toolName: string, serverName: string, connectorId?: string): string;
+/**
+ * 将 MCP 服务的远程工具批量注册到 ToolRegistry
+ *
+ * 工具名自动添加命名空间前缀 `mcp_[{connectorId}_]{serverName}_{toolName}`，
+ * 避免多 MCP 服务器间工具名冲突。调用 MCP 服务时使用原始名字。
+ *
+ * @param connectorId 连接器 ID（公有 MCP 服务器传 undefined，连接器私有传连接器 ID）
+ */
+export declare function registerMCPTools(registry: ToolRegistry, mcpClient: MCPClient, serverName: string, connectorId?: string, serverId?: number | string): Promise<void>;
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/mcp/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/mcp/client.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wCAAwC;AACxC,eAAO,MAAM,eAAe,SAAS,CAAC;AAEtC;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQnG;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,YAAY,EACtB,SAAS,EAAE,SAAS,EACpB,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GACzB,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/esm/mcp/client.js

@@ -0,0 +1,70 @@
+// ============================================================
+// MCP Client — 工具自动注册辅助函数
+// ============================================================
+/** MCP 工具名前缀，用于与 builtin/skill 等工具区分 */
+export const MCP_TOOL_PREFIX = 'mcp_';
+/**
+ * 将名称中的非安全字符替换为下划线，确保可安全用于工具名拼接
+ */
+export function sanitizeForToolName(name) {
+    return name
+        .replace(/[^a-zA-Z0-9_]/g, '_') // 非安全字符 → _
+        .replace(/_+/g, '_') // 合并连续下划线
+        .replace(/^_|_$/g, ''); // 去除首尾下划线
+}
+/**
+ * 构建带命名空间的 MCP 工具名
+ *
+ * - 连接器工具：`mcp_{connectorId}_{serverName}_{toolName}`
+ * - 独立工具：`mcp_{serverName}_{toolName}`
+ *
+ * 命名空间从根源上解决多 MCP 服务器工具名冲突问题。
+ */
+export function buildMCPToolName(toolName, serverName, connectorId) {
+    const safeTool = sanitizeForToolName(toolName);
+    const safeServer = sanitizeForToolName(serverName);
+    if (connectorId) {
+        const safeConn = sanitizeForToolName(connectorId);
+        return `${MCP_TOOL_PREFIX}${safeConn}_${safeServer}_${safeTool}`;
+    }
+    return `${MCP_TOOL_PREFIX}${safeServer}_${safeTool}`;
+}
+/**
+ * 将 MCP 服务的远程工具批量注册到 ToolRegistry
+ *
+ * 工具名自动添加命名空间前缀 `mcp_[{connectorId}_]{serverName}_{toolName}`，
+ * 避免多 MCP 服务器间工具名冲突。调用 MCP 服务时使用原始名字。
+ *
+ * @param connectorId 连接器 ID（公有 MCP 服务器传 undefined，连接器私有传连接器 ID）
+ */
+export async function registerMCPTools(registry, mcpClient, serverName, connectorId, serverId) {
+    const remoteTools = await mcpClient.listTools();
+    console.log(`[MCP] registerMCPTools for '${serverName}' (connector=${connectorId || 'none'}): ${remoteTools.length} tools — ${remoteTools.map(t => t.function.name).join(', ')}`);
+    for (const def of remoteTools) {
+        const originalName = def.function.name;
+        const prefixedName = buildMCPToolName(originalName, serverName, connectorId);
+        registry.register({
+            definition: {
+                ...def,
+                function: { ...def.function, name: prefixedName },
+            },
+            executor: async (args) => {
+                console.log(`[MCP] executor '${prefixedName}' called (server=${serverName})`);
+                console.log(`  → args: ${JSON.stringify(args)}`);
+                try {
+                    const result = await mcpClient.callTool(originalName, args);
+                    console.log(`  ← result (${result.length} chars): ${result.substring(0, 200)}${result.length > 200 ? '...' : ''}`);
+                    return result;
+                }
+                catch (e) {
+                    console.error(`  ✗ executor '${prefixedName}' failed: ${e?.message || e}`);
+                    throw e;
+                }
+            },
+            category: 'mcp',
+            concurrent: true, // MCP 工具默认可并发（纯网络请求）
+            metadata: { mcpServer: serverName, serverId, originalName, connectorId },
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/mcp/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/mcp/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/mcp/factory.d.ts

@@ -0,0 +1,16 @@
+import type { MCPClient, MCPServerConfig } from './types.ts';
+/** 自定义 transport 工厂函数签名 */
+export type TransportFactory = () => MCPClient;
+/**
+ * 注册自定义 transport 工厂
+ * 上层应用通过此方法扩展 core 层不内置的 transport 类型（如 api-bridge）
+ */
+export declare function registerTransport(transport: string, factory: TransportFactory): void;
+/**
+ * 根据 MCPServerConfig.transport 创建对应的 MCPClient 实例
+ *
+ * 内置支持：stdio / http / sse
+ * 自定义 transport：通过 registerTransport 注册后支持
+ */
+export declare function createMCPClient(config: MCPServerConfig): MCPClient;
+//# sourceMappingURL=factory.d.ts.map

package/dist/esm/mcp/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/mcp/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI7D,2BAA2B;AAC3B,MAAM,MAAM,gBAAgB,GAAG,MAAM,SAAS,CAAC;AAK/C;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAGpF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAclE"}