helixmind 0.5.4

package/dist/cli/agent/tools/edit-file.js

@@ -0,0 +1,61 @@
+import { readFileSync, writeFileSync, statSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { registerTool } from './registry.js';
+import { validatePathEx } from '../sandbox.js';
+/** Maximum file size in bytes (10MB) — matches write_file limit */
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+registerTool({
+    definition: {
+        name: 'edit_file',
+        description: 'Make targeted edits to a file. Replaces a specific string with a new string. The old_string must appear exactly once in the file for a precise match.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path to the file' },
+                old_string: { type: 'string', description: 'The exact string to find and replace (must be unique in the file)' },
+                new_string: { type: 'string', description: 'The replacement string (empty string to delete)' },
+            },
+            required: ['path', 'old_string', 'new_string'],
+        },
+    },
+    async execute(input, ctx) {
+        const { resolved: filePath } = validatePathEx(input.path, ctx.projectRoot);
+        const oldStr = input.old_string;
+        const newStr = input.new_string;
+        // Check file size before reading to prevent OOM
+        try {
+            const stat = statSync(filePath);
+            if (stat.size > MAX_FILE_SIZE) {
+                return `Error: File too large (${(stat.size / 1024 / 1024).toFixed(1)} MB, max ${MAX_FILE_SIZE / 1024 / 1024} MB). Use write_file for smaller targeted writes.`;
+            }
+        }
+        catch {
+            // File doesn't exist yet — will fail on readFileSync below
+        }
+        const original = readFileSync(filePath, 'utf-8');
+        const occurrences = original.split(oldStr).length - 1;
+        if (occurrences === 0) {
+            return `Error: old_string not found in ${input.path}. The exact text does not exist in the file.`;
+        }
+        if (occurrences > 1) {
+            return `Error: old_string found ${occurrences} times in ${input.path}. It must be unique. Provide more surrounding context to make it unique.`;
+        }
+        const updated = original.replace(oldStr, newStr);
+        // Write the file
+        writeFileSync(filePath, updated, 'utf-8');
+        // Push to undo stack
+        ctx.undoStack.push({
+            id: randomUUID(),
+            timestamp: Date.now(),
+            tool: 'edit_file',
+            path: filePath,
+            originalContent: original,
+            newContent: updated,
+        });
+        // Generate a simple diff description
+        const oldLines = oldStr.split('\n');
+        const newLines = newStr.split('\n');
+        return `File edited: ${input.path}\n  Replaced ${oldLines.length} line(s) with ${newLines.length} line(s).`;
+    },
+});
+//# sourceMappingURL=edit-file.js.map

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

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

package/dist/cli/agent/tools/find.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=find.d.ts.map

package/dist/cli/agent/tools/find.d.ts.map

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

package/dist/cli/agent/tools/find.js

@@ -0,0 +1,35 @@
+import fg from 'fast-glob';
+import { registerTool } from './registry.js';
+import { validatePathEx } from '../sandbox.js';
+registerTool({
+    definition: {
+        name: 'find_files',
+        description: 'Find files by name pattern using glob. For example "**/*.test.ts" finds all test files.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                pattern: { type: 'string', description: 'Glob pattern (e.g. "**/*.ts", "src/**/*.test.ts")' },
+                path: { type: 'string', description: 'Base directory to search in (default: project root)' },
+            },
+            required: ['pattern'],
+        },
+    },
+    async execute(input, ctx) {
+        const { resolved: baseDir } = validatePathEx(input.path || '.', ctx.projectRoot);
+        const pattern = input.pattern;
+        const files = await fg(pattern, {
+            cwd: baseDir,
+            ignore: ['node_modules/**', '.git/**', 'dist/**', 'coverage/**'],
+            onlyFiles: true,
+            dot: false,
+        });
+        if (files.length === 0) {
+            return `No files found matching pattern: ${pattern}`;
+        }
+        const sorted = files.sort();
+        const display = sorted.slice(0, 100).join('\n');
+        const extra = sorted.length > 100 ? `\n... and ${sorted.length - 100} more` : '';
+        return `Found ${sorted.length} file(s) matching "${pattern}":\n\n${display}${extra}`;
+    },
+});
+//# sourceMappingURL=find.js.map

