@hflin/cclin 0.1.0

package/dist/tools/approval.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @file 审批管理器 — 管理工具执行的审批策略和授权缓存。
+ *
+ * Phase 4：基于工具的 isMutating 属性决定是否需要审批。
+ *
+ * 设计思路：
+ *   1. 非 mutating 工具（read_file / list_directory）→ 自动放行
+ *   2. mutating 工具（write_file / bash / edit_file）→ 需要审批
+ *   3. 用"指纹"去重，避免重复询问相同操作
+ *
+ * 三种策略：
+ *   - always：每次都询问（最严格）
+ *   - once：同指纹本轮只问一次
+ *   - session：同指纹整个会话有效
+ */
+import type { ApprovalPolicy, ApprovalDecision, ApprovalCheckResult } from '../types.js';
+export declare function generateFingerprint(toolName: string, input: unknown): string;
+/** ApprovalManager 构造参数。 */
+export type ApprovalManagerOptions = {
+    /** 审批策略，默认 'once'。 */
+    policy?: ApprovalPolicy;
+};
+/**
+ * 审批管理器。
+ *
+ * 管理工具执行权限：
+ *   - 检查工具是否需要审批
+ *   - 缓存已授权的操作指纹
+ *   - 支持按轮次或会话级别的授权生命周期
+ */
+export declare class ApprovalManager {
+    private _policy;
+    /** once 级别授权缓存（Turn 结束时清除）。 */
+    private onceGrants;
+    /** session 级别授权缓存（Session 结束时清除）。 */
+    private sessionGrants;
+    constructor(options?: ApprovalManagerOptions);
+    /** 获取当前策略。 */
+    get policy(): ApprovalPolicy;
+    /**
+     * 动态切换审批策略。
+     * 切换策略时会自动清空旧的授权缓存，防止状态混乱。
+     */
+    set policy(newPolicy: ApprovalPolicy);
+    /**
+     * 检查工具调用是否需要审批。
+     *
+     * 非 mutating 工具自动放行；
+     * mutating 工具根据策略和缓存决定。
+     */
+    check(toolName: string, input: unknown, isMutating: boolean): ApprovalCheckResult;
+    /** 记录用户决定。 */
+    recordDecision(fingerprint: string, decision: ApprovalDecision): void;
+    /** 检查指纹是否已授权。 */
+    isGranted(fingerprint: string): boolean;
+    /** 清除 once 级别授权（Turn 结束时调用）。 */
+    clearOnceApprovals(): void;
+    /** 清除所有授权（Session 结束时调用）。 */
+    dispose(): void;
+}
+//# sourceMappingURL=approval.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"approval.d.ts","sourceRoot":"","sources":["../../src/tools/approval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACR,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACtB,MAAM,aAAa,CAAA;AAyBpB,wBAAgB,mBAAmB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,GACf,MAAM,CAER;AAID,4BAA4B;AAC5B,MAAM,MAAM,sBAAsB,GAAG;IACjC,sBAAsB;IACtB,MAAM,CAAC,EAAE,cAAc,CAAA;CAC1B,CAAA;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,OAAO,CAAgB;IAE/B,+BAA+B;IAC/B,OAAO,CAAC,UAAU,CAAyB;IAE3C,qCAAqC;IACrC,OAAO,CAAC,aAAa,CAAyB;gBAElC,OAAO,GAAE,sBAA2B;IAIhD,cAAc;IACd,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED;;;OAGG;IACH,IAAI,MAAM,CAAC,SAAS,EAAE,cAAc,EAGnC;IAED;;;;;OAKG;IACH,KAAK,CACD,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,OAAO,GACpB,mBAAmB;IAsBtB,cAAc;IACd,cAAc,CACV,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,gBAAgB,GAC3B,IAAI;IAWP,iBAAiB;IACjB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IAOvC,gCAAgC;IAChC,kBAAkB,IAAI,IAAI;IAI1B,6BAA6B;IAC7B,OAAO,IAAI,IAAI;CAIlB"}

package/dist/tools/approval.js

