@kody-ade/kody-engine 0.4.565 → 0.4.566

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.565",
+      version: "0.4.566",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -2289,6 +2289,7 @@ function parseWorkflowStep(value) {
   const target = stringField(raw.target);
   const delivery = stringField(raw.delivery);
   const targetFact = stringField(raw.targetFact ?? raw.target_fact);
+  const timeoutSeconds = typeof raw.timeoutSeconds === "number" && Number.isInteger(raw.timeoutSeconds) && raw.timeoutSeconds > 0 && raw.timeoutSeconds <= 3600 ? raw.timeoutSeconds : void 0;
   const hasInput = Object.hasOwn(raw, "input");
   const inputs = parseWorkflowInputBindings(raw.inputs);
   const next = parseWorkflowTransitions(raw.next);
@@ -2304,6 +2305,7 @@ function parseWorkflowStep(value) {
     ...delivery === "pull-request" ? { delivery } : {},
     ...targetFact ? { targetFact } : {},
     ...reason ? { reason } : {},
+    ...timeoutSeconds ? { timeoutSeconds } : {},
     ...next ? { next } : {},
     ...isPlainObject(raw.runWhen) ? { runWhen: raw.runWhen } : {},
     ...stringList(raw.continueOn ?? raw.continue_on).length > 0 ? { continueOn: stringList(raw.continueOn ?? raw.continue_on) } : {},
@@ -4722,6 +4724,15 @@ function validateWorkflow(value, options = {}) {
     if (step.input !== void 0 && step.inputs !== void 0) {
       issue(issues, "conflicting_inputs", base, "workflow step cannot declare both input and inputs");
     }
+    const timeoutSeconds = step.timeoutSeconds;
+    if (timeoutSeconds !== void 0 && (typeof timeoutSeconds !== "number" || !Number.isInteger(timeoutSeconds) || timeoutSeconds < 1 || timeoutSeconds > 3600)) {
+      issue(
+        issues,
+        "invalid_step_timeout",
+        `${base}.timeoutSeconds`,
+        "workflow step timeoutSeconds must be an integer from 1 to 3600"
+      );
+    }
     validateInputBindings(
       step.inputs,
       `${base}.inputs`,
@@ -5005,6 +5016,7 @@ var init_workflowValidation = __esm({
       "delivery",
       "targetFact",
       "reason",
+      "timeoutSeconds",
       "next",
       "runWhen",
       "continueOn",
@@ -23574,25 +23586,31 @@ async function runGraphCapabilityWorkflow(parent, workflow, capability, base, ch
 
 `
     );
-    result = await runJob(child, {
-      ...base,
-      preloadedData: {
-        ...chainData,
-        runSubjectType: "capability",
-        runSubjectId: step.capability,
-        runSubjectLabel: step.id,
-        workflowStep: step.id,
-        workflowStepIndex: index + 1,
-        workflowExecutionKey: graphWorkflowExecutionKey(
-          base.preloadedData?.workflowExecutionKey,
-          capability.slug,
-          step.id,
-          state.transitionCounts
-        ),
-        workflowStepReason: step.reason,
-        workflowContinueOn: step.continueOn ?? []
-      }
-    });
+    const stepAbort = workflowStepAbortController(base.abortController, step.timeoutSeconds);
+    try {
+      result = await runJob(child, {
+        ...base,
+        abortController: stepAbort.controller,
+        preloadedData: {
+          ...chainData,
+          runSubjectType: "capability",
+          runSubjectId: step.capability,
+          runSubjectLabel: step.id,
+          workflowStep: step.id,
+          workflowStepIndex: index + 1,
+          workflowExecutionKey: graphWorkflowExecutionKey(
+            base.preloadedData?.workflowExecutionKey,
+            capability.slug,
+            step.id,
+            state.transitionCounts
+          ),
+          workflowStepReason: step.reason,
+          workflowContinueOn: step.continueOn ?? []
+        }
+      });
+    } finally {
+      stepAbort.cleanup();
+    }
     finishWorkflowStep(state, step, result);
     mergeWorkflowResults(state, result.capabilityResults);
     if (result.capabilityOutput && typeof result.capabilityOutput === "object" && !Array.isArray(result.capabilityOutput)) {
@@ -23900,6 +23918,24 @@ function canContinueWorkflow(step, outcome) {
   if (!outcome || !step.continueOn || step.continueOn.length === 0) return false;
   return step.continueOn.includes(outcome.type);
 }
+function workflowStepAbortController(parent, timeoutSeconds) {
+  if (!timeoutSeconds) return { controller: parent, cleanup: () => void 0 };
+  const controller = new AbortController();
+  const forwardParentAbort = () => controller.abort(parent?.signal.reason);
+  if (parent?.signal.aborted) forwardParentAbort();
+  else parent?.signal.addEventListener("abort", forwardParentAbort, { once: true });
+  const timer = setTimeout(() => {
+    controller.abort(new Error(`workflow step timed out after ${timeoutSeconds}s`));
+  }, timeoutSeconds * 1e3);
+  timer.unref?.();
+  return {
+    controller,
+    cleanup: () => {
+      clearTimeout(timer);
+      parent?.signal.removeEventListener("abort", forwardParentAbort);
+    }
+  };
+}
 function workflowOutcome(result) {
   return result.taskState?.core.lastOutcome ?? null;
 }

package/package.json

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