@hflin/cclin 0.1.0

package/dist/tools/mcp-client.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @file MCP 客户端 — 管理 MCP Server 的连接生命周期。
+ *
+ * Phase 9：通过 @modelcontextprotocol/sdk 与外部 MCP Server 通信。
+ *
+ * 职责：
+ *   1. 通过 stdio 传输建立与 MCP Server 的连接
+ *   2. 发现 Server 提供的工具列表
+ *   3. 代理调用远端工具
+ *   4. 管理连接生命周期（连接池 + 清理）
+ *
+ * 设计简化：
+ *   - 仅支持 stdio 传输（最常见场景）
+ *   - 不引入 HTTP/OAuth 复杂度
+ *   - 连接池避免重复连接
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import type { MCPServerConfig } from '../types.js';
+/** 单个 MCP Server 的连接信息。 */
+type McpConnection = {
+    /** Server 名称。 */
+    name: string;
+    /** MCP SDK Client 实例。 */
+    client: Client;
+    /** stdio 传输层实例。 */
+    transport: StdioClientTransport;
+};
+/** MCP Server 发现到的原始工具信息。 */
+export type McpDiscoveredTool = {
+    /** 工具原始名称（Server 端的名称）。 */
+    name: string;
+    /** 工具描述。 */
+    description: string;
+    /** 输入参数 JSON Schema。 */
+    inputSchema: Record<string, unknown>;
+};
+/**
+ * MCP 客户端连接池。
+ *
+ * 管理多个 MCP Server 的 stdio 连接：
+ *   - 懒连接（首次使用时建立）
+ *   - 连接复用（同一 Server 不会重复连接）
+ *   - 统一清理
+ */
+export declare class McpClientPool {
+    private connections;
+    /**
+     * 连接到指定 MCP Server。
+     *
+     * 如果已经连接过，直接返回已有连接。
+     */
+    connect(name: string, config: MCPServerConfig): Promise<McpConnection>;
+    /**
+     * 发现指定 Server 提供的工具列表。
+     *
+     * 通过 MCP 协议的 listTools() 方法获取。
+     */
+    discoverTools(name: string, config: MCPServerConfig): Promise<McpDiscoveredTool[]>;
+    /**
+     * 通过 MCP 协议调用远端工具。
+     *
+     * @param serverName — 目标 Server 名称
+     * @param toolName — 工具原始名称（Server 端的名称）
+     * @param args — 工具参数
+     */
+    callTool(serverName: string, toolName: string, args: Record<string, unknown>): Promise<string>;
+    /** 关闭所有 MCP 连接。 */
+    closeAll(): Promise<void>;
+    /** 获取连接数量。 */
+    get size(): number;
+}
+export {};
+//# sourceMappingURL=mcp-client.d.ts.map

package/dist/tools/mcp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-client.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAIlD,2BAA2B;AAC3B,KAAK,aAAa,GAAG;IACjB,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,SAAS,EAAE,oBAAoB,CAAA;CAClC,CAAA;AAED,6BAA6B;AAC7B,MAAM,MAAM,iBAAiB,GAAG;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACvC,CAAA;AAuBD;;;;;;;GAOG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,WAAW,CAAwC;IAE3D;;;;OAIG;IACG,OAAO,CACT,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,CAAC;IA+BzB;;;;OAIG;IACG,aAAa,CACf,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACxB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAW/B;;;;;;OAMG;IACG,QAAQ,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;IAwBlB,mBAAmB;IACb,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAc/B,cAAc;IACd,IAAI,IAAI,IAAI,MAAM,CAEjB;CACJ"}

package/dist/tools/mcp-client.js