package/dist/cli/agent/tools/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/find.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,WAAW,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,yFAAyF;QACtG,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mDAAmD,EAAE;gBAC7F,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;aAC7F;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,CAAE,KAAK,CAAC,IAAe,IAAI,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7F,MAAM,OAAO,GAAG,KAAK,CAAC,OAAiB,CAAC;QAExC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE;YAC9B,GAAG,EAAE,OAAO;YACZ,MAAM,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC;YAChE,SAAS,EAAE,IAAI;YACf,GAAG,EAAE,KAAK;SACX,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,oCAAoC,OAAO,EAAE,CAAC;QACvD,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,MAAM,CAAC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAEjF,OAAO,SAAS,MAAM,CAAC,MAAM,sBAAsB,OAAO,SAAS,OAAO,GAAG,KAAK,EAAE,CAAC;IACvF,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/agent/tools/git-commit.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-commit.d.ts.map

package/dist/cli/agent/tools/git-commit.d.ts.map

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

package/dist/cli/agent/tools/git-commit.js

@@ -0,0 +1,57 @@
+import { execFileSync } from 'node:child_process';
+import { registerTool } from './registry.js';
+registerTool({
+    definition: {
+        name: 'git_commit',
+        description: 'Stage files and create a git commit. If no files specified, stages all modified files.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                message: { type: 'string', description: 'Commit message' },
+                files: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Specific files to stage (default: all modified files)',
+                },
+            },
+            required: ['message'],
+        },
+    },
+    async execute(input, ctx) {
+        try {
+            execFileSync('git', ['rev-parse', '--is-inside-work-tree'], { cwd: ctx.projectRoot, encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch {
+            return `Not a git repository. The current directory (${ctx.projectRoot}) is not tracked by git.`;
+        }
+        try {
+            const message = input.message;
+            const files = input.files;
+            // Stage files (use execFileSync to prevent shell injection via file names)
+            if (files && files.length > 0) {
+                for (const file of files) {
+                    execFileSync('git', ['add', '--', file], { cwd: ctx.projectRoot });
+                }
+            }
+            else {
+                execFileSync('git', ['add', '-A'], { cwd: ctx.projectRoot });
+            }
+            // Check if there's anything staged
+            const staged = execFileSync('git', ['diff', '--cached', '--stat'], { cwd: ctx.projectRoot, encoding: 'utf-8' }).trim();
+            if (!staged) {
+                return 'Nothing to commit (no staged changes).';
+            }
+            // Commit (use execFileSync to prevent shell injection via commit message)
+            execFileSync('git', ['commit', '-m', message], {
+                cwd: ctx.projectRoot,
+                encoding: 'utf-8',
+            });
+            const hash = execFileSync('git', ['rev-parse', '--short', 'HEAD'], { cwd: ctx.projectRoot, encoding: 'utf-8' }).trim();
+            return `Committed: ${hash} — ${message}\n\n${staged}`;
+        }
+        catch (err) {
+            return `Error: ${err}`;
+        }
+    },
+});
+//# sourceMappingURL=git-commit.js.map

package/dist/cli/agent/tools/git-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-commit.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/git-commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,wFAAwF;QACrG,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gBAAgB,EAAE;gBAC1D,KAAK,EAAE;oBACL,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACzB,WAAW,EAAE,uDAAuD;iBACrE;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1H,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,gDAAgD,GAAG,CAAC,WAAW,0BAA0B,CAAC;QACnG,CAAC;QAED,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,KAAK,CAAC,OAAiB,CAAC;YACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAA6B,CAAC;YAElD,2EAA2E;YAC3E,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,YAAY,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YAC/D,CAAC;YAED,mCAAmC;YACnC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACvH,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,wCAAwC,CAAC;YAClD,CAAC;YAED,0EAA0E;YAC1E,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE;gBAC7C,GAAG,EAAE,GAAG,CAAC,WAAW;gBACpB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACvH,OAAO,cAAc,IAAI,MAAM,OAAO,OAAO,MAAM,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,UAAU,GAAG,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/agent/tools/git-diff.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-diff.d.ts.map

package/dist/cli/agent/tools/git-diff.d.ts.map

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

package/dist/cli/agent/tools/git-diff.js

@@ -0,0 +1,45 @@
+import { execFileSync } from 'node:child_process';
+import { registerTool } from './registry.js';
+registerTool({
+    definition: {
+        name: 'git_diff',
+        description: 'Show git diff for a specific file or all changes. Shows unified diff format.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Specific file to diff (optional, default: all)' },
+                staged: { type: 'boolean', description: 'Show staged changes (default: false)' },
+            },
+            required: [],
+        },
+    },
+    async execute(input, ctx) {
+        try {
+            execFileSync('git', ['rev-parse', '--is-inside-work-tree'], { cwd: ctx.projectRoot, encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch {
+            return `Not a git repository. The current directory (${ctx.projectRoot}) is not tracked by git.`;
+        }
+        try {
+            // Use execFileSync to prevent shell injection via file paths
+            const args = ['diff'];
+            if (input.staged)
+                args.push('--cached');
+            if (input.path)
+                args.push('--', String(input.path));
+            const diff = execFileSync('git', args, { cwd: ctx.projectRoot, encoding: 'utf-8', maxBuffer: 1024 * 1024 }).trim();
+            if (!diff) {
+                return input.staged ? 'No staged changes.' : 'No unstaged changes.';
+            }
+            // Truncate very long diffs
+            if (diff.length > 15000) {
+                return diff.slice(0, 15000) + `\n\n... diff truncated (${diff.length} chars total)`;
+            }
+            return diff;
+        }
+        catch (err) {
+            return `Git error: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+});
+//# sourceMappingURL=git-diff.js.map

package/dist/cli/agent/tools/git-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-diff.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/git-diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,8EAA8E;QAC3F,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gDAAgD,EAAE;gBACvF,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;aACjF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1H,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,gDAAgD,GAAG,CAAC,WAAW,0BAA0B,CAAC;QACnG,CAAC;QAED,IAAI,CAAC;YACH,6DAA6D;YAC7D,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;YACtB,IAAI,KAAK,CAAC,MAAM;gBAAE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAEpD,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAEnH,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,sBAAsB,CAAC;YACtE,CAAC;YAED,2BAA2B;YAC3B,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;gBACxB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,2BAA2B,IAAI,CAAC,MAAM,eAAe,CAAC;YACtF,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,cAAc,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/agent/tools/git-log.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-log.d.ts.map

package/dist/cli/agent/tools/git-log.d.ts.map

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

package/dist/cli/agent/tools/git-log.js

@@ -0,0 +1,41 @@
+import { execFileSync } from 'node:child_process';
+import { registerTool } from './registry.js';
+registerTool({
+    definition: {
+        name: 'git_log',
+        description: 'Show recent git commit history with hash, message, author, and date.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                count: { type: 'number', description: 'Number of commits to show (default: 10)' },
+                file: { type: 'string', description: 'Show history for a specific file (optional)' },
+            },
+            required: [],
+        },
+    },
+    async execute(input, ctx) {
+        try {
+            execFileSync('git', ['rev-parse', '--is-inside-work-tree'], { cwd: ctx.projectRoot, encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch {
+            return `Not a git repository. The current directory (${ctx.projectRoot}) is not tracked by git.`;
+        }
+        try {
+            const rawCount = Number(input.count);
+            const count = Number.isInteger(rawCount) && rawCount > 0 && rawCount <= 100 ? rawCount : 10;
+            // Use execFileSync to prevent shell injection via file paths
+            const args = ['log', `-${count}`, '--format=%h  %s  (%ar)  <%an>'];
+            if (input.file)
+                args.push('--', String(input.file));
+            const log = execFileSync('git', args, { cwd: ctx.projectRoot, encoding: 'utf-8' }).trim();
+            if (!log) {
+                return 'No commits found.';
+            }
+            return `Recent commits:\n\n${log}`;
+        }
+        catch (err) {
+            return `Error: ${err}`;
+        }
+    },
+});
+//# sourceMappingURL=git-log.js.map

package/dist/cli/agent/tools/git-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-log.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/git-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,sEAAsE;QACnF,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;gBACjF,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6CAA6C,EAAE;aACrF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,IAAI,CAAC;YACH,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC1H,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,gDAAgD,GAAG,CAAC,WAAW,0BAA0B,CAAC;QACnG,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,IAAI,QAAQ,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5F,6DAA6D;YAC7D,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,IAAI,KAAK,EAAE,EAAE,+BAA+B,CAAC,CAAC;YACnE,IAAI,KAAK,CAAC,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;YAEpD,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAE1F,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,mBAAmB,CAAC;YAC7B,CAAC;YAED,OAAO,sBAAsB,GAAG,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,UAAU,GAAG,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/agent/tools/git-status.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=git-status.d.ts.map

package/dist/cli/agent/tools/git-status.d.ts.map

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

package/dist/cli/agent/tools/git-status.js

@@ -0,0 +1,52 @@
+import { execSync } from 'node:child_process';
+import { registerTool } from './registry.js';
+registerTool({
+    definition: {
+        name: 'git_status',
+        description: 'Show current git status — modified, added, deleted files, current branch, and tracking info.',
+        input_schema: {
+            type: 'object',
+            properties: {},
+            required: [],
+        },
+    },
+    async execute(_input, ctx) {
+        // Quick check: is this a git repository?
+        try {
+            execSync('git rev-parse --is-inside-work-tree', { cwd: ctx.projectRoot, encoding: 'utf-8', stdio: 'pipe' });
+        }
+        catch {
+            return `Not a git repository. The current directory (${ctx.projectRoot}) is not tracked by git. Use \`git init\` to initialize one, or navigate to a project that uses git.`;
+        }
+        try {
+            const branch = execSync('git branch --show-current', { cwd: ctx.projectRoot, encoding: 'utf-8', stdio: 'pipe' }).trim();
+            const status = execSync('git status --short', { cwd: ctx.projectRoot, encoding: 'utf-8', stdio: 'pipe' }).trim();
+            let ahead = '0';
+            let behind = '0';
+            try {
+                ahead = execSync('git rev-list --count @{upstream}..HEAD', { cwd: ctx.projectRoot, encoding: 'utf-8', stdio: 'pipe' }).trim();
+                behind = execSync('git rev-list --count HEAD..@{upstream}', { cwd: ctx.projectRoot, encoding: 'utf-8', stdio: 'pipe' }).trim();
+            }
+            catch {
+                // No upstream configured — skip ahead/behind
+            }
+            let result = `Branch: ${branch}`;
+            if (ahead !== '0')
+                result += ` (${ahead} ahead)`;
+            if (behind !== '0')
+                result += ` (${behind} behind)`;
+            result += '\n';
+            if (status) {
+                result += `\nChanges:\n${status}`;
+            }
+            else {
+                result += '\nWorking tree clean';
+            }
+            return result;
+        }
+        catch (err) {
+            return `Git error: ${err instanceof Error ? err.message : String(err)}`;
+        }
+    },
+});
+//# sourceMappingURL=git-status.js.map

package/dist/cli/agent/tools/git-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-status.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/git-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,8FAA8F;QAC3G,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,EAAE;YACd,QAAQ,EAAE,EAAE;SACb;KACF;IAED,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,yCAAyC;QACzC,IAAI,CAAC;YACH,QAAQ,CAAC,qCAAqC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9G,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,gDAAgD,GAAG,CAAC,WAAW,sGAAsG,CAAC;QAC/K,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACxH,MAAM,MAAM,GAAG,QAAQ,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAEjH,IAAI,KAAK,GAAG,GAAG,CAAC;YAChB,IAAI,MAAM,GAAG,GAAG,CAAC;YACjB,IAAI,CAAC;gBACH,KAAK,GAAG,QAAQ,CAAC,wCAAwC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC9H,MAAM,GAAG,QAAQ,CAAC,wCAAwC,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACjI,CAAC;YAAC,MAAM,CAAC;gBACP,6CAA6C;YAC/C,CAAC;YAED,IAAI,MAAM,GAAG,WAAW,MAAM,EAAE,CAAC;YACjC,IAAI,KAAK,KAAK,GAAG;gBAAE,MAAM,IAAI,KAAK,KAAK,SAAS,CAAC;YACjD,IAAI,MAAM,KAAK,GAAG;gBAAE,MAAM,IAAI,KAAK,MAAM,UAAU,CAAC;YACpD,MAAM,IAAI,IAAI,CAAC;YAEf,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,eAAe,MAAM,EAAE,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,sBAAsB,CAAC;YACnC,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,cAAc,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/agent/tools/list-dir.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=list-dir.d.ts.map

package/dist/cli/agent/tools/list-dir.d.ts.map

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

package/dist/cli/agent/tools/list-dir.js

@@ -0,0 +1,73 @@
+import { readdirSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { registerTool } from './registry.js';
+import { validatePathEx } from '../sandbox.js';
+registerTool({
+    definition: {
+        name: 'list_directory',
+        description: 'List files and directories at the given path. Shows file sizes and types. Use for understanding project structure.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path to the directory (default: project root)' },
+                recursive: { type: 'boolean', description: 'List recursively (default: false)' },
+                max_depth: { type: 'number', description: 'Maximum recursion depth (default: 2)' },
+            },
+            required: [],
+        },
+    },
+    async execute(input, ctx) {
+        const { resolved: dirPath } = validatePathEx(input.path || '.', ctx.projectRoot);
+        const recursive = input.recursive ?? false;
+        const maxDepth = input.max_depth ?? 2;
+        // Check if the directory exists before listing
+        try {
+            const stat = statSync(dirPath);
+            if (!stat.isDirectory()) {
+                return `Error: "${input.path || '.'}" is not a directory (it's a file). Use read_file instead.`;
+            }
+        }
+        catch {
+            return `Error: Directory "${input.path || '.'}" does not exist in ${ctx.projectRoot}`;
+        }
+        const entries = [];
+        const IGNORE = new Set(['node_modules', '.git', 'dist', '.next', '__pycache__', '.venv', 'target']);
+        function listDir(dir, depth, prefix) {
+            if (depth > maxDepth)
+                return;
+            let items;
+            try {
+                items = readdirSync(dir).sort();
+            }
+            catch {
+                return;
+            }
+            for (const item of items) {
+                if (IGNORE.has(item))
+                    continue;
+                const fullPath = join(dir, item);
+                let stat;
+                try {
+                    stat = statSync(fullPath);
+                }
+                catch {
+                    continue;
+                }
+                if (stat.isDirectory()) {
+                    entries.push(`${prefix}${item}/`);
+                    if (recursive && depth < maxDepth) {
+                        listDir(fullPath, depth + 1, prefix + '  ');
+                    }
+                }
+                else {
+                    const sizeKB = (stat.size / 1024).toFixed(1);
+                    entries.push(`${prefix}${item}  (${sizeKB} KB)`);
+                }
+            }
+        }
+        listDir(dirPath, 0, '');
+        const relPath = relative(ctx.projectRoot, dirPath) || '.';
+        return `Directory: ${relPath}/\n${entries.length} entries\n\n${entries.join('\n')}`;
+    },
+});
+//# sourceMappingURL=list-dir.js.map

