@kody-ade/kody-engine 0.3.51 → 0.3.52

package/dist/bin/kody.js

@@ -3,7 +3,7 @@
 // package.json
 var package_default = {
   name: "@kody-ade/kody-engine",
-  version: "0.3.51",
+  version: "0.3.52",
   description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative executable profiles.",
   license: "MIT",
   type: "module",
@@ -1313,6 +1313,12 @@ function parseScriptList(p, key, raw) {
     if (r.with && typeof r.with === "object") {
       entry.with = r.with;
     }
+    if (typeof r.timeoutSec === "number" && r.timeoutSec > 0) {
+      if (!hasShell) {
+        throw new ProfileError(p, `scripts.${key}[${i}] "timeoutSec" only applies to shell entries`);
+      }
+      entry.timeoutSec = r.timeoutSec;
+    }
     out.push(entry);
   }
   return out;
@@ -6725,7 +6731,17 @@ function finish(out) {
 `);
   return out;
 }
-var SHELL_TIMEOUT_MS = 3e5;
+var DEFAULT_SHELL_TIMEOUT_MS = 3e5;
+function resolveShellTimeoutMs(entry) {
+  if (typeof entry.timeoutSec === "number" && entry.timeoutSec > 0) {
+    return Math.floor(entry.timeoutSec * 1e3);
+  }
+  const envSec = Number(process.env.KODY_SHELL_TIMEOUT_SEC);
+  if (Number.isFinite(envSec) && envSec > 0) {
+    return Math.floor(envSec * 1e3);
+  }
+  return DEFAULT_SHELL_TIMEOUT_MS;
+}
 function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
   const shellPath = path21.join(profile.dir, shellName);
@@ -6744,12 +6760,13 @@ function runShellEntry(entry, ctx, profile) {
   for (const [k, v] of flattenConfig(ctx.config)) {
     env[`KODY_CFG_${k}`] = v;
   }
+  const timeoutMs = resolveShellTimeoutMs(entry);
   const r = spawnSync("bash", [shellPath, ...positional], {
     cwd: ctx.cwd,
     encoding: "utf-8",
     env,
     stdio: ["pipe", "pipe", "pipe"],
-    timeout: SHELL_TIMEOUT_MS
+    timeout: timeoutMs
   });
   const stdout = r.stdout ?? "";
   const stderr = r.stderr ?? "";
@@ -6763,6 +6780,18 @@ function runShellEntry(entry, ctx, profile) {
   if (prUrlMatch?.[1]) ctx.output.prUrl = prUrlMatch[1].trim();
   const reasonMatch = stdout.match(/^KODY_REASON=(.+)$/m);
   if (reasonMatch?.[1]) ctx.output.reason = reasonMatch[1].trim();
+  const timedOut = r.status === null && r.signal !== null;
+  if (timedOut) {
+    ctx.skipAgent = true;
+    const seconds = Math.round(timeoutMs / 1e3);
+    if (ctx.output.exitCode === void 0 || ctx.output.exitCode === 0) {
+      ctx.output.exitCode = 124;
+    }
+    if (!ctx.output.reason) {
+      ctx.output.reason = `shell '${shellName}' timed out after ${seconds}s (signal=${r.signal})`;
+    }
+    return;
+  }
   const exit = r.status ?? -1;
   if (exit !== 0) {
     ctx.skipAgent = true;

package/dist/executables/types.ts

@@ -185,6 +185,14 @@ export interface ScriptEntry {
    * dispatcher script can be reused with different `next` targets.
    */
   with?: Record<string, string | number | boolean>
+  /**
+   * Optional shell-script timeout in seconds. Only honored on `shell` entries.
+   * Falls back to `KODY_SHELL_TIMEOUT_SEC` env var, then the 300s default.
+   * Long-running shells (release publish, large repo verify) should declare
+   * a higher value rather than relying on the default and getting SIGKILLed
+   * with an opaque "exited -1".
+   */
+  timeoutSec?: number
 }
 
 export interface OutputContract {

package/package.json

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