@@ -0,0 +1,129 @@
+/**
+ * @file MCP 客户端 — 管理 MCP Server 的连接生命周期。
+ *
+ * Phase 9：通过 @modelcontextprotocol/sdk 与外部 MCP Server 通信。
+ *
+ * 职责：
+ *   1. 通过 stdio 传输建立与 MCP Server 的连接
+ *   2. 发现 Server 提供的工具列表
+ *   3. 代理调用远端工具
+ *   4. 管理连接生命周期（连接池 + 清理）
+ *
+ * 设计简化：
+ *   - 仅支持 stdio 传输（最常见场景）
+ *   - 不引入 HTTP/OAuth 复杂度
+ *   - 连接池避免重复连接
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+// ─── 辅助函数 ──────────────────────────────────────────────────────────────
+/** 合并 process.env 与自定义 env 配置。 */
+function mergeProcessEnv(env) {
+    if (!env)
+        return undefined;
+    const merged = {
+        ...process.env,
+        ...env,
+    };
+    // 过滤掉 undefined 值
+    const entries = Object.entries(merged).filter((entry) => typeof entry[1] === 'string');
+    return Object.fromEntries(entries);
+}
+// ─── McpClientPool 类 ─────────────────────────────────────────────────────
+/**
+ * MCP 客户端连接池。
+ *
+ * 管理多个 MCP Server 的 stdio 连接：
+ *   - 懒连接（首次使用时建立）
+ *   - 连接复用（同一 Server 不会重复连接）
+ *   - 统一清理
+ */
+export class McpClientPool {
+    connections = new Map();
+    /**
+     * 连接到指定 MCP Server。
+     *
+     * 如果已经连接过，直接返回已有连接。
+     */
+    async connect(name, config) {
+        // 连接复用
+        const existing = this.connections.get(name);
+        if (existing)
+            return existing;
+        // 创建 MCP Client
+        const client = new Client({ name: 'cclin-agent', version: '0.1.0' }, { capabilities: {} });
+        // 创建 stdio 传输
+        const transport = new StdioClientTransport({
+            command: config.command,
+            args: config.args,
+            env: mergeProcessEnv(config.env),
+            stderr: 'ignore',
+        });
+        // 建立连接
+        await client.connect(transport);
+        const connection = {
+            name,
+            client,
+            transport,
+        };
+        this.connections.set(name, connection);
+        return connection;
+    }
+    /**
+     * 发现指定 Server 提供的工具列表。
+     *
+     * 通过 MCP 协议的 listTools() 方法获取。
+     */
+    async discoverTools(name, config) {
+        const conn = await this.connect(name, config);
+        const result = await conn.client.listTools();
+        return (result.tools || []).map((t) => ({
+            name: t.name,
+            description: t.description || `Tool from ${name}: ${t.name}`,
+            inputSchema: t.inputSchema ?? {},
+        }));
+    }
+    /**
+     * 通过 MCP 协议调用远端工具。
+     *
+     * @param serverName — 目标 Server 名称
+     * @param toolName — 工具原始名称（Server 端的名称）
+     * @param args — 工具参数
+     */
+    async callTool(serverName, toolName, args) {
+        const conn = this.connections.get(serverName);
+        if (!conn) {
+            throw new Error(`MCP server "${serverName}" not connected`);
+        }
+        const result = await conn.client.callTool({
+            name: toolName,
+            arguments: args,
+        });
+        // 提取文本内容
+        const texts = (result.content || [])
+            .filter((item) => item.type === 'text' && item.text)
+            .map((item) => item.text);
+        if (result.isError) {
+            return `Error: ${texts.join('\n') || 'Unknown MCP tool error'}`;
+        }
+        return texts.join('\n') || '(empty result)';
+    }
+    /** 关闭所有 MCP 连接。 */
+    async closeAll() {
+        const tasks = Array.from(this.connections.values()).map(async (conn) => {
+            try {
+                await conn.client.close();
+            }
+            catch {
+                // 忽略关闭错误
+            }
+        });
+        await Promise.all(tasks);
+        this.connections.clear();
+    }
+    /** 获取连接数量。 */
+    get size() {
+        return this.connections.size;
+    }
+}
+//# sourceMappingURL=mcp-client.js.map

package/dist/tools/mcp-client.js.map

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

