@polka-codes/core 0.10.11 → 0.10.16

package/dist/tools/listFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listFiles.js","sourceRoot":"","sources":["../../src/tools/listFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhE,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,WAAW;IACjB,WAAW,EACT,4XAA4X;IAC9X,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,IAAI,EAAE,CAAC;aACJ,MAAM,EAAE;aACR,QAAQ,CAAC,4FAA4F,CAAC;aACtG,IAAI,CAAC,EAAE,UAAU,EAAE,qBAAqB,EAAE,CAAC;QAC9C,QAAQ,EAAE,CAAC,CAAC,MAAM;aACf,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,OAAO,CAAC,IAAI,CAAC;aACb,QAAQ,CAAC,sDAAsD,CAAC;aAChE,IAAI,CAAC,EAAE,UAAU,EAAE,4CAA4C,EAAE,CAAC;QACrE,SAAS,EAAE,CAAC;aACT,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;aACnE,QAAQ,CAAC,sGAAsG,CAAC;aAChH,IAAI,CAAC,EAAE,UAAU,EAAE,0BAA0B,EAAE,CAAC;QACnD,cAAc,EAAE,CAAC;aACd,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aACpE,QAAQ,CAAC,oFAAoF,CAAC;aAC9F,IAAI,CAAC,EAAE,UAAU,EAAE,0BAA0B,EAAE,CAAC;KACpD,CAAC;SACD,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR;gBACE,WAAW,EAAE,uBAAuB;gBACpC,KAAK,EAAE;oBACL,IAAI,EAAE,KAAK;oBACX,QAAQ,EAAE,KAAK;iBAChB;aACF;SACF;KACF,CAAC;CACuB,CAAA;AAE7B,MAAM,CAAC,MAAM,OAAO,GAAqD,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAChG,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QACxB,OAAO,mBAAmB,CAAC,YAAY,CAAC,CAAA;IAC1C,CAAC;IAED,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrF,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAA;IAEjG,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,oBAAoB,IAAI;;EAEnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;wBAEM,YAAY,yBAAyB;SACxD;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe;IACb,GAAG,QAAQ;IACX,OAAO;CACe,CAAA"}

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

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

package/dist/tools/listFiles.test.js

@@ -0,0 +1,59 @@
+import { describe, expect, it, spyOn } from 'bun:test';
+import listFiles from './listFiles';
+import { MockProvider } from './provider';
+describe('listFiles', () => {
+    it('should return file list', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'listFiles').mockResolvedValue([['file1.ts', 'file2.ts'], false]);
+        const result = await listFiles.handler(mockProvider, {
+            path: 'src',
+            maxCount: '10',
+            includeIgnored: 'false',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.listFiles).toHaveBeenCalledWith('src', true, 10, false);
+    });
+    it('should handle non recursive listing', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'listFiles').mockResolvedValue([['file1.ts', 'file2.ts'], false]);
+        const result = await listFiles.handler(mockProvider, {
+            path: 'src',
+            recursive: 'false',
+            includeIgnored: 'false',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.listFiles).toHaveBeenCalledWith('src', false, 2000, false);
+    });
+    it('should handle empty directory', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'listFiles').mockResolvedValue([[], true]);
+        const result = await listFiles.handler(mockProvider, {
+            path: 'empty-dir',
+            includeIgnored: 'false',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.listFiles).toHaveBeenCalledWith('empty-dir', true, 2000, false);
+    });
+    it('should handle max count with truncation', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'listFiles').mockResolvedValue([['file1.ts', 'file2.ts'], true]);
+        const result = await listFiles.handler(mockProvider, {
+            path: 'src',
+            maxCount: '1',
+            includeIgnored: 'false',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.listFiles).toHaveBeenCalledWith('src', true, 1, false);
+    });
+    it('should handle errors', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'listFiles').mockRejectedValue(new Error('Directory not found'));
+        const result = listFiles.handler(mockProvider, {
+            path: 'invalid-path',
+            includeIgnored: 'false',
+        });
+        await expect(result).rejects.toMatchSnapshot();
+        expect(mockProvider.listFiles).toHaveBeenCalledWith('invalid-path', true, 2000, false);
+    });
+});
+//# sourceMappingURL=listFiles.test.js.map

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

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

