@kody-ade/kody-engine 0.4.43 → 0.4.45

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.4.43",
+  version: "0.4.45",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -390,7 +390,27 @@ function formatBytes(bytes) {
 }
 
 // src/agent.ts
+function classifySubtype(subtype) {
+  if (!subtype) return "generic_failed";
+  const lower = subtype.toLowerCase();
+  if (lower === "success") return "ok";
+  if (lower.includes("max_turns") || lower.includes("max-turns")) return "out_of_turns";
+  if (lower.includes("rate_limit") || lower.includes("rate-limit")) return "rate_limit";
+  if (lower.includes("tool")) return "tool_error";
+  if (lower.includes("error")) return "model_error";
+  return "generic_failed";
+}
 var DEFAULT_ALLOWED_TOOLS = ["Bash", "Edit", "Read", "Write", "Glob", "Grep"];
+var DEFAULT_TURN_TIMEOUT_MS = 3e5;
+function resolveTurnTimeoutMs(opts) {
+  if (opts.maxTurnTimeoutMs !== void 0 && opts.maxTurnTimeoutMs !== null) {
+    return opts.maxTurnTimeoutMs > 0 ? opts.maxTurnTimeoutMs : 0;
+  }
+  const envSec = Number(process.env.KODY_TURN_TIMEOUT_SEC);
+  if (Number.isFinite(envSec) && envSec > 0) return Math.floor(envSec * 1e3);
+  if (Number.isFinite(envSec) && envSec <= 0) return 0;
+  return DEFAULT_TURN_TIMEOUT_MS;
+}
 async function runAgent(opts) {
   const ndjsonDir = opts.ndjsonDir ?? path3.join(opts.cwd, ".kody");
   fs3.mkdirSync(ndjsonDir, { recursive: true });
@@ -416,10 +436,14 @@ async function runAgent(opts) {
   }
   const resultTexts = [];
   let outcome = "failed";
+  let outcomeKind = "generic_failed";
   let errorMessage;
   const 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;
   try {
     const queryOptions = {
       model: opts.model.model,
@@ -456,12 +480,45 @@ async function runAgent(opts) {
       // biome-ignore lint/suspicious/noExplicitAny: SDK options type is narrow; mcpServers is runtime-passthrough.
       options: queryOptions
     });
-    for await (const msg of result) {
+    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((resolve4) => {
+          timer = setTimeout(() => {
+            timedOut = true;
+            resolve4({ 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;
+      }
+      if (next.done) break;
+      const msg = next.value;
       messageCount++;
       try {
         fullLog.write(`${JSON.stringify(msg)}
 `);
-      } catch {
+      } 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}
@@ -481,16 +538,19 @@ async function runAgent(opts) {
       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 {
@@ -498,9 +558,14 @@ async function runAgent(opts) {
     } catch {
     }
   }
+  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");
   return {
     outcome,
+    outcomeKind,
     finalText,
     error: errorMessage,
     ndjsonPath,
@@ -2018,6 +2083,13 @@ async function checkLitellmHealth(url) {
     return false;
   }
 }
+var DEFAULT_LITELLM_STARTUP_TIMEOUT_SEC = 60;
+var LITELLM_HEALTH_POLL_INTERVAL_MS = 2e3;
+function resolveLitellmTimeoutMs() {
+  const envSec = Number(process.env.KODY_LITELLM_TIMEOUT_SEC);
+  if (Number.isFinite(envSec) && envSec > 0) return Math.floor(envSec * 1e3);
+  return DEFAULT_LITELLM_STARTUP_TIMEOUT_SEC * 1e3;
+}
 function generateLitellmConfigYaml(model) {
   const apiKeyVar = providerApiKeyEnvVar(model.provider);
   return [
@@ -2063,8 +2135,10 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
     env: stripBlockingEnv({ ...process.env, ...dotenvVars })
   });
   fs10.closeSync(outFd);
-  for (let i = 0; i < 30; i++) {
-    await new Promise((r) => setTimeout(r, 2e3));
+  const timeoutMs = resolveLitellmTimeoutMs();
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    await new Promise((r) => setTimeout(r, LITELLM_HEALTH_POLL_INTERVAL_MS));
     if (await checkLitellmHealth(url)) {
       return {
         url,
@@ -2086,7 +2160,8 @@ async function startLitellmIfNeeded(model, projectDir, url = LITELLM_DEFAULT_URL
     child.kill();
   } catch {
   }
-  throw new Error(`LiteLLM proxy failed to start within 60s. Log tail:
+  const seconds = Math.round(timeoutMs / 1e3);
+  throw new Error(`LiteLLM proxy failed to start within ${seconds}s (KODY_LITELLM_TIMEOUT_SEC overrides). Log tail:
 ${logTail}`);
 }
 function readDotenvApiKeys(projectDir) {
@@ -6875,6 +6950,7 @@ var parseAgentResult2 = async (ctx, profile, agentResult) => {
   ctx.data.agentFailureReason = parsed.failureReason;
   ctx.data.agentMarkerMissing = parsed.markerMissing;
   ctx.data.agentOutcome = agentResult.outcome;
+  ctx.data.agentOutcomeKind = agentResult.outcomeKind;
   ctx.data.agentError = agentResult.error;
   const modeSeg = (ctx.args.mode ?? profile.name).replace(/-/g, "_").toUpperCase();
   if (parsed.done) {
@@ -9100,7 +9176,8 @@ async function runExecutable(profileName, input) {
       return finishAndEnd({ exitCode: 99, reason: `config error: ${err instanceof Error ? err.message : String(err)}` });
     }
   }
-  const modelSpec = profile.claudeCode.model === "inherit" ? config.agent.model : profile.claudeCode.model;
+  const perExecutableModel = config.agent.perExecutable?.[profileName];
+  const modelSpec = perExecutableModel ? perExecutableModel : profile.claudeCode.model === "inherit" ? config.agent.model : profile.claudeCode.model;
   let model;
   try {
     model = parseProviderModel(modelSpec);
@@ -9204,6 +9281,7 @@ async function runExecutable(profileName, input) {
         durationMs: agentResult.durationMs,
         outcome: agentResult.outcome === "completed" ? "ok" : "failed",
         meta: {
+          kind: agentResult.outcomeKind,
           ...agentResult.tokens ? { tokens: agentResult.tokens } : {},
           ...typeof agentResult.messageCount === "number" ? { messageCount: agentResult.messageCount } : {},
           ...agentResult.error ? { error: agentResult.error } : {}
@@ -10126,8 +10204,8 @@ async function runScheduledFanOut(cwd, args, opts) {
     return 99;
   }
   const config = loadConfig(cwd);
-  let worstExit = 0;
-  for (const match of matches) {
+  const serial = process.env.KODY_SERIAL_WATCHES === "1";
+  const runWatch = async (match) => {
     process.stdout.write(`
 \u2192 kody: running watch \`${match.executable}\`
 `);
@@ -10144,13 +10222,27 @@ async function runScheduledFanOut(cwd, args, opts) {
           `[kody] watch \`${match.executable}\` exited ${result.exitCode}: ${result.reason ?? "(no reason)"}
 `
         );
-        if (result.exitCode > worstExit) worstExit = result.exitCode;
+        return result.exitCode;
       }
+      return 0;
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
       process.stderr.write(`[kody] watch \`${match.executable}\` crashed: ${msg}
 `);
-      worstExit = Math.max(worstExit, 99);
+      return 99;
+    }
+  };
+  let worstExit = 0;
+  if (serial) {
+    for (const match of matches) {
+      const code = await runWatch(match);
+      if (code > worstExit) worstExit = code;
+    }
+  } else {
+    const settled = await Promise.allSettled(matches.map((m) => runWatch(m)));
+    for (const r of settled) {
+      const code = r.status === "fulfilled" ? r.value : 99;
+      if (code > worstExit) worstExit = code;
     }
   }
   return worstExit;

package/dist/executables/plan/profile.json

@@ -20,34 +20,16 @@
       "Read",
       "Grep",
       "Glob",
-      "Bash",
-      "mcp__playwright"
+      "Bash"
     ],
     "hooks": ["block-write"],
     "skills": [],
     "commands": [],
     "subagents": [],
     "plugins": [],
-    "mcpServers": [
-      {
-        "name": "playwright",
-        "command": "npx",
-        "args": ["-y", "--package=@playwright/mcp@latest", "--", "playwright-mcp"]
-      }
-    ]
+    "mcpServers": []
   },
-  "cliTools": [
-    {
-      "name": "playwright",
-      "install": {
-        "required": false,
-        "checkCommand": "ls \"$HOME/.cache/ms-playwright\" 2>/dev/null | grep -q '^chromium'",
-        "installCommand": "npx --yes playwright install --with-deps chromium"
-      },
-      "verify": "ls \"$HOME/.cache/ms-playwright\" 2>/dev/null | grep -q '^chromium'",
-      "usage": ""
-    }
-  ],
+  "cliTools": [],
   "scripts": {
     "preflight": [
       {

package/dist/executables/review/profile.json

@@ -21,34 +21,16 @@
       "Read",
       "Grep",
       "Glob",
-      "Bash",
-      "mcp__playwright"
+      "Bash"
     ],
     "hooks": ["block-write"],
     "skills": [],
     "commands": [],
     "subagents": [],
     "plugins": [],
-    "mcpServers": [
-      {
-        "name": "playwright",
-        "command": "npx",
-        "args": ["-y", "--package=@playwright/mcp@latest", "--", "playwright-mcp"]
-      }
-    ]
+    "mcpServers": []
   },
-  "cliTools": [
-    {
-      "name": "playwright",
-      "install": {
-        "required": false,
-        "checkCommand": "ls \"$HOME/.cache/ms-playwright\" 2>/dev/null | grep -q '^chromium'",
-        "installCommand": "npx --yes playwright install --with-deps chromium"
-      },
-      "verify": "ls \"$HOME/.cache/ms-playwright\" 2>/dev/null | grep -q '^chromium'",
-      "usage": ""
-    }
-  ],
+  "cliTools": [],
   "scripts": {
     "preflight": [
       {

package/kody.config.schema.json

@@ -135,6 +135,14 @@
           "description": "Single 'provider/model' string used by kody (single-session pipeline). Use 'claude/...' or 'anthropic/...' for direct Anthropic API; anything else routes through LiteLLM proxy.",
           "examples": ["claude/claude-sonnet-4-6", "minimax/MiniMax-M2.7-highspeed"]
         },
+        "perExecutable": {
+          "type": "object",
+          "description": "Per-executable model override. Wins over agent.model for the matching stage. Example: {\"classify\": \"claude/claude-haiku-4-5-20251001\", \"plan\": \"claude/claude-opus-4-7\"}.",
+          "additionalProperties": {
+            "type": "string",
+            "pattern": "^[^/]+/.+$"
+          }
+        },
         "modelMap": {
           "type": "object",
           "description": "Maps model tiers to 'provider/model' strings. Use 'claude/...' or 'anthropic/...' for direct Anthropic API; anything else routes through LiteLLM proxy.",

package/package.json

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