@omaikit/agents 0.1.0

package/dist/tester/test-patterns.js

@@ -0,0 +1,65 @@
+export class TestPatterns {
+    getPatterns(language, framework) {
+        const normalized = language.toLowerCase();
+        const fw = framework.toLowerCase();
+        if (normalized === 'python') {
+            return [
+                {
+                    name: 'unit-test',
+                    description: 'Basic unit test with pytest-style assertions',
+                    example: 'def test_adds_numbers():\n    assert add(1, 2) == 3',
+                    type: 'unit',
+                },
+                {
+                    name: 'integration-test',
+                    description: 'Integration test with fixture setup',
+                    example: 'def test_api_returns_200(client):\n    response = client.get("/health")\n    assert response.status_code == 200',
+                    type: 'integration',
+                },
+                {
+                    name: 'edge-case',
+                    description: 'Edge case for invalid inputs',
+                    example: 'def test_rejects_empty_payload():\n    with pytest.raises(ValueError):\n        create_user({})',
+                    type: 'edge',
+                },
+            ];
+        }
+        if (fw.includes('vitest') || fw.includes('jest') || normalized === 'typescript') {
+            return [
+                {
+                    name: 'unit-test',
+                    description: 'Unit test with describe/it',
+                    example: 'describe("add", () => {\n  it("adds numbers", () => {\n    expect(add(1, 2)).toBe(3);\n  });\n});',
+                    type: 'unit',
+                },
+                {
+                    name: 'integration-test',
+                    description: 'Integration test with setup/teardown',
+                    example: 'describe("health", () => {\n  it("returns ok", async () => {\n    const res = await api.get("/health");\n    expect(res.status).toBe(200);\n  });\n});',
+                    type: 'integration',
+                },
+                {
+                    name: 'edge-case',
+                    description: 'Edge case for invalid inputs',
+                    example: 'it("rejects empty payload", () => {\n  expect(() => createUser({})).toThrow();\n});',
+                    type: 'edge',
+                },
+            ];
+        }
+        return [
+            {
+                name: 'unit-test',
+                description: 'Basic unit test pattern',
+                example: 'assert add(1, 2) == 3',
+                type: 'unit',
+            },
+            {
+                name: 'edge-case',
+                description: 'Basic edge case test pattern',
+                example: 'assert_throws(invalid_input)',
+                type: 'edge',
+            },
+        ];
+    }
+}
+//# sourceMappingURL=test-patterns.js.map

package/dist/tester/test-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-patterns.js","sourceRoot":"","sources":["../../src/tester/test-patterns.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,YAAY;IACvB,WAAW,CAAC,QAAgB,EAAE,SAAiB;QAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QAEnC,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO;gBACL;oBACE,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,8CAA8C;oBAC3D,OAAO,EAAE,qDAAqD;oBAC9D,IAAI,EAAE,MAAM;iBACb;gBACD;oBACE,IAAI,EAAE,kBAAkB;oBACxB,WAAW,EAAE,qCAAqC;oBAClD,OAAO,EACL,iHAAiH;oBACnH,IAAI,EAAE,aAAa;iBACpB;gBACD;oBACE,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,8BAA8B;oBAC3C,OAAO,EACL,iGAAiG;oBACnG,IAAI,EAAE,MAAM;iBACb;aACF,CAAC;QACJ,CAAC;QAED,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YAChF,OAAO;gBACL;oBACE,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,4BAA4B;oBACzC,OAAO,EACL,mGAAmG;oBACrG,IAAI,EAAE,MAAM;iBACb;gBACD;oBACE,IAAI,EAAE,kBAAkB;oBACxB,WAAW,EAAE,sCAAsC;oBACnD,OAAO,EACL,wJAAwJ;oBAC1J,IAAI,EAAE,aAAa;iBACpB;gBACD;oBACE,IAAI,EAAE,WAAW;oBACjB,WAAW,EAAE,8BAA8B;oBAC3C,OAAO,EACL,qFAAqF;oBACvF,IAAI,EAAE,MAAM;iBACb;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,yBAAyB;gBACtC,OAAO,EAAE,uBAAuB;gBAChC,IAAI,EAAE,MAAM;aACb;YACD;gBACE,IAAI,EAAE,WAAW;gBACjB,WAAW,EAAE,8BAA8B;gBAC3C,OAAO,EAAE,8BAA8B;gBACvC,IAAI,EAAE,MAAM;aACb;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/tester/tester.d.ts

