@hflin/cclin 0.1.0

package/dist/tools/orchestrator.js

@@ -0,0 +1,190 @@
+/**
+ * @file 工具编排器 — 统一调度工具执行。
+ *
+ * Phase 4：在 ToolRegistry 和 ReAct 循环之间的中间层。
+ *
+ * 职责链：工具查找 → 审批检查 → 输入解析 → 执行 → 错误分类 → 结果截断
+ *
+ * 设计思路：
+ *   1. 将散落在 registry.createExecuteTool() 和 react-loop 中的
+ *      执行逻辑集中到一个统一入口。
+ *   2. 通过 ApprovalHooks 回调将审批 UI 解耦。
+ *   3. 提供 createExecuteTool() 兼容现有 ReAct 循环接口。
+ */
+/** 工具输出最大字符数（超过则截断）。 */
+const MAX_OUTPUT_CHARS = 50_000;
+// ─── 辅助函数 ─────────────────────────────────────────────────────────────────
+/** 截断过长的工具输出。 */
+function truncateOutput(output, toolName) {
+    if (output.length <= MAX_OUTPUT_CHARS)
+        return output;
+    return (output.slice(0, MAX_OUTPUT_CHARS) +
+        `\n...[truncated] ${toolName} output too long ` +
+        `(${output.length} chars, max ${MAX_OUTPUT_CHARS})`);
+}
+/** 解析工具输入，确保为 Record 类型。 */
+function parseToolInput(rawInput) {
+    if (rawInput === null || rawInput === undefined)
+        return {};
+    if (typeof rawInput === 'object' && !Array.isArray(rawInput)) {
+        return rawInput;
+    }
+    if (typeof rawInput === 'string') {
+        try {
+            const parsed = JSON.parse(rawInput);
+            if (typeof parsed === 'object' && parsed !== null) {
+                return parsed;
+            }
+        }
+        catch {
+            // 解析失败，返回空对象
+        }
+    }
+    return {};
+}
+/** 错误分类。 */
+function classifyError(err) {
+    const msg = err instanceof Error
+        ? err.message.toLowerCase()
+        : String(err).toLowerCase();
+    if (msg.includes('permission denied') ||
+        msg.includes('eacces')) {
+        return 'execution_failed';
+    }
+    return 'execution_failed';
+}
+// ─── ToolOrchestrator 类 ─────────────────────────────────────────────────────
+/**
+ * 工具编排器。
+ *
+ * 统一的工具执行入口，包含：
+ *   1. 工具查找
+ *   2. 审批检查
+ *   3. 输入解析
+ *   4. 工具执行
+ *   5. 错误分类
+ *   6. 结果截断
+ */
+export class ToolOrchestrator {
+    registry;
+    approvalManager;
+    constructor(registry, approvalManager) {
+        this.registry = registry;
+        this.approvalManager = approvalManager;
+    }
+    /**
+     * 执行单个工具调用。
+     *
+     * 完整流程：查找 → 审批 → 解析 → 执行 → 截断
+     */
+    async executeAction(action, hooks) {
+        const startedAt = Date.now();
+        // 1. 工具查找
+        const tool = this.registry.get(action.name);
+        if (!tool) {
+            return {
+                actionId: action.id,
+                tool: action.name,
+                status: 'tool_not_found',
+                success: false,
+                observation: `Error: tool "${action.name}" not found.`,
+                durationMs: Date.now() - startedAt,
+            };
+        }
+        // 2. 审批检查
+        const check = this.approvalManager.check(action.name, action.input, tool.isMutating);
+        if (check.needsApproval) {
+            const request = {
+                toolName: check.toolName,
+                input: check.input,
+                fingerprint: check.fingerprint,
+                reason: check.reason,
+            };
+            // 调用 UI 审批回调
+            const decision = hooks?.requestApproval
+                ? await hooks.requestApproval(request)
+                : 'deny';
+            this.approvalManager.recordDecision(check.fingerprint, decision);
+            if (decision === 'deny') {
+                return {
+                    actionId: action.id,
+                    tool: action.name,
+                    status: 'approval_denied',
+                    success: false,
+                    observation: `User denied: "${action.name}". ` +
+                        'Please inform the user and suggest alternatives.',
+                    durationMs: Date.now() - startedAt,
+                };
+            }
+        }
+        // 3. 输入解析
+        const parsedInput = parseToolInput(action.input);
+        // 4. 执行工具
+        try {
+            const result = await tool.execute(parsedInput);
+            // 5. 结果截断
+            const output = truncateOutput(result.output, action.name);
+            return {
+                actionId: action.id,
+                tool: action.name,
+                status: result.isError ? 'execution_failed' : 'success',
+                success: !result.isError,
+                observation: output,
+                durationMs: Date.now() - startedAt,
+            };
+        }
+        catch (err) {
+            return {
+                actionId: action.id,
+                tool: action.name,
+                status: classifyError(err),
+                success: false,
+                observation: `Tool execution error: ${err.message}`,
+                durationMs: Date.now() - startedAt,
+            };
+        }
+    }
+    /**
+     * 批量执行工具调用（顺序执行）。
+     */
+    async executeActions(actions, hooks) {
+        const results = [];
+        for (const action of actions) {
+            const result = await this.executeAction(action, hooks);
+            results.push(result);
+            // 如果被拒绝，停止后续执行   
+            if (result.status === 'approval_denied')
+                break;
+        }
+        const hasRejection = results.some((r) => r.status === 'approval_denied');
+        const combinedObservation = results
+            .map((r) => r.observation)
+            .join('\n---\n');
+        return { results, combinedObservation, hasRejection };
+    }
+    /**
+     * 创建兼容 ExecuteTool 签名的函数。
+     *
+     * 让 Orchestrator 可以无缝接入现有 ReAct 循环。
+     */
+    createExecuteTool(hooks) {
+        return async (toolName, toolInput) => {
+            const action = {
+                id: `${toolName}:${Date.now()}`,
+                name: toolName,
+                input: toolInput,
+            };
+            const result = await this.executeAction(action, hooks);
+            return result.observation;
+        };
+    }
+    /** 清除 once 级别授权（Turn 结束时调用）。 */
+    clearOnceApprovals() {
+        this.approvalManager.clearOnceApprovals();
+    }
+    /** 清除所有授权（Session 结束时调用）。 */
+    dispose() {
+        this.approvalManager.dispose();
+    }
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/tools/orchestrator.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * @file Unit tests for ToolOrchestrator (Phase 4).
+ *
+ * Tests: tool not found, approval denied, successful execution,
+ *        output truncation, parseToolInput, createExecuteTool
+ */
+export {};
+//# sourceMappingURL=orchestrator.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.test.d.ts","sourceRoot":"","sources":["../../src/tools/orchestrator.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/tools/orchestrator.test.js

@@ -0,0 +1,122 @@
+/**
+ * @file Unit tests for ToolOrchestrator (Phase 4).
+ *
+ * Tests: tool not found, approval denied, successful execution,
+ *        output truncation, parseToolInput, createExecuteTool
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { ToolOrchestrator } from './orchestrator.js';
+import { ApprovalManager } from './approval.js';
+// ─── Test Fixtures ────────────────────────────────────────────────────────────
+function makeTool(name, mutating, output = 'ok') {
+    return {
+        name,
+        description: `${name} desc`,
+        inputSchema: { type: 'object', properties: {}, required: [] },
+        isMutating: mutating,
+        execute: vi.fn(async () => ({ output })),
+    };
+}
+function makeRegistry(tools) {
+    const map = new Map(tools.map((t) => [t.name, t]));
+    return { get: (name) => map.get(name) };
+}
+function makeAction(name, input = {}) {
+    return { id: `${name}:1`, name, input };
+}
+// ─── Tests ────────────────────────────────────────────────────────────────────
+describe('ToolOrchestrator', () => {
+    let approval;
+    let orchestrator;
+    describe('executeAction', () => {
+        beforeEach(() => {
+            approval = new ApprovalManager();
+        });
+        it('should return tool_not_found for unknown tools', async () => {
+            orchestrator = new ToolOrchestrator(makeRegistry([]), approval);
+            const result = await orchestrator.executeAction(makeAction('x'));
+            expect(result.status).toBe('tool_not_found');
+            expect(result.success).toBe(false);
+        });
+        it('should deny when no approval hook and tool is mutating', async () => {
+            const tool = makeTool('bash', true);
+            orchestrator = new ToolOrchestrator(makeRegistry([tool]), approval);
+            const result = await orchestrator.executeAction(makeAction('bash'));
+            expect(result.status).toBe('approval_denied');
+            expect(result.success).toBe(false);
+        });
+        it('should auto-pass non-mutating tools', async () => {
+            const tool = makeTool('read_file', false, 'file content');
+            orchestrator = new ToolOrchestrator(makeRegistry([tool]), approval);
+            const result = await orchestrator.executeAction(makeAction('read_file'));
+            expect(result.status).toBe('success');
+            expect(result.observation).toBe('file content');
+        });
+        it('should pass with approval hook returning approve', async () => {
+            const tool = makeTool('bash', true, 'done');
+            orchestrator = new ToolOrchestrator(makeRegistry([tool]), approval);
+            const hooks = { requestApproval: vi.fn(async () => 'approve') };
+            const result = await orchestrator.executeAction(makeAction('bash'), hooks);
+            expect(result.status).toBe('success');
+            expect(result.observation).toBe('done');
+        });
+        it('should handle tool execution error', async () => {
+            const tool = makeTool('bad', false);
+            vi.mocked(tool.execute).mockRejectedValue(new Error('boom'));
+            orchestrator = new ToolOrchestrator(makeRegistry([tool]), approval);
+            const result = await orchestrator.executeAction(makeAction('bad'));
+            expect(result.status).toBe('execution_failed');
+            expect(result.observation).toContain('boom');
+        });
+        it('should truncate oversized output', async () => {
+            const big = 'x'.repeat(60_000);
+            const tool = makeTool('big_tool', false, big);
+            orchestrator = new ToolOrchestrator(makeRegistry([tool]), approval);
+            const result = await orchestrator.executeAction(makeAction('big_tool'));
+            expect(result.observation.length).toBeLessThan(big.length);
+            expect(result.observation).toContain('[truncated]');
+        });
+    });
+    describe('executeActions', () => {
+        it('should stop on first approval_denied', async () => {
+            approval = new ApprovalManager();
+            const t1 = makeTool('a', true);
+            const t2 = makeTool('b', true);
+            orchestrator = new ToolOrchestrator(makeRegistry([t1, t2]), approval);
+            const result = await orchestrator.executeActions([
+                makeAction('a'),
+                makeAction('b'),
+            ]);
+            expect(result.hasRejection).toBe(true);
+            // Only first was attempted
+            expect(result.results).toHaveLength(1);
+        });
+    });
+    describe('createExecuteTool', () => {
+        it('should return observation string', async () => {
+            approval = new ApprovalManager();
+            const tool = makeTool('list', false, 'files here');
+            orchestrator = new ToolOrchestrator(makeRegistry([tool]), approval);
+            const exec = orchestrator.createExecuteTool();
+            const obs = await exec('list', {});
+            expect(obs).toBe('files here');
+        });
+    });
+    describe('lifecycle', () => {
+        it('clearOnceApprovals delegates to approval manager', () => {
+            approval = new ApprovalManager();
+            const spy = vi.spyOn(approval, 'clearOnceApprovals');
+            orchestrator = new ToolOrchestrator(makeRegistry([]), approval);
+            orchestrator.clearOnceApprovals();
+            expect(spy).toHaveBeenCalledOnce();
+        });
+        it('dispose delegates to approval manager', () => {
+            approval = new ApprovalManager();
+            const spy = vi.spyOn(approval, 'dispose');
+            orchestrator = new ToolOrchestrator(makeRegistry([]), approval);
+            orchestrator.dispose();
+            expect(spy).toHaveBeenCalledOnce();
+        });
+    });
+});
+//# sourceMappingURL=orchestrator.test.js.map

package/dist/tools/orchestrator.test.js.map

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

package/dist/tools/read-file.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file read_file 工具 — 读取文件内容，支持 offset/limit 分段。
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const readFileTool: ToolDefinition;
+//# sourceMappingURL=read-file.d.ts.map

package/dist/tools/read-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD,eAAO,MAAM,YAAY,EAAE,cAkD1B,CAAA"}

package/dist/tools/read-file.js

@@ -0,0 +1,50 @@
+/**
+ * @file read_file 工具 — 读取文件内容，支持 offset/limit 分段。
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { validatePath } from './safety.js';
+export const readFileTool = {
+    name: 'read_file',
+    description: 'Read the contents of a file. Supports offset/limit for partial reads. ' +
+        'Returns line-numbered output.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'File path to read.' },
+            offset: { type: 'number', description: 'Start line (0-based, default 0).' },
+            limit: { type: 'number', description: 'Max lines to return (default: all).' },
+        },
+        required: ['path'],
+    },
+    isMutating: false,
+    async execute(input) {
+        const filePath = String(input.path ?? '');
+        if (!filePath)
+            return { output: 'Error: path is required.', isError: true };
+        const validation = validatePath(filePath);
+        if (!validation.ok)
+            return { output: validation.error, isError: true };
+        const resolved = path.resolve(filePath);
+        try {
+            const raw = await fs.readFile(resolved, 'utf-8');
+            let lines = raw.split('\n');
+            const offset = Math.max(0, Number(input.offset) || 0);
+            const limit = Number(input.limit) || 0;
+            if (offset > 0 || limit > 0) {
+                const end = limit > 0 ? offset + limit : undefined;
+                lines = lines.slice(offset, end);
+            }
+            const numbered = lines.map((line, i) => `${offset + i + 1}: ${line}`).join('\n');
+            return { output: `File: ${resolved}\n${numbered}` };
+        }
+        catch (err) {
+            const code = err.code;
+            const msg = code === 'ENOENT'
+                ? `File not found: ${resolved}`
+                : `read_file failed: ${err.message}`;
+            return { output: msg, isError: true };
+        }
+    },
+};
+//# sourceMappingURL=read-file.js.map

package/dist/tools/read-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,CAAC,MAAM,YAAY,GAAmB;IACxC,IAAI,EAAE,WAAW;IACjB,WAAW,EACP,wEAAwE;QACxE,+BAA+B;IACnC,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;YAC3D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kCAAkC,EAAE;YAC3E,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;SAChF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACrB;IACD,UAAU,EAAE,KAAK;IAEjB,KAAK,CAAC,OAAO,CAAC,KAAK;QACf,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;QACzC,IAAI,CAAC,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,0BAA0B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAE3E,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACzC,IAAI,CAAC,UAAU,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAEtE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAEvC,IAAI,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YAChD,IAAI,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;YACrD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;YAEtC,IAAI,MAAM,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,GAAG,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;gBAClD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YACpC,CAAC;YAED,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACnC,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAEZ,OAAO,EAAE,MAAM,EAAE,SAAS,QAAQ,KAAK,QAAQ,EAAE,EAAE,CAAA;QACvD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAA;YAChD,MAAM,GAAG,GAAG,IAAI,KAAK,QAAQ;gBACzB,CAAC,CAAC,mBAAmB,QAAQ,EAAE;gBAC/B,CAAC,CAAC,qBAAsB,GAAa,CAAC,OAAO,EAAE,CAAA;YACnD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACzC,CAAC;IACL,CAAC;CACJ,CAAA"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @file 工具注册表 — 管理所有已注册的工具定义。
+ *
+ * Phase 3：提供工具注册、查询和格式转换能力。
+ *
+ * 职责：
+ *   1. 存储 ToolDefinition 实例
+ *   2. 提供 toOpenAITools() 生成 LLM 所需的 tools 参数
+ *   3. （功能已转移）提供 createExecuteTool() 生成符合 ExecuteTool 签名的函数
+ */
+import type { ToolDefinition } from '../types.js';
+/**
+ * 工具注册表。
+ *
+ * 用法：
+ * ```ts
+ * const registry = new ToolRegistry()
+ * registry.register(readFileTool)
+ * registry.register(bashTool)
+ *
+ * const tools = registry.toOpenAITools()  // 传给 LLM
+ * （功能已转移）const executeTool = registry.createExecuteTool()  // 传给 ReAct 循环
+ * ```
+ */
+export declare class ToolRegistry {
+    private tools;
+    /** 注册单个工具。 */
+    register(tool: ToolDefinition): void;
+    /** 批量注册工具。 */
+    registerMany(tools: ToolDefinition[]): void;
+    /** 获取指定工具。 */
+    get(name: string): ToolDefinition | undefined;
+    /** 获取所有工具。 */
+    getAll(): ToolDefinition[];
+    /** 检查工具是否存在。 */
+    has(name: string): boolean;
+    /** 已注册工具数量。 */
+    get size(): number;
+    /**
+     * 转换为 OpenAI function calling 的 tools 参数格式。
+     */
+    toOpenAITools(): Array<{
+        type: 'function';
+        function: {
+            name: string;
+            description: string;
+            parameters: Record<string, unknown>;
+        };
+    }>;
+    /**
+     * 转换为 Markdown 文本格式，供系统提示词注入。
+     */
+    toMarkdown(): string;
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIjD;;;;;;;;;;;;GAYG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,KAAK,CAAyC;IAEtD,cAAc;IACd,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAIpC,cAAc;IACd,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAM3C,cAAc;IACd,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI7C,cAAc;IACd,MAAM,IAAI,cAAc,EAAE;IAI1B,gBAAgB;IAChB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,eAAe;IACf,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,aAAa,IAAI,KAAK,CAAC;QACnB,IAAI,EAAE,UAAU,CAAA;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,MAAM,CAAA;YACZ,WAAW,EAAE,MAAM,CAAA;YACnB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SACtC,CAAA;KACJ,CAAC;IAWF;;OAEG;IACH,UAAU,IAAI,MAAM;CAmCvB"}

package/dist/tools/registry.js

@@ -0,0 +1,75 @@
+/**
+ * @file 工具注册表 — 管理所有已注册的工具定义。
+ *
+ * Phase 3：提供工具注册、查询和格式转换能力。
+ *
+ * 职责：
+ *   1. 存储 ToolDefinition 实例
+ *   2. 提供 toOpenAITools() 生成 LLM 所需的 tools 参数
+ *   3. （功能已转移）提供 createExecuteTool() 生成符合 ExecuteTool 签名的函数
+ */
+// ─── ToolRegistry 类 ─────────────────────────────────────────────────────────
+/**
+ * 工具注册表。
+ *
+ * 用法：
+ * ```ts
+ * const registry = new ToolRegistry()
+ * registry.register(readFileTool)
+ * registry.register(bashTool)
+ *
+ * const tools = registry.toOpenAITools()  // 传给 LLM
+ * （功能已转移）const executeTool = registry.createExecuteTool()  // 传给 ReAct 循环
+ * ```
+ */
+export class ToolRegistry {
+    tools = new Map();
+    /** 注册单个工具。 */
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    /** 批量注册工具。 */
+    registerMany(tools) {
+        for (const tool of tools) {
+            this.register(tool);
+        }
+    }
+    /** 获取指定工具。 */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /** 获取所有工具。 */
+    getAll() {
+        return Array.from(this.tools.values());
+    }
+    /** 检查工具是否存在。 */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /** 已注册工具数量。 */
+    get size() {
+        return this.tools.size;
+    }
+    /**
+     * 转换为 OpenAI function calling 的 tools 参数格式。
+     */
+    toOpenAITools() {
+        return this.getAll().map((tool) => ({
+            type: 'function',
+            function: {
+                name: tool.name,
+                description: tool.description,
+                parameters: tool.inputSchema,
+            },
+        }));
+    }
+    /**
+     * 转换为 Markdown 文本格式，供系统提示词注入。
+     */
+    toMarkdown() {
+        return this.getAll()
+            .map((tool) => `### ${tool.name}\n${tool.description}\n\n**Parameters Schema**:\n\`\`\`json\n${JSON.stringify(tool.inputSchema, null, 2)}\n\`\`\``)
+            .join('\n\n');
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,YAAY;IACb,KAAK,GAAgC,IAAI,GAAG,EAAE,CAAA;IAEtD,cAAc;IACd,QAAQ,CAAC,IAAoB;QACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACnC,CAAC;IAED,cAAc;IACd,YAAY,CAAC,KAAuB;QAChC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QACvB,CAAC;IACL,CAAC;IAED,cAAc;IACd,GAAG,CAAC,IAAY;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC/B,CAAC;IAED,cAAc;IACd,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,eAAe;IACf,IAAI,IAAI;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAA;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QAQT,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,UAAmB;YACzB,QAAQ,EAAE;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,UAAU,EAAE,IAAI,CAAC,WAAW;aAC/B;SACJ,CAAC,CAAC,CAAA;IACP,CAAC;IAED;;OAEG;IACH,UAAU;QACN,OAAO,IAAI,CAAC,MAAM,EAAE;aACf,GAAG,CACA,CAAC,IAAI,EAAE,EAAE,CACL,OAAO,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,2CAA2C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,CAC1I;aACA,IAAI,CAAC,MAAM,CAAC,CAAA;IACrB,CAAC;CA4BJ"}

package/dist/tools/registry.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file Unit tests for ToolRegistry (Phase 3).
+ *
+ * Tests: register, get, has, size, getAll, registerMany,
+ *        toOpenAITools, toMarkdown
+ */
+export {};
+//# sourceMappingURL=registry.test.d.ts.map

package/dist/tools/registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.test.d.ts","sourceRoot":"","sources":["../../src/tools/registry.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}