@element47/ag 4.4.0

package/dist/tools/__tests__/plan.test.js

@@ -0,0 +1,81 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { planTool } from '../plan.js';
+import { mkdirSync, rmSync, existsSync } from 'node:fs';
+import { randomBytes } from 'node:crypto';
+import { paths } from '../../memory/memory.js';
+const fakeCwd = `/tmp/__ag_plan_test_${randomBytes(8).toString('hex')}__`;
+let projectDir;
+let plan;
+beforeEach(() => {
+    mkdirSync(fakeCwd, { recursive: true });
+    projectDir = paths(fakeCwd).projectDir;
+    plan = planTool(fakeCwd);
+});
+afterEach(() => {
+    if (existsSync(projectDir))
+        rmSync(projectDir, { recursive: true });
+    if (existsSync(fakeCwd))
+        rmSync(fakeCwd, { recursive: true });
+});
+describe('plan tool', () => {
+    it('save creates a plan and returns path', async () => {
+        const result = await plan.execute({ action: 'save', content: '# My Plan\nStep 1' });
+        expect(result).toContain('Plan saved');
+    });
+    it('save requires content', async () => {
+        const result = await plan.execute({ action: 'save' });
+        expect(result).toContain('content is required');
+    });
+    it('list shows saved plans', async () => {
+        await plan.execute({ action: 'save', content: 'plan 1', name: 'first' });
+        await plan.execute({ action: 'save', content: 'plan 2', name: 'second' });
+        const result = await plan.execute({ action: 'list' });
+        expect(result).toContain('first');
+        expect(result).toContain('second');
+    });
+    it('list returns message when empty', async () => {
+        const result = await plan.execute({ action: 'list' });
+        expect(result).toContain('No plans');
+    });
+    it('read loads a specific plan by name', async () => {
+        await plan.execute({ action: 'save', content: 'specific content', name: 'readable' });
+        const listResult = await plan.execute({ action: 'list' });
+        // Extract the plan name from the list
+        const name = listResult.split('\n')[0].split('  ')[0].trim();
+        const result = await plan.execute({ action: 'read', name });
+        expect(result).toContain('specific content');
+    });
+    it('read requires name', async () => {
+        const result = await plan.execute({ action: 'read' });
+        expect(result).toContain('name is required');
+    });
+    it('append adds to latest plan', async () => {
+        await plan.execute({ action: 'save', content: 'base plan', name: 'appendable' });
+        const result = await plan.execute({ action: 'append', content: '\nappended text' });
+        expect(result).toContain('Appended');
+    });
+    it('append requires content', async () => {
+        const result = await plan.execute({ action: 'append' });
+        expect(result).toContain('content is required');
+    });
+    it('switch activates a different plan', async () => {
+        await plan.execute({ action: 'save', content: 'plan A', name: 'alpha' });
+        await plan.execute({ action: 'save', content: 'plan B', name: 'beta' });
+        const result = await plan.execute({ action: 'switch', name: 'alpha' });
+        expect(result).toContain('Switched to plan');
+        expect(result).toContain('alpha');
+    });
+    it('switch requires name', async () => {
+        const result = await plan.execute({ action: 'switch' });
+        expect(result).toContain('name is required');
+    });
+    it('switch errors on nonexistent plan', async () => {
+        const result = await plan.execute({ action: 'switch', name: 'nonexistent' });
+        expect(result).toContain('No plan matching');
+    });
+    it('unknown action returns error', async () => {
+        const result = await plan.execute({ action: 'delete' });
+        expect(result).toContain('Unknown action');
+    });
+});
+//# sourceMappingURL=plan.test.js.map

package/dist/tools/__tests__/plan.test.js.map

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

package/dist/tools/__tests__/schemas.test.d.ts

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

package/dist/tools/__tests__/schemas.test.d.ts.map

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

package/dist/tools/__tests__/schemas.test.js