package/dist/cli/agent/tools/list-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/list-dir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,oHAAoH;QACjI,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;gBAC/F,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,mCAAmC,EAAE;gBAChF,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sCAAsC,EAAE;aACnF;YACD,QAAQ,EAAE,EAAE;SACb;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,CAAE,KAAK,CAAC,IAAe,IAAI,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7F,MAAM,SAAS,GAAI,KAAK,CAAC,SAAqB,IAAI,KAAK,CAAC;QACxD,MAAM,QAAQ,GAAI,KAAK,CAAC,SAAoB,IAAI,CAAC,CAAC;QAElD,+CAA+C;QAC/C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,OAAO,WAAW,KAAK,CAAC,IAAI,IAAI,GAAG,4DAA4D,CAAC;YAClG,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,qBAAqB,KAAK,CAAC,IAAI,IAAI,GAAG,uBAAuB,GAAG,CAAC,WAAW,EAAE,CAAC;QACxF,CAAC;QAED,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAEpG,SAAS,OAAO,CAAC,GAAW,EAAE,KAAa,EAAE,MAAc;YACzD,IAAI,KAAK,GAAG,QAAQ;gBAAE,OAAO;YAE7B,IAAI,KAAe,CAAC;YACpB,IAAI,CAAC;gBACH,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAClC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO;YACT,CAAC;YAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC/B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;gBACjC,IAAI,IAAI,CAAC;gBACT,IAAI,CAAC;oBACH,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC5B,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBAED,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;oBACvB,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC;oBAClC,IAAI,SAAS,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;wBAClC,OAAO,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;oBAC9C,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBAC7C,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,MAAM,MAAM,MAAM,CAAC,CAAC;gBACnD,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAExB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,GAAG,CAAC;QAC1D,OAAO,cAAc,OAAO,MAAM,OAAO,CAAC,MAAM,eAAe,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtF,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=read-file.d.ts.map

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

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

