@kody-ade/kody-engine 0.4.474 → 0.4.476

package/dist/bin/kody.js

@@ -15,7 +15,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.474",
+      version: "0.4.476",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -1737,8 +1737,15 @@ function parseCapabilityContract(raw) {
   if (secrets && parsed.execution !== "script") {
     throw new Error('contract.json secrets are supported only when execution is "script"');
   }
+  const timeoutMs = parsed.timeoutMs === void 0 ? void 0 : typeof parsed.timeoutMs === "number" && Number.isInteger(parsed.timeoutMs) && parsed.timeoutMs >= 1e3 && parsed.timeoutMs <= 6 * 60 * 60 * 1e3 ? parsed.timeoutMs : null;
+  if (timeoutMs === null) {
+    throw new Error("contract.json timeoutMs must be an integer from 1000 to 21600000");
+  }
+  if (timeoutMs !== void 0 && parsed.execution !== "script") {
+    throw new Error('contract.json timeoutMs is supported only when execution is "script"');
+  }
   const unsupported = Object.keys(parsed).filter(
-    (key) => key !== "execution" && key !== "secrets" && key !== "input" && key !== "output"
+    (key) => key !== "execution" && key !== "secrets" && key !== "timeoutMs" && key !== "input" && key !== "output"
   );
   if (unsupported.length > 0) {
     throw new Error(`contract.json contains unsupported fields: ${unsupported.join(", ")}`);
@@ -1746,6 +1753,7 @@ function parseCapabilityContract(raw) {
   return {
     ...parsed.execution ? { execution: parsed.execution } : {},
     ...secrets ? { secrets } : {},
+    ...timeoutMs !== void 0 ? { timeoutMs } : {},
     input: parsed.input,
     output: parsed.output
   };
@@ -15564,6 +15572,7 @@ var init_loadSimpleCapability = __esm({
       if (capability.contract?.execution === "script") {
         ctx.data.capabilityScriptPath = path40.join(capability.dir, "tools", "run.sh");
         ctx.data.capabilitySecretNames = capability.contract.secrets ?? [];
+        ctx.data.capabilityScriptTimeoutMs = capability.contract.timeoutMs;
       }
       if (capability.config.outputSchema) {
         ctx.data.capabilityOutputSchema = capability.config.outputSchema;
@@ -19030,6 +19039,9 @@ var init_runScheduledImplementationTick = __esm({
 // src/scripts/runSimpleCapabilityScript.ts
 import { spawnSync as spawnSync3 } from "child_process";
 import * as fs47 from "fs";
+function formatDuration2(timeoutMs) {
+  return timeoutMs % 6e4 === 0 ? `${timeoutMs / 6e4} minutes` : `${timeoutMs}ms`;
+}
 function declaredSecrets(names, parent) {
   if (!Array.isArray(names)) return {};
   const secrets = {};
@@ -19051,12 +19063,13 @@ function isRegularFile2(filePath) {
 function isStringRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) && Object.values(value).every((entry) => typeof entry === "string");
 }
-var SCRIPT_TIMEOUT_MS, SCRIPT_MAX_OUTPUT_BYTES, runSimpleCapabilityScript;
+var DEFAULT_SCRIPT_TIMEOUT_MS, SCRIPT_MAX_OUTPUT_BYTES, runSimpleCapabilityScript;
 var init_runSimpleCapabilityScript = __esm({
   "src/scripts/runSimpleCapabilityScript.ts"() {
     "use strict";
+    init_capabilityResult();
     init_tickShellRunner();
-    SCRIPT_TIMEOUT_MS = 5 * 60 * 1e3;
+    DEFAULT_SCRIPT_TIMEOUT_MS = 5 * 60 * 1e3;
     SCRIPT_MAX_OUTPUT_BYTES = 1024 * 1024;
     runSimpleCapabilityScript = async (ctx) => {
       ctx.skipAgent = true;
@@ -19068,6 +19081,7 @@ var init_runSimpleCapabilityScript = __esm({
       }
       const capabilityEnvironment2 = isStringRecord(ctx.data.capabilityEnvironment) ? ctx.data.capabilityEnvironment : {};
       const capabilitySecrets = declaredSecrets(ctx.data.capabilitySecretNames, process.env);
+      const timeoutMs = typeof ctx.data.capabilityScriptTimeoutMs === "number" ? ctx.data.capabilityScriptTimeoutMs : DEFAULT_SCRIPT_TIMEOUT_MS;
       const result = spawnSync3("bash", [scriptPath], {
         cwd: ctx.cwd,
         env: {
@@ -19077,14 +19091,14 @@ var init_runSimpleCapabilityScript = __esm({
         },
         stdio: ["ignore", "pipe", "pipe"],
         encoding: "utf-8",
-        timeout: SCRIPT_TIMEOUT_MS,
+        timeout: timeoutMs,
         maxBuffer: SCRIPT_MAX_OUTPUT_BYTES
       });
       if (result.stderr) process.stderr.write(result.stderr);
       if (result.error) {
         const timedOut = result.error.code === "ETIMEDOUT";
         ctx.output.exitCode = timedOut ? 124 : 99;
-        ctx.output.reason = timedOut ? "Capability script timed out after 5 minutes" : `Capability script failed to start: ${result.error.message}`;
+        ctx.output.reason = timedOut ? `Capability script timed out after ${formatDuration2(timeoutMs)}` : `Capability script failed to start: ${result.error.message}`;
         return;
       }
       if (result.signal) {
@@ -19097,11 +19111,17 @@ var init_runSimpleCapabilityScript = __esm({
         ctx.output.reason = `Capability script exited ${result.status ?? 99}`;
         return;
       }
+      const stdout = result.stdout ?? "";
       try {
-        ctx.data.capabilityScriptOutput = JSON.parse(result.stdout ?? "");
+        ctx.data.capabilityScriptOutput = JSON.parse(stdout);
       } catch {
+        const structuredResult = parseCapabilityResultsFromText(stdout).at(-1);
+        if (structuredResult) {
+          ctx.data.capabilityScriptOutput = structuredResult;
+          return;
+        }
         ctx.output.exitCode = 64;
-        ctx.output.reason = "Capability script must return exactly one valid JSON value on stdout";
+        ctx.output.reason = "Capability script must return exactly one valid JSON value or emit a valid KODY_CAPABILITY_RESULT marker";
       }
     };
   }
@@ -22518,7 +22538,7 @@ function valueMatches(actual, expected) {
   return actual === expected;
 }
 function workflowStepTargetNumber(step, parent, chainData) {
-  if (step.target === "pr") return workflowPrNumber(chainData) ?? workflowTargetFactNumber(step, chainData);
+  if (step.target === "pr") return workflowTargetFactNumber(step, chainData) ?? workflowPrNumber(chainData);
   if (step.target === "issue") return workflowIssueNumber(parent) ?? workflowTargetFactNumber(step, chainData);
   return typeof parent.target === "number" ? parent.target : targetFromCliArgs(parent.cliArgs);
 }

package/package.json

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