@@ -0,0 +1,56 @@
+import type { AgentInput, AgentOutput } from '../types.js';
+import type { Task, TestSuite } from '@omaikit/models';
+import { Agent } from '../agent.js';
+import { Logger } from '../logger.js';
+export interface TesterAgentInput extends AgentInput {
+    task: Task;
+    projectContext: any;
+    plan: any;
+    run?: boolean;
+    coverageTarget?: number;
+    force?: boolean;
+}
+export interface TesterAgentOutput extends AgentOutput {
+    result: TestSuite;
+    metadata: {
+        durationMs: number;
+        filesGenerated?: number;
+        testsGenerated?: number;
+        coverage?: number;
+        execution?: {
+            passed: number;
+            failed: number;
+            skipped: number;
+            durationMs: number;
+        };
+        tokenUsage?: {
+            input: number;
+            output: number;
+            total: number;
+        };
+    };
+}
+export declare class TesterAgent extends Agent {
+    name: string;
+    version: string;
+    private promptTemplates;
+    private parser;
+    private coverageAnalyzer;
+    private coverageValidator;
+    private frameworkDetector;
+    private testExecutor;
+    private provider?;
+    private memoryStore;
+    constructor(logger?: Logger);
+    init(): Promise<void>;
+    execute(input: TesterAgentInput): Promise<TesterAgentOutput>;
+    validate(output: AgentOutput): Promise<any>;
+    canHandle(_task: Task): boolean;
+    private validateInput;
+    private determineLanguage;
+    private isValidationError;
+    private callLLM;
+    private withTimeout;
+    private getMockGeneratedTests;
+}
+//# sourceMappingURL=tester.d.ts.map

package/dist/tester/tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tester.d.ts","sourceRoot":"","sources":["../../src/tester/tester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,SAAS,EAAY,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAUnC,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,IAAI,EAAE,IAAI,CAAC;IACX,cAAc,EAAE,GAAG,CAAC;IACpB,IAAI,EAAE,GAAG,CAAC;IACV,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE;QACR,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE;YACV,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,OAAO,EAAE,MAAM,CAAC;YAChB,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC;QACF,UAAU,CAAC,EAAE;YACX,KAAK,EAAE,MAAM,CAAC;YACd,MAAM,EAAE,MAAM,CAAC;YACf,KAAK,EAAE,MAAM,CAAC;SACf,CAAC;KACH,CAAC;CACH;AAED,qBAAa,WAAY,SAAQ,KAAK;IAC7B,IAAI,SAAY;IAChB,OAAO,SAAW;IAEzB,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,CAAM;IACvB,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,CAAC,EAAE,MAAM;IAWrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IASrB,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqG5D,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;IAyDjD,SAAS,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAI/B,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;YASX,OAAO;YA2CP,WAAW;IAgBzB,OAAO,CAAC,qBAAqB;CAO9B"}

package/dist/tester/tester.js

