@cicctencent/agent-core 0.1.1 → 0.1.3

package/dist/esm/mcp/factory.js

@@ -0,0 +1,39 @@
+// ============================================================
+// MCPClient Factory — 根据 transport 类型创建对应 Client
+// 支持上层应用通过 registerTransport 注册自定义 transport
+// ============================================================
+import { StdioMCPClient } from "./stdio-client.js";
+import { HttpMCPClient } from "./http-client.js";
+/** 已注册的自定义 transport 工厂映射 */
+const customTransports = new Map();
+/**
+ * 注册自定义 transport 工厂
+ * 上层应用通过此方法扩展 core 层不内置的 transport 类型（如 api-bridge）
+ */
+export function registerTransport(transport, factory) {
+    customTransports.set(transport, factory);
+    console.log(`[MCP Factory] registered custom transport: ${transport}`);
+}
+/**
+ * 根据 MCPServerConfig.transport 创建对应的 MCPClient 实例
+ *
+ * 内置支持：stdio / http / sse
+ * 自定义 transport：通过 registerTransport 注册后支持
+ */
+export function createMCPClient(config) {
+    switch (config.transport) {
+        case 'stdio':
+            return new StdioMCPClient();
+        case 'http':
+        case 'sse':
+        case 'streamableHttp':
+            return new HttpMCPClient();
+        default: {
+            const factory = customTransports.get(config.transport);
+            if (factory)
+                return factory();
+            throw new Error(`Unsupported MCP transport: ${config.transport}`);
+        }
+    }
+}
+//# sourceMappingURL=factory.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../src/mcp/factory.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,iDAAiD;AACjD,6CAA6C;AAC7C,+DAA+D;AAG/D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKjD,6BAA6B;AAC7B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAA4B,CAAC;AAE7D;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,OAAyB;IAC5E,gBAAgB,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,8CAA8C,SAAS,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,QAAQ,MAAM,CAAC,SAAS,EAAE,CAAC;QACzB,KAAK,OAAO;YACV,OAAO,IAAI,cAAc,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC;QACZ,KAAK,KAAK,CAAC;QACX,KAAK,gBAAgB;YACnB,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACvD,IAAI,OAAO;gBAAE,OAAO,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,24 @@
+import { MCPClientBase } from './base-client.ts';
+import type { MCPServerConfig } from './types.ts';
+export declare class HttpMCPClient extends MCPClientBase {
+    private endpoint;
+    private sessionId?;
+    private dispatcher?;
+    /** 用户自定义请求头（如 Authorization） */
+    private customHeaders?;
+    /** 结构化鉴权配置 */
+    private authConfig?;
+    protected doConnect(config: MCPServerConfig): Promise<void>;
+    protected doDisconnect(): void;
+    /** 根据 auth 配置生成鉴权请求头 */
+    private buildAuthHeaders;
+    protected send(request: {
+        jsonrpc: string;
+        id: number;
+        method: string;
+        params?: Record<string, unknown>;
+    }): void;
+    /** 解析 SSE 文本块中的 JSON-RPC 响应 */
+    private parseSSE;
+}
+//# sourceMappingURL=http-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/mcp/http-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAIlD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,gCAAgC;IAChC,OAAO,CAAC,aAAa,CAAC,CAAyB;IAC/C,cAAc;IACd,OAAO,CAAC,UAAU,CAAC,CAAiD;cAEpD,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjE,SAAS,CAAC,YAAY,IAAI,IAAI;IAW9B,wBAAwB;IACxB,OAAO,CAAC,gBAAgB;IAkBxB,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAuEhH,+BAA+B;IAC/B,OAAO,CAAC,QAAQ;CAkBjB"}

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

