codeam-cli 2.61.7 → 2.61.9

package/CHANGELOG.md

@@ -4,6 +4,27 @@ 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.61.8] — 2026-07-16
+
+### Added
+
+- **cli:** Agent-agnostic RECENT list + auto-resume latest conversation (ACP session/list)
+
+### Fixed
+
+- **cli:** Wrap public loadSession() with the load-replay guard (keystone)
+
+### Tests
+
+- **cli:** Harness invariant — no unguarded connection.loadSession
+
+## [2.61.7] — 2026-07-16
+
+### Fixed
+
+- **cli:** Auto-resume the user's session on host-agent restart (no churn)
+- **cli:** Engines-compat test uses CommonJS require (was import.meta → tsc fail)
+
 ## [2.61.5] — 2026-07-16
 
 ### Added

package/dist/index.js

@@ -5975,7 +5975,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.61.7" : "0.0.0-dev",
+    cliVersion: true ? "2.61.9" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -6156,7 +6156,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.61.7",
+  version: "2.61.9",
   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",
@@ -7299,7 +7299,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.7" ? { ideVersion: "2.61.7" } : {}
+      ..."2.61.9" ? { ideVersion: "2.61.9" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -17900,7 +17900,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 current = true ? "2.61.7" : null;
+  const current = true ? "2.61.9" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -17917,7 +17917,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current = true ? "2.61.7" : null;
+  const current = true ? "2.61.9" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -17937,7 +17937,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.7" : null;
+  return true ? "2.61.9" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve8) => {
@@ -18256,7 +18256,10 @@ var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process23.s
 });
 var defaultResumeSpawner = (env, cwd) => (0, import_node_child_process23.spawn)(process.execPath, [process.argv[1]], {
   cwd,
-  env: { ...process.env, ...env, CODEAM_AUTO_APPROVE: "1" },
+  // CODEAM_AUTO_APPROVE=1 → ACP path (baton off). CODEAM_RESUME_LATEST=1 →
+  // continue the user's most-recent conversation instead of opening an empty
+  // one (runAcpSession loads it via the ACP session/list RPC).
+  env: { ...process.env, ...env, CODEAM_AUTO_APPROVE: "1", CODEAM_RESUME_LATEST: "1" },
   stdio: ["ignore", "pipe", "pipe"],
   detached: false
 });
@@ -22595,16 +22598,23 @@ function buildNpmInstallInvocation(opts) {
     path59.dirname(execPath),
     process.platform === "win32" ? "npm.cmd" : "npm"
   );
