@polka-codes/core 0.9.48 → 0.9.49

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,3 +1,4 @@
1
+ import { $strip } from 'zod/v4/core';
1
2
  import type { FilePart } from 'ai';
2
3
  import type { ImagePart } from 'ai';
3
4
  import type { JSONValue } from '@ai-sdk/provider';
@@ -6,6 +7,12 @@ import type { LanguageModelV2ToolResultOutput } from '@ai-sdk/provider';
6
7
  import type { LanguageModelV2Usage } from '@ai-sdk/provider';
7
8
  import type { TextPart } from 'ai';
8
9
  import { z } from 'zod';
10
+ import { ZodArray } from 'zod';
11
+ import { ZodEnum } from 'zod';
12
+ import { ZodNullable } from 'zod';
13
+ import { ZodObject } from 'zod';
14
+ import { ZodOptional } from 'zod';
15
+ import { ZodString } from 'zod';
9
16
 
10
17
  declare type CommandProvider = {
11
18
  executeCommand?: (command: string, needApprove: boolean) => Promise<{
@@ -102,6 +109,42 @@ export { _default as askFollowupQuestion_alias_1 }
102
109
  export { _default as default_alias }
103
110
 
104
111
  declare const _default_10: {
112
+ handler: ToolHandler<{
113
+ readonly name: "readMemory";
114
+ 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.";
115
+ readonly parameters: z.ZodObject<{
116
+ topic: z.ZodOptional<z.ZodString>;
117
+ }, z.core.$strip>;
118
+ }, MemoryProvider>;
119
+ name: "readMemory";
120
+ 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.";
121
+ parameters: z.ZodObject<{
122
+ topic: z.ZodOptional<z.ZodString>;
123
+ }, z.core.$strip>;
124
+ };
125
+ export { _default_10 as default_alias_9 }
126
+ export { _default_10 as readMemory }
127
+ export { _default_10 as readMemory_alias_1 }
128
+
129
+ declare const _default_11: {
130
+ handler: ToolHandler<{
131
+ readonly name: "removeFile";
132
+ readonly description: "Request to remove a file at the specified path.";
133
+ readonly parameters: z.ZodObject<{
134
+ path: z.ZodString;
135
+ }, z.core.$strip>;
136
+ }, FilesystemProvider>;
137
+ name: "removeFile";
138
+ description: "Request to remove a file at the specified path.";
139
+ parameters: z.ZodObject<{
140
+ path: z.ZodString;
141
+ }, z.core.$strip>;
142
+ };
143
+ export { _default_11 as default_alias_10 }
144
+ export { _default_11 as removeFile }
145
+ export { _default_11 as removeFile_alias_1 }
146
+
147
+ declare const _default_12: {
105
148
  handler: ToolHandler<{
106
149
  readonly name: "renameFile";
107
150
  readonly description: "Request to rename a file from source path to target path.";
@@ -117,11 +160,11 @@ declare const _default_10: {
117
160
  target_path: z.ZodString;
118
161
  }, z.core.$strip>;
119
162
  };
120
- export { _default_10 as default_alias_9 }
121
- export { _default_10 as renameFile }
122
- export { _default_10 as renameFile_alias_1 }
163
+ export { _default_12 as default_alias_11 }
164
+ export { _default_12 as renameFile }
165
+ export { _default_12 as renameFile_alias_1 }
123
166
 
124
- declare const _default_11: {
167
+ declare const _default_13: {
125
168
  handler: ToolHandler<{
126
169
  readonly name: "replaceInFile";
127
170
  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.";
@@ -137,11 +180,11 @@ declare const _default_11: {
137
180
  diff: z.ZodString;
138
181
  }, z.core.$strip>;
139
182
  };
140
- export { _default_11 as default_alias_10 }
141
- export { _default_11 as replaceInFile }
142
- export { _default_11 as replaceInFile_alias_1 }
183
+ export { _default_13 as default_alias_12 }
184
+ export { _default_13 as replaceInFile }
185
+ export { _default_13 as replaceInFile_alias_1 }
143
186
 
144
- declare const _default_12: {
187
+ declare const _default_14: {
145
188
  handler: ToolHandler<{
146
189
  readonly name: "searchFiles";
147
190
  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.";
@@ -159,14 +202,14 @@ declare const _default_12: {
159
202
  filePattern: z.ZodOptional<z.ZodString>;
160
203
  }, z.core.$strip>;
161
204
  };
162
- export { _default_12 as default_alias_11 }
163
- export { _default_12 as searchFiles }
164
- export { _default_12 as searchFiles_alias_1 }
205
+ export { _default_14 as default_alias_13 }
206
+ export { _default_14 as searchFiles }
207
+ export { _default_14 as searchFiles_alias_1 }
165
208
 
166
- declare const _default_13: {
209
+ declare const _default_15: {
167
210
  handler: ToolHandler<{
168
211
  readonly name: "updateMemory";
169
- readonly description: "Appends, replaces, or removes content from a memory topic.";
212
+ 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.";
170
213
  readonly parameters: z.ZodObject<{
171
214
  operation: z.ZodEnum<{
172
215
  append: "append";
@@ -178,7 +221,7 @@ declare const _default_13: {
178
221
  }, z.core.$strip>;
179
222
  }, MemoryProvider>;
180
223
  name: "updateMemory";
181
- description: "Appends, replaces, or removes content from a memory topic.";
224
+ 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.";
182
225
  parameters: z.ZodObject<{
183
226
  operation: z.ZodEnum<{
184
227
  append: "append";
@@ -189,11 +232,55 @@ declare const _default_13: {
189
232
  content: z.ZodOptional<z.ZodString>;
190
233
  }, z.core.$strip>;
191
234
  };
192
- export { _default_13 as default_alias_12 }
193
- export { _default_13 as updateMemory }
194
- export { _default_13 as updateMemory_alias_1 }
235
+ export { _default_15 as default_alias_14 }
236
+ export { _default_15 as updateMemory }
237
+ export { _default_15 as updateMemory_alias_1 }
195
238
 
196
- declare const _default_14: {
239
+ declare const _default_16: {
240
+ handler: ToolHandler<{
241
+ readonly name: "updateTodoItem";
242
+ readonly description: "Add or update a to-do item.";
243
+ readonly parameters: ZodObject< {
244
+ operation: ZodEnum< {
245
+ add: "add";
246
+ update: "update";
247
+ }>;
248
+ id: ZodOptional<ZodNullable<ZodString>>;
249
+ parentId: ZodOptional<ZodNullable<ZodString>>;
250
+ title: ZodOptional<ZodNullable<ZodString>>;
251
+ description: ZodOptional<ZodNullable<ZodString>>;
252
+ relevantFileList: ZodOptional<ZodNullable<ZodArray<ZodString>>>;
253
+ status: ZodOptional<ZodNullable<ZodEnum< {
254
+ open: "open";
255
+ completed: "completed";
256
+ closed: "closed";
257
+ }>>>;
258
+ }, $strip>;
259
+ }, TodoProvider>;
260
+ name: "updateTodoItem";
261
+ description: "Add or update a to-do item.";
262
+ parameters: ZodObject< {
263
+ operation: ZodEnum< {
264
+ add: "add";
265
+ update: "update";
266
+ }>;
267
+ id: ZodOptional<ZodNullable<ZodString>>;
268
+ parentId: ZodOptional<ZodNullable<ZodString>>;
269
+ title: ZodOptional<ZodNullable<ZodString>>;
270
+ description: ZodOptional<ZodNullable<ZodString>>;
271
+ relevantFileList: ZodOptional<ZodNullable<ZodArray<ZodString>>>;
272
+ status: ZodOptional<ZodNullable<ZodEnum< {
273
+ open: "open";
274
+ completed: "completed";
275
+ closed: "closed";
276
+ }>>>;
277
+ }, $strip>;
278
+ };
279
+ export { _default_16 as default_alias_15 }
280
+ export { _default_16 as updateTodoItem }
281
+ export { _default_16 as updateTodoItem_alias_1 }
282
+
283
+ declare const _default_17: {
197
284
  handler: ToolHandler<{
198
285
  readonly name: "writeToFile";
199
286
  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.";
@@ -209,9 +296,9 @@ declare const _default_14: {
209
296
  content: z.ZodString;
210
297
  }, z.core.$strip>;
211
298
  };
212
- export { _default_14 as default_alias_13 }
213
- export { _default_14 as writeToFile }
214
- export { _default_14 as writeToFile_alias_1 }
299
+ export { _default_17 as default_alias_16 }
300
+ export { _default_17 as writeToFile }
301
+ export { _default_17 as writeToFile_alias_1 }
215
302
 
216
303
  declare const _default_2: {
217
304
  handler: ToolHandler<{
@@ -252,6 +339,24 @@ export { _default_3 as fetchUrl }
252
339
  export { _default_3 as fetchUrl_alias_1 }
253
340
 
254
341
  declare const _default_4: {
342
+ handler: ToolHandler<{
343
+ readonly name: "getTodoItem";
344
+ readonly description: "Get a to-do item by its ID.";
345
+ readonly parameters: z.ZodObject<{
346
+ id: z.ZodString;
347
+ }, z.core.$strip>;
348
+ }, TodoProvider>;
349
+ name: "getTodoItem";
350
+ description: "Get a to-do item by its ID.";
351
+ parameters: z.ZodObject<{
352
+ id: z.ZodString;
353
+ }, z.core.$strip>;
354
+ };
355
+ export { _default_4 as default_alias_3 }
356
+ export { _default_4 as getTodoItem }
357
+ export { _default_4 as getTodoItem_alias_1 }
358
+
359
+ declare const _default_5: {
255
360
  handler: ToolHandler<{
256
361
  readonly name: "listFiles";
257
362
  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.";
@@ -271,25 +376,53 @@ declare const _default_4: {
271
376
  includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
272
377
  }, z.core.$strip>;
273
378
  };
274
- export { _default_4 as default_alias_3 }
275
- export { _default_4 as listFiles }
276
- export { _default_4 as listFiles_alias_1 }
379
+ export { _default_5 as default_alias_4 }
380
+ export { _default_5 as listFiles }
381
+ export { _default_5 as listFiles_alias_1 }
277
382
 
278
- declare const _default_5: {
383
+ declare const _default_6: {
279
384
  handler: ToolHandler<{
280
385
  readonly name: "listMemoryTopics";
281
- readonly description: "Lists all topics in memory.";
386
+ readonly description: "Lists all topics in memory. Use this to see what information has been stored and which topics are available to read from.";
282
387
  readonly parameters: z.ZodObject<{}, z.core.$strip>;
283
388
  }, MemoryProvider>;
284
389
  name: "listMemoryTopics";
285
- description: "Lists all topics in memory.";
390
+ description: "Lists all topics in memory. Use this to see what information has been stored and which topics are available to read from.";
286
391
  parameters: z.ZodObject<{}, z.core.$strip>;
287
392
  };
288
- export { _default_5 as default_alias_4 }
289
- export { _default_5 as listMemoryTopics }
290
- export { _default_5 as listMemoryTopics_alias_1 }
393
+ export { _default_6 as default_alias_5 }
394
+ export { _default_6 as listMemoryTopics }
395
+ export { _default_6 as listMemoryTopics_alias_1 }
291
396
 
292
- declare const _default_6: {
397
+ declare const _default_7: {
398
+ handler: ToolHandler<{
399
+ readonly name: "listTodoItems";
400
+ 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.";
401
+ readonly parameters: z.ZodObject<{
402
+ id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
403
+ status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
404
+ open: "open";
405
+ completed: "completed";
406
+ closed: "closed";
407
+ }>>>;
408
+ }, z.core.$strip>;
409
+ }, TodoProvider>;
410
+ name: "listTodoItems";
411
+ 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.";
412
+ parameters: z.ZodObject<{
413
+ id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
414
+ status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
415
+ open: "open";
416
+ completed: "completed";
417
+ closed: "closed";
418
+ }>>>;
419
+ }, z.core.$strip>;
420
+ };
421
+ export { _default_7 as default_alias_6 }
422
+ export { _default_7 as listTodoItems }
423
+ export { _default_7 as listTodoItems_alias_1 }
424
+
425
+ declare const _default_8: {
293
426
  handler: ToolHandler<{
294
427
  readonly name: "readBinaryFile";
295
428
  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.";
@@ -303,11 +436,11 @@ declare const _default_6: {
303
436
  url: z.ZodString;
304
437
  }, z.core.$strip>;
305
438
  };
306
- export { _default_6 as default_alias_5 }
307
- export { _default_6 as readBinaryFile }
308
- export { _default_6 as readBinaryFile_alias_1 }
439
+ export { _default_8 as default_alias_7 }
440
+ export { _default_8 as readBinaryFile }
441
+ export { _default_8 as readBinaryFile_alias_1 }
309
442
 
310
- declare const _default_7: {
443
+ declare const _default_9: {
311
444
  handler: ToolHandler<{
312
445
  readonly name: "readFile";
313
446
  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.";
@@ -323,45 +456,9 @@ declare const _default_7: {
323
456
  includeIgnored: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
324
457
  }, z.core.$strip>;
325
458
  };
326
- export { _default_7 as default_alias_6 }
327
- export { _default_7 as readFile }
328
- export { _default_7 as readFile_alias_1 }
329
-
330
- declare const _default_8: {
331
- handler: ToolHandler<{
332
- readonly name: "readMemory";
333
- readonly description: "Reads content from a memory topic.";
334
- readonly parameters: z.ZodObject<{
335
- topic: z.ZodOptional<z.ZodString>;
336
- }, z.core.$strip>;
337
- }, MemoryProvider>;
338
- name: "readMemory";
339
- description: "Reads content from a memory topic.";
340
- parameters: z.ZodObject<{
341
- topic: z.ZodOptional<z.ZodString>;
342
- }, z.core.$strip>;
343
- };
344
- export { _default_8 as default_alias_7 }
345
- export { _default_8 as readMemory }
346
- export { _default_8 as readMemory_alias_1 }
347
-
348
- declare const _default_9: {
349
- handler: ToolHandler<{
350
- readonly name: "removeFile";
351
- readonly description: "Request to remove a file at the specified path.";
352
- readonly parameters: z.ZodObject<{
353
- path: z.ZodString;
354
- }, z.core.$strip>;
355
- }, FilesystemProvider>;
356
- name: "removeFile";
357
- description: "Request to remove a file at the specified path.";
358
- parameters: z.ZodObject<{
359
- path: z.ZodString;
360
- }, z.core.$strip>;
361
- };
362
459
  export { _default_9 as default_alias_8 }
363
- export { _default_9 as removeFile }
364
- export { _default_9 as removeFile_alias_1 }
460
+ export { _default_9 as readFile }
461
+ export { _default_9 as readFile_alias_1 }
365
462
 
366
463
  /**
367
464
  * Returns the directory portion of a path string.
@@ -391,6 +488,16 @@ declare type FullToolInfo = ToolInfo & {
391
488
  export { FullToolInfo }
392
489
  export { FullToolInfo as FullToolInfo_alias_1 }
393
490
 
491
+ declare type GetTodoItemOutput = TodoItem & {
492
+ subItems: {
493
+ id: string;
494
+ title: string;
495
+ }[];
496
+ };
497
+ export { GetTodoItemOutput }
498
+ export { GetTodoItemOutput as GetTodoItemOutput_alias_1 }
499
+ export { GetTodoItemOutput as GetTodoItemOutput_alias_2 }
500
+
394
501
  export declare const handler: ToolHandler<typeof toolInfo, InteractionProvider>;
395
502
 
396
503
  export declare const handler_alias_1: ToolHandler<typeof toolInfo_alias_1, CommandProvider>;
@@ -399,25 +506,31 @@ export declare const handler_alias_10: ToolHandler<typeof toolInfo_alias_10, Fil
399
506
 
400
507
  export declare const handler_alias_11: ToolHandler<typeof toolInfo_alias_11, FilesystemProvider>;
401
508
 
402
- export declare const handler_alias_12: ToolHandler<typeof toolInfo_alias_12, MemoryProvider>;
509
+ export declare const handler_alias_12: ToolHandler<typeof toolInfo_alias_12, FilesystemProvider>;
403
510
 
404
511
  export declare const handler_alias_13: ToolHandler<typeof toolInfo_alias_13, FilesystemProvider>;
405
512
 
513
+ export declare const handler_alias_14: ToolHandler<typeof toolInfo_alias_14, MemoryProvider>;
514
+
515
+ export declare const handler_alias_15: ToolHandler<typeof toolInfo_alias_15, TodoProvider>;
516
+
517
+ export declare const handler_alias_16: ToolHandler<typeof toolInfo_alias_16, FilesystemProvider>;
518
+
406
519
  export declare const handler_alias_2: ToolHandler<typeof toolInfo_alias_2, WebProvider>;
407
520
 
408
- export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, FilesystemProvider>;
521
+ export declare const handler_alias_3: ToolHandler<typeof toolInfo_alias_3, TodoProvider>;
409
522
 
410
- export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, MemoryProvider>;
523
+ export declare const handler_alias_4: ToolHandler<typeof toolInfo_alias_4, FilesystemProvider>;
411
524
 
412
- export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, FilesystemProvider>;
525
+ export declare const handler_alias_5: ToolHandler<typeof toolInfo_alias_5, MemoryProvider>;
413
526
 
414
- export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, FilesystemProvider>;
527
+ export declare const handler_alias_6: ToolHandler<typeof toolInfo_alias_6, TodoProvider>;
415
528
 
416
- export declare const handler_alias_7: ToolHandler<typeof toolInfo_alias_7, MemoryProvider>;
529
+ export declare const handler_alias_7: ToolHandler<typeof toolInfo_alias_7, FilesystemProvider>;
417
530
 
418
531
  export declare const handler_alias_8: ToolHandler<typeof toolInfo_alias_8, FilesystemProvider>;
419
532
 
420
- export declare const handler_alias_9: ToolHandler<typeof toolInfo_alias_9, FilesystemProvider>;
533
+ export declare const handler_alias_9: ToolHandler<typeof toolInfo_alias_9, MemoryProvider>;
421
534
 
422
535
  declare type InteractionProvider = {
423
536
  askFollowupQuestion?: (question: string, options: string[]) => Promise<string>;
@@ -431,6 +544,11 @@ export { InteractionProvider as InteractionProvider_alias_2 }
431
544
  */
432
545
  export declare function join(...parts: string[]): string;
433
546
 
547
+ declare type ListTodoItemsOutput = TodoItem[];
548
+ export { ListTodoItemsOutput }
549
+ export { ListTodoItemsOutput as ListTodoItemsOutput_alias_1 }
550
+ export { ListTodoItemsOutput as ListTodoItemsOutput_alias_2 }
551
+
434
552
  declare interface MemoryProvider {
435
553
  listMemoryTopics: () => Promise<string[]>;
436
554
  readMemory: (topic?: string) => Promise<string | undefined>;
@@ -441,6 +559,17 @@ export { MemoryProvider as MemoryProvider_alias_1 }
441
559
  export { MemoryProvider as MemoryProvider_alias_2 }
442
560
 
443
561
  declare class MockProvider implements ToolProvider {
562
+ listTodoItems(id?: string | null, _status?: string | null): Promise<{
563
+ id: string;
564
+ title: string;
565
+ status: "open";
566
+ description: string;
567
+ relevantFileList: never[];
568
+ }[]>;
569
+ getTodoItem(id: string): Promise<GetTodoItemOutput | undefined>;
570
+ updateTodoItem(input: UpdateTodoItemInput): Promise<{
571
+ id: string;
572
+ }>;
444
573
  readFile(_path: string, _includeIgnored?: boolean): Promise<string>;
445
574
  writeFile(_path: string, _content: string): Promise<void>;
446
575
  removeFile(_path: string): Promise<void>;
@@ -512,6 +641,44 @@ export { responsePrompts }
512
641
  export { responsePrompts as responsePrompts_alias_1 }
513
642
  export { responsePrompts as responsePrompts_alias_2 }
514
643
 
644
+ declare type TodoItem = z.infer<typeof TodoItemSchema>;
645
+ export { TodoItem }
646
+ export { TodoItem as TodoItem_alias_1 }
647
+ export { TodoItem as TodoItem_alias_2 }
648
+
649
+ declare const TodoItemSchema: z.ZodObject<{
650
+ id: z.ZodString;
651
+ title: z.ZodString;
652
+ description: z.ZodString;
653
+ relevantFileList: z.ZodArray<z.ZodString>;
654
+ status: z.ZodEnum<{
655
+ open: "open";
656
+ completed: "completed";
657
+ closed: "closed";
658
+ }>;
659
+ }, z.core.$strip>;
660
+ export { TodoItemSchema }
661
+ export { TodoItemSchema as TodoItemSchema_alias_1 }
662
+ export { TodoItemSchema as TodoItemSchema_alias_2 }
663
+
664
+ declare type TodoProvider = {
665
+ listTodoItems: (id?: string | null, status?: string | null) => Promise<ListTodoItemsOutput>;
666
+ getTodoItem: (id: string) => Promise<GetTodoItemOutput | undefined>;
667
+ updateTodoItem: (input: UpdateTodoItemInput) => Promise<UpdateTodoItemOutput>;
668
+ };
669
+ export { TodoProvider }
670
+ export { TodoProvider as TodoProvider_alias_1 }
671
+ export { TodoProvider as TodoProvider_alias_2 }
672
+
673
+ declare const TodoStatus: z.ZodEnum<{
674
+ open: "open";
675
+ completed: "completed";
676
+ closed: "closed";
677
+ }>;
678
+ export { TodoStatus }
679
+ export { TodoStatus as TodoStatus_alias_1 }
680
+ export { TodoStatus as TodoStatus_alias_2 }
681
+
515
682
  declare type ToolHandler<_T, P> = (provider: P, args: Partial<Record<string, ToolParameterValue>>) => Promise<ToolResponse>;
516
683
  export { ToolHandler }
517
684
  export { ToolHandler as ToolHandler_alias_1 }
@@ -545,6 +712,23 @@ export declare const toolInfo_alias_1: {
545
712
  };
546
713
 
547
714
  export declare const toolInfo_alias_10: {
715
+ readonly name: "removeFile";
716
+ readonly description: "Request to remove a file at the specified path.";
717
+ readonly parameters: z.ZodObject<{
718
+ path: z.ZodString;
719
+ }, z.core.$strip>;
720
+ };
721
+
722
+ export declare const toolInfo_alias_11: {
723
+ readonly name: "renameFile";
724
+ readonly description: "Request to rename a file from source path to target path.";
725
+ readonly parameters: z.ZodObject<{
726
+ source_path: z.ZodString;
727
+ target_path: z.ZodString;
728
+ }, z.core.$strip>;
729
+ };
730
+
731
+ export declare const toolInfo_alias_12: {
548
732
  readonly name: "replaceInFile";
549
733
  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.";
550
734
  readonly parameters: z.ZodObject<{
@@ -553,7 +737,7 @@ export declare const toolInfo_alias_10: {
553
737
  }, z.core.$strip>;
554
738
  };
555
739
 
556
- export declare const toolInfo_alias_11: {
740
+ export declare const toolInfo_alias_13: {
557
741
  readonly name: "searchFiles";
558
742
  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.";
559
743
  readonly parameters: z.ZodObject<{
@@ -563,9 +747,9 @@ export declare const toolInfo_alias_11: {
563
747
  }, z.core.$strip>;
564
748
  };
565
749
 
566
- export declare const toolInfo_alias_12: {
750
+ export declare const toolInfo_alias_14: {
567
751
  readonly name: "updateMemory";
568
- readonly description: "Appends, replaces, or removes content from a memory topic.";
752
+ 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.";
569
753
  readonly parameters: z.ZodObject<{
570
754
  operation: z.ZodEnum<{
571
755
  append: "append";
@@ -577,7 +761,28 @@ export declare const toolInfo_alias_12: {
577
761
  }, z.core.$strip>;
578
762
  };
579
763
 
580
- export declare const toolInfo_alias_13: {
764
+ export declare const toolInfo_alias_15: {
765
+ readonly name: "updateTodoItem";
766
+ readonly description: "Add or update a to-do item.";
767
+ readonly parameters: ZodObject< {
768
+ operation: ZodEnum< {
769
+ add: "add";
770
+ update: "update";
771
+ }>;
772
+ id: ZodOptional<ZodNullable<ZodString>>;
773
+ parentId: ZodOptional<ZodNullable<ZodString>>;
774
+ title: ZodOptional<ZodNullable<ZodString>>;
775
+ description: ZodOptional<ZodNullable<ZodString>>;
776
+ relevantFileList: ZodOptional<ZodNullable<ZodArray<ZodString>>>;
777
+ status: ZodOptional<ZodNullable<ZodEnum< {
778
+ open: "open";
779
+ completed: "completed";
780
+ closed: "closed";
781
+ }>>>;
782
+ }, $strip>;
783
+ };
784
+
785
+ export declare const toolInfo_alias_16: {
581
786
  readonly name: "writeToFile";
582
787
  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.";
583
788
  readonly parameters: z.ZodObject<{
@@ -595,6 +800,14 @@ export declare const toolInfo_alias_2: {
595
800
  };
596
801
 
597
802
  export declare const toolInfo_alias_3: {
803
+ readonly name: "getTodoItem";
804
+ readonly description: "Get a to-do item by its ID.";
805
+ readonly parameters: z.ZodObject<{
806
+ id: z.ZodString;
807
+ }, z.core.$strip>;
808
+ };
809
+
810
+ export declare const toolInfo_alias_4: {
598
811
  readonly name: "listFiles";
599
812
  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.";
600
813
  readonly parameters: z.ZodObject<{
@@ -605,13 +818,26 @@ export declare const toolInfo_alias_3: {
605
818
  }, z.core.$strip>;
606
819
  };
607
820
 
608
- export declare const toolInfo_alias_4: {
821
+ export declare const toolInfo_alias_5: {
609
822
  readonly name: "listMemoryTopics";
610
- readonly description: "Lists all topics in memory.";
823
+ readonly description: "Lists all topics in memory. Use this to see what information has been stored and which topics are available to read from.";
611
824
  readonly parameters: z.ZodObject<{}, z.core.$strip>;
612
825
  };
613
826
 
614
- export declare const toolInfo_alias_5: {
827
+ export declare const toolInfo_alias_6: {
828
+ readonly name: "listTodoItems";
829
+ 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.";
830
+ readonly parameters: z.ZodObject<{
831
+ id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
832
+ status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
833
+ open: "open";
834
+ completed: "completed";
835
+ closed: "closed";
836
+ }>>>;
837
+ }, z.core.$strip>;
838
+ };
839
+
840
+ export declare const toolInfo_alias_7: {
615
841
  readonly name: "readBinaryFile";
616
842
  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.";
617
843
  readonly parameters: z.ZodObject<{
@@ -619,7 +845,7 @@ export declare const toolInfo_alias_5: {
619
845
  }, z.core.$strip>;
620
846
  };
621
847
 
622
- export declare const toolInfo_alias_6: {
848
+ export declare const toolInfo_alias_8: {
623
849
  readonly name: "readFile";
624
850
  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.";
625
851
  readonly parameters: z.ZodObject<{
@@ -628,31 +854,14 @@ export declare const toolInfo_alias_6: {
628
854
  }, z.core.$strip>;
629
855
  };
630
856
 
631
- export declare const toolInfo_alias_7: {
857
+ export declare const toolInfo_alias_9: {
632
858
  readonly name: "readMemory";
633
- readonly description: "Reads content from a memory topic.";
859
+ 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.";
634
860
  readonly parameters: z.ZodObject<{
635
861
  topic: z.ZodOptional<z.ZodString>;
636
862
  }, z.core.$strip>;
637
863
  };
638
864
 
639
- export declare const toolInfo_alias_8: {
640
- readonly name: "removeFile";
641
- readonly description: "Request to remove a file at the specified path.";
642
- readonly parameters: z.ZodObject<{
643
- path: z.ZodString;
644
- }, z.core.$strip>;
645
- };
646
-
647
- export declare const toolInfo_alias_9: {
648
- readonly name: "renameFile";
649
- readonly description: "Request to rename a file from source path to target path.";
650
- readonly parameters: z.ZodObject<{
651
- source_path: z.ZodString;
652
- target_path: z.ZodString;
653
- }, z.core.$strip>;
654
- };
655
-
656
865
  declare type ToolParameter = {
657
866
  name: string;
658
867
  description: string;
@@ -670,7 +879,7 @@ declare type ToolParameterValue = string | {
670
879
  export { ToolParameterValue }
671
880
  export { ToolParameterValue as ToolParameterValue_alias_1 }
672
881
 
673
- declare type ToolProvider = FilesystemProvider & CommandProvider & InteractionProvider & WebProvider & Partial<MemoryProvider>;
882
+ declare type ToolProvider = FilesystemProvider & CommandProvider & InteractionProvider & WebProvider & Partial<MemoryProvider> & Partial<TodoProvider>;
674
883
  export { ToolProvider }
675
884
  export { ToolProvider as ToolProvider_alias_1 }
676
885
  export { ToolProvider as ToolProvider_alias_2 }
@@ -748,6 +957,43 @@ declare type Totals = {
748
957
  messageCount: number;
749
958
  };
750
959
 
960
+ declare type UpdateTodoItemInput = z.infer<typeof UpdateTodoItemInputSchema>;
961
+ export { UpdateTodoItemInput }
962
+ export { UpdateTodoItemInput as UpdateTodoItemInput_alias_1 }
963
+ export { UpdateTodoItemInput as UpdateTodoItemInput_alias_2 }
964
+
965
+ declare const UpdateTodoItemInputSchema: z.ZodObject<{
966
+ operation: z.ZodEnum<{
967
+ add: "add";
968
+ update: "update";
969
+ }>;
970
+ id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
971
+ parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
972
+ title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
973
+ description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
974
+ relevantFileList: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
975
+ status: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
976
+ open: "open";
977
+ completed: "completed";
978
+ closed: "closed";
979
+ }>>>;
980
+ }, z.core.$strip>;
981
+ export { UpdateTodoItemInputSchema }
982
+ export { UpdateTodoItemInputSchema as UpdateTodoItemInputSchema_alias_1 }
983
+ export { UpdateTodoItemInputSchema as UpdateTodoItemInputSchema_alias_2 }
984
+
985
+ declare type UpdateTodoItemOutput = z.infer<typeof UpdateTodoItemOutputSchema>;
986
+ export { UpdateTodoItemOutput }
987
+ export { UpdateTodoItemOutput as UpdateTodoItemOutput_alias_1 }
988
+ export { UpdateTodoItemOutput as UpdateTodoItemOutput_alias_2 }
989
+
990
+ declare const UpdateTodoItemOutputSchema: z.ZodObject<{
991
+ id: z.ZodString;
992
+ }, z.core.$strip>;
993
+ export { UpdateTodoItemOutputSchema }
994
+ export { UpdateTodoItemOutputSchema as UpdateTodoItemOutputSchema_alias_1 }
995
+ export { UpdateTodoItemOutputSchema as UpdateTodoItemOutputSchema_alias_2 }
996
+
751
997
  /**
752
998
  * Tracks token / cost usage across any mix of LLM models.
753
999
  * Supports optional caps on total messages and total cost.