@@ -0,0 +1,119 @@
+/**
+ * @file 审批管理器 — 管理工具执行的审批策略和授权缓存。
+ *
+ * Phase 4：基于工具的 isMutating 属性决定是否需要审批。
+ *
+ * 设计思路：
+ *   1. 非 mutating 工具（read_file / list_directory）→ 自动放行
+ *   2. mutating 工具（write_file / bash / edit_file）→ 需要审批
+ *   3. 用"指纹"去重，避免重复询问相同操作
+ *
+ * 三种策略：
+ *   - always：每次都询问（最严格）
+ *   - once：同指纹本轮只问一次
+ *   - session：同指纹整个会话有效
+ */
+// ─── 指纹生成 ─────────────────────────────────────────────────────────────────
+/**
+ * 生成工具调用指纹。
+ *
+ * 将工具名和输入参数序列化为稳定字符串，用于去重。
+ * 使用排序后的 JSON 保证相同参数产生相同指纹。
+ */
+function stableStringify(value) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value !== 'object')
+        return String(value);
+    const sorted = Object.keys(value)
+        .sort()
+        .reduce((acc, key) => {
+        acc[key] = value[key];
+        return acc;
+    }, {});
+    return JSON.stringify(sorted);
+}
+export function generateFingerprint(toolName, input) {
+    return `${toolName}::${stableStringify(input)}`;
+}
+/**
+ * 审批管理器。
+ *
+ * 管理工具执行权限：
+ *   - 检查工具是否需要审批
+ *   - 缓存已授权的操作指纹
+ *   - 支持按轮次或会话级别的授权生命周期
+ */
+export class ApprovalManager {
+    _policy;
+    /** once 级别授权缓存（Turn 结束时清除）。 */
+    onceGrants = new Set();
+    /** session 级别授权缓存（Session 结束时清除）。 */
+    sessionGrants = new Set();
+    constructor(options = {}) {
+        this._policy = options.policy ?? 'once';
+    }
+    /** 获取当前策略。 */
+    get policy() {
+        return this._policy;
+    }
+    /**
+     * 动态切换审批策略。
+     * 切换策略时会自动清空旧的授权缓存，防止状态混乱。
+     */
+    set policy(newPolicy) {
+        this._policy = newPolicy;
+        this.dispose(); // 清空原有的授权
+    }
+    /**
+     * 检查工具调用是否需要审批。
+     *
+     * 非 mutating 工具自动放行；
+     * mutating 工具根据策略和缓存决定。
+     */
+    check(toolName, input, isMutating) {
+        // 非 mutating 工具直接放行
+        if (!isMutating) {
+            return { needsApproval: false };
+        }
+        const fingerprint = generateFingerprint(toolName, input);
+        // 检查缓存
+        if (this.isGranted(fingerprint)) {
+            return { needsApproval: false };
+        }
+        return {
+            needsApproval: true,
+            fingerprint,
+            reason: `工具 "${toolName}" 会修改外部状态，需要你的确认。`,
+            toolName,
+            input,
+        };
+    }
+    /** 记录用户决定。 */
+    recordDecision(fingerprint, decision) {
+        if (decision !== 'approve')
+            return;
+        if (this._policy === 'once') {
+            this.onceGrants.add(fingerprint);
+        }
+        else if (this._policy === 'session') {
+            this.sessionGrants.add(fingerprint);
+        }
+        // always 策略不缓存
+    }
+    /** 检查指纹是否已授权。 */
+    isGranted(fingerprint) {
+        return (this.onceGrants.has(fingerprint) ||
+            this.sessionGrants.has(fingerprint));
+    }
+    /** 清除 once 级别授权（Turn 结束时调用）。 */
+    clearOnceApprovals() {
+        this.onceGrants.clear();
+    }
+    /** 清除所有授权（Session 结束时调用）。 */
+    dispose() {
+        this.onceGrants.clear();
+        this.sessionGrants.clear();
+    }
+}
+//# sourceMappingURL=approval.js.map

package/dist/tools/approval.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * @file Unit tests for ApprovalManager (Phase 4).
+ *
+ * Tests: check (non-mutating auto-pass, mutating requires approval),
+ *        recordDecision, policies (always/once/session),
+ *        clearOnceApprovals, dispose, generateFingerprint
+ */
+export {};
+//# sourceMappingURL=approval.test.d.ts.map

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

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

package/dist/tools/approval.test.js

