codeam-cli 2.35.2 → 2.35.3

package/CHANGELOG.md

@@ -4,6 +4,17 @@ 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

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.2",
+  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.2" : "0.0.0-dev",
+    cliVersion: true ? "2.35.3" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -7246,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
@@ -9992,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
@@ -11023,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" });
@@ -11047,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");
@@ -11154,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) => {
@@ -11176,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 {
   }
 }
@@ -11269,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"
     );
@@ -11286,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
@@ -11314,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" });
@@ -11363,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"];
@@ -11479,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"
       );
@@ -11544,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");
@@ -11665,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"
       );
@@ -11678,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"
       });
     }
@@ -11750,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");
@@ -11880,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" });
@@ -11914,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");
@@ -12015,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'.`
@@ -12036,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.`
@@ -15739,7 +15739,7 @@ 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_process17 = require("child_process");
@@ -17493,6 +17493,7 @@ function defaultBeadsHomeDir() {
 // src/beads/provisioner.ts
 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
@@ -17576,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 {
@@ -17604,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) => {
@@ -17622,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);
@@ -18179,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;
@@ -19215,7 +19241,7 @@ async function dispatchCommand(ctx, cmd) {
 // src/services/file-watcher.service.ts
 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"));
 
@@ -19326,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 = [
@@ -19428,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.`
@@ -22074,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");
@@ -22236,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) {
@@ -23442,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
@@ -23668,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.
@@ -25953,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})`,
@@ -26019,7 +26045,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.35.2" : "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}`);
@@ -26218,7 +26244,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.35.2" : "unknown";
+  const v = true ? "2.35.3" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -26347,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");
@@ -26357,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() {
@@ -26504,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.2" : 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.2",
+  "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",