@@ -0,0 +1,40 @@
+/**
+ * Tool schema contract tests — ensures tool definitions (the API contract with LLMs)
+ * don't accidentally change shape, names, or required parameters.
+ */
+import { describe, it, expect } from 'vitest';
+import { fileTool } from '../file.js';
+import { bashToolFactory } from '../bash.js';
+import { grepTool } from '../grep.js';
+import { gitTool } from '../git.js';
+import { webTool } from '../web.js';
+import { memoryTool } from '../memory.js';
+import { planTool } from '../plan.js';
+const cwd = process.cwd();
+function schema(tool) {
+    return { name: tool.function.name, parameters: tool.function.parameters };
+}
+describe('tool schema contracts', () => {
+    it('file tool schema', () => {
+        expect(schema(fileTool(cwd))).toMatchSnapshot();
+    });
+    it('bash tool schema', () => {
+        expect(schema(bashToolFactory(cwd))).toMatchSnapshot();
+    });
+    it('grep tool schema', () => {
+        expect(schema(grepTool(cwd))).toMatchSnapshot();
+    });
+    it('git tool schema', () => {
+        expect(schema(gitTool(cwd))).toMatchSnapshot();
+    });
+    it('web tool schema', () => {
+        expect(schema(webTool())).toMatchSnapshot();
+    });
+    it('memory tool schema', () => {
+        expect(schema(memoryTool(cwd))).toMatchSnapshot();
+    });
+    it('plan tool schema', () => {
+        expect(schema(planTool(cwd))).toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=schemas.test.js.map

package/dist/tools/__tests__/schemas.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.test.js","sourceRoot":"","sources":["../../../src/tools/__tests__/schemas.test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAE1B,SAAS,MAAM,CAAC,IAA8E;IAC5F,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;AAC5E,CAAC;AAED,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/tools/__tests__/web.test.d.ts

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

package/dist/tools/__tests__/web.test.d.ts.map

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

package/dist/tools/__tests__/web.test.js

@@ -0,0 +1,51 @@
+import { describe, it, expect } from 'vitest';
+import { webTool } from '../web.js';
+const web = webTool();
+describe('web tool - SSRF protection', () => {
+    const blockedUrls = [
+        'http://localhost/admin',
+        'http://127.0.0.1/secret',
+        'http://0.0.0.0:8080/',
+        'http://[::1]/',
+        'http://169.254.169.254/latest/meta-data/',
+        'http://metadata.google.internal/computeMetadata/v1/',
+        'http://10.0.0.1/internal',
+        'http://172.16.0.1/internal',
+        'http://192.168.1.1/admin',
+    ];
+    for (const url of blockedUrls) {
+        it(`blocks ${new URL(url).hostname}`, async () => {
+            const result = await web.execute({ action: 'fetch', url });
+            expect(result).toMatch(/blocked.*private|internal/i);
+        });
+    }
+    it('blocks non-http protocols', async () => {
+        const result = await web.execute({ action: 'fetch', url: 'ftp://example.com/file' });
+        expect(result).toMatch(/http.*https/);
+    });
+    it('rejects invalid URLs', async () => {
+        const result = await web.execute({ action: 'fetch', url: 'not-a-url' });
+        expect(result).toMatch(/Invalid URL/);
+    });
+    it('requires url for fetch', async () => {
+        const result = await web.execute({ action: 'fetch' });
+        expect(result).toMatch(/url is required/);
+    });
+    it('requires query for search', async () => {
+        const result = await web.execute({ action: 'search' });
+        expect(result).toMatch(/query is required/);
+    });
+    it('unknown action returns error', async () => {
+        const result = await web.execute({ action: 'post' });
+        expect(result).toMatch(/Unknown action/);
+    });
+    it('blocks 169.254.x.x link-local addresses', async () => {
+        const result = await web.execute({ action: 'fetch', url: 'http://169.254.1.1/metadata' });
+        expect(result).toMatch(/blocked/i);
+    });
+    it('blocks 172.16-31 private range', async () => {
+        const result = await web.execute({ action: 'fetch', url: 'http://172.31.255.255/' });
+        expect(result).toMatch(/blocked/i);
+    });
+});
+//# sourceMappingURL=web.test.js.map

package/dist/tools/__tests__/web.test.js.map

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

package/dist/tools/bash.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Bash tool - the universal interface for system operations
+ */
+import { Tool } from '../core/types.js';
+export declare function bashToolFactory(cwd: string): Tool;
+//# sourceMappingURL=bash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bash.d.ts","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAyBxC,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAiEjD"}

package/dist/tools/bash.js

@@ -0,0 +1,89 @@
+/**
+ * Bash tool - the universal interface for system operations
+ */
+import { spawn } from 'node:child_process';
+const MAX_BUFFER = 1024 * 1024; // 1 MB
+const DANGEROUS_PATTERNS = [
+    { pattern: /\bfind\s+[~\/](?![\w.])/, message: 'Blocked: `find` on home/root directory. Use the grep tool (action=find) to search for files, or scope to a specific subdirectory.' },
+    { pattern: /\brm\s+(-[a-zA-Z]*r[a-zA-Z]*)?\s*-[a-zA-Z]*f[a-zA-Z]*\s+[~\/]/, message: 'Blocked: destructive `rm` targeting home or root directory.' },
+    { pattern: /\brm\s+(-[a-zA-Z]*f[a-zA-Z]*)?\s*-[a-zA-Z]*r[a-zA-Z]*\s+[~\/]/, message: 'Blocked: destructive `rm` targeting home or root directory.' },
+    { pattern: /\brm\s+(-[a-zA-Z]*r[a-zA-Z]*f|f[a-zA-Z]*r)[a-zA-Z]*\s+\/\*/, message: 'Blocked: destructive `rm` targeting root glob.' },
+    { pattern: /:\(\)\{.*:\|:/, message: 'Blocked: fork bomb detected.' },
+    { pattern: /\bdd\b.*\bof=\/dev\//, message: 'Blocked: dd write to device.' },
+    { pattern: /\bmkfs\b/, message: 'Blocked: filesystem format command.' },
+    { pattern: /\b(chmod|chown)\s+-[a-zA-Z]*R[a-zA-Z]*\s+.*[~\/]/, message: 'Blocked: recursive permission change on home/root.' },
+    { pattern: /\b(curl|wget)\b.*\|\s*(sh|bash|zsh|sudo)/, message: 'Blocked: pipe-to-shell pattern detected. Download the script first and review it.' },
+    { pattern: />\s*\/dev\/[hs]d[a-z]/, message: 'Blocked: redirect write to raw block device.' },
+    { pattern: /\bsudo\s+rm\b/, message: 'Blocked: sudo rm is too dangerous. Remove files without sudo or do it manually.' },
+];
+function checkCommand(command) {
+    for (const { pattern, message } of DANGEROUS_PATTERNS) {
+        if (pattern.test(command))
+            return `Error: ${message}`;
+    }
+    return null;
+}
+export function bashToolFactory(cwd) {
+    return {
+        type: 'function',
+        function: {
+            name: 'bash',
+            description: 'Run a shell command in the project directory. Use ONLY for: running tests, builds, installs, servers, and system operations. Do NOT use bash for: reading files (use file tool), editing files (use file tool), searching code (use grep tool), finding files (use grep tool), listing directories (use file tool), or git operations (use git tool). Dangerous commands like rm -rf, sudo rm, and pipe-to-shell are blocked.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    command: {
+                        type: 'string',
+                        description: 'The shell command to execute'
+                    }
+                },
+                required: ['command']
+            }
+        },
+        execute: ({ command }) => {
+            const blocked = checkCommand(command);
+            if (blocked)
+                return Promise.resolve(blocked);
+            return new Promise((resolve) => {
+                const child = spawn('sh', ['-c', command], {
+                    cwd,
+                    timeout: 60_000,
+                    stdio: ['pipe', 'pipe', 'pipe']
+                });
+                let stdout = '';
+                let stderr = '';
+                let stdoutOverflow = false;
+                child.stdout.on('data', (chunk) => {
+                    if (stdout.length < MAX_BUFFER) {
+                        stdout += chunk.toString();
+                    }
+                    else {
+                        stdoutOverflow = true;
+                    }
+                });
+                child.stderr.on('data', (chunk) => {
+                    if (stderr.length < MAX_BUFFER) {
+                        stderr += chunk.toString();
+                    }
+                });
+                child.on('close', (code) => {
+                    let result = stdout.trim();
+                    if (stdoutOverflow) {
+                        result += '\n... (output truncated at 1MB)';
+                    }
+                    if (code === 0) {
+                        resolve(result);
+                    }
+                    else {
+                        const status = code ?? 1;
+                        resolve(`EXIT ${status}\n${(stdout + stderr).trim()}`);
+                    }
+                });
+                child.on('error', (err) => {
+                    resolve(`EXIT 1\n${err.message}`);
+                });
+            });
+        }
+    };
+}
+//# sourceMappingURL=bash.js.map

package/dist/tools/bash.js.map

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

package/dist/tools/file.d.ts

@@ -0,0 +1,7 @@
+/**
+ * File tool — read files and list directories
+ * Prevents the model from falling back to bash for cat/head/tail/ls.
+ */
+import { Tool } from '../core/types.js';
+export declare function fileTool(cwd: string): Tool;
+//# sourceMappingURL=file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/tools/file.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAgKxC,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAuC1C"}

package/dist/tools/file.js

@@ -0,0 +1,224 @@
+/**
+ * File tool — read files and list directories
+ * Prevents the model from falling back to bash for cat/head/tail/ls.
+ */
+import { readFileSync, writeFileSync, readdirSync, statSync, mkdirSync } from 'node:fs';
+import { resolve, extname, dirname } from 'node:path';
+import { DEFAULT_IGNORE, isBinary } from '../core/constants.js';
+const MAX_READ_BYTES = 100 * 1024; // 100 KB text cap
+const MAX_LIST_ENTRIES = 200;
+const MAX_LIST_DEPTH = 3;
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+function doRead(cwd, path, offset, limit) {
+    const resolved = resolve(cwd, path);
+    const cwdResolved = resolve(cwd);
+    if (!resolved.startsWith(cwdResolved + '/') && resolved !== cwdResolved) {
+        return `Error: path "${path}" is outside the project directory. Access is restricted to ${cwdResolved}`;
+    }
+    let stat;
+    try {
+        stat = statSync(resolved);
+    }
+    catch (e) {
+        const err = e;
+        if (err.code === 'ENOENT')
+            return `Error: file not found — ${path}. Use grep(action=find) or file(action=list) to discover the correct filename.`;
+        if (err.code === 'EACCES')
+            return `Error: permission denied — ${path}`;
+        return `Error: ${err.message ?? String(e)}`;
+    }
+    if (stat.isDirectory())
+        return `Error: "${path}" is a directory. Use action=list instead.`;
+    if (isBinary(resolved)) {
+        const ext = extname(resolved);
+        return `Binary file (${formatSize(stat.size)} ${ext || 'unknown type'}). Use bash with an appropriate tool (e.g. pdftotext, xxd, strings) to inspect.`;
+    }
+    let content;
+    try {
+        content = readFileSync(resolved, 'utf-8');
+    }
+    catch (e) {
+        return `Error: ${e instanceof Error ? e.message : String(e)}`;
+    }
+    const lines = content.split('\n');
+    const start = Math.max(0, (offset ?? 1) - 1);
+    const count = limit ?? lines.length;
+    const slice = lines.slice(start, start + count);
+    // Check if we need to truncate by byte size
+    let totalBytes = 0;
+    let truncIdx = slice.length;
+    for (let i = 0; i < slice.length; i++) {
+        totalBytes += slice[i].length + 1;
+        if (totalBytes > MAX_READ_BYTES) {
+            truncIdx = i;
+            break;
+        }
+    }
+    const output = slice.slice(0, truncIdx);
+    const numbered = output.map((line, i) => `${String(start + i + 1).padStart(6)}\t${line}`);
+    let result = numbered.join('\n');
+    if (truncIdx < slice.length) {
+        result += `\n... (truncated at 100KB — showing lines ${start + 1}-${start + truncIdx} of ${lines.length} total)`;
+    }
+    else if (start + count < lines.length && !limit) {
+        // no truncation needed
+    }
+    return result;
+}
+function doList(cwd, path, maxDepth) {
+    const resolved = resolve(cwd, path);
+    const cwdResolved = resolve(cwd);
+    if (!resolved.startsWith(cwdResolved + '/') && resolved !== cwdResolved) {
+        return `Error: path "${path}" is outside the project directory. Access is restricted to ${cwdResolved}`;
+    }
+    const entries = [];
+    let count = 0;
+    function walk(dir, depth, prefix) {
+        if (depth > maxDepth || count >= MAX_LIST_ENTRIES)
+            return;
+        let items;
+        try {
+            items = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        // Sort: dirs first, then files
+        items.sort((a, b) => {
+            if (a.isDirectory() && !b.isDirectory())
+                return -1;
+            if (!a.isDirectory() && b.isDirectory())
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+        for (const item of items) {
+            if (count >= MAX_LIST_ENTRIES)
+                break;
+            if (DEFAULT_IGNORE.has(item.name))
+                continue;
+            if (item.name.startsWith('.') && item.name !== '.')
+                continue;
+            const full = resolve(dir, item.name);
+            if (item.isDirectory()) {
+                entries.push(`${prefix}[dir] ${item.name}/`);
+                count++;
+                if (depth < maxDepth)
+                    walk(full, depth + 1, prefix + '  ');
+            }
+            else if (item.isFile()) {
+                try {
+                    const s = statSync(full);
+                    entries.push(`${prefix}${item.name} (${formatSize(s.size)})`);
+                }
+                catch {
+                    entries.push(`${prefix}${item.name}`);
+                }
+                count++;
+            }
+        }
+    }
+    walk(resolved, 1, '');
+    if (entries.length === 0)
+        return 'Empty directory.';
+    let result = entries.join('\n');
+    if (count >= MAX_LIST_ENTRIES)
+        result += `\n... (${MAX_LIST_ENTRIES} entries shown. Narrow with path.)`;
+    return result;
+}
+function validatePath(cwd, path) {
+    const resolved = resolve(cwd, path);
+    const cwdResolved = resolve(cwd);
+    if (!resolved.startsWith(cwdResolved + '/') && resolved !== cwdResolved) {
+        return { resolved, error: `Error: path "${path}" is outside the project directory. Access is restricted to ${cwdResolved}` };
+    }
+    return { resolved };
+}
+function doWrite(cwd, path, content) {
+    const { resolved, error } = validatePath(cwd, path);
+    if (error)
+        return error;
+    try {
+        mkdirSync(dirname(resolved), { recursive: true });
+        writeFileSync(resolved, content);
+        const lines = content.split('\n').length;
+        const bytes = Buffer.byteLength(content);
+        return `Wrote ${path} (${lines} lines, ${formatSize(bytes)})`;
+    }
+    catch (e) {
+        return `Error: ${e instanceof Error ? e.message : String(e)}`;
+    }
+}
+function doEdit(cwd, path, oldString, newString) {
+    const { resolved, error } = validatePath(cwd, path);
+    if (error)
+        return error;
+    let content;
+    try {
+        content = readFileSync(resolved, 'utf-8');
+    }
+    catch (e) {
+        const err = e;
+        if (err.code === 'ENOENT')
+            return `Error: file not found — ${path}`;
+        return `Error: ${err.message ?? String(e)}`;
+    }
+    if (isBinary(resolved))
+        return `Error: cannot edit binary file — ${path}`;
+    const occurrences = content.split(oldString).length - 1;
+    if (occurrences === 0)
+        return `Error: old_string not found in ${path}. Read the file first to verify exact content.`;
+    if (occurrences > 1)
+        return `Error: old_string matches ${occurrences} times in ${path}. Provide more surrounding context to make it unique.`;
+    const updated = content.replace(oldString, newString);
+    writeFileSync(resolved, updated);
+    return `Edited ${path} — replaced ${oldString.split('\n').length} line(s)`;
+}
+export function fileTool(cwd) {
+    return {
+        type: 'function',
+        function: {
+            name: 'file',
+            description: 'Read, list, write, and edit files. Prefer this over bash for ALL file operations. Actions: read (view with line numbers — always read before editing), list (directory tree), write (create/overwrite file), edit (find-and-replace in existing file — old_string must match exactly once).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    action: { type: 'string', enum: ['read', 'list', 'write', 'edit'], description: 'read = view file, list = directory listing, write = create/overwrite file, edit = replace a string in an existing file.' },
+                    path: { type: 'string', description: 'File or directory path (relative to project root, or absolute).' },
+                    content: { type: 'string', description: 'File content to write (write action only).' },
+                    old_string: { type: 'string', description: 'Exact string to find and replace (edit action only). Must match exactly once.' },
+                    new_string: { type: 'string', description: 'Replacement string (edit action only).' },
+                    offset: { type: 'number', description: 'Line number to start reading from (read only, default: 1).' },
+                    limit: { type: 'number', description: 'Max lines to return (read only). Omit to read entire file.' },
+                    depth: { type: 'number', description: 'Directory depth for list (default: 2, max: 3).' },
+                },
+                required: ['action', 'path']
+            }
+        },
+        execute: async ({ action, path, content, old_string, new_string, offset, limit, depth }) => {
+            if (!path)
+                return 'Error: path is required.';
+            switch (action) {
+                case 'read': return doRead(cwd, path, offset, limit);
+                case 'list': return doList(cwd, path, Math.min(depth ?? 2, MAX_LIST_DEPTH));
+                case 'write':
+                    if (content === undefined)
+                        return 'Error: content is required for write action.';
+                    return doWrite(cwd, path, content);
+                case 'edit':
+                    if (!old_string)
+                        return 'Error: old_string is required for edit action.';
+                    if (new_string === undefined)
+                        return 'Error: new_string is required for edit action.';
+                    return doEdit(cwd, path, old_string, new_string);
+                default: return `Unknown action "${action}". Use: read, list, write, edit.`;
+            }
+        }
+    };
+}
+//# sourceMappingURL=file.js.map

package/dist/tools/file.js.map

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

package/dist/tools/git.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '../core/types.js';
+export declare function gitTool(cwd: string): Tool;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/tools/git.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AA+LxC,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAsCzC"}