@polka-codes/core 0.0.3 → 0.1.0

package/dist/tools/tools.d.ts

@@ -0,0 +1,200 @@
+export declare const executeCommand: {
+    readonly name: "execute_command";
+    readonly 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.";
+    readonly parameters: [{
+        readonly name: "command";
+        readonly 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.";
+        readonly required: true;
+        readonly usageValue: "Your command here";
+    }, {
+        readonly name: "requires_approval";
+        readonly 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.";
+        readonly required: false;
+        readonly usageValue: "true or false";
+    }];
+    readonly examples: [{
+        readonly description: "Request to execute a command";
+        readonly parameters: [{
+            readonly name: "command";
+            readonly value: "npm run dev";
+        }, {
+            readonly name: "requires_approval";
+            readonly value: "false";
+        }];
+    }];
+};
+export declare const readFile: {
+    readonly name: "read_file";
+    readonly 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.";
+    readonly parameters: [{
+        readonly name: "path";
+        readonly description: "The path of the file to read";
+        readonly required: true;
+        readonly usageValue: "Comma separated paths here";
+    }];
+    readonly examples: [{
+        readonly description: "Request to read the contents of a file";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/main.js";
+        }];
+    }, {
+        readonly description: "Request to read multiple files";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/main.js,src/index.js";
+        }];
+    }];
+};
+export declare const writeToFile: {
+    readonly name: "write_to_file";
+    readonly 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.";
+    readonly parameters: [{
+        readonly name: "path";
+        readonly description: "The path of the file to write to";
+        readonly required: true;
+        readonly usageValue: "File path here";
+    }, {
+        readonly name: "content";
+        readonly 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.";
+        readonly required: true;
+        readonly usageValue: "Your file content here";
+    }];
+    readonly examples: [{
+        readonly description: "Request to write content to a file";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/main.js";
+        }, {
+            readonly name: "content";
+            readonly value: "import React from 'react';\n\nfunction App() {\n  return (\n    <div>\n      <h1>Hello, World!</h1>\n    </div>\n  );\n}\n\nexport default App;\n";
+        }];
+    }];
+};
+export declare const replaceInFile: {
+    readonly name: "replace_in_file";
+    readonly 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.";
+    readonly parameters: [{
+        readonly name: "path";
+        readonly description: "The path of the file to modify";
+        readonly required: true;
+        readonly usageValue: "File path here";
+    }, {
+        readonly name: "diff";
+        readonly description: "One or more SEARCH/REPLACE blocks following this exact format:\n  ```\n  <<<<<<< SEARCH\n  [exact content to find]\n  =======\n  [new content to replace with]\n  >>>>>>> REPLACE\n  ```\n  Critical rules:\n  1. SEARCH content must match the associated file section to find EXACTLY:\n     * Match character-for-character including whitespace, indentation, line endings\n     * Include all comments, docstrings, etc.\n  2. SEARCH/REPLACE blocks will ONLY replace the first match occurrence.\n     * Including multiple unique SEARCH/REPLACE blocks if you need to make multiple changes.\n     * Include *just* enough lines in each SEARCH section to uniquely match each set of lines that need to change.\n     * When using multiple SEARCH/REPLACE blocks, list them in the order they appear in the file.\n  3. Keep SEARCH/REPLACE blocks concise:\n     * Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.\n     * Include just the changing lines, and a few surrounding lines if needed for uniqueness.\n     * Do not include long runs of unchanging lines in SEARCH/REPLACE blocks.\n     * Each line must be complete. Never truncate lines mid-way through as this can cause matching failures.\n  4. Special operations:\n     * To move code: Use two SEARCH/REPLACE blocks (one to delete from original + one to insert at new location)\n     * To delete code: Use empty REPLACE section";
+        readonly required: true;
+        readonly usageValue: "Search and replace blocks here";
+    }];
+    readonly examples: [{
+        readonly description: "Request to replace sections of content in a file";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/main.js";
+        }, {
+            readonly name: "diff";
+            readonly value: "\n<<<<<<< SEARCH\nimport React from 'react';\n=======\nimport React, { useState } from 'react';\n>>>>>>> REPLACE\n\n<<<<<<< SEARCH\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\n=======\n>>>>>>> REPLACE\n\n<<<<<<< SEARCH\nreturn (\n  <div>\n=======\nfunction handleSubmit() {\n  saveData();\n  setLoading(false);\n}\n\nreturn (\n  <div>\n>>>>>>> REPLACE\n";
+        }];
+    }];
+};
+export declare const searchFiles: {
+    readonly name: "search_files";
+    readonly 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.";
+    readonly parameters: [{
+        readonly name: "path";
+        readonly description: "The path of the directory to search in (relative to the current working directory). This directory will be recursively searched.";
+        readonly required: true;
+        readonly usageValue: "Directory path here";
+    }, {
+        readonly name: "regex";
+        readonly description: "The regular expression pattern to search for. Uses Rust regex syntax.";
+        readonly required: true;
+        readonly usageValue: "Your regex pattern here";
+    }, {
+        readonly name: "file_pattern";
+        readonly description: "Glob pattern to filter files (e.g., \"*.ts\" for TypeScript files). If not provided, it will search all files (*).";
+        readonly required: false;
+        readonly usageValue: "file pattern here (optional)";
+    }];
+    readonly examples: [{
+        readonly description: "Request to perform a regex search across files";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src";
+        }, {
+            readonly name: "regex";
+            readonly value: "^src/components/";
+        }, {
+            readonly name: "file_pattern";
+            readonly value: "*.ts";
+        }];
+    }];
+};
+export declare const listFiles: {
+    readonly name: "list_files";
+    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: [{
+        readonly name: "path";
+        readonly description: "The path of the directory to list contents for (relative to the current working directory)";
+        readonly required: true;
+        readonly usageValue: "Directory path here";
+    }, {
+        readonly name: "depth";
+        readonly 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.";
+        readonly required: false;
+        readonly usageValue: "a number (optional)";
+    }];
+    readonly examples: [{
+        readonly description: "Request to list files";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src";
+        }, {
+            readonly name: "recursive";
+            readonly value: "true";
+        }];
+    }];
+};
+export declare const listCodeDefinitionNames: {
+    readonly name: "list_code_definition_names";
+    readonly 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.";
+    readonly parameters: [{
+        readonly name: "path";
+        readonly description: "The path of the directory (relative to the current working directory ${cwd.toPosix()}) to list top level source code definitions for.";
+        readonly required: true;
+        readonly usageValue: "Directory path here";
+    }];
+};
+export declare const askFollowupQuestion: {
+    readonly name: "ask_followup_question";
+    readonly 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.";
+    readonly parameters: [{
+        readonly name: "question";
+        readonly description: "The question to ask the user. This should be a clear, specific question that addresses the information you need.";
+        readonly required: true;
+        readonly usageValue: "Your question here";
+    }];
+    readonly examples: [{
+        readonly description: "Request to ask a question";
+        readonly parameters: [{
+            readonly name: "question";
+            readonly value: "What is the name of the project?";
+        }];
+    }];
+};
+export declare const attemptCompletion: {
+    readonly name: "attempt_completion";
+    readonly 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.";
+    readonly parameters: [{
+        readonly name: "result";
+        readonly 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.";
+        readonly required: true;
+        readonly usageValue: "Your final result description here";
+    }];
+    readonly examples: [{
+        readonly description: "Request to present the result of the task";
+        readonly parameters: [{
+            readonly name: "result";
+            readonly value: "Your final result description here";
+        }];
+    }];
+};

package/dist/tools/tools.js

@@ -0,0 +1,329 @@
+// 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

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

package/dist/tools/types.d.ts

@@ -0,0 +1,49 @@
+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

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1 @@
+{"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"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@polka-codes/core",
-  "version": "0.0.3",
+  "version": "0.1.0",
+  "license": "AGPL-3.0",
   "type": "module",
   "exports": {
     ".": {
@@ -8,9 +9,11 @@
       "types": "./dist/index.d.ts"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "typecheck": "tsc --noEmit"
-  },
-  "files": ["dist"]
+  "files": ["dist"],
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.33.1",
+    "openai": "^4.77.4",
+    "pino": "^8.16.2",
+    "pino-pretty": "^13.0.0"
+  }
 }