codeam-cli 2.39.68 → 2.39.71

package/CHANGELOG.md

@@ -4,6 +4,22 @@ 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.69] — 2026-06-21
+
+### Added
+
+- **cli:** Report Headroom prompt-cache savings, not just compression
+
+### Fixed
+
+- **cli:** Make the pairing code more legible (letter-spacing + bold + contrast)
+
+## [2.39.68] — 2026-06-20
+
+### Tests
+
+- **host-agent:** Don't leak a heartbeat timer in the self_hosted_stop test
+
 ## [2.39.66] — 2026-06-20
 
 ### Fixed

package/dist/index.js

@@ -1084,12 +1084,12 @@ var PromiseQueue = class {
     return promise;
   }
   async join() {
-    let promises = Object.values(this.promiseByIds);
-    let length = promises.length;
+    let promises2 = Object.values(this.promiseByIds);
+    let length = promises2.length;
     while (length > 0) {
-      await Promise.all(promises);
-      promises = Object.values(this.promiseByIds);
-      length = promises.length;
+      await Promise.all(promises2);
+      promises2 = Object.values(this.promiseByIds);
+      length = promises2.length;
     }
   }
   get length() {
@@ -1427,8 +1427,8 @@ function safeSetTimeout(fn, timeout) {
   return t2;
 }
 var isError = (x) => x instanceof Error;
-function allSettled(promises) {
-  return Promise.all(promises.map((p2) => (p2 ?? Promise.resolve()).then((value) => ({
+function allSettled(promises2) {
+  return Promise.all(promises2.map((p2) => (p2 ?? Promise.resolve()).then((value) => ({
     status: "fulfilled",
     value
   }), (reason) => ({
@@ -5388,7 +5388,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.39.68" : "0.0.0-dev",
+    cliVersion: true ? "2.39.71" : "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.68",
+  version: "2.39.71",
   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",
@@ -8281,10 +8281,12 @@ function boxRow(content, visibleLength) {
   return `  \u2502${content}${pad}\u2502`;
 }
 function showPairingCode(code) {
+  const spaced = code.split("").join(" ");
   console.log(BOX_BORDER_TOP);
-  const codeVisible = `  Code:  ${code}`.length;
+  const label = "  Code:   ";
+  const codeVisible = `${label}${spaced}`.length;
   console.log(
-    boxRow(`  Code:  ${import_picocolors.default.bold(import_picocolors.default.yellow(code))}`, codeVisible)
+    boxRow(`${label}${import_picocolors.default.bold(import_picocolors.default.yellow(spaced))}`, codeVisible)
   );
   console.log(BOX_BORDER_BOT);
   console.log("");
@@ -17181,7 +17183,14 @@ function provisionAgentCredentials(publicAgentId, auth, homeDir2 = os30.homedir(
 }
 
 // src/services/headroom/stats-reporter.ts
-var ZERO = { rawTokensEst: 0, sentTokensEst: 0, cachedTokens: 0, retrieveHops: 0 };
+var ZERO = {
+  rawTokensEst: 0,
+  sentTokensEst: 0,
+  cachedTokens: 0,
+  retrieveHops: 0,
+  cacheReadTokens: 0,
+  cacheSavingsUsd: 0
+};
 function read(stats) {
   const totals = stats.agent_usage?.totals;
   const compression = stats.summary?.compression;
@@ -17191,7 +17200,9 @@ function read(stats) {
     rawTokensEst,
     sentTokensEst,
     cachedTokens: 0,
-    retrieveHops: stats.summary?.mcp?.retrievals ?? 0
+    retrieveHops: stats.summary?.mcp?.retrievals ?? 0,
+    cacheReadTokens: stats.prefix_cache?.totals?.cache_read_tokens ?? 0,
+    cacheSavingsUsd: stats.summary?.cost?.breakdown?.cache_savings_usd ?? 0
   };
 }
 function mapStatsToSavings(stats, prev) {
@@ -17201,7 +17212,9 @@ function mapStatsToSavings(stats, prev) {
     rawTokensEst: d3(next.rawTokensEst, prev.rawTokensEst),
     sentTokensEst: d3(next.sentTokensEst, prev.sentTokensEst),
     cachedTokens: d3(next.cachedTokens, prev.cachedTokens),
-    retrieveHops: d3(next.retrieveHops, prev.retrieveHops)
+    retrieveHops: d3(next.retrieveHops, prev.retrieveHops),
+    cacheReadTokens: d3(next.cacheReadTokens, prev.cacheReadTokens),
+    cacheSavingsUsd: d3(next.cacheSavingsUsd, prev.cacheSavingsUsd)
   };
   return { next, delta };
 }
@@ -17220,7 +17233,9 @@ var HeadroomStatsReporter = class {
     try {
       const { next, delta } = mapStatsToSavings(await this.deps.fetchStats(), this.prev);
       this.prev = next;
-      if (delta.rawTokensEst > 0) await this.deps.postSavings(delta);
+      if (delta.rawTokensEst > 0 || delta.cacheReadTokens > 0 || delta.cacheSavingsUsd > 0) {
+        await this.deps.postSavings(delta);
+      }
     } catch {
     }
   }
@@ -17391,7 +17406,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.68" : null;
+  const current = true ? "2.39.71" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -17484,7 +17499,8 @@ var CONTROL_AGENT_META = {
 };
 var PEP668_MARKER = "externally-managed-environment";
 var PM_INSTALL_TIMEOUT_MS = 18e4;
-var PIP_INSTALL_TIMEOUT_MS = 12e4;
+var ENGINE_INSTALL_TIMEOUT_MS = 36e4;
+var HEADROOM_MIN_FREE_DISK_BYTES = 3 * 1024 * 1024 * 1024;
 var defaultHeadroomRunner = {
   which(cmd) {
     try {
@@ -17696,57 +17712,50 @@ function bundledClaudeBinDir() {
   }
   return null;
 }
+async function getFreeDiskBytes(dir) {
+  try {
+    const s = await fs39.promises.statfs(dir);
+    return s.bsize * s.bavail;
+  } catch {
+    return null;
+  }
+}
 async function setupHeadroomForSelfHosted(agent, runner = defaultHeadroomRunner) {
-  const PIP_PACKAGES = [
-    "headroom-ai",
-    "fastapi",
-    "uvicorn",
-    "httpx[http2]",
-    "websockets",
-    "zstandard"
-  ];
+  const SERVER_DEPS = ["fastapi", "uvicorn", "httpx[http2]", "websockets", "zstandard"];
   const pipAvailable = await ensurePip(runner);
   if (!pipAvailable) {
     return false;
   }
-  const installOk = await (async () => {
-    const baseArgs = ["-m", "pip", "install", "--quiet", ...PIP_PACKAGES];
-    const firstResult = await runner.run("python3", baseArgs, {
-      timeoutMs: PIP_INSTALL_TIMEOUT_MS
-    });
-    if (firstResult.code === 0) {
-      log.info("host-agent", "headroom pip install succeeded");
-      return true;
-    }
-    if (firstResult.stderr.includes(PEP668_MARKER)) {
-      log.info(
-        "host-agent",
-        "PEP 668 externally-managed-environment detected \u2014 retrying with --break-system-packages"
-      );
-      const retryResult = await runner.run(
-        "python3",
-        [...baseArgs, "--break-system-packages"],
-        { timeoutMs: PIP_INSTALL_TIMEOUT_MS }
-      );
-      if (retryResult.code === 0) {
-        log.info("host-agent", "headroom pip install succeeded (--break-system-packages)");
-        return true;
-      }
-      log.warn(
-        "host-agent",
-        `headroom pip install failed even with --break-system-packages (code=${String(retryResult.code)}) \u2014 skipping Headroom`
-      );
-      return false;
+  const pipInstall = async (pkgs, extraArgs, timeoutMs) => {
+    const base = ["-m", "pip", "install", "--quiet", ...extraArgs, ...pkgs];
+    const r = await runner.run("python3", 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 });
+      return r2.code === 0;
     }
-    log.warn(
-      "host-agent",
-      `headroom pip install exited code=${String(firstResult.code)} \u2014 skipping Headroom`
-    );
     return false;
-  })();
+  };
+  const torchOk = await pipInstall(
+    ["torch"],
+    ["--index-url", "https://download.pytorch.org/whl/cpu"],
+    ENGINE_INSTALL_TIMEOUT_MS
+  );
+  log.info(
+    "host-agent",
+    torchOk ? "CPU-only PyTorch installed \u2014 Kompress (ML) compressor available" : "CPU torch install failed \u2014 installing code-aware engine only (Kompress unavailable)"
+  );
+  const headroomPkg = torchOk ? "headroom-ai[code,ml]" : "headroom-ai[code]";
+  const installOk = await pipInstall(
+    [headroomPkg, ...SERVER_DEPS],
+    [],
+    ENGINE_INSTALL_TIMEOUT_MS
+  );
   if (!installOk) {
+    log.warn("host-agent", `headroom engine install failed (${headroomPkg}) \u2014 skipping Headroom`);
     return false;
   }
+  log.info("host-agent", `headroom + engines installed (${headroomPkg})`);
   if (!runner.which("headroom")) {
     log.warn("host-agent", "headroom not found on PATH after install \u2014 skipping init");
     return false;
@@ -17796,7 +17805,7 @@ var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process13.s
   detached: false
 });
 function currentCliVersion() {
-  return true ? "2.39.68" : null;
+  return true ? "2.39.71" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve7) => {
@@ -18199,17 +18208,32 @@ var HostAgentSupervisor = class {
       }
       if (payload.headroomEnabled && payload.headroomAgent && payload.headroomSavingsIngestUrl) {
         report("headroom", "setting up Headroom proxy");
-        const headroomOk = await this.setupHeadroom(payload.headroomAgent);
-        if (headroomOk) {
-          persistHeadroomConfig({
-            enabled: true,
-            agent: agentIdToHeadroomKind(payload.headroomAgent),
-            ingestUrl: payload.headroomSavingsIngestUrl
-          });
-          log.info("host-agent", "Headroom proxy ready; persisted headroom config for child spawns");
-        } else {
+        const freeBytes = await getFreeDiskBytes(os32.homedir());
+        if (freeBytes !== null && freeBytes < HEADROOM_MIN_FREE_DISK_BYTES) {
+          const freeGb = (freeBytes / 1e9).toFixed(1);
+          const needGb = Math.round(HEADROOM_MIN_FREE_DISK_BYTES / 1e9);
+          report(
+            "headroom",
+            `Token-saving optimizer skipped \u2014 needs ~${needGb} GB free, host has ${freeGb} GB. The agent runs normally without it.`
+          );
+          log.warn(
+            "host-agent",
+            `Headroom skipped: insufficient disk (free=${freeGb}GB < ${needGb}GB)`
+          );
           persistHeadroomConfig({ enabled: false });
-          log.warn("host-agent", "Headroom setup failed (best-effort) \u2014 child will run without Headroom");
+        } else {
+          const headroomOk = await this.setupHeadroom(payload.headroomAgent);
+          if (headroomOk) {
+            persistHeadroomConfig({
+              enabled: true,
+              agent: agentIdToHeadroomKind(payload.headroomAgent),
+              ingestUrl: payload.headroomSavingsIngestUrl
+            });
+            log.info("host-agent", "Headroom proxy ready; persisted headroom config for child spawns");
+          } else {
+            persistHeadroomConfig({ enabled: false });
+            log.warn("host-agent", "Headroom setup failed (best-effort) \u2014 child will run without Headroom");
+          }
         }
       } else if (payload.headroomEnabled === false) {
         persistHeadroomConfig({ enabled: false });
@@ -28435,7 +28459,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.39.68" : "0.0.0-dev";
+  const cliVersion = true ? "2.39.71" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -28634,7 +28658,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors14 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.39.68" : "unknown";
+  const v = true ? "2.39.71" : "unknown";
   console.log(`${import_picocolors14.default.bold("codeam-cli")} ${import_picocolors14.default.cyan(v)}`);
 }
 

package/package.json

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