@polka-codes/core 0.8.1 → 0.8.3

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

@@ -51,6 +51,7 @@ declare type AgentBaseConfig = {
         description: string;
     }>;
     callback?: TaskEventCallback;
+    policies: AgentPolicy[];
 };
 export { AgentBaseConfig }
 export { AgentBaseConfig as AgentBaseConfig_alias_1 }
@@ -68,6 +69,22 @@ declare type AgentNameType = (typeof allAgents)[number]['name'];
 export { AgentNameType }
 export { AgentNameType as AgentNameType_alias_1 }
 
+declare type AgentPolicy = (tools: Record<string, FullToolInfo>) => AgentPolicyInstance | undefined;
+export { AgentPolicy }
+export { AgentPolicy as AgentPolicy_alias_1 }
+export { AgentPolicy as AgentPolicy_alias_2 }
+
+declare type AgentPolicyInstance = {
+    name: string;
+    tools?: FullToolInfo[];
+    prompt?: string;
+    updateResponse?: (response: AssistantMessageContent[]) => Promise<AssistantMessageContent[]>;
+    onBeforeInvokeTool?: (name: string, args: Record<string, string>) => Promise<ToolResponse | undefined>;
+};
+export { AgentPolicyInstance }
+export { AgentPolicyInstance as AgentPolicyInstance_alias_1 }
+export { AgentPolicyInstance as AgentPolicyInstance_alias_2 }
+
 declare const agentsPrompt: (agents: Readonly<AgentInfo[]>, name: string) => string;
 export { agentsPrompt }
 export { agentsPrompt as agentsPrompt_alias_1 }
@@ -153,10 +170,11 @@ export declare namespace allTools {
         _default_7 as readFile,
         _default_8 as replaceInFile,
         _default_9 as searchFiles,
-        _default_10 as writeToFile,
-        _default_11 as handOver,
-        _default_12 as removeFile,
-        _default_13 as renameFile
+        _default_10 as updateKnowledge,
+        _default_11 as writeToFile,
+        _default_12 as handOver,
+        _default_13 as removeFile,
+        _default_14 as renameFile
     }
 }
 
