@kody-ade/kody-engine 0.4.150 → 0.4.152

package/dist/bin/kody.js

@@ -1061,7 +1061,7 @@ var init_loadPriorArt = __esm({
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.150",
+  version: "0.4.152",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1662,11 +1662,27 @@ function resolveTurnTimeoutMs(opts) {
   if (Number.isFinite(envSec) && envSec <= 0) return 0;
   return DEFAULT_TURN_TIMEOUT_MS;
 }
+var MAX_CONNECTION_RETRIES = 2;
+var CONNECTION_RETRY_BASE_MS = 2e3;
+function isTransientConnectionError(msg) {
+  if (!msg) return false;
+  return /ConnectionRefused|ECONNREFUSED|ECONNRESET|ETIMEDOUT|EHOSTUNREACH|ENOTFOUND|socket hang up|Unable to connect to API|fetch failed/i.test(
+    msg
+  );
+}
+var MUTATING_FILE_TOOLS = /* @__PURE__ */ new Set(["Edit", "Write", "MultiEdit", "NotebookEdit"]);
+var BASH_WRITE_VERB = /\b(git\s+(commit|push|merge|rebase|tag|reset|cherry-pick)|gh\s+(pr|issue|release)\s+(create|comment|edit|close|merge|review|reopen)|gh\s+api\b[^|&]*-X\s*(POST|PUT|PATCH|DELETE)|npm\s+publish)\b/i;
+function toolMayMutate(name, input) {
+  if (!name) return false;
+  if (MUTATING_FILE_TOOLS.has(name)) return true;
+  if (name.startsWith("mcp__kody-submit__")) return true;
+  if (name === "Bash") return BASH_WRITE_VERB.test(String(input?.command ?? ""));
+  return false;
+}
 async function runAgent(opts) {
   const ndjsonDir = opts.ndjsonDir ?? path7.join(opts.cwd, ".kody");
   fs7.mkdirSync(ndjsonDir, { recursive: true });
   const ndjsonPath = path7.join(ndjsonDir, "last-run.jsonl");
-  const fullLog = fs7.createWriteStream(ndjsonPath, { flags: "w" });
   const env = {
     ...process.env,
     SKIP_HOOKS: "1",
@@ -1685,227 +1701,259 @@ async function runAgent(opts) {
     env.ANTHROPIC_BASE_URL = opts.litellmUrl;
     env.ANTHROPIC_API_KEY = getAnthropicApiKeyOrDummy();
   }
-  const resultTexts = [];
+  const startedAt = Date.now();
+  const turnTimeoutMs = resolveTurnTimeoutMs(opts);
   let outcome = "failed";
   let outcomeKind = "generic_failed";
   let errorMessage;
-  const tokens = { input: 0, output: 0, cacheRead: 0, cacheCreate: 0 };
+  let tokens = { input: 0, output: 0, cacheRead: 0, cacheCreate: 0 };
   let messageCount = 0;
-  const startedAt = Date.now();
-  const turnTimeoutMs = resolveTurnTimeoutMs(opts);
-  let ndjsonWriteFailed = false;
-  let ndjsonWriteError;
+  let finalText = "";
   let getSubmitted;
-  try {
-    const queryOptions = {
-      model: opts.model.model,
-      cwd: opts.cwd,
-      // Fresh array (never mutate the shared DEFAULT_ALLOWED_TOOLS const) so
-      // opt-in tools like fetch_repo can be appended below.
-      allowedTools: [...opts.allowedToolsOverride ?? DEFAULT_ALLOWED_TOOLS],
-      permissionMode: opts.permissionModeOverride ?? "acceptEdits",
-      env
-    };
-    const mcpEntries = [];
-    if (opts.mcpServers && opts.mcpServers.length > 0) {
-      for (const s of opts.mcpServers) {
-        const cfg = { command: s.command };
-        if (s.args) cfg.args = s.args;
-        if (s.env) cfg.env = s.env;
-        mcpEntries.push([s.name, cfg]);
-      }
-    }
-    if (opts.enableVerifyTool && opts.verifyConfig) {
-      const { buildVerifyMcpServer: buildVerifyMcpServer2 } = await Promise.resolve().then(() => (init_verifyMcp(), verifyMcp_exports));
-      const verifyServer = buildVerifyMcpServer2({
-        config: opts.verifyConfig,
+  for (let attempt = 0; ; attempt++) {
+    const fullLog = fs7.createWriteStream(ndjsonPath, { flags: "w" });
+    const resultTexts = [];
+    outcome = "failed";
+    outcomeKind = "generic_failed";
+    errorMessage = void 0;
+    tokens = { input: 0, output: 0, cacheRead: 0, cacheCreate: 0 };
+    messageCount = 0;
+    let ndjsonWriteFailed = false;
+    let ndjsonWriteError;
+    let sawMutatingTool = false;
+    try {
+      const queryOptions = {
+        model: opts.model.model,
         cwd: opts.cwd,
-        executable: opts.executableName ?? "agent",
-        maxAttempts: typeof opts.verifyToolMaxAttempts === "number" && opts.verifyToolMaxAttempts > 0 ? opts.verifyToolMaxAttempts : void 0
-      });
-      mcpEntries.push(["kody-verify", verifyServer]);
-    }
-    if (opts.enableSubmitTool) {
-      const { buildSubmitMcpServer: buildSubmitMcpServer2 } = await Promise.resolve().then(() => (init_submitMcp(), submitMcp_exports));
-      const submitHandle = buildSubmitMcpServer2();
-      getSubmitted = submitHandle.getSubmitted;
-      mcpEntries.push(["kody-submit", submitHandle.server]);
-    }
-    if (opts.enableFetchRepoTool && opts.reposRoot) {
-      const { buildFetchRepoMcpServer: buildFetchRepoMcpServer2 } = await Promise.resolve().then(() => (init_fetchRepoMcp(), fetchRepoMcp_exports));
-      const fetchServer = buildFetchRepoMcpServer2({
-        reposRoot: opts.reposRoot,
-        repoToken: opts.repoToken
-      });
-      mcpEntries.push(["kody-fetch-repo", fetchServer]);
-      queryOptions.allowedTools.push("mcp__kody-fetch-repo__fetch_repo");
-      queryOptions.additionalDirectories = [opts.reposRoot];
-    }
-    if (mcpEntries.length > 0) {
-      queryOptions.mcpServers = Object.fromEntries(mcpEntries);
-    }
-    if (opts.pluginPaths && opts.pluginPaths.length > 0) {
-      queryOptions.plugins = opts.pluginPaths.map((p) => ({ type: "local", path: p }));
-    }
-    if (opts.agents && Object.keys(opts.agents).length > 0) {
-      queryOptions.agents = opts.agents;
-    }
-    if (typeof opts.maxTurns === "number" && opts.maxTurns > 0) {
-      queryOptions.maxTurns = opts.maxTurns;
-    }
-    if (typeof opts.maxThinkingTokens === "number" && opts.maxThinkingTokens > 0) {
-      queryOptions.maxThinkingTokens = opts.maxThinkingTokens;
-    }
-    if (typeof opts.systemPromptAppend === "string" && opts.systemPromptAppend.length > 0) {
-      const systemPrompt = {
-        type: "preset",
-        preset: "claude_code",
-        append: opts.systemPromptAppend
+        // Fresh array (never mutate the shared DEFAULT_ALLOWED_TOOLS const) so
+        // opt-in tools like fetch_repo can be appended below.
+        allowedTools: [...opts.allowedToolsOverride ?? DEFAULT_ALLOWED_TOOLS],
+        permissionMode: opts.permissionModeOverride ?? "acceptEdits",
+        env
       };
-      if (opts.cacheable) systemPrompt.excludeDynamicSections = true;
-      queryOptions.systemPrompt = systemPrompt;
-    } else if (opts.cacheable) {
-      queryOptions.systemPrompt = {
-        type: "preset",
-        preset: "claude_code",
-        excludeDynamicSections: true
-      };
-    }
-    queryOptions.settingSources = opts.settingSources ?? ["project", "local"];
-    const stableBinary = ensureStableClaudeBinary();
-    if (stableBinary) {
-      queryOptions.pathToClaudeCodeExecutable = stableBinary;
-    }
-    const result = query({
-      prompt: opts.prompt,
-      // biome-ignore lint/suspicious/noExplicitAny: SDK options type is narrow; mcpServers is runtime-passthrough.
-      options: queryOptions
-    });
-    const iterator = typeof result[Symbol.asyncIterator] === "function" ? result[Symbol.asyncIterator]() : result;
-    while (true) {
-      const nextPromise = iterator.next();
-      let timedOut = false;
-      let timer;
-      let next;
-      if (turnTimeoutMs > 0) {
-        const timeoutPromise = new Promise((resolve6) => {
-          timer = setTimeout(() => {
-            timedOut = true;
-            resolve6({ done: true, value: void 0 });
-          }, turnTimeoutMs);
+      const mcpEntries = [];
+      if (opts.mcpServers && opts.mcpServers.length > 0) {
+        for (const s of opts.mcpServers) {
+          const cfg = { command: s.command };
+          if (s.args) cfg.args = s.args;
+          if (s.env) cfg.env = s.env;
+          mcpEntries.push([s.name, cfg]);
+        }
+      }
+      if (opts.enableVerifyTool && opts.verifyConfig) {
+        const { buildVerifyMcpServer: buildVerifyMcpServer2 } = await Promise.resolve().then(() => (init_verifyMcp(), verifyMcp_exports));
+        const verifyServer = buildVerifyMcpServer2({
+          config: opts.verifyConfig,
+          cwd: opts.cwd,
+          executable: opts.executableName ?? "agent",
+          maxAttempts: typeof opts.verifyToolMaxAttempts === "number" && opts.verifyToolMaxAttempts > 0 ? opts.verifyToolMaxAttempts : void 0
         });
-        next = await Promise.race([nextPromise, timeoutPromise]);
-        if (timer) clearTimeout(timer);
-      } else {
-        next = await nextPromise;
+        mcpEntries.push(["kody-verify", verifyServer]);
       }
-      if (timedOut) {
-        outcome = "failed";
-        outcomeKind = "stalled";
-        errorMessage = `agent stalled: no SDK message in ${Math.round(turnTimeoutMs / 1e3)}s`;
-        if (typeof iterator.return === "function") {
-          try {
-            await iterator.return(void 0);
-          } catch {
+      if (opts.enableSubmitTool) {
+        const { buildSubmitMcpServer: buildSubmitMcpServer2 } = await Promise.resolve().then(() => (init_submitMcp(), submitMcp_exports));
+        const submitHandle = buildSubmitMcpServer2();
+        getSubmitted = submitHandle.getSubmitted;
+        mcpEntries.push(["kody-submit", submitHandle.server]);
+      }
+      if (opts.enableFetchRepoTool && opts.reposRoot) {
+        const { buildFetchRepoMcpServer: buildFetchRepoMcpServer2 } = await Promise.resolve().then(() => (init_fetchRepoMcp(), fetchRepoMcp_exports));
+        const fetchServer = buildFetchRepoMcpServer2({
+          reposRoot: opts.reposRoot,
+          repoToken: opts.repoToken
+        });
+        mcpEntries.push(["kody-fetch-repo", fetchServer]);
+        queryOptions.allowedTools.push("mcp__kody-fetch-repo__fetch_repo");
+        queryOptions.additionalDirectories = [opts.reposRoot];
+      }
+      if (mcpEntries.length > 0) {
+        queryOptions.mcpServers = Object.fromEntries(mcpEntries);
+      }
+      if (opts.pluginPaths && opts.pluginPaths.length > 0) {
+        queryOptions.plugins = opts.pluginPaths.map((p) => ({ type: "local", path: p }));
+      }
+      if (opts.agents && Object.keys(opts.agents).length > 0) {
+        queryOptions.agents = opts.agents;
+      }
+      if (typeof opts.maxTurns === "number" && opts.maxTurns > 0) {
+        queryOptions.maxTurns = opts.maxTurns;
+      }
+      if (typeof opts.maxThinkingTokens === "number" && opts.maxThinkingTokens > 0) {
+        queryOptions.maxThinkingTokens = opts.maxThinkingTokens;
+      }
+      if (typeof opts.systemPromptAppend === "string" && opts.systemPromptAppend.length > 0) {
+        const systemPrompt = {
+          type: "preset",
+          preset: "claude_code",
+          append: opts.systemPromptAppend
+        };
+        if (opts.cacheable) systemPrompt.excludeDynamicSections = true;
+        queryOptions.systemPrompt = systemPrompt;
+      } else if (opts.cacheable) {
+        queryOptions.systemPrompt = {
+          type: "preset",
+          preset: "claude_code",
+          excludeDynamicSections: true
+        };
+      }
+      queryOptions.settingSources = opts.settingSources ?? ["project", "local"];
+      const stableBinary = ensureStableClaudeBinary();
+      if (stableBinary) {
+        queryOptions.pathToClaudeCodeExecutable = stableBinary;
+      }
+      const result = query({
+        prompt: opts.prompt,
+        // biome-ignore lint/suspicious/noExplicitAny: SDK options type is narrow; mcpServers is runtime-passthrough.
+        options: queryOptions
+      });
+      const iterator = typeof result[Symbol.asyncIterator] === "function" ? result[Symbol.asyncIterator]() : result;
+      while (true) {
+        const nextPromise = iterator.next();
+        let timedOut = false;
+        let timer;
+        let next;
+        if (turnTimeoutMs > 0) {
+          const timeoutPromise = new Promise((resolve6) => {
+            timer = setTimeout(() => {
+              timedOut = true;
+              resolve6({ done: true, value: void 0 });
+            }, turnTimeoutMs);
+          });
+          next = await Promise.race([nextPromise, timeoutPromise]);
+          if (timer) clearTimeout(timer);
+        } else {
+          next = await nextPromise;
+        }
+        if (timedOut) {
+          outcome = "failed";
+          outcomeKind = "stalled";
+          errorMessage = `agent stalled: no SDK message in ${Math.round(turnTimeoutMs / 1e3)}s`;
+          if (typeof iterator.return === "function") {
+            try {
+              await iterator.return(void 0);
+            } catch {
+            }
           }
+          break;
         }
-        break;
-      }
-      if (next.done) break;
-      const msg = next.value;
-      messageCount++;
-      try {
-        fullLog.write(`${JSON.stringify(msg)}
+        if (next.done) break;
+        const msg = next.value;
+        messageCount++;
+        try {
+          fullLog.write(`${JSON.stringify(msg)}
 `);
-      } catch (e) {
-        ndjsonWriteFailed = true;
-        ndjsonWriteError = e instanceof Error ? e.message : String(e);
-      }
-      const line = renderEvent(msg, { verbose: opts.verbose, quiet: opts.quiet });
-      if (line) process.stdout.write(`${line}
+        } catch (e) {
+          ndjsonWriteFailed = true;
+          ndjsonWriteError = e instanceof Error ? e.message : String(e);
+        }
+        const line = renderEvent(msg, { verbose: opts.verbose, quiet: opts.quiet });
+        if (line) process.stdout.write(`${line}
 `);
-      const m = msg;
-      if (opts.onProgress) {
-        const blocks = m.message?.content ?? [];
-        for (const block of blocks) {
-          try {
-            if (block.type === "thinking") {
-              const t = block.thinking;
-              if (typeof t === "string" && t.length > 0) {
-                await opts.onProgress({ kind: "thinking", thinking: t });
-              }
-            } else if (block.type === "tool_use") {
-              const b = block;
-              await opts.onProgress({
-                kind: "tool_use",
-                name: b.name ?? "tool",
-                input: b.input,
-                id: b.id
-              });
-            } else if (block.type === "tool_result") {
-              const b = block;
-              const content = typeof b.content === "string" ? b.content : (() => {
-                try {
-                  return JSON.stringify(b.content);
-                } catch {
-                  return "";
+        const m = msg;
+        if (opts.onProgress) {
+          const blocks = m.message?.content ?? [];
+          for (const block of blocks) {
+            try {
+              if (block.type === "thinking") {
+                const t = block.thinking;
+                if (typeof t === "string" && t.length > 0) {
+                  await opts.onProgress({ kind: "thinking", thinking: t });
+                }
+              } else if (block.type === "tool_use") {
+                const b = block;
+                await opts.onProgress({
+                  kind: "tool_use",
+                  name: b.name ?? "tool",
+                  input: b.input,
+                  id: b.id
+                });
+              } else if (block.type === "tool_result") {
+                const b = block;
+                const content = typeof b.content === "string" ? b.content : (() => {
+                  try {
+                    return JSON.stringify(b.content);
+                  } catch {
+                    return "";
+                  }
+                })();
+                await opts.onProgress({
+                  kind: "tool_result",
+                  toolUseId: b.tool_use_id,
+                  content,
+                  isError: b.is_error
+                });
+              } else if (block.type === "text") {
+                const b = block;
+                if (typeof b.text === "string" && b.text.length > 0) {
+                  await opts.onProgress({ kind: "text", text: b.text });
                 }
-              })();
-              await opts.onProgress({
-                kind: "tool_result",
-                toolUseId: b.tool_use_id,
-                content,
-                isError: b.is_error
-              });
-            } else if (block.type === "text") {
+              }
+            } catch {
+            }
+          }
+        }
+        const usage = m.usage;
+        if (usage && typeof usage === "object") {
+          const i = Number(usage.input_tokens ?? 0);
+          const o = Number(usage.output_tokens ?? 0);
+          const cr = Number(usage.cache_read_input_tokens ?? 0);
+          const cc = Number(usage.cache_creation_input_tokens ?? 0);
+          if (Number.isFinite(i)) tokens.input += i;
+          if (Number.isFinite(o)) tokens.output += o;
+          if (Number.isFinite(cr)) tokens.cacheRead += cr;
+          if (Number.isFinite(cc)) tokens.cacheCreate += cc;
+        }
+        if (!sawMutatingTool) {
+          const blocks = m.message?.content ?? [];
+          for (const block of blocks) {
+            if (block.type === "tool_use") {
               const b = block;
-              if (typeof b.text === "string" && b.text.length > 0) {
-                await opts.onProgress({ kind: "text", text: b.text });
+              if (toolMayMutate(b.name, b.input)) {
+                sawMutatingTool = true;
+                break;
               }
             }
-          } catch {
           }
         }
-      }
-      const usage = m.usage;
-      if (usage && typeof usage === "object") {
-        const i = Number(usage.input_tokens ?? 0);
-        const o = Number(usage.output_tokens ?? 0);
-        const cr = Number(usage.cache_read_input_tokens ?? 0);
-        const cc = Number(usage.cache_creation_input_tokens ?? 0);
-        if (Number.isFinite(i)) tokens.input += i;
-        if (Number.isFinite(o)) tokens.output += o;
-        if (Number.isFinite(cr)) tokens.cacheRead += cr;
-        if (Number.isFinite(cc)) tokens.cacheCreate += cc;
-      }
-      if (m.type === "result") {
-        if (m.subtype === "success") {
-          outcome = "completed";
-          outcomeKind = "ok";
-          const text = (typeof m.result === "string" ? m.result : "").trim();
-          if (text) resultTexts.push(text);
-        } else {
-          outcome = "failed";
-          outcomeKind = classifySubtype(m.subtype);
-          errorMessage = `result subtype: ${m.subtype ?? "unknown"}`;
+        if (m.type === "result") {
+          if (m.subtype === "success") {
+            outcome = "completed";
+            outcomeKind = "ok";
+            const text = (typeof m.result === "string" ? m.result : "").trim();
+            if (text) resultTexts.push(text);
+          } else {
+            outcome = "failed";
+            outcomeKind = classifySubtype(m.subtype);
+            errorMessage = `result subtype: ${m.subtype ?? "unknown"}`;
+          }
         }
       }
+    } catch (e) {
+      outcome = "failed";
+      outcomeKind = "model_error";
+      errorMessage = e instanceof Error ? e.message : String(e);
+    } finally {
+      try {
+        fullLog.end();
+      } catch {
+      }
     }
-  } catch (e) {
-    outcome = "failed";
-    outcomeKind = "model_error";
-    errorMessage = e instanceof Error ? e.message : String(e);
-  } finally {
-    try {
-      fullLog.end();
-    } catch {
+    if (ndjsonWriteFailed) {
+      process.stderr.write(
+        `[kody agent] NDJSON write failed (post-mortem may be incomplete): ${ndjsonWriteError ?? "unknown error"}
+`
+      );
     }
+    finalText = resultTexts.join("\n\n---\n\n");
+    const shouldRetry = outcome === "failed" && attempt < MAX_CONNECTION_RETRIES && !sawMutatingTool && isTransientConnectionError(errorMessage);
+    if (!shouldRetry) break;
+    const delayMs = CONNECTION_RETRY_BASE_MS * 2 ** attempt;
+    process.stderr.write(
+      `[kody agent] transient connection error (attempt ${attempt + 1}/${MAX_CONNECTION_RETRIES + 1}); retrying in ${Math.round(delayMs / 1e3)}s: ${errorMessage}
+`
+    );
+    await new Promise((r) => setTimeout(r, delayMs));
   }
-  if (ndjsonWriteFailed) {
-    process.stderr.write(`[kody agent] NDJSON write failed (post-mortem may be incomplete): ${ndjsonWriteError ?? "unknown error"}
-`);
-  }
-  const finalText = resultTexts.join("\n\n---\n\n");
   const submittedState = getSubmitted?.();
   return {
     outcome,
@@ -7850,6 +7898,8 @@ var FAILED = {
   description: "kody: flow failed"
 };
 var finalizeTerminal = async (ctx) => {
+  const flow = ctx.data.taskState?.flow;
+  if (flow?.issueNumber) return;
   const target = ctx.data.commentTargetType ?? "issue";
   const issueNumber = ctx.args.issue;
   const targetNumber = ctx.data.commentTargetNumber ?? issueNumber;
@@ -12047,6 +12097,11 @@ function postKodyComment(target, issueNumber, state, next, cwd) {
 // src/scripts/syncFlow.ts
 import { execFileSync as execFileSync25 } from "child_process";
 init_issue();
+var DONE2 = {
+  label: "kody:done",
+  color: "0e8a16",
+  description: "kody: PR ready for human review/merge"
+};
 var syncFlow = async (ctx, _profile, args) => {
   const announceOnSuccess = Boolean(args?.announceOnSuccess);
   const prNumber = ctx.args.pr;
@@ -12084,6 +12139,7 @@ var syncFlow = async (ctx, _profile, args) => {
     if (announceOnSuccess) {
       ctx.output.exitCode = 0;
       ctx.output.reason = `already up to date with origin/${baseBranch}`;
+      restoreDone(prNumber, ctx.cwd);
     }
     return;
   }
@@ -12098,8 +12154,15 @@ var syncFlow = async (ctx, _profile, args) => {
   if (announceOnSuccess) {
     ctx.output.exitCode = 0;
     ctx.output.reason = `merged origin/${baseBranch} into ${ctx.data.branch}`;
+    restoreDone(prNumber, ctx.cwd);
   }
 };
+function restoreDone(prNumber, cwd) {
+  try {
+    setKodyLabel(prNumber, DONE2, cwd);
+  } catch {
+  }
+}
 function bail2(ctx, prNumber, reason) {
   ctx.skipAgent = true;
   ctx.output.exitCode = 1;

package/dist/executables/fix/profile.json

@@ -70,7 +70,8 @@
       "color": "e99695",
       "description": "kody: applying review feedback"
     },
-    "context": "task"
+    "context": "task",
+    "finalize": true
   },
   "scripts": {
     "preflight": [

package/dist/executables/fix-ci/profile.json

@@ -52,7 +52,8 @@
       "description": "kody: fixing CI failures"
     },
     "context": "ci-fix",
-    "advance": false
+    "advance": false,
+    "finalize": true
   },
   "scripts": {
     "preflight": [

package/dist/executables/run/profile.json

@@ -54,7 +54,8 @@
     "context": "task",
     "contextExtras": ["resolveArtifacts"],
     "sync": false,
-    "mirrorState": true
+    "mirrorState": true,
+    "finalize": true
   },
   "scripts": {
     "preflight": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.150",
+  "version": "0.4.152",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   "license": "MIT",
   "type": "module",