@kernlang/agon 0.1.5 → 0.1.7

package/dist/{chunk-HAJIKZGU.js → chunk-BPKY4OF2.js}

@@ -5,7 +5,7 @@ import {
   __require,
   __toCommonJS,
   apiStreamDispatchWithHistory
-} from "./chunk-SOUF7XTW.js";
+} from "./chunk-45YTXJWJ.js";
 
 // ../core/src/generated/signals/glicko.ts
 var glicko_exports = {};
@@ -387,6 +387,7 @@ var DEFAULT_AGON_CONFIG = {
   isolationMigrationNotified: false,
   terminalMode: "native",
   iconTheme: "roman",
+  narrationFold: "safe",
   autoReviewAfterForge: true,
   autoReviewAfterImpl: true,
   buddyTimeout: 420,
@@ -1108,10 +1109,61 @@ function hydrateWorktreeBuildArtifacts(repoDir, worktreePath) {
     console.warn(`[agon] worktree artifact hydration failed for ${worktreePath}: ${err instanceof Error ? err.message : String(err)}`);
   }
 }
+var activeWorktrees = (() => {
+  const g = globalThis;
+  if (!g.__agonActiveWorktrees) {
+    g.__agonActiveWorktrees = /* @__PURE__ */ new Map();
+  }
+  return g.__agonActiveWorktrees;
+})();
+function registerExitHooks() {
+  const g = globalThis;
+  if (g.__agonExitHooksRegistered) return;
+  g.__agonExitHooksRegistered = true;
+  const cleanup = () => {
+    if (activeWorktrees.size === 0) return;
+    process.stderr.write(`
+[agon] Cleaning up active git worktrees...
+`);
+    const repoDirs = new Set(activeWorktrees.values());
+    for (const [wtPath, repoDir] of activeWorktrees.entries()) {
+      try {
+        execFileSync("git", ["worktree", "remove", wtPath, "--force"], { cwd: repoDir, stdio: "ignore" });
+        activeWorktrees.delete(wtPath);
+      } catch {
+      }
+    }
+    for (const repoDir of repoDirs) {
+      try {
+        execFileSync("git", ["worktree", "prune"], { cwd: repoDir, stdio: "ignore" });
+      } catch {
+      }
+    }
+  };
+  process.on("exit", () => {
+    cleanup();
+  });
+  const handleSigInt = () => {
+    cleanup();
+    if (process.listenerCount("SIGINT") <= 1) {
+      process.exit(130);
+    }
+  };
+  const handleSigTerm = () => {
+    cleanup();
+    if (process.listenerCount("SIGTERM") <= 1) {
+      process.exit(143);
+    }
+  };
+  process.on("SIGINT", handleSigInt);
+  process.on("SIGTERM", handleSigTerm);
+}
 function worktreeCreate(repoDir, worktreePath, sha) {
+  registerExitHooks();
   worktreePrune(repoDir);
   try {
     git(["worktree", "add", "--detach", worktreePath, sha], repoDir);
+    activeWorktrees.set(worktreePath, repoDir);
     linkWorktreeNodeModules(repoDir, worktreePath);
     hydrateWorktreeBuildArtifacts(repoDir, worktreePath);
     return worktreePath;
@@ -1157,6 +1209,7 @@ function worktreeRemove(repoDir, worktreePath) {
   for (let attempt = 0; attempt < 2; attempt++) {
     try {
       git(["worktree", "remove", worktreePath, "--force"], repoDir);
+      activeWorktrees.delete(worktreePath);
       return;
     } catch (err) {
       lastErr = err;
@@ -1223,6 +1276,23 @@ function worktreePruneAll(repoDir, olderThanMs) {
   } catch {
   }
 }
+function worktreePruneOrphaned(repoDir) {
+  try {
+    const output = git(["worktree", "list", "--porcelain"], repoDir);
+    const lines = output.split("\n");
+    for (const line of lines) {
+      if (line.startsWith("worktree ")) {
+        const wtPath = line.slice(9).trim();
+        const isAgentWt = wtPath.includes(".agon/agent-worktrees") || wtPath.includes(".agon/speculate-worktrees") || wtPath.includes(".agon/runs") || wtPath.includes(".agon/goals");
+        if (isAgentWt) {
+          worktreeRemoveBestEffort(repoDir, wtPath);
+        }
+      }
+    }
+  } catch (err) {
+    console.warn(`[agon] worktreePruneOrphaned failed: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
 function worktreeChangedDiff(cwd, baseSha) {
   try {
     const trackedDiff = gitRaw(["diff", baseSha, "--"], cwd);
@@ -20018,10 +20088,10 @@ function createBashTool() {
     const readRedirect = tryRedirectToRead(command);
     if (readRedirect) {
       try {
-        const { readFileSync: readFileSync36 } = await import("fs");
+        const { readFileSync: readFileSync38 } = await import("fs");
         const { resolve: resolve28 } = await import("path");
         const filePath = resolve28(ctx.cwd, readRedirect.file);
-        const content = readFileSync36(filePath, "utf-8");
+        const content = readFileSync38(filePath, "utf-8");
         const lines = content.split("\n");
         const offset = readRedirect.offset ?? 0;
         const limit = readRedirect.limit ?? lines.length;
@@ -22065,6 +22135,8 @@ function cesarPlanMarkdownPath(planId) {
   }
   return full;
 }
+var CESAR_STEP_TYPE_TABLE = { self: true, forge: true, teamforge: true, delegate: true, brainstorm: true, campfire: true, tribunal: true, pipeline: true, review: true, agent: true, "team-agent": true };
+var CESAR_STEP_TYPES = Object.keys(CESAR_STEP_TYPE_TABLE);
 function createCesarPlan(intent, steps) {
   const id = `cplan-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
   const initializedSteps = steps.map((s) => Object.assign({}, s, { state: s.dependsOn && s.dependsOn.length > 0 ? "blocked" : "pending" }));
@@ -22080,10 +22152,11 @@ function advanceCesarStep(plan, stepId, result) {
   const stepIdx = plan.steps.findIndex((s) => s.id === stepId);
   if (stepIdx === -1) return plan;
   const isSuccess = result.status === "success";
-  const stepState = isSuccess ? "done" : "failed";
+  const isPaused = result.status === "paused";
+  const stepState = isSuccess ? "done" : isPaused ? "pending" : "failed";
   const now = (/* @__PURE__ */ new Date()).toISOString();
   let newSteps = plan.steps.map(
-    (s, i) => i === stepIdx ? { ...s, state: stepState, result, completedAt: now } : s
+    (s, i) => i === stepIdx ? { ...s, state: stepState, result: isPaused ? void 0 : result, completedAt: isPaused ? void 0 : now } : s
   );
   if (isSuccess) {
     newSteps = newSteps.map((s) => {
@@ -22723,13 +22796,16 @@ function latestChatSession() {
 }
 
 // ../core/src/generated/blocks/image.ts
-import { existsSync as existsSync19 } from "fs";
+import { existsSync as existsSync19, readFileSync as readFileSync23, statSync as statSync16 } from "fs";
 import { resolve as resolve19, basename as basename4, extname as extname2 } from "path";
 import { homedir as homedir11 } from "os";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var IMAGE_EXTENSIONS = /* @__PURE__ */ new Set([".png", ".jpg", ".jpeg", ".gif", ".webp", ".svg", ".bmp"]);
 var MIME_MAP = { ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".gif": "image/gif", ".webp": "image/webp", ".svg": "image/svg+xml", ".bmp": "image/bmp" };
 var IMG_CMD_REGEX = /^\/img\s+(.+)$/i;
+var MAX_DISPATCH_IMAGE_BYTES = 5 * 1024 * 1024;
+var MAX_DISPATCH_IMAGES = 4;
+var DISPATCH_VISION_MIME = /* @__PURE__ */ new Set(["image/png", "image/jpeg", "image/webp", "image/gif"]);
 function isImagePath(filePath) {
   const ext = extname2(filePath).toLowerCase();
   return IMAGE_EXTENSIONS.has(ext);
@@ -22816,9 +22892,55 @@ function extractImagesFromInput(input, cwd) {
   text = text.replace(/\s{2,}/g, " ").trim();
   return { text, images };
 }
+function encodeImagesRaw(paths, maxBytes, maxImages) {
+  const lim = maxBytes ?? MAX_DISPATCH_IMAGE_BYTES;
+  const cap = maxImages ?? MAX_DISPATCH_IMAGES;
+  const images = [];
+  const skipped = [];
+  const kb = (n) => `${Math.round(n / 1024)}KB`;
+  for (const p of paths) {
+    const name = basename4(p);
+    if (images.length >= cap) {
+      skipped.push(`${name} (exceeds ${cap}-image limit)`);
+      continue;
+    }
+    try {
+      if (!existsSync19(p)) {
+        skipped.push(`${name} (not found)`);
+        continue;
+      }
+      const mediaType = mimeFromExt(p);
+      if (!DISPATCH_VISION_MIME.has(mediaType)) {
+        skipped.push(`${name} (unsupported type ${mediaType})`);
+        continue;
+      }
+      const st = statSync16(p);
+      if (!st.isFile()) {
+        skipped.push(`${name} (not a regular file)`);
+        continue;
+      }
+      if (st.size > lim) {
+        skipped.push(`${name} (${kb(st.size)} over ${kb(lim)} limit)`);
+        continue;
+      }
+      const data = readFileSync23(p).toString("base64");
+      images.push({ data, mediaType });
+    } catch {
+      skipped.push(`${name} (read error)`);
+    }
+  }
+  return { images, skipped };
+}
+function encodeImagesForDispatch(paths, maxBytes, maxImages) {
+  const { images, skipped } = encodeImagesRaw(paths, maxBytes, maxImages);
+  return {
+    parts: images.map((i) => ({ type: "image", image: `data:${i.mediaType};base64,${i.data}`, mediaType: i.mediaType })),
+    skipped
+  };
+}
 
 // ../core/src/generated/rooms/store.ts
-import { mkdirSync as mkdirSync18, existsSync as existsSync20, readFileSync as readFileSync23, writeFileSync as writeFileSync19, appendFileSync as appendFileSync2, readdirSync as readdirSync14, openSync, closeSync, unlinkSync as unlinkSync9, statSync as statSync16 } from "fs";
+import { mkdirSync as mkdirSync18, existsSync as existsSync20, readFileSync as readFileSync24, writeFileSync as writeFileSync19, appendFileSync as appendFileSync2, readdirSync as readdirSync14, openSync, closeSync, unlinkSync as unlinkSync9, statSync as statSync17 } from "fs";
 import { join as join22 } from "path";
 var LOCK_TIMEOUT_MS = 2e3;
 var LOCK_STALE_MS = 5e3;
@@ -22843,7 +22965,7 @@ function roomExists(roomId) {
 }
 function readMeta(roomId) {
   try {
-    return JSON.parse(readFileSync23(metaPath(roomId), "utf-8"));
+    return JSON.parse(readFileSync24(metaPath(roomId), "utf-8"));
   } catch {
     return null;
   }
@@ -22904,7 +23026,7 @@ function withRoomLock(roomId, work) {
     } catch (err) {
       if (err?.code !== "EEXIST") throw err;
       try {
-        const st = statSync16(lock);
+        const st = statSync17(lock);
         if (Date.now() - st.mtimeMs > LOCK_STALE_MS) {
           unlinkSync9(lock);
           continue;
@@ -22960,7 +23082,7 @@ function appendEvent(roomId, input) {
 function readEvents(roomId, sinceSeq, limit) {
   let raw;
   try {
-    raw = readFileSync23(eventsPath(roomId), "utf-8");
+    raw = readFileSync24(eventsPath(roomId), "utf-8");
   } catch {
     return [];
   }
@@ -22988,7 +23110,7 @@ function isRoomClosed(roomId) {
 }
 
 // ../core/src/generated/rooms/presence.ts
-import { mkdirSync as mkdirSync19, readFileSync as readFileSync24, writeFileSync as writeFileSync20 } from "fs";
+import { mkdirSync as mkdirSync19, readFileSync as readFileSync25, writeFileSync as writeFileSync20 } from "fs";
 import { join as join23 } from "path";
 var PRESENCE_TTL_MS = 9e4;
 function presencePath(roomId) {
@@ -22996,7 +23118,7 @@ function presencePath(roomId) {
 }
 function readPresenceRaw(roomId) {
   try {
-    return JSON.parse(readFileSync24(presencePath(roomId), "utf-8"));
+    return JSON.parse(readFileSync25(presencePath(roomId), "utf-8"));
   } catch {
     return {};
   }
@@ -23039,14 +23161,14 @@ function listPresence(roomId) {
 }
 
 // ../core/src/generated/rooms/leases.ts
-import { readFileSync as readFileSync25, writeFileSync as writeFileSync21 } from "fs";
+import { readFileSync as readFileSync26, writeFileSync as writeFileSync21 } from "fs";
 import { join as join24 } from "path";
 function leasesPath(roomId) {
   return join24(roomDir(roomId), "leases.json");
 }
 function readActiveLease(roomId) {
   try {
-    const raw = JSON.parse(readFileSync25(leasesPath(roomId), "utf-8"));
+    const raw = JSON.parse(readFileSync26(leasesPath(roomId), "utf-8"));
     if (!raw || !raw.leaseId) return null;
     if (Date.now() >= new Date(raw.expiresAt).getTime()) return null;
     return raw;
@@ -23129,7 +23251,7 @@ function evaluateStop(state, config2, events) {
 }
 
 // ../core/src/generated/signals/flow.ts
-import { readFileSync as readFileSync26, writeFileSync as writeFileSync22, mkdirSync as mkdirSync20, readdirSync as readdirSync15 } from "fs";
+import { readFileSync as readFileSync27, writeFileSync as writeFileSync22, mkdirSync as mkdirSync20, readdirSync as readdirSync15 } from "fs";
 import { join as join25, resolve as resolve20 } from "path";
 import { homedir as homedir12 } from "os";
 function getFlowsDir() {
@@ -23162,7 +23284,7 @@ function readFlows(limit) {
   const records = [];
   for (const file2 of files) {
     try {
-      const data = JSON.parse(readFileSync26(join25(getFlowsDir(), file2), "utf-8"));
+      const data = JSON.parse(readFileSync27(join25(getFlowsDir(), file2), "utf-8"));
       records.push(data);
     } catch (err) {
       console.warn(`[agon] skipping malformed flow record ${file2}: ${err instanceof Error ? err.message : String(err)}`);
@@ -23591,7 +23713,7 @@ async function companionDispatch(opts) {
 }
 
 // ../core/src/generated/signals/models-registry.ts
-import { readFileSync as readFileSync27, writeFileSync as writeFileSync23, mkdirSync as mkdirSync21, existsSync as existsSync22, statSync as statSync17 } from "fs";
+import { readFileSync as readFileSync28, writeFileSync as writeFileSync23, mkdirSync as mkdirSync21, existsSync as existsSync22, statSync as statSync18 } from "fs";
 import { join as join26 } from "path";
 var CACHE_TTL_MS = 36e5;
 var MODELS_DEV_URL = "https://models.dev/api.json";
@@ -23600,10 +23722,10 @@ async function fetchModelsRegistry() {
   const cacheFile = join26(cacheDir, "models-dev.json");
   if (existsSync22(cacheFile)) {
     try {
-      const stat = statSync17(cacheFile);
+      const stat = statSync18(cacheFile);
       const age = Date.now() - stat.mtimeMs;
       if (age < CACHE_TTL_MS) {
-        return JSON.parse(readFileSync27(cacheFile, "utf-8"));
+        return JSON.parse(readFileSync28(cacheFile, "utf-8"));
       }
     } catch (_e) {
       console.warn(`[agon] models-registry: cache read failed, refetching: ${_e instanceof Error ? _e.message : String(_e)}`);
@@ -23612,7 +23734,7 @@ async function fetchModelsRegistry() {
   const response = await fetch(MODELS_DEV_URL);
   if (!response.ok) {
     if (existsSync22(cacheFile)) {
-      return JSON.parse(readFileSync27(cacheFile, "utf-8"));
+      return JSON.parse(readFileSync28(cacheFile, "utf-8"));
     }
     throw new Error(`Failed to fetch models registry: ${response.status}`);
   }
@@ -23739,7 +23861,7 @@ function modelEntryToEngineDef(entry) {
 
 // ../core/src/generated/signals/cli-models-registry.ts
 import { execSync as execSync4 } from "child_process";
-import { readFileSync as readFileSync28, writeFileSync as writeFileSync24, mkdirSync as mkdirSync22, existsSync as existsSync23, statSync as statSync18 } from "fs";
+import { readFileSync as readFileSync29, writeFileSync as writeFileSync24, mkdirSync as mkdirSync22, existsSync as existsSync23, statSync as statSync19 } from "fs";
 import { join as join27 } from "path";
 import { homedir as homedir13 } from "os";
 import { createRequire as createRequire4 } from "module";
@@ -23754,9 +23876,9 @@ function readProbedCliModels(engineId, ttlMs) {
   try {
     const file2 = probedModelsCacheFile(engineId);
     if (!existsSync23(file2)) return null;
-    const age = Date.now() - statSync18(file2).mtimeMs;
+    const age = Date.now() - statSync19(file2).mtimeMs;
     if (age > (ttlMs ?? PROBE_TTL_MS)) return null;
-    const data = JSON.parse(readFileSync28(file2, "utf-8"));
+    const data = JSON.parse(readFileSync29(file2, "utf-8"));
     const raw = Array.isArray(data?.models) ? data.models : [];
     const models = raw.map((m) => ({ id: String(m.id ?? ""), name: String(m.name ?? m.id ?? ""), current: !!m.current })).filter((m) => m.name);
     return models.length > 0 ? models : null;
@@ -23991,6 +24113,7 @@ async function discoverCliModelsAsync() {
 // ../core/src/generated/sessions/session-companion.ts
 import { spawn as spawn3 } from "child_process";
 import { createInterface as createInterface2 } from "readline";
+import { existsSync as existsSync24 } from "fs";
 function createCompanionSession(config2) {
   let proc = null;
   let alive = false;
@@ -24296,9 +24419,37 @@ ${config2.systemPrompt}
 ${message}`;
         }
         firstTurn = false;
+        const input = [{ type: "text", text: message, text_elements: [] }];
+        if (opts.images?.length) {
+          if (config2.engine.capabilities?.includes("vision")) {
+            let attached = 0;
+            const skipped = [];
+            for (const p of opts.images) {
+              if (attached >= MAX_DISPATCH_IMAGES) {
+                skipped.push(`${p} (exceeds ${MAX_DISPATCH_IMAGES}-image limit)`);
+                continue;
+              }
+              if (!existsSync24(p) || !isImagePath(p)) {
+                skipped.push(`${p} (not found or not an image)`);
+                continue;
+              }
+              if (!DISPATCH_VISION_MIME.has(mimeFromExt(p))) {
+                skipped.push(`${p} (unsupported type ${mimeFromExt(p)})`);
+                continue;
+              }
+              input.push({ type: "localImage", path: p });
+              attached++;
+            }
+            if (skipped.length) {
+              chunks.push({ type: "status", content: `image(s) not sent: ${skipped.join("; ")}` });
+            }
+          } else {
+            chunks.push({ type: "status", content: `${config2.engine.id} has no vision capability \u2014 ${opts.images.length} image(s) not sent to the model` });
+          }
+        }
         await sendRpc("turn/start", {
           threadId,
-          input: [{ type: "text", text: message, text_elements: [] }]
+          input
         });
         while (!turnDone) {
           if (chunks.length > 0) {
@@ -25031,7 +25182,41 @@ function createResumeSession(config2) {
           }
           firstTurn = false;
         }
-        messageHistory.push({ role: "user", content: opts.message });
+        const hasVision = !!config2.engine.capabilities?.includes("vision");
+        let turnImageParts = [];
+        if (opts.images?.length) {
+          if (hasVision) {
+            const enc = encodeImagesForDispatch(opts.images);
+            turnImageParts = enc.parts;
+            if (enc.skipped.length) {
+              yield { type: "status", content: `image(s) not sent: ${enc.skipped.join("; ")}` };
+            }
+          } else {
+            yield { type: "status", content: `${config2.engine.id} has no vision capability \u2014 ${opts.images.length} image(s) not sent to the model` };
+          }
+        }
+        const userTurnMsg = { role: "user", content: opts.message };
+        messageHistory.push(userTurnMsg);
+        const withImages = (history) => {
+          if (!turnImageParts.length) return history;
+          let idx = history.indexOf(userTurnMsg);
+          if (idx < 0) {
+            for (let i = history.length - 1; i >= 0; i--) {
+              const m = history[i];
+              if (m?.role === "user" && typeof m.content === "string" && m.content === userTurnMsg.content) {
+                idx = i;
+                break;
+              }
+            }
+          }
+          if (idx < 0) return history;
+          const base = history[idx];
+          const text = typeof base.content === "string" ? base.content : "";
+          const content = text.trim() ? [{ type: "text", text }, ...turnImageParts] : [...turnImageParts];
+          const cloned = history.slice();
+          cloned[idx] = { ...base, content };
+          return cloned;
+        };
         const estimateSingle = (m) => {
           if (typeof m.content === "string") return Math.ceil(m.content.length / 3.5);
           if (m.content === null && m.tool_calls) {
@@ -25190,7 +25375,7 @@ ${newSummary.decisions.map((d) => `  - ${d}`).join("\n")}` : "",
           const tier3CompactionEnabled = process.env.AGON_DISABLE_TIER3_COMPACTION !== "1";
           if (tier3CompactionEnabled && afterTier2 > CONTEXT_LIMIT - COMPACTION_BUFFER && config2.engine.api) {
             try {
-              const { apiDispatch: apiDispatch2 } = await import("./dispatch-XHLJ44TF.js");
+              const { apiDispatch: apiDispatch2 } = await import("./dispatch-J4RSWLXM.js");
               const compactionPrompt = `Summarize this conversation context into a concise briefing. Preserve: the user's goal, key discoveries, files read/modified, important decisions, and current progress. Drop: verbose tool outputs, repeated attempts, and pleasantries.
 
   CONTEXT TO SUMMARIZE:
@@ -25325,7 +25510,7 @@ ${compactionResult.stdout}` },
           } else {
             yield { type: "status", content: `tool loop turn ${step}/${budget}\u2026` };
           }
-          const gen = apiStreamDispatchWithHistory(config2.engine.api, messageHistory, config2.engine.timeout ?? 180, opts.signal, effectiveTools);
+          const gen = apiStreamDispatchWithHistory(config2.engine.api, withImages(messageHistory), config2.engine.timeout ?? 180, opts.signal, effectiveTools);
           try {
             while (true) {
               const { value, done: done2 } = await gen.next();
@@ -25866,6 +26051,191 @@ ${compactionResult.stdout}` },
   return session;
 }
 
+// ../core/src/generated/sessions/session-pty.ts
+import { existsSync as existsSync25, readFileSync as readFileSync30, rmSync as rmSync5 } from "fs";
+function createPtySession(config2) {
+  let claudeSession = null;
+  let alive = false;
+  let firstTurn = true;
+  let turnActive = false;
+  let pendingDrain = null;
+  const TURN_TIMEOUT_MS = 15 * 60 * 1e3;
+  function buildExtraArgv() {
+    const args = [];
+    if (config2.mcpServers && config2.mcpServers.length > 0) {
+      const mcpConfig = JSON.stringify({
+        mcpServers: Object.fromEntries(
+          config2.mcpServers.map((s) => [s.name ?? s.command ?? "mcp", s])
+        )
+      });
+      args.push("--mcp-config", mcpConfig, "--strict-mcp-config");
+    }
+    args.push("--disallowedTools", "Bash Edit Write MultiEdit NotebookEdit");
+    args.push("--allowedTools", "Read Grep Glob mcp__agon-orchestration");
+    if (config2.claudePtyLaunchArgs && config2.claudePtyLaunchArgs.length > 0) {
+      args.push(...config2.claudePtyLaunchArgs);
+    }
+    return args;
+  }
+  function readAnswer() {
+    const p = config2.answerChannelPath;
+    if (!p) return null;
+    try {
+      if (!existsSync25(p)) return null;
+      const parsed = JSON.parse(readFileSync30(p, "utf-8"));
+      const t = parsed?.text;
+      return typeof t === "string" ? t : null;
+    } catch {
+      return null;
+    }
+  }
+  function clearAnswer() {
+    const p = config2.answerChannelPath;
+    if (!p) return;
+    try {
+      rmSync5(p, { force: true });
+    } catch {
+    }
+  }
+  const session = {
+    get alive() {
+      return alive;
+    },
+    sessionId: null,
+    engineId: config2.engine.id,
+    get pid() {
+      return null;
+    },
+    async start() {
+      if (alive) return;
+      const mod = await import("@kernlang/agon-engines/cli/claude.js");
+      claudeSession = await mod.ClaudeCliSession.spawn({
+        mode: "agent",
+        cwd: config2.cwd,
+        extraArgv: buildExtraArgv(),
+        daemonTimeoutMs: 6e4
+      });
+      alive = true;
+      firstTurn = true;
+    },
+    async *send(opts) {
+      if (turnActive) {
+        yield { type: "error", content: "claude PTY session busy (concurrent turn rejected)" };
+        return;
+      }
+      turnActive = true;
+      try {
+        if (pendingDrain) {
+          try {
+            await pendingDrain;
+          } catch {
+          }
+          pendingDrain = null;
+        }
+        if (!alive || !claudeSession) {
+          try {
+            await session.start();
+          } catch (e) {
+            yield { type: "error", content: `claude PTY session not alive: ${e instanceof Error ? e.message : String(e)}` };
+            return;
+          }
+        }
+        if (opts.signal?.aborted) {
+          yield { type: "done", content: "cancelled" };
+          return;
+        }
+        clearAnswer();
+        const sys = firstTurn ? opts.systemPrompt ?? config2.systemPrompt : void 0;
+        firstTurn = false;
+        const composed = sys ? `[System Instructions]
+${sys}
+
+[User Message]
+${opts.message}` : opts.message;
+        let aborted2 = false;
+        const onAbort = () => {
+          aborted2 = true;
+          try {
+            claudeSession?.close?.();
+          } catch {
+          }
+          claudeSession = null;
+          alive = false;
+        };
+        opts.signal?.addEventListener("abort", onAbort, { once: true });
+        let scrapedFinal = "";
+        let driverError = null;
+        const it = claudeSession.askStream(composed, TURN_TIMEOUT_MS);
+        const driver = (async () => {
+          try {
+            let res = await it.next();
+            while (!res.done) {
+              res = await it.next();
+            }
+            scrapedFinal = typeof res.value === "string" ? res.value : "";
+          } catch (e) {
+            driverError = e;
+          }
+        })();
+        pendingDrain = driver;
+        let driverDone = false;
+        void driver.then(() => {
+          driverDone = true;
+        });
+        await new Promise((resolve28) => {
+          const tick = setInterval(() => {
+            if (driverDone || readAnswer() !== null) {
+              clearInterval(tick);
+              resolve28();
+            }
+          }, 100);
+          void driver.finally(() => {
+            clearInterval(tick);
+            resolve28();
+          });
+        });
+        opts.signal?.removeEventListener("abort", onAbort);
+        if (aborted2) {
+          yield { type: "done", content: "cancelled" };
+          return;
+        }
+        const answer = readAnswer();
+        if (answer !== null && answer.length > 0) {
+          yield { type: "text", content: answer };
+          yield { type: "done", content: "end_turn" };
+          return;
+        }
+        await driver;
+        pendingDrain = null;
+        if (driverError) {
+          alive = false;
+          claudeSession = null;
+          yield { type: "error", content: `claude PTY turn failed: ${driverError instanceof Error ? driverError.message : String(driverError)}` };
+          return;
+        }
+        if (scrapedFinal && scrapedFinal.trim()) {
+          yield { type: "text", content: scrapedFinal };
+        }
+        yield { type: "done", content: "end_turn" };
+      } finally {
+        turnActive = false;
+      }
+    },
+    close() {
+      try {
+        claudeSession?.close?.();
+      } catch {
+      }
+      claudeSession = null;
+      alive = false;
+    },
+    getMessageHistory() {
+      return [];
+    }
+  };
+  return session;
+}
+
 // ../core/src/generated/sessions/persistent-session.ts
 function createPersistentSession(config2) {
   const engine = config2.engine;
@@ -25873,7 +26243,11 @@ function createPersistentSession(config2) {
     return createResumeSession(config2);
   }
   if ((engine.companion?.protocol === "stream-json" || engine.id === "claude" || engine.binary === "claude") && config2.binaryPath) {
-    return createStreamJsonSession(config2);
+    const printOptOut = process.env.AGON_CLAUDE_PRINT;
+    if (printOptOut === "1" || printOptOut === "true") {
+      return createStreamJsonSession(config2);
+    }
+    return createPtySession(config2);
   }
   if (engine.companion && engine.companion.protocol === "acp") {
     return createAcpSession(config2);
@@ -25968,7 +26342,7 @@ function createStreamBridge(dispatch, opts) {
 }
 
 // ../core/src/generated/forge/virtual-fs.ts
-import { readFileSync as readFileSync29, existsSync as existsSync24, readdirSync as readdirSync16, statSync as statSync19 } from "fs";
+import { readFileSync as readFileSync31, existsSync as existsSync26, readdirSync as readdirSync16, statSync as statSync20 } from "fs";
 import { join as join28, resolve as resolve21, relative as relative8, dirname as dirname12 } from "path";
 import { createHash as createHash5 } from "crypto";
 function createFileSnapshot(rootDir) {
@@ -25985,16 +26359,16 @@ function snapshotRead(snap, absPath) {
     return snap.cache.get(key) ?? null;
   }
   try {
-    if (!existsSync24(key)) {
+    if (!existsSync26(key)) {
       snap.cache.set(key, null);
       return null;
     }
-    const st = statSync19(key);
+    const st = statSync20(key);
     if (!st.isFile()) {
       snap.cache.set(key, null);
       return null;
     }
-    const content = readFileSync29(key, "utf-8");
+    const content = readFileSync31(key, "utf-8");
     snap.cache.set(key, content);
     return content;
   } catch (e) {
@@ -26007,7 +26381,7 @@ function snapshotList(snap, absDir) {
   try {
     return readdirSync16(dir).filter((f) => {
       try {
-        return statSync19(join28(dir, f)).isFile();
+        return statSync20(join28(dir, f)).isFile();
       } catch {
         return false;
       }
@@ -26421,7 +26795,7 @@ ${sessionLines.join("\n")}`);
 }
 
 // ../core/src/generated/cesar/context-thread.ts
-import { readFileSync as readFileSync30, writeFileSync as writeFileSync25, mkdirSync as mkdirSync23, renameSync as renameSync11, existsSync as existsSync25, readdirSync as readdirSync17, unlinkSync as unlinkSync10, statSync as statSync20, chmodSync as chmodSync2, openSync as openSync2, fsyncSync, closeSync as closeSync2, appendFileSync as appendFileSync3 } from "fs";
+import { readFileSync as readFileSync32, writeFileSync as writeFileSync25, mkdirSync as mkdirSync23, renameSync as renameSync11, existsSync as existsSync27, readdirSync as readdirSync17, unlinkSync as unlinkSync10, statSync as statSync21, chmodSync as chmodSync2, openSync as openSync2, fsyncSync, closeSync as closeSync2, appendFileSync as appendFileSync3 } from "fs";
 import { join as join30, resolve as resolve23, basename as basename6 } from "path";
 import { randomUUID as randomUUID5, createHash as createHash6 } from "crypto";
 import { homedir as homedir14 } from "os";
@@ -26646,14 +27020,14 @@ var ContextThread = class {
     const now = Date.now();
     if (config2.threadId) {
       const candidatePath = threadFilePath(this.projectPath, config2.threadId);
-      if (existsSync25(candidatePath)) {
+      if (existsSync27(candidatePath)) {
         try {
-          const stat = statSync20(candidatePath);
+          const stat = statSync21(candidatePath);
           if (stat.size > MAX_THREAD_FILE_BYTES) {
             console.warn(`[agon] context-thread: ${candidatePath} is ${stat.size} bytes (> ${MAX_THREAD_FILE_BYTES}), refusing to load. Run /thread compact or /thread fork.`);
             throw new Error("thread file too large");
           }
-          const raw = readFileSync30(candidatePath, "utf-8");
+          const raw = readFileSync32(candidatePath, "utf-8");
           const snap = JSON.parse(raw);
           if (snap && typeof snap === "object" && Array.isArray(snap.messages)) {
             const filteredMessages = (snap.messages ?? []).filter((m) => m && m.role !== "system");
@@ -26671,9 +27045,9 @@ var ContextThread = class {
             this.fileTouches = snap.fileTouches ?? {};
             this.hydrated = true;
             const jPathOnLoad = threadFilePath(this.projectPath, this.threadId).replace(/\.json$/, ".journal.jsonl");
-            if (existsSync25(jPathOnLoad)) {
+            if (existsSync27(jPathOnLoad)) {
               try {
-                const journalLines = readFileSync30(jPathOnLoad, "utf-8").split("\n").filter(Boolean);
+                const journalLines = readFileSync32(jPathOnLoad, "utf-8").split("\n").filter(Boolean);
                 const knownOnLoad = new Set(this.messages.map((m) => m.id));
                 let merged = false;
                 for (const line of journalLines) {
@@ -26943,8 +27317,8 @@ ${msg.content}` };
     let bytes = 0;
     try {
       const path = threadFilePath(this.projectPath, this.threadId);
-      if (existsSync25(path)) {
-        bytes = readFileSync30(path, "utf-8").length;
+      if (existsSync27(path)) {
+        bytes = readFileSync32(path, "utf-8").length;
       }
     } catch {
     }
@@ -26993,7 +27367,7 @@ ${msg.content}` };
       this.dirty = false;
       this.hydrated = true;
       const jPath = threadJournalPath(this.projectPath, this.threadId);
-      if (existsSync25(jPath)) unlinkSync10(jPath);
+      if (existsSync27(jPath)) unlinkSync10(jPath);
       this.journaledIds.clear();
     } catch {
     }
@@ -27025,9 +27399,9 @@ ${msg.content}` };
     }
     try {
       const jPath = threadJournalPath(this.projectPath, this.threadId);
-      if (existsSync25(jPath)) {
+      if (existsSync27(jPath)) {
         try {
-          const journalLines = readFileSync30(jPath, "utf-8").split("\n").filter(Boolean);
+          const journalLines = readFileSync32(jPath, "utf-8").split("\n").filter(Boolean);
           const known = new Set(this.messages.map((m) => m.id));
           for (const line of journalLines) {
             try {
@@ -27046,11 +27420,11 @@ ${msg.content}` };
           console.warn(`[agon] context-thread: journal merge failed (will overwrite): ${err instanceof Error ? err.message : String(err)}`);
         }
       }
-      if (existsSync25(target)) {
+      if (existsSync27(target)) {
         try {
-          const stat = statSync20(target);
+          const stat = statSync21(target);
           if (stat.size <= MAX_THREAD_FILE_BYTES) {
-            const raw = readFileSync30(target, "utf-8");
+            const raw = readFileSync32(target, "utf-8");
             const onDisk = JSON.parse(raw);
             if (onDisk && Array.isArray(onDisk.messages)) {
               const known = new Set(this.messages.map((m) => m.id));
@@ -27108,7 +27482,7 @@ ${msg.content}` };
       this.dirty = false;
       this.hydrated = true;
       try {
-        if (existsSync25(jPath)) unlinkSync10(jPath);
+        if (existsSync27(jPath)) unlinkSync10(jPath);
         this.journaledIds.clear();
       } catch {
       }
@@ -27129,8 +27503,8 @@ ${msg.content}` };
 function loadActivePointer() {
   try {
     const path = activePointerPath();
-    if (existsSync25(path)) {
-      const raw = readFileSync30(path, "utf-8");
+    if (existsSync27(path)) {
+      const raw = readFileSync32(path, "utf-8");
       const parsed = JSON.parse(raw);
       if (parsed && typeof parsed === "object" && parsed.byProject) {
         return parsed;
@@ -27202,7 +27576,7 @@ async function forkActiveThread(projectPath, systemPrompt) {
 }
 function listThreadsForProject(projectPath) {
   const dir = threadDirFor(projectPath);
-  if (!existsSync25(dir)) return [];
+  if (!existsSync27(dir)) return [];
   try {
     return readdirSync17(dir).filter((f) => f.endsWith(".json")).map((f) => f.slice(0, -5));
   } catch (err) {
@@ -27260,6 +27634,39 @@ var PlanCostEstimator = class {
 };
 var planCostEstimator = new PlanCostEstimator();
 
+// ../core/src/generated/cesar/plan-validation.ts
+var VALID_STEP_TYPES = new Set(CESAR_STEP_TYPES);
+function sanitizePlanSteps(rawSteps) {
+  const SAFE_ID = /^[a-z0-9_-]{1,64}$/;
+  const sanitizeId = (raw, fallback) => {
+    if (typeof raw === "string" && SAFE_ID.test(raw)) return raw;
+    return fallback;
+  };
+  const input = Array.isArray(rawSteps) ? rawSteps : [];
+  const steps = input.filter((s) => s && VALID_STEP_TYPES.has(s.type)).map((s, i) => {
+    const est = planCostEstimator.estimate(s.type, s.engines ?? []);
+    return {
+      id: sanitizeId(s.id, `step-${i}-${Math.random().toString(36).slice(2, 8)}`),
+      type: s.type,
+      description: typeof s.description === "string" && s.description.trim().length > 0 ? s.description : "(no description)",
+      engines: s.engines,
+      engine: s.engine,
+      fitnessCmd: s.fitnessCmd,
+      tribunalMode: s.tribunalMode,
+      parallel: s.parallel ?? false,
+      dependsOn: s.dependsOn,
+      exports: typeof s.exports === "string" ? [s.exports] : s.exports,
+      imports: typeof s.imports === "string" ? [s.imports] : s.imports,
+      estimatedTokens: est.tokens,
+      estimatedCostUsd: est.costUsd,
+      rationale: s.rationale,
+      verifyCmd: s.verifyCmd
+    };
+  });
+  const dropped = input.length - steps.length;
+  return { steps, dropped };
+}
+
 // ../core/src/generated/cesar/plan-executor.ts
 function getReadySteps(plan) {
   return plan.steps.filter((s) => s.state === "pending");
@@ -28653,7 +29060,7 @@ function hooksOutput(results) {
 }
 
 // ../core/src/generated/blocks/skill-loader.ts
-import { readFileSync as readFileSync31, readdirSync as readdirSync18, existsSync as existsSync26 } from "fs";
+import { readFileSync as readFileSync33, readdirSync as readdirSync18, existsSync as existsSync28 } from "fs";
 import { join as join32, dirname as dirname13, resolve as resolve24 } from "path";
 import { homedir as homedir15 } from "os";
 import { fileURLToPath as fileURLToPath4 } from "url";
@@ -28675,7 +29082,7 @@ function parseFrontmatter(content) {
 }
 function loadSkillFile(filePath) {
   try {
-    const content = readFileSync31(filePath, "utf-8");
+    const content = readFileSync33(filePath, "utf-8");
     const { meta: meta3, body } = parseFrontmatter(content);
     if (!meta3.name || !meta3.trigger) return null;
     return {
@@ -28693,7 +29100,7 @@ function loadSkillFile(filePath) {
 }
 function loadSkillsFromDir(dir, source) {
   const skills = [];
-  if (!existsSync26(dir)) return skills;
+  if (!existsSync28(dir)) return skills;
   try {
     const files = readdirSync18(dir).filter((f) => f.endsWith(".md"));
     for (const file2 of files) {
@@ -28733,7 +29140,7 @@ function renderSkillPrompt(skill, input) {
 }
 
 // ../core/src/generated/blocks/engine-memory.ts
-import { readFileSync as readFileSync32, writeFileSync as writeFileSync26, mkdirSync as mkdirSync24, renameSync as renameSync12 } from "fs";
+import { readFileSync as readFileSync34, writeFileSync as writeFileSync26, mkdirSync as mkdirSync24, renameSync as renameSync12 } from "fs";
 import { join as join33, resolve as resolve25 } from "path";
 import { homedir as homedir16 } from "os";
 function memoryPath() {
@@ -28743,7 +29150,7 @@ function memoryPath() {
 }
 function loadEngineMemory() {
   try {
-    return JSON.parse(readFileSync32(memoryPath(), "utf-8"));
+    return JSON.parse(readFileSync34(memoryPath(), "utf-8"));
   } catch (err) {
     if (err.code !== "ENOENT") {
       console.warn(`[agon] failed to load engine memory: ${err instanceof Error ? err.message : String(err)}`);
@@ -29021,12 +29428,12 @@ function createSidechainLogger(opts) {
 }
 
 // ../core/src/generated/blocks/provenance.ts
-import { readFileSync as readFileSync33, writeFileSync as writeFileSync27, mkdirSync as mkdirSync26 } from "fs";
+import { readFileSync as readFileSync35, writeFileSync as writeFileSync27, mkdirSync as mkdirSync26 } from "fs";
 import { join as join35, resolve as resolve26 } from "path";
 import { createHash as createHash7 } from "crypto";
 function sha256OfFile(path) {
   try {
-    return "sha256:" + createHash7("sha256").update(readFileSync33(path)).digest("hex");
+    return "sha256:" + createHash7("sha256").update(readFileSync35(path)).digest("hex");
   } catch (e) {
     console.warn(`[agon] provenance: could not hash ${path}: ${e instanceof Error ? e.message : String(e)}`);
     return "unavailable";
@@ -29304,7 +29711,7 @@ var CommandRegistry = class {
 
 // ../core/src/generated/blocks/extension-loader.ts
 import { join as join36, resolve as resolve27 } from "path";
-import { readdirSync as readdirSync19, readFileSync as readFileSync34, existsSync as existsSync27 } from "fs";
+import { readdirSync as readdirSync19, readFileSync as readFileSync36, existsSync as existsSync29 } from "fs";
 import { homedir as homedir17 } from "os";
 
 // ../core/src/generated/signals/event-bus.ts
@@ -29397,13 +29804,13 @@ function discoverExtensionDirs(cwd) {
   const override = process.env.AGON_HOME?.trim();
   const home = override ? resolve27(override) : join36(homedir17(), ".agon");
   const userDir = join36(home, "extensions");
-  if (existsSync27(userDir)) {
+  if (existsSync29(userDir)) {
     try {
       const entries = readdirSync19(userDir, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.isDirectory()) {
           const manifestPath = join36(userDir, entry.name, "manifest.json");
-          if (existsSync27(manifestPath)) {
+          if (existsSync29(manifestPath)) {
             results.push({ dir: join36(userDir, entry.name), source: "user" });
           }
         }
@@ -29412,13 +29819,13 @@ function discoverExtensionDirs(cwd) {
     }
   }
   const repoDir = join36(cwd, ".agon", "extensions");
-  if (existsSync27(repoDir)) {
+  if (existsSync29(repoDir)) {
     try {
       const entries = readdirSync19(repoDir, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.isDirectory()) {
           const manifestPath = join36(repoDir, entry.name, "manifest.json");
-          if (existsSync27(manifestPath)) {
+          if (existsSync29(manifestPath)) {
             results.push({ dir: join36(repoDir, entry.name), source: "repo" });
           }
         }
@@ -29431,7 +29838,7 @@ function discoverExtensionDirs(cwd) {
 function loadExtensionManifest(dir, source) {
   const manifestPath = join36(dir, "manifest.json");
   try {
-    const raw = JSON.parse(readFileSync34(manifestPath, "utf-8"));
+    const raw = JSON.parse(readFileSync36(manifestPath, "utf-8"));
     const result = validateManifest(raw, manifestPath);
     if (!result.ok || !result.data) {
       console.warn(`[agon] skipping extension ${dir}: ${result.error}`);
@@ -29500,7 +29907,7 @@ function registerExtensionEngines(ext, engineRegistry) {
   for (const enginePath of enginePaths) {
     try {
       const fullPath = resolve27(ext.dir, enginePath);
-      const raw = JSON.parse(readFileSync34(fullPath, "utf-8"));
+      const raw = JSON.parse(readFileSync36(fullPath, "utf-8"));
       if (raw.id) {
         engineRegistry.register(raw);
         registered.push(raw.id);
@@ -29915,7 +30322,7 @@ function computeContributionWeights(team, trace) {
 }
 
 // ../core/src/generated/teams/team-elo.ts
-import { readFileSync as readFileSync35, writeFileSync as writeFileSync28, mkdirSync as mkdirSync27, renameSync as renameSync13 } from "fs";
+import { readFileSync as readFileSync37, writeFileSync as writeFileSync28, mkdirSync as mkdirSync27, renameSync as renameSync13 } from "fs";
 import { dirname as dirname14 } from "path";
 function defaultCompositionRating(lineupKey2) {
   return { lineupKey: lineupKey2, rating: 1500, wins: 0, losses: 0, draws: 0, matches: 0 };
@@ -29925,7 +30332,7 @@ function defaultRoleRating(engineId, role) {
 }
 function loadTeamElo() {
   try {
-    return JSON.parse(readFileSync35(TEAM_ELO_PATH, "utf-8"));
+    return JSON.parse(readFileSync37(TEAM_ELO_PATH, "utf-8"));
   } catch (err) {
     if (err.code !== "ENOENT") {
       console.warn(`[agon] failed to load team ELO: ${err instanceof Error ? err.message : String(err)}`);
@@ -30083,6 +30490,7 @@ export {
   worktreeRemove,
   worktreeRemoveBestEffort,
   worktreePruneAll,
+  worktreePruneOrphaned,
   worktreeChangedDiff,
   worktreeChangedShortstat,
   stashSnapshot,
@@ -30272,6 +30680,7 @@ export {
   getCesarPlansDir,
   cesarPlanJsonPath,
   cesarPlanMarkdownPath,
+  CESAR_STEP_TYPES,
   createCesarPlan,
   approveCesarPlan,
   advanceCesarStep,
@@ -30303,6 +30712,7 @@ export {
   buildImageAttachment,
   normalizeDroppedPath,
   extractImagesFromInput,
+  encodeImagesForDispatch,
   roomsDir,
   roomDir,
   slugifyRoomId,
@@ -30371,6 +30781,7 @@ export {
   listThreadsForProject,
   deleteThread,
   planCostEstimator,
+  sanitizePlanSteps,
   getReadySteps,
   executePlan,
   makeAssistantChunk,
@@ -30456,4 +30867,4 @@ export {
   predictTeamRating,
   updateTeamElo
 };
-//# sourceMappingURL=chunk-HAJIKZGU.js.map
+//# sourceMappingURL=chunk-BPKY4OF2.js.map