@polka-codes/core 0.10.13 → 0.10.17

package/dist/tools/askFollowupQuestion.js

@@ -0,0 +1,105 @@
+import { z } from 'zod';
+const questionObject = z.object({
+    prompt: z.string().describe('The text of the question.').meta({ usageValue: 'question text here' }),
+    options: z
+        .array(z.string())
+        .default([])
+        .describe('Ordered list of suggested answers (omit if none).')
+        .meta({ usageValue: 'suggested answer here' }),
+});
+export const toolInfo = {
+    name: 'askFollowupQuestion',
+    description: 'Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.',
+    parameters: z
+        .object({
+        questions: z
+            .array(questionObject)
+            .describe('One or more follow-up questions you need answered before you can continue.')
+            .meta({ usageValue: 'questions here' }),
+    })
+        .meta({
+        examples: [
+            {
+                description: 'Single clarifying question (no options)',
+                input: {
+                    questions: [{ prompt: 'What is the target deployment environment?' }],
+                },
+            },
+            {
+                description: 'Single question with multiple-choice options',
+                input: {
+                    questions: [
+                        {
+                            prompt: 'Which frontend framework are you using?',
+                            options: ['React', 'Angular', 'Vue', 'Svelte'],
+                        },
+                    ],
+                },
+            },
+            {
+                description: 'Two related questions in one call',
+                input: {
+                    questions: [
+                        { prompt: 'What type of application are you building?' },
+                        {
+                            prompt: 'Preferred programming language?',
+                            options: ['JavaScript', 'TypeScript', 'Python', 'Java'],
+                        },
+                    ],
+                },
+            },
+            {
+                description: 'Binary (yes/no) confirmation',
+                input: {
+                    questions: [
+                        {
+                            prompt: 'Is it acceptable to refactor existing tests to improve performance?',
+                            options: ['Yes', 'No'],
+                        },
+                    ],
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.askFollowupQuestion) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'Not possible to ask followup question.',
+            },
+        };
+    }
+    const { questions } = toolInfo.parameters.parse(args);
+    if (questions.length === 0) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'No questions provided',
+            },
+        };
+    }
+    const answers = [];
+    for (const question of questions) {
+        const { prompt, options } = question;
+        const answer = await provider.askFollowupQuestion(prompt, options);
+        answers.push(`<ask_followup_question_answer question="${prompt}">
+${answer}
+</ask_followup_question_answer>`);
+    }
+    return {
+        success: true,
+        message: {
+            type: 'text',
+            value: answers.join('\n'),
+        },
+    };
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=askFollowupQuestion.js.map

package/dist/tools/askFollowupQuestion.js.map

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

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

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

package/dist/tools/askFollowupQuestion.test.js

@@ -0,0 +1,80 @@
+import { describe, expect, it, spyOn } from 'bun:test';
+import askFollowupQuestion from './askFollowupQuestion';
+import { MockProvider } from './provider';
+describe('askFollowupQuestion', () => {
+    it('should return the correct response', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'askFollowupQuestion').mockResolvedValue('Test response');
+        const result = await askFollowupQuestion.handler(mockProvider, {
+            questions: [
+                {
+                    prompt: 'Test question',
+                    options: ['option1', 'option2'],
+                },
+            ],
+        });
+        expect(result).toMatchSnapshot();
+    });
+    it('should handle errors', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'askFollowupQuestion').mockRejectedValue(new Error('Test error'));
+        await expect(askFollowupQuestion.handler(mockProvider, {
+            questions: [
+                {
+                    prompt: 'Test question',
+                    options: ['option1', 'option2'],
+                },
+            ],
+        })).rejects.toMatchSnapshot();
+    });
+    it('should handle multiple questions', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'askFollowupQuestion').mockResolvedValue('Answer1|Answer2');
+        const result = await askFollowupQuestion.handler(mockProvider, {
+            questions: [
+                {
+                    prompt: 'First question?',
+                    options: ['A', 'B'],
+                },
+                {
+                    prompt: 'Second question?',
+                    options: ['X', 'Y'],
+                },
+            ],
+        });
+        expect(result).toMatchSnapshot();
+    });
+    it('should handle questions without options', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'askFollowupQuestion').mockResolvedValue('Free text answer');
+        const result = await askFollowupQuestion.handler(mockProvider, {
+            questions: [
+                {
+                    prompt: 'Open-ended question',
+                },
+            ],
+        });
+        expect(result).toMatchSnapshot();
+    });
+    it('should handle empty options array', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'askFollowupQuestion').mockResolvedValue('Fallback answer');
+        const result = await askFollowupQuestion.handler(mockProvider, {
+            questions: [
+                {
+                    prompt: 'Question with empty options',
+                    options: [],
+                },
+            ],
+        });
+        expect(result).toMatchSnapshot();
+    });
+    it('should validate required parameters', async () => {
+        const mockProvider = new MockProvider();
+        await expect(askFollowupQuestion.handler(mockProvider, {})).rejects.toMatchSnapshot();
+        await expect(askFollowupQuestion.handler(mockProvider, {
+            questions: [{}],
+        })).rejects.toMatchSnapshot();
+    });
+});
+//# sourceMappingURL=askFollowupQuestion.test.js.map

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

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

