codeam-cli 2.75.7 → 2.75.8

package/CHANGELOG.md

@@ -4,6 +4,13 @@ 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.75.7] — 2026-09-19
+
+### Fixed
+
+- **cli:** Strip the retired Headroom proxy from ~/.claude/settings.json on start
+- **cli:** Log.info takes (tag, msg) — caught by CI typecheck
+
 ## [2.75.6] — 2026-09-17
 
 ### CI

package/dist/index.js

@@ -10344,7 +10344,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.75.7" : "0.0.0-dev",
+    cliVersion: true ? "2.75.8" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -10586,7 +10586,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.75.7",
+  version: "2.75.8",
   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",
@@ -11384,6 +11384,9 @@ var streamHost = new StreamHostSelector(
 );
 
 // src/services/command-relay.service.ts
+function isRecord2(v) {
+  return typeof v === "object" && v !== null;
+}
 function httpStatusOf(err) {
   if (typeof err === "object" && err !== null && "statusCode" in err) {
     const status2 = err.statusCode;
@@ -11394,6 +11397,8 @@ function httpStatusOf(err) {
 var API_BASE2 = resolveApiBaseUrl();
 var PENDING_STREAM_PATH = "/api/commands/pending/stream";
 var SSE_LIVENESS_TIMEOUT_MS = 45e3;
+var HEARTBEAT_RETRY_MS = 3e3;
+var HEARTBEAT_WARN_INTERVAL_MS = 6e4;
 var SSE_WATCHDOG_INTERVAL_MS = 1e4;
 var CommandRelayService = class _CommandRelayService {
   constructor(pluginId, onCommand, agentMeta, agentsOverride, explicitPollSecret, onHeartbeat) {
@@ -11412,6 +11417,18 @@ var CommandRelayService = class _CommandRelayService {
   onHeartbeat;
   _running = false;
   pairingInvalid = false;
+  /**
+   * Heartbeat health. Before 2026-09-23 a failed heartbeat was a `log.trace`,
+   * i.e. INVISIBLE in a normal `~/.codeam/debug-*.log` — a user whose beats
+   * never reached the origin (every other request did) spent a day on "Server
+   * Failed to Start" with nothing in his log to show for it. Failures are now
+   * WARN (rate-limited per streak) + a PostHog event, and the process exits
+   * when the backend answers `paired:false`.
+   */
+  heartbeatFailStreak = 0;
+  heartbeatLastWarnAt = 0;
+  sessionGone = false;
+  onSessionGone;
   heartbeatTimer = null;
   agentsTimer = null;
   /** Injectable for tests; defaults to real fs/fetch/spawn wiring. */
@@ -11530,6 +11547,17 @@ var CommandRelayService = class _CommandRelayService {
   stop() {
     void this.stopAndFlush();
   }
+  /**
+   * Called ONCE when a heartbeat answers `paired:false` — the backend no longer
+   * has a live session for this pluginId (deleted / disconnected from the
+   * app). The relay has already stopped itself by then; the owner should exit
+   * the process like a Ctrl-C would. Backstop for a process whose
+   * `session_terminated` command was consumed by a sibling on the same
+   * pluginId (two `codeam start` on one saved session, 2026-09-23).
+   */
+  setOnSessionGone(cb) {
+    this.onSessionGone = cb;
+  }
   /**
    * Same teardown as {@link stop}, but resolves only once the `online:false`
    * heartbeat POST has settled — so a caller can `await` it before exiting.
@@ -11877,8 +11905,9 @@ var CommandRelayService = class _CommandRelayService {
     });
   }
   // ─── Heartbeat + agents ──────────────────────────────────────────
-  async sendHeartbeat(online) {
-    await _postJson(`${API_BASE2}/api/plugin/heartbeat`, {
+  async sendHeartbeat(online, attempt = 0) {
+    if (this.sessionGone && online) return;
+    const body = {
       pluginId: this.pluginId,
       online,
       agentId: this.agentMeta.id,
@@ -11887,8 +11916,58 @@ 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.75.7" ? { ideVersion: "2.75.7" } : {}
-    }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
+      ..."2.75.8" ? { ideVersion: "2.75.8" } : {}
+    };
+    try {
+      const res = await _postJson(`${API_BASE2}/api/plugin/heartbeat`, body);
+      this.heartbeatFailStreak = 0;
+      log.trace("relay", `heartbeat ok online=${online}`);
+      const data = res?.data;
+      if (online && isRecord2(data) && data.paired === false) this.handleSessionGone();
+    } catch (err) {
+      if (!online) {
+        log.trace("relay", "goodbye heartbeat failed", err);
+        return;
+      }
+      this.heartbeatFailStreak += 1;
+      this.noteHeartbeatFailure(err);
+      if (attempt === 0 && this._running) {
+        const t2 = setTimeout(() => {
+          void this.sendHeartbeat(true, 1);
+        }, HEARTBEAT_RETRY_MS);
+        t2.unref?.();
+      }
+    }
+  }
+  noteHeartbeatFailure(err) {
+    const status2 = httpStatusOf(err);
+    const code = err?.code;
+    const reason = status2 ? `status_${status2}` : typeof code === "string" ? code : (err instanceof Error ? err.message : String(err)).slice(0, 80);
+    const now = Date.now();
+    const firstOfStreak = this.heartbeatFailStreak === 1;
+    if (!firstOfStreak && now - this.heartbeatLastWarnAt < HEARTBEAT_WARN_INTERVAL_MS) return;
+    this.heartbeatLastWarnAt = now;
+    log.warn(
+      "relay",
+      `heartbeat failed (${reason}, streak=${this.heartbeatFailStreak}) \u2014 two misses in a row and the app shows this session OFFLINE even though it is running`
+    );
+    capture("heartbeat_failed", {
+      pluginId: this.pluginId,
+      agentId: this.agentMeta.id,
+      reason,
+      streak: this.heartbeatFailStreak
+    });
+  }
+  handleSessionGone() {
+    if (this.sessionGone) return;
+    log.warn("relay", "backend reports this session no longer exists (paired:false) \u2014 stopping");
+    capture("session_gone_detected", { pluginId: this.pluginId, agentId: this.agentMeta.id });
+    process.stderr.write(
+      "[codeam] This session was deleted or disconnected from the app \u2014 exiting. Run `codeam pair` to start a new one.\n"
+    );
+    this.stop();
+    this.sessionGone = true;
+    this.onSessionGone?.();
   }
   /**
    * Refresh {@link cachedBranch} without blocking the event loop.
@@ -31218,14 +31297,14 @@ var zGuardCreateElicitationResponseCancel = z7.object({
 
 // ../../node_modules/@agentclientprotocol/sdk/dist/jsonrpc.js
 var CANCEL_REQUEST_METHOD = "$/cancel_request";
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null;
 }
 function isJsonRpcId(value) {
   return value === null || typeof value === "string" || typeof value === "number" && Number.isFinite(value);
 }
 function cancelRequestId(params) {
-  if (!isRecord2(params) || !isJsonRpcId(params["requestId"])) {
+  if (!isRecord3(params) || !isJsonRpcId(params["requestId"])) {
     return void 0;
   }
   return params["requestId"];
@@ -31657,7 +31736,7 @@ var Connection = class {
     if (this.abortController.signal.aborted) {
       return;
     }
-    if (!isRecord2(message)) {
+    if (!isRecord3(message)) {
       console.error("Invalid message", { message });
       return;
     }
@@ -31750,7 +31829,7 @@ var Connection = class {
       pendingResponse.cleanup?.();
       if ("result" in response) {
         pendingResponse.resolve(response.result);
-      } else if ("error" in response && isRecord2(response.error)) {
+      } else if ("error" in response && isRecord3(response.error)) {
         const { code, message, data } = response.error;
         pendingResponse.reject(new RequestError(code, message, data));
       } else {
@@ -32023,7 +32102,7 @@ function ndJsonStream(output, input) {
         if (trimmedLine) {
           try {
             const message = JSON.parse(trimmedLine);
-            if (isRecord2(message)) {
+            if (isRecord3(message)) {
               controller.enqueue(message);
             } else {
               console.warn("Skipping JSON line that is not an object:", trimmedLine);
@@ -40600,6 +40679,7 @@ async function runAcpSession(opts) {
   };
   process.once("SIGINT", () => void shutdown("SIGINT"));
   process.once("SIGTERM", () => void shutdown("SIGTERM"));
+  relay.setOnSessionGone(() => void shutdown("SIGTERM"));
   process.once("SIGHUP", () => void shutdown("SIGHUP"));
   await new Promise(() => {
   });
@@ -42730,6 +42810,7 @@ async function runBatonSession(opts) {
   process.once("SIGINT", onSignal);
   process.once("SIGTERM", onSignal);
   process.once("SIGHUP", onSignal);
+  relay.setOnSessionGone(onSignal);
   showInfo(`Starting ${opts.agent} baton (local) \u2014 native TUI + mobile take-control\u2026`);
   await controller.begin();
   relay.start();
@@ -43170,6 +43251,9 @@ async function start(requestedAgent, presetSession) {
     })
   );
   ctx.relay = relay;
+  relay.setOnSessionGone(() => {
+    void sigintHandler();
+  });
   void beadsReady.then((started) => {
     ctx.beads = started;
   });
@@ -46422,7 +46506,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.75.7" : null;
+  const current2 = true ? "2.75.8" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -46439,7 +46523,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.75.7" : null;
+  const current2 = true ? "2.75.8" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -46462,7 +46546,7 @@ var SELF_UPDATE_INSTALL_TIMEOUT_MS = 18e4;
 var SELF_UPDATE_LS_TIMEOUT_MS = 15e3;
 var SUDO_PREFLIGHT_TIMEOUT_MS = 5e3;
 function currentCliVersion() {
-  return true ? "2.75.7" : null;
+  return true ? "2.75.8" : null;
 }
 async function installedVersion(deps) {
   const ls = await deps.run(
@@ -48202,7 +48286,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.75.7" : "0.0.0-dev";
+  const cliVersion = true ? "2.75.8" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto12.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -48726,7 +48810,7 @@ async function mcpWarm(argv = [], opts = {}) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.75.7" : "unknown";
+  const v = true ? "2.75.8" : "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.75.7",
+  "version": "2.75.8",
   "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",