package/dist/cli/agent/tools/read-file.js

@@ -0,0 +1,45 @@
+import { readFileSync, statSync } from 'node:fs';
+import { registerTool } from './registry.js';
+import { validatePathEx } from '../sandbox.js';
+registerTool({
+    definition: {
+        name: 'read_file',
+        description: 'Read the contents of a file. Returns content with line numbers. Can read specific line ranges.',
+        input_schema: {
+            type: 'object',
+            properties: {
+                path: { type: 'string', description: 'Relative path to the file' },
+                start_line: { type: 'number', description: 'Start line (1-based, optional)' },
+                end_line: { type: 'number', description: 'End line (inclusive, optional)' },
+            },
+            required: ['path'],
+        },
+    },
+    async execute(input, ctx) {
+        const { resolved: filePath } = validatePathEx(input.path, ctx.projectRoot);
+        const stat = statSync(filePath);
+        if (stat.isDirectory()) {
+            return `Error: ${input.path} is a directory, not a file. Use list_directory instead.`;
+        }
+        if (stat.size > 1024 * 1024) {
+            return `Error: File is too large (${(stat.size / 1024).toFixed(0)} KB). Use start_line/end_line to read a portion.`;
+        }
+        const content = readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        const startLine = input.start_line ?? 1;
+        const endLine = input.end_line ?? lines.length;
+        const start = Math.max(1, startLine) - 1;
+        const end = Math.min(lines.length, endLine);
+        const selectedLines = lines.slice(start, end);
+        const numbered = selectedLines.map((line, i) => {
+            const lineNum = String(start + i + 1).padStart(4);
+            return `${lineNum} │ ${line}`;
+        }).join('\n');
+        const header = `File: ${input.path} (${lines.length} lines, ${(stat.size / 1024).toFixed(1)} KB)`;
+        if (start > 0 || end < lines.length) {
+            return `${header}\nShowing lines ${start + 1}-${end} of ${lines.length}\n\n${numbered}`;
+        }
+        return `${header}\n\n${numbered}`;
+    },
+});
+//# sourceMappingURL=read-file.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,gGAAgG;QAC7G,YAAY,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;gBAClE,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;gBAC7E,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;aAC5E;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,cAAc,CAAC,KAAK,CAAC,IAAc,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACrF,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAEhC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACvB,OAAO,UAAU,KAAK,CAAC,IAAI,0DAA0D,CAAC;QACxF,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;YAC5B,OAAO,6BAA6B,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,kDAAkD,CAAC;QACtH,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,SAAS,GAAI,KAAK,CAAC,UAAiC,IAAI,CAAC,CAAC;QAChE,MAAM,OAAO,GAAI,KAAK,CAAC,QAA+B,IAAI,KAAK,CAAC,MAAM,CAAC;QAEvE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC5C,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAE9C,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAClD,OAAO,GAAG,OAAO,MAAM,IAAI,EAAE,CAAC;QAChC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,MAAM,GAAG,SAAS,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;QAClG,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO,GAAG,MAAM,mBAAmB,KAAK,GAAG,CAAC,IAAI,GAAG,OAAO,KAAK,CAAC,MAAM,OAAO,QAAQ,EAAE,CAAC;QAC1F,CAAC;QACD,OAAO,GAAG,MAAM,OAAO,QAAQ,EAAE,CAAC;IACpC,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,34 @@
+import type { ToolDefinition } from '../../providers/types.js';
+import type { UndoStack } from '../undo.js';
+import type { BugJournal } from '../../bugs/journal.js';
+import type { BrowserController } from '../../browser/controller.js';
+import type { VisionProcessor } from '../../browser/vision.js';
+import type { LearningJournal } from '../../jarvis/learning.js';
+export interface ToolContext {
+    projectRoot: string;
+    undoStack: UndoStack;
+    spiralEngine?: any;
+    bugJournal?: BugJournal;
+    browserController?: BrowserController;
+    visionProcessor?: VisionProcessor;
+    onBrowserScreenshot?: (info: {
+        url: string;
+        title?: string;
+        imageBase64?: string;
+        analysis?: string;
+    }) => void;
+    learningJournal?: LearningJournal;
+    lockFile?: (path: string) => boolean;
+    unlockFile?: (path: string) => void;
+}
+export interface ToolHandler {
+    definition: ToolDefinition;
+    execute: (input: Record<string, unknown>, ctx: ToolContext) => Promise<string>;
+}
+export declare function registerTool(handler: ToolHandler): void;
+export declare function getTool(name: string): ToolHandler | undefined;
+export declare function getAllToolDefinitions(): ToolDefinition[];
+export declare function getAllToolNames(): string[];
+/** Initialize all tools by importing their modules (parallel for speed) */
+export declare function initializeTools(): Promise<void>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/cli/agent/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC/G,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACrC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,cAAc,CAAC;IAC3B,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAChF;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAEvD;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE7D;AAED,wBAAgB,qBAAqB,IAAI,cAAc,EAAE,CAExD;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,2EAA2E;AAC3E,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAqCrD"}

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