package/dist/tools/mcp-config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @file MCP 配置加载器 — 读取 mcp_config.json。
+ *
+ * Phase 9：按优先级搜索 MCP 配置文件。
+ *
+ * 搜索路径（优先级从高到低）：
+ *   1. 项目目录 ./mcp_config.json
+ *   2. 用户目录 ~/.cclin/mcp_config.json
+ *
+ * 配置格式：
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "serverName": {
+ *       "command": "node",
+ *       "args": ["path/to/server.js"],
+ *       "env": { "KEY": "value" }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+import type { MCPServerConfig } from '../types.js';
+/**
+ * 加载 MCP 配置。
+ *
+ * @param cwd — 项目目录（默认 process.cwd()）
+ * @returns MCP Server 配置表（可能为空）
+ */
+export declare function loadMcpConfig(cwd?: string): Promise<Record<string, MCPServerConfig>>;
+//# sourceMappingURL=mcp-config.d.ts.map

package/dist/tools/mcp-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,aAAa,CAAA;AAEjE;;;;;GAKG;AACH,wBAAsB,aAAa,CAC/B,GAAG,SAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CA4B1C"}

package/dist/tools/mcp-config.js

@@ -0,0 +1,55 @@
+/**
+ * @file MCP 配置加载器 — 读取 mcp_config.json。
+ *
+ * Phase 9：按优先级搜索 MCP 配置文件。
+ *
+ * 搜索路径（优先级从高到低）：
+ *   1. 项目目录 ./mcp_config.json
+ *   2. 用户目录 ~/.cclin/mcp_config.json
+ *
+ * 配置格式：
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "serverName": {
+ *       "command": "node",
+ *       "args": ["path/to/server.js"],
+ *       "env": { "KEY": "value" }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+/**
+ * 加载 MCP 配置。
+ *
+ * @param cwd — 项目目录（默认 process.cwd()）
+ * @returns MCP Server 配置表（可能为空）
+ */
+export async function loadMcpConfig(cwd = process.cwd()) {
+    // 搜索路径优先级
+    const candidates = [
+        join(cwd, 'mcp_config.json'),
+        join(homedir(), '.cclin', 'mcp_config.json'),
+    ];
+    for (const configPath of candidates) {
+        try {
+            const raw = await readFile(configPath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed.mcpServers &&
+                typeof parsed.mcpServers === 'object') {
+                console.log(`[MCP] Config loaded from: ${configPath}`);
+                return parsed.mcpServers;
+            }
+        }
+        catch {
+            // 文件不存在或解析失败，尝试下一个
+        }
+    }
+    // 未找到配置，返回空对象（不是错误）
+    return {};
+}
+//# sourceMappingURL=mcp-config.js.map

package/dist/tools/mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-config.js","sourceRoot":"","sources":["../../src/tools/mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAGjC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAC/B,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,UAAU;IACV,MAAM,UAAU,GAAG;QACf,IAAI,CAAC,GAAG,EAAE,iBAAiB,CAAC;QAC5B,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,iBAAiB,CAAC;KAC/C,CAAA;IAED,KAAK,MAAM,UAAU,IAAI,UAAU,EAAE,CAAC;QAClC,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;YAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAA;YAE/C,IACI,MAAM,CAAC,UAAU;gBACjB,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EACvC,CAAC;gBACC,OAAO,CAAC,GAAG,CACP,6BAA6B,UAAU,EAAE,CAC5C,CAAA;gBACD,OAAO,MAAM,CAAC,UAAU,CAAA;YAC5B,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,mBAAmB;QACvB,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,OAAO,EAAE,CAAA;AACb,CAAC"}

package/dist/tools/mcp-registry.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file MCP 工具注册表 — 将 MCP Server 的工具适配为 ToolDefinition。
+ *
+ * Phase 9：连接 MCP Server，发现工具，生成可执行的 ToolDefinition。
+ *
+ * 职责：
+ *   1. 使用 McpClientPool 连接 MCP Server
+ *   2. 将发现的工具转换为 cclin 的 ToolDefinition 格式
+ *   3. 工具名添加 serverName_ 前缀避免冲突
+ *   4. 提供标准查询接口（get/getAll/has/size）
+ */
+import type { MCPServerConfig, McpToolDefinition } from '../types.js';
+/**
+ * MCP 工具注册表。
+ *
+ * 将 MCP Server 的远端工具适配为本地 ToolDefinition，
+ * 使其可以无缝接入 ToolRouter 和 ToolOrchestrator。
+ */
+export declare class McpToolRegistry {
+    private pool;
+    private tools;
+    /**
+     * 连接并加载所有配置的 MCP Server。
+     *
+     * @returns 成功加载的工具总数
+     */
+    loadServers(servers: Record<string, MCPServerConfig>): Promise<number>;
+    /** 获取指定工具。 */
+    get(name: string): McpToolDefinition | undefined;
+    /** 获取所有 MCP 工具。 */
+    getAll(): McpToolDefinition[];
+    /** 检查工具是否存在。 */
+    has(name: string): boolean;
+    /** 已注册 MCP 工具数量。 */
+    get size(): number;
+    /** 清理所有 MCP 连接。 */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=mcp-registry.d.ts.map

package/dist/tools/mcp-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.d.ts","sourceRoot":"","sources":["../../src/tools/mcp-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACR,eAAe,EACf,iBAAiB,EAEpB,MAAM,aAAa,CAAA;AAKpB;;;;;GAKG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,IAAI,CAAsB;IAClC,OAAO,CAAC,KAAK,CAA4C;IAEzD;;;;OAIG;IACG,WAAW,CACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,GACzC,OAAO,CAAC,MAAM,CAAC;IA4DlB,cAAc;IACd,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIhD,mBAAmB;IACnB,MAAM,IAAI,iBAAiB,EAAE;IAI7B,gBAAgB;IAChB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,oBAAoB;IACpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,mBAAmB;IACb,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAIjC"}

package/dist/tools/mcp-registry.js

@@ -0,0 +1,88 @@
+/**
+ * @file MCP 工具注册表 — 将 MCP Server 的工具适配为 ToolDefinition。
+ *
+ * Phase 9：连接 MCP Server，发现工具，生成可执行的 ToolDefinition。
+ *
+ * 职责：
+ *   1. 使用 McpClientPool 连接 MCP Server
+ *   2. 将发现的工具转换为 cclin 的 ToolDefinition 格式
+ *   3. 工具名添加 serverName_ 前缀避免冲突
+ *   4. 提供标准查询接口（get/getAll/has/size）
+ */
+import { McpClientPool } from './mcp-client.js';
+// ─── McpToolRegistry 类 ──────────────────────────────────────────────────
+/**
+ * MCP 工具注册表。
+ *
+ * 将 MCP Server 的远端工具适配为本地 ToolDefinition，
+ * 使其可以无缝接入 ToolRouter 和 ToolOrchestrator。
+ */
+export class McpToolRegistry {
+    pool = new McpClientPool();
+    tools = new Map();
+    /**
+     * 连接并加载所有配置的 MCP Server。
+     *
+     * @returns 成功加载的工具总数
+     */
+    async loadServers(servers) {
+        const entries = Object.entries(servers);
+        if (entries.length === 0)
+            return 0;
+        for (const [serverName, config] of entries) {
+            try {
+                const discovered = await this.pool.discoverTools(serverName, config);
+                for (const rawTool of discovered) {
+                    // 工具名：serverName_originalName
+                    const qualifiedName = `${serverName}_${rawTool.name}`;
+                    const tool = {
+                        name: qualifiedName,
+                        description: rawTool.description ||
+                            `Tool from ${serverName}: ${rawTool.name}`,
+                        inputSchema: rawTool.inputSchema ?? {
+                            type: 'object',
+                            properties: {},
+                        },
+                        isMutating: true, // 保守策略：MCP 工具默认需要审批
+                        source: 'mcp',
+                        serverName,
+                        originalName: rawTool.name,
+                        execute: async (input) => {
+                            const result = await this.pool.callTool(serverName, rawTool.name, input);
+                            const isError = result.startsWith('Error:');
+                            return { output: result, isError };
+                        },
+                    };
+                    this.tools.set(qualifiedName, tool);
+                }
+                console.log(`[MCP] Loaded ${discovered.length} tools from "${serverName}"`);
+            }
+            catch (err) {
+                console.error(`[MCP] Failed to connect to "${serverName}":`, err.message);
+            }
+        }
+        return this.tools.size;
+    }
+    /** 获取指定工具。 */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** 获取所有 MCP 工具。 */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /** 检查工具是否存在。 */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /** 已注册 MCP 工具数量。 */
+    get size() {
+        return this.tools.size;
+    }
+    /** 清理所有 MCP 连接。 */
+    async dispose() {
+        await this.pool.closeAll();
+        this.tools.clear();
+    }
+}
+//# sourceMappingURL=mcp-registry.js.map

package/dist/tools/mcp-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-registry.js","sourceRoot":"","sources":["../../src/tools/mcp-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,2EAA2E;AAE3E;;;;;GAKG;AACH,MAAM,OAAO,eAAe;IAChB,IAAI,GAAG,IAAI,aAAa,EAAE,CAAA;IAC1B,KAAK,GAAmC,IAAI,GAAG,EAAE,CAAA;IAEzD;;;;OAIG;IACH,KAAK,CAAC,WAAW,CACb,OAAwC;QAExC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAA;QAElC,KAAK,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACzC,IAAI,CAAC;gBACD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,aAAa,CAC5C,UAAU,EACV,MAAM,CACT,CAAA;gBAED,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;oBAC/B,8BAA8B;oBAC9B,MAAM,aAAa,GACf,GAAG,UAAU,IAAI,OAAO,CAAC,IAAI,EAAE,CAAA;oBAEnC,MAAM,IAAI,GAAsB;wBAC5B,IAAI,EAAE,aAAa;wBACnB,WAAW,EACP,OAAO,CAAC,WAAW;4BACnB,aAAa,UAAU,KAAK,OAAO,CAAC,IAAI,EAAE;wBAC9C,WAAW,EACN,OAAO,CAAC,WAA+B,IAAI;4BACxC,IAAI,EAAE,QAAQ;4BACd,UAAU,EAAE,EAAE;yBACjB;wBACL,UAAU,EAAE,IAAI,EAAE,oBAAoB;wBACtC,MAAM,EAAE,KAAK;wBACb,UAAU;wBACV,YAAY,EAAE,OAAO,CAAC,IAAI;wBAC1B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;4BACrB,MAAM,MAAM,GACR,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CACpB,UAAU,EACV,OAAO,CAAC,IAAI,EACZ,KAAK,CACR,CAAA;4BACL,MAAM,OAAO,GACT,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAA;4BAC/B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAA;wBACtC,CAAC;qBACJ,CAAA;oBAED,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,CAAA;gBACvC,CAAC;gBAED,OAAO,CAAC,GAAG,CACP,gBAAgB,UAAU,CAAC,MAAM,gBAAgB,UAAU,GAAG,CACjE,CAAA;YACL,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CACT,+BAA+B,UAAU,IAAI,EAC5C,GAAa,CAAC,OAAO,CACzB,CAAA;YACL,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,cAAc;IACd,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,mBAAmB;IACnB,MAAM;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAA;IAC1C,CAAC;IAED,gBAAgB;IAChB,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,oBAAoB;IACpB,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED,mBAAmB;IACnB,KAAK,CAAC,OAAO;QACT,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;QAC1B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;CACJ"}

package/dist/tools/orchestrator.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @file 工具编排器 — 统一调度工具执行。
+ *
+ * Phase 4：在 ToolRegistry 和 ReAct 循环之间的中间层。
+ *
+ * 职责链：工具查找 → 审批检查 → 输入解析 → 执行 → 错误分类 → 结果截断
+ *
+ * 设计思路：
+ *   1. 将散落在 registry.createExecuteTool() 和 react-loop 中的
+ *      执行逻辑集中到一个统一入口。
+ *   2. 通过 ApprovalHooks 回调将审批 UI 解耦。
+ *   3. 提供 createExecuteTool() 兼容现有 ReAct 循环接口。
+ */
+import type { ExecuteTool, ApprovalHooks, ToolAction, ToolActionResult, ToolExecutionResult, ToolQueryable } from '../types.js';
+import type { ApprovalManager } from './approval.js';
+/**
+ * 工具编排器。
+ *
+ * 统一的工具执行入口，包含：
+ *   1. 工具查找
+ *   2. 审批检查
+ *   3. 输入解析
+ *   4. 工具执行
+ *   5. 错误分类
+ *   6. 结果截断
+ */
+export declare class ToolOrchestrator {
+    private readonly registry;
+    private readonly approvalManager;
+    constructor(registry: ToolQueryable, approvalManager: ApprovalManager);
+    /**
+     * 执行单个工具调用。
+     *
+     * 完整流程：查找 → 审批 → 解析 → 执行 → 截断
+     */
+    executeAction(action: ToolAction, hooks?: ApprovalHooks): Promise<ToolActionResult>;
+    /**
+     * 批量执行工具调用（顺序执行）。
+     */
+    executeActions(actions: ToolAction[], hooks?: ApprovalHooks): Promise<ToolExecutionResult>;
+    /**
+     * 创建兼容 ExecuteTool 签名的函数。
+     *
+     * 让 Orchestrator 可以无缝接入现有 ReAct 循环。
+     */
+    createExecuteTool(hooks?: ApprovalHooks): ExecuteTool;
+    /** 清除 once 级别授权（Turn 结束时调用）。 */
+    clearOnceApprovals(): void;
+    /** 清除所有授权（Session 结束时调用）。 */
+    dispose(): void;
+}
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/tools/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/tools/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EAEb,UAAU,EACV,gBAAgB,EAEhB,mBAAmB,EACnB,aAAa,EAChB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAsDpD;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAErB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBADf,QAAQ,EAAE,aAAa,EACvB,eAAe,EAAE,eAAe;IAGrD;;;;OAIG;IACG,aAAa,CACf,MAAM,EAAE,UAAU,EAClB,KAAK,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,gBAAgB,CAAC;IAwF5B;;OAEG;IACG,cAAc,CAChB,OAAO,EAAE,UAAU,EAAE,EACrB,KAAK,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,mBAAmB,CAAC;IAqB/B;;;;OAIG;IACH,iBAAiB,CAAC,KAAK,CAAC,EAAE,aAAa,GAAG,WAAW;IAerD,gCAAgC;IAChC,kBAAkB,IAAI,IAAI;IAI1B,6BAA6B;IAC7B,OAAO,IAAI,IAAI;CAGlB"}