@@ -0,0 +1,246 @@
+import { Agent } from '../agent.js';
+import { createProvider } from '../ai-provider/factory.js';
+import { TestPromptTemplates } from './prompt-templates.js';
+import { TestParser } from './test-parser.js';
+import { CoverageAnalyzer } from './coverage-analyzer.js';
+import { CoverageValidator } from './coverage-validator.js';
+import { FrameworkDetector } from './framework-detector.js';
+import { TestExecutor } from './test-executor.js';
+import { MemoryStore } from '../memory/memory-store.js';
+export class TesterAgent extends Agent {
+    name = 'tester';
+    version = '1.0.0';
+    promptTemplates;
+    parser;
+    coverageAnalyzer;
+    coverageValidator;
+    frameworkDetector;
+    testExecutor;
+    provider;
+    memoryStore;
+    constructor(logger) {
+        super(logger);
+        this.promptTemplates = new TestPromptTemplates();
+        this.parser = new TestParser();
+        this.coverageAnalyzer = new CoverageAnalyzer();
+        this.coverageValidator = new CoverageValidator();
+        this.frameworkDetector = new FrameworkDetector();
+        this.testExecutor = new TestExecutor();
+        this.memoryStore = new MemoryStore();
+    }
+    async init() {
+        this.logger.info('Initializing TesterAgent', { version: this.version });
+        try {
+            this.provider = await createProvider();
+        }
+        catch (error) {
+            this.logger.warn('Could not initialize AI provider, using mock mode');
+        }
+    }
+    async execute(input) {
+        const startTime = Date.now();
+        const output = {
+            agentName: this.name,
+            status: 'success',
+            timestamp: new Date().toISOString(),
+            result: {
+                id: `ts-${Date.now()}`,
+                taskId: input.task?.id || 'unknown',
+                files: [],
+            },
+            metadata: {
+                durationMs: 0,
+                filesGenerated: 0,
+                testsGenerated: 0,
+                coverage: 0,
+            },
+        };
+        try {
+            await this.beforeExecute(input);
+            this.validateInput(input);
+            const language = this.determineLanguage(input);
+            const framework = this.frameworkDetector.detect(language, input.projectContext);
+            const prompt = await this.promptTemplates.generatePrompt(input.task, input.projectContext, input.plan, language, framework);
+            const recentMemory = await this.memoryStore.readRecent(this.name, 3);
+            const memoryContext = this.memoryStore.formatRecent(recentMemory);
+            const finalPrompt = memoryContext
+                ? `${prompt}\n\n## Recent Agent Memory\n${memoryContext}`
+                : prompt;
+            const response = await this.callLLM(finalPrompt, language, framework, input);
+            await this.memoryStore.append(this.name, {
+                timestamp: new Date().toISOString(),
+                prompt: finalPrompt,
+                response,
+                taskId: input.task.id,
+            });
+            const files = this.parser.parse(response, language, framework);
+            const coverage = this.coverageAnalyzer.analyze(files);
+            const validation = this.coverageValidator.validate(coverage.overall, input.coverageTarget ?? 80);
+            output.result.files = files;
+            output.result.coverage = coverage.overall;
+            output.result.metadata = {
+                generatedAt: new Date().toISOString(),
+                model: 'mock-model',
+            };
+            output.metadata.filesGenerated = files.length;
+            output.metadata.testsGenerated = files.reduce((sum, file) => sum + file.testCases.length, 0);
+            output.metadata.coverage = coverage.overall;
+            if (!validation.isValid) {
+                output.status = 'partial';
+            }
+            if (input.run) {
+                output.metadata.execution = await this.testExecutor.run(files, framework);
+            }
+            await this.afterExecute(output);
+            await this.memoryStore.clear(this.name);
+        }
+        catch (error) {
+            const err = error;
+            await this.onError(err);
+            output.status = 'failed';
+            output.error = {
+                code: 'TESTER_ERROR',
+                message: err.message,
+            };
+            await this.memoryStore.append(this.name, {
+                timestamp: new Date().toISOString(),
+                prompt: '',
+                response: output.error.message,
+                taskId: input.task?.id,
+                metadata: { status: 'failed' },
+            });
+            if (this.isValidationError(err)) {
+                throw err;
+            }
+        }
+        output.metadata.durationMs = Date.now() - startTime;
+        return output;
+    }
+    async validate(output) {
+        const issues = [];
+        let qualityScore = 100;
+        const result = output.result || {};
+        if (!result.id) {
+            issues.push({ severity: 'error', message: 'Missing result.id', field: 'result.id' });
+            qualityScore -= 25;
+        }
+        if (!result.taskId) {
+            issues.push({ severity: 'error', message: 'Missing result.taskId', field: 'result.taskId' });
+            qualityScore -= 25;
+        }
+        if (!Array.isArray(result.files) || result.files.length === 0) {
+            issues.push({ severity: 'error', message: 'No test files generated', field: 'result.files' });
+            qualityScore -= 25;
+        }
+        if (Array.isArray(result.files)) {
+            result.files.forEach((file, idx) => {
+                if (!file.path) {
+                    issues.push({
+                        severity: 'error',
+                        message: `File ${idx} missing path`,
+                        field: `result.files[${idx}].path`,
+                    });
+                    qualityScore -= 5;
+                }
+                if (!file.language) {
+                    issues.push({
+                        severity: 'error',
+                        message: `File ${idx} missing language`,
+                        field: `result.files[${idx}].language`,
+                    });
+                    qualityScore -= 5;
+                }
+                if (!file.content) {
+                    issues.push({
+                        severity: 'error',
+                        message: `File ${idx} missing content`,
+                        field: `result.files[${idx}].content`,
+                    });
+                    qualityScore -= 5;
+                }
+            });
+        }
+        return {
+            isValid: issues.filter((issue) => issue.severity === 'error').length === 0,
+            issues,
+            warnings: [],
+            qualityScore: Math.max(0, qualityScore),
+        };
+    }
+    canHandle(_task) {
+        return true;
+    }
+    validateInput(input) {
+        if (!input.task) {
+            throw new Error('Task is required');
+        }
+        if (!input.projectContext) {
+            throw new Error('Project context is required');
+        }
+        if (!input.task.id || !input.task.title) {
+            throw new Error('Task must have id and title');
+        }
+    }
+    determineLanguage(input) {
+        const languages = input.projectContext?.metadata?.languages || input.projectContext?.analysis?.languages || [];
+        if (languages.length > 0) {
+            return languages[0];
+        }
+        return 'typescript';
+    }
+    isValidationError(error) {
+        const message = error.message || '';
+        return (message.includes('Task is required') ||
+            message.includes('Project context is required') ||
+            message.includes('Task must have id and title'));
+    }
+    async callLLM(prompt, language, framework, input) {
+        this.logger.info('Calling LLM for test generation', { language, framework });
+        if (process.env.VITEST !== undefined) {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+            return this.getMockGeneratedTests(language, input.task);
+        }
+        if (!this.provider) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+            return this.getMockGeneratedTests(language, input.task);
+        }
+        const response = await this.withTimeout(this.provider.generate(prompt, {
+            temperature: 0.3,
+            maxTokens: 900,
+        }), 90_000);
+        if (!response) {
+            this.logger.warn('LLM generation timed out; using mock output', { timeoutMs: 90_000 });
+            return this.getMockGeneratedTests(language, input.task);
+        }
+        if (typeof response === 'string' &&
+            (response.startsWith('OPENAI_ECHO') || response.startsWith('ANTHROPIC_ECHO'))) {
+            return this.getMockGeneratedTests(language, input.task);
+        }
+        return typeof response === 'string'
+            ? response
+            : this.getMockGeneratedTests(language, input.task);
+    }
+    async withTimeout(promise, timeoutMs) {
+        let timeoutHandle = null;
+        try {
+            return await Promise.race([
+                promise,
+                new Promise((resolve) => {
+                    timeoutHandle = setTimeout(() => resolve(null), timeoutMs);
+                }),
+            ]);
+        }
+        finally {
+            if (timeoutHandle) {
+                clearTimeout(timeoutHandle);
+            }
+        }
+    }
+    getMockGeneratedTests(language, task) {
+        if (language.toLowerCase() === 'python') {
+            return `# File: tests/${task.id}.test.py\n\nimport pytest\n\n\n\ndef test_${task.id}_happy_path():\n    assert True\n\n\n\ndef test_${task.id}_invalid_input():\n    with pytest.raises(Exception):\n        raise Exception("Invalid input")\n`;
+        }
+        return `// File: tests/${task.id}.test.ts\n\nimport { describe, it, expect } from 'vitest';\n\n\ndescribe('${task.title}', () => {\n  it('handles happy path', () => {\n    expect(true).toBe(true);\n  });\n\n  it('handles invalid input', () => {\n    expect(() => { throw new Error('Invalid input'); }).toThrow();\n  });\n});\n`;
+    }
+}
+//# sourceMappingURL=tester.js.map

package/dist/tester/tester.js.map

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

package/dist/tester.d.ts

@@ -0,0 +1,3 @@
+export { TesterAgent } from './tester/tester.js';
+export type { TesterAgentInput, TesterAgentOutput } from './tester/tester.js';
+//# sourceMappingURL=tester.d.ts.map

package/dist/tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tester.d.ts","sourceRoot":"","sources":["../src/tester.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tester.js

@@ -0,0 +1,2 @@
+export { TesterAgent } from './tester/tester.js';
+//# sourceMappingURL=tester.js.map

package/dist/tester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tester.js","sourceRoot":"","sources":["../src/tester.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/tools/default-registry.d.ts

@@ -0,0 +1,3 @@
+import { ToolRegistry } from './registry.js';
+export declare function createDefaultToolRegistry(): ToolRegistry;
+//# sourceMappingURL=default-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default-registry.d.ts","sourceRoot":"","sources":["../../src/tools/default-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK1C,wBAAgB,yBAAyB,IAAI,YAAY,CAMxD"}

package/dist/tools/default-registry.js

@@ -0,0 +1,12 @@
+import { ToolRegistry } from './registry.js';
+import { readToolDefinition, readToolHandler } from './read.js';
+import { searchToolDefinition, searchToolHandler } from './search.js';
+import { editToolDefinition, editToolHandler } from './edit.js';
+export function createDefaultToolRegistry() {
+    const registry = new ToolRegistry();
+    registry.register(readToolDefinition, readToolHandler);
+    registry.register(searchToolDefinition, searchToolHandler);
+    registry.register(editToolDefinition, editToolHandler);
+    return registry;
+}
+//# sourceMappingURL=default-registry.js.map

