codeam-cli 2.65.16 → 2.66.0

package/CHANGELOG.md

@@ -4,6 +4,18 @@ All notable changes to `codeam-cli` are documented here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.65.17] — 2026-08-21
+
+### Fixed
+
+- **cli:** Install Headroom without root by resolving uv before sudo (#648)
+
+## [2.65.16] — 2026-08-20
+
+### Added
+
+- **cli:** House agent (CodeAgent Cloud) as an in-session switch target
+
 ## [2.65.15] — 2026-08-20
 
 ### Fixed

package/dist/index.js

@@ -8081,7 +8081,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.65.16" : "0.0.0-dev",
+    cliVersion: true ? "2.66.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8323,7 +8323,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.65.16",
+  version: "2.66.0",
   description: "Workflow-continuity bridge for AI coding agents. Wrap Claude Code or Codex in a PTY and supervise, approve, and redirect the session from any device \u2014 async. The terminal companion for CodeAgent Mobile.",
   type: "commonjs",
   main: "dist/index.js",
@@ -9845,7 +9845,7 @@ var CommandRelayService = class _CommandRelayService {
       // fresh + clear the "CLI update available" banner after a self-update
       // (a codespace that reinstalls @latest reconnects via heartbeat, not
       // pair/reconnect). Older backends ignore the extra field.
-      ..."2.65.16" ? { ideVersion: "2.65.16" } : {}
+      ..."2.66.0" ? { ideVersion: "2.66.0" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -16995,19 +16995,31 @@ 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) {
+async function ensurePythonInstaller(runner) {
   if (runner.which("pip") || runner.which("pip3")) {
-    return true;
+    return { ok: true, installer: { kind: "pip" } };
+  }
+  if (runner.which("uv")) {
+    log.info("host-agent", "pip absent but uv is available \u2014 installing without root");
+    return { ok: true, installer: { kind: "uv", bin: "uv" } };
   }
   const pm = detectPackageManager(runner);
   if (!pm) {
-    log.warn(
-      "host-agent",
-      "pip is absent and no known package manager (apt-get/apk/dnf/yum/pacman/zypper) found \u2014 skipping Headroom"
-    );
-    return false;
+    return {
+      ok: false,
+      reason: "Python pip is not installed and no supported package manager (apt-get/apk/dnf/yum/pacman/zypper) was found. Install pip \u2014 or uv \u2014 on this machine, then retry."
+    };
   }
   const escalate = escalateCommand;
+  if (process.getuid?.() !== 0) {
+    const probe = await runner.run("sudo", ["-n", "true"], { timeoutMs: 1e4 });
+    if (probe.code !== 0) {
+      return {
+        ok: false,
+        reason: "Python pip is not installed here and this session cannot install it: it runs as a non-root user and sudo requires a password (there is no terminal to type it into). Install python3-pip \u2014 or uv \u2014 on the machine, then retry."
+      };
+    }
+  }
   const recipe = PROVISION_RECIPES[pm];
   log.info(
     "host-agent",
@@ -17027,21 +17039,23 @@ async function ensurePip(runner) {
     const { cmd, args: args2 } = escalate(recipe.install);
     const installResult = await runner.run(cmd, args2, { timeoutMs: PM_INSTALL_TIMEOUT_MS });
     if (installResult.code !== 0) {
+      const detail = installResult.stderr.trim().split("\n").slice(-1)[0] ?? "";
       log.warn(
         "host-agent",
         `${pm} bare-box provision failed (code=${String(installResult.code)}) \u2014 skipping Headroom`
       );
-      return false;
+      return {
+        ok: false,
+        reason: `Installing python3-pip via ${pm} failed (exit ${String(installResult.code)})${detail ? `: ${detail}` : ""}.`
+      };
     }
   } catch (e) {
-    log.warn(
-      "host-agent",
-      `bare-box provision threw unexpectedly: ${e instanceof Error ? e.message : String(e)} \u2014 skipping Headroom`
-    );
-    return false;
+    const msg = e instanceof Error ? e.message : String(e);
+    log.warn("host-agent", `bare-box provision threw unexpectedly: ${msg} \u2014 skipping Headroom`);
+    return { ok: false, reason: `Installing python3-pip via ${pm} threw: ${msg}` };
   }
   log.info("host-agent", `bare box provisioned via ${pm} (python3+pip+ca-certificates+curl)`);
-  return true;
+  return { ok: true, installer: { kind: "pip" } };
 }
 async function resolveHeadroomPython(runner) {
   const PROBE_TIMEOUT_MS = 5e3;
@@ -21693,10 +21707,12 @@ async function setupHeadroomForSelfHosted(agent, runner = defaultHeadroomRunner,
   const onProgress = opts.onProgress ?? (() => {
   });
   const SERVER_DEPS = HEADROOM_PIP_COMPANIONS;
-  const pipAvailable = await ensurePip(runner);
-  if (!pipAvailable) {
+  const installerResult = await ensurePythonInstaller(runner);
+  if (!installerResult.ok) {
+    log.warn("host-agent", `Headroom: ${installerResult.reason}`);
     return false;
   }
+  const installer = installerResult.installer;
   const py = await ensureModernPython(runner);
   if (py === null) {
     log.warn(
@@ -21707,6 +21723,14 @@ async function setupHeadroomForSelfHosted(agent, runner = defaultHeadroomRunner,
   }
   log.info("host-agent", `Headroom will use interpreter: ${py}`);
   const pipInstall = async (pkgs, extraArgs, timeoutMs) => {
+    if (installer.kind === "uv") {
+      const r2 = await runner.run(
+        installer.bin,
+        ["pip", "install", "--quiet", "--python", py, "--break-system-packages", ...extraArgs, ...pkgs],
+        { timeoutMs }
+      );
+      return r2.code === 0;
+    }
     const base = ["-m", "pip", "install", "--quiet", ...extraArgs, ...pkgs];
     const r = await runner.run(py, base, { timeoutMs });
     if (r.code === 0) return true;
@@ -22046,7 +22070,7 @@ async function autoUpgradeBeforeCriticalCommand() {
   if (process.env.NODE_ENV === "test") return;
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
-  const current2 = true ? "2.65.16" : null;
+  const current2 = true ? "2.66.0" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22063,7 +22087,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current2 = true ? "2.65.16" : null;
+  const current2 = true ? "2.66.0" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22083,7 +22107,7 @@ var SELF_UPDATE_INTERVAL_MS = 60 * 60 * 1e3;
 var SELF_UPDATE_VIEW_TIMEOUT_MS = 3e4;
 var SELF_UPDATE_INSTALL_TIMEOUT_MS = 18e4;
 function currentCliVersion() {
-  return true ? "2.65.16" : null;
+  return true ? "2.66.0" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve10) => {
@@ -22361,6 +22385,11 @@ function fleetUserIdFromContainerName(containerName) {
 function isMissingContainerError(stderr) {
   return /no such container/i.test(stderr);
 }
+function isFleetPruneHostPayload(v) {
+  if (typeof v !== "object" || v === null) return false;
+  const p2 = v;
+  return typeof p2.images === "boolean" && typeof p2.buildCache === "boolean";
+}
 function isMissingVolumeError(stderr) {
   return /no such volume/i.test(stderr);
 }
@@ -22776,6 +22805,14 @@ var HostAgentSupervisor = class {
       await this.fleetDeleteBox(cmd.payload);
       return;
     }
+    if (cmd.type === "fleet_prune_host") {
+      if (!isFleetPruneHostPayload(cmd.payload)) {
+        log.warn("host-agent", `ignoring malformed fleet_prune_host id=${cmd.id}`);
+        return;
+      }
+      await this.fleetPruneHost(cmd.payload);
+      return;
+    }
     if (cmd.type === "self_hosted_deploy") {
       if (!isDeployPayload(cmd.payload)) {
         log.warn("host-agent", `ignoring malformed self_hosted_deploy id=${cmd.id}`);
@@ -22987,6 +23024,39 @@ var HostAgentSupervisor = class {
   /** `fleet_stop_box` — sleep an idle box (`docker stop`). MUST be
    *  idempotent — the backend's reap sweeps may re-send a stop for a box
    *  the host already stopped/removed; "No such container" is success. */
+  /**
+   * `fleet_prune_host` — reclaim Docker residue. Best-effort and idempotent: a
+   * prune with nothing to collect exits 0 with "Total reclaimed space: 0B".
+   *
+   * ⚠️ Only ever `image prune` (dangling) and `builder prune`. NEVER
+   * `container prune` (a stopped fleet container is a SLEEPING BOX) and NEVER
+   * `volume prune` (a box's volume is the user's workspace and outlives its
+   * container by design). See `FleetPruneHostPayload`.
+   */
+  async fleetPruneHost(payload) {
+    log.info(
+      "host-agent",
+      `fleet_prune_host images=${payload.images} buildCache=${payload.buildCache}`
+    );
+    const steps = [];
+    if (payload.images) steps.push({ label: "image", args: ["image", "prune", "-f"] });
+    if (payload.buildCache) steps.push({ label: "builder", args: ["builder", "prune", "-f"] });
+    for (const step of steps) {
+      const res = await this.docker.run(step.args);
+      if (res.code !== 0) {
+        log.warn(
+          "host-agent",
+          `fleet_prune_host ${step.label} failed (code=${res.code}): ${res.stderr.trim().slice(-300)}`
+        );
+        continue;
+      }
+      const reclaimed = /Total reclaimed space:\s*(.+)/i.exec(res.stdout || "");
+      log.info(
+        "host-agent",
+        `fleet_prune_host ${step.label} ok${reclaimed ? ` reclaimed=${reclaimed[1].trim()}` : ""}`
+      );
+    }
+  }
   async fleetStopBox(payload) {
     log.info("host-agent", `fleet_stop_box id=${payload.boxId} name=${payload.containerName}`);
     const res = await this.docker.run(["stop", payload.containerName]);
@@ -45564,7 +45634,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.65.16" : "0.0.0-dev";
+  const cliVersion = true ? "2.66.0" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -45955,7 +46025,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.65.16" : "unknown";
+  const v = true ? "2.66.0" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeam-cli",
-  "version": "2.65.16",
+  "version": "2.66.0",
   "description": "Workflow-continuity bridge for AI coding agents. Wrap Claude Code or Codex in a PTY and supervise, approve, and redirect the session from any device — async. The terminal companion for CodeAgent Mobile.",
   "type": "commonjs",
   "main": "dist/index.js",