@@ -0,0 +1,112 @@
+/**
+ * @file Unit tests for ApprovalManager (Phase 4).
+ *
+ * Tests: check (non-mutating auto-pass, mutating requires approval),
+ *        recordDecision, policies (always/once/session),
+ *        clearOnceApprovals, dispose, generateFingerprint
+ */
+import { describe, it, expect, beforeEach } from 'vitest';
+import { ApprovalManager, generateFingerprint } from './approval.js';
+// ─── generateFingerprint ──────────────────────────────────────────────────────
+describe('generateFingerprint', () => {
+    it('should produce stable fingerprint for same input', () => {
+        const fp1 = generateFingerprint('bash', { command: 'ls' });
+        const fp2 = generateFingerprint('bash', { command: 'ls' });
+        expect(fp1).toBe(fp2);
+    });
+    it('should be order-independent for object keys', () => {
+        const fp1 = generateFingerprint('tool', { a: 1, b: 2 });
+        const fp2 = generateFingerprint('tool', { b: 2, a: 1 });
+        expect(fp1).toBe(fp2);
+    });
+    it('should differ for different tool names', () => {
+        const fp1 = generateFingerprint('bash', { command: 'ls' });
+        const fp2 = generateFingerprint('write_file', { command: 'ls' });
+        expect(fp1).not.toBe(fp2);
+    });
+    it('should handle null/undefined input', () => {
+        const fp1 = generateFingerprint('tool', null);
+        const fp2 = generateFingerprint('tool', undefined);
+        expect(fp1).toBe(fp2);
+    });
+});
+// ─── ApprovalManager ──────────────────────────────────────────────────────────
+describe('ApprovalManager', () => {
+    let manager;
+    beforeEach(() => {
+        manager = new ApprovalManager();
+    });
+    // ── Non-mutating auto-pass ──
+    it('should auto-pass non-mutating tools', () => {
+        const result = manager.check('read_file', { path: 'x' }, false);
+        expect(result.needsApproval).toBe(false);
+    });
+    it('should default to once policy', () => {
+        expect(manager.policy).toBe('once');
+    });
+    it('should require approval for mutating tools', () => {
+        const result = manager.check('write_file', { path: 'x' }, true);
+        expect(result.needsApproval).toBe(true);
+        if (result.needsApproval) {
+            expect(result.toolName).toBe('write_file');
+            expect(result.fingerprint).toBeTruthy();
+        }
+    });
+    it('should cache approval under once policy', () => {
+        const r1 = manager.check('bash', { command: 'ls' }, true);
+        if (r1.needsApproval)
+            manager.recordDecision(r1.fingerprint, 'approve');
+        const r2 = manager.check('bash', { command: 'ls' }, true);
+        expect(r2.needsApproval).toBe(false);
+    });
+    it('should clear once approvals on clearOnceApprovals', () => {
+        const r1 = manager.check('bash', { command: 'ls' }, true);
+        if (r1.needsApproval)
+            manager.recordDecision(r1.fingerprint, 'approve');
+        manager.clearOnceApprovals();
+        const r2 = manager.check('bash', { command: 'ls' }, true);
+        expect(r2.needsApproval).toBe(true);
+    });
+    it('should always require approval under always policy', () => {
+        manager = new ApprovalManager({ policy: 'always' });
+        const r1 = manager.check('bash', { command: 'ls' }, true);
+        if (r1.needsApproval)
+            manager.recordDecision(r1.fingerprint, 'approve');
+        const r2 = manager.check('bash', { command: 'ls' }, true);
+        expect(r2.needsApproval).toBe(true);
+    });
+    it('should persist approval across turns under session policy', () => {
+        manager = new ApprovalManager({ policy: 'session' });
+        const r1 = manager.check('bash', { cmd: 'ls' }, true);
+        if (r1.needsApproval)
+            manager.recordDecision(r1.fingerprint, 'approve');
+        manager.clearOnceApprovals(); // simulate turn end
+        const r2 = manager.check('bash', { cmd: 'ls' }, true);
+        expect(r2.needsApproval).toBe(false);
+    });
+    it('should not cache denied decisions', () => {
+        const r1 = manager.check('bash', { command: 'ls' }, true);
+        if (r1.needsApproval)
+            manager.recordDecision(r1.fingerprint, 'deny');
+        const r2 = manager.check('bash', { command: 'ls' }, true);
+        expect(r2.needsApproval).toBe(true);
+    });
+    it('should clear all caches on dispose', () => {
+        manager = new ApprovalManager({ policy: 'session' });
+        const r1 = manager.check('bash', { cmd: 'ls' }, true);
+        if (r1.needsApproval)
+            manager.recordDecision(r1.fingerprint, 'approve');
+        manager.dispose();
+        const r2 = manager.check('bash', { cmd: 'ls' }, true);
+        expect(r2.needsApproval).toBe(true);
+    });
+    it('should clear cache when switching policy', () => {
+        const r1 = manager.check('bash', { cmd: 'ls' }, true);
+        if (r1.needsApproval)
+            manager.recordDecision(r1.fingerprint, 'approve');
+        manager.policy = 'always';
+        const r2 = manager.check('bash', { cmd: 'ls' }, true);
+        expect(r2.needsApproval).toBe(true);
+    });
+});
+//# sourceMappingURL=approval.test.js.map

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

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

package/dist/tools/bash.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file bash 工具 — 执行 Shell 命令。
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const bashTool: ToolDefinition;
+//# sourceMappingURL=bash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAKjD,eAAO,MAAM,QAAQ,EAAE,cA2DtB,CAAA"}

package/dist/tools/bash.js

@@ -0,0 +1,58 @@
+/**
+ * @file bash 工具 — 执行 Shell 命令。
+ */
+import { execSync } from 'node:child_process';
+import { classifyCommand } from './safety.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+export const bashTool = {
+    name: 'bash',
+    description: 'Execute a shell command and return its output. ' +
+        'Use this for running scripts, installing packages, ' +
+        'checking system state, etc. ' +
+        'Dangerous commands will be blocked.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            command: { type: 'string', description: 'The shell command to execute.' },
+            timeout_ms: { type: 'number', description: 'Timeout in ms. Defaults to 30000.' },
+        },
+        required: ['command'],
+    },
+    isMutating: true,
+    async execute(input) {
+        const command = String(input.command ?? '');
+        if (!command)
+            return { output: 'Error: command is required.', isError: true };
+        const safety = classifyCommand(command);
+        if (safety === 'block') {
+            return { output: `Blocked: "${command}" is a dangerous command.`, isError: true };
+        }
+        if (safety === 'confirm') {
+            console.log(`  ⚠️ [bash] confirm-level command: ${command}`);
+        }
+        const timeout = Number(input.timeout_ms) || DEFAULT_TIMEOUT_MS;
+        try {
+            const result = execSync(command, {
+                encoding: 'utf-8',
+                timeout,
+                maxBuffer: 1024 * 1024,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return { output: result || '(no output)' };
+        }
+        catch (err) {
+            const execErr = err;
+            const parts = [];
+            if (execErr.stdout)
+                parts.push(execErr.stdout);
+            if (execErr.stderr)
+                parts.push(execErr.stderr);
+            if (parts.length > 0) {
+                const prefix = `Exit code: ${execErr.status ?? 'unknown'}\n`;
+                return { output: prefix + parts.join('\n') };
+            }
+            return { output: `bash failed: ${execErr.message}`, isError: true };
+        }
+    },
+};
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bash.js","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,kBAAkB,GAAG,MAAM,CAAA;AAEjC,MAAM,CAAC,MAAM,QAAQ,GAAmB;IACpC,IAAI,EAAE,MAAM;IACZ,WAAW,EACP,iDAAiD;QACjD,qDAAqD;QACrD,8BAA8B;QAC9B,qCAAqC;IACzC,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+BAA+B,EAAE;YACzE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mCAAmC,EAAE;SACnF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACxB;IACD,UAAU,EAAE,IAAI;IAEhB,KAAK,CAAC,OAAO,CAAC,KAAK;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;QAC3C,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,MAAM,EAAE,6BAA6B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QAE7E,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;QACvC,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;YACrB,OAAO,EAAE,MAAM,EAAE,aAAa,OAAO,2BAA2B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACrF,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,GAAG,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAA;QAChE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,kBAAkB,CAAA;QAE9D,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE;gBAC7B,QAAQ,EAAE,OAAO;gBACjB,OAAO;gBACP,SAAS,EAAE,IAAI,GAAG,IAAI;gBACtB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;aAClC,CAAC,CAAA;YACF,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,aAAa,EAAE,CAAA;QAC9C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,GAKf,CAAA;YAED,MAAM,KAAK,GAAa,EAAE,CAAA;YAC1B,IAAI,OAAO,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAC9C,IAAI,OAAO,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;YAE9C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnB,MAAM,MAAM,GAAG,cAAc,OAAO,CAAC,MAAM,IAAI,SAAS,IAAI,CAAA;gBAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAA;YAChD,CAAC;YAED,OAAO,EAAE,MAAM,EAAE,gBAAgB,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACvE,CAAC;IACL,CAAC;CACJ,CAAA"}

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

@@ -0,0 +1,6 @@
+/**
+ * @file edit_file 工具 — 文件内容替换。
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const editFileTool: ToolDefinition;
+//# sourceMappingURL=edit-file.d.ts.map

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

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

package/dist/tools/edit-file.js

@@ -0,0 +1,58 @@
+/**
+ * @file edit_file 工具 — 文件内容替换。
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { validatePath } from './safety.js';
+export const editFileTool = {
+    name: 'edit_file',
+    description: 'Edit a file by replacing old_text with new_text. ' +
+        'The old_text must match exactly (including whitespace).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'File path to edit.' },
+            old_text: { type: 'string', description: 'Exact text to find and replace.' },
+            new_text: { type: 'string', description: 'Replacement text.' },
+        },
+        required: ['path', 'old_text', 'new_text'],
+    },
+    isMutating: true,
+    async execute(input) {
+        const filePath = String(input.path ?? '');
+        const oldText = String(input.old_text ?? '');
+        const newText = String(input.new_text ?? '');
+        if (!filePath)
+            return { output: 'Error: path is required.', isError: true };
+        if (!oldText)
+            return { output: 'Error: old_text is required.', isError: true };
+        const validation = validatePath(filePath);
+        if (!validation.ok)
+            return { output: validation.error, isError: true };
+        const resolved = path.resolve(filePath);
+        try {
+            const original = await fs.readFile(resolved, 'utf-8');
+            const idx = original.indexOf(oldText);
+            if (idx === -1) {
+                return { output: 'Error: old_text not found in file.', isError: true };
+            }
+            const secondIdx = original.indexOf(oldText, idx + 1);
+            if (secondIdx !== -1) {
+                return { output: 'Error: old_text matches multiple locations. Please provide more specific text.', isError: true };
+            }
+            const updated = original.replace(oldText, newText);
+            await fs.writeFile(resolved, updated, 'utf-8');
+            const oldLines = oldText.split('\n').length;
+            const newLines = newText.split('\n').length;
+            return { output: `File edited: ${resolved} (replaced ${oldLines} lines with ${newLines} lines)` };
+        }
+        catch (err) {
+            const code = err.code;
+            const msg = code === 'ENOENT'
+                ? `File not found: ${resolved}`
+                : `edit_file failed: ${err.message}`;
+            return { output: msg, isError: true };
+        }
+    },
+};
+//# sourceMappingURL=edit-file.js.map

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

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

package/dist/tools/get-memory.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file get_memory 工具 — 读取项目级记忆（AGENTS.md）。
+ *
+ * 参考 memo-code 的 get_memory.ts，
+ * 让 Agent 能在需要时检索项目的关键指令和上下文。
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const getMemoryTool: ToolDefinition;
+//# sourceMappingURL=get-memory.d.ts.map

package/dist/tools/get-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-memory.d.ts","sourceRoot":"","sources":["../../src/tools/get-memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAOjD,eAAO,MAAM,aAAa,EAAE,cAmD3B,CAAA"}

package/dist/tools/get-memory.js

@@ -0,0 +1,56 @@
+/**
+ * @file get_memory 工具 — 读取项目级记忆（AGENTS.md）。
+ *
+ * 参考 memo-code 的 get_memory.ts，
+ * 让 Agent 能在需要时检索项目的关键指令和上下文。
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+/** 支持的 memory_id → 文件路径映射。 */
+const MEMORY_FILES = {
+    project: 'AGENTS.md',
+};
+export const getMemoryTool = {
+    name: 'get_memory',
+    description: 'Load stored memory for a given memory_id. ' +
+        'Use memory_id "project" to read the project-level AGENTS.md.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            memory_id: {
+                type: 'string',
+                description: 'Memory identifier. Currently supports: "project".',
+            },
+        },
+        required: ['memory_id'],
+    },
+    isMutating: false,
+    async execute(input) {
+        const memoryId = String(input.memory_id ?? '').trim();
+        if (!memoryId) {
+            return { output: 'Error: memory_id is required.', isError: true };
+        }
+        const filename = MEMORY_FILES[memoryId];
+        if (!filename) {
+            const supported = Object.keys(MEMORY_FILES).join(', ');
+            return {
+                output: `Error: unknown memory_id "${memoryId}". Supported: ${supported}`,
+                isError: true,
+            };
+        }
+        const resolved = path.resolve(filename);
+        try {
+            const content = await fs.readFile(resolved, 'utf-8');
+            return {
+                output: JSON.stringify({ memory_id: memoryId, memory_summary: content }, null, 2),
+            };
+        }
+        catch {
+            return {
+                output: `memory not found for memory_id=${memoryId}`,
+                isError: true,
+            };
+        }
+    },
+};
+//# sourceMappingURL=get-memory.js.map

package/dist/tools/get-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-memory.js","sourceRoot":"","sources":["../../src/tools/get-memory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAGjC,8BAA8B;AAC9B,MAAM,YAAY,GAA2B;IACzC,OAAO,EAAE,WAAW;CACvB,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAmB;IACzC,IAAI,EAAE,YAAY;IAClB,WAAW,EACP,4CAA4C;QAC5C,8DAA8D;IAClE,WAAW,EAAE;QACT,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACR,SAAS,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EACP,mDAAmD;aAC1D;SACJ;QACD,QAAQ,EAAE,CAAC,WAAW,CAAC;KAC1B;IACD,UAAU,EAAE,KAAK;IAEjB,KAAK,CAAC,OAAO,CAAC,KAAK;QACf,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;QACrD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,OAAO,EAAE,MAAM,EAAE,+BAA+B,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;QACrE,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAA;QACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACtD,OAAO;gBACH,MAAM,EAAE,6BAA6B,QAAQ,iBAAiB,SAAS,EAAE;gBACzE,OAAO,EAAE,IAAI;aAChB,CAAA;QACL,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAEvC,IAAI,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;YACpD,OAAO;gBACH,MAAM,EAAE,IAAI,CAAC,SAAS,CAClB,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,EAChD,IAAI,EACJ,CAAC,CACJ;aACJ,CAAA;QACL,CAAC;QAAC,MAAM,CAAC;YACL,OAAO;gBACH,MAAM,EAAE,kCAAkC,QAAQ,EAAE;gBACpD,OAAO,EAAE,IAAI;aAChB,CAAA;QACL,CAAC;IACL,CAAC;CACJ,CAAA"}

