@polka-codes/core 0.10.11 → 0.10.16

package/dist/tools/renameFile.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../tool';
+import type { FilesystemProvider } from './provider';
+export declare const toolInfo: {
+    readonly name: "renameFile";
+    readonly description: "Request to rename a file from source path to target path.";
+    readonly parameters: z.ZodObject<{
+        source_path: z.ZodString;
+        target_path: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, FilesystemProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "renameFile";
+        readonly description: "Request to rename a file from source path to target path.";
+        readonly parameters: z.ZodObject<{
+            source_path: z.ZodString;
+            target_path: z.ZodString;
+        }, z.core.$strip>;
+    }, FilesystemProvider>;
+    name: "renameFile";
+    description: "Request to rename a file from source path to target path.";
+    parameters: z.ZodObject<{
+        source_path: z.ZodString;
+        target_path: z.ZodString;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/renameFile.js

@@ -0,0 +1,48 @@
+// Generated by polka.codes
+// Tool for renaming files in the filesystem
+import { z } from 'zod';
+export const toolInfo = {
+    name: 'renameFile',
+    description: 'Request to rename a file from source path to target path.',
+    parameters: z
+        .object({
+        source_path: z.string().describe('The current path of the file').meta({ usageValue: 'Source file path here' }),
+        target_path: z.string().describe('The new path for the file').meta({ usageValue: 'Target file path here' }),
+    })
+        .meta({
+        examples: [
+            {
+                description: 'Request to rename a file',
+                input: {
+                    source_path: 'src/old-name.js',
+                    target_path: 'src/new-name.js',
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.renameFile) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'Not possible to rename file.',
+            },
+        };
+    }
+    const { source_path, target_path } = toolInfo.parameters.parse(args);
+    await provider.renameFile(source_path, target_path);
+    return {
+        success: true,
+        message: {
+            type: 'text',
+            value: `<rename_file_path>${target_path}</rename_file_path><status>Success</status>`,
+        },
+    };
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=renameFile.js.map

package/dist/tools/renameFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renameFile.js","sourceRoot":"","sources":["../../src/tools/renameFile.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,4CAA4C;AAE5C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,2DAA2D;IACxE,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,uBAAuB,EAAE,CAAC;QAC9G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,uBAAuB,EAAE,CAAC;KAC5G,CAAC;SACD,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR;gBACE,WAAW,EAAE,0BAA0B;gBACvC,KAAK,EAAE;oBACL,WAAW,EAAE,iBAAiB;oBAC9B,WAAW,EAAE,iBAAiB;iBAC/B;aACF;SACF;KACF,CAAC;CACuB,CAAA;AAE7B,MAAM,CAAC,MAAM,OAAO,GAAqD,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAChG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QACzB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,8BAA8B;aACtC;SACF,CAAA;IACH,CAAC;IAED,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACpE,MAAM,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IAEnD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,qBAAqB,WAAW,6CAA6C;SACrF;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe;IACb,GAAG,QAAQ;IACX,OAAO;CACe,CAAA"}

package/dist/tools/renameFile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/renameFile.test.js

@@ -0,0 +1,53 @@
+// Generated by polka.codes
+// Tests for the renameFile tool
+import { describe, expect, it, spyOn } from 'bun:test';
+import { MockProvider } from './provider';
+import renameFile from './renameFile';
+describe('renameFile', () => {
+    it('should rename file successfully', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'renameFile').mockResolvedValue();
+        const result = await renameFile.handler(mockProvider, {
+            source_path: 'old.txt',
+            target_path: 'new.txt',
+        });
+        // Verify successful rename
+        expect(result).toEqual({
+            success: true,
+            message: {
+                type: 'text',
+                value: '<rename_file_path>new.txt</rename_file_path><status>Success</status>',
+            },
+        });
+        expect(mockProvider.renameFile).toHaveBeenCalledWith('old.txt', 'new.txt');
+    });
+    it('should handle rename errors', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'renameFile').mockRejectedValue(new Error('Rename error'));
+        const result = renameFile.handler(mockProvider, {
+            source_path: 'error.txt',
+            target_path: 'new.txt',
+        });
+        // Verify error is propagated
+        await expect(result).rejects.toThrow('Rename error');
+        expect(mockProvider.renameFile).toHaveBeenCalledWith('error.txt', 'new.txt');
+    });
+    it('should handle unavailable provider', async () => {
+        const mockProvider = new MockProvider();
+        // @ts-expect-error
+        mockProvider.renameFile = undefined;
+        const result = await renameFile.handler(mockProvider, {
+            source_path: 'test.txt',
+            target_path: 'new.txt',
+        });
+        // Verify unavailable provider returns error message
+        expect(result).toEqual({
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'Not possible to rename file.',
+            },
+        });
+    });
+});
+//# sourceMappingURL=renameFile.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renameFile.test.js","sourceRoot":"","sources":["../../src/tools/renameFile.test.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,gCAAgC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,UAAU,MAAM,cAAc,CAAA;AAErC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;QAC/C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,iBAAiB,EAAE,CAAA;QAErD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE;YACpD,WAAW,EAAE,SAAS;YACtB,WAAW,EAAE,SAAS;SACvB,CAAC,CAAA;QAEF,2BAA2B;QAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,sEAAsE;aAC9E;SACF,CAAC,CAAA;QACF,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;IAC5E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;QAC3C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC,CAAA;QAE9E,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE;YAC9C,WAAW,EAAE,WAAW;YACxB,WAAW,EAAE,SAAS;SACvB,CAAC,CAAA;QAEF,6BAA6B;QAC7B,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAA;QACpD,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;IAC9E,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,KAAK,IAAI,EAAE;QAClD,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,mBAAmB;QACnB,YAAY,CAAC,UAAU,GAAG,SAAS,CAAA;QAEnC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,YAAY,EAAE;YACpD,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,SAAS;SACvB,CAAC,CAAA;QAEF,oDAAoD;QACpD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,8BAA8B;aACtC;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tools/replaceInFile.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../tool';
+import type { FilesystemProvider } from './provider';
+export declare const toolInfo: {
+    readonly name: "replaceInFile";
+    readonly description: "Request to replace sections of content in an existing file using\nSEARCH/REPLACE blocks.\n\nWhen to use:\n- Making targeted changes to specific parts of a file\n- Replacing variable names, function signatures, imports\n- Fixing bugs in existing code\n- When you know the exact content to replace\n\nWhen NOT to use:\n- For creating new files: Use writeToFile instead\n- For completely replacing file contents: Use writeToFile instead\n- When you don't know the exact content: Read file first\n\nSEARCH/REPLACE FORMAT:\n<<<<<<< SEARCH\n[exact content to find]\n=======\n[new content to replace with]\n>>>>>>> REPLACE\n\nCritical rules:\n1. SEARCH content must match EXACTLY (character-for-character including whitespace)\n2. Each block replaces only first occurrence\n3. Include just enough lines for uniqueness (not too many, not too few)\n4. Keep blocks concise (don't include long unchanged sections)\n5. List blocks in order they appear in file\n6. Use multiple blocks for multiple independent changes\n\nSpecial operations:\n- Move code: Two blocks (delete from original + insert at new location)\n- Delete code: Empty REPLACE section\n\nIMPORTANT CONSTRAINTS:\n- SEARCH text must match file content exactly\n- Each block is independent (doesn't affect other blocks)\n- Cannot use for appending or inserting without SEARCH context";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodString;
+        diff: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, FilesystemProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "replaceInFile";
+        readonly description: "Request to replace sections of content in an existing file using\nSEARCH/REPLACE blocks.\n\nWhen to use:\n- Making targeted changes to specific parts of a file\n- Replacing variable names, function signatures, imports\n- Fixing bugs in existing code\n- When you know the exact content to replace\n\nWhen NOT to use:\n- For creating new files: Use writeToFile instead\n- For completely replacing file contents: Use writeToFile instead\n- When you don't know the exact content: Read file first\n\nSEARCH/REPLACE FORMAT:\n<<<<<<< SEARCH\n[exact content to find]\n=======\n[new content to replace with]\n>>>>>>> REPLACE\n\nCritical rules:\n1. SEARCH content must match EXACTLY (character-for-character including whitespace)\n2. Each block replaces only first occurrence\n3. Include just enough lines for uniqueness (not too many, not too few)\n4. Keep blocks concise (don't include long unchanged sections)\n5. List blocks in order they appear in file\n6. Use multiple blocks for multiple independent changes\n\nSpecial operations:\n- Move code: Two blocks (delete from original + insert at new location)\n- Delete code: Empty REPLACE section\n\nIMPORTANT CONSTRAINTS:\n- SEARCH text must match file content exactly\n- Each block is independent (doesn't affect other blocks)\n- Cannot use for appending or inserting without SEARCH context";
+        readonly parameters: z.ZodObject<{
+            path: z.ZodString;
+            diff: z.ZodString;
+        }, z.core.$strip>;
+    }, FilesystemProvider>;
+    name: "replaceInFile";
+    description: "Request to replace sections of content in an existing file using\nSEARCH/REPLACE blocks.\n\nWhen to use:\n- Making targeted changes to specific parts of a file\n- Replacing variable names, function signatures, imports\n- Fixing bugs in existing code\n- When you know the exact content to replace\n\nWhen NOT to use:\n- For creating new files: Use writeToFile instead\n- For completely replacing file contents: Use writeToFile instead\n- When you don't know the exact content: Read file first\n\nSEARCH/REPLACE FORMAT:\n<<<<<<< SEARCH\n[exact content to find]\n=======\n[new content to replace with]\n>>>>>>> REPLACE\n\nCritical rules:\n1. SEARCH content must match EXACTLY (character-for-character including whitespace)\n2. Each block replaces only first occurrence\n3. Include just enough lines for uniqueness (not too many, not too few)\n4. Keep blocks concise (don't include long unchanged sections)\n5. List blocks in order they appear in file\n6. Use multiple blocks for multiple independent changes\n\nSpecial operations:\n- Move code: Two blocks (delete from original + insert at new location)\n- Delete code: Empty REPLACE section\n\nIMPORTANT CONSTRAINTS:\n- SEARCH text must match file content exactly\n- Each block is independent (doesn't affect other blocks)\n- Cannot use for appending or inserting without SEARCH context";
+    parameters: z.ZodObject<{
+        path: z.ZodString;
+        diff: z.ZodString;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/replaceInFile.js

@@ -0,0 +1,233 @@
+// generated by polka.codes
+import { z } from 'zod';
+import { replaceInFile } from './utils/replaceInFile';
+export const toolInfo = {
+    name: 'replaceInFile',
+    description: `Request to replace sections of content in an existing file using
+SEARCH/REPLACE blocks.
+
+When to use:
+- Making targeted changes to specific parts of a file
+- Replacing variable names, function signatures, imports
+- Fixing bugs in existing code
+- When you know the exact content to replace
+
+When NOT to use:
+- For creating new files: Use writeToFile instead
+- For completely replacing file contents: Use writeToFile instead
+- When you don't know the exact content: Read file first
+
+SEARCH/REPLACE FORMAT:
+<<<<<<< SEARCH
+[exact content to find]
+=======
+[new content to replace with]
+>>>>>>> REPLACE
+
+Critical rules:
+1. SEARCH content must match EXACTLY (character-for-character including whitespace)
+2. Each block replaces only first occurrence
+3. Include just enough lines for uniqueness (not too many, not too few)
+4. Keep blocks concise (don't include long unchanged sections)
+5. List blocks in order they appear in file
+6. Use multiple blocks for multiple independent changes
+
+Special operations:
+- Move code: Two blocks (delete from original + insert at new location)
+- Delete code: Empty REPLACE section
+
+IMPORTANT CONSTRAINTS:
+- SEARCH text must match file content exactly
+- Each block is independent (doesn't affect other blocks)
+- Cannot use for appending or inserting without SEARCH context`,
+    parameters: z
+        .object({
+        path: z.string().describe('The path of the file to modify').meta({ usageValue: 'File path here' }),
+        diff: z
+            .string()
+            .describe(`One or more SEARCH/REPLACE blocks following this exact format:
+\`\`\`
+<<<<<<< SEARCH
+[exact content to find]
+=======
+[new content to replace with]
+>>>>>>> REPLACE
+\`\`\`
+Critical rules:
+1. SEARCH content must match the associated file section to find EXACTLY:
+    * Match character-for-character including whitespace, indentation, line endings
+    * Include all comments, docstrings, etc.
+2. SEARCH/REPLACE blocks will ONLY replace the first match occurrence.
+    * Including multiple unique SEARCH/REPLACE blocks if you need to make multiple changes.
+    * Include *just* enough lines in each SEARCH section to uniquely match each set of lines that need to change.
+    * When using multiple SEARCH/REPLACE blocks, list them in the order they appear in the file.
+3. Keep SEARCH/REPLACE blocks concise:
+    * Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.
+    * Include just the changing lines, and a few surrounding lines if needed for uniqueness.
+    * Do not include long runs of unchanging lines in SEARCH/REPLACE blocks.
+    * Each line must be complete. Never truncate lines mid-way through as this can cause matching failures.
+4. Special operations:
+    * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)
+    * To delete code: Empty REPLACE section`)
+            .meta({ usageValue: 'Search and replace blocks here' }),
+    })
+        .meta({
+        examples: [
+            {
+                description: 'Request to replace sections of content in a file',
+                input: {
+                    path: 'src/main.js',
+                    diff: `<<<<<<< SEARCH
+import React from 'react';
+=======
+import React, { useState } from 'react';
+>>>>>>> REPLACE
+
+<<<<<<< SEARCH
+function handleSubmit() {
+  saveData();
+  setLoading(false);
+}
+
+=======
+>>>>>>> REPLACE
+
+<<<<<<< SEARCH
+return (
+  <div>
+=======
+function handleSubmit() {
+  saveData();
+  setLoading(false);
+}
+
+return (
+  <div>
+>>>>>>> REPLACE`,
+                },
+            },
+            {
+                description: 'Request to perform a simple, single-line replacement',
+                input: {
+                    path: 'src/config.js',
+                    diff: `<<<<<<< SEARCH
+const API_URL = 'https://api.example.com';
+=======
+const API_URL = 'https://api.staging.example.com';
+>>>>>>> REPLACE`,
+                },
+            },
+            {
+                description: 'Request to add a new function to a file',
+                input: {
+                    path: 'src/utils.js',
+                    diff: `<<<<<<< SEARCH
+function helperA() {
+  // ...
+}
+=======
+function helperA() {
+  // ...
+}
+
+function newHelper() {
+  // implementation
+}
+>>>>>>> REPLACE`,
+                },
+            },
+            {
+                description: 'Request to delete a block of code from a file',
+                input: {
+                    path: 'src/app.js',
+                    diff: `<<<<<<< SEARCH
+function oldFeature() {
+  // This is no longer needed
+}
+
+=======
+>>>>>>> REPLACE`,
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.readFile || !provider.writeFile) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'Not possible to replace in file.',
+            },
+        };
+    }
+    const parsed = toolInfo.parameters.safeParse(args);
+    if (!parsed.success) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: `Invalid arguments for replaceInFile: ${parsed.error.message}`,
+            },
+        };
+    }
+    const { path, diff } = parsed.data;
+    try {
+        const fileContent = await provider.readFile(path, false);
+        if (fileContent == null) {
+            return {
+                success: false,
+                message: {
+                    type: 'error-text',
+                    value: `<replace_in_file_result path="${path}" status="failed" message="File not found" />`,
+                },
+            };
+        }
+        const result = replaceInFile(fileContent, diff);
+        if (result.status === 'no_diff_applied') {
+            return {
+                success: false,
+                message: {
+                    type: 'error-text',
+                    value: `<replace_in_file_result path="${path}" status="failed" message="Unable to apply changes">
+  <file_content path="${path}">${fileContent}</file_content>
+</replace_in_file_result>`,
+                },
+            };
+        }
+        await provider.writeFile(path, result.content);
+        if (result.status === 'some_diff_applied') {
+            return {
+                success: true,
+                message: {
+                    type: 'text',
+                    value: `<replace_in_file_result path="${path}" status="some_diff_applied" applied_count="${result.appliedCount}" total_count="${result.totalCount}">
+  <file_content path="${path}">${result.content}</file_content>
+</replace_in_file_result>`,
+                },
+            };
+        }
+        return {
+            success: true,
+            message: {
+                type: 'text',
+                value: `<replace_in_file_result path="${path}" status="all_diff_applied" />`,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: `Invalid arguments for replaceInFile: ${error}`,
+            },
+        };
+    }
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=replaceInFile.js.map

