codeam-cli 2.39.51 → 2.39.52

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.39.51] — 2026-06-20
+
+### Fixed
+
+- **cli:** Reuse running preview on re-open instead of re-spawn (EADDRINUSE)
+
 ## [2.39.50] — 2026-06-19
 
 ### Fixed

package/dist/index.js

@@ -5388,7 +5388,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.39.51" : "0.0.0-dev",
+    cliVersion: true ? "2.39.52" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5547,7 +5547,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.39.51",
+  version: "2.39.52",
   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",
@@ -17245,6 +17245,15 @@ function isDeployPayload(p2) {
   if (p2.cloneToken !== void 0 && typeof p2.cloneToken !== "string") {
     return false;
   }
+  if (p2.headroomEnabled !== void 0 && typeof p2.headroomEnabled !== "boolean") {
+    return false;
+  }
+  if (p2.headroomAgent !== void 0 && typeof p2.headroomAgent !== "string") {
+    return false;
+  }
+  if (p2.headroomSavingsIngestUrl !== void 0 && typeof p2.headroomSavingsIngestUrl !== "string") {
+    return false;
+  }
   const hasHouse = isHouseProxy(p2.houseProxy);
   const hasSealed = typeof p2.sealedAgentAuth === "string";
   return hasHouse || hasSealed;
@@ -17260,6 +17269,95 @@ var CONTROL_AGENT_META = {
   supportedAuthKinds: ["oauth_token"],
   preferredAuthKind: "oauth_token"
 };
+async function setupHeadroomForSelfHosted(agent) {
+  const INSTALL_TIMEOUT_MS2 = 12e4;
+  const PIP_PACKAGES = [
+    "headroom-ai",
+    "fastapi",
+    "uvicorn",
+    "httpx[http2]",
+    "websockets",
+    "zstandard"
+  ];
+  const installOk = await new Promise((resolve7) => {
+    const tryPip = (cmd) => new Promise((res) => {
+      const child = (0, import_node_child_process12.spawn)(cmd, ["install", "--quiet", ...PIP_PACKAGES], {
+        stdio: ["ignore", "pipe", "pipe"]
+      });
+      let settled = false;
+      const done = (ok) => {
+        if (settled) return;
+        settled = true;
+        res(ok);
+      };
+      const onData = (b) => {
+        const line = b.toString().replace(/\n+$/g, "");
+        if (line) log.info("host-agent", `headroom-install: ${line}`);
+      };
+      child.stdout?.on("data", onData);
+      child.stderr?.on("data", onData);
+      const timer = setTimeout(() => {
+        log.warn("host-agent", `headroom pip install timed out (${INSTALL_TIMEOUT_MS2 / 1e3}s) \u2014 skipping Headroom`);
+        try {
+          child.kill("SIGTERM");
+        } catch {
+        }
+        done(false);
+      }, INSTALL_TIMEOUT_MS2);
+      child.once("exit", (code) => {
+        clearTimeout(timer);
+        if (code === 0) {
+          log.info("host-agent", "headroom pip install succeeded");
+        } else {
+          log.warn("host-agent", `headroom pip install exited code=${String(code)} \u2014 skipping Headroom`);
+        }
+        done(code === 0);
+      });
+      child.once("error", (e) => {
+        clearTimeout(timer);
+        done(false);
+        log.trace("host-agent", `headroom pip spawn error (${cmd}): ${e.message}`);
+      });
+    });
+    tryPip("pip").then((ok) => ok ? resolve7(true) : tryPip("pip3").then(resolve7)).catch(() => resolve7(false));
+  });
+  if (!installOk) {
+    return false;
+  }
+  const initOk = await new Promise((resolve7) => {
+    (0, import_node_child_process12.execFile)("which", ["headroom"], (whichErr) => {
+      if (whichErr) {
+        log.warn("host-agent", "headroom not found on PATH after install \u2014 skipping init");
+        resolve7(false);
+        return;
+      }
+      (0, import_node_child_process12.execFile)("headroom", ["init", "--global", agent], (initErr, stdout, stderr) => {
+        if (initErr) {
+          const detail = (stderr || initErr.message).replace(/\n+$/g, "");
+          log.warn("host-agent", `headroom init failed (best-effort): ${detail}`);
+          resolve7(false);
+        } else {
+          if (stdout.trim()) log.info("host-agent", `headroom init: ${stdout.trim()}`);
+          log.info("host-agent", "headroom init --global succeeded");
+          resolve7(true);
+        }
+      });
+    });
+  });
+  if (!initOk) {
+    return false;
+  }
+  try {
+    const proxy = (0, import_node_child_process12.spawn)("headroom", ["proxy", "--port", "8787"], {
+      stdio: "ignore",
+      detached: true
+    });
+    proxy.unref();
+  } catch (e) {
+    log.warn("host-agent", `headroom proxy warm-start failed (best-effort): ${e instanceof Error ? e.message : String(e)}`);
+  }
+  return true;
+}
 var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process12.spawn)(process.execPath, [process.argv[1], "pair-auto", ...args2], {
   cwd,
   env: { ...process.env, ...env },
@@ -17283,6 +17381,7 @@ var HostAgentSupervisor = class {
     this.deps = deps;
     this.spawnChild = deps.spawnChild ?? defaultSpawner;
     this.resolveAgentAuth = deps.resolveAgentAuth ?? unsealAgentAuth;
+    this.setupHeadroom = deps.setupHeadroom ?? setupHeadroomForSelfHosted;
     this.metrics = deps.metricsCollector ?? new MetricsCollector();
     this.onIdentityRejected = deps.onIdentityRejected ?? defaultOnIdentityRejected;
     this.disableService = deps.disableService ?? defaultDisableService;
@@ -17292,6 +17391,7 @@ var HostAgentSupervisor = class {
   children = /* @__PURE__ */ new Map();
   spawnChild;
   resolveAgentAuth;
+  setupHeadroom;
   relay = null;
   heartbeatTimer = null;
   /** Guards the one-shot 'connected' telemetry on the first heartbeat. */
@@ -17464,6 +17564,18 @@ var HostAgentSupervisor = class {
         childEnv.PREVIEW_TUNNEL_TOKEN = payload.previewTunnelToken;
         childEnv.PREVIEW_TUNNEL_HOSTNAME = payload.previewHostname;
       }
+      if (payload.headroomEnabled && payload.headroomAgent && payload.headroomSavingsIngestUrl) {
+        report("headroom", "setting up Headroom proxy");
+        const headroomOk = await this.setupHeadroom(payload.headroomAgent);
+        if (headroomOk) {
+          childEnv.HEADROOM_ENABLED = "1";
+          childEnv.HEADROOM_AGENT = payload.headroomAgent;
+          childEnv.HEADROOM_SAVINGS_INGEST_URL = payload.headroomSavingsIngestUrl;
+          log.info("host-agent", "Headroom proxy ready; HEADROOM_* env injected into child");
+        } else {
+          log.warn("host-agent", "Headroom setup failed (best-effort) \u2014 child will run without Headroom");
+        }
+      }
       report("spawning", "starting agent");
       const proc = this.spawnChild(childEnv, cwd, extraArgs);
       const child = { deployId: payload.deployId, proc };
@@ -27373,9 +27485,9 @@ async function probeCodeamPair(provider, workspace) {
 }
 async function stopWorkspaceFromLocal(target) {
   if (target.provider.id === "github-codespaces") {
-    const { execFile: execFile11 } = await import("child_process");
+    const { execFile: execFile12 } = await import("child_process");
     const { promisify: promisify11 } = await import("util");
-    const execFileP10 = promisify11(execFile11);
+    const execFileP10 = promisify11(execFile12);
     await execFileP10("gh", ["codespace", "stop", "-c", target.id], { maxBuffer: 8 * 1024 * 1024 });
     return;
   }
@@ -27599,7 +27711,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.39.51" : "0.0.0-dev";
+  const cliVersion = true ? "2.39.52" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -27798,7 +27910,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.39.51" : "unknown";
+  const v = true ? "2.39.52" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -28084,7 +28196,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.39.51" : null;
+  const current = true ? "2.39.52" : 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.39.51",
+  "version": "2.39.52",
   "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",