codeam-cli 2.69.0 → 2.71.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `codeam-cli` are documented here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.70.0] — 2026-08-29
+
+### Fixed
+
+- **cli:** Distinguir una navegacion de un fetch, no solo mirar el Accept (#667)
+
+## [2.69.0] — 2026-08-29
+
+### Added
+
+- **cli:** El inspector habla tambien dentro del WebView de la app movil (#666)
+
 ## [2.68.0] — 2026-08-29
 
 ### Added

package/dist/index.js

@@ -271,8 +271,8 @@ var init_stdio_proxy = __esm({
       }
       async spawnChild(stdout, preResolved) {
         const spec = preResolved ?? await this.opts.spawnSpec();
-        const spawn46 = this.opts.spawnImpl ?? import_node_child_process33.spawn;
-        const child = spawn46(spec.command, spec.args, {
+        const spawn47 = this.opts.spawnImpl ?? import_node_child_process33.spawn;
+        const child = spawn47(spec.command, spec.args, {
           env: { ...process.env, ...spec.env },
           // env only — never argv
           stdio: ["pipe", "pipe", "inherit"]
@@ -8081,7 +8081,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.69.0" : "0.0.0-dev",
+    cliVersion: true ? "2.71.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8323,7 +8323,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.69.0",
+  version: "2.71.0",
   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",
@@ -9859,7 +9859,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.69.0" ? { ideVersion: "2.69.0" } : {}
+      ..."2.71.0" ? { ideVersion: "2.71.0" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -11270,7 +11270,7 @@ var fs65 = __toESM(require("fs"));
 var os54 = __toESM(require("os"));
 var path71 = __toESM(require("path"));
 var import_crypto3 = require("crypto");
-var import_child_process27 = require("child_process");
+var import_child_process28 = require("child_process");
 
 // src/lib/payload.ts
 var import_zod = require("zod");
@@ -14062,7 +14062,7 @@ function subscribeToPairCompletion(pluginId, onPaired, onTimeout, pollSecret) {
     onPaired(info);
   };
   dispatchers.add(dispatch);
-  const connect3 = () => {
+  const connect4 = () => {
     if (stopped) return;
     const url2 = new URL(`${API_BASE5}/api/commands/pending/stream`);
     url2.searchParams.set("pluginId", pluginId);
@@ -14088,7 +14088,7 @@ function subscribeToPairCompletion(pluginId, onPaired, onTimeout, pollSecret) {
             `sse status=${res.statusCode}; will reconnect in 1s`
           );
           res.resume();
-          setTimeout(connect3, 1e3);
+          setTimeout(connect4, 1e3);
           return;
         }
         let buf = "";
@@ -14103,23 +14103,23 @@ function subscribeToPairCompletion(pluginId, onPaired, onTimeout, pollSecret) {
           }
         });
         res.on("end", () => {
-          if (!stopped) setTimeout(connect3, 250);
+          if (!stopped) setTimeout(connect4, 250);
         });
         res.on("error", () => {
-          if (!stopped) setTimeout(connect3, 1e3);
+          if (!stopped) setTimeout(connect4, 1e3);
         });
       }
     );
     req.on("error", () => {
-      if (!stopped) setTimeout(connect3, 1e3);
+      if (!stopped) setTimeout(connect4, 1e3);
     });
     req.on("timeout", () => {
       req?.destroy();
-      if (!stopped) setTimeout(connect3, 250);
+      if (!stopped) setTimeout(connect4, 250);
     });
     req.end();
   };
-  connect3();
+  connect4();
   timeoutTimer = setTimeout(() => {
     stop();
     onTimeout();
@@ -17074,7 +17074,7 @@ async function ensurePythonInstaller(runner) {
   return { ok: true, installer: { kind: "pip" } };
 }
 async function resolveHeadroomPython(runner) {
-  const PROBE_TIMEOUT_MS = 5e3;
+  const PROBE_TIMEOUT_MS2 = 5e3;
   const SUFFIXES = ["python3.13", "python3.12", "python3.11", "python3.10"];
   const PREFIX_DIRS = ["/opt/homebrew/bin", "/usr/local/bin"];
   const probe = async (candidate) => {
@@ -17082,7 +17082,7 @@ async function resolveHeadroomPython(runner) {
       const r = await runner.run(
         candidate,
         ["-c", 'import sys; print("%d.%d" % sys.version_info[:2])'],
-        { timeoutMs: PROBE_TIMEOUT_MS }
+        { timeoutMs: PROBE_TIMEOUT_MS2 }
       );
       if (r.code !== 0) return false;
       const parts = (r.stdout ?? "").trim().split(".");
@@ -17090,7 +17090,7 @@ async function resolveHeadroomPython(runner) {
       const minor = parseInt(parts[1] ?? "", 10);
       if (!(major === 3 && minor >= 10)) return false;
       const pipCheck = await runner.run(candidate, ["-m", "pip", "--version"], {
-        timeoutMs: PROBE_TIMEOUT_MS
+        timeoutMs: PROBE_TIMEOUT_MS2
       });
       return pipCheck.code === 0;
     } catch {
@@ -22118,7 +22118,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.69.0" : null;
+  const current2 = true ? "2.71.0" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22135,7 +22135,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.69.0" : null;
+  const current2 = true ? "2.71.0" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22158,7 +22158,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.69.0" : null;
+  return true ? "2.71.0" : null;
 }
 async function installedVersion(deps) {
   const ls = await deps.run(
@@ -24029,17 +24029,17 @@ async function defaultFetchJson(url2) {
 async function readUsageReport(deps = {}) {
   const port = deps.port ?? HEADROOM_PROXY_PORT;
   const base = `http://127.0.0.1:${port}`;
-  const get2 = deps.fetchJson ?? ((path95) => defaultFetchJson(`${base}${path95}`));
+  const get3 = deps.fetchJson ?? ((path95) => defaultFetchJson(`${base}${path95}`));
   let history;
   try {
-    history = await get2("/stats-history");
+    history = await get3("/stats-history");
   } catch (err) {
     log.info("headroomUsage", `stats-history unavailable: ${err.message}`);
     return null;
   }
   let proxyVersion;
   try {
-    const health = await get2("/health");
+    const health = await get3("/health");
     if (health && typeof health.version === "string") proxyVersion = health.version;
   } catch {
   }
@@ -24380,7 +24380,18 @@ function isBuildHealSupported(framework) {
 function defaultWatchDir(dir, onEvent) {
   try {
     const w3 = fs52.watch(dir, { persistent: false }, (_eventType, filename) => onEvent(filename));
-    return () => w3.close();
+    w3.on("error", () => {
+      try {
+        w3.close();
+      } catch {
+      }
+    });
+    return () => {
+      try {
+        w3.close();
+      } catch {
+      }
+    };
   } catch {
     return null;
   }
@@ -24798,11 +24809,78 @@ async function waitForPortListening(port, opts) {
 var import_fs4 = require("fs");
 var import_path7 = __toESM(require("path"));
 
-// src/services/preview/run-setup.ts
+// src/services/preview/embedded-postgres.ts
 var import_child_process20 = require("child_process");
+var net3 = __toESM(require("net"));
+var BOOT = `
+const { PGlite } = require('@electric-sql/pglite');
+const { PGLiteSocketServer } = require('@electric-sql/pglite-socket');
+(async () => {
+  // 'memory://' \u2014 ef\xEDmero por dise\xF1o; ver el comentario del m\xF3dulo.
+  const db = await PGlite.create('memory://');
+  const server = new PGLiteSocketServer({ db, port: PORT, host: '127.0.0.1' });
+  await server.start();
+  process.on('SIGTERM', async () => { await server.stop(); process.exit(0); });
+})().catch((e) => { console.error(String(e && e.message)); process.exit(1); });
+`;
+function isListening(port) {
+  return new Promise((resolve10) => {
+    const s = net3.connect({ host: "127.0.0.1", port }, () => {
+      s.destroy();
+      resolve10(true);
+    }).on("error", () => resolve10(false));
+    s.setTimeout(1e3, () => {
+      s.destroy();
+      resolve10(false);
+    });
+  });
+}
+var DEFAULT_PORT = 5432;
+async function startEmbeddedPostgres(opts = {}) {
+  const port = opts.port ?? DEFAULT_PORT;
+  const probe = opts.probe ?? isListening;
+  const log2 = opts.log ?? (() => void 0);
+  if (await probe(port)) {
+    log2(`embedded postgres skipped \u2014 port ${port} already serving`);
+    return null;
+  }
+  const child = (opts.spawnFn ?? import_child_process20.spawn)(
+    process.execPath,
+    ["-e", `const PORT=${port};${BOOT}`],
+    { stdio: ["ignore", "pipe", "pipe"], detached: false }
+  );
+  let failure = "";
+  child.stderr?.on("data", (d3) => {
+    failure += String(d3).slice(0, 400);
+  });
+  const deadline = Date.now() + (opts.readyTimeoutMs ?? 2e4);
+  while (Date.now() < deadline) {
+    if (child.exitCode !== null) {
+      log2(`embedded postgres unavailable (${failure.trim() || "exited"})`);
+      return null;
+    }
+    if (await probe(port)) {
+      log2(`embedded postgres serving on ${port}`);
+      return { port, stop: () => stopChild(child) };
+    }
+    await new Promise((r) => setTimeout(r, 250));
+  }
+  log2("embedded postgres did not become ready in time");
+  stopChild(child);
+  return null;
+}
+function stopChild(child) {
+  try {
+    child.kill("SIGTERM");
+  } catch {
+  }
+}
+
+// src/services/preview/run-setup.ts
+var import_child_process21 = require("child_process");
 function runSetupCommand(cmd, args2, cwd, env, opts) {
   return new Promise((resolve10) => {
-    const child = (0, import_child_process20.spawn)(cmd, args2, {
+    const child = (0, import_child_process21.spawn)(cmd, args2, {
       cwd,
       env: { ...process.env, ...env ?? {} },
       stdio: ["ignore", "pipe", "pipe"]
@@ -24886,6 +24964,35 @@ var REDIS = {
   healthTest: ["CMD", "redis-cli", "ping"],
   envLines: ["REDIS_URL=redis://localhost:6379", "REDIS_HOST=localhost", "REDIS_PORT=6379"]
 };
+async function readPrismaProvider(cwd) {
+  for (const rel of ["prisma/schema.prisma", "schema.prisma", "src/prisma/schema.prisma"]) {
+    try {
+      return prismaProvider(await import_fs4.promises.readFile(import_path7.default.join(cwd, rel), "utf8"));
+    } catch {
+    }
+  }
+  return null;
+}
+function prismaProvider(schema) {
+  const m = /datasource\s+\w+\s*\{[^}]*?provider\s*=\s*"([^"]+)"/s.exec(schema);
+  return m ? m[1] : null;
+}
+function serviceForPrismaProvider(provider) {
+  switch (provider) {
+    case "postgresql":
+    case "postgres":
+      return POSTGRES;
+    case "mysql":
+    // PlanetScale habla el protocolo de MySQL.
+    case "planetscale":
+      return MYSQL;
+    case "mongodb":
+      return MONGO;
+    // `sqlite` es un FICHERO: no necesita contenedor y no es un hueco.
+    default:
+      return null;
+  }
+}
 function detectServicesFromDeps(pkg) {
   const deps = /* @__PURE__ */ new Set([
     ...Object.keys(pkg.dependencies ?? {}),
@@ -24994,12 +25101,72 @@ function runDockerComposeUp(cwd, composeArgs) {
     { timeoutMs: 18e4 }
   );
 }
+var embeddedPg = null;
+function registerEmbeddedPostgres(pg) {
+  embeddedPg?.stop();
+  embeddedPg = pg;
+}
+var lastOutcome = null;
+function noteProvisionOutcome(outcome) {
+  lastOutcome = outcome;
+}
+function getLastProvisionOutcome() {
+  return lastOutcome;
+}
+function envVarFor(service) {
+  const first = service.envLines[0] ?? "";
+  return first.split("=")[0] || "DATABASE_URL";
+}
 async function provisionProjectDependencies(cwd) {
+  let needed = [];
+  const outcome = (reason) => ({
+    reason,
+    missing: reason === "ok" ? [] : needed.map((sv) => ({ service: sv.name, envVar: envVarFor(sv) }))
+  });
   try {
-    const docker = await runSetupCommand("docker", ["info"], cwd, void 0, { timeoutMs: 15e3 });
+    let docker = await runSetupCommand("docker", ["info"], cwd, void 0, {
+      timeoutMs: 15e3
+    });
+    if (docker.status !== "ok") {
+      log.info("provision", "docker not responding \u2014 trying to start the daemon");
+      for (const argv of [
+        ["-n", "systemctl", "start", "docker"],
+        ["-n", "service", "docker", "start"]
+      ]) {
+        const started2 = await runSetupCommand("sudo", argv, cwd, void 0, {
+          timeoutMs: 45e3
+        });
+        if (started2.status !== "ok") continue;
+        docker = await runSetupCommand("docker", ["info"], cwd, void 0, {
+          timeoutMs: 2e4
+        });
+        if (docker.status === "ok") {
+          log.info("provision", `docker daemon started via ${argv[1]}`);
+          break;
+        }
+      }
+    }
     if (docker.status !== "ok") {
       log.info("provision", "docker not usable \u2014 skipping dependency provisioning");
-      return;
+      const pkgForNeeds = await readPackageJson(cwd);
+      needed = pkgForNeeds ? detectServicesFromDeps(pkgForNeeds) : [];
+      const prismaNeed = serviceForPrismaProvider(await readPrismaProvider(cwd));
+      if (prismaNeed && !needed.some((n) => n.name === prismaNeed.name)) {
+        needed.push(prismaNeed);
+      }
+      const pgIndex = needed.findIndex((n) => n.name === "postgres");
+      if (pgIndex !== -1) {
+        const embedded = await startEmbeddedPostgres({
+          port: 5432,
+          log: (m) => log.info("provision", m)
+        });
+        if (embedded) {
+          registerEmbeddedPostgres(embedded);
+          await ensureEnvFile(cwd, [needed[pgIndex]]);
+          needed.splice(pgIndex, 1);
+        }
+      }
+      return outcome(needed.length === 0 ? "ok" : "no-docker");
     }
     const pkg = await readPackageJson(cwd);
     let started = false;
@@ -25012,6 +25179,11 @@ async function provisionProjectDependencies(cwd) {
       if (!started) log.warn("provision", `compose up \u2192 ${up.status} (non-fatal)`);
     } else if (pkg) {
       generated = detectServicesFromDeps(pkg);
+      const prismaSvc = serviceForPrismaProvider(await readPrismaProvider(cwd));
+      if (prismaSvc && !generated.some((g) => g.name === prismaSvc.name)) {
+        generated.push(prismaSvc);
+      }
+      needed = generated;
       if (generated.length > 0) {
         const dir = import_path7.default.join(cwd, ".codeam", "provision");
         await import_fs4.promises.mkdir(dir, { recursive: true });
@@ -25031,8 +25203,10 @@ async function provisionProjectDependencies(cwd) {
     await ensureEnvFile(cwd, generated);
     if (started && pkg?.scripts) await runMigrationsIfPresent(cwd, pkg.scripts);
     log.info("provision", "project dependency provisioning complete");
+    return outcome(needed.length > 0 && !started ? "compose-failed" : "ok");
   } catch (err) {
     log.warn("provision", "provisionProjectDependencies failed (non-fatal)", err);
+    return outcome("unknown");
   }
 }
 
@@ -25100,6 +25274,51 @@ async function awaitTunnelRegistered(candidate, hostname3, deadlineMs) {
   }
 }
 
+// src/services/preview/adopt-port.ts
+var http6 = __toESM(require("http"));
+var DIRECTORY_LISTING_RE = /<title>\s*(?:Directory listing for|Index of)/i;
+var PROBE_TIMEOUT_MS = 2e3;
+var PROBE_BODY_LIMIT = 4 * 1024;
+function verdictFor(res) {
+  if (!res) return { adopt: false, reason: "unreachable" };
+  if (!res.contentType || !res.contentType.toLowerCase().includes("text/html")) {
+    return { adopt: false, reason: "not-html" };
+  }
+  if (DIRECTORY_LISTING_RE.test(res.bodyStart)) {
+    return { adopt: false, reason: "directory-listing" };
+  }
+  return { adopt: true };
+}
+var probePort = (port) => new Promise((resolve10) => {
+  const req = http6.get(
+    { host: "127.0.0.1", port, path: "/", timeout: PROBE_TIMEOUT_MS },
+    (res) => {
+      let body = "";
+      res.setEncoding("utf8");
+      res.on("data", (c2) => {
+        if (body.length < PROBE_BODY_LIMIT) body += c2;
+      });
+      res.on(
+        "end",
+        () => resolve10({ contentType: res.headers["content-type"], bodyStart: body })
+      );
+      res.on("error", () => resolve10(null));
+    }
+  );
+  req.on("timeout", () => {
+    req.destroy();
+    resolve10(null);
+  });
+  req.on("error", () => resolve10(null));
+});
+async function canAdoptPort(port, probe = probePort) {
+  try {
+    return verdictFor(await probe(port));
+  } catch {
+    return { adopt: false, reason: "unreachable" };
+  }
+}
+
 // src/services/preview/index.ts
 var activePreviews = /* @__PURE__ */ new Map();
 function registerPreview(sessionId, preview) {
@@ -25133,9 +25352,9 @@ async function killPreview(sessionId) {
     await preview.inspector?.close();
   } catch {
   }
-  killProcessTree(preview.devServer, "SIGTERM");
+  if (preview.devServer) killProcessTree(preview.devServer, "SIGTERM");
   const sigkillTimer = setTimeout(() => {
-    killProcessTree(preview.devServer, "SIGKILL");
+    if (preview.devServer) killProcessTree(preview.devServer, "SIGKILL");
     if (preview.tunnel) killProcessTree(preview.tunnel, "SIGKILL");
   }, 250);
   sigkillTimer.unref?.();
@@ -25151,7 +25370,7 @@ function activePreviewSessionIds() {
 }
 
 // src/services/preview/start-orchestrator.ts
-var import_child_process22 = require("child_process");
+var import_child_process23 = require("child_process");
 var fs59 = __toESM(require("fs"));
 var path64 = __toESM(require("path"));
 var import_which2 = __toESM(require("which"));
@@ -25161,7 +25380,7 @@ var import_fs6 = require("fs");
 var path63 = __toESM(require("path"));
 
 // src/beads/project-key.ts
-var import_child_process21 = require("child_process");
+var import_child_process22 = require("child_process");
 var crypto2 = __toESM(require("crypto"));
 var fs57 = __toESM(require("fs"));
 var path62 = __toESM(require("path"));
@@ -25208,7 +25427,7 @@ function findRepoRoot(cwd) {
 }
 var _execSeam3 = {
   exec: (file, args2, opts) => {
-    const out2 = (0, import_child_process21.execFileSync)(file, args2, opts);
+    const out2 = (0, import_child_process22.execFileSync)(file, args2, opts);
     return typeof out2 === "string" ? out2 : out2.toString("utf8");
   },
   realpath: (p2) => fs57.realpathSync(p2)
@@ -25318,12 +25537,16 @@ async function resolveNamedTunnel(ctx, fetchTunnel) {
 }
 
 // src/services/preview/inspector-proxy.ts
-var http6 = __toESM(require("http"));
-var net3 = __toESM(require("net"));
+var http7 = __toESM(require("http"));
+var net4 = __toESM(require("net"));
 var INJECTION_SCAN_BUDGET_BYTES = 64 * 1024;
 var INJECTION_ANCHORS = ["</head>", "<body>", "</body>"];
-function wantsHtml(accept) {
-  return typeof accept === "string" && accept.includes("text/html");
+function isNavigation(headers) {
+  if (headers.secFetchDest !== void 0) {
+    return headers.secFetchDest === "document" || headers.secFetchDest === "iframe";
+  }
+  if (headers.secFetchMode !== void 0) return headers.secFetchMode === "navigate";
+  return typeof headers.accept === "string" && headers.accept.includes("text/html");
 }
 function isHtmlResponse(contentType) {
   return typeof contentType === "string" && contentType.toLowerCase().includes("text/html");
@@ -25340,11 +25563,16 @@ function injectAt(html, script) {
 async function startInspectorProxy(opts) {
   const targetHost = opts.targetHost ?? "127.0.0.1";
   const upgraded = /* @__PURE__ */ new Set();
-  const server = http6.createServer((req, res) => {
-    const inject = wantsHtml(req.headers.accept);
+  const server = http7.createServer((req, res) => {
+    const one = (v) => Array.isArray(v) ? v[0] : v;
+    const inject = isNavigation({
+      accept: one(req.headers.accept),
+      secFetchDest: one(req.headers["sec-fetch-dest"]),
+      secFetchMode: one(req.headers["sec-fetch-mode"])
+    });
     const headers = { ...req.headers };
     if (inject) delete headers["accept-encoding"];
-    const upstream = http6.request(
+    const upstream = http7.request(
       { host: targetHost, port: opts.targetPort, method: req.method, path: req.url, headers },
       (originRes) => {
         const outHeaders = { ...originRes.headers };
@@ -25391,7 +25619,7 @@ async function startInspectorProxy(opts) {
   });
   server.on("upgrade", (req, clientSocket, head) => {
     upgraded.add(clientSocket);
-    const upstream = net3.connect(opts.targetPort, targetHost, () => {
+    const upstream = net4.connect(opts.targetPort, targetHost, () => {
       const lines = [`${req.method} ${req.url} HTTP/1.1`];
       for (const [k2, v] of Object.entries(req.headers)) {
         for (const one of Array.isArray(v) ? v : [v]) {
@@ -25588,6 +25816,77 @@ function inspectorClientSource(opts) {
       send('hover', { element: describe(el) });
     }
 
+    // Captura, y se traga el evento: mientras el modo esta activo un clic
+    // SELECCIONA, no navega. Sin esto, pulsar un enlace se llevaria el
+    // preview a otra pagina en mitad del gesto.
+    /**
+     * Las marcas FIJADAS, dibujadas DENTRO de la pagina.
+     *
+     * \u26A0\uFE0F Antes las pintaba el dashboard, en una capa sobre el iframe. Como esa
+     * capa vive fuera del documento, sus coordenadas son del VIEWPORT: al
+     * hacer scroll dentro del preview las marcas se quedaban clavadas en la
+     * pantalla mientras el elemento se iba (reportado el 2026-08-29).
+     *
+     * Aqui se anclan al DOCUMENTO (position:absolute mas el scroll sumado), asi
+     * que acompa\xF1an al contenido igual que cualquier otro nodo de la pagina \u2014 y
+     * ademas se recolocan si el layout cambia, que una capa externa no puede
+     * saber.
+     */
+    var picked = [];
+    var seq = 0;
+    var marksHost = null;
+
+    function ensureMarksHost() {
+      if (marksHost && marksHost.parentNode) return marksHost;
+      marksHost = document.createElement('div');
+      marksHost.setAttribute('data-codeam', 'marks');
+      marksHost.style.cssText = 'position:absolute;left:0;top:0;width:0;height:0;z-index:2147483646';
+      document.body.appendChild(marksHost);
+      return marksHost;
+    }
+
+    function redrawMarks() {
+      if (picked.length === 0) {
+        if (marksHost && marksHost.parentNode) marksHost.parentNode.removeChild(marksHost);
+        marksHost = null;
+        return;
+      }
+      var host = ensureMarksHost();
+      host.innerHTML = '';
+      for (var i = 0; i < picked.length; i++) {
+        var r = picked[i].el.getBoundingClientRect();
+        // Coordenadas de DOCUMENTO: es lo que hace que la marca viaje con el
+        // contenido en vez de quedarse pegada a la pantalla.
+        var top = r.top + (window.scrollY || window.pageYOffset || 0);
+        var left = r.left + (window.scrollX || window.pageXOffset || 0);
+
+        var box = document.createElement('div');
+        box.setAttribute('data-codeam', 'mark');
+        box.style.cssText = [
+          'position:absolute', 'pointer-events:none', 'box-sizing:border-box',
+          'border:1.5px solid #a855f7', 'background:rgba(168,85,247,0.12)',
+          'border-radius:3px',
+          'left:' + left + 'px', 'top:' + top + 'px',
+          'width:' + r.width + 'px', 'height:' + r.height + 'px'
+        ].join(';');
+
+        var badge = document.createElement('div');
+        badge.setAttribute('data-codeam', 'mark-badge');
+        badge.style.cssText = [
+          'position:absolute', 'left:-10px', 'top:-10px', 'width:20px', 'height:20px',
+          'border-radius:10px', 'background:#a855f7', 'color:#000',
+          'font:700 11px/20px ui-monospace,SFMono-Regular,Menlo,monospace',
+          'text-align:center', 'pointer-events:none'
+        ].join(';');
+        badge.textContent = String(i + 1);
+
+        box.appendChild(badge);
+        host.appendChild(box);
+      }
+    }
+
+    function reposition() { if (picked.length) redrawMarks(); }
+
     // Captura, y se traga el evento: mientras el modo esta activo un clic
     // SELECCIONA, no navega. Sin esto, pulsar un enlace se llevaria el
     // preview a otra pagina en mitad del gesto.
@@ -25597,7 +25896,30 @@ function inspectorClientSource(opts) {
       if (el && el.getAttribute && el.getAttribute('data-codeam')) return;
       e.preventDefault();
       e.stopPropagation();
-      if (el) send('pick', { element: describe(el) });
+      if (!el) return;
+      var id = 'p' + (++seq);
+      picked.push({ id: id, el: el });
+      redrawMarks();
+      var described = describe(el);
+      described.markId = id;
+      send('pick', { element: described });
+    }
+
+    /**
+     * El dashboard manda la lista de ids que SIGUEN vivos, en su orden.
+     *
+     * Es la otra mitad de \xABla marca es un objeto\xBB: si el usuario borra un chip
+     * en el composer, la marca tiene que desaparecer de la pagina \u2014 y las que
+     * quedan renumerarse, porque lo que el usuario escribe (\xAB\u2460 se sale\xBB) mira
+     * a estos numeros.
+     */
+    function syncMarks(ids) {
+      var byId = {};
+      for (var i = 0; i < picked.length; i++) byId[picked[i].id] = picked[i];
+      var next = [];
+      for (var j = 0; j < ids.length; j++) if (byId[ids[j]]) next.push(byId[ids[j]]);
+      picked = next;
+      redrawMarks();
     }
 
     function enable(origin) {
@@ -25606,6 +25928,9 @@ function inspectorClientSource(opts) {
       driver = origin;
       document.addEventListener('mousemove', onMove, true);
       document.addEventListener('click', onClick, true);
+      // El scroll y el resize mueven los elementos; las marcas los siguen.
+      window.addEventListener('scroll', reposition, true);
+      window.addEventListener('resize', reposition);
       send('ready', {});
     }
 
@@ -25615,7 +25940,11 @@ function inspectorClientSource(opts) {
       current = null;
       document.removeEventListener('mousemove', onMove, true);
       document.removeEventListener('click', onClick, true);
+      window.removeEventListener('scroll', reposition, true);
+      window.removeEventListener('resize', reposition);
       removeOverlay();
+      // Las marcas fijadas SI sobreviven a salir del modo: siguen siendo el
+      // contexto del mensaje que el usuario esta escribiendo.
       driver = null;
     }
 
@@ -25625,6 +25954,7 @@ function inspectorClientSource(opts) {
       if (!data || data.source !== CHANNEL) return;
       if (data.type === 'enable') enable(e.origin);
       else if (data.type === 'disable') disable();
+      else if (data.type === 'marks' && data.ids) syncMarks(data.ids);
     });
 
     /**
@@ -25772,7 +26102,7 @@ async function runPreviewStart(args2) {
     }
   };
   const existing = activePreviews.get(sessionId);
-  if (existing && existing.devServer.exitCode === null) {
+  if (existing && existing.devServer?.exitCode !== 0 && existing.devServer?.exitCode == null) {
     log.info(
       "preview",
       `reusing running preview for session=${sessionId} url=${existing.url}`
@@ -25806,7 +26136,9 @@ async function runPreviewStart(args2) {
     detection,
     cwd: ctx.cwd
   });
-  recordPreviewPort(detection.port, dev.devServer.pid, sessionId, Date.now());
+  if (dev.devServer) {
+    recordPreviewPort(detection.port, dev.devServer.pid, sessionId, Date.now());
+  }
   log.info("preview", `ready: ${detection.framework} at ${tun.url}`);
   emit2(USER_EVENTS.PREVIEW_READY, {
     url: tun.url,
@@ -25919,7 +26251,7 @@ async function startDevServer(ctx) {
   const { sessionId, detection, cwd, emit: emit2, emitProgress } = ctx;
   if (await isPortListening(detection.port)) {
     const raceExisting = activePreviews.get(sessionId);
-    if (raceExisting && raceExisting.devServer.exitCode === null) {
+    if (raceExisting && raceExisting.devServer?.exitCode == null) {
       log.info(
         "preview",
         `port race: reusing running preview for session=${sessionId} url=${raceExisting.url}`
@@ -25935,7 +26267,7 @@ async function startDevServer(ctx) {
     if (raceExisting) {
       log.info(
         "preview",
-        `reclaiming stale preview holding port ${detection.port} for session=${sessionId} (exit=${raceExisting.devServer.exitCode})`
+        `reclaiming stale preview holding port ${detection.port} for session=${sessionId} (exit=${raceExisting.devServer?.exitCode})`
       );
       await killPreview(sessionId);
       const freeDeadline = Date.now() + 4e3;
@@ -25963,9 +26295,18 @@ async function startDevServer(ctx) {
         return null;
       }
     } else {
+      const verdict = await canAdoptPort(detection.port);
+      if (verdict.adopt) {
+        log.info(
+          "preview",
+          `adopting the dev server already serving on port ${detection.port}`
+        );
+        emitProgress("READY_DETECTED", `adopted the server already on port ${detection.port}`);
+        return { devServer: null, expoUrlRef: { current: null } };
+      }
       emit2(USER_EVENTS.PREVIEW_ERROR, {
         stage: "spawn",
-        message: `Port ${detection.port} is already in use by another process, so the dev server can't start there. Stop whatever is listening on port ${detection.port} and try the preview again.`
+        message: verdict.reason === "directory-listing" ? `Port ${detection.port} is serving a directory listing, not your app \u2014 that's usually a leftover \`python -m http.server\`. Stop it and try the preview again.` : `Port ${detection.port} is already in use by something that isn't a dev server, so the preview can't start there. Stop whatever is listening on port ${detection.port} and try again.`
       });
       return null;
     }
@@ -25973,7 +26314,7 @@ async function startDevServer(ctx) {
   await applyPreviewHostAllow(cwd);
   const spawnable = normalizeDetectionForSpawn(detection, cwd);
   emitProgress("BOOT_SEQUENCE", `${spawnable.command} ${spawnable.args.join(" ")}`);
-  const devServer = (0, import_child_process22.spawn)(spawnable.command, spawnable.args, {
+  const devServer = (0, import_child_process23.spawn)(spawnable.command, spawnable.args, {
     cwd,
     env: { ...process.env, ...spawnable.env ?? {} },
     stdio: ["ignore", "pipe", "pipe"],
@@ -26039,7 +26380,7 @@ async function establishTunnel(ctx, dev) {
     }
     const expoUrl = dev.expoUrlRef.current;
     if (!expoUrl) {
-      killProcessTree(devServer, "SIGTERM");
+      if (devServer) killProcessTree(devServer, "SIGTERM");
       emit2(USER_EVENTS.PREVIEW_ERROR, {
         stage: "tunnel",
         message: "Expo did not report a tunnel URL."
@@ -26056,7 +26397,7 @@ async function establishTunnel(ctx, dev) {
   try {
     bin = await resolveCloudflared();
   } catch (e) {
-    killProcessTree(devServer, "SIGTERM");
+    if (devServer) killProcessTree(devServer, "SIGTERM");
     emit2(USER_EVENTS.PREVIEW_ERROR, {
       stage: "tunnel",
       message: e.message
@@ -26110,7 +26451,7 @@ async function establishTunnel(ctx, dev) {
         `cloudflared quick tunnel (retry ${attempt}/${MAX_TUNNEL_ATTEMPTS})`
       );
     }
-    const candidate = (0, import_child_process22.spawn)(
+    const candidate = (0, import_child_process23.spawn)(
       bin,
       ["tunnel", "--url", `http://localhost:${tunnelPort}`],
       { stdio: ["ignore", "pipe", "pipe"] }
@@ -26130,7 +26471,7 @@ async function establishTunnel(ctx, dev) {
     }
   }
   if (!parsedUrl) {
-    killProcessTree(devServer, "SIGTERM");
+    if (devServer) killProcessTree(devServer, "SIGTERM");
     emit2(USER_EVENTS.PREVIEW_ERROR, {
       stage: "tunnel",
       message: `Tunnel did not become reachable after ${MAX_TUNNEL_ATTEMPTS} attempts (${lastTunnelErr}). Cloudflare Quick Tunnels occasionally fail to register \u2014 please retry.`
@@ -26141,7 +26482,7 @@ async function establishTunnel(ctx, dev) {
 }
 
 // src/beads/bd-adapter.ts
-var import_child_process23 = require("child_process");
+var import_child_process24 = require("child_process");
 var fs60 = __toESM(require("fs"));
 var os48 = __toESM(require("os"));
 var path65 = __toESM(require("path"));
@@ -26195,7 +26536,7 @@ function _defaultSpawn(binaryPath, args2, opts) {
   return new Promise((resolve10) => {
     let proc;
     try {
-      proc = (0, import_child_process23.spawn)(binaryPath, args2, { cwd: opts.cwd, env: opts.env });
+      proc = (0, import_child_process24.spawn)(binaryPath, args2, { cwd: opts.cwd, env: opts.env });
     } catch (err) {
       resolve10({ code: -1, stdout: "", stderr: err.message });
       return;
@@ -26352,13 +26693,13 @@ function coerceIssue(row, projectKey) {
 }
 
 // src/beads/provisioner.ts
-var import_child_process26 = require("child_process");
+var import_child_process27 = require("child_process");
 var fs62 = __toESM(require("fs"));
 var os50 = __toESM(require("os"));
 var path67 = __toESM(require("path"));
 
 // src/beads/install-bd.ts
-var import_child_process24 = require("child_process");
+var import_child_process25 = require("child_process");
 var INSTALL_SH_URL = "https://raw.githubusercontent.com/gastownhall/beads/main/scripts/install.sh";
 var INSTALL_PS1_URL = "https://raw.githubusercontent.com/gastownhall/beads/main/install.ps1";
 function resolveInstallStrategy(platform3) {
@@ -26389,7 +26730,7 @@ function _defaultInstallSpawn(strategy) {
   return new Promise((resolve10) => {
     let proc;
     try {
-      proc = (0, import_child_process24.spawn)(strategy.command, strategy.args, { env: process.env });
+      proc = (0, import_child_process25.spawn)(strategy.command, strategy.args, { env: process.env });
     } catch (err) {
       resolve10({ ok: false, code: -1, stderr: err.message });
       return;
@@ -26419,7 +26760,7 @@ async function installBd(platform3 = process.platform) {
 }
 
 // src/beads/install-dolt.ts
-var import_child_process25 = require("child_process");
+var import_child_process26 = require("child_process");
 var fs61 = __toESM(require("fs"));
 var os49 = __toESM(require("os"));
 var path66 = __toESM(require("path"));
@@ -26581,7 +26922,7 @@ function _defaultDoltInstallSpawn(strategy) {
     };
     let proc;
     try {
-      proc = (0, import_child_process25.spawn)(strategy.command, strategy.args, {
+      proc = (0, import_child_process26.spawn)(strategy.command, strategy.args, {
         env: process.env,
         stdio: ["ignore", "pipe", "pipe"]
       });
@@ -26808,7 +27149,7 @@ function linkBdOntoPath(binaryPath) {
   log.info("beads", `linked bd onto PATH: ${linkPath} -> ${binaryPath}`);
 }
 function setGitBeadsRole() {
-  (0, import_child_process26.execFileSync)("git", ["config", "--global", "beads.role", "contributor"], {
+  (0, import_child_process27.execFileSync)("git", ["config", "--global", "beads.role", "contributor"], {
     stdio: "ignore"
   });
 }
@@ -27663,7 +28004,7 @@ var sessionTerminated = async (ctx, cmd) => {
   }
   quiet(() => ctx.agent.kill());
   try {
-    const proc = (0, import_child_process27.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
+    const proc = (0, import_child_process28.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
       detached: true,
       stdio: "ignore"
     });
@@ -27682,7 +28023,7 @@ var shutdownSession = async (ctx, cmd) => {
   quiet(() => ctx.agent.kill());
   if (ctx.keepAliveCtx.inCodespace && ctx.keepAliveCtx.codespaceName) {
     try {
-      const stopProc = (0, import_child_process27.spawn)(
+      const stopProc = (0, import_child_process28.spawn)(
         "bash",
         ["-lc", `sleep 1; gh codespace stop -c ${JSON.stringify(ctx.keepAliveCtx.codespaceName)} >/dev/null 2>&1 || true`],
         { detached: true, stdio: "ignore" }
@@ -27692,7 +28033,7 @@ var shutdownSession = async (ctx, cmd) => {
     }
   }
   try {
-    const proc = (0, import_child_process27.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
+    const proc = (0, import_child_process28.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
       detached: true,
       stdio: "ignore"
     });
@@ -28297,7 +28638,7 @@ var defaultCliUpdateDeps = {
   // Only a truly local `codeam start` (neither marker) re-execs in place below.
   isSupervised: () => process.env["CODEAM_AUTO_APPROVE"] === "1" || process.env["CODESPACES"] === "true",
   relaunch: (args2) => {
-    const child = (0, import_child_process27.spawnSync)("codeam", args2, { stdio: "inherit", env: process.env });
+    const child = (0, import_child_process28.spawnSync)("codeam", args2, { stdio: "inherit", env: process.env });
     process.exit(child.status ?? 0);
   }
 };
@@ -28378,7 +28719,7 @@ async function runNpmInstallLatest() {
     const useShell = process.platform === "win32";
     const command2 = useShell && invocation.command.includes(" ") ? `"${invocation.command}"` : invocation.command;
     const result = await new Promise((resolve10) => {
-      (0, import_child_process27.execFile)(
+      (0, import_child_process28.execFile)(
         command2,
         invocation.args,
         { timeout: CLI_UPDATE_INSTALL_TIMEOUT_MS, shell: useShell },
@@ -28705,9 +29046,18 @@ function parseInsightText(text) {
     securityNote: securityMatch?.[1]?.trim() || void 0
   };
 }
-var emitPreviewEvent = makeSerializedEmitter(
+var emitPreviewEventRaw = makeSerializedEmitter(
   (args2) => postPreviewEvent(args2)
 );
+var emitPreviewEvent = (args2) => {
+  if (args2.type !== USER_EVENTS.PREVIEW_ERROR) return emitPreviewEventRaw(args2);
+  const missing = getLastProvisionOutcome()?.missing ?? [];
+  if (missing.length === 0) return emitPreviewEventRaw(args2);
+  return emitPreviewEventRaw({
+    ...args2,
+    payload: { ...args2.payload ?? {}, missingServices: missing }
+  });
+};
 var requestPreviewDetectH = (ctx) => {
   if (!ctx.pluginAuthToken) {
     log.info("preview", "no pluginAuthToken \u2014 skipping detect");
@@ -28804,7 +29154,7 @@ function makePreviewReaffirm(args2) {
   return makePreviewHeartbeatReaffirm({
     serving: () => {
       const active2 = activePreviews.get(sessionId);
-      if (!active2 || active2.devServer.exitCode !== null) return null;
+      if (!active2 || active2.devServer && active2.devServer.exitCode !== null) return null;
       return {
         url: active2.url,
         framework: active2.framework,
@@ -29048,13 +29398,13 @@ async function dispatchCommand(ctx, cmd) {
 }
 
 // src/commands/start/keep-alive.ts
-var import_child_process28 = require("child_process");
+var import_child_process29 = require("child_process");
 function buildKeepAlive(ctx) {
   let timer = null;
   async function setIdleTimeout(minutes) {
     if (!ctx.inCodespace || !ctx.codespaceName) return;
     await new Promise((resolve10) => {
-      const proc = (0, import_child_process28.spawn)(
+      const proc = (0, import_child_process29.spawn)(
         "gh",
         [
           "api",
@@ -30227,7 +30577,7 @@ var fs67 = __toESM(require("fs"));
 var path74 = __toESM(require("path"));
 var os56 = __toESM(require("os"));
 var https7 = __toESM(require("https"));
-var http7 = __toESM(require("http"));
+var http8 = __toESM(require("http"));
 var import_zod2 = require("zod");
 var historyRecordSchema = import_zod2.z.object({
   type: import_zod2.z.string().optional(),
@@ -30310,7 +30660,7 @@ function post(endpoint, body, pluginAuthToken) {
   return new Promise((resolve10) => {
     const payload = JSON.stringify(body);
     const u2 = new URL(`${API_BASE8}${endpoint}`);
-    const transport = u2.protocol === "https:" ? https7 : http7;
+    const transport = u2.protocol === "https:" ? https7 : http8;
     const req = transport.request(
       {
         hostname: u2.hostname,
@@ -36036,12 +36386,12 @@ function buildRelaunchProxyEnv(baseEnv) {
   return env;
 }
 var relaunchProxyWithoutBudget = async () => {
-  const { spawn: spawn46 } = await import("child_process");
+  const { spawn: spawn47 } = await import("child_process");
   killHeadroomProxy();
   await new Promise((r) => setTimeout(r, 500));
   const proxyEnv = buildRelaunchProxyEnv(process.env);
   try {
-    const proxy = spawn46(
+    const proxy = spawn47(
       "headroom",
       ["proxy", "--port", "8787"],
       { stdio: "ignore", detached: true, env: proxyEnv }
@@ -36261,7 +36611,7 @@ async function performAgentSwitch(deps, rawAgentId, fastPath = {}) {
 }
 
 // src/services/streaming/transport.ts
-var http8 = __toESM(require("http"));
+var http9 = __toESM(require("http"));
 var https8 = __toESM(require("https"));
 var _transport4 = {
   post: _post3,
@@ -36271,7 +36621,7 @@ function _post3(url2, headers, payload) {
   return new Promise((resolve10, reject) => {
     let settled = false;
     const u2 = new URL(url2);
-    const lib = u2.protocol === "https:" ? https8 : http8;
+    const lib = u2.protocol === "https:" ? https8 : http9;
     const req = lib.request(
       {
         hostname: u2.hostname,
@@ -36313,7 +36663,7 @@ function _get(url2, headers) {
   return new Promise((resolve10, reject) => {
     let settled = false;
     const u2 = new URL(url2);
-    const lib = u2.protocol === "https:" ? https8 : http8;
+    const lib = u2.protocol === "https:" ? https8 : http9;
     const req = lib.request(
       {
         hostname: u2.hostname,
@@ -36947,7 +37297,7 @@ function withholdTrailingPartialFenceMarker(text) {
 }
 
 // src/agents/acp/onboarding.ts
-var import_child_process29 = require("child_process");
+var import_child_process30 = require("child_process");
 var fs69 = __toESM(require("fs"));
 var os59 = __toESM(require("os"));
 var path77 = __toESM(require("path"));
@@ -36968,7 +37318,7 @@ var _onboardingSeam = {
    */
   gitRemoteUrl: (cwd) => {
     try {
-      return (0, import_child_process29.execFileSync)("git", ["-C", cwd, "remote", "get-url", "origin"], {
+      return (0, import_child_process30.execFileSync)("git", ["-C", cwd, "remote", "get-url", "origin"], {
         encoding: "utf8",
         stdio: ["ignore", "pipe", "ignore"],
         timeout: 2e3
@@ -37324,7 +37674,7 @@ function extractSelectPrompt(text) {
 var import_crypto5 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
-var import_child_process30 = require("child_process");
+var import_child_process31 = require("child_process");
 var fs71 = __toESM(require("fs/promises"));
 var path79 = __toESM(require("path"));
 
@@ -37510,7 +37860,7 @@ function defaultRunGit(cwd, args2) {
   return new Promise((resolve10) => {
     let proc;
     try {
-      proc = (0, import_child_process30.spawn)("git", args2, { cwd, env: process.env });
+      proc = (0, import_child_process31.spawn)("git", args2, { cwd, env: process.env });
     } catch {
       resolve10(null);
       return;
@@ -43537,8 +43887,9 @@ async function start(requestedAgent, presetSession) {
     })
   );
   provisionSkillsForStart();
-  const depsReady = process.env.CODESPACES === "true" ? provisionProjectDependencies(cwd).catch(() => void 0) : Promise.resolve();
-  if (process.env.CODESPACES === "true") {
+  const managedBox = !isLocalSession();
+  const depsReady = managedBox ? provisionProjectDependencies(cwd).then((outcome) => noteProvisionOutcome(outcome)).catch(() => void 0) : Promise.resolve();
+  if (managedBox) {
     const GATE_TIMEOUT_MS = 24e4;
     const acpAdapterForGate = requiresAcp(session.agent) ? await resolveAcpAdapterWithRetry(session.agent) : null;
     const agentBinaryReady = acpAdapterForGate ? Promise.all([
@@ -44158,11 +44509,11 @@ async function logout() {
 var import_picocolors11 = __toESM(require("picocolors"));
 
 // src/services/providers/github-codespaces.ts
-var import_child_process31 = require("child_process");
+var import_child_process32 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors9 = __toESM(require("picocolors"));
 var path89 = __toESM(require("path"));
-var execFileP6 = (0, import_util4.promisify)(import_child_process31.execFile);
+var execFileP6 = (0, import_util4.promisify)(import_child_process32.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
   if (process.stdin.isTTY) {
@@ -44206,7 +44557,7 @@ var GitHubCodespacesProvider = class {
     if (!isAuthed) {
       resetStdinForChild();
       await new Promise((resolve10, reject) => {
-        const proc = (0, import_child_process31.spawn)("gh", ["auth", "login", "-s", "codespace,repo,read:user"], {
+        const proc = (0, import_child_process32.spawn)("gh", ["auth", "login", "-s", "codespace,repo,read:user"], {
           stdio: "inherit"
         });
         proc.on("exit", (code) => {
@@ -44240,7 +44591,7 @@ var GitHubCodespacesProvider = class {
       wt(noteLines.join("\n"), "One more permission needed");
       resetStdinForChild();
       const refreshCode = await new Promise((resolve10, reject) => {
-        const proc = (0, import_child_process31.spawn)(
+        const proc = (0, import_child_process32.spawn)(
           "gh",
           ["auth", "refresh", "-h", "github.com", "-s", "codespace"],
           { stdio: "inherit" }
@@ -44390,7 +44741,7 @@ var GitHubCodespacesProvider = class {
     O2.step(`Installing gh via ${installCmd.describe}\u2026`);
     resetStdinForChild();
     const ok = await new Promise((resolve10) => {
-      const proc = (0, import_child_process31.spawn)(installCmd.exe, installCmd.args, { stdio: "inherit" });
+      const proc = (0, import_child_process32.spawn)(installCmd.exe, installCmd.args, { stdio: "inherit" });
       proc.on("exit", (code) => resolve10(code === 0));
       proc.on("error", () => resolve10(false));
     });
@@ -44417,7 +44768,7 @@ var GitHubCodespacesProvider = class {
     );
     resetStdinForChild();
     await new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process31.spawn)(
+      const proc = (0, import_child_process32.spawn)(
         "gh",
         ["auth", "refresh", "-h", "github.com", "-s", "repo,read:org"],
         { stdio: "inherit" }
@@ -44595,7 +44946,7 @@ var GitHubCodespacesProvider = class {
   async streamCommand(workspaceId, command2) {
     resetStdinForChild();
     return new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process31.spawn)(
+      const proc = (0, import_child_process32.spawn)(
         "gh",
         ["codespace", "ssh", "-c", workspaceId, "--", "-tt", command2],
         { stdio: "inherit" }
@@ -44622,11 +44973,11 @@ var GitHubCodespacesProvider = class {
       `mkdir -p ${shellQuote(remoteDir)} && tar -xzf - -C ${shellQuote(remoteDir)}`
     ];
     await new Promise((resolve10, reject) => {
-      const tar = (0, import_child_process31.spawn)("tar", tarArgs, {
+      const tar = (0, import_child_process32.spawn)("tar", tarArgs, {
         stdio: ["ignore", "pipe", "pipe"],
         env: tarEnv
       });
-      const ssh = (0, import_child_process31.spawn)("gh", sshArgs, {
+      const ssh = (0, import_child_process32.spawn)("gh", sshArgs, {
         stdio: [tar.stdout, "pipe", "pipe"]
       });
       let tarErr = "";
@@ -44660,7 +45011,7 @@ var GitHubCodespacesProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process31.spawn)(
+      const proc = (0, import_child_process32.spawn)(
         "gh",
         ["codespace", "ssh", "-c", workspaceId, "--", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -44718,11 +45069,11 @@ function shellQuote(s) {
 }
 
 // src/services/providers/gitpod.ts
-var import_child_process32 = require("child_process");
+var import_child_process33 = require("child_process");
 var import_util5 = require("util");
 var path90 = __toESM(require("path"));
 var import_picocolors10 = __toESM(require("picocolors"));
-var execFileP7 = (0, import_util5.promisify)(import_child_process32.execFile);
+var execFileP7 = (0, import_util5.promisify)(import_child_process33.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
 function resetStdinForChild2() {
   if (process.stdin.isTTY) {
@@ -44762,7 +45113,7 @@ var GitpodProvider = class {
     );
     resetStdinForChild2();
     await new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process32.spawn)("gitpod", ["login"], { stdio: "inherit" });
+      const proc = (0, import_child_process33.spawn)("gitpod", ["login"], { stdio: "inherit" });
       proc.on("exit", (code) => {
         if (code === 0) resolve10();
         else reject(new Error("gitpod login failed."));
@@ -44914,7 +45265,7 @@ var GitpodProvider = class {
   async streamCommand(workspaceId, command2) {
     resetStdinForChild2();
     return new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process32.spawn)(
+      const proc = (0, import_child_process33.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", "-tt", command2],
         { stdio: "inherit" }
@@ -44934,11 +45285,11 @@ var GitpodProvider = class {
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote2(remoteDir)} && tar -xzf - -C ${shellQuote2(remoteDir)}`;
     await new Promise((resolve10, reject) => {
-      const tar = (0, import_child_process32.spawn)("tar", tarArgs, {
+      const tar = (0, import_child_process33.spawn)("tar", tarArgs, {
         stdio: ["ignore", "pipe", "pipe"],
         env: tarEnv
       });
-      const ssh = (0, import_child_process32.spawn)(
+      const ssh = (0, import_child_process33.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -44970,7 +45321,7 @@ var GitpodProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process32.spawn)(
+      const proc = (0, import_child_process33.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -44994,10 +45345,10 @@ function shellQuote2(s) {
 }
 
 // src/services/providers/gitlab-workspaces.ts
-var import_child_process33 = require("child_process");
+var import_child_process34 = require("child_process");
 var import_util6 = require("util");
 var path91 = __toESM(require("path"));
-var execFileP8 = (0, import_util6.promisify)(import_child_process33.execFile);
+var execFileP8 = (0, import_util6.promisify)(import_child_process34.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
 function resetStdinForChild3() {
@@ -45039,7 +45390,7 @@ var GitLabWorkspacesProvider = class {
     );
     resetStdinForChild3();
     await new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process33.spawn)(
+      const proc = (0, import_child_process34.spawn)(
         "glab",
         ["auth", "login", "--scopes", "api,read_user,read_repository"],
         { stdio: "inherit" }
@@ -45211,7 +45562,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
     const sshHost = process.env.CODEAM_GITLAB_SSH_HOST ?? "workspaces.gitlab.com";
     resetStdinForChild3();
     return new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process33.spawn)(
+      const proc = (0, import_child_process34.spawn)(
         "ssh",
         ["-tt", "-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, command2],
         { stdio: "inherit" }
@@ -45232,8 +45583,8 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote3(remoteDir)} && tar -xzf - -C ${shellQuote3(remoteDir)}`;
     await new Promise((resolve10, reject) => {
-      const tar = (0, import_child_process33.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
-      const ssh = (0, import_child_process33.spawn)(
+      const tar = (0, import_child_process34.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
+      const ssh = (0, import_child_process34.spawn)(
         "ssh",
         ["-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -45263,7 +45614,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process33.spawn)(
+      const proc = (0, import_child_process34.spawn)(
         "ssh",
         ["-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -45322,10 +45673,10 @@ function shellQuote3(s) {
 }
 
 // src/services/providers/railway.ts
-var import_child_process34 = require("child_process");
+var import_child_process35 = require("child_process");
 var import_util7 = require("util");
 var path92 = __toESM(require("path"));
-var execFileP9 = (0, import_util7.promisify)(import_child_process34.execFile);
+var execFileP9 = (0, import_util7.promisify)(import_child_process35.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
   if (process.stdin.isTTY) {
@@ -45366,7 +45717,7 @@ var RailwayProvider = class {
     );
     resetStdinForChild4();
     await new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process34.spawn)("railway", ["login"], { stdio: "inherit" });
+      const proc = (0, import_child_process35.spawn)("railway", ["login"], { stdio: "inherit" });
       proc.on("exit", (code) => {
         if (code === 0) resolve10();
         else reject(new Error("railway login failed."));
@@ -45509,7 +45860,7 @@ var RailwayProvider = class {
     }
     resetStdinForChild4();
     return new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process34.spawn)(
+      const proc = (0, import_child_process35.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", command2],
         { stdio: "inherit" }
@@ -45533,8 +45884,8 @@ var RailwayProvider = class {
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote4(remoteDir)} && tar -xzf - -C ${shellQuote4(remoteDir)}`;
     await new Promise((resolve10, reject) => {
-      const tar = (0, import_child_process34.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
-      const sh = (0, import_child_process34.spawn)(
+      const tar = (0, import_child_process35.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
+      const sh = (0, import_child_process35.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -45567,7 +45918,7 @@ var RailwayProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve10, reject) => {
-      const proc = (0, import_child_process34.spawn)(
+      const proc = (0, import_child_process35.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -46375,7 +46726,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.69.0" : "0.0.0-dev";
+  const cliVersion = true ? "2.71.0" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -46766,7 +47117,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.69.0" : "unknown";
+  const v = true ? "2.71.0" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.69.0",
+  "version": "2.71.0",
   "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 — async. The terminal companion for CodeAgent Mobile.",
   "type": "commonjs",
   "main": "dist/index.js",