@polka-codes/cli-shared 0.9.79 → 0.9.81

package/dist/index.js

@@ -47675,12 +47675,6 @@ function date4(params) {
 // ../../node_modules/zod/v4/classic/external.js
 config(en_default());
 // ../core/src/config.ts
-var providerModelSchema = exports_external.object({
-  provider: exports_external.string().optional(),
-  model: exports_external.string().optional(),
-  parameters: exports_external.record(exports_external.string(), exports_external.any()).optional(),
-  budget: exports_external.number().positive().optional()
-});
 var ruleSchema = exports_external.union([
   exports_external.string(),
   exports_external.object({ path: exports_external.string() }).strict(),
@@ -47693,6 +47687,13 @@ var ruleSchema = exports_external.union([
     branch: exports_external.string().optional()
   }).strict()
 ]);
+var providerModelSchema = exports_external.object({
+  provider: exports_external.string().optional(),
+  model: exports_external.string().optional(),
+  parameters: exports_external.record(exports_external.string(), exports_external.any()).optional(),
+  budget: exports_external.number().positive().optional(),
+  rules: exports_external.array(ruleSchema).optional().or(exports_external.string()).optional()
+});
 var configSchema = exports_external.object({
   prices: exports_external.record(exports_external.string(), exports_external.record(exports_external.string(), exports_external.object({
     inputPrice: exports_external.number().optional(),
@@ -47785,7 +47786,7 @@ var toolInfo = {
 var handler = async (provider, args) => {
   if (!provider.askFollowupQuestion) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to ask followup question."
@@ -47795,7 +47796,7 @@ var handler = async (provider, args) => {
   const { questions } = toolInfo.parameters.parse(args);
   if (questions.length === 0) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "No questions provided"
@@ -47811,7 +47812,7 @@ ${answer}
 </ask_followup_question_answer>`);
   }
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: answers.join(`
@@ -47854,7 +47855,7 @@ var toolInfo2 = {
 var handler2 = async (provider, args) => {
   if (!provider.executeCommand) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to execute command. Abort."
@@ -47883,7 +47884,7 @@ ${result.stderr}
     }
     if (result.exitCode === 0) {
       return {
-        type: "Reply" /* Reply */,
+        success: true,
         message: {
           type: "text",
           value: message
@@ -47891,7 +47892,7 @@ ${result.stderr}
       };
     }
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: message
@@ -47899,7 +47900,7 @@ ${result.stderr}
     };
   } catch (error46) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: error46 instanceof Error ? error46.message : String(error46)
@@ -47948,7 +47949,7 @@ var toolInfo3 = {
 var handler3 = async (provider, args) => {
   if (!provider.fetchUrl) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to fetch url."
@@ -47958,7 +47959,7 @@ var handler3 = async (provider, args) => {
   const { url: urls } = toolInfo3.parameters.parse(args);
   if (urls.length === 0) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "No URLs provided. Please provide at least one URL to fetch."
@@ -47977,7 +47978,7 @@ var handler3 = async (provider, args) => {
   }
   const resolvedResults = await Promise.all(results);
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: resolvedResults.join(`
@@ -47989,40 +47990,8 @@ var fetchUrl_default = {
   ...toolInfo3,
   handler: handler3
 };
-// ../core/src/tools/getTodoItem.ts
-var toolInfo4 = {
-  name: "getTodoItem",
-  description: "Get a to-do item by its ID.",
-  parameters: exports_external.object({
-    id: exports_external.string().describe("The ID of the to-do item.")
-  })
-};
-var handler4 = async (provider, args) => {
-  if (!provider.getTodoItem) {
-    return {
-      type: "Error" /* Error */,
-      message: {
-        type: "error-text",
-        value: "Not possible to get a to-do item."
-      }
-    };
-  }
-  const { id } = toolInfo4.parameters.parse(args);
-  const item = await provider.getTodoItem(id);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "json",
-      value: item ?? null
-    }
-  };
-};
-var getTodoItem_default = {
-  ...toolInfo4,
-  handler: handler4
-};
 // ../core/src/tools/listFiles.ts
-var toolInfo5 = {
+var toolInfo4 = {
   name: "listFiles",
   description: "Request to list files and directories within the specified directory. If recursive is true, it will list all files and directories recursively. If recursive is false or not provided, it will only list the top-level contents. Do not use this tool to confirm the existence of files you may have created, as the user will let you know if the files were created successfully or not.",
   parameters: exports_external.object({
@@ -48060,20 +48029,20 @@ var toolInfo5 = {
     ]
   })
 };
-var handler5 = async (provider, args) => {
+var handler4 = async (provider, args) => {
   if (!provider.listFiles) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to list files."
       }
     };
   }
-  const { path, maxCount, recursive, includeIgnored } = toolInfo5.parameters.parse(args);
+  const { path, maxCount, recursive, includeIgnored } = toolInfo4.parameters.parse(args);
   const [files, limitReached] = await provider.listFiles(path, recursive, maxCount, includeIgnored);
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: `<list_files_path>${path}</list_files_path>
@@ -48086,128 +48055,32 @@ ${files.join(`
   };
 };
 var listFiles_default = {
-  ...toolInfo5,
-  handler: handler5
-};
-// ../core/src/tools/listMemoryTopics.ts
-var toolInfo6 = {
-  name: "listMemoryTopics",
-  description: "Lists all topics in memory. Use this to see what information has been stored and which topics are available to read from.",
-  parameters: exports_external.object({})
-};
-var handler6 = async (provider, _args) => {
-  const topics = await provider.listMemoryTopics();
-  if (!topics.length) {
-    return { type: "Reply" /* Reply */, message: { type: "text", value: "No topics found." } };
-  }
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "text",
-      value: `Memory topics:
-${topics.join(`
-`)}`
-    }
-  };
-};
-var listMemoryTopics_default = {
-  ...toolInfo6,
-  handler: handler6
-};
-// ../core/src/tools/todo.ts
-var TodoStatus = exports_external.enum(["open", "completed", "closed"]);
-var TodoItemSchema = exports_external.object({
-  id: exports_external.string(),
-  title: exports_external.string(),
-  description: exports_external.string(),
-  status: TodoStatus
-});
-var UpdateTodoItemInputSchema = exports_external.object({
-  operation: exports_external.enum(["add", "update"]),
-  id: exports_external.string().nullish(),
-  parentId: exports_external.string().nullish(),
-  title: exports_external.string().nullish(),
-  description: exports_external.string().nullish(),
-  status: TodoStatus.nullish()
-}).superRefine((data, ctx) => {
-  if (data.operation === "add") {
-    if (!data.title) {
-      ctx.addIssue({
-        code: "custom",
-        message: 'Title is required for "add" operation',
-        path: ["title"]
-      });
-    }
-  } else if (data.operation === "update") {
-    if (!data.id) {
-      ctx.addIssue({
-        code: "custom",
-        message: 'ID is required for "update" operation',
-        path: ["id"]
-      });
-    }
-  }
-});
-var UpdateTodoItemOutputSchema = exports_external.object({
-  id: exports_external.string()
-});
-
-// ../core/src/tools/listTodoItems.ts
-var toolInfo7 = {
-  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: exports_external.object({
-    id: exports_external.string().nullish(),
-    status: TodoStatus.nullish()
-  })
-};
-var handler7 = async (provider, args) => {
-  if (!provider.listTodoItems) {
-    return {
-      type: "Error" /* Error */,
-      message: {
-        type: "error-text",
-        value: "Not possible to list to-do items."
-      }
-    };
-  }
-  const { id, status } = toolInfo7.parameters.parse(args);
-  const items = await provider.listTodoItems(id, status);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "json",
-      value: items
-    }
-  };
-};
-var listTodoItems_default = {
-  ...toolInfo7,
-  handler: handler7
+  ...toolInfo4,
+  handler: handler4
 };
 // ../core/src/tools/readBinaryFile.ts
-var toolInfo8 = {
+var toolInfo5 = {
   name: "readBinaryFile",
   description: "Read a binary file from a URL or local path. Use file:// prefix to access local files. This can be used to access non-text files such as PDFs or images.",
   parameters: exports_external.object({
     url: exports_external.string().describe("The URL or local path of the file to read.")
   })
 };
-var handler8 = async (provider, args) => {
+var handler5 = async (provider, args) => {
   if (!provider.readBinaryFile) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to fetch files. Abort."
       }
     };
   }
-  const { url: url2 } = toolInfo8.parameters.parse(args);
+  const { url: url2 } = toolInfo5.parameters.parse(args);
   try {
     const filePart = await provider.readBinaryFile(url2);
     return {
-      type: "Reply" /* Reply */,
+      success: true,
       message: {
         type: "content",
         value: [
@@ -48223,7 +48096,7 @@ var handler8 = async (provider, args) => {
   } catch (error46) {
     const errorMessage = error46 instanceof Error ? error46.message : "Unknown error";
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Error fetching file from ${url2}: ${errorMessage}`
@@ -48232,11 +48105,11 @@ var handler8 = async (provider, args) => {
   }
 };
 var readBinaryFile_default = {
-  ...toolInfo8,
-  handler: handler8
+  ...toolInfo5,
+  handler: handler5
 };
 // ../core/src/tools/readFile.ts
-var toolInfo9 = {
+var toolInfo6 = {
   name: "readFile",
   description: "Request to read the contents of one or multiple files at the specified paths. Use comma separated paths to read multiple files. Use this when you need to examine the contents of an existing file you do not know the contents of, for example to analyze code, review text files, or extract information from configuration files. May not be suitable for other types of binary files, as it returns the raw content as a string. Try to list all the potential files are relevent to the task, and then use this tool to read all the relevant files.",
   parameters: exports_external.object({
@@ -48273,17 +48146,17 @@ var toolInfo9 = {
     ]
   })
 };
-var handler9 = async (provider, args) => {
+var handler6 = async (provider, args) => {
   if (!provider.readFile) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to read file."
       }
     };
   }
-  const { path: paths, includeIgnored } = toolInfo9.parameters.parse(args);
+  const { path: paths, includeIgnored } = toolInfo6.parameters.parse(args);
   const resp = [];
   for (const path of paths) {
     const fileContent = await provider.readFile(path, includeIgnored ?? false);
@@ -48299,7 +48172,7 @@ var handler9 = async (provider, args) => {
     }
   }
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: resp.join(`
@@ -48308,45 +48181,11 @@ var handler9 = async (provider, args) => {
   };
 };
 var readFile_default = {
-  ...toolInfo9,
-  handler: handler9
-};
-// ../core/src/tools/readMemory.ts
-var toolInfo10 = {
-  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: exports_external.object({
-    topic: exports_external.string().nullish().describe('The topic to read from memory. Defaults to ":default:".')
-  })
-};
-var handler10 = async (provider, args) => {
-  const { topic } = toolInfo10.parameters.parse(args);
-  const content = await provider.readMemory(topic ?? undefined);
-  if (content) {
-    return {
-      type: "Reply" /* Reply */,
-      message: {
-        type: "text",
-        value: `<memory${topic ? ` topic="${topic}"` : ""}>
-${content}
-</memory>`
-      }
-    };
-  }
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "text",
-      value: `<memory ${topic ? `topic="${topic}"` : ""} isEmpty="true" />`
-    }
-  };
-};
-var readMemory_default = {
-  ...toolInfo10,
-  handler: handler10
+  ...toolInfo6,
+  handler: handler6
 };
 // ../core/src/tools/removeFile.ts
-var toolInfo11 = {
+var toolInfo7 = {
   name: "removeFile",
   description: "Request to remove a file at the specified path.",
   parameters: exports_external.object({
@@ -48362,20 +48201,20 @@ var toolInfo11 = {
     ]
   })
 };
-var handler11 = async (provider, args) => {
+var handler7 = async (provider, args) => {
   if (!provider.removeFile) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to remove file."
       }
     };
   }
-  const parsed = toolInfo11.parameters.safeParse(args);
+  const parsed = toolInfo7.parameters.safeParse(args);
   if (!parsed.success) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Invalid arguments for removeFile: ${parsed.error.message}`
@@ -48385,7 +48224,7 @@ var handler11 = async (provider, args) => {
   const { path } = parsed.data;
   await provider.removeFile(path);
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: `<remove_file_path>${path}</remove_file_path><status>Success</status>`
@@ -48393,11 +48232,11 @@ var handler11 = async (provider, args) => {
   };
 };
 var removeFile_default = {
-  ...toolInfo11,
-  handler: handler11
+  ...toolInfo7,
+  handler: handler7
 };
 // ../core/src/tools/renameFile.ts
-var toolInfo12 = {
+var toolInfo8 = {
   name: "renameFile",
   description: "Request to rename a file from source path to target path.",
   parameters: exports_external.object({
@@ -48415,20 +48254,20 @@ var toolInfo12 = {
     ]
   })
 };
-var handler12 = async (provider, args) => {
+var handler8 = async (provider, args) => {
   if (!provider.renameFile) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to rename file."
       }
     };
   }
-  const { source_path, target_path } = toolInfo12.parameters.parse(args);
+  const { source_path, target_path } = toolInfo8.parameters.parse(args);
   await provider.renameFile(source_path, target_path);
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: `<rename_file_path>${target_path}</rename_file_path><status>Success</status>`
@@ -48436,8 +48275,8 @@ var handler12 = async (provider, args) => {
   };
 };
 var renameFile_default = {
-  ...toolInfo12,
-  handler: handler12
+  ...toolInfo8,
+  handler: handler8
 };
 // ../core/src/tools/utils/replaceInFile.ts
 var replaceInFile = (fileContent, diff) => {
@@ -48514,7 +48353,7 @@ var replaceInFile = (fileContent, diff) => {
 };
 
 // ../core/src/tools/replaceInFile.ts
-var toolInfo13 = {
+var toolInfo9 = {
   name: "replaceInFile",
   description: "Request to replace sections of content in an existing file using SEARCH/REPLACE blocks that define exact changes to specific parts of the file. This tool should be used when you need to make targeted changes to specific parts of a file.",
   parameters: exports_external.object({
@@ -48624,20 +48463,20 @@ function oldFeature() {
     ]
   })
 };
-var handler13 = async (provider, args) => {
+var handler9 = async (provider, args) => {
   if (!provider.readFile || !provider.writeFile) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to replace in file."
       }
     };
   }
-  const parsed = toolInfo13.parameters.safeParse(args);
+  const parsed = toolInfo9.parameters.safeParse(args);
   if (!parsed.success) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Invalid arguments for replaceInFile: ${parsed.error.message}`
@@ -48649,7 +48488,7 @@ var handler13 = async (provider, args) => {
     const fileContent = await provider.readFile(path, false);
     if (fileContent == null) {
       return {
-        type: "Error" /* Error */,
+        success: false,
         message: {
           type: "error-text",
           value: `<replace_in_file_result path="${path}" status="failed" message="File not found" />`
@@ -48659,7 +48498,7 @@ var handler13 = async (provider, args) => {
     const result = replaceInFile(fileContent, diff);
     if (result.status === "no_diff_applied") {
       return {
-        type: "Error" /* Error */,
+        success: false,
         message: {
           type: "error-text",
           value: `<replace_in_file_result path="${path}" status="failed" message="Unable to apply changes">
@@ -48671,7 +48510,7 @@ var handler13 = async (provider, args) => {
     await provider.writeFile(path, result.content);
     if (result.status === "some_diff_applied") {
       return {
-        type: "Reply" /* Reply */,
+        success: true,
         message: {
           type: "text",
           value: `<replace_in_file_result path="${path}" status="some_diff_applied" applied_count="${result.appliedCount}" total_count="${result.totalCount}">
@@ -48681,7 +48520,7 @@ var handler13 = async (provider, args) => {
       };
     }
     return {
-      type: "Reply" /* Reply */,
+      success: true,
       message: {
         type: "text",
         value: `<replace_in_file_result path="${path}" status="all_diff_applied" />`
@@ -48689,7 +48528,7 @@ var handler13 = async (provider, args) => {
     };
   } catch (error46) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Invalid arguments for replaceInFile: ${error46}`
@@ -48698,11 +48537,11 @@ var handler13 = async (provider, args) => {
   }
 };
 var replaceInFile_default = {
-  ...toolInfo13,
-  handler: handler13
+  ...toolInfo9,
+  handler: handler9
 };
 // ../core/src/tools/search.ts
-var toolInfo14 = {
+var toolInfo10 = {
   name: "search",
   description: "Search the web for information using Google Search. Use this tool to find current information, facts, news, documentation, or research that is not available in your training data. Returns comprehensive search results with relevant content extracted from the web.",
   parameters: exports_external.object({
@@ -48730,11 +48569,11 @@ var toolInfo14 = {
     ]
   })
 };
-var handler14 = async (provider, args) => {
-  const { query } = toolInfo14.parameters.parse(args);
+var handler10 = async (provider, args) => {
+  const { query } = toolInfo10.parameters.parse(args);
   if (!provider.search) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "text",
         value: "This tool requires a web provider to be installed."
@@ -48743,7 +48582,7 @@ var handler14 = async (provider, args) => {
   }
   const result = await provider.search(query);
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: result
@@ -48751,11 +48590,11 @@ var handler14 = async (provider, args) => {
   };
 };
 var search_default = {
-  ...toolInfo14,
-  handler: handler14
+  ...toolInfo10,
+  handler: handler10
 };
 // ../core/src/tools/searchFiles.ts
-var toolInfo15 = {
+var toolInfo11 = {
   name: "searchFiles",
   description: "Request to perform a regex search across files in a specified directory, outputting context-rich results that include surrounding lines. This tool searches for patterns or specific content across multiple files, displaying each match with encapsulating context.",
   parameters: exports_external.object({
@@ -48779,20 +48618,20 @@ var toolInfo15 = {
     ]
   })
 };
-var handler15 = async (provider, args) => {
+var handler11 = async (provider, args) => {
   if (!provider.searchFiles) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to search files."
       }
     };
   }
-  const parsed = toolInfo15.parameters.safeParse(args);
+  const parsed = toolInfo11.parameters.safeParse(args);
   if (!parsed.success) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Invalid arguments for searchFiles: ${parsed.error.message}`
@@ -48803,7 +48642,7 @@ var handler15 = async (provider, args) => {
   try {
     const files = await provider.searchFiles(path, regex, filePattern ?? "*");
     return {
-      type: "Reply" /* Reply */,
+      success: true,
       message: {
         type: "text",
         value: `<search_files_path>${path}</search_files_path>
@@ -48818,7 +48657,7 @@ ${files.join(`
     };
   } catch (error46) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Error searching files: ${error46}`
@@ -48827,112 +48666,48 @@ ${files.join(`
   }
 };
 var searchFiles_default = {
-  ...toolInfo15,
-  handler: handler15
+  ...toolInfo11,
+  handler: handler11
 };
-// ../core/src/tools/updateMemory.ts
-var toolInfo16 = {
-  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: exports_external.object({
-    operation: exports_external.enum(["append", "replace", "remove"]).describe("The operation to perform."),
-    topic: exports_external.string().nullish().describe('The topic to update in memory. Defaults to ":default:".'),
-    content: exports_external.string().nullish().describe("The content for append or replace operations. Must be omitted for remove operation.")
-  }).superRefine((data, ctx) => {
-    if (data.operation === "append" || data.operation === "replace") {
-      if (data.content === undefined) {
-        ctx.addIssue({
-          code: "custom",
-          message: 'Content is required for "append" and "replace" operations.',
-          path: ["content"]
-        });
-      }
-    } else if (data.operation === "remove") {
-      if (data.content !== undefined) {
-        ctx.addIssue({
-          code: "custom",
-          message: 'Content must not be provided for "remove" operation.',
-          path: ["content"]
-        });
-      }
+// ../core/src/tools/todo.ts
+var TodoStatus = exports_external.enum(["open", "completed", "closed"]);
+var TodoItemSchema = exports_external.object({
+  id: exports_external.string(),
+  title: exports_external.string(),
+  description: exports_external.string(),
+  status: TodoStatus
+});
+var UpdateTodoItemInputSchema = exports_external.object({
+  operation: exports_external.enum(["add", "update"]),
+  id: exports_external.string().nullish(),
+  parentId: exports_external.string().nullish(),
+  title: exports_external.string().nullish(),
+  description: exports_external.string().nullish(),
+  status: TodoStatus.nullish()
+}).superRefine((data, ctx) => {
+  if (data.operation === "add") {
+    if (!data.title) {
+      ctx.addIssue({
+        code: "custom",
+        message: 'Title is required for "add" operation',
+        path: ["title"]
+      });
     }
-  })
-};
-var handler16 = async (provider, args) => {
-  if (!provider.updateMemory) {
-    return {
-      type: "Error" /* Error */,
-      message: {
-        type: "error-text",
-        value: "Memory operations are not supported by the current provider."
-      }
-    };
-  }
-  const params = toolInfo16.parameters.parse(args);
-  await provider.updateMemory(params.operation, params.topic ?? undefined, params.content ?? undefined);
-  switch (params.operation) {
-    case "append":
-      return {
-        type: "Reply" /* Reply */,
-        message: {
-          type: "text",
-          value: `Content appended to memory topic '${params.topic || ":default:"}'.`
-        }
-      };
-    case "replace":
-      return {
-        type: "Reply" /* Reply */,
-        message: {
-          type: "text",
-          value: `Memory topic '${params.topic || ":default:"}' replaced.`
-        }
-      };
-    case "remove":
-      return {
-        type: "Reply" /* Reply */,
-        message: {
-          type: "text",
-          value: `Memory topic '${params.topic || ":default:"}' removed.`
-        }
-      };
-  }
-};
-var updateMemory_default = {
-  ...toolInfo16,
-  handler: handler16
-};
-// ../core/src/tools/updateTodoItem.ts
-var toolInfo17 = {
-  name: "updateTodoItem",
-  description: "Add or update a to-do item.",
-  parameters: UpdateTodoItemInputSchema
-};
-var handler17 = async (provider, args) => {
-  if (!provider.updateTodoItem) {
-    return {
-      type: "Error" /* Error */,
-      message: {
-        type: "error-text",
-        value: "Not possible to update a to-do item."
-      }
-    };
-  }
-  const input = toolInfo17.parameters.parse(args);
-  const result = await provider.updateTodoItem(input);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "json",
-      value: result
+  } else if (data.operation === "update") {
+    if (!data.id) {
+      ctx.addIssue({
+        code: "custom",
+        message: 'ID is required for "update" operation',
+        path: ["id"]
+      });
     }
-  };
-};
-var updateTodoItem_default = {
-  ...toolInfo17,
-  handler: handler17
-};
+  }
+});
+var UpdateTodoItemOutputSchema = exports_external.object({
+  id: exports_external.string()
+});
 // ../core/src/tools/writeToFile.ts
-var toolInfo18 = {
+var toolInfo12 = {
   name: "writeToFile",
   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.",
   parameters: exports_external.object({
@@ -48961,20 +48736,20 @@ export default App;
     ]
   })
 };
-var handler18 = async (provider, args) => {
+var handler12 = async (provider, args) => {
   if (!provider.writeFile) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to write file."
       }
     };
   }
-  const parsed = toolInfo18.parameters.safeParse(args);
+  const parsed = toolInfo12.parameters.safeParse(args);
   if (!parsed.success) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Invalid arguments for writeToFile: ${parsed.error.message}`
@@ -48987,7 +48762,7 @@ var handler18 = async (provider, args) => {
     content = trimmedContent.slice(9, -3);
   await provider.writeFile(path, content);
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: `<write_to_file_path>${path}</write_to_file_path><status>Success</status>`
@@ -48995,8 +48770,8 @@ var handler18 = async (provider, args) => {
   };
 };
 var writeToFile_default = {
-  ...toolInfo18,
-  handler: handler18
+  ...toolInfo12,
+  handler: handler12
 };
 // ../core/src/UsageMeter.ts
 class UsageMeter {
@@ -58816,7 +58591,8 @@ var WorkflowStepDefinitionSchema = exports_external.object({
   output: exports_external.string().nullish(),
   expected_outcome: exports_external.string().nullish(),
   code: exports_external.string().nullish(),
-  outputSchema: exports_external.any().nullish()
+  outputSchema: exports_external.any().nullish(),
+  timeout: exports_external.number().positive().nullish()
 });
 var WorkflowDefinitionSchema = exports_external.object({
   task: exports_external.string(),
@@ -58830,17 +58606,383 @@ var WorkflowFileSchema = exports_external.object({
 
 // ../core/src/workflow/dynamic.ts
 var AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
+// ../core/src/workflow/prompts/dynamic-generator-prompts.ts
+var RUNTIME_CONTEXT_TYPES = `## Runtime context (ctx)
+\`\`\`ts
+// Runtime types (for reference)
+type Logger = {
+  debug: (...args: any[]) => void
+  info: (...args: any[]) => void
+  warn: (...args: any[]) => void
+  error: (...args: any[]) => void
+}
+
+type StepFn = {
+  <T>(name: string, fn: () => Promise<T>): Promise<T>
+  <T>(name: string, options: { retry?: number }, fn: () => Promise<T>): Promise<T>
+}
+
+type JsonModelMessage = { role: 'system' | 'user' | 'assistant' | 'tool'; content: any }
+type JsonResponseMessage = { role: 'assistant' | 'tool'; content: any }
+type ToolSet = Record<string, any>
+
+type ToolResponseResult =
+  | { type: 'text'; value: string }
+  | { type: 'json'; value: any }
+  | { type: 'error-text'; value: string }
+  | { type: 'error-json'; value: any }
+  | { type: 'content'; value: any[] }
+
+type ToolResponse =
+  | { type: 'Reply'; message: ToolResponseResult }
+  | { type: 'Exit'; message: string; object?: any }
+  | { type: 'Error'; message: ToolResponseResult }
+
+type ExitReason =
+  | { type: 'UsageExceeded' }
+  | { type: 'Exit'; message: string; object?: any }
+  | { type: 'Error'; error: { message: string; stack?: string } }
+
+type FullToolInfo = { name: string; description: string; parameters: any; handler: any }
+
+type AgentTools = {
+  readFile: (input: { path: string }) => Promise<string | null>
+  writeToFile: (input: { path: string; content: string }) => Promise<void>
+  executeCommand: (input: { command: string; pipe?: boolean; requiresApproval?: boolean } & ({ args: string[]; shell?: false } | { shell: true })) => Promise<{
+    exitCode: number
+    stdout: string
+    stderr: string
+  }>
+  searchFiles: (input: { path: string; regex: string; filePattern?: string }) => Promise<string>
+  listFiles: (input: { path: string; recursive?: boolean; maxCount?: number; includeIgnored?: boolean }) => Promise<string>
+  fetchUrl: (input: { url: string[] }) => Promise<string>
+  askFollowupQuestion: (input: { questions: { prompt: string; options?: string[] }[] }) => Promise<any>
+  // ... and other tools available in the environment
+}
+
+// Tools available on ctx.tools in dynamic steps
+type DynamicWorkflowTools = {
+  // LLM + agent helpers
+  runAgent: (input: {
+    tools: Readonly<FullToolInfo[]>
+    maxToolRoundTrips?: number
+    userMessage: readonly JsonModelMessage[]
+  } & ({ messages: JsonModelMessage[] } | { systemPrompt: string })) => Promise<ExitReason>
+
+  // CLI UX helpers
+  confirm: (input: { message: string }) => Promise<boolean>
+  input: (input: { message: string; default?: string }) => Promise<string>
+  select: (input: { message: string; choices: { name: string; value: string }[] }) => Promise<string>
+}
+
+type DynamicStepRuntimeContext = {
+  workflowId: string
+  stepId: string
+  input: Record<string, any>
+  state: Record<string, any>
+  tools: DynamicWorkflowTools
+  agentTools: AgentTools
+  logger: Logger
+  step: StepFn
+  runWorkflow: (workflowId: string, input?: Record<string, any>) => Promise<any>
+  toolInfo?: ReadonlyArray<FullToolInfo>
+}
+\`\`\`
+
+- \`ctx.input\`: workflow inputs (read-only).
+- \`ctx.state\`: shared state between steps (previous step outputs are stored here).
+- \`ctx.agentTools\`: standard tools (readFile, executeCommand, etc.). Call as \`await ctx.agentTools.someTool({ ... })\`.
+- \`ctx.tools\`: workflow helpers (runAgent, confirm, input, select).
+- \`ctx.runWorkflow\`: run a sub-workflow by id.`;
+var CONTEXT_USAGE_GUIDELINES = `## Guidelines
+- Use \`await\` for all async operations.
+- Return the output value for the step (this becomes the step output).
+- Access inputs via \`ctx.input.<inputId>\`.
+- Access previous step outputs via \`ctx.state.<stepOutputKey>\` (defaults to the step \`output\` or \`id\`).`;
+var QUALITY_GUIDELINES = `## Quality Guidelines for Code Implementation
+
+### Error Handling
+- ALWAYS validate inputs at the start of steps
+- Use try-catch for operations that might fail (file I/O, parsing, API calls)
+- Preserve stack traces: re-throw original errors rather than creating new ones
+- Use error type guards: \`const err = error instanceof Error ? error : new Error(String(error))\`
+- Check for null/undefined before using values
+- Handle edge cases (empty arrays, missing files, invalid data)
+
+### Logging
+- Use \`ctx.logger.info()\` for important progress updates
+- Use \`ctx.logger.debug()\` for detailed information
+- Use \`ctx.logger.warn()\` for recoverable issues
+- Use \`ctx.logger.error()\` before throwing errors
+- Log when starting and completing significant operations
+- Use template literals for readability: \`ctx.logger.info(\\\`Processing \${items.length} items...\\\`)\`
+
+### User Experience
+- Provide progress feedback for long operations
+- Return structured data (objects/arrays), not strings when possible
+- Include helpful metadata in results (counts, timestamps, status)
+- For batch operations, report progress: \`Processed 5/10 items\`
+
+### Data Validation
+- Validate required fields exist before accessing
+- Check data types match expectations
+- Validate array lengths before iteration
+- Example: \`if (!data?.users || !Array.isArray(data.users)) throw new Error('Invalid data format')\`
+
+### Best Practices
+- Use meaningful variable names
+- Avoid nested callbacks - use async/await
+- Clean up resources (close files, clear timeouts)
+- Return consistent data structures across similar steps
+- For iteration, consider batching or rate limiting
+
+### When to Simplify
+- Simple transformation steps (e.g., formatting strings) need only basic error handling
+- Internal sub-workflow steps with validated inputs from parent can skip redundant validation
+- Minimal logging is fine for fast steps (<100ms) that don't perform I/O or external calls
+- Use judgment: match error handling complexity to the step's failure risk and impact`;
+var TOOL_CALLING_EXAMPLES = `## Tool calling examples
+
+### Standard tools (ctx.agentTools)
+\`\`\`ts
+// readFile
+const readme = await ctx.agentTools.readFile({ path: 'README.md' })
+if (readme == null) throw new Error('README.md not found')
+
+// writeToFile
+await ctx.agentTools.writeToFile({ path: 'notes.txt', content: 'hello\\n' })
+
+// executeCommand (args form)
+const rg = await ctx.agentTools.executeCommand({ command: 'rg', args: ['-n', 'TODO', '.'] })
+if (rg.exitCode !== 0) throw new Error(rg.stderr)
+
+// executeCommand (shell form)
+await ctx.agentTools.executeCommand({ command: 'ls -la', shell: true, pipe: true })
+\`\`\`
+
+### Workflow helpers (ctx.tools)
+\`\`\`ts
+// runAgent (nested agent; use ctx.toolInfo as the tool list)
+const agentRes = await ctx.tools.runAgent({
+  systemPrompt: 'You are a helpful assistant.',
+  userMessage: [{ role: 'user', content: 'Summarize README.md in 3 bullets.' }],
+  tools: (ctx.toolInfo ?? []) as any,
+})
+if (agentRes.type !== 'Exit') throw new Error('runAgent failed')
+
+// confirm / input / select (interactive)
+const ok = await ctx.tools.confirm({ message: 'Proceed?' })
+const name = await ctx.tools.input({ message: 'Name?', default: 'main' })
+const flavor = await ctx.tools.select({
+  message: 'Pick one',
+  choices: [
+    { name: 'A', value: 'a' },
+    { name: 'B', value: 'b' },
+  ],
+})
+\`\`\`
+
+### Sub-workflow example (ctx.runWorkflow)
+\`\`\`ts
+const results: any[] = []
+for (const pr of ctx.state.prs ?? []) {
+  results.push(await ctx.runWorkflow('reviewPR', { prId: pr.id }))
+}
+return results
+\`\`\``;
+var COMPLETE_STEP_EXAMPLE = `## Complete Example: High-Quality Step Implementation
+
+This example demonstrates all quality guidelines in a single step:
+
+\`\`\`ts
+// Step: processUserData
+// Task: Read, validate, and process user data from a file
+
+// Input validation
+if (!ctx.input.dataFile) {
+  throw new Error('Missing required input: dataFile')
+}
+
+ctx.logger.info(\`Starting user data processing for: \${ctx.input.dataFile}\`)
+
+// Read file with error handling
+let rawData
+try {
+  ctx.logger.debug(\`Reading file: \${ctx.input.dataFile}\`)
+  rawData = await ctx.agentTools.readFile({ path: ctx.input.dataFile })
+
+  if (!rawData) {
+    throw new Error(\`File not found or empty: \${ctx.input.dataFile}\`)
+  }
+} catch (error) {
+  const err = error instanceof Error ? error : new Error(String(error))
+  ctx.logger.error(\`Failed to read file: \${err.message}\`)
+  throw err  // Preserve original stack trace
+}
+
+// Parse and validate data
+let users
+try {
+  ctx.logger.debug('Parsing JSON data')
+  const parsed = JSON.parse(rawData)
+
+  if (!parsed?.users || !Array.isArray(parsed.users)) {
+    throw new Error('Invalid data format: expected {users: [...]}')
+  }
+
+  users = parsed.users
+  ctx.logger.info(\`Found \${users.length} users to process\`)
+} catch (error) {
+  const err = error instanceof Error ? error : new Error(String(error))
+  ctx.logger.error(\`Data parsing failed: \${err.message}\`)
+  throw err  // Preserve original stack trace
+}
+
+// Process each user with progress reporting
+const results = []
+for (let i = 0; i < users.length; i++) {
+  const user = users[i]
+
+  // Validate each user object
+  if (!user?.id || !user?.email) {
+    ctx.logger.warn(\`Skipping invalid user at index \${i}: missing id or email\`)
+    continue
+  }
+
+  // Process user
+  const processed = {
+    id: user.id,
+    email: user.email.toLowerCase().trim(),
+    name: user.name?.trim() || 'Unknown',
+    processedAt: new Date().toISOString(),
+    status: 'active'
+  }
+
+  results.push(processed)
+
+  // Progress feedback every 10 items
+  if ((i + 1) % 10 === 0) {
+    ctx.logger.info(\`Processed \${i + 1}/\${users.length} users\`)
+  }
+}
+
+ctx.logger.info(\`Successfully processed \${results.length}/\${users.length} users\`)
+
+// Return structured result with metadata
+return {
+  users: results,
+  metadata: {
+    totalInput: users.length,
+    totalProcessed: results.length,
+    skipped: users.length - results.length,
+    processedAt: new Date().toISOString()
+  }
+}
+\`\`\`
+
+Key features demonstrated:
+- Input validation at start
+- Comprehensive error handling with try-catch that preserves stack traces
+- Logging at info, debug, warn, and error levels
+- Progress reporting for long operations (every 10 items)
+- Data validation throughout (null checks, type checks, array validation)
+- Structured return value with metadata for observability
+- Descriptive error messages with context
+- Meaningful variable names (rawData, users, processed)
+- Clean async/await usage
+- Template literals for readable string interpolation
+- Proper error type guards (error instanceof Error)`;
+var CODE_FIELD_CONSTRAINTS = `REMEMBER: The "code" field must be ONLY the function body statements.
+- DO NOT wrap code in arrow functions: \`(ctx) => { ... }\`
+- DO NOT wrap code in async functions: \`async (ctx) => { ... }\`
+- DO NOT include outer curly braces
+- DO include a return statement if the step should produce output
+- Each "code" field should be a string containing multiple statements separated by newlines`;
+function composeImplementationGuidelines() {
+  return [
+    RUNTIME_CONTEXT_TYPES,
+    "",
+    CONTEXT_USAGE_GUIDELINES,
+    "",
+    QUALITY_GUIDELINES,
+    "",
+    TOOL_CALLING_EXAMPLES,
+    "",
+    COMPLETE_STEP_EXAMPLE
+  ].join(`
+`);
+}
+
 // ../core/src/workflow/dynamic-generator.workflow.ts
 var GenerateWorkflowDefinitionInputSchema = exports_external.object({
   prompt: exports_external.string(),
   availableTools: exports_external.array(exports_external.object({
     name: exports_external.string(),
     description: exports_external.string()
-  })).optional()
+  })).nullish()
 });
 var GenerateWorkflowCodeInputSchema = exports_external.object({
-  workflow: WorkflowFileSchema
+  workflow: WorkflowFileSchema,
+  skipReview: exports_external.boolean().nullish()
 });
+var AsyncFunction2 = Object.getPrototypeOf(async () => {}).constructor;
+var WORKFLOW_IMPLEMENTATION_GUIDELINES = composeImplementationGuidelines();
+var WORKFLOW_CODE_SYSTEM_PROMPT = `You are an expert TypeScript developer.
+Your task is to implement the TypeScript code for the steps in the provided workflow definition.
+
+You will receive a JSON workflow definition where the "code" field is null.
+You must fill in the "code" field for each step with valid TypeScript code.
+
+CRITICAL: Each step "code" field must contain ONLY the function body statements (the code inside the curly braces).
+DO NOT include function declaration, arrow function syntax, async keyword, parameter list, or outer curly braces.
+
+Prefer using \`ctx.tools.runAgent\` for complex tasks or when multiple steps/tools are needed. Use \`ctx.agentTools\` for direct tool usage (e.g. \`ctx.agentTools.readFile\`).
+
+The code will be wrapped automatically in: \`async (ctx) => { YOUR_CODE_HERE }\`
+
+Example of CORRECT code field:
+\`\`\`ts
+const result = await ctx.agentTools.readFile({ path: 'README.md' })
+if (!result) throw new Error('File not found')
+return result
+\`\`\`
+
+Example of INCORRECT code field (DO NOT DO THIS):
+\`\`\`ts
+async (ctx) => {
+  const result = await ctx.agentTools.readFile({ path: 'README.md' })
+  return result
+}
+\`\`\`
+
+${WORKFLOW_IMPLEMENTATION_GUIDELINES}
+
+## Final Instructions
+
+${CODE_FIELD_CONSTRAINTS}
+
+Return the complete workflow JSON with the "code" fields populated.
+`;
+var WORKFLOW_REVIEW_SYSTEM_PROMPT = `You are an expert TypeScript Code Reviewer.
+Your task is to review the provided workflow definition and its implemented code, and improve it to meet the highest quality standards.
+
+You will receive a JSON workflow definition where the "code" fields are already populated.
+You must review each step's code and improve it if necessary.
+
+Check for:
+- Correct usage of \`ctx.agentTools\` (for standard tools) and \`ctx.tools\` (for workflow helpers).
+- Proper error handling (try-catch, input validation).
+- Meaningful logging.
+- Adherence to the Quality Guidelines.
+- Correct syntax (no outer function wrappers).
+
+${QUALITY_GUIDELINES}
+
+## Final Instructions
+
+Return the complete workflow JSON with the "code" fields improved where necessary.
+Ensure the "code" field still contains ONLY the function body statements.
+`;
 // ../../node_modules/lodash-es/_freeGlobal.js
 var freeGlobal = typeof global == "object" && global && global.Object === Object && global;
 var _freeGlobal_default = freeGlobal;
@@ -62109,15 +62251,15 @@ function useKeypress(userHandler) {
   signal.current = userHandler;
   useEffect((rl) => {
     let ignore = false;
-    const handler19 = withUpdates((_input, event) => {
+    const handler13 = withUpdates((_input, event) => {
       if (ignore)
         return;
       signal.current(event, rl);
     });
-    rl.input.on("keypress", handler19);
+    rl.input.on("keypress", handler13);
     return () => {
       ignore = true;
-      rl.input.removeListener("keypress", handler19);
+      rl.input.removeListener("keypress", handler13);
     };
   }, []);
 }
@@ -62708,16 +62850,16 @@ class Emitter {
 
 class SignalExitBase {
 }
-var signalExitWrap = (handler19) => {
+var signalExitWrap = (handler13) => {
   return {
     onExit(cb, opts) {
-      return handler19.onExit(cb, opts);
+      return handler13.onExit(cb, opts);
     },
     load() {
-      return handler19.load();
+      return handler13.load();
     },
     unload() {
-      return handler19.unload();
+      return handler13.unload();
     }
   };
 };
@@ -64567,11 +64709,6 @@ Tool error:`, event.tool));
             }
             break;
           }
-          case "Exit" /* Exit */:
-            if (verbose > 0) {
-              customConsole.log("Exit Message:", event.exitReason.message);
-            }
-            break;
         }
         for (const [tool3, taskStats] of taskToolCallStats.entries()) {
           const globalStats = globalToolCallStats.get(tool3) ?? { calls: 0, success: 0, errors: 0 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polka-codes/cli-shared",
-  "version": "0.9.79",
+  "version": "0.9.81",
   "license": "AGPL-3.0",
   "author": "github@polka.codes",
   "type": "module",