@polka-codes/core 0.1.6 → 0.1.7

package/dist/tools/tools.js

@@ -1,329 +0,0 @@
-// source: https://github.com/cline/cline/blob/f6c19c29a64ca84e9360df7ab2c07d128dcebe64/src/core/prompts/system.ts#L1
-export const executeCommand = {
-    name: 'execute_command',
-    description: `Request to execute a CLI command on the system. Use this when you need to perform system operations or run specific commands to accomplish any step in the user's task. You must tailor your command to the user's system and provide a clear explanation of what the command does. Prefer to execute complex CLI commands over creating executable scripts, as they are more flexible and easier to run. Commands will be executed in the current working directory.`,
-    parameters: [
-        {
-            name: 'command',
-            description: 'The CLI command to execute. This should be valid for the current operating system. Ensure the command is properly formatted and does not contain any harmful instructions.',
-            required: true,
-            usageValue: 'Your command here',
-        },
-        {
-            name: 'requires_approval',
-            description: `A boolean indicating whether this command requires explicit user approval before execution in case the user has auto-approve mode enabled. Set to 'true' for potentially impactful operations like installing/uninstalling packages, deleting/overwriting files, system configuration changes, network operations, or any commands that could have unintended side effects. Set to 'false' for safe operations like reading files/directories, running development servers, building projects, and other non-destructive operations.`,
-            required: false,
-            usageValue: 'true or false',
-        },
-    ],
-    examples: [
-        {
-            description: 'Request to execute a command',
-            parameters: [
-                {
-                    name: 'command',
-                    value: 'npm run dev',
-                },
-                {
-                    name: 'requires_approval',
-                    value: 'false',
-                },
-            ],
-        },
-    ],
-};
-export const readFile = {
-    name: 'read_file',
-    description: 'Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string.',
-    parameters: [
-        {
-            name: 'path',
-            description: 'The path of the file to read',
-            required: true,
-            usageValue: 'Comma separated paths here',
-        },
-    ],
-    examples: [
-        {
-            description: 'Request to read the contents of a file',
-            parameters: [
-                {
-                    name: 'path',
-                    value: 'src/main.js',
-                },
-            ],
-        },
-        {
-            description: 'Request to read multiple files',
-            parameters: [
-                {
-                    name: 'path',
-                    value: 'src/main.js,src/index.js',
-                },
-            ],
-        },
-    ],
-};
-export const writeToFile = {
-    name: 'write_to_file',
-    description: "Request to write content to a file at the specified path. If the file exists, it will be overwritten with the provided content. If the file doesn't exist, it will be created. This tool will automatically create any directories needed to write the file.",
-    parameters: [
-        {
-            name: 'path',
-            description: 'The path of the file to write to',
-            required: true,
-            usageValue: 'File path here',
-        },
-        {
-            name: 'content',
-            description: "The content to write to the file. ALWAYS provide the COMPLETE intended content of the file, without any truncation or omissions. You MUST include ALL parts of the file, even if they haven't been modified.",
-            required: true,
-            usageValue: 'Your file content here',
-        },
-    ],
-    examples: [
-        {
-            description: 'Request to write content to a file',
-            parameters: [
-                {
-                    name: 'path',
-                    value: 'src/main.js',
-                },
-                {
-                    name: 'content',
-                    value: `import React from 'react';
-
-function App() {
-  return (
-    <div>
-      <h1>Hello, World!</h1>
-    </div>
-  );
-}
-
-export default App;
-`,
-                },
-            ],
-        },
-    ],
-};
-export const replaceInFile = {
-    name: 'replace_in_file',
-    description: 'Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. This tool should be used when you need to make targeted changes to specific parts of a file.',
-    parameters: [
-        {
-            name: 'path',
-            description: 'The path of the file to modify',
-            required: true,
-            usageValue: 'File path here',
-        },
-        {
-            name: 'diff',
-            description: `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: Use empty REPLACE section`,
-            required: true,
-            usageValue: 'Search and replace blocks here',
-        },
-    ],
-    examples: [
-        {
-            description: 'Request to replace sections of content in a file',
-            parameters: [
-                {
-                    name: 'path',
-                    value: 'src/main.js',
-                },
-                {
-                    name: 'diff',
-                    value: `
-<<<<<<< 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
-`,
-                },
-            ],
-        },
-    ],
-};
-export const searchFiles = {
-    name: 'search_files',
-    description: 'Request to perform a regex search across files in a specified directory, outputting context-rich results that include surrounding lines. This tool searches for patterns or specific content across multiple files, displaying each match with encapsulating context.',
-    parameters: [
-        {
-            name: 'path',
-            description: 'The path of the directory to search in (relative to the current working directory). This directory will be recursively searched.',
-            required: true,
-            usageValue: 'Directory path here',
-        },
-        {
-            name: 'regex',
-            description: 'The regular expression pattern to search for. Uses Rust regex syntax.',
-            required: true,
-            usageValue: 'Your regex pattern here',
-        },
-        {
-            name: 'file_pattern',
-            description: 'Glob pattern to filter files (e.g., "*.ts" for TypeScript files). If not provided, it will search all files (*).',
-            required: false,
-            usageValue: 'file pattern here (optional)',
-        },
-    ],
-    examples: [
-        {
-            description: 'Request to perform a regex search across files',
-            parameters: [
-                {
-                    name: 'path',
-                    value: 'src',
-                },
-                {
-                    name: 'regex',
-                    value: '^src/components/',
-                },
-                {
-                    name: 'file_pattern',
-                    value: '*.ts',
-                },
-            ],
-        },
-    ],
-};
-export const listFiles = {
-    name: 'list_files',
-    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: [
-        {
-            name: 'path',
-            description: 'The path of the directory to list contents for (relative to the current working directory)',
-            required: true,
-            usageValue: 'Directory path here',
-        },
-        {
-            name: 'depth',
-            description: 'The depth of the directory to list contents for. Use 0 for the top-level directory only, 1 for the top-level directory and its children, and so on.',
-            required: false,
-            usageValue: 'a number (optional)',
-        },
-    ],
-    examples: [
-        {
-            description: 'Request to list files',
-            parameters: [
-                {
-                    name: 'path',
-                    value: 'src',
-                },
-                {
-                    name: 'recursive',
-                    value: 'true',
-                },
-            ],
-        },
-    ],
-};
-export const listCodeDefinitionNames = {
-    name: 'list_code_definition_names',
-    description: 'Request to list definition names (classes, functions, methods, etc.) used in source code files at the top level of the specified directory. This tool provides insights into the codebase structure and important constructs, encapsulating high-level concepts and relationships that are crucial for understanding the overall architecture.',
-    parameters: [
-        {
-            name: 'path',
-            description: 'The path of the directory (relative to the current working directory ${cwd.toPosix()}) to list top level source code definitions for.',
-            required: true,
-            usageValue: 'Directory path here',
-        },
-    ],
-};
-export const askFollowupQuestion = {
-    name: 'ask_followup_question',
-    description: 'Ask the user a question to gather additional information needed to complete the task. This tool should be used when you encounter ambiguities, need clarification, or require more details to proceed effectively. It allows for interactive problem-solving by enabling direct communication with the user. Use this tool judiciously to maintain a balance between gathering necessary information and avoiding excessive back-and-forth.',
-    parameters: [
-        {
-            name: 'question',
-            description: 'The question to ask the user. This should be a clear, specific question that addresses the information you need.',
-            required: true,
-            usageValue: 'Your question here',
-        },
-    ],
-    examples: [
-        {
-            description: 'Request to ask a question',
-            parameters: [
-                {
-                    name: 'question',
-                    value: 'What is the name of the project?',
-                },
-            ],
-        },
-    ],
-};
-export const attemptCompletion = {
-    name: 'attempt_completion',
-    description: "After each tool use, the user will respond with the result of that tool use, i.e. if it succeeded or failed, along with any reasons for failure. Once you've received the results of tool uses and can confirm that the task is complete, use this tool to present the result of your work to the user.",
-    parameters: [
-        {
-            name: 'result',
-            description: "The result of the task. Formulate this result in a way that is final and does not require further input from the user. Don't end your result with questions or offers for further assistance.",
-            required: true,
-            usageValue: 'Your final result description here',
-        },
-    ],
-    examples: [
-        {
-            description: 'Request to present the result of the task',
-            parameters: [
-                {
-                    name: 'result',
-                    value: 'Your final result description here',
-                },
-            ],
-        },
-    ],
-};
-//# sourceMappingURL=tools.js.map