package/dist/tools/executeCommand.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../tool';
+import type { CommandProvider } from './provider';
+export declare const toolInfo: {
+    readonly name: "executeCommand";
+    readonly description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.";
+    readonly parameters: z.ZodObject<{
+        command: z.ZodString;
+        requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, CommandProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "executeCommand";
+        readonly description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.";
+        readonly parameters: z.ZodObject<{
+            command: z.ZodString;
+            requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        }, z.core.$strip>;
+    }, CommandProvider>;
+    name: "executeCommand";
+    description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.";
+    parameters: z.ZodObject<{
+        command: z.ZodString;
+        requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/executeCommand.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { createProviderError, preprocessBoolean } from './utils';
+export const toolInfo = {
+    name: 'executeCommand',
+    description: 'Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.',
+    parameters: z
+        .object({
+        command: z
+            .string()
+            .describe('The exact command to run  (valid for the current OS). It must be correctly formatted and free of harmful instructions.')
+            .meta({ usageValue: 'your-command-here' }),
+        requiresApproval: z
+            .preprocess(preprocessBoolean, z.boolean().optional().default(false))
+            .describe('Set to `true` for commands that install/uninstall software, modify or delete files, change system settings, perform network operations, or have other side effects. Use `false` for safe, read-only, or purely local development actions (e.g., listing files, make a build, running tests).')
+            .meta({ usageValue: 'true | false' }),
+    })
+        .meta({
+        examples: [
+            {
+                description: 'Make a build',
+                input: {
+                    command: 'npm run build',
+                    requiresApproval: 'false',
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.executeCommand) {
+        return createProviderError('execute command. Abort');
+    }
+    const { command, requiresApproval } = toolInfo.parameters.parse(args);
+    try {
+        const result = await provider.executeCommand(command, requiresApproval);
+        let message = `<command>${command}</command>
+<command_exit_code>${result.exitCode}</command_exit_code>
+`;
+        if (result.summary) {
+            message += `<command_output_summary>\n${result.summary}\n</command_output_summary>\n`;
+        }
+        else {
+            message += `<command_stdout>
+${result.stdout}
+</command_stdout>
+<command_stderr>
+${result.stderr}
+</command_stderr>
+`;
+        }
+        if (result.exitCode === 0) {
+            return {
+                success: true,
+                message: {
+                    type: 'text',
+                    value: message,
+                },
+            };
+        }
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: message,
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: error instanceof Error ? error.message : String(error),
+            },
+        };
+    }
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=executeCommand.js.map

package/dist/tools/executeCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeCommand.js","sourceRoot":"","sources":["../../src/tools/executeCommand.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,gBAAgB;IACtB,WAAW,EACT,oUAAoU;IAEtU,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CAAC,wHAAwH,CAAC;aAClI,IAAI,CAAC,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;QAC5C,gBAAgB,EAAE,CAAC;aAChB,UAAU,CAAC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aACpE,QAAQ,CACP,8RAA8R,CAC/R;aACA,IAAI,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC;KACxC,CAAC;SACD,IAAI,CAAC;QACJ,QAAQ,EAAE;YACR;gBACE,WAAW,EAAE,cAAc;gBAC3B,KAAK,EAAE;oBACL,OAAO,EAAE,eAAe;oBACxB,gBAAgB,EAAE,OAAO;iBAC1B;aACF;SACF;KACF,CAAC;CACuB,CAAA;AAE7B,MAAM,CAAC,MAAM,OAAO,GAAkD,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;IAC7F,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC7B,OAAO,mBAAmB,CAAC,wBAAwB,CAAC,CAAA;IACtD,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACrE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;QACvE,IAAI,OAAO,GAAG,YAAY,OAAO;qBAChB,MAAM,CAAC,QAAQ;CACnC,CAAA;QACG,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,IAAI,6BAA6B,MAAM,CAAC,OAAO,+BAA+B,CAAA;QACvF,CAAC;aAAM,CAAC;YACN,OAAO,IAAI;EACf,MAAM,CAAC,MAAM;;;EAGb,MAAM,CAAC,MAAM;;CAEd,CAAA;QACG,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,OAAO;iBACf;aACF,CAAA;QACH,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,OAAO;aACf;SACF,CAAA;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D;SACF,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED,eAAe;IACb,GAAG,QAAQ;IACX,OAAO;CACe,CAAA"}

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

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

package/dist/tools/executeCommand.test.js

@@ -0,0 +1,60 @@
+import { describe, expect, it, spyOn } from 'bun:test';
+import executeCommand from './executeCommand';
+import { MockProvider } from './provider';
+describe('executeCommand', () => {
+    it('should execute command successfully', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'executeCommand').mockResolvedValue({
+            stdout: 'Command output',
+            stderr: 'stderr',
+            exitCode: 0,
+        });
+        const result = await executeCommand.handler(mockProvider, {
+            command: 'echo test',
+            requiresApproval: 'false',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.executeCommand).toHaveBeenCalledWith('echo test', false);
+    });
+    it('should handle command errors', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'executeCommand').mockRejectedValue(new Error('Command failed'));
+        const result = executeCommand.handler(mockProvider, {
+            command: 'invalid-command',
+            requiresApproval: 'false',
+        });
+        // The handler now catches the error and returns a ToolResponseError
+        const toolResponse = await result;
+        expect(toolResponse).toMatchSnapshot();
+        expect(mockProvider.executeCommand).toHaveBeenCalledWith('invalid-command', false);
+    });
+    it('should handle command with non-zero exit code', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'executeCommand').mockResolvedValue({
+            stdout: 'Command output',
+            stderr: 'stderr',
+            exitCode: 1,
+        });
+        const result = await executeCommand.handler(mockProvider, {
+            command: 'invalid-command',
+            requiresApproval: 'false',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.executeCommand).toHaveBeenCalledWith('invalid-command', false);
+    });
+    it('should handle approval required', async () => {
+        const mockProvider = new MockProvider();
+        spyOn(mockProvider, 'executeCommand').mockResolvedValue({
+            stdout: 'Approved command',
+            stderr: 'stderr',
+            exitCode: 0,
+        });
+        const result = await executeCommand.handler(mockProvider, {
+            command: 'rm -rf /',
+            requiresApproval: 'true',
+        });
+        expect(result).toMatchSnapshot();
+        expect(mockProvider.executeCommand).toHaveBeenCalledWith('rm -rf /', true);
+    });
+});
+//# sourceMappingURL=executeCommand.test.js.map

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

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

package/dist/tools/fetchUrl.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+import type { ToolHandler } from '../tool';
+import type { WebProvider } from './provider';
+export declare const toolInfo: {
+    readonly name: "fetchUrl";
+    readonly description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.";
+    readonly parameters: z.ZodObject<{
+        url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, WebProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "fetchUrl";
+        readonly description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.";
+        readonly parameters: z.ZodObject<{
+            url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>;
+    }, WebProvider>;
+    name: "fetchUrl";
+    description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.";
+    parameters: z.ZodObject<{
+        url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/fetchUrl.js

@@ -0,0 +1,85 @@
+// generated by polka.codes
+import { z } from 'zod';
+export const toolInfo = {
+    name: 'fetchUrl',
+    description: 'Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.',
+    parameters: z
+        .object({
+        url: z
+            .preprocess((val) => {
+            if (!val)
+                return [];
+            const values = Array.isArray(val) ? val : [val];
+            return values.flatMap((i) => (typeof i === 'string' ? i.split(',') : [])).filter((s) => s.length > 0);
+        }, z.array(z.string()))
+            .describe('One or more URLs to fetch, separated by commas if multiple.')
+            .meta({ usageValue: 'url' }),
+    })
+        .meta({
+        examples: [
+            {
+                description: 'Fetch a single webpage',
+                input: {
+                    url: 'https://example.com',
+                },
+            },
+            {
+                description: 'Fetch multiple webpages',
+                input: {
+                    url: 'https://example.com,https://developer.mozilla.org/en-US/docs/Web/HTTP',
+                },
+            },
+            {
+                description: 'Fetch a raw file from GitHub',
+                input: {
+                    url: 'https://raw.githubusercontent.com/user/repo/main/README.md',
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.fetchUrl) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'Not possible to fetch url.',
+            },
+        };
+    }
+    const { url: urls } = toolInfo.parameters.parse(args);
+    if (urls.length === 0) {
+        return {
+            success: false,
+            message: {
+                type: 'error-text',
+                value: 'No URLs provided. Please provide at least one URL to fetch.',
+            },
+        };
+    }
+    const results = [];
+    for (const url of urls) {
+        try {
+            const content = provider.fetchUrl(url).then((res) => `<fetch_url_content url="${url}">${res}</fetch_url_content>`);
+            results.push(content);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            results.push(Promise.resolve(`<fetch_url_error url="${url}">${errorMessage}</fetch_url_error>`));
+        }
+    }
+    const resolvedResults = await Promise.all(results);
+    return {
+        success: true,
+        message: {
+            type: 'text',
+            value: resolvedResults.join('\n'),
+        },
+    };
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=fetchUrl.js.map

package/dist/tools/fetchUrl.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,15 @@
+export { default as askFollowupQuestion } from './askFollowupQuestion';
+export { default as executeCommand } from './executeCommand';
+export { default as fetchUrl } from './fetchUrl';
+export { default as listFiles } from './listFiles';
+export * from './provider';
+export { default as readBinaryFile } from './readBinaryFile';
+export { default as readFile } from './readFile';
+export { default as removeFile } from './removeFile';
+export { default as renameFile } from './renameFile';
+export { default as replaceInFile } from './replaceInFile';
+export { createErrorResponse, createProviderErrorResponse, createSuccessResponse, createValidationErrorResponse, } from './response-builders';
+export { default as search } from './search';
+export { default as searchFiles } from './searchFiles';
+export * from './todo';
+export { default as writeToFile } from './writeToFile';

package/dist/tools/index.js

@@ -0,0 +1,17 @@
+// generated by polka.codes
+export { default as askFollowupQuestion } from './askFollowupQuestion';
+export { default as executeCommand } from './executeCommand';
+export { default as fetchUrl } from './fetchUrl';
+export { default as listFiles } from './listFiles';
+export * from './provider';
+export { default as readBinaryFile } from './readBinaryFile';
+export { default as readFile } from './readFile';
+export { default as removeFile } from './removeFile';
+export { default as renameFile } from './renameFile';
+export { default as replaceInFile } from './replaceInFile';
+export { createErrorResponse, createProviderErrorResponse, createSuccessResponse, createValidationErrorResponse, } from './response-builders';
+export { default as search } from './search';
+export { default as searchFiles } from './searchFiles';
+export * from './todo';
+export { default as writeToFile } from './writeToFile';
+//# 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,2BAA2B;AAE3B,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AACtE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAA;AAElD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EACL,mBAAmB,EACnB,2BAA2B,EAC3B,qBAAqB,EACrB,6BAA6B,GAC9B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA;AACtD,cAAc,QAAQ,CAAA;AACtB,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAA"}

package/dist/tools/listFiles.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: "listFiles";
+    readonly description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodString;
+        maxCount: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+    }, z.core.$strip>;
+};
+export declare const handler: ToolHandler<typeof toolInfo, FilesystemProvider>;
+declare const _default: {
+    handler: ToolHandler<{
+        readonly name: "listFiles";
+        readonly description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.";
+        readonly parameters: z.ZodObject<{
+            path: z.ZodString;
+            maxCount: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+            recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+            includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        }, z.core.$strip>;
+    }, FilesystemProvider>;
+    name: "listFiles";
+    description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.";
+    parameters: z.ZodObject<{
+        path: z.ZodString;
+        maxCount: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+        recursive: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+    }, z.core.$strip>;
+};
+export default _default;

package/dist/tools/listFiles.js

@@ -0,0 +1,61 @@
+import { z } from 'zod';
+import { createProviderError, preprocessBoolean } from './utils';
+export const toolInfo = {
+    name: 'listFiles',
+    description: 'Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.',
+    parameters: z
+        .object({
+        path: z
+            .string()
+            .describe('The path of the directory to list contents for (relative to the current working directory)')
+            .meta({ usageValue: 'Directory path here' }),
+        maxCount: z.coerce
+            .number()
+            .optional()
+            .default(2000)
+            .describe('The maximum number of files to list. Default to 2000')
+            .meta({ usageValue: 'Maximum number of files to list (optional)' }),
+        recursive: z
+            .preprocess(preprocessBoolean, z.boolean().optional().default(true))
+            .describe('Whether to list files recursively. Use true for recursive listing, false or omit for top-level only.')
+            .meta({ usageValue: 'true or false (optional)' }),
+        includeIgnored: z
+            .preprocess(preprocessBoolean, z.boolean().optional().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 list files',
+                input: {
+                    path: 'src',
+                    maxCount: '100',
+                },
+            },
+        ],
+    }),
+};
+export const handler = async (provider, args) => {
+    if (!provider.listFiles) {
+        return createProviderError('list files');
+    }
+    const { path, maxCount, recursive, includeIgnored } = toolInfo.parameters.parse(args);
+    const [files, limitReached] = await provider.listFiles(path, recursive, maxCount, includeIgnored);
+    return {
+        success: true,
+        message: {
+            type: 'text',
+            value: `<list_files_path>${path}</list_files_path>
+<list_files_files>
+${files.join('\n')}
+</list_files_files>
+<list_files_truncated>${limitReached}</list_files_truncated>`,
+        },
+    };
+};
+export default {
+    ...toolInfo,
+    handler,
+};
+//# sourceMappingURL=listFiles.js.map