@kody-ade/kody-engine 0.4.472 → 0.4.474

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.472",
+      version: "0.4.474",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -454,6 +454,7 @@ function parseReleaseConfig(raw) {
   if (typeof r.productionUrl === "string") out.productionUrl = r.productionUrl;
   if (typeof r.smokeCommand === "string") out.smokeCommand = r.smokeCommand;
   if (typeof r.draftRelease === "boolean") out.draftRelease = r.draftRelease;
+  if (typeof r.allowAdminMerge === "boolean") out.allowAdminMerge = r.allowAdminMerge;
   if (typeof r.releaseBranch === "string") out.releaseBranch = r.releaseBranch;
   if (typeof r.timeoutMs === "number" && r.timeoutMs > 0) out.timeoutMs = Math.floor(r.timeoutMs);
   return Object.keys(out).length > 0 ? out : void 0;
@@ -1729,12 +1730,22 @@ function parseCapabilityContract(raw) {
   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");
+  const secrets = parsed.secrets === void 0 ? void 0 : Array.isArray(parsed.secrets) && parsed.secrets.every((name) => typeof name === "string" && /^[A-Z][A-Z0-9_]*$/.test(name)) ? [...new Set(parsed.secrets)] : null;
+  if (secrets === null) {
+    throw new Error("contract.json secrets must contain valid environment variable names");
+  }
+  if (secrets && parsed.execution !== "script") {
+    throw new Error('contract.json secrets are supported only when execution is "script"');
+  }
+  const unsupported = Object.keys(parsed).filter(
+    (key) => key !== "execution" && key !== "secrets" && key !== "input" && key !== "output"
+  );
   if (unsupported.length > 0) {
     throw new Error(`contract.json contains unsupported fields: ${unsupported.join(", ")}`);
   }
   return {
     ...parsed.execution ? { execution: parsed.execution } : {},
+    ...secrets ? { secrets } : {},
     input: parsed.input,
     output: parsed.output
   };
@@ -2316,7 +2327,7 @@ var init_convex_client = __esm({
 
 // src/kody-api-client.ts
 import { getFunctionName } from "convex/server";
-function apiUrl(env) {
+function resolveKodyApiUrl(env) {
   return (env.KODY_API_URL?.trim() || env.KODY_DASHBOARD_URL?.trim() || env.DASHBOARD_URL?.trim() || DEFAULT_KODY_API_URL).replace(/\/$/, "");
 }
 function oidcRequestUrl(env) {
@@ -2355,7 +2366,7 @@ function operationName(fn) {
 async function callKodyApi(kind, fn, args, env) {
   const call = async (forceToken) => {
     const token = await githubOidcToken(env, forceToken);
-    return fetch(`${apiUrl(env)}/api/kody/engine/backend`, {
+    return fetch(`${resolveKodyApiUrl(env)}/api/kody/engine/backend`, {
       method: "POST",
       headers: {
         Authorization: `Bearer ${token}`,
@@ -2385,7 +2396,7 @@ function createKodyApiBackendClient(env = process.env) {
 }
 async function readRuntimeSecretFromKody(name, env = process.env) {
   const token = await githubOidcToken(env);
-  const response = await fetch(`${apiUrl(env)}/api/kody/engine/secret`, {
+  const response = await fetch(`${resolveKodyApiUrl(env)}/api/kody/engine/secret`, {
     method: "POST",
     headers: { Authorization: `Bearer ${token}`, "Content-Type": "application/json" },
     body: JSON.stringify({ name }),
@@ -2398,7 +2409,7 @@ async function readRuntimeSecretFromKody(name, env = process.env) {
 }
 async function readPreviewContextFromKody(env = process.env) {
   const token = await githubOidcToken(env);
-  const response = await fetch(`${apiUrl(env)}/api/kody/engine/preview-context`, {
+  const response = await fetch(`${resolveKodyApiUrl(env)}/api/kody/engine/preview-context`, {
     method: "POST",
     headers: { Authorization: `Bearer ${token}` },
     signal: AbortSignal.timeout(3e4)
@@ -2410,7 +2421,7 @@ var DEFAULT_KODY_API_URL, OIDC_AUDIENCE, cachedToken;
 var init_kody_api_client = __esm({
   "src/kody-api-client.ts"() {
     "use strict";
-    DEFAULT_KODY_API_URL = "https://dashboard-six-alpha-46.vercel.app";
+    DEFAULT_KODY_API_URL = "https://kody-dashboard-aguy.vercel.app";
     OIDC_AUDIENCE = "kody-api";
     cachedToken = null;
   }
@@ -13259,6 +13270,13 @@ var init_loopDefinitions = __esm({
 
 // src/scripts/dispatchLoops.ts
 import { randomUUID } from "crypto";
+function assertLoopDispatchesSucceeded(results) {
+  const failed = results.filter((result) => result.status === "failed");
+  if (failed.length === 0) return;
+  throw new Error(
+    `Loop dispatch failed: ${failed.map((result) => `${result.loopId}: ${result.reason}`).join("; ")}`
+  );
+}
 async function dispatchLoopsWith(input) {
   const results = [];
   for (const loop of input.loops) {
@@ -13421,6 +13439,7 @@ var init_dispatchLoops = __esm({
 `);
       }
       ctx.data.loopDispatchResults = results;
+      assertLoopDispatchesSucceeded(results);
     };
   }
 });
@@ -15544,6 +15563,7 @@ var init_loadSimpleCapability = __esm({
       ctx.data.capabilityExecution = capability.contract?.execution ?? "agent";
       if (capability.contract?.execution === "script") {
         ctx.data.capabilityScriptPath = path40.join(capability.dir, "tools", "run.sh");
+        ctx.data.capabilitySecretNames = capability.contract.secrets ?? [];
       }
       if (capability.config.outputSchema) {
         ctx.data.capabilityOutputSchema = capability.config.outputSchema;
@@ -16569,6 +16589,7 @@ var init_parseSimpleCapabilityOutput = __esm({
   "src/scripts/parseSimpleCapabilityOutput.ts"() {
     "use strict";
     init_capability_contract_validation();
+    init_capabilityResult();
     parseSimpleCapabilityOutput = async (ctx, _profile, agentResult) => {
       const output = Object.hasOwn(ctx.data, "capabilityScriptOutput") ? ctx.data.capabilityScriptOutput : parseOutput(agentResult?.finalText);
       if (output === void 0) {
@@ -16617,6 +16638,12 @@ var init_parseSimpleCapabilityOutput = __esm({
         }
       }
       ctx.data.capabilityOutput = output;
+      const structuredResult = parseCapabilityResult(output);
+      if (structuredResult) {
+        ctx.output.reason = structuredResult.summary;
+        ctx.data.capabilityResults = [structuredResult];
+        return;
+      }
       const result = isObject2(output) ? output : {};
       const data = isObject2(result.data) ? result.data : isObject2(output) ? output : { output };
       const summary = typeof result.summary === "string" ? result.summary : "Capability completed";
@@ -19003,6 +19030,16 @@ var init_runScheduledImplementationTick = __esm({
 // src/scripts/runSimpleCapabilityScript.ts
 import { spawnSync as spawnSync3 } from "child_process";
 import * as fs47 from "fs";
+function declaredSecrets(names, parent) {
+  if (!Array.isArray(names)) return {};
+  const secrets = {};
+  for (const name of names) {
+    if (typeof name !== "string" || !/^[A-Z][A-Z0-9_]*$/.test(name)) continue;
+    const value = parent[name];
+    if (value !== void 0) secrets[name] = value;
+  }
+  return secrets;
+}
 function isRegularFile2(filePath) {
   try {
     const stat = fs47.lstatSync(filePath);
@@ -19030,10 +19067,12 @@ var init_runSimpleCapabilityScript = __esm({
         return;
       }
       const capabilityEnvironment2 = isStringRecord(ctx.data.capabilityEnvironment) ? ctx.data.capabilityEnvironment : {};
+      const capabilitySecrets = declaredSecrets(ctx.data.capabilitySecretNames, process.env);
       const result = spawnSync3("bash", [scriptPath], {
         cwd: ctx.cwd,
         env: {
           ...buildTickChildEnv(process.env, false),
+          ...capabilitySecrets,
           ...capabilityEnvironment2
         },
         stdio: ["ignore", "pipe", "pipe"],
@@ -22251,11 +22290,7 @@ async function runGraphCapabilityWorkflow(parent, workflow, capability, base, ch
       return withWorkflowBoundaryEval(capability, { ...result, workflowState: state });
     }
     if (!step.next || step.next.length === 0) {
-      state.status = "done";
-      delete state.currentStepId;
-      delete state.blocker;
-      await checkpoint?.(state);
-      return withWorkflowBoundaryEval(capability, { ...result, workflowState: state });
+      return completeWorkflowAtTerminal(capability, state, result, checkpoint);
     }
     const resultConditionPaths = workflowResultConditionPaths(step.next);
     if (resultConditionPaths.length > 0 && !result.capabilityResults?.at(-1)) {
@@ -22278,11 +22313,7 @@ async function runGraphCapabilityWorkflow(parent, workflow, capability, base, ch
       state.transitionCounts[key] = (state.transitionCounts[key] ?? 0) + 1;
     }
     if (transition.to === "$end") {
-      state.status = "done";
-      delete state.currentStepId;
-      delete state.blocker;
-      await checkpoint?.(state);
-      return withWorkflowBoundaryEval(capability, { ...result, workflowState: state });
+      return completeWorkflowAtTerminal(capability, state, result, checkpoint);
     }
     state.currentStepId = transition.to;
     state.status = "running";
@@ -22293,6 +22324,25 @@ async function runGraphCapabilityWorkflow(parent, workflow, capability, base, ch
   await checkpoint?.(state);
   return withWorkflowBoundaryEval(capability, { ...result, workflowState: state });
 }
+async function completeWorkflowAtTerminal(capability, state, output, checkpoint) {
+  const result = output.capabilityResults?.at(-1);
+  if (result?.status === "fail" || result?.status === "blocked") {
+    state.status = result.status === "fail" ? "failed" : "blocked";
+    state.blocker = result.summary;
+    await checkpoint?.(state);
+    return withWorkflowBoundaryEval(capability, {
+      ...output,
+      exitCode: result.status === "fail" ? 1 : 64,
+      reason: result.summary,
+      workflowState: state
+    });
+  }
+  state.status = "done";
+  delete state.currentStepId;
+  delete state.blocker;
+  await checkpoint?.(state);
+  return withWorkflowBoundaryEval(capability, { ...output, workflowState: state });
+}
 function graphWorkflowExecutionKey(parentExecutionKey, workflowSlug, stepId, transitionCounts) {
   const transitionHistory = Object.entries(transitionCounts).filter(([, count]) => count > 0).sort(([left], [right]) => left.localeCompare(right)).map(([transition, count]) => `${transition}=${count}`).join(",");
   return [

package/kody.config.schema.json

@@ -149,6 +149,7 @@
         "e2eCommand": { "type": "string" },
         "draftRelease": { "type": "boolean" },
         "releaseBranch": { "type": "string" },
+        "allowAdminMerge": { "type": "boolean" },
         "timeoutMs": {
           "type": "integer",
           "minimum": 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.472",
+  "version": "0.4.474",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,29 @@
     "templates",
     "kody.config.schema.json"
   ],
+  "scripts": {
+    "kody:run": "tsx bin/kody.ts",
+    "serve": "tsx bin/kody.ts serve",
+    "serve:vscode": "tsx bin/kody.ts serve vscode",
+    "serve:claude": "tsx bin/kody.ts serve claude",
+    "clean:dist": "node scripts/clean-dist.cjs",
+    "build": "pnpm clean:dist && tsup && node scripts/copy-assets.cjs",
+    "check:modularity": "tsx scripts/check-script-modularity.ts",
+    "pretest": "pnpm check:modularity",
+    "test": "vitest run tests/unit tests/int --coverage",
+    "posttest": "tsx scripts/check-coverage-floor.ts",
+    "test:smoke": "vitest run tests/smoke --no-coverage",
+    "test:e2e": "vitest run tests/e2e --no-coverage",
+    "test:runtime-services": "node --test \"tests/runtime-services/*.test.mjs\"",
+    "test:all": "vitest run tests --no-coverage",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check",
+    "lint:fix": "biome check --write",
+    "format": "biome format --write",
+    "verify:package": "node scripts/verify-package-tarball.cjs",
+    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain --build-arg KODY_ENGINE_REF=$(git rev-parse HEAD) -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner",
+    "prepublishOnly": "pnpm typecheck && vitest run tests/unit tests/int --no-coverage && pnpm test:runtime-services && pnpm build && pnpm verify:package"
+  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -38,27 +61,5 @@
     "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
   },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
-  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues",
-  "scripts": {
-    "kody:run": "tsx bin/kody.ts",
-    "serve": "tsx bin/kody.ts serve",
-    "serve:vscode": "tsx bin/kody.ts serve vscode",
-    "serve:claude": "tsx bin/kody.ts serve claude",
-    "clean:dist": "node scripts/clean-dist.cjs",
-    "build": "pnpm clean:dist && tsup && node scripts/copy-assets.cjs",
-    "check:modularity": "tsx scripts/check-script-modularity.ts",
-    "pretest": "pnpm check:modularity",
-    "test": "vitest run tests/unit tests/int --coverage",
-    "posttest": "tsx scripts/check-coverage-floor.ts",
-    "test:smoke": "vitest run tests/smoke --no-coverage",
-    "test:e2e": "vitest run tests/e2e --no-coverage",
-    "test:runtime-services": "node --test \"tests/runtime-services/*.test.mjs\"",
-    "test:all": "vitest run tests --no-coverage",
-    "typecheck": "tsc --noEmit",
-    "lint": "biome check",
-    "lint:fix": "biome check --write",
-    "format": "biome format --write",
-    "verify:package": "node scripts/verify-package-tarball.cjs",
-    "brain:publish": "docker buildx build --platform linux/amd64 -f runner/Dockerfile.brain --build-arg KODY_ENGINE_REF=$(git rev-parse HEAD) -t ghcr.io/${KODY_BRAIN_GHCR_OWNER:-aharonyaircohen}/kody-brain:latest --push runner"
-  }
-}
+  "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
+}