-  const command2 = exists2(siblingNpm) ? siblingNpm : "npm";
-  const args2 = prefix ? ["install", "-g", "--prefix", prefix, "codeam-cli@latest"] : ["install", "-g", "codeam-cli@latest"];
-  return { command: command2, args: args2 };
+  const npmCommand = exists2(siblingNpm) ? siblingNpm : "npm";
+  const npmArgs = prefix ? ["install", "-g", "--prefix", prefix, "codeam-cli@latest"] : ["install", "-g", "codeam-cli@latest"];
+  if (opts?.sudo) {
+    return { command: "sudo", args: ["-n", npmCommand, ...npmArgs] };
+  }
+  return { command: npmCommand, args: npmArgs };
+}
+function isPermissionError(stderr) {
+  return /EACCES|permission denied|errno[\s"']*-13|operation not permitted/i.test(stderr);
 }
 async function runNpmInstallLatest() {
   let lastError = "";
-  const invocation = buildNpmInstallInvocation();
-  const useShell = process.platform === "win32";
-  const command2 = useShell && invocation.command.includes(" ") ? `"${invocation.command}"` : invocation.command;
+  let useSudo = false;
   for (let attempt = 1; attempt <= CLI_UPDATE_MAX_ATTEMPTS; attempt++) {
+    const invocation = buildNpmInstallInvocation({ sudo: useSudo });
+    const useShell = process.platform === "win32";
+    const command2 = useShell && invocation.command.includes(" ") ? `"${invocation.command}"` : invocation.command;
     const result = await new Promise((resolve8) => {
       (0, import_child_process24.execFile)(
         command2,
@@ -22621,6 +22631,10 @@ async function runNpmInstallLatest() {
     });
     if (result.ok) return { ok: true };
     lastError = result.error ?? "unknown";
+    if (!useSudo && process.platform !== "win32" && isPermissionError(lastError)) {
+      useSudo = true;
+      continue;
+    }
     if (attempt < CLI_UPDATE_MAX_ATTEMPTS) {
       await new Promise((r) => setTimeout(r, 1e3 * attempt));
     }
@@ -29068,6 +29082,7 @@ var AcpClient = class {
    *  the conversation — whereas one without it falls back to a fresh
    *  `session/new`. Set once during {@link startOnce}. */
   supportsLoadSession = false;
+  supportsListSessions = false;
   /** Idle watchdog for the in-flight prompt. The `Client` handlers
    *  (`sessionUpdate` / `requestPermission`) reach for this to keep
    *  the turn alive while the adapter is demonstrably working. Null
@@ -29252,6 +29267,7 @@ var AcpClient = class {
         `initialize \u2190 ok protocolVersion=${initialize.protocolVersion} agentCaps=${JSON.stringify(initialize.agentCapabilities ?? {}).slice(0, 200)}`
       );
       this.supportsLoadSession = initialize.agentCapabilities?.loadSession === true;
+      this.supportsListSessions = !!initialize.agentCapabilities?.sessionCapabilities?.list;
       log.info("acpClient", "newSession \u2192 sending");
       let startupTimer;
       const startupFailure = new Promise((_2, reject) => {
@@ -29495,14 +29511,44 @@ var AcpClient = class {
       return;
     }
     log.info("acpClient", `loadSession \u2192 sessionId=${sessionId.slice(0, 8)}`);
-    await this.connection.loadSession({
-      sessionId,
-      cwd: this.opts.cwd,
-      mcpServers: this.opts.mcpServers ?? []
-    });
+    this.opts.beginLoadReplay?.();
+    try {
+      await this.connection.loadSession({
+        sessionId,
+        cwd: this.opts.cwd,
+        mcpServers: this.opts.mcpServers ?? []
+      });
+    } finally {
+      this.opts.endLoadReplay?.();
+    }
     this.sessionId = sessionId;
     log.info("acpClient", `loadSession \u2190 ok sessionId=${sessionId.slice(0, 8)}`);
   }
+  /**
+   * Enumerate the workspace's conversations via the ACP `session/list` RPC.
+   * Agent-agnostic — works for ANY adapter that advertises
+   * `sessionCapabilities.list` (claude/codex/gemini alike), so the mobile RECENT
+   * list no longer depends on per-agent JSONL scanning. Maps SessionInfo (id +
+   * agent-authored title + updatedAt) to the backend's RECENT-list shape.
+   *
+   * Returns null when the agent doesn't advertise `list` (caller falls back or
+   * skips). Best-effort — never throws out to the caller.
+   */
+  async listSessions() {
+    if (!this.connection || !this.supportsListSessions) return null;
+    try {
+      const res = await this.connection.listSessions({ cwd: this.opts.cwd });
+      return (res.sessions ?? []).map((s) => ({
+        id: s.sessionId,
+        summary: s.title ?? "",
+        // updatedAt is an ISO string; fall back to now on absent/unparseable.
+        timestamp: s.updatedAt ? Date.parse(s.updatedAt) || Date.now() : Date.now()
+      }));
+    } catch (err) {
+      log.trace("acpClient", "listSessions failed (best-effort)", err);
+      return null;
+    }
+  }
   /**
    * Switch the active session's model via the non-standard
    * `session/set_model` RPC. The standard ACP SDK doesn't expose
@@ -32330,17 +32376,17 @@ var AcpHistory = class {
   async flush() {
     if (this.summary === null || this.messages.length === 0) return;
     const timestamp = Date.now();
+    const current = { id: this.opts.acpSessionId, summary: this.summary, timestamp };
+    let sessions3 = [current];
+    const listed = this.opts.listSessions ? await this.opts.listSessions() : null;
+    if (listed && listed.length > 0) {
+      sessions3 = listed.map(
+        (s) => s.id === this.opts.acpSessionId && !s.summary ? { ...s, summary: this.summary } : s
+      );
+      if (!sessions3.some((s) => s.id === this.opts.acpSessionId)) sessions3.unshift(current);
+    }
     await Promise.all([
-      this.publisher.pushSessionList({
-        agentId: this.opts.agent,
-        sessions: [
-          {
-            id: this.opts.acpSessionId,
-            summary: this.summary,
-            timestamp
-          }
-        ]
-      }),
+      this.publisher.pushSessionList({ agentId: this.opts.agent, sessions: sessions3 }),
       this.publisher.pushConversation({
         agentId: this.opts.agent,
         sessionId: this.opts.acpSessionId,
@@ -32386,6 +32432,10 @@ function computeAdapterExtraEnv(params) {
   );
   return env;
 }
+function pickLatestResumableConversation(sessions3, currentId) {
+  const prior = (sessions3 ?? []).filter((s) => s.id !== currentId).sort((a, b) => b.timestamp - a.timestamp)[0];
+  return prior?.id ?? null;
+}
 async function runAcpSession(opts) {
   const publisher = new AcpPublisher({
     sessionId: opts.sessionId,
@@ -32534,16 +32584,24 @@ async function runAcpSession(opts) {
     });
     return;
   }
-  const {
-    sessionId: acpSessionId,
-    initialize,
-    model: handshakeModel,
-    tier: handshakeTier
-  } = handshake;
+  let acpSessionId = handshake.sessionId;
+  const { initialize, model: handshakeModel, tier: handshakeTier } = handshake;
   log.trace(
     "acpRunner",
     `adapter handshake ok protocolVersion=${initialize.protocolVersion} sessionId=${acpSessionId.slice(0, 8)}`
   );
+  if (process.env.CODEAM_RESUME_LATEST === "1") {
+    try {
+      const priorId = pickLatestResumableConversation(await client3.listSessions(), acpSessionId);
+      if (priorId) {
+        await client3.loadSession(priorId);
+        acpSessionId = priorId;
+        log.info("acpRunner", `auto-resumed latest conversation ${priorId.slice(0, 8)}`);
+      }
+    } catch (err) {
+      log.trace("acpRunner", "auto-resume-latest failed (best-effort)", err);
+    }
+  }
   showSuccess(`${opts.agent} online (ACP) \u2014 awaiting prompts from mobile.`);
   showRelayNotice();
   void publisher.publishOutput({
@@ -32565,10 +32623,33 @@ async function runAcpSession(opts) {
   });
   const runtime = createInteractiveAgentStrategy(opts.agent, createOsStrategy());
   const models = await runtime.listModels();
-  const history = new AcpHistory(publisher, { agent: opts.agent, acpSessionId });
+  const history = new AcpHistory(publisher, {
+    agent: opts.agent,
+    acpSessionId,
+    // Agent-agnostic RECENT list: enumerate via the ACP session/list RPC (any
+    // adapter advertising sessionCapabilities.list). Returns null on unsupported
+    // agents → flush() falls back to the current session only.
+    listSessions: () => client3.listSessions()
+  });
   const jsonlHistory = new HistoryService(runtime, opts.pluginId, opts.cwd, {
     pluginAuthToken: opts.pluginAuthToken
   });
+  void (async () => {
+    try {
+      const listed = await client3.listSessions();
+      if (listed && listed.length > 0) {
+        await publisher.pushSessionList({ agentId: opts.agent, sessions: listed });
+        log.info("acpRunner", `session-start: pushed ${listed.length} conversation(s) to RECENT`);
+      }
+      const uploaded = await jsonlHistory.uploadConversationIfChanged(acpSessionId);
+      log.info(
+        "acpRunner",
+        `session-start: transcript upload ${acpSessionId.slice(0, 8)} \u2192 ${uploaded}`
+      );
+    } catch (err) {
+      log.warn("acpRunner", `session-start push failed (best-effort): ${describeError(err)}`);
+    }
+  })();
   const onboardingWelcomeDone = maybeSendOnboardingWelcome({
     streaming,
     history,
@@ -37340,7 +37421,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.61.7" : "0.0.0-dev";
+  const cliVersion = true ? "2.61.9" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto12.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -37851,7 +37932,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.61.7" : "unknown";
+  const v = true ? "2.61.9" : "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.61.7",
+  "version": "2.61.9",
   "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",