@kody-ade/kody-engine 0.4.612 → 0.4.617

package/README.md

@@ -115,6 +115,12 @@ downstream workflows or modify `.github/workflows/*`.
 
 The consumer workflow listens on `issue_comment` for `@kody ...` dispatch and `workflow_dispatch` for manual runs and chat mode. Convex owns scheduled Loop wakeups.
 
+Live chat transcripts remain in Kody's canonical backend. In GitHub Actions,
+the Engine uses the workflow's short-lived OIDC identity to call Dashboard's
+repository-scoped backend endpoint; consumer repositories must not receive
+`CONVEX_URL` or `KODY_SERVICE_KEY`. Local and server runtimes may connect
+directly with those two variables when no GitHub Actions identity exists.
+
 ## Commands
 
 ```

package/dist/bin/kody.js

@@ -15,9 +15,13 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@kody-ade/kody-engine",
-      version: "0.4.612",
+      version: "0.4.617",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
+      repository: {
+        type: "git",
+        url: "git+https://github.com/aharonyaircohen/kody-engine.git"
+      },
       type: "module",
       bin: {
         "kody-engine": "dist/bin/kody.js"
@@ -72,10 +76,6 @@ var init_package = __esm({
       engines: {
         node: ">=22"
       },
-      repository: {
-        type: "git",
-        url: "git+https://github.com/aharonyaircohen/kody-engine.git"
-      },
       homepage: "https://github.com/aharonyaircohen/kody-engine",
       bugs: "https://github.com/aharonyaircohen/kody-engine/issues"
     };
@@ -2322,7 +2322,9 @@ function parseDeliveryConfigAllowlist(raw) {
     if (filePath !== "kody.config.json" || !Array.isArray(paths) || paths.length === 0 || paths.length > 32) {
       throw new Error("contract.json deliveryConfigAllowlist contains an unsupported config file or path list");
     }
-    if (!paths.every((value) => typeof value === "string" && /^[A-Za-z][A-Za-z0-9]*(?:\.[A-Za-z][A-Za-z0-9]*)*$/.test(value))) {
+    if (!paths.every(
+      (value) => typeof value === "string" && /^[A-Za-z][A-Za-z0-9]*(?:\.[A-Za-z][A-Za-z0-9]*)*$/.test(value)
+    )) {
       throw new Error("contract.json deliveryConfigAllowlist must contain safe dotted config paths");
     }
     parsed[filePath] = [...new Set(paths)];
@@ -2367,9 +2369,7 @@ function parseCapabilityRequirements(raw) {
   if (raw.githubTestToken !== void 0 && typeof raw.githubTestToken !== "boolean") {
     throw new Error("contract.json requirements.githubTestToken must be boolean");
   }
-  if (raw.qaAccountCredentials !== void 0 && (!Array.isArray(raw.qaAccountCredentials) || raw.qaAccountCredentials.length === 0 || !raw.qaAccountCredentials.every(
-    (name) => typeof name === "string" && /^[A-Z][A-Z0-9_]{0,127}$/.test(name)
-  ))) {
+  if (raw.qaAccountCredentials !== void 0 && (!Array.isArray(raw.qaAccountCredentials) || raw.qaAccountCredentials.length === 0 || !raw.qaAccountCredentials.every((name) => typeof name === "string" && /^[A-Z][A-Z0-9_]{0,127}$/.test(name)))) {
     throw new Error("contract.json requirements.qaAccountCredentials must contain valid credential names");
   }
   if (raw.qaAccountModelSettings !== void 0 && !isPlainObject(raw.qaAccountModelSettings)) {
@@ -6110,6 +6110,7 @@ function loadProfile(profilePath) {
   const STATE_LOADERS = [
     "loadCapabilityState",
     "loadJobFromFile",
+    "loadLiveAgent",
     "runTickScript",
     "runScheduledImplementationTick",
     "runScheduledExecutableTick"
@@ -8909,9 +8910,7 @@ function abortUnfinishedGitOps(cwd) {
   return aborted;
 }
 function isExplicitlyAllowed(p, allowlist) {
-  return allowlist.some(
-    (entry) => entry.endsWith("/**") ? p.startsWith(entry.slice(0, -2)) : p === entry
-  );
+  return allowlist.some((entry) => entry.endsWith("/**") ? p.startsWith(entry.slice(0, -2)) : p === entry);
 }
 function isForbiddenPath(p, deliveryPathAllowlist = []) {
   if (FORBIDDEN_PATH_EXACT.has(p)) return true;
@@ -12713,18 +12712,10 @@ var init_commitAndPush = __esm({
       const deliveryPathAllowlist = Array.isArray(ctx.data.deliveryPathAllowlist) ? ctx.data.deliveryPathAllowlist : [];
       const deliveryConfigAllowlist = ctx.data.deliveryConfigAllowlist && typeof ctx.data.deliveryConfigAllowlist === "object" ? ctx.data.deliveryConfigAllowlist : {};
       try {
-        const result2 = commitAndPush(
-          branch,
-          message,
-          ctx.cwd,
-          deliveryPathAllowlist,
-          deliveryConfigAllowlist
-        );
+        const result2 = commitAndPush(branch, message, ctx.cwd, deliveryPathAllowlist, deliveryConfigAllowlist);
         ctx.data.commitResult = result2;
         const postCommitFiles = result2.committed ? listFilesInCommit("HEAD", ctx.cwd) : listChangedFiles(ctx.cwd);
-        ctx.data.changedFiles = postCommitFiles.filter(
-          (f) => !isForbiddenPath(f, deliveryPathAllowlist)
-        );
+        ctx.data.changedFiles = postCommitFiles.filter((f) => !isForbiddenPath(f, deliveryPathAllowlist));
         if (result2.committed && !result2.pushed) {
           const reason = result2.pushError ?? "push failed (no error detail)";
           ctx.data.commitCrash = reason;
@@ -16552,8 +16543,8 @@ var loadLiveAgent;
 var init_loadLiveAgent = __esm({
   "src/scripts/loadLiveAgent.ts"() {
     "use strict";
-    init_definition_paths();
     init_agents();
+    init_definition_paths();
     init_state_backend();
     loadLiveAgent = async (ctx, profile) => {
       const agent = String(ctx.args.agent ?? ctx.data.jobAgent ?? "").trim();
@@ -18593,10 +18584,7 @@ function parseSetCookie(value, hostname) {
   const attributes = /* @__PURE__ */ new Map();
   for (const part of parts) {
     const index = part.indexOf("=");
-    attributes.set(
-      (index < 0 ? part : part.slice(0, index)).toLowerCase(),
-      index < 0 ? "" : part.slice(index + 1)
-    );
+    attributes.set((index < 0 ? part : part.slice(0, index)).toLowerCase(), index < 0 ? "" : part.slice(index + 1));
   }
   const sameSite = attributes.get("samesite")?.toLowerCase();
   return {
@@ -18721,11 +18709,9 @@ function mergeStorageStates(existingPath, nextPath) {
     }
     origins.set(entry.origin, { origin: entry.origin, localStorage: [...localStorage.values()] });
   }
-  fs49.writeFileSync(
-    nextPath,
-    JSON.stringify({ cookies: [...cookies.values()], origins: [...origins.values()] }),
-    { mode: 384 }
-  );
+  fs49.writeFileSync(nextPath, JSON.stringify({ cookies: [...cookies.values()], origins: [...origins.values()] }), {
+    mode: 384
+  });
 }
 function configurePlaywright(profile, storageStatePath) {
   const playwright = profile.claudeCode.mcpServers.find((server) => server.name === "playwright");
@@ -20741,12 +20727,19 @@ function buildTickChildEnv(parent, force, loaded) {
     "GH_PAT",
     "GITHUB_TOKEN",
     "GITHUB_REPOSITORY",
+    "GITHUB_REPOSITORY_ID",
+    "GITHUB_REPOSITORY_OWNER_ID",
     "GITHUB_REF",
     "GITHUB_SHA",
     "GITHUB_RUN_ID",
     "GITHUB_RUN_ATTEMPT",
+    "GITHUB_SERVER_URL",
+    "GITHUB_EVENT_NAME",
     "GITHUB_WORKFLOW",
+    "GITHUB_WORKFLOW_REF",
     "GITHUB_ACTIONS",
+    "ACTIONS_ID_TOKEN_REQUEST_URL",
+    "ACTIONS_ID_TOKEN_REQUEST_TOKEN",
     "CI",
     "KODY_DRY_RUN",
     "KODY_NO_COMMIT"
@@ -20980,25 +20973,6 @@ var init_runTickScript = __esm({
   }
 });
 
-// src/scripts/saveManagedGoalState.ts
-var saveManagedGoalState;
-var init_saveManagedGoalState = __esm({
-  "src/scripts/saveManagedGoalState.ts"() {
-    "use strict";
-    init_state2();
-    saveManagedGoalState = async (ctx) => {
-      ctx.skipAgent = true;
-      const goal = ctx.data.goal;
-      if (!goal?.raw) return;
-      const original = typeof ctx.data.goalOriginalStateText === "string" ? ctx.data.goalOriginalStateText : "";
-      const changedBeforeTimestamp = original !== serializeGoalState(goal.raw);
-      const updated = changedBeforeTimestamp ? { ...goal.raw, updatedAt: nowIso() } : goal.raw;
-      ctx.data.goalPersistState = updated;
-      ctx.data.goalPersistChanged = original !== serializeGoalState(updated);
-    };
-  }
-});
-
 // src/scripts/saveLiveAgentState.ts
 var saveLiveAgentState;
 var init_saveLiveAgentState = __esm({
@@ -21034,6 +21008,25 @@ var init_saveLiveAgentState = __esm({
   }
 });
 
+// src/scripts/saveManagedGoalState.ts
+var saveManagedGoalState;
+var init_saveManagedGoalState = __esm({
+  "src/scripts/saveManagedGoalState.ts"() {
+    "use strict";
+    init_state2();
+    saveManagedGoalState = async (ctx) => {
+      ctx.skipAgent = true;
+      const goal = ctx.data.goal;
+      if (!goal?.raw) return;
+      const original = typeof ctx.data.goalOriginalStateText === "string" ? ctx.data.goalOriginalStateText : "";
+      const changedBeforeTimestamp = original !== serializeGoalState(goal.raw);
+      const updated = changedBeforeTimestamp ? { ...goal.raw, updatedAt: nowIso() } : goal.raw;
+      ctx.data.goalPersistState = updated;
+      ctx.data.goalPersistChanged = original !== serializeGoalState(updated);
+    };
+  }
+});
+
 // src/scripts/setCommentTarget.ts
 var setCommentTarget;
 var init_setCommentTarget = __esm({
@@ -22382,8 +22375,8 @@ var init_scripts = __esm({
     init_runScheduledImplementationTick();
     init_runSimpleCapabilityScript();
     init_runTickScript();
-    init_saveManagedGoalState();
     init_saveLiveAgentState();
+    init_saveManagedGoalState();
     init_saveTaskState();
     init_setCommentTarget();
     init_setLifecycleLabel();
@@ -24229,9 +24222,10 @@ function enforceCapabilityOutputContract(capability, result) {
   if (result.exitCode !== 0 || !schema) {
     return result;
   }
+  const contractOutput = result.capabilityOutput === void 0 && typeof result.prUrl === "string" && result.prUrl.trim().length > 0 ? { prUrl: result.prUrl } : result.capabilityOutput;
   try {
-    validateCapabilityContractOutput(schema, result.capabilityOutput);
-    return result;
+    validateCapabilityContractOutput(schema, contractOutput);
+    return contractOutput === result.capabilityOutput ? result : { ...result, capabilityOutput: contractOutput };
   } catch (error) {
     const reason = error instanceof Error ? error.message : String(error);
     const blocked = {
@@ -25585,6 +25579,7 @@ function makeRunId(sessionId, suffix) {
 }
 
 // src/chat/session-store.ts
+init_kody_api_client();
 init_convex_client();
 import { anyApi as anyApi2 } from "convex/server";
 function currentEpochTurns(result) {
@@ -25612,11 +25607,12 @@ function createSessionStore(opts) {
     warn: (message) => process.stderr.write(`[kody:chat:store] ${message}
 `)
   };
-  const client = opts.client !== void 0 ? opts.client : createConvexClientFromEnv();
-  const tenantId2 = opts.tenantId ?? process.env.GITHUB_REPOSITORY ?? "";
+  const env = opts.env ?? process.env;
+  const client = opts.client !== void 0 ? opts.client : hasGitHubActionsIdentity(env) ? createKodyApiBackendClient(env) : createConvexClientFromEnv(env);
+  const tenantId2 = opts.tenantId ?? env.GITHUB_REPOSITORY ?? "";
   if (!client || !tenantId2) {
     throw new Error(
-      "Canonical Convex conversation storage is required (CONVEX_URL, KODY_SERVICE_KEY, and GITHUB_REPOSITORY)"
+      "Canonical conversation storage requires GitHub Actions identity or direct Kody backend credentials"
     );
   }
   logger.info(`conversation ${opts.sessionId}: using canonical Convex store (tenant ${tenantId2})`);
@@ -27194,6 +27190,10 @@ function ensurePackageManagerInstalled(pm, cwd) {
   return shellOut("npm", ["install", "-g", spec], cwd);
 }
 function installDeps(pm, cwd) {
+  if (!fs56.existsSync(path53.join(cwd, "package.json"))) {
+    process.stdout.write("\u2192 kody: no package.json found \u2014 skipping consumer dependency install\n");
+    return 0;
+  }
   const ensureCode = ensurePackageManagerInstalled(pm, cwd);
   if (ensureCode !== 0) return ensureCode;
   const args = {
@@ -29287,8 +29287,137 @@ init_repoWorkspace();
 import * as path58 from "path";
 import { createInterface as createInterface2 } from "readline";
 
+// src/terminal/brain-terminal-adapters.ts
+import { spawn as spawn9 } from "child_process";
+import { createHash as createHash9, randomBytes as randomBytes2 } from "crypto";
+import { mkdir, readFile, rename, writeFile as writeFile2 } from "fs/promises";
+import * as path57 from "path";
+function runTerminalCommand(command, args, input) {
+  return new Promise((resolve24, reject) => {
+    const child = spawn9(command, args, { stdio: ["pipe", "pipe", "pipe"] });
+    const stdout = [];
+    const stderr = [];
+    child.stdout.on("data", (chunk) => stdout.push(chunk));
+    child.stderr.on("data", (chunk) => stderr.push(chunk));
+    child.on("error", reject);
+    child.on("close", (code) => {
+      resolve24({
+        code: code ?? 1,
+        stdout: Buffer.concat(stdout).toString("utf8"),
+        stderr: Buffer.concat(stderr).toString("utf8")
+      });
+    });
+    if (input !== void 0) child.stdin.end(input);
+    else child.stdin.end();
+  });
+}
+function storeKey(id) {
+  return createHash9("sha256").update(id).digest("hex");
+}
+function isStoredSession(value) {
+  if (!value || typeof value !== "object") return false;
+  const session = value;
+  return session.version === 1 && typeof session.id === "string" && typeof session.sessionName === "string" && typeof session.cwd === "string" && Number.isInteger(session.generation) && Number.isInteger(session.revision) && typeof session.output === "string" && typeof session.scope?.owner === "string" && typeof session.scope?.repo === "string" && typeof session.scope?.conversationId === "string";
+}
+var FileBrainTerminalMetadataStore = class {
+  constructor(root) {
+    this.root = root;
+  }
+  root;
+  file(id) {
+    return path57.join(this.root, `${storeKey(id)}.json`);
+  }
+  async read(id) {
+    try {
+      const parsed = JSON.parse(await readFile(this.file(id), "utf8"));
+      if (!isStoredSession(parsed) || parsed.id !== id) {
+        throw new Error("stored terminal session is invalid");
+      }
+      return parsed;
+    } catch (error) {
+      if (error.code === "ENOENT") return null;
+      throw error;
+    }
+  }
+  async write(session) {
+    await mkdir(this.root, { recursive: true, mode: 448 });
+    const target = this.file(session.id);
+    const temporary = `${target}.${process.pid}.${randomBytes2(6).toString("hex")}.tmp`;
+    await writeFile2(temporary, `${JSON.stringify(session)}
+`, { mode: 384 });
+    await rename(temporary, target);
+  }
+};
+function commandError(action, result) {
+  const detail = result.stderr.trim() || result.stdout.trim() || `exit ${result.code}`;
+  return new Error(`tmux ${action} failed: ${detail.slice(0, 500)}`);
+}
+var TmuxBrainTerminalRuntime = class {
+  constructor(run = runTerminalCommand) {
+    this.run = run;
+  }
+  run;
+  async tmux(action, args, input) {
+    const result = await this.run("tmux", args, input);
+    if (result.code !== 0) throw commandError(action, result);
+    return result;
+  }
+  async start(sessionName2, cwd, cols, rows) {
+    await this.tmux("start", [
+      "new-session",
+      "-d",
+      "-s",
+      sessionName2,
+      "-x",
+      String(cols),
+      "-y",
+      String(rows),
+      "-c",
+      cwd,
+      "/bin/bash",
+      "-l"
+    ]);
+    await this.tmux("configure", ["set-option", "-t", sessionName2, "status", "off"]);
+    await this.tmux("configure", ["set-option", "-t", sessionName2, "history-limit", "50000"]);
+    await this.tmux("configure", ["set-option", "-w", "-t", sessionName2, "remain-on-exit", "on"]);
+    const inspected = await this.inspect(sessionName2);
+    if (!inspected.alive || inspected.processId === null) throw new Error("tmux terminal did not start");
+    return { processId: inspected.processId };
+  }
+  async inspect(sessionName2) {
+    const result = await this.run("tmux", ["list-panes", "-t", sessionName2, "-F", "#{pane_dead}:#{pane_pid}"]);
+    if (result.code !== 0) return { alive: false, processId: null };
+    const [dead, pid] = result.stdout.trim().split(":");
+    const processId = Number(pid);
+    return {
+      alive: dead === "0" && Number.isInteger(processId) && processId > 0,
+      processId: Number.isInteger(processId) && processId > 0 ? processId : null
+    };
+  }
+  async capture(sessionName2) {
+    const alternate = await this.run("tmux", ["display-message", "-p", "-t", sessionName2, "#{alternate_on}"]);
+    if (alternate.code !== 0) throw commandError("inspect screen", alternate);
+    const args = alternate.stdout.trim() === "1" ? ["capture-pane", "-p", "-e", "-t", sessionName2] : ["capture-pane", "-p", "-e", "-J", "-S", "-50000", "-t", sessionName2];
+    return (await this.tmux("capture", args)).stdout;
+  }
+  async input(sessionName2, data) {
+    const bufferName = `kody_${randomBytes2(8).toString("hex")}`;
+    await this.tmux("load input", ["load-buffer", "-b", bufferName, "-"], data);
+    await this.tmux("paste input", ["paste-buffer", "-d", "-b", bufferName, "-t", sessionName2]);
+  }
+  async resize(sessionName2, cols, rows) {
+    await this.tmux("resize", ["resize-window", "-t", sessionName2, "-x", String(cols), "-y", String(rows)]);
+  }
+  async stop(sessionName2) {
+    const result = await this.run("tmux", ["kill-session", "-t", sessionName2]);
+    if (result.code !== 0 && !/can't find session|no server running/i.test(result.stderr)) {
+      throw commandError("stop", result);
+    }
+  }
+};
+
 // src/terminal/brain-terminal-session.ts
-import { createHash as createHash9 } from "crypto";
+import { createHash as createHash10 } from "crypto";
 var MAX_CAPTURE_CHARS = 2e5;
 function requiredIdentifier(value, name, max = 240) {
   if (typeof value !== "string" || !value.trim() || value.length > max) {
@@ -29369,7 +29498,7 @@ function parseBrainTerminalCommand(value) {
   }
 }
 function sessionName(id) {
-  return `kody_${createHash9("sha256").update(id).digest("hex").slice(0, 32)}`;
+  return `kody_${createHash10("sha256").update(id).digest("hex").slice(0, 32)}`;
 }
 function stateEvent(session) {
   return {
@@ -29431,12 +29560,7 @@ var BrainTerminalSessionAgent = class {
       await this.persist(session);
       let started;
       try {
-        started = await this.dependencies.runtime.start(
-          session.sessionName,
-          session.cwd,
-          session.cols,
-          session.rows
-        );
+        started = await this.dependencies.runtime.start(session.sessionName, session.cwd, session.cols, session.rows);
       } catch (cause) {
         session = { ...session, state: "failed", updatedAt: this.now() };
         await this.persist(session);
@@ -29595,155 +29719,6 @@ var BrainTerminalSessionAgent = class {
   }
 };
 
-// src/terminal/brain-terminal-adapters.ts
-import { createHash as createHash10, randomBytes as randomBytes2 } from "crypto";
-import { mkdir, readFile, rename, writeFile as writeFile2 } from "fs/promises";
-import * as path57 from "path";
-import { spawn as spawn9 } from "child_process";
-function runTerminalCommand(command, args, input) {
-  return new Promise((resolve24, reject) => {
-    const child = spawn9(command, args, { stdio: ["pipe", "pipe", "pipe"] });
-    const stdout = [];
-    const stderr = [];
-    child.stdout.on("data", (chunk) => stdout.push(chunk));
-    child.stderr.on("data", (chunk) => stderr.push(chunk));
-    child.on("error", reject);
-    child.on("close", (code) => {
-      resolve24({
-        code: code ?? 1,
-        stdout: Buffer.concat(stdout).toString("utf8"),
-        stderr: Buffer.concat(stderr).toString("utf8")
-      });
-    });
-    if (input !== void 0) child.stdin.end(input);
-    else child.stdin.end();
-  });
-}
-function storeKey(id) {
-  return createHash10("sha256").update(id).digest("hex");
-}
-function isStoredSession(value) {
-  if (!value || typeof value !== "object") return false;
-  const session = value;
-  return session.version === 1 && typeof session.id === "string" && typeof session.sessionName === "string" && typeof session.cwd === "string" && Number.isInteger(session.generation) && Number.isInteger(session.revision) && typeof session.output === "string" && typeof session.scope?.owner === "string" && typeof session.scope?.repo === "string" && typeof session.scope?.conversationId === "string";
-}
-var FileBrainTerminalMetadataStore = class {
-  constructor(root) {
-    this.root = root;
-  }
-  root;
-  file(id) {
-    return path57.join(this.root, `${storeKey(id)}.json`);
-  }
-  async read(id) {
-    try {
-      const parsed = JSON.parse(await readFile(this.file(id), "utf8"));
-      if (!isStoredSession(parsed) || parsed.id !== id) {
-        throw new Error("stored terminal session is invalid");
-      }
-      return parsed;
-    } catch (error) {
-      if (error.code === "ENOENT") return null;
-      throw error;
-    }
-  }
-  async write(session) {
-    await mkdir(this.root, { recursive: true, mode: 448 });
-    const target = this.file(session.id);
-    const temporary = `${target}.${process.pid}.${randomBytes2(6).toString("hex")}.tmp`;
-    await writeFile2(temporary, `${JSON.stringify(session)}
-`, { mode: 384 });
-    await rename(temporary, target);
-  }
-};
-function commandError(action, result) {
-  const detail = result.stderr.trim() || result.stdout.trim() || `exit ${result.code}`;
-  return new Error(`tmux ${action} failed: ${detail.slice(0, 500)}`);
-}
-var TmuxBrainTerminalRuntime = class {
-  constructor(run = runTerminalCommand) {
-    this.run = run;
-  }
-  run;
-  async tmux(action, args, input) {
-    const result = await this.run("tmux", args, input);
-    if (result.code !== 0) throw commandError(action, result);
-    return result;
-  }
-  async start(sessionName2, cwd, cols, rows) {
-    await this.tmux("start", [
-      "new-session",
-      "-d",
-      "-s",
-      sessionName2,
-      "-x",
-      String(cols),
-      "-y",
-      String(rows),
-      "-c",
-      cwd,
-      "/bin/bash",
-      "-l"
-    ]);
-    await this.tmux("configure", ["set-option", "-t", sessionName2, "status", "off"]);
-    await this.tmux("configure", ["set-option", "-t", sessionName2, "history-limit", "50000"]);
-    await this.tmux("configure", ["set-option", "-w", "-t", sessionName2, "remain-on-exit", "on"]);
-    const inspected = await this.inspect(sessionName2);
-    if (!inspected.alive || inspected.processId === null) throw new Error("tmux terminal did not start");
-    return { processId: inspected.processId };
-  }
-  async inspect(sessionName2) {
-    const result = await this.run("tmux", [
-      "list-panes",
-      "-t",
-      sessionName2,
-      "-F",
-      "#{pane_dead}:#{pane_pid}"
-    ]);
-    if (result.code !== 0) return { alive: false, processId: null };
-    const [dead, pid] = result.stdout.trim().split(":");
-    const processId = Number(pid);
-    return {
-      alive: dead === "0" && Number.isInteger(processId) && processId > 0,
-      processId: Number.isInteger(processId) && processId > 0 ? processId : null
-    };
-  }
-  async capture(sessionName2) {
-    const alternate = await this.run("tmux", [
-      "display-message",
-      "-p",
-      "-t",
-      sessionName2,
-      "#{alternate_on}"
-    ]);
-    if (alternate.code !== 0) throw commandError("inspect screen", alternate);
-    const args = alternate.stdout.trim() === "1" ? ["capture-pane", "-p", "-e", "-t", sessionName2] : ["capture-pane", "-p", "-e", "-J", "-S", "-50000", "-t", sessionName2];
-    return (await this.tmux("capture", args)).stdout;
-  }
-  async input(sessionName2, data) {
-    const bufferName = `kody_${randomBytes2(8).toString("hex")}`;
-    await this.tmux("load input", ["load-buffer", "-b", bufferName, "-"], data);
-    await this.tmux("paste input", ["paste-buffer", "-d", "-b", bufferName, "-t", sessionName2]);
-  }
-  async resize(sessionName2, cols, rows) {
-    await this.tmux("resize", [
-      "resize-window",
-      "-t",
-      sessionName2,
-      "-x",
-      String(cols),
-      "-y",
-      String(rows)
-    ]);
-  }
-  async stop(sessionName2) {
-    const result = await this.run("tmux", ["kill-session", "-t", sessionName2]);
-    if (result.code !== 0 && !/can't find session|no server running/i.test(result.stderr)) {
-      throw commandError("stop", result);
-    }
-  }
-};
-
 // src/servers/brain-terminal-agent.ts
 var DEFAULT_POLL_INTERVAL_MS = 150;
 function writeEvent(output, event) {

package/dist/capabilities/run/definition.json

@@ -22,6 +22,10 @@
   "outputSchema": {
     "type": "object",
     "properties": {
+      "prUrl": {
+        "type": "string",
+        "description": "Canonical pull request URL produced by the implementation."
+      },
       "reason": {
         "type": "string"
       },

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.612",
-  "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
+  "version": "0.4.617",
+  "description": "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
+  },
   "type": "module",
   "bin": {
     "kody-engine": "dist/bin/kody.js"
@@ -57,10 +61,6 @@
   "engines": {
     "node": ">=22"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/aharonyaircohen/kody-engine.git"
-  },
   "homepage": "https://github.com/aharonyaircohen/kody-engine",
   "bugs": "https://github.com/aharonyaircohen/kody-engine/issues"
 }