package/dist/tools/provider.d.ts

@@ -0,0 +1,76 @@
+import type { TodoItem, UpdateTodoItemInput, UpdateTodoItemOutput } from './todo';
+export type FilesystemProvider = {
+    readFile?: (path: string, includeIgnored: boolean) => Promise<string | undefined>;
+    writeFile?: (path: string, content: string) => Promise<void>;
+    fileExists?: (path: string) => Promise<boolean>;
+    removeFile?: (path: string) => Promise<void>;
+    renameFile?: (sourcePath: string, targetPath: string) => Promise<void>;
+    listFiles?: (path: string, recursive: boolean, maxCount: number, includeIgnored: boolean) => Promise<[string[], boolean]>;
+    searchFiles?: (path: string, regex: string, filePattern: string) => Promise<string[]>;
+    readBinaryFile?: (url: string) => Promise<{
+        base64Data: string;
+        mediaType: string;
+    }>;
+};
+export type CommandProvider = {
+    executeCommand?: (command: string, needApprove: boolean) => Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+        summary?: string;
+    }>;
+};
+export type InteractionProvider = {
+    askFollowupQuestion?: (question: string, options: string[]) => Promise<string>;
+};
+export type WebProvider = {
+    fetchUrl?: (url: string) => Promise<string>;
+    search?: (query: string) => Promise<string>;
+};
+export interface MemoryProvider {
+    listMemoryTopics: () => Promise<string[]>;
+    readMemory: (topic?: string) => Promise<string | undefined>;
+    updateMemory: (operation: 'append' | 'replace' | 'remove', topic: string | undefined, content: string | undefined) => Promise<void>;
+}
+export type ListTodoItemsOutput = TodoItem[];
+export type GetTodoItemOutput = TodoItem & {
+    subItems: {
+        id: string;
+        title: string;
+    }[];
+};
+export type TodoProvider = {
+    listTodoItems: (id?: string | null, status?: string | null) => Promise<ListTodoItemsOutput>;
+    getTodoItem: (id: string) => Promise<GetTodoItemOutput | undefined>;
+    updateTodoItem: (input: UpdateTodoItemInput) => Promise<UpdateTodoItemOutput>;
+};
+export type ToolProvider = FilesystemProvider & CommandProvider & InteractionProvider & WebProvider & Partial<MemoryProvider> & Partial<TodoProvider>;
+export declare class MockProvider implements ToolProvider {
+    listTodoItems(id?: string | null, _status?: string | null): Promise<{
+        id: string;
+        title: string;
+        status: "open";
+        description: string;
+    }[]>;
+    getTodoItem(id: string): Promise<GetTodoItemOutput | undefined>;
+    updateTodoItem(input: UpdateTodoItemInput): Promise<{
+        id: string;
+    }>;
+    readFile(_path: string, _includeIgnored?: boolean): Promise<string>;
+    writeFile(_path: string, _content: string): Promise<void>;
+    removeFile(_path: string): Promise<void>;
+    renameFile(_sourcePath: string, _targetPath: string): Promise<void>;
+    listFiles(_path: string, _recursive: boolean, _maxCount: number, _includeIgnored?: boolean): Promise<[string[], boolean]>;
+    searchFiles(_path: string, _regex: string, _filePattern: string): Promise<string[]>;
+    executeCommand(_command: string, _needApprove: boolean): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+        summary?: string;
+    }>;
+    askFollowupQuestion(_question: string, _options?: string[]): Promise<string>;
+    search(_query: string): Promise<string>;
+    listMemoryTopics(): Promise<string[]>;
+    readMemory(_topic?: string): Promise<string | undefined>;
+    updateMemory(_operation: 'append' | 'replace' | 'remove', _topic?: string, _content?: string): Promise<void>;
+}

package/dist/tools/provider.js