package/dist/tools/replaceInFile.js.map

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

package/dist/tools/replaceInFile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/replaceInFile.test.js

@@ -0,0 +1,79 @@
+// generated by polka.codes
+import { describe, expect, mock, spyOn, test } from 'bun:test';
+import { handler } from './replaceInFile';
+import * as replaceInFileModule from './utils/replaceInFile';
+describe('replaceInFile tool', () => {
+    const mockProvider = {
+        readFile: mock((_path) => Promise.resolve('')),
+        writeFile: mock((_path, _content) => Promise.resolve()),
+    };
+    test('handler should return error if provider is missing methods', async () => {
+        const incompleteProvider = { writeFile: mock(() => Promise.resolve()) };
+        const result = await handler(incompleteProvider, {});
+        expect(result).toEqual({
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'Not possible to replace in file.',
+            },
+        });
+    });
+    test('handler should return file not found error', async () => {
+        ;
+        mockProvider.readFile.mockResolvedValueOnce(undefined);
+        const args = { path: 'nonexistent.txt', diff: '...' };
+        const result = await handler(mockProvider, args);
+        expect(result.success).toBe(false);
+        if (result.success === false) {
+            expect(result.message).toMatchSnapshot();
+        }
+    });
+    test('handler should return no_diff_applied message', async () => {
+        ;
+        mockProvider.readFile.mockResolvedValueOnce('file content');
+        spyOn(replaceInFileModule, 'replaceInFile').mockReturnValueOnce({
+            status: 'no_diff_applied',
+            appliedCount: 0,
+            totalCount: 2,
+            content: 'file content',
+        });
+        const args = { path: 'test.txt', diff: '...' };
+        const result = await handler(mockProvider, args);
+        expect(result).toMatchSnapshot();
+    });
+    test('handler should return some_diff_applied message', async () => {
+        ;
+        mockProvider.readFile.mockResolvedValueOnce('file content');
+        spyOn(replaceInFileModule, 'replaceInFile').mockReturnValueOnce({
+            status: 'some_diff_applied',
+            appliedCount: 1,
+            totalCount: 2,
+            content: 'new content',
+        });
+        const args = { path: 'test.txt', diff: '...' };
+        const result = await handler(mockProvider, args);
+        expect(result.success).toBe(true);
+        if (result.success === true) {
+            expect(result.message).toMatchSnapshot();
+        }
+        expect(mockProvider.writeFile).toHaveBeenCalledWith('test.txt', 'new content');
+    });
+    test('handler should return all_diff_applied message', async () => {
+        ;
+        mockProvider.readFile.mockResolvedValueOnce('file content');
+        spyOn(replaceInFileModule, 'replaceInFile').mockReturnValueOnce({
+            status: 'all_diff_applied',
+            appliedCount: 2,
+            totalCount: 2,
+            content: 'new content',
+        });
+        const args = { path: 'test.txt', diff: '...' };
+        const result = await handler(mockProvider, args);
+        expect(result.success).toBe(true);
+        if (result.success === true) {
+            expect(result.message).toMatchSnapshot();
+        }
+        expect(mockProvider.writeFile).toHaveBeenCalledWith('test.txt', 'new content');
+    });
+});
+//# sourceMappingURL=replaceInFile.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replaceInFile.test.js","sourceRoot":"","sources":["../../src/tools/replaceInFile.test.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAa,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAGzE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,KAAK,mBAAmB,MAAM,uBAAuB,CAAA;AAE5D,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,MAAM,YAAY,GAAuB;QACvC,QAAQ,EAAE,IAAI,CAAC,CAAC,KAAa,EAA+B,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACnF,SAAS,EAAE,IAAI,CAAC,CAAC,KAAa,EAAE,QAAgB,EAAiB,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;KACvF,CAAA;IAED,IAAI,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC5E,MAAM,kBAAkB,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAE,CAAA;QACvE,MAAM,MAAM,GAAG,MAAO,OAAiC,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAA;QAC/E,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,kCAAkC;aAC1C;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC5D,CAAC;QAAC,YAAY,CAAC,QAAsB,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAA;QACtE,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QACrD,MAAM,MAAM,GAAG,MAAO,OAAiC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;QAC3E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAClC,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,CAAA;QAC1C,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC/D,CAAC;QAAC,YAAY,CAAC,QAAsB,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAA;QAC3E,KAAK,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,mBAAmB,CAAC;YAC9D,MAAM,EAAE,iBAAiB;YACzB,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,cAAc;SACxB,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAC9C,MAAM,MAAM,GAAG,MAAO,OAAiC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;QAC3E,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAA;IAClC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QACjE,CAAC;QAAC,YAAY,CAAC,QAAsB,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAA;QAC3E,KAAK,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,mBAAmB,CAAC;YAC9D,MAAM,EAAE,mBAAmB;YAC3B,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,aAAa;SACvB,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAC9C,MAAM,MAAM,GAAG,MAAO,OAAiC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;QAC3E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,CAAA;QAC1C,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAChE,CAAC;QAAC,YAAY,CAAC,QAAsB,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAA;QAC3E,KAAK,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,mBAAmB,CAAC;YAC9D,MAAM,EAAE,kBAAkB;YAC1B,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,CAAC;YACb,OAAO,EAAE,aAAa;SACvB,CAAC,CAAA;QACF,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAA;QAC9C,MAAM,MAAM,GAAG,MAAO,OAAiC,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;QAC3E,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,eAAe,EAAE,CAAA;QAC1C,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;IAChF,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tools/response-builders.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Shared utilities for building tool response objects
+ * Eliminates duplication across 20+ tool files
+ */
+import type { ToolResponse } from '../tool';
+/**
+ * Create a successful tool response
+ *
+ * @param value - The response value (string or JSON string)
+ * @param type - Response type ('text' or 'json')
+ * @returns A successful tool response object
+ *
+ * @example
+ * ```ts
+ * return createSuccessResponse('File content loaded')
+ * return createSuccessResponse(JSON.stringify(data), 'json')
+ * ```
+ */
+export declare function createSuccessResponse(value: string, type?: 'text' | 'json'): ToolResponse;
+/**
+ * Create an error tool response
+ *
+ * @param message - The error message
+ * @returns An error tool response object
+ *
+ * @example
+ * ```ts
+ * return createErrorResponse('Failed to read file')
+ * ```
+ */
+export declare function createErrorResponse(message: string): ToolResponse;
+/**
+ * Create a provider capability error response
+ * Use this when a required provider capability is not available
+ *
+ * @param capability - The capability that's missing (e.g., "read file", "write file")
+ * @returns An error response indicating the missing capability
+ *
+ * @example
+ * ```ts
+ * if (!provider.readFile) {
+ *   return createProviderErrorResponse('read file')
+ * }
+ * ```
+ */
+export declare function createProviderErrorResponse(capability: string): ToolResponse;
+/**
+ * Create a validation error response
+ * Use this when input validation fails
+ *
+ * @param errors - The validation error details
+ * @returns An error response with validation details
+ *
+ * @example
+ * ```ts
+ * const result = schema.safeParse(input)
+ * if (!result.success) {
+ *   return createValidationErrorResponse(result.error)
+ * }
+ * ```
+ */
+export declare function createValidationErrorResponse(errors: {
+    message: string;
+}): ToolResponse;

