developer-ai 1.1.0 → 1.1.2

package/dist/tools/patch-file.js

@@ -0,0 +1,120 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { resolveSafePath } from './utils.js';
+const schema = z.object({
+    path: z.string().describe('Workspace-relative file path'),
+    old_string: z.string().describe('Exact text to find and replace (must match uniquely)'),
+    new_string: z.string().describe('Replacement text'),
+});
+/**
+ * Targeted string-replacement tool — like GitHub Copilot's replace_string_in_file.
+ * Saves tokens by only sending the changed portion instead of the entire file.
+ *
+ * Rules:
+ * - `old_string` must match exactly ONE location in the file.
+ * - If it matches zero or multiple locations, the tool fails with a clear error.
+ * - Surrounding context (3+ unchanged lines) should be included in `old_string`
+ *   to guarantee uniqueness.
+ */
+export const patchFileTool = {
+    name: 'patch_file',
+    description: 'Apply a targeted text replacement to an existing file. ' +
+        'Provide the exact `old_string` to find (must match exactly one location) and the `new_string` to replace it with. ' +
+        'This is far more token-efficient than rewriting the entire file — prefer this for small edits. ' +
+        'Include 2-3 lines of surrounding context in old_string to ensure a unique match.',
+    schema,
+    jsonSchema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Workspace-relative file path' },
+            old_string: {
+                type: 'string',
+                description: 'Exact text to find. Must match exactly one location in the file. Include surrounding context lines for uniqueness.',
+            },
+            new_string: {
+                type: 'string',
+                description: 'Replacement text. Use empty string to delete the matched text.',
+            },
+        },
+        required: ['path', 'old_string', 'new_string'],
+    },
+    async execute(input, ctx) {
+        const { path: filePath, old_string, new_string } = schema.parse(input);
+        const resolved = resolveSafePath(ctx.workspaceDir, filePath);
+        if (!resolved) {
+            return { success: false, output: '', error: 'Path escapes workspace directory' };
+        }
+        // Read current content
+        let content;
+        try {
+            content = await fs.readFile(resolved, 'utf-8');
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: '',
+                error: `Cannot read file: ${err.message}`,
+            };
+        }
+        // Count occurrences
+        const occurrences = countOccurrences(content, old_string);
+        if (occurrences === 0) {
+            // Provide helpful context: show a snippet of the file so the LLM can self-correct
+            const preview = content.slice(0, 500);
+            return {
+                success: false,
+                output: '',
+                error: `old_string not found in "${filePath}". ` +
+                    `Make sure you copied the text exactly (whitespace matters).\n` +
+                    `File preview (first 500 chars):\n${preview}`,
+            };
+        }
+        if (occurrences > 1) {
+            return {
+                success: false,
+                output: '',
+                error: `old_string matched ${occurrences} locations in "${filePath}". ` +
+                    `Include more surrounding context to make the match unique.`,
+            };
+        }
+        // Apply the single replacement
+        const updated = content.replace(old_string, new_string);
+        try {
+            await fs.mkdir(path.dirname(resolved), { recursive: true });
+            await fs.writeFile(resolved, updated, 'utf-8');
+            const oldLines = old_string.split('\n').length;
+            const newLines = new_string.split('\n').length;
+            const diff = newLines - oldLines;
+            const diffLabel = diff === 0
+                ? 'same line count'
+                : diff > 0
+                    ? `+${diff} lines`
+                    : `${diff} lines`;
+            return {
+                success: true,
+                output: `Patched: ${filePath} (replaced ${old_string.length} → ${new_string.length} chars, ${diffLabel})`,
+            };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: '',
+                error: `Cannot write file: ${err.message}`,
+            };
+        }
+    },
+};
+/** Count non-overlapping occurrences of `needle` in `haystack`. */
+function countOccurrences(haystack, needle) {
+    if (needle.length === 0)
+        return 0;
+    let count = 0;
+    let pos = 0;
+    while ((pos = haystack.indexOf(needle, pos)) !== -1) {
+        count++;
+        pos += needle.length;
+    }
+    return count;
+}
+//# sourceMappingURL=patch-file.js.map

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

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

