codeam-cli 2.35.1 → 2.35.3

package/CHANGELOG.md

@@ -4,6 +4,24 @@ 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.35.2] — 2026-06-10
+
+### Fixed
+
+- **cli:** Bound preview install + add port-listening ready fallback
+- **cli:** Stop resume_session from killing the agent dead
+
+### Tests
+
+- **cli:** Make linkBdOntoPath/cliBinDir provisioner tests OS-independent
+
+## [2.35.1] — 2026-06-10
+
+### Fixed
+
+- **cli:** Sync package-lock with @beads/bd@1.0.5 (npm ci was failing on main CI)
+- **cli:** Symlink bd into a dir that is actually on PATH
+
 ## [2.35.0] — 2026-06-10
 
 ### Fixed

package/dist/index.js

@@ -498,7 +498,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.35.1",
+  version: "2.35.3",
   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",
@@ -5898,7 +5898,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.35.1" : "0.0.0-dev",
+    cliVersion: true ? "2.35.3" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -6630,11 +6630,17 @@ var AgentService = class _AgentService {
   restart(sessionId, auto = false) {
     if (!this.strategy || !this.initialLaunch) return;
     const resumeArgs = this.runtime.resumeLaunchArgs(sessionId, { auto });
+    const launch = this.runtime.prepareResumeLaunch?.(sessionId, { auto }) ?? {
+      cmd: this.initialLaunch.cmd,
+      args: [...this.initialLaunch.args, ...resumeArgs]
+    };
+    this.agentBusy = false;
+    if (this.quietTimer) {
+      clearTimeout(this.quietTimer);
+      this.quietTimer = null;
+    }
     this.strategy.kill();
-    this.strategy.spawn(this.initialLaunch.cmd, this.opts.cwd, [
-      ...this.initialLaunch.args,
-      ...resumeArgs
-    ]);
+    this.strategy.spawn(launch.cmd, this.opts.cwd, launch.args);
     if (resumeArgs.length === 0 && this.runtime.postSpawnInstruction) {
       const { ptyInput } = this.runtime.postSpawnInstruction(sessionId);
       setTimeout(() => {
@@ -7240,10 +7246,10 @@ function buildForPlatform(platform2) {
 var import_node_crypto4 = require("crypto");
 
 // src/agents/claude/resolver.ts
-function buildClaudeLaunch(extraArgs = [], os30 = createOsStrategy()) {
-  const found = os30.findInPath("claude") ?? os30.findInPath("claude-code");
+function buildClaudeLaunch(extraArgs = [], os31 = createOsStrategy()) {
+  const found = os31.findInPath("claude") ?? os31.findInPath("claude-code");
   if (!found) return null;
-  return os30.buildLaunch(found, extraArgs);
+  return os31.buildLaunch(found, extraArgs);
 }
 
 // src/agents/claude/installer.ts
@@ -9986,8 +9992,8 @@ var ClaudeRuntimeStrategy = class {
   meta = getAgent("claude");
   mode = "interactive";
   os;
-  constructor(os30) {
-    this.os = os30;
+  constructor(os31) {
+    this.os = os31;
   }
   /**
    * Claude Code's react-ink TUI enables bracketed-paste mode at
@@ -10037,6 +10043,28 @@ var ClaudeRuntimeStrategy = class {
     if (opts?.auto) args2.push("--dangerously-skip-permissions");
     return args2;
   }
+  /**
+   * Resume relaunch as a COMPLETE command. We deliberately rebuild the
+   * launch from scratch with `--resume <id>` rather than appending it
+   * onto the spawn-time args, because those carried `--session-id
+   * <uuid>` (the conversation binding from the initial spawn). Claude
+   * Code rejects `--session-id` together with `--resume` and exits
+   * immediately — that was the "resume → agent fully dead, even new
+   * prompts get no response" bug. Building a fresh launch drops the
+   * conflicting flag by construction.
+   *
+   * Synchronous on purpose: by the time a resume happens the binary
+   * was already resolved (the initial spawn succeeded), so
+   * `buildClaudeLaunch` re-probes PATH without needing the async
+   * installer fallback.
+   */
+  prepareResumeLaunch(sessionId, opts) {
+    const launch = buildClaudeLaunch(this.resumeLaunchArgs(sessionId, opts), this.os);
+    if (!launch) {
+      return { cmd: this.meta.binaryName, args: this.resumeLaunchArgs(sessionId, opts) };
+    }
+    return launch;
+  }
   resolveHistoryDir(cwd) {
     return resolveHistoryDir(cwd);
   }
@@ -10995,8 +11023,8 @@ function codexCredentialLocator() {
 function codexLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os30 = createOsStrategy();
-      return os30.findInPath("codex") !== null;
+      const os31 = createOsStrategy();
+      return os31.findInPath("codex") !== null;
     },
     launch() {
       return (0, import_node_child_process3.spawn)("codex", ["login"], { stdio: "inherit" });
@@ -11019,8 +11047,8 @@ var CodexRuntimeStrategy = class {
   meta = getAgent("codex");
   mode = "interactive";
   os;
-  constructor(os30) {
-    this.os = os30;
+  constructor(os31) {
+    this.os = os31;
   }
   async prepareLaunch() {
     let binary = this.os.findInPath("codex");
@@ -11126,12 +11154,12 @@ var CodexRuntimeStrategy = class {
     });
   }
 };
-function resolveNpm(os30) {
-  return os30.id === "win32" ? "npm.cmd" : "npm";
+function resolveNpm(os31) {
+  return os31.id === "win32" ? "npm.cmd" : "npm";
 }
-async function installCodexViaNpm(os30) {
+async function installCodexViaNpm(os31) {
   return new Promise((resolve7, reject) => {
-    const proc = (0, import_node_child_process4.spawn)(resolveNpm(os30), ["install", "-g", "@openai/codex"], {
+    const proc = (0, import_node_child_process4.spawn)(resolveNpm(os31), ["install", "-g", "@openai/codex"], {
       stdio: "inherit"
     });
     proc.on("close", (code) => {
@@ -11148,16 +11176,16 @@ async function installCodexViaNpm(os30) {
     });
   });
 }
-function augmentNpmGlobalBin(os30) {
+function augmentNpmGlobalBin(os31) {
   try {
-    const result = (0, import_node_child_process4.spawnSync)(resolveNpm(os30), ["prefix", "-g"], {
+    const result = (0, import_node_child_process4.spawnSync)(resolveNpm(os31), ["prefix", "-g"], {
       stdio: ["ignore", "pipe", "ignore"]
     });
     if (result.status !== 0) return;
     const prefix = result.stdout.toString().trim();
     if (!prefix) return;
-    const binDir = os30.id === "win32" ? prefix : path17.join(prefix, "bin");
-    os30.augmentPath([binDir]);
+    const binDir = os31.id === "win32" ? prefix : path17.join(prefix, "bin");
+    os31.augmentPath([binDir]);
   } catch {
   }
 }
@@ -11241,9 +11269,9 @@ var import_node_child_process7 = require("child_process");
 // src/agents/coderabbit/installer.ts
 var import_node_child_process5 = require("child_process");
 var INSTALL_URL = "https://cli.coderabbit.ai/install.sh";
-async function ensureCoderabbitInstalled(os30) {
-  if (os30.findInPath("coderabbit")) return true;
-  if (os30.id === "win32") {
+async function ensureCoderabbitInstalled(os31) {
+  if (os31.findInPath("coderabbit")) return true;
+  if (os31.id === "win32") {
     console.error(
       "\n  \u2717 CodeRabbit on Windows requires WSL.\n    Install the CLI inside your WSL distribution\n    (curl -fsSL https://cli.coderabbit.ai/install.sh | sh)\n    then re-run `codeam link coderabbit` from WSL.\n"
     );
@@ -11258,8 +11286,8 @@ async function ensureCoderabbitInstalled(os30) {
     proc.on("error", () => resolve7(false));
   });
   if (!ok) return false;
-  os30.augmentPath([`${os30.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
-  return os30.findInPath("coderabbit") !== null;
+  os31.augmentPath([`${os31.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
+  return os31.findInPath("coderabbit") !== null;
 }
 
 // src/agents/coderabbit/link.ts
@@ -11286,10 +11314,10 @@ function coderabbitCredentialLocator() {
     extract: extractLocalCoderabbitToken
   };
 }
-function coderabbitLoginLauncher(os30) {
+function coderabbitLoginLauncher(os31) {
   return {
     async ensureInstalled() {
-      return ensureCoderabbitInstalled(os30);
+      return ensureCoderabbitInstalled(os31);
     },
     launch() {
       return (0, import_node_child_process6.spawn)("coderabbit", ["login"], { stdio: "inherit" });
@@ -11335,8 +11363,8 @@ var CoderabbitRuntimeStrategy = class {
   meta = getAgent("coderabbit");
   mode = "batch";
   os;
-  constructor(os30) {
-    this.os = os30;
+  constructor(os31) {
+    this.os = os31;
   }
   getDefaultArgs() {
     return ["review"];
@@ -11451,10 +11479,10 @@ function cursorCredentialLocator() {
     extract: extractLocalCursorToken
   };
 }
-function cursorLoginLauncher(os30) {
+function cursorLoginLauncher(os31) {
   return {
     async ensureInstalled() {
-      if (os30.findInPath("cursor-agent")) return true;
+      if (os31.findInPath("cursor-agent")) return true;
       console.error(
         "\n  \u2717 cursor-agent binary not on PATH.\n    Install Cursor (https://cursor.com/) and ensure the CLI\n    plugin is enabled, then re-run `codeam link cursor`.\n"
       );
@@ -11516,8 +11544,8 @@ var CursorRuntimeStrategy = class {
   meta = getAgent("cursor");
   mode = "interactive";
   os;
-  constructor(os30) {
-    this.os = os30;
+  constructor(os31) {
+    this.os = os31;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("cursor-agent");
@@ -11637,10 +11665,10 @@ function aiderCredentialLocator() {
     extract: extractLocalAiderToken
   };
 }
-function aiderLoginLauncher(os30) {
+function aiderLoginLauncher(os31) {
   return {
     async ensureInstalled() {
-      if (os30.findInPath("aider")) return true;
+      if (os31.findInPath("aider")) return true;
       console.error(
         "\n  \u2717 aider binary not on PATH.\n    Install Aider:\n      pip install aider-chat\n    then re-run `codeam link aider`.\n"
       );
@@ -11650,7 +11678,7 @@ function aiderLoginLauncher(os30) {
       console.error(
         "\n  Aider has no interactive login flow.\n    Set ANTHROPIC_API_KEY or OPENAI_API_KEY in your shell,\n    or re-run `codeam link aider --api-key=<your-key>`.\n"
       );
-      return (0, import_node_child_process9.spawn)(os30.id === "win32" ? "cmd.exe" : "sh", os30.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
+      return (0, import_node_child_process9.spawn)(os31.id === "win32" ? "cmd.exe" : "sh", os31.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
         stdio: "ignore"
       });
     }
@@ -11722,8 +11750,8 @@ var AiderRuntimeStrategy = class {
   meta = getAgent("aider");
   mode = "interactive";
   os;
-  constructor(os30) {
-    this.os = os30;
+  constructor(os31) {
+    this.os = os31;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("aider");
@@ -11852,8 +11880,8 @@ function geminiCredentialLocator() {
 function geminiLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os30 = createOsStrategy();
-      return os30.findInPath("gemini") !== null;
+      const os31 = createOsStrategy();
+      return os31.findInPath("gemini") !== null;
     },
     launch() {
       return (0, import_node_child_process10.spawn)("gemini", ["auth", "login"], { stdio: "inherit" });
@@ -11886,8 +11914,8 @@ var GeminiRuntimeStrategy = class {
   meta = getAgent("gemini");
   mode = "interactive";
   os;
-  constructor(os30) {
-    this.os = os30;
+  constructor(os31) {
+    this.os = os31;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("gemini");
@@ -11987,18 +12015,18 @@ var GeminiRuntimeStrategy = class {
 
 // src/agents/registry.ts
 var runtimeBuilders = {
-  claude: (os30) => new ClaudeRuntimeStrategy(os30),
-  codex: (os30) => new CodexRuntimeStrategy(os30),
-  coderabbit: (os30) => new CoderabbitRuntimeStrategy(os30),
-  cursor: (os30) => new CursorRuntimeStrategy(os30),
-  aider: (os30) => new AiderRuntimeStrategy(os30),
-  gemini: (os30) => new GeminiRuntimeStrategy(os30)
+  claude: (os31) => new ClaudeRuntimeStrategy(os31),
+  codex: (os31) => new CodexRuntimeStrategy(os31),
+  coderabbit: (os31) => new CoderabbitRuntimeStrategy(os31),
+  cursor: (os31) => new CursorRuntimeStrategy(os31),
+  aider: (os31) => new AiderRuntimeStrategy(os31),
+  gemini: (os31) => new GeminiRuntimeStrategy(os31)
 };
 var deployBuilders = {
   claude: () => new ClaudeDeployStrategy(),
   codex: () => new CodexDeployStrategy()
 };
-function createAgentStrategy(agent, os30 = createOsStrategy()) {
+function createAgentStrategy(agent, os31 = createOsStrategy()) {
   if (!AGENT_REGISTRY[agent]?.enabled) {
     throw new Error(
       `Agent "${agent}" is not supported in this codeam-cli version. Upgrade with 'npm i -g codeam-cli@latest'.`
@@ -12008,10 +12036,10 @@ function createAgentStrategy(agent, os30 = createOsStrategy()) {
   if (!build) {
     throw new Error(`No runtime strategy registered for agent "${agent}"`);
   }
-  return build(os30);
+  return build(os31);
 }
-function createInteractiveAgentStrategy(agent, os30 = createOsStrategy()) {
-  const s = createAgentStrategy(agent, os30);
+function createInteractiveAgentStrategy(agent, os31 = createOsStrategy()) {
+  const s = createAgentStrategy(agent, os31);
   if (s.mode !== "interactive") {
     throw new Error(
       `Agent "${agent}" is a batch agent; use createAgentStrategy + .runOneShot for one-shot reviews.`
@@ -15711,10 +15739,10 @@ function extractSelectPrompt(text) {
 
 // src/commands/start/handlers.ts
 var fs32 = __toESM(require("fs"));
-var os25 = __toESM(require("os"));
+var os26 = __toESM(require("os"));
 var path39 = __toESM(require("path"));
 var import_crypto3 = require("crypto");
-var import_child_process16 = require("child_process");
+var import_child_process17 = require("child_process");
 
 // src/lib/payload.ts
 var import_zod = require("zod");
@@ -17136,6 +17164,77 @@ function parseExpoUrl(stdout) {
   return match ? match[0] : null;
 }
 
+// src/services/preview/port-ready.ts
+var net = __toESM(require("net"));
+function isPortListening(port, host = "127.0.0.1") {
+  return new Promise((resolve7) => {
+    const socket = new net.Socket();
+    const done = (result) => {
+      socket.removeAllListeners();
+      socket.destroy();
+      resolve7(result);
+    };
+    socket.setTimeout(1e3);
+    socket.once("connect", () => done(true));
+    socket.once("timeout", () => done(false));
+    socket.once("error", () => done(false));
+    socket.connect(port, host);
+  });
+}
+async function waitForPortListening(port, opts) {
+  const interval = opts.intervalMs ?? 500;
+  const deadline = Date.now() + opts.timeoutMs;
+  for (; ; ) {
+    if (await isPortListening(port)) return true;
+    if (Date.now() >= deadline) return false;
+    await new Promise((r) => setTimeout(r, interval));
+  }
+}
+
+// src/services/preview/run-setup.ts
+var import_child_process12 = require("child_process");
+function runSetupCommand(cmd, args2, cwd, env, opts) {
+  return new Promise((resolve7) => {
+    const child = (0, import_child_process12.spawn)(cmd, args2, {
+      cwd,
+      env: { ...process.env, ...env ?? {} },
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let settled = false;
+    const tag = `setup:${cmd}`;
+    const onChunk = (chunk) => {
+      const text = chunk.toString().replace(/\n+$/g, "");
+      if (text.length === 0) return;
+      log.info("preview", `${tag}: ${text}`);
+    };
+    child.stdout?.on("data", onChunk);
+    child.stderr?.on("data", onChunk);
+    const timer = setTimeout(() => {
+      if (settled) return;
+      settled = true;
+      log.info("preview", `${tag}: timed out after ${opts.timeoutMs}ms \u2014 killing`);
+      try {
+        child.kill("SIGTERM");
+      } catch {
+      }
+      resolve7({ status: "timeout", code: null });
+    }, opts.timeoutMs);
+    child.once("exit", (code) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      if (code === 0) resolve7({ status: "ok", code: 0 });
+      else resolve7({ status: "failed", code });
+    });
+    child.once("error", () => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve7({ status: "failed", code: null });
+    });
+  });
+}
+
 // src/services/preview/setup-deps.ts
 var import_fs2 = __toESM(require("fs"));
 var import_path6 = __toESM(require("path"));
@@ -17202,7 +17301,7 @@ function activePreviewSessionIds() {
 }
 
 // src/beads/bd-adapter.ts
-var import_child_process12 = require("child_process");
+var import_child_process13 = require("child_process");
 var fs29 = __toESM(require("fs"));
 var os24 = __toESM(require("os"));
 var path35 = __toESM(require("path"));
@@ -17256,7 +17355,7 @@ function _defaultSpawn(binaryPath, args2, opts) {
   return new Promise((resolve7) => {
     let proc;
     try {
-      proc = (0, import_child_process12.spawn)(binaryPath, args2, { cwd: opts.cwd, env: opts.env });
+      proc = (0, import_child_process13.spawn)(binaryPath, args2, { cwd: opts.cwd, env: opts.env });
     } catch (err) {
       resolve7({ code: -1, stdout: "", stderr: err.message });
       return;
@@ -17392,12 +17491,13 @@ function defaultBeadsHomeDir() {
 }
 
 // src/beads/provisioner.ts
-var import_child_process14 = require("child_process");
+var import_child_process15 = require("child_process");
 var fs30 = __toESM(require("fs"));
+var os25 = __toESM(require("os"));
 var path36 = __toESM(require("path"));
 
 // src/beads/install-bd.ts
-var import_child_process13 = require("child_process");
+var import_child_process14 = 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(platform2) {
@@ -17428,7 +17528,7 @@ function _defaultInstallSpawn(strategy) {
   return new Promise((resolve7) => {
     let proc;
     try {
-      proc = (0, import_child_process13.spawn)(strategy.command, strategy.args, { env: process.env });
+      proc = (0, import_child_process14.spawn)(strategy.command, strategy.args, { env: process.env });
     } catch (err) {
       resolve7({ ok: false, code: -1, stderr: err.message });
       return;
@@ -17477,26 +17577,47 @@ var _provisionSeam = {
 };
 var _linkSeam = {
   platform: () => process.platform,
+  homedir: () => os25.homedir(),
+  isWritableDir: (dir) => {
+    try {
+      fs30.accessSync(dir, fs30.constants.W_OK);
+      return true;
+    } catch {
+      return false;
+    }
+  },
+  ensureDir: (dir) => {
+    fs30.mkdirSync(dir, { recursive: true });
+  },
   /**
-   * A directory ON PATH to symlink `bd` into, so the AGENT's shell + the
-   * SessionStart `bd prime` hook resolve `bd` by name.
+   * A directory to symlink `bd` into so the AGENT's shell + Claude Code's
+   * SessionStart `bd prime` hook resolve `bd` by name. The dir MUST be on the
+   * persistent shell PATH those processes use AND be writable.
    *
-   * Earlier this used `dirname(realpath(process.argv[1]))` — but for a GLOBAL
-   * npm install that resolves to the package's own `dist/` dir (e.g.
-   * `…/node_modules/codeam-cli/dist`), which is NOT on PATH. The symlink landed
-   * somewhere nothing sees, so `which bd` and the hook still failed (observed
-   * live in a codespace). `dirname(process.execPath)` is the dir the `node`
-   * binary lives in — for a global install that's the npm prefix `bin/` where
-   * the `codeam` launcher also lives, and IS on PATH. We prefer the first
-   * candidate that actually appears in `$PATH`, falling back to node's bin dir.
+   * History: v2.35.1 used `dirname(realpath(argv[1]))` (the package `dist/`,
+   * not on PATH); v2.35.2 used `dirname(process.execPath)` — correct for a
+   * normal global npm install, but in a GitHub Codespace `node` lives in a
+   * TRANSIENT bootstrap prefix (`/tmp/codeam-node20/bin`) that is NOT on the
+   * persistent shell PATH, so the hook still failed (validated live). The
+   * dir that IS on PATH and writable in a codespace is `~/.local/bin`.
+   *
+   * Strategy: among [node's bin, ~/.local/bin, /usr/local/bin, entry dir],
+   * pick the first that is BOTH on `$PATH` AND writable. If none qualifies
+   * (codespace: node prefix off-PATH, /usr/local/bin read-only), fall back to
+   * `~/.local/bin` — the standard user bin, on PATH for login shells —
+   * which `linkBdOntoPath` creates if missing.
    */
   cliBinDir: () => {
     const pathDirs = (process.env.PATH ?? "").split(path36.delimiter).filter(Boolean);
+    const home = _linkSeam.homedir();
+    const localBin = home ? path36.join(home, ".local", "bin") : null;
     const candidates = [];
     try {
       candidates.push(path36.dirname(process.execPath));
     } catch {
     }
+    if (localBin) candidates.push(localBin);
+    candidates.push("/usr/local/bin");
     const entry = process.argv[1];
     if (entry) {
       try {
@@ -17505,8 +17626,11 @@ var _linkSeam = {
         candidates.push(path36.dirname(entry));
       }
     }
-    if (candidates.length === 0) return null;
-    return candidates.find((d3) => pathDirs.includes(d3)) ?? candidates[0];
+    const onPathWritable = candidates.find(
+      (d3) => pathDirs.includes(d3) && _linkSeam.isWritableDir(d3)
+    );
+    if (onPathWritable) return onPathWritable;
+    return localBin ?? candidates[0] ?? null;
   },
   /** Current symlink target at `linkPath`, or null when absent / not a link. */
   readlink: (linkPath) => {
@@ -17523,6 +17647,7 @@ function linkBdOntoPath(binaryPath) {
   if (_linkSeam.platform() === "win32") return;
   const binDir = _linkSeam.cliBinDir();
   if (!binDir) return;
+  _linkSeam.ensureDir(binDir);
   const linkPath = path36.join(binDir, "bd");
   if (linkPath === binaryPath) return;
   const current = _linkSeam.readlink(linkPath);
@@ -17532,7 +17657,7 @@ function linkBdOntoPath(binaryPath) {
   log.info("beads", `linked bd onto PATH: ${linkPath} -> ${binaryPath}`);
 }
 function setGitBeadsRole() {
-  (0, import_child_process14.execFileSync)("git", ["config", "--global", "beads.role", "contributor"], {
+  (0, import_child_process15.execFileSync)("git", ["config", "--global", "beads.role", "contributor"], {
     stdio: "ignore"
   });
 }
@@ -17639,7 +17764,7 @@ var crypto3 = __toESM(require("crypto"));
 var path38 = __toESM(require("path"));
 
 // src/beads/project-key.ts
-var import_child_process15 = require("child_process");
+var import_child_process16 = require("child_process");
 var crypto2 = __toESM(require("crypto"));
 var fs31 = __toESM(require("fs"));
 var path37 = __toESM(require("path"));
@@ -17686,7 +17811,7 @@ function findRepoRoot(cwd) {
 }
 var _execSeam2 = {
   exec: (file, args2, opts) => {
-    const out2 = (0, import_child_process15.execFileSync)(file, args2, opts);
+    const out2 = (0, import_child_process16.execFileSync)(file, args2, opts);
     return typeof out2 === "string" ? out2 : out2.toString("utf8");
   },
   realpath: (p2) => fs31.realpathSync(p2)
@@ -18080,7 +18205,7 @@ 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 = path39.join(os25.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
+    const tmpPath = path39.join(os26.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
     fs32.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
     pendingAttachmentFiles.add(tmpPath);
     return tmpPath;
@@ -18226,7 +18351,7 @@ var sessionTerminated = async (ctx, cmd) => {
   } catch {
   }
   try {
-    const proc = (0, import_child_process16.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
+    const proc = (0, import_child_process17.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
       detached: true,
       stdio: "ignore"
     });
@@ -18248,7 +18373,7 @@ var shutdownSession = async (ctx, cmd) => {
   }
   if (ctx.keepAliveCtx.inCodespace && ctx.keepAliveCtx.codespaceName) {
     try {
-      const stopProc = (0, import_child_process16.spawn)(
+      const stopProc = (0, import_child_process17.spawn)(
         "bash",
         ["-lc", `sleep 1; gh codespace stop -c ${JSON.stringify(ctx.keepAliveCtx.codespaceName)} >/dev/null 2>&1 || true`],
         { detached: true, stdio: "ignore" }
@@ -18258,7 +18383,7 @@ var shutdownSession = async (ctx, cmd) => {
     }
   }
   try {
-    const proc = (0, import_child_process16.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
+    const proc = (0, import_child_process17.spawn)("bash", ["-lc", "pm2 delete codeam-pair >/dev/null 2>&1 || true"], {
       detached: true,
       stdio: "ignore"
     });
@@ -18658,11 +18783,21 @@ async function waitForDevServerReady(devServer, readyRe, opts = {
   };
   devServer.stdout?.on("data", consume);
   devServer.stderr?.on("data", consume);
+  let probeInFlight = false;
   const deadline = Date.now() + opts.timeoutMs;
   while (!readyMatched && Date.now() < deadline) {
     if (devServer.exitCode !== null) {
       return { kind: "exited", code: devServer.exitCode };
     }
+    if (opts.portProbe && !probeInFlight) {
+      probeInFlight = true;
+      void opts.portProbe().then((up) => {
+        if (up) readyMatched = true;
+      }).catch(() => {
+      }).finally(() => {
+        probeInFlight = false;
+      });
+    }
     await new Promise((r) => setTimeout(r, 250));
   }
   if (readyMatched) return { kind: "ready" };
@@ -18682,6 +18817,8 @@ function normalizeDetectionForSpawn(detection, cwd) {
     args: args2.slice(1)
   };
 }
+var INSTALL_TIMEOUT_MS = 5 * 6e4;
+var SETUP_TIMEOUT_MS = 2 * 6e4;
 var previewStartH = (ctx, _cmd, parsed) => {
   if (!ctx.pluginAuthToken) {
     log.info("preview", "no pluginAuthToken \u2014 skipping start");
@@ -18719,13 +18856,27 @@ var previewStartH = (ctx, _cmd, parsed) => {
         "SETUP_RUN",
         `${missingDeps.cmd} ${missingDeps.args.join(" ")} (pre-flight \u2014 node_modules missing)`
       );
-      const exitCode = await runOnce(
+      const result = await runSetupCommand(
         missingDeps.cmd,
         missingDeps.args,
         process.cwd(),
-        detection.env
+        detection.env,
+        { timeoutMs: INSTALL_TIMEOUT_MS }
       );
-      if (exitCode !== 0) {
+      if (result.status === "timeout") {
+        void postPreviewEvent({
+          sessionId: ctx.sessionId,
+          pluginId: ctx.pluginId,
+          pluginAuthToken,
+          type: "preview_error",
+          payload: {
+            stage: "ready_timeout",
+            message: `Dependency install (${missingDeps.cmd} ${missingDeps.args.join(" ")}) didn't finish within ${Math.round(INSTALL_TIMEOUT_MS / 1e3)}s and was stopped. Run it manually in this project, then try the preview again.`
+          }
+        });
+        return;
+      }
+      if (result.status === "failed") {
         void postPreviewEvent({
           sessionId: ctx.sessionId,
           pluginId: ctx.pluginId,
@@ -18733,7 +18884,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
           type: "preview_error",
           payload: {
             stage: "spawn",
-            message: `Dependency install failed (${missingDeps.cmd} ${missingDeps.args.join(" ")}, exit ${exitCode}). Run it manually in this project and try again.`
+            message: `Dependency install failed (${missingDeps.cmd} ${missingDeps.args.join(" ")}, exit ${result.code}). Run it manually in this project and try again.`
           }
         });
         return;
@@ -18745,8 +18896,28 @@ var previewStartH = (ctx, _cmd, parsed) => {
     ) : detection.setup_commands ?? [];
     for (const setup of agentSetupCommands) {
       emitProgress("SETUP_RUN", `${setup.cmd} ${setup.args.join(" ")}`);
-      const exitCode = await runOnce(setup.cmd, setup.args, process.cwd(), detection.env);
-      if (exitCode !== 0) {
+      const timeoutMs = isJsInstallCommand(setup.cmd, setup.args) ? INSTALL_TIMEOUT_MS : SETUP_TIMEOUT_MS;
+      const result = await runSetupCommand(
+        setup.cmd,
+        setup.args,
+        process.cwd(),
+        detection.env,
+        { timeoutMs }
+      );
+      if (result.status === "timeout") {
+        void postPreviewEvent({
+          sessionId: ctx.sessionId,
+          pluginId: ctx.pluginId,
+          pluginAuthToken,
+          type: "preview_error",
+          payload: {
+            stage: "ready_timeout",
+            message: `Setup step (${setup.cmd} ${setup.args.join(" ")}) didn't finish within ${Math.round(timeoutMs / 1e3)}s and was stopped.`
+          }
+        });
+        return;
+      }
+      if (result.status === "failed") {
         void postPreviewEvent({
           sessionId: ctx.sessionId,
           pluginId: ctx.pluginId,
@@ -18754,7 +18925,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
           type: "preview_error",
           payload: {
             stage: "spawn",
-            message: `Setup failed (${setup.cmd} ${setup.args.join(" ")}, exit ${exitCode}).`
+            message: `Setup failed (${setup.cmd} ${setup.args.join(" ")}, exit ${result.code}).`
           }
         });
         return;
@@ -18765,7 +18936,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
       "BOOT_SEQUENCE",
       `${spawnable.command} ${spawnable.args.join(" ")}`
     );
-    const devServer = (0, import_child_process16.spawn)(spawnable.command, spawnable.args, {
+    const devServer = (0, import_child_process17.spawn)(spawnable.command, spawnable.args, {
       cwd: process.cwd(),
       env: { ...process.env, ...spawnable.env ?? {} },
       stdio: ["ignore", "pipe", "pipe"]
@@ -18774,13 +18945,15 @@ var previewStartH = (ctx, _cmd, parsed) => {
     emitProgress("WAITING_FOR_READY", detection.ready_pattern);
     let expoUrl = null;
     const readyRe = compileReadyPattern(detection.ready_pattern);
+    const isNextJs = /next/i.test(detection.framework);
     const outcome = await waitForDevServerReady(devServer, readyRe, {
       timeoutMs: 12e4,
       onChunk: (s) => {
         if (!expoUrl && detection.framework === "Expo") {
           expoUrl = parseExpoUrl(s);
         }
-      }
+      },
+      portProbe: isNextJs ? () => waitForPortListening(detection.port, { timeoutMs: 1e3, intervalMs: 250 }) : void 0
     });
     if (outcome.kind === "exited") {
       void postPreviewEvent({
@@ -18891,7 +19064,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
         });
         return;
       }
-      tunnel = (0, import_child_process16.spawn)(bin, ["tunnel", "--url", `http://localhost:${detection.port}`], {
+      tunnel = (0, import_child_process17.spawn)(bin, ["tunnel", "--url", `http://localhost:${detection.port}`], {
         stdio: ["ignore", "pipe", "pipe"]
       });
       let parsedUrl = null;
@@ -18987,25 +19160,6 @@ var previewStopH = (ctx) => {
     });
   })();
 };
-function runOnce(cmd, args2, cwd, env) {
-  return new Promise((resolve7) => {
-    const child = (0, import_child_process16.spawn)(cmd, args2, {
-      cwd,
-      env: { ...process.env, ...env ?? {} },
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    const tag = `setup:${cmd}`;
-    const onChunk = (chunk) => {
-      const text = chunk.toString().replace(/\n+$/g, "");
-      if (text.length === 0) return;
-      log.info("preview", `${tag}: ${text}`);
-    };
-    child.stdout?.on("data", onChunk);
-    child.stderr?.on("data", onChunk);
-    child.once("exit", (code) => resolve7(code));
-    child.once("error", () => resolve7(-1));
-  });
-}
 var savePreviewConfigH = (_ctx, _cmd, parsed) => {
   const detection = parsed.detection;
   if (!detection) {
@@ -19085,9 +19239,9 @@ async function dispatchCommand(ctx, cmd) {
 }
 
 // src/services/file-watcher.service.ts
-var import_child_process17 = require("child_process");
+var import_child_process18 = require("child_process");
 var fs33 = __toESM(require("fs"));
-var os26 = __toESM(require("os"));
+var os27 = __toESM(require("os"));
 var path40 = __toESM(require("path"));
 var import_ignore = __toESM(require("ignore"));
 
@@ -19198,10 +19352,10 @@ var WINDOWS_LEGACY_JUNCTIONS = [
   /[\\/]Start Menu([\\/]|$)/i,
   /[\\/]Templates([\\/]|$)/i
 ];
-function isUnsafeWindowsWatchRoot(dir, homedir22) {
+function isUnsafeWindowsWatchRoot(dir, homedir23) {
   const norm = (p2) => p2.replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
   const cwd = norm(dir);
-  const home = norm(homedir22);
+  const home = norm(homedir23);
   if (cwd === home) return true;
   if (/^[a-z]:$/.test(cwd)) return true;
   const sysRoots = [
@@ -19300,7 +19454,7 @@ var FileWatcherService = class {
       throw new Error("FileWatcherService has already been stopped \u2014 re-instantiate to restart.");
     }
     const isWin = process.platform === "win32";
-    if (isWin && isUnsafeWindowsWatchRoot(this.opts.workingDir, os26.homedir())) {
+    if (isWin && isUnsafeWindowsWatchRoot(this.opts.workingDir, os27.homedir())) {
       log.warn(
         "fileWatcher",
         `refusing to watch ${this.opts.workingDir} \u2014 looks like a Windows user-profile or system path. Run codeam from your project folder to enable file change emission.`
@@ -19851,7 +20005,7 @@ async function _runGitImpl(cwd, args2, opts = {}) {
   return new Promise((resolve7) => {
     let proc;
     try {
-      proc = (0, import_child_process17.spawn)("git", args2, { cwd, env: process.env });
+      proc = (0, import_child_process18.spawn)("git", args2, { cwd, env: process.env });
     } catch {
       resolve7(null);
       return;
@@ -19883,7 +20037,7 @@ function _runGit(cwd, args2, opts = {}) {
 var import_crypto4 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
-var import_child_process18 = require("child_process");
+var import_child_process19 = require("child_process");
 var path41 = __toESM(require("path"));
 async function collectRepoChangeset(opts) {
   const status2 = await runGit3(opts.repoRoot, ["status", "--porcelain=v1", "-z"]);
@@ -19967,7 +20121,7 @@ function defaultRunGit(cwd, args2) {
   return new Promise((resolve7) => {
     let proc;
     try {
-      proc = (0, import_child_process18.spawn)("git", args2, { cwd, env: process.env });
+      proc = (0, import_child_process19.spawn)("git", args2, { cwd, env: process.env });
     } catch {
       resolve7(null);
       return;
@@ -21946,7 +22100,7 @@ var OutputService = class _OutputService {
 // src/services/history.service.ts
 var fs35 = __toESM(require("fs"));
 var path43 = __toESM(require("path"));
-var os27 = __toESM(require("os"));
+var os28 = __toESM(require("os"));
 var https7 = __toESM(require("https"));
 var http7 = __toESM(require("http"));
 var import_zod2 = require("zod");
@@ -22108,7 +22262,7 @@ var HistoryService = class _HistoryService {
     return this._quotaPercent === null || Date.now() - this._quotaFetchedAt > ttlMs;
   }
   get projectDir() {
-    return this.runtime.resolveHistoryDir(this.cwd) ?? path43.join(os27.homedir(), ".claude", "projects", encodeCwd(this.cwd));
+    return this.runtime.resolveHistoryDir(this.cwd) ?? path43.join(os28.homedir(), ".claude", "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -22822,13 +22976,13 @@ function fetchQuotaUsage(runtime, historySvc) {
 }
 
 // src/commands/start/keep-alive.ts
-var import_child_process19 = require("child_process");
+var import_child_process20 = require("child_process");
 function buildKeepAlive(ctx) {
   let timer = null;
   async function setIdleTimeout(minutes) {
     if (!ctx.inCodespace || !ctx.codespaceName) return;
     await new Promise((resolve7) => {
-      const proc = (0, import_child_process19.spawn)(
+      const proc = (0, import_child_process20.spawn)(
         "gh",
         [
           "api",
@@ -23314,7 +23468,7 @@ async function autoLinkAfterPair(opts) {
 
 // src/commands/pair-auto.ts
 var fs36 = __toESM(require("fs"));
-var os28 = __toESM(require("os"));
+var os29 = __toESM(require("os"));
 var import_crypto7 = require("crypto");
 
 // src/commands/start-infra-only.ts
@@ -23540,7 +23694,7 @@ async function claimOnce(token, pluginId) {
     pluginId,
     ideName: "codeam-cli (codespace)",
     ideVersion: process.env.npm_package_version ?? "unknown",
-    hostname: os28.hostname(),
+    hostname: os29.hostname(),
     codespaceName: process.env.CODESPACE_NAME ?? "",
     // Current git branch of the codespace's working directory, so the
     // backend can populate `PairedSession.branch` for the codespace pair.
@@ -23777,11 +23931,11 @@ async function logout() {
 var import_picocolors10 = __toESM(require("picocolors"));
 
 // src/services/providers/github-codespaces.ts
-var import_child_process20 = require("child_process");
+var import_child_process21 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors8 = __toESM(require("picocolors"));
 var path44 = __toESM(require("path"));
-var execFileP5 = (0, import_util4.promisify)(import_child_process20.execFile);
+var execFileP5 = (0, import_util4.promisify)(import_child_process21.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
   if (process.stdin.isTTY) {
@@ -23825,7 +23979,7 @@ var GitHubCodespacesProvider = class {
     if (!isAuthed) {
       resetStdinForChild();
       await new Promise((resolve7, reject) => {
-        const proc = (0, import_child_process20.spawn)("gh", ["auth", "login", "-s", "codespace,repo,read:user"], {
+        const proc = (0, import_child_process21.spawn)("gh", ["auth", "login", "-s", "codespace,repo,read:user"], {
           stdio: "inherit"
         });
         proc.on("exit", (code) => {
@@ -23859,7 +24013,7 @@ var GitHubCodespacesProvider = class {
       wt(noteLines.join("\n"), "One more permission needed");
       resetStdinForChild();
       const refreshCode = await new Promise((resolve7, reject) => {
-        const proc = (0, import_child_process20.spawn)(
+        const proc = (0, import_child_process21.spawn)(
           "gh",
           ["auth", "refresh", "-h", "github.com", "-s", "codespace"],
           { stdio: "inherit" }
@@ -24009,7 +24163,7 @@ var GitHubCodespacesProvider = class {
     O2.step(`Installing gh via ${installCmd.describe}\u2026`);
     resetStdinForChild();
     const ok = await new Promise((resolve7) => {
-      const proc = (0, import_child_process20.spawn)(installCmd.exe, installCmd.args, { stdio: "inherit" });
+      const proc = (0, import_child_process21.spawn)(installCmd.exe, installCmd.args, { stdio: "inherit" });
       proc.on("exit", (code) => resolve7(code === 0));
       proc.on("error", () => resolve7(false));
     });
@@ -24036,7 +24190,7 @@ var GitHubCodespacesProvider = class {
     );
     resetStdinForChild();
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process20.spawn)(
+      const proc = (0, import_child_process21.spawn)(
         "gh",
         ["auth", "refresh", "-h", "github.com", "-s", "repo,read:org"],
         { stdio: "inherit" }
@@ -24214,7 +24368,7 @@ var GitHubCodespacesProvider = class {
   async streamCommand(workspaceId, command2) {
     resetStdinForChild();
     return new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process20.spawn)(
+      const proc = (0, import_child_process21.spawn)(
         "gh",
         ["codespace", "ssh", "-c", workspaceId, "--", "-tt", command2],
         { stdio: "inherit" }
@@ -24241,11 +24395,11 @@ var GitHubCodespacesProvider = class {
       `mkdir -p ${shellQuote(remoteDir)} && tar -xzf - -C ${shellQuote(remoteDir)}`
     ];
     await new Promise((resolve7, reject) => {
-      const tar = (0, import_child_process20.spawn)("tar", tarArgs, {
+      const tar = (0, import_child_process21.spawn)("tar", tarArgs, {
         stdio: ["ignore", "pipe", "pipe"],
         env: tarEnv
       });
-      const ssh = (0, import_child_process20.spawn)("gh", sshArgs, {
+      const ssh = (0, import_child_process21.spawn)("gh", sshArgs, {
         stdio: [tar.stdout, "pipe", "pipe"]
       });
       let tarErr = "";
@@ -24279,7 +24433,7 @@ var GitHubCodespacesProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process20.spawn)(
+      const proc = (0, import_child_process21.spawn)(
         "gh",
         ["codespace", "ssh", "-c", workspaceId, "--", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -24337,11 +24491,11 @@ function shellQuote(s) {
 }
 
 // src/services/providers/gitpod.ts
-var import_child_process21 = require("child_process");
+var import_child_process22 = require("child_process");
 var import_util5 = require("util");
 var path45 = __toESM(require("path"));
 var import_picocolors9 = __toESM(require("picocolors"));
-var execFileP6 = (0, import_util5.promisify)(import_child_process21.execFile);
+var execFileP6 = (0, import_util5.promisify)(import_child_process22.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
 function resetStdinForChild2() {
   if (process.stdin.isTTY) {
@@ -24381,7 +24535,7 @@ var GitpodProvider = class {
     );
     resetStdinForChild2();
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process21.spawn)("gitpod", ["login"], { stdio: "inherit" });
+      const proc = (0, import_child_process22.spawn)("gitpod", ["login"], { stdio: "inherit" });
       proc.on("exit", (code) => {
         if (code === 0) resolve7();
         else reject(new Error("gitpod login failed."));
@@ -24533,7 +24687,7 @@ var GitpodProvider = class {
   async streamCommand(workspaceId, command2) {
     resetStdinForChild2();
     return new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process21.spawn)(
+      const proc = (0, import_child_process22.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", "-tt", command2],
         { stdio: "inherit" }
@@ -24553,11 +24707,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((resolve7, reject) => {
-      const tar = (0, import_child_process21.spawn)("tar", tarArgs, {
+      const tar = (0, import_child_process22.spawn)("tar", tarArgs, {
         stdio: ["ignore", "pipe", "pipe"],
         env: tarEnv
       });
-      const ssh = (0, import_child_process21.spawn)(
+      const ssh = (0, import_child_process22.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -24589,7 +24743,7 @@ var GitpodProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process21.spawn)(
+      const proc = (0, import_child_process22.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -24613,10 +24767,10 @@ function shellQuote2(s) {
 }
 
 // src/services/providers/gitlab-workspaces.ts
-var import_child_process22 = require("child_process");
+var import_child_process23 = require("child_process");
 var import_util6 = require("util");
 var path46 = __toESM(require("path"));
-var execFileP7 = (0, import_util6.promisify)(import_child_process22.execFile);
+var execFileP7 = (0, import_util6.promisify)(import_child_process23.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
 function resetStdinForChild3() {
@@ -24658,7 +24812,7 @@ var GitLabWorkspacesProvider = class {
     );
     resetStdinForChild3();
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process22.spawn)(
+      const proc = (0, import_child_process23.spawn)(
         "glab",
         ["auth", "login", "--scopes", "api,read_user,read_repository"],
         { stdio: "inherit" }
@@ -24830,7 +24984,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((resolve7, reject) => {
-      const proc = (0, import_child_process22.spawn)(
+      const proc = (0, import_child_process23.spawn)(
         "ssh",
         ["-tt", "-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, command2],
         { stdio: "inherit" }
@@ -24851,8 +25005,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((resolve7, reject) => {
-      const tar = (0, import_child_process22.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
-      const ssh = (0, import_child_process22.spawn)(
+      const tar = (0, import_child_process23.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
+      const ssh = (0, import_child_process23.spawn)(
         "ssh",
         ["-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -24882,7 +25036,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process22.spawn)(
+      const proc = (0, import_child_process23.spawn)(
         "ssh",
         ["-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -24941,10 +25095,10 @@ function shellQuote3(s) {
 }
 
 // src/services/providers/railway.ts
-var import_child_process23 = require("child_process");
+var import_child_process24 = require("child_process");
 var import_util7 = require("util");
 var path47 = __toESM(require("path"));
-var execFileP8 = (0, import_util7.promisify)(import_child_process23.execFile);
+var execFileP8 = (0, import_util7.promisify)(import_child_process24.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
   if (process.stdin.isTTY) {
@@ -24985,7 +25139,7 @@ var RailwayProvider = class {
     );
     resetStdinForChild4();
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process23.spawn)("railway", ["login"], { stdio: "inherit" });
+      const proc = (0, import_child_process24.spawn)("railway", ["login"], { stdio: "inherit" });
       proc.on("exit", (code) => {
         if (code === 0) resolve7();
         else reject(new Error("railway login failed."));
@@ -25128,7 +25282,7 @@ var RailwayProvider = class {
     }
     resetStdinForChild4();
     return new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process23.spawn)(
+      const proc = (0, import_child_process24.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", command2],
         { stdio: "inherit" }
@@ -25152,8 +25306,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((resolve7, reject) => {
-      const tar = (0, import_child_process23.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
-      const sh = (0, import_child_process23.spawn)(
+      const tar = (0, import_child_process24.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
+      const sh = (0, import_child_process24.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -25186,7 +25340,7 @@ var RailwayProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process23.spawn)(
+      const proc = (0, import_child_process24.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -25825,9 +25979,9 @@ function checkSessions() {
   }
 }
 function checkAgentBinaries() {
-  const os30 = createOsStrategy();
+  const os31 = createOsStrategy();
   return getEnabledAgents().map((meta) => {
-    const found = os30.findInPath(meta.binaryName);
+    const found = os31.findInPath(meta.binaryName);
     return {
       id: `agent-${meta.id}`,
       label: `Agent binary: ${meta.displayName} (${meta.binaryName})`,
@@ -25891,7 +26045,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.35.1" : "0.0.0-dev";
+  const cliVersion = true ? "2.35.3" : "0.0.0-dev";
   const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -26090,7 +26244,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.35.1" : "unknown";
+  const v = true ? "2.35.3" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -26219,7 +26373,7 @@ var _subcommandHelpKeys = Object.keys(HELPS);
 
 // src/lib/updateNotifier.ts
 var fs38 = __toESM(require("fs"));
-var os29 = __toESM(require("os"));
+var os30 = __toESM(require("os"));
 var path49 = __toESM(require("path"));
 var https8 = __toESM(require("https"));
 var import_node_child_process12 = require("child_process");
@@ -26229,7 +26383,7 @@ 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 = path49.join(os29.homedir(), ".codeam");
+  const dir = path49.join(os30.homedir(), ".codeam");
   return path49.join(dir, "update-check.json");
 }
 function readCache() {
@@ -26376,7 +26530,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current = true ? "2.35.1" : null;
+  const current = true ? "2.35.3" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.35.1",
+  "version": "2.35.3",
   "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",