codeam-cli 2.49.2 → 2.49.4

package/CHANGELOG.md

@@ -4,6 +4,21 @@ 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.49.3] — 2026-06-27
+
+### Fixed
+
+- **cli:** Resolve a Python ≥3.10 for Headroom install (avoid macOS Xcode py3.9)
+- **cli:** Auto-install Python ≥3.10 for Headroom when none present
+- **cli:** Capture stdout in headroom runner so the python ≥3.10 probe works
+- **cli:** Require pip in the headroom python probe (skip pip-less newest python)
+
+## [2.49.2] — 2026-06-27
+
+### Fixed
+
+- **cli:** Set agentId in ACP HandlerContext so headroom enable works for claude/codex
+
 ## [2.49.1] — 2026-06-27
 
 ### Fixed

package/dist/index.js

@@ -5397,7 +5397,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.49.2" : "0.0.0-dev",
+    cliVersion: true ? "2.49.4" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5578,7 +5578,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.49.2",
+  version: "2.49.4",
   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",
@@ -14747,7 +14747,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 current = true ? "2.49.2" : null;
+  const current = true ? "2.49.4" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -14764,7 +14764,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.49.2" : null;
+  const current = true ? "2.49.4" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -14884,14 +14884,17 @@ var defaultHeadroomRunner = {
       const spawnEnv = opts.env ?? process.env;
       const child = (0, import_node_child_process14.spawn)(cmd, args2, { stdio: ["ignore", "pipe", "pipe"], env: spawnEnv });
       let stderrBuf = "";
+      let stdoutBuf = "";
       let settled = false;
       const done = (code) => {
         if (settled) return;
         settled = true;
-        resolve7({ code, stderr: stderrBuf });
+        resolve7({ code, stderr: stderrBuf, stdout: stdoutBuf });
       };
       child.stdout?.on("data", (b) => {
-        const line = b.toString().replace(/\n+$/, "");
+        const chunk = b.toString();
+        stdoutBuf += chunk;
+        const line = chunk.replace(/\n+$/, "");
         if (line) log.info("host-agent", `headroom[${cmd}]: ${line}`);
       });
       child.stderr?.on("data", (b) => {
@@ -14979,6 +14982,10 @@ function detectPackageManager(runner) {
   }
   return null;
 }
+function escalateCommand(argv) {
+  const isRoot = process.getuid?.() === 0;
+  return isRoot ? { cmd: argv[0], args: argv.slice(1) } : { cmd: "sudo", args: argv };
+}
 async function ensurePip(runner) {
   if (runner.which("pip") || runner.which("pip3")) {
     return true;
@@ -14991,8 +14998,7 @@ async function ensurePip(runner) {
     );
     return false;
   }
-  const isRoot = process.getuid?.() === 0;
-  const escalate = (argv) => isRoot ? { cmd: argv[0], args: argv.slice(1) } : { cmd: "sudo", args: argv };
+  const escalate = escalateCommand;
   const recipe = PROVISION_RECIPES[pm];
   log.info(
     "host-agent",
@@ -15157,6 +15163,132 @@ async function getFreeDiskBytes(dir) {
     return null;
   }
 }
+async function resolveHeadroomPython(runner) {
+  const PROBE_TIMEOUT_MS = 5e3;
+  const SUFFIXES = ["python3.13", "python3.12", "python3.11", "python3.10"];
+  const PREFIX_DIRS = ["/opt/homebrew/bin", "/usr/local/bin"];
+  const probe = async (candidate) => {
+    try {
+      const r = await runner.run(
+        candidate,
+        ["-c", 'import sys; print("%d.%d" % sys.version_info[:2])'],
+        { timeoutMs: PROBE_TIMEOUT_MS }
+      );
+      if (r.code !== 0) return false;
+      const parts = (r.stdout ?? "").trim().split(".");
+      const major = parseInt(parts[0] ?? "", 10);
+      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
+      });
+      return pipCheck.code === 0;
+    } catch {
+      return false;
+    }
+  };
+  for (const suffix of SUFFIXES) {
+    try {
+      if (await probe(suffix)) return suffix;
+    } catch {
+    }
+  }
+  for (const suffix of SUFFIXES) {
+    for (const dir of PREFIX_DIRS) {
+      const candidate = `${dir}/${suffix}`;
+      try {
+        if (await probe(candidate)) return candidate;
+      } catch {
+      }
+    }
+  }
+  try {
+    if (await probe("python3")) return "python3";
+  } catch {
+  }
+  return null;
+}
+var PY_INSTALL_TIMEOUT_MS = 6e5;
+var MODERN_PYTHON_RECIPES = {
+  "apt-get": [
+    ["apt-get", "install", "-y", "python3.12"],
+    ["apt-get", "install", "-y", "python3.11"],
+    ["apt-get", "install", "-y", "python3"]
+  ],
+  dnf: [
+    ["dnf", "install", "-y", "python3.12"],
+    ["dnf", "install", "-y", "python3"]
+  ],
+  yum: [
+    ["yum", "install", "-y", "python3.12"],
+    ["yum", "install", "-y", "python3"]
+  ],
+  apk: [["apk", "add", "--no-cache", "python3"]],
+  pacman: [["pacman", "-Sy", "--noconfirm", "python"]],
+  zypper: [
+    ["zypper", "--non-interactive", "install", "python311"],
+    ["zypper", "--non-interactive", "install", "python3"]
+  ]
+};
+async function ensureModernPython(runner) {
+  let py = await resolveHeadroomPython(runner);
+  if (py !== null) return py;
+  try {
+    if (process.platform === "darwin") {
+      if (runner.which("brew")) {
+        log.info("host-agent", "no Python \u22653.10 found \u2014 installing python@3.12 via Homebrew");
+        const r = await runner.run("brew", ["install", "python@3.12"], {
+          timeoutMs: PY_INSTALL_TIMEOUT_MS
+        });
+        if (r.code !== 0) {
+          log.warn(
+            "host-agent",
+            `brew install python@3.12 exited ${String(r.code)} \u2014 will re-probe anyway`
+          );
+        }
+      } else {
+        log.warn(
+          "host-agent",
+          "no Python \u22653.10 and Homebrew is absent \u2014 cannot auto-install Python on macOS"
+        );
+      }
+    } else if (process.platform === "linux") {
+      const pm = detectPackageManager(runner);
+      if (!pm) {
+        log.warn(
+          "host-agent",
+          "no Python \u22653.10 and no known package manager (apt-get/apk/dnf/yum/pacman/zypper) \u2014 cannot auto-install Python"
+        );
+      } else {
+        log.info("host-agent", `no Python \u22653.10 found \u2014 installing a modern Python via ${pm}`);
+        for (const argv of MODERN_PYTHON_RECIPES[pm]) {
+          const { cmd, args: args2 } = escalateCommand(argv);
+          const r = await runner.run(cmd, args2, { timeoutMs: PY_INSTALL_TIMEOUT_MS });
+          if (r.code === 0) {
+            log.info("host-agent", `installed Python package via ${pm}: ${argv.join(" ")}`);
+            break;
+          }
+          log.warn(
+            "host-agent",
+            `${pm} install '${argv.join(" ")}' exited ${String(r.code)} \u2014 trying next`
+          );
+        }
+      }
+    } else {
+      log.warn(
+        "host-agent",
+        `no Python \u22653.10 and platform '${process.platform}' has no auto-install path`
+      );
+    }
+  } catch (e) {
+    log.warn(
+      "host-agent",
+      `Python auto-install threw unexpectedly (best-effort): ${e instanceof Error ? e.message : String(e)}`
+    );
+  }
+  py = await resolveHeadroomPython(runner);
+  return py;
+}
 async function setupHeadroomForSelfHosted(agent, runner = defaultHeadroomRunner, opts = {}) {
   const extras = opts.extras ?? ["proxy", "code"];
   const onProgress = opts.onProgress ?? (() => {
@@ -15166,12 +15298,21 @@ async function setupHeadroomForSelfHosted(agent, runner = defaultHeadroomRunner,
   if (!pipAvailable) {
     return false;
   }
+  const py = await ensureModernPython(runner);
+  if (py === null) {
+    log.warn(
+      "host-agent",
+      "Headroom needs Python \u22653.10 and auto-install failed (no brew on macOS / package manager couldn\u2019t provide it) \u2014 skipping Headroom"
+    );
+    return false;
+  }
+  log.info("host-agent", `Headroom will use interpreter: ${py}`);
   const pipInstall = async (pkgs, extraArgs, timeoutMs) => {
     const base = ["-m", "pip", "install", "--quiet", ...extraArgs, ...pkgs];
-    const r = await runner.run("python3", base, { timeoutMs });
+    const r = await runner.run(py, base, { timeoutMs });
     if (r.code === 0) return true;
     if (r.stderr.includes(PEP668_MARKER)) {
-      const r2 = await runner.run("python3", [...base, "--break-system-packages"], { timeoutMs });
+      const r2 = await runner.run(py, [...base, "--break-system-packages"], { timeoutMs });
       return r2.code === 0;
     }
     return false;
@@ -15190,7 +15331,7 @@ async function setupHeadroomForSelfHosted(agent, runner = defaultHeadroomRunner,
     'snapshot_download("chopratejas/kompress-v2-base", allow_patterns=["*.json","onnx/*.onnx","kompress-int8-wo.onnx"])',
     'snapshot_download("answerdotai/ModernBERT-base", allow_patterns=["*.json","tokenizer*","*.txt","vocab*","merges*"])'
   ].join("\n");
-  const dl = await runner.run("python3", ["-c", predownloadPy], {
+  const dl = await runner.run(py, ["-c", predownloadPy], {
     timeoutMs: ENGINE_INSTALL_TIMEOUT_MS
   });
   log.info(
@@ -15259,7 +15400,7 @@ var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process14.s
   detached: false
 });
 function currentCliVersion() {
-  return true ? "2.49.2" : null;
+  return true ? "2.49.4" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve7) => {
@@ -18174,6 +18315,7 @@ var envWriteH = async (ctx, cmd, parsed) => {
   }
 };
 var _activeReporter = null;
+var _headroomEmitChain = Promise.resolve();
 var headroomConfigureH = async (ctx, cmd, parsed) => {
   const action = parsed.action;
   if (action !== "enable" && action !== "disable" && action !== "status") {
@@ -18266,14 +18408,17 @@ var headroomConfigureH = async (ctx, cmd, parsed) => {
       }
     },
     emit: (event) => {
-      if (!ctx.pluginAuthToken) return;
-      void postHeadroomEvent({
-        sessionId: ctx.sessionId,
-        pluginId: ctx.pluginId,
-        pluginAuthToken: ctx.pluginAuthToken,
-        type: event.type,
-        payload: "step" in event ? { step: event.step } : { state: event.state }
-      });
+      const token = ctx.pluginAuthToken;
+      if (!token) return;
+      _headroomEmitChain = _headroomEmitChain.then(
+        () => postHeadroomEvent({
+          sessionId: ctx.sessionId,
+          pluginId: ctx.pluginId,
+          pluginAuthToken: token,
+          type: event.type,
+          payload: "step" in event ? { step: event.step } : { state: event.state }
+        })
+      );
     }
   });
   await ctx.relay.sendResult(cmd.id, "completed", result);
@@ -30201,7 +30346,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.49.2" : "0.0.0-dev";
+  const cliVersion = true ? "2.49.4" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -30400,7 +30545,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.49.2" : "unknown";
+  const v = true ? "2.49.4" : "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.49.2",
+  "version": "2.49.4",
   "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",