@@ -557,6 +575,7 @@ declare const configSchema: z.ZodObject<{
     }>, "strip">>>;
     rules: z.ZodOptional<z.ZodUnion<[z.ZodOptional<z.ZodArray<z.ZodString, "many">>, z.ZodString]>>;
     excludeFiles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    policies: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
 }, "strict", z.ZodTypeAny, {
     agent?: string | undefined;
     prices?: Record<string, Record<string, {
@@ -617,6 +636,7 @@ declare const configSchema: z.ZodObject<{
     }>, "strip"> | undefined;
     rules?: string | string[] | undefined;
     excludeFiles?: string[] | undefined;
+    policies?: string[] | undefined;
 }, {
     agent?: string | undefined;
     prices?: Record<string, Record<string, {
@@ -677,6 +697,7 @@ declare const configSchema: z.ZodObject<{
     }>, "strip"> | undefined;
     rules?: string | string[] | undefined;
     excludeFiles?: string[] | undefined;
+    policies?: string[] | undefined;
 }>;
 export { configSchema }
 export { configSchema as configSchema_alias_1 }
@@ -821,9 +842,139 @@ export { _default as askFollowupQuestion_alias_2 }
 export { _default as default_alias_4 }
 
 declare const _default_10: {
+    handler: ToolHandler<{
+        readonly name: "update_knowledge";
+        readonly description: "Update knowledge in a knowledge.ai.yml file with smart merging capabilities. This tool lets you add, update, or remove information using path-based updates and special directives.";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly description: "Directory containing (or where to create) the knowledge.ai.yml file";
+            readonly required: true;
+            readonly usageValue: "Directory path here";
+        }, {
+            readonly name: "knowledge";
+            readonly description: "YAML content to merge into the knowledge file";
+            readonly required: true;
+            readonly usageValue: "YAML content with knowledge to update";
+        }];
+        readonly examples: [{
+            readonly description: "Add a new file entry";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/utils";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "files:\n  \"newFile.ts\":\n    description: \"A new utility file\"\n    api:\n      functions:\n        1:\n          name: \"processData\"\n          params:\n            1: { name: \"data\", type: \"object\" }\n          returns: \"object\"";
+            }];
+        }, {
+            readonly description: "Update an existing file description";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/utils";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "files:\n  \"existingFile.ts\":\n    description: \"Updated description for the file\"";
+            }];
+        }, {
+            readonly description: "Add a new rule";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "rules:\n    10: \"New rule to follow\"";
+            }];
+        }, {
+            readonly description: "Remove a rule";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "rules:\n    5: null";
+            }];
+        }, {
+            readonly description: "Update nested properties using dot notation";
+            readonly parameters: [{
+                readonly name: "path";
+                readonly value: "src/components";
+            }, {
+                readonly name: "knowledge";
+                readonly value: "files.Button.tsx.api.functions.1.description: \"Updated function description\"";
+            }];
+        }];
+        readonly permissionLevel: PermissionLevel.Write;
+    }, FilesystemProvider>;
+    isAvailable: (provider: FilesystemProvider) => boolean;
+    name: "update_knowledge";
+    description: "Update knowledge in a knowledge.ai.yml file with smart merging capabilities. This tool lets you add, update, or remove information using path-based updates and special directives.";
+    parameters: [{
+        readonly name: "path";
+        readonly description: "Directory containing (or where to create) the knowledge.ai.yml file";
+        readonly required: true;
+        readonly usageValue: "Directory path here";
+    }, {
+        readonly name: "knowledge";
+        readonly description: "YAML content to merge into the knowledge file";
+        readonly required: true;
+        readonly usageValue: "YAML content with knowledge to update";
+    }];
+    examples: [{
+        readonly description: "Add a new file entry";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/utils";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files:\n  \"newFile.ts\":\n    description: \"A new utility file\"\n    api:\n      functions:\n        1:\n          name: \"processData\"\n          params:\n            1: { name: \"data\", type: \"object\" }\n          returns: \"object\"";
+        }];
+    }, {
+        readonly description: "Update an existing file description";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/utils";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files:\n  \"existingFile.ts\":\n    description: \"Updated description for the file\"";
+        }];
+    }, {
+        readonly description: "Add a new rule";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "rules:\n    10: \"New rule to follow\"";
+        }];
+    }, {
+        readonly description: "Remove a rule";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "rules:\n    5: null";
+        }];
+    }, {
+        readonly description: "Update nested properties using dot notation";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/components";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files.Button.tsx.api.functions.1.description: \"Updated function description\"";
+        }];
+    }];
+    permissionLevel: PermissionLevel.Write;
+};
+export { _default_10 as default_alias_16 }
+export { _default_10 as updateKnowledge }
+export { _default_10 as updateKnowledge_alias_1 }
+export { _default_10 as updateKnowledge_alias_2 }
+
+declare const _default_11: {
     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.";
+        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;` and `&gt;`.";
         readonly parameters: [{
             readonly name: "path";
             readonly description: "The path of the file to write to";
@@ -849,7 +1000,7 @@ declare const _default_10: {
     }, FilesystemProvider>;
     isAvailable: (provider: FilesystemProvider) => boolean;
     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.";
+    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;` and `&gt;`.";
     parameters: [{
         readonly name: "path";
         readonly description: "The path of the file to write to";
@@ -873,12 +1024,12 @@ declare const _default_10: {
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_10 as default_alias_16 }
-export { _default_10 as writeToFile }
-export { _default_10 as writeToFile_alias_1 }
-export { _default_10 as writeToFile_alias_2 }
+export { _default_11 as default_alias_17 }
+export { _default_11 as writeToFile }
+export { _default_11 as writeToFile_alias_1 }
+export { _default_11 as writeToFile_alias_2 }
 
-declare const _default_11: {
+declare const _default_12: {
     handler: ToolHandler<{
         readonly name: "hand_over";
         readonly description: "Hand over the current task to another agent to complete. This tool MUST NOT to be used with any other tool.";
@@ -963,12 +1114,12 @@ declare const _default_11: {
     }];
     permissionLevel: PermissionLevel.None;
 };
-export { _default_11 as default_alias_8 }
-export { _default_11 as handOver }
-export { _default_11 as handOver_alias_1 }
-export { _default_11 as handOver_alias_2 }
+export { _default_12 as default_alias_8 }
+export { _default_12 as handOver }
+export { _default_12 as handOver_alias_1 }
+export { _default_12 as handOver_alias_2 }
 
-declare const _default_12: {
+declare const _default_13: {
     handler: ToolHandler<{
         readonly name: "remove_file";
         readonly description: "Request to remove a file at the specified path.";
@@ -1005,12 +1156,12 @@ declare const _default_12: {
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_12 as default_alias_12 }
-export { _default_12 as removeFile }
-export { _default_12 as removeFile_alias_1 }
-export { _default_12 as removeFile_alias_2 }
+export { _default_13 as default_alias_12 }
+export { _default_13 as removeFile }
+export { _default_13 as removeFile_alias_1 }
+export { _default_13 as removeFile_alias_2 }
 
-declare const _default_13: {
+declare const _default_14: {
     handler: ToolHandler<{
         readonly name: "rename_file";
         readonly description: "Request to rename a file from source path to target path.";
@@ -1063,10 +1214,10 @@ declare const _default_13: {
     }];
     permissionLevel: PermissionLevel.Write;
 };
-export { _default_13 as default_alias_13 }
-export { _default_13 as renameFile }
-export { _default_13 as renameFile_alias_1 }
-export { _default_13 as renameFile_alias_2 }
+export { _default_14 as default_alias_13 }
+export { _default_14 as renameFile }
+export { _default_14 as renameFile_alias_1 }
+export { _default_14 as renameFile_alias_2 }
 
 declare const _default_2: {
     handler: ToolHandler<{
@@ -1634,7 +1785,7 @@ export { ExitReason as ExitReason_alias_1 }
 export { ExitReason as ExitReason_alias_2 }
 
 declare type FilesystemProvider = {
-    readFile?: (path: string) => Promise<string>;
+    readFile?: (path: string) => Promise<string | undefined>;
     writeFile?: (path: string, content: string) => Promise<void>;
     removeFile?: (path: string) => Promise<void>;
     renameFile?: (sourcePath: string, targetPath: string) => Promise<void>;
@@ -1769,6 +1920,8 @@ export declare const handler_alias_11: ToolHandler<typeof toolInfo_alias_11, Fil
 
 export declare const handler_alias_12: ToolHandler<typeof toolInfo_alias_12, FilesystemProvider>;
 
+export declare const handler_alias_13: ToolHandler<typeof toolInfo_alias_13, FilesystemProvider>;
+
 export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, any>;
 
 export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, CommandProvider>;
@@ -1810,6 +1963,8 @@ export declare const isAvailable_alias_11: (provider: FilesystemProvider) => boo
 
 export declare const isAvailable_alias_12: (provider: FilesystemProvider) => boolean;
 
+export declare const isAvailable_alias_13: (provider: FilesystemProvider) => boolean;
+
 export declare const isAvailable_alias_2: (_provider: any) => boolean;
 
 export declare const isAvailable_alias_3: (provider: CommandProvider) => boolean;
@@ -1826,6 +1981,26 @@ export declare const isAvailable_alias_8: (provider: FilesystemProvider) => bool
 
 export declare const isAvailable_alias_9: (provider: FilesystemProvider) => boolean;
 
+declare const KnowledgeManagementPolicy: (tools: Parameters<AgentPolicy>[0]) => {
+    name: Policies;
+    tools: FullToolInfo[];
+    prompt: string | undefined;
+    getKnowledgeFilePaths(inputFiles: string[]): Promise<string[]>;
+    updateResponse(response: AssistantMessageContent[]): Promise<(TextContent | ToolUse | {
+        readonly type: "tool_use";
+        readonly name: "read_file";
+        readonly params: {
+            readonly path: string;
+        };
+    })[]>;
+} | undefined;
+export { KnowledgeManagementPolicy }
+export { KnowledgeManagementPolicy as KnowledgeManagementPolicy_alias_1 }
+export { KnowledgeManagementPolicy as KnowledgeManagementPolicy_alias_2 }
+export { KnowledgeManagementPolicy as KnowledgeManagementPolicy_alias_3 }
+
+export declare type KnowledgeManagementPolicyInstance = NonNullable<ReturnType<typeof KnowledgeManagementPolicy>>;
+
 declare const makeAgentTool: <T extends AiToolDefinition<any, any>>(definition: T) => (agent: MultiAgent, params: GetInput<T>) => Promise<GetOutput<T>>;
 export { makeAgentTool }
 export { makeAgentTool as makeAgentTool_alias_1 }
@@ -1976,7 +2151,7 @@ export { MultiAgent as MultiAgent_alias_2 }
 
 declare type MultiAgentConfig = {
     createAgent: (name: string) => Promise<AgentBase>;
-    getPrompt?: (name: string, task: string, context?: string, files?: string[], originalTask?: string) => Promise<string>;
+    getPrompt?: (name: string, task: string, context: string | undefined, files: string[] | undefined, originalTask: string | undefined) => Promise<string>;
 };
 export { MultiAgentConfig }
 export { MultiAgentConfig as MultiAgentConfig_alias_1 }
@@ -2069,6 +2244,12 @@ declare enum PermissionLevel {
 export { PermissionLevel }
 export { PermissionLevel as PermissionLevel_alias_1 }
 
+declare enum Policies {
+    KnowledgeManagement = "knowledgemanagement"
+}
+export { Policies }
+export { Policies as Policies_alias_1 }
+
 declare const replaceInFile_2: (fileContent: string, diff: string) => Promise<string>;
 export { replaceInFile_2 as replaceInFileHelper }
 export { replaceInFile_2 as replaceInFile_alias_3 }
@@ -2101,6 +2282,7 @@ declare type SharedAgentOptions = {
     }>;
     agents?: Readonly<AgentInfo[]>;
     callback?: TaskEventCallback;
+    policies: AgentPolicy[];
 };
 export { SharedAgentOptions }
 export { SharedAgentOptions as SharedAgentOptions_alias_1 }
@@ -2420,8 +2602,71 @@ export declare const toolInfo_alias_11: {
 };
 
 export declare const toolInfo_alias_12: {
+    readonly name: "update_knowledge";
+    readonly description: "Update knowledge in a knowledge.ai.yml file with smart merging capabilities. This tool lets you add, update, or remove information using path-based updates and special directives.";
+    readonly parameters: [{
+        readonly name: "path";
+        readonly description: "Directory containing (or where to create) the knowledge.ai.yml file";
+        readonly required: true;
+        readonly usageValue: "Directory path here";
+    }, {
+        readonly name: "knowledge";
+        readonly description: "YAML content to merge into the knowledge file";
+        readonly required: true;
+        readonly usageValue: "YAML content with knowledge to update";
+    }];
+    readonly examples: [{
+        readonly description: "Add a new file entry";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/utils";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files:\n  \"newFile.ts\":\n    description: \"A new utility file\"\n    api:\n      functions:\n        1:\n          name: \"processData\"\n          params:\n            1: { name: \"data\", type: \"object\" }\n          returns: \"object\"";
+        }];
+    }, {
+        readonly description: "Update an existing file description";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/utils";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files:\n  \"existingFile.ts\":\n    description: \"Updated description for the file\"";
+        }];
+    }, {
+        readonly description: "Add a new rule";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "rules:\n    10: \"New rule to follow\"";
+        }];
+    }, {
+        readonly description: "Remove a rule";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "rules:\n    5: null";
+        }];
+    }, {
+        readonly description: "Update nested properties using dot notation";
+        readonly parameters: [{
+            readonly name: "path";
+            readonly value: "src/components";
+        }, {
+            readonly name: "knowledge";
+            readonly value: "files.Button.tsx.api.functions.1.description: \"Updated function description\"";
+        }];
+    }];
+    readonly permissionLevel: PermissionLevel.Write;
+};
+
+export declare const toolInfo_alias_13: {
     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 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;` and `&gt;`.";
     readonly parameters: [{
         readonly name: "path";
         readonly description: "The path of the file to write to";

package/dist/index.d.ts

@@ -29,6 +29,8 @@ export { TaskEventCallback } from './_tsup-dts-rollup.js';
 export { SharedAgentOptions } from './_tsup-dts-rollup.js';
 export { AgentBaseConfig } from './_tsup-dts-rollup.js';
 export { AgentInfo } from './_tsup-dts-rollup.js';
+export { AgentPolicyInstance } from './_tsup-dts-rollup.js';
+export { AgentPolicy } from './_tsup-dts-rollup.js';
 export { ToolResponseOrToolPause } from './_tsup-dts-rollup.js';
 export { ExitReason } from './_tsup-dts-rollup.js';
 export { AgentBase } from './_tsup-dts-rollup.js';
@@ -57,6 +59,7 @@ export { parseAssistantMessage } from './_tsup-dts-rollup.js';
 export { TextContent } from './_tsup-dts-rollup.js';
 export { ToolUse } from './_tsup-dts-rollup.js';
 export { AssistantMessageContent } from './_tsup-dts-rollup.js';
+export { KnowledgeManagementPolicy } from './_tsup-dts-rollup.js';
 export { allTools } from './_tsup-dts-rollup.js';
 export { FilesystemProvider } from './_tsup-dts-rollup.js';
 export { CommandProvider } from './_tsup-dts-rollup.js';
@@ -72,6 +75,7 @@ export { listFiles } from './_tsup-dts-rollup.js';
 export { readFile } from './_tsup-dts-rollup.js';
 export { replaceInFile } from './_tsup-dts-rollup.js';
 export { searchFiles } from './_tsup-dts-rollup.js';
+export { updateKnowledge } from './_tsup-dts-rollup.js';
 export { writeToFile } from './_tsup-dts-rollup.js';
 export { handOver } from './_tsup-dts-rollup.js';
 export { removeFile } from './_tsup-dts-rollup.js';
@@ -114,6 +118,7 @@ export { ToolHandler } from './_tsup-dts-rollup.js';
 export { getAvailableTools_alias_1 as getAvailableTools } from './_tsup-dts-rollup.js';
 export { configSchema_alias_1 as configSchema } from './_tsup-dts-rollup.js';
 export { Config_alias_1 as Config } from './_tsup-dts-rollup.js';
+export { Policies_alias_1 as Policies } from './_tsup-dts-rollup.js';
 export { getString } from './_tsup-dts-rollup.js';
 export { getStringArray } from './_tsup-dts-rollup.js';
 export { getBoolean } from './_tsup-dts-rollup.js';