package/dist/tools/response-builders.js

@@ -0,0 +1,88 @@
+/**
+ * Shared utilities for building tool response objects
+ * Eliminates duplication across 20+ tool files
+ */
+/**
+ * Create a successful tool response
+ *
+ * @param value - The response value (string or JSON string)
+ * @param type - Response type ('text' or 'json')
+ * @returns A successful tool response object
+ *
+ * @example
+ * ```ts
+ * return createSuccessResponse('File content loaded')
+ * return createSuccessResponse(JSON.stringify(data), 'json')
+ * ```
+ */
+export function createSuccessResponse(value, type = 'text') {
+    return {
+        success: true,
+        message: { type, value },
+    };
+}
+/**
+ * Create an error tool response
+ *
+ * @param message - The error message
+ * @returns An error tool response object
+ *
+ * @example
+ * ```ts
+ * return createErrorResponse('Failed to read file')
+ * ```
+ */
+export function createErrorResponse(message) {
+    return {
+        success: false,
+        message: { type: 'error-text', value: message },
+    };
+}
+/**
+ * Create a provider capability error response
+ * Use this when a required provider capability is not available
+ *
+ * @param capability - The capability that's missing (e.g., "read file", "write file")
+ * @returns An error response indicating the missing capability
+ *
+ * @example
+ * ```ts
+ * if (!provider.readFile) {
+ *   return createProviderErrorResponse('read file')
+ * }
+ * ```
+ */
+export function createProviderErrorResponse(capability) {
+    return {
+        success: false,
+        message: {
+            type: 'error-text',
+            value: `Not possible to ${capability}.`,
+        },
+    };
+}
+/**
+ * Create a validation error response
+ * Use this when input validation fails
+ *
+ * @param errors - The validation error details
+ * @returns An error response with validation details
+ *
+ * @example
+ * ```ts
+ * const result = schema.safeParse(input)
+ * if (!result.success) {
+ *   return createValidationErrorResponse(result.error)
+ * }
+ * ```
+ */
+export function createValidationErrorResponse(errors) {
+    return {
+        success: false,
+        message: {
+            type: 'error-text',
+            value: `Validation failed: ${errors.message}`,
+        },
+    };
+}
+//# sourceMappingURL=response-builders.js.map

package/dist/tools/response-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builders.js","sourceRoot":"","sources":["../../src/tools/response-builders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,OAAwB,MAAM;IACjF,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE;KACzB,CAAA;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE;KAChD,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAAC,UAAkB;IAC5D,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO,EAAE;YACP,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,mBAAmB,UAAU,GAAG;SACxC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAA2B;IACvE,OAAO;QACL,OAAO,EAAE,KAAK;QACd,OAAO,EAAE;YACP,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,sBAAsB,MAAM,CAAC,OAAO,EAAE;SAC9C;KACF,CAAA;AACH,CAAC"}