package/dist/tools/default-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-registry.js","sourceRoot":"","sources":["../../src/tools/default-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAE7D,MAAM,UAAU,yBAAyB;IACvC,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;IAC3D,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;IACvD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/tools/edit.d.ts

@@ -0,0 +1,4 @@
+import { ToolDefinition, ToolHandler } from './types.js';
+export declare const editToolDefinition: ToolDefinition;
+export declare const editToolHandler: ToolHandler;
+//# sourceMappingURL=edit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"edit.d.ts","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtD,eAAO,MAAM,kBAAkB,EAAE,cAqBhC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WAwE7B,CAAC"}

package/dist/tools/edit.js

@@ -0,0 +1,95 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { resolveSafePath, ensureFileExists, readFileLines, writeFileLines } from './utils.js';
+export const editToolDefinition = {
+    name: 'edit',
+    description: 'Edit a text file by replacing, inserting, appending, or overwriting content.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Path to the file, relative to the project root.' },
+            mode: {
+                type: 'string',
+                enum: ['overwrite', 'append', 'replace', 'insert'],
+                description: 'Edit mode to apply.',
+            },
+            content: { type: 'string', description: 'Content to write or insert.' },
+            startLine: { type: 'integer', description: '1-based start line for replace/insert.' },
+            endLine: { type: 'integer', description: '1-based end line for replace.' },
+            find: { type: 'string', description: 'String or regex pattern to replace.' },
+            replace: { type: 'string', description: 'Replacement string.' },
+            useRegex: { type: 'boolean', description: 'Treat find as regex (default: false).' },
+        },
+        required: ['path', 'mode'],
+    },
+};
+export const editToolHandler = (args, context) => {
+    const pathArg = String(args.path || '');
+    const mode = String(args.mode || '');
+    if (!pathArg) {
+        return { ok: false, error: { message: 'path is required', code: 'INVALID_ARGS' } };
+    }
+    if (!mode) {
+        return { ok: false, error: { message: 'mode is required', code: 'INVALID_ARGS' } };
+    }
+    const { absolutePath, relativePath } = resolveSafePath(pathArg, context.rootPath || context.cwd);
+    const encoding = 'utf-8';
+    if (mode === 'overwrite') {
+        const content = String(args.content ?? '');
+        ensureDir(path.dirname(absolutePath));
+        fs.writeFileSync(absolutePath, content, encoding);
+        return { ok: true, data: { path: relativePath, mode, bytes: Buffer.byteLength(content) } };
+    }
+    ensureFileExists(absolutePath);
+    if (mode === 'append') {
+        const content = String(args.content ?? '');
+        fs.appendFileSync(absolutePath, content, encoding);
+        return { ok: true, data: { path: relativePath, mode, bytes: Buffer.byteLength(content) } };
+    }
+    const lines = readFileLines(absolutePath, encoding);
+    if (mode === 'insert') {
+        const content = String(args.content ?? '');
+        const startLine = typeof args.startLine === 'number' ? Math.max(args.startLine, 1) : lines.length + 1;
+        const insertLines = content.split(/\r?\n/);
+        const updated = [
+            ...lines.slice(0, startLine - 1),
+            ...insertLines,
+            ...lines.slice(startLine - 1),
+        ];
+        writeFileLines(absolutePath, updated, encoding);
+        return { ok: true, data: { path: relativePath, mode, startLine } };
+    }
+    if (mode === 'replace') {
+        const content = String(args.content ?? '');
+        if (typeof args.startLine === 'number') {
+            const startLine = Math.max(args.startLine, 1);
+            const endLine = typeof args.endLine === 'number' ? Math.max(args.endLine, startLine) : startLine;
+            const replacement = content.split(/\r?\n/);
+            const updated = [...lines.slice(0, startLine - 1), ...replacement, ...lines.slice(endLine)];
+            writeFileLines(absolutePath, updated, encoding);
+            return { ok: true, data: { path: relativePath, mode, startLine, endLine } };
+        }
+        const find = String(args.find ?? '');
+        if (!find) {
+            return {
+                ok: false,
+                error: { message: 'find is required when startLine is not provided', code: 'INVALID_ARGS' },
+            };
+        }
+        const useRegex = Boolean(args.useRegex);
+        const regex = useRegex ? new RegExp(find, 'g') : new RegExp(escapeRegex(find), 'g');
+        const updatedContent = lines.join('\n').replace(regex, String(args.replace ?? ''));
+        fs.writeFileSync(absolutePath, updatedContent, encoding);
+        return { ok: true, data: { path: relativePath, mode } };
+    }
+    return { ok: false, error: { message: `Unsupported mode: ${mode}`, code: 'INVALID_ARGS' } };
+};
+function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=edit.js.map

