yuangs 6.2.3 → 6.4.0

package/dist/agent/tools/SearchSymbol.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchSymbol = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const utils_1 = require("./utils");
+const pathSafety_1 = require("./pathSafety");
+const executor_1 = require("../executor");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+class SearchSymbol {
+    name = 'search_symbol';
+    description = '搜索代码符号（函数、类、变量等）';
+    parameters = [
+        { name: 'symbol', type: 'string', required: true, description: '符号名称' },
+        { name: 'symbol_type', type: 'string', required: false, description: '符号类型（function/class/interface）' },
+        { name: 'path', type: 'string', required: false, description: '搜索路径' },
+        { name: 'file_pattern', type: 'string', required: false, description: '文件名模式' }
+    ];
+    async execute(params) {
+        const symbol = params.symbol;
+        const symbolType = params.symbol_type;
+        const searchPath = params.path || '.';
+        const filePattern = params.file_pattern;
+        try {
+            const safePath = await (0, pathSafety_1.resolveAndValidate)(searchPath, executor_1.ToolExecutor.getAllowedCwd());
+            let pattern = symbol;
+            switch (symbolType) {
+                case 'function':
+                    pattern = `function\\s+${symbol}|${symbol}\\s*[:=]\\s*function|const\\s+${symbol}\\s*=`;
+                    break;
+                case 'class':
+                    pattern = `class\\s+${symbol}`;
+                    break;
+                case 'interface':
+                    pattern = `interface\\s+${symbol}`;
+                    break;
+            }
+            let grepCmd = `grep -rn --color=never -E "${pattern}" ${safePath}`;
+            if (filePattern)
+                grepCmd += ` --include="${filePattern}"`;
+            const { stdout } = await execAsync(grepCmd, {
+                maxBuffer: 10 * 1024 * 1024,
+                cwd: process.cwd()
+            });
+            if (!stdout.trim()) {
+                return (0, utils_1.successResult)(`未找到符号 "${symbol}"`);
+            }
+            return (0, utils_1.successResult)(stdout);
+        }
+        catch (error) {
+            if (error.message?.includes('Access denied')) {
+                return (0, utils_1.failResult)(error.message);
+            }
+            if (error.code === 1) {
+                return (0, utils_1.successResult)(`未找到符号 "${symbol}"`);
+            }
+            return (0, utils_1.failResult)(error.message);
+        }
+    }
+}
+exports.SearchSymbol = SearchSymbol;
+//# sourceMappingURL=SearchSymbol.js.map

package/dist/agent/tools/SearchSymbol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchSymbol.js","sourceRoot":"","sources":["../../../src/agent/tools/SearchSymbol.ts"],"names":[],"mappings":";;;AAAA,iDAAqC;AACrC,+BAAiC;AAGjC,mCAAoD;AACpD,6CAAkD;AAClD,0CAA2C;AAE3C,MAAM,SAAS,GAAG,IAAA,gBAAS,EAAC,oBAAI,CAAC,CAAC;AAElC,MAAa,YAAY;IACvB,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,kBAAkB,CAAC;IACjC,UAAU,GAAoB;QAC5B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE;QACvE,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gCAAgC,EAAE;QACvG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE;QACtE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE;KAChF,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA2B;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7B,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,IAAI,GAAG,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;QAExC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAkB,EAAC,UAAU,EAAE,uBAAY,CAAC,aAAa,EAAE,CAAC,CAAC;YACpF,IAAI,OAAO,GAAG,MAAM,CAAC;YACrB,QAAQ,UAAU,EAAE,CAAC;gBACnB,KAAK,UAAU;oBACb,OAAO,GAAG,eAAe,MAAM,IAAI,MAAM,iCAAiC,MAAM,OAAO,CAAC;oBACxF,MAAM;gBACR,KAAK,OAAO;oBACV,OAAO,GAAG,YAAY,MAAM,EAAE,CAAC;oBAC/B,MAAM;gBACR,KAAK,WAAW;oBACd,OAAO,GAAG,gBAAgB,MAAM,EAAE,CAAC;oBACnC,MAAM;YACV,CAAC;YAED,IAAI,OAAO,GAAG,8BAA8B,OAAO,KAAK,QAAQ,EAAE,CAAC;YACnE,IAAI,WAAW;gBAAE,OAAO,IAAI,eAAe,WAAW,GAAG,CAAC;YAE1D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;gBAC1C,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;gBAC3B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;aACnB,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,OAAO,IAAA,qBAAa,EAAC,UAAU,MAAM,GAAG,CAAC,CAAC;YAC5C,CAAC;YAED,OAAO,IAAA,qBAAa,EAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC7C,OAAO,IAAA,kBAAU,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;YACD,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACrB,OAAO,IAAA,qBAAa,EAAC,UAAU,MAAM,GAAG,CAAC,CAAC;YAC5C,CAAC;YACD,OAAO,IAAA,kBAAU,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AAtDD,oCAsDC"}

package/dist/agent/tools/ShellCmd.d.ts

@@ -0,0 +1,8 @@
+import { Tool, ToolParameter } from './types';
+import { ToolExecutionResult } from '../state';
+export declare class ShellCmd implements Tool {
+    name: string;
+    description: string;
+    parameters: ToolParameter[];
+    execute(params: Record<string, any>): Promise<ToolExecutionResult>;
+}

package/dist/agent/tools/ShellCmd.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShellCmd = void 0;
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const utils_1 = require("./utils");
+const toolResultStorage_1 = require("../toolResultStorage");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+class ShellCmd {
+    name = 'shell_cmd';
+    description = '执行 shell 命令';
+    parameters = [
+        { name: 'command', type: 'string', required: true, description: '要执行的命令' }
+    ];
+    async execute(params) {
+        const command = params.command;
+        try {
+            const { stdout, stderr } = await execAsync(command, {
+                maxBuffer: 10 * 1024 * 1024,
+                cwd: process.cwd()
+            });
+            let output = stdout || stderr || '';
+            const baseCmd = command.split(/\s+/)[0];
+            const persisted = await (0, toolResultStorage_1.persistToolResult)(output, baseCmd);
+            if (persisted) {
+                output = `${persisted.preview}\n\n[⚠️ 输出已截断，完整结果已保存到 ${persisted.filepath}（${(0, toolResultStorage_1.formatFileSize)(persisted.originalSize)}）]`;
+            }
+            return (0, utils_1.successResult)(output, persisted ? [persisted.filepath] : []);
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error.message,
+                output: error.stdout || error.stderr || ''
+            };
+        }
+    }
+}
+exports.ShellCmd = ShellCmd;
+//# sourceMappingURL=ShellCmd.js.map

package/dist/agent/tools/ShellCmd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellCmd.js","sourceRoot":"","sources":["../../../src/agent/tools/ShellCmd.ts"],"names":[],"mappings":";;;AAAA,iDAAqC;AACrC,+BAAiC;AAGjC,mCAAoD;AACpD,4DAAyE;AAEzE,MAAM,SAAS,GAAG,IAAA,gBAAS,EAAC,oBAAI,CAAC,CAAC;AAElC,MAAa,QAAQ;IACnB,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,aAAa,CAAC;IAC5B,UAAU,GAAoB;QAC5B,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE;KAC3E,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA2B;QACvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAE/B,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE;gBAClD,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;gBAC3B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;aACnB,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,MAAM,IAAI,MAAM,IAAI,EAAE,CAAC;YAEpC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,MAAM,SAAS,GAAG,MAAM,IAAA,qCAAiB,EAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAC3D,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,0BAA0B,SAAS,CAAC,QAAQ,IAAI,IAAA,kCAAc,EAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC;YAC1H,CAAC;YAED,OAAO,IAAA,qBAAa,EAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,CAAC,OAAO;gBACpB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE;aAC3C,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAjCD,4BAiCC"}

package/dist/agent/tools/WriteFile.d.ts

@@ -0,0 +1,8 @@
+import { Tool, ToolParameter } from './types';
+import { ToolExecutionResult } from '../state';
+export declare class WriteFile implements Tool {
+    name: string;
+    description: string;
+    parameters: ToolParameter[];
+    execute(params: Record<string, any>): Promise<ToolExecutionResult>;
+}

package/dist/agent/tools/WriteFile.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WriteFile = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+const utils_1 = require("./utils");
+const pathSafety_1 = require("./pathSafety");
+const executor_1 = require("../executor");
+class WriteFile {
+    name = 'write_file';
+    description = '写入文件内容（覆盖或创建）';
+    parameters = [
+        { name: 'path', type: 'string', required: true, description: '文件路径' },
+        { name: 'content', type: 'string', required: true, description: '文件内容' }
+    ];
+    async execute(params) {
+        try {
+            const safePath = await (0, pathSafety_1.resolveAndValidate)(params.path, executor_1.ToolExecutor.getAllowedCwd());
+            await promises_1.default.mkdir(path_1.default.dirname(safePath), { recursive: true });
+            await promises_1.default.writeFile(safePath, params.content, 'utf-8');
+            return (0, utils_1.successResult)(`Successfully wrote ${safePath}`, [safePath]);
+        }
+        catch (error) {
+            if (error.message?.includes('Access denied')) {
+                return (0, utils_1.failResult)(error.message);
+            }
+            return (0, utils_1.failResult)(error.message);
+        }
+    }
+}
+exports.WriteFile = WriteFile;
+//# sourceMappingURL=WriteFile.js.map

package/dist/agent/tools/WriteFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteFile.js","sourceRoot":"","sources":["../../../src/agent/tools/WriteFile.ts"],"names":[],"mappings":";;;;;;AAAA,2DAA6B;AAC7B,gDAAwB;AAGxB,mCAAoD;AACpD,6CAAkD;AAClD,0CAA2C;AAE3C,MAAa,SAAS;IACpB,IAAI,GAAG,YAAY,CAAC;IACpB,WAAW,GAAG,eAAe,CAAC;IAC9B,UAAU,GAAoB;QAC5B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE;QACrE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE;KACzE,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAA2B;QACvC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAkB,EAAC,MAAM,CAAC,IAAI,EAAE,uBAAY,CAAC,aAAa,EAAE,CAAC,CAAC;YACrF,MAAM,kBAAE,CAAC,KAAK,CAAC,cAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,kBAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACtD,OAAO,IAAA,qBAAa,EAAC,sBAAsB,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gBAC7C,OAAO,IAAA,kBAAU,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACnC,CAAC;YACD,OAAO,IAAA,kBAAU,EAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;CACF;AArBD,8BAqBC"}

package/dist/agent/tools/index.d.ts

@@ -0,0 +1,20 @@
+export { Tool, ToolParameter } from './types';
+export { ToolRegistry } from './registry';
+export { maybeTruncateOutput, formatBytes, getFriendlyError, getReadPosition, setReadPosition, clearReadPosition, getMaxOutputLength, failResult, successResult } from './utils';
+export { ReadFile } from './ReadFile';
+export { ReadFileLines } from './ReadFileLines';
+export { ReadFileLinesFromEnd } from './ReadFileLinesFromEnd';
+export { WriteFile } from './WriteFile';
+export { AppendFile } from './AppendFile';
+export { FileInfo } from './FileInfo';
+export { ContinueReading } from './ContinueReading';
+export { ListFiles } from './ListFiles';
+export { ListDirectoryTree } from './ListDirectoryTree';
+export { SearchInFiles } from './SearchInFiles';
+export { SearchSymbol } from './SearchSymbol';
+export { AnalyzeDependencies } from './AnalyzeDependencies';
+export { GitStatus } from './GitStatus';
+export { GitDiff } from './GitDiff';
+export { GitLog } from './GitLog';
+export { ShellCmd } from './ShellCmd';
+export { CodeDiff } from './CodeDiff';

package/dist/agent/tools/index.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeDiff = exports.ShellCmd = exports.GitLog = exports.GitDiff = exports.GitStatus = exports.AnalyzeDependencies = exports.SearchSymbol = exports.SearchInFiles = exports.ListDirectoryTree = exports.ListFiles = exports.ContinueReading = exports.FileInfo = exports.AppendFile = exports.WriteFile = exports.ReadFileLinesFromEnd = exports.ReadFileLines = exports.ReadFile = exports.successResult = exports.failResult = exports.getMaxOutputLength = exports.clearReadPosition = exports.setReadPosition = exports.getReadPosition = exports.getFriendlyError = exports.formatBytes = exports.maybeTruncateOutput = exports.ToolRegistry = void 0;
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "ToolRegistry", { enumerable: true, get: function () { return registry_1.ToolRegistry; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "maybeTruncateOutput", { enumerable: true, get: function () { return utils_1.maybeTruncateOutput; } });
+Object.defineProperty(exports, "formatBytes", { enumerable: true, get: function () { return utils_1.formatBytes; } });
+Object.defineProperty(exports, "getFriendlyError", { enumerable: true, get: function () { return utils_1.getFriendlyError; } });
+Object.defineProperty(exports, "getReadPosition", { enumerable: true, get: function () { return utils_1.getReadPosition; } });
+Object.defineProperty(exports, "setReadPosition", { enumerable: true, get: function () { return utils_1.setReadPosition; } });
+Object.defineProperty(exports, "clearReadPosition", { enumerable: true, get: function () { return utils_1.clearReadPosition; } });
+Object.defineProperty(exports, "getMaxOutputLength", { enumerable: true, get: function () { return utils_1.getMaxOutputLength; } });
+Object.defineProperty(exports, "failResult", { enumerable: true, get: function () { return utils_1.failResult; } });
+Object.defineProperty(exports, "successResult", { enumerable: true, get: function () { return utils_1.successResult; } });
+var ReadFile_1 = require("./ReadFile");
+Object.defineProperty(exports, "ReadFile", { enumerable: true, get: function () { return ReadFile_1.ReadFile; } });
+var ReadFileLines_1 = require("./ReadFileLines");
+Object.defineProperty(exports, "ReadFileLines", { enumerable: true, get: function () { return ReadFileLines_1.ReadFileLines; } });
+var ReadFileLinesFromEnd_1 = require("./ReadFileLinesFromEnd");
+Object.defineProperty(exports, "ReadFileLinesFromEnd", { enumerable: true, get: function () { return ReadFileLinesFromEnd_1.ReadFileLinesFromEnd; } });
+var WriteFile_1 = require("./WriteFile");
+Object.defineProperty(exports, "WriteFile", { enumerable: true, get: function () { return WriteFile_1.WriteFile; } });
+var AppendFile_1 = require("./AppendFile");
+Object.defineProperty(exports, "AppendFile", { enumerable: true, get: function () { return AppendFile_1.AppendFile; } });
+var FileInfo_1 = require("./FileInfo");
+Object.defineProperty(exports, "FileInfo", { enumerable: true, get: function () { return FileInfo_1.FileInfo; } });
+var ContinueReading_1 = require("./ContinueReading");
+Object.defineProperty(exports, "ContinueReading", { enumerable: true, get: function () { return ContinueReading_1.ContinueReading; } });
+var ListFiles_1 = require("./ListFiles");
+Object.defineProperty(exports, "ListFiles", { enumerable: true, get: function () { return ListFiles_1.ListFiles; } });
+var ListDirectoryTree_1 = require("./ListDirectoryTree");
+Object.defineProperty(exports, "ListDirectoryTree", { enumerable: true, get: function () { return ListDirectoryTree_1.ListDirectoryTree; } });
+var SearchInFiles_1 = require("./SearchInFiles");
+Object.defineProperty(exports, "SearchInFiles", { enumerable: true, get: function () { return SearchInFiles_1.SearchInFiles; } });
+var SearchSymbol_1 = require("./SearchSymbol");
+Object.defineProperty(exports, "SearchSymbol", { enumerable: true, get: function () { return SearchSymbol_1.SearchSymbol; } });
+var AnalyzeDependencies_1 = require("./AnalyzeDependencies");
+Object.defineProperty(exports, "AnalyzeDependencies", { enumerable: true, get: function () { return AnalyzeDependencies_1.AnalyzeDependencies; } });
+var GitStatus_1 = require("./GitStatus");
+Object.defineProperty(exports, "GitStatus", { enumerable: true, get: function () { return GitStatus_1.GitStatus; } });
+var GitDiff_1 = require("./GitDiff");
+Object.defineProperty(exports, "GitDiff", { enumerable: true, get: function () { return GitDiff_1.GitDiff; } });
+var GitLog_1 = require("./GitLog");
+Object.defineProperty(exports, "GitLog", { enumerable: true, get: function () { return GitLog_1.GitLog; } });
+var ShellCmd_1 = require("./ShellCmd");
+Object.defineProperty(exports, "ShellCmd", { enumerable: true, get: function () { return ShellCmd_1.ShellCmd; } });
+var CodeDiff_1 = require("./CodeDiff");
+Object.defineProperty(exports, "CodeDiff", { enumerable: true, get: function () { return CodeDiff_1.CodeDiff; } });
+//# sourceMappingURL=index.js.map

package/dist/agent/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agent/tools/index.ts"],"names":[],"mappings":";;;AACA,uCAA0C;AAAjC,wGAAA,YAAY,OAAA;AACrB,iCAUiB;AATf,4GAAA,mBAAmB,OAAA;AACnB,oGAAA,WAAW,OAAA;AACX,yGAAA,gBAAgB,OAAA;AAChB,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,0GAAA,iBAAiB,OAAA;AACjB,2GAAA,kBAAkB,OAAA;AAClB,mGAAA,UAAU,OAAA;AACV,sGAAA,aAAa,OAAA;AAGf,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAC7B,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,qDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA;AAC5B,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA"}

package/dist/agent/tools/pathSafety.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Resolve a path and validate it's safe to access.
+ *
+ * @param targetPath The path to validate (may be relative or contain symlinks)
+ * @param allowedCwd The root directory that access should be confined to
+ * @returns The resolved absolute path if safe
+ * @throws Error if the path is outside allowedCwd or points to a system path
+ */
+export declare function resolveAndValidate(targetPath: string, allowedCwd: string): Promise<string>;

package/dist/agent/tools/pathSafety.js

@@ -0,0 +1,85 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveAndValidate = resolveAndValidate;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Known dangerous system paths that should never be accessed,
+ * even if they happen to be under allowedCwd (e.g. via symlink).
+ */
+const SYSTEM_PATHS = [
+    '/etc', '/usr', '/var', '/tmp', '/root', '/home',
+    '/System', '/Library', '/Applications',
+    '/dev', '/proc', '/sys', '/boot'
+];
+/**
+ * Resolve a path and validate it's safe to access.
+ *
+ * @param targetPath The path to validate (may be relative or contain symlinks)
+ * @param allowedCwd The root directory that access should be confined to
+ * @returns The resolved absolute path if safe
+ * @throws Error if the path is outside allowedCwd or points to a system path
+ */
+async function resolveAndValidate(targetPath, allowedCwd) {
+    // 1. Normalize to absolute path
+    const resolved = path_1.default.resolve(allowedCwd, targetPath);
+    // 2. Check against known system paths (string-level check, fast)
+    for (const sysPath of SYSTEM_PATHS) {
+        if (resolved === sysPath || resolved.startsWith(sysPath + '/')) {
+            throw new Error(`Access denied: ${resolved} is a protected system path`);
+        }
+    }
+    // 3. Resolve symlinks to get the real path
+    let realPath;
+    try {
+        realPath = await promises_1.default.realpath(resolved);
+    }
+    catch (error) {
+        // File may not exist yet (e.g. write_file creating new file)
+        // For non-existent files, validate the parent directory
+        const parentDir = path_1.default.dirname(resolved);
+        try {
+            const realParent = await promises_1.default.realpath(parentDir);
+            if (!isPathInScope(realParent, allowedCwd)) {
+                throw new Error(`Access denied: parent directory of ${resolved} is outside allowed workspace`);
+            }
+            return resolved;
+        }
+        catch {
+            // Parent doesn't exist either — allow it (write_file will create dirs)
+            // But still check that the resolved path is under allowedCwd
+            if (!isPathInScope(resolved, allowedCwd)) {
+                throw new Error(`Access denied: ${resolved} is outside allowed workspace`);
+            }
+            return resolved;
+        }
+    }
+    // 4. Validate real path is under allowedCwd
+    if (!isPathInScope(realPath, allowedCwd)) {
+        throw new Error(`Access denied: ${realPath} resolves outside allowed workspace (${allowedCwd})`);
+    }
+    // 5. Double-check: real path shouldn't point to system paths (symlink escape)
+    for (const sysPath of SYSTEM_PATHS) {
+        if (realPath === sysPath || realPath.startsWith(sysPath + '/')) {
+            throw new Error(`Access denied: ${targetPath} resolves to protected system path ${realPath}`);
+        }
+    }
+    return realPath;
+}
+/**
+ * Check if a resolved path is within the allowed scope.
+ * Both paths should already be absolute/normalized.
+ */
+function isPathInScope(targetPath, allowedCwd) {
+    const normalizedTarget = path_1.default.normalize(targetPath);
+    const normalizedCwd = path_1.default.normalize(allowedCwd);
+    // Ensure allowedCwd has a trailing separator for proper prefix check
+    const cwdPrefix = normalizedCwd.endsWith(path_1.default.sep)
+        ? normalizedCwd
+        : normalizedCwd + path_1.default.sep;
+    return normalizedTarget === normalizedCwd || normalizedTarget.startsWith(cwdPrefix);
+}
+//# sourceMappingURL=pathSafety.js.map

package/dist/agent/tools/pathSafety.js.map

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

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

@@ -0,0 +1,40 @@
+import { Tool } from './types';
+/**
+ * Tool registry — manages tool registration and lookup.
+ */
+export declare class ToolRegistry {
+    private tools;
+    /**
+     * Register a tool instance.
+     */
+    register(tool: Tool): void;
+    /**
+     * Register multiple tools at once.
+     */
+    registerAll(tools: Tool[]): void;
+    /**
+     * Get a tool by name.
+     */
+    get(name: string): Tool | undefined;
+    /**
+     * Check if a tool exists.
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered tool names.
+     */
+    names(): string[];
+    /**
+     * Get all registered tool instances.
+     */
+    all(): Tool[];
+    /**
+     * Generate tool definitions for LLM prompt (JSON schema format).
+     */
+    generateDefinitions(): Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, any>;
+    }>;
+    private parametersToSchema;
+}

