developer-ai 1.0.0

package/dist/tests/tools.test.js

@@ -0,0 +1,170 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { ToolRegistry } from '../tools/registry.js';
+import { readFileTool } from '../tools/read-file.js';
+import { writeFileTool } from '../tools/write-file.js';
+import { listFilesTool } from '../tools/list-files.js';
+import { searchTextTool } from '../tools/search-text.js';
+import { runCommandTool } from '../tools/run-command.js';
+import { webSearchTool } from '../tools/web-search.js';
+import { resolveSafePath } from '../tools/utils.js';
+import { SkillsLoader } from '../skills/loader.js';
+// ---- Test fixtures ----
+const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'devai-test-'));
+const ctx = {
+    workspaceDir: tmpDir,
+    confirmFn: async () => true,
+    allowDangerous: false,
+    autoYes: true,
+};
+// ---- Path safety ----
+describe('resolveSafePath', () => {
+    it('resolves a relative path inside workspace', () => {
+        const result = resolveSafePath(tmpDir, 'src/index.ts');
+        assert.equal(result, path.join(tmpDir, 'src/index.ts'));
+    });
+    it('rejects paths that escape workspace', () => {
+        const result = resolveSafePath(tmpDir, '../../etc/passwd');
+        assert.equal(result, null);
+    });
+    it('rejects absolute paths outside workspace', () => {
+        const result = resolveSafePath(tmpDir, '/etc/passwd');
+        assert.equal(result, null);
+    });
+});
+// ---- Tool registry ----
+describe('ToolRegistry', () => {
+    it('registers and retrieves tools', () => {
+        const reg = new ToolRegistry();
+        reg.register(readFileTool);
+        assert.equal(reg.get('read_file')?.name, 'read_file');
+        assert.equal(reg.get('nonexistent'), undefined);
+    });
+    it('generates tool definitions', () => {
+        const reg = new ToolRegistry();
+        reg.register(readFileTool);
+        reg.register(writeFileTool);
+        const defs = reg.getDefinitions();
+        assert.equal(defs.length, 2);
+        assert.equal(defs[0].function.name, 'read_file');
+        assert.equal(defs[1].function.name, 'write_file');
+    });
+    it('returns error for unknown tool', async () => {
+        const reg = new ToolRegistry();
+        const result = await reg.execute('not_a_tool', {}, ctx);
+        assert.equal(result.success, false);
+        assert.ok(result.error?.includes('Unknown tool'));
+    });
+});
+// ---- write_file ----
+describe('write_file tool', () => {
+    it('creates a new file', async () => {
+        const result = await writeFileTool.execute({ path: 'test-write.txt', content: 'hello world', confirmOverwrite: false }, ctx);
+        assert.equal(result.success, true);
+        const content = fs.readFileSync(path.join(tmpDir, 'test-write.txt'), 'utf-8');
+        assert.equal(content, 'hello world');
+    });
+    it('creates nested directories', async () => {
+        const result = await writeFileTool.execute({ path: 'deep/nested/file.txt', content: 'nested', confirmOverwrite: false }, ctx);
+        assert.equal(result.success, true);
+        assert.ok(fs.existsSync(path.join(tmpDir, 'deep/nested/file.txt')));
+    });
+    it('rejects paths outside workspace', async () => {
+        const result = await writeFileTool.execute({ path: '../escape.txt', content: 'bad', confirmOverwrite: false }, ctx);
+        assert.equal(result.success, false);
+        assert.ok(result.error?.includes('escapes'));
+    });
+});
+// ---- read_file ----
+describe('read_file tool', () => {
+    it('reads an existing file', async () => {
+        fs.writeFileSync(path.join(tmpDir, 'readable.txt'), 'content here');
+        const result = await readFileTool.execute({ path: 'readable.txt' }, ctx);
+        assert.equal(result.success, true);
+        assert.equal(result.output, 'content here');
+    });
+    it('returns error for missing file', async () => {
+        const result = await readFileTool.execute({ path: 'missing.txt' }, ctx);
+        assert.equal(result.success, false);
+        assert.ok(result.error?.includes('Cannot read'));
+    });
+});
+// ---- list_files ----
+describe('list_files tool', () => {
+    it('lists files in workspace', async () => {
+        const result = await listFilesTool.execute({ path: '.' }, ctx);
+        assert.equal(result.success, true);
+        assert.ok(result.output.includes('readable.txt'));
+    });
+});
+// ---- search_text ----
+describe('search_text tool', () => {
+    it('finds matching text', async () => {
+        fs.writeFileSync(path.join(tmpDir, 'searchme.txt'), 'finding needle here');
+        const result = await searchTextTool.execute({ query: 'needle' }, ctx);
+        assert.equal(result.success, true);
+        assert.ok(result.output.includes('needle'));
+    });
+    it('returns no matches message', async () => {
+        const result = await searchTextTool.execute({ query: 'xyznonexistent123' }, ctx);
+        assert.equal(result.success, true);
+        assert.ok(result.output.includes('No matches'));
+    });
+});
+// ---- run_command ----
+describe('run_command tool', () => {
+    it('runs a safe command', async () => {
+        const result = await runCommandTool.execute({ command: 'echo hello' }, ctx);
+        assert.equal(result.success, true);
+        assert.ok(result.output.includes('hello'));
+    });
+    it('blocks dangerous commands without allowDangerous', async () => {
+        const noConfirmCtx = {
+            ...ctx,
+            autoYes: false,
+            confirmFn: async () => false,
+        };
+        const result = await runCommandTool.execute({ command: 'rm -rf /', allowDangerous: false }, noConfirmCtx);
+        assert.equal(result.success, false);
+        assert.ok(result.error?.includes('blocked') || result.error?.includes('dangerous'));
+    });
+});
+// ---- web_search ----
+describe('web_search tool', () => {
+    it('returns not-configured error when no keys set', async () => {
+        const result = await webSearchTool.execute({ query: 'test' }, ctx);
+        assert.equal(result.success, false);
+        assert.ok(result.error?.includes('not configured'));
+    });
+});
+// ---- SkillsLoader ----
+describe('SkillsLoader', () => {
+    it('loads no skills from empty dir', async () => {
+        const loader = new SkillsLoader([path.join(tmpDir, 'no-skills')]);
+        await loader.load();
+        assert.equal(loader.getAll().length, 0);
+    });
+    it('finds relevant skills by keyword', async () => {
+        const skillDir = path.join(tmpDir, 'skills-test', 'testing');
+        fs.mkdirSync(skillDir, { recursive: true });
+        fs.writeFileSync(path.join(skillDir, 'SKILL.md'), '---\nname: testing-strategy\ndescription: Testing and test plans\n---\n# Testing\nWrite tests.');
+        const loader = new SkillsLoader([path.join(tmpDir, 'skills-test')]);
+        await loader.load();
+        const relevant = loader.findRelevant('write unit tests');
+        assert.ok(relevant.length > 0);
+        assert.equal(relevant[0].name, 'testing-strategy');
+    });
+});
+// ---- Cleanup ----
+process.on('exit', () => {
+    try {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/tests/tools.test.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,5 @@
+import { ToolRegistry } from './registry.js';
+export declare function createToolRegistry(): ToolRegistry;
+export { ToolRegistry } from './registry.js';
+export type { ToolHandler, ToolContext } from './registry.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAQ7C,wBAAgB,kBAAkB,IAAI,YAAY,CASjD;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,19 @@
+import { ToolRegistry } from './registry.js';
+import { readFileTool } from './read-file.js';
+import { writeFileTool } from './write-file.js';
+import { listFilesTool } from './list-files.js';
+import { searchTextTool } from './search-text.js';
+import { runCommandTool } from './run-command.js';
+import { webSearchTool } from './web-search.js';
+export function createToolRegistry() {
+    const registry = new ToolRegistry();
+    registry.register(readFileTool);
+    registry.register(writeFileTool);
+    registry.register(listFilesTool);
+    registry.register(searchTextTool);
+    registry.register(runCommandTool);
+    registry.register(webSearchTool);
+    return registry;
+}
+export { ToolRegistry } from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClC,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/tools/list-files.d.ts

@@ -0,0 +1,3 @@
+import type { ToolHandler } from './registry.js';
+export declare const listFilesTool: ToolHandler;
+//# sourceMappingURL=list-files.d.ts.map

package/dist/tools/list-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files.d.ts","sourceRoot":"","sources":["../../src/tools/list-files.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAQ9D,eAAO,MAAM,aAAa,EAAE,WAyD3B,CAAC"}

package/dist/tools/list-files.js

@@ -0,0 +1,60 @@
+import path from 'node:path';
+import { glob } from 'glob';
+import { z } from 'zod';
+const schema = z.object({
+    path: z.string().default('.'),
+    pattern: z.string().optional(),
+});
+export const listFilesTool = {
+    name: 'list_files',
+    description: 'List files under a directory (workspace-relative). ' +
+        'Optionally filter with a glob pattern. Excludes node_modules, .git, dist by default.',
+    schema,
+    jsonSchema: {
+        type: 'object',
+        properties: {
+            path: {
+                type: 'string',
+                description: 'Directory path relative to workspace (default: ".")',
+            },
+            pattern: {
+                type: 'string',
+                description: 'Glob pattern to filter results (default: "**/*")',
+            },
+        },
+        required: ['path'],
+    },
+    async execute(input, ctx) {
+        const { path: dirPath, pattern } = schema.parse(input);
+        const dir = path.resolve(ctx.workspaceDir, dirPath);
+        if (!dir.startsWith(ctx.workspaceDir + path.sep) &&
+            dir !== ctx.workspaceDir) {
+            return { success: false, output: '', error: 'Path escapes workspace directory' };
+        }
+        try {
+            const globPattern = pattern ?? '**/*';
+            const files = await glob(globPattern, {
+                cwd: dir,
+                nodir: false,
+                dot: false,
+                ignore: ['node_modules/**', '.git/**', 'dist/**'],
+                maxDepth: 5,
+            });
+            const sorted = files.sort();
+            const limited = sorted.slice(0, 300);
+            let output = limited.join('\n');
+            if (sorted.length > 300) {
+                output += `\n... and ${sorted.length - 300} more files`;
+            }
+            return { success: true, output: output || '(empty directory)' };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: '',
+                error: `Cannot list directory: ${err.message}`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=list-files.js.map

package/dist/tools/list-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-files.js","sourceRoot":"","sources":["../../src/tools/list-files.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,qDAAqD;QACrD,sFAAsF;IACxF,MAAM;IACN,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qDAAqD;aACnE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;IAED,KAAK,CAAC,OAAO,CAAC,KAAc,EAAE,GAAgB;QAC5C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEpD,IACE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC;YAC5C,GAAG,KAAK,GAAG,CAAC,YAAY,EACxB,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;QACnF,CAAC;QAED,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,OAAO,IAAI,MAAM,CAAC;YACtC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE;gBACpC,GAAG,EAAE,GAAG;gBACR,KAAK,EAAE,KAAK;gBACZ,GAAG,EAAE,KAAK;gBACV,MAAM,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,SAAS,CAAC;gBACjD,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACrC,IAAI,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,IAAI,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;gBACxB,MAAM,IAAI,aAAa,MAAM,CAAC,MAAM,GAAG,GAAG,aAAa,CAAC;YAC1D,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,0BAA2B,GAAa,CAAC,OAAO,EAAE;aAC1D,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ToolHandler } from './registry.js';
+export declare const readFileTool: ToolHandler;
+//# sourceMappingURL=read-file.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/read-file.js

@@ -0,0 +1,46 @@
+import fs from 'node:fs/promises';
+import { z } from 'zod';
+import { resolveSafePath } from './utils.js';
+import { MAX_FILE_SIZE } from '../constants.js';
+const schema = z.object({
+    path: z.string().describe('Workspace-relative file path'),
+});
+export const readFileTool = {
+    name: 'read_file',
+    description: 'Read a text file from the workspace. Path is relative to workspace root.',
+    schema,
+    jsonSchema: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Workspace-relative file path' },
+        },
+        required: ['path'],
+    },
+    async execute(input, ctx) {
+        const { path: filePath } = schema.parse(input);
+        const resolved = resolveSafePath(ctx.workspaceDir, filePath);
+        if (!resolved) {
+            return { success: false, output: '', error: 'Path escapes workspace directory' };
+        }
+        try {
+            const stat = await fs.stat(resolved);
+            if (stat.size > MAX_FILE_SIZE) {
+                return {
+                    success: false,
+                    output: '',
+                    error: `File too large (${(stat.size / 1024).toFixed(0)} KB). Max: ${MAX_FILE_SIZE / 1024} KB`,
+                };
+            }
+            const content = await fs.readFile(resolved, 'utf-8');
+            return { success: true, output: content };
+        }
+        catch (err) {
+            return {
+                success: false,
+                output: '',
+                error: `Cannot read file: ${err.message}`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=read-file.js.map

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

@@ -0,0 +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"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,24 @@
+import type { ToolDefinition, ToolResult } from '../core/types.js';
+import type { z } from 'zod';
+export interface ToolHandler {
+    name: string;
+    description: string;
+    schema: z.ZodType;
+    jsonSchema: Record<string, unknown>;
+    execute(input: unknown, context: ToolContext): Promise<ToolResult>;
+}
+export interface ToolContext {
+    workspaceDir: string;
+    confirmFn: (message: string) => Promise<boolean>;
+    allowDangerous: boolean;
+    autoYes: boolean;
+}
+export declare class ToolRegistry {
+    private tools;
+    register(handler: ToolHandler): void;
+    get(name: string): ToolHandler | undefined;
+    getDefinitions(): ToolDefinition[];
+    execute(name: string, input: unknown, context: ToolContext): Promise<ToolResult>;
+    listNames(): string[];
+}
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAkC;IAE/C,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAIpC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI1C,cAAc,IAAI,cAAc,EAAE;IAW5B,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAetB,SAAS,IAAI,MAAM,EAAE;CAGtB"}

package/dist/tools/registry.js

@@ -0,0 +1,37 @@
+export class ToolRegistry {
+    tools = new Map();
+    register(handler) {
+        this.tools.set(handler.name, handler);
+    }
+    get(name) {
+        return this.tools.get(name);
+    }
+    getDefinitions() {
+        return Array.from(this.tools.values()).map((t) => ({
+            type: 'function',
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.jsonSchema,
+            },
+        }));
+    }
+    async execute(name, input, context) {
+        const handler = this.tools.get(name);
+        if (!handler) {
+            return { success: false, output: '', error: `Unknown tool: ${name}` };
+        }
+        try {
+            const validated = handler.schema.parse(input);
+            return await handler.execute(validated, context);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, output: '', error: `Tool "${name}" error: ${msg}` };
+        }
+    }
+    listNames() {
+        return Array.from(this.tools.keys());
+    }
+}
+//# sourceMappingURL=registry.js.map

package/dist/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,YAAY;IACf,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE/C,QAAQ,CAAC,OAAoB;QAC3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,GAAG,CAAC,IAAY;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,cAAc;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjD,IAAI,EAAE,UAAmB;YACzB,QAAQ,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,UAAU,EAAE,CAAC,CAAC,UAAU;aACzB;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,OAAO,CACX,IAAY,EACZ,KAAc,EACd,OAAoB;QAEpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC;QACxE,CAAC;QAED,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC9C,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,IAAI,YAAY,GAAG,EAAE,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;CACF"}

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

@@ -0,0 +1,3 @@
+import type { ToolHandler } from './registry.js';
+export declare const runCommandTool: ToolHandler;
+//# sourceMappingURL=run-command.d.ts.map

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

@@ -0,0 +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"}

package/dist/tools/run-command.js

@@ -0,0 +1,114 @@
+import { execSync } from 'node:child_process';
+import path from 'node:path';
+import { z } from 'zod';
+import { COMMAND_TIMEOUT_MS, MAX_OUTPUT_LENGTH } from '../constants.js';
+/** Commands that run without asking the user. */
+const SAFE_COMMANDS = new Set([
+    'ls', 'cat', 'head', 'tail', 'wc', 'find', 'grep', 'echo', 'pwd', 'stat',
+    'node', 'npm', 'npx', 'tsc', 'python', 'python3', 'pip', 'pip3',
+    'git', 'which', 'date', 'tree', 'file', 'diff', 'du',
+    'sort', 'uniq', 'cut', 'tr', 'sed', 'awk', 'jq',
+    'open', // macOS
+    'xdg-open', // Linux
+    'mkdir',
+]);
+/** Patterns that are always considered dangerous. */
+const DANGEROUS_PATTERNS = [
+    /\brm\s+.*-[a-z]*[rf]/i,
+    /\bmkfs\b/i,
+    /\bdd\s+if=/i,
+    /:\s*\(\)\s*\{/, // fork bomb
+    /\bcurl\b.*\|\s*(sh|bash|zsh)\b/i,
+    /\bwget\b.*\|\s*(sh|bash|zsh)\b/i,
+    /\bchmod\s+777\b/i,
+    />\s*\/dev\//i,
+    /\bformat\s+[a-z]:/i,
+    /\bsudo\s+(rm|mkfs|dd|chmod|chown)\b/i,
+];
+function baseCommand(command) {
+    const firstWord = command.trim().split(/\s+/)[0] ?? '';
+    return path.basename(firstWord);
+}
+function isSafe(command) {
+    return SAFE_COMMANDS.has(baseCommand(command));
+}
+function isDangerous(command) {
+    return DANGEROUS_PATTERNS.some((p) => p.test(command));
+}
+const schema = z.object({
+    command: z.string(),
+    cwd: z.string().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.',
+    schema,
+    jsonSchema: {
+        type: 'object',
+        properties: {
+            command: { type: 'string', description: 'Shell command to execute' },
+            cwd: {
+                type: 'string',
+                description: 'Working directory relative to workspace (default: workspace root)',
+            },
+            allowDangerous: {
+                type: 'boolean',
+                description: 'Explicitly allow dangerous commands',
+            },
+        },
+        required: ['command'],
+    },
+    async execute(input, ctx) {
+        const { command, cwd, allowDangerous } = schema.parse(input);
+        const workDir = cwd
+            ? path.resolve(ctx.workspaceDir, cwd)
+            : ctx.workspaceDir;
+        if (!workDir.startsWith(ctx.workspaceDir + path.sep) &&
+            workDir !== ctx.workspaceDir) {
+            return { success: false, output: '', error: 'Working directory escapes workspace' };
+        }
+        // Safety gates
+        if (isDangerous(command)) {
+            if (!allowDangerous && !ctx.allowDangerous) {
+                const confirmed = await ctx.confirmFn(`⚠️  Potentially dangerous command:\n  ${command}\nAllow execution?`);
+                if (!confirmed) {
+                    return {
+                        success: false,
+                        output: '',
+                        error: 'Command blocked: flagged as dangerous. Use --allow-dangerous or confirm.',
+                    };
+                }
+            }
+        }
+        else if (!isSafe(command) && !ctx.autoYes) {
+            const confirmed = await ctx.confirmFn(`Run command?\n  ${command}`);
+            if (!confirmed) {
+                return { success: false, output: '', error: 'Command cancelled by user' };
+            }
+        }
+        try {
+            const stdout = execSync(command, {
+                cwd: workDir,
+                encoding: 'utf-8',
+                timeout: COMMAND_TIMEOUT_MS,
+                maxBuffer: 2 * 1024 * 1024,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return { success: true, output: stdout.slice(0, MAX_OUTPUT_LENGTH) };
+        }
+        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);
+            return {
+                success: false,
+                output: stdout,
+                error: `Exit code ${e.status ?? 1}: ${stderr}`,
+            };
+        }
+    },
+};
+//# sourceMappingURL=run-command.js.map

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

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

package/dist/tools/search-text.d.ts

@@ -0,0 +1,3 @@
+import type { ToolHandler } from './registry.js';
+export declare const searchTextTool: ToolHandler;
+//# sourceMappingURL=search-text.d.ts.map

package/dist/tools/search-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-text.d.ts","sourceRoot":"","sources":["../../src/tools/search-text.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAQ9D,eAAO,MAAM,cAAc,EAAE,WAiG5B,CAAC"}