package/dist/tools/tools.js.map

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

package/dist/tools/types.d.ts

@@ -1,49 +0,0 @@
-export type ToolParameter = {
-    name: string;
-    description: string;
-    required: boolean;
-    usageValue: string;
-};
-export type ToolExample = {
-    description: string;
-    parameters: {
-        name: string;
-        value: string;
-    }[];
-};
-export type ToolInfo = {
-    name: string;
-    description: string;
-    parameters: ToolParameter[];
-    examples?: ToolExample[];
-};
-export declare enum ToolResponseType {
-    Reply = "Reply",
-    Exit = "Exit",
-    Invalid = "Invalid",
-    Error = "Error",
-    Interrupted = "Interrupted"
-}
-export type ToolResponseReply = {
-    type: ToolResponseType.Reply;
-    message: string;
-};
-export type ToolResponseExit = {
-    type: ToolResponseType.Exit;
-    message: string;
-};
-export type ToolResponseInvalid = {
-    type: ToolResponseType.Invalid;
-    message: string;
-};
-export type ToolResponseError = {
-    type: ToolResponseType.Error;
-    message: string;
-    canRetry?: boolean;
-};
-export type ToolResponseInterrupted = {
-    type: ToolResponseType.Interrupted;
-    message: string;
-};
-export type ToolResponse = ToolResponseReply | ToolResponseExit | ToolResponseInvalid | ToolResponseError | ToolResponseInterrupted;
-export type ToolHandler = (tool: string, args: Record<string, string>) => Promise<ToolResponse>;

package/dist/tools/types.js

@@ -1,9 +0,0 @@
-export var ToolResponseType;
-(function (ToolResponseType) {
-    ToolResponseType["Reply"] = "Reply";
-    ToolResponseType["Exit"] = "Exit";
-    ToolResponseType["Invalid"] = "Invalid";
-    ToolResponseType["Error"] = "Error";
-    ToolResponseType["Interrupted"] = "Interrupted";
-})(ToolResponseType || (ToolResponseType = {}));
-//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAN,IAAY,gBAMX;AAND,WAAY,gBAAgB;IAC1B,mCAAe,CAAA;IACf,iCAAa,CAAA;IACb,uCAAmB,CAAA;IACnB,mCAAe,CAAA;IACf,+CAA2B,CAAA;AAC7B,CAAC,EANW,gBAAgB,KAAhB,gBAAgB,QAM3B"}