@@ -0,0 +1,53 @@
+const tools = new Map();
+export function registerTool(handler) {
+    tools.set(handler.definition.name, handler);
+}
+export function getTool(name) {
+    return tools.get(name);
+}
+export function getAllToolDefinitions() {
+    return Array.from(tools.values()).map(t => t.definition);
+}
+export function getAllToolNames() {
+    return Array.from(tools.keys());
+}
+/** Initialize all tools by importing their modules (parallel for speed) */
+export async function initializeTools() {
+    // Core tools — all independent, load in parallel (~150-300ms faster)
+    await Promise.all([
+        import('./read-file.js'),
+        import('./write-file.js'),
+        import('./edit-file.js'),
+        import('./list-dir.js'),
+        import('./search.js'),
+        import('./find.js'),
+        import('./run-command.js'),
+        import('./git-status.js'),
+        import('./git-diff.js'),
+        import('./git-commit.js'),
+        import('./git-log.js'),
+        import('./spiral-query.js'),
+        import('./spiral-store.js'),
+        import('./web-research.js'),
+        import('./bug-report.js'),
+        import('./bug-list.js'),
+    ]);
+    // Browser tools — conditional (puppeteer-core is optional)
+    try {
+        await Promise.all([
+            import('./browser-open.js'),
+            import('./browser-navigate.js'),
+            import('./browser-screenshot.js'),
+            import('./browser-click.js'),
+            import('./browser-type.js'),
+            import('./browser-close.js'),
+        ]);
+    }
+    catch {
+        // puppeteer-core not installed — browser tools silently unavailable
+        if (process.env.DEBUG) {
+            console.error('[tools] Browser tools unavailable — install puppeteer-core for browser automation');
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/cli/agent/tools/registry.ts"],"names":[],"mappings":"AAyBA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE7C,MAAM,UAAU,YAAY,CAAC,OAAoB;IAC/C,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,qEAAqE;IACrE,MAAM,OAAO,CAAC,GAAG,CAAC;QAChB,MAAM,CAAC,gBAAgB,CAAC;QACxB,MAAM,CAAC,iBAAiB,CAAC;QACzB,MAAM,CAAC,gBAAgB,CAAC;QACxB,MAAM,CAAC,eAAe,CAAC;QACvB,MAAM,CAAC,aAAa,CAAC;QACrB,MAAM,CAAC,WAAW,CAAC;QACnB,MAAM,CAAC,kBAAkB,CAAC;QAC1B,MAAM,CAAC,iBAAiB,CAAC;QACzB,MAAM,CAAC,eAAe,CAAC;QACvB,MAAM,CAAC,iBAAiB,CAAC;QACzB,MAAM,CAAC,cAAc,CAAC;QACtB,MAAM,CAAC,mBAAmB,CAAC;QAC3B,MAAM,CAAC,mBAAmB,CAAC;QAC3B,MAAM,CAAC,mBAAmB,CAAC;QAC3B,MAAM,CAAC,iBAAiB,CAAC;QACzB,MAAM,CAAC,eAAe,CAAC;KACxB,CAAC,CAAC;IAEH,2DAA2D;IAC3D,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC;YAChB,MAAM,CAAC,mBAAmB,CAAC;YAC3B,MAAM,CAAC,uBAAuB,CAAC;YAC/B,MAAM,CAAC,yBAAyB,CAAC;YACjC,MAAM,CAAC,oBAAoB,CAAC;YAC5B,MAAM,CAAC,mBAAmB,CAAC;YAC3B,MAAM,CAAC,oBAAoB,CAAC;SAC7B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,oEAAoE;QACpE,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,mFAAmF,CAAC,CAAC;QACrG,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/agent/tools/run-command.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run-command.d.ts.map

package/dist/cli/agent/tools/run-command.d.ts.map

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