codeam-cli 2.61.98 → 2.62.0

package/dist/index.js

@@ -2790,6 +2790,7 @@ function resolveApiBaseUrl() {
 }
 
 // ../../packages/shared/src/headroom/manifest.ts
+var HEADROOM_PROXY_PORT = 8787;
 var HEADROOM_PIP_COMPANIONS = [
   "fastapi",
   "uvicorn",
@@ -3270,7 +3271,7 @@ var { getConfig, ensurePluginId, addSession, removeSession, setActiveSession, ge
 
 // src/commands/pair-auto.ts
 var fs63 = __toESM(require("fs"));
-var os51 = __toESM(require("os"));
+var os52 = __toESM(require("os"));
 var path67 = __toESM(require("path"));
 var import_crypto4 = require("crypto");
 
@@ -3635,31 +3636,31 @@ var BucketedRateLimiter = class {
     this._refillRate = clampToRange(options.refillRate, 0, this._bucketSize, options._logger);
     this._refillInterval = clampToRange(options.refillInterval, 0, ONE_DAY_IN_MS, options._logger);
   }
-  _applyRefill(bucket, now) {
-    const elapsedMs = now - bucket.lastAccess;
+  _applyRefill(bucket2, now) {
+    const elapsedMs = now - bucket2.lastAccess;
     const refillIntervals = Math.floor(elapsedMs / this._refillInterval);
     if (refillIntervals > 0) {
       const tokensToAdd = refillIntervals * this._refillRate;
-      bucket.tokens = Math.min(bucket.tokens + tokensToAdd, this._bucketSize);
-      bucket.lastAccess = bucket.lastAccess + refillIntervals * this._refillInterval;
+      bucket2.tokens = Math.min(bucket2.tokens + tokensToAdd, this._bucketSize);
+      bucket2.lastAccess = bucket2.lastAccess + refillIntervals * this._refillInterval;
     }
   }
   consumeRateLimit(key) {
     const now = Date.now();
     const keyStr = String(key);
-    let bucket = this._buckets[keyStr];
-    if (bucket) this._applyRefill(bucket, now);
+    let bucket2 = this._buckets[keyStr];
+    if (bucket2) this._applyRefill(bucket2, now);
     else {
-      bucket = {
+      bucket2 = {
         tokens: this._bucketSize,
         lastAccess: now
       };
-      this._buckets[keyStr] = bucket;
+      this._buckets[keyStr] = bucket2;
     }
-    if (0 === bucket.tokens) return true;
-    bucket.tokens--;
-    if (0 === bucket.tokens) this._onBucketRateLimited?.(key);
-    return 0 === bucket.tokens;
+    if (0 === bucket2.tokens) return true;
+    bucket2.tokens--;
+    if (0 === bucket2.tokens) this._onBucketRateLimited?.(key);
+    return 0 === bucket2.tokens;
   }
   stop() {
     this._buckets = {};
@@ -8021,7 +8022,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.61.98" : "0.0.0-dev",
+    cliVersion: true ? "2.62.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8202,7 +8203,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.61.98",
+  version: "2.62.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",
@@ -8860,12 +8861,13 @@ function computePollDelay({ baseMs, failures }) {
 
 // src/services/headroom/proxy-supervisor.ts
 var fs7 = __toESM(require("fs"));
-var os6 = __toESM(require("os"));
+var os7 = __toESM(require("os"));
 var path6 = __toESM(require("path"));
 
 // src/services/headroom/proxy-process.ts
 var import_child_process2 = require("child_process");
 var fs6 = __toESM(require("fs"));
+var os6 = __toESM(require("os"));
 var path5 = __toESM(require("path"));
 
 // src/services/headroom/budget-args.ts
@@ -8946,6 +8948,27 @@ function pkillFallback() {
   } catch {
   }
 }
+function findRunningProxyPid() {
+  let entries;
+  try {
+    entries = fs5.readdirSync("/proc");
+  } catch {
+    return null;
+  }
+  for (const name of entries) {
+    if (!/^\d+$/.test(name)) continue;
+    const pid = Number(name);
+    if (pid === process.pid) continue;
+    if (pidLooksLikeProxy(pid)) return pid;
+  }
+  return null;
+}
+function adoptRunningProxy() {
+  const pid = findRunningProxyPid();
+  if (pid === null) return null;
+  writeHeadroomProxyPidfile(pid);
+  return pid;
+}
 function killHeadroomProxy() {
   const pid = readHeadroomProxyPidfile();
   if (pid !== null && isPidAlive(pid)) {
@@ -8965,6 +8988,14 @@ function killHeadroomProxy() {
     } catch {
     }
   }
+  const found = findRunningProxyPid();
+  if (found !== null) {
+    try {
+      process.kill(found, "SIGTERM");
+      return;
+    } catch {
+    }
+  }
   pkillFallback();
 }
 
@@ -8999,6 +9030,23 @@ function refreshSpawnLock() {
   } catch {
   }
 }
+function headroomProxyLogPath() {
+  return path5.join(os6.homedir(), ".codeam", "headroom-proxy.log");
+}
+var PROXY_LOG_MAX_BYTES = 2 * 1024 * 1024;
+function openProxyLogFd() {
+  try {
+    const p2 = headroomProxyLogPath();
+    fs6.mkdirSync(path5.dirname(p2), { recursive: true, mode: 448 });
+    try {
+      if (fs6.statSync(p2).size > PROXY_LOG_MAX_BYTES) fs6.truncateSync(p2, 0);
+    } catch {
+    }
+    return fs6.openSync(p2, "a", 384);
+  } catch {
+    return null;
+  }
+}
 function spawnHeadroomProxy(logging, opts = {}) {
   try {
     const nowMs = Date.now();
@@ -9012,15 +9060,22 @@ function spawnHeadroomProxy(logging, opts = {}) {
       ...process.env,
       HEADROOM_KOMPRESS_BACKEND: "onnx_cpu"
     };
+    const logFd = openProxyLogFd();
     const proxy = (0, import_child_process2.spawn)(
       "headroom",
       ["proxy", "--port", "8787", ...buildBudgetProxyArgs(proxyEnv)],
       {
-        stdio: "ignore",
+        stdio: logFd === null ? "ignore" : ["ignore", logFd, logFd],
         detached: true,
         env: proxyEnv
       }
     );
+    if (logFd !== null) {
+      try {
+        fs6.closeSync(logFd);
+      } catch {
+      }
+    }
     proxy.once("error", (e) => {
       log.warn(logging.tag, logging.spawnErrorMsg(e.message));
     });
@@ -9045,6 +9100,11 @@ async function ensureHeadroomProxy(deps) {
   if (deps.proxyProcessAlive()) return "starting";
   const ageMs = deps.proxyStartupAgeMs();
   if (ageMs !== null && ageMs < PROXY_STARTUP_GRACE_MS) return "starting";
+  const adopted = deps.adoptRunningProxy?.() ?? null;
+  if (adopted !== null) {
+    log.info("headroom-supervisor", `adopted an already-running proxy (pid ${adopted})`);
+    return "starting";
+  }
   log.warn("headroom-supervisor", "proxy :8787 is confirmed down \u2014 respawning");
   (deps.spawnProxyForce ?? deps.spawnProxy)();
   return "respawned";
@@ -9070,7 +9130,13 @@ async function ensureHeadroomProxyReady(deps, opts = {}) {
   log.warn("headroom-supervisor", "proxy :8787 still not ready after respawn wait \u2014 proceeding anyway");
   return false;
 }
-function isHeadroomConfiguredReal(homeDir2 = os6.homedir()) {
+function isHeadroomConfiguredReal(homeDir2 = os7.homedir()) {
+  const ownConfig = path6.join(homeDir2, ".codeam", "headroom-config.json");
+  try {
+    const j2 = JSON.parse(fs7.readFileSync(ownConfig, "utf8"));
+    if (j2.enabled === true) return true;
+  } catch {
+  }
   if (process.env.HEADROOM_ENABLED === "1") return true;
   const csEnv = path6.join(homeDir2, ".codeam", "codespace-env.json");
   try {
@@ -9080,7 +9146,8 @@ function isHeadroomConfiguredReal(homeDir2 = os6.homedir()) {
   }
   const settings = path6.join(homeDir2, ".claude", "settings.json");
   try {
-    if (fs7.readFileSync(settings, "utf8").includes("127.0.0.1:8787")) return true;
+    const raw = fs7.readFileSync(settings, "utf8");
+    if (raw.includes("127.0.0.1:8787") || raw.includes("headroom init hook")) return true;
   } catch {
   }
   return false;
@@ -9112,6 +9179,7 @@ function makeRealProxySupervisorDeps() {
     probeAlive: probeProxyAliveReal,
     proxyProcessAlive: () => isHeadroomProxyProcessAlive(),
     proxyStartupAgeMs: () => headroomProxyPidfileAgeMs(Date.now()),
+    adoptRunningProxy: () => adoptRunningProxy(),
     spawnProxy: spawnProxyReal,
     spawnProxyForce: () => {
       killHeadroomProxy();
@@ -9519,7 +9587,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.61.98" ? { ideVersion: "2.61.98" } : {}
+      ..."2.62.0" ? { ideVersion: "2.62.0" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -9586,7 +9654,7 @@ var CommandRelayService = class _CommandRelayService {
 // src/services/file-watcher.service.ts
 var import_child_process3 = require("child_process");
 var fs8 = __toESM(require("fs"));
-var os7 = __toESM(require("os"));
+var os8 = __toESM(require("os"));
 var path7 = __toESM(require("path"));
 var import_ignore = __toESM(require("ignore"));
 
@@ -9746,10 +9814,10 @@ var WINDOWS_LEGACY_JUNCTIONS = [
   /[\\/]Start Menu([\\/]|$)/i,
   /[\\/]Templates([\\/]|$)/i
 ];
-function isUnsafeWindowsWatchRoot(dir, homedir51) {
+function isUnsafeWindowsWatchRoot(dir, homedir52) {
   const norm = (p2) => p2.replace(/\//g, "\\").replace(/\\+$/, "").toLowerCase();
   const cwd = norm(dir);
-  const home = norm(homedir51);
+  const home = norm(homedir52);
   if (cwd === home) return true;
   if (/^[a-z]:$/.test(cwd)) return true;
   const sysRoots = [
@@ -9848,7 +9916,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, os7.homedir())) {
+    if (isWin && isUnsafeWindowsWatchRoot(this.opts.workingDir, os8.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.`
@@ -10894,7 +10962,7 @@ function closeAllTerminals() {
 
 // src/commands/start/handlers.ts
 var fs62 = __toESM(require("fs"));
-var os50 = __toESM(require("os"));
+var os51 = __toESM(require("os"));
 var path66 = __toESM(require("path"));
 var import_crypto3 = require("crypto");
 var import_child_process24 = require("child_process");
@@ -13784,7 +13852,7 @@ function parseFrame(frame, dispatch) {
 
 // src/os/posix.ts
 var fs13 = __toESM(require("fs"));
-var os9 = __toESM(require("os"));
+var os10 = __toESM(require("os"));
 var path14 = __toESM(require("path"));
 var import_node_crypto2 = require("crypto");
 
@@ -13809,7 +13877,7 @@ function findInPathFor(name, opts) {
 // src/services/pty/unix.strategy.ts
 var import_child_process7 = require("child_process");
 var fs12 = __toESM(require("fs"));
-var os8 = __toESM(require("os"));
+var os9 = __toESM(require("os"));
 var path13 = __toESM(require("path"));
 
 // src/services/pty/types.ts
@@ -13892,7 +13960,7 @@ var UnixPtyStrategy = class {
     }
     const cols = process.stdout.columns || 220;
     const rows = process.stdout.rows || 50;
-    this.helperPath = path13.join(os8.tmpdir(), "codeam-pty-helper.py");
+    this.helperPath = path13.join(os9.tmpdir(), "codeam-pty-helper.py");
     fs12.writeFileSync(this.helperPath, PYTHON_PTY_HELPER, { mode: 420 });
     this.proc = (0, import_child_process7.spawn)(python, [this.helperPath, cmd, ...args2], {
       stdio: ["pipe", "pipe", "inherit"],
@@ -14030,11 +14098,11 @@ var UnixPtyStrategy = class {
 // src/os/posix.ts
 var PosixOsStrategy = class {
   homeDir() {
-    return os9.homedir();
+    return os10.homedir();
   }
   scratchPath(prefix) {
     const tag = `${process.pid}-${(0, import_node_crypto2.randomBytes)(4).toString("hex")}`;
-    return path14.join(os9.tmpdir(), `${prefix}-${tag}`);
+    return path14.join(os10.tmpdir(), `${prefix}-${tag}`);
   }
   devNull() {
     return "/dev/null";
@@ -14089,7 +14157,7 @@ var LinuxOsStrategy = class extends PosixOsStrategy {
 
 // src/os/win32.ts
 var fs14 = __toESM(require("fs"));
-var os10 = __toESM(require("os"));
+var os11 = __toESM(require("os"));
 var path16 = __toESM(require("path"));
 var import_node_crypto3 = require("crypto");
 
@@ -14282,11 +14350,11 @@ var WINDOWS_EXEC_EXTS = [".exe", ".cmd", ".bat", ".ps1"];
 var Win32OsStrategy = class {
   id = "win32";
   homeDir() {
-    return os10.homedir();
+    return os11.homedir();
   }
   scratchPath(prefix) {
     const tag = `${process.pid}-${(0, import_node_crypto3.randomBytes)(4).toString("hex")}`;
-    return path16.join(os10.tmpdir(), `${prefix}-${tag}`);
+    return path16.join(os11.tmpdir(), `${prefix}-${tag}`);
   }
   devNull() {
     return "NUL";
@@ -14405,18 +14473,18 @@ function buildForPlatform(platform3) {
 var import_node_crypto4 = require("crypto");
 
 // src/agents/claude/resolver.ts
-function buildClaudeLaunch(extraArgs = [], os63 = createOsStrategy()) {
-  const found = os63.findInPath("claude") ?? os63.findInPath("claude-code");
+function buildClaudeLaunch(extraArgs = [], os64 = createOsStrategy()) {
+  const found = os64.findInPath("claude") ?? os64.findInPath("claude-code");
   if (!found) return null;
-  return os63.buildLaunch(found, extraArgs);
+  return os64.buildLaunch(found, extraArgs);
 }
 
 // src/agents/claude/installer.ts
 var import_child_process9 = require("child_process");
 var path17 = __toESM(require("path"));
-var os11 = __toESM(require("os"));
+var os12 = __toESM(require("os"));
 function probeInstallDirs() {
-  const home = os11.homedir();
+  const home = os12.homedir();
   if (process.platform === "win32") {
     return [
       path17.join(home, ".claude", "local"),
@@ -14498,7 +14566,7 @@ var import_node_child_process3 = require("child_process");
 // src/agents/claude/local-token.ts
 var import_node_child_process2 = require("child_process");
 var fs15 = __toESM(require("fs"));
-var os12 = __toESM(require("os"));
+var os13 = __toESM(require("os"));
 var path18 = __toESM(require("path"));
 var import_node_util3 = require("util");
 var execFileP2 = (0, import_node_util3.promisify)(import_node_child_process2.execFile);
@@ -14509,7 +14577,7 @@ var KEYCHAIN_SERVICE_NAMES = [
   "Anthropic Claude"
 ];
 function claudeCredentialsPaths() {
-  const home = os12.homedir();
+  const home = os13.homedir();
   return [
     path18.join(home, ".claude", ".credentials.json"),
     path18.join(home, ".config", "claude", ".credentials.json")
@@ -14544,7 +14612,7 @@ async function extractLocalClaudeToken() {
 }
 function readClaudeAgentState() {
   const STATE_MAX_BYTES = 256 * 1024;
-  const candidate = path18.join(os12.homedir(), ".claude.json");
+  const candidate = path18.join(os13.homedir(), ".claude.json");
   try {
     if (!fs15.existsSync(candidate)) return void 0;
     const buf = fs15.readFileSync(candidate);
@@ -14635,7 +14703,7 @@ function claudeLoginLauncher() {
 
 // src/agents/claude/quota.ts
 var fs16 = __toESM(require("fs"));
-var os13 = __toESM(require("os"));
+var os14 = __toESM(require("os"));
 var path19 = __toESM(require("path"));
 var import_child_process10 = require("child_process");
 var HELPER_SCRIPT = `import os,pty,sys,select,signal,struct,fcntl,termios,errno
@@ -14699,7 +14767,7 @@ async function fetchClaudeQuota() {
       resolve9(null);
       return;
     }
-    const helperPath = path19.join(os13.tmpdir(), "codeam-quota-helper.py");
+    const helperPath = path19.join(os14.tmpdir(), "codeam-quota-helper.py");
     fs16.writeFileSync(helperPath, HELPER_SCRIPT, { mode: 420 });
     const python = findInPath("python3") ?? findInPath("python");
     if (!python) {
@@ -14813,12 +14881,12 @@ async function spawnAndCapture(cmd, args2, opts = {}) {
 // src/agents/claude/history.ts
 var fs17 = __toESM(require("fs"));
 var path20 = __toESM(require("path"));
-var os14 = __toESM(require("os"));
+var os15 = __toESM(require("os"));
 function encodeCwd(cwd) {
   return cwd.replace(/[\\/:_]/g, "-");
 }
 function resolveHistoryDir(cwd, projectsRoot) {
-  const root = projectsRoot ?? path20.join(os14.homedir(), ".claude", "projects");
+  const root = projectsRoot ?? path20.join(os15.homedir(), ".claude", "projects");
   const primary = path20.join(root, encodeCwd(cwd));
   if (fs17.existsSync(primary)) return primary;
   try {
@@ -14998,8 +15066,8 @@ var ClaudeRuntimeStrategy = class {
   meta = getAgent("claude");
   mode = "interactive";
   os;
-  constructor(os63) {
-    this.os = os63;
+  constructor(os64) {
+    this.os = os64;
   }
   /**
    * Claude Code's react-ink TUI enables bracketed-paste mode at
@@ -15135,23 +15203,23 @@ var ClaudeRuntimeStrategy = class {
 
 // src/agents/claude/deploy.ts
 var fs19 = __toESM(require("fs"));
-var os16 = __toESM(require("os"));
+var os17 = __toESM(require("os"));
 var path22 = __toESM(require("path"));
 
 // src/agents/claude/credentials.ts
 var import_child_process12 = require("child_process");
 var fs18 = __toESM(require("fs"));
-var os15 = __toESM(require("os"));
+var os16 = __toESM(require("os"));
 var path21 = __toESM(require("path"));
 var import_util2 = require("util");
 var execFileP3 = (0, import_util2.promisify)(import_child_process12.execFile);
 async function detectLocalClaudeCredentials() {
-  const localClaudeDir = path21.join(os15.homedir(), ".claude");
+  const localClaudeDir = path21.join(os16.homedir(), ".claude");
   const flat = path21.join(localClaudeDir, ".credentials.json");
   if (fs18.existsSync(flat)) {
     return { source: "flat-file", description: "~/.claude/.credentials.json" };
   }
-  if (os15.platform() === "darwin") {
+  if (os16.platform() === "darwin") {
     try {
       await execFileP3(
         "security",
@@ -15166,7 +15234,7 @@ async function detectLocalClaudeCredentials() {
   return { source: "none", description: "" };
 }
 async function bridgeClaudeCredentials(provider, workspaceId) {
-  const localClaudeDir = path21.join(os15.homedir(), ".claude");
+  const localClaudeDir = path21.join(os16.homedir(), ".claude");
   const fileBased = path21.join(localClaudeDir, ".credentials.json");
   if (fs18.existsSync(fileBased)) {
     return { source: "flat-file", description: "~/.claude/.credentials.json" };
@@ -15260,7 +15328,7 @@ var ClaudeDeployStrategy = class {
       process.exit(1);
     }
     claudeStep.stop("\u2713 Claude CLI installed");
-    const localClaudeDir = path22.join(os16.homedir(), ".claude");
+    const localClaudeDir = path22.join(os17.homedir(), ".claude");
     const haveLocalClaude = fs19.existsSync(localClaudeDir) && fs19.statSync(localClaudeDir).isDirectory();
     if (haveLocalClaude) {
       const copyStep = fe();
@@ -15315,7 +15383,7 @@ var ClaudeDeployStrategy = class {
       }
     }
     if (opts.bridged !== "none") {
-      const localClaudeJson = path22.join(os16.homedir(), ".claude.json");
+      const localClaudeJson = path22.join(os17.homedir(), ".claude.json");
       if (fs19.existsSync(localClaudeJson)) {
         try {
           const contents = fs19.readFileSync(localClaudeJson);
@@ -15712,10 +15780,10 @@ var import_node_child_process4 = require("child_process");
 
 // src/agents/codex/local-token.ts
 var fs21 = __toESM(require("fs"));
-var os18 = __toESM(require("os"));
+var os19 = __toESM(require("os"));
 var path24 = __toESM(require("path"));
 function codexCredentialsPath() {
-  return path24.join(os18.homedir(), ".codex", "auth.json");
+  return path24.join(os19.homedir(), ".codex", "auth.json");
 }
 async function extractLocalCodexToken() {
   const file = codexCredentialsPath();
@@ -15779,8 +15847,8 @@ function codexCredentialLocator() {
 function codexLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os63 = createOsStrategy();
-      return os63.findInPath("codex") !== null;
+      const os64 = createOsStrategy();
+      return os64.findInPath("codex") !== null;
     },
     launch() {
       return (0, import_node_child_process4.spawn)("codex", ["login"], { stdio: "inherit" });
@@ -15803,8 +15871,8 @@ var CodexRuntimeStrategy = class {
   meta = getAgent("codex");
   mode = "interactive";
   os;
-  constructor(os63) {
-    this.os = os63;
+  constructor(os64) {
+    this.os = os64;
   }
   async prepareLaunch() {
     let binary = this.os.findInPath("codex");
@@ -15913,12 +15981,12 @@ var CodexRuntimeStrategy = class {
     });
   }
 };
-function resolveNpm(os63) {
-  return os63.id === "win32" ? "npm.cmd" : "npm";
+function resolveNpm(os64) {
+  return os64.id === "win32" ? "npm.cmd" : "npm";
 }
-async function installCodexViaNpm(os63) {
+async function installCodexViaNpm(os64) {
   return new Promise((resolve9, reject) => {
-    const proc = (0, import_node_child_process5.spawn)(resolveNpm(os63), ["install", "-g", "@openai/codex"], {
+    const proc = (0, import_node_child_process5.spawn)(resolveNpm(os64), ["install", "-g", "@openai/codex"], {
       stdio: "inherit"
     });
     proc.on("close", (code) => {
@@ -15935,16 +16003,16 @@ async function installCodexViaNpm(os63) {
     });
   });
 }
-function augmentNpmGlobalBin(os63) {
+function augmentNpmGlobalBin(os64) {
   try {
-    const result = (0, import_node_child_process5.spawnSync)(resolveNpm(os63), ["prefix", "-g"], {
+    const result = (0, import_node_child_process5.spawnSync)(resolveNpm(os64), ["prefix", "-g"], {
       stdio: ["ignore", "pipe", "ignore"]
     });
     if (result.status !== 0) return;
     const prefix = result.stdout.toString().trim();
     if (!prefix) return;
-    const binDir = os63.id === "win32" ? prefix : path25.join(prefix, "bin");
-    os63.augmentPath([binDir]);
+    const binDir = os64.id === "win32" ? prefix : path25.join(prefix, "bin");
+    os64.augmentPath([binDir]);
   } catch {
   }
 }
@@ -16028,9 +16096,9 @@ var import_node_child_process8 = require("child_process");
 // src/agents/coderabbit/installer.ts
 var import_node_child_process6 = require("child_process");
 var INSTALL_URL = "https://cli.coderabbit.ai/install.sh";
-async function ensureCoderabbitInstalled(os63) {
-  if (os63.findInPath("coderabbit")) return true;
-  if (os63.id === "win32") {
+async function ensureCoderabbitInstalled(os64) {
+  if (os64.findInPath("coderabbit")) return true;
+  if (os64.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"
     );
@@ -16063,14 +16131,14 @@ async function ensureCoderabbitInstalled(os63) {
     proc.on("error", () => finish(false));
   });
   if (!ok) return false;
-  os63.augmentPath([`${os63.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
-  return os63.findInPath("coderabbit") !== null;
+  os64.augmentPath([`${os64.homeDir()}/.local/bin`, "/opt/homebrew/bin"]);
+  return os64.findInPath("coderabbit") !== null;
 }
 
 // src/agents/coderabbit/link.ts
 var import_node_child_process7 = require("child_process");
 var fs23 = __toESM(require("fs"));
-var os20 = __toESM(require("os"));
+var os21 = __toESM(require("os"));
 var path27 = __toESM(require("path"));
 
 // src/agents/strategy.ts
@@ -16080,7 +16148,7 @@ function validateNonEmptyCredential(token) {
 
 // src/agents/coderabbit/link.ts
 function authPath() {
-  return path27.join(os20.homedir(), ".coderabbit", "auth.json");
+  return path27.join(os21.homedir(), ".coderabbit", "auth.json");
 }
 async function extractLocalCoderabbitToken() {
   const file = authPath();
@@ -16099,10 +16167,10 @@ function coderabbitCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function coderabbitLoginLauncher(os63) {
+function coderabbitLoginLauncher(os64) {
   return {
     async ensureInstalled() {
-      return ensureCoderabbitInstalled(os63);
+      return ensureCoderabbitInstalled(os64);
     },
     launch() {
       return (0, import_node_child_process7.spawn)("coderabbit", ["auth", "login"], { stdio: "inherit" });
@@ -16195,9 +16263,9 @@ function findingsFrom(value) {
   }
   const grouped = flat && !Array.isArray(flat) ? flat : root;
   for (const sev of ["critical", "warning", "warn", "error", "info", "note"]) {
-    const bucket = grouped[sev];
-    if (Array.isArray(bucket)) {
-      for (const f of bucket) {
+    const bucket2 = grouped[sev];
+    if (Array.isArray(bucket2)) {
+      for (const f of bucket2) {
         const h = toHunk(f, sev);
         if (h) out2.push(h);
       }
@@ -16322,8 +16390,8 @@ var CoderabbitRuntimeStrategy = class {
   meta = getAgent("coderabbit");
   mode = "batch";
   os;
-  constructor(os63) {
-    this.os = os63;
+  constructor(os64) {
+    this.os = os64;
   }
   getDefaultArgs() {
     return ["review", "--agent"];
@@ -16426,11 +16494,11 @@ CodeRabbit review timed out after ${Math.round(
 
 // src/agents/cursor/history.ts
 var fs24 = __toESM(require("fs"));
-var os21 = __toESM(require("os"));
+var os22 = __toESM(require("os"));
 var path28 = __toESM(require("path"));
 var import_node_crypto5 = require("crypto");
-var HISTORY_ROOT = path28.join(os21.homedir(), ".cursor", "projects");
-var CURSOR_HOME = path28.join(os21.homedir(), ".cursor");
+var HISTORY_ROOT = path28.join(os22.homedir(), ".cursor", "projects");
+var CURSOR_HOME = path28.join(os22.homedir(), ".cursor");
 var STORE_FILES = ["store.db", "store.db-wal", "store.db-shm"];
 function acpSessionDir(sessionId) {
   return path28.join(CURSOR_HOME, "acp-sessions", sessionId);
@@ -16567,10 +16635,10 @@ var import_node_child_process9 = require("child_process");
 
 // src/agents/cursor/local-token.ts
 var fs25 = __toESM(require("fs"));
-var os22 = __toESM(require("os"));
+var os23 = __toESM(require("os"));
 var path29 = __toESM(require("path"));
 function cursorCredentialsPath() {
-  return path29.join(os22.homedir(), ".cursor", "auth.json");
+  return path29.join(os23.homedir(), ".cursor", "auth.json");
 }
 async function extractLocalCursorToken() {
   const file = cursorCredentialsPath();
@@ -16594,10 +16662,10 @@ function cursorCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function cursorLoginLauncher(os63) {
+function cursorLoginLauncher(os64) {
   return {
     async ensureInstalled() {
-      if (os63.findInPath("cursor-agent")) return true;
+      if (os64.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"
       );
@@ -16661,8 +16729,8 @@ var CursorRuntimeStrategy = class {
   meta = getAgent("cursor");
   mode = "interactive";
   os;
-  constructor(os63) {
-    this.os = os63;
+  constructor(os64) {
+    this.os = os64;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("cursor-agent");
@@ -16837,9 +16905,9 @@ var import_node_child_process11 = require("child_process");
 
 // src/agents/aider/local-token.ts
 var fs27 = __toESM(require("fs"));
-var os23 = __toESM(require("os"));
+var os24 = __toESM(require("os"));
 var path31 = __toESM(require("path"));
-var AIDER_CONF_FILE = path31.join(os23.homedir(), ".aider.conf.yml");
+var AIDER_CONF_FILE = path31.join(os24.homedir(), ".aider.conf.yml");
 var API_KEY_ENV_VARS = [
   "ANTHROPIC_API_KEY",
   "OPENAI_API_KEY",
@@ -16878,10 +16946,10 @@ function aiderCredentialLocator() {
     validate: validateNonEmptyCredential
   };
 }
-function aiderLoginLauncher(os63) {
+function aiderLoginLauncher(os64) {
   return {
     async ensureInstalled() {
-      if (os63.findInPath("aider")) return true;
+      if (os64.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"
       );
@@ -16891,7 +16959,7 @@ function aiderLoginLauncher(os63) {
       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_process11.spawn)(os63.id === "win32" ? "cmd.exe" : "sh", os63.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
+      return (0, import_node_child_process11.spawn)(os64.id === "win32" ? "cmd.exe" : "sh", os64.id === "win32" ? ["/c", "exit", "0"] : ["-c", "exit 0"], {
         stdio: "ignore"
       });
     }
@@ -16963,8 +17031,8 @@ var AiderRuntimeStrategy = class {
   meta = getAgent("aider");
   mode = "interactive";
   os;
-  constructor(os63) {
-    this.os = os63;
+  constructor(os64) {
+    this.os = os64;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("aider");
@@ -17039,10 +17107,10 @@ var import_node_child_process12 = require("child_process");
 
 // src/agents/gemini/local-token.ts
 var fs28 = __toESM(require("fs"));
-var os24 = __toESM(require("os"));
+var os25 = __toESM(require("os"));
 var path32 = __toESM(require("path"));
 function geminiCredentialsPath() {
-  return path32.join(os24.homedir(), ".gemini", "oauth_creds.json");
+  return path32.join(os25.homedir(), ".gemini", "oauth_creds.json");
 }
 function geminiCredentialsPaths() {
   return [geminiCredentialsPath()];
@@ -17096,8 +17164,8 @@ function geminiCredentialLocator() {
 function geminiLoginLauncher() {
   return {
     async ensureInstalled() {
-      const os63 = createOsStrategy();
-      return os63.findInPath("gemini") !== null;
+      const os64 = createOsStrategy();
+      return os64.findInPath("gemini") !== null;
     },
     launch() {
       return (0, import_node_child_process12.spawn)("gemini", ["auth", "login"], { stdio: "inherit" });
@@ -17107,9 +17175,9 @@ function geminiLoginLauncher() {
 
 // src/agents/gemini/history.ts
 var fs29 = __toESM(require("fs"));
-var os25 = __toESM(require("os"));
+var os26 = __toESM(require("os"));
 var path33 = __toESM(require("path"));
-var GEMINI_ROOT = path33.join(os25.homedir(), ".gemini");
+var GEMINI_ROOT = path33.join(os26.homedir(), ".gemini");
 function projectNameForCwd(cwd, root) {
   try {
     const parsed = JSON.parse(
@@ -17287,8 +17355,8 @@ var GeminiRuntimeStrategy = class {
   meta = getAgent("gemini");
   mode = "interactive";
   os;
-  constructor(os63) {
-    this.os = os63;
+  constructor(os64) {
+    this.os = os64;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("gemini");
@@ -17402,11 +17470,11 @@ var import_node_path4 = require("path");
 
 // src/agents/kimi/history.ts
 var fs30 = __toESM(require("fs"));
-var os26 = __toESM(require("os"));
+var os27 = __toESM(require("os"));
 var path34 = __toESM(require("path"));
 var import_node_crypto7 = require("crypto");
 function kimiHome() {
-  return process.env.KIMI_CODE_HOME || path34.join(os26.homedir(), ".kimi-code");
+  return process.env.KIMI_CODE_HOME || path34.join(os27.homedir(), ".kimi-code");
 }
 function workDirKey(cwd) {
   const hash = (0, import_node_crypto7.createHash)("sha256").update(cwd).digest("hex").slice(0, 12);
@@ -17427,8 +17495,8 @@ function resolveHistoryFile5(cwd, sessionId) {
     const p2 = path34.join(fromIndex, WIRE_REL);
     if (fs30.existsSync(p2)) return p2;
   }
-  const bucket = path34.join(kimiHome(), "sessions", workDirKey(cwd));
-  const computed = path34.join(bucket, sessionId, WIRE_REL);
+  const bucket2 = path34.join(kimiHome(), "sessions", workDirKey(cwd));
+  const computed = path34.join(bucket2, sessionId, WIRE_REL);
   if (fs30.existsSync(computed)) return computed;
   const scanned = scanBucketsForSession(sessionId);
   if (scanned) return scanned;
@@ -17467,20 +17535,20 @@ function scanBucketsForSession(sessionId) {
   return null;
 }
 async function discoverSessionId2(cwd, opts) {
-  const bucket = path34.join(kimiHome(), "sessions", workDirKey(cwd));
+  const bucket2 = path34.join(kimiHome(), "sessions", workDirKey(cwd));
   const floor = opts.sinceMs - 2e3;
   const deadline = Date.now() + (opts.timeoutMs ?? 15e3);
   for (; ; ) {
-    const id = newestSessionSince(bucket, floor);
+    const id = newestSessionSince(bucket2, floor);
     if (id) return id;
     if (Date.now() >= deadline) return null;
     await sleep3(250);
   }
 }
-function newestSessionSince(bucket, floorMs) {
+function newestSessionSince(bucket2, floorMs) {
   let entries;
   try {
-    entries = fs30.readdirSync(bucket, { withFileTypes: true });
+    entries = fs30.readdirSync(bucket2, { withFileTypes: true });
   } catch {
     return null;
   }
@@ -17490,7 +17558,7 @@ function newestSessionSince(bucket, floorMs) {
     if (!e.isDirectory() || !e.name.startsWith("session_")) continue;
     let mtime;
     try {
-      mtime = fs30.statSync(path34.join(bucket, e.name)).mtimeMs;
+      mtime = fs30.statSync(path34.join(bucket2, e.name)).mtimeMs;
     } catch {
       continue;
     }
@@ -17579,8 +17647,8 @@ var KimiRuntimeStrategy = class {
   meta = getAgent("kimi");
   mode = "interactive";
   os;
-  constructor(os63) {
-    this.os = os63;
+  constructor(os64) {
+    this.os = os64;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("kimi");
@@ -17722,8 +17790,8 @@ var OpencodeRuntimeStrategy = class {
   meta = getAgent("opencode");
   mode = "interactive";
   os;
-  constructor(os63) {
-    this.os = os63;
+  constructor(os64) {
+    this.os = os64;
   }
   async prepareLaunch() {
     const binary = this.os.findInPath("opencode");
@@ -17807,20 +17875,20 @@ var OpencodeRuntimeStrategy = class {
 
 // src/agents/registry.ts
 var runtimeBuilders = {
-  claude: (os63) => new ClaudeRuntimeStrategy(os63),
-  codex: (os63) => new CodexRuntimeStrategy(os63),
-  coderabbit: (os63) => new CoderabbitRuntimeStrategy(os63),
-  cursor: (os63) => new CursorRuntimeStrategy(os63),
-  aider: (os63) => new AiderRuntimeStrategy(os63),
-  gemini: (os63) => new GeminiRuntimeStrategy(os63),
-  kimi: (os63) => new KimiRuntimeStrategy(os63),
-  opencode: (os63) => new OpencodeRuntimeStrategy(os63)
+  claude: (os64) => new ClaudeRuntimeStrategy(os64),
+  codex: (os64) => new CodexRuntimeStrategy(os64),
+  coderabbit: (os64) => new CoderabbitRuntimeStrategy(os64),
+  cursor: (os64) => new CursorRuntimeStrategy(os64),
+  aider: (os64) => new AiderRuntimeStrategy(os64),
+  gemini: (os64) => new GeminiRuntimeStrategy(os64),
+  kimi: (os64) => new KimiRuntimeStrategy(os64),
+  opencode: (os64) => new OpencodeRuntimeStrategy(os64)
 };
 var deployBuilders = {
   claude: () => new ClaudeDeployStrategy(),
   codex: () => new CodexDeployStrategy()
 };
-function createAgentStrategy(agent, os63 = createOsStrategy()) {
+function createAgentStrategy(agent, os64 = 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'.`
@@ -17830,10 +17898,10 @@ function createAgentStrategy(agent, os63 = createOsStrategy()) {
   if (!build) {
     throw new Error(`No runtime strategy registered for agent "${agent}"`);
   }
-  return build(os63);
+  return build(os64);
 }
-function createInteractiveAgentStrategy(agent, os63 = createOsStrategy()) {
-  const s = createAgentStrategy(agent, os63);
+function createInteractiveAgentStrategy(agent, os64 = createOsStrategy()) {
+  const s = createAgentStrategy(agent, os64);
   if (s.mode !== "interactive") {
     throw new Error(
       `Agent "${agent}" is a batch agent; use createAgentStrategy + .runOneShot for one-shot reviews.`
@@ -18241,7 +18309,7 @@ var path37 = __toESM(require("path"));
 // src/agents/coderabbit/oauth.ts
 var import_node_child_process15 = require("child_process");
 var fs32 = __toESM(require("fs"));
-var os27 = __toESM(require("os"));
+var os28 = __toESM(require("os"));
 var path36 = __toESM(require("path"));
 function parseCoderabbitAuthEvent(line) {
   const l = line.replace(/\x1b\[[0-9;?]*[A-Za-z]/g, "").trim();
@@ -18291,7 +18359,7 @@ function resolvePython() {
 function spawnCoderabbitLoginProc(cmd, args2) {
   const python = resolvePython();
   if (python) {
-    const helper = path36.join(os27.tmpdir(), "codeam-cr-pty.py");
+    const helper = path36.join(os28.tmpdir(), "codeam-cr-pty.py");
     fs32.writeFileSync(helper, PYTHON_PTY_HELPER, { mode: 420 });
     return (0, import_node_child_process15.spawn)(python, [helper, cmd, ...args2], {
       stdio: ["pipe", "pipe", "pipe"],
@@ -18403,7 +18471,7 @@ function runCoderabbitOAuthLogin(deps) {
   });
 }
 function coderabbitDir(home) {
-  return path36.join(home ?? os27.homedir(), ".coderabbit");
+  return path36.join(home ?? os28.homedir(), ".coderabbit");
 }
 var NON_CREDENTIAL = /* @__PURE__ */ new Set(["doctor.json", "machine-id"]);
 function snapshotCredentialDir(home) {
@@ -18530,26 +18598,26 @@ function restoreCoderabbitOauthBlob(value) {
   (0, import_node_fs5.writeFileSync)(path37.join(dir, file), contents, { mode: 384 });
 }
 async function configureCoderabbit(input, deps = {}) {
-  const os63 = deps.os ?? createOsStrategy();
+  const os64 = deps.os ?? createOsStrategy();
   const ensureInstalled = deps.ensureInstalled ?? ensureCoderabbitInstalled;
   const isLoggedIn = deps.isLoggedIn ?? defaultIsLoggedIn;
   const runOAuth = deps.runOAuthLogin ?? runCoderabbitOAuthLogin;
   const snapshot = deps.snapshotDir ?? (() => snapshotCredentialDir());
   const capture2 = deps.captureCredential ?? ((b) => diffCapturedCredential(b));
   const loginWithApiKey = deps.loginWithApiKey ?? defaultLoginWithApiKey;
-  const home = os63.homeDir();
-  os63.augmentPath(
-    os63.id === "win32" ? [
+  const home = os64.homeDir();
+  os64.augmentPath(
+    os64.id === "win32" ? [
       path37.join(home, ".local", "bin"),
       path37.join(process.env.APPDATA ?? path37.join(home, "AppData", "Roaming"), "npm"),
       path37.join(home, "scoop", "shims")
     ] : [path37.join(home, ".local", "bin"), "/opt/homebrew/bin", "/usr/local/bin"]
   );
-  const installed2 = os63.findInPath("coderabbit") !== null;
+  const installed2 = os64.findInPath("coderabbit") !== null;
   const base = () => ({
     action: input.action,
     supported: true,
-    installed: os63.findInPath("coderabbit") !== null,
+    installed: os64.findInPath("coderabbit") !== null,
     loggedIn: false
   });
   if (input.action === "status") {
@@ -18563,7 +18631,7 @@ async function configureCoderabbit(input, deps = {}) {
     const key = (input.apiKey ?? "").trim();
     if (!key) return { ...res2, error: "No API key provided" };
     if (!res2.installed) {
-      const ok = await ensureInstalled(os63);
+      const ok = await ensureInstalled(os64);
       res2.installed = ok;
       if (!ok) return { ...res2, error: "CodeRabbit CLI could not be installed" };
     }
@@ -18587,7 +18655,7 @@ async function configureCoderabbit(input, deps = {}) {
     }
     if (!res2.installed) {
       deps.onEvent?.({ kind: "installing" });
-      const ok = await ensureInstalled(os63);
+      const ok = await ensureInstalled(os64);
       res2.installed = ok;
       if (!ok) return { ...res2, error: "CodeRabbit CLI could not be installed" };
     }
@@ -18617,7 +18685,7 @@ async function configureCoderabbit(input, deps = {}) {
     const res2 = base();
     if (!installed2) {
       deps.onEvent?.({ kind: "installing" });
-      const ok = await ensureInstalled(os63);
+      const ok = await ensureInstalled(os64);
       res2.installed = ok;
       if (!ok) return { ...res2, error: "CodeRabbit CLI could not be installed" };
     }
@@ -18657,7 +18725,7 @@ async function configureCoderabbit(input, deps = {}) {
   }
   const res = base();
   if (!res.installed) {
-    const ok = await ensureInstalled(os63);
+    const ok = await ensureInstalled(os64);
     res.installed = ok;
     if (!ok) return { ...res, error: "CodeRabbit CLI is not installed" };
   }
@@ -18841,7 +18909,7 @@ function defaultRunGh(args2) {
 
 // src/commands/host-agent.ts
 var import_node_child_process25 = require("child_process");
-var os39 = __toESM(require("os"));
+var os40 = __toESM(require("os"));
 var fs45 = __toESM(require("fs"));
 var path48 = __toESM(require("path"));
 
@@ -18990,13 +19058,13 @@ function describeReason(reason) {
 
 // src/commands/host/host-client.ts
 var fs36 = __toESM(require("fs"));
-var os31 = __toESM(require("os"));
+var os32 = __toESM(require("os"));
 var path40 = __toESM(require("path"));
 var import_node_crypto9 = require("crypto");
 function sampleCpuTimes() {
   let idle = 0;
   let total = 0;
-  for (const cpu of os31.cpus()) {
+  for (const cpu of os32.cpus()) {
     const t2 = cpu.times;
     idle += t2.idle;
     total += t2.user + t2.nice + t2.sys + t2.idle + t2.irq;
@@ -19015,8 +19083,8 @@ var MetricsCollector = class {
     const prev = this.prevCpu;
     this.prevCpu = current2;
     if (!prev) {
-      const cores = os31.cpus().length || 1;
-      const proxy = os31.loadavg()[0] / cores * 100;
+      const cores = os32.cpus().length || 1;
+      const proxy = os32.loadavg()[0] / cores * 100;
       return Math.min(100, Math.max(0, Math.round(proxy)));
     }
     const idleDelta = current2.idle - prev.idle;
@@ -19029,8 +19097,8 @@ var MetricsCollector = class {
   collect() {
     return {
       cpuPct: this.cpuPct(),
-      ramUsedMb: Math.round((os31.totalmem() - os31.freemem()) / 1048576),
-      ramTotalMb: Math.round(os31.totalmem() / 1048576),
+      ramUsedMb: Math.round((os32.totalmem() - os32.freemem()) / 1048576),
+      ramTotalMb: Math.round(os32.totalmem() / 1048576),
       latencyMs: this.lastLatencyMs
     };
   }
@@ -19039,13 +19107,13 @@ function apiBase() {
   return process.env.CODEAM_API_URL ?? resolveApiBaseUrl();
 }
 function hostIdentityPath() {
-  return path40.join(os31.homedir(), ".codeam", "host-agent.json");
+  return path40.join(os32.homedir(), ".codeam", "host-agent.json");
 }
 function collectOsInfo() {
   return {
-    distro: os31.platform(),
-    arch: os31.arch(),
-    kernel: os31.release(),
+    distro: os32.platform(),
+    arch: os32.arch(),
+    kernel: os32.release(),
     nodeVersion: process.versions.node
   };
 }
@@ -19140,7 +19208,7 @@ async function postJson(pathname, body) {
 function resolveHostLabel(label) {
   const explicit = label?.trim();
   const envLabel = process.env.CODEAM_HOST_LABEL?.trim();
-  const resolved = explicit || envLabel || os31.hostname();
+  const resolved = explicit || envLabel || os32.hostname();
   return resolved.slice(0, 80);
 }
 async function redeemEnrollToken(token, label) {
@@ -19252,7 +19320,7 @@ async function reportDeployProgress(auth, deployId, step, message, sessionId) {
 
 // src/commands/host/workspace.ts
 var fs37 = __toESM(require("fs"));
-var os32 = __toESM(require("os"));
+var os33 = __toESM(require("os"));
 var path41 = __toESM(require("path"));
 var import_node_child_process19 = require("child_process");
 var import_node_util4 = require("util");
@@ -19261,7 +19329,7 @@ function isAbsolutePathTarget(target) {
   return path41.isAbsolute(target);
 }
 function selfHostedWorkspaceRoot() {
-  return path41.join(os32.homedir(), ".codeam", "self-hosted");
+  return path41.join(os33.homedir(), ".codeam", "self-hosted");
 }
 function nonInteractiveGitEnv() {
   return {
@@ -19401,7 +19469,7 @@ async function prepareWorkspace(repoOrPath, deployId, cloneToken, provider = "gi
 
 // src/commands/host/agent-provisioning.ts
 var fs38 = __toESM(require("fs"));
-var os33 = __toESM(require("os"));
+var os34 = __toESM(require("os"));
 var path42 = __toESM(require("path"));
 var PUBLIC_TO_INTERNAL_AGENT = {
   claude_code: "claude",
@@ -19586,7 +19654,7 @@ var UnsupportedAgentError = class extends Error {
     this.agentId = agentId;
   }
 };
-function provisionAgentCredentials(publicAgentId, auth, homeDir2 = os33.homedir()) {
+function provisionAgentCredentials(publicAgentId, auth, homeDir2 = os34.homedir()) {
   const internal = toInternalAgentId(publicAgentId);
   if (!internal) throw new UnsupportedAgentError(publicAgentId);
   const provisioner = PROVISIONERS[internal];
@@ -19597,10 +19665,10 @@ function provisionAgentCredentials(publicAgentId, auth, homeDir2 = os33.homedir(
 // src/commands/host/git-tooling.ts
 var import_node_child_process20 = require("child_process");
 var fs39 = __toESM(require("fs"));
-var os34 = __toESM(require("os"));
+var os35 = __toESM(require("os"));
 var path43 = __toESM(require("path"));
 function codeamBinDir() {
-  return process.env.CODEAM_BIN_DIR ?? path43.join(os34.homedir(), ".codeam", "bin");
+  return process.env.CODEAM_BIN_DIR ?? path43.join(os35.homedir(), ".codeam", "bin");
 }
 var FALLBACK_GH_VERSION = "2.62.0";
 var RELEASE_API = "https://api.github.com/repos/cli/cli/releases/latest";
@@ -19655,7 +19723,7 @@ async function ensureGhCli(runner, token, deps = {}) {
     const version3 = await resolveVersionFn(token);
     const asset = `gh_${version3}_${osToken}_${arch2}`;
     const url2 = `https://github.com/cli/cli/releases/download/v${version3}/${asset}.${ext}`;
-    const tmpRoot = fs39.mkdtempSync(path43.join(os34.tmpdir(), "codeam-gh-"));
+    const tmpRoot = fs39.mkdtempSync(path43.join(os35.tmpdir(), "codeam-gh-"));
     const archive = path43.join(tmpRoot, `${asset}.${ext}`);
     if (!await downloadFn(url2, archive)) {
       log.warn("host-agent", "gh download failed \u2014 skipping (git pull/push still work via the credential helper)");
@@ -19735,7 +19803,7 @@ async function ensureGlabCli(runner, deps = {}) {
     const version3 = await resolveLatestGlabVersion();
     const asset = `glab_${version3}_${osToken}_${arch2}`;
     const url2 = `https://gitlab.com/gitlab-org/cli/-/releases/v${version3}/downloads/${asset}.${ext}`;
-    const tmpRoot = fs39.mkdtempSync(path43.join(os34.tmpdir(), "codeam-glab-"));
+    const tmpRoot = fs39.mkdtempSync(path43.join(os35.tmpdir(), "codeam-glab-"));
     const archive = path43.join(tmpRoot, `${asset}.${ext}`);
     if (!await downloadFn(url2, archive)) {
       log.warn("host-agent", "glab download failed \u2014 skipping (git push/pull still work)");
@@ -19862,10 +19930,10 @@ var ZERO = {
   compressionPct: 0
 };
 function read(stats, inputPricePerMillion) {
-  const totals = stats.agent_usage?.totals;
+  const totals2 = stats.agent_usage?.totals;
   const compression = stats.summary?.compression;
-  const rawTokensEst = totals?.before_tokens ?? compression?.total_tokens_before_with_cli_filtering ?? 0;
-  const sentTokensEst = totals?.after_tokens ?? rawTokensEst - (compression?.total_tokens_removed ?? 0);
+  const rawTokensEst = totals2?.before_tokens ?? compression?.total_tokens_before_with_cli_filtering ?? 0;
+  const sentTokensEst = totals2?.after_tokens ?? rawTokensEst - (compression?.total_tokens_removed ?? 0);
   const compressionTokens = compression?.total_tokens_saved_with_cli_filtering ?? compression?.total_tokens_removed ?? Math.max(0, rawTokensEst - sentTokensEst);
   const compressionSavingsUsd = stats.summary?.cost?.breakdown?.compression_savings_usd ?? Math.max(0, compressionTokens) / 1e6 * inputPricePerMillion;
   return {
@@ -20250,14 +20318,14 @@ async function ensureModernPython(runner) {
 // src/commands/host/headroom-bootstrap.ts
 var fs41 = __toESM(require("fs"));
 var path45 = __toESM(require("path"));
-var os36 = __toESM(require("os"));
+var os37 = __toESM(require("os"));
 
 // src/commands/host/headroom-config.ts
 var fs40 = __toESM(require("fs"));
-var os35 = __toESM(require("os"));
+var os36 = __toESM(require("os"));
 var path44 = __toESM(require("path"));
 function headroomConfigPath() {
-  return path44.join(os35.homedir(), ".codeam", "headroom-config.json");
+  return path44.join(os36.homedir(), ".codeam", "headroom-config.json");
 }
 function persistHeadroomConfig(config) {
   try {
@@ -20275,7 +20343,7 @@ function persistHeadroomConfig(config) {
   }
 }
 function agentSettingsPath(kind) {
-  const home = os35.homedir();
+  const home = os36.homedir();
   if (kind === "claude") return path44.join(home, ".claude", "settings.json");
   if (kind === "codex") return path44.join(home, ".codex", "auth.json");
   if (kind === "copilot") return path44.join(home, ".config", "github-copilot", "hosts.json");
@@ -20286,7 +20354,7 @@ function backupAgentHeadroomConfig(kind) {
   if (!src) return;
   try {
     if (!fs40.existsSync(src)) return;
-    const dest = path44.join(os35.homedir(), ".codeam", `headroom-backup-${kind}.json`);
+    const dest = path44.join(os36.homedir(), ".codeam", `headroom-backup-${kind}.json`);
     fs40.mkdirSync(path44.dirname(dest), { recursive: true, mode: 448 });
     fs40.copyFileSync(src, dest);
     fs40.chmodSync(dest, 384);
@@ -20301,7 +20369,7 @@ function backupAgentHeadroomConfig(kind) {
 function restoreAgentHeadroomConfig(kind) {
   const dest = agentSettingsPath(kind);
   if (!dest) return false;
-  const src = path44.join(os35.homedir(), ".codeam", `headroom-backup-${kind}.json`);
+  const src = path44.join(os36.homedir(), ".codeam", `headroom-backup-${kind}.json`);
   if (!fs40.existsSync(src)) return false;
   try {
     fs40.mkdirSync(path44.dirname(dest), { recursive: true, mode: 448 });
@@ -20393,7 +20461,7 @@ async function getFreeDiskBytes(dir) {
 }
 function headroomModelsCached() {
   const hubDir = process.env.HUGGINGFACE_HUB_CACHE || path45.join(
-    process.env.HF_HOME || path45.join(os36.homedir(), ".cache", "huggingface"),
+    process.env.HF_HOME || path45.join(os37.homedir(), ".cache", "huggingface"),
     "hub"
   );
   return HEADROOM_MODELS.every(
@@ -20504,10 +20572,10 @@ async function setupHeadroomForSelfHosted(agent, runner = defaultHeadroomRunner,
 
 // src/commands/host/house-proxy-config.ts
 var fs42 = __toESM(require("fs"));
-var os37 = __toESM(require("os"));
+var os38 = __toESM(require("os"));
 var path46 = __toESM(require("path"));
 function houseProxyConfigPath() {
-  return path46.join(os37.homedir(), ".codeam", "house-proxy.json");
+  return path46.join(os38.homedir(), ".codeam", "house-proxy.json");
 }
 function persistHouseProxyConfig(config) {
   try {
@@ -20566,7 +20634,7 @@ var import_node_child_process23 = require("child_process");
 
 // src/lib/updateNotifier.ts
 var fs43 = __toESM(require("fs"));
-var os38 = __toESM(require("os"));
+var os39 = __toESM(require("os"));
 var path47 = __toESM(require("path"));
 var https6 = __toESM(require("https"));
 var import_node_child_process22 = require("child_process");
@@ -20576,7 +20644,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 = path47.join(os38.homedir(), ".codeam");
+  const dir = path47.join(os39.homedir(), ".codeam");
   return path47.join(dir, "update-check.json");
 }
 function readCache() {
@@ -20722,7 +20790,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.61.98" : null;
+  const current2 = true ? "2.62.0" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -20739,7 +20807,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.61.98" : null;
+  const current2 = true ? "2.62.0" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -20759,7 +20827,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.61.98" : null;
+  return true ? "2.62.0" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve9) => {
@@ -21491,7 +21559,7 @@ var HostAgentSupervisor = class {
     const relay = this.relay;
     if (!relay) return;
     const raw = cmd.payload?.path;
-    const target = typeof raw === "string" && raw.trim() ? path48.resolve(raw.trim()) : os39.homedir();
+    const target = typeof raw === "string" && raw.trim() ? path48.resolve(raw.trim()) : os40.homedir();
     try {
       const dirents = await fs45.promises.readdir(target, { withFileTypes: true });
       const entries = dirents.filter((d3) => !d3.name.startsWith(".")).map((d3) => ({ name: d3.name, isDir: d3.isDirectory() })).sort(
@@ -21731,7 +21799,7 @@ var HostAgentSupervisor = class {
           CODEAM_AUTO_TOKEN: payload.autoPairToken
         };
         const houseConfigDir = path48.join(
-          os39.homedir(),
+          os40.homedir(),
           ".codeam",
           "house-claude",
           payload.deployId
@@ -21763,7 +21831,7 @@ var HostAgentSupervisor = class {
         report("installing", "installing agent CLI");
         await this.runAgentInstall(payload.agentInstallScript);
       }
-      const home = process.env.HOME || os39.homedir();
+      const home = process.env.HOME || os40.homedir();
       childEnv.PATH = `${home}/.local/bin:${process.env.PATH ?? ""}`;
       if (payload.cloneToken) {
         try {
@@ -21797,7 +21865,7 @@ var HostAgentSupervisor = class {
       }
       if (payload.headroomEnabled && payload.headroomAgent && payload.headroomSavingsIngestUrl && isHeadroomSupportedAgent(payload.headroomAgent)) {
         report("headroom", "setting up Headroom proxy");
-        const freeBytes = await this.getFreeDisk(os39.homedir());
+        const freeBytes = await this.getFreeDisk(os40.homedir());
         const alreadyInstalled = this.isHeadroomInstalled();
         if (!alreadyInstalled && freeBytes !== null && freeBytes < HEADROOM_MIN_FREE_DISK_BYTES) {
           const freeGb = (freeBytes / 1e9).toFixed(1);
@@ -21856,7 +21924,7 @@ var HostAgentSupervisor = class {
       );
       if (!payload.suppressOnboardingWelcome) {
         try {
-          const cfgDir = childEnv.CLAUDE_CONFIG_DIR || path48.join(os39.homedir(), ".claude");
+          const cfgDir = childEnv.CLAUDE_CONFIG_DIR || path48.join(os40.homedir(), ".claude");
           const projectDir = path48.join(cfgDir, "projects", encodeCwd(cwd));
           const hasPriorConversation = fs45.existsSync(projectDir) && fs45.readdirSync(projectDir).some((f) => f.endsWith(".jsonl"));
           if (hasPriorConversation) {
@@ -22006,7 +22074,7 @@ var HostAgentSupervisor = class {
    */
   runAgentInstall(script) {
     return new Promise((resolve9) => {
-      const home = process.env.HOME || os39.homedir();
+      const home = process.env.HOME || os40.homedir();
       const child = (0, import_node_child_process25.spawn)("sh", ["-c", script], {
         env: { ...process.env, HOME: home },
         stdio: ["ignore", "pipe", "pipe"]
@@ -22095,7 +22163,7 @@ var HostAgentSupervisor = class {
     }
     const dirs = [
       path48.join(selfHostedWorkspaceRoot(), deployId),
-      path48.join(os39.homedir(), ".codeam", "house-claude", deployId)
+      path48.join(os40.homedir(), ".codeam", "house-claude", deployId)
     ];
     for (const dir of dirs) {
       try {
@@ -22237,7 +22305,7 @@ async function configureHeadroom(action, ctx, deps) {
 
 // src/services/headroom/budget-relaunch.ts
 var fs46 = __toESM(require("fs"));
-var os40 = __toESM(require("os"));
+var os41 = __toESM(require("os"));
 var path49 = __toESM(require("path"));
 var import_child_process13 = require("child_process");
 function amendDeploymentManifestBudget(manifest, budget) {
@@ -22349,7 +22417,7 @@ function spawnProxyReal2(_budget) {
   );
 }
 function makeRealApplyBudgetDeps() {
-  const homeDir2 = os40.homedir();
+  const homeDir2 = os41.homedir();
   return {
     findDeployments: () => findHeadroomDeployments(homeDir2, {
       readDir: (dir) => fs46.readdirSync(dir),
@@ -22362,15 +22430,138 @@ function makeRealApplyBudgetDeps() {
   };
 }
 
+// src/services/headroom/usage-report.ts
+var HOURLY_CAP = 48;
+var SERIES_CAP = {
+  hourly: HOURLY_CAP,
+  daily: 90,
+  weekly: 52,
+  monthly: 24
+};
+var REQUEST_TIMEOUT_MS2 = 5e3;
+async function fetchWithTimeout2(url2) {
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS2);
+  try {
+    return await fetch(url2, { signal: controller.signal });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function num(v) {
+  return typeof v === "number" && Number.isFinite(v) ? v : 0;
+}
+function totals(raw) {
+  const o = raw ?? {};
+  return {
+    requests: num(o.requests),
+    tokens_saved: num(o.tokens_saved),
+    compression_savings_usd: num(o.compression_savings_usd),
+    total_input_tokens: num(o.total_input_tokens),
+    total_input_cost_usd: num(o.total_input_cost_usd)
+  };
+}
+function slices(raw) {
+  const out2 = {};
+  if (typeof raw !== "object" || raw === null) return out2;
+  for (const [key, value] of Object.entries(raw)) {
+    const v = value ?? {};
+    out2[key] = {
+      tokens_saved: num(v.tokens_saved),
+      compression_savings_usd_delta: num(v.compression_savings_usd_delta),
+      total_input_tokens_delta: num(v.total_input_tokens_delta),
+      total_input_cost_usd_delta: num(v.total_input_cost_usd_delta)
+    };
+  }
+  return out2;
+}
+function bucket(raw) {
+  if (typeof raw !== "object" || raw === null) return null;
+  const o = raw;
+  if (typeof o.timestamp !== "string") return null;
+  return {
+    timestamp: o.timestamp,
+    tokens_saved: num(o.tokens_saved),
+    compression_savings_usd_delta: num(o.compression_savings_usd_delta),
+    total_tokens_saved: num(o.total_tokens_saved),
+    compression_savings_usd: num(o.compression_savings_usd),
+    total_input_tokens_delta: num(o.total_input_tokens_delta),
+    total_input_tokens: num(o.total_input_tokens),
+    total_input_cost_usd_delta: num(o.total_input_cost_usd_delta),
+    total_input_cost_usd: num(o.total_input_cost_usd),
+    by_provider: slices(o.by_provider),
+    by_model: slices(o.by_model)
+  };
+}
+function toUsageReport(raw, proxyVersion) {
+  const root = raw ?? {};
+  const rawSeries = root.series ?? {};
+  const series = {};
+  for (const key of Object.keys(SERIES_CAP)) {
+    const arr = rawSeries[key];
+    if (!Array.isArray(arr)) continue;
+    const kept = arr.slice(-SERIES_CAP[key]).map(bucket).filter((b) => b !== null);
+    if (kept.length > 0) series[key] = kept;
+  }
+  const displaySession = root.display_session ?? null;
+  const retention = root.retention ?? null;
+  const report = {
+    schemaVersion: num(root.schema_version),
+    generatedAt: typeof root.generated_at === "string" ? root.generated_at : (/* @__PURE__ */ new Date()).toISOString(),
+    lifetime: totals(root.lifetime),
+    series
+  };
+  if (proxyVersion) report.proxyVersion = proxyVersion;
+  if (displaySession) {
+    report.currentSession = {
+      ...totals(displaySession),
+      savings_percent: num(displaySession.savings_percent),
+      started_at: typeof displaySession.started_at === "string" ? displaySession.started_at : null,
+      last_activity_at: typeof displaySession.last_activity_at === "string" ? displaySession.last_activity_at : null
+    };
+  }
+  if (retention) {
+    report.retention = {
+      max_history_points: num(retention.max_history_points),
+      max_history_age_days: num(retention.max_history_age_days)
+    };
+  }
+  return report;
+}
+async function defaultFetchJson(url2) {
+  const res = await fetchWithTimeout2(url2);
+  if (!res.ok) throw new Error(`HTTP ${res.status}`);
+  return await res.json();
+}
+async function readUsageReport(deps = {}) {
+  const port = deps.port ?? HEADROOM_PROXY_PORT;
+  const base = `http://127.0.0.1:${port}`;
+  const get2 = deps.fetchJson ?? ((path89) => defaultFetchJson(`${base}${path89}`));
+  let history;
+  try {
+    history = await get2("/stats-history");
+  } catch (err) {
+    log.info("headroomUsage", `stats-history unavailable: ${err.message}`);
+    return null;
+  }
+  let proxyVersion;
+  try {
+    const health = await get2("/health");
+    if (health && typeof health.version === "string") proxyVersion = health.version;
+  } catch {
+  }
+  return toUsageReport(history, proxyVersion);
+}
+
 // src/agents/acp/guardrail-config.ts
 var fs47 = __toESM(require("fs"));
 var path50 = __toESM(require("path"));
-var os41 = __toESM(require("os"));
+var os42 = __toESM(require("os"));
 var current = null;
-function guardrailConfigPath(homeDir2 = os41.homedir()) {
+function guardrailConfigPath(homeDir2 = os42.homedir()) {
   return path50.join(homeDir2, ".codeam", "guardrails.json");
 }
-function loadGuardrailPolicy(homeDir2 = os41.homedir()) {
+function loadGuardrailPolicy(homeDir2 = os42.homedir()) {
   try {
     current = normalizeGuardrailPolicy(JSON.parse(fs47.readFileSync(guardrailConfigPath(homeDir2), "utf8")));
   } catch {
@@ -22378,10 +22569,10 @@ function loadGuardrailPolicy(homeDir2 = os41.homedir()) {
   }
   return current;
 }
-function getGuardrailPolicy(homeDir2 = os41.homedir()) {
+function getGuardrailPolicy(homeDir2 = os42.homedir()) {
   return current ?? loadGuardrailPolicy(homeDir2);
 }
-function setGuardrailPolicy(raw, homeDir2 = os41.homedir()) {
+function setGuardrailPolicy(raw, homeDir2 = os42.homedir()) {
   const next = normalizeGuardrailPolicy(raw);
   current = next;
   try {
@@ -22395,11 +22586,11 @@ function setGuardrailPolicy(raw, homeDir2 = os41.homedir()) {
 
 // src/services/preview/port-registry.ts
 var fs48 = __toESM(require("fs"));
-var os42 = __toESM(require("os"));
+var os43 = __toESM(require("os"));
 var path51 = __toESM(require("path"));
 var import_child_process14 = require("child_process");
 function registryPath() {
-  return path51.join(os42.homedir(), ".codeam", "preview-ports.json");
+  return path51.join(os43.homedir(), ".codeam", "preview-ports.json");
 }
 function readRegistry() {
   try {
@@ -23943,7 +24134,7 @@ async function establishTunnel(ctx, dev) {
 // src/beads/bd-adapter.ts
 var import_child_process20 = require("child_process");
 var fs57 = __toESM(require("fs"));
-var os44 = __toESM(require("os"));
+var os45 = __toESM(require("os"));
 var path60 = __toESM(require("path"));
 var BD_PACKAGE = "@beads/bd";
 function resolveBundledBdBinary() {
@@ -24061,7 +24252,7 @@ var BdAdapter = class {
     const env = { ...process.env };
     if (!env.HOME) {
       try {
-        const home = os44.homedir();
+        const home = os45.homedir();
         if (home) env.HOME = home;
       } catch {
       }
@@ -24154,7 +24345,7 @@ function coerceIssue(row, projectKey) {
 // src/beads/provisioner.ts
 var import_child_process23 = require("child_process");
 var fs59 = __toESM(require("fs"));
-var os46 = __toESM(require("os"));
+var os47 = __toESM(require("os"));
 var path62 = __toESM(require("path"));
 
 // src/beads/install-bd.ts
@@ -24221,7 +24412,7 @@ async function installBd(platform3 = process.platform) {
 // src/beads/install-dolt.ts
 var import_child_process22 = require("child_process");
 var fs58 = __toESM(require("fs"));
-var os45 = __toESM(require("os"));
+var os46 = __toESM(require("os"));
 var path61 = __toESM(require("path"));
 var DOLT_INSTALL_SH_URL = "https://github.com/dolthub/dolt/releases/latest/download/install.sh";
 var DOLT_MSI_URL = "https://github.com/dolthub/dolt/releases/latest/download/dolt-windows-amd64.msi";
@@ -24262,11 +24453,11 @@ function resolveDoltInstallStrategy(platform3) {
 }
 var DOLT_RELEASE_BASE = "https://github.com/dolthub/dolt/releases/latest/download";
 function doltPlatformTuple(platform3, arch2) {
-  const os63 = platform3 === "win32" ? "windows" : platform3 === "darwin" ? "darwin" : "linux";
+  const os64 = platform3 === "win32" ? "windows" : platform3 === "darwin" ? "darwin" : "linux";
   const a = arch2 === "x64" ? "amd64" : arch2 === "arm64" ? "arm64" : null;
   if (!a) return null;
-  if (os63 === "windows" && a !== "amd64") return null;
-  return `${os63}-${a}`;
+  if (os64 === "windows" && a !== "amd64") return null;
+  return `${os64}-${a}`;
 }
 function resolveDoltTarballStrategy(targetDir, platform3, arch2) {
   const tuple = doltPlatformTuple(platform3, arch2);
@@ -24311,7 +24502,7 @@ async function installDoltToDir(targetDir, platform3 = process.platform, arch2 =
   return result;
 }
 var _doltPathSeam = {
-  homedir: () => os45.homedir(),
+  homedir: () => os46.homedir(),
   getPath: () => process.env.PATH ?? "",
   setPath: (p2) => {
     process.env.PATH = p2;
@@ -24522,7 +24713,7 @@ var _provisionSeam = {
 };
 var _linkSeam = {
   platform: () => process.platform,
-  homedir: () => os46.homedir(),
+  homedir: () => os47.homedir(),
   isWritableDir: (dir) => {
     try {
       fs59.accessSync(dir, fs59.constants.W_OK);
@@ -25317,7 +25508,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 = path66.join(os50.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
+    const tmpPath = path66.join(os51.tmpdir(), `codeam-${(0, import_crypto3.randomUUID)()}-${safeName}`);
     fs62.writeFileSync(tmpPath, Buffer.from(base64, "base64"));
     pendingAttachmentFiles.add(tmpPath);
     return tmpPath;
@@ -25912,7 +26103,7 @@ var vcsAgentReviewH = async (ctx, cmd, parsed) => {
   });
   const token = ctx.pluginAuthToken;
   void (async () => {
-    const os63 = createOsStrategy();
+    const os64 = createOsStrategy();
     try {
       const report = await reviewPullRequest(
         {
@@ -25921,7 +26112,7 @@ var vcsAgentReviewH = async (ctx, cmd, parsed) => {
           baseBranch: parsed.baseBranch
         },
         {
-          runReview: (input) => new CoderabbitRuntimeStrategy(os63).runOneShot(input),
+          runReview: (input) => new CoderabbitRuntimeStrategy(os64).runOneShot(input),
           runGh: (args2) => defaultRunGh(args2),
           postReport: async (r) => {
             if (!token) return;
@@ -25943,6 +26134,24 @@ var vcsAgentReviewH = async (ctx, cmd, parsed) => {
     }
   })();
 };
+var headroomUsageH = async (ctx, cmd) => {
+  try {
+    const report = await readUsageReport();
+    if (!report) {
+      await ctx.relay.sendResult(cmd.id, "completed", {
+        available: false,
+        error: "Headroom is not running in this session."
+      });
+      return;
+    }
+    await ctx.relay.sendResult(cmd.id, "completed", { available: true, report });
+  } catch (err) {
+    await ctx.relay.sendResult(cmd.id, "completed", {
+      available: false,
+      error: err.message
+    });
+  }
+};
 var headroomBudgetH = async (ctx, cmd) => {
   const payload = cmd.payload;
   let rawAgentId = ctx.agentId || (typeof payload.agentId === "string" ? payload.agentId : "");
@@ -26116,13 +26325,13 @@ function resolveGlobalNodeModulesDir(opts) {
 var STALE_STAGING_AGE_MS = CLI_UPDATE_INSTALL_TIMEOUT_MS;
 function sweepStaleCliStagingDirs(nodeModulesDir, now = Date.now(), deps) {
   if (!nodeModulesDir) return 0;
-  const readdirSync14 = deps?.readdirSync ?? fs62.readdirSync;
+  const readdirSync15 = deps?.readdirSync ?? fs62.readdirSync;
   const statSync17 = deps?.statSync ?? fs62.statSync;
   const rmSync9 = deps?.rmSync ?? fs62.rmSync;
   let removed = 0;
   let entries;
   try {
-    entries = readdirSync14(nodeModulesDir);
+    entries = readdirSync15(nodeModulesDir);
   } catch {
     return 0;
   }
@@ -26731,6 +26940,7 @@ var handlers = {
   take_control: takeControlH,
   handback: handbackH,
   headroom_configure: headroomConfigureH,
+  headroom_usage: headroomUsageH,
   coderabbit_configure: coderabbitConfigureH,
   vcs_agent_review: vcsAgentReviewH,
   headroom_budget: headroomBudgetH,
@@ -27038,7 +27248,7 @@ async function claimOnce(token, pluginId, pluginSecretHash) {
     pluginId,
     ideName: "codeam-cli (codespace)",
     ideVersion: process.env.npm_package_version ?? "unknown",
-    hostname: os51.hostname(),
+    hostname: os52.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.
@@ -27099,7 +27309,7 @@ async function claim(token, pluginId, pluginSecretHash) {
   }
 }
 function pairAutoLockPath() {
-  return path67.join(os51.homedir(), ".codeam", "pair-auto.lock");
+  return path67.join(os52.homedir(), ".codeam", "pair-auto.lock");
 }
 function isLivePairAuto(pid) {
   if (!Number.isInteger(pid) || pid <= 0 || pid === process.pid) return false;
@@ -27119,7 +27329,7 @@ function isLiveCodeam(pid) {
 }
 function daemonLockPath(sessionId) {
   const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, "_");
-  return path67.join(os51.homedir(), ".codeam", `daemon-${safe}.lock`);
+  return path67.join(os52.homedir(), ".codeam", `daemon-${safe}.lock`);
 }
 function acquireDaemonLock(sessionId) {
   const lockPath = daemonLockPath(sessionId);
@@ -28070,7 +28280,7 @@ var import_node_crypto11 = require("crypto");
 // src/services/history.service.ts
 var fs65 = __toESM(require("fs"));
 var path70 = __toESM(require("path"));
-var os53 = __toESM(require("os"));
+var os54 = __toESM(require("os"));
 var https7 = __toESM(require("https"));
 var http6 = __toESM(require("http"));
 var import_zod2 = require("zod");
@@ -28238,7 +28448,7 @@ var HistoryService = class _HistoryService {
     return this._quotaPercent === null || Date.now() - this._quotaFetchedAt > ttlMs;
   }
   get projectDir() {
-    return this.runtime.resolveHistoryDir(this.cwd) ?? path70.join(os53.homedir(), ".claude", "projects", encodeCwd(this.cwd));
+    return this.runtime.resolveHistoryDir(this.cwd) ?? path70.join(os54.homedir(), ".claude", "projects", encodeCwd(this.cwd));
   }
   /** Set the current Claude conversation ID (extracted from /cost command or session start) */
   setCurrentConversationId(id) {
@@ -28666,7 +28876,7 @@ var HistoryService = class _HistoryService {
 var import_node_child_process29 = require("child_process");
 var fs66 = __toESM(require("fs/promises"));
 var fsSync = __toESM(require("fs"));
-var os55 = __toESM(require("os"));
+var os56 = __toESM(require("os"));
 var path72 = __toESM(require("path"));
 var import_node_stream = require("stream");
 
@@ -32694,7 +32904,7 @@ function createIdleTimeout(idleMs, makeError, activeIdleMs = idleMs) {
 
 // src/agents/acp/internal-paths.ts
 var path71 = __toESM(require("path"));
-var os54 = __toESM(require("os"));
+var os55 = __toESM(require("os"));
 var INTERNAL_TOKENS = [".codeam", "house-claude"];
 var SELF_HOSTED_WORKSPACE_RE = /\.codeam[/\\]self-hosted/gi;
 function textReferencesInternal(text) {
@@ -32702,7 +32912,7 @@ function textReferencesInternal(text) {
   const scrubbed = text.replace(SELF_HOSTED_WORKSPACE_RE, " ");
   return INTERNAL_TOKENS.some((t2) => scrubbed.includes(t2));
 }
-function pathIsInternal(p2, homeDir2 = os54.homedir()) {
+function pathIsInternal(p2, homeDir2 = os55.homedir()) {
   if (!p2) return false;
   const abs = path71.resolve(p2);
   const home = path71.resolve(homeDir2);
@@ -33750,7 +33960,7 @@ function applyLineRange(content, line, limit) {
   return { content: lines.slice(start2, end).join("\n") };
 }
 function knownAgentBinaryDirs() {
-  const home = os55.homedir();
+  const home = os56.homedir();
   const out2 = [];
   out2.push("/tmp/codeam-node20/bin");
   for (const root of [
@@ -34277,10 +34487,10 @@ function commonPrefixLength(a, b) {
 // src/agents/acp/onboarding.ts
 var import_child_process27 = require("child_process");
 var fs67 = __toESM(require("fs"));
-var os56 = __toESM(require("os"));
+var os57 = __toESM(require("os"));
 var path73 = __toESM(require("path"));
 var _onboardingSeam = {
-  markerPath: (sessionId) => path73.join(os56.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
+  markerPath: (sessionId) => path73.join(os57.homedir(), ".codeam", "welcomed", `${sessionId}.done`),
   exists: (p2) => fs67.existsSync(p2),
   write: (p2) => {
     fs67.mkdirSync(path73.dirname(p2), { recursive: true });
@@ -36154,8 +36364,8 @@ function buildAcpPromptBlocks(payload) {
 // src/agents/agent-standard.ts
 var fs74 = __toESM(require("fs"));
 var path80 = __toESM(require("path"));
-var os57 = __toESM(require("os"));
-function ensureAgentStandard(homeDir2 = os57.homedir()) {
+var os58 = __toESM(require("os"));
+function ensureAgentStandard(homeDir2 = os58.homedir()) {
   try {
     const file = path80.join(homeDir2, ".claude", "CLAUDE.md");
     let existing = "";
@@ -36176,7 +36386,7 @@ ${AGENT_STANDARD_BLOCK}
 }
 var _agentStandardSeam = {
   isLocalSession: () => isLocalSession(),
-  markerPath: (sessionId) => path80.join(os57.homedir(), ".codeam", "agent-standard", `${sessionId}.done`),
+  markerPath: (sessionId) => path80.join(os58.homedir(), ".codeam", "agent-standard", `${sessionId}.done`),
   exists: (p2) => fs74.existsSync(p2),
   write: (p2) => {
     fs74.mkdirSync(path80.dirname(p2), { recursive: true });
@@ -38851,7 +39061,7 @@ function startClaudeCredentialSync(opts) {
 // src/beads/workflow-hint.ts
 var fs75 = __toESM(require("fs"));
 var path81 = __toESM(require("path"));
-var os58 = __toESM(require("os"));
+var os59 = __toESM(require("os"));
 var BEADS_HINT_MARKER = "<!-- codeam:beads-workflow -->";
 var BEADS_HINT = `${BEADS_HINT_MARKER}
 # Beads (bd) \u2014 task tracking + persistent memory (ALWAYS use it)
@@ -38865,7 +39075,7 @@ This environment uses **bd (beads)** for issue/task tracking and persistent memo
 - \`bd ready\` (available work) \xB7 \`bd show <id>\` \xB7 \`bd update <id> --claim\` \xB7 \`bd close <id>\`.
 - Use \`bd remember "..."\` for persistent knowledge \u2014 do NOT use MEMORY.md files.
 ${BEADS_HINT_MARKER}`;
-function ensureBeadsWorkflowHint(homeDir2 = os58.homedir()) {
+function ensureBeadsWorkflowHint(homeDir2 = os59.homedir()) {
   try {
     const file = path81.join(homeDir2, ".claude", "CLAUDE.md");
     let existing = "";
@@ -39618,12 +39828,12 @@ function keepDeviceAwake(deps = {}) {
 
 // src/agents/claude/onboarding.ts
 var fs77 = __toESM(require("fs"));
-var os60 = __toESM(require("os"));
+var os61 = __toESM(require("os"));
 var path82 = __toESM(require("path"));
 var ONBOARDING_VERSION_SENTINEL = "9999.0.0";
 function ensureClaudeOnboarded(cwd) {
   try {
-    const file = path82.join(os60.homedir(), ".claude.json");
+    const file = path82.join(os61.homedir(), ".claude.json");
     let config = {};
     try {
       config = JSON.parse(fs77.readFileSync(file, "utf8"));
@@ -42532,9 +42742,9 @@ function checkSessions() {
   }
 }
 function checkAgentBinaries() {
-  const os63 = createOsStrategy();
+  const os64 = createOsStrategy();
   return getEnabledAgents().map((meta) => {
-    const found = os63.findInPath(meta.binaryName);
+    const found = os64.findInPath(meta.binaryName);
     return {
       id: `agent-${meta.id}`,
       label: `Agent binary: ${meta.displayName} (${meta.binaryName})`,
@@ -42598,7 +42808,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.61.98" : "0.0.0-dev";
+  const cliVersion = true ? "2.62.0" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -42989,7 +43199,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.61.98" : "unknown";
+  const v = true ? "2.62.0" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 
@@ -43138,10 +43348,10 @@ var EXIT_CODE_NAMES = {
 };
 
 // src/index.ts
-var os62 = __toESM(require("os"));
+var os63 = __toESM(require("os"));
 if (!process.env.HOME) {
   try {
-    const home = os62.homedir();
+    const home = os63.homedir();
     if (home) process.env.HOME = home;
   } catch {
   }