@polka-codes/cli 0.9.79 → 0.9.81

package/dist/index.js

@@ -37660,7 +37660,7 @@ var {
   Help
 } = import__.default;
 // package.json
-var version = "0.9.79";
+var version = "0.9.81";
 
 // src/commands/code.ts
 import { readFile as readFile4 } from "node:fs/promises";
@@ -50382,12 +50382,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(),
@@ -50400,6 +50394,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(),
@@ -50492,7 +50493,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."
@@ -50502,7 +50503,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"
@@ -50518,7 +50519,7 @@ ${answer}
 </ask_followup_question_answer>`);
   }
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: answers.join(`
@@ -50561,7 +50562,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."
@@ -50590,7 +50591,7 @@ ${result.stderr}
     }
     if (result.exitCode === 0) {
       return {
-        type: "Reply" /* Reply */,
+        success: true,
         message: {
           type: "text",
           value: message
@@ -50598,7 +50599,7 @@ ${result.stderr}
       };
     }
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: message
@@ -50606,7 +50607,7 @@ ${result.stderr}
     };
   } catch (error46) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: error46 instanceof Error ? error46.message : String(error46)
@@ -50655,7 +50656,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."
@@ -50665,7 +50666,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."
@@ -50684,7 +50685,7 @@ var handler3 = async (provider, args) => {
   }
   const resolvedResults = await Promise.all(results);
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: resolvedResults.join(`
@@ -50696,40 +50697,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({
@@ -50767,20 +50736,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>
@@ -50793,128 +50762,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: [
@@ -50930,7 +50803,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}`
@@ -50939,11 +50812,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({
@@ -50980,17 +50853,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);
@@ -51006,7 +50879,7 @@ var handler9 = async (provider, args) => {
     }
   }
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: resp.join(`
@@ -51015,45 +50888,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({
@@ -51069,20 +50908,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}`
@@ -51092,7 +50931,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>`
@@ -51100,11 +50939,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({
@@ -51122,20 +50961,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>`
@@ -51143,8 +50982,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) => {
@@ -51221,7 +51060,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({
@@ -51331,20 +51170,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}`
@@ -51356,7 +51195,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" />`
@@ -51366,7 +51205,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">
@@ -51378,7 +51217,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}">
@@ -51388,7 +51227,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" />`
@@ -51396,7 +51235,7 @@ var handler13 = async (provider, args) => {
     };
   } catch (error46) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Invalid arguments for replaceInFile: ${error46}`
@@ -51405,11 +51244,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({
@@ -51437,11 +51276,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."
@@ -51450,7 +51289,7 @@ var handler14 = async (provider, args) => {
   }
   const result = await provider.search(query);
   return {
-    type: "Reply" /* Reply */,
+    success: true,
     message: {
       type: "text",
       value: result
@@ -51458,11 +51297,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({
@@ -51486,20 +51325,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}`
@@ -51510,7 +51349,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>
@@ -51525,7 +51364,7 @@ ${files.join(`
     };
   } catch (error46) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Error searching files: ${error46}`
@@ -51534,112 +51373,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({
@@ -51668,20 +51443,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}`
@@ -51694,7 +51469,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>`
@@ -51702,8 +51477,8 @@ var handler18 = async (provider, args) => {
   };
 };
 var writeToFile_default = {
-  ...toolInfo18,
-  handler: handler18
+  ...toolInfo12,
+  handler: handler12
 };
 // ../core/src/UsageMeter.ts
 class UsageMeter {
@@ -63981,11 +63756,11 @@ var uiMessagesSchema = lazyValidator(() => zodSchema(exports_external.array(expo
 // ../core/src/workflow/agent.workflow.ts
 var agentWorkflow = async (input, { step, tools, logger }) => {
   const event = (name17, event2) => step(name17, () => tools.taskEvent(event2));
-  const { tools: toolInfo19, maxToolRoundTrips = 200 } = input;
+  const { tools: toolInfo13, maxToolRoundTrips = 200 } = input;
   const messages = "systemPrompt" in input ? [{ role: "system", content: input.systemPrompt }] : input.messages;
   await event("start-task", { kind: "StartTask" /* StartTask */, systemPrompt: "systemPrompt" in input ? input.systemPrompt : "" });
   const toolSet = {};
-  for (const tool2 of toolInfo19) {
+  for (const tool2 of toolInfo13) {
     toolSet[tool2.name] = {
       description: tool2.description,
       inputSchema: jsonSchema(toJSONSchema(tool2.parameters))
@@ -64087,50 +63862,28 @@ var agentWorkflow = async (input, { step, tools, logger }) => {
           input: toolCall.input
         });
       });
-      switch (toolResponse.type) {
-        case "Reply" /* Reply */:
-          await event(`event-tool-reply-${toolCall.toolName}-${toolCall.toolCallId}`, {
-            kind: "ToolReply" /* ToolReply */,
-            tool: toolCall.toolName,
-            content: toolResponse.message
-          });
-          toolResults.push({
-            toolCallId: toolCall.toolCallId,
-            toolName: toolCall.toolName,
-            output: toolResponse.message
-          });
-          break;
-        case "Error" /* Error */:
-          await event(`event-tool-error-${toolCall.toolName}-${toolCall.toolCallId}`, {
-            kind: "ToolError" /* ToolError */,
-            tool: toolCall.toolName,
-            error: toolResponse.message ?? "Unknown error"
-          });
-          toolResults.push({
-            toolCallId: toolCall.toolCallId,
-            toolName: toolCall.toolName,
-            output: toolResponse.message
-          });
-          break;
-        case "Exit": {
-          if (toolCalls.length > 1) {
-            toolResults.push({
-              toolCallId: toolCall.toolCallId,
-              toolName: toolCall.toolName,
-              output: {
-                type: "error-text",
-                value: `Error: The tool '${toolCall.toolName}' must be called alone, but it was called with other tools.`
-              }
-            });
-            break;
-          }
-          if (toolResults.length > 0) {
-            break;
-          }
-          const exitReason = { ...toolResponse, messages };
-          await event("end-task", { kind: "EndTask" /* EndTask */, exitReason });
-          return exitReason;
-        }
+      if (toolResponse.success) {
+        await event(`event-tool-reply-${toolCall.toolName}-${toolCall.toolCallId}`, {
+          kind: "ToolReply" /* ToolReply */,
+          tool: toolCall.toolName,
+          content: toolResponse.message
+        });
+        toolResults.push({
+          toolCallId: toolCall.toolCallId,
+          toolName: toolCall.toolName,
+          output: toolResponse.message
+        });
+      } else {
+        await event(`event-tool-error-${toolCall.toolName}-${toolCall.toolCallId}`, {
+          kind: "ToolError" /* ToolError */,
+          tool: toolCall.toolName,
+          error: toolResponse.message ?? "Unknown error"
+        });
+        toolResults.push({
+          toolCallId: toolCall.toolCallId,
+          toolName: toolCall.toolName,
+          output: toolResponse.message
+        });
       }
     }
     nextMessage = [
@@ -64205,7 +63958,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(),
@@ -64218,6 +63972,11 @@ var WorkflowFileSchema = exports_external.object({
 });
 
 // ../core/src/workflow/dynamic.ts
+var TOOL_GROUPS = {
+  readonly: ["readFile", "readBinaryFile", "listFiles", "searchFiles"],
+  readwrite: ["readFile", "readBinaryFile", "listFiles", "searchFiles", "writeToFile", "replaceInFile", "removeFile", "renameFile"],
+  internet: ["fetchUrl", "search"]
+};
 function parseDynamicWorkflowDefinition(source) {
   try {
     const raw = $parse(source);
@@ -64231,6 +63990,29 @@ function parseDynamicWorkflowDefinition(source) {
   }
 }
 var AsyncFunction = Object.getPrototypeOf(async () => {}).constructor;
+function validateAndApplyDefaults(workflowId, workflow, input) {
+  if (!workflow.inputs || workflow.inputs.length === 0) {
+    return input;
+  }
+  const validatedInput = {};
+  const errors4 = [];
+  for (const inputDef of workflow.inputs) {
+    const providedValue = input[inputDef.id];
+    if (providedValue !== undefined && providedValue !== null) {
+      validatedInput[inputDef.id] = providedValue;
+    } else if (inputDef.default !== undefined && inputDef.default !== null) {
+      validatedInput[inputDef.id] = inputDef.default;
+    } else {
+      errors4.push(`Missing required input '${inputDef.id}'${inputDef.description ? `: ${inputDef.description}` : ""}`);
+    }
+  }
+  if (errors4.length > 0) {
+    throw new Error(`Workflow '${workflowId}' input validation failed:
+${errors4.map((e) => `  - ${e}`).join(`
+`)}`);
+  }
+  return validatedInput;
+}
 function createRunWorkflowFn(args) {
   return async (subWorkflowId, subInput) => {
     const mergedInput = { ...args.input, ...args.state, ...subInput ?? {} };
@@ -64251,7 +64033,14 @@ function compileStep(stepDef, workflowId, compiledSteps) {
     compiledSteps.set(key, fn);
     return fn;
   } catch (error46) {
-    throw new Error(`Failed to compile code for step '${stepDef.id}' in workflow '${workflowId}': ${error46 instanceof Error ? error46.message : String(error46)}`);
+    const errorMsg = error46 instanceof Error ? error46.message : String(error46);
+    const codePreview = stepDef.code.length > 200 ? `${stepDef.code.substring(0, 200)}...` : stepDef.code;
+    throw new Error(`Failed to compile code for step '${stepDef.id}' in workflow '${workflowId}':
+` + `  Error: ${errorMsg}
+` + `  Code:
+${codePreview.split(`
+`).map((line) => `    ${line}`).join(`
+`)}`);
   }
 }
 async function executeStepWithAgent(stepDef, workflowId, input, state, context, options, runInternal) {
@@ -64262,9 +64051,33 @@ async function executeStepWithAgent(stepDef, workflowId, input, state, context,
   if (!options.toolInfo) {
     throw new Error(`Step '${stepDef.id}' in workflow '${workflowId}' requires agent execution, but no toolInfo was provided to DynamicWorkflowRunner.`);
   }
-  const allowedToolNames = stepDef.tools;
-  const toolsForAgent = allowedToolNames ? options.toolInfo.filter((t) => allowedToolNames.includes(t.name)) : [...options.toolInfo];
-  if (!allowedToolNames || allowedToolNames.includes("runWorkflow")) {
+  const rawAllowedToolNames = stepDef.tools;
+  let toolsForAgent;
+  if (rawAllowedToolNames) {
+    const expandedToolNames = new Set;
+    let includeAll = false;
+    for (const name17 of rawAllowedToolNames) {
+      if (name17 === "all") {
+        includeAll = true;
+        break;
+      }
+      if (Object.hasOwn(TOOL_GROUPS, name17)) {
+        for (const tool2 of TOOL_GROUPS[name17]) {
+          expandedToolNames.add(tool2);
+        }
+      } else {
+        expandedToolNames.add(name17);
+      }
+    }
+    if (includeAll) {
+      toolsForAgent = [...options.toolInfo];
+    } else {
+      toolsForAgent = options.toolInfo.filter((t) => expandedToolNames.has(t.name));
+    }
+  } else {
+    toolsForAgent = [...options.toolInfo];
+  }
+  if (!rawAllowedToolNames || rawAllowedToolNames.includes("all") || rawAllowedToolNames.includes("runWorkflow")) {
     toolsForAgent.push({
       name: "runWorkflow",
       description: "Run a named sub-workflow defined in the current workflow file.",
@@ -64273,11 +64086,12 @@ async function executeStepWithAgent(stepDef, workflowId, input, state, context,
         input: exports_external.any().nullish().describe("Optional input object for the sub-workflow")
       }),
       handler: async () => {
-        return { type: "Error" /* Error */, message: { type: "error-text", value: "runWorkflow is virtual." } };
+        return { success: false, message: { type: "error-text", value: "runWorkflow is virtual." } };
       }
     });
   }
   const allowedToolNameSet = new Set(toolsForAgent.map((t) => t.name));
+  context.logger.debug(`[Agent] Available tools for step '${stepDef.id}': ${toolsForAgent.map((t) => t.name).join(", ")}`);
   const systemPrompt = options.stepSystemPrompt?.({ workflowId, step: stepDef, input, state }) ?? [
     `You are an AI assistant executing a workflow step.`,
     "",
@@ -64304,7 +64118,7 @@ async function executeStepWithAgent(stepDef, workflowId, input, state, context,
     invokeTool: async ({ toolName, input: toolInput }) => {
       if (!allowedToolNameSet.has(toolName)) {
         return {
-          type: "Error" /* Error */,
+          success: false,
           message: { type: "error-text", value: `Tool '${toolName}' is not allowed in this step.` }
         };
       }
@@ -64313,17 +64127,17 @@ async function executeStepWithAgent(stepDef, workflowId, input, state, context,
         const subInput = toolInput?.input;
         if (typeof subWorkflowId !== "string") {
           return {
-            type: "Error" /* Error */,
+            success: false,
             message: { type: "error-text", value: "runWorkflow.workflowId must be a string." }
           };
         }
         try {
           const output = await runWorkflow(subWorkflowId, subInput);
           const jsonResult = { type: "json", value: output };
-          return { type: "Reply" /* Reply */, message: jsonResult };
+          return { success: true, message: jsonResult };
         } catch (error46) {
           return {
-            type: "Error" /* Error */,
+            success: false,
             message: { type: "error-text", value: error46 instanceof Error ? error46.message : String(error46) }
           };
         }
@@ -64346,28 +64160,91 @@ async function executeStepWithAgent(stepDef, workflowId, input, state, context,
     if (parsed.success) {
       return parsed.data;
     }
+    if (options.wrapAgentResultInObject) {
+      context.logger.warn(`[Agent] Step '${stepDef.id}' returned plain text instead of JSON. Wrapping in {result: ...}`);
+      return { result: result.message };
+    }
     return result.message;
   }
-  throw new Error(`Agent execution for step '${stepDef.id}' in workflow '${workflowId}' did not exit cleanly.`);
+  if (result.type === "Error") {
+    throw new Error(`Agent step '${stepDef.id}' in workflow '${workflowId}' failed: ${result.error?.message || "Unknown error"}`);
+  }
+  if (result.type === "UsageExceeded") {
+    throw new Error(`Agent step '${stepDef.id}' in workflow '${workflowId}' exceeded usage limits (tokens or rounds)`);
+  }
+  throw new Error(`Agent step '${stepDef.id}' in workflow '${workflowId}' exited unexpectedly with type: ${result.type}`);
+}
+async function executeStepWithTimeout(stepDef, workflowId, input, state, context, options, compiledSteps, runInternal) {
+  const executeStepLogic = async () => {
+    if (stepDef.code && options.allowUnsafeCodeExecution) {
+      context.logger.debug(`[Step] Executing step '${stepDef.id}' with compiled code`);
+      const fn = compileStep(stepDef, workflowId, compiledSteps);
+      const runWorkflow = createRunWorkflowFn({ input, state, context, runInternal });
+      const agentTools = {};
+      if (options.toolInfo) {
+        for (const tool2 of options.toolInfo) {
+          if (typeof context.tools[tool2.name] === "function") {
+            agentTools[tool2.name] = context.tools[tool2.name];
+          }
+        }
+      }
+      const runtimeCtx = {
+        workflowId,
+        stepId: stepDef.id,
+        input,
+        state,
+        tools: context.tools,
+        logger: context.logger,
+        step: context.step,
+        runWorkflow,
+        toolInfo: options.toolInfo,
+        agentTools
+      };
+      const result2 = await fn(runtimeCtx);
+      context.logger.debug(`[Step] Compiled code execution completed for step '${stepDef.id}'`);
+      return result2;
+    }
+    context.logger.debug(`[Step] Executing step '${stepDef.id}' with agent`);
+    const result = await executeStepWithAgent(stepDef, workflowId, input, state, context, options, runInternal);
+    context.logger.debug(`[Step] Agent execution completed for step '${stepDef.id}'`);
+    return result;
+  };
+  if (stepDef.timeout && stepDef.timeout > 0) {
+    context.logger.debug(`[Step] Step '${stepDef.id}' has timeout of ${stepDef.timeout}ms`);
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+      timeoutId = setTimeout(() => reject(new Error(`Step '${stepDef.id}' in workflow '${workflowId}' timed out after ${stepDef.timeout}ms`)), stepDef.timeout);
+    });
+    try {
+      return await Promise.race([executeStepLogic(), timeoutPromise]);
+    } finally {
+      if (timeoutId)
+        clearTimeout(timeoutId);
+    }
+  }
+  return await executeStepLogic();
 }
 async function executeStep(stepDef, workflowId, input, state, context, options, compiledSteps, runInternal) {
-  if (stepDef.code && options.allowUnsafeCodeExecution) {
-    const fn = compileStep(stepDef, workflowId, compiledSteps);
-    const runWorkflow = createRunWorkflowFn({ input, state, context, runInternal });
-    const runtimeCtx = {
-      workflowId,
-      stepId: stepDef.id,
-      input,
-      state,
-      tools: context.tools,
-      logger: context.logger,
-      step: context.step,
-      runWorkflow,
-      toolInfo: options.toolInfo
-    };
-    return await fn(runtimeCtx);
+  const result = await executeStepWithTimeout(stepDef, workflowId, input, state, context, options, compiledSteps, runInternal);
+  if (stepDef.outputSchema) {
+    try {
+      const _schema = exports_external.any();
+      if (typeof stepDef.outputSchema === "object") {
+        context.logger.debug(`[Step] Validating output for step '${stepDef.id}' against schema`);
+        if (stepDef.outputSchema.type === "object") {
+          if (typeof result !== "object" || result === null || Array.isArray(result)) {
+            throw new Error(`Expected object output, got ${Array.isArray(result) ? "array" : result === null ? "null" : typeof result}`);
+          }
+        }
+        if (stepDef.outputSchema.type === "array" && !Array.isArray(result)) {
+          throw new Error(`Expected array output, got ${typeof result}`);
+        }
+      }
+    } catch (error46) {
+      throw new Error(`Step '${stepDef.id}' in workflow '${workflowId}' output validation failed: ${error46 instanceof Error ? error46.message : String(error46)}`);
+    }
   }
-  return await executeStepWithAgent(stepDef, workflowId, input, state, context, options, runInternal);
+  return result;
 }
 function createDynamicWorkflow(definition, options = {}) {
   if (typeof definition === "string") {
@@ -64383,36 +64260,393 @@ function createDynamicWorkflow(definition, options = {}) {
     if (!workflow) {
       throw new Error(`Workflow '${workflowId}' not found`);
     }
+    const validatedInput = validateAndApplyDefaults(workflowId, workflow, input);
+    context.logger.info(`[Workflow] Starting workflow '${workflowId}'`);
+    context.logger.debug(`[Workflow] Input: ${JSON.stringify(validatedInput)}`);
+    context.logger.debug(`[Workflow] Inherited state: ${JSON.stringify(inheritedState)}`);
+    context.logger.debug(`[Workflow] Steps: ${workflow.steps.map((s) => s.id).join(", ")}`);
     const state = { ...inheritedState };
     let lastOutput;
-    for (const stepDef of workflow.steps) {
+    for (let i = 0;i < workflow.steps.length; i++) {
+      const stepDef = workflow.steps[i];
       const stepName = `${workflowId}.${stepDef.id}`;
+      context.logger.info(`[Workflow] Step ${i + 1}/${workflow.steps.length}: ${stepDef.id}`);
+      context.logger.debug(`[Workflow] Step task: ${stepDef.task}`);
+      if (stepDef.expected_outcome) {
+        context.logger.debug(`[Workflow] Expected outcome: ${stepDef.expected_outcome}`);
+      }
+      context.logger.debug(`[Workflow] Current state keys: ${Object.keys(state).join(", ")}`);
       lastOutput = await context.step(stepName, async () => {
-        return await executeStep(stepDef, workflowId, input, state, context, options, compiledSteps, runInternal);
+        return await executeStep(stepDef, workflowId, validatedInput, state, context, options, compiledSteps, runInternal);
       });
       const outputKey = stepDef.output ?? stepDef.id;
       state[outputKey] = lastOutput;
+      context.logger.debug(`[Workflow] Step output stored as '${outputKey}': ${typeof lastOutput === "object" ? JSON.stringify(lastOutput).substring(0, 200) : lastOutput}`);
     }
+    context.logger.info(`[Workflow] Completed workflow '${workflowId}'`);
     if (workflow.output) {
+      context.logger.debug(`[Workflow] Returning output field: ${workflow.output}`);
       return state[workflow.output];
     }
+    context.logger.debug(`[Workflow] Returning full state with keys: ${Object.keys(state).join(", ")}`);
     return state;
   };
   return async (workflowId, input, context) => {
     return await runInternal(workflowId, input, context, {});
   };
 }
+// ../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;
+function validateWorkflowDefinition(workflow) {
+  const errors4 = [];
+  if (!workflow.workflows.main) {
+    errors4.push("Missing required 'main' workflow");
+  }
+  for (const [wfId, wf] of Object.entries(workflow.workflows)) {
+    const stepIds = new Set;
+    for (const step of wf.steps) {
+      if (stepIds.has(step.id)) {
+        errors4.push(`Duplicate step ID '${step.id}' in workflow '${wfId}'`);
+      }
+      stepIds.add(step.id);
+    }
+  }
+  return { valid: errors4.length === 0, errors: errors4 };
+}
+function validateWorkflowCodeSyntax(workflow) {
+  const errors4 = [];
+  for (const [wfId, wf] of Object.entries(workflow.workflows)) {
+    for (const step of wf.steps) {
+      if (step.code) {
+        try {
+          new AsyncFunction2("ctx", step.code);
+        } catch (e) {
+          const errorMsg = e instanceof Error ? e.message : String(e);
+          errors4.push(`Syntax error in ${wfId}.${step.id}: ${errorMsg}`);
+        }
+      }
+    }
+  }
+  return { valid: errors4.length === 0, errors: errors4 };
+}
 var WORKFLOW_DEFINITION_SYSTEM_PROMPT = `You are an expert workflow architect.
 Your task is to create a JSON workflow definition based on the user's request.
 
@@ -64428,8 +64662,11 @@ The workflow definition must follow this structure:
         {
           "id": "stepId",
           "task": "Description of the step",
-          "tools": ["toolName1", "toolName2"], // Optional list of tools needed
-          "output": "outputVariableName", // Optional
+          "tools": ["toolName1", "toolName2"], // Optional: restrict which tools can be used. Can use groups: "readonly", "readwrite", "internet", "all".
+          "output": "outputVariableName", // Optional: defaults to step id
+          "timeout": 30000, // Optional: timeout in milliseconds
+          "expected_outcome": "What this step produces", // Optional: documentation for expected results
+          "outputSchema": { "type": "object" } // Optional: validation schema
         }
       ],
       "output": "outputVariableName" // Optional
@@ -64443,7 +64680,24 @@ Constraints:
 - Break down complex tasks into logical steps.
 - Define clear inputs and outputs.
 
-Example 1:
+Quality Guidelines:
+- Add "timeout" field (in milliseconds) for steps that might take long (file I/O, API calls, searches)
+- Use "expected_outcome" field to document what each step should produce and its format
+- Use descriptive step IDs (e.g., "validateInput", "fetchUserData", not "step1", "step2")
+- Design steps to be focused - one responsibility per step
+- For steps that process multiple items, consider creating a sub-workflow
+- Add "outputSchema" with type information for validation-critical steps
+- Order steps logically with clear data flow
+
+### Using expected_outcome Effectively
+
+The "expected_outcome" field helps document what each step produces. Best practices:
+- Describe the data structure: "Returns an array of { id, name, status } objects"
+- Mention important constraints: "Returns at most 10 results, sorted by date"
+- Note failure modes: "Returns null if file not found"
+- Document side effects: "Creates output directory if it doesn't exist"
+
+Example 1 - Research workflow:
 User: "Research a topic and summarize it."
 Output:
 \`\`\`json
@@ -64459,13 +64713,16 @@ Output:
           "id": "search",
           "task": "Search for information about the topic",
           "tools": ["search"],
-          "output": "searchResults"
+          "output": "searchResults",
+          "timeout": 30000,
+          "expected_outcome": "Returns search results with titles, URLs, and snippets related to the topic"
         },
         {
           "id": "summarize",
           "task": "Summarize the search results",
-          "tools": ["generateText"],
-          "output": "summary"
+          "tools": ["runAgent"],
+          "output": "summary",
+          "expected_outcome": "Returns a concise summary string (2-3 paragraphs) of the key findings"
         }
       ],
       "output": "summary"
@@ -64474,7 +64731,7 @@ Output:
 }
 \`\`\`
 
-Example 2:
+Example 2 - PR review workflow with sub-workflow:
 User: "Review urgent PRs. For each PR, run the review workflow."
 Output:
 \`\`\`json
@@ -64488,13 +64745,16 @@ Output:
           "id": "fetchPRs",
           "task": "Fetch list of urgent PRs",
           "tools": ["github_list_prs"],
-          "output": "prs"
+          "output": "prs",
+          "timeout": 15000,
+          "expected_outcome": "Returns array of PR objects with { id, title, author, url }"
         },
         {
           "id": "reviewEachPR",
           "task": "Run review workflow for each PR",
           "tools": [],
-          "output": "reviews"
+          "output": "reviews",
+          "expected_outcome": "Returns array of review results, one per PR"
         }
       ],
       "output": "reviews"
@@ -64509,13 +64769,16 @@ Output:
           "id": "getDiff",
           "task": "Get PR diff",
           "tools": ["github_get_diff"],
-          "output": "diff"
+          "output": "diff",
+          "timeout": 10000,
+          "expected_outcome": "Returns the unified diff string for the PR"
         },
         {
           "id": "analyze",
-          "task": "Analyze the diff",
-          "tools": ["generateText"],
-          "output": "analysis"
+          "task": "Analyze the diff and provide feedback",
+          "tools": ["runAgent"],
+          "output": "analysis",
+          "expected_outcome": "Returns { summary, issues, suggestions } object with review feedback"
         }
       ],
       "output": "analysis"
@@ -64523,77 +64786,130 @@ Output:
   }
 }
 \`\`\`
+
+Example 3 - File processing with conditional logic:
+User: "Process all JSON files in a directory, validate them, and generate a report."
+Output:
+\`\`\`json
+{
+  "workflows": {
+    "main": {
+      "task": "Process and validate JSON files, then generate a report",
+      "inputs": [
+        { "id": "directory", "description": "Directory containing JSON files", "default": "data" }
+      ],
+      "steps": [
+        {
+          "id": "listJsonFiles",
+          "task": "List all JSON files in the directory",
+          "tools": ["listFiles"],
+          "output": "jsonFiles",
+          "timeout": 5000,
+          "expected_outcome": "Returns array of file paths ending in .json"
+        },
+        {
+          "id": "processFiles",
+          "task": "Process each JSON file using the processFile sub-workflow",
+          "tools": [],
+          "output": "processedResults",
+          "expected_outcome": "Returns array of { file, valid, errors?, data? } for each file"
+        },
+        {
+          "id": "generateReport",
+          "task": "Generate a summary report of all processed files",
+          "tools": ["writeToFile"],
+          "output": "reportPath",
+          "expected_outcome": "Writes report to 'report.md' and returns the file path"
+        }
+      ],
+      "output": "reportPath"
+    },
+    "processFile": {
+      "task": "Process and validate a single JSON file",
+      "inputs": [
+        { "id": "filePath", "description": "Path to the JSON file" }
+      ],
+      "steps": [
+        {
+          "id": "readFile",
+          "task": "Read the JSON file content",
+          "tools": ["readFile"],
+          "output": "content",
+          "timeout": 3000,
+          "expected_outcome": "Returns file content as string, or null if not found"
+        },
+        {
+          "id": "validateJson",
+          "task": "Parse and validate the JSON structure",
+          "tools": [],
+          "output": "validationResult",
+          "expected_outcome": "Returns { valid: boolean, data?: object, errors?: string[] }"
+        }
+      ],
+      "output": "validationResult"
+    }
+  }
+}
+\`\`\`
 `;
+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.
 
-The code will be executed in an async function with the following signature:
-async (ctx) => {
-  // Your code here
-}
-
-The \`ctx\` object provides access to:
-- \`ctx.input\`: The workflow inputs.
-- \`ctx.state\`: A shared state object for passing data between steps.
-- \`ctx.tools\`: An object containing available tools.
-- \`ctx.runWorkflow\`: (workflowId: string, input?: any) => Promise<any>. Use this to run other workflows.
-
-Guidelines:
-- Use \`await\` for asynchronous operations.
-- Return the output value of the step.
-- Access inputs via \`ctx.input.inputName\`.
-- Access previous step outputs via \`ctx.state.stepOutputName\`.
-- Use \`ctx.tools.invokeTool({ toolName: 'name', input: { ... } })\` to call tools.
-- Use \`ctx.tools.generateText({ messages: [...] })\` for LLM calls.
-- Use \`ctx.tools.invokeTool({ toolName: 'runAgent', input: { prompt: '...' } })\` for complex sub-tasks that require multiple steps or tools. Prefer this over \`generateText\` for advanced tasks.
-
-Example Code for a step:
-\`\`\`typescript
-const searchResults = await ctx.tools.invokeTool({
-  toolName: 'search',
-  input: { query: ctx.input.topic }
-});
-return searchResults;
-\`\`\`
+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.
 
-Example Code for LLM step:
-\`\`\`typescript
-const summary = await ctx.tools.generateText({
-  messages: [
-    { role: 'system', content: 'Summarize the following text.' },
-    { role: 'user', content: ctx.state.searchResults }
-  ]
-});
-return summary;
-\`\`\`
+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\`).
 
-Example Code for runAgent:
-\`\`\`typescript
-const result = await ctx.tools.invokeTool({
-  toolName: 'runAgent',
-  input: {
-    prompt: 'Research the history of the internet and write a summary.',
-    tools: ['search', 'generateText']
-  }
-});
-return result;
+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 Code for invoking a sub-workflow:
-\`\`\`typescript
-const results = [];
-for (const pr of ctx.state.prs) {
-  const review = await ctx.runWorkflow('reviewPR', { prId: pr.id });
-  results.push(review);
+Example of INCORRECT code field (DO NOT DO THIS):
+\`\`\`ts
+async (ctx) => {
+  const result = await ctx.agentTools.readFile({ path: 'README.md' })
+  return result
 }
-return results;
 \`\`\`
 
+${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.
+`;
+var MAX_GENERATION_ATTEMPTS = 3;
 var generateWorkflowDefinitionWorkflow = async (input, ctx) => {
   let systemPrompt = WORKFLOW_DEFINITION_SYSTEM_PROMPT;
   if (input.availableTools && input.availableTools.length > 0) {
@@ -64614,24 +64930,75 @@ Use these tools when appropriate.`;
       outputSchema: WorkflowFileSchema
     }, ctx);
   });
-  if (result.type === "Exit" && result.object) {
-    return result.object;
+  if (result.type !== "Exit" || !result.object) {
+    throw new Error("Failed to generate workflow definition");
   }
-  throw new Error("Failed to generate workflow definition");
+  const workflow = result.object;
+  await ctx.step("validate-workflow-definition", async () => {
+    const validation = validateWorkflowDefinition(workflow);
+    if (!validation.valid) {
+      ctx.logger.warn(`Workflow definition validation warnings: ${validation.errors.join("; ")}`);
+    }
+    return validation;
+  });
+  return workflow;
 };
 var generateWorkflowCodeWorkflow = async (input, ctx) => {
-  const result = await ctx.step("generate-workflow-code", async () => {
-    return agentWorkflow({
-      systemPrompt: WORKFLOW_CODE_SYSTEM_PROMPT,
-      userMessage: [{ role: "user", content: JSON.stringify(input.workflow, null, 2) }],
-      tools: [],
-      outputSchema: WorkflowFileSchema
-    }, ctx);
-  });
-  if (result.type === "Exit" && result.object) {
-    return result.object;
+  let lastError = null;
+  let currentWorkflow = input.workflow;
+  for (let attempt = 0;attempt < MAX_GENERATION_ATTEMPTS; attempt++) {
+    const stepName = attempt === 0 ? "generate-workflow-code" : `retry-workflow-code-${attempt}`;
+    const userMessage = lastError ? `Previous attempt had issues: ${lastError}
+
+Please fix the problems in this workflow:
+${JSON.stringify(currentWorkflow, null, 2)}` : JSON.stringify(currentWorkflow, null, 2);
+    const generated = await ctx.step(stepName, async () => {
+      return agentWorkflow({
+        systemPrompt: WORKFLOW_CODE_SYSTEM_PROMPT,
+        userMessage: [{ role: "user", content: userMessage }],
+        tools: [],
+        outputSchema: WorkflowFileSchema
+      }, ctx);
+    });
+    if (generated.type !== "Exit" || !generated.object) {
+      lastError = "Failed to generate workflow code";
+      continue;
+    }
+    const generatedWorkflow = generated.object;
+    const syntaxValidation = await ctx.step(`validate-code-syntax-${attempt}`, async () => {
+      return validateWorkflowCodeSyntax(generatedWorkflow);
+    });
+    if (!syntaxValidation.valid) {
+      lastError = syntaxValidation.errors.join("; ");
+      currentWorkflow = generatedWorkflow;
+      ctx.logger.warn(`Code syntax validation failed (attempt ${attempt + 1}): ${lastError}`);
+      continue;
+    }
+    if (input.skipReview) {
+      return generatedWorkflow;
+    }
+    const reviewed = await ctx.step("review-workflow-code", async () => {
+      return agentWorkflow({
+        systemPrompt: WORKFLOW_REVIEW_SYSTEM_PROMPT,
+        userMessage: [{ role: "user", content: JSON.stringify(generatedWorkflow, null, 2) }],
+        tools: [],
+        outputSchema: WorkflowFileSchema
+      }, ctx);
+    });
+    if (reviewed.type !== "Exit" || !reviewed.object) {
+      throw new Error("Failed to review workflow code");
+    }
+    const reviewedWorkflow = reviewed.object;
+    const reviewSyntaxValidation = await ctx.step("validate-reviewed-code-syntax", async () => {
+      return validateWorkflowCodeSyntax(reviewedWorkflow);
+    });
+    if (!reviewSyntaxValidation.valid) {
+      ctx.logger.warn(`Reviewed code has syntax issues: ${reviewSyntaxValidation.errors.join("; ")}`);
+      return generatedWorkflow;
+    }
+    return reviewedWorkflow;
   }
-  throw new Error("Failed to generate workflow code");
+  throw new Error(`Failed to generate valid workflow code after ${MAX_GENERATION_ATTEMPTS} attempts: ${lastError}`);
 };
 // ../core/src/workflow/json-ai-types.ts
 var toJsonDataContent = (data) => {
@@ -68230,15 +68597,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);
     };
   }, []);
 }
@@ -68829,16 +69196,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();
     }
   };
 };
@@ -70884,11 +71251,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 };
@@ -84384,7 +84746,7 @@ class ApiProviderConfig {
     return this.resolveModelConfig(mergedConfig);
   }
   resolveModelConfig(config4) {
-    const { provider: provider3, model, parameters, budget } = config4;
+    const { provider: provider3, model, parameters, budget, rules } = config4;
     const finalProvider = provider3 ?? this.defaultProvider;
     if (!finalProvider) {
       return;
@@ -84405,7 +84767,8 @@ class ApiProviderConfig {
       keyFile,
       baseUrl,
       parameters: finalParameters,
-      budget
+      budget,
+      rules
     };
   }
 }
@@ -84584,9 +84947,41 @@ function getProviderOptions(options) {
 
 // src/tool-implementations.ts
 import { spawn as spawn3, spawnSync as spawnSync2 } from "node:child_process";
-import fs3, { mkdir as mkdir2 } from "node:fs/promises";
+import fs4, { mkdir as mkdir2 } from "node:fs/promises";
 import { dirname as dirname2 } from "node:path";
 
+// src/tools/getTodoItem.ts
+var toolInfo13 = {
+  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 handler13 = async (provider3, args) => {
+  if (!provider3.getTodoItem) {
+    return {
+      success: false,
+      message: {
+        type: "error-text",
+        value: "Not possible to get a to-do item."
+      }
+    };
+  }
+  const { id } = toolInfo13.parameters.parse(args);
+  const item = await provider3.getTodoItem(id);
+  return {
+    success: true,
+    message: {
+      type: "json",
+      value: item ?? null
+    }
+  };
+};
+var getTodoItem_default = {
+  ...toolInfo13,
+  handler: handler13
+};
 // src/tools/utils/diffLineNumbers.ts
 function parseHunkHeader(header) {
   const match = header.match(/^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/);
@@ -84646,7 +85041,7 @@ function annotateDiffWithLineNumbers(diff) {
 }
 
 // src/tools/gitDiff.ts
-var toolInfo19 = {
+var toolInfo14 = {
   name: "git_diff",
   description: "Get the git diff for the current repository. Can be used to get staged changes, unstaged changes, or changes between commits. By default, it returns unstaged changes.",
   parameters: exports_external.object({
@@ -84675,17 +85070,17 @@ var toolInfo19 = {
     }, exports_external.boolean().optional().default(true)).describe("Annotate the diff with line numbers for additions and deletions.")
   })
 };
-var handler19 = async (provider3, args) => {
+var handler14 = async (provider3, args) => {
   if (!provider3.executeCommand) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: "Not possible to execute command. Abort."
       }
     };
   }
-  const { staged, file: file2, commitRange, contextLines, includeLineNumbers } = toolInfo19.parameters.parse(args);
+  const { staged, file: file2, commitRange, contextLines, includeLineNumbers } = toolInfo14.parameters.parse(args);
   const commandParts = ["git", "diff", "--no-color", `-U${contextLines}`];
   if (staged) {
     commandParts.push("--staged");
@@ -84702,7 +85097,7 @@ var handler19 = async (provider3, args) => {
     if (result.exitCode === 0) {
       if (!result.stdout.trim()) {
         return {
-          type: "Reply" /* Reply */,
+          success: true,
           message: {
             type: "text",
             value: "No diff found."
@@ -84714,7 +85109,7 @@ var handler19 = async (provider3, args) => {
         diffOutput = annotateDiffWithLineNumbers(diffOutput);
       }
       return {
-        type: "Reply" /* Reply */,
+        success: true,
         message: {
           type: "text",
           value: `<diff file="${file2 ?? "all"}">
@@ -84724,7 +85119,7 @@ ${diffOutput}
       };
     }
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `\`${command}\` exited with code ${result.exitCode}:
@@ -84733,7 +85128,7 @@ ${result.stderr}`
     };
   } catch (error46) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: error46 instanceof Error ? error46.message : String(error46)
@@ -84742,6 +85137,199 @@ ${result.stderr}`
   }
 };
 var gitDiff_default = {
+  ...toolInfo14,
+  handler: handler14
+};
+// src/tools/listMemoryTopics.ts
+var toolInfo15 = {
+  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 handler15 = async (provider3, _args) => {
+  const topics = await provider3.listMemoryTopics();
+  if (!topics.length) {
+    return { success: true, message: { type: "text", value: "No topics found." } };
+  }
+  return {
+    success: true,
+    message: {
+      type: "text",
+      value: `Memory topics:
+${topics.join(`
+`)}`
+    }
+  };
+};
+var listMemoryTopics_default = {
+  ...toolInfo15,
+  handler: handler15
+};
+// src/tools/listTodoItems.ts
+var toolInfo16 = {
+  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 handler16 = async (provider3, args) => {
+  if (!provider3.listTodoItems) {
+    return {
+      success: false,
+      message: {
+        type: "error-text",
+        value: "Not possible to list to-do items."
+      }
+    };
+  }
+  const { id, status } = toolInfo16.parameters.parse(args);
+  const items = await provider3.listTodoItems(id, status);
+  return {
+    success: true,
+    message: {
+      type: "json",
+      value: items
+    }
+  };
+};
+var listTodoItems_default = {
+  ...toolInfo16,
+  handler: handler16
+};
+// src/tools/readMemory.ts
+var toolInfo17 = {
+  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 handler17 = async (provider3, args) => {
+  const { topic } = toolInfo17.parameters.parse(args);
+  const content = await provider3.readMemory(topic ?? undefined);
+  if (content) {
+    return {
+      success: true,
+      message: {
+        type: "text",
+        value: `<memory${topic ? ` topic="${topic}"` : ""}>
+${content}
+</memory>`
+      }
+    };
+  }
+  return {
+    success: true,
+    message: {
+      type: "text",
+      value: `<memory ${topic ? `topic="${topic}"` : ""} isEmpty="true" />`
+    }
+  };
+};
+var readMemory_default = {
+  ...toolInfo17,
+  handler: handler17
+};
+// src/tools/updateMemory.ts
+var toolInfo18 = {
+  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"]
+        });
+      }
+    }
+  })
+};
+var handler18 = async (provider3, args) => {
+  if (!provider3.updateMemory) {
+    return {
+      success: false,
+      message: {
+        type: "error-text",
+        value: "Memory operations are not supported by the current provider."
+      }
+    };
+  }
+  const params = toolInfo18.parameters.parse(args);
+  await provider3.updateMemory(params.operation, params.topic ?? undefined, params.content ?? undefined);
+  switch (params.operation) {
+    case "append":
+      return {
+        success: true,
+        message: {
+          type: "text",
+          value: `Content appended to memory topic '${params.topic || ":default:"}'.`
+        }
+      };
+    case "replace":
+      return {
+        success: true,
+        message: {
+          type: "text",
+          value: `Memory topic '${params.topic || ":default:"}' replaced.`
+        }
+      };
+    case "remove":
+      return {
+        success: true,
+        message: {
+          type: "text",
+          value: `Memory topic '${params.topic || ":default:"}' removed.`
+        }
+      };
+  }
+};
+var updateMemory_default = {
+  ...toolInfo18,
+  handler: handler18
+};
+// src/tools/updateTodoItem.ts
+var toolInfo19 = {
+  name: "updateTodoItem",
+  description: "Add or update a to-do item.",
+  parameters: UpdateTodoItemInputSchema
+};
+var handler19 = async (provider3, args) => {
+  if (!provider3.updateTodoItem) {
+    return {
+      success: false,
+      message: {
+        type: "error-text",
+        value: "Not possible to update a to-do item."
+      }
+    };
+  }
+  const input = toolInfo19.parameters.parse(args);
+  const result = await provider3.updateTodoItem(input);
+  return {
+    success: true,
+    message: {
+      type: "json",
+      value: result
+    }
+  };
+};
+var updateTodoItem_default = {
   ...toolInfo19,
   handler: handler19
 };
@@ -84817,12 +85405,14 @@ async function getUserInput(message, options = {}) {
 
 // src/workflows/workflow.utils.ts
 import { execSync } from "node:child_process";
+import { promises as fs3 } from "node:fs";
+import path from "node:path";
 function parseGitDiffNameStatus(diffOutput) {
   const lines = diffOutput.split(`
 `).filter((line) => line.trim());
   return lines.map((line) => {
     const [status, ...pathParts] = line.split("\t");
-    const path = pathParts.join("\t");
+    const path2 = pathParts.join("\t");
     let statusDescription;
     switch (status[0]) {
       case "A":
@@ -84846,7 +85436,7 @@ function parseGitDiffNameStatus(diffOutput) {
       default:
         statusDescription = "Unknown";
     }
-    return { path, status: statusDescription };
+    return { path: path2, status: statusDescription };
   });
 }
 function printChangedFiles(logger, changedFiles) {
@@ -84873,21 +85463,21 @@ function parseGitDiffNumStat(output) {
     if (parts.length >= 3) {
       const insertions = parts[0] === "-" ? 0 : Number.parseInt(parts[0], 10);
       const deletions = parts[1] === "-" ? 0 : Number.parseInt(parts[1], 10);
-      const path = unquotePath(parts.slice(2).join("\t"));
-      stats[path] = { insertions, deletions };
+      const path2 = unquotePath(parts.slice(2).join("\t"));
+      stats[path2] = { insertions, deletions };
     }
   }
   return stats;
 }
-var unquotePath = (path) => {
-  if (path.startsWith('"') && path.endsWith('"')) {
+var unquotePath = (path2) => {
+  if (path2.startsWith('"') && path2.endsWith('"')) {
     try {
-      return JSON.parse(path);
+      return JSON.parse(path2);
     } catch {
-      return path;
+      return path2;
     }
   }
-  return path;
+  return path2;
 };
 function parseGitStatus(statusOutput) {
   const statusLines = statusOutput.split(`
@@ -84896,7 +85486,7 @@ function parseGitStatus(statusOutput) {
   for (const line of statusLines) {
     const indexStatus = line[0];
     const workingTreeStatus = line[1];
-    const path = line.length > 3 ? unquotePath(line.slice(3)) : line;
+    const path2 = line.length > 3 ? unquotePath(line.slice(3)) : line;
     const statuses = [];
     if (indexStatus !== " " && indexStatus !== "?") {
       switch (indexStatus) {
@@ -84935,7 +85525,7 @@ function parseGitStatus(statusOutput) {
       }
     }
     if (statuses.length > 0) {
-      files.push({ path, status: statuses.join(", ") });
+      files.push({ path: path2, status: statuses.join(", ") });
     }
   }
   return files;
@@ -85069,21 +85659,42 @@ function formatElapsedTime(ms) {
   const remainingMinutes = minutes % 60;
   return remainingMinutes > 0 ? `${hours}h ${remainingMinutes}m` : `${hours}h`;
 }
-async function getDefaultContext() {
+async function getDefaultContext(commandName) {
   const config4 = await loadConfig();
   const cwd = process.cwd();
   const [files, truncated] = await listFiles(cwd, true, 2000, cwd, config4?.excludeFiles ?? []);
   const fileList = files.join(`
 `);
+  const now2 = new Date;
+  const formattedDate = `${now2.getUTCFullYear()}-${String(now2.getUTCMonth() + 1).padStart(2, "0")}-${String(now2.getUTCDate()).padStart(2, "0")}`;
   const contextParts = [
     `<file_list truncated="${truncated}">
 ${fileList}
 </file_list>`,
-    `<now_date>${new Date().toISOString()}</now_date>`
+    `<now_date>${formattedDate}</now_date>`
   ];
-  if (config4?.rules) {
+  try {
+    const agentsMdContent = await fs3.readFile(path.join(cwd, "AGENTS.md"), "utf-8");
+    contextParts.push(`<agents_instructions>
+${agentsMdContent}
+</agents_instructions>`);
+  } catch {}
+  let rules = await resolveRules(config4?.rules);
+  if (commandName && config4) {
+    const apiConfig = new ApiProviderConfig(config4);
+    const commandConfig = apiConfig.getConfigForCommand(commandName);
+    if (commandConfig?.rules) {
+      const commandRules = await resolveRules(commandConfig.rules);
+      if (commandRules) {
+        rules = rules ? `${rules}
+
+${commandRules}` : commandRules;
+      }
+    }
+  }
+  if (rules) {
     contextParts.push(`<rules>
-${config4.rules}
+${rules}
 </rules>`);
   }
   if (config4?.scripts) {
@@ -85205,12 +85816,12 @@ async function select(input2, context) {
 }
 async function writeToFile(input2) {
   await mkdir2(dirname2(input2.path), { recursive: true });
-  await fs3.writeFile(input2.path, input2.content);
+  await fs4.writeFile(input2.path, input2.content);
   return {};
 }
 async function readFile3(input2) {
   try {
-    const content = await fs3.readFile(input2.path, "utf8");
+    const content = await fs4.readFile(input2.path, "utf8");
     return content;
   } catch {}
   return null;
@@ -85367,7 +85978,7 @@ async function invokeTool(input2, context) {
   const tool3 = toolHandlers.get(input2.toolName);
   if (!tool3) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: `Tool not found: ${input2.toolName}`
@@ -85379,7 +85990,7 @@ async function invokeTool(input2, context) {
     return result;
   } catch (error46) {
     return {
-      type: "Error" /* Error */,
+      success: false,
       message: {
         type: "error-text",
         value: error46?.message ?? `${error46}`
@@ -85620,6 +86231,9 @@ Memory is organized using topics, which are like named containers for different
 - Use the default topic for simple, single-context scenarios
 - Memory persists across all tool calls within the current workflow
 `;
+var AGENTS_INSTRUCTION = `## AGENTS.md Instructions
+
+If you are working in a subdirectory, check if there is an AGENTS.md file in that directory or parent directories for specific instructions. These files contain project-specific guidelines and conventions that you must follow.`;
 
 // src/workflows/prompts/coder.ts
 var CODER_SYSTEM_PROMPT = `Role: AI developer.
@@ -85631,6 +86245,8 @@ ${MEMORY_USAGE_SECTION}
 
 ${TOOL_USAGE_INSTRUCTION}
 
+${AGENTS_INSTRUCTION}
+
 ## Implementation Guidelines
 
 ### 1. Plan Analysis
@@ -86187,6 +86803,8 @@ ${MEMORY_USAGE_SECTION}
 
 ${TOOL_USAGE_INSTRUCTION}
 
+${AGENTS_INSTRUCTION}
+
 ## Your Role
 
 As a planner, your expertise lies in:
@@ -86587,7 +87205,7 @@ var fixWorkflow = async (input2, context) => {
     }
     logger.info(`Command failed with exit code ${exitCode}. Asking agent to fix it...`);
     const result = await step(`fix-${i2}`, async () => {
-      const defaultContext = await getDefaultContext();
+      const defaultContext = await getDefaultContext("fix");
       const memoryContext = await tools2.getMemoryContext();
       const userPrompt = getFixUserPrompt(command, exitCode, stdout, stderr, task, prompt);
       const agentTools = [
@@ -86653,7 +87271,7 @@ async function createPlan(input2, context) {
         userMessage: [{ role: "user", content: userFeedback ?? task }]
       };
     } else {
-      const defaultContext = await getDefaultContext();
+      const defaultContext = await getDefaultContext("plan");
       const memoryContext = await tools2.getMemoryContext();
       const prompt = `${memoryContext}
 ${getPlanPrompt(task, inputPlan)}
@@ -86709,10 +87327,10 @@ ${defaultContext}`;
     }
     const outputFiles = [];
     if (filePaths) {
-      for (const path of filePaths) {
-        const content = await tools2.readFile({ path });
+      for (const path2 of filePaths) {
+        const content = await tools2.readFile({ path: path2 });
         if (content) {
-          outputFiles.push({ path, content });
+          outputFiles.push({ path: path2, content });
         }
       }
     }
@@ -86944,7 +87562,7 @@ ${fileContentString}`;
     agentTools.push(additionalTools.search);
   }
   const res = await step("implement", async () => {
-    const defaultContext = await getDefaultContext();
+    const defaultContext = await getDefaultContext("code");
     const memoryContext = await tools2.getMemoryContext();
     const textContent = userContent.find((c) => c.type === "text");
     if (textContent && textContent.type === "text") {
@@ -87264,7 +87882,7 @@ async function createPlan2(input2, context) {
       outputSchema: EpicPlanSchema
     }, context);
   }
-  const defaultContext = await getDefaultContext();
+  const defaultContext = await getDefaultContext("epic");
   const memoryContext = await tools2.getMemoryContext();
   const prompt = `${memoryContext}
 ${getPlanPrompt(task, plan2)}
@@ -87309,7 +87927,7 @@ async function createAndApprovePlan(task, context, saveUsageSnapshot, interactiv
       const planAgentResult = await step(`plan-${planAttempt}`, () => createPlan2({ task, feedback, messages, additionalTools }, context));
       messages = planAgentResult.messages;
       planAttempt++;
-      if (planAgentResult.type !== "Exit" /* Exit */) {
+      if (planAgentResult.type !== "Exit") {
         logger.error(`Plan creation failed. Agent exited with status: ${planAgentResult.type}`);
         return null;
       }
@@ -87473,7 +88091,7 @@ async function performReviewAndFixCycle(iterationCount, taskItem, highLevelPlan,
   const commitMessages = [];
   for (let i2 = 0;i2 < MAX_REVIEW_RETRIES; i2++) {
     const diffResult = await tools2.executeCommand({ command: "git", args: ["diff", "--name-status", "HEAD~1", "HEAD"] });
-    const changedFiles = parseGitDiffNameStatus(diffResult.stdout).filter(({ path }) => path !== ".epic.yml");
+    const changedFiles = parseGitDiffNameStatus(diffResult.stdout).filter(({ path: path2 }) => path2 !== ".epic.yml");
     if (changedFiles.length === 0) {
       logger.info(`No files were changed. Skipping review.
 `);
@@ -87487,7 +88105,7 @@ Review iteration ${i2 + 1}/${MAX_REVIEW_RETRIES}`);
       changedFiles
     };
     const reviewAgentResult = await step(`review-${iterationCount}-${i2}`, { retry: 1 }, async () => {
-      const defaultContext = await getDefaultContext();
+      const defaultContext = await getDefaultContext("review");
       const memoryContext = await tools2.getMemoryContext();
       const userMessage = `${defaultContext}
 ${memoryContext}
@@ -87500,7 +88118,7 @@ ${formatReviewToolInput(changeInfo)}`;
         outputSchema: reviewOutputSchema
       }, context);
     });
-    if (reviewAgentResult.type !== "Exit" /* Exit */) {
+    if (reviewAgentResult.type !== "Exit") {
       logger.error(`Review agent failed with status: ${reviewAgentResult.type}.`);
       break;
     }
@@ -87682,7 +88300,7 @@ Phase 6: Final Review and Fixup...
   const commitRange = `${baseBranch}...${currentBranch}`;
   for (let i2 = 0;i2 < MAX_REVIEW_RETRIES; i2++) {
     const diffResult = await tools2.executeCommand({ command: "git", args: ["diff", "--name-status", commitRange] });
-    const changedFiles = parseGitDiffNameStatus(diffResult.stdout).filter(({ path }) => path !== ".epic.yml");
+    const changedFiles = parseGitDiffNameStatus(diffResult.stdout).filter(({ path: path2 }) => path2 !== ".epic.yml");
     if (changedFiles.length === 0) {
       logger.info(`No files have been changed in this branch. Skipping final review.
 `);
@@ -87696,7 +88314,7 @@ Final review iteration ${i2 + 1}/${MAX_REVIEW_RETRIES}`);
       changedFiles
     };
     const reviewAgentResult = await step(`final-review-${i2}`, async () => {
-      const defaultContext = await getDefaultContext();
+      const defaultContext = await getDefaultContext("review");
       const memoryContext = await tools2.getMemoryContext();
       const userMessage = `${defaultContext}
 ${memoryContext}
@@ -87709,7 +88327,7 @@ ${formatReviewToolInput(changeInfo)}`;
         outputSchema: reviewOutputSchema
       }, context);
     });
-    if (reviewAgentResult.type !== "Exit" /* Exit */) {
+    if (reviewAgentResult.type !== "Exit") {
       logger.error(`Review agent failed with status: ${reviewAgentResult.type}.`);
       break;
     }
@@ -87907,7 +88525,7 @@ Running generic agent...
     agentTools.push(additionalTools.search);
   }
   await step("agent", async () => {
-    const defaultContext = await getDefaultContext();
+    const defaultContext = await getDefaultContext("task");
     const userMessage = `${task}
 
 ${defaultContext}`;
@@ -87948,7 +88566,7 @@ Deciding which workflow to use for task...
     tools: [],
     outputSchema: DecisionSchema
   }, context);
-  if (result.type !== "Exit" /* Exit */ || !result.object) {
+  if (result.type !== "Exit" || !result.object) {
     throw new Error(`Could not decide which workflow to run. Agent exited with reason: ${result.type}`);
   }
   const decision = result.object;
@@ -88018,7 +88636,7 @@ var prWorkflow = async (input2, context) => {
     tools: [],
     outputSchema: prDetailsSchema
   }, context);
-  if (agentResult.type !== "Exit" /* Exit */) {
+  if (agentResult.type !== "Exit") {
     throw new Error(`Workflow exited unexpectedly with type: ${agentResult.type}`);
   }
   const prDetails = agentResult.object;
@@ -88180,7 +88798,7 @@ var reviewWorkflow = async (input2, context) => {
     return { overview: "No changes to review.", specificReviews: [] };
   }
   const result = await step("review", async () => {
-    const defaultContext = await getDefaultContext();
+    const defaultContext = await getDefaultContext("review");
     const memoryContext = await tools2.getMemoryContext();
     const reviewInput = formatReviewToolInput(changeInfo);
     const fullContent = `${reviewInput}
@@ -88228,7 +88846,7 @@ var commitCommand = new Command("commit").description("Create a commit with AI-g
 });
 
 // src/workflows/epic-context.ts
-import { promises as fs4 } from "node:fs";
+import { promises as fs5 } from "node:fs";
 var EPIC_CONTEXT_FILE = ".epic.yml";
 var EpicUsageSchema = exports_external.object({
   timestamp: exports_external.number(),
@@ -88257,12 +88875,12 @@ var saveEpicContext = async (context) => {
     memory: context.memory,
     usages: context.usages
   });
-  await fs4.writeFile(EPIC_CONTEXT_FILE, yamlString, "utf-8");
+  await fs5.writeFile(EPIC_CONTEXT_FILE, yamlString, "utf-8");
 };
 var loadEpicContext = async () => {
   let fileContent;
   try {
-    fileContent = await fs4.readFile(EPIC_CONTEXT_FILE, "utf-8");
+    fileContent = await fs5.readFile(EPIC_CONTEXT_FILE, "utf-8");
   } catch {
     return {};
   }
@@ -88792,9 +89410,9 @@ ${formattedReview}`;
 // src/commands/workflow.ts
 import { mkdir as mkdir3, readFile as readFile5, writeFile as writeFile2 } from "node:fs/promises";
 import { dirname as dirname3 } from "node:path";
-async function saveWorkflowFile(path, workflow3) {
-  await mkdir3(dirname3(path), { recursive: true });
-  await writeFile2(path, $stringify(workflow3));
+async function saveWorkflowFile(path2, workflow3) {
+  await mkdir3(dirname3(path2), { recursive: true });
+  await writeFile2(path2, $stringify(workflow3));
 }
 function clearWorkflowCode(workflowDef) {
   for (const wf of Object.values(workflowDef.workflows)) {
@@ -88906,12 +89524,15 @@ Return the updated workflow definition.`;
   }
   const workflowDef = parsedResult.definition;
   const workflowNames = Object.keys(workflowDef.workflows);
+  logger.info(`Available workflows: ${workflowNames.join(", ")}`);
   let workflowId = workflowName;
   if (!workflowId) {
     if (workflowNames.includes("main")) {
       workflowId = "main";
+      logger.info(`Using 'main' workflow`);
     } else if (workflowNames.length === 1) {
       workflowId = workflowNames[0];
+      logger.info(`Using workflow '${workflowId}'`);
     } else if (workflowNames.length > 1) {
       logger.error(`Multiple workflows found in file and no 'main' workflow. Please specify one using --workflow <name>. Available workflows: ${workflowNames.join(", ")}`);
       return;
@@ -88924,6 +89545,7 @@ Return the updated workflow definition.`;
       logger.error(`Workflow '${workflowId}' not found in file. Available workflows: ${workflowNames.join(", ")}`);
       return;
     }
+    logger.info(`Using workflow '${workflowId}'`);
   }
   let dynamicRunner;
   try {
@@ -88943,7 +89565,14 @@ Return the updated workflow definition.`;
   if (selectedWorkflow.inputs && selectedWorkflow.inputs.length > 0 && task2) {
     const firstInput = selectedWorkflow.inputs[0];
     workflowInput[firstInput.id] = task2;
+    logger.info(`Workflow input '${firstInput.id}': ${task2}`);
+  } else if (selectedWorkflow.inputs && selectedWorkflow.inputs.length > 0) {
+    logger.info(`Workflow expects inputs: ${selectedWorkflow.inputs.map((i2) => i2.id).join(", ")}`);
+  } else {
+    logger.info("Workflow has no inputs");
   }
+  logger.info(`Workflow has ${selectedWorkflow.steps.length} step(s)`);
+  logger.debug(`Steps: ${selectedWorkflow.steps.map((s2) => `${s2.id} (${s2.task})`).join(", ")}`);
   await runWorkflow(workflowFn, workflowInput, { commandName: "workflow", command, logger, yes });
 }
 var workflowCommand = new Command("workflow").description("Generate, manage, and run custom workflows.").argument("[task]", "The task description for generating the workflow.").option("-f, --file <path>", "Path to the workflow file").option("-w, --workflow <name>", "The name of the workflow to run").option("--create", "Create a new workflow").option("--regenerate", "Regenerate the code for the workflow").action(runWorkflowCommand);