@kody-ade/kody-engine 0.4.502 → 0.4.503

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.502",
+      version: "0.4.503",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -15648,6 +15648,8 @@ var init_loadQaContext = __esm({
 // src/scripts/loadSimpleCapability.ts
 import * as fs43 from "fs";
 import * as path40 from "path";
+import * as os6 from "os";
+import { randomUUID as randomUUID2 } from "crypto";
 function registerCapabilitySubagents(profile, toolRoot, toolFiles) {
   const subagentFiles = toolFiles.flatMap((file) => {
     const match = /^agents\/([a-z][a-z0-9-]{0,63})\.md$/.exec(file);
@@ -15754,9 +15756,12 @@ var init_loadSimpleCapability = __esm({
       if (capability.config.outputSchema) {
         ctx.data.capabilityOutputSchema = capability.config.outputSchema;
       }
+      const outputPath = ctx.data.capabilityExecution === "agent" && capability.config.outputSchema ? path40.join(os6.tmpdir(), `kody-capability-output-${randomUUID2()}.json`) : void 0;
+      if (outputPath) ctx.data.capabilityOutputPath = outputPath;
       ctx.data.capabilityEnvironment = {
         ...capabilityInputEnvironment(input),
-        ...capabilityConfigEnvironment(ctx.config)
+        ...capabilityConfigEnvironment(ctx.config),
+        ...outputPath ? { KODY_CAPABILITY_OUTPUT: outputPath } : {}
       };
       ctx.data.prompt = [
         capability.rawBody.trim(),
@@ -15793,7 +15798,13 @@ var init_loadSimpleCapability = __esm({
           "",
           "```json",
           JSON.stringify(capability.config.outputSchema, null, 2),
-          "```"
+          "```",
+          ...outputPath ? [
+            "",
+            "Write the final JSON value to this file before your final response:",
+            outputPath,
+            "The Engine reads this file as the authoritative result. Do not write markdown to it."
+          ] : []
         ] : ["Return one JSON value."]
       ].join("\n");
     };
@@ -16741,6 +16752,15 @@ var init_parseReproOutput = __esm({
 });
 
 // src/scripts/parseSimpleCapabilityOutput.ts
+import * as fs45 from "fs";
+function readOutputFile(outputPath) {
+  if (!outputPath || !fs45.existsSync(outputPath)) return { found: false };
+  try {
+    return { found: true, value: JSON.parse(fs45.readFileSync(outputPath, "utf-8")) };
+  } finally {
+    fs45.rmSync(outputPath, { force: true });
+  }
+}
 function parseOutput(text2) {
   if (!text2) return void 0;
   try {
@@ -16780,7 +16800,9 @@ var init_parseSimpleCapabilityOutput = __esm({
     init_capability_contract_validation();
     init_capabilityResult();
     parseSimpleCapabilityOutput = async (ctx, _profile, agentResult) => {
-      const output = Object.hasOwn(ctx.data, "capabilityScriptOutput") ? ctx.data.capabilityScriptOutput : parseOutput(agentResult?.finalText);
+      const outputPath = typeof ctx.data.capabilityOutputPath === "string" ? ctx.data.capabilityOutputPath : void 0;
+      const fileOutput = readOutputFile(outputPath);
+      const output = fileOutput.found ? fileOutput.value : 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 = {
@@ -17322,8 +17344,8 @@ var init_postResearchComment = __esm({
 });
 
 // src/scripts/prepareBrowserAuth.ts
-import * as fs45 from "fs";
-import * as os6 from "os";
+import * as fs46 from "fs";
+import * as os7 from "os";
 import * as path42 from "path";
 function appendAuthMessage(ctx, message) {
   const current = typeof ctx.data.qaAuthBlock === "string" ? ctx.data.qaAuthBlock.trim() : "";
@@ -17363,8 +17385,8 @@ async function githubJson(url, token) {
   return await response.json();
 }
 function writeKodyStorageState(input) {
-  const directory = fs45.mkdtempSync(path42.join(os6.tmpdir(), "kody-browser-auth-"));
-  fs45.chmodSync(directory, 448);
+  const directory = fs46.mkdtempSync(path42.join(os7.tmpdir(), "kody-browser-auth-"));
+  fs46.chmodSync(directory, 448);
   const file = path42.join(directory, "storage-state.json");
   const now = Date.now();
   const repoEntry = {
@@ -17395,7 +17417,7 @@ function writeKodyStorageState(input) {
       }
     ]
   };
-  fs45.writeFileSync(file, JSON.stringify(storageState), { mode: 384 });
+  fs46.writeFileSync(file, JSON.stringify(storageState), { mode: 384 });
   return { directory, file };
 }
 function configurePlaywright(profile, storageStatePath) {
@@ -17477,7 +17499,7 @@ async function prepareMethod(ctx, profile, method) {
     configurePlaywright(profile, state.file);
     const authDirectory = state.directory;
     registerRuntimeCleanup(ctx, () => {
-      fs45.rmSync(authDirectory, { recursive: true, force: true });
+      fs46.rmSync(authDirectory, { recursive: true, force: true });
     });
     appendAuthMessage(
       ctx,
@@ -17485,7 +17507,7 @@ async function prepareMethod(ctx, profile, method) {
     );
     return true;
   } catch (error) {
-    if (state) fs45.rmSync(state.directory, { recursive: true, force: true });
+    if (state) fs46.rmSync(state.directory, { recursive: true, force: true });
     const reason = error instanceof Error ? error.message : String(error);
     appendAuthMessage(
       ctx,
@@ -19161,7 +19183,7 @@ var init_tickShellRunner = __esm({
 });
 
 // src/scripts/runScheduledImplementationTick.ts
-import * as fs46 from "fs";
+import * as fs47 from "fs";
 import * as path44 from "path";
 var runScheduledImplementationTick;
 var init_runScheduledImplementationTick = __esm({
@@ -19190,7 +19212,7 @@ var init_runScheduledImplementationTick = __esm({
         return;
       }
       const shellPath = path44.join(profile.dir, shell);
-      if (!fs46.existsSync(shellPath)) {
+      if (!fs47.existsSync(shellPath)) {
         ctx.output.exitCode = 99;
         ctx.output.reason = `runScheduledImplementationTick: shell not found: ${shell} (looked in ${profile.dir})`;
         return;
@@ -19222,13 +19244,13 @@ var init_runScheduledImplementationTick = __esm({
 
 // src/scripts/runSimpleCapabilityScript.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import * as fs47 from "fs";
+import * as fs48 from "fs";
 function formatDuration2(timeoutMs) {
   return timeoutMs % 6e4 === 0 ? `${timeoutMs / 6e4} minutes` : `${timeoutMs}ms`;
 }
 function isRegularFile2(filePath) {
   try {
-    const stat = fs47.lstatSync(filePath);
+    const stat = fs48.lstatSync(filePath);
     return stat.isFile() && !stat.isSymbolicLink();
   } catch {
     return false;
@@ -19307,7 +19329,7 @@ var init_runSimpleCapabilityScript = __esm({
 });
 
 // src/scripts/runTickScript.ts
-import * as fs48 from "fs";
+import * as fs49 from "fs";
 import * as path45 from "path";
 var runTickScript;
 var init_runTickScript = __esm({
@@ -19341,7 +19363,7 @@ var init_runTickScript = __esm({
         return;
       }
       const scriptPath = path45.isAbsolute(tickScript) ? tickScript : path45.join(ctx.cwd, tickScript);
-      if (!fs48.existsSync(scriptPath)) {
+      if (!fs49.existsSync(scriptPath)) {
         ctx.output.exitCode = 99;
         ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
         return;
@@ -20385,7 +20407,7 @@ var init_warmupMcp = __esm({
 });
 
 // src/scripts/writeAgentRunSummary.ts
-import * as fs49 from "fs";
+import * as fs50 from "fs";
 var writeAgentRunSummary;
 var init_writeAgentRunSummary = __esm({
   "src/scripts/writeAgentRunSummary.ts"() {
@@ -20411,7 +20433,7 @@ var init_writeAgentRunSummary = __esm({
       if (reason) lines.push(`- **Reason:** ${reason}`);
       lines.push("");
       try {
-        fs49.appendFileSync(summaryPath, `${lines.join("\n")}
+        fs50.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
       } catch {
       }
@@ -20747,7 +20769,7 @@ var init_scripts = __esm({
 });
 
 // src/stateWorkspace.ts
-import * as fs50 from "fs";
+import * as fs51 from "fs";
 import * as path47 from "path";
 function tenantId(config) {
   const owner = config.github?.owner?.trim() || process.env.GITHUB_REPOSITORY?.split("/")[0]?.trim();
@@ -20756,8 +20778,8 @@ function tenantId(config) {
 }
 function writeRuntimeFile(cwd, relativePath, content) {
   const target = path47.join(cwd, RUNTIME_ROOT, relativePath);
-  fs50.mkdirSync(path47.dirname(target), { recursive: true });
-  fs50.writeFileSync(target, content, "utf8");
+  fs51.mkdirSync(path47.dirname(target), { recursive: true });
+  fs51.writeFileSync(target, content, "utf8");
 }
 function record(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -20826,7 +20848,7 @@ async function hydrateStateWorkspace(config, cwd, backendOverride) {
   if (hydratedWorkspaces.has(key)) return;
   const backend = backendOverride ?? createStateBackendFromEnv();
   const root = path47.join(cwd, RUNTIME_ROOT);
-  fs50.rmSync(root, { recursive: true, force: true });
+  fs51.rmSync(root, { recursive: true, force: true });
   await Promise.all([
     hydratePrefix(backend, tenant, cwd, "context:"),
     hydratePrefix(backend, tenant, cwd, "memory:"),
@@ -20913,8 +20935,8 @@ var init_tools = __esm({
 
 // src/executor.ts
 import { spawn as spawn8 } from "child_process";
-import * as fs51 from "fs";
-import * as os7 from "os";
+import * as fs52 from "fs";
+import * as os8 from "os";
 import * as path48 from "path";
 function isMutatingPostflight(scriptName) {
   return MUTATING_POSTFLIGHTS.has(scriptName ?? "");
@@ -21655,7 +21677,7 @@ function resolveProfilePath(profileName, cwd = process.cwd()) {
     // fallback
   ];
   for (const c of candidates) {
-    if (fs51.existsSync(c)) return c;
+    if (fs52.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -21771,7 +21793,7 @@ function resolveShellTimeoutMs(entry) {
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
   const shellPath = path48.join(profile.dir, shellName);
-  if (!fs51.existsSync(shellPath)) {
+  if (!fs52.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -21779,7 +21801,7 @@ async function runShellEntry(entry, ctx, profile) {
   }
   const positional = entry.with ? Object.values(entry.with).map((v) => String(v)) : [];
   const outputFile = path48.join(
-    os7.tmpdir(),
+    os8.tmpdir(),
     `kody-shell-output-${process.pid}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`
   );
   const env = { ...process.env, HUSKY: "0", SKIP_HOOKS: "1", KODY_OUTPUT: outputFile };
@@ -21845,9 +21867,9 @@ async function runShellEntry(entry, ctx, profile) {
   }
   let sideChannelText = "";
   try {
-    if (fs51.existsSync(outputFile)) {
-      sideChannelText = fs51.readFileSync(outputFile, "utf-8");
-      fs51.rmSync(outputFile, { force: true });
+    if (fs52.existsSync(outputFile)) {
+      sideChannelText = fs52.readFileSync(outputFile, "utf-8");
+      fs52.rmSync(outputFile, { force: true });
     }
   } catch {
   }
@@ -24143,7 +24165,7 @@ async function hydrateDefinitionsFromEnv(cwd = process.cwd(), env = process.env)
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync24 } from "child_process";
-import * as fs52 from "fs";
+import * as fs53 from "fs";
 import * as path49 from "path";
 
 // src/app-auth.ts
@@ -24940,9 +24962,9 @@ async function resolveAuthToken(env = process.env) {
   return void 0;
 }
 function detectPackageManager2(cwd) {
-  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";
+  if (fs53.existsSync(path49.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs53.existsSync(path49.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs53.existsSync(path49.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shouldChainScheduledWatch(match) {
@@ -25044,8 +25066,8 @@ function postFailureTail(issueNumber, cwd, reason) {
   const logPath = lastRunLogPath(cwd);
   let tail = "";
   try {
-    if (fs52.existsSync(logPath)) {
-      const content = fs52.readFileSync(logPath, "utf-8");
+    if (fs53.existsSync(logPath)) {
+      const content = fs53.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -25136,9 +25158,9 @@ async function runCi(argv) {
       forceRunCliArgs = { goal: envForceMessage };
     }
   }
-  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs52.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs53.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs52.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs53.readFileSync(dispatchEventPath, "utf-8"));
       const inputs = objectValue2(evt.inputs);
       const issueInput = parseInt(String(inputs?.issue_number ?? ""), 10);
       const sessionInput = String(inputs?.sessionId ?? "");
@@ -25549,7 +25571,7 @@ init_repoWorkspace();
 
 // src/scripts/brainTurnLog.ts
 init_runtimePaths();
-import * as fs53 from "fs";
+import * as fs54 from "fs";
 import * as path50 from "path";
 import posixPath4 from "path/posix";
 var live = /* @__PURE__ */ new Map();
@@ -25558,8 +25580,8 @@ function brainEventsFilePath(dir, chatId) {
 }
 function lastPersistedSeq(dir, chatId) {
   const p = brainEventsFilePath(dir, chatId);
-  if (!fs53.existsSync(p)) return 0;
-  const lines = fs53.readFileSync(p, "utf-8").split("\n").filter(Boolean);
+  if (!fs54.existsSync(p)) return 0;
+  const lines = fs54.readFileSync(p, "utf-8").split("\n").filter(Boolean);
   if (lines.length === 0) return 0;
   try {
     return JSON.parse(lines[lines.length - 1]).seq || 0;
@@ -25569,9 +25591,9 @@ function lastPersistedSeq(dir, chatId) {
 }
 function readSince(dir, chatId, since) {
   const p = brainEventsFilePath(dir, chatId);
-  if (!fs53.existsSync(p)) return [];
+  if (!fs54.existsSync(p)) return [];
   const out = [];
-  for (const line of fs53.readFileSync(p, "utf-8").split("\n")) {
+  for (const line of fs54.readFileSync(p, "utf-8").split("\n")) {
     if (!line) continue;
     try {
       const rec = JSON.parse(line);
@@ -25597,12 +25619,12 @@ function beginTurn(dir, chatId) {
   };
   live.set(chatId, state);
   const p = brainEventsFilePath(dir, chatId);
-  fs53.mkdirSync(path50.dirname(p), { recursive: true });
+  fs54.mkdirSync(path50.dirname(p), { recursive: true });
   return (event) => {
     state.seq += 1;
     const rec = { seq: state.seq, turn, ts: Date.now(), event };
     try {
-      fs53.appendFileSync(p, `${JSON.stringify(rec)}
+      fs54.appendFileSync(p, `${JSON.stringify(rec)}
 `);
     } catch (err) {
       process.stderr.write(
@@ -25641,7 +25663,7 @@ function endTurnIfUnterminated(dir, chatId, errMessage) {
     event: { type: "error", error: errMessage || "turn ended unexpectedly", chatId }
   };
   try {
-    fs53.appendFileSync(brainEventsFilePath(dir, chatId), `${JSON.stringify(rec)}
+    fs54.appendFileSync(brainEventsFilePath(dir, chatId), `${JSON.stringify(rec)}
 `);
   } catch {
   }
@@ -26458,7 +26480,7 @@ init_config();
 init_fetchRepoMcp();
 
 // src/servers/mcpHttpServer.ts
-import { randomUUID as randomUUID2 } from "crypto";
+import { randomUUID as randomUUID3 } from "crypto";
 import { createServer as createServer4 } from "http";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
@@ -26467,7 +26489,7 @@ function buildMcpHttpServer(opts) {
   const transports = /* @__PURE__ */ new Map();
   for (const route of opts.routes) {
     const transport = new StreamableHTTPServerTransport({
-      sessionIdGenerator: () => randomUUID2()
+      sessionIdGenerator: () => randomUUID3()
     });
     transports.set(route.path, transport);
     routes.set(route.path, route.name);
@@ -27819,7 +27841,7 @@ async function poolServe() {
 
 // src/servers/runner-serve.ts
 import { spawn as spawn9 } from "child_process";
-import * as fs54 from "fs";
+import * as fs55 from "fs";
 import { createServer as createServer6 } from "http";
 var DEFAULT_PORT2 = 8080;
 var DEFAULT_WORKDIR = "/workspace/repo";
@@ -27895,8 +27917,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`;
-  fs54.rmSync(workdir, { recursive: true, force: true });
-  fs54.mkdirSync(workdir, { recursive: true });
+  fs55.rmSync(workdir, { recursive: true, force: true });
+  fs55.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.502",
+  "version": "0.4.503",
   "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"
+}