codeam-cli 2.75.23 → 2.75.26

package/dist/index.js

@@ -357,8 +357,8 @@ function defaultSpawn(timeoutMs) {
   });
 }
 function resolveConvexBin(cwd) {
-  const local = path93.join(cwd, "node_modules", ".bin", process.platform === "win32" ? "convex.cmd" : "convex");
-  if (fs79.existsSync(local)) return { cmd: local, args: [] };
+  const local = path94.join(cwd, "node_modules", ".bin", process.platform === "win32" ? "convex.cmd" : "convex");
+  if (fs80.existsSync(local)) return { cmd: local, args: [] };
   return { cmd: "npx", args: ["--yes", "convex"] };
 }
 function redact(text, key) {
@@ -489,13 +489,13 @@ async function runConvexAdminMcp(client3, id) {
   });
   await server.connect(new StdioServerTransport());
 }
-var import_node_child_process32, fs79, path93, TOOLS;
+var import_node_child_process32, fs80, path94, TOOLS;
 var init_convex_admin_mcp = __esm({
   "src/integrations/convex-admin-mcp.ts"() {
     "use strict";
     import_node_child_process32 = require("child_process");
-    fs79 = __toESM(require("fs"));
-    path93 = __toESM(require("path"));
+    fs80 = __toESM(require("fs"));
+    path94 = __toESM(require("path"));
     TOOLS = [
       {
         name: "tables",
@@ -3248,6 +3248,9 @@ var USER_EVENTS = {
   PREVIEW_STOPPED: "preview_stopped",
   PREVIEW_ERROR: "preview_error",
   PREVIEW_PROGRESS: "preview_progress",
+  /** The agent points at an element of the running preview (`highlight_element`
+   *  MCP tool) — the inspector client draws the agent's mark over it. */
+  PREVIEW_AGENT_HIGHLIGHT: "preview_agent_highlight",
   BEADS_STATE_CHANGED: "beads_state_changed",
   BEADS_PROVISIONING: "beads_provisioning",
   BEADS_TEAM_MEMORY_CHANGED: "beads_team_memory_changed",
@@ -3525,11 +3528,11 @@ function quiet(fn) {
     log.debug(TAG, "ignored sync error", err);
   }
 }
-function rmIfExistsQuiet(path95) {
+function rmIfExistsQuiet(path96) {
   try {
-    fs2.rmSync(path95, { force: true });
+    fs2.rmSync(path96, { force: true });
   } catch (err) {
-    log.debug(TAG, `rmIfExists failed for ${path95}`, err);
+    log.debug(TAG, `rmIfExists failed for ${path96}`, err);
   }
 }
 function killQuiet(target, signal = "SIGTERM") {
@@ -3695,9 +3698,9 @@ var _default = makeConfig();
 var { getConfig, ensurePluginId, addSession, removeSession, setActiveSession, getActiveSession, getActiveSessionForAgent, setDisable1mContext, setSessionAgent, setSquadAuto, getSquadAuto, clearAll, saveCliConfig, loadCliConfig } = _default;
 
 // src/commands/pair-auto.ts
-var fs51 = __toESM(require("fs"));
+var fs52 = __toESM(require("fs"));
 var os40 = __toESM(require("os"));
-var path59 = __toESM(require("path"));
+var path60 = __toESM(require("path"));
 var import_crypto3 = require("crypto");
 
 // src/services/telemetry.service.ts
@@ -3733,8 +3736,8 @@ function createGetModuleFromFilename(basePath = process.argv[1] ? (0, import_pat
     return decodedFile;
   };
 }
-function normalizeWindowsPath(path95) {
-  return path95.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
+function normalizeWindowsPath(path96) {
+  return path96.replace(/^[A-Z]:/, "").replace(/\\/g, "/");
 }
 
 // ../../node_modules/@posthog/core/dist/error-tracking/index.mjs
@@ -6467,13 +6470,13 @@ var PostHogCoreStateless = class {
       sentFromRoute += batchMessages.length;
     }
   }
-  async _sendOtlpBatch({ path: path95, payload }) {
+  async _sendOtlpBatch({ path: path96, payload }) {
     if (this.disabled) return {
       kind: "fatal",
       error: new Error("The client is disabled")
     };
     const serialized = JSON.stringify(payload);
-    const url2 = `${this.host}/i/v1/${path95}?token=${encodeURIComponent(this.apiKey)}`;
+    const url2 = `${this.host}/i/v1/${path96}?token=${encodeURIComponent(this.apiKey)}`;
     const gzippedPayload = this.disableCompression ? null : await this.compressPayload(serialized);
     const fetchOptions = {
       method: "POST",
@@ -7713,14 +7716,14 @@ async function addSourceContext(frames, openSourceFile = import_promises.open, l
   LRU_FILE_CONTENTS_CACHE.reduce();
   return frames;
 }
-async function openRegularSourceFile(path95, openSourceFile, logger) {
+async function openRegularSourceFile(path96, openSourceFile, logger) {
   let fileHandle;
   let isValid = false;
   try {
-    fileHandle = await openSourceFile(path95, import_node_fs.constants.O_RDONLY | import_node_fs.constants.O_NONBLOCK);
+    fileHandle = await openSourceFile(path96, import_node_fs.constants.O_RDONLY | import_node_fs.constants.O_NONBLOCK);
     const fileStat = await fileHandle.stat();
     if (!fileStat.isFile()) return;
-    if (fileStat.size > MAX_CONTEXTLINES_FILE_SIZE) return void logger?.debug(`Skipping source context for oversized file ${path95}: ${fileStat.size} bytes exceeds ${MAX_CONTEXTLINES_FILE_SIZE}`);
+    if (fileStat.size > MAX_CONTEXTLINES_FILE_SIZE) return void logger?.debug(`Skipping source context for oversized file ${path96}: ${fileStat.size} bytes exceeds ${MAX_CONTEXTLINES_FILE_SIZE}`);
     isValid = true;
     return fileHandle;
   } catch {
@@ -7730,8 +7733,8 @@ async function openRegularSourceFile(path95, openSourceFile, logger) {
     });
   }
 }
-async function getContextLinesFromFile(path95, ranges, output, cacheKey, openSourceFile, logger) {
-  const fileHandle = await openRegularSourceFile(path95, openSourceFile, logger);
+async function getContextLinesFromFile(path96, ranges, output, cacheKey, openSourceFile, logger) {
+  const fileHandle = await openRegularSourceFile(path96, openSourceFile, logger);
   if (void 0 === fileHandle) return void LRU_FILE_CONTENTS_FS_READ_FAILED.set(cacheKey, 1);
   const openedFileHandle = fileHandle;
   return new Promise((resolve12) => {
@@ -7833,22 +7836,22 @@ function clearLineContext(frame) {
   delete frame.context_line;
   delete frame.post_context;
 }
-function shouldSkipContextLinesForFile(path95) {
-  return path95.startsWith("node:") || path95.endsWith(".min.js") || path95.endsWith(".min.cjs") || path95.endsWith(".min.mjs") || path95.startsWith("data:");
+function shouldSkipContextLinesForFile(path96) {
+  return path96.startsWith("node:") || path96.endsWith(".min.js") || path96.endsWith(".min.cjs") || path96.endsWith(".min.mjs") || path96.startsWith("data:");
 }
 function shouldSkipContextLinesForFrame(frame) {
   if (void 0 !== frame.lineno && frame.lineno > MAX_CONTEXTLINES_LINENO) return true;
   if (void 0 !== frame.colno && frame.colno > MAX_CONTEXTLINES_COLNO) return true;
   return false;
 }
-function makeSourceCacheKey(path95, basePath) {
-  if ((0, import_node_path.isAbsolute)(path95)) return JSON.stringify([
+function makeSourceCacheKey(path96, basePath) {
+  if ((0, import_node_path.isAbsolute)(path96)) return JSON.stringify([
     null,
-    path95
+    path96
   ]);
   return void 0 === basePath ? void 0 : JSON.stringify([
     basePath,
-    path95
+    path96
   ]);
 }
 function rangeExistsInContentCache(cacheKey, range) {
@@ -10509,7 +10512,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.75.23" : "0.0.0-dev",
+    cliVersion: true ? "2.75.26" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -10751,7 +10754,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.75.23",
+  version: "2.75.26",
   description: "Workflow-continuity bridge for AI coding agents. Wrap Claude Code or Codex in a PTY and supervise, approve, and redirect the session from any device \u2014 async. The terminal companion for CodeAgent Mobile.",
   type: "commonjs",
   main: "dist/index.js",
@@ -12081,7 +12084,7 @@ var CommandRelayService = class _CommandRelayService {
       // fresh + clear the "CLI update available" banner after a self-update
       // (a codespace that reinstalls @latest reconnects via heartbeat, not
       // pair/reconnect). Older backends ignore the extra field.
-      ..."2.75.23" ? { ideVersion: "2.75.23" } : {}
+      ..."2.75.26" ? { ideVersion: "2.75.26" } : {}
     };
     try {
       const res = await _postJson(`${API_BASE2}/api/plugin/heartbeat`, body);
@@ -13534,9 +13537,9 @@ function closeAllTerminals() {
 }
 
 // src/commands/start/handlers.ts
-var fs50 = __toESM(require("fs"));
+var fs51 = __toESM(require("fs"));
 var os39 = __toESM(require("os"));
-var path58 = __toESM(require("path"));
+var path59 = __toESM(require("path"));
 var import_crypto2 = require("crypto");
 var import_child_process25 = require("child_process");
 
@@ -17150,12 +17153,12 @@ function isAvailable() {
 }
 function augmentPath() {
   const dirs = probeInstallDirs();
-  const sep6 = path15.delimiter;
+  const sep7 = path15.delimiter;
   const current2 = process.env.PATH ?? "";
-  const existing = new Set(current2.split(sep6).filter(Boolean));
+  const existing = new Set(current2.split(sep7).filter(Boolean));
   const additions = dirs.filter((d3) => !existing.has(d3));
   if (additions.length === 0) return;
-  process.env.PATH = additions.join(sep6) + sep6 + current2;
+  process.env.PATH = additions.join(sep7) + sep7 + current2;
 }
 function runInstaller() {
   const isWindows = process.platform === "win32";
@@ -19603,8 +19606,8 @@ function pickLine(obj) {
 function toHunk(raw, groupSeverity) {
   if (!raw || typeof raw !== "object") return null;
   const o = raw;
-  const path95 = asString(pick(o, ["file_path", "filePath", "file", "path", "filename", "fileName"])) ?? asString(pick(o, ["location"])?.path);
-  if (!path95) return null;
+  const path96 = asString(pick(o, ["file_path", "filePath", "file", "path", "filename", "fileName"])) ?? asString(pick(o, ["location"])?.path);
+  if (!path96) return null;
   const message = asString(
     pick(o, [
       "comment",
@@ -19621,7 +19624,7 @@ function toHunk(raw, groupSeverity) {
   const severity = normSeverity(pick(o, ["severity", "level", "priority", "impact"])) ?? normSeverity(groupSeverity);
   const locObj = pick(o, ["location"]) ?? o;
   return {
-    path: path95.trim(),
+    path: path96.trim(),
     line: pickLine(o) ?? pickLine(locObj),
     severity,
     message: (title && message ? `${title}: ${message}` : title || message).trim() || "(no message)"
@@ -19704,10 +19707,10 @@ function parsePlain(stdout) {
   for (const line of stdout.split(/\r?\n/)) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
-    const [, path95, lineNo, sevToken, message] = m;
-    if (!path95 || !lineNo || !message) continue;
+    const [, path96, lineNo, sevToken, message] = m;
+    if (!path96 || !lineNo || !message) continue;
     hunks.push({
-      path: path95.trim(),
+      path: path96.trim(),
       line: Number(lineNo),
       severity: sevToken ? SEVERITY_MAP[sevToken.toLowerCase()] : void 0,
       message: message.trim().replace(/^[*-]\s+/, "")
@@ -23164,7 +23167,8 @@ async function readPreviewConfig(cwd) {
 async function writePreviewConfig(cwd, detection) {
   const filePath = configPath(cwd);
   await import_promises4.default.mkdir(import_path6.default.dirname(filePath), { recursive: true });
-  await import_promises4.default.writeFile(filePath, JSON.stringify(detection, null, 2) + "\n", "utf-8");
+  const { candidates: _candidates, ...config } = detection;
+  await import_promises4.default.writeFile(filePath, JSON.stringify(config, null, 2) + "\n", "utf-8");
 }
 
 // src/services/preview/dotenv.ts
@@ -23839,6 +23843,107 @@ function isJsInstallCommand(cmd, args2) {
   return verb === "install" || verb === "i" || verb === "ci";
 }
 
+// src/services/preview/script-candidates.ts
+var fs40 = __toESM(require("fs"));
+var path48 = __toESM(require("path"));
+var EXCLUDE_RE = /(^|:)(deploy|publish|release|build|test|e2e|lint|format|typecheck|type-check|clean|prebuild|postinstall|preinstall|prepare|install|migrate|seed|db|prisma|codegen|storybook-build)(:|$)/i;
+var EXCLUDE_BODY_RE = /\b(run:android|run:ios|gradlew|fastlane|xcodebuild|eas build|eas submit)\b/i;
+var MAX_APPS = 40;
+var MAX_CANDIDATES = 120;
+function frameworkFor(pkg, body) {
+  const deps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
+  const has = (d3) => d3 in deps || new RegExp(`\\b${d3}\\b`).test(body);
+  if (has("expo")) return { framework: "Expo", port: 8081, ready_pattern: "Waiting on http|Metro waiting|Logs for your project" };
+  if (has("next")) return { framework: "Next.js", port: 3e3, ready_pattern: "Ready in|Local:.*http" };
+  if (has("vite")) return { framework: "Vite", port: 5173, ready_pattern: "Local:.*http" };
+  if (has("@angular/cli") || /\bng serve\b/.test(body)) return { framework: "Angular", port: 4200, ready_pattern: "Local:.*http|compiled successfully" };
+  if (has("react-scripts")) return { framework: "Create React App", port: 3e3, ready_pattern: "Compiled|Local:.*http" };
+  if (has("nx") || /\bnx\b/.test(body)) return { framework: "Nx", port: 4200, ready_pattern: "Local:.*http|ready|listening" };
+  return { framework: "Node", port: 3e3, ready_pattern: "Local:.*http|ready|listening|started" };
+}
+function readPkg(file) {
+  try {
+    return JSON.parse(fs40.readFileSync(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
+function expandGlob(root, pattern) {
+  const clean = pattern.replace(/\/+$/, "");
+  if (!clean.endsWith("/*")) return [clean];
+  const base = clean.slice(0, -2);
+  try {
+    return fs40.readdirSync(path48.join(root, base), { withFileTypes: true }).filter((d3) => d3.isDirectory() && !d3.name.startsWith(".") && d3.name !== "node_modules").map((d3) => path48.join(base, d3.name));
+  } catch {
+    return [];
+  }
+}
+function workspaceDirs(root, rootPkg) {
+  const ws = rootPkg?.workspaces;
+  const patterns = Array.isArray(ws) ? ws : ws?.packages ?? [];
+  try {
+    const pnpm = fs40.readFileSync(path48.join(root, "pnpm-workspace.yaml"), "utf8");
+    for (const m of pnpm.matchAll(/^\s*-\s*['"]?([^'"\n]+)['"]?\s*$/gm)) patterns.push(m[1]);
+  } catch {
+  }
+  if (patterns.length === 0) patterns.push("apps/*", "packages/*");
+  const dirs = /* @__PURE__ */ new Set();
+  for (const p2 of patterns) for (const d3 of expandGlob(root, p2)) dirs.add(d3);
+  return [...dirs].slice(0, MAX_APPS);
+}
+function listScriptCandidates(root) {
+  const out2 = [];
+  const rootPkg = readPkg(path48.join(root, "package.json"));
+  const add = (pkg, appDir) => {
+    for (const [script, body] of Object.entries(pkg.scripts ?? {})) {
+      if (out2.length >= MAX_CANDIDATES) return;
+      if (EXCLUDE_RE.test(script) || EXCLUDE_BODY_RE.test(body)) continue;
+      const fw = frameworkFor(pkg, body);
+      out2.push({
+        app: pkg.name ?? (appDir === "." ? path48.basename(root) : appDir),
+        appDir,
+        script,
+        body,
+        framework: fw.framework,
+        command: "npm",
+        args: appDir === "." ? ["run", script] : ["--prefix", appDir, "run", script],
+        port: fw.port,
+        ready_pattern: fw.ready_pattern
+      });
+    }
+  };
+  if (rootPkg) add(rootPkg, ".");
+  for (const dir of workspaceDirs(root, rootPkg)) {
+    const pkg = readPkg(path48.join(root, dir, "package.json"));
+    if (pkg) add(pkg, dir.split(path48.sep).join("/"));
+  }
+  return out2;
+}
+
+// src/services/preview/prewarm-deps.ts
+var inFlight = null;
+var PREWARM_INSTALL_TIMEOUT_MS = 5 * 6e4;
+function prewarmNodeDeps(cwd) {
+  if (inFlight) return inFlight;
+  const missing = detectMissingNodeDeps(cwd);
+  if (!missing || missing.cmd !== "npm") return Promise.resolve();
+  log.info("preview", `prewarm: installing deps (${missing.cmd} ${missing.args.join(" ")})`);
+  const started = Date.now();
+  inFlight = runSetupCommand(missing.cmd, missing.args, cwd, void 0, {
+    timeoutMs: PREWARM_INSTALL_TIMEOUT_MS
+  }).then((r) => {
+    log.info("preview", `prewarm: deps ${r.status} after ${Date.now() - started}ms`);
+  }).catch((err) => {
+    log.info("preview", `prewarm: deps install threw (${String(err)})`);
+  }).finally(() => {
+    inFlight = null;
+  });
+  return inFlight;
+}
+function awaitPrewarmInstall() {
+  return inFlight ?? Promise.resolve();
+}
+
 // src/services/preview/tunnel-bringup.ts
 var TUNNEL_REGISTERED_RE = /Registered tunnel connection/i;
 async function awaitTunnelRegistered(candidate, hostname3, deadlineMs) {
@@ -23975,19 +24080,19 @@ function activePreviewSessionIds() {
 
 // src/services/preview/start-orchestrator.ts
 var import_child_process20 = require("child_process");
-var fs42 = __toESM(require("fs"));
-var path50 = __toESM(require("path"));
+var fs43 = __toESM(require("fs"));
+var path51 = __toESM(require("path"));
 var import_which2 = __toESM(require("which"));
 
 // src/services/project-env/index.ts
 var import_fs6 = require("fs");
-var path49 = __toESM(require("path"));
+var path50 = __toESM(require("path"));
 
 // src/beads/project-key.ts
 var import_child_process19 = require("child_process");
 var crypto2 = __toESM(require("crypto"));
-var fs40 = __toESM(require("fs"));
-var path48 = __toESM(require("path"));
+var fs41 = __toESM(require("fs"));
+var path49 = __toESM(require("path"));
 function normalizeOrigin(raw) {
   const trimmed = raw.trim();
   if (!trimmed) return null;
@@ -24013,17 +24118,17 @@ function normalizeOrigin(raw) {
   return `${host2}/${pathPart}`;
 }
 function findRepoRoot(cwd) {
-  let dir = path48.resolve(cwd);
+  let dir = path49.resolve(cwd);
   const seen2 = /* @__PURE__ */ new Set();
   for (let i = 0; i < 256; i++) {
     if (seen2.has(dir)) return null;
     seen2.add(dir);
     try {
-      const stat3 = fs40.statSync(path48.join(dir, ".git"), { throwIfNoEntry: false });
+      const stat3 = fs41.statSync(path49.join(dir, ".git"), { throwIfNoEntry: false });
       if (stat3 && (stat3.isDirectory() || stat3.isFile())) return dir;
     } catch {
     }
-    const parent = path48.dirname(dir);
+    const parent = path49.dirname(dir);
     if (parent === dir) return null;
     dir = parent;
   }
@@ -24034,7 +24139,7 @@ var _execSeam3 = {
     const out2 = (0, import_child_process19.execFileSync)(file, args2, opts);
     return typeof out2 === "string" ? out2 : out2.toString("utf8");
   },
-  realpath: (p2) => fs40.realpathSync(p2)
+  realpath: (p2) => fs41.realpathSync(p2)
 };
 function readOrigin(cwd) {
   try {
@@ -24063,7 +24168,7 @@ function deriveProjectIdentity(cwd = process.cwd()) {
   } catch {
   }
   const hash = crypto2.createHash("sha256").update(real).digest("hex");
-  return { projectKey: `path:${hash}`, projectLabel: path48.basename(real) || "project" };
+  return { projectKey: `path:${hash}`, projectLabel: path49.basename(real) || "project" };
 }
 
 // src/services/project-env/index.ts
@@ -24076,7 +24181,7 @@ async function readIfExists(p2) {
 }
 async function syncProjectEnvUp(cwd, ctx) {
   if (!ctx.pluginAuthToken) return;
-  const content = await readIfExists(path49.join(cwd, ".env"));
+  const content = await readIfExists(path50.join(cwd, ".env"));
   if (content == null) return;
   try {
     const { projectKey, projectLabel } = deriveProjectIdentity(cwd);
@@ -24098,7 +24203,7 @@ async function syncProjectEnvUp(cwd, ctx) {
 }
 async function restoreProjectEnvIfMissing(cwd, ctx) {
   if (!ctx.pluginAuthToken) return false;
-  const envPath = path49.join(cwd, ".env");
+  const envPath = path50.join(cwd, ".env");
   if (await readIfExists(envPath) != null) return false;
   try {
     const { projectKey, projectLabel } = deriveProjectIdentity(cwd);
@@ -24109,7 +24214,7 @@ async function restoreProjectEnvIfMissing(cwd, ctx) {
       projectKey
     });
     if (!stored) return false;
-    const tmp = path49.join(cwd, ".env.codeam-restore.tmp");
+    const tmp = path50.join(cwd, ".env.codeam-restore.tmp");
     await import_fs6.promises.writeFile(tmp, stored.content, { encoding: "utf8", mode: 384 });
     await import_fs6.promises.rename(tmp, envPath);
     log.info("project-env", `restored .env (${stored.keyCount} vars) for ${projectLabel}`);
@@ -24526,6 +24631,145 @@ function inspectorClientSource(opts) {
       redrawMarks();
     }
 
+    /**
+     * Las marcas del AGENTE \u2014 la herramienta highlight_element.
+     *
+     * Van aparte de las del usuario a proposito: no se numeran, no se pueden
+     * borrar desde el composer y no dependen de que el modo inspector este
+     * encendido. Son el agente SE\xD1ALANDO algo, y el usuario las ve aunque no
+     * haya tocado nada: un cursor que viaja hasta el elemento, lo centra en
+     * pantalla y deja una caja con su etiqueta.
+     *
+     * Mismo anclaje que las marcas fijadas (coordenadas de documento), asi que
+     * acompa\xF1an al scroll. Un selector que no encuentra nada no pinta nada: el
+     * agente ya sabe por la herramienta que puede fallar.
+     */
+    var AGENT = '#22d3ee';
+    var agentMarks = [];
+    var agentHost = null;
+    var agentCursor = null;
+    var agentStyle = null;
+    var agentListening = false;
+
+    function ensureAgentStyle() {
+      if (agentStyle && agentStyle.parentNode) return;
+      agentStyle = document.createElement('style');
+      agentStyle.setAttribute('data-codeam', 'agent-style');
+      agentStyle.textContent =
+        '@keyframes codeam-agent-pulse{0%{box-shadow:0 0 0 0 rgba(34,211,238,.55)}' +
+        '70%{box-shadow:0 0 0 10px rgba(34,211,238,0)}100%{box-shadow:0 0 0 0 rgba(34,211,238,0)}}' +
+        '@keyframes codeam-agent-in{from{opacity:0;transform:scale(1.06)}to{opacity:1;transform:scale(1)}}';
+      (document.head || document.documentElement).appendChild(agentStyle);
+    }
+
+    function ensureAgentCursor() {
+      if (agentCursor && agentCursor.parentNode) return agentCursor;
+      agentCursor = document.createElement('div');
+      agentCursor.setAttribute('data-codeam', 'agent-cursor');
+      agentCursor.style.cssText = [
+        'position:fixed', 'pointer-events:none', 'z-index:2147483647',
+        'left:' + Math.round(window.innerWidth / 2) + 'px', 'top:' + Math.round(window.innerHeight - 40) + 'px',
+        'transition:left .6s cubic-bezier(.22,1,.36,1),top .6s cubic-bezier(.22,1,.36,1),opacity .3s',
+        'opacity:0'
+      ].join(';');
+      agentCursor.innerHTML =
+        '<svg width="22" height="22" viewBox="0 0 24 24" style="display:block;filter:drop-shadow(0 1px 2px rgba(0,0,0,.5))">' +
+        '<path d="M4 2l15 8.5-6.6 1.6L9 18.5z" fill="' + AGENT + '" stroke="#000" stroke-width="1.2"/></svg>' +
+        '<div style="margin:2px 0 0 14px;background:' + AGENT + ';color:#000;font:700 10px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;' +
+        'padding:1px 6px;border-radius:8px;white-space:nowrap">Agent</div>';
+      document.body.appendChild(agentCursor);
+      return agentCursor;
+    }
+
+    function redrawAgentMarks() {
+      if (agentMarks.length === 0) {
+        if (agentHost && agentHost.parentNode) agentHost.parentNode.removeChild(agentHost);
+        agentHost = null;
+        return;
+      }
+      if (!agentHost || !agentHost.parentNode) {
+        agentHost = document.createElement('div');
+        agentHost.setAttribute('data-codeam', 'agent-marks');
+        agentHost.style.cssText = 'position:absolute;left:0;top:0;width:0;height:0;z-index:2147483646';
+        document.body.appendChild(agentHost);
+      }
+      agentHost.innerHTML = '';
+      var sx = window.scrollX || window.pageXOffset || 0;
+      var sy = window.scrollY || window.pageYOffset || 0;
+      for (var i = 0; i < agentMarks.length; i++) {
+        var m = agentMarks[i];
+        if (!m.el.isConnected) continue;
+        var r = m.el.getBoundingClientRect();
+        var box = document.createElement('div');
+        box.setAttribute('data-codeam', 'agent-mark');
+        box.style.cssText = [
+          'position:absolute', 'pointer-events:none', 'box-sizing:border-box',
+          'border:2px solid ' + AGENT, 'background:rgba(34,211,238,0.10)', 'border-radius:4px',
+          'left:' + (r.left + sx - 3) + 'px', 'top:' + (r.top + sy - 3) + 'px',
+          'width:' + (r.width + 6) + 'px', 'height:' + (r.height + 6) + 'px',
+          'animation:codeam-agent-in .25s ease-out,codeam-agent-pulse 1.6s ease-out 3'
+        ].join(';');
+        if (m.label) {
+          var tag = document.createElement('div');
+          tag.setAttribute('data-codeam', 'agent-mark-label');
+          tag.style.cssText = [
+            'position:absolute', 'left:-2px', (r.top >= 22 ? 'top:-22px' : 'bottom:-22px'),
+            'background:' + AGENT, 'color:#000', 'font:700 11px/1.6 ui-monospace,SFMono-Regular,Menlo,monospace',
+            'padding:0 6px', 'border-radius:3px', 'white-space:nowrap', 'max-width:260px',
+            'overflow:hidden', 'text-overflow:ellipsis'
+          ].join(';');
+          tag.textContent = m.label;
+          box.appendChild(tag);
+        }
+        agentHost.appendChild(box);
+      }
+    }
+
+    function listenAgentLayout() {
+      if (agentListening) return;
+      agentListening = true;
+      window.addEventListener('scroll', redrawAgentMarks, true);
+      window.addEventListener('resize', redrawAgentMarks);
+    }
+
+    function agentHighlight(selector, labelText) {
+      var el = null;
+      try { el = document.querySelector(String(selector)); } catch (e) { el = null; }
+      if (!el || !el.getBoundingClientRect) return false;
+      ensureAgentStyle();
+      listenAgentLayout();
+      try { el.scrollIntoView({ block: 'center', inline: 'nearest', behavior: 'smooth' }); } catch (e) { /* viejo */ }
+      var cursor = ensureAgentCursor();
+      // Tras el scroll suave: el cursor viaja al centro del elemento y, al
+      // llegar, aparece la caja. El orden es lo que se lee como \xABel agente
+      // lo esta se\xF1alando\xBB y no como un recuadro que salta.
+      setTimeout(function () {
+        var r = el.getBoundingClientRect();
+        cursor.style.opacity = '1';
+        cursor.style.left = Math.round(r.left + Math.min(r.width / 2, 40)) + 'px';
+        cursor.style.top = Math.round(r.top + Math.min(r.height / 2, 24)) + 'px';
+        setTimeout(function () {
+          agentMarks.push({ el: el, label: labelText ? String(labelText).slice(0, 80) : '' });
+          redrawAgentMarks();
+        }, 620);
+      }, 380);
+      return true;
+    }
+
+    function agentClear() {
+      agentMarks = [];
+      redrawAgentMarks();
+      if (agentCursor && agentCursor.parentNode) agentCursor.parentNode.removeChild(agentCursor);
+      agentCursor = null;
+      if (agentStyle && agentStyle.parentNode) agentStyle.parentNode.removeChild(agentStyle);
+      agentStyle = null;
+      if (agentListening) {
+        window.removeEventListener('scroll', redrawAgentMarks, true);
+        window.removeEventListener('resize', redrawAgentMarks);
+        agentListening = false;
+      }
+    }
+
     function enable(origin) {
       if (enabled) return;
       enabled = true;
@@ -24559,6 +24803,8 @@ function inspectorClientSource(opts) {
       if (data.type === 'enable') enable(e.origin);
       else if (data.type === 'disable') disable();
       else if (data.type === 'marks' && data.ids) syncMarks(data.ids);
+      else if (data.type === 'agent-highlight' && data.selector) agentHighlight(data.selector, data.label);
+      else if (data.type === 'agent-clear') agentClear();
     });
 
     /**
@@ -24577,6 +24823,11 @@ function inspectorClientSource(opts) {
       window.__codeamInspector = {
         enable: function () { enable('react-native'); },
         disable: disable,
+        // La app movil ya llamaba \`marks\` al borrar un chip y no existia:
+        // la marca se quedaba pintada en la pagina.
+        marks: function (ids) { if (ids && ids.length !== undefined) syncMarks(ids); },
+        highlight: function (selector, text) { return agentHighlight(selector, text); },
+        clear: agentClear,
       };
     }
   } catch (e) {
@@ -24630,6 +24881,12 @@ var TUNNEL_REGISTER_DEADLINE_MS = 45e3;
 function compileReadyPattern(pattern) {
   return new RegExp(pattern, "i");
 }
+var DEV_SERVER_READY_TIMEOUT_MS = 12e4;
+var MONOREPO_READY_TIMEOUT_MS = 36e4;
+function devServerReadyTimeoutMs(detection) {
+  const text = [detection.framework, detection.command ?? "", ...detection.args ?? []].join(" ");
+  return /\b(nx|turbo|turborepo|lerna)\b/i.test(text) ? MONOREPO_READY_TIMEOUT_MS : DEV_SERVER_READY_TIMEOUT_MS;
+}
 async function waitForDevServerReady(devServer, readyRe, opts = {
   timeoutMs: 12e4
 }) {
@@ -24689,8 +24946,8 @@ function normalizeDetectionForSpawn(detection, cwd) {
   if (args2.length === 0) return detection;
   const binName = args2[0];
   if (binName.startsWith("-")) return detection;
-  const binPath = path50.join(cwd, "node_modules", ".bin", binName);
-  if (!fs42.existsSync(binPath)) return detection;
+  const binPath = path51.join(cwd, "node_modules", ".bin", binName);
+  if (!fs43.existsSync(binPath)) return detection;
   return {
     ...detection,
     command: binPath,
@@ -24784,6 +25041,7 @@ async function provisionDeps(ctx) {
       pluginAuthToken: ctx.projectEnvAuth.pluginAuthToken
     });
   }
+  await awaitPrewarmInstall();
   const missingDeps = detectMissingNodeDeps(cwd);
   let preflightRan = false;
   if (missingDeps) {
@@ -24963,7 +25221,7 @@ async function startDevServer(ctx, extraEnv = {}) {
   const isNextJs = /next/i.test(detection.framework);
   const portProbe = isExpo ? () => waitForExpoManifest(detection.port, { timeoutMs: 1e3, intervalMs: 250 }) : isNextJs ? () => waitForPortListening(detection.port, { timeoutMs: 1e3, intervalMs: 250 }) : void 0;
   const outcome = await waitForDevServerReady(devServer, readyRe, {
-    timeoutMs: 12e4,
+    timeoutMs: devServerReadyTimeoutMs(detection),
     onChunk: (s) => {
       outputTail = (outputTail + s).slice(-16e3);
     },
@@ -25089,9 +25347,9 @@ async function bringUpPublicUrl(ctx, tunnelPort) {
 
 // src/beads/bd-adapter.ts
 var import_child_process21 = require("child_process");
-var fs43 = __toESM(require("fs"));
+var fs44 = __toESM(require("fs"));
 var os31 = __toESM(require("os"));
-var path51 = __toESM(require("path"));
+var path52 = __toESM(require("path"));
 var BD_PACKAGE = "@beads/bd";
 function resolveBundledBdBinary() {
   return _resolveSeam.resolveBundled();
@@ -25103,11 +25361,11 @@ function _defaultResolveBundled() {
   } catch {
     return null;
   }
-  const binDir = path51.join(path51.dirname(pkgJsonPath), "bin");
+  const binDir = path52.join(path52.dirname(pkgJsonPath), "bin");
   const binaryName = process.platform === "win32" ? "bd.exe" : "bd";
-  const binaryPath = path51.join(binDir, binaryName);
+  const binaryPath = path52.join(binDir, binaryName);
   try {
-    fs43.accessSync(binaryPath, fs43.constants.F_OK);
+    fs44.accessSync(binaryPath, fs44.constants.F_OK);
     return binaryPath;
   } catch {
     return null;
@@ -25117,13 +25375,13 @@ function resolveBdOnPath() {
   return _resolveSeam.resolveOnPath();
 }
 function _defaultResolveOnPath() {
-  const dirs = (process.env.PATH ?? "").split(path51.delimiter).filter(Boolean);
+  const dirs = (process.env.PATH ?? "").split(path52.delimiter).filter(Boolean);
   const candidates = process.platform === "win32" ? ["bd.exe", "bd.cmd", "bd"] : ["bd"];
   for (const dir of dirs) {
     for (const candidate of candidates) {
-      const full = path51.join(dir, candidate);
+      const full = path52.join(dir, candidate);
       try {
-        fs43.accessSync(full, fs43.constants.F_OK);
+        fs44.accessSync(full, fs44.constants.F_OK);
         return full;
       } catch {
       }
@@ -25300,9 +25558,9 @@ function coerceIssue(row, projectKey) {
 
 // src/beads/provisioner.ts
 var import_child_process24 = require("child_process");
-var fs45 = __toESM(require("fs"));
+var fs46 = __toESM(require("fs"));
 var os33 = __toESM(require("os"));
-var path53 = __toESM(require("path"));
+var path54 = __toESM(require("path"));
 
 // src/beads/install-bd.ts
 var import_child_process22 = require("child_process");
@@ -25367,9 +25625,9 @@ async function installBd(platform3 = process.platform) {
 
 // src/beads/install-dolt.ts
 var import_child_process23 = require("child_process");
-var fs44 = __toESM(require("fs"));
+var fs45 = __toESM(require("fs"));
 var os32 = __toESM(require("os"));
-var path52 = __toESM(require("path"));
+var path53 = __toESM(require("path"));
 var DOLT_INSTALL_SH_URL = "https://github.com/dolthub/dolt/releases/latest/download/install.sh";
 var DOLT_MSI_URL = "https://github.com/dolthub/dolt/releases/latest/download/dolt-windows-amd64.msi";
 function resolveDoltInstallStrategy(platform3) {
@@ -25465,7 +25723,7 @@ var _doltPathSeam = {
   },
   exists: (p2) => {
     try {
-      fs44.accessSync(p2, fs44.constants.F_OK);
+      fs45.accessSync(p2, fs45.constants.F_OK);
       return true;
     } catch {
       return false;
@@ -25476,7 +25734,7 @@ function doltBinaryNames(platform3) {
   return platform3 === "win32" ? ["dolt.exe", "dolt.cmd", "dolt"] : ["dolt"];
 }
 function knownDoltDirs(platform3) {
-  const P3 = platform3 === "win32" ? path52.win32 : path52.posix;
+  const P3 = platform3 === "win32" ? path53.win32 : path53.posix;
   const home = _doltPathSeam.homedir();
   if (platform3 === "win32") {
     return [
@@ -25492,7 +25750,7 @@ function knownDoltDirs(platform3) {
   ].filter(Boolean);
 }
 function ensureDoltResolvable(platform3 = process.platform) {
-  const P3 = platform3 === "win32" ? path52.win32 : path52.posix;
+  const P3 = platform3 === "win32" ? path53.win32 : path53.posix;
   const delim = platform3 === "win32" ? ";" : ":";
   const names = doltBinaryNames(platform3);
   const pathDirs = _doltPathSeam.getPath().split(delim).filter(Boolean);
@@ -25689,14 +25947,14 @@ var _linkSeam = {
   homedir: () => os33.homedir(),
   isWritableDir: (dir) => {
     try {
-      fs45.accessSync(dir, fs45.constants.W_OK);
+      fs46.accessSync(dir, fs46.constants.W_OK);
       return true;
     } catch {
       return false;
     }
   },
   ensureDir: (dir) => {
-    fs45.mkdirSync(dir, { recursive: true });
+    fs46.mkdirSync(dir, { recursive: true });
   },
   /**
    * A directory to symlink `bd` into so the AGENT's shell + Claude Code's
@@ -25717,9 +25975,9 @@ var _linkSeam = {
    * which `linkBdOntoPath` creates if missing.
    */
   cliBinDir: () => {
-    const pathDirs = (process.env.PATH ?? "").split(path53.delimiter).filter(Boolean);
+    const pathDirs = (process.env.PATH ?? "").split(path54.delimiter).filter(Boolean);
     const home = _linkSeam.homedir();
-    const localBin = home ? path53.join(home, ".local", "bin") : null;
+    const localBin = home ? path54.join(home, ".local", "bin") : null;
     if (localBin) {
       try {
         _linkSeam.ensureDir(localBin);
@@ -25729,16 +25987,16 @@ var _linkSeam = {
     const candidates = [];
     if (localBin) candidates.push(localBin);
     try {
-      candidates.push(path53.dirname(process.execPath));
+      candidates.push(path54.dirname(process.execPath));
     } catch {
     }
     candidates.push("/usr/local/bin");
     const entry = process.argv[1];
     if (entry) {
       try {
-        candidates.push(path53.dirname(fs45.realpathSync(entry)));
+        candidates.push(path54.dirname(fs46.realpathSync(entry)));
       } catch {
-        candidates.push(path53.dirname(entry));
+        candidates.push(path54.dirname(entry));
       }
     }
     const onPathWritable = candidates.find(
@@ -25750,20 +26008,20 @@ var _linkSeam = {
   /** Current symlink target at `linkPath`, or null when absent / not a link. */
   readlink: (linkPath) => {
     try {
-      return fs45.readlinkSync(linkPath);
+      return fs46.readlinkSync(linkPath);
     } catch {
       return null;
     }
   },
-  unlink: (linkPath) => fs45.unlinkSync(linkPath),
-  symlink: (target, linkPath) => fs45.symlinkSync(target, linkPath)
+  unlink: (linkPath) => fs46.unlinkSync(linkPath),
+  symlink: (target, linkPath) => fs46.symlinkSync(target, linkPath)
 };
 function linkBdOntoPath(binaryPath) {
   if (_linkSeam.platform() === "win32") return;
   const binDir = _linkSeam.cliBinDir();
   if (!binDir) return;
   _linkSeam.ensureDir(binDir);
-  const linkPath = path53.join(binDir, "bd");
+  const linkPath = path54.join(binDir, "bd");
   if (linkPath === binaryPath) return;
   const current2 = _linkSeam.readlink(linkPath);
   if (current2 === binaryPath) return;
@@ -25968,7 +26226,7 @@ function dedupeRecipes(agents) {
 
 // src/beads/watcher.ts
 var crypto4 = __toESM(require("crypto"));
-var path54 = __toESM(require("path"));
+var path55 = __toESM(require("path"));
 var API_BASE5 = resolveApiBaseUrl();
 var DEBOUNCE_MS2 = 400;
 var ZERO_SUMMARY = {
@@ -25992,7 +26250,7 @@ var BeadsWatcher = class {
   constructor(opts) {
     this.opts = opts;
     this.bd = opts.adapter ?? new BdAdapter({ cwd: opts.cwd, beadsDir: opts.beadsDir });
-    this.feedPath = opts.feedPath ?? path54.join(opts.cwd ?? process.cwd(), ".beads", "last-touched");
+    this.feedPath = opts.feedPath ?? path55.join(opts.cwd ?? process.cwd(), ".beads", "last-touched");
     this.apiBase = opts.apiBaseUrl ?? API_BASE5;
   }
   opts;
@@ -26409,9 +26667,9 @@ async function configureBeads(action, ctx, deps) {
       return { enabled: false, running: false };
     }
     const p3 = await deps.probe();
-    const running2 = p3.serverUp && p3.bdAvailable;
-    deps.emit({ type: "beads_status", state: running2 ? "enabled" : "disabled", running: running2, ...p3 });
-    return { enabled: running2, running: running2, ...p3 };
+    const running3 = p3.serverUp && p3.bdAvailable;
+    deps.emit({ type: "beads_status", state: running3 ? "enabled" : "disabled", running: running3, ...p3 });
+    return { enabled: running3, running: running3, ...p3 };
   }
   if (action === "disable") {
     deps.persist({ enabled: false });
@@ -26428,9 +26686,9 @@ async function configureBeads(action, ctx, deps) {
     return { enabled: false, ...p2 };
   }
   await deps.startWatcher().catch(() => void 0);
-  const running = true;
-  deps.emit({ type: "beads_status", state: "enabled", running, ...p2 });
-  return { enabled: true, running, ...p2 };
+  const running2 = true;
+  deps.emit({ type: "beads_status", state: "enabled", running: running2, ...p2 });
+  return { enabled: true, running: running2, ...p2 };
 }
 
 // src/skills/configure.ts
@@ -26567,8 +26825,8 @@ function cleanupAttachmentTempFiles() {
 function saveFilesTemp(files) {
   return files.filter(({ base64 }) => base64 && base64.length > 0).map(({ filename, base64 }) => {
     const safeName = filename.replace(/[^a-zA-Z0-9._-]/g, "_").slice(0, 80);
-    const tmpPath = path58.join(os39.tmpdir(), `codeam-${(0, import_crypto2.randomUUID)()}-${safeName}`);
-    fs50.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
+    const tmpPath = path59.join(os39.tmpdir(), `codeam-${(0, import_crypto2.randomUUID)()}-${safeName}`);
+    fs51.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
     pendingAttachmentFiles.add(tmpPath);
     return tmpPath;
   });
@@ -26803,10 +27061,10 @@ var listFiles = async (ctx, cmd, parsed) => {
   await ctx.relay.sendResult(cmd.id, "completed", result);
 };
 var envReadH = async (ctx, cmd) => {
-  const envPath = path58.join(process.cwd(), ".env");
+  const envPath = path59.join(process.cwd(), ".env");
   await restoreProjectEnvIfMissing(process.cwd(), ctx);
   try {
-    const raw = await fs50.promises.readFile(envPath, "utf8");
+    const raw = await fs51.promises.readFile(envPath, "utf8");
     await ctx.relay.sendResult(cmd.id, "completed", {
       exists: true,
       vars: parseDotenv(raw)
@@ -26835,7 +27093,7 @@ var envParseH = async (ctx, cmd, parsed) => {
   const existing = /* @__PURE__ */ new Map();
   if (!replace) {
     try {
-      const raw = await fs50.promises.readFile(path58.join(process.cwd(), ".env"), "utf8");
+      const raw = await fs51.promises.readFile(path59.join(process.cwd(), ".env"), "utf8");
       for (const v of parseDotenv(raw)) existing.set(v.key, v.value);
     } catch {
     }
@@ -26875,15 +27133,15 @@ var envWriteH = async (ctx, cmd, parsed) => {
     }
     seen2.add(v.key);
   }
-  const envPath = path58.join(process.cwd(), ".env");
-  const tmpPath = path58.join(process.cwd(), ".env.codeam.tmp");
+  const envPath = path59.join(process.cwd(), ".env");
+  const tmpPath = path59.join(process.cwd(), ".env.codeam.tmp");
   try {
-    await fs50.promises.writeFile(tmpPath, serializeDotenv(vars), "utf8");
-    await fs50.promises.rename(tmpPath, envPath);
+    await fs51.promises.writeFile(tmpPath, serializeDotenv(vars), "utf8");
+    await fs51.promises.rename(tmpPath, envPath);
     await ctx.relay.sendResult(cmd.id, "completed", { ok: true, count: vars.length });
     void syncProjectEnvUp(process.cwd(), ctx);
   } catch (err) {
-    await fs50.promises.rm(tmpPath, { force: true }).catch(() => void 0);
+    await fs51.promises.rm(tmpPath, { force: true }).catch(() => void 0);
     await ctx.relay.sendResult(cmd.id, "failed", { error: err.message });
   }
 };
@@ -27215,9 +27473,9 @@ var CLI_UPDATE_MAX_ATTEMPTS = 3;
 function buildNpmInstallInvocation(opts) {
   const entryScript = opts?.entryScript ?? process.argv[1] ?? "";
   const execPath = opts?.execPath ?? process.execPath;
-  const exists2 = opts?.existsSync ?? fs50.existsSync;
+  const exists2 = opts?.existsSync ?? fs51.existsSync;
   const platform3 = opts?.platform ?? process.platform;
-  const p2 = platform3 === "win32" ? path58.win32 : path58.posix;
+  const p2 = platform3 === "win32" ? path59.win32 : path59.posix;
   const normalized = entryScript.split(/[\\/]/).join("/");
   const marker = "/lib/node_modules/codeam-cli/";
   const markerIdx = normalized.indexOf(marker);
@@ -27239,7 +27497,7 @@ function isPermissionError(stderr) {
 function resolveGlobalNodeModulesDir(opts) {
   const entryScript = opts?.entryScript ?? process.argv[1] ?? "";
   const platform3 = opts?.platform ?? process.platform;
-  const p2 = platform3 === "win32" ? path58.win32 : path58.posix;
+  const p2 = platform3 === "win32" ? path59.win32 : path59.posix;
   const marker = "/lib/node_modules/codeam-cli/";
   const markerIdx = entryScript.split(/[\\/]/).join("/").indexOf(marker);
   if (markerIdx <= 0) return null;
@@ -27249,19 +27507,19 @@ function resolveGlobalNodeModulesDir(opts) {
 var STALE_STAGING_AGE_MS = CLI_UPDATE_INSTALL_TIMEOUT_MS;
 function sweepStaleCliStagingDirs(nodeModulesDir, now = Date.now(), deps) {
   if (!nodeModulesDir) return 0;
-  const readdirSync12 = deps?.readdirSync ?? fs50.readdirSync;
-  const statSync15 = deps?.statSync ?? fs50.statSync;
-  const rmSync9 = deps?.rmSync ?? fs50.rmSync;
+  const readdirSync13 = deps?.readdirSync ?? fs51.readdirSync;
+  const statSync15 = deps?.statSync ?? fs51.statSync;
+  const rmSync9 = deps?.rmSync ?? fs51.rmSync;
   let removed = 0;
   let entries;
   try {
-    entries = readdirSync12(nodeModulesDir);
+    entries = readdirSync13(nodeModulesDir);
   } catch {
     return 0;
   }
   for (const name of entries) {
     if (!/^\.codeam-cli-/.test(name)) continue;
-    const full = path58.join(nodeModulesDir, name);
+    const full = path59.join(nodeModulesDir, name);
     try {
       const st3 = statSync15(full);
       if (now - st3.mtimeMs < STALE_STAGING_AGE_MS) continue;
@@ -27650,114 +27908,106 @@ async function runDetectOneShot(generate, timeoutMs = PREVIEW_DETECT_TIMEOUT_MS)
     if (timer) clearTimeout(timer);
   }
 }
-var requestPreviewDetectH = (ctx) => {
-  if (!ctx.pluginAuthToken) {
-    log.info("preview", "no pluginAuthToken \u2014 skipping detect");
-    return;
-  }
-  if (typeof ctx.runtime.generateOneShot !== "function") {
-    log.info("preview", `runtime ${ctx.runtime.id} has no generateOneShot \u2014 emitting unsupported`);
+function originPayload(payload, origin) {
+  if (origin !== "agent") return payload;
+  return { ...payload ?? {}, origin };
+}
+async function resolvePreviewDetection(args2) {
+  const { ctx, runtime, pluginAuthToken, origin } = args2;
+  const emit2 = (type, payload) => {
     emitPreviewEvent({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
-      pluginAuthToken: ctx.pluginAuthToken,
-      type: USER_EVENTS.PREVIEW_ERROR,
-      payload: {
-        stage: "detection",
-        message: `Preview detection isn't available on ${ctx.runtime.id} sessions yet \u2014 link a Claude or Codex agent.`
-      }
+      pluginAuthToken,
+      type,
+      payload: originPayload(payload, origin)
     });
-    return;
+  };
+  if (typeof runtime.generateOneShot !== "function") {
+    log.info("preview", `runtime ${runtime.id} has no generateOneShot \u2014 emitting unsupported`);
+    emit2(USER_EVENTS.PREVIEW_ERROR, {
+      stage: "detection",
+      message: `Preview detection isn't available on ${runtime.id} sessions yet \u2014 link a Claude or Codex agent.`
+    });
+    return null;
   }
-  const pluginAuthToken = ctx.pluginAuthToken;
-  const generateOneShot = ctx.runtime.generateOneShot.bind(ctx.runtime);
-  void (async () => {
-    const fromFile = await readPreviewConfig(process.cwd());
-    if (fromFile) {
-      log.info("preview", `detect: using .codeam/preview.json (${fromFile.framework})`);
-      emitPreviewEvent({
-        sessionId: ctx.sessionId,
-        pluginId: ctx.pluginId,
-        pluginAuthToken,
-        type: USER_EVENTS.PREVIEW_DETECTION_READY,
-        payload: { detection: fromFile }
-      });
-      return;
-    }
-    emitPreviewEvent({
-      sessionId: ctx.sessionId,
-      pluginId: ctx.pluginId,
-      pluginAuthToken,
-      type: USER_EVENTS.PREVIEW_DETECTION_PENDING
+  const generateOneShot = runtime.generateOneShot.bind(runtime);
+  const fromFile = await readPreviewConfig(process.cwd());
+  if (fromFile) {
+    log.info("preview", `detect: using .codeam/preview.json (${fromFile.framework})`);
+    return fromFile;
+  }
+  emit2(USER_EVENTS.PREVIEW_DETECTION_PENDING);
+  log.info("preview", "detect: invoking generateOneShot");
+  const startedAt = Date.now();
+  const { raw, timedOut, stderr } = await runDetectOneShot(generateOneShot);
+  const tookMs = Date.now() - startedAt;
+  if (timedOut) {
+    log.info("preview", `detect: timed out after ${tookMs}ms \u2014 emitting preview_error`);
+    emit2(USER_EVENTS.PREVIEW_ERROR, {
+      stage: "detection",
+      message: `Project detection timed out after ${Math.round(PREVIEW_DETECT_TIMEOUT_MS / 1e3)} s \u2014 the agent did not answer. Try again, or add a .codeam/preview.json override.`
     });
-    log.info("preview", "detect: invoking generateOneShot");
-    const startedAt = Date.now();
-    const { raw, timedOut, stderr } = await runDetectOneShot(generateOneShot);
-    const tookMs = Date.now() - startedAt;
-    if (timedOut) {
-      log.info("preview", `detect: timed out after ${tookMs}ms \u2014 emitting preview_error`);
-      emitPreviewEvent({
-        sessionId: ctx.sessionId,
-        pluginId: ctx.pluginId,
-        pluginAuthToken,
-        type: USER_EVENTS.PREVIEW_ERROR,
-        payload: {
-          stage: "detection",
-          message: `Project detection timed out after ${Math.round(PREVIEW_DETECT_TIMEOUT_MS / 1e3)} s \u2014 the agent did not answer. Try again, or add a .codeam/preview.json override.`
-        }
-      });
-      return;
-    }
-    const detection = safeParseDetection(raw);
-    if (!detection) {
-      const failure = describeDetectionFailure(raw);
-      log.info(
-        "preview",
-        `detect: failed after ${tookMs}ms reason=${failure?.reason ?? "unknown"}` + (failure?.missing ? ` missing=${failure.missing.join(",")}` : "") + `
+    return null;
+  }
+  const detection = safeParseDetection(raw);
+  if (!detection) {
+    const failure = describeDetectionFailure(raw);
+    log.info(
+      "preview",
+      `detect: failed after ${tookMs}ms reason=${failure?.reason ?? "unknown"}` + (failure?.missing ? ` missing=${failure.missing.join(",")}` : "") + `
 --- salida cruda del agente (acotada) ---
 ${failure?.rawExcerpt ?? ""}`
-      );
-      emitPreviewEvent({
-        sessionId: ctx.sessionId,
-        pluginId: ctx.pluginId,
-        pluginAuthToken,
-        type: USER_EVENTS.PREVIEW_ERROR,
-        payload: {
-          stage: "detection",
-          // El mensaje sale del diagnostico: decir "JSON invalido" cuando el
-          // agente no contesto manda al usuario a mirar un JSON que no existe.
-          message: (failure?.reason === "no_output" ? describeOneShotAgentError(stderr) : null) ?? failure?.message ?? "Agent returned invalid JSON. Try again, or add a .codeam/preview.json override."
-        }
-      });
-      return;
-    }
-    if (isUnsupportedDetection(detection)) {
-      log.info("preview", "detect: framework=unsupported");
-      emitPreviewEvent({
-        sessionId: ctx.sessionId,
-        pluginId: ctx.pluginId,
-        pluginAuthToken,
-        type: USER_EVENTS.PREVIEW_ERROR,
-        payload: {
-          stage: "unsupported",
-          message: detection.notes ?? "No dev server applies to this project."
-        }
-      });
-      return;
-    }
-    log.info("preview", `detect: ${detection.framework} on :${detection.port} (took ${tookMs}ms)`);
-    void writePreviewConfig(process.cwd(), detection).catch((err) => {
-      log.info("preview", `detect: writePreviewConfig failed (non-fatal): ${String(err)}`);
+    );
+    emit2(USER_EVENTS.PREVIEW_ERROR, {
+      stage: "detection",
+      // El mensaje sale del diagnostico: decir "JSON invalido" cuando el
+      // agente no contesto manda al usuario a mirar un JSON que no existe.
+      message: (failure?.reason === "no_output" ? describeOneShotAgentError(stderr) : null) ?? failure?.message ?? "Agent returned invalid JSON. Try again, or add a .codeam/preview.json override."
+    });
+    return null;
+  }
+  if (isUnsupportedDetection(detection)) {
+    log.info("preview", "detect: framework=unsupported");
+    emit2(USER_EVENTS.PREVIEW_ERROR, {
+      stage: "unsupported",
+      message: detection.notes ?? "No dev server applies to this project."
     });
+    return null;
+  }
+  log.info("preview", `detect: ${detection.framework} on :${detection.port} (took ${tookMs}ms)`);
+  void writePreviewConfig(process.cwd(), detection).catch((err) => {
+    log.info("preview", `detect: writePreviewConfig failed (non-fatal): ${String(err)}`);
+  });
+  return detection;
+}
+var requestPreviewDetectH = (ctx) => {
+  if (!ctx.pluginAuthToken) {
+    log.info("preview", "no pluginAuthToken \u2014 skipping detect");
+    return;
+  }
+  const pluginAuthToken = ctx.pluginAuthToken;
+  void (async () => {
+    const detection = await resolvePreviewDetection({ ctx, runtime: ctx.runtime, pluginAuthToken });
+    if (!detection) return;
     emitPreviewEvent({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
       pluginAuthToken,
       type: USER_EVENTS.PREVIEW_DETECTION_READY,
-      payload: { detection }
+      payload: { detection: withScriptCandidates(detection) }
     });
   })();
 };
+function withScriptCandidates(detection) {
+  try {
+    const candidates = listScriptCandidates(process.cwd());
+    return candidates.length > 0 ? { ...detection, candidates } : detection;
+  } catch (err) {
+    log.info("preview", `detect: listing script candidates failed (non-fatal): ${String(err)}`);
+    return detection;
+  }
+}
 var previewPrewarmStarted = false;
 function makePreviewReaffirm(args2) {
   const token = args2.pluginAuthToken;
@@ -27787,6 +28037,7 @@ function makePreviewReaffirm(args2) {
 function prewarmPreviewDetection(runtime) {
   if (previewPrewarmStarted) return;
   previewPrewarmStarted = true;
+  void prewarmNodeDeps(process.cwd());
   if (typeof runtime.generateOneShot !== "function") return;
   const generateOneShot = runtime.generateOneShot.bind(runtime);
   void (async () => {
@@ -27821,19 +28072,21 @@ var previewStartH = (ctx, _cmd, parsed) => {
     log.info("preview", "start: no detection in payload");
     return;
   }
-  startPreviewFromDetection(ctx, rawDetection, ctx.pluginAuthToken);
+  void startPreviewFromDetection(ctx, rawDetection, ctx.pluginAuthToken);
 };
-function startPreviewFromDetection(ctx, detection, pluginAuthToken) {
+function startPreviewFromDetection(ctx, detection, pluginAuthToken, opts = {}) {
   const emit2 = (type, payload) => {
+    const tagged = originPayload(payload, opts.origin) ?? {};
+    opts.onEvent?.(type, tagged);
     emitPreviewEvent({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
       pluginAuthToken,
       type,
-      payload
+      payload: tagged
     });
   };
-  runPreviewStart({
+  return runPreviewStart({
     sessionId: ctx.sessionId,
     detection,
     cwd: process.cwd(),
@@ -27864,7 +28117,7 @@ function maybeAttachBuildHeal(ctx, pluginAuthToken) {
         if (!activePreviews.has(ctx.sessionId)) return;
         await killPreview(ctx.sessionId);
         await new Promise((r) => setTimeout(r, 150));
-        startPreviewFromDetection(ctx, preview.detection, pluginAuthToken);
+        void startPreviewFromDetection(ctx, preview.detection, pluginAuthToken);
       })();
     },
     notify: (message) => {
@@ -27910,7 +28163,7 @@ var previewRestartH = async (ctx, cmd) => {
   }
   await killPreview(ctx.sessionId);
   await new Promise((r) => setTimeout(r, 150));
-  startPreviewFromDetection(ctx, preview.detection, ctx.pluginAuthToken);
+  void startPreviewFromDetection(ctx, preview.detection, ctx.pluginAuthToken);
   await ctx.relay.sendResult(cmd.id, "completed", { restarted: true });
 };
 var savePreviewConfigH = (_ctx, _cmd, parsed) => {
@@ -28283,11 +28536,11 @@ function resolveTokenValue(args2) {
   }
   const fileFlag = args2.find((a) => a.startsWith("--token-file="));
   if (fileFlag) {
-    const path95 = fileFlag.slice("--token-file=".length);
+    const path96 = fileFlag.slice("--token-file=".length);
     try {
-      const content = fs51.readFileSync(path95, "utf8").trim();
-      if (content.length === 0) fail(`--token-file ${path95} is empty`);
-      rmIfExistsQuiet(path95);
+      const content = fs52.readFileSync(path96, "utf8").trim();
+      if (content.length === 0) fail(`--token-file ${path96} is empty`);
+      rmIfExistsQuiet(path96);
       return content;
     } catch (err) {
       fail(`Could not read --token-file: ${err.message}`);
@@ -28379,12 +28632,12 @@ async function claim(token, pluginId, pluginSecretHash) {
   }
 }
 function pairAutoLockPath() {
-  return path59.join(os40.homedir(), ".codeam", "pair-auto.lock");
+  return path60.join(os40.homedir(), ".codeam", "pair-auto.lock");
 }
 var procRoot = "/proc";
 function readProcFile(rel) {
   try {
-    return fs51.readFileSync(path59.join(procRoot, rel), "utf8");
+    return fs52.readFileSync(path60.join(procRoot, rel), "utf8");
   } catch {
     return void 0;
   }
@@ -28405,7 +28658,7 @@ function currentBootId() {
 function readLockRecord(lockPath) {
   let raw;
   try {
-    raw = fs51.readFileSync(lockPath, "utf8");
+    raw = fs52.readFileSync(lockPath, "utf8");
   } catch {
     return void 0;
   }
@@ -28454,24 +28707,24 @@ function isLiveLockHolder(rec) {
 }
 function releaseOwnLock(lockPath) {
   try {
-    if (readLockRecord(lockPath)?.pid === process.pid) fs51.unlinkSync(lockPath);
+    if (readLockRecord(lockPath)?.pid === process.pid) fs52.unlinkSync(lockPath);
   } catch {
   }
 }
 function daemonLockPath(sessionId) {
   const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, "_");
-  return path59.join(os40.homedir(), ".codeam", `daemon-${safe}.lock`);
+  return path60.join(os40.homedir(), ".codeam", `daemon-${safe}.lock`);
 }
 function acquireDaemonLock(sessionId) {
   const lockPath = daemonLockPath(sessionId);
   try {
-    fs51.mkdirSync(path59.dirname(lockPath), { recursive: true });
+    fs52.mkdirSync(path60.dirname(lockPath), { recursive: true });
     try {
-      fs51.writeFileSync(lockPath, ownLockBody(), { flag: "wx" });
+      fs52.writeFileSync(lockPath, ownLockBody(), { flag: "wx" });
     } catch (e) {
       if (e.code !== "EEXIST") throw e;
       if (isLiveLockHolder(readLockRecord(lockPath))) return false;
-      fs51.writeFileSync(lockPath, ownLockBody());
+      fs52.writeFileSync(lockPath, ownLockBody());
     }
     const release3 = () => releaseOwnLock(lockPath);
     process.once("exit", release3);
@@ -28491,13 +28744,13 @@ function acquireDaemonLock(sessionId) {
 function acquireSingletonLock() {
   const lockPath = pairAutoLockPath();
   try {
-    fs51.mkdirSync(path59.dirname(lockPath), { recursive: true });
+    fs52.mkdirSync(path60.dirname(lockPath), { recursive: true });
     try {
-      fs51.writeFileSync(lockPath, ownLockBody(), { flag: "wx" });
+      fs52.writeFileSync(lockPath, ownLockBody(), { flag: "wx" });
     } catch (e) {
       if (e.code !== "EEXIST") throw e;
       if (isLiveLockHolder(readLockRecord(lockPath))) return false;
-      fs51.writeFileSync(lockPath, ownLockBody());
+      fs52.writeFileSync(lockPath, ownLockBody());
     }
     process.once("exit", () => releaseOwnLock(lockPath));
     return true;
@@ -28914,7 +29167,7 @@ var AgentService = class _AgentService {
 };
 
 // src/agents/acp/adapters.ts
-var path60 = __toESM(require("path"));
+var path61 = __toESM(require("path"));
 
 // src/agents/kimi/installer.ts
 var import_node_child_process19 = require("child_process");
@@ -29034,13 +29287,13 @@ function resolveBin(pkgName, binName) {
   try {
     const manifestPath = require_.resolve(`${pkgName}/package.json`);
     const manifest = require_(`${pkgName}/package.json`);
-    const pkgDir = path60.dirname(manifestPath);
+    const pkgDir = path61.dirname(manifestPath);
     const bin = manifest.bin;
     if (!bin) return null;
-    if (typeof bin === "string") return path60.resolve(pkgDir, bin);
+    if (typeof bin === "string") return path61.resolve(pkgDir, bin);
     const target = binName ?? Object.keys(bin)[0];
     if (!target || !bin[target]) return null;
-    return path60.resolve(pkgDir, bin[target]);
+    return path61.resolve(pkgDir, bin[target]);
   } catch {
     return null;
   }
@@ -29220,30 +29473,30 @@ async function resolveAcpAdapterWithRetry(agent, opts = {}) {
 }
 
 // src/agents/acp/runner.ts
-var import_node_crypto10 = require("crypto");
-var fs68 = __toESM(require("fs"));
+var import_node_crypto11 = require("crypto");
+var fs69 = __toESM(require("fs"));
 var os53 = __toESM(require("os"));
-var path79 = __toESM(require("path"));
+var path80 = __toESM(require("path"));
 
 // src/lib/provider-routing.ts
-var fs53 = __toESM(require("fs"));
+var fs54 = __toESM(require("fs"));
 var os42 = __toESM(require("os"));
-var path62 = __toESM(require("path"));
+var path63 = __toESM(require("path"));
 
 // src/commands/host/house-proxy-config.ts
-var fs52 = __toESM(require("fs"));
+var fs53 = __toESM(require("fs"));
 var os41 = __toESM(require("os"));
-var path61 = __toESM(require("path"));
+var path62 = __toESM(require("path"));
 function houseProxyConfigPath() {
-  return path61.join(os41.homedir(), ".codeam", "house-proxy.json");
+  return path62.join(os41.homedir(), ".codeam", "house-proxy.json");
 }
 function persistHouseProxyConfig(config) {
   try {
     const file = houseProxyConfigPath();
-    fs52.mkdirSync(path61.dirname(file), { recursive: true, mode: 448 });
+    fs53.mkdirSync(path62.dirname(file), { recursive: true, mode: 448 });
     const tmp = `${file}.tmp-${process.pid}`;
-    fs52.writeFileSync(tmp, JSON.stringify(config, null, 2), { encoding: "utf8", mode: 384 });
-    fs52.renameSync(tmp, file);
+    fs53.writeFileSync(tmp, JSON.stringify(config, null, 2), { encoding: "utf8", mode: 384 });
+    fs53.renameSync(tmp, file);
     restrictToOwner(file);
   } catch (err) {
     log.warn(
@@ -29254,13 +29507,13 @@ function persistHouseProxyConfig(config) {
 }
 function clearHouseProxyConfig() {
   try {
-    fs52.rmSync(houseProxyConfigPath(), { force: true });
+    fs53.rmSync(houseProxyConfigPath(), { force: true });
   } catch {
   }
 }
 function readHouseProxyChildEnv() {
   try {
-    const raw = fs52.readFileSync(houseProxyConfigPath(), "utf8");
+    const raw = fs53.readFileSync(houseProxyConfigPath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed !== "object" || parsed === null) return {};
     const o = parsed;
@@ -29387,14 +29640,14 @@ function redactUrlToOrigin(raw) {
 }
 function readOpencodeProviderOrigins(opts = {}) {
   const home = opts.homeDir ?? os42.homedir();
-  const readFile7 = opts.readFile ?? ((f) => fs53.readFileSync(f, "utf8"));
+  const readFile7 = opts.readFile ?? ((f) => fs54.readFileSync(f, "utf8"));
   const candidates = [];
   if (opts.cwd) {
-    candidates.push(path62.join(opts.cwd, "opencode.json"), path62.join(opts.cwd, "opencode.jsonc"));
+    candidates.push(path63.join(opts.cwd, "opencode.json"), path63.join(opts.cwd, "opencode.jsonc"));
   }
   candidates.push(
-    path62.join(home, ".config", "opencode", "opencode.json"),
-    path62.join(home, ".config", "opencode", "opencode.jsonc")
+    path63.join(home, ".config", "opencode", "opencode.json"),
+    path63.join(home, ".config", "opencode", "opencode.jsonc")
   );
   const out2 = [];
   const seen2 = /* @__PURE__ */ new Set();
@@ -29501,8 +29754,8 @@ function noteProviderBillingSignal(opts) {
 }
 
 // src/services/history.service.ts
-var fs54 = __toESM(require("fs"));
-var path63 = __toESM(require("path"));
+var fs55 = __toESM(require("fs"));
+var path64 = __toESM(require("path"));
 var os43 = __toESM(require("os"));
 var https6 = __toESM(require("https"));
 var http9 = __toESM(require("http"));
@@ -29564,7 +29817,7 @@ function parseJsonl(filePath) {
   const messages = [];
   let raw;
   try {
-    raw = fs54.readFileSync(filePath, "utf8");
+    raw = fs55.readFileSync(filePath, "utf8");
   } catch (err) {
     if (err.code !== "ENOENT") {
       log.warn("history:parseJsonl", `read failed for ${filePath}`, err);
@@ -29718,7 +29971,7 @@ var HistoryService = class _HistoryService {
     return this._quotaPercent === null || Date.now() - this._quotaFetchedAt > ttlMs;
   }
   get projectDir() {
-    return this.runtime.resolveHistoryDir(this.cwd) ?? path63.join(os43.homedir(), ".claude", "projects", encodeCwd(this.cwd));
+    return this.runtime.resolveHistoryDir(this.cwd) ?? path64.join(os43.homedir(), ".claude", "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -29730,7 +29983,7 @@ var HistoryService = class _HistoryService {
   /** Return the current message count in the active conversation. */
   getCurrentMessageCount() {
     if (!this.currentConversationId) return 0;
-    const filePath = path63.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+    const filePath = path64.join(this.projectDir, `${this.currentConversationId}.jsonl`);
     return parseJsonl(filePath).length;
   }
   /**
@@ -29741,7 +29994,7 @@ var HistoryService = class _HistoryService {
     const deadline = Date.now() + timeoutMs;
     while (Date.now() < deadline) {
       if (!this.currentConversationId) return null;
-      const filePath = path63.join(this.projectDir, `${this.currentConversationId}.jsonl`);
+      const filePath = path64.join(this.projectDir, `${this.currentConversationId}.jsonl`);
       const messages = parseJsonl(filePath);
       if (messages.length > previousCount) {
         for (let i = messages.length - 1; i >= previousCount; i--) {
@@ -29767,16 +30020,16 @@ var HistoryService = class _HistoryService {
     const dir = this.projectDir;
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     try {
-      const files = fs54.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
+      const files = fs55.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
         try {
-          const stat3 = fs54.statSync(path63.join(dir, e.name));
+          const stat3 = fs55.statSync(path64.join(dir, e.name));
           return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
         } catch {
           return { name: e.name, mtime: 0, birthtime: 0 };
         }
       }).filter((f) => f.birthtime >= cutoff).sort((a, b) => b.mtime - a.mtime);
       if (files.length > 0) {
-        this.currentConversationId = path63.basename(files[0].name, ".jsonl");
+        this.currentConversationId = path64.basename(files[0].name, ".jsonl");
       }
     } catch {
     }
@@ -29810,13 +30063,13 @@ var HistoryService = class _HistoryService {
     const cutoff = this.bootTimeMs - _HistoryService.BIRTHTIME_GRACE_MS;
     let entries;
     try {
-      entries = fs54.readdirSync(dir, { withFileTypes: true });
+      entries = fs55.readdirSync(dir, { withFileTypes: true });
     } catch {
       return null;
     }
     const files = entries.filter((e) => e.isFile() && e.name.endsWith(".jsonl")).map((e) => {
       try {
-        const stat3 = fs54.statSync(path63.join(dir, e.name));
+        const stat3 = fs55.statSync(path64.join(dir, e.name));
         return { name: e.name, mtime: stat3.mtimeMs, birthtime: stat3.birthtimeMs };
       } catch {
         return { name: e.name, mtime: 0, birthtime: 0 };
@@ -29825,12 +30078,12 @@ var HistoryService = class _HistoryService {
     if (files.length === 0) return null;
     const targetFile = this.currentConversationId ? `${this.currentConversationId}.jsonl` : files[0].name;
     if (!files.some((f) => f.name === targetFile)) return null;
-    return this.extractUsageFromFile(path63.join(dir, targetFile));
+    return this.extractUsageFromFile(path64.join(dir, targetFile));
   }
   extractUsageFromFile(filePath) {
     let raw;
     try {
-      raw = fs54.readFileSync(filePath, "utf8");
+      raw = fs55.readFileSync(filePath, "utf8");
     } catch {
       return null;
     }
@@ -29882,9 +30135,9 @@ var HistoryService = class _HistoryService {
     let totalCost = 0;
     let files;
     try {
-      files = fs54.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
+      files = fs55.readdirSync(projectDir).filter((f) => f.endsWith(".jsonl")).filter((f) => {
         try {
-          return fs54.statSync(path63.join(projectDir, f)).mtimeMs >= monthStartMs;
+          return fs55.statSync(path64.join(projectDir, f)).mtimeMs >= monthStartMs;
         } catch {
           return false;
         }
@@ -29895,7 +30148,7 @@ var HistoryService = class _HistoryService {
     for (const file of files) {
       let raw;
       try {
-        raw = fs54.readFileSync(path63.join(projectDir, file), "utf8");
+        raw = fs55.readFileSync(path64.join(projectDir, file), "utf8");
       } catch {
         continue;
       }
@@ -29974,7 +30227,7 @@ var HistoryService = class _HistoryService {
     if (this.runtime.resolveHistoryFile) {
       return this.runtime.resolveHistoryFile(this.cwd, sessionId);
     }
-    return path63.join(this.projectDir, `${sessionId}.jsonl`);
+    return path64.join(this.projectDir, `${sessionId}.jsonl`);
   }
   /**
    * Parse a conversation's messages from disk, agent-aware. Claude uses the
@@ -30012,14 +30265,14 @@ var HistoryService = class _HistoryService {
         };
       });
     }
-    return parseJsonl(path63.join(this.projectDir, `${sessionId}.jsonl`));
+    return parseJsonl(path64.join(this.projectDir, `${sessionId}.jsonl`));
   }
   /** One in-flight full upload per conversation — the baton mirror and a
    *  `get_conversation` used to upload the same transcript concurrently. */
   uploadsInFlight = /* @__PURE__ */ new Map();
   async loadConversation(sessionId) {
-    const inFlight = this.uploadsInFlight.get(sessionId);
-    if (inFlight) return inFlight;
+    const inFlight2 = this.uploadsInFlight.get(sessionId);
+    if (inFlight2) return inFlight2;
     const run = this.loadConversationNow(sessionId).finally(() => {
       this.uploadsInFlight.delete(sessionId);
     });
@@ -30094,7 +30347,7 @@ var HistoryService = class _HistoryService {
     if (!filePath) return false;
     let mtimeMs;
     try {
-      mtimeMs = fs54.statSync(filePath).mtimeMs;
+      mtimeMs = fs55.statSync(filePath).mtimeMs;
     } catch {
       return false;
     }
@@ -30169,10 +30422,10 @@ var HistoryService = class _HistoryService {
 
 // src/agents/acp/client.ts
 var import_node_child_process21 = require("child_process");
-var fs55 = __toESM(require("fs/promises"));
+var fs56 = __toESM(require("fs/promises"));
 var fsSync = __toESM(require("fs"));
 var os45 = __toESM(require("os"));
-var path65 = __toESM(require("path"));
+var path66 = __toESM(require("path"));
 var import_node_stream = require("stream");
 
 // ../../node_modules/@agentclientprotocol/sdk/dist/schema/index.js
@@ -34198,7 +34451,7 @@ function createIdleTimeout(idleMs, makeError, activeIdleMs = idleMs) {
 }
 
 // src/agents/acp/internal-paths.ts
-var path64 = __toESM(require("path"));
+var path65 = __toESM(require("path"));
 var os44 = __toESM(require("os"));
 var INTERNAL_TOKENS = [".codeam", "house-claude"];
 var PROSE_ONLY_TOOL_KINDS = /* @__PURE__ */ new Set(["think", "switch_mode"]);
@@ -34213,11 +34466,11 @@ function textReferencesInternal(text) {
 }
 function pathIsInternal(p2, homeDir2 = os44.homedir()) {
   if (!p2) return false;
-  const abs = path64.resolve(p2);
-  const home = path64.resolve(homeDir2);
-  const within = (root) => abs === root || abs.startsWith(root + path64.sep);
-  if (within(path64.join(home, ".codeam", "self-hosted"))) return false;
-  return within(path64.join(home, ".codeam")) || within(path64.join(home, ".beads")) || abs === path64.join(home, ".codeam-host.log") || abs.includes(`${path64.sep}house-claude${path64.sep}`) || abs.endsWith(`${path64.sep}house-claude`);
+  const abs = path65.resolve(p2);
+  const home = path65.resolve(homeDir2);
+  const within = (root) => abs === root || abs.startsWith(root + path65.sep);
+  if (within(path65.join(home, ".codeam", "self-hosted"))) return false;
+  return within(path65.join(home, ".codeam")) || within(path65.join(home, ".beads")) || abs === path65.join(home, ".codeam-host.log") || abs.includes(`${path65.sep}house-claude${path65.sep}`) || abs.endsWith(`${path65.sep}house-claude`);
 }
 function toolCallReferencesInternal(call, homeDir2) {
   if (call.locations?.some((l) => pathIsInternal(l.path, homeDir2))) return true;
@@ -35312,7 +35565,7 @@ var AcpClient = class {
           throw new RequestError(-32002, GUARDRAIL_SECRET_READ_BLOCK_REASON, { uri: params.path });
         }
         try {
-          const content = await fs55.readFile(params.path, "utf8");
+          const content = await fs56.readFile(params.path, "utf8");
           return applyLineRange(content, params.line ?? null, params.limit ?? null);
         } catch (err) {
           const code = err.code;
@@ -35333,7 +35586,7 @@ var AcpClient = class {
           throw new RequestError(-32002, INTERNAL_BLOCK_REASON, { uri: params.path });
         }
         try {
-          await fs55.writeFile(params.path, params.content, "utf8");
+          await fs56.writeFile(params.path, params.content, "utf8");
           return {};
         } catch (err) {
           const code = err.code;
@@ -35426,25 +35679,25 @@ function knownAgentBinaryDirs() {
   out2.push("/tmp/codeam-node20/bin");
   for (const root of [
     "/usr/local/share/nvm/versions/node",
-    path65.join(home, ".nvm/versions/node")
+    path66.join(home, ".nvm/versions/node")
   ]) {
     try {
       for (const child of fsSync.readdirSync(root)) {
-        out2.push(path65.join(root, child, "bin"));
+        out2.push(path66.join(root, child, "bin"));
       }
     } catch {
     }
   }
-  out2.push(path65.join(home, ".volta/bin"));
+  out2.push(path66.join(home, ".volta/bin"));
   out2.push("/usr/local/bin");
   out2.push("/usr/bin");
-  out2.push(path65.join(home, ".local/bin"));
-  out2.push(path65.join(home, "bin"));
+  out2.push(path66.join(home, ".local/bin"));
+  out2.push(path66.join(home, "bin"));
   out2.push(...agentInstallBinDirs());
   if (process.platform === "win32") {
     const { LOCALAPPDATA, APPDATA } = process.env;
-    if (LOCALAPPDATA) out2.push(path65.join(LOCALAPPDATA, "cursor-agent"));
-    if (APPDATA) out2.push(path65.join(APPDATA, "npm"));
+    if (LOCALAPPDATA) out2.push(path66.join(LOCALAPPDATA, "cursor-agent"));
+    if (APPDATA) out2.push(path66.join(APPDATA, "npm"));
   }
   return out2.filter((p2) => {
     try {
@@ -35455,7 +35708,7 @@ function knownAgentBinaryDirs() {
   });
 }
 function expandPathForAgentBinaries(existingPath) {
-  const existing = new Set(existingPath.split(path65.delimiter).filter((p2) => p2.length > 0));
+  const existing = new Set(existingPath.split(path66.delimiter).filter((p2) => p2.length > 0));
   const additions = [];
   for (const dir of knownAgentBinaryDirs()) {
     if (!existing.has(dir)) {
@@ -35464,7 +35717,7 @@ function expandPathForAgentBinaries(existingPath) {
     }
   }
   if (additions.length === 0) return existingPath;
-  return [...additions, existingPath].filter((p2) => p2.length > 0).join(path65.delimiter);
+  return [...additions, existingPath].filter((p2) => p2.length > 0).join(path66.delimiter);
 }
 
 // src/commands/host/agent-install.ts
@@ -35736,9 +35989,9 @@ async function performAgentSwitch(deps, rawAgentId, fastPath = {}) {
 }
 
 // src/commands/host/agent-provisioning.ts
-var fs56 = __toESM(require("fs"));
+var fs57 = __toESM(require("fs"));
 var os47 = __toESM(require("os"));
-var path66 = __toESM(require("path"));
+var path67 = __toESM(require("path"));
 var PUBLIC_TO_INTERNAL_AGENT = {
   claude_code: "claude",
   claude: "claude",
@@ -35755,22 +36008,22 @@ function toInternalAgentId(publicAgentId) {
   return PUBLIC_TO_INTERNAL_AGENT[publicAgentId] ?? null;
 }
 function ensureDir(dir) {
-  fs56.mkdirSync(dir, { recursive: true, mode: 448 });
+  fs57.mkdirSync(dir, { recursive: true, mode: 448 });
 }
 function writeFile0600(filePath, contents) {
-  ensureDir(path66.dirname(filePath));
-  fs56.writeFileSync(filePath, contents, { encoding: "utf8", mode: 384 });
+  ensureDir(path67.dirname(filePath));
+  fs57.writeFileSync(filePath, contents, { encoding: "utf8", mode: 384 });
   restrictToOwner(filePath);
 }
 function rmIfExists(filePath) {
   try {
-    fs56.rmSync(filePath, { force: true });
+    fs57.rmSync(filePath, { force: true });
   } catch {
   }
 }
 var claudeProvisioner = {
   write(auth, home) {
-    const credentialsJson = path66.join(home, ".claude", ".credentials.json");
+    const credentialsJson = path67.join(home, ".claude", ".credentials.json");
     if (auth.kind === "api_key") {
       rmIfExists(credentialsJson);
       return { ANTHROPIC_API_KEY: auth.value };
@@ -35782,8 +36035,8 @@ var claudeProvisioner = {
     } else {
       rmIfExists(credentialsJson);
     }
-    const claudeJson = path66.join(home, ".claude.json");
-    if (!fs56.existsSync(claudeJson)) {
+    const claudeJson = path67.join(home, ".claude.json");
+    if (!fs57.existsSync(claudeJson)) {
       writeFile0600(
         claudeJson,
         JSON.stringify({ hasCompletedOnboarding: true, customApiKeyResponses: { approved: [] } })
@@ -35794,7 +36047,7 @@ var claudeProvisioner = {
 };
 var codexProvisioner = {
   write(auth, home) {
-    const authJson = path66.join(home, ".codex", "auth.json");
+    const authJson = path67.join(home, ".codex", "auth.json");
     if (auth.kind === "api_key") {
       writeFile0600(authJson, JSON.stringify({ auth_mode: "apikey", OPENAI_API_KEY: auth.value }));
       return { OPENAI_API_KEY: auth.value };
@@ -35805,8 +36058,8 @@ var codexProvisioner = {
 };
 var geminiProvisioner = {
   write(auth, home) {
-    const settingsJson = path66.join(home, ".gemini", "settings.json");
-    const oauthCreds = path66.join(home, ".gemini", "oauth_creds.json");
+    const settingsJson = path67.join(home, ".gemini", "settings.json");
+    const oauthCreds = path67.join(home, ".gemini", "oauth_creds.json");
     if (auth.kind === "api_key") {
       rmIfExists(oauthCreds);
       writeFile0600(settingsJson, '{"security":{"auth":{"selectedType":"gemini-api-key"}}}');
@@ -35819,7 +36072,7 @@ var geminiProvisioner = {
 };
 var cursorProvisioner = {
   write(auth, home) {
-    const authJson = path66.join(home, ".config", "cursor", "auth.json");
+    const authJson = path67.join(home, ".config", "cursor", "auth.json");
     if (auth.kind === "api_key") {
       rmIfExists(authJson);
       return { CURSOR_API_KEY: auth.value };
@@ -35861,22 +36114,22 @@ max_context_size = 262144
 var kimiProvisioner = {
   write(auth, home) {
     const credentialsFiles = [
-      path66.join(home, ".kimi", "credentials", "kimi-code.json"),
-      path66.join(home, ".kimi-code", "credentials", "kimi-code.json")
+      path67.join(home, ".kimi", "credentials", "kimi-code.json"),
+      path67.join(home, ".kimi-code", "credentials", "kimi-code.json")
     ];
     if (auth.kind === "api_key") {
       credentialsFiles.forEach(rmIfExists);
       return { KIMI_API_KEY: auth.value };
     }
     credentialsFiles.forEach((f) => writeFile0600(f, auth.value));
-    writeFile0600(path66.join(home, ".kimi-code", "config.toml"), KIMI_MANAGED_CONFIG_TOML);
+    writeFile0600(path67.join(home, ".kimi-code", "config.toml"), KIMI_MANAGED_CONFIG_TOML);
     return {};
   }
 };
 var coderabbitProvisioner = {
   write(auth, home) {
-    const dir = path66.join(home, ".coderabbit");
-    const authJson = path66.join(dir, "auth.json");
+    const dir = path67.join(home, ".coderabbit");
+    const authJson = path67.join(dir, "auth.json");
     if (auth.kind === "api_key") {
       rmIfExists(authJson);
       return { CODERABBIT_API_KEY: auth.value };
@@ -35888,13 +36141,13 @@ var coderabbitProvisioner = {
       try {
         const parsed = JSON.parse(value);
         if (typeof parsed.file === "string" && typeof parsed.contents === "string") {
-          file = path66.basename(parsed.file);
+          file = path67.basename(parsed.file);
           contents = parsed.contents;
         }
       } catch {
       }
     }
-    writeFile0600(path66.join(dir, file), contents);
+    writeFile0600(path67.join(dir, file), contents);
     return {};
   }
 };
@@ -35931,16 +36184,16 @@ function provisionAgentCredentials(publicAgentId, auth, homeDir2 = os47.homedir(
 }
 
 // src/beads/workflow-hint.ts
-var fs57 = __toESM(require("fs"));
-var path68 = __toESM(require("path"));
+var fs58 = __toESM(require("fs"));
+var path69 = __toESM(require("path"));
 
 // src/agents/claude-memory-file.ts
 var os48 = __toESM(require("os"));
-var path67 = __toESM(require("path"));
+var path68 = __toESM(require("path"));
 function claudeMemoryFile(homeDir2, env = process.env) {
-  if (homeDir2) return path67.join(homeDir2, ".claude", "CLAUDE.md");
+  if (homeDir2) return path68.join(homeDir2, ".claude", "CLAUDE.md");
   const configDir = env.CLAUDE_CONFIG_DIR?.trim();
-  return configDir ? path67.join(configDir, "CLAUDE.md") : path67.join(os48.homedir(), ".claude", "CLAUDE.md");
+  return configDir ? path68.join(configDir, "CLAUDE.md") : path68.join(os48.homedir(), ".claude", "CLAUDE.md");
 }
 
 // src/beads/workflow-hint.ts
@@ -35970,11 +36223,11 @@ function ensureBeadsWorkflowHint(homeDir2, file = claudeMemoryFile(homeDir2)) {
   try {
     let existing = "";
     try {
-      existing = fs57.readFileSync(file, "utf8");
+      existing = fs58.readFileSync(file, "utf8");
     } catch {
     }
     if (existing.includes(BEADS_HINT)) return;
-    fs57.mkdirSync(path68.dirname(file), { recursive: true });
+    fs58.mkdirSync(path69.dirname(file), { recursive: true });
     let next;
     const open = existing.indexOf(BEADS_HINT_MARKER);
     const close = open === -1 ? -1 : existing.indexOf(BEADS_HINT_MARKER, open + BEADS_HINT_MARKER.length);
@@ -35987,40 +36240,40 @@ ${BEADS_HINT}
 ` : `${BEADS_HINT}
 `;
     }
-    fs57.writeFileSync(file, next);
+    fs58.writeFileSync(file, next);
   } catch {
   }
 }
 
 // src/agents/agent-standard.ts
-var fs58 = __toESM(require("fs"));
-var path69 = __toESM(require("path"));
+var fs59 = __toESM(require("fs"));
+var path70 = __toESM(require("path"));
 var os49 = __toESM(require("os"));
 function ensureAgentStandard(homeDir2, file = claudeMemoryFile(homeDir2)) {
   try {
     let existing = "";
     try {
-      existing = fs58.readFileSync(file, "utf8");
+      existing = fs59.readFileSync(file, "utf8");
     } catch {
     }
     if (existing.includes(AGENT_STANDARD_MARKER)) return;
-    fs58.mkdirSync(path69.dirname(file), { recursive: true });
+    fs59.mkdirSync(path70.dirname(file), { recursive: true });
     const next = existing.trim() ? `${existing.trimEnd()}
 
 ${AGENT_STANDARD_BLOCK}
 ` : `${AGENT_STANDARD_BLOCK}
 `;
-    fs58.writeFileSync(file, next);
+    fs59.writeFileSync(file, next);
   } catch {
   }
 }
 var _agentStandardSeam = {
   isLocalSession: () => isLocalSession(),
-  markerPath: (sessionId) => path69.join(os49.homedir(), ".codeam", "agent-standard", `${sessionId}.done`),
-  exists: (p2) => fs58.existsSync(p2),
+  markerPath: (sessionId) => path70.join(os49.homedir(), ".codeam", "agent-standard", `${sessionId}.done`),
+  exists: (p2) => fs59.existsSync(p2),
   write: (p2) => {
-    fs58.mkdirSync(path69.dirname(p2), { recursive: true });
-    fs58.writeFileSync(p2, "");
+    fs59.mkdirSync(path70.dirname(p2), { recursive: true });
+    fs59.writeFileSync(p2, "");
   }
 };
 function isClaude(agent) {
@@ -36713,15 +36966,15 @@ function withholdTrailingPartialFenceMarker(text) {
 
 // src/agents/acp/onboarding.ts
 var import_child_process28 = require("child_process");
-var fs59 = __toESM(require("fs"));
+var fs60 = __toESM(require("fs"));
 var os50 = __toESM(require("os"));
-var path70 = __toESM(require("path"));
+var path71 = __toESM(require("path"));
 var _onboardingSeam = {
-  markerPath: (sessionId) => path70.join(os50.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
-  exists: (p2) => fs59.existsSync(p2),
+  markerPath: (sessionId) => path71.join(os50.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
+  exists: (p2) => fs60.existsSync(p2),
   write: (p2) => {
-    fs59.mkdirSync(path70.dirname(p2), { recursive: true });
-    fs59.writeFileSync(p2, "");
+    fs60.mkdirSync(path71.dirname(p2), { recursive: true });
+    fs60.writeFileSync(p2, "");
   },
   disabled: () => {
     const v = process.env.CODEAM_ONBOARDING_DISABLED;
@@ -36758,7 +37011,7 @@ function resolveRepoName(cwd) {
       if (name) return name;
     }
   }
-  const base = path70.basename(cwd || "");
+  const base = path71.basename(cwd || "");
   if (base && !isUuid(base)) return base;
   return "this project";
 }
@@ -37150,13 +37403,13 @@ var import_crypto4 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
 var import_child_process29 = require("child_process");
-var fs61 = __toESM(require("fs/promises"));
-var path72 = __toESM(require("path"));
+var fs62 = __toESM(require("fs/promises"));
+var path73 = __toESM(require("path"));
 
 // src/services/turn-files/review-ignore.ts
 var import_ignore2 = __toESM(require("ignore"));
-var fs60 = __toESM(require("fs"));
-var path71 = __toESM(require("path"));
+var fs61 = __toESM(require("fs"));
+var path72 = __toESM(require("path"));
 var CURATED_REVIEW_IGNORE = [
   // Google Cloud SDK (the incident) — installs a huge python tree.
   "google-cloud-sdk/",
@@ -37195,7 +37448,7 @@ var CURATED_REVIEW_IGNORE = [
 function makeReviewIgnore(repoRoot) {
   const ig = (0, import_ignore2.default)().add(CURATED_REVIEW_IGNORE);
   try {
-    const custom = fs60.readFileSync(path71.join(repoRoot, ".codeam", "reviewignore"), "utf8");
+    const custom = fs61.readFileSync(path72.join(repoRoot, ".codeam", "reviewignore"), "utf8");
     ig.add(custom);
   } catch {
   }
@@ -37240,7 +37493,7 @@ async function collectRepoChangeset(opts) {
     let stats;
     if (!truncated && row.fileStatus === "added" && numstatEntry === void 0) {
       const lineCount = await readUntrackedLineCount(
-        path72.join(opts.repoRoot, row.filePath)
+        path73.join(opts.repoRoot, row.filePath)
       );
       stats = { added: lineCount, removed: 0 };
     } else {
@@ -37271,7 +37524,7 @@ function readUntrackedLineCount(absPath) {
 }
 async function defaultReadUntrackedLineCount(absPath) {
   try {
-    const content = await fs61.readFile(absPath, "utf8");
+    const content = await fs62.readFile(absPath, "utf8");
     let count = 0;
     let pos = -1;
     while ((pos = content.indexOf("\n", pos + 1)) !== -1) {
@@ -37363,7 +37616,7 @@ function defaultRunGit(cwd, args2) {
   });
 }
 async function discoverRepos(workingDir, maxDepth = 4) {
-  const fs80 = await import("fs/promises");
+  const fs81 = await import("fs/promises");
   const out2 = [];
   await walk(workingDir, 0);
   return out2;
@@ -37371,7 +37624,7 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (depth > maxDepth) return;
     let entries = [];
     try {
-      const dirents = await fs80.readdir(dir, { withFileTypes: true });
+      const dirents = await fs81.readdir(dir, { withFileTypes: true });
       entries = dirents.filter((d3) => !d3.name.startsWith(".") || d3.name === ".git").map((d3) => ({ name: d3.name, isDirectory: d3.isDirectory() }));
     } catch {
       return;
@@ -37382,8 +37635,8 @@ async function discoverRepos(workingDir, maxDepth = 4) {
     if (hasGit) {
       out2.push({
         repoRoot: dir,
-        repoPath: path72.relative(workingDir, dir),
-        repoName: path72.basename(dir)
+        repoPath: path73.relative(workingDir, dir),
+        repoName: path73.basename(dir)
       });
       return;
     }
@@ -37391,14 +37644,14 @@ async function discoverRepos(workingDir, maxDepth = 4) {
       if (!entry.isDirectory) continue;
       if (entry.name === "node_modules") continue;
       if (entry.name === "dist" || entry.name === "build") continue;
-      await walk(path72.join(dir, entry.name), depth + 1);
+      await walk(path73.join(dir, entry.name), depth + 1);
     }
   }
 }
 
 // src/services/turn-files/files-outbox.ts
-var fs62 = __toESM(require("fs/promises"));
-var path73 = __toESM(require("path"));
+var fs63 = __toESM(require("fs/promises"));
+var path74 = __toESM(require("path"));
 var import_os12 = require("os");
 var HOME_OUTBOX_DIR = ".codeam/outbox";
 var MAX_AGE_MS = 24 * 60 * 60 * 1e3;
@@ -37431,16 +37684,16 @@ var FilesOutbox = class {
   backoffIndex = 0;
   stopped = false;
   constructor(opts) {
-    const base = opts.baseDir ?? path73.join(homeDir(), HOME_OUTBOX_DIR);
-    this.filePath = path73.join(base, `${opts.sessionId}.jsonl`);
+    const base = opts.baseDir ?? path74.join(homeDir(), HOME_OUTBOX_DIR);
+    this.filePath = path74.join(base, `${opts.sessionId}.jsonl`);
     this.post = opts.post;
     this.autoSchedule = opts.autoSchedule !== false;
   }
   /** Persist the entry to disk and trigger a flush. Returns once the
    *  line is durable on disk (not once the POST succeeds). */
   async enqueue(entry) {
-    await fs62.mkdir(path73.dirname(this.filePath), { recursive: true });
-    await fs62.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
+    await fs63.mkdir(path74.dirname(this.filePath), { recursive: true });
+    await fs63.appendFile(this.filePath, JSON.stringify(entry) + "\n", "utf8");
     this.backoffIndex = 0;
     if (this.autoSchedule) this.scheduleFlush(0);
   }
@@ -37531,7 +37784,7 @@ var FilesOutbox = class {
   async readAll() {
     let raw = "";
     try {
-      raw = await fs62.readFile(this.filePath, "utf8");
+      raw = await fs63.readFile(this.filePath, "utf8");
     } catch {
       return [];
     }
@@ -37555,12 +37808,12 @@ var FilesOutbox = class {
   async rewrite(entries) {
     const tmpPath = `${this.filePath}.${process.pid}.tmp`;
     if (entries.length === 0) {
-      await fs62.unlink(this.filePath).catch(() => void 0);
+      await fs63.unlink(this.filePath).catch(() => void 0);
       return;
     }
     const payload = entries.map((e) => JSON.stringify(e)).join("\n") + "\n";
-    await fs62.writeFile(tmpPath, payload, "utf8");
-    await fs62.rename(tmpPath, this.filePath);
+    await fs63.writeFile(tmpPath, payload, "utf8");
+    await fs63.rename(tmpPath, this.filePath);
   }
 };
 function applyJitter(ms) {
@@ -38108,8 +38361,8 @@ async function postCredentialSync(opts, fetchImpl = fetch) {
 
 // src/packs/gates.ts
 var import_node_child_process22 = require("child_process");
-var fs63 = __toESM(require("fs"));
-var path74 = __toESM(require("path"));
+var fs64 = __toESM(require("fs"));
+var path75 = __toESM(require("path"));
 var defaultCommandRunner = (file, args2, cwd, timeoutMs, env) => new Promise((resolve12) => {
   (0, import_node_child_process22.execFile)(
     file,
@@ -38159,7 +38412,7 @@ async function changedFiles(run, cwd, from, to) {
 }
 function readWorkspaceFile(cwd, relPath) {
   try {
-    return fs63.readFileSync(path74.join(cwd, relPath), "utf8");
+    return fs64.readFileSync(path75.join(cwd, relPath), "utf8");
   } catch {
     return null;
   }
@@ -38168,14 +38421,14 @@ var NO_TEST_PLACEHOLDER = 'echo "Error: no test specified"';
 var CHECKS_TIMEOUT_MS = 5 * 6e4;
 function detectChecksCommand(cwd) {
   try {
-    const cfg = JSON.parse(fs63.readFileSync(path74.join(cwd, ".codeam", "pack.json"), "utf8"));
+    const cfg = JSON.parse(fs64.readFileSync(path75.join(cwd, ".codeam", "pack.json"), "utf8"));
     if (typeof cfg.checksCommand === "string" && cfg.checksCommand.trim().length > 0) {
       return cfg.checksCommand.trim();
     }
   } catch {
   }
   try {
-    const pkg = JSON.parse(fs63.readFileSync(path74.join(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(fs64.readFileSync(path75.join(cwd, "package.json"), "utf8"));
     const test = pkg.scripts?.test;
     if (typeof test === "string" && test.trim().length > 0 && !test.includes(NO_TEST_PLACEHOLDER)) {
       return "npm test";
@@ -38193,39 +38446,39 @@ ${res.stderr}`.trim();
 }
 
 // src/packs/run-store.ts
-var fs64 = __toESM(require("fs"));
-var path75 = __toESM(require("path"));
+var fs65 = __toESM(require("fs"));
+var path76 = __toESM(require("path"));
 var crypto5 = __toESM(require("crypto"));
 function packsDir(cwd) {
-  return path75.join(cwd, ".codeam", "packs");
+  return path76.join(cwd, ".codeam", "packs");
 }
 function runDir(cwd, runId) {
-  return path75.join(packsDir(cwd), runId);
+  return path76.join(packsDir(cwd), runId);
 }
 function newRunId() {
   return `pk_${Date.now().toString(36)}_${crypto5.randomBytes(4).toString("hex")}`;
 }
 function writeJsonAtomic(file, value) {
-  fs64.mkdirSync(path75.dirname(file), { recursive: true });
+  fs65.mkdirSync(path76.dirname(file), { recursive: true });
   const tmp = `${file}.tmp`;
-  fs64.writeFileSync(tmp, JSON.stringify(value, null, 2));
-  fs64.renameSync(tmp, file);
+  fs65.writeFileSync(tmp, JSON.stringify(value, null, 2));
+  fs65.renameSync(tmp, file);
 }
 function saveRun(cwd, state) {
-  writeJsonAtomic(path75.join(runDir(cwd, state.runId), "run.json"), state);
+  writeJsonAtomic(path76.join(runDir(cwd, state.runId), "run.json"), state);
 }
 function saveStageHandoff(cwd, runId, stageIndex, role, handoff) {
   const name = `${String(stageIndex + 1).padStart(2, "0")}-${role}.json`;
-  writeJsonAtomic(path75.join(runDir(cwd, runId), name), handoff);
+  writeJsonAtomic(path76.join(runDir(cwd, runId), name), handoff);
 }
 function loadLatestRun(cwd) {
   try {
     const dir = packsDir(cwd);
-    const entries = fs64.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+    const entries = fs65.readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory()).map((e) => e.name).sort();
     for (let i = entries.length - 1; i >= 0; i--) {
-      const file = path75.join(dir, entries[i], "run.json");
+      const file = path76.join(dir, entries[i], "run.json");
       try {
-        const parsed = JSON.parse(fs64.readFileSync(file, "utf8"));
+        const parsed = JSON.parse(fs65.readFileSync(file, "utf8"));
         if (parsed && typeof parsed.runId === "string") return parsed;
       } catch {
       }
@@ -38236,17 +38489,17 @@ function loadLatestRun(cwd) {
 }
 function ensureLedgerIgnored(cwd) {
   try {
-    const gitDir = path75.join(cwd, ".git");
-    if (!fs64.existsSync(gitDir)) return;
-    const exclude = path75.join(gitDir, "info", "exclude");
+    const gitDir = path76.join(cwd, ".git");
+    if (!fs65.existsSync(gitDir)) return;
+    const exclude = path76.join(gitDir, "info", "exclude");
     let existing = "";
     try {
-      existing = fs64.readFileSync(exclude, "utf8");
+      existing = fs65.readFileSync(exclude, "utf8");
     } catch {
     }
     if (existing.includes(".codeam/packs/")) return;
-    fs64.mkdirSync(path75.dirname(exclude), { recursive: true });
-    fs64.writeFileSync(exclude, `${existing.trimEnd()}
+    fs65.mkdirSync(path76.dirname(exclude), { recursive: true });
+    fs65.writeFileSync(exclude, `${existing.trimEnd()}
 .codeam/packs/
 `.trimStart());
   } catch {
@@ -39226,8 +39479,175 @@ async function mcpRouter() {
   });
 }
 
+// src/commands/preview-mcp.ts
+var PREVIEW_MCP_SERVER_NAME = "codeagent_preview";
+var PREVIEW_IPC_URL_ENV = "CODEAM_PREVIEW_IPC_URL";
+var PREVIEW_IPC_TOKEN_ENV = "CODEAM_PREVIEW_IPC_TOKEN";
+var START_TIMEOUT_MS = 27e4;
+var SHORT_TIMEOUT_MS = 2e4;
+var PREVIEW_TOOLS = [
+  {
+    name: "start_preview",
+    description: "Open this project's live Preview in the user's CodeAgent app \u2014 the same thing as their Preview button: it installs dependencies if needed, starts the dev server, publishes it on a public URL and switches the user's screen to it. Use it after you change anything visual (UI, styles, layout, copy) so you and the user can check the result, or whenever the user asks to see the app. Returns the public URL (you can curl it) or the exact error. Reuses a preview that is already running. Usually leave the arguments out: the project is detected automatically. Pass command/args/port only if you know the exact dev command.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        command: { type: "string", description: 'Dev server executable, e.g. "npm". Optional.' },
+        args: { type: "array", items: { type: "string" }, description: 'e.g. ["run","dev"]. Optional.' },
+        port: { type: "number", description: "Port the dev server listens on. Required with command." },
+        framework: { type: "string", description: 'Label shown to the user, e.g. "next". Optional.' }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "preview_status",
+    description: "Current state of the Preview: running (with its URL), starting, error (with the reason) or idle. Use it when start_preview answered that the preview is still starting.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false }
+  },
+  {
+    name: "highlight_element",
+    description: 'Point at an element in the running Preview: the user sees your cursor move to it and a labelled box drawn around it, scrolled into view. Use it to show the user exactly what you changed or what you are talking about ("this button", "the header spacing"). Takes a CSS selector (prefer ids, data-testid or specific classes you saw in the code). Several calls add several marks; clear_highlights removes them.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        selector: { type: "string", description: 'CSS selector, e.g. "#checkout" or "[data-testid=hero-cta]".' },
+        label: { type: "string", description: 'Short caption on the mark, e.g. "New CTA". Optional.' }
+      },
+      required: ["selector"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "clear_highlights",
+    description: "Remove every mark you drew in the Preview with highlight_element.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false }
+  },
+  {
+    name: "stop_preview",
+    description: "Stop the Preview (dev server + public URL). Only when the user asks, or to restart it cleanly.",
+    inputSchema: { type: "object", properties: {}, additionalProperties: false }
+  }
+];
+function previewMcpServer(bridge) {
+  if (!bridge) return null;
+  return {
+    name: PREVIEW_MCP_SERVER_NAME,
+    // Same runtime + entrypoint as this CLI — never trust the agent's PATH.
+    command: process.execPath,
+    args: [process.argv[1], "preview-mcp"],
+    env: [
+      { name: PREVIEW_IPC_URL_ENV, value: bridge.url },
+      { name: PREVIEW_IPC_TOKEN_ENV, value: bridge.token }
+    ]
+  };
+}
+function httpCall(baseUrl, token) {
+  return async (path96, method, body, timeoutMs) => {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    try {
+      const res = await fetch(`${baseUrl}${path96}`, {
+        method,
+        headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+        ...method === "POST" ? { body: JSON.stringify(body ?? {}) } : {},
+        signal: ac.signal
+      });
+      return await res.json();
+    } finally {
+      clearTimeout(timer);
+    }
+  };
+}
+async function runPreviewTool(name, args2, call) {
+  switch (name) {
+    case "start_preview":
+      return describeResult(await call("/preview/start", "POST", args2, START_TIMEOUT_MS));
+    case "preview_status":
+      return describeResult(await call("/preview/status", "GET", void 0, SHORT_TIMEOUT_MS));
+    case "highlight_element":
+      return describeAck(await call("/preview/highlight", "POST", args2, SHORT_TIMEOUT_MS));
+    case "clear_highlights":
+      return describeAck(await call("/preview/highlight", "POST", { clear: true }, SHORT_TIMEOUT_MS));
+    case "stop_preview":
+      return describeAck(await call("/preview/stop", "POST", {}, SHORT_TIMEOUT_MS));
+    default:
+      return { text: `Unknown tool: ${name}`, isError: true };
+  }
+}
+function describeResult(raw) {
+  const r = raw && typeof raw === "object" ? raw : {};
+  switch (r.status) {
+    case "running": {
+      const inspector = r.inspector ? " You can point at elements with highlight_element." : " (No element highlighting for this framework.)";
+      return {
+        text: `Preview ${r.reused ? "already running" : "is live"}: ${String(r.url)} (${String(r.framework)}). The user's app is showing it now.${inspector}`,
+        isError: false
+      };
+    }
+    case "starting":
+      return { text: String(r.message ?? "The preview is starting."), isError: false };
+    case "idle":
+      return { text: "No preview is running.", isError: false };
+    case "error":
+      return {
+        text: `Preview failed at ${String(r.stage)}: ${String(r.message)}`,
+        isError: true
+      };
+    default:
+      return { text: `Unexpected answer from the preview bridge: ${JSON.stringify(raw)}`, isError: true };
+  }
+}
+function describeAck(raw) {
+  const r = raw && typeof raw === "object" ? raw : {};
+  return { text: String(r.message ?? r.error ?? "done"), isError: r.ok !== true };
+}
+async function previewMcp() {
+  const url2 = process.env[PREVIEW_IPC_URL_ENV];
+  const token = process.env[PREVIEW_IPC_TOKEN_ENV];
+  const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
+  const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+  const { ListToolsRequestSchema, CallToolRequestSchema } = await import("@modelcontextprotocol/sdk/types.js");
+  const call = url2 && token ? httpCall(url2, token) : null;
+  const server = new Server({ name: PREVIEW_MCP_SERVER_NAME, version: "1.0.0" }, { capabilities: { tools: {} } });
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: PREVIEW_TOOLS }));
+  server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    if (!call) {
+      return {
+        content: [{ type: "text", text: "Preview is not available in this session." }],
+        isError: true
+      };
+    }
+    try {
+      const { text, isError: isError2 } = await runPreviewTool(
+        req.params.name,
+        req.params.arguments ?? {},
+        call
+      );
+      return { content: [{ type: "text", text }], isError: isError2 };
+    } catch (err) {
+      const aborted = err instanceof Error && err.name === "AbortError";
+      return {
+        content: [
+          {
+            type: "text",
+            text: aborted ? "The preview is taking long \u2014 it keeps going in the background; call preview_status shortly." : `Preview bridge unreachable: ${err instanceof Error ? err.message : String(err)}`
+          }
+        ],
+        isError: !aborted
+      };
+    }
+  });
+  await server.connect(new StdioServerTransport());
+}
+
 // src/integrations/provision.ts
 function buildMcpServersForStart(ctx) {
+  const servers = buildIntegrationMcpServers(ctx);
+  const preview = previewMcpServer(ctx.preview ?? null);
+  return preview ? [...servers, preview] : servers;
+}
+function buildIntegrationMcpServers(ctx) {
   const manifest = readIntegrationsManifest();
   if (!manifest || manifest.integrations.length === 0) return [];
   if (!ctx.pluginAuthToken) {
@@ -39399,6 +39819,299 @@ function mergeWithLocalMcpServers(integrationServers) {
   return merged;
 }
 
+// src/commands/start/agent-preview-bridge.ts
+var http11 = __toESM(require("http"));
+var import_node_crypto10 = require("crypto");
+var START_WAIT_MS = 24e4;
+var MAX_SELECTOR = 500;
+var MAX_LABEL = 80;
+var AgentPreviewBridge = class {
+  server = null;
+  listening = null;
+  token = (0, import_node_crypto10.randomBytes)(24).toString("hex");
+  ctx = null;
+  /** The bring-up in flight, so two tool calls never start two dev servers. */
+  inflight = null;
+  lastError = null;
+  bound = null;
+  /** Start the loopback server once. `null` when it could not bind — the
+   *  preview tools are then simply absent, never a failed session. */
+  listen() {
+    if (this.listening) return this.listening;
+    this.listening = new Promise((resolve12) => {
+      const server = http11.createServer((req, res) => {
+        void this.handle(req, res);
+      });
+      server.on("error", (err) => {
+        log.warn("agent-preview", `bridge failed to listen: ${String(err)}`);
+        resolve12(null);
+      });
+      server.listen(0, "127.0.0.1", () => {
+        const addr = server.address();
+        if (!addr || typeof addr === "string") {
+          resolve12(null);
+          return;
+        }
+        server.unref();
+        this.server = server;
+        this.bound = { url: `http://127.0.0.1:${addr.port}`, token: this.token };
+        resolve12(this.bound);
+      });
+    });
+    return this.listening;
+  }
+  /** The bound address once {@link listen} resolved, else null (sync, for
+   *  the MCP list rebuilds that happen mid-session). */
+  address() {
+    return this.bound;
+  }
+  /** Bind the live session. Tool calls before this answer "still starting". */
+  attach(ctx) {
+    this.ctx = ctx;
+  }
+  close() {
+    this.server?.close();
+    this.server = null;
+  }
+  // ─── Operations (public for tests) ─────────────────────────────────────
+  async start(override, waitMs = START_WAIT_MS) {
+    const ctx = this.ctx;
+    if (!ctx?.pluginAuthToken) {
+      return {
+        status: "error",
+        stage: "session",
+        message: "The session is still starting (or has no pairing token) \u2014 try again in a few seconds."
+      };
+    }
+    if (!this.inflight) {
+      const run = this.launch(ctx, ctx.pluginAuthToken, override);
+      this.inflight = run;
+      void run.finally(() => {
+        if (this.inflight === run) this.inflight = null;
+      });
+    }
+    const inflight = this.inflight;
+    let timer;
+    const pending = new Promise((resolve12) => {
+      timer = setTimeout(
+        () => resolve12({
+          status: "starting",
+          message: "The preview is still coming up (dependencies or a slow dev server). It keeps going in the background \u2014 call preview_status in a minute."
+        }),
+        waitMs
+      );
+      timer.unref?.();
+    });
+    try {
+      return await Promise.race([inflight, pending]);
+    } finally {
+      if (timer) clearTimeout(timer);
+    }
+  }
+  status() {
+    const ctx = this.ctx;
+    if (!ctx) return { status: "idle" };
+    const active2 = serving(ctx.sessionId);
+    if (active2) return running(active2, true);
+    if (this.inflight) return { status: "starting", message: "The preview is starting." };
+    if (this.lastError) return { status: "error", ...this.lastError };
+    return { status: "idle" };
+  }
+  async highlight(input) {
+    const ctx = this.ctx;
+    if (!ctx?.pluginAuthToken) return { ok: false, message: "The session is still starting." };
+    const active2 = serving(ctx.sessionId);
+    if (!active2) {
+      return { ok: false, message: "No preview is running \u2014 call start_preview first." };
+    }
+    if (!active2.inspector) {
+      return {
+        ok: false,
+        message: `Element highlighting needs the web inspector, which ${active2.framework} previews don't have.`
+      };
+    }
+    let payload;
+    if (input.clear === true) {
+      payload = { clear: true };
+    } else {
+      const selector = typeof input.selector === "string" ? input.selector.trim() : "";
+      if (!selector || selector.length > MAX_SELECTOR) {
+        return { ok: false, message: `selector must be a CSS selector of 1-${MAX_SELECTOR} characters.` };
+      }
+      const label = typeof input.label === "string" ? input.label.trim().slice(0, MAX_LABEL) : "";
+      payload = label ? { selector, label } : { selector };
+    }
+    const res = await postPreviewEvent({
+      sessionId: ctx.sessionId,
+      pluginId: ctx.pluginId,
+      pluginAuthToken: ctx.pluginAuthToken,
+      type: USER_EVENTS.PREVIEW_AGENT_HIGHLIGHT,
+      payload
+    });
+    if (!res.ok) {
+      return { ok: false, message: `Could not reach the app (${res.status}): ${res.message}` };
+    }
+    return {
+      ok: true,
+      message: payload.clear === true ? "Cleared your marks from the preview." : `Marked ${String(payload.selector)} in the user's preview. If the selector matches nothing, no mark appears.`
+    };
+  }
+  async stop() {
+    const ctx = this.ctx;
+    if (!ctx?.pluginAuthToken) return { ok: false, message: "The session is still starting." };
+    if (!activePreviews.has(ctx.sessionId)) return { ok: true, message: "No preview was running." };
+    await killPreview(ctx.sessionId);
+    resetBuildHealState(ctx.sessionId);
+    await postPreviewEvent({
+      sessionId: ctx.sessionId,
+      pluginId: ctx.pluginId,
+      pluginAuthToken: ctx.pluginAuthToken,
+      type: USER_EVENTS.PREVIEW_STOPPED,
+      payload: { reason: "user", origin: "agent" }
+    });
+    return { ok: true, message: "Preview stopped." };
+  }
+  // ─── Internals ─────────────────────────────────────────────────────────
+  async launch(ctx, pluginAuthToken, override) {
+    this.lastError = null;
+    const already = serving(ctx.sessionId);
+    if (already) {
+      await postPreviewEvent({
+        sessionId: ctx.sessionId,
+        pluginId: ctx.pluginId,
+        pluginAuthToken,
+        type: USER_EVENTS.PREVIEW_READY,
+        payload: {
+          url: already.url,
+          framework: already.framework,
+          port: already.detection.port,
+          origin: "agent"
+        }
+      });
+      return running(already, true);
+    }
+    void postPreviewEvent({
+      sessionId: ctx.sessionId,
+      pluginId: ctx.pluginId,
+      pluginAuthToken,
+      type: USER_EVENTS.PREVIEW_DETECTION_PENDING,
+      payload: { origin: "agent" }
+    });
+    const detection = (override && detectionFromOverride(override)) ?? await resolvePreviewDetection({ ctx, runtime: ctx.getRuntime(), pluginAuthToken, origin: "agent" });
+    if (!detection) {
+      const err2 = { stage: "detection", message: "Could not work out how to start this project." };
+      this.lastError = err2;
+      return { status: "error", ...err2 };
+    }
+    let failure = null;
+    await startPreviewFromDetection(ctx, detection, pluginAuthToken, {
+      origin: "agent",
+      onEvent: (type, payload) => {
+        if (type === USER_EVENTS.PREVIEW_ERROR) {
+          failure = {
+            stage: String(payload.stage ?? "spawn"),
+            message: String(payload.message ?? "The preview failed to start.")
+          };
+        }
+      }
+    });
+    const up = serving(ctx.sessionId);
+    if (up) return running(up, false);
+    const err = failure ?? { stage: "spawn", message: "The preview did not come up." };
+    this.lastError = err;
+    return { status: "error", ...err };
+  }
+  async handle(req, res) {
+    const reply = (code, body) => {
+      res.writeHead(code, { "content-type": "application/json" });
+      res.end(JSON.stringify(body));
+    };
+    if (!authorized(req.headers.authorization, this.token)) return reply(401, { error: "unauthorized" });
+    try {
+      const body = req.method === "POST" ? await readJson(req) : {};
+      switch (`${req.method} ${req.url}`) {
+        case "POST /preview/start":
+          return reply(200, await this.start(overrideFrom(body)));
+        case "GET /preview/status":
+          return reply(200, this.status());
+        case "POST /preview/highlight":
+          return reply(200, await this.highlight(body));
+        case "POST /preview/stop":
+          return reply(200, await this.stop());
+        default:
+          return reply(404, { error: "not found" });
+      }
+    } catch (err) {
+      log.warn("agent-preview", `bridge request failed: ${String(err)}`);
+      return reply(500, { error: err instanceof Error ? err.message : String(err) });
+    }
+  }
+};
+function serving(sessionId) {
+  const active2 = activePreviews.get(sessionId);
+  if (!active2 || active2.devServer && active2.devServer.exitCode !== null) return null;
+  return active2;
+}
+function running(active2, reused) {
+  return {
+    status: "running",
+    url: active2.url,
+    framework: active2.framework,
+    ...reused ? { reused: true } : {},
+    inspector: Boolean(active2.inspector)
+  };
+}
+function detectionFromOverride(o) {
+  if (!o.command || !Number.isInteger(o.port) || o.port <= 0 || o.port > 65535) return null;
+  return {
+    framework: o.framework?.trim() || "custom",
+    command: o.command,
+    args: Array.isArray(o.args) ? o.args.map(String) : [],
+    port: o.port,
+    // Any Local/ready/listening line; the TCP probe is the real fallback.
+    ready_pattern: o.ready_pattern?.trim() || "(ready|local:|listening|started server|compiled)"
+  };
+}
+function overrideFrom(body) {
+  if (typeof body.command !== "string" || typeof body.port !== "number") return void 0;
+  return {
+    command: body.command,
+    args: Array.isArray(body.args) ? body.args.map(String) : void 0,
+    port: body.port,
+    framework: typeof body.framework === "string" ? body.framework : void 0,
+    ready_pattern: typeof body.ready_pattern === "string" ? body.ready_pattern : void 0
+  };
+}
+function authorized(header, token) {
+  const presented = Buffer.from((header ?? "").replace(/^Bearer\s+/i, ""));
+  const expected = Buffer.from(token);
+  return presented.length === expected.length && (0, import_node_crypto10.timingSafeEqual)(presented, expected);
+}
+function readJson(req) {
+  return new Promise((resolve12, reject) => {
+    let raw = "";
+    req.setEncoding("utf8");
+    req.on("data", (chunk) => {
+      raw += chunk;
+      if (raw.length > 64e3) {
+        reject(new Error("body too large"));
+        req.destroy();
+      }
+    });
+    req.on("end", () => {
+      if (!raw) return resolve12({});
+      try {
+        const parsed = JSON.parse(raw);
+        resolve12(parsed && typeof parsed === "object" ? parsed : {});
+      } catch {
+        reject(new Error("invalid JSON"));
+      }
+    });
+    req.on("error", reject);
+  });
+}
+var agentPreviewBridge = new AgentPreviewBridge();
+
 // src/integrations/detect-stack.ts
 var import_node_fs13 = __toESM(require("fs"));
 var import_node_path13 = __toESM(require("path"));
@@ -40539,7 +41252,8 @@ async function integrationsSyncH(ctx) {
         sessionId: opts.sessionId,
         pluginId: opts.pluginId,
         pluginAuthToken: opts.pluginAuthToken,
-        pollSecret: opts.pollSecret
+        pollSecret: opts.pollSecret,
+        preview: agentPreviewBridge.address()
       })
     );
     const applied = await client3.reprovisionMcp(servers);
@@ -41176,7 +41890,7 @@ var AcpHistory = class {
       this.summary = trimmed.length > 120 ? trimmed.slice(0, 117) + "\u2026" : trimmed;
     }
     this.messages.push({
-      id: (0, import_node_crypto10.randomUUID)(),
+      id: (0, import_node_crypto11.randomUUID)(),
       role: "user",
       text,
       timestamp: Date.now(),
@@ -41192,7 +41906,7 @@ var AcpHistory = class {
   appendAgentReply(text, agentId = this.opts.agent) {
     if (text.length === 0) return;
     this.messages.push({
-      id: (0, import_node_crypto10.randomUUID)(),
+      id: (0, import_node_crypto11.randomUUID)(),
       role: "agent",
       text,
       timestamp: Date.now(),
@@ -41723,17 +42437,17 @@ async function runAcpSession(opts) {
       switchCredentialEnv = provisionAgentCredentials(agentId, auth);
     },
     provisionHouseProxy: ({ baseUrl, token, model, managedAgentId }) => {
-      const claudeConfigDir = path79.join(
+      const claudeConfigDir = path80.join(
         os53.homedir(),
         ".codeam",
         "house-claude",
         `switch-${opts.pluginId}`
       );
       try {
-        fs68.mkdirSync(claudeConfigDir, { recursive: true, mode: 448 });
+        fs69.mkdirSync(claudeConfigDir, { recursive: true, mode: 448 });
       } catch {
       }
-      const memoryFile = path79.join(claudeConfigDir, "CLAUDE.md");
+      const memoryFile = path80.join(claudeConfigDir, "CLAUDE.md");
       ensureBeadsWorkflowHint(void 0, memoryFile);
       ensureAgentStandard(void 0, memoryFile);
       const cfg = {
@@ -42956,8 +43670,8 @@ function pickPinnedSession(pinnedId, listSessions2) {
 }
 
 // src/agents/retired-proxy-cleanup.ts
-var fs69 = __toESM(require("fs"));
-var path80 = __toESM(require("path"));
+var fs70 = __toESM(require("fs"));
+var path81 = __toESM(require("path"));
 var os54 = __toESM(require("os"));
 var RETIRED_PROXY_RE = /^https?:\/\/(?:127\.0\.0\.1|localhost|\[::1\]):8787(?:[/?#]|$)/i;
 var HEADROOM_CMD_RE = /(^|[\s/"'])headroom(\s|$)/i;
@@ -42969,10 +43683,10 @@ function isHeadroomHook(group) {
 }
 function sanitizeRetiredProxyConfig(homeDir2 = os54.homedir()) {
   const out2 = { inspected: false, changed: false, removed: [] };
-  const file = path80.join(homeDir2, ".claude", "settings.json");
+  const file = path81.join(homeDir2, ".claude", "settings.json");
   let parsed;
   try {
-    parsed = JSON.parse(fs69.readFileSync(file, "utf8"));
+    parsed = JSON.parse(fs70.readFileSync(file, "utf8"));
   } catch {
     return out2;
   }
@@ -43014,9 +43728,9 @@ function sanitizeRetiredProxyConfig(homeDir2 = os54.homedir()) {
   if (!out2.changed) return out2;
   try {
     const tmp = `${file}.codeam.tmp`;
-    fs69.writeFileSync(tmp, `${JSON.stringify(parsed, null, 2)}
+    fs70.writeFileSync(tmp, `${JSON.stringify(parsed, null, 2)}
 `, { mode: 384 });
-    fs69.renameSync(tmp, file);
+    fs70.renameSync(tmp, file);
   } catch {
     out2.changed = false;
   }
@@ -43548,7 +44262,7 @@ var AcpDriver = class {
 };
 
 // src/baton/transcript-mirror.ts
-var fs70 = __toESM(require("fs"));
+var fs71 = __toESM(require("fs"));
 var TranscriptMirror = class {
   constructor(deps) {
     this.deps = deps;
@@ -43642,7 +44356,7 @@ var TranscriptMirror = class {
   }
 };
 function defaultWatch(file, onChange) {
-  const w3 = fs70.watch(file, { persistent: false }, () => onChange());
+  const w3 = fs71.watch(file, { persistent: false }, () => onChange());
   return () => w3.close();
 }
 
@@ -43988,16 +44702,16 @@ function keepDeviceAwake(deps = {}) {
 }
 
 // src/agents/claude/onboarding.ts
-var fs71 = __toESM(require("fs"));
+var fs72 = __toESM(require("fs"));
 var os56 = __toESM(require("os"));
-var path81 = __toESM(require("path"));
+var path82 = __toESM(require("path"));
 var ONBOARDING_VERSION_SENTINEL = "9999.0.0";
 function ensureClaudeOnboarded(cwd) {
   try {
-    const file = path81.join(os56.homedir(), ".claude.json");
+    const file = path82.join(os56.homedir(), ".claude.json");
     let config = {};
     try {
-      config = JSON.parse(fs71.readFileSync(file, "utf8"));
+      config = JSON.parse(fs72.readFileSync(file, "utf8"));
     } catch {
     }
     let changed = false;
@@ -44022,8 +44736,8 @@ function ensureClaudeOnboarded(cwd) {
       }
     }
     if (!changed) return;
-    fs71.mkdirSync(path81.dirname(file), { recursive: true });
-    fs71.writeFileSync(file, JSON.stringify(config, null, 2));
+    fs72.mkdirSync(path82.dirname(file), { recursive: true });
+    fs72.writeFileSync(file, JSON.stringify(config, null, 2));
     log.info(
       "claude",
       `pre-completed Claude onboarding${cwd ? ` + trusted workspace ${cwd}` : ""}`
@@ -44146,12 +44860,20 @@ async function start(requestedAgent, presetSession) {
       agent: isHouseProxyEnv(process.env) ? houseRailWireId(process.env) : session.agent
     });
   }
+  const previewBridge = await agentPreviewBridge.listen();
+  agentPreviewBridge.attach({
+    sessionId: session.id,
+    pluginId,
+    pluginAuthToken: session.pluginAuthToken ?? void 0,
+    getRuntime: () => createInteractiveAgentStrategy(session.agent, createOsStrategy())
+  });
   const mcpServers = mergeWithLocalMcpServers(
     buildMcpServersForStart({
       sessionId: session.id,
       pluginId,
       pluginAuthToken: session.pluginAuthToken ?? void 0,
-      pollSecret: session.pollSecret
+      pollSecret: session.pollSecret,
+      preview: previewBridge
     })
   );
   provisionSkillsForStart();
@@ -44792,7 +45514,7 @@ var import_picocolors10 = __toESM(require("picocolors"));
 var import_child_process30 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors8 = __toESM(require("picocolors"));
-var path82 = __toESM(require("path"));
+var path83 = __toESM(require("path"));
 var execFileP5 = (0, import_util4.promisify)(import_child_process30.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
@@ -45281,7 +46003,7 @@ var GitHubCodespacesProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path82.posix.dirname(remotePath);
+    const remoteDir = path83.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote(remoteDir)}`,
       `cat > ${shellQuote(remotePath)}`
@@ -45351,7 +46073,7 @@ function shellQuote(s) {
 // src/services/providers/gitpod.ts
 var import_child_process31 = require("child_process");
 var import_util5 = require("util");
-var path83 = __toESM(require("path"));
+var path84 = __toESM(require("path"));
 var import_picocolors9 = __toESM(require("picocolors"));
 var execFileP6 = (0, import_util5.promisify)(import_child_process31.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
@@ -45591,7 +46313,7 @@ var GitpodProvider = class {
     });
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
-    const remoteDir = path83.posix.dirname(remotePath);
+    const remoteDir = path84.posix.dirname(remotePath);
     const parts = [
       `mkdir -p ${shellQuote2(remoteDir)}`,
       `cat > ${shellQuote2(remotePath)}`
@@ -45627,7 +46349,7 @@ function shellQuote2(s) {
 // src/services/providers/gitlab-workspaces.ts
 var import_child_process32 = require("child_process");
 var import_util6 = require("util");
-var path84 = __toESM(require("path"));
+var path85 = __toESM(require("path"));
 var execFileP7 = (0, import_util6.promisify)(import_child_process32.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
@@ -45887,7 +46609,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
   }
   async uploadFile(workspaceId, remotePath, contents, options = {}) {
     const sshHost = process.env.CODEAM_GITLAB_SSH_HOST ?? "workspaces.gitlab.com";
-    const remoteDir = path84.posix.dirname(remotePath);
+    const remoteDir = path85.posix.dirname(remotePath);
     const parts = [`mkdir -p ${shellQuote3(remoteDir)}`, `cat > ${shellQuote3(remotePath)}`];
     if (options.mode != null) {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote3(remotePath)}`);
@@ -45955,7 +46677,7 @@ function shellQuote3(s) {
 // src/services/providers/railway.ts
 var import_child_process33 = require("child_process");
 var import_util7 = require("util");
-var path85 = __toESM(require("path"));
+var path86 = __toESM(require("path"));
 var execFileP8 = (0, import_util7.promisify)(import_child_process33.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
@@ -46191,7 +46913,7 @@ var RailwayProvider = class {
     if (!projectId || !serviceId) {
       throw new Error("Invalid Railway workspace id (expected projectId/serviceId).");
     }
-    const remoteDir = path85.posix.dirname(remotePath);
+    const remoteDir = path86.posix.dirname(remotePath);
     const parts = [`mkdir -p ${shellQuote4(remoteDir)}`, `cat > ${shellQuote4(remotePath)}`];
     if (options.mode != null) {
       parts.push(`chmod ${options.mode.toString(8)} ${shellQuote4(remotePath)}`);
@@ -46731,10 +47453,10 @@ async function stopWorkspaceFromLocal(target) {
 }
 
 // src/commands/host/host-client.ts
-var fs72 = __toESM(require("fs"));
+var fs73 = __toESM(require("fs"));
 var os57 = __toESM(require("os"));
-var path86 = __toESM(require("path"));
-var import_node_crypto11 = require("crypto");
+var path87 = __toESM(require("path"));
+var import_node_crypto12 = require("crypto");
 function sampleCpuTimes() {
   let idle = 0;
   let total = 0;
@@ -46781,7 +47503,7 @@ function apiBase() {
   return process.env.CODEAM_API_URL ?? resolveApiBaseUrl();
 }
 function hostIdentityPath() {
-  return path86.join(os57.homedir(), ".codeam", "host-agent.json");
+  return path87.join(os57.homedir(), ".codeam", "host-agent.json");
 }
 function collectOsInfo() {
   return {
@@ -46793,7 +47515,7 @@ function collectOsInfo() {
 }
 function loadHostIdentity() {
   try {
-    const raw = fs72.readFileSync(hostIdentityPath(), "utf8");
+    const raw = fs73.readFileSync(hostIdentityPath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed === "object" && parsed !== null && typeof parsed.hostId === "string" && typeof parsed.hostToken === "string" && typeof parsed.controlPluginId === "string") {
       const p2 = parsed;
@@ -46812,8 +47534,8 @@ function loadHostIdentity() {
 }
 function saveHostIdentity(identity) {
   const file = hostIdentityPath();
-  fs72.mkdirSync(path86.dirname(file), { recursive: true, mode: 448 });
-  fs72.writeFileSync(file, JSON.stringify(identity, null, 2), {
+  fs73.mkdirSync(path87.dirname(file), { recursive: true, mode: 448 });
+  fs73.writeFileSync(file, JSON.stringify(identity, null, 2), {
     encoding: "utf8",
     mode: 384
   });
@@ -46858,7 +47580,7 @@ function isTerminalEnrollError(err) {
 }
 function deleteHostIdentity() {
   try {
-    fs72.rmSync(hostIdentityPath(), { force: true });
+    fs73.rmSync(hostIdentityPath(), { force: true });
   } catch {
   }
 }
@@ -46886,8 +47608,8 @@ function resolveHostLabel(label) {
   return resolved.slice(0, 80);
 }
 async function redeemEnrollToken(token, label) {
-  const controlPollSecret = (0, import_node_crypto11.randomBytes)(32).toString("base64url");
-  const pluginSecretHash = (0, import_node_crypto11.createHash)("sha256").update(controlPollSecret).digest("hex");
+  const controlPollSecret = (0, import_node_crypto12.randomBytes)(32).toString("base64url");
+  const pluginSecretHash = (0, import_node_crypto12.createHash)("sha256").update(controlPollSecret).digest("hex");
   const data = await postJson("/api/self-hosted/redeem", {
     token,
     label: resolveHostLabel(label),
@@ -47072,8 +47794,8 @@ async function host(args2) {
 // src/commands/host-agent.ts
 var import_node_child_process30 = require("child_process");
 var os62 = __toESM(require("os"));
-var fs77 = __toESM(require("fs"));
-var path91 = __toESM(require("path"));
+var fs78 = __toESM(require("fs"));
+var path92 = __toESM(require("path"));
 
 // src/skills/persist-from-payload.ts
 function persistOrClearSkillsFromPayload(skills) {
@@ -47082,13 +47804,13 @@ function persistOrClearSkillsFromPayload(skills) {
 }
 
 // src/commands/host/session-state.ts
-var fs73 = __toESM(require("fs"));
+var fs74 = __toESM(require("fs"));
 var os58 = __toESM(require("os"));
-var path87 = __toESM(require("path"));
+var path88 = __toESM(require("path"));
 function hostSessionStatePath(env = process.env) {
   const override = env.CODEAM_HOST_SESSION_STATE_FILE;
   if (override && override.trim()) return override.trim();
-  return path87.join(os58.homedir(), ".codeam", "host-agent-sessions.json");
+  return path88.join(os58.homedir(), ".codeam", "host-agent-sessions.json");
 }
 function isRecord5(v) {
   if (typeof v !== "object" || v === null) return false;
@@ -47099,7 +47821,7 @@ function fileSessionChildStore(file = hostSessionStatePath()) {
   return {
     load() {
       try {
-        const raw = JSON.parse(fs73.readFileSync(file, "utf8"));
+        const raw = JSON.parse(fs74.readFileSync(file, "utf8"));
         return Array.isArray(raw?.sessions) ? raw.sessions.filter(isRecord5) : [];
       } catch {
         return [];
@@ -47107,18 +47829,18 @@ function fileSessionChildStore(file = hostSessionStatePath()) {
     },
     save(list) {
       try {
-        fs73.mkdirSync(path87.dirname(file), { recursive: true, mode: 448 });
+        fs74.mkdirSync(path88.dirname(file), { recursive: true, mode: 448 });
         const tmp = `${file}.${process.pid}.tmp`;
-        fs73.writeFileSync(tmp, JSON.stringify({ version: 1, sessions: list }, null, 2), {
+        fs74.writeFileSync(tmp, JSON.stringify({ version: 1, sessions: list }, null, 2), {
           mode: 384
         });
-        fs73.renameSync(tmp, file);
+        fs74.renameSync(tmp, file);
       } catch {
       }
     },
     clear() {
       try {
-        fs73.rmSync(file, { force: true });
+        fs74.rmSync(file, { force: true });
       } catch {
       }
     }
@@ -47141,9 +47863,9 @@ function planSessionResume(records, max) {
   return { resume: ordered.slice(0, bound), dropped: ordered.slice(bound) };
 }
 function pickSavedSessionForWorkspace(sessions3, cwd) {
-  const target = path87.resolve(cwd);
+  const target = path88.resolve(cwd);
   const matches = sessions3.filter(
-    (s) => !!s.cwd && path87.resolve(s.cwd) === target && !!s.pluginId && !!s.pollSecret && !!s.agent
+    (s) => !!s.cwd && path88.resolve(s.cwd) === target && !!s.pluginId && !!s.pollSecret && !!s.agent
   );
   if (matches.length === 0) return null;
   matches.sort((a, b) => b.pairedAt - a.pairedAt);
@@ -47151,25 +47873,25 @@ function pickSavedSessionForWorkspace(sessions3, cwd) {
 }
 
 // src/commands/host/workspace.ts
-var fs74 = __toESM(require("fs"));
+var fs75 = __toESM(require("fs"));
 var os59 = __toESM(require("os"));
-var path88 = __toESM(require("path"));
+var path89 = __toESM(require("path"));
 var import_node_child_process25 = require("child_process");
 var import_node_util5 = require("util");
 var execFileP9 = (0, import_node_util5.promisify)(import_node_child_process25.execFile);
 function isAbsolutePathTarget(target) {
-  return path88.isAbsolute(target);
+  return path89.isAbsolute(target);
 }
 function selfHostedWorkspaceRoot() {
-  return path88.join(os59.homedir(), ".codeam", "self-hosted");
+  return path89.join(os59.homedir(), ".codeam", "self-hosted");
 }
 function deployIdFromWorkspace(cwd) {
   if (!cwd) return null;
   const root = selfHostedWorkspaceRoot();
-  const resolved = path88.resolve(cwd);
-  const rel = path88.relative(root, resolved);
-  if (!rel || rel.startsWith("..") || path88.isAbsolute(rel)) return null;
-  const parts = rel.split(path88.sep).filter(Boolean);
+  const resolved = path89.resolve(cwd);
+  const rel = path89.relative(root, resolved);
+  if (!rel || rel.startsWith("..") || path89.isAbsolute(rel)) return null;
+  const parts = rel.split(path89.sep).filter(Boolean);
   if (parts.length !== 1) return null;
   return parts[0];
 }
@@ -47241,15 +47963,15 @@ async function configureGitCredentials(dest, repoRef, cloneToken, provider = "gi
   const isGitlab = provider === "gitlab";
   if (isGitlab ? !gitlabProjectPath(repoRef.trim()) : !githubOwnerRepo(repoRef.trim())) return;
   if (!cloneToken) return;
-  const credFile = path88.join(dest, ".git", "codeam-credentials");
+  const credFile = path89.join(dest, ".git", "codeam-credentials");
   const credLine = isGitlab ? `https://oauth2:${cloneToken}@gitlab.com
 ` : `https://x-access-token:${cloneToken}@github.com
 `;
-  fs74.writeFileSync(credFile, credLine, { mode: 384 });
+  fs75.writeFileSync(credFile, credLine, { mode: 384 });
   restrictToOwner(credFile);
   const env = nonInteractiveGitEnv();
   const git2 = (args2) => execFileP9("git", ["-C", dest, ...args2], { timeout: 3e4, env });
-  const credFilePosix = credFile.split(path88.sep).join("/");
+  const credFilePosix = credFile.split(path89.sep).join("/");
   await git2(["config", "--local", "--replace-all", "credential.helper", ""]).catch(() => {
   });
   await git2([
@@ -47282,17 +48004,17 @@ function maskToken(text, cloneToken) {
 }
 async function prepareWorkspace(repoOrPath, deployId, cloneToken, provider = "github", branch) {
   if (isAbsolutePathTarget(repoOrPath)) {
-    if (!fs74.existsSync(repoOrPath)) {
+    if (!fs75.existsSync(repoOrPath)) {
       throw new Error(`deploy target path does not exist: ${repoOrPath}`);
     }
     return repoOrPath;
   }
-  const dest = path88.join(selfHostedWorkspaceRoot(), deployId);
-  if (fs74.existsSync(path88.join(dest, ".git"))) {
+  const dest = path89.join(selfHostedWorkspaceRoot(), deployId);
+  if (fs75.existsSync(path89.join(dest, ".git"))) {
     if (cloneToken) await configureGitCredentials(dest, repoOrPath, cloneToken, provider);
     return dest;
   }
-  fs74.mkdirSync(selfHostedWorkspaceRoot(), { recursive: true, mode: 448 });
+  fs75.mkdirSync(selfHostedWorkspaceRoot(), { recursive: true, mode: 448 });
   const cloneUrl = repoCloneUrl(repoOrPath, cloneToken, provider);
   const cloneArgs = branch ? ["clone", "--depth", "1", "--branch", branch, cloneUrl, dest] : ["clone", "--depth", "1", cloneUrl, dest];
   try {
@@ -47311,11 +48033,11 @@ async function prepareWorkspace(repoOrPath, deployId, cloneToken, provider = "gi
 
 // src/commands/host/git-tooling.ts
 var import_node_child_process26 = require("child_process");
-var fs75 = __toESM(require("fs"));
+var fs76 = __toESM(require("fs"));
 var os60 = __toESM(require("os"));
-var path89 = __toESM(require("path"));
+var path90 = __toESM(require("path"));
 function codeamBinDir() {
-  return process.env.CODEAM_BIN_DIR ?? path89.join(os60.homedir(), ".codeam", "bin");
+  return process.env.CODEAM_BIN_DIR ?? path90.join(os60.homedir(), ".codeam", "bin");
 }
 var FALLBACK_GH_VERSION = "2.62.0";
 var RELEASE_API = "https://api.github.com/repos/cli/cli/releases/latest";
@@ -47347,7 +48069,7 @@ async function download(url2, dest) {
     const res = await fetch(url2, { headers: { "User-Agent": "codeam-cli" } });
     if (!res.ok || !res.body) return false;
     const buf = Buffer.from(await res.arrayBuffer());
-    fs75.writeFileSync(dest, buf);
+    fs76.writeFileSync(dest, buf);
     return true;
   } catch {
     return false;
@@ -47370,8 +48092,8 @@ async function ensureGhCli(runner, token, deps = {}) {
     const version3 = await resolveVersionFn(token);
     const asset = `gh_${version3}_${osToken}_${arch2}`;
     const url2 = `https://github.com/cli/cli/releases/download/v${version3}/${asset}.${ext}`;
-    const tmpRoot = fs75.mkdtempSync(path89.join(os60.tmpdir(), "codeam-gh-"));
-    const archive = path89.join(tmpRoot, `${asset}.${ext}`);
+    const tmpRoot = fs76.mkdtempSync(path90.join(os60.tmpdir(), "codeam-gh-"));
+    const archive = path90.join(tmpRoot, `${asset}.${ext}`);
     if (!await downloadFn(url2, archive)) {
       log.warn("host-agent", "gh download failed \u2014 skipping (git pull/push still work via the credential helper)");
       return null;
@@ -47381,16 +48103,16 @@ async function ensureGhCli(runner, token, deps = {}) {
       log.warn("host-agent", `gh archive extraction failed (code=${String(extract.code)}) \u2014 skipping`);
       return null;
     }
-    const extractedBin = path89.join(tmpRoot, asset, "bin", binaryName);
-    if (!fs75.existsSync(extractedBin)) {
+    const extractedBin = path90.join(tmpRoot, asset, "bin", binaryName);
+    if (!fs76.existsSync(extractedBin)) {
       log.warn("host-agent", "gh binary not found in the extracted archive \u2014 skipping");
       return null;
     }
     const binDir = codeamBinDir();
-    fs75.mkdirSync(binDir, { recursive: true });
-    const target = path89.join(binDir, binaryName);
-    fs75.copyFileSync(extractedBin, target);
-    fs75.chmodSync(target, 493);
+    fs76.mkdirSync(binDir, { recursive: true });
+    const target = path90.join(binDir, binaryName);
+    fs76.copyFileSync(extractedBin, target);
+    fs76.chmodSync(target, 493);
     log.info("host-agent", `gh installed to ${target} (v${version3})`);
     return target;
   } catch (e) {
@@ -47427,19 +48149,19 @@ async function ensureGhAuth(runner, ghCmd, token) {
 }
 function ghConfigDir() {
   if (process.env.GH_CONFIG_DIR) return process.env.GH_CONFIG_DIR;
-  if (process.env.XDG_CONFIG_HOME) return path89.join(process.env.XDG_CONFIG_HOME, "gh");
+  if (process.env.XDG_CONFIG_HOME) return path90.join(process.env.XDG_CONFIG_HOME, "gh");
   if (process.platform === "win32" && process.env.APPDATA) {
-    return path89.join(process.env.APPDATA, "GitHub CLI");
+    return path90.join(process.env.APPDATA, "GitHub CLI");
   }
-  return path89.join(os60.homedir(), ".config", "gh");
+  return path90.join(os60.homedir(), ".config", "gh");
 }
 function writeGhHostsToken(token) {
   try {
     const dir = ghConfigDir();
-    const file = path89.join(dir, "hosts.yml");
-    if (fs75.existsSync(file)) return false;
-    fs75.mkdirSync(dir, { recursive: true, mode: 448 });
-    fs75.writeFileSync(
+    const file = path90.join(dir, "hosts.yml");
+    if (fs76.existsSync(file)) return false;
+    fs76.mkdirSync(dir, { recursive: true, mode: 448 });
+    fs76.writeFileSync(
       file,
       `github.com:
     oauth_token: ${token}
@@ -47482,8 +48204,8 @@ async function ensureGlabCli(runner, deps = {}) {
     const version3 = await resolveLatestGlabVersion();
     const asset = `glab_${version3}_${osToken}_${arch2}`;
     const url2 = `https://gitlab.com/gitlab-org/cli/-/releases/v${version3}/downloads/${asset}.${ext}`;
-    const tmpRoot = fs75.mkdtempSync(path89.join(os60.tmpdir(), "codeam-glab-"));
-    const archive = path89.join(tmpRoot, `${asset}.${ext}`);
+    const tmpRoot = fs76.mkdtempSync(path90.join(os60.tmpdir(), "codeam-glab-"));
+    const archive = path90.join(tmpRoot, `${asset}.${ext}`);
     if (!await downloadFn(url2, archive)) {
       log.warn("host-agent", "glab download failed \u2014 skipping (git push/pull still work)");
       return null;
@@ -47494,20 +48216,20 @@ async function ensureGlabCli(runner, deps = {}) {
       return null;
     }
     const candidates = [
-      path89.join(tmpRoot, "bin", binaryName),
-      path89.join(tmpRoot, asset, "bin", binaryName),
-      path89.join(tmpRoot, binaryName)
+      path90.join(tmpRoot, "bin", binaryName),
+      path90.join(tmpRoot, asset, "bin", binaryName),
+      path90.join(tmpRoot, binaryName)
     ];
-    const extractedBin = candidates.find((c2) => fs75.existsSync(c2));
+    const extractedBin = candidates.find((c2) => fs76.existsSync(c2));
     if (!extractedBin) {
       log.warn("host-agent", "glab binary not found in the extracted archive \u2014 skipping");
       return null;
     }
     const binDir = codeamBinDir();
-    fs75.mkdirSync(binDir, { recursive: true });
-    const target = path89.join(binDir, binaryName);
-    fs75.copyFileSync(extractedBin, target);
-    fs75.chmodSync(target, 493);
+    fs76.mkdirSync(binDir, { recursive: true });
+    const target = path90.join(binDir, binaryName);
+    fs76.copyFileSync(extractedBin, target);
+    fs76.chmodSync(target, 493);
     log.info("host-agent", `glab installed to ${target} (v${version3})`);
     return target;
   } catch (e) {
@@ -47589,9 +48311,9 @@ var defaultGitToolingRunner = {
 var import_node_child_process28 = require("child_process");
 
 // src/lib/updateNotifier.ts
-var fs76 = __toESM(require("fs"));
+var fs77 = __toESM(require("fs"));
 var os61 = __toESM(require("os"));
-var path90 = __toESM(require("path"));
+var path91 = __toESM(require("path"));
 var https8 = __toESM(require("https"));
 var import_node_child_process27 = require("child_process");
 var import_picocolors12 = __toESM(require("picocolors"));
@@ -47600,12 +48322,12 @@ var REGISTRY_URL = `https://registry.npmjs.org/${PKG_NAME}/latest`;
 var TTL_MS = 24 * 60 * 60 * 1e3;
 var REQUEST_TIMEOUT_MS = 1500;
 function cachePath() {
-  const dir = path90.join(os61.homedir(), ".codeam");
-  return path90.join(dir, "update-check.json");
+  const dir = path91.join(os61.homedir(), ".codeam");
+  return path91.join(dir, "update-check.json");
 }
 function readCache() {
   try {
-    const raw = fs76.readFileSync(cachePath(), "utf8");
+    const raw = fs77.readFileSync(cachePath(), "utf8");
     const parsed = JSON.parse(raw);
     if (typeof parsed.fetchedAt !== "number" || typeof parsed.latest !== "string") return null;
     return parsed;
@@ -47616,10 +48338,10 @@ function readCache() {
 function writeCache(cache) {
   try {
     const file = cachePath();
-    fs76.mkdirSync(path90.dirname(file), { recursive: true });
+    fs77.mkdirSync(path91.dirname(file), { recursive: true });
     const tmp = `${file}.${process.pid}.tmp`;
-    fs76.writeFileSync(tmp, JSON.stringify(cache));
-    fs76.renameSync(tmp, file);
+    fs77.writeFileSync(tmp, JSON.stringify(cache));
+    fs77.renameSync(tmp, file);
   } catch {
   }
 }
@@ -47693,8 +48415,8 @@ function isLinkedInstall() {
       timeout: 2e3
     }).trim();
     if (!root) return false;
-    const pkgPath = path90.join(root, PKG_NAME);
-    return fs76.lstatSync(pkgPath).isSymbolicLink();
+    const pkgPath = path91.join(root, PKG_NAME);
+    return fs77.lstatSync(pkgPath).isSymbolicLink();
   } catch {
     return false;
   }
@@ -47730,7 +48452,7 @@ function maybeAutoUpdate(currentVersion, latest) {
     return;
   }
   try {
-    fs76.unlinkSync(cachePath());
+    fs77.unlinkSync(cachePath());
   } catch {
   }
   process.stderr.write(`  ${import_picocolors12.default.green("\u2713")} Updated. Resuming session...
@@ -47746,7 +48468,7 @@ async function autoUpgradeBeforeCriticalCommand() {
   if (process.env.NODE_ENV === "test") return;
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
-  const current2 = true ? "2.75.23" : null;
+  const current2 = true ? "2.75.26" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -47763,7 +48485,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current2 = true ? "2.75.23" : null;
+  const current2 = true ? "2.75.26" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -47786,7 +48508,7 @@ var SELF_UPDATE_INSTALL_TIMEOUT_MS = 18e4;
 var SELF_UPDATE_LS_TIMEOUT_MS = 15e3;
 var SUDO_PREFLIGHT_TIMEOUT_MS = 5e3;
 function currentCliVersion() {
-  return true ? "2.75.23" : null;
+  return true ? "2.75.26" : null;
 }
 async function installedVersion(deps) {
   const ls = await deps.run(
@@ -48519,13 +49241,13 @@ var HostAgentSupervisor = class {
     const relay = this.relay;
     if (!relay) return;
     const raw = cmd.payload?.path;
-    const target = typeof raw === "string" && raw.trim() ? path91.resolve(raw.trim()) : os62.homedir();
+    const target = typeof raw === "string" && raw.trim() ? path92.resolve(raw.trim()) : os62.homedir();
     try {
-      const dirents = await fs77.promises.readdir(target, { withFileTypes: true });
+      const dirents = await fs78.promises.readdir(target, { withFileTypes: true });
       const entries = dirents.filter((d3) => !d3.name.startsWith(".")).map((d3) => ({ name: d3.name, isDir: d3.isDirectory() })).sort(
         (a, b) => a.isDir === b.isDir ? a.name.localeCompare(b.name) : a.isDir ? -1 : 1
       );
-      const parent = path91.dirname(target);
+      const parent = path92.dirname(target);
       await relay.sendResult(cmd.id, "completed", {
         path: target,
         // null at the filesystem root so the UI can hide the ".." affordance.
@@ -48872,14 +49594,14 @@ var HostAgentSupervisor = class {
           ...buildHouseProxyChildEnv({ baseUrl, token, openRouter: openRouter === true }),
           CODEAM_AUTO_TOKEN: payload.autoPairToken
         };
-        const houseConfigDir = path91.join(
+        const houseConfigDir = path92.join(
           os62.homedir(),
           ".codeam",
           "house-claude",
           payload.deployId
         );
         try {
-          fs77.mkdirSync(houseConfigDir, { recursive: true, mode: 448 });
+          fs78.mkdirSync(houseConfigDir, { recursive: true, mode: 448 });
         } catch {
         }
         childEnv.CLAUDE_CONFIG_DIR = houseConfigDir;
@@ -48913,13 +49635,13 @@ var HostAgentSupervisor = class {
           if ((payload.repoProvider ?? "github") === "gitlab") {
             const glabCmd = await ensureGlabCli(defaultGitToolingRunner);
             if (glabCmd) {
-              childEnv.PATH = `${codeamBinDir()}${path91.delimiter}${childEnv.PATH}`;
+              childEnv.PATH = `${codeamBinDir()}${path92.delimiter}${childEnv.PATH}`;
               await ensureGlabAuth(defaultGitToolingRunner, glabCmd, payload.cloneToken);
             }
           } else {
             const ghCmd = await ensureGhCli(defaultGitToolingRunner, payload.cloneToken);
             if (ghCmd) {
-              childEnv.PATH = `${codeamBinDir()}${path91.delimiter}${childEnv.PATH}`;
+              childEnv.PATH = `${codeamBinDir()}${path92.delimiter}${childEnv.PATH}`;
               await ensureGhAuth(defaultGitToolingRunner, ghCmd, payload.cloneToken);
             }
           }
@@ -48947,9 +49669,9 @@ var HostAgentSupervisor = class {
       );
       if (!payload.suppressOnboardingWelcome) {
         try {
-          const cfgDir = childEnv.CLAUDE_CONFIG_DIR || path91.join(os62.homedir(), ".claude");
-          const projectDir = path91.join(cfgDir, "projects", encodeCwd(cwd));
-          const hasPriorConversation = fs77.existsSync(projectDir) && fs77.readdirSync(projectDir).some((f) => f.endsWith(".jsonl"));
+          const cfgDir = childEnv.CLAUDE_CONFIG_DIR || path92.join(os62.homedir(), ".claude");
+          const projectDir = path92.join(cfgDir, "projects", encodeCwd(cwd));
+          const hasPriorConversation = fs78.existsSync(projectDir) && fs78.readdirSync(projectDir).some((f) => f.endsWith(".jsonl"));
           if (hasPriorConversation) {
             childEnv.CODEAM_RESUME_LATEST = "1";
             log.info(
@@ -49100,7 +49822,7 @@ var HostAgentSupervisor = class {
   fallbackResumeTarget() {
     const session = getActiveSession();
     if (!session || !session.pluginId || !session.pollSecret || !session.agent) return null;
-    const cwd = session.cwd && fs77.existsSync(session.cwd) ? session.cwd : process.cwd();
+    const cwd = session.cwd && fs78.existsSync(session.cwd) ? session.cwd : process.cwd();
     const deployId = deployIdFromWorkspace(session.cwd) ?? session.id;
     return { deployId, cwd, session };
   }
@@ -49120,7 +49842,7 @@ var HostAgentSupervisor = class {
     if (this.children.has(deployId)) return;
     const st3 = this.resumeStateFor(target);
     try {
-      const cwd = fs77.existsSync(target.cwd) ? target.cwd : process.cwd();
+      const cwd = fs78.existsSync(target.cwd) ? target.cwd : process.cwd();
       const proc = this.resumeSpawner(
         { ...readHouseProxyChildEnv(), CODEAM_RESUME_SESSION_ID: session.id },
         cwd
@@ -49338,12 +50060,12 @@ var HostAgentSupervisor = class {
       this.untrackChild(deployId);
     }
     const dirs = [
-      path91.join(selfHostedWorkspaceRoot(), deployId),
-      path91.join(os62.homedir(), ".codeam", "house-claude", deployId)
+      path92.join(selfHostedWorkspaceRoot(), deployId),
+      path92.join(os62.homedir(), ".codeam", "house-claude", deployId)
     ];
     for (const dir of dirs) {
       try {
-        fs77.rmSync(dir, { recursive: true, force: true });
+        fs78.rmSync(dir, { recursive: true, force: true });
       } catch (err) {
         log.warn(
           "host-agent",
@@ -49502,9 +50224,9 @@ async function invite() {
 // src/commands/doctor.ts
 var import_node_dns = require("dns");
 var import_node_util6 = require("util");
-var import_node_crypto12 = require("crypto");
-var fs78 = __toESM(require("fs"));
-var path92 = __toESM(require("path"));
+var import_node_crypto13 = require("crypto");
+var fs79 = __toESM(require("fs"));
+var path93 = __toESM(require("path"));
 var import_picocolors14 = __toESM(require("picocolors"));
 var dnsResolveP = (0, import_node_util6.promisify)(import_node_dns.resolve);
 async function checkDns(apiBase2) {
@@ -49560,13 +50282,13 @@ async function checkHealth(apiBase2) {
   }
 }
 function checkConfigDir() {
-  const dir = path92.join(require("os").homedir(), ".codeam");
+  const dir = path93.join(require("os").homedir(), ".codeam");
   try {
-    fs78.mkdirSync(dir, { recursive: true, mode: 448 });
-    const probe = path92.join(dir, ".doctor-probe");
-    fs78.writeFileSync(probe, "ok", { mode: 384 });
-    const read = fs78.readFileSync(probe, "utf8");
-    fs78.unlinkSync(probe);
+    fs79.mkdirSync(dir, { recursive: true, mode: 448 });
+    const probe = path93.join(dir, ".doctor-probe");
+    fs79.writeFileSync(probe, "ok", { mode: 384 });
+    const read = fs79.readFileSync(probe, "utf8");
+    fs79.unlinkSync(probe);
     if (read !== "ok") throw new Error("write/read round-trip mismatch");
     return {
       id: "config-dir",
@@ -49630,7 +50352,7 @@ function checkNodePty() {
       detail: "not required on this platform"
     };
   }
-  const vendoredPath = path92.join(__dirname, "vendor", "node-pty");
+  const vendoredPath = path93.join(__dirname, "vendor", "node-pty");
   for (const target of [vendoredPath, "node-pty"]) {
     try {
       require(target);
@@ -49672,9 +50394,9 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.75.23" : "0.0.0-dev";
+  const cliVersion = true ? "2.75.26" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
-  const diagnosticId = (0, import_node_crypto12.randomUUID)();
+  const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
   const [dns, health] = await Promise.all([
     checkDns(apiBase2),
@@ -50196,7 +50918,7 @@ async function mcpWarm(argv = [], opts = {}) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.75.23" : "unknown";
+  const v = true ? "2.75.26" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 
@@ -50397,6 +51119,9 @@ async function main() {
   if (command === "mcp-run") {
     return mcpRun(args);
   }
+  if (command === "preview-mcp") {
+    return previewMcp();
+  }
   if (command === "mcp-warm") {
     await mcpWarm(args);
     return;