@polka-codes/core 0.9.19 → 0.9.20

package/dist/_tsup-dts-rollup.d.ts

@@ -1,13 +1,14 @@
 import type { FilePart } from 'ai';
 import type { ImagePart } from 'ai';
+import type { JSONValue } from '@ai-sdk/provider';
 import type { LanguageModelV2 } from '@ai-sdk/provider';
+import type { LanguageModelV2ToolResultOutput } from '@ai-sdk/provider';
 import type { LanguageModelV2Usage } from '@ai-sdk/provider';
 import type { ModelMessage } from '@ai-sdk/provider-utils';
 import type { ModelMessage as ModelMessage_2 } from 'ai';
 import type { TextPart } from 'ai';
 import type { ToolModelMessage } from '@ai-sdk/provider-utils';
 import type { UserContent } from '@ai-sdk/provider-utils';
-import type { UserContent as UserContent_2 } from 'ai';
 import type { UserModelMessage } from '@ai-sdk/provider-utils';
 import { z } from 'zod';
 
@@ -25,7 +26,7 @@ declare abstract class AgentBase {
     step(prompt: UserContent): Promise<AssistantMessageContent[]>;
     handleStepResponse(response: AssistantMessageContent[]): Promise<{
         type: "reply";
-        message: UserModelMessage | ToolModelMessage;
+        message: (UserModelMessage | ToolModelMessage)[];
     } | {
         type: "exit";
         reason: ExitReason;
@@ -146,12 +147,13 @@ export declare namespace allTools {
         _default_5 as fetchUrl,
         _default_6 as handOver,
         _default_7 as listFiles,
-        _default_8 as readFile,
-        _default_9 as removeFile,
-        _default_10 as renameFile,
-        _default_11 as replaceInFile,
-        _default_12 as searchFiles,
-        _default_13 as writeToFile
+        _default_8 as readBinaryFile,
+        _default_9 as readFile,
+        _default_10 as removeFile,
+        _default_11 as renameFile,
+        _default_12 as replaceInFile,
+        _default_13 as searchFiles,
+        _default_14 as writeToFile
     }
 }
 
@@ -406,6 +408,28 @@ export { _default as askFollowupQuestion_alias_2 }
 export { _default as default_alias_6 }
 
 declare const _default_10: {
+    handler: ToolHandler<{
+        readonly name: "remove_file";
+        readonly description: "Request to remove a file at the specified path.";
+        readonly parameters: z.ZodObject<{
+            path: z.ZodString;
+        }, z.core.$strip>;
+        readonly permissionLevel: PermissionLevel.Write;
+    }, FilesystemProvider>;
+    isAvailable: (provider: FilesystemProvider) => boolean;
+    name: "remove_file";
+    description: "Request to remove a file at the specified path.";
+    parameters: z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strip>;
+    permissionLevel: PermissionLevel.Write;
+};
+export { _default_10 as default_alias_15 }
+export { _default_10 as removeFile }
+export { _default_10 as removeFile_alias_1 }
+export { _default_10 as removeFile_alias_2 }
+
+declare const _default_11: {
     handler: ToolHandler<{
         readonly name: "rename_file";
         readonly description: "Request to rename a file from source path to target path.";
@@ -424,12 +448,12 @@ declare const _default_10: {
     }, z.core.$strip>;
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_10 as default_alias_15 }
-export { _default_10 as renameFile }
-export { _default_10 as renameFile_alias_1 }
-export { _default_10 as renameFile_alias_2 }
+export { _default_11 as default_alias_16 }
+export { _default_11 as renameFile }
+export { _default_11 as renameFile_alias_1 }
+export { _default_11 as renameFile_alias_2 }
 
-declare const _default_11: {
+declare const _default_12: {
     handler: ToolHandler<{
         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.";
@@ -448,12 +472,12 @@ declare const _default_11: {
     }, z.core.$strip>;
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_11 as default_alias_16 }
-export { _default_11 as replaceInFile }
-export { _default_11 as replaceInFile_alias_1 }
-export { _default_11 as replaceInFile_alias_2 }
+export { _default_12 as default_alias_17 }
+export { _default_12 as replaceInFile }
+export { _default_12 as replaceInFile_alias_1 }
+export { _default_12 as replaceInFile_alias_2 }
 
-declare const _default_12: {
+declare const _default_13: {
     handler: ToolHandler<{
         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.";
@@ -474,12 +498,12 @@ declare const _default_12: {
     }, z.core.$strip>;
     permissionLevel: PermissionLevel.Read;
 };
-export { _default_12 as default_alias_17 }
-export { _default_12 as searchFiles }
-export { _default_12 as searchFiles_alias_1 }
-export { _default_12 as searchFiles_alias_2 }
+export { _default_13 as default_alias_18 }
+export { _default_13 as searchFiles }
+export { _default_13 as searchFiles_alias_1 }
+export { _default_13 as searchFiles_alias_2 }
 
-declare const _default_13: {
+declare const _default_14: {
     handler: ToolHandler<{
         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. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
@@ -498,10 +522,10 @@ declare const _default_13: {
     }, z.core.$strip>;
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_13 as default_alias_18 }
-export { _default_13 as writeToFile }
-export { _default_13 as writeToFile_alias_1 }
-export { _default_13 as writeToFile_alias_2 }
+export { _default_14 as default_alias_19 }
+export { _default_14 as writeToFile }
+export { _default_14 as writeToFile_alias_1 }
+export { _default_14 as writeToFile_alias_2 }
 
 declare const _default_2: {
     handler: ToolHandler<{
@@ -657,49 +681,49 @@ export { _default_7 as listFiles_alias_2 }
 
 declare const _default_8: {
     handler: ToolHandler<{
-        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. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
+        readonly name: "read_binary_file";
+        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<{
-            path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-            includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+            url: z.ZodString;
         }, z.core.$strip>;
         readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
-    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. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
+    name: "read_binary_file";
+    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<{
-        path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-        includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        url: z.ZodString;
     }, z.core.$strip>;
     permissionLevel: PermissionLevel.Read;
 };
 export { _default_8 as default_alias_13 }
-export { _default_8 as readFile }
-export { _default_8 as readFile_alias_1 }
-export { _default_8 as readFile_alias_2 }
+export { _default_8 as readBinaryFile }
+export { _default_8 as readBinaryFile_alias_1 }
+export { _default_8 as readBinaryFile_alias_2 }
 
 declare const _default_9: {
     handler: ToolHandler<{
-        readonly name: "remove_file";
-        readonly description: "Request to remove a file at the specified path.";
+        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. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
         readonly parameters: z.ZodObject<{
-            path: z.ZodString;
+            path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+            includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
         }, z.core.$strip>;
-        readonly permissionLevel: PermissionLevel.Write;
+        readonly permissionLevel: PermissionLevel.Read;
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
-    name: "remove_file";
-    description: "Request to remove a file at the specified path.";
+    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. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
     parameters: z.ZodObject<{
-        path: z.ZodString;
+        path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+        includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    permissionLevel: PermissionLevel.Write;
+    permissionLevel: PermissionLevel.Read;
 };
 export { _default_9 as default_alias_14 }
-export { _default_9 as removeFile }
-export { _default_9 as removeFile_alias_1 }
-export { _default_9 as removeFile_alias_2 }
+export { _default_9 as readFile }
+export { _default_9 as readFile_alias_1 }
+export { _default_9 as readFile_alias_2 }
 
 /**
  * AI tool for creating new projects based on user specifications.
@@ -846,6 +870,10 @@ declare type FilesystemProvider = {
     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 { FilesystemProvider }
 export { FilesystemProvider as FilesystemProvider_alias_1 }
@@ -967,6 +995,8 @@ export declare const handler_alias_12: ToolHandler<typeof toolInfo_alias_12, Fil
 
 export declare const handler_alias_13: ToolHandler<typeof toolInfo_alias_13, FilesystemProvider>;
 
+export declare const handler_alias_14: ToolHandler<typeof toolInfo_alias_14, FilesystemProvider>;
+
 export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, InteractionProvider>;
 
 export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, any>;
@@ -1022,6 +1052,8 @@ export declare const isAvailable_alias_12: (provider: FilesystemProvider) => boo
 
 export declare const isAvailable_alias_13: (provider: FilesystemProvider) => boolean;
 
+export declare const isAvailable_alias_14: (provider: FilesystemProvider) => boolean;
+
 export declare const isAvailable_alias_2: (_provider: InteractionProvider) => boolean;
 
 export declare const isAvailable_alias_3: (_provider: any) => boolean;
@@ -1225,7 +1257,7 @@ declare const responsePrompts: {
     readonly errorInvokeTool: (tool: string, error: unknown) => string;
     readonly requireUseTool: "Error: No tool use detected. You MUST use a tool before proceeding.\ne.g. <tool_tool_name>tool_name</tool_tool_name>\n\nEnsure the opening and closing tags are correctly nested and closed, and that you are using the correct tool name.\nAvoid unnecessary text or symbols before or after the tool use.\nAvoid unnecessary escape characters or special characters.\n";
     readonly requireUseToolNative: "Error: No tool use detected. You MUST use a tool before proceeding.\n";
-    readonly toolResults: (tool: string, result: UserContent_2) => Array<TextPart | ImagePart | FilePart>;
+    readonly toolResults: (tool: string, result: LanguageModelV2ToolResultOutput) => Array<TextPart | ImagePart | FilePart>;
     readonly commandResult: (command: string, exitCode: number, stdout: string, stderr: string) => string;
 };
 export { responsePrompts }
@@ -1370,7 +1402,7 @@ export { TaskEventKind as TaskEventKind_alias_2 }
  */
 declare interface TaskEventStartRequest extends TaskEventBase {
     kind: TaskEventKind.StartRequest;
-    userMessage: ModelMessage;
+    userMessage: ModelMessage[];
 }
 export { TaskEventStartRequest }
 export { TaskEventStartRequest as TaskEventStartRequest_alias_1 }
@@ -1513,6 +1545,15 @@ export declare const toolInfo_alias_1: {
 };
 
 export declare const toolInfo_alias_10: {
+    readonly name: "remove_file";
+    readonly description: "Request to remove a file at the specified path.";
+    readonly parameters: z.ZodObject<{
+        path: z.ZodString;
+    }, z.core.$strip>;
+    readonly permissionLevel: PermissionLevel.Write;
+};
+
+export declare const toolInfo_alias_11: {
     readonly name: "rename_file";
     readonly description: "Request to rename a file from source path to target path.";
     readonly parameters: z.ZodObject<{
@@ -1522,7 +1563,7 @@ export declare const toolInfo_alias_10: {
     readonly permissionLevel: PermissionLevel.Write;
 };
 
-export declare const toolInfo_alias_11: {
+export declare const toolInfo_alias_12: {
     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: z.ZodObject<{
@@ -1532,7 +1573,7 @@ export declare const toolInfo_alias_11: {
     readonly permissionLevel: PermissionLevel.Write;
 };
 
-export declare const toolInfo_alias_12: {
+export declare const toolInfo_alias_13: {
     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: z.ZodObject<{
@@ -1543,7 +1584,7 @@ export declare const toolInfo_alias_12: {
     readonly permissionLevel: PermissionLevel.Read;
 };
 
-export declare const toolInfo_alias_13: {
+export declare const toolInfo_alias_14: {
     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. Ensure that the output content does not include incorrect escaped character patterns such as `&lt;`, `&gt;`, or `&amp;`. Also ensure there is no unwanted CDATA tags in the content.";
     readonly parameters: z.ZodObject<{
@@ -1618,22 +1659,22 @@ export declare const toolInfo_alias_7: {
 };
 
 export declare const toolInfo_alias_8: {
-    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. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
+    readonly name: "read_binary_file";
+    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<{
-        path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
-        includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        url: z.ZodString;
     }, z.core.$strip>;
     readonly permissionLevel: PermissionLevel.Read;
 };
 
 export declare const toolInfo_alias_9: {
-    readonly name: "remove_file";
-    readonly description: "Request to remove a file at the specified path.";
+    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. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.";
     readonly parameters: z.ZodObject<{
-        path: z.ZodString;
+        path: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+        includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
-    readonly permissionLevel: PermissionLevel.Write;
+    readonly permissionLevel: PermissionLevel.Read;
 };
 
 declare type ToolInfoV2 = {
@@ -1683,7 +1724,7 @@ export { ToolResponseDelegate as ToolResponseDelegate_alias_1 }
 
 declare type ToolResponseError = {
     type: ToolResponseType.Error;
-    message: string;
+    message: ToolResponseResult;
     canRetry?: boolean;
 };
 export { ToolResponseError }
@@ -1716,7 +1757,7 @@ export { ToolResponseInterrupted as ToolResponseInterrupted_alias_1 }
 
 declare type ToolResponseInvalid = {
     type: ToolResponseType.Invalid;
-    message: string;
+    message: ToolResponseResult;
 };
 export { ToolResponseInvalid }
 export { ToolResponseInvalid as ToolResponseInvalid_alias_1 }
@@ -1724,7 +1765,7 @@ export { ToolResponseInvalid as ToolResponseInvalid_alias_1 }
 declare type ToolResponseOrToolPause = {
     type: 'response';
     tool: string;
-    response: UserContent;
+    response: LanguageModelV2ToolResultOutput;
     id?: string;
 } | {
     type: 'pause';
@@ -1745,11 +1786,42 @@ export { ToolResponsePause as ToolResponsePause_alias_1 }
 
 declare type ToolResponseReply = {
     type: ToolResponseType.Reply;
-    message: UserContent;
+    message: ToolResponseResult;
 };
 export { ToolResponseReply }
 export { ToolResponseReply as ToolResponseReply_alias_1 }
 
+declare type ToolResponseResult = {
+    type: 'text';
+    value: string;
+} | {
+    type: 'json';
+    value: JSONValue;
+} | {
+    type: 'error-text';
+    value: string;
+} | {
+    type: 'error-json';
+    value: JSONValue;
+} | {
+    type: 'content';
+    value: Array<{
+        type: 'text';
+        text: string;
+    } | ToolResponseResultMedia>;
+};
+export { ToolResponseResult }
+export { ToolResponseResult as ToolResponseResult_alias_1 }
+
+declare type ToolResponseResultMedia = {
+    type: 'media';
+    base64Data: string;
+    mediaType: string;
+    url: string;
+};
+export { ToolResponseResultMedia }
+export { ToolResponseResultMedia as ToolResponseResultMedia_alias_1 }
+
 declare enum ToolResponseType {
     Reply = "Reply",
     Exit = "Exit",

package/dist/index.d.ts

@@ -78,6 +78,8 @@ export { ToolInfoV2 } from './_tsup-dts-rollup.js';
 export { FullToolInfo } from './_tsup-dts-rollup.js';
 export { FullToolInfoV2 } from './_tsup-dts-rollup.js';
 export { ToolResponseType } from './_tsup-dts-rollup.js';
+export { ToolResponseResultMedia } from './_tsup-dts-rollup.js';
+export { ToolResponseResult } from './_tsup-dts-rollup.js';
 export { ToolResponseReply } from './_tsup-dts-rollup.js';
 export { ToolResponseExit } from './_tsup-dts-rollup.js';
 export { ToolResponseInvalid } from './_tsup-dts-rollup.js';
@@ -96,6 +98,7 @@ export { executeCommand } from './_tsup-dts-rollup.js';
 export { fetchUrl } from './_tsup-dts-rollup.js';
 export { handOver } from './_tsup-dts-rollup.js';
 export { listFiles } from './_tsup-dts-rollup.js';
+export { readBinaryFile } from './_tsup-dts-rollup.js';
 export { readFile } from './_tsup-dts-rollup.js';
 export { removeFile } from './_tsup-dts-rollup.js';
 export { renameFile } from './_tsup-dts-rollup.js';