@@ -0,0 +1,138 @@
+// ============================================================
+// HttpMCPClient — HTTP / SSE 传输的 MCP 客户端
+// ============================================================
+import { MCPClientBase } from "./base-client.js";
+import { resolveProxyAgentForCategory } from "./proxy-agent.js";
+export class HttpMCPClient extends MCPClientBase {
+    endpoint = '';
+    sessionId;
+    dispatcher;
+    /** 用户自定义请求头（如 Authorization） */
+    customHeaders;
+    /** 结构化鉴权配置 */
+    authConfig;
+    async doConnect(config) {
+        if (!config.endpoint) {
+            throw new Error(`${config.transport} transport requires an "endpoint" URL in config`);
+        }
+        this.endpoint = config.endpoint;
+        this.dispatcher = resolveProxyAgentForCategory(config.proxyCategory, 'MCP:HTTP');
+        this.customHeaders = config.headers;
+        this.authConfig = config.auth;
+    }
+    doDisconnect() {
+        this.endpoint = '';
+        this.sessionId = undefined;
+        this.customHeaders = undefined;
+        this.authConfig = undefined;
+        if (this.dispatcher && typeof this.dispatcher.close === 'function') {
+            this.dispatcher.close().catch(() => { });
+        }
+        this.dispatcher = undefined;
+    }
+    /** 根据 auth 配置生成鉴权请求头 */
+    buildAuthHeaders() {
+        if (!this.authConfig)
+            return {};
+        const { type, value, name } = this.authConfig;
+        switch (type) {
+            case 'bearer':
+                return { Authorization: `Bearer ${value}` };
+            case 'basic':
+                // value 已是 base64(user:pass) 编码
+                return { Authorization: `Basic ${value}` };
+            case 'apiKey':
+                return { [name || 'X-API-Key']: value };
+            case 'custom':
+                return { [name || 'X-Custom-Auth']: value };
+            default:
+                return {};
+        }
+    }
+    send(request) {
+        // 通知（id=0）不需要响应，用 fire-and-forget
+        const isNotification = request.id === 0;
+        const headers = {
+            'Content-Type': 'application/json',
+            'Accept': 'application/json, text/event-stream',
+        };
+        // MCP SSE/StreamableHTTP 传输可能返回 session id
+        if (this.sessionId) {
+            headers['Mcp-Session-Id'] = this.sessionId;
+        }
+        // 注入结构化鉴权头（优先于自定义 headers，确保鉴权不被覆盖）
+        Object.assign(headers, this.buildAuthHeaders());
+        // 注入用户自定义请求头（最后注入，允许覆盖默认值）
+        if (this.customHeaders) {
+            Object.assign(headers, this.customHeaders);
+        }
+        const body = JSON.stringify(request);
+        // 使用 fetch（Node 18+ 内置），注入 proxy dispatcher
+        fetch(this.endpoint, {
+            method: 'POST',
+            headers,
+            body,
+            signal: isNotification ? AbortSignal.timeout(10000) : undefined,
+            ...(this.dispatcher ? { dispatcher: this.dispatcher } : {}),
+        }).then(async (res) => {
+            if (isNotification)
+                return;
+            // 捕获 session id
+            const sessionId = res.headers.get('mcp-session-id');
+            if (sessionId)
+                this.sessionId = sessionId;
+            // 检查 HTTP 错误状态码
+            if (!res.ok) {
+                const errBody = await res.text().catch(() => '');
+                console.error(`[MCP:HTTP] Server returned ${res.status} ${res.statusText} for id=${request.id}: ${errBody.substring(0, 500)}`);
+                this.handleResponse({
+                    jsonrpc: '2.0',
+                    id: request.id,
+                    error: { code: -32000, message: `HTTP ${res.status}: ${errBody.substring(0, 200)}` },
+                });
+                return;
+            }
+            const contentType = res.headers.get('content-type') || '';
+            if (contentType.includes('text/event-stream')) {
+                // SSE 响应：解析事件流中的 JSON-RPC 响应
+                const text = await res.text();
+                this.parseSSE(text);
+            }
+            else {
+                // 普通 JSON 响应
+                const data = await res.json();
+                this.handleResponse(data);
+            }
+        }).catch((err) => {
+            if (isNotification)
+                return;
+            // 通知 handleResponse 超时由 pending 的 timer 负责
+            // 此处仅打日志
+            if (!isNotification) {
+                console.debug(`[MCP:HTTP] Request failed for id=${request.id}:`, err.message);
+            }
+        });
+    }
+    /** 解析 SSE 文本块中的 JSON-RPC 响应 */
+    parseSSE(text) {
+        // 支持 \r\n 和 \n 行分隔符
+        const lines = text.replace(/\r\n/g, '\n').split('\n');
+        for (const line of lines) {
+            if (line.startsWith('data:')) {
+                const jsonStr = line.slice(5).trim();
+                if (!jsonStr)
+                    continue;
+                try {
+                    const data = JSON.parse(jsonStr);
+                    if (data.id !== undefined && data.id !== 0) {
+                        this.handleResponse(data);
+                    }
+                }
+                catch {
+                    // 非 JSON data 忽略
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=http-client.js.map

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

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

package/dist/esm/mcp/proxy-agent.d.ts

@@ -0,0 +1,49 @@
+import { type Dispatcher } from 'undici';
+/** 代理模式：system=系统代理, custom=自定义, direct=直连 */
+export type ProxyMode = 'system' | 'custom' | 'direct';
+/** 单分类代理配置 */
+export interface ProxyCategoryConfig {
+    mode: ProxyMode;
+    /** mode='custom' 时的代理 URL */
+    url?: string;
+}
+/** 分类代理设置（LLM / MCP / Fetch 各自独立） */
+export interface ProxySettings {
+    llm: ProxyCategoryConfig;
+    mcp: ProxyCategoryConfig;
+    fetch: ProxyCategoryConfig;
+}
+/** 默认代理设置：全部分类走系统代理 */
+export declare const DEFAULT_PROXY_SETTINGS: ProxySettings;
+/**
+ * 从 Windows 注册表读取系统代理配置
+ * 仅 Windows 平台生效，其他平台返回 undefined
+ * 结果缓存，避免重复查询注册表
+ */
+export declare function getWindowsSystemProxy(): string | undefined;
+/** 清除系统代理缓存（设置变更时可调用） */
+export declare function clearSystemProxyCache(): void;
+/**
+ * 获取系统代理 URL
+ * 优先级：环境变量 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY > macOS scutil > Windows 注册表
+ */
+export declare function getSystemProxyUrl(): string | undefined;
+/**
+ * 根据分类代理配置创建 dispatcher
+ *
+ * - `mode='system'`：自动检测系统代理（环境变量 + Windows 注册表）
+ * - `mode='custom'`：使用用户指定的代理 URL
+ * - `mode='direct'`：不走代理，返回 undefined
+ *
+ * @param category 分类代理配置
+ * @param label 日志标签（如 'LLM', 'MCP', 'Fetch'）
+ * @returns dispatcher 实例，无代理时返回 undefined
+ */
+export declare function resolveProxyAgentForCategory(category?: ProxyCategoryConfig, label?: string): Dispatcher | undefined;
+/**
+ * 获取分类代理的有效 URL（用于 axios 等不支持 undici Dispatcher 的场景）
+ *
+ * @returns 代理 URL 字符串，无代理时返回 undefined
+ */
+export declare function resolveProxyUrlForCategory(category?: ProxyCategoryConfig): string | undefined;
+//# sourceMappingURL=proxy-agent.d.ts.map

package/dist/esm/mcp/proxy-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-agent.d.ts","sourceRoot":"","sources":["../../../src/mcp/proxy-agent.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAMrD,8CAA8C;AAC9C,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvD,cAAc;AACd,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAC;IAChB,6BAA6B;IAC7B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,mBAAmB,CAAC;IACzB,GAAG,EAAE,mBAAmB,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,uBAAuB;AACvB,eAAO,MAAM,sBAAsB,EAAE,aAIpC,CAAC;AAkDF;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAkC1D;AAED,yBAAyB;AACzB,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAStD;AA2BD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,CAAC,EAAE,mBAAmB,EAC9B,KAAK,SAAU,GACd,UAAU,GAAG,SAAS,CAyBxB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,CAAC,EAAE,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAY7F"}

package/dist/esm/mcp/proxy-agent.js

@@ -0,0 +1,187 @@
+// ============================================================
+// Proxy Agent — 通用 HTTP/HTTPS/SOCKS 代理解析工具
+// ============================================================
+import { ProxyAgent } from 'undici';
+import { SocksProxyAgent } from 'socks-proxy-agent';
+import { execSync } from 'child_process';
+/** 默认代理设置：全部分类走系统代理 */
+export const DEFAULT_PROXY_SETTINGS = {
+    llm: { mode: 'system' },
+    mcp: { mode: 'system' },
+    fetch: { mode: 'system' },
+};
+// ---- macOS 系统代理检测 ----
+/**
+ * 从 macOS 系统偏好设置读取代理配置
+ * 通过 scutil --proxy 查询，仅 macOS 平台生效
+ */
+function getMacOSSystemProxy() {
+    if (process.platform !== 'darwin')
+        return undefined;
+    try {
+        const output = execSync('scutil --proxy', { encoding: 'utf-8', timeout: 3000 });
+        const parsed = {};
+        // scutil 输出格式: "  Key : Value"
+        for (const line of output.split('\n')) {
+            const m = line.trim().match(/^(\w+)\s*:\s*(.+)$/);
+            if (m)
+                parsed[m[1]] = m[2].trim();
+        }
+        // 优先 HTTPS 代理，其次 HTTP 代理，最后 SOCKS 代理
+        if (parsed['HTTPSEnable'] === '1' && parsed['HTTPSProxy']) {
+            const port = parsed['HTTPSPort'] || '443';
+            const url = `http://${parsed['HTTPSProxy']}:${port}`;
+            console.debug(`[Proxy] macOS system HTTPS proxy detected: ${url}`);
+            return url;
+        }
+        if (parsed['HTTPEnable'] === '1' && parsed['HTTPProxy']) {
+            const port = parsed['HTTPPort'] || '80';
+            const url = `http://${parsed['HTTPProxy']}:${port}`;
+            console.debug(`[Proxy] macOS system HTTP proxy detected: ${url}`);
+            return url;
+        }
+        if (parsed['SOCKSEnable'] === '1' && parsed['SOCKSProxy']) {
+            const port = parsed['SOCKSPort'] || '1080';
+            const url = `socks5://${parsed['SOCKSProxy']}:${port}`;
+            console.debug(`[Proxy] macOS system SOCKS proxy detected: ${url}`);
+            return url;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ---- Windows 系统代理检测 ----
+let _cachedSystemProxy = null;
+/**
+ * 从 Windows 注册表读取系统代理配置
+ * 仅 Windows 平台生效，其他平台返回 undefined
+ * 结果缓存，避免重复查询注册表
+ */
+export function getWindowsSystemProxy() {
+    if (_cachedSystemProxy !== null)
+        return _cachedSystemProxy || undefined;
+    if (process.platform !== 'win32') {
+        _cachedSystemProxy = undefined;
+        return undefined;
+    }
+    try {
+        const regPath = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings';
+        const output = execSync(`reg query "${regPath}" /v ProxyEnable`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
+        const enabledMatch = output.match(/ProxyEnable\s+REG_DWORD\s+0x(\d+)/i);
+        if (!enabledMatch || enabledMatch[1] === '0') {
+            _cachedSystemProxy = undefined;
+            return undefined;
+        }
+        const serverOutput = execSync(`reg query "${regPath}" /v ProxyServer`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
+        const serverMatch = serverOutput.match(/ProxyServer\s+REG_SZ\s+(.+)/i);
+        if (!serverMatch) {
+            _cachedSystemProxy = undefined;
+            return undefined;
+        }
+        const proxyServer = serverMatch[1].trim();
+        // Windows 代理可能是 ip:port 格式，需要补全协议
+        const proxyUrl = proxyServer.includes('://') ? proxyServer : `http://${proxyServer}`;
+        _cachedSystemProxy = proxyUrl;
+        console.debug(`[Proxy] Windows system proxy detected: ${proxyUrl}`);
+        return proxyUrl;
+    }
+    catch {
+        _cachedSystemProxy = undefined;
+        return undefined;
+    }
+}
+/** 清除系统代理缓存（设置变更时可调用） */
+export function clearSystemProxyCache() {
+    _cachedSystemProxy = null;
+}
+/**
+ * 获取系统代理 URL
+ * 优先级：环境变量 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY > macOS scutil > Windows 注册表
+ */
+export function getSystemProxyUrl() {
+    return process.env.HTTPS_PROXY
+        || process.env.https_proxy
+        || process.env.HTTP_PROXY
+        || process.env.http_proxy
+        || process.env.ALL_PROXY
+        || process.env.all_proxy
+        || getMacOSSystemProxy()
+        || getWindowsSystemProxy();
+}
+// ---- Dispatcher 创建 ----
+/**
+ * 根据代理 URL 创建对应的 dispatcher
+ *
+ * 自动识别协议：
+ * - `http://proxy:8080`  → undici ProxyAgent（HTTP 代理）
+ * - `https://proxy:8443` → undici ProxyAgent（HTTPS 代理）
+ * - `socks5://proxy:1080`→ SocksProxyAgent（SOCKS5）
+ * - `socks4://proxy:1080`→ SocksProxyAgent（SOCKS4）
+ *
+ * @returns dispatcher 实例，无代理时返回 undefined
+ */
+function createDispatcherFromUrl(proxyUrl, label = 'Proxy') {
+    if (proxyUrl.startsWith('socks')) {
+        console.debug(`[${label}] using SOCKS proxy: ${proxyUrl}`);
+        return new SocksProxyAgent(proxyUrl);
+    }
+    console.debug(`[${label}] using HTTP proxy: ${proxyUrl}`);
+    return new ProxyAgent(proxyUrl);
+}
+// ---- 新版分类代理解析 ----
+/**
+ * 根据分类代理配置创建 dispatcher
+ *
+ * - `mode='system'`：自动检测系统代理（环境变量 + Windows 注册表）
+ * - `mode='custom'`：使用用户指定的代理 URL
+ * - `mode='direct'`：不走代理，返回 undefined
+ *
+ * @param category 分类代理配置
+ * @param label 日志标签（如 'LLM', 'MCP', 'Fetch'）
+ * @returns dispatcher 实例，无代理时返回 undefined
+ */
+export function resolveProxyAgentForCategory(category, label = 'Proxy') {
+    if (!category)
+        return undefined;
+    switch (category.mode) {
+        case 'direct':
+            console.debug(`[${label}] proxy mode: direct (no proxy)`);
+            return undefined;
+        case 'custom':
+            if (!category.url) {
+                console.debug(`[${label}] proxy mode: custom but no URL configured, falling back to direct`);
+                return undefined;
+            }
+            return createDispatcherFromUrl(category.url, label);
+        case 'system':
+        default: {
+            const systemUrl = getSystemProxyUrl();
+            if (!systemUrl) {
+                console.debug(`[${label}] proxy mode: system, no system proxy detected`);
+                return undefined;
+            }
+            return createDispatcherFromUrl(systemUrl, label);
+        }
+    }
+}
+/**
+ * 获取分类代理的有效 URL（用于 axios 等不支持 undici Dispatcher 的场景）
+ *
+ * @returns 代理 URL 字符串，无代理时返回 undefined
+ */
+export function resolveProxyUrlForCategory(category) {
+    if (!category)
+        return undefined;
+    switch (category.mode) {
+        case 'direct':
+            return undefined;
+        case 'custom':
+            return category.url || undefined;
+        case 'system':
+        default:
+            return getSystemProxyUrl();
+    }
+}
+//# sourceMappingURL=proxy-agent.js.map

package/dist/esm/mcp/proxy-agent.js.map

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

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

@@ -0,0 +1,16 @@
+import { MCPClientBase } from './base-client.ts';
+import type { MCPServerConfig } from './types.ts';
+export declare class StdioMCPClient extends MCPClientBase {
+    private process;
+    private buffer;
+    protected doConnect(config: MCPServerConfig): Promise<void>;
+    protected doDisconnect(): void;
+    protected send(request: {
+        jsonrpc: string;
+        id: number;
+        method: string;
+        params?: Record<string, unknown>;
+    }): void;
+    private flushBuffer;
+}
+//# sourceMappingURL=stdio-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-client.d.ts","sourceRoot":"","sources":["../../../src/mcp/stdio-client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAM;cAEJ,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDjE,SAAS,CAAC,YAAY,IAAI,IAAI;IAQ9B,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI;IAgBhH,OAAO,CAAC,WAAW;CAkBpB"}

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

@@ -0,0 +1,91 @@
+// ============================================================
+// StdioMCPClient — 通过子进程 stdio 通信的 MCP 客户端
+// ============================================================
+import { spawn } from 'child_process';
+import { MCPClientBase } from "./base-client.js";
+export class StdioMCPClient extends MCPClientBase {
+    process = null;
+    buffer = '';
+    async doConnect(config) {
+        if (!config.command) {
+            throw new Error('stdio transport requires a "command" in config');
+        }
+        return new Promise((resolve, reject) => {
+            const child = spawn(config.command, config.args || [], {
+                env: { ...process.env, ...(config.env || {}) },
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            this.process = child;
+            // 超时检查
+            const timer = setTimeout(() => {
+                reject(new Error(`stdio MCP server '${config.name}' failed to start within 10s`));
+            }, 10000);
+            child.on('spawn', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+            child.on('error', (err) => {
+                clearTimeout(timer);
+                reject(new Error(`Failed to start MCP server '${config.name}': ${err.message}`));
+            });
+            // stdout 接收 JSON-RPC 响应（逐行）
+            child.stdout?.on('data', (chunk) => {
+                this.buffer += chunk.toString();
+                this.flushBuffer();
+            });
+            // stderr 用于日志
+            child.stderr?.on('data', (chunk) => {
+                const msg = chunk.toString().trim();
+                if (msg)
+                    console.debug(`[MCP:${config.name}] ${msg}`);
+            });
+            child.on('exit', (code) => {
+                if (this.connected) {
+                    console.warn(`[MCP:${config.name}] process exited with code ${code}`);
+                    this.connected = false;
+                }
+            });
+        });
+    }
+    doDisconnect() {
+        if (this.process) {
+            this.process.kill('SIGTERM');
+            this.process = null;
+        }
+        this.buffer = '';
+    }
+    send(request) {
+        if (!this.process?.stdin?.writable) {
+            throw new Error('MCP stdio process is not writable');
+        }
+        // 通知 (id=0) 不发 content-length，用 JSON-RPC notification 格式
+        if (request.id === 0) {
+            const msg = JSON.stringify({ jsonrpc: request.jsonrpc, method: request.method, params: request.params });
+            this.process.stdin.write(msg + '\n');
+            return;
+        }
+        const msg = JSON.stringify(request);
+        this.process.stdin.write(msg + '\n');
+    }
+    // ---- 内部 ----
+    flushBuffer() {
+        const lines = this.buffer.split('\n');
+        this.buffer = lines.pop() || ''; // 最后一行可能不完整
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                const data = JSON.parse(trimmed);
+                // 只处理有 id 的响应（非 notification）
+                if (data.id !== undefined && data.id !== 0) {
+                    this.handleResponse(data);
+                }
+            }
+            catch {
+                // 非 JSON 行忽略
+            }
+        }
+    }
+}
+//# sourceMappingURL=stdio-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-client.js","sourceRoot":"","sources":["../../../src/mcp/stdio-client.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2CAA2C;AAC3C,+DAA+D;AAE/D,OAAO,EAAE,KAAK,EAAqB,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,MAAM,OAAO,cAAe,SAAQ,aAAa;IACvC,OAAO,GAAwB,IAAI,CAAC;IACpC,MAAM,GAAG,EAAE,CAAC;IAEV,KAAK,CAAC,SAAS,CAAC,MAAuB;QAC/C,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAQ,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,EAAE;gBACtD,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE;gBAC9C,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAChC,CAAC,CAAC;YAEH,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;YAErB,OAAO;YACP,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,MAAM,CAAC,IAAI,8BAA8B,CAAC,CAAC,CAAC;YACpF,CAAC,EAAE,KAAK,CAAC,CAAC;YAEV,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;gBACrB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACxB,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACnF,CAAC,CAAC,CAAC;YAEH,4BAA4B;YAC5B,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,IAAI,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAChC,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;YAEH,cAAc;YACd,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;gBACzC,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,GAAG;oBAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC,CAAC;YACxD,CAAC,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;gBACxB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;oBACnB,OAAO,CAAC,IAAI,CAAC,QAAQ,MAAM,CAAC,IAAI,8BAA8B,IAAI,EAAE,CAAC,CAAC;oBACtE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;gBACzB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAES,YAAY;QACpB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAES,IAAI,CAAC,OAA0F;QACvG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACvD,CAAC;QACD,yDAAyD;QACzD,IAAI,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACzG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,eAAe;IAEP,WAAW;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,YAAY;QAE7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;gBACjC,8BAA8B;gBAC9B,IAAI,IAAI,CAAC,EAAE,KAAK,SAAS,IAAI,IAAI,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;oBAC3C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,aAAa;YACf,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,60 @@
+import type { ToolDefinition } from '../tool/types.ts';
+import type { ProxyCategoryConfig } from './proxy-agent.ts';
+export type MCPTransport = 'stdio' | 'http' | 'sse' | 'streamableHttp' | (string & {});
+export interface MCPServerConfig {
+    name: string;
+    transport: MCPTransport;
+    /** stdio 模式：启动命令 */
+    command?: string;
+    /** stdio 模式：命令参数 */
+    args?: string[];
+    /** stdio 模式：环境变量 */
+    env?: Record<string, string>;
+    /** HTTP/SSE/StreamableHTTP 模式：服务端点 */
+    endpoint?: string;
+    /** HTTP/SSE/StreamableHTTP 模式：自定义请求头（如 Authorization） */
+    headers?: Record<string, string>;
+    /** HTTP/SSE/StreamableHTTP 模式：结构化鉴权配置（bearer/basic/apiKey/custom） */
+    auth?: {
+        type: 'bearer' | 'basic' | 'apiKey' | 'custom';
+        value: string;
+        name?: string;
+    };
+    /** 请求超时（毫秒） */
+    timeout?: number;
+    /** 自动重连配置 */
+    autoReconnect?: boolean | {
+        maxRetries?: number;
+        interval?: number;
+    };
+    /**
+     * 分类代理配置（支持 system / custom / direct 三种模式）
+     *
+     * 由上层应用（如 workspace settings）传入对应的 ProxyCategoryConfig，
+     * 客户端根据 mode 自动创建 dispatcher。
+     */
+    proxyCategory?: ProxyCategoryConfig;
+    /** 扩展配置（自定义 transport 的专属数据统一放在此处） */
+    extra?: Record<string, unknown>;
+}
+export interface MCPClient {
+    /** 连接 MCP 服务 */
+    connect(config: MCPServerConfig): Promise<void>;
+    /** 发现远程工具列表 */
+    listTools(): Promise<ToolDefinition[]>;
+    /** 调用远程工具 */
+    callTool(name: string, args: Record<string, unknown>): Promise<string>;
+    /** 发现远程资源列表（可选能力） */
+    listResources?(): Promise<Array<{
+        uri: string;
+        name: string;
+        description?: string;
+    }>>;
+    /** 读取远程资源（可选能力） */
+    readResource?(uri: string): Promise<string>;
+    /** 断开连接 */
+    disconnect(): void;
+    /** 连接状态 */
+    isConnected(): boolean;
+}
+//# sourceMappingURL=types.d.ts.map