codeam-cli 2.65.10 → 2.65.11

package/dist/index.js

@@ -8079,7 +8079,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.65.10" : "0.0.0-dev",
+    cliVersion: true ? "2.65.11" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8321,7 +8321,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.65.10",
+  version: "2.65.11",
   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",
@@ -9542,12 +9542,30 @@ var CommandRelayService = class _CommandRelayService {
       this.connectSSE();
     }
   }
+  /**
+   * Stop the relay. Kept SYNCHRONOUS for the many callers that just tear down
+   * — the goodbye heartbeat is fired but NOT awaited here.
+   *
+   * ⚠️ On a shutdown path that calls `process.exit()` right after, use
+   * {@link stopAndFlush} (or {@link stopRelayWithGoodbye}) instead: the process
+   * dies before the fire-and-forget POST hits the wire, so the backend never
+   * learns the CLI went away and mobile keeps showing the session ONLINE until
+   * the 30 s Redis heartbeat key expires — silently, since nothing publishes on
+   * expiry (the 2026-08-18 "closing Claude Code leaves mobile online" report).
+   */
   stop() {
+    void this.stopAndFlush();
+  }
+  /**
+   * Same teardown as {@link stop}, but resolves only once the `online:false`
+   * heartbeat POST has settled — so a caller can `await` it before exiting.
+   * Never rejects (`sendHeartbeat` swallows its own transport errors).
+   */
+  async stopAndFlush() {
     if (!this._running) return;
     this._running = false;
     this.cleanup();
-    this.sendHeartbeat(false).catch(() => {
-    });
+    await this.sendHeartbeat(false);
   }
   async sendResult(commandId, status2, result) {
     if (this.pairingInvalid) return;
@@ -9824,7 +9842,7 @@ var CommandRelayService = class _CommandRelayService {
       // fresh + clear the "CLI update available" banner after a self-update
       // (a codespace that reinstalls @latest reconnects via heartbeat, not
       // pair/reconnect). Older backends ignore the extra field.
-      ..."2.65.10" ? { ideVersion: "2.65.10" } : {}
+      ..."2.65.11" ? { ideVersion: "2.65.11" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -9905,6 +9923,21 @@ var CommandRelayService = class _CommandRelayService {
     }
   }
 };
+var RELAY_GOODBYE_TIMEOUT_MS = 1500;
+async function stopRelayWithGoodbye(relay, timeoutMs = RELAY_GOODBYE_TIMEOUT_MS) {
+  let timer;
+  try {
+    await Promise.race([
+      relay.stopAndFlush(),
+      new Promise((resolve10) => {
+        timer = setTimeout(resolve10, timeoutMs);
+      })
+    ]);
+  } catch {
+  } finally {
+    if (timer) clearTimeout(timer);
+  }
+}
 
 // src/services/file-watcher.service.ts
 var import_child_process4 = require("child_process");
@@ -21753,7 +21786,7 @@ async function autoUpgradeBeforeCriticalCommand() {
   if (process.env.NODE_ENV === "test") return;
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
-  const current2 = true ? "2.65.10" : null;
+  const current2 = true ? "2.65.11" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -21770,7 +21803,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current2 = true ? "2.65.10" : null;
+  const current2 = true ? "2.65.11" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -21790,7 +21823,7 @@ var SELF_UPDATE_INTERVAL_MS = 60 * 60 * 1e3;
 var SELF_UPDATE_VIEW_TIMEOUT_MS = 3e4;
 var SELF_UPDATE_INSTALL_TIMEOUT_MS = 18e4;
 function currentCliVersion() {
-  return true ? "2.65.10" : null;
+  return true ? "2.65.11" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve10) => {
@@ -26585,7 +26618,7 @@ var sessionTerminated = async (ctx, cmd) => {
   } catch {
   }
   ctx.outputSvc.dispose();
-  ctx.relay.stop();
+  await stopRelayWithGoodbye(ctx.relay);
   process.exit(0);
 };
 var shutdownSession = async (ctx, cmd) => {
@@ -26614,7 +26647,7 @@ var shutdownSession = async (ctx, cmd) => {
   } catch {
   }
   ctx.outputSvc.dispose();
-  ctx.relay.stop();
+  await stopRelayWithGoodbye(ctx.relay);
   process.exit(0);
 };
 var showInstallCommand = async (ctx, cmd, parsed) => {
@@ -33869,6 +33902,7 @@ var _acpStartSeam = {
 var PROTOCOL_VERSION3 = 1;
 var FATAL_STARTUP_RE = /IneligibleTierError|UNSUPPORTED_CLIENT|no longer supported for Gemini Code Assist|not eligible for Gemini Code Assist|Error authenticating|ProjectIdRequiredError/i;
 var NEWSESSION_TIMEOUT_MS = 12e4;
+var LOADSESSION_TIMEOUT_MS = 6e4;
 var PROMPT_IDLE_TIMEOUT_MS = 9e4;
 var PROMPT_ACTIVE_IDLE_TIMEOUT_MS = 6e5;
 var CLIENT_CAPABILITIES = {
@@ -34383,13 +34417,30 @@ var AcpClient = class {
     log.info("acpClient", `loadSession \u2192 sessionId=${sessionId.slice(0, 8)}`);
     this.opts.beginLoadReplay?.();
     let loaded;
+    let loadTimer;
     try {
-      loaded = await this.connection.loadSession({
-        sessionId,
-        cwd: this.opts.cwd,
-        mcpServers: this.opts.mcpServers ?? []
-      });
+      loaded = await Promise.race([
+        this.connection.loadSession({
+          sessionId,
+          cwd: this.opts.cwd,
+          mcpServers: this.opts.mcpServers ?? []
+        }),
+        new Promise((_2, reject) => {
+          loadTimer = setTimeout(() => {
+            const tail = this.recentStderr.slice(-4).join(" | ");
+            reject(
+              new Error(
+                `ACP_LOAD_SESSION_TIMEOUT: ${this.opts.adapter.requiresAgentBinary} did not answer session/load for ${sessionId.slice(
+                  0,
+                  8
+                )} within ${Math.round(LOADSESSION_TIMEOUT_MS / 1e3)}s${tail ? ` \u2014 last output: ${tail}` : ""}`
+              )
+            );
+          }, LOADSESSION_TIMEOUT_MS);
+        })
+      ]);
     } finally {
+      if (loadTimer) clearTimeout(loadTimer);
       this.opts.endLoadReplay?.();
     }
     this.sessionId = sessionId;
@@ -38676,7 +38727,7 @@ async function sessionShutdownH(ctx) {
     } catch {
     }
   }
-  relay.stop();
+  await stopRelayWithGoodbye(relay);
   closeAllTerminals();
   await client3.stop();
   process.exit(0);
@@ -39975,7 +40026,7 @@ async function runAcpSession(opts) {
   const shutdown = async (signal) => {
     showInfo(`Shutting down ACP session (${signal})\u2026`);
     clearTimeout(prewarmTimer);
-    relay.stop();
+    await stopRelayWithGoodbye(relay);
     void fileWatcher.stop();
     turnFiles.stop();
     closeAllTerminals();
@@ -40444,7 +40495,27 @@ var OutputService = class _OutputService {
       ...lines.slice(banner.endIdx + 1)
     ];
   }
+  /**
+   * Mute/unmute the CHAT-output publish path. Every frame this service would
+   * emit (clear / user_message / new_turn / text / chrome_steps / selectors /
+   * banner / input_suggestion) is dropped while muted; `push()` and the tick
+   * still run, so the detection side-effects (session id, rate limit,
+   * terminal-turn gate) are untouched.
+   *
+   * ⚠️ The one caller is the baton's {@link NativeTuiDriver}: while LOCAL_DRIVE
+   * holds the baton, the mobile view is the read-only TRANSCRIPT mirror, never
+   * a screen-scrape — piping the native TUI's PTY bytes through here published
+   * raw Claude Code chrome (box-drawing rules, `❯`, "auto mode on (shift+tab to
+   * cycle) · esc to interrupt") into the chat as if it were agent output.
+   * Terminal-panel frames (`sendTerminalChunk`/`sendTerminalExit`) go straight
+   * to the emitter and are deliberately NOT affected.
+   */
+  setPublishSuppressed(suppressed) {
+    this.publishSuppressed = suppressed;
+  }
+  publishSuppressed = false;
   async send(body, opts = {}) {
+    if (this.publishSuppressed) return;
     const outcome = await this.emitter.send(body, opts);
     if (outcome.dead && this.pty.isActive) {
       this.dispose();
@@ -41135,11 +41206,18 @@ function provisionSkillsForStart(home = import_node_os13.default.homedir()) {
 }
 
 // src/baton/baton-controller.ts
-var BatonController = class {
+var BatonController = class _BatonController {
   constructor(deps) {
     this.deps = deps;
   }
   deps;
+  /**
+   * Default upper bound on a whole hand-off. A cold `newSession` on claude is
+   * ~20 s, so 45 s leaves generous headroom for a healthy switch while still
+   * failing FAST enough that the user gets an honest error instead of a
+   * permanent "Switching…".
+   */
+  static DEFAULT_SWITCH_TIMEOUT_MS = 45e3;
   _state = "LOCAL_DRIVE";
   _active = "local_tui";
   _conversationId = null;
@@ -41216,24 +41294,79 @@ var BatonController = class {
     this.setState("SWITCHING");
     const priorActive = this._active;
     const priorConversationId = this._conversationId;
-    try {
+    const timeoutMs = this.deps.switchTimeoutMs ?? _BatonController.DEFAULT_SWITCH_TIMEOUT_MS;
+    let stoppedCurrent = false;
+    const handoff = (async () => {
       await current2.whenSafeToYield();
       await current2.stop();
-      this._conversationId = await next.start(this._conversationId ?? void 0);
+      stoppedCurrent = true;
+      return next.start(priorConversationId ?? void 0);
+    })();
+    handoff.catch(() => void 0);
+    try {
+      const conversationId = await withDeadline(
+        handoff,
+        timeoutMs,
+        `BATON_SWITCH_TIMEOUT: ${from} \u2192 ${to} hand-off did not complete within ${Math.round(
+          timeoutMs / 1e3
+        )}s`
+      );
+      this._conversationId = conversationId;
       this._active = nextKind;
       this.setState(to);
     } catch (err) {
+      await this.recoverFromFailedSwitch(
+        current2,
+        next,
+        stoppedCurrent,
+        priorConversationId,
+        timeoutMs
+      );
       this._active = priorActive;
-      this._conversationId = priorConversationId;
       this.setState(from);
       throw err;
     }
   }
+  /**
+   * Undo a half-done hand-off. The `next` driver may still be starting behind
+   * the deadline — stop it so a second adapter/PTY can't race the revived one.
+   * And when `current` was ALREADY stopped before the failure, reverting only
+   * the STATE would leave the user staring at a dead terminal (or mobile at a
+   * dead adapter), so bring it back on the same conversation. Both best-effort
+   * and bounded: recovery must never itself hang the controller.
+   */
+  async recoverFromFailedSwitch(current2, next, stoppedCurrent, priorConversationId, timeoutMs) {
+    this._conversationId = priorConversationId;
+    await withDeadline(next.stop(), timeoutMs, "BATON_RECOVERY_STOP_TIMEOUT").catch(
+      () => void 0
+    );
+    if (!stoppedCurrent) return;
+    try {
+      const revived = await withDeadline(
+        current2.start(priorConversationId ?? void 0),
+        timeoutMs,
+        "BATON_RECOVERY_START_TIMEOUT"
+      );
+      if (revived) this._conversationId = revived;
+    } catch {
+    }
+  }
   setState(state) {
     this._state = state;
     this.deps.publishState(state, this._active, this._conversationId);
   }
 };
+function withDeadline(promise, ms, message) {
+  let timer;
+  return Promise.race([
+    promise,
+    new Promise((_2, reject) => {
+      timer = setTimeout(() => reject(new Error(message)), ms);
+    })
+  ]).finally(() => {
+    if (timer) clearTimeout(timer);
+  });
+}
 
 // src/baton/terminal.ts
 var TUI_MODE_RESET = "\x1B[?1004l\x1B[?2004l\x1B[?1000l\x1B[?1002l\x1B[?1003l\x1B[?1006l\x1B[?25h";
@@ -41271,6 +41404,7 @@ var NativeTuiDriver = class _NativeTuiDriver {
       deps.opts.pluginAuthToken,
       deps.runtime
     );
+    this.outputSvc.setPublishSuppressed(true);
     this.keepAliveCtx = { inCodespace: false, codespaceName: void 0 };
     this.setKeepAlive = buildKeepAlive(this.keepAliveCtx).apply;
   }
@@ -41375,10 +41509,17 @@ var AcpDriver = class {
   session = null;
   budgetReachedPosted = false;
   async start(resumeId) {
+    const resumable = resumeId !== void 0 && this.hasTranscript(resumeId);
+    if (resumeId !== void 0 && !resumable) {
+      log.info(
+        "batonAcp",
+        `resume id ${resumeId.slice(0, 8)} has no transcript on disk (zero turns yet) \u2014 starting a fresh ACP session instead of session/load`
+      );
+    }
     let started;
     try {
       started = await this.deps.client.start();
-      if (resumeId !== void 0) {
+      if (resumable && resumeId !== void 0) {
         await this.deps.runtime.syncTranscriptForAcpResume?.(this.deps.opts.cwd, resumeId);
         this.deps.streaming.beginLoadReplay();
         try {
@@ -41391,13 +41532,30 @@ var AcpDriver = class {
       await this.deps.client.stop().catch(() => void 0);
       throw err;
     }
-    const conversationId = resumeId !== void 0 ? resumeId : started.sessionId;
+    const conversationId = resumable && resumeId !== void 0 ? resumeId : started.sessionId;
     this.acpSessionId = conversationId;
     this.agentCaps = started.initialize.agentCapabilities;
     this.session = null;
     this.budgetReachedPosted = false;
     return conversationId;
   }
+  /**
+   * Does the agent's own on-disk transcript for `conversationId` exist yet?
+   * `resolveHistoryFile` returns null when the file isn't there (every baton
+   * runtime `existsSync`-checks), which is exactly "the native TUI has run zero
+   * turns on this id" — the only case where `session/load` has nothing to load.
+   * A runtime without the hook can't be a baton runtime (see `gate.ts`), but if
+   * one ever is, assume resumable so behaviour is unchanged.
+   */
+  hasTranscript(conversationId) {
+    const resolve10 = this.deps.runtime.resolveHistoryFile;
+    if (typeof resolve10 !== "function") return true;
+    try {
+      return resolve10.call(this.deps.runtime, this.deps.opts.cwd, conversationId) !== null;
+    } catch {
+      return true;
+    }
+  }
   async stop() {
     await this.deps.client.stop();
     this.acpSessionId = null;
@@ -41732,8 +41890,7 @@ async function runBatonSession(opts) {
       nativeDriver.handlePtyData(raw);
     },
     onExit(code) {
-      teardown();
-      process.exit(code);
+      void teardown().finally(() => process.exit(code));
     }
   });
   nativeDriver = new NativeTuiDriver({
@@ -41813,19 +41970,18 @@ async function runBatonSession(opts) {
       publish: publishBatonState
     })
   );
-  function teardown() {
+  async function teardown() {
     if (torn) return;
     torn = true;
     process.removeListener("SIGINT", onSignal);
     process.removeListener("SIGTERM", onSignal);
     process.removeListener("SIGHUP", onSignal);
     mirror?.stop();
-    relay.stop();
     void controller.shutdown();
+    await stopRelayWithGoodbye(relay);
   }
   const onSignal = () => {
-    teardown();
-    process.exit(0);
+    void teardown().finally(() => process.exit(0));
   };
   process.once("SIGINT", onSignal);
   process.once("SIGTERM", onSignal);
@@ -42212,12 +42368,12 @@ async function start(requestedAgent, presetSession) {
         outputSvc.push(raw);
         streamingEmitter?.push(raw);
       },
-      onExit(code) {
+      async onExit(code) {
         process.removeListener("SIGINT", sigintHandler);
         process.removeListener("SIGTERM", sigintHandler);
         process.removeListener("SIGHUP", sigintHandler);
         outputSvc.dispose();
-        relay.stop();
+        await stopRelayWithGoodbye(relay);
         void fileWatcher?.stop();
         turnFiles?.stop();
         void beads?.watcher.stop();
@@ -42272,7 +42428,7 @@ async function start(requestedAgent, presetSession) {
     shuttingDown = true;
     agent.kill();
     outputSvc.dispose();
-    relay.stop();
+    await stopRelayWithGoodbye(relay);
     void fileWatcher?.stop();
     void beads?.watcher.stop();
     void streamingEmitter?.stop();
@@ -44868,7 +45024,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.65.10" : "0.0.0-dev";
+  const cliVersion = true ? "2.65.11" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -45259,7 +45415,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.65.10" : "unknown";
+  const v = true ? "2.65.11" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 

package/package.json

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