codeam-cli 2.65.11 → 2.65.12

package/CHANGELOG.md

@@ -4,6 +4,42 @@ All notable changes to `codeam-cli` are documented here.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.65.11] — 2026-08-19
+
+### Documentation
+
+- **cli:** Record the 2026-08-18 baton hand-off + goodbye-heartbeat invariants
+
+### Fixed
+
+- **cli:** Take-control never wedges on "Switching…" again
+- **cli:** Say goodbye before exiting so mobile stops showing ONLINE
+- **cli:** LOCAL_DRIVE mirrors the transcript only — no raw TUI bytes to mobile
+
+### Tests
+
+- **cli:** Real baton local integration test (take-control before first turn, handback, goodbye heartbeat)
+
+## [2.65.10] — 2026-08-19
+
+### Fixed
+
+- **cli:** Codespace sessions report the user's repo, not the shared wrapper hostname
+- **cli:** Dedupe the native ACP model list and validate model/tier at the wire boundary
+- **cli:** Welcome card greets first-time users correctly and never shows a raw internal path
+
+## [2.65.9] — 2026-08-19
+
+### Fixed
+
+- **cli:** Report an ineligible-tier credential to the backend on startup failure
+
+## [2.65.8] — 2026-08-18
+
+### Fixed
+
+- **cli:** Baton re-affirms its state on the relay heartbeat so the 1h backend snapshot never expires under a live session
+
 ## [2.65.7] — 2026-08-15
 
 ### Fixed

package/dist/index.js

@@ -8079,7 +8079,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.65.11" : "0.0.0-dev",
+    cliVersion: true ? "2.65.12" : "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.11",
+  version: "2.65.12",
   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",
@@ -9842,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.11" ? { ideVersion: "2.65.11" } : {}
+      ..."2.65.12" ? { ideVersion: "2.65.12" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -15283,6 +15283,7 @@ function parseHistoryFile(filePath) {
     if (!msg) continue;
     const text = extractText(msg["content"]).trim();
     if (!text) continue;
+    if (type === "user" && isLocalCommandEcho(text)) continue;
     const ts = r["timestamp"];
     const timestamp = typeof ts === "string" ? ts : typeof ts === "number" ? new Date(ts).toISOString() : (/* @__PURE__ */ new Date()).toISOString();
     const uuid = typeof r["uuid"] === "string" ? r["uuid"] : `${Date.now()}-${Math.random()}`;
@@ -15347,6 +15348,175 @@ function listResumableSessions(cwd) {
   out2.sort((a, b) => b.timestamp - a.timestamp);
   return out2;
 }
+function isLocalCommandEcho(text) {
+  return /^\s*<(command-name|local-command-[a-z]+)>/.test(text);
+}
+var CLEAR_COMMAND_ECHO = "<command-name>/clear</command-name>";
+var SWITCH_PROBE_BYTES = 256 * 1024;
+function isClearedConversationFile(filePath) {
+  let fd;
+  try {
+    fd = fs17.openSync(filePath, "r");
+  } catch {
+    return false;
+  }
+  let raw;
+  try {
+    const buf = Buffer.alloc(SWITCH_PROBE_BYTES);
+    const n = fs17.readSync(fd, buf, 0, SWITCH_PROBE_BYTES, 0);
+    raw = buf.toString("utf8", 0, n);
+  } catch {
+    return false;
+  } finally {
+    fs17.closeSync(fd);
+  }
+  if (!raw.includes(CLEAR_COMMAND_ECHO) && !raw.includes("SessionStart:clear")) return false;
+  for (const line of raw.split("\n")) {
+    if (!line.trim()) continue;
+    let r;
+    try {
+      r = JSON.parse(line);
+    } catch {
+      continue;
+    }
+    if (r["type"] === "user" && !r["isMeta"]) {
+      const msg = r["message"];
+      if (extractText(msg?.["content"]).trimStart().startsWith(CLEAR_COMMAND_ECHO)) return true;
+    }
+    if (r["type"] === "attachment") {
+      const att = r["attachment"];
+      if (typeof att?.["hookName"] === "string" && att["hookName"].startsWith("SessionStart:clear")) {
+        return true;
+      }
+    }
+  }
+  return false;
+}
+function appendedTailHasResumeMarker(filePath, fromOffset) {
+  let fd;
+  try {
+    fd = fs17.openSync(filePath, "r");
+  } catch {
+    return false;
+  }
+  try {
+    const size = fs17.fstatSync(fd).size;
+    const len = Math.min(Math.max(size - fromOffset, 0), SWITCH_PROBE_BYTES);
+    if (len <= 0) return false;
+    const buf = Buffer.alloc(len);
+    const n = fs17.readSync(fd, buf, 0, len, fromOffset);
+    const raw = buf.toString("utf8", 0, n);
+    if (!raw.includes('"last-prompt"')) return false;
+    for (const line of raw.split("\n")) {
+      if (!line.trim()) continue;
+      try {
+        if (JSON.parse(line)["type"] === "last-prompt") return true;
+      } catch {
+      }
+    }
+    return false;
+  } catch {
+    return false;
+  } finally {
+    fs17.closeSync(fd);
+  }
+}
+function watchConversationSwitch(cwd, opts, onSwitch, projectsRoot) {
+  const root = projectsRoot ?? path21.join(os15.homedir(), ".claude", "projects");
+  let currentId = opts.currentId;
+  const baseline = /* @__PURE__ */ new Map();
+  const unclassified = /* @__PURE__ */ new Map();
+  let dirWatcher = null;
+  let rootWatcher = null;
+  let closed = false;
+  const fileSize = (file) => {
+    try {
+      return fs17.statSync(file).size;
+    } catch {
+      return null;
+    }
+  };
+  const switchTo = (dir, id, kind) => {
+    const leaving = fileSize(path21.join(dir, `${currentId}.jsonl`));
+    if (leaving !== null) baseline.set(currentId, leaving);
+    baseline.delete(id);
+    unclassified.delete(id);
+    currentId = id;
+    onSwitch(id, { kind });
+  };
+  const scan = (dir) => {
+    if (closed) return;
+    let entries;
+    try {
+      entries = fs17.readdirSync(dir);
+    } catch {
+      return;
+    }
+    for (const name of entries) {
+      if (!name.endsWith(".jsonl")) continue;
+      const id = name.slice(0, -".jsonl".length);
+      if (id === currentId) continue;
+      const file = path21.join(dir, name);
+      const size = fileSize(file);
+      if (size === null) continue;
+      const known = baseline.get(id);
+      if (known !== void 0) {
+        if (size > known && appendedTailHasResumeMarker(file, known)) {
+          switchTo(dir, id, "resumed");
+          return;
+        }
+        continue;
+      }
+      if (unclassified.get(id) === size) continue;
+      unclassified.set(id, size);
+      if (isClearedConversationFile(file)) {
+        switchTo(dir, id, "new");
+        return;
+      }
+    }
+  };
+  const attachDir = (initial) => {
+    const dir = resolveHistoryDir(cwd, root);
+    if (!dir) return false;
+    rootWatcher?.close();
+    rootWatcher = null;
+    if (initial) {
+      try {
+        for (const name of fs17.readdirSync(dir)) {
+          if (!name.endsWith(".jsonl")) continue;
+          const id = name.slice(0, -".jsonl".length);
+          if (id === currentId) continue;
+          const size = fileSize(path21.join(dir, name));
+          if (size !== null) baseline.set(id, size);
+        }
+      } catch {
+      }
+    }
+    try {
+      dirWatcher = fs17.watch(dir, { persistent: false }, () => scan(dir));
+    } catch {
+      return false;
+    }
+    scan(dir);
+    return true;
+  };
+  if (!attachDir(true)) {
+    try {
+      fs17.mkdirSync(root, { recursive: true });
+      rootWatcher = fs17.watch(root, { persistent: false }, () => {
+        if (!closed && !dirWatcher) attachDir(false);
+      });
+    } catch {
+    }
+  }
+  return () => {
+    closed = true;
+    dirWatcher?.close();
+    rootWatcher?.close();
+    dirWatcher = null;
+    rootWatcher = null;
+  };
+}
 
 // src/agents/claude/runtime.ts
 var ClaudeRuntimeStrategy = class {
@@ -15436,6 +15606,14 @@ var ClaudeRuntimeStrategy = class {
   parseHistoryFile(filePath) {
     return parseHistoryFile(filePath);
   }
+  /**
+   * Baton: follow the native TUI through `/clear` (new conversation id, new
+   * JSONL) and `/resume` (an existing one) — see
+   * {@link history.watchConversationSwitch}.
+   */
+  watchConversationSwitch(cwd, opts, onSwitch) {
+    return watchConversationSwitch(cwd, opts, onSwitch);
+  }
   getCurrentUsage(historyDir) {
     return getCurrentUsage(historyDir);
   }
@@ -18137,25 +18315,27 @@ async function waitForCommandOnPath(cmd, opts = {}) {
   }
   return check();
 }
-function augmentUserLocalBinPaths() {
-  const home = import_os4.default.homedir();
+function augmentUserLocalBinPaths(deps = {}) {
+  const env = deps.env ?? process.env;
+  const home = deps.homedir ?? import_os4.default.homedir();
+  const p2 = deps.pathApi ?? import_path4.default;
   const candidates = [
     // XDG-style per-user bin — npm's default global-prefix bin dir on most
     // Linux setups (`npm config set prefix ~/.local` or an nvm-less
     // per-user npm), and where curl-based agent installers commonly land.
-    import_path4.default.join(home, ".local", "bin"),
+    p2.join(home, ".local", "bin"),
     // Common explicit npm global-prefix conventions seen in the wild
     // (`npm config set prefix ~/.npm-global`, and Debian/Fedora's
     // `~/.local/share/npm` layout for `npm config set prefix
     // ~/.local/share/npm`).
-    import_path4.default.join(home, ".npm-global", "bin"),
-    import_path4.default.join(home, ".local", "share", "npm", "bin")
+    p2.join(home, ".npm-global", "bin"),
+    p2.join(home, ".local", "share", "npm", "bin")
   ];
-  const parts = (process.env.PATH ?? "").split(import_path4.default.delimiter).filter((p2) => p2.length > 0);
+  const parts = (env.PATH ?? "").split(p2.delimiter).filter((s) => s.length > 0);
   const existing = new Set(parts);
   const additions = candidates.filter((dir) => !existing.has(dir));
   if (additions.length === 0) return;
-  process.env.PATH = [...additions, ...parts].join(import_path4.default.delimiter);
+  env.PATH = [...additions, ...parts].join(p2.delimiter);
 }
 function resolveCursorAgentBinary(deps = {}) {
   const existsSync29 = deps.existsSync ?? import_fs.default.existsSync;
@@ -21786,7 +21966,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.11" : null;
+  const current2 = true ? "2.65.12" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -21803,7 +21983,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.11" : null;
+  const current2 = true ? "2.65.12" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -21823,7 +22003,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.11" : null;
+  return true ? "2.65.12" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve10) => {
@@ -41268,6 +41448,21 @@ var BatonController = class _BatonController {
     this._conversationId = conversationId;
     this.setState("LOCAL_DRIVE");
   }
+  /**
+   * The native TUI SWITCHED conversation while driving (Claude `/clear` →
+   * a new id, `/resume` → an existing one): the process and the pairing are
+   * unchanged, but the conversation the user is in has another id. Re-point
+   * the baton at it so the read-only mirror follows that transcript and a
+   * later Take Control resumes THAT conversation instead of the abandoned one. Guarded to LOCAL_DRIVE — only
+   * the terminal can switch its own conversation, and during a hand-off /
+   * MOBILE_DRIVE the native watcher is torn down anyway (`stop()`). Same id →
+   * no-op. Re-publishes LOCAL_DRIVE so the mirror re-arms + mobile learns the id.
+   */
+  switchConversation(conversationId) {
+    if (this._state !== "LOCAL_DRIVE" || this._conversationId === conversationId) return;
+    this._conversationId = conversationId;
+    this.setState("LOCAL_DRIVE");
+  }
   async takeControl() {
     await this.switchDriver(
       "LOCAL_DRIVE",
@@ -41419,18 +41614,25 @@ var NativeTuiDriver = class _NativeTuiDriver {
   static QUICK_DISCOVER_MS = 8e3;
   outputSvc;
   historySvc;
+  /** Unsubscribe for the runtime's conversation-switch watcher (armed per
+   *  `start()`, torn down in `stop()`), or null when not armed. */
+  unwatchSwitch = null;
   setKeepAlive;
   keepAliveCtx;
   async start(resumeId) {
     if (resumeId !== void 0) {
       await this.deps.runtime.syncTranscriptForNativeResume?.(this.deps.opts.cwd, resumeId);
       await this.agent.restart(resumeId, false);
+      this.armSwitchWatch(resumeId);
       return resumeId;
     }
     const spawnedAt = this.now();
     await this.agent.spawn();
     const preMinted = this.agent.spawnedSessionId;
-    if (preMinted) return preMinted;
+    if (preMinted) {
+      this.armSwitchWatch(preMinted);
+      return preMinted;
+    }
     const discover = this.deps.runtime.discoverSessionId;
     if (!discover) {
       throw new Error("NativeTuiDriver: agent did not expose a session id after spawn");
@@ -41446,7 +41648,26 @@ var NativeTuiDriver = class _NativeTuiDriver {
     });
     return null;
   }
+  /**
+   * Follow the native TUI if it switches conversation mid-session (Claude
+   * `/clear` / `/resume`): the runtime's event-driven watcher reports the id
+   * now being driven, we point the PTY-side history at it and tell the
+   * controller to rebind. Armed once per `start()` (fresh or resume) on the
+   * id the TUI is driving; inert for agents without the hook.
+   */
+  armSwitchWatch(currentId) {
+    this.unwatchSwitch?.();
+    this.unwatchSwitch = null;
+    const watch3 = this.deps.runtime.watchConversationSwitch;
+    if (!watch3) return;
+    this.unwatchSwitch = watch3(this.deps.opts.cwd, { currentId }, (id) => {
+      this.historySvc.setCurrentConversationId(id);
+      this.deps.onConversationSwitch?.(id);
+    });
+  }
   async stop() {
+    this.unwatchSwitch?.();
+    this.unwatchSwitch = null;
     this.agent.kill();
     parkTerminalForReadonly();
   }
@@ -41693,8 +41914,8 @@ var TranscriptMirror = class {
     if (!file) return false;
     this.attached = true;
     this.emit(file);
-    const watch2 = this.deps.watch ?? defaultWatch;
-    this.unwatch = watch2(file, () => this.emit(file));
+    const watch3 = this.deps.watch ?? defaultWatch;
+    this.unwatch = watch3(file, () => this.emit(file));
     return true;
   }
   clearPoll() {
@@ -41909,10 +42130,17 @@ async function runBatonSession(opts) {
     // calls this once the user's first terminal turn creates the transcript.
     // Safe forward-ref — `controller` is initialised long before `begin()` runs,
     // and onLateBind only fires from inside `begin()`'s spawn.
-    onLateBind: (id) => controller.rebindConversation(id)
+    onLateBind: (id) => controller.rebindConversation(id),
+    // The native TUI switched conversation mid-drive (Claude `/clear` mints a
+    // new id + JSONL; `/resume` re-opens an existing one): rebind so the mirror
+    // follows that transcript and a later Take Control resumes THAT
+    // conversation. Owner report 2026-08-18: after `/clear` (+`/rename`) the
+    // mobile went silent — the mirror kept tailing the abandoned file.
+    onConversationSwitch: (id) => controller.switchConversation(id)
   });
   let mirror = null;
   let firstLocalDrive = true;
+  let lastPublished = null;
   const startMirror = (conversationId, fresh) => {
     mirror?.stop();
     mirror = new TranscriptMirror({
@@ -41945,11 +42173,13 @@ async function runBatonSession(opts) {
     publishState: (state, driver, conversationId) => {
       publishBatonState(state, driver, conversationId);
       if (state === "LOCAL_DRIVE" && conversationId) {
-        startMirror(conversationId, firstLocalDrive);
+        const switched = lastPublished === "LOCAL_DRIVE";
+        startMirror(conversationId, firstLocalDrive || switched);
         firstLocalDrive = false;
       } else if (state !== "LOCAL_DRIVE") {
         mirror?.stop();
       }
+      lastPublished = state;
     }
   });
   const dispatchActive = (cmd) => controller.activeSessionDriver.dispatch(cmd);
@@ -45024,7 +45254,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.65.11" : "0.0.0-dev";
+  const cliVersion = true ? "2.65.12" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -45415,7 +45645,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.65.11" : "unknown";
+  const v = true ? "2.65.12" : "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.11",
+  "version": "2.65.12",
   "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",