package/dist/agent/tools/registry.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ToolRegistry = void 0;
+/**
+ * Tool registry — manages tool registration and lookup.
+ */
+class ToolRegistry {
+    tools = new Map();
+    /**
+     * Register a tool instance.
+     */
+    register(tool) {
+        this.tools.set(tool.name, tool);
+    }
+    /**
+     * Register multiple tools at once.
+     */
+    registerAll(tools) {
+        for (const t of tools) {
+            this.register(t);
+        }
+    }
+    /**
+     * Get a tool by name.
+     */
+    get(name) {
+        return this.tools.get(name);
+    }
+    /**
+     * Check if a tool exists.
+     */
+    has(name) {
+        return this.tools.has(name);
+    }
+    /**
+     * Get all registered tool names.
+     */
+    names() {
+        return Array.from(this.tools.keys());
+    }
+    /**
+     * Get all registered tool instances.
+     */
+    all() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Generate tool definitions for LLM prompt (JSON schema format).
+     */
+    generateDefinitions() {
+        return this.all().map(t => ({
+            name: t.name,
+            description: t.description,
+            parameters: this.parametersToSchema(t.parameters)
+        }));
+    }
+    parametersToSchema(params) {
+        const properties = {};
+        const required = [];
+        for (const p of params) {
+            properties[p.name] = {
+                type: p.type === 'array' ? 'array' : p.type,
+                description: p.description
+            };
+            if (p.required) {
+                required.push(p.name);
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            required
+        };
+    }
+}
+exports.ToolRegistry = ToolRegistry;
+//# sourceMappingURL=registry.js.map

package/dist/agent/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/agent/tools/registry.ts"],"names":[],"mappings":";;;AAGA;;GAEG;AACH,MAAa,YAAY;IACf,KAAK,GAAsB,IAAI,GAAG,EAAE,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAa;QACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,GAAG;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,WAAW,EAAE,CAAC,CAAC,WAAW;YAC1B,UAAU,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,CAAC;SAClD,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,kBAAkB,CAAC,MAAuB;QAChD,MAAM,UAAU,GAAwB,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG;gBACnB,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI;gBAC3C,WAAW,EAAE,CAAC,CAAC,WAAW;aAC3B,CAAC;YACF,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;gBACf,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,QAAQ;YACd,UAAU;YACV,QAAQ;SACT,CAAC;IACJ,CAAC;CACF;AA9ED,oCA8EC"}

package/dist/agent/tools/types.d.ts

@@ -0,0 +1,21 @@
+import { ToolExecutionResult } from '../state';
+import { CapabilityLevel } from '../../core/capability/CapabilityLevel';
+/**
+ * Parameter definition for a tool.
+ */
+export interface ToolParameter {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'array';
+    required: boolean;
+    description: string;
+}
+/**
+ * Abstract tool interface — each tool implementation must satisfy this.
+ */
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: ToolParameter[];
+    capabilityLevel?: CapabilityLevel;
+    execute(params: Record<string, any>): Promise<ToolExecutionResult>;
+}