@@ -0,0 +1,60 @@
+export class MockProvider {
+    async listTodoItems(id, _status) {
+        if (id) {
+            return [{ id: `${id}-1`, title: 'mock sub item', status: 'open', description: '' }];
+        }
+        return [{ id: '1', title: 'mock item', status: 'open', description: '' }];
+    }
+    async getTodoItem(id) {
+        return {
+            id,
+            title: 'mock item',
+            description: 'mock desc',
+            status: 'open',
+            subItems: [],
+        };
+    }
+    async updateTodoItem(input) {
+        if (input.operation === 'add') {
+            return { id: '2' };
+        }
+        return { id: input.id };
+    }
+    async readFile(_path, _includeIgnored) {
+        return 'mock content';
+    }
+    async writeFile(_path, _content) {
+        return;
+    }
+    async removeFile(_path) {
+        return;
+    }
+    async renameFile(_sourcePath, _targetPath) {
+        return;
+    }
+    async listFiles(_path, _recursive, _maxCount, _includeIgnored) {
+        return [['mock-file.txt'], false];
+    }
+    async searchFiles(_path, _regex, _filePattern) {
+        return ['mock-file.txt'];
+    }
+    async executeCommand(_command, _needApprove) {
+        return { stdout: 'mock output', stderr: '', exitCode: 0 };
+    }
+    async askFollowupQuestion(_question, _options) {
+        return 'mock answer';
+    }
+    async search(_query) {
+        return 'mock search result';
+    }
+    async listMemoryTopics() {
+        return ['default'];
+    }
+    async readMemory(_topic) {
+        return 'mock memory content';
+    }
+    async updateMemory(_operation, _topic, _content) {
+        return;
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/tools/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/tools/provider.ts"],"names":[],"mappings":"AA4DA,MAAM,OAAO,YAAY;IACvB,KAAK,CAAC,aAAa,CAAC,EAAkB,EAAE,OAAuB;QAC7D,IAAI,EAAE,EAAE,CAAC;YACP,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAe,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAA;QAC9F,CAAC;QACD,OAAO,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAe,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAA;IACpF,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,EAAU;QAC1B,OAAO;YACL,EAAE;YACF,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,WAAW;YACxB,MAAM,EAAE,MAAe;YACvB,QAAQ,EAAE,EAAE;SACb,CAAA;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,KAA0B;QAC7C,IAAI,KAAK,CAAC,SAAS,KAAK,KAAK,EAAE,CAAC;YAC9B,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,CAAA;QACpB,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAY,EAAE,CAAA;IACnC,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,KAAa,EAAE,eAAyB;QACrD,OAAO,cAAc,CAAA;IACvB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,QAAgB;QAC7C,OAAM;IACR,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa;QAC5B,OAAM;IACR,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,WAAmB,EAAE,WAAmB;QACvD,OAAM;IACR,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa,EAAE,UAAmB,EAAE,SAAiB,EAAE,eAAyB;QAC9F,OAAO,CAAC,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,KAAa,EAAE,MAAc,EAAE,YAAoB;QACnE,OAAO,CAAC,eAAe,CAAC,CAAA;IAC1B,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,QAAgB,EAChB,YAAqB;QAErB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IAC3D,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,SAAiB,EAAE,QAAmB;QAC9D,OAAO,aAAa,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,OAAO,oBAAoB,CAAA;IAC7B,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,CAAC,SAAS,CAAC,CAAA;IACpB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAe;QAC9B,OAAO,qBAAqB,CAAA;IAC9B,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,UAA2C,EAAE,MAAe,EAAE,QAAiB;QAChG,OAAM;IACR,CAAC;CACF"}

package/dist/tools/readBinaryFile.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../tool';
+import type { FilesystemProvider } from './provider';
+export declare const toolInfo: {
+    readonly name: "readBinaryFile";
+    readonly description: "Read a binary file from a URL or local path. Use file:// prefix to access local files. This can be used to access non-text files such as PDFs or images.";
+    readonly parameters: z.ZodObject<{
+        url: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, FilesystemProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "readBinaryFile";
+        readonly description: "Read a binary file from a URL or local path. Use file:// prefix to access local files. This can be used to access non-text files such as PDFs or images.";
+        readonly parameters: z.ZodObject<{
+            url: z.ZodString;
+        }, z.core.$strip>;
+    }, FilesystemProvider>;
+    name: "readBinaryFile";
+    description: "Read a binary file from a URL or local path. Use file:// prefix to access local files. This can be used to access non-text files such as PDFs or images.";
+    parameters: z.ZodObject<{
+        url: z.ZodString;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/readBinaryFile.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+export const toolInfo = {
+    name: 'readBinaryFile',
+    description: 'Read a binary file from a URL or local path. Use file:// prefix to access local files. This can be used to access non-text files such as PDFs or images.',
+    parameters: z.object({
+        url: z.string().describe('The URL or local path of the file to read.'),
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.readBinaryFile) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'Not possible to fetch files. Abort.',
+            },
+        };
+    }
+    const { url } = toolInfo.parameters.parse(args);
+    try {
+        const filePart = await provider.readBinaryFile(url);
+        return {
+            success: true,
+            message: {
+                type: 'content',
+                value: [
+                    {
+                        type: 'media',
+                        url,
+                        data: filePart.base64Data,
+                        mediaType: filePart.mediaType,
+                    },
+                ],
+            },
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: `Error fetching file from ${url}: ${errorMessage}`,
+            },
+        };
+    }
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=readBinaryFile.js.map

package/dist/tools/readBinaryFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readBinaryFile.js","sourceRoot":"","sources":["../../src/tools/readBinaryFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,gBAAgB;IACtB,WAAW,EACT,0JAA0J;IAC5J,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;QACnB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;KACvE,CAAC;CACyB,CAAA;AAE7B,MAAM,CAAC,MAAM,OAAO,GAAqD,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAChG,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC7B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,qCAAqC;aAC7C;SACF,CAAA;IACH,CAAC;IAED,MAAM,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAE/C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;QAEnD,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE;oBACL;wBACE,IAAI,EAAE,OAAO;wBACb,GAAG;wBACH,IAAI,EAAE,QAAQ,CAAC,UAAU;wBACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;qBAC9B;iBACF;aACF;SACF,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAA;QAC7E,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,4BAA4B,GAAG,KAAK,YAAY,EAAE;aAC1D;SACF,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED,eAAe;IACb,GAAG,QAAQ;IACX,OAAO;CACe,CAAA"}

package/dist/tools/readFile.d.ts

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../tool';
+import type { FilesystemProvider } from './provider';
+export declare const toolInfo: {
+    readonly name: "readFile";
+    readonly description: "Request to read the contents of one or multiple files at the specified paths.\n\nWhen to use:\n- Examining file contents you don't know\n- Analyzing code, reviewing text files, extracting configuration info\n- Reading multiple files at once (use comma-separated paths)\n- Understanding file structure before editing\n\nWhen NOT to use:\n- For file existence checks: Use listFiles instead\n- For searching within files: Use grep instead\n- For file name searches: Use searchFiles instead\n- Prefer this tool over executeCommand with cat/head/tail\n\nFeatures:\n- Supports comma-separated paths for multiple files\n- Line numbers included for easy reference\n- Optional offset/limit for partial file reading\n- Automatically handles different file types\n\nIMPORTANT:\n- Line numbers are included for easy reference\n- Use offset/limit for large files to read specific sections";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodPipe<z.ZodTransform<any[], unknown>, z.ZodArray<z.ZodString>>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>>;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, FilesystemProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "readFile";
+        readonly description: "Request to read the contents of one or multiple files at the specified paths.\n\nWhen to use:\n- Examining file contents you don't know\n- Analyzing code, reviewing text files, extracting configuration info\n- Reading multiple files at once (use comma-separated paths)\n- Understanding file structure before editing\n\nWhen NOT to use:\n- For file existence checks: Use listFiles instead\n- For searching within files: Use grep instead\n- For file name searches: Use searchFiles instead\n- Prefer this tool over executeCommand with cat/head/tail\n\nFeatures:\n- Supports comma-separated paths for multiple files\n- Line numbers included for easy reference\n- Optional offset/limit for partial file reading\n- Automatically handles different file types\n\nIMPORTANT:\n- Line numbers are included for easy reference\n- Use offset/limit for large files to read specific sections";
+        readonly parameters: z.ZodObject<{
+            path: z.ZodPipe<z.ZodTransform<any[], unknown>, z.ZodArray<z.ZodString>>;
+            offset: z.ZodOptional<z.ZodNumber>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>>;
+        }, z.core.$strip>;
+    }, FilesystemProvider>;
+    name: "readFile";
+    description: "Request to read the contents of one or multiple files at the specified paths.\n\nWhen to use:\n- Examining file contents you don't know\n- Analyzing code, reviewing text files, extracting configuration info\n- Reading multiple files at once (use comma-separated paths)\n- Understanding file structure before editing\n\nWhen NOT to use:\n- For file existence checks: Use listFiles instead\n- For searching within files: Use grep instead\n- For file name searches: Use searchFiles instead\n- Prefer this tool over executeCommand with cat/head/tail\n\nFeatures:\n- Supports comma-separated paths for multiple files\n- Line numbers included for easy reference\n- Optional offset/limit for partial file reading\n- Automatically handles different file types\n\nIMPORTANT:\n- Line numbers are included for easy reference\n- Use offset/limit for large files to read specific sections";
+    parameters: z.ZodObject<{
+        path: z.ZodPipe<z.ZodTransform<any[], unknown>, z.ZodArray<z.ZodString>>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>>>;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/readFile.js

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+import { createFileElement, createProviderError, preprocessBoolean } from './utils';
+export const toolInfo = {
+    name: 'readFile',
+    description: `Request to read the contents of one or multiple files at the specified paths.
+
+When to use:
+- Examining file contents you don't know
+- Analyzing code, reviewing text files, extracting configuration info
+- Reading multiple files at once (use comma-separated paths)
+- Understanding file structure before editing
+
+When NOT to use:
+- For file existence checks: Use listFiles instead
+- For searching within files: Use grep instead
+- For file name searches: Use searchFiles instead
+- Prefer this tool over executeCommand with cat/head/tail
+
+Features:
+- Supports comma-separated paths for multiple files
+- Line numbers included for easy reference
+- Optional offset/limit for partial file reading
+- Automatically handles different file types
+
+IMPORTANT:
+- Line numbers are included for easy reference
+- Use offset/limit for large files to read specific sections`,
+    parameters: z
+        .object({
+        path: z
+            .preprocess((val) => {
+            if (!val)
+                return [];
+            // Only split by comma if the input is a string
+            // If it's already an array, use it as-is to support files with commas in names
+            if (Array.isArray(val)) {
+                return val.filter((s) => typeof s === 'string' && s.length > 0);
+            }
+            // Single string input - split by comma for multiple files
+            return val.split(',').filter((s) => s.length > 0);
+        }, z.array(z.string()))
+            .describe('The path of the file to read')
+            .meta({ usageValue: 'Comma separated paths here' }),
+        offset: z.number().optional().describe('Skip first N lines (for partial file reading)').meta({ usageValue: '100' }),
+        limit: z.number().optional().describe('Read at most N lines (for partial file reading)').meta({ usageValue: '50' }),
+        includeIgnored: z
+            .preprocess(preprocessBoolean, z.boolean().nullish().default(false))
+            .describe('Whether to include ignored files. Use true to include files ignored by .gitignore.')
+            .meta({ usageValue: 'true or false (optional)' }),
+    })
+        .meta({
+        examples: [
+            {
+                description: 'Request to read the contents of a file',
+                input: {
+                    path: 'src/main.js',
+                },
+            },
+            {
+                description: 'Request to read multiple files',
+                input: {
+                    path: 'src/main.js,src/index.js',
+                },
+            },
+            {
+                description: 'Read partial file (lines 100-150)',
+                input: {
+                    path: 'src/large-file.ts',
+                    offset: 100,
+                    limit: 50,
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.readFile) {
+        return createProviderError('read file');
+    }
+    const parsed = toolInfo.parameters.safeParse(args);
+    if (!parsed.success) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: `Invalid arguments for readFile: ${parsed.error.message}`,
+            },
+        };
+    }
+    const { path: paths, offset, limit, includeIgnored } = parsed.data;
+    const resp = [];
+    for (const path of paths) {
+        const fileContent = await provider.readFile(path, includeIgnored ?? false);
+        if (!fileContent) {
+            resp.push(createFileElement('read_file_file_content', path, undefined, { file_not_found: 'true' }));
+            continue;
+        }
+        // Apply offset/limit if specified
+        let lines = fileContent.split('\n');
+        const start = offset ?? 0;
+        const end = limit ? start + limit : lines.length;
+        if (offset !== undefined || limit !== undefined) {
+            lines = lines.slice(start, end);
+        }
+        // Add line numbers
+        const lineOffset = offset ?? 0;
+        const numberedContent = lines
+            .map((line, i) => {
+            const lineNumber = lineOffset + i + 1;
+            const paddedNumber = String(lineNumber).padStart(6, ' ');
+            return `${paddedNumber}→${line}`;
+        })
+            .join('\n');
+        resp.push(createFileElement('read_file_file_content', path, numberedContent));
+    }
+    return {
+        success: true,
+        message: {
+            type: 'text',
+            value: resp.join('\n'),
+        },
+    };
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=readFile.js.map

package/dist/tools/readFile.js.map

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

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

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

package/dist/tools/readFile.test.js

@@ -0,0 +1,37 @@
+import { describe, expect, it, spyOn } from 'bun:test';
+import { MockProvider } from './provider';
+import readFile from './readFile';
+describe('readFile', () => {
+    it('should read single file', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'readFile').mockResolvedValue('file content');
+        const result = await readFile.handler(mockProvider, {
+            path: 'file.txt',
+            includeIgnored: 'false',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.readFile).toHaveBeenCalledWith('file.txt', false);
+    });
+    it('should read multiple files', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'readFile').mockResolvedValueOnce('file1 content').mockResolvedValueOnce('file2 content');
+        const result = await readFile.handler(mockProvider, {
+            path: 'file1.txt,file2.txt',
+            includeIgnored: 'false',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.readFile).toHaveBeenCalledWith('file1.txt', false);
+        expect(mockProvider.readFile).toHaveBeenCalledWith('file2.txt', false);
+    });
+    it('should handle file not found', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'readFile').mockRejectedValue(new Error('File not found'));
+        const result = readFile.handler(mockProvider, {
+            path: 'missing.txt',
+            includeIgnored: 'false',
+        });
+        await expect(result).rejects.toMatchSnapshot();
+        expect(mockProvider.readFile).toHaveBeenCalledWith('missing.txt', false);
+    });
+});
+//# sourceMappingURL=readFile.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readFile.test.js","sourceRoot":"","sources":["../../src/tools/readFile.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,QAAQ,MAAM,YAAY,CAAA;AAEjC,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,EAAE,CAAC,yBAAyB,EAAE,KAAK,IAAI,EAAE;QACvC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAA;QAEjE,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE;YAClD,IAAI,EAAE,UAAU;YAChB,cAAc,EAAE,OAAO;SACxB,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAA;QAChC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;QAC1C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAC,qBAAqB,CAAC,eAAe,CAAC,CAAA;QAE7G,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE;YAClD,IAAI,EAAE,qBAAqB;YAC3B,cAAc,EAAE,OAAO;SACxB,CAAC,CAAA;QAEF,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAA;QAChC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;QACtE,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,WAAW,EAAE,KAAK,CAAC,CAAA;IACxE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,8BAA8B,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;QACvC,KAAK,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAA;QAE9E,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE;YAC5C,IAAI,EAAE,aAAa;YACnB,cAAc,EAAE,OAAO;SACxB,CAAC,CAAA;QAEF,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,CAAA;QAC9C,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAA;IAC1E,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/tools/removeFile.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../tool';
+import type { FilesystemProvider } from './provider';
+export declare const toolInfo: {
+    readonly name: "removeFile";
+    readonly description: "Request to remove a file at the specified path.";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, FilesystemProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "removeFile";
+        readonly description: "Request to remove a file at the specified path.";
+        readonly parameters: z.ZodObject<{
+            path: z.ZodString;
+        }, z.core.$strip>;
+    }, FilesystemProvider>;
+    name: "removeFile";
+    description: "Request to remove a file at the specified path.";
+    parameters: z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/removeFile.js

@@ -0,0 +1,49 @@
+import { z } from 'zod';
+import { createProviderError } from './utils';
+export const toolInfo = {
+    name: 'removeFile',
+    description: 'Request to remove a file at the specified path.',
+    parameters: z
+        .object({
+        path: z.string().describe('The path of the file to remove').meta({ usageValue: 'File path here' }),
+    })
+        .meta({
+        examples: [
+            {
+                description: 'Request to remove a file',
+                input: {
+                    path: 'src/main.js',
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.removeFile) {
+        return createProviderError('remove file');
+    }
+    const parsed = toolInfo.parameters.safeParse(args);
+    if (!parsed.success) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: `Invalid arguments for removeFile: ${parsed.error.message}`,
+            },
+        };
+    }
+    const { path } = parsed.data;
+    await provider.removeFile(path);
+    return {
+        success: true,
+        message: {
+            type: 'text',
+            value: `<remove_file_path>${path}</remove_file_path><status>Success</status>`,
+        },
+    };
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=removeFile.js.map

package/dist/tools/removeFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"removeFile.js","sourceRoot":"","sources":["../../src/tools/removeFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAE7C,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,iDAAiD;IAC9D,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC;KACnG,CAAC;SACD,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR;gBACE,WAAW,EAAE,0BAA0B;gBACvC,KAAK,EAAE;oBACL,IAAI,EAAE,aAAa;iBACpB;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,mBAAmB,CAAC,aAAa,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,qCAAqC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE;aACnE;SACF,CAAA;IACH,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,IAAI,CAAA;IAE5B,MAAM,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;IAE/B,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,qBAAqB,IAAI,6CAA6C;SAC9E;KACF,CAAA;AACH,CAAC,CAAA;AAED,eAAe;IACb,GAAG,QAAQ;IACX,OAAO;CACe,CAAA"}

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

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

package/dist/tools/removeFile.test.js

@@ -0,0 +1,32 @@
+import { describe, expect, it, spyOn } from 'bun:test';
+import { MockProvider } from './provider';
+import removeFile from './removeFile';
+describe('removeFile', () => {
+    it('should remove file successfully', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'removeFile').mockResolvedValue();
+        const result = await removeFile.handler(mockProvider, {
+            path: 'test.txt',
+        });
+        // Verify successful removal
+        expect(result).toEqual({
+            success: true,
+            message: {
+                type: 'text',
+                value: '<remove_file_path>test.txt</remove_file_path><status>Success</status>',
+            },
+        });
+        expect(mockProvider.removeFile).toHaveBeenCalledWith('test.txt');
+    });
+    it('should handle remove errors', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'removeFile').mockRejectedValue(new Error('Remove error'));
+        const result = removeFile.handler(mockProvider, {
+            path: 'error.txt',
+        });
+        // Verify error is propagated
+        await expect(result).rejects.toThrow('Remove error');
+        expect(mockProvider.removeFile).toHaveBeenCalledWith('error.txt');
+    });
+});
+//# sourceMappingURL=removeFile.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removeFile.test.js","sourceRoot":"","sources":["../../src/tools/removeFile.test.ts"],"names":[],"mappings":"AAAA,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,IAAI,EAAE,UAAU;SACjB,CAAC,CAAA;QAEF,4BAA4B;QAC5B,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,OAAO,EAAE,IAAI;YACb,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,KAAK,EAAE,uEAAuE;aAC/E;SACF,CAAC,CAAA;QACF,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAA;IAClE,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,IAAI,EAAE,WAAW;SAClB,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,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}