@kody-ade/kody-engine 0.4.569 → 0.4.571

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.569",
+      version: "0.4.571",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -150,6 +150,29 @@ var init_claudeBinary = __esm({
   }
 });
 
+// src/completionGuard.ts
+function completionToolCutoffAt(startedAtMs, deadlineAtMs) {
+  const availableMs = Math.max(0, deadlineAtMs - startedAtMs);
+  const reserveMs = Math.min(MAX_COMPLETION_RESERVE_MS, Math.floor(availableMs / 3));
+  return deadlineAtMs - reserveMs;
+}
+function createCompletionToolGuard(cutoffAtMs, now = Date.now) {
+  return async () => {
+    if (now() < cutoffAtMs) return {};
+    return {
+      decision: "block",
+      reason: "The run has entered its reserved completion window. Do not call more tools. Use the evidence and changes already present, state any verification limits clearly, and return your final response now."
+    };
+  };
+}
+var MAX_COMPLETION_RESERVE_MS;
+var init_completionGuard = __esm({
+  "src/completionGuard.ts"() {
+    "use strict";
+    MAX_COMPLETION_RESERVE_MS = 10 * 6e4;
+  }
+});
+
 // src/config.ts
 import * as fs2 from "fs";
 import * as path2 from "path";
@@ -548,6 +571,29 @@ var init_config = __esm({
   }
 });
 