package/dist/agent/tools/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/agent/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/agent/tools/types.ts"],"names":[],"mappings":""}

package/dist/agent/tools/utils.d.ts

@@ -0,0 +1,43 @@
+import { ToolExecutionResult } from '../state';
+/**
+ * Get stored read position for a file (used by continue_reading).
+ */
+export declare function getReadPosition(filePath: string): number | undefined;
+/**
+ * Set read position for a file.
+ */
+export declare function setReadPosition(filePath: string, position: number): void;
+/**
+ * Clear read position for a file.
+ */
+export declare function clearReadPosition(filePath: string): void;
+/**
+ * Get the maximum output length threshold.
+ */
+export declare function getMaxOutputLength(): number;
+/**
+ * Intelligently truncate output.
+ * When output exceeds the limit, returns truncated text with a suggestion block.
+ */
+export declare function maybeTruncateOutput(output: string, toolName?: string, filePath?: string): string;
+/**
+ * Format byte count into human-readable string.
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * Get user-friendly error message and suggestion for a given tool.
+ */
+export declare function getFriendlyError(toolName: string, error: Error | {
+    message: string;
+}): {
+    message: string;
+    suggestion: string;
+};
+/**
+ * Create a failed ToolExecutionResult from an error.
+ */
+export declare function failResult(error: string, output?: string): ToolExecutionResult;
+/**
+ * Create a success ToolExecutionResult.
+ */
+export declare function successResult(output: string, artifacts?: string[]): ToolExecutionResult;