@kody-ade/kody-engine 0.4.464 → 0.4.466

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.464",
+      version: "0.4.466",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -1688,6 +1688,9 @@ function readCapabilityFolder(root, slug) {
   try {
     const rawBody = fs4.readFileSync(bodyPath, "utf-8");
     const contract = fs4.existsSync(contractPath) ? parseCapabilityContract(fs4.readFileSync(contractPath, "utf-8")) : void 0;
+    if (contract?.execution === "script" && !isRegularFile(path5.join(dir, "tools", "run.sh"))) {
+      throw new Error('script-backed Capability requires a regular "tools/run.sh" file');
+    }
     const { title, body } = parseCapabilityBody(rawBody, slug);
     return {
       slug,
@@ -1701,12 +1704,17 @@ function readCapabilityFolder(root, slug) {
       config: {
         action: slug,
         describe: title,
+        ...contract?.execution ? { execution: contract.execution } : {},
         ...contract ? {
           inputSchema: contract.input,
           outputSchema: contract.output
         } : {}
       },
-      rawProfile: contract ? { input: contract.input, output: contract.output } : {},
+      rawProfile: contract ? {
+        ...contract.execution ? { execution: contract.execution } : {},
+        input: contract.input,
+        output: contract.output
+      } : {},
       ...contract ? { contract } : {}
     };
   } catch {
@@ -1718,11 +1726,28 @@ function parseCapabilityContract(raw) {
   if (!isPlainObject(parsed) || !isPlainObject(parsed.input) || !isPlainObject(parsed.output)) {
     throw new Error("contract.json must contain input and output JSON schemas");
   }
-  const unsupported = Object.keys(parsed).filter((key) => key !== "input" && key !== "output");
+  if (parsed.execution !== void 0 && parsed.execution !== "agent" && parsed.execution !== "script") {
+    throw new Error('contract.json execution must be "agent" or "script"');
+  }
+  const unsupported = Object.keys(parsed).filter(
+    (key) => key !== "execution" && key !== "input" && key !== "output"
+  );
   if (unsupported.length > 0) {
     throw new Error(`contract.json contains unsupported fields: ${unsupported.join(", ")}`);
   }
-  return { input: parsed.input, output: parsed.output };
+  return {
+    ...parsed.execution ? { execution: parsed.execution } : {},
+    input: parsed.input,
+    output: parsed.output
+  };
+}
+function isRegularFile(filePath) {
+  try {
+    const stat = fs4.lstatSync(filePath);
+    return stat.isFile() && !stat.isSymbolicLink();
+  } catch {
+    return false;
+  }
 }
 function schemaPropertyPaths(schema, prefix) {
   const properties = isPlainObject(schema.properties) ? schema.properties : {};
@@ -16249,6 +16274,10 @@ var init_loadSimpleCapability = __esm({
       }
       ctx.data.jobCapability = slug;
       ctx.data.capabilityInput = input;
+      ctx.data.capabilityExecution = capability.contract?.execution ?? "agent";
+      if (capability.contract?.execution === "script") {
+        ctx.data.capabilityScriptPath = path40.join(capability.dir, "tools", "run.sh");
+      }
       if (capability.config.outputSchema) {
         ctx.data.capabilityOutputSchema = capability.config.outputSchema;
       }
@@ -17274,7 +17303,7 @@ var init_parseSimpleCapabilityOutput = __esm({
     "use strict";
     init_capability_contract_validation();
     parseSimpleCapabilityOutput = async (ctx, _profile, agentResult) => {
-      const output = parseOutput(agentResult?.finalText);
+      const output = Object.hasOwn(ctx.data, "capabilityScriptOutput") ? ctx.data.capabilityScriptOutput : parseOutput(agentResult?.finalText);
       if (output === void 0) {
         const reason2 = agentResult?.outcomeKind === "out_of_turns" ? "Capability execution limit reached" : "Capability execution ended before returning a result";
         const blocked = {
@@ -19768,6 +19797,74 @@ var init_runTickScript = __esm({
   }
 });
 
+// src/scripts/runSimpleCapabilityScript.ts
+import { spawnSync as spawnSync3 } from "child_process";
+import * as fs48 from "fs";
+function isRegularFile2(filePath) {
+  try {
+    const stat = fs48.lstatSync(filePath);
+    return stat.isFile() && !stat.isSymbolicLink();
+  } catch {
+    return false;
+  }
+}
+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 init_runSimpleCapabilityScript = __esm({
+  "src/scripts/runSimpleCapabilityScript.ts"() {
+    "use strict";
+    init_tickShellRunner();
+    SCRIPT_TIMEOUT_MS = 5 * 60 * 1e3;
+    SCRIPT_MAX_OUTPUT_BYTES = 1024 * 1024;
+    runSimpleCapabilityScript = async (ctx) => {
+      ctx.skipAgent = true;
+      const scriptPath = typeof ctx.data.capabilityScriptPath === "string" ? ctx.data.capabilityScriptPath : "";
+      if (!scriptPath || !isRegularFile2(scriptPath)) {
+        ctx.output.exitCode = 99;
+        ctx.output.reason = 'Script-backed Capability requires a regular "tools/run.sh" entrypoint';
+        return;
+      }
+      const capabilityEnvironment2 = isStringRecord(ctx.data.capabilityEnvironment) ? ctx.data.capabilityEnvironment : {};
+      const result = spawnSync3("bash", [scriptPath], {
+        cwd: ctx.cwd,
+        env: {
+          ...buildTickChildEnv(process.env, false),
+          ...capabilityEnvironment2
+        },
+        stdio: ["ignore", "pipe", "pipe"],
+        encoding: "utf-8",
+        timeout: SCRIPT_TIMEOUT_MS,
+        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}`;
+        return;
+      }
+      if (result.signal) {
+        ctx.output.exitCode = 124;
+        ctx.output.reason = `Capability script was killed by ${result.signal}`;
+        return;
+      }
+      if (result.status !== 0) {
+        ctx.output.exitCode = result.status ?? 99;
+        ctx.output.reason = `Capability script exited ${result.status ?? 99}`;
+        return;
+      }
+      try {
+        ctx.data.capabilityScriptOutput = JSON.parse(result.stdout ?? "");
+      } catch {
+        ctx.output.exitCode = 64;
+        ctx.output.reason = "Capability script must return exactly one valid JSON value on stdout";
+      }
+    };
+  }
+});
+
 // src/scripts/saveManagedGoalState.ts
 var saveManagedGoalState;
 var init_saveManagedGoalState = __esm({
@@ -20783,7 +20880,7 @@ var init_warmupMcp = __esm({
 });
 
 // src/scripts/writeAgentRunSummary.ts
-import * as fs48 from "fs";
+import * as fs49 from "fs";
 var writeAgentRunSummary;
 var init_writeAgentRunSummary = __esm({
   "src/scripts/writeAgentRunSummary.ts"() {
@@ -20809,7 +20906,7 @@ var init_writeAgentRunSummary = __esm({
       if (reason) lines.push(`- **Reason:** ${reason}`);
       lines.push("");
       try {
-        fs48.appendFileSync(summaryPath, `${lines.join("\n")}
+        fs49.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
       } catch {
       }
@@ -21012,6 +21109,7 @@ var init_scripts = __esm({
     init_runPreviewBuild();
     init_runScheduledImplementationTick();
     init_runTickScript();
+    init_runSimpleCapabilityScript();
     init_saveManagedGoalState();
     init_saveTaskState();
     init_setCommentTarget();
@@ -21080,6 +21178,7 @@ var init_scripts = __esm({
       runScheduledImplementationTick,
       runScheduledExecutableTick: runScheduledImplementationTick,
       runTickScript,
+      runSimpleCapabilityScript,
       runPreviewBuild,
       advanceManagedGoal,
       loadGoalState,
@@ -21145,7 +21244,7 @@ var init_scripts = __esm({
 });
 
 // src/stateWorkspace.ts
-import * as fs49 from "fs";
+import * as fs50 from "fs";
 import * as path47 from "path";
 function tenantId(config) {
   const owner = config.github?.owner?.trim() || process.env.GITHUB_REPOSITORY?.split("/")[0]?.trim();
@@ -21154,8 +21253,8 @@ function tenantId(config) {
 }
 function writeRuntimeFile(cwd, relativePath, content) {
   const target = path47.join(cwd, RUNTIME_ROOT, relativePath);
-  fs49.mkdirSync(path47.dirname(target), { recursive: true });
-  fs49.writeFileSync(target, content, "utf8");
+  fs50.mkdirSync(path47.dirname(target), { recursive: true });
+  fs50.writeFileSync(target, content, "utf8");
 }
 function record(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -21224,7 +21323,7 @@ async function hydrateStateWorkspace(config, cwd, backendOverride) {
   if (hydratedWorkspaces.has(key)) return;
   const backend = backendOverride ?? createStateBackendFromEnv();
   const root = path47.join(cwd, RUNTIME_ROOT);
-  fs49.rmSync(root, { recursive: true, force: true });
+  fs50.rmSync(root, { recursive: true, force: true });
   await Promise.all([
     hydratePrefix(backend, tenant, cwd, "context:"),
     hydratePrefix(backend, tenant, cwd, "memory:"),
@@ -21311,7 +21410,7 @@ var init_tools = __esm({
 
 // src/executor.ts
 import { spawn as spawn8 } from "child_process";
-import * as fs50 from "fs";
+import * as fs51 from "fs";
 import * as os7 from "os";
 import * as path48 from "path";
 function isMutatingPostflight(scriptName) {
@@ -22029,7 +22128,7 @@ function resolveProfilePath(profileName, cwd = process.cwd()) {
     // fallback
   ];
   for (const c of candidates) {
-    if (fs50.existsSync(c)) return c;
+    if (fs51.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -22145,7 +22244,7 @@ function resolveShellTimeoutMs(entry) {
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
   const shellPath = path48.join(profile.dir, shellName);
-  if (!fs50.existsSync(shellPath)) {
+  if (!fs51.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -22224,9 +22323,9 @@ async function runShellEntry(entry, ctx, profile) {
   }
   let sideChannelText = "";
   try {
-    if (fs50.existsSync(outputFile)) {
-      sideChannelText = fs50.readFileSync(outputFile, "utf-8");
-      fs50.rmSync(outputFile, { force: true });
+    if (fs51.existsSync(outputFile)) {
+      sideChannelText = fs51.readFileSync(outputFile, "utf-8");
+      fs51.rmSync(outputFile, { force: true });
     }
   } catch {
   }
@@ -24496,7 +24595,7 @@ async function hydrateDefinitionsFromEnv(cwd = process.cwd(), env = process.env)
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync24 } from "child_process";
-import * as fs51 from "fs";
+import * as fs52 from "fs";
 import * as path49 from "path";
 
 // src/app-auth.ts
@@ -25316,9 +25415,9 @@ async function resolveAuthToken(env = process.env) {
   return void 0;
 }
 function detectPackageManager2(cwd) {
-  if (fs51.existsSync(path49.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs51.existsSync(path49.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs51.existsSync(path49.join(cwd, "bun.lockb"))) return "bun";
+  if (fs52.existsSync(path49.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs52.existsSync(path49.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs52.existsSync(path49.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shouldChainScheduledWatch(match) {
@@ -25422,8 +25521,8 @@ function postFailureTail(issueNumber, cwd, reason) {
   const logPath = lastRunLogPath(cwd);
   let tail = "";
   try {
-    if (fs51.existsSync(logPath)) {
-      const content = fs51.readFileSync(logPath, "utf-8");
+    if (fs52.existsSync(logPath)) {
+      const content = fs52.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -25511,9 +25610,9 @@ async function runCi(argv) {
       forceRunCliArgs = { goal: envForceMessage };
     }
   }
-  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs51.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs52.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs51.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs52.readFileSync(dispatchEventPath, "utf-8"));
       const inputs = objectValue2(evt.inputs);
       const issueInput = parseInt(String(inputs?.issue_number ?? ""), 10);
       const sessionInput = String(inputs?.sessionId ?? "");
@@ -25921,7 +26020,7 @@ init_repoWorkspace();
 
 // src/scripts/brainTurnLog.ts
 init_runtimePaths();
-import * as fs52 from "fs";
+import * as fs53 from "fs";
 import * as path50 from "path";
 import posixPath4 from "path/posix";
 var live = /* @__PURE__ */ new Map();
@@ -25930,8 +26029,8 @@ function brainEventsFilePath(dir, chatId) {
 }
 function lastPersistedSeq(dir, chatId) {
   const p = brainEventsFilePath(dir, chatId);
-  if (!fs52.existsSync(p)) return 0;
-  const lines = fs52.readFileSync(p, "utf-8").split("\n").filter(Boolean);
+  if (!fs53.existsSync(p)) return 0;
+  const lines = fs53.readFileSync(p, "utf-8").split("\n").filter(Boolean);
   if (lines.length === 0) return 0;
   try {
     return JSON.parse(lines[lines.length - 1]).seq || 0;
@@ -25941,9 +26040,9 @@ function lastPersistedSeq(dir, chatId) {
 }
 function readSince(dir, chatId, since) {
   const p = brainEventsFilePath(dir, chatId);
-  if (!fs52.existsSync(p)) return [];
+  if (!fs53.existsSync(p)) return [];
   const out = [];
-  for (const line of fs52.readFileSync(p, "utf-8").split("\n")) {
+  for (const line of fs53.readFileSync(p, "utf-8").split("\n")) {
     if (!line) continue;
     try {
       const rec = JSON.parse(line);
@@ -25969,12 +26068,12 @@ function beginTurn(dir, chatId) {
   };
   live.set(chatId, state);
   const p = brainEventsFilePath(dir, chatId);
-  fs52.mkdirSync(path50.dirname(p), { recursive: true });
+  fs53.mkdirSync(path50.dirname(p), { recursive: true });
   return (event) => {
     state.seq += 1;
     const rec = { seq: state.seq, turn, ts: Date.now(), event };
     try {
-      fs52.appendFileSync(p, `${JSON.stringify(rec)}
+      fs53.appendFileSync(p, `${JSON.stringify(rec)}
 `);
     } catch (err) {
       process.stderr.write(
@@ -26013,7 +26112,7 @@ function endTurnIfUnterminated(dir, chatId, errMessage) {
     event: { type: "error", error: errMessage || "turn ended unexpectedly", chatId }
   };
   try {
-    fs52.appendFileSync(brainEventsFilePath(dir, chatId), `${JSON.stringify(rec)}
+    fs53.appendFileSync(brainEventsFilePath(dir, chatId), `${JSON.stringify(rec)}
 `);
   } catch {
   }
@@ -28246,7 +28345,7 @@ async function poolServe() {
 
 // src/servers/runner-serve.ts
 import { spawn as spawn9 } from "child_process";
-import * as fs53 from "fs";
+import * as fs54 from "fs";
 import { createServer as createServer6 } from "http";
 var DEFAULT_PORT2 = 8080;
 var DEFAULT_WORKDIR = "/workspace/repo";
@@ -28381,8 +28480,8 @@ async function defaultRunJob(job) {
   const workdir = process.env.RUNNER_WORKDIR ?? DEFAULT_WORKDIR;
   const branch = job.ref ?? "main";
   const authUrl = `https://x-access-token:${job.githubToken}@github.com/${job.repo}.git`;
-  fs53.rmSync(workdir, { recursive: true, force: true });
-  fs53.mkdirSync(workdir, { recursive: true });
+  fs54.rmSync(workdir, { recursive: true, force: true });
+  fs54.mkdirSync(workdir, { recursive: true });
   const allSecrets = typeof job.allSecrets === "string" ? job.allSecrets : JSON.stringify(job.allSecrets ?? {});
   const target = job.runRequest.target;
   const interactive = target.type === "chat";

package/dist/runtime-services/capability-delivery/profile.json

@@ -74,7 +74,11 @@
   "scripts": {
     "preflight": [
       { "script": "loadSimpleCapability" },
-      { "script": "prepareCapabilityDelivery" }
+      { "script": "prepareCapabilityDelivery" },
+      {
+        "script": "runSimpleCapabilityScript",
+        "runWhen": { "data.capabilityExecution": "script" }
+      }
     ],
     "postflight": [
       { "script": "parseSimpleCapabilityOutput" }

package/dist/runtime-services/capability-run/profile.json

@@ -36,7 +36,13 @@
   },
   "cliTools": [],
   "scripts": {
-    "preflight": [{ "script": "loadSimpleCapability" }],
+    "preflight": [
+      { "script": "loadSimpleCapability" },
+      {
+        "script": "runSimpleCapabilityScript",
+        "runWhen": { "data.capabilityExecution": "script" }
+      }
+    ],
     "postflight": [{ "script": "parseSimpleCapabilityOutput" }]
   },
   "inputArtifacts": [],

package/package.json

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

package/templates/kody.yml

@@ -99,5 +99,4 @@ jobs:
           KODY_DEFINITIONS_ROOT_CWD: ${{ github.workspace }}
         working-directory: ${{ github.workspace }}
         run: |
-          test -d .kody-engine/definitions/capabilities
           npx -y -p @kody-ade/kody-engine@latest kody-engine ci --cwd "$GITHUB_WORKSPACE"