@kody-ade/kody-engine 0.4.607 → 0.4.611

package/README.md

@@ -113,7 +113,7 @@ model key at runtime; user secrets are not copied into Actions. `KODY_TOKEN`
 remains an optional GitHub authentication fallback when Kody must trigger
 downstream workflows or modify `.github/workflows/*`.
 
-The consumer workflow listens on `issue_comment` for `@kody ...` dispatch and `workflow_dispatch` for manual runs, chat mode, and scheduled wakeups.
+The consumer workflow listens on `issue_comment` for `@kody ...` dispatch and `workflow_dispatch` for manual runs and chat mode. Convex owns scheduled Loop wakeups.
 
 ## Commands
 

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.607",
+      version: "0.4.611",
       description: "kody \u2014 autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
       license: "MIT",
       type: "module",
@@ -3158,6 +3158,22 @@ function createStateBackendFromEnv(env = process.env, client) {
       });
       return Array.isArray(result) ? result : [];
     },
+    async replaceLoopWakeRegistrations(tenantId2, loops, updatedAt) {
+      await transport.mutation(anyApi.loopWakes.replaceRegistrations, {
+        tenantId: requireTenant(tenantId2),
+        loops,
+        updatedAt: requireNonEmpty(updatedAt, "updatedAt")
+      });
+    },
+    async markLoopWakeExecution(tenantId2, wakeId, status, detail, updatedAt) {
+      await transport.mutation(anyApi.loopWakes.markExecution, {
+        tenantId: requireTenant(tenantId2),
+        wakeId: requireNonEmpty(wakeId, "wakeId"),
+        status,
+        detail,
+        updatedAt: requireNonEmpty(updatedAt, "updatedAt")
+      });
+    },
     async get(tenantId2, taskKey, kind) {
       const result = await transport.query(anyApi.taskState.get, {
         tenantId: requireTenant(tenantId2),
@@ -3176,6 +3192,26 @@ function createStateBackendFromEnv(env = process.env, client) {
         ...expectedUpdatedAt ? { expectedUpdatedAt } : {}
       });
     },
+    async getAgentState(tenantId2, agent) {
+      const result = await transport.query(anyApi.agentStates.get, {
+        tenantId: requireTenant(tenantId2),
+        agent: requireNonEmpty(agent, "agent")
+      });
+      return result ?? null;
+    },
+    async saveAgentState(tenantId2, state, expectedRevision) {
+      await transport.mutation(anyApi.agentStates.save, {
+        tenantId: requireTenant(tenantId2),
+        state,
+        ...expectedRevision === void 0 ? {} : { expectedRevision }
+      });
+    },
+    async resetAgentState(tenantId2, agent) {
+      await transport.mutation(anyApi.agentStates.reset, {
+        tenantId: requireTenant(tenantId2),
+        agent: requireNonEmpty(agent, "agent")
+      });
+    },
     async getRepoDoc(tenantId2, kind) {
       const result = await transport.query(anyApi.repoDocs.get, {
         tenantId: requireTenant(tenantId2),
@@ -14457,7 +14493,7 @@ function assertLoopDispatchesSucceeded(results) {
 async function dispatchLoopsWith(input) {
   const results = [];
   for (const loop of input.loops) {
-    const slot = loopDispatchSlot(loop, input.now, input.force, input.nonce());
+    const slot = input.scheduledFor ?? loopDispatchSlot(loop, input.now, input.force, input.nonce());
     if (!slot) continue;
     const reservationId = `reservation-${input.nonce()}`;
     const idempotencyKey = `${loop.id}:${slot}`;
@@ -14466,7 +14502,7 @@ async function dispatchLoopsWith(input) {
       loopId: loop.id,
       decision: {
         kind: "fire",
-        reason: input.force ? "manual Loop run requested" : "local Loop schedule is due",
+        reason: input.scheduledFor ? "Convex scheduled Loop run" : input.force ? "manual Loop run requested" : "local Loop schedule is due",
         scheduledAt: slot
       },
       leaseUntil: new Date(input.now.getTime() + LOOP_DISPATCH_LEASE_MS).toISOString(),
@@ -14586,6 +14622,19 @@ function mergeLoopDefinitions(repositoryLoops, runtimeLoops) {
   }
   return [...byId.values()].sort((left, right) => left.id.localeCompare(right.id));
 }
+async function syncLoopWakeRegistrations(backend, tenantId2, loops, updatedAt, log2) {
+  try {
+    await backend.replaceLoopWakeRegistrations(
+      tenantId2,
+      loops.filter((loop) => loop.enabled && loop.trigger.type === "schedule"),
+      updatedAt
+    );
+    return true;
+  } catch {
+    log2("\u2192 kody: Convex Loop wake registration backfill skipped; existing Loop execution continues");
+    return false;
+  }
+}
 function loopDispatchSlot(loop, now, force, nonce) {
   return force ? `manual:${now.toISOString()}:${nonce}` : dueSlot(loop, now);
 }
@@ -14643,12 +14692,25 @@ var init_dispatchLoops = __esm({
       const tenantId2 = repositoryTenant(ctx.config);
       if (!tenantId2) throw new Error("Repository identity is required for Loop dispatch");
       const now = /* @__PURE__ */ new Date();
-      const force = ctx.data.jobForce === true;
+      const scheduledFor = typeof ctx.data.scheduledFor === "string" ? ctx.data.scheduledFor.trim() : "";
+      const force = ctx.data.jobForce === true && !scheduledFor;
       const requestedLoopId = typeof ctx.args.loop === "string" ? ctx.args.loop.trim() : "";
       const backend = createStateBackendFromEnv();
+      const wakeId = typeof ctx.data.wakeId === "string" ? ctx.data.wakeId : "";
+      if (wakeId) {
+        await backend.markLoopWakeExecution(tenantId2, wakeId, "running", "Engine started Loop", now.toISOString());
+      }
       const loops = mergeLoopDefinitions(listLoopDefinitions(ctx.cwd), await backend.listLoops(tenantId2));
+      await syncLoopWakeRegistrations(
+        backend,
+        tenantId2,
+        loops,
+        now.toISOString(),
+        (message) => process.stderr.write(`${message}
+`)
+      );
       const due = selectRunnableLoops(loops, now, {
-        force,
+        force: force || Boolean(scheduledFor),
         ...requestedLoopId ? { loopId: requestedLoopId } : {}
       });
       process.stdout.write(`\u2192 kody: Loop scheduler found ${due.length} runnable Loop(s)${force ? " (manual)" : ""}
@@ -14659,6 +14721,7 @@ var init_dispatchLoops = __esm({
         backend,
         now,
         force,
+        scheduledFor: scheduledFor || void 0,
         nonce: randomUUID,
         run: (job, parentRunId, loopId) => runJob(job, {
           cwd: ctx.cwd,
@@ -14674,6 +14737,16 @@ var init_dispatchLoops = __esm({
 `);
       }
       ctx.data.loopDispatchResults = results;
+      if (wakeId) {
+        const failed = results.find((result) => result.status === "failed" || result.status === "blocked");
+        await backend.markLoopWakeExecution(
+          tenantId2,
+          wakeId,
+          failed ? "failed" : "succeeded",
+          failed?.reason ?? "Loop completed",
+          (/* @__PURE__ */ new Date()).toISOString()
+        );
+      }
       assertLoopDispatchesSucceeded(results);
     };
   }
@@ -16442,14 +16515,105 @@ ${truncate2(issue2.body, FINDING_BODY_MAX_BYTES)}`;
   }
 });
 
-// src/scripts/kodyVariables.ts
+// src/scripts/loadLiveAgent.ts
 import * as fs43 from "fs";
+function tenant(config) {
+  const [envOwner, envRepo] = (process.env.GITHUB_REPOSITORY ?? "").split("/");
+  const owner = config.github?.owner?.trim() || envOwner;
+  const repo = config.github?.repo?.trim() || envRepo;
+  if (!owner || !repo) throw new Error("Repository identity is required for live Agent execution");
+  return `${owner}/${repo}`;
+}
+function frontmatter(raw) {
+  const match = /^---\n([\s\S]*?)\n---/.exec(raw);
+  if (!match) return {};
+  const result = {};
+  for (const line of match[1].split("\n")) {
+    const at = line.indexOf(":");
+    if (at < 0) continue;
+    const key = line.slice(0, at).trim();
+    const value = line.slice(at + 1).trim();
+    result[key] = value.startsWith("[") ? value.slice(1, -1).split(",").map((entry) => entry.trim()).filter(Boolean) : value;
+  }
+  return result;
+}
+function guidanceBody(row, agent) {
+  if (typeof row.doc?.body !== "string") return null;
+  const metadata = frontmatter(row.doc.body);
+  const audience = Array.isArray(metadata.agent) ? metadata.agent : [metadata.agent ?? "*"];
+  if (!audience.includes("*") && !audience.includes(agent)) return null;
+  return row.doc.body.replace(/^---\n[\s\S]*?\n---\n?/, "").trim();
+}
+function intentBody(row) {
+  if (typeof row.doc?.body !== "string") return null;
+  return row.doc.body.replace(/^---\n[\s\S]*?\n---\n?/, "").trim() || null;
+}
+var loadLiveAgent;
+var init_loadLiveAgent = __esm({
+  "src/scripts/loadLiveAgent.ts"() {
+    "use strict";
+    init_definition_paths();
+    init_agents();
+    init_state_backend();
+    loadLiveAgent = async (ctx, profile) => {
+      const agent = String(ctx.args.agent ?? ctx.data.jobAgent ?? "").trim();
+      if (!agent) throw new Error("loadLiveAgent: agent is required");
+      const file = resolveAgentFile2(ctx.cwd, agent, agentsRoot(ctx.cwd));
+      const raw = fs43.existsSync(file) ? fs43.readFileSync(file, "utf8") : "";
+      const metadata = frontmatter(raw);
+      const assignedIntent = typeof metadata.primaryIntent === "string" ? metadata.primaryIntent : "";
+      const requestedIntent = String(ctx.args.intent ?? "").trim();
+      const intent = requestedIntent || assignedIntent;
+      if (!intent || requestedIntent && assignedIntent !== requestedIntent) {
+        throw new Error(`Live Agent '${agent}' does not have the requested primary Intent`);
+      }
+      const backend = createStateBackendFromEnv();
+      const tenantId2 = tenant(ctx.config);
+      const [stateRow, intentRow, policies, constraints, context] = await Promise.all([
+        backend.getAgentState(tenantId2, agent),
+        backend.getRepoDoc(tenantId2, `intent:${intent}`),
+        backend.listRepoDocs(tenantId2, "policy:"),
+        backend.listRepoDocs(tenantId2, "constraint:"),
+        backend.listRepoDocs(tenantId2, "context:")
+      ]);
+      if (!stateRow) throw new Error(`Live Agent '${agent}' has no AgentState`);
+      const state = stateRow.state;
+      const selectedIntentBody = intentRow ? intentBody(intentRow) : null;
+      if (!selectedIntentBody) throw new Error(`Primary Intent '${intent}' is missing`);
+      const render = (rows) => rows.map((row) => guidanceBody(row, agent)).filter(Boolean).join("\n\n") || "None assigned.";
+      ctx.data.agentIdentity = loadAgentIdentity(ctx.cwd, agent);
+      ctx.data.liveAgentIntent = selectedIntentBody;
+      ctx.data.liveAgentPolicies = render(policies);
+      ctx.data.liveAgentConstraints = render(constraints);
+      ctx.data.liveAgentContext = render(context);
+      ctx.data.liveAgentCapabilities = Array.isArray(metadata.capabilities) ? metadata.capabilities.map((slug) => `- ${slug}`).join("\n") : "None assigned.";
+      ctx.data.liveAgentSlug = agent;
+      ctx.data.liveAgentPreviousRevision = Number(state.revision ?? 0);
+      ctx.data.jobState = {
+        state: {
+          version: 1,
+          rev: Number(state.revision ?? 0),
+          cursor: String(state.cursor ?? "idle"),
+          data: state.data ?? {},
+          done: false
+        }
+      };
+      ctx.data.jobStateJson = JSON.stringify(state, null, 2);
+      ctx.data.capabilityTools = ["start_capability"];
+      ctx.data.capabilityToolMode = "lock";
+      profile.claudeCode.enableSubmitTool = true;
+    };
+  }
+});
+
+// src/scripts/kodyVariables.ts
+import * as fs44 from "fs";
 import * as path41 from "path";
 function readKodyVariables(cwd) {
   const full = path41.join(cwd, KODY_VARIABLES_REL_PATH);
   let raw;
   try {
-    raw = fs43.readFileSync(full, "utf-8");
+    raw = fs44.readFileSync(full, "utf-8");
   } catch {
     return {};
   }
@@ -16474,7 +16638,7 @@ var init_kodyVariables = __esm({
 });
 
 // src/scripts/loadQaContext.ts
-import * as fs44 from "fs";
+import * as fs45 from "fs";
 import * as path42 from "path";
 function parseSlugList(value) {
   const inner = value.startsWith("[") && value.endsWith("]") ? value.slice(1, -1) : value;
@@ -16505,17 +16669,17 @@ function readProfileAgents(raw) {
 }
 function readProfile(cwd) {
   const dir = path42.join(cwd, CONTEXT_DIR_REL_PATH);
-  if (!fs44.existsSync(dir)) return "";
+  if (!fs45.existsSync(dir)) return "";
   let entries;
   try {
-    entries = fs44.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
+    entries = fs45.readdirSync(dir).filter((f) => f.endsWith(".md")).sort();
   } catch {
     return "";
   }
   const blocks = [];
   for (const file of entries) {
     try {
-      const raw = fs44.readFileSync(path42.join(dir, file), "utf-8");
+      const raw = fs45.readFileSync(path42.join(dir, file), "utf-8");
       const { agent, body } = readProfileAgents(raw);
       if (!agent.includes(QA_AGENT) && !agent.includes(ALL_AGENTS)) continue;
       blocks.push(`## ${file}
@@ -16565,7 +16729,7 @@ var init_loadQaContext = __esm({
 
 // src/scripts/loadSimpleCapability.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import * as fs45 from "fs";
+import * as fs46 from "fs";
 import * as os6 from "os";
 import * as path43 from "path";
 function registerCapabilitySubagents(profile, toolRoot, toolFiles) {
@@ -16580,7 +16744,7 @@ function registerCapabilitySubagents(profile, toolRoot, toolFiles) {
   profile.subagentTemplates = {
     ...profile.subagentTemplates ?? {},
     ...Object.fromEntries(
-      subagentFiles.map(({ name, file }) => [name, fs45.readFileSync(path43.join(toolRoot, file), "utf-8")])
+      subagentFiles.map(({ name, file }) => [name, fs46.readFileSync(path43.join(toolRoot, file), "utf-8")])
     )
   };
   if (!profile.claudeCode.tools.includes("Agent")) {
@@ -16621,10 +16785,10 @@ function scalar(value) {
   return value;
 }
 function listFiles(root) {
-  if (!fs45.existsSync(root)) return [];
+  if (!fs46.existsSync(root)) return [];
   const files = [];
   const visit = (dir) => {
-    for (const entry of fs45.readdirSync(dir, { withFileTypes: true })) {
+    for (const entry of fs46.readdirSync(dir, { withFileTypes: true })) {
       const absolute = path43.join(dir, entry.name);
       if (entry.isSymbolicLink()) continue;
       if (entry.isDirectory()) visit(absolute);
@@ -16716,7 +16880,7 @@ var init_loadSimpleCapability = __esm({
           ...skillFiles.flatMap((file) => [
             `### ${file}`,
             "",
-            fs45.readFileSync(path43.join(skillRoot, file), "utf-8"),
+            fs46.readFileSync(path43.join(skillRoot, file), "utf-8"),
             ""
           ])
         ] : [],
@@ -16756,7 +16920,7 @@ var init_loadSimpleCapability = __esm({
 });
 
 // src/taskContext.ts
-import * as fs46 from "fs";
+import * as fs47 from "fs";
 import * as path44 from "path";
 function buildTaskContext(args) {
   return {
@@ -16773,9 +16937,9 @@ function buildTaskContext(args) {
 function persistTaskContext(cwd, ctx) {
   try {
     const dir = runtimeStatePath(cwd, "agent-runs", ctx.runId);
-    fs46.mkdirSync(dir, { recursive: true });
+    fs47.mkdirSync(dir, { recursive: true });
     const file = path44.join(dir, "task-context.json");
-    fs46.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
+    fs47.writeFileSync(file, `${JSON.stringify(ctx, null, 2)}
 `);
     return file;
   } catch (err) {
@@ -17696,7 +17860,7 @@ var init_parseReproOutput = __esm({
 });
 
 // src/scripts/parseSimpleCapabilityOutput.ts
-import * as fs47 from "fs";
+import * as fs48 from "fs";
 function acceptAuthoritativeCapabilityOutput(ctx, profile, output) {
   ctx.data.agentDone = true;
   delete ctx.data.agentFailureReason;
@@ -17713,11 +17877,11 @@ function stringList2(value) {
   return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
 }
 function readOutputFile(outputPath) {
-  if (!outputPath || !fs47.existsSync(outputPath)) return { found: false };
+  if (!outputPath || !fs48.existsSync(outputPath)) return { found: false };
   try {
-    return { found: true, value: JSON.parse(fs47.readFileSync(outputPath, "utf-8")) };
+    return { found: true, value: JSON.parse(fs48.readFileSync(outputPath, "utf-8")) };
   } finally {
-    fs47.rmSync(outputPath, { force: true });
+    fs48.rmSync(outputPath, { force: true });
   }
 }
 function parseOutput(text2) {
@@ -18339,7 +18503,7 @@ var init_postResearchComment = __esm({
 });
 
 // src/scripts/prepareBrowserAuth.ts
-import * as fs48 from "fs";
+import * as fs49 from "fs";
 import * as os7 from "os";
 import * as path45 from "path";
 function appendAuthMessage(ctx, message) {
@@ -18385,8 +18549,8 @@ async function githubJson(url, token, checkName) {
   throw new Error(`GitHub ${checkName} check failed`);
 }
 function writeKodyStorageState(input) {
-  const directory = fs48.mkdtempSync(path45.join(os7.tmpdir(), "kody-browser-auth-"));
-  fs48.chmodSync(directory, 448);
+  const directory = fs49.mkdtempSync(path45.join(os7.tmpdir(), "kody-browser-auth-"));
+  fs49.chmodSync(directory, 448);
   const file = path45.join(directory, "storage-state.json");
   const now = Date.now();
   const repoEntry = {
@@ -18418,7 +18582,7 @@ function writeKodyStorageState(input) {
       }
     ]
   };
-  fs48.writeFileSync(file, JSON.stringify(storageState), { mode: 384 });
+  fs49.writeFileSync(file, JSON.stringify(storageState), { mode: 384 });
   return { directory, file, auth };
 }
 function parseSetCookie(value, hostname) {
@@ -18448,10 +18612,10 @@ function parseSetCookie(value, hostname) {
 }
 function writeCookieStorageState(targetUrl, setCookies) {
   const target = new URL(targetUrl);
-  const directory = fs48.mkdtempSync(path45.join(os7.tmpdir(), "kody-browser-auth-"));
-  fs48.chmodSync(directory, 448);
+  const directory = fs49.mkdtempSync(path45.join(os7.tmpdir(), "kody-browser-auth-"));
+  fs49.chmodSync(directory, 448);
   const file = path45.join(directory, "storage-state.json");
-  fs48.writeFileSync(
+  fs49.writeFileSync(
     file,
     JSON.stringify({
       cookies: setCookies.map((cookie) => parseSetCookie(cookie, target.hostname)),
@@ -18472,9 +18636,9 @@ function currentStorageStatePath(args) {
 function browserSessionCookieHeader(profile, targetUrl) {
   const playwright = profile.claudeCode.mcpServers.find((server) => server.name === "playwright");
   const storagePath = currentStorageStatePath(playwright?.args ?? []);
-  if (!storagePath || !fs48.existsSync(storagePath)) return void 0;
+  if (!storagePath || !fs49.existsSync(storagePath)) return void 0;
   const hostname = new URL(targetUrl).hostname;
-  const state = JSON.parse(fs48.readFileSync(storagePath, "utf-8"));
+  const state = JSON.parse(fs49.readFileSync(storagePath, "utf-8"));
   const cookies = (state.cookies ?? []).filter((cookie) => {
     const domain = cookie.domain.replace(/^\./, "");
     return hostname === domain || hostname.endsWith(`.${domain}`);
@@ -18541,9 +18705,9 @@ async function prepareAccountModelSettings(ctx, profile, input) {
   return true;
 }
 function mergeStorageStates(existingPath, nextPath) {
-  if (existingPath === nextPath || !fs48.existsSync(existingPath)) return;
-  const existing = JSON.parse(fs48.readFileSync(existingPath, "utf-8"));
-  const next = JSON.parse(fs48.readFileSync(nextPath, "utf-8"));
+  if (existingPath === nextPath || !fs49.existsSync(existingPath)) return;
+  const existing = JSON.parse(fs49.readFileSync(existingPath, "utf-8"));
+  const next = JSON.parse(fs49.readFileSync(nextPath, "utf-8"));
   const cookies = /* @__PURE__ */ new Map();
   for (const cookie of [...existing.cookies ?? [], ...next.cookies ?? []]) {
     cookies.set(`${cookie.name}\0${cookie.domain}\0${cookie.path}`, cookie);
@@ -18557,7 +18721,7 @@ function mergeStorageStates(existingPath, nextPath) {
     }
     origins.set(entry.origin, { origin: entry.origin, localStorage: [...localStorage.values()] });
   }
-  fs48.writeFileSync(
+  fs49.writeFileSync(
     nextPath,
     JSON.stringify({ cookies: [...cookies.values()], origins: [...origins.values()] }),
     { mode: 384 }
@@ -18654,7 +18818,7 @@ async function prepareKodyRepositoryBrowserAuth(ctx, profile, input) {
     configurePlaywright(profile, state.file);
     const authDirectory = state.directory;
     registerRuntimeCleanup(ctx, () => {
-      fs48.rmSync(authDirectory, { recursive: true, force: true });
+      fs49.rmSync(authDirectory, { recursive: true, force: true });
     });
     appendAuthMessage(
       ctx,
@@ -18662,7 +18826,7 @@ async function prepareKodyRepositoryBrowserAuth(ctx, profile, input) {
     );
     return true;
   } catch (error) {
-    if (state) fs48.rmSync(state.directory, { recursive: true, force: true });
+    if (state) fs49.rmSync(state.directory, { recursive: true, force: true });
     const reason = error instanceof Error ? error.message : String(error);
     appendAuthMessage(
       ctx,
@@ -18689,11 +18853,11 @@ async function prepareEmailPasswordBrowserAuth(ctx, profile, input) {
     state = writeCookieStorageState(input.targetUrl, cookies);
     configurePlaywright(profile, state.file);
     const authDirectory = state.directory;
-    registerRuntimeCleanup(ctx, () => fs48.rmSync(authDirectory, { recursive: true, force: true }));
+    registerRuntimeCleanup(ctx, () => fs49.rmSync(authDirectory, { recursive: true, force: true }));
     ctx.data.qaAuthBlock = "Auth: the app is already signed in through an engine-provided browser session. The login credentials are not available to you; never request, reveal, or report them.";
     return true;
   } catch (error) {
-    if (state) fs48.rmSync(state.directory, { recursive: true, force: true });
+    if (state) fs49.rmSync(state.directory, { recursive: true, force: true });
     const reason = error instanceof Error ? error.message : String(error);
     ctx.data.qaAuthBlock = `Auth: the engine could not prepare the app login (${reason}). Note this authenticated surface as a gap.`;
     return false;
@@ -20607,7 +20771,7 @@ var init_tickShellRunner = __esm({
 });
 
 // src/scripts/runScheduledImplementationTick.ts
-import * as fs49 from "fs";
+import * as fs50 from "fs";
 import * as path48 from "path";
 var runScheduledImplementationTick;
 var init_runScheduledImplementationTick = __esm({
@@ -20636,7 +20800,7 @@ var init_runScheduledImplementationTick = __esm({
         return;
       }
       const shellPath = path48.join(profile.dir, shell);
-      if (!fs49.existsSync(shellPath)) {
+      if (!fs50.existsSync(shellPath)) {
         ctx.output.exitCode = 99;
         ctx.output.reason = `runScheduledImplementationTick: shell not found: ${shell} (looked in ${profile.dir})`;
         return;
@@ -20668,13 +20832,13 @@ var init_runScheduledImplementationTick = __esm({
 
 // src/scripts/runSimpleCapabilityScript.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import * as fs50 from "fs";
+import * as fs51 from "fs";
 function formatDuration2(timeoutMs) {
   return timeoutMs % 6e4 === 0 ? `${timeoutMs / 6e4} minutes` : `${timeoutMs}ms`;
 }
 function isRegularFile2(filePath) {
   try {
-    const stat = fs50.lstatSync(filePath);
+    const stat = fs51.lstatSync(filePath);
     return stat.isFile() && !stat.isSymbolicLink();
   } catch {
     return false;
@@ -20753,7 +20917,7 @@ var init_runSimpleCapabilityScript = __esm({
 });
 
 // src/scripts/runTickScript.ts
-import * as fs51 from "fs";
+import * as fs52 from "fs";
 import * as path49 from "path";
 var runTickScript;
 var init_runTickScript = __esm({
@@ -20787,7 +20951,7 @@ var init_runTickScript = __esm({
         return;
       }
       const scriptPath = path49.isAbsolute(tickScript) ? tickScript : path49.join(ctx.cwd, tickScript);
-      if (!fs51.existsSync(scriptPath)) {
+      if (!fs52.existsSync(scriptPath)) {
         ctx.output.exitCode = 99;
         ctx.output.reason = `runTickScript: tickScript not found: ${scriptPath}`;
         return;
@@ -20835,6 +20999,41 @@ var init_saveManagedGoalState = __esm({
   }
 });
 
+// src/scripts/saveLiveAgentState.ts
+var saveLiveAgentState;
+var init_saveLiveAgentState = __esm({
+  "src/scripts/saveLiveAgentState.ts"() {
+    "use strict";
+    init_state_backend();
+    saveLiveAgentState = async (ctx, _profile, agentResult) => {
+      const agent = String(ctx.data.liveAgentSlug ?? "");
+      const previousRevision = Number(ctx.data.liveAgentPreviousRevision ?? 0);
+      const next = ctx.data.nextJobState;
+      if (!agent || !next || typeof next.cursor !== "string" || !next.cursor) {
+        throw new Error(String(ctx.data.nextStateParseError ?? "Live Agent did not submit valid continuation state"));
+      }
+      const [envOwner, envRepo] = (process.env.GITHUB_REPOSITORY ?? "").split("/");
+      const owner = ctx.config.github?.owner?.trim() || envOwner;
+      const repo = ctx.config.github?.repo?.trim() || envRepo;
+      if (!owner || !repo) throw new Error("Repository identity is required for live Agent state");
+      const summary = (agentResult?.finalText ?? "").trim().slice(0, 1e3);
+      await createStateBackendFromEnv().saveAgentState(
+        `${owner}/${repo}`,
+        {
+          version: 1,
+          agent,
+          revision: previousRevision + 1,
+          cursor: next.cursor,
+          summary,
+          data: next.data && typeof next.data === "object" ? next.data : {},
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+        },
+        previousRevision
+      );
+    };
+  }
+});
+
 // src/scripts/setCommentTarget.ts
 var setCommentTarget;
 var init_setCommentTarget = __esm({
@@ -21952,7 +22151,7 @@ var init_warmupMcp = __esm({
 });
 
 // src/scripts/writeAgentRunSummary.ts
-import * as fs52 from "fs";
+import * as fs53 from "fs";
 var writeAgentRunSummary;
 var init_writeAgentRunSummary = __esm({
   "src/scripts/writeAgentRunSummary.ts"() {
@@ -21978,7 +22177,7 @@ var init_writeAgentRunSummary = __esm({
       if (reason) lines.push(`- **Reason:** ${reason}`);
       lines.push("");
       try {
-        fs52.appendFileSync(summaryPath, `${lines.join("\n")}
+        fs53.appendFileSync(summaryPath, `${lines.join("\n")}
 `);
       } catch {
       }
@@ -22135,6 +22334,7 @@ var init_scripts = __esm({
     init_loadIssueStateComment();
     init_loadJobFromFile();
     init_loadLinkedFinding();
+    init_loadLiveAgent();
     init_loadMemoryContext();
     init_loadPriorArt();
     init_loadQaContext();
@@ -22183,6 +22383,7 @@ var init_scripts = __esm({
     init_runSimpleCapabilityScript();
     init_runTickScript();
     init_saveManagedGoalState();
+    init_saveLiveAgentState();
     init_saveTaskState();
     init_setCommentTarget();
     init_setLifecycleLabel();
@@ -22222,6 +22423,7 @@ var init_scripts = __esm({
       loadConventions,
       loadCoverageRules,
       loadLinkedFinding,
+      loadLiveAgent,
       loadMemoryContext,
       loadPriorArt,
       loadQaContext,
@@ -22257,6 +22459,7 @@ var init_scripts = __esm({
       saveManagedGoalState
     };
     postflightScripts = {
+      saveLiveAgentState,
       parseSimpleCapabilityOutput,
       parseAgentResult: parseAgentResult2,
       parseIssueStateFromAgentResult,
@@ -22316,7 +22519,7 @@ var init_scripts = __esm({
 });
 
 // src/stateWorkspace.ts
-import * as fs53 from "fs";
+import * as fs54 from "fs";
 import * as path51 from "path";
 function tenantId(config) {
   const owner = config.github?.owner?.trim() || process.env.GITHUB_REPOSITORY?.split("/")[0]?.trim();
@@ -22325,8 +22528,8 @@ function tenantId(config) {
 }
 function writeRuntimeFile(cwd, relativePath, content) {
   const target = path51.join(cwd, RUNTIME_ROOT, relativePath);
-  fs53.mkdirSync(path51.dirname(target), { recursive: true });
-  fs53.writeFileSync(target, content, "utf8");
+  fs54.mkdirSync(path51.dirname(target), { recursive: true });
+  fs54.writeFileSync(target, content, "utf8");
 }
 function record(value) {
   return value && typeof value === "object" && !Array.isArray(value) ? value : null;
@@ -22347,8 +22550,8 @@ function memoryIndex(docs) {
   if (lines.length === 0) return "";
   return ["# Kody memory index", "", "One line per backend memory document.", "", ...lines, ""].join("\n");
 }
-async function hydratePrefix(backend, tenant, cwd, prefix) {
-  const docs = await backend.listRepoDocs(tenant, prefix);
+async function hydratePrefix(backend, tenant2, cwd, prefix) {
+  const docs = await backend.listRepoDocs(tenant2, prefix);
   for (const doc of docs) {
     const slug = doc.kind.slice(prefix.length);
     if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(slug)) continue;
@@ -22361,8 +22564,8 @@ async function hydratePrefix(backend, tenant, cwd, prefix) {
     if (index) writeRuntimeFile(cwd, "memory/INDEX.md", index);
   }
 }
-async function hydrateSingleton(backend, tenant, cwd, kind, relativePath) {
-  const doc = await backend.getRepoDoc(tenant, kind);
+async function hydrateSingleton(backend, tenant2, cwd, kind, relativePath) {
+  const doc = await backend.getRepoDoc(tenant2, kind);
   if (!doc) return;
   const body = stringField6(doc.doc, "body");
   if (body !== null) {
@@ -22372,8 +22575,8 @@ async function hydrateSingleton(backend, tenant, cwd, kind, relativePath) {
   writeRuntimeFile(cwd, relativePath, `${JSON.stringify(doc.doc, null, 2)}
 `);
 }
-async function hydrateWorkflows(backend, tenant, cwd) {
-  for (const workflow of await backend.listWorkflows(tenant)) {
+async function hydrateWorkflows(backend, tenant2, cwd) {
+  for (const workflow of await backend.listWorkflows(tenant2)) {
     if (!/^[a-z0-9][a-z0-9_-]{0,79}$/.test(workflow.workflowId)) continue;
     writeRuntimeFile(
       cwd,
@@ -22384,25 +22587,25 @@ async function hydrateWorkflows(backend, tenant, cwd) {
   }
 }
 async function hydrateStateWorkspace(config, cwd, backendOverride) {
-  const tenant = tenantId(config);
+  const tenant2 = tenantId(config);
   const configured = hasStateBackendConfig();
-  if (!tenant || !configured) {
+  if (!tenant2 || !configured) {
     if (process.env.GITHUB_ACTIONS === "true")
       throw new Error("Kody backend access is required for runtime workspace documents");
     return;
   }
-  const key = `${path51.resolve(cwd)}|${tenant}`;
+  const key = `${path51.resolve(cwd)}|${tenant2}`;
   if (hydratedWorkspaces.has(key)) return;
   const backend = backendOverride ?? createStateBackendFromEnv();
   const root = path51.join(cwd, RUNTIME_ROOT);
-  fs53.rmSync(root, { recursive: true, force: true });
+  fs54.rmSync(root, { recursive: true, force: true });
   await Promise.all([
-    hydratePrefix(backend, tenant, cwd, "context:"),
-    hydratePrefix(backend, tenant, cwd, "memory:"),
-    hydrateSingleton(backend, tenant, cwd, "instructions", "instructions.md"),
-    hydrateSingleton(backend, tenant, cwd, "system-prompt", "system-prompt.md"),
-    hydrateSingleton(backend, tenant, cwd, "variables", "variables.json"),
-    hydrateWorkflows(backend, tenant, cwd)
+    hydratePrefix(backend, tenant2, cwd, "context:"),
+    hydratePrefix(backend, tenant2, cwd, "memory:"),
+    hydrateSingleton(backend, tenant2, cwd, "instructions", "instructions.md"),
+    hydrateSingleton(backend, tenant2, cwd, "system-prompt", "system-prompt.md"),
+    hydrateSingleton(backend, tenant2, cwd, "variables", "variables.json"),
+    hydrateWorkflows(backend, tenant2, cwd)
   ]);
   hydratedWorkspaces.add(key);
 }
@@ -22482,7 +22685,7 @@ var init_tools = __esm({
 
 // src/executor.ts
 import { spawn as spawn8 } from "child_process";
-import * as fs54 from "fs";
+import * as fs55 from "fs";
 import * as os8 from "os";
 import * as path52 from "path";
 function isMutatingPostflight(scriptName) {
@@ -23269,7 +23472,7 @@ function resolveProfilePath(profileName, cwd = process.cwd()) {
     // fallback
   ];
   for (const c of candidates) {
-    if (fs54.existsSync(c)) return c;
+    if (fs55.existsSync(c)) return c;
   }
   return candidates[0];
 }
@@ -23385,7 +23588,7 @@ function resolveShellTimeoutMs(entry) {
 async function runShellEntry(entry, ctx, profile) {
   const shellName = entry.shell;
   const shellPath = path52.join(profile.dir, shellName);
-  if (!fs54.existsSync(shellPath)) {
+  if (!fs55.existsSync(shellPath)) {
     ctx.skipAgent = true;
     ctx.output.exitCode = 99;
     ctx.output.reason = `shell script not found: ${shellName} (looked in ${profile.dir})`;
@@ -23459,9 +23662,9 @@ async function runShellEntry(entry, ctx, profile) {
   }
   let sideChannelText = "";
   try {
-    if (fs54.existsSync(outputFile)) {
-      sideChannelText = fs54.readFileSync(outputFile, "utf-8");
-      fs54.rmSync(outputFile, { force: true });
+    if (fs55.existsSync(outputFile)) {
+      sideChannelText = fs55.readFileSync(outputFile, "utf-8");
+      fs55.rmSync(outputFile, { force: true });
     }
   } catch {
   }
@@ -26194,7 +26397,7 @@ async function hydrateDefinitionsFromEnv(cwd = process.cwd(), env = process.env)
 
 // src/kody-cli.ts
 import { execFileSync as execFileSync24 } from "child_process";
-import * as fs55 from "fs";
+import * as fs56 from "fs";
 import * as path53 from "path";
 
 // src/app-auth.ts
@@ -26242,26 +26445,6 @@ async function ghApp(jwt, apiPath, method = "GET") {
   }
   return await res.json();
 }
-async function ghAppPage(authToken, apiPath) {
-  const res = await fetch(`${GH_API}${apiPath}`, {
-    headers: {
-      Authorization: `Bearer ${authToken}`,
-      Accept: "application/vnd.github+json",
-      "X-GitHub-Api-Version": "2022-11-28",
-      "User-Agent": "kody-engine"
-    }
-  });
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(
-      `GitHub App API GET ${apiPath} \u2192 ${res.status} ${res.statusText}${body ? `: ${body.slice(0, 200)}` : ""}`
-    );
-  }
-  return {
-    data: await res.json(),
-    hasNext: /rel="next"/.test(res.headers.get("link") ?? "")
-  };
-}
 function readAppCreds(env = process.env) {
   const appId = env.KODY_APP_ID?.trim();
   const privateKey = env.KODY_APP_PRIVATE_KEY;
@@ -26286,36 +26469,6 @@ async function mintAppInstallationToken(creds) {
   const tok = await ghApp(jwt, `/app/installations/${installationId}/access_tokens`, "POST");
   return tok.token;
 }
-async function discoverAppRepositories(creds) {
-  const jwt = buildAppJwt(creds.appId, creds.privateKey);
-  const installations = [];
-  for (let page = 1; ; page++) {
-    const result = await ghAppPage(jwt, `/app/installations?per_page=100&page=${page}`);
-    installations.push(...result.data.filter((item) => Number.isInteger(item.id) && item.id > 0));
-    if (!result.hasNext) break;
-  }
-  const byRepo = /* @__PURE__ */ new Map();
-  for (const installation of installations) {
-    const token = await mintAppInstallationToken({
-      appId: creds.appId,
-      privateKey: creds.privateKey,
-      installationId: String(installation.id)
-    });
-    for (let page = 1; ; page++) {
-      const result = await ghAppPage(
-        token,
-        `/installation/repositories?per_page=100&page=${page}`
-      );
-      for (const repository of result.data.repositories ?? []) {
-        const repo = repository.full_name?.trim();
-        if (!repo || !/^[^/\s]+\/[^/\s]+$/.test(repo)) continue;
-        byRepo.set(repo.toLowerCase(), { repo, token });
-      }
-      if (!result.hasNext) break;
-    }
-  }
-  return [...byRepo.values()].sort((left, right) => left.repo.localeCompare(right.repo));
-}
 
 // src/kody-cli.ts
 init_capabilityFolders();
@@ -26891,7 +27044,8 @@ function routeRunRequest(request) {
     return {
       kind: "action",
       action: "loop-scheduler",
-      cliArgs: { loop: target.id }
+      cliArgs: { loop: target.id },
+      ...typeof request.input?.scheduledFor === "string" ? { scheduledFor: request.input.scheduledFor } : {}
     };
   }
   if (target.type === "workflow") {
@@ -26997,9 +27151,9 @@ async function resolveAuthToken(env = process.env) {
   return void 0;
 }
 function detectPackageManager2(cwd) {
-  if (fs55.existsSync(path53.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs55.existsSync(path53.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs55.existsSync(path53.join(cwd, "bun.lockb"))) return "bun";
+  if (fs56.existsSync(path53.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (fs56.existsSync(path53.join(cwd, "yarn.lock"))) return "yarn";
+  if (fs56.existsSync(path53.join(cwd, "bun.lockb"))) return "bun";
   return "npm";
 }
 function shouldChainScheduledWatch(match) {
@@ -27102,8 +27256,8 @@ function postFailureTail(issueNumber, cwd, reason) {
   const logPath = lastRunLogPath(cwd);
   let tail = "";
   try {
-    if (fs55.existsSync(logPath)) {
-      const content = fs55.readFileSync(logPath, "utf-8");
+    if (fs56.existsSync(logPath)) {
+      const content = fs56.readFileSync(logPath, "utf-8");
       tail = content.slice(-3e3);
     }
   } catch {
@@ -27159,6 +27313,8 @@ async function runCi(argv) {
   let forceRunAction = null;
   let forceRunCliArgs = {};
   let forceWorkflowRunId;
+  let forceRunScheduledFor;
+  let forceRunWakeId;
   let forceRunTargetKind = "action";
   let runRequestFanOut = false;
   let runRequestFanOutForce = false;
@@ -27183,6 +27339,8 @@ async function runCi(argv) {
       forceRunAction = route.action;
       forceRunCliArgs = route.cliArgs;
       forceWorkflowRunId = route.workflowRunId;
+      forceRunScheduledFor = route.scheduledFor;
+      if (route.scheduledFor) forceRunWakeId = parsedRunRequest.request.requestId;
     } else if (route.kind === "workflow") {
       forceRunAction = route.workflow;
       forceRunTargetKind = "workflow";
@@ -27198,9 +27356,9 @@ async function runCi(argv) {
       forceRunCliArgs = { goal: envForceMessage };
     }
   }
-  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs55.existsSync(dispatchEventPath)) {
+  if (!args.issueNumber && !autoFallback && !forceRunAction && !runRequestFanOut && eventName === "workflow_dispatch" && dispatchEventPath && fs56.existsSync(dispatchEventPath)) {
     try {
-      const evt = JSON.parse(fs55.readFileSync(dispatchEventPath, "utf-8"));
+      const evt = JSON.parse(fs56.readFileSync(dispatchEventPath, "utf-8"));
       const inputs = objectValue2(evt.inputs);
       const issueInput = parseInt(String(inputs?.issue_number ?? ""), 10);
       const sessionInput = String(inputs?.sessionId ?? "");
@@ -27326,7 +27484,8 @@ async function runCi(argv) {
         cwd,
         config,
         verbose: args.verbose,
-        quiet: args.quiet
+        quiet: args.quiet,
+        ...forceRunScheduledFor ? { preloadedData: { scheduledFor: forceRunScheduledFor, wakeId: forceRunWakeId } } : {}
       }
     );
     const ec = result.exitCode;
@@ -27615,7 +27774,7 @@ init_repoWorkspace();
 
 // src/scripts/brainTurnLog.ts
 init_runtimePaths();
-import * as fs56 from "fs";
+import * as fs57 from "fs";
 import * as path54 from "path";
 import posixPath4 from "path/posix";
 var live = /* @__PURE__ */ new Map();
@@ -27624,8 +27783,8 @@ function brainEventsFilePath(dir, chatId) {
 }
 function lastPersistedSeq(dir, chatId) {
   const p = brainEventsFilePath(dir, chatId);
-  if (!fs56.existsSync(p)) return 0;
-  const lines = fs56.readFileSync(p, "utf-8").split("\n").filter(Boolean);
+  if (!fs57.existsSync(p)) return 0;
+  const lines = fs57.readFileSync(p, "utf-8").split("\n").filter(Boolean);
   if (lines.length === 0) return 0;
   try {
     return JSON.parse(lines[lines.length - 1]).seq || 0;
@@ -27635,9 +27794,9 @@ function lastPersistedSeq(dir, chatId) {
 }
 function readSince(dir, chatId, since) {
   const p = brainEventsFilePath(dir, chatId);
-  if (!fs56.existsSync(p)) return [];
+  if (!fs57.existsSync(p)) return [];
   const out = [];
-  for (const line of fs56.readFileSync(p, "utf-8").split("\n")) {
+  for (const line of fs57.readFileSync(p, "utf-8").split("\n")) {
     if (!line) continue;
     try {
       const rec = JSON.parse(line);
@@ -27663,12 +27822,12 @@ function beginTurn(dir, chatId) {
   };
   live.set(chatId, state);
   const p = brainEventsFilePath(dir, chatId);
-  fs56.mkdirSync(path54.dirname(p), { recursive: true });
+  fs57.mkdirSync(path54.dirname(p), { recursive: true });
   return (event) => {
     state.seq += 1;
     const rec = { seq: state.seq, turn, ts: Date.now(), event };
     try {
-      fs56.appendFileSync(p, `${JSON.stringify(rec)}
+      fs57.appendFileSync(p, `${JSON.stringify(rec)}
 `);
     } catch (err) {
       process.stderr.write(
@@ -27707,7 +27866,7 @@ function endTurnIfUnterminated(dir, chatId, errMessage) {
     event: { type: "error", error: errMessage || "turn ended unexpectedly", chatId }
   };
   try {
-    fs56.appendFileSync(brainEventsFilePath(dir, chatId), `${JSON.stringify(rec)}
+    fs57.appendFileSync(brainEventsFilePath(dir, chatId), `${JSON.stringify(rec)}
 `);
   } catch {
   }
@@ -29694,55 +29853,6 @@ async function brainTerminalAgent(options) {
 
 // src/servers/pool-serve.ts
 import { createServer as createServer5 } from "http";
-
-// src/pool/agency-loop-tick.ts
-function normalizeRepositories(repositories) {
-  const unique = /* @__PURE__ */ new Set();
-  for (const raw of repositories) {
-    const repo = raw.trim().toLowerCase();
-    if (/^[^/\s]+\/[^/\s]+$/.test(repo)) unique.add(repo);
-  }
-  return [...unique].sort();
-}
-async function runAgencyLoopTick(deps) {
-  const repositories = normalizeRepositories(await deps.discover());
-  if (repositories.length === 0) {
-    deps.log("no consumer agencies discovered \u2014 nothing to tick");
-    return { discovered: 0, claimed: 0 };
-  }
-  deps.log(
-    `running scheduled fan-out for ${repositories.length} consumer agenc${repositories.length === 1 ? "y" : "ies"}`
-  );
-  const clock = deps.now ?? Date.now;
-  let claimed = 0;
-  for (const repository of repositories) {
-    const [owner, repo] = repository.split("/");
-    try {
-      const jobId = `sched-${owner}-${repo}-${clock()}`;
-      const result = await deps.claim(owner, repo, {
-        jobId,
-        repo: repository,
-        runRequest: {
-          requestId: jobId,
-          target: { type: "workflow", id: "scheduled-fanout" },
-          intent: "tick",
-          source: "schedule"
-        }
-      });
-      if (result.ok) {
-        claimed++;
-        deps.log(`[${repository}] scheduled fan-out claimed ${result.machineId}`);
-      } else {
-        deps.log(`[${repository}] scheduled fan-out skipped: ${result.reason ?? "runner unavailable"}`);
-      }
-    } catch (error) {
-      deps.log(`[${repository}] scheduled fan-out error: ${error instanceof Error ? error.message : String(error)}`);
-    }
-  }
-  return { discovered: repositories.length, claimed };
-}
-
-// src/servers/pool-serve.ts
 init_keys();
 
 // src/pool/registry.ts
@@ -30378,30 +30488,6 @@ async function poolServe() {
   const tick = setInterval(() => {
     registry.resyncAll().catch((err) => log(`resync tick failed: ${err instanceof Error ? err.message : String(err)}`));
   }, refillMs);
-  const discoverAgencies = async () => {
-    if (!appCreds) return registry.activeRepos();
-    const repositories = await discoverAppRepositories(appCreds);
-    for (const access of repositories) repoTokens.set(access.repo.toLowerCase(), access.token);
-    return [.../* @__PURE__ */ new Set([...repositories.map((access) => access.repo), ...registry.activeRepos()])];
-  };
-  let agencyTickInFlight = null;
-  const runLoopTick = () => {
-    if (agencyTickInFlight) return agencyTickInFlight;
-    agencyTickInFlight = runAgencyLoopTick({
-      discover: discoverAgencies,
-      claim: (owner, repo, req) => registry.claim(owner, repo, req),
-      log
-    }).catch((err) => log(`agency Loop tick failed: ${err instanceof Error ? err.message : String(err)}`)).finally(() => {
-      agencyTickInFlight = null;
-    });
-    return agencyTickInFlight;
-  };
-  const loopTickEnabled = (process.env.POOL_LOOP_TICK ?? process.env.POOL_CAPABILITY_TICK ?? "1") !== "0";
-  const loopTickMs = envInt2(
-    process.env.POOL_LOOP_TICK_MS ? "POOL_LOOP_TICK_MS" : "POOL_CAPABILITY_TICK_MS",
-    15 * 6e4
-  );
-  const loopTick = loopTickEnabled ? setInterval(() => void runLoopTick(), loopTickMs) : null;
   const server = createServer5(async (req, res) => {
     try {
       if (!req.method || !req.url) return sendJson2(res, 400, { error: "bad request" });
@@ -30455,11 +30541,9 @@ async function poolServe() {
       resolve24();
     });
   });
-  if (loopTickEnabled) void runLoopTick();
   const shutdown = (signal) => {
     log(`${signal} \u2014 shutting down`);
     clearInterval(tick);
-    if (loopTick) clearInterval(loopTick);
     server.close(() => process.exit(0));
   };
   process.once("SIGINT", () => shutdown("SIGINT"));
@@ -30471,7 +30555,7 @@ async function poolServe() {
 
 // src/servers/runner-serve.ts
 import { spawn as spawn10 } from "child_process";
-import * as fs57 from "fs";
+import * as fs58 from "fs";
 import { createServer as createServer6 } from "http";
 var DEFAULT_PORT2 = 8080;
 var DEFAULT_WORKDIR = "/workspace/repo";
@@ -30547,8 +30631,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`;
-  fs57.rmSync(workdir, { recursive: true, force: true });
-  fs57.mkdirSync(workdir, { recursive: true });
+  fs58.rmSync(workdir, { recursive: true, force: true });
+  fs58.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";
@@ -31136,7 +31220,7 @@ async function main(argv = process.argv.slice(2)) {
   const args = parseArgs(argv);
   const cwdFlag = argv.indexOf("--cwd");
   const definitionCwd = cwdFlag >= 0 && argv[cwdFlag + 1] ? argv[cwdFlag + 1] : process.cwd();
-  const shouldHydrate = !(args.command === "server" && args.serverName === "brain-serve") && !hasExplicitDefinitionsRoot(definitionCwd) && (Boolean(process.env.CONVEX_URL?.trim()) || process.env.GITHUB_ACTIONS === "true" && Boolean(process.env.GITHUB_EVENT_NAME));
+  const shouldHydrate = args.command !== "help" && args.command !== "version" && !(args.command === "server" && args.serverName === "brain-serve") && !hasExplicitDefinitionsRoot(definitionCwd) && (Boolean(process.env.CONVEX_URL?.trim()) || process.env.GITHUB_ACTIONS === "true" && Boolean(process.env.GITHUB_EVENT_NAME));
   if (shouldHydrate) {
     try {
       await hydrateDefinitionsFromEnv(definitionCwd);

package/dist/capabilities/live-agent/capability.md

@@ -0,0 +1,9 @@
+# Live Agent
+
+## Purpose
+
+Run one continuation cycle for a selected persistent Agent.
+
+## Instructions
+
+Use the `live-agent` implementation to load the Agent, its assigned Intent and resources, then persist the next AgentState.

package/dist/capabilities/live-agent/definition.json

@@ -0,0 +1,32 @@
+{
+  "id": "live-agent",
+  "action": "live-agent",
+  "purpose": "Run one continuation cycle for a selected persistent Agent.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "agent": {
+        "type": "string",
+        "description": "Selected Agent slug."
+      },
+      "intent": {
+        "type": "string",
+        "description": "Primary Intent slug recorded by the Loop."
+      }
+    },
+    "required": ["agent"],
+    "additionalProperties": false
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "cursor": { "type": "string" },
+      "data": { "type": "object", "additionalProperties": true }
+    },
+    "additionalProperties": true
+  },
+  "effects": ["agent-state"],
+  "permissions": [],
+  "success": "The Agent completes one cycle and persists its continuation state.",
+  "failure": "The Agent cycle fails or its continuation state cannot be persisted."
+}

package/dist/implementations/live-agent/profile.json

@@ -0,0 +1,30 @@
+{
+  "name": "live-agent",
+  "role": "primitive",
+  "kind": "oneshot",
+  "inputs": [
+    { "name": "agent", "flag": "--agent", "type": "string", "required": true, "describe": "Live Agent slug." },
+    { "name": "intent", "flag": "--intent", "type": "string", "required": false, "describe": "Primary Intent slug recorded by the Loop." }
+  ],
+  "claudeCode": {
+    "model": "inherit",
+    "permissionMode": "default",
+    "maxTurns": 100,
+    "maxThinkingTokens": null,
+    "systemPromptAppend": null,
+    "enableSubmitTool": true,
+    "tools": ["mcp__kody-capability__start_capability", "mcp__kody-submit__submit_state"],
+    "hooks": [], "skills": [], "commands": [], "subagents": [], "plugins": [], "mcpServers": []
+  },
+  "cliTools": [],
+  "scripts": {
+    "preflight": [{ "script": "loadLiveAgent" }, { "script": "composePrompt" }],
+    "postflight": [
+      { "script": "parseJobStateFromAgentResult", "with": { "fenceLabel": "kody-agent-next-state" } },
+      { "script": "saveLiveAgentState" },
+      { "script": "appendCompanyActivity" }
+    ]
+  },
+  "inputArtifacts": [],
+  "outputArtifacts": []
+}

package/dist/implementations/live-agent/prompt.md

@@ -0,0 +1,38 @@
+You are a persistent Kody Agent completing one scheduled cycle.
+
+## Identity
+
+{{agentIdentity}}
+
+## Primary Intent
+
+{{liveAgentIntent}}
+
+## Policies
+
+{{liveAgentPolicies}}
+
+## Constraints
+
+{{liveAgentConstraints}}
+
+## Context
+
+{{liveAgentContext}}
+
+## Assigned Capabilities
+
+{{liveAgentCapabilities}}
+
+## Previous continuation
+
+```json
+{{jobStateJson}}
+```
+
+Inspect current conditions, decide the best next action toward the Intent, and use only assigned capabilities. Do not create work merely to appear active. If waiting is correct, record what is being awaited.
+
+As your final action, call `submit_state` exactly once with:
+- `cursor`: the next continuation cursor;
+- `data`: compact durable continuation data;
+- `done`: always `false` for a live Agent.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kody-ade/kody-engine",
-  "version": "0.4.607",
+  "version": "0.4.611",
   "description": "kody — autonomous development engine. Single-session Claude Code agent behind a generic executor + declarative implementation profiles.",
   "license": "MIT",
   "type": "module",
@@ -12,6 +12,30 @@
     "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",
+    "verify:live-release": "tsx scripts/live-release-gate.ts",
+    "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 && pnpm test:runtime-services && pnpm build && pnpm verify:package"
+  },
   "dependencies": {
     "@actions/cache": "^6.0.0",
     "@anthropic-ai/claude-agent-sdk": "0.2.119",
@@ -38,28 +62,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",
-    "verify:live-release": "tsx scripts/live-release-gate.ts",
-    "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"
+}

package/templates/kody.yml

@@ -50,8 +50,6 @@ on:
     types: [created]
   pull_request:
     types: [opened, synchronize, closed]
-  schedule:
-    - cron: '7/15 * * * *'
 
 jobs:
   run: