@polka-codes/cli 0.9.47 → 0.9.48

package/dist/index.js

@@ -35579,7 +35579,7 @@ var {
   Help
 } = import__.default;
 // package.json
-var version = "0.9.47";
+var version = "0.9.48";
 
 // src/commands/code.ts
 import { readFile as readFile3 } from "node:fs/promises";
@@ -48216,36 +48216,12 @@ var configSchema = exports_external.object({
   rules: exports_external.array(exports_external.string()).optional().or(exports_external.string()).optional(),
   excludeFiles: exports_external.array(exports_external.string()).optional()
 }).strict();
-// ../core/src/tools/appendMemory.ts
-var toolInfo = {
-  name: "appendMemory",
-  description: "Appends content to a memory topic.",
-  parameters: exports_external.object({
-    topic: exports_external.string().nullish().describe('The topic to append to in memory. Defaults to ":default:".'),
-    content: exports_external.string().describe("The content to append.")
-  })
-};
-var handler = async (provider, args) => {
-  const { topic, content } = toolInfo.parameters.parse(args);
-  await provider.appendMemory(topic ?? undefined, content);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "text",
-      value: `Content appended to memory topic '${topic || ""}'.`
-    }
-  };
-};
-var appendMemory_default = {
-  ...toolInfo,
-  handler
-};
 // ../core/src/tools/askFollowupQuestion.ts
 var questionObject = exports_external.object({
   prompt: exports_external.string().describe("The text of the question.").meta({ usageValue: "question text here" }),
   options: exports_external.array(exports_external.string()).default([]).describe("Ordered list of suggested answers (omit if none).").meta({ usageValue: "suggested answer here" })
 });
-var toolInfo2 = {
+var toolInfo = {
   name: "askFollowupQuestion",
   description: "Call this when vital details are missing. Pose each follow-up as one direct, unambiguous question. If it speeds the reply, add up to five short, mutually-exclusive answer options. Group any related questions in the same call to avoid a back-and-forth chain.",
   parameters: exports_external.object({
@@ -48295,7 +48271,7 @@ var toolInfo2 = {
     ]
   })
 };
-var handler2 = async (provider, args) => {
+var handler = async (provider, args) => {
   if (!provider.askFollowupQuestion) {
     return {
       type: "Error" /* Error */,
@@ -48305,7 +48281,7 @@ var handler2 = async (provider, args) => {
       }
     };
   }
-  const { questions } = toolInfo2.parameters.parse(args);
+  const { questions } = toolInfo.parameters.parse(args);
   if (questions.length === 0) {
     return {
       type: "Error" /* Error */,
@@ -48333,11 +48309,11 @@ ${answer}
   };
 };
 var askFollowupQuestion_default = {
-  ...toolInfo2,
-  handler: handler2
+  ...toolInfo,
+  handler
 };
 // ../core/src/tools/executeCommand.ts
-var toolInfo3 = {
+var toolInfo2 = {
   name: "executeCommand",
   description: "Run a single CLI command. The command is always executed in the project-root working directory (regardless of earlier commands). Prefer one-off shell commands over wrapper scripts for flexibility. **IMPORTANT**: After an `execute_command` call, you MUST stop and NOT allowed to make further tool calls in the same message.",
   parameters: exports_external.object({
@@ -48364,7 +48340,7 @@ var toolInfo3 = {
     ]
   })
 };
-var handler3 = async (provider, args) => {
+var handler2 = async (provider, args) => {
   if (!provider.executeCommand) {
     return {
       type: "Error" /* Error */,
@@ -48374,7 +48350,7 @@ var handler3 = async (provider, args) => {
       }
     };
   }
-  const { command, requiresApproval } = toolInfo3.parameters.parse(args);
+  const { command, requiresApproval } = toolInfo2.parameters.parse(args);
   try {
     const result = await provider.executeCommand(command, requiresApproval);
     let message = `<command>${command}</command>
@@ -48421,11 +48397,11 @@ ${result.stderr}
   }
 };
 var executeCommand_default = {
-  ...toolInfo3,
-  handler: handler3
+  ...toolInfo2,
+  handler: handler2
 };
 // ../core/src/tools/fetchUrl.ts
-var toolInfo4 = {
+var toolInfo3 = {
   name: "fetchUrl",
   description: "Fetch the content located at one or more HTTP(S) URLs and return it in Markdown format. This works for standard web pages as well as raw files (e.g. README.md, source code) hosted on platforms like GitHub.",
   parameters: exports_external.object({
@@ -48458,7 +48434,7 @@ var toolInfo4 = {
     ]
   })
 };
-var handler4 = async (provider, args) => {
+var handler3 = async (provider, args) => {
   if (!provider.fetchUrl) {
     return {
       type: "Error" /* Error */,
@@ -48468,7 +48444,7 @@ var handler4 = async (provider, args) => {
       }
     };
   }
-  const { url: urls } = toolInfo4.parameters.parse(args);
+  const { url: urls } = toolInfo3.parameters.parse(args);
   if (urls.length === 0) {
     return {
       type: "Error" /* Error */,
@@ -48499,11 +48475,11 @@ var handler4 = async (provider, args) => {
   };
 };
 var fetchUrl_default = {
-  ...toolInfo4,
-  handler: handler4
+  ...toolInfo3,
+  handler: handler3
 };
 // ../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({
@@ -48541,7 +48517,7 @@ var toolInfo5 = {
     ]
   })
 };
-var handler5 = async (provider, args) => {
+var handler4 = async (provider, args) => {
   if (!provider.listFiles) {
     return {
       type: "Error" /* Error */,
@@ -48551,7 +48527,7 @@ var handler5 = async (provider, args) => {
       }
     };
   }
-  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 */,
@@ -48567,16 +48543,16 @@ ${files.join(`
   };
 };
 var listFiles_default = {
-  ...toolInfo5,
-  handler: handler5
+  ...toolInfo4,
+  handler: handler4
 };
 // ../core/src/tools/listMemoryTopics.ts
-var toolInfo6 = {
+var toolInfo5 = {
   name: "listMemoryTopics",
   description: "Lists all topics in memory.",
   parameters: exports_external.object({})
 };
-var handler6 = async (provider, _args) => {
+var handler5 = async (provider, _args) => {
   const topics = await provider.listMemoryTopics();
   if (!topics.length) {
     return { type: "Reply" /* Reply */, message: { type: "text", value: "No topics found." } };
@@ -48592,18 +48568,18 @@ ${topics.join(`
   };
 };
 var listMemoryTopics_default = {
-  ...toolInfo6,
-  handler: handler6
+  ...toolInfo5,
+  handler: handler5
 };
 // ../core/src/tools/readBinaryFile.ts
-var toolInfo7 = {
+var toolInfo6 = {
   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 handler7 = async (provider, args) => {
+var handler6 = async (provider, args) => {
   if (!provider.readBinaryFile) {
     return {
       type: "Error" /* Error */,
@@ -48613,7 +48589,7 @@ var handler7 = async (provider, args) => {
       }
     };
   }
-  const { url: url2 } = toolInfo7.parameters.parse(args);
+  const { url: url2 } = toolInfo6.parameters.parse(args);
   try {
     const filePart = await provider.readBinaryFile(url2);
     return {
@@ -48642,11 +48618,11 @@ var handler7 = async (provider, args) => {
   }
 };
 var readBinaryFile_default = {
-  ...toolInfo7,
-  handler: handler7
+  ...toolInfo6,
+  handler: handler6
 };
 // ../core/src/tools/readFile.ts
-var toolInfo8 = {
+var toolInfo7 = {
   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({
@@ -48683,7 +48659,7 @@ var toolInfo8 = {
     ]
   })
 };
-var handler8 = async (provider, args) => {
+var handler7 = async (provider, args) => {
   if (!provider.readFile) {
     return {
       type: "Error" /* Error */,
@@ -48693,7 +48669,7 @@ var handler8 = async (provider, args) => {
       }
     };
   }
-  const { path: paths, includeIgnored } = toolInfo8.parameters.parse(args);
+  const { path: paths, includeIgnored } = toolInfo7.parameters.parse(args);
   const resp = [];
   for (const path of paths) {
     const fileContent = await provider.readFile(path, includeIgnored);
@@ -48718,19 +48694,19 @@ var handler8 = async (provider, args) => {
   };
 };
 var readFile_default = {
-  ...toolInfo8,
-  handler: handler8
+  ...toolInfo7,
+  handler: handler7
 };
 // ../core/src/tools/readMemory.ts
-var toolInfo9 = {
+var toolInfo8 = {
   name: "readMemory",
   description: "Reads content from a memory topic.",
   parameters: exports_external.object({
     topic: exports_external.string().optional().describe('The topic to read from memory. Defaults to ":default:".')
   })
 };
-var handler9 = async (provider, args) => {
-  const { topic } = toolInfo9.parameters.parse(args);
+var handler8 = async (provider, args) => {
+  const { topic } = toolInfo8.parameters.parse(args);
   const content = await provider.readMemory(topic);
   if (content) {
     return {
@@ -48752,11 +48728,11 @@ ${content}
   };
 };
 var readMemory_default = {
-  ...toolInfo9,
-  handler: handler9
+  ...toolInfo8,
+  handler: handler8
 };
 // ../core/src/tools/removeFile.ts
-var toolInfo10 = {
+var toolInfo9 = {
   name: "removeFile",
   description: "Request to remove a file at the specified path.",
   parameters: exports_external.object({
@@ -48772,7 +48748,7 @@ var toolInfo10 = {
     ]
   })
 };
-var handler10 = async (provider, args) => {
+var handler9 = async (provider, args) => {
   if (!provider.removeFile) {
     return {
       type: "Error" /* Error */,
@@ -48782,7 +48758,7 @@ var handler10 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo10.parameters.safeParse(args);
+  const parsed = toolInfo9.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -48803,34 +48779,11 @@ var handler10 = async (provider, args) => {
   };
 };
 var removeFile_default = {
-  ...toolInfo10,
-  handler: handler10
-};
-// ../core/src/tools/removeMemory.ts
-var toolInfo11 = {
-  name: "removeMemory",
-  description: "Removes a topic from memory.",
-  parameters: exports_external.object({
-    topic: exports_external.string().optional().describe('The topic to remove from memory. Defaults to ":default:".')
-  })
-};
-var handler11 = async (provider, args) => {
-  const { topic } = toolInfo11.parameters.parse(args);
-  await provider.removeMemory(topic);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "text",
-      value: `Memory topic '${topic || ""}' removed.`
-    }
-  };
-};
-var removeMemory_default = {
-  ...toolInfo11,
-  handler: handler11
+  ...toolInfo9,
+  handler: handler9
 };
 // ../core/src/tools/renameFile.ts
-var toolInfo12 = {
+var toolInfo10 = {
   name: "renameFile",
   description: "Request to rename a file from source path to target path.",
   parameters: exports_external.object({
@@ -48848,7 +48801,7 @@ var toolInfo12 = {
     ]
   })
 };
-var handler12 = async (provider, args) => {
+var handler10 = async (provider, args) => {
   if (!provider.renameFile) {
     return {
       type: "Error" /* Error */,
@@ -48858,7 +48811,7 @@ var handler12 = async (provider, args) => {
       }
     };
   }
-  const { source_path, target_path } = toolInfo12.parameters.parse(args);
+  const { source_path, target_path } = toolInfo10.parameters.parse(args);
   await provider.renameFile(source_path, target_path);
   return {
     type: "Reply" /* Reply */,
@@ -48869,8 +48822,8 @@ var handler12 = async (provider, args) => {
   };
 };
 var renameFile_default = {
-  ...toolInfo12,
-  handler: handler12
+  ...toolInfo10,
+  handler: handler10
 };
 // ../core/src/tools/utils/replaceInFile.ts
 var replaceInFile = (fileContent, diff) => {
@@ -48947,7 +48900,7 @@ var replaceInFile = (fileContent, diff) => {
 };
 
 // ../core/src/tools/replaceInFile.ts
-var toolInfo13 = {
+var toolInfo11 = {
   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({
@@ -49057,7 +49010,7 @@ function oldFeature() {
     ]
   })
 };
-var handler13 = async (provider, args) => {
+var handler11 = async (provider, args) => {
   if (!provider.readFile || !provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -49067,7 +49020,7 @@ var handler13 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo13.parameters.safeParse(args);
+  const parsed = toolInfo11.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -49131,35 +49084,11 @@ var handler13 = async (provider, args) => {
   }
 };
 var replaceInFile_default = {
-  ...toolInfo13,
-  handler: handler13
-};
-// ../core/src/tools/replaceMemory.ts
-var toolInfo14 = {
-  name: "replaceMemory",
-  description: "Replaces content of a memory topic.",
-  parameters: exports_external.object({
-    topic: exports_external.string().optional().describe('The topic to replace in memory. Defaults to ":default:".'),
-    content: exports_external.string().describe("The new content.")
-  })
-};
-var handler14 = async (provider, args) => {
-  const { topic, content } = toolInfo14.parameters.parse(args);
-  await provider.replaceMemory(topic, content);
-  return {
-    type: "Reply" /* Reply */,
-    message: {
-      type: "text",
-      value: `Memory topic '${topic || ""}' replaced.`
-    }
-  };
-};
-var replaceMemory_default = {
-  ...toolInfo14,
-  handler: handler14
+  ...toolInfo11,
+  handler: handler11
 };
 // ../core/src/tools/searchFiles.ts
-var toolInfo15 = {
+var toolInfo12 = {
   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({
@@ -49183,7 +49112,7 @@ var toolInfo15 = {
     ]
   })
 };
-var handler15 = async (provider, args) => {
+var handler12 = async (provider, args) => {
   if (!provider.searchFiles) {
     return {
       type: "Error" /* Error */,
@@ -49193,7 +49122,7 @@ var handler15 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo15.parameters.safeParse(args);
+  const parsed = toolInfo12.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -49231,11 +49160,82 @@ ${files.join(`
   }
 };
 var searchFiles_default = {
-  ...toolInfo15,
-  handler: handler15
+  ...toolInfo12,
+  handler: handler12
+};
+// ../core/src/tools/updateMemory.ts
+var toolInfo13 = {
+  name: "updateMemory",
+  description: "Appends, replaces, or removes content from a memory topic.",
+  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().optional().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 handler13 = 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 = toolInfo13.parameters.parse(args);
+  await provider.updateMemory(params.operation, params.topic ?? undefined, "content" in params ? 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 = {
+  ...toolInfo13,
+  handler: handler13
 };
 // ../core/src/tools/writeToFile.ts
-var toolInfo16 = {
+var toolInfo14 = {
   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({
@@ -49264,7 +49264,7 @@ export default App;
     ]
   })
 };
-var handler16 = async (provider, args) => {
+var handler14 = async (provider, args) => {
   if (!provider.writeFile) {
     return {
       type: "Error" /* Error */,
@@ -49274,7 +49274,7 @@ var handler16 = async (provider, args) => {
       }
     };
   }
-  const parsed = toolInfo16.parameters.safeParse(args);
+  const parsed = toolInfo14.parameters.safeParse(args);
   if (!parsed.success) {
     return {
       type: "Error" /* Error */,
@@ -49298,8 +49298,8 @@ var handler16 = async (provider, args) => {
   };
 };
 var writeToFile_default = {
-  ...toolInfo16,
-  handler: handler16
+  ...toolInfo14,
+  handler: handler14
 };
 // ../core/src/UsageMeter.ts
 class UsageMeter {
@@ -51340,15 +51340,15 @@ function useKeypress(userHandler) {
   signal.current = userHandler;
   useEffect((rl) => {
     let ignore = false;
-    const handler17 = withUpdates((_input, event) => {
+    const handler15 = withUpdates((_input, event) => {
       if (ignore)
         return;
       signal.current(event, rl);
     });
-    rl.input.on("keypress", handler17);
+    rl.input.on("keypress", handler15);
     return () => {
       ignore = true;
-      rl.input.removeListener("keypress", handler17);
+      rl.input.removeListener("keypress", handler15);
     };
   }, []);
 }
@@ -51507,16 +51507,16 @@ class Emitter {
 
 class SignalExitBase {
 }
-var signalExitWrap = (handler17) => {
+var signalExitWrap = (handler15) => {
   return {
     onExit(cb, opts) {
-      return handler17.onExit(cb, opts);
+      return handler15.onExit(cb, opts);
     },
     load() {
-      return handler17.load();
+      return handler15.load();
     },
     unload() {
-      return handler17.unload();
+      return handler15.unload();
     }
   };
 };
@@ -52348,19 +52348,26 @@ var getProvider = (options = {}) => {
     readMemory: async (topic = defaultMemoryTopic) => {
       return memoryStore[topic];
     },
-    appendMemory: async (topic = defaultMemoryTopic, content) => {
-      if (memoryStore[topic]) {
-        memoryStore[topic] += content;
-      } else {
-        memoryStore[topic] = content;
+    updateMemory: async (operation, topic, content) => {
+      const memoryTopic = topic ?? defaultMemoryTopic;
+      switch (operation) {
+        case "append":
+          if (content === undefined) {
+            throw new Error("Content is required for append operation.");
+          }
+          memoryStore[memoryTopic] = (memoryStore[memoryTopic] || "") + content;
+          break;
+        case "replace":
+          if (content === undefined) {
+            throw new Error("Content is required for replace operation.");
+          }
+          memoryStore[memoryTopic] = content;
+          break;
+        case "remove":
+          delete memoryStore[memoryTopic];
+          break;
       }
     },
-    replaceMemory: async (topic = defaultMemoryTopic, content) => {
-      memoryStore[topic] = content;
-    },
-    removeMemory: async (topic = defaultMemoryTopic) => {
-      delete memoryStore[topic];
-    },
     readFile: async (path, includeIgnored) => {
       if (!includeIgnored && ig.ignores(path)) {
         throw new Error(`Not allow to access file ${path}`);
@@ -64124,11 +64131,11 @@ var agentWorkflow = async (input, { step, tools: tools2 }) => {
       await tools2.taskEvent(event2);
     });
   };
-  const { tools: toolInfo17, maxToolRoundTrips = 200 } = input;
+  const { tools: toolInfo15, 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 tool3 of toolInfo17) {
+  for (const tool3 of toolInfo15) {
     toolSet[tool3.name] = {
       description: tool3.description,
       inputSchema: jsonSchema(toJSONSchema(tool3.parameters))
@@ -64829,7 +64836,32 @@ var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 var source_default = chalk;
 
 // ../cli-shared/src/utils/eventHandler.ts
-var toolCallStats = new Map;
+var taskToolCallStats = new Map;
+var globalToolCallStats = new Map;
+function logToolCallStats(stream, statsMap, title) {
+  const customConsole = new Console(stream, stream);
+  customConsole.log(`
+
+======== ${title} ========`);
+  if (statsMap.size > 0) {
+    const tableData = [...statsMap.entries()].map(([tool3, stats]) => {
+      const successRate = stats.calls > 0 ? stats.success / stats.calls * 100 : 0;
+      return {
+        "Tool Name": tool3,
+        Calls: stats.calls,
+        Success: stats.success,
+        Errors: stats.errors,
+        "Success Rate": `${successRate.toFixed(2)}%`
+      };
+    });
+    customConsole.table(tableData);
+  } else {
+    customConsole.log("No tools were called.");
+  }
+}
+function logGlobalToolCallStats(stream) {
+  logToolCallStats(stream, globalToolCallStats, "Global Tool Call Stats");
+}
 var printEvent = (verbose, usageMeter, stream = process.stdout) => {
   if (verbose < 0) {
     return () => {};
@@ -64840,7 +64872,7 @@ var printEvent = (verbose, usageMeter, stream = process.stdout) => {
   return (event) => {
     switch (event.kind) {
       case "StartTask" /* StartTask */:
-        toolCallStats.clear();
+        taskToolCallStats.clear();
         if (verbose > 2) {
           customConsole.log(`
 ====== System Prompt ======
@@ -64852,10 +64884,12 @@ ${event.systemPrompt}`);
         }
         break;
       case "StartRequest" /* StartRequest */:
-        customConsole.log(`
+        if (verbose > 0) {
+          customConsole.log(`
 
 ======== New Request ========
 `);
+        }
         if (verbose > 1) {
           for (const message of event.userMessage) {
             const userMessage = message.content;
@@ -64899,10 +64933,12 @@ ${event.systemPrompt}`);
         }
         break;
       case "EndRequest" /* EndRequest */:
-        customConsole.log(`
+        if (verbose > 0) {
+          customConsole.log(`
 
 ======== Request Ended ========
 `);
+        }
         if (verbose > 1) {
           customConsole.log(usageMeter.getUsageText());
         }
@@ -64918,23 +64954,27 @@ ${event.systemPrompt}`);
         break;
       }
       case "Reasoning" /* Reasoning */: {
-        write(source_default.dim(event.newText));
-        hadReasoning = true;
+        if (verbose > 0) {
+          write(source_default.dim(event.newText));
+          hadReasoning = true;
+        }
         break;
       }
       case "ToolUse" /* ToolUse */: {
-        customConsole.log(source_default.yellow(`
+        if (verbose > 0) {
+          customConsole.log(source_default.yellow(`
 
 Tool use:`, event.tool), event.params);
-        const stats = toolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
+        }
+        const stats = taskToolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
         stats.calls++;
-        toolCallStats.set(event.tool, stats);
+        taskToolCallStats.set(event.tool, stats);
         break;
       }
       case "ToolReply" /* ToolReply */: {
-        const stats = toolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
+        const stats = taskToolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
         stats.success++;
-        toolCallStats.set(event.tool, stats);
+        taskToolCallStats.set(event.tool, stats);
         break;
       }
       case "ToolError" /* ToolError */: {
@@ -64942,9 +64982,9 @@ Tool use:`, event.tool), event.params);
 
 Tool error:`, event.tool));
         customConsole.error(event.error);
-        const stats = toolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
+        const stats = taskToolCallStats.get(event.tool) ?? { calls: 0, success: 0, errors: 0 };
         stats.errors++;
-        toolCallStats.set(event.tool, stats);
+        taskToolCallStats.set(event.tool, stats);
         break;
       }
       case "UsageExceeded" /* UsageExceeded */:
@@ -64964,23 +65004,15 @@ Tool error:`, event.tool));
             customConsole.log("Exit Message:", event.exitReason.message);
             break;
         }
-        customConsole.log(`
-
-======== Tool Call Stats ========`);
-        if (toolCallStats.size > 0) {
-          const tableData = [...toolCallStats.entries()].map(([tool3, stats]) => {
-            const successRate = stats.calls > 0 ? stats.success / stats.calls * 100 : 0;
-            return {
-              "Tool Name": tool3,
-              Calls: stats.calls,
-              Success: stats.success,
-              Errors: stats.errors,
-              "Success Rate": `${successRate.toFixed(2)}%`
-            };
-          });
-          customConsole.table(tableData);
-        } else {
-          customConsole.log("No tools were called.");
+        if (verbose > 0) {
+          for (const [tool3, taskStats] of taskToolCallStats.entries()) {
+            const globalStats = globalToolCallStats.get(tool3) ?? { calls: 0, success: 0, errors: 0 };
+            globalStats.calls += taskStats.calls;
+            globalStats.success += taskStats.success;
+            globalStats.errors += taskStats.errors;
+            globalToolCallStats.set(tool3, globalStats);
+          }
+          logToolCallStats(stream, taskToolCallStats, "Task Tool Call Stats");
         }
         break;
     }
@@ -77469,7 +77501,7 @@ function annotateDiffWithLineNumbers(diff) {
 }
 
 // src/tools/gitDiff.ts
-var toolInfo17 = {
+var toolInfo15 = {
   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({
@@ -77498,7 +77530,7 @@ var toolInfo17 = {
     }, exports_external.boolean().optional().default(false)).describe("Annotate the diff with line numbers for additions and deletions.")
   })
 };
-var handler17 = async (provider3, args) => {
+var handler15 = async (provider3, args) => {
   if (!provider3.executeCommand) {
     return {
       type: "Error" /* Error */,
@@ -77508,7 +77540,7 @@ var handler17 = async (provider3, args) => {
       }
     };
   }
-  const { staged, file: file2, commitRange, contextLines, includeLineNumbers } = toolInfo17.parameters.parse(args);
+  const { staged, file: file2, commitRange, contextLines, includeLineNumbers } = toolInfo15.parameters.parse(args);
   const commandParts = ["git", "diff", "--no-color", `-U${contextLines}`];
   if (staged) {
     commandParts.push("--staged");
@@ -77565,8 +77597,8 @@ ${result.stderr}`
   }
 };
 var gitDiff_default = {
-  ...toolInfo17,
-  handler: handler17
+  ...toolInfo15,
+  handler: handler15
 };
 // src/utils/cacheControl.ts
 var CACHEABLE_MODELS = ["sonnet", "opus", "haiku", "gemini"];
@@ -77889,11 +77921,9 @@ var allTools = [
   listFiles_default,
   readBinaryFile_default,
   readFile_default,
-  appendMemory_default,
   readMemory_default,
-  replaceMemory_default,
-  removeMemory_default,
   listMemoryTopics_default,
+  updateMemory_default,
   removeFile_default,
   renameFile_default,
   replaceInFile_default,
@@ -78158,17 +78188,10 @@ ${defaultContent}
   return contextParts.join(`
 `);
 }
-async function appendMemory(input2, context) {
-  const provider3 = context.toolProvider;
-  await provider3.appendMemory(input2.topic, input2.content);
-}
-async function replaceMemory(input2, context) {
+async function updateMemory(input2, context) {
   const provider3 = context.toolProvider;
-  await provider3.replaceMemory(input2.topic, input2.content);
-}
-async function removeMemory(input2, context) {
-  const provider3 = context.toolProvider;
-  await provider3.removeMemory(input2.topic);
+  const content = "content" in input2 ? input2.content : undefined;
+  return provider3.updateMemory(input2.operation, input2.topic, content);
 }
 var localToolHandlers = {
   createPullRequest,
@@ -78184,14 +78207,12 @@ var localToolHandlers = {
   invokeTool,
   taskEvent,
   getMemoryContext,
-  appendMemory,
-  replaceMemory,
-  removeMemory
+  updateMemory
 };
 async function toolCall(toolCall2, context) {
-  const handler18 = localToolHandlers[toolCall2.tool];
-  if (handler18) {
-    return handler18(toolCall2.input, context);
+  const handler16 = localToolHandlers[toolCall2.tool];
+  if (handler16) {
+    return handler16(toolCall2.input, context);
   }
   throw new Error(`Unknown tool: ${toolCall2.tool}`);
 }
@@ -78256,7 +78277,9 @@ async function runWorkflow(workflow2, workflowInput, options) {
   try {
     logger.info("Running workflow...");
     const output = await workflow2(workflowInput, context);
-    logger.info("Workflow completed successfully.");
+    logger.info(`
+
+Workflow completed successfully.`);
     logger.info(usage.getUsageText());
     return output;
   } catch (e) {
@@ -78269,6 +78292,8 @@ async function runWorkflow(workflow2, workflowInput, options) {
     }
     logger.info(usage.getUsageText());
     return;
+  } finally {
+    logGlobalToolCallStats(process.stderr);
   }
 }
 
@@ -78303,7 +78328,8 @@ As a planner, your expertise lies in:
 - Exploring codebases to identify patterns, conventions, and integration points
 - Breaking down complex tasks into clear, logical sequences of steps
 - Anticipating dependencies, edge cases, and potential challenges
-- Creating plans that are specific, actionable, and implementable by other developers or AI agents
+- Creating plans that can be executed autonomously by an AI coding agent
+- Providing technical specificity required for autonomous implementation
 
 ## Planning Philosophy
 
@@ -78322,16 +78348,39 @@ Effective planning requires understanding before action:
    - Understanding context prevents suggesting solutions that don't fit the project
 
 3. **Specificity Over Generality**
-   - Vague plans lead to implementation confusion
+   - Vague plans lead to implementation confusion and prevent autonomous execution
    - Instead of "implement the feature," specify which files to modify, what functions to add, and what logic to implement
    - Name specific components, modules, or files when possible
    - Describe what needs to change and why
-
-4. **Clarity for AI and Human Implementers**
-   - Plans should be understandable and actionable by someone else
-   - Each step should have a clear deliverable
-   - Break complex tasks into smaller, logical units
+   - Examples:
+     * ❌ Vague: "Implement the feature"
+     * ✅ Specific: "Create \`src/components/LoginForm.tsx\` with a React component that includes email and password fields, using the existing \`useAuth\` hook from \`src/hooks/useAuth.ts\`"
+     * ❌ Vague: "Add error handling"
+     * ✅ Specific: "In \`src/api/client.ts\`, wrap the fetch call in a try-catch block and throw custom errors using the \`ApiError\` class from \`src/errors.ts\`"
+
+4. **Clarity for AI Coding Agents**
+   - Plans will be executed autonomously by an AI coding agent without human intervention
+   - Break complex tasks into smaller, logical units that can be completed independently
    - Use clear structure (numbered lists, narrative text, or combined formats) to organize steps
+   - Include exact file paths, function names, and implementation patterns
+
+## Planning for AI Implementation
+
+Plans will be executed by an AI coding agent that operates autonomously with the following capabilities:
+
+**Planning Requirements:**
+Plans should include specific technical details to enable autonomous implementation:
+- **Function/class names**: Name specific functions, classes, or components to implement
+- **Implementation patterns**: Reference existing patterns or provide clear guidance on approach
+- **Import statements**: Specify required dependencies and where to import them from
+- **Technical constraints**: Note any architectural decisions, performance requirements, or compatibility concerns
+
+**What Makes a Good AI-Actionable Plan:**
+- Each step can be completed using the available tools
+- File paths and code structures are explicitly named
+- Dependencies between steps are clear
+- Implementation approach follows existing codebase patterns
+- Technical requirements are specific, not general
 
 ## Your Approach
 
@@ -78408,9 +78457,11 @@ When generating your plan, follow these formatting guidelines:
       2. Implement feature B
       3. Write tests
 
-5. Only include relevant details for AI Agents:
-    a. Avoid unnecessary technical jargon or implementation details
-    b. Avoid steps that require human intervention or cannot be done by an AI agent
+5. Include implementation-ready details for AI agents:
+    a. Provide specific technical details the coding agent needs (file paths, function signatures, etc.)
+    b. Avoid steps that require human intervention or manual processes
+    c. Each step should be implementable using the AI agent's available tools
+    d. Reference existing code patterns and conventions from the codebase
 
 **Note**: Plans should use flexible formats such as numbered lists or narrative text. Checklist formats (markdown checkboxes) are NOT required and should only be used when specifically appropriate for tracking independent action items.
 
@@ -78613,7 +78664,7 @@ You will receive:
 ## Process
 
 1. **Find the completed item**: Locate the item in the plan that matches the completed task
-2. **Mark it as complete**: 
+2. **Mark it as complete**:
    - If using checkboxes: Change \`- [ ]\` to \`- [x]\`
    - If using numbered lists: Add a ✅ prefix (e.g., "1. Task" → "✅ 1. Task")
    - If using narrative: Mark completion in context-appropriate way
@@ -79060,9 +79111,7 @@ ${memoryContext}`
           removeFile_default,
           renameFile_default,
           readMemory_default,
-          appendMemory_default,
-          replaceMemory_default,
-          removeMemory_default,
+          updateMemory_default,
           listMemoryTopics_default
         ],
         outputSchema: FixIterationSummarySchema
@@ -79077,7 +79126,7 @@ ${memoryContext}`
         }
         if (summary) {
           summaries.push(summary);
-          await tools2.appendMemory({ content: `Summary of changes for fix attempt ${i + 1}: ${summary}` });
+          await tools2.updateMemory({ operation: "append", content: `Summary of changes for fix attempt ${i + 1}: ${summary}` });
           logger.info(`Summary of changes: ${summary}`);
         }
       }
@@ -79130,9 +79179,7 @@ ${defaultContext}`;
     fetchUrl_default,
     listMemoryTopics_default,
     readMemory_default,
-    appendMemory_default,
-    replaceMemory_default,
-    removeMemory_default
+    updateMemory_default
   ];
   if (interactive) {
     agentTools.push(askFollowupQuestion_default);
@@ -79373,9 +79420,7 @@ ${fileContentString}`;
     removeFile_default,
     renameFile_default,
     readMemory_default,
-    appendMemory_default,
-    replaceMemory_default,
-    removeMemory_default,
+    updateMemory_default,
     listMemoryTopics_default
   ];
   if (mode === "interactive") {
@@ -79419,7 +79464,8 @@ ${memoryContext}`
       summaries.push(summary);
       logger.info(`Summary: ${summary}`);
       await step("summarize-implementation", async () => {
-        await tools2.appendMemory({
+        await tools2.updateMemory({
+          operation: "append",
           topic: "implementation-summary",
           content: summary
         });
@@ -79891,18 +79937,7 @@ ${formatReviewToolInput(changeInfo)}`;
       return await agentWorkflow({
         systemPrompt: CODE_REVIEW_SYSTEM_PROMPT,
         userMessage: [{ role: "user", content: userMessage }],
-        tools: [
-          readFile_default,
-          readBinaryFile_default,
-          searchFiles_default,
-          listFiles_default,
-          gitDiff_default,
-          readMemory_default,
-          appendMemory_default,
-          replaceMemory_default,
-          removeMemory_default,
-          listMemoryTopics_default
-        ],
+        tools: [readFile_default, readBinaryFile_default, searchFiles_default, listFiles_default, gitDiff_default, readMemory_default, updateMemory_default, listMemoryTopics_default],
         outputSchema: reviewOutputSchema
       }, context);
     });
@@ -79991,9 +80026,7 @@ ${feedback}`
       readBinaryFile_default,
       searchFiles_default,
       readMemory_default,
-      appendMemory_default,
-      replaceMemory_default,
-      removeMemory_default,
+      updateMemory_default,
       listMemoryTopics_default
     ],
     outputSchema: EpicPlanSchema
@@ -80075,9 +80108,11 @@ var epicWorkflow = async (input2, context) => {
     let feedback;
     let highLevelPlan2;
     let branchName2;
+    let planAttempt = 1;
     try {
       while (true) {
-        const result = await step2("plan", () => createPlan2({ task: task2, feedback }, context2));
+        const result = await step2(`plan-${planAttempt}`, () => createPlan2({ task: task2, feedback }, context2));
+        planAttempt++;
         if (result.question) {
           const answer = await tools3.input({
             message: result.question.question,
@@ -80166,13 +80201,14 @@ ${result.plan}`);
     await step2("createBranch", async () => await tools3.executeCommand({ command: "git", args: ["checkout", "-b", finalBranchName] }));
     logger2.info(`✅ Branch '${finalBranchName}' created.
 `);
-    await tools3.appendMemory({
+    await tools3.updateMemory({
+      operation: "append",
       topic: "epic-context",
       content: `Epic: ${task2}
 Branch: ${finalBranchName}
 Started: ${new Date().toISOString()}`
     });
-    await tools3.appendMemory({ topic: "epic-plan", content: plan });
+    await tools3.updateMemory({ operation: "append", topic: "epic-plan", content: plan });
     return { success: true, branchName: finalBranchName };
   }
   const branchResult = await createFeatureBranch(branchName, task, highLevelPlan, context);
@@ -80244,7 +80280,7 @@ Focus only on this item, but use the plan for context.`;
       currentPlan = updateResult.updatedPlan;
       isComplete = updateResult.isComplete;
       nextTask = updateResult.nextTask;
-      await tools2.replaceMemory({ topic: "epic-plan", content: currentPlan });
+      await tools2.updateMemory({ operation: "replace", topic: "epic-plan", content: currentPlan });
       const checkboxCompleted = (currentPlan.match(/- \[x\]/g) || []).length;
       const checkboxTotal = (currentPlan.match(/- \[[x ]\]/g) || []).length;
       const checkmarkCompleted = (currentPlan.match(/^✅/gm) || []).length;
@@ -80277,8 +80313,8 @@ Focus only on this item, but use the plan for context.`;
 Branch '${branchName}' was created but work is incomplete.`);
     logger.info(`To cleanup: git checkout <previous-branch> && git branch -D ${branchName}
 `);
-    await tools2.removeMemory({ topic: "epic-context" });
-    await tools2.removeMemory({ topic: "epic-plan" });
+    await tools2.updateMemory({ operation: "remove", topic: "epic-context" });
+    await tools2.updateMemory({ operation: "remove", topic: "epic-plan" });
     throw error46;
   }
   const totalElapsed = Date.now() - workflowStartTime;
@@ -80308,8 +80344,8 @@ ${"=".repeat(80)}`);
 `);
   logger.info(`${"=".repeat(80)}
 `);
-  await tools2.removeMemory({ topic: "epic-context" });
-  await tools2.removeMemory({ topic: "epic-plan" });
+  await tools2.updateMemory({ operation: "remove", topic: "epic-context" });
+  await tools2.updateMemory({ operation: "remove", topic: "epic-plan" });
 };
 
 // src/workflows/task.workflow.ts

package/package.json

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