package/dist/tools/list-directory.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file list_directory 工具 — 列出目录内容。
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const listDirectoryTool: ToolDefinition;
+//# sourceMappingURL=list-directory.d.ts.map

package/dist/tools/list-directory.d.ts.map

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

package/dist/tools/list-directory.js

@@ -0,0 +1,68 @@
+/**
+ * @file list_directory 工具 — 列出目录内容。
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { validatePath } from './safety.js';
+export const listDirectoryTool = {
+    name: 'list_directory',
+    description: 'List the contents of a directory. ' +
+        'Returns file names, types (file/dir), and sizes.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Directory path to list.' },
+        },
+        required: ['path'],
+    },
+    isMutating: false,
+    async execute(input) {
+        const dirPath = String(input.path ?? '');
+        if (!dirPath)
+            return { output: 'Error: path is required.', isError: true };
+        const validation = validatePath(dirPath);
+        if (!validation.ok)
+            return { output: validation.error, isError: true };
+        const resolved = path.resolve(dirPath);
+        try {
+            const entries = await fs.readdir(resolved, { withFileTypes: true });
+            if (entries.length === 0) {
+                return { output: `${resolved}/ (empty directory)` };
+            }
+            const lines = [];
+            for (const entry of entries) {
+                const fullPath = path.join(resolved, entry.name);
+                if (entry.isDirectory()) {
+                    lines.push(`  [DIR]  ${entry.name}/`);
+                }
+                else {
+                    try {
+                        const stat = await fs.stat(fullPath);
+                        lines.push(`  [FILE] ${entry.name} (${formatSize(stat.size)})`);
+                    }
+                    catch {
+                        lines.push(`  [FILE] ${entry.name}`);
+                    }
+                }
+            }
+            return { output: `${resolved}/ (${entries.length} entries)\n${lines.join('\n')}` };
+        }
+        catch (err) {
+            const code = err.code;
+            const msg = code === 'ENOENT'
+                ? `Directory not found: ${resolved}`
+                : code === 'ENOTDIR'
+                    ? `Not a directory: ${resolved}`
+                    : `list_directory failed: ${err.message}`;
+            return { output: msg, isError: true };
+        }
+    },
+};
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=list-directory.js.map

package/dist/tools/list-directory.js.map

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