package/dist/tools/edit.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,6 @@
+export * from './registry.js';
+export * from './default-registry.js';
+export { readToolDefinition, readToolHandler } from './read.js';
+export { searchToolDefinition, searchToolHandler } from './search.js';
+export { editToolDefinition, editToolHandler } from './edit.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,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+export * from './registry.js';
+export * from './default-registry.js';
+export { readToolDefinition, readToolHandler } from './read.js';
+export { searchToolDefinition, searchToolHandler } from './search.js';
+export { editToolDefinition, editToolHandler } from './edit.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,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC"}

package/dist/tools/read.d.ts

@@ -0,0 +1,4 @@
+import { ToolDefinition, ToolHandler } from './types.js';
+export declare const readToolDefinition: ToolDefinition;
+export declare const readToolHandler: ToolHandler;
+//# sourceMappingURL=read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtD,eAAO,MAAM,kBAAkB,EAAE,cAahC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,WA4B7B,CAAC"}

package/dist/tools/read.js

@@ -0,0 +1,39 @@
+import { resolveSafePath, ensureFileExists, readFileLines } from './utils.js';
+export const readToolDefinition = {
+    name: 'read',
+    description: 'Read a text file from disk with optional line range.',
+    parameters: {
+        type: 'object',
+        properties: {
+            path: { type: 'string', description: 'Path to the file, relative to the project root.' },
+            startLine: { type: 'integer', description: '1-based start line number (inclusive).' },
+            endLine: { type: 'integer', description: '1-based end line number (inclusive).' },
+            encoding: { type: 'string', description: 'File encoding (default: utf-8).' },
+        },
+        required: ['path'],
+    },
+};
+export const readToolHandler = (args, context) => {
+    const pathArg = String(args.path || '');
+    if (!pathArg) {
+        return { ok: false, error: { message: 'path is required', code: 'INVALID_ARGS' } };
+    }
+    const { absolutePath, relativePath } = resolveSafePath(pathArg, context.rootPath || context.cwd);
+    ensureFileExists(absolutePath);
+    const encoding = args.encoding || 'utf-8';
+    const lines = readFileLines(absolutePath, encoding);
+    const startLine = typeof args.startLine === 'number' ? Math.max(args.startLine, 1) : 1;
+    const endLine = typeof args.endLine === 'number' ? Math.min(args.endLine, lines.length) : lines.length;
+    const slice = lines.slice(startLine - 1, endLine).join('\n');
+    return {
+        ok: true,
+        data: {
+            path: relativePath,
+            startLine,
+            endLine,
+            totalLines: lines.length,
+            content: slice,
+        },
+    };
+};
+//# sourceMappingURL=read.js.map

package/dist/tools/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE3E,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,sDAAsD;IACnE,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iDAAiD,EAAE;YACxF,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,wCAAwC,EAAE;YACrF,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sCAAsC,EAAE;YACjF,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iCAAiC,EAAE;SAC7E;QACD,QAAQ,EAAE,CAAC,MAAM,CAAC;KACnB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,CAAC;IACrF,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACjG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAE/B,MAAM,QAAQ,GAAI,IAAI,CAAC,QAA2B,IAAI,OAAO,CAAC;IAC9D,MAAM,KAAK,GAAG,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAEpD,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvF,MAAM,OAAO,GACX,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IAEzF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7D,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE;YACJ,IAAI,EAAE,YAAY;YAClB,SAAS;YACT,OAAO;YACP,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,OAAO,EAAE,KAAK;SACf;KACF,CAAC;AACJ,CAAC,CAAC"}