@polka-codes/core 0.9.47 → 0.9.49

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

@@ -1,3 +1,4 @@
+import { $strip } from 'zod/v4/core';
 import type { FilePart } from 'ai';
 import type { ImagePart } from 'ai';
 import type { JSONValue } from '@ai-sdk/provider';
@@ -6,6 +7,12 @@ import type { LanguageModelV2ToolResultOutput } from '@ai-sdk/provider';
 import type { LanguageModelV2Usage } from '@ai-sdk/provider';
 import type { TextPart } from 'ai';
 import { z } from 'zod';
+import { ZodArray } from 'zod';
+import { ZodEnum } from 'zod';
+import { ZodNullable } from 'zod';
+import { ZodObject } from 'zod';
+import { ZodOptional } from 'zod';
+import { ZodString } from 'zod';
 
 declare type CommandProvider = {
     executeCommand?: (command: string, needApprove: boolean) => Promise<{
@@ -79,59 +86,63 @@ export { configSchema as configSchema_alias_1 }
 
 declare const _default: {
     handler: ToolHandler<{
-        readonly name: "appendMemory";
-        readonly description: "Appends content to a memory topic.";
+        readonly name: "askFollowupQuestion";
+        readonly description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.";
         readonly parameters: z.ZodObject<{
-            topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            content: z.ZodString;
+            questions: z.ZodArray<z.ZodObject<{
+                prompt: z.ZodString;
+                options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            }, z.core.$strip>>;
         }, z.core.$strip>;
-    }, MemoryProvider>;
-    name: "appendMemory";
-    description: "Appends content to a memory topic.";
+    }, InteractionProvider>;
+    name: "askFollowupQuestion";
+    description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.";
     parameters: z.ZodObject<{
-        topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        content: z.ZodString;
+        questions: z.ZodArray<z.ZodObject<{
+            prompt: z.ZodString;
+            options: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        }, z.core.$strip>>;
     }, z.core.$strip>;
 };
-export { _default as appendMemory }
-export { _default as appendMemory_alias_1 }
+export { _default as askFollowupQuestion }
+export { _default as askFollowupQuestion_alias_1 }
 export { _default as default_alias }
 
 declare const _default_10: {
     handler: ToolHandler<{
-        readonly name: "removeFile";
-        readonly description: "Request to remove a file at the specified path.";
+        readonly name: "readMemory";
+        readonly description: "Reads content from a memory topic. Use this to retrieve information stored in previous steps. If no topic is specified, reads from the default topic.";
         readonly parameters: z.ZodObject<{
-            path: z.ZodString;
+            topic: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
-    }, FilesystemProvider>;
-    name: "removeFile";
-    description: "Request to remove a file at the specified path.";
+    }, MemoryProvider>;
+    name: "readMemory";
+    description: "Reads content from a memory topic. Use this to retrieve information stored in previous steps. If no topic is specified, reads from the default topic.";
     parameters: z.ZodObject<{
-        path: z.ZodString;
+        topic: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 };
 export { _default_10 as default_alias_9 }
-export { _default_10 as removeFile }
-export { _default_10 as removeFile_alias_1 }
+export { _default_10 as readMemory }
+export { _default_10 as readMemory_alias_1 }
 
 declare const _default_11: {
     handler: ToolHandler<{
-        readonly name: "removeMemory";
-        readonly description: "Removes a topic from memory.";
+        readonly name: "removeFile";
+        readonly description: "Request to remove a file at the specified path.";
         readonly parameters: z.ZodObject<{
-            topic: z.ZodOptional<z.ZodString>;
+            path: z.ZodString;
         }, z.core.$strip>;
-    }, MemoryProvider>;
-    name: "removeMemory";
-    description: "Removes a topic from memory.";
+    }, FilesystemProvider>;
+    name: "removeFile";
+    description: "Request to remove a file at the specified path.";
     parameters: z.ZodObject<{
-        topic: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
     }, z.core.$strip>;
 };
 export { _default_11 as default_alias_10 }
-export { _default_11 as removeMemory }
-export { _default_11 as removeMemory_alias_1 }
+export { _default_11 as removeFile }
+export { _default_11 as removeFile_alias_1 }
 
 declare const _default_12: {
     handler: ToolHandler<{
@@ -174,26 +185,6 @@ export { _default_13 as replaceInFile }
 export { _default_13 as replaceInFile_alias_1 }
 
 declare const _default_14: {
-    handler: ToolHandler<{
-        readonly name: "replaceMemory";
-        readonly description: "Replaces content of a memory topic.";
-        readonly parameters: z.ZodObject<{
-            topic: z.ZodOptional<z.ZodString>;
-            content: z.ZodString;
-        }, z.core.$strip>;
-    }, MemoryProvider>;
-    name: "replaceMemory";
-    description: "Replaces content of a memory topic.";
-    parameters: z.ZodObject<{
-        topic: z.ZodOptional<z.ZodString>;
-        content: z.ZodString;
-    }, z.core.$strip>;
-};
-export { _default_14 as default_alias_13 }
-export { _default_14 as replaceMemory }
-export { _default_14 as replaceMemory_alias_1 }
-
-declare const _default_15: {
     handler: ToolHandler<{
         readonly name: "searchFiles";
         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.";
@@ -211,11 +202,85 @@ declare const _default_15: {
         filePattern: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 };
+export { _default_14 as default_alias_13 }
+export { _default_14 as searchFiles }
+export { _default_14 as searchFiles_alias_1 }
+
+declare const _default_15: {
+    handler: ToolHandler<{
+        readonly name: "updateMemory";
+        readonly description: "Appends, replaces, or removes content from a memory topic. Use \"append\" to add to existing content, \"replace\" to overwrite entirely, or \"remove\" to delete a topic. Memory persists across tool calls within a workflow.";
+        readonly parameters: z.ZodObject<{
+            operation: z.ZodEnum<{
+                append: "append";
+                replace: "replace";
+                remove: "remove";
+            }>;
+            topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            content: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    }, MemoryProvider>;
+    name: "updateMemory";
+    description: "Appends, replaces, or removes content from a memory topic. Use \"append\" to add to existing content, \"replace\" to overwrite entirely, or \"remove\" to delete a topic. Memory persists across tool calls within a workflow.";
+    parameters: z.ZodObject<{
+        operation: z.ZodEnum<{
+            append: "append";
+            replace: "replace";
+            remove: "remove";
+        }>;
+        topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
 export { _default_15 as default_alias_14 }
-export { _default_15 as searchFiles }
-export { _default_15 as searchFiles_alias_1 }
+export { _default_15 as updateMemory }
+export { _default_15 as updateMemory_alias_1 }
 
 declare const _default_16: {
+    handler: ToolHandler<{
+        readonly name: "updateTodoItem";
+        readonly description: "Add or update a to-do item.";
+        readonly parameters: ZodObject<    {
+        operation: ZodEnum<    {
+        add: "add";
+        update: "update";
+        }>;
+        id: ZodOptional<ZodNullable<ZodString>>;
+        parentId: ZodOptional<ZodNullable<ZodString>>;
+        title: ZodOptional<ZodNullable<ZodString>>;
+        description: ZodOptional<ZodNullable<ZodString>>;
+        relevantFileList: ZodOptional<ZodNullable<ZodArray<ZodString>>>;
+        status: ZodOptional<ZodNullable<ZodEnum<    {
+        open: "open";
+        completed: "completed";
+        closed: "closed";
+        }>>>;
+        }, $strip>;
+    }, TodoProvider>;
+    name: "updateTodoItem";
+    description: "Add or update a to-do item.";
+    parameters: ZodObject<    {
+    operation: ZodEnum<    {
+    add: "add";
+    update: "update";
+    }>;
+    id: ZodOptional<ZodNullable<ZodString>>;
+    parentId: ZodOptional<ZodNullable<ZodString>>;
+    title: ZodOptional<ZodNullable<ZodString>>;
+    description: ZodOptional<ZodNullable<ZodString>>;
+    relevantFileList: ZodOptional<ZodNullable<ZodArray<ZodString>>>;
+    status: ZodOptional<ZodNullable<ZodEnum<    {
+    open: "open";
+    completed: "completed";
+    closed: "closed";
+    }>>>;
+    }, $strip>;
+};
+export { _default_16 as default_alias_15 }
+export { _default_16 as updateTodoItem }
+export { _default_16 as updateTodoItem_alias_1 }
+
+declare const _default_17: {
     handler: ToolHandler<{
         readonly name: "writeToFile";
         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.";
@@ -231,35 +296,11 @@ declare const _default_16: {
         content: z.ZodString;
     }, z.core.$strip>;
 };
-export { _default_16 as default_alias_15 }
-export { _default_16 as writeToFile }
-export { _default_16 as writeToFile_alias_1 }
+export { _default_17 as default_alias_16 }
+export { _default_17 as writeToFile }
+export { _default_17 as writeToFile_alias_1 }
 
 declare const _default_2: {
-    handler: ToolHandler<{
-        readonly name: "askFollowupQuestion";
-        readonly description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.";
-        readonly parameters: z.ZodObject<{
-            questions: z.ZodArray<z.ZodObject<{
-                prompt: z.ZodString;
-                options: z.ZodDefault<z.ZodArray<z.ZodString>>;
-            }, z.core.$strip>>;
-        }, z.core.$strip>;
-    }, InteractionProvider>;
-    name: "askFollowupQuestion";
-    description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.";
-    parameters: z.ZodObject<{
-        questions: z.ZodArray<z.ZodObject<{
-            prompt: z.ZodString;
-            options: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>>;
-    }, z.core.$strip>;
-};
-export { _default_2 as askFollowupQuestion }
-export { _default_2 as askFollowupQuestion_alias_1 }
-export { _default_2 as default_alias_1 }
-
-declare const _default_3: {
     handler: ToolHandler<{
         readonly name: "executeCommand";
         readonly description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.";
@@ -275,11 +316,11 @@ declare const _default_3: {
         requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
 };
-export { _default_3 as default_alias_2 }
-export { _default_3 as executeCommand }
-export { _default_3 as executeCommand_alias_1 }
+export { _default_2 as default_alias_1 }
+export { _default_2 as executeCommand }
+export { _default_2 as executeCommand_alias_1 }
 
-declare const _default_4: {
+declare const _default_3: {
     handler: ToolHandler<{
         readonly name: "fetchUrl";
         readonly description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.";
@@ -293,9 +334,27 @@ declare const _default_4: {
         url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
 };
+export { _default_3 as default_alias_2 }
+export { _default_3 as fetchUrl }
+export { _default_3 as fetchUrl_alias_1 }
+
+declare const _default_4: {
+    handler: ToolHandler<{
+        readonly name: "getTodoItem";
+        readonly description: "Get a to-do item by its ID.";
+        readonly parameters: z.ZodObject<{
+            id: z.ZodString;
+        }, z.core.$strip>;
+    }, TodoProvider>;
+    name: "getTodoItem";
+    description: "Get a to-do item by its ID.";
+    parameters: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>;
+};
 export { _default_4 as default_alias_3 }
-export { _default_4 as fetchUrl }
-export { _default_4 as fetchUrl_alias_1 }
+export { _default_4 as getTodoItem }
+export { _default_4 as getTodoItem_alias_1 }
 
 declare const _default_5: {
     handler: ToolHandler<{
@@ -324,11 +383,11 @@ export { _default_5 as listFiles_alias_1 }
 declare const _default_6: {
     handler: ToolHandler<{
         readonly name: "listMemoryTopics";
-        readonly description: "Lists all topics in memory.";
+        readonly description: "Lists all topics in memory. Use this to see what information has been stored and which topics are available to read from.";
         readonly parameters: z.ZodObject<{}, z.core.$strip>;
     }, MemoryProvider>;
     name: "listMemoryTopics";
-    description: "Lists all topics in memory.";
+    description: "Lists all topics in memory. Use this to see what information has been stored and which topics are available to read from.";
     parameters: z.ZodObject<{}, z.core.$strip>;
 };
 export { _default_6 as default_alias_5 }
@@ -336,6 +395,34 @@ export { _default_6 as listMemoryTopics }
 export { _default_6 as listMemoryTopics_alias_1 }
 
 declare const _default_7: {
+    handler: ToolHandler<{
+        readonly name: "listTodoItems";
+        readonly description: "List all to-do items, sorted by id. If an id is provided, it lists all sub-items for that id. Can be filtered by status.";
+        readonly parameters: z.ZodObject<{
+            id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+                open: "open";
+                completed: "completed";
+                closed: "closed";
+            }>>>;
+        }, z.core.$strip>;
+    }, TodoProvider>;
+    name: "listTodoItems";
+    description: "List all to-do items, sorted by id. If an id is provided, it lists all sub-items for that id. Can be filtered by status.";
+    parameters: z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            open: "open";
+            completed: "completed";
+            closed: "closed";
+        }>>>;
+    }, z.core.$strip>;
+};
+export { _default_7 as default_alias_6 }
+export { _default_7 as listTodoItems }
+export { _default_7 as listTodoItems_alias_1 }
+
+declare const _default_8: {
     handler: ToolHandler<{
         readonly name: "readBinaryFile";
         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.";
@@ -349,11 +436,11 @@ declare const _default_7: {
         url: z.ZodString;
     }, z.core.$strip>;
 };
-export { _default_7 as default_alias_6 }
-export { _default_7 as readBinaryFile }
-export { _default_7 as readBinaryFile_alias_1 }
+export { _default_8 as default_alias_7 }
+export { _default_8 as readBinaryFile }
+export { _default_8 as readBinaryFile_alias_1 }
 
-declare const _default_8: {
+declare const _default_9: {
     handler: ToolHandler<{
         readonly name: "readFile";
         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.";
@@ -369,27 +456,9 @@ declare const _default_8: {
         includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
     }, z.core.$strip>;
 };
-export { _default_8 as default_alias_7 }
-export { _default_8 as readFile }
-export { _default_8 as readFile_alias_1 }
-
-declare const _default_9: {
-    handler: ToolHandler<{
-        readonly name: "readMemory";
-        readonly description: "Reads content from a memory topic.";
-        readonly parameters: z.ZodObject<{
-            topic: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
-    }, MemoryProvider>;
-    name: "readMemory";
-    description: "Reads content from a memory topic.";
-    parameters: z.ZodObject<{
-        topic: z.ZodOptional<z.ZodString>;
-    }, z.core.$strip>;
-};
 export { _default_9 as default_alias_8 }
-export { _default_9 as readMemory }
-export { _default_9 as readMemory_alias_1 }
+export { _default_9 as readFile }
+export { _default_9 as readFile_alias_1 }
 
 /**
  * Returns the directory portion of a path string.
@@ -419,37 +488,49 @@ declare type FullToolInfo = ToolInfo & {
 export { FullToolInfo }
 export { FullToolInfo as FullToolInfo_alias_1 }
 
-export declare const handler: ToolHandler<typeof toolInfo, MemoryProvider>;
+declare type GetTodoItemOutput = TodoItem & {
+    subItems: {
+        id: string;
+        title: string;
+    }[];
+};
+export { GetTodoItemOutput }
+export { GetTodoItemOutput as GetTodoItemOutput_alias_1 }
+export { GetTodoItemOutput as GetTodoItemOutput_alias_2 }
+
+export declare const handler: ToolHandler<typeof toolInfo, InteractionProvider>;
 
-export declare const handler_alias_1: ToolHandler<typeof toolInfo_alias_1, InteractionProvider>;
+export declare const handler_alias_1: ToolHandler<typeof toolInfo_alias_1, CommandProvider>;
 
-export declare const handler_alias_10: ToolHandler<typeof toolInfo_alias_10, MemoryProvider>;
+export declare const handler_alias_10: ToolHandler<typeof toolInfo_alias_10, FilesystemProvider>;
 
 export declare const handler_alias_11: ToolHandler<typeof toolInfo_alias_11, FilesystemProvider>;
 
 export declare const handler_alias_12: ToolHandler<typeof toolInfo_alias_12, FilesystemProvider>;
 
-export declare const handler_alias_13: ToolHandler<typeof toolInfo_alias_13, MemoryProvider>;
+export declare const handler_alias_13: ToolHandler<typeof toolInfo_alias_13, FilesystemProvider>;
+
+export declare const handler_alias_14: ToolHandler<typeof toolInfo_alias_14, MemoryProvider>;
 
-export declare const handler_alias_14: ToolHandler<typeof toolInfo_alias_14, FilesystemProvider>;
+export declare const handler_alias_15: ToolHandler<typeof toolInfo_alias_15, TodoProvider>;
 
-export declare const handler_alias_15: ToolHandler<typeof toolInfo_alias_15, FilesystemProvider>;
+export declare const handler_alias_16: ToolHandler<typeof toolInfo_alias_16, FilesystemProvider>;
 
-export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, CommandProvider>;
+export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, WebProvider>;
 
-export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, WebProvider>;
+export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, TodoProvider>;
 
 export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, FilesystemProvider>;
 
 export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, MemoryProvider>;
 
-export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, FilesystemProvider>;
+export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, TodoProvider>;
 
 export declare const handler_alias_7: ToolHandler<typeof toolInfo_alias_7, FilesystemProvider>;
 
-export declare const handler_alias_8: ToolHandler<typeof toolInfo_alias_8, MemoryProvider>;
+export declare const handler_alias_8: ToolHandler<typeof toolInfo_alias_8, FilesystemProvider>;
 
-export declare const handler_alias_9: ToolHandler<typeof toolInfo_alias_9, FilesystemProvider>;
+export declare const handler_alias_9: ToolHandler<typeof toolInfo_alias_9, MemoryProvider>;
 
 declare type InteractionProvider = {
     askFollowupQuestion?: (question: string, options: string[]) => Promise<string>;
@@ -463,18 +544,32 @@ export { InteractionProvider as InteractionProvider_alias_2 }
  */
 export declare function join(...parts: string[]): string;
 
+declare type ListTodoItemsOutput = TodoItem[];
+export { ListTodoItemsOutput }
+export { ListTodoItemsOutput as ListTodoItemsOutput_alias_1 }
+export { ListTodoItemsOutput as ListTodoItemsOutput_alias_2 }
+
 declare interface MemoryProvider {
     listMemoryTopics: () => Promise<string[]>;
     readMemory: (topic?: string) => Promise<string | undefined>;
-    appendMemory: (topic: string | undefined, content: string) => Promise<void>;
-    replaceMemory: (topic: string | undefined, content: string) => Promise<void>;
-    removeMemory: (topic: string | undefined) => Promise<void>;
+    updateMemory: (operation: 'append' | 'replace' | 'remove', topic: string | undefined, content: string | undefined) => Promise<void>;
 }
 export { MemoryProvider }
 export { MemoryProvider as MemoryProvider_alias_1 }
 export { MemoryProvider as MemoryProvider_alias_2 }
 
 declare class MockProvider implements ToolProvider {
+    listTodoItems(id?: string | null, _status?: string | null): Promise<{
+        id: string;
+        title: string;
+        status: "open";
+        description: string;
+        relevantFileList: never[];
+    }[]>;
+    getTodoItem(id: string): Promise<GetTodoItemOutput | undefined>;
+    updateTodoItem(input: UpdateTodoItemInput): Promise<{
+        id: string;
+    }>;
     readFile(_path: string, _includeIgnored?: boolean): Promise<string>;
     writeFile(_path: string, _content: string): Promise<void>;
     removeFile(_path: string): Promise<void>;
@@ -488,6 +583,9 @@ declare class MockProvider implements ToolProvider {
         summary?: string;
     }>;
     askFollowupQuestion(_question: string, _options?: string[]): Promise<string>;
+    listMemoryTopics(): Promise<string[]>;
+    readMemory(_topic?: string): Promise<string | undefined>;
+    updateMemory(_operation: 'append' | 'replace' | 'remove', _topic?: string, _content?: string): Promise<void>;
 }
 export { MockProvider }
 export { MockProvider as MockProvider_alias_1 }
@@ -543,6 +641,44 @@ export { responsePrompts }
 export { responsePrompts as responsePrompts_alias_1 }
 export { responsePrompts as responsePrompts_alias_2 }
 
+declare type TodoItem = z.infer<typeof TodoItemSchema>;
+export { TodoItem }
+export { TodoItem as TodoItem_alias_1 }
+export { TodoItem as TodoItem_alias_2 }
+
+declare const TodoItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    relevantFileList: z.ZodArray<z.ZodString>;
+    status: z.ZodEnum<{
+        open: "open";
+        completed: "completed";
+        closed: "closed";
+    }>;
+}, z.core.$strip>;
+export { TodoItemSchema }
+export { TodoItemSchema as TodoItemSchema_alias_1 }
+export { TodoItemSchema as TodoItemSchema_alias_2 }
+
+declare type TodoProvider = {
+    listTodoItems: (id?: string | null, status?: string | null) => Promise<ListTodoItemsOutput>;
+    getTodoItem: (id: string) => Promise<GetTodoItemOutput | undefined>;
+    updateTodoItem: (input: UpdateTodoItemInput) => Promise<UpdateTodoItemOutput>;
+};
+export { TodoProvider }
+export { TodoProvider as TodoProvider_alias_1 }
+export { TodoProvider as TodoProvider_alias_2 }
+
+declare const TodoStatus: z.ZodEnum<{
+    open: "open";
+    completed: "completed";
+    closed: "closed";
+}>;
+export { TodoStatus }
+export { TodoStatus as TodoStatus_alias_1 }
+export { TodoStatus as TodoStatus_alias_2 }
+
 declare type ToolHandler<_T, P> = (provider: P, args: Partial<Record<string, ToolParameterValue>>) => Promise<ToolResponse>;
 export { ToolHandler }
 export { ToolHandler as ToolHandler_alias_1 }
@@ -556,15 +692,6 @@ export { ToolInfo }
 export { ToolInfo as ToolInfo_alias_1 }
 
 export declare const toolInfo: {
-    readonly name: "appendMemory";
-    readonly description: "Appends content to a memory topic.";
-    readonly parameters: z.ZodObject<{
-        topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-        content: z.ZodString;
-    }, z.core.$strip>;
-};
-
-export declare const toolInfo_alias_1: {
     readonly name: "askFollowupQuestion";
     readonly description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.";
     readonly parameters: z.ZodObject<{
@@ -575,11 +702,20 @@ export declare const toolInfo_alias_1: {
     }, z.core.$strip>;
 };
 
+export declare const toolInfo_alias_1: {
+    readonly name: "executeCommand";
+    readonly description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.";
+    readonly parameters: z.ZodObject<{
+        command: z.ZodString;
+        requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+    }, z.core.$strip>;
+};
+
 export declare const toolInfo_alias_10: {
-    readonly name: "removeMemory";
-    readonly description: "Removes a topic from memory.";
+    readonly name: "removeFile";
+    readonly description: "Request to remove a file at the specified path.";
     readonly parameters: z.ZodObject<{
-        topic: z.ZodOptional<z.ZodString>;
+        path: z.ZodString;
     }, z.core.$strip>;
 };
 
@@ -602,15 +738,6 @@ export declare const toolInfo_alias_12: {
 };
 
 export declare const toolInfo_alias_13: {
-    readonly name: "replaceMemory";
-    readonly description: "Replaces content of a memory topic.";
-    readonly parameters: z.ZodObject<{
-        topic: z.ZodOptional<z.ZodString>;
-        content: z.ZodString;
-    }, z.core.$strip>;
-};
-
-export declare const toolInfo_alias_14: {
     readonly name: "searchFiles";
     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<{
@@ -620,7 +747,42 @@ export declare const toolInfo_alias_14: {
     }, z.core.$strip>;
 };
 
+export declare const toolInfo_alias_14: {
+    readonly name: "updateMemory";
+    readonly description: "Appends, replaces, or removes content from a memory topic. Use \"append\" to add to existing content, \"replace\" to overwrite entirely, or \"remove\" to delete a topic. Memory persists across tool calls within a workflow.";
+    readonly parameters: z.ZodObject<{
+        operation: z.ZodEnum<{
+            append: "append";
+            replace: "replace";
+            remove: "remove";
+        }>;
+        topic: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        content: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+
 export declare const toolInfo_alias_15: {
+    readonly name: "updateTodoItem";
+    readonly description: "Add or update a to-do item.";
+    readonly parameters: ZodObject<    {
+    operation: ZodEnum<    {
+    add: "add";
+    update: "update";
+    }>;
+    id: ZodOptional<ZodNullable<ZodString>>;
+    parentId: ZodOptional<ZodNullable<ZodString>>;
+    title: ZodOptional<ZodNullable<ZodString>>;
+    description: ZodOptional<ZodNullable<ZodString>>;
+    relevantFileList: ZodOptional<ZodNullable<ZodArray<ZodString>>>;
+    status: ZodOptional<ZodNullable<ZodEnum<    {
+    open: "open";
+    completed: "completed";
+    closed: "closed";
+    }>>>;
+    }, $strip>;
+};
+
+export declare const toolInfo_alias_16: {
     readonly name: "writeToFile";
     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<{
@@ -630,19 +792,18 @@ export declare const toolInfo_alias_15: {
 };
 
 export declare const toolInfo_alias_2: {
-    readonly name: "executeCommand";
-    readonly description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.";
+    readonly name: "fetchUrl";
+    readonly description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.";
     readonly parameters: z.ZodObject<{
-        command: z.ZodString;
-        requiresApproval: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
+        url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
     }, z.core.$strip>;
 };
 
 export declare const toolInfo_alias_3: {
-    readonly name: "fetchUrl";
-    readonly description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.";
+    readonly name: "getTodoItem";
+    readonly description: "Get a to-do item by its ID.";
     readonly parameters: z.ZodObject<{
-        url: z.ZodPipe<z.ZodTransform<string[], unknown>, z.ZodArray<z.ZodString>>;
+        id: z.ZodString;
     }, z.core.$strip>;
 };
 
@@ -659,11 +820,24 @@ export declare const toolInfo_alias_4: {
 
 export declare const toolInfo_alias_5: {
     readonly name: "listMemoryTopics";
-    readonly description: "Lists all topics in memory.";
+    readonly description: "Lists all topics in memory. Use this to see what information has been stored and which topics are available to read from.";
     readonly parameters: z.ZodObject<{}, z.core.$strip>;
 };
 
 export declare const toolInfo_alias_6: {
+    readonly name: "listTodoItems";
+    readonly description: "List all to-do items, sorted by id. If an id is provided, it lists all sub-items for that id. Can be filtered by status.";
+    readonly parameters: z.ZodObject<{
+        id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            open: "open";
+            completed: "completed";
+            closed: "closed";
+        }>>>;
+    }, z.core.$strip>;
+};
+
+export declare const toolInfo_alias_7: {
     readonly name: "readBinaryFile";
     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<{
@@ -671,7 +845,7 @@ export declare const toolInfo_alias_6: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_7: {
+export declare const toolInfo_alias_8: {
     readonly name: "readFile";
     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<{
@@ -680,22 +854,14 @@ export declare const toolInfo_alias_7: {
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_8: {
+export declare const toolInfo_alias_9: {
     readonly name: "readMemory";
-    readonly description: "Reads content from a memory topic.";
+    readonly description: "Reads content from a memory topic. Use this to retrieve information stored in previous steps. If no topic is specified, reads from the default topic.";
     readonly parameters: z.ZodObject<{
         topic: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
 };
 
-export declare const toolInfo_alias_9: {
-    readonly name: "removeFile";
-    readonly description: "Request to remove a file at the specified path.";
-    readonly parameters: z.ZodObject<{
-        path: z.ZodString;
-    }, z.core.$strip>;
-};
-
 declare type ToolParameter = {
     name: string;
     description: string;
@@ -713,7 +879,7 @@ declare type ToolParameterValue = string | {
 export { ToolParameterValue }
 export { ToolParameterValue as ToolParameterValue_alias_1 }
 
-declare type ToolProvider = FilesystemProvider & CommandProvider & InteractionProvider & WebProvider & Partial<MemoryProvider>;
+declare type ToolProvider = FilesystemProvider & CommandProvider & InteractionProvider & WebProvider & Partial<MemoryProvider> & Partial<TodoProvider>;
 export { ToolProvider }
 export { ToolProvider as ToolProvider_alias_1 }
 export { ToolProvider as ToolProvider_alias_2 }
@@ -791,6 +957,43 @@ declare type Totals = {
     messageCount: number;
 };
 
+declare type UpdateTodoItemInput = z.infer<typeof UpdateTodoItemInputSchema>;
+export { UpdateTodoItemInput }
+export { UpdateTodoItemInput as UpdateTodoItemInput_alias_1 }
+export { UpdateTodoItemInput as UpdateTodoItemInput_alias_2 }
+
+declare const UpdateTodoItemInputSchema: z.ZodObject<{
+    operation: z.ZodEnum<{
+        add: "add";
+        update: "update";
+    }>;
+    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    relevantFileList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+    status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        open: "open";
+        completed: "completed";
+        closed: "closed";
+    }>>>;
+}, z.core.$strip>;
+export { UpdateTodoItemInputSchema }
+export { UpdateTodoItemInputSchema as UpdateTodoItemInputSchema_alias_1 }
+export { UpdateTodoItemInputSchema as UpdateTodoItemInputSchema_alias_2 }
+
+declare type UpdateTodoItemOutput = z.infer<typeof UpdateTodoItemOutputSchema>;
+export { UpdateTodoItemOutput }
+export { UpdateTodoItemOutput as UpdateTodoItemOutput_alias_1 }
+export { UpdateTodoItemOutput as UpdateTodoItemOutput_alias_2 }
+
+declare const UpdateTodoItemOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export { UpdateTodoItemOutputSchema }
+export { UpdateTodoItemOutputSchema as UpdateTodoItemOutputSchema_alias_1 }
+export { UpdateTodoItemOutputSchema as UpdateTodoItemOutputSchema_alias_2 }
+
 /**
  * Tracks token / cost usage across any mix of LLM models.
  * Supports optional caps on total messages and total cost.