+// src/fileEditGuards.ts
+import * as fs3 from "fs";
+import * as path3 from "path";
+function createMissingParentWriteGuard(cwd) {
+  return async (input) => {
+    const toolInput = input.tool_input;
+    if (!toolInput || typeof toolInput !== "object" || Array.isArray(toolInput)) return {};
+    const filePath = toolInput.file_path;
+    if (typeof filePath !== "string" || filePath.length === 0) return {};
+    const resolvedPath = path3.resolve(cwd, filePath);
+    if (fs3.existsSync(path3.dirname(resolvedPath))) return {};
+    return {
+      decision: "block",
+      reason: `Cannot write ${resolvedPath}: its parent directory does not exist. Locate and edit the real repository source path first. If this task genuinely requires a new directory, create that directory explicitly before writing the file.`
+    };
+  };
+}
+var init_fileEditGuards = __esm({
+  "src/fileEditGuards.ts"() {
+    "use strict";
+  }
+});
+
 // src/format.ts
 function renderEvent(msg, opts = {}) {
   if (opts.quiet) {
@@ -669,29 +715,6 @@ var init_format = __esm({
   }
 });
 
-// src/fileEditGuards.ts
-import * as fs3 from "fs";
-import * as path3 from "path";
-function createMissingParentWriteGuard(cwd) {
-  return async (input) => {
-    const toolInput = input.tool_input;
-    if (!toolInput || typeof toolInput !== "object" || Array.isArray(toolInput)) return {};
-    const filePath = toolInput.file_path;
-    if (typeof filePath !== "string" || filePath.length === 0) return {};
-    const resolvedPath = path3.resolve(cwd, filePath);
-    if (fs3.existsSync(path3.dirname(resolvedPath))) return {};
-    return {
-      decision: "block",
-      reason: `Cannot write ${resolvedPath}: its parent directory does not exist. Locate and edit the real repository source path first. If this task genuinely requires a new directory, create that directory explicitly before writing the file.`
-    };
-  };
-}
-var init_fileEditGuards = __esm({
-  "src/fileEditGuards.ts"() {
-    "use strict";
-  }
-});
-
 // src/agency/capability-contract-validation.ts
 import Ajv from "ajv";
 function createCapabilityContractValueValidator(compile) {
@@ -4062,6 +4085,7 @@ async function runAgent(opts) {
   }
   const startedAt = Date.now();
   const turnTimeoutMs = resolveTurnTimeoutMs(opts);
+  const completionGuard = typeof opts.deadlineAtMs === "number" ? createCompletionToolGuard(completionToolCutoffAt(startedAt, opts.deadlineAtMs)) : null;
   let outcome = "failed";
   let outcomeKind = "generic_failed";
   let errorMessage2;
@@ -4106,6 +4130,11 @@ async function runAgent(opts) {
         env,
         hooks: {
           PreToolUse: [
+            ...completionGuard ? [
+              {
+                hooks: [completionGuard]
+              }
+            ] : [],
             {
               matcher: "Agent",
               hooks: [enforceSubagentModelInheritance]
@@ -4229,11 +4258,13 @@ async function runAgent(opts) {
       } else if (typeof opts.maxThinkingTokens === "number" && opts.maxThinkingTokens > 0) {
         queryOptions.maxThinkingTokens = opts.maxThinkingTokens;
       }
-      if (typeof opts.systemPromptAppend === "string" && opts.systemPromptAppend.length > 0) {
+      const completionNotice = completionGuard ? "Work within the enforced run time. Tool access closes before the hard deadline to reserve time for a final response. When that happens, stop using tools and finish immediately." : null;
+      const systemPromptAppend = [opts.systemPromptAppend, completionNotice].filter((value) => typeof value === "string" && value.length > 0).join("\n\n");
+      if (systemPromptAppend.length > 0) {
         const systemPrompt = {
           type: "preset",
           preset: "claude_code",
-          append: opts.systemPromptAppend
+          append: systemPromptAppend
         };
         if (opts.cacheable) systemPrompt.excludeDynamicSections = true;
         queryOptions.systemPrompt = systemPrompt;
@@ -4463,9 +4494,10 @@ var init_agent = __esm({
   "src/agent.ts"() {
     "use strict";
     init_claudeBinary();
+    init_completionGuard();
     init_config();
-    init_format();
     init_fileEditGuards();
+    init_format();
     init_outputContractHooks();
     init_runtimePaths();
     init_subagents();
@@ -22138,6 +22170,7 @@ async function runImplementation(profileName, input) {
       verbose: input.verbose,
       quiet: input.quiet,
       abortController: input.abortController,
+      deadlineAtMs: input.deadlineAtMs,
       ndjsonDir,
       additionalDirectories: agentTaskArtifacts ? [agentTaskArtifacts.absDir] : void 0,
       allowedToolsOverride: profile.claudeCode.tools,
@@ -23324,6 +23357,7 @@ async function runCapabilityImplementationStep(valid, profileName, capabilityIde
     verbose: base.verbose,
     quiet: base.quiet,
     abortController: base.abortController,
+    deadlineAtMs: base.deadlineAtMs,
     preloadedData: Object.keys(preloadedData).length > 0 ? preloadedData : void 0
   };
   const shouldApplyResolvedCapabilityArgs = valid.implementation === void 0 && resolvedCapability && profileName === resolvedCapability.implementation;
@@ -23637,6 +23671,7 @@ async function runGraphCapabilityWorkflow(parent, workflow, capability, base, ch
       result = await runJob(child, {
         ...base,
         abortController: stepAbort.controller,
+        deadlineAtMs: stepAbort.deadlineAtMs,
         preloadedData: {
           ...chainData,
           runSubjectType: "capability",
@@ -23966,8 +24001,9 @@ function canContinueWorkflow(step, outcome) {
   return step.continueOn.includes(outcome.type);
 }
 function workflowStepAbortController(parent, timeoutSeconds) {
-  if (!timeoutSeconds) return { controller: parent, cleanup: () => void 0 };
+  if (!timeoutSeconds) return { controller: parent, deadlineAtMs: void 0, cleanup: () => void 0 };
   const controller = new AbortController();
+  const deadlineAtMs = Date.now() + timeoutSeconds * 1e3;
   const forwardParentAbort = () => controller.abort(parent?.signal.reason);
   if (parent?.signal.aborted) forwardParentAbort();
   else parent?.signal.addEventListener("abort", forwardParentAbort, { once: true });
@@ -23977,6 +24013,7 @@ function workflowStepAbortController(parent, timeoutSeconds) {
   timer.unref?.();
   return {
     controller,
+    deadlineAtMs,
     cleanup: () => {
       clearTimeout(timer);
       parent?.signal.removeEventListener("abort", forwardParentAbort);
@@ -23984,7 +24021,7 @@ function workflowStepAbortController(parent, timeoutSeconds) {
   };
 }
 function workflowOutcome(result) {
-  return result.taskState?.core.lastOutcome ?? result.action ?? null;
+  return result.action ?? result.taskState?.core.lastOutcome ?? null;
 }
 function workflowStepDeadlineResult(result, controller, timeoutSeconds) {
   if (!timeoutSeconds || !controller?.signal.aborted || result.exitCode === 0) return result;

package/package.json

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