package/dist/tools/project-detect.d.ts

@@ -0,0 +1,8 @@
+import type { ToolHandler } from './registry.js';
+/**
+ * Project detection tool — scans the workspace to identify the project type,
+ * language, package manager, test runner, and other metadata.
+ * This gives the agent situational awareness without wasting tokens guessing.
+ */
+export declare const projectDetectTool: ToolHandler;
+//# sourceMappingURL=project-detect.d.ts.map

package/dist/tools/project-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-detect.d.ts","sourceRoot":"","sources":["../../src/tools/project-detect.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAK9D;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,WAiJ/B,CAAC"}

package/dist/tools/project-detect.js

@@ -0,0 +1,201 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { z } from 'zod';
+const schema = z.object({});
+/**
+ * Project detection tool — scans the workspace to identify the project type,
+ * language, package manager, test runner, and other metadata.
+ * This gives the agent situational awareness without wasting tokens guessing.
+ */
+export const projectDetectTool = {
+    name: 'project_detect',
+    description: 'Detect the project type, language, package manager, test runner, build tool, and ' +
+        'framework by scanning configuration files in the workspace root. ' +
+        'Call this early to understand the project before making changes.',
+    schema,
+    jsonSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+    async execute(_input, ctx) {
+        const root = ctx.workspaceDir;
+        const result = {
+            languages: [],
+            frameworks: [],
+            packageManager: null,
+            testRunner: null,
+            buildTool: null,
+            linter: null,
+            formatter: null,
+            hasGit: false,
+            hasCi: false,
+            hasDocker: false,
+            monorepo: false,
+            entryPoints: [],
+        };
+        const exists = (p) => fs.existsSync(path.join(root, p));
+        const readJson = (p) => {
+            try {
+                return JSON.parse(fs.readFileSync(path.join(root, p), 'utf-8'));
+            }
+            catch {
+                return null;
+            }
+        };
+        // ---- Languages ----
+        const langs = result['languages'];
+        if (exists('tsconfig.json') || exists('tsconfig.base.json'))
+            langs.push('TypeScript');
+        if (exists('jsconfig.json') || exists('package.json'))
+            langs.push('JavaScript');
+        if (exists('pyproject.toml') || exists('setup.py') || exists('requirements.txt'))
+            langs.push('Python');
+        if (exists('go.mod'))
+            langs.push('Go');
+        if (exists('Cargo.toml'))
+            langs.push('Rust');
+        if (exists('pom.xml') || exists('build.gradle') || exists('build.gradle.kts'))
+            langs.push('Java');
+        if (exists('*.csproj') || exists('*.sln'))
+            langs.push('C#');
+        if (exists('Gemfile'))
+            langs.push('Ruby');
+        if (exists('composer.json'))
+            langs.push('PHP');
+        // ---- Package Manager ----
+        if (exists('pnpm-lock.yaml'))
+            result['packageManager'] = 'pnpm';
+        else if (exists('yarn.lock'))
+            result['packageManager'] = 'yarn';
+        else if (exists('bun.lockb'))
+            result['packageManager'] = 'bun';
+        else if (exists('package-lock.json'))
+            result['packageManager'] = 'npm';
+        else if (exists('Pipfile.lock'))
+            result['packageManager'] = 'pipenv';
+        else if (exists('poetry.lock'))
+            result['packageManager'] = 'poetry';
+        else if (exists('uv.lock'))
+            result['packageManager'] = 'uv';
+        else if (exists('Cargo.lock'))
+            result['packageManager'] = 'cargo';
+        else if (exists('go.sum'))
+            result['packageManager'] = 'go modules';
+        // ---- Frameworks (from package.json) ----
+        const pkg = readJson('package.json');
+        const frameworks = result['frameworks'];
+        if (pkg) {
+            const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
+            if (allDeps['next'])
+                frameworks.push('Next.js');
+            if (allDeps['nuxt'] || allDeps['nuxt3'])
+                frameworks.push('Nuxt');
+            if (allDeps['react'])
+                frameworks.push('React');
+            if (allDeps['vue'])
+                frameworks.push('Vue');
+            if (allDeps['svelte'] || allDeps['@sveltejs/kit'])
+                frameworks.push('Svelte');
+            if (allDeps['angular'] || allDeps['@angular/core'])
+                frameworks.push('Angular');
+            if (allDeps['express'])
+                frameworks.push('Express');
+            if (allDeps['fastify'])
+                frameworks.push('Fastify');
+            if (allDeps['hono'])
+                frameworks.push('Hono');
+            if (allDeps['astro'])
+                frameworks.push('Astro');
+            if (allDeps['remix'] || allDeps['@remix-run/node'])
+                frameworks.push('Remix');
+            if (allDeps['electron'])
+                frameworks.push('Electron');
+            if (allDeps['vite'])
+                frameworks.push('Vite');
+            if (allDeps['tailwindcss'])
+                frameworks.push('Tailwind CSS');
+            // Test runner
+            if (allDeps['vitest'])
+                result['testRunner'] = 'vitest';
+            else if (allDeps['jest'])
+                result['testRunner'] = 'jest';
+            else if (allDeps['mocha'])
+                result['testRunner'] = 'mocha';
+            else if (allDeps['@playwright/test'])
+                result['testRunner'] = 'playwright';
+            else if (allDeps['cypress'])
+                result['testRunner'] = 'cypress';
+            // Linter
+            if (allDeps['eslint'] || allDeps['@eslint/js'])
+                result['linter'] = 'eslint';
+            else if (allDeps['biome'] || allDeps['@biomejs/biome'])
+                result['linter'] = 'biome';
+            // Formatter
+            if (allDeps['prettier'])
+                result['formatter'] = 'prettier';
+            else if (allDeps['@biomejs/biome'])
+                result['formatter'] = 'biome';
+            // Build tool
+            if (allDeps['vite'])
+                result['buildTool'] = 'vite';
+            else if (allDeps['webpack'])
+                result['buildTool'] = 'webpack';
+            else if (allDeps['esbuild'])
+                result['buildTool'] = 'esbuild';
+            else if (allDeps['rollup'])
+                result['buildTool'] = 'rollup';
+            else if (allDeps['turbo'] || allDeps['turborepo'])
+                result['buildTool'] = 'turbo';
+            else if (allDeps['typescript'])
+                result['buildTool'] = 'tsc';
+            // Entry points from scripts
+            const scripts = pkg.scripts ?? {};
+            const entries = result['entryPoints'];
+            if (scripts['start'])
+                entries.push(`start: ${scripts['start']}`);
+            if (scripts['dev'])
+                entries.push(`dev: ${scripts['dev']}`);
+            if (scripts['build'])
+                entries.push(`build: ${scripts['build']}`);
+            if (scripts['test'])
+                entries.push(`test: ${scripts['test']}`);
+        }
+        // ---- Python specifics ----
+        if (exists('pyproject.toml')) {
+            const pyproject = fs.readFileSync(path.join(root, 'pyproject.toml'), 'utf-8');
+            if (pyproject.includes('pytest'))
+                result['testRunner'] = 'pytest';
+            if (pyproject.includes('ruff'))
+                result['linter'] = 'ruff';
+            if (pyproject.includes('black'))
+                result['formatter'] = 'black';
+            if (pyproject.includes('django'))
+                frameworks.push('Django');
+            if (pyproject.includes('fastapi'))
+                frameworks.push('FastAPI');
+            if (pyproject.includes('flask'))
+                frameworks.push('Flask');
+        }
+        // ---- Infrastructure ----
+        result['hasGit'] = exists('.git');
+        result['hasCi'] = exists('.github/workflows') || exists('.gitlab-ci.yml') || exists('.circleci');
+        result['hasDocker'] = exists('Dockerfile') || exists('docker-compose.yml') || exists('compose.yaml');
+        result['monorepo'] = exists('pnpm-workspace.yaml') || exists('lerna.json') || exists('nx.json') ||
+            (pkg?.workspaces != null);
+        // ---- Git info ----
+        if (result['hasGit']) {
+            try {
+                const branch = execSync('git branch --show-current', {
+                    cwd: root, encoding: 'utf-8', timeout: 5_000,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                }).trim();
+                result['gitBranch'] = branch;
+            }
+            catch { /* not fatal */ }
+        }
+        return { success: true, output: JSON.stringify(result, null, 2) };
+    },
+};
+//# sourceMappingURL=project-detect.js.map

package/dist/tools/project-detect.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAS9D,eAAO,MAAM,YAAY,EAAE,WAuC1B,CAAC"}
+{"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAW9D,eAAO,MAAM,YAAY,EAAE,WAiE1B,CAAC"}

package/dist/tools/read-file.js

@@ -4,20 +4,32 @@ import { resolveSafePath } from './utils.js';
 import { MAX_FILE_SIZE } from '../constants.js';
 const schema = z.object({
     path: z.string().describe('Workspace-relative file path'),
+    start_line: z.number().optional().describe('1-based start line (inclusive)'),
+    end_line: z.number().optional().describe('1-based end line (inclusive)'),
 });
 export const readFileTool = {
     name: 'read_file',
-    description: 'Read a text file from the workspace. Path is relative to workspace root.',
+    description: 'Read a text file from the workspace. Path is relative to workspace root. ' +
+        'Optionally specify start_line and end_line (1-based, inclusive) to read a specific range — ' +
+        'this saves tokens on large files. Without range parameters, reads the entire file.',
     schema,
     jsonSchema: {
         type: 'object',
         properties: {
             path: { type: 'string', description: 'Workspace-relative file path' },
+            start_line: {
+                type: 'number',
+                description: '1-based start line (inclusive). Omit to read from beginning.',
+            },
+            end_line: {
+                type: 'number',
+                description: '1-based end line (inclusive). Omit to read to end of file.',
+            },
         },
         required: ['path'],
     },
     async execute(input, ctx) {
-        const { path: filePath } = schema.parse(input);
+        const { path: filePath, start_line, end_line } = schema.parse(input);
         const resolved = resolveSafePath(ctx.workspaceDir, filePath);
         if (!resolved) {
             return { success: false, output: '', error: 'Path escapes workspace directory' };
@@ -28,10 +40,22 @@ export const readFileTool = {
                 return {
                     success: false,
                     output: '',
-                    error: `File too large (${(stat.size / 1024).toFixed(0)} KB). Max: ${MAX_FILE_SIZE / 1024} KB`,
+                    error: `File too large (${(stat.size / 1024).toFixed(0)} KB). Max: ${MAX_FILE_SIZE / 1024} KB. Use start_line/end_line to read a range.`,
                 };
             }
             const content = await fs.readFile(resolved, 'utf-8');
+            // Line range extraction
+            if (start_line !== undefined || end_line !== undefined) {
+                const lines = content.split('\n');
+                const totalLines = lines.length;
+                const from = Math.max(1, start_line ?? 1) - 1; // 0-based
+                const to = Math.min(totalLines, end_line ?? totalLines); // 1-based inclusive
+                const slice = lines.slice(from, to);
+                // Prefix each line with its line number for context
+                const numbered = slice.map((line, i) => `${from + i + 1}│ ${line}`);
+                const header = `[${filePath} lines ${from + 1}-${to} of ${totalLines}]`;
+                return { success: true, output: `${header}\n${numbered.join('\n')}` };
+            }
             return { success: true, output: content };
         }
         catch (err) {

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

@@ -1 +1 @@
-{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,0EAA0E;IAC5E,MAAM;IACN,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;SACtE;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IAED,KAAK,CAAC,OAAO,CAAC,KAAc,EAAE,GAAgB;QAC5C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QACnF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,mBAAmB,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,aAAa,GAAG,IAAI,KAAK;iBAC/F,CAAC;YACJ,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,qBAAsB,GAAa,CAAC,OAAO,EAAE;aACrD,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACzD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;IAC5E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;CACzE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAgB;IACvC,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,2EAA2E;QAC3E,6FAA6F;QAC7F,oFAAoF;IACtF,MAAM;IACN,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACrE,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,4DAA4D;aAC1E;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IAED,KAAK,CAAC,OAAO,CAAC,KAAc,EAAE,GAAgB;QAC5C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QACnF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,IAAI,CAAC,IAAI,GAAG,aAAa,EAAE,CAAC;gBAC9B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE,mBAAmB,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,aAAa,GAAG,IAAI,+CAA+C;iBACzI,CAAC;YACJ,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAErD,wBAAwB;YACxB,IAAI,UAAU,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACvD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAQ,UAAU;gBAChE,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC,oBAAoB;gBAC7E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAEpC,oDAAoD;gBACpD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBACpE,MAAM,MAAM,GAAG,IAAI,QAAQ,UAAU,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,UAAU,GAAG,CAAC;gBACxE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACxE,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,qBAAsB,GAAa,CAAC,OAAO,EAAE;aACrD,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAgD9D,eAAO,MAAM,cAAc,EAAE,WA8E5B,CAAC"}
+{"version":3,"file":"run-command.d.ts","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAmD9D,eAAO,MAAM,cAAc,EAAE,WAkG5B,CAAC"}

package/dist/tools/run-command.js

@@ -38,13 +38,16 @@ function isDangerous(command) {
 const schema = z.object({
     command: z.string(),
     cwd: z.string().optional(),
+    timeout_ms: z.number().optional(),
+    env: z.record(z.string()).optional(),
+    max_output_kb: z.number().optional(),
     allowDangerous: z.boolean().optional().default(false),
 });
 export const runCommandTool = {
     name: 'run_command',
     description: 'Run a shell command in the workspace. Safe commands (ls, cat, npm, git, node, etc.) ' +
         'run automatically. Other commands require confirmation. Dangerous commands are blocked unless ' +
-        'explicitly allowed.',
+        'explicitly allowed. Supports custom timeout, environment variables, and output limits.',
     schema,
     jsonSchema: {
         type: 'object',
@@ -54,6 +57,19 @@ export const runCommandTool = {
                 type: 'string',
                 description: 'Working directory relative to workspace (default: workspace root)',
             },
+            timeout_ms: {
+                type: 'number',
+                description: 'Custom timeout in milliseconds (default: 30000)',
+            },
+            env: {
+                type: 'object',
+                description: 'Extra environment variables to set for this command',
+                additionalProperties: { type: 'string' },
+            },
+            max_output_kb: {
+                type: 'number',
+                description: 'Maximum output size in KB (default: ~10 KB)',
+            },
             allowDangerous: {
                 type: 'boolean',
                 description: 'Explicitly allow dangerous commands',
@@ -62,7 +78,9 @@ export const runCommandTool = {
         required: ['command'],
     },
     async execute(input, ctx) {
-        const { command, cwd, allowDangerous } = schema.parse(input);
+        const { command, cwd, timeout_ms, env: extraEnv, max_output_kb, allowDangerous } = schema.parse(input);
+        const effectiveTimeout = timeout_ms ?? COMMAND_TIMEOUT_MS;
+        const effectiveMaxOutput = max_output_kb ? max_output_kb * 1024 : MAX_OUTPUT_LENGTH;
         const workDir = cwd
             ? path.resolve(ctx.workspaceDir, cwd)
             : ctx.workspaceDir;
@@ -89,24 +107,27 @@ export const runCommandTool = {
                 return { success: false, output: '', error: 'Command cancelled by user' };
             }
         }
+        const execEnv = extraEnv ? { ...process.env, ...extraEnv } : undefined;
         try {
             const stdout = execSync(command, {
                 cwd: workDir,
                 encoding: 'utf-8',
-                timeout: COMMAND_TIMEOUT_MS,
-                maxBuffer: 2 * 1024 * 1024,
+                timeout: effectiveTimeout,
+                maxBuffer: 4 * 1024 * 1024,
                 stdio: ['pipe', 'pipe', 'pipe'],
+                ...(execEnv ? { env: execEnv } : {}),
             });
-            return { success: true, output: stdout.slice(0, MAX_OUTPUT_LENGTH) };
+            return { success: true, output: stdout.slice(0, effectiveMaxOutput) };
         }
         catch (err) {
             const e = err;
-            const stderr = (e.stderr ?? '').slice(0, MAX_OUTPUT_LENGTH / 2);
-            const stdout = (e.stdout ?? '').slice(0, MAX_OUTPUT_LENGTH / 2);
+            const stderr = (e.stderr ?? '').slice(0, effectiveMaxOutput / 2);
+            const stdout = (e.stdout ?? '').slice(0, effectiveMaxOutput / 2);
+            const reason = e.killed ? 'Timed out' : `Exit code ${e.status ?? 1}`;
             return {
                 success: false,
                 output: stdout,
-                error: `Exit code ${e.status ?? 1}: ${stderr}`,
+                error: `${reason}: ${stderr}`,
             };
         }
     },

package/dist/tools/run-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-command.js","sourceRoot":"","sources":["../../src/tools/run-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAExE,iDAAiD;AACjD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IACxE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM;IAC/D,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI;IACpD,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI;IAC/C,MAAM,EAAQ,QAAQ;IACtB,UAAU,EAAI,QAAQ;IACtB,OAAO;CACR,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,kBAAkB,GAAG;IACzB,uBAAuB;IACvB,WAAW;IACX,aAAa;IACb,eAAe,EAAyB,YAAY;IACpD,iCAAiC;IACjC,iCAAiC;IACjC,kBAAkB;IAClB,cAAc;IACd,oBAAoB;IACpB,sCAAsC;CACvC,CAAC;AAEF,SAAS,WAAW,CAAC,OAAe;IAClC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,MAAM,CAAC,OAAe;IAC7B,OAAO,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,GAAG,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACtD,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,aAAa;IACnB,WAAW,EACT,sFAAsF;QACtF,gGAAgG;QAChG,wFAAwF;IAC1F,MAAM;IACN,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0BAA0B,EAAE;YACpE,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mEAAmE;aACjF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iDAAiD;aAC/D;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;gBAClE,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;aACzC;YACD,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,qCAAqC;aACnD;SACF;QACD,QAAQ,EAAE,CAAC,SAAS,CAAC;KACtB;IAED,KAAK,CAAC,OAAO,CAAC,KAAc,EAAE,GAAgB;QAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAEvG,MAAM,gBAAgB,GAAG,UAAU,IAAI,kBAAkB,CAAC;QAC1D,MAAM,kBAAkB,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC,iBAAiB,CAAC;QAEpF,MAAM,OAAO,GAAG,GAAG;YACjB,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC;YACrC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;QAErB,IACE,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC;YAChD,OAAO,KAAK,GAAG,CAAC,YAAY,EAC5B,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;QACtF,CAAC;QAED,eAAe;QACf,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,cAAc,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;gBAC3C,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,SAAS,CACnC,yCAAyC,OAAO,oBAAoB,CACrE,CAAC;gBACF,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,OAAO;wBACL,OAAO,EAAE,KAAK;wBACd,MAAM,EAAE,EAAE;wBACV,KAAK,EAAE,0EAA0E;qBAClF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YAC5C,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,SAAS,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;YACpE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,EAAE;gBAC/B,GAAG,EAAE,OAAO;gBACZ,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,gBAAgB;gBACzB,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;gBAC1B,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBAC/B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,CAAC,EAAE,CAAC;QACxE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,GAA8E,CAAC;YACzF,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,GAAG,CAAC,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,kBAAkB,GAAG,CAAC,CAAC,CAAC;YACjE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACrE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,MAAM;gBACd,KAAK,EAAE,GAAG,MAAM,KAAK,MAAM,EAAE;aAC9B,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { ToolHandler } from './registry.js';
+/**
+ * File metadata tool — lets the agent verify reality before/after edits.
+ * Returns size, modified time, type, permissions, and optional hash.
+ */
+export declare const statFileTool: ToolHandler;
+//# sourceMappingURL=stat-file.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stat-file.d.ts","sourceRoot":"","sources":["../../src/tools/stat-file.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAS9D;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,WAmF1B,CAAC"}