helixmind 0.1.0

package/dist/cli/agent/sandbox.js

@@ -0,0 +1,124 @@
+import { resolve, normalize, sep } from 'node:path';
+import { statSync } from 'node:fs';
+/** Maximum file size in bytes (10MB) */
+const MAX_FILE_SIZE = 10 * 1024 * 1024;
+/** Maximum content length in characters (5MB) */
+const MAX_CONTENT_LENGTH = 5 * 1024 * 1024;
+/** Sensitive files that should never be read or written by the agent */
+const BLOCKED_FILES = [
+    '.env', '.env.local', '.env.production', '.env.staging',
+    'id_rsa', 'id_ed25519', 'id_ecdsa',
+    '.ssh/config', '.npmrc', '.pypirc',
+    'credentials.json', 'serviceAccountKey.json',
+];
+/** Dangerous command patterns that require extra confirmation */
+const DANGEROUS_PATTERNS = [
+    /\brm\s+(-rf?|--recursive)/,
+    /\bsudo\b/,
+    /\bchmod\b.*777/,
+    /\bdd\b\s/,
+    /\b>\s*\/dev\//,
+    /\bcurl\b.*\|\s*(ba)?sh/,
+    /\bwget\b.*\|\s*(ba)?sh/,
+    /\bnpm\s+publish/,
+    /\bgit\s+push\s+.*--force/,
+    /\bdrop\s+(database|table)/i,
+    /\btruncate\s+table/i,
+    /\bformat\s+[a-z]:/i,
+    /\bdel\s+\/[sq]/i,
+    /\brmdir\s+\/s/i,
+];
+export class SecurityError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SecurityError';
+    }
+}
+/**
+ * Validate that a requested path is within the project root
+ * and not a sensitive file. Returns the resolved absolute path.
+ */
+export function validatePath(requestedPath, projectRoot) {
+    // Normalize the requested path to handle . and .. sequences
+    let normalizedPath = normalize(requestedPath);
+    // Resolve against project root
+    const resolved = resolve(projectRoot, normalizedPath);
+    // Ensure the resolved path starts with the normalized project root
+    const normalizedRoot = normalize(projectRoot);
+    if (!resolved.startsWith(normalizedRoot)) {
+        throw new SecurityError(`Access denied: ${requestedPath} is outside the project directory`);
+    }
+    // Check for path traversal attempts (multiple consecutive separators)
+    if (normalizedPath.split(sep).length > 10) {
+        throw new SecurityError(`Access denied: Path too deep: ${requestedPath}`);
+    }
+    // Normalize for case-insensitive blocked file check
+    const lower = resolved.toLowerCase().replace(/\\/g, '/');
+    for (const blocked of BLOCKED_FILES) {
+        if (lower.endsWith('/' + blocked) || lower.endsWith('\\' + blocked) || lower === blocked) {
+            throw new SecurityError(`Access denied: ${requestedPath} is a sensitive file`);
+        }
+    }
+    // Check if path exists and is not a symlink (follow symlinks could bypass security)
+    try {
+        const stats = statSync(resolved);
+        if (stats.isSymbolicLink()) {
+            throw new SecurityError(`Access denied: Symlinks are not allowed`);
+        }
+    }
+    catch (err) {
+        // Path doesn't exist yet, that's fine for new files
+        if (err.code !== 'ENOENT') {
+            throw new SecurityError(`Access denied: Invalid path: ${requestedPath}`);
+        }
+    }
+    // Verify the directory exists (or can be created)
+    try {
+        const dirStats = statSync(normalizedRoot);
+        if (!dirStats.isDirectory()) {
+            throw new SecurityError(`Access denied: Project root is not a directory`);
+        }
+    }
+    catch (err) {
+        throw new SecurityError(`Access denied: Project root not accessible: ${projectRoot}`);
+    }
+    return resolved;
+}
+/**
+ * Classify a shell command's danger level.
+ */
+export function classifyCommand(cmd) {
+    // Sanitize command: remove shell metacharacters
+    const sanitized = cmd
+        .replace(/[^\w\s|;&<>()]/g, '') // Remove dangerous characters
+        .trim();
+    if (!sanitized || sanitized.length === 0) {
+        throw new SecurityError('Command cannot be empty');
+    }
+    // Check for command injection attempts
+    if (sanitized.length > 10000) {
+        throw new SecurityError('Command too long');
+    }
+    // Check for blocked commands
+    if (isBlockedCommand(sanitized)) {
+        throw new SecurityError('This command is blocked');
+    }
+    // Check for dangerous patterns
+    if (DANGEROUS_PATTERNS.some(p => p.test(sanitized)))
+        return 'dangerous';
+    // Check for potentially dangerous operations
+    if (/\brm\s/.test(sanitized) || /\bmv\s/.test(sanitized) || /\bgit\s+push/.test(sanitized))
+        return 'ask';
+    return 'safe';
+}
+/**
+ * Check if a command is blocked entirely (should never run).
+ */
+export function isBlockedCommand(cmd) {
+    const blocked = [
+        /\bformat\s+c:/i,
+        /:\(\)\s*\{[^}]*\|\s*:.*&\s*\}\s*;/, // fork bomb
+    ];
+    return blocked.some(p => p.test(cmd));
+}
+//# sourceMappingURL=sandbox.js.map

package/dist/cli/agent/sandbox.js.map

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

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

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

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

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

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

@@ -0,0 +1,49 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { randomUUID } from 'node:crypto';
+import { registerTool } from './registry.js';
+import { validatePath } from '../sandbox.js';
+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 filePath = validatePath(input.path, ctx.projectRoot);
+        const oldStr = input.old_string;
+        const newStr = input.new_string;
+        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":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,YAAY,CAAC;IACX,UAAU,EAAE;QACV,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,uJAAuJ;QACpK,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,mEAAmE,EAAE;gBAChH,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;aAC/F;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC;SAC/C;KACF;IAED,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,IAAc,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG,KAAK,CAAC,UAAoB,CAAC;QAC1C,MAAM,MAAM,GAAG,KAAK,CAAC,UAAoB,CAAC;QAE1C,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAEtD,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,kCAAkC,KAAK,CAAC,IAAI,8CAA8C,CAAC;QACpG,CAAC;QAED,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,2BAA2B,WAAW,aAAa,KAAK,CAAC,IAAI,0EAA0E,CAAC;QACjJ,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEjD,iBAAiB;QACjB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAE1C,qBAAqB;QACrB,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;YACjB,EAAE,EAAE,UAAU,EAAE;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,QAAQ;YACd,eAAe,EAAE,QAAQ;YACzB,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;QAEH,qCAAqC;QACrC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEpC,OAAO,gBAAgB,KAAK,CAAC,IAAI,gBAAgB,QAAQ,CAAC,MAAM,iBAAiB,QAAQ,CAAC,MAAM,WAAW,CAAC;IAC9G,CAAC;CACF,CAAC,CAAC"}

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 { validatePath } 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 baseDir = validatePath(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,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,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,OAAO,GAAG,YAAY,CAAE,KAAK,CAAC,IAAe,IAAI,GAAG,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QAC7E,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,51 @@
+import { execSync } 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 {
+            const message = input.message;
+            const files = input.files;
+            // Stage files
+            if (files && files.length > 0) {
+                for (const file of files) {
+                    execSync(`git add "${file}"`, { cwd: ctx.projectRoot });
+                }
+            }
+            else {
+                execSync('git add -A', { cwd: ctx.projectRoot });
+            }
+            // Check if there's anything staged
+            const staged = execSync('git diff --cached --stat', { cwd: ctx.projectRoot, encoding: 'utf-8' }).trim();
+            if (!staged) {
+                return 'Nothing to commit (no staged changes).';
+            }
+            // Commit
+            execSync(`git commit -m "${message.replace(/"/g, '\\"')}"`, {
+                cwd: ctx.projectRoot,
+                encoding: 'utf-8',
+            });
+            const hash = execSync('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,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,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,MAAM,OAAO,GAAG,KAAK,CAAC,OAAiB,CAAC;YACxC,MAAM,KAAK,GAAG,KAAK,CAAC,KAA6B,CAAC;YAElD,cAAc;YACd,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,QAAQ,CAAC,YAAY,IAAI,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,YAAY,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;YACnD,CAAC;YAED,mCAAmC;YACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,0BAA0B,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACxG,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,wCAAwC,CAAC;YAClD,CAAC;YAED,SAAS;YACT,QAAQ,CAAC,kBAAkB,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,EAAE;gBAC1D,GAAG,EAAE,GAAG,CAAC,WAAW;gBACpB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAC;YAEH,MAAM,IAAI,GAAG,QAAQ,CAAC,4BAA4B,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACxG,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,36 @@
+import { execSync } 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 {
+            const staged = input.staged ? '--cached' : '';
+            const filePath = input.path ? ` -- "${input.path}"` : '';
+            const cmd = `git diff ${staged}${filePath}`.trim();
+            const diff = execSync(cmd, { cwd: ctx.projectRoot, encoding: 'utf-8', maxBuffer: 1024 * 1024 }).trim();
+            if (!diff) {
+                return 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 `Error: ${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,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,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,MAAM,MAAM,GAAI,KAAK,CAAC,MAAkB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,GAAG,GAAG,YAAY,MAAM,GAAG,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YAEnD,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAEvG,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,sBAAsB,CAAC;YAChE,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,UAAU,GAAG,EAAE,CAAC;QACzB,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,32 @@
+import { execSync } 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 {
+            const count = input.count ?? 10;
+            const filePath = input.file ? ` -- "${input.file}"` : '';
+            const format = '--format=%h  %s  (%ar)  <%an>';
+            const log = execSync(`git log -${count} "${format}"${filePath}`, { 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,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,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,MAAM,KAAK,GAAI,KAAK,CAAC,KAAgB,IAAI,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,+BAA+B,CAAC;YAE/C,MAAM,GAAG,GAAG,QAAQ,CAClB,YAAY,KAAK,KAAK,MAAM,IAAI,QAAQ,EAAE,EAC1C,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAC5C,CAAC,IAAI,EAAE,CAAC;YAET,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,38 @@
+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) {
+        try {
+            const branch = execSync('git branch --show-current', { cwd: ctx.projectRoot, encoding: 'utf-8' }).trim();
+            const status = execSync('git status --short', { cwd: ctx.projectRoot, encoding: 'utf-8' }).trim();
+            const ahead = execSync('git rev-list --count @{upstream}..HEAD 2>/dev/null || echo 0', { cwd: ctx.projectRoot, encoding: 'utf-8', shell: 'bash' }).trim();
+            const behind = execSync('git rev-list --count HEAD..@{upstream} 2>/dev/null || echo 0', { cwd: ctx.projectRoot, encoding: 'utf-8', shell: 'bash' }).trim();
+            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 `Error: Not a git repository or git not available. ${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,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACzG,MAAM,MAAM,GAAG,QAAQ,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAClG,MAAM,KAAK,GAAG,QAAQ,CAAC,8DAA8D,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1J,MAAM,MAAM,GAAG,QAAQ,CAAC,8DAA8D,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAE3J,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,qDAAqD,GAAG,EAAE,CAAC;QACpE,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 { validatePath } 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 dirPath = validatePath(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":"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"}

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 { validatePath } 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 filePath = validatePath(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,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,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,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,IAAc,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACrE,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,18 @@
+import type { ToolDefinition } from '../../providers/types.js';
+import type { UndoStack } from '../undo.js';
+export interface ToolContext {
+    projectRoot: string;
+    undoStack: UndoStack;
+    spiralEngine?: any;
+}
+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 */
+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;AAE5C,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,YAAY,CAAC,EAAE,GAAG,CAAC;CACpB;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,sDAAsD;AACtD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAerD"}