codeam-cli 2.73.2 → 2.73.4

package/CHANGELOG.md

@@ -4,6 +4,22 @@ 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.73.3] — 2026-09-02
+
+### Fixed
+
+- **cli:** Debounce MCP reprovisions so a run of changes costs ONE respawn (#684)
+
+## [2.73.2] — 2026-09-02
+
+### CI
+
+- **release:** Publish the release notes to #changelog and Discussions (#680)
+
+### Fixed
+
+- **cli:** An MCP reprovision burst must not kill the session (#682)
+
 ## [2.73.1] — 2026-09-02
 
 ### Added

package/dist/index.js

@@ -8097,7 +8097,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.73.2" : "0.0.0-dev",
+    cliVersion: true ? "2.73.4" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8339,7 +8339,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.73.2",
+  version: "2.73.4",
   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",
@@ -9932,7 +9932,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.73.2" ? { ideVersion: "2.73.2" } : {}
+      ..."2.73.4" ? { ideVersion: "2.73.4" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -22208,7 +22208,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.73.2" : null;
+  const current2 = true ? "2.73.4" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22225,7 +22225,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.73.2" : null;
+  const current2 = true ? "2.73.4" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22248,7 +22248,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.73.2" : null;
+  return true ? "2.73.4" : null;
 }
 async function installedVersion(deps) {
   const ls = await deps.run(
@@ -35677,6 +35677,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 MCP_STARTUP_TIMEOUT_MS = NEWSESSION_TIMEOUT_MS - 3e4;
 var LOADSESSION_TIMEOUT_MS = 6e4;
 var PROMPT_IDLE_TIMEOUT_MS = 9e4;
 var PROMPT_ACTIVE_IDLE_TIMEOUT_MS = 6e5;
@@ -35684,6 +35685,7 @@ var CLIENT_CAPABILITIES = {
   fs: { readTextFile: true, writeTextFile: true },
   terminal: false
 };
+var MCP_REPROVISION_DEBOUNCE_MS = 1e4;
 var AcpClient = class {
   constructor(opts) {
     this.opts = opts;
@@ -35756,8 +35758,9 @@ var AcpClient = class {
   /** True once a start has fully succeeded (handshake + session). Distinguishes
    *  "never started" (a programming error) from "the adapter died" (recoverable). */
   startedOnce = false;
-  mcpReprovisionQueued = false;
   mcpReprovisionPending = null;
+  mcpDebounceTimer = null;
+  mcpDebounceWaiters = [];
   /** Last few adapter stderr lines — so a startup failure surfaces the REAL
    *  cause (e.g. gemini's `IneligibleTierError`) instead of a bare timeout. */
   recentStderr = [];
@@ -35853,7 +35856,15 @@ var AcpClient = class {
       // extraEnv (e.g. CLAUDE_CODE_DISABLE_1M_CONTEXT=1 on an on-demand
       // re-spawn) layers over process.env; PATH stays last so the augmented
       // PATH always wins.
-      env: { ...process.env, ...this.opts.extraEnv ?? {}, PATH: augmentedPath },
+      //
+      // MCP_TIMEOUT comes FIRST so the caller can still override it, and it is
+      // load-bearing — see MCP_STARTUP_TIMEOUT_MS.
+      env: {
+        ...process.env,
+        MCP_TIMEOUT: String(MCP_STARTUP_TIMEOUT_MS),
+        ...this.opts.extraEnv ?? {},
+        PATH: augmentedPath
+      },
       stdio: ["pipe", "pipe", "pipe"]
     });
     this.child = child;
@@ -36268,19 +36279,30 @@ var AcpClient = class {
     this.opts.mcpServers = servers;
     if (!this.connection || !this.sessionId) return "deferred";
     this.mcpReprovisionPending = servers;
-    if (this.mcpReprovisionQueued) return "deferred";
-    this.mcpReprovisionQueued = true;
-    const run = this.promptChain.then(() => {
-      this.mcpReprovisionQueued = false;
+    if (this.mcpDebounceTimer) clearTimeout(this.mcpDebounceTimer);
+    const settled = new Promise((resolve11) => {
+      this.mcpDebounceWaiters.push(resolve11);
+    });
+    this.mcpDebounceTimer = setTimeout(() => {
+      this.mcpDebounceTimer = null;
       const latest = this.mcpReprovisionPending ?? servers;
       this.mcpReprovisionPending = null;
-      return this.runReprovisionMcp(latest);
-    });
-    this.promptChain = run.then(
-      () => void 0,
-      () => void 0
-    );
-    return run;
+      const waiters = this.mcpDebounceWaiters;
+      this.mcpDebounceWaiters = [];
+      const run = this.promptChain.then(() => this.runReprovisionMcp(latest));
+      this.promptChain = run.then(
+        () => void 0,
+        () => void 0
+      );
+      run.then(
+        (result) => waiters.forEach((w3) => w3(result)),
+        // `runReprovisionMcp` already swallows its own failures into
+        // 'deferred'; this is the belt for anything the chain itself throws.
+        () => waiters.forEach((w3) => w3("deferred"))
+      );
+    }, this.opts.mcpReprovisionDebounceMs ?? MCP_REPROVISION_DEBOUNCE_MS);
+    this.mcpDebounceTimer.unref?.();
+    return settled;
   }
   /** The actual respawn. Only ever called from {@link reprovisionMcp}'s queued
    *  slot, so it can assume no turn and no other respawn is running. */
@@ -36480,6 +36502,14 @@ var AcpClient = class {
    */
   async stop() {
     this.stopping = true;
+    if (this.mcpDebounceTimer) {
+      clearTimeout(this.mcpDebounceTimer);
+      this.mcpDebounceTimer = null;
+      this.mcpReprovisionPending = null;
+      const waiters = this.mcpDebounceWaiters;
+      this.mcpDebounceWaiters = [];
+      waiters.forEach((w3) => w3("deferred"));
+    }
     const child = this.child;
     if (!child) return;
     this.child = null;
@@ -43681,12 +43711,22 @@ var TranscriptMirror = class {
   unwatch = null;
   pollHandle = null;
   attached = false;
+  /** True while `start()`'s own synchronous attach attempt is running, so
+   *  `tryAttach` can tell "the file was already there" from "it appeared while
+   *  we waited". The distinction is the whole basis for whether the first
+   *  batch is history or live content. */
+  attachingAtStart = false;
   pollIntervalMs;
   waitTimeoutMs;
   setIntervalFn;
   clearIntervalFn;
   start() {
-    if (this.tryAttach()) return;
+    this.attachingAtStart = true;
+    try {
+      if (this.tryAttach()) return;
+    } finally {
+      this.attachingAtStart = false;
+    }
     let waited = 0;
     this.pollHandle = this.setIntervalFn(() => {
       waited += this.pollIntervalMs;
@@ -43709,7 +43749,7 @@ var TranscriptMirror = class {
     const file = this.deps.runtime.resolveHistoryFile?.(this.deps.cwd, this.deps.conversationId);
     if (!file) return false;
     this.attached = true;
-    this.emit(file);
+    this.emit(file, this.attachingAtStart);
     const watch4 = this.deps.watch ?? defaultWatch;
     this.unwatch = watch4(file, () => this.emit(file));
     return true;
@@ -43720,7 +43760,7 @@ var TranscriptMirror = class {
       this.pollHandle = null;
     }
   }
-  emit(file) {
+  emit(file, preexisting = false) {
     let all;
     try {
       all = this.deps.runtime.parseHistoryFile(file);
@@ -43730,7 +43770,7 @@ var TranscriptMirror = class {
     if (all.length <= this.emitted) return;
     const delta = all.slice(this.emitted);
     this.emitted = all.length;
-    this.deps.onNewMessages(delta);
+    this.deps.onNewMessages(delta, { preexisting });
   }
 };
 function defaultWatch(file, onChange) {
@@ -43782,10 +43822,9 @@ async function publishMirroredTurnsLive(publisher, messages) {
   }
 }
 function makeMirrorOnNewMessages(deps) {
-  let isFirstEmit = true;
   let publishChain = Promise.resolve();
   const conversation = [];
-  return (messages) => {
+  return (messages, meta) => {
     const relevant = messages.filter((m) => m.role !== "system");
     if (relevant.length === 0) return;
     const mapped = relevant.map((m) => ({
@@ -43800,7 +43839,7 @@ function makeMirrorOnNewMessages(deps) {
       sessionId: deps.conversationId,
       messages: conversation.slice()
     });
-    if (deps.fresh || !isFirstEmit) {
+    if (meta?.preexisting !== true) {
       publishChain = publishChain.then(() => publishMirroredTurnsLive(deps.publisher, relevant)).catch((err) => {
         log.warn(
           "wireBaton",
@@ -43808,7 +43847,6 @@ function makeMirrorOnNewMessages(deps) {
         );
       });
     }
-    isFirstEmit = false;
   };
 }
 function makeSerializedBatonPoster(post2) {
@@ -43935,9 +43973,8 @@ async function runBatonSession(opts) {
     onConversationSwitch: (id) => controller.switchConversation(id)
   });
   let mirror = null;
-  let firstLocalDrive = true;
   let lastPublished = null;
-  const startMirror = (conversationId, fresh) => {
+  const startMirror = (conversationId) => {
     mirror?.stop();
     mirror = new TranscriptMirror({
       runtime,
@@ -43946,8 +43983,7 @@ async function runBatonSession(opts) {
       onNewMessages: makeMirrorOnNewMessages({
         publisher,
         agentId: opts.agent,
-        conversationId,
-        fresh
+        conversationId
       })
     });
     mirror.start();
@@ -43969,9 +44005,7 @@ async function runBatonSession(opts) {
     publishState: (state, driver, conversationId) => {
       publishBatonState(state, driver, conversationId);
       if (state === "LOCAL_DRIVE" && conversationId) {
-        const switched = lastPublished === "LOCAL_DRIVE";
-        startMirror(conversationId, firstLocalDrive || switched);
-        firstLocalDrive = false;
+        startMirror(conversationId);
       } else if (state !== "LOCAL_DRIVE") {
         mirror?.stop();
       }
@@ -47065,7 +47099,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.73.2" : "0.0.0-dev";
+  const cliVersion = true ? "2.73.4" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -47453,10 +47487,77 @@ async function mcpRun(args2) {
   await proxy.start();
 }
 
+// src/integrations/mcp-warm.ts
+var import_node_child_process35 = require("child_process");
+function specOf(delivery) {
+  if (!delivery.command) return null;
+  const spec = (delivery.args ?? []).find((a) => !a.startsWith("-"));
+  return spec ?? null;
+}
+function warmTargets() {
+  const bySpec = /* @__PURE__ */ new Map();
+  for (const integration of getEnabledIntegrations()) {
+    const delivery = integration.delivery?.mcp;
+    if (!delivery) continue;
+    const spec = specOf(delivery);
+    if (!spec) continue;
+    if (!bySpec.has(spec)) {
+      bySpec.set(spec, { id: integration.id, launcher: delivery.command, spec });
+    }
+  }
+  return [...bySpec.values()];
+}
+function warmCommand(target) {
+  if (target.launcher === "npx") {
+    return { command: "npx", args: ["-y", "--package", target.spec, "-c", "true"] };
+  }
+  if (target.launcher === "uvx") {
+    return { command: "uv", args: ["tool", "install", target.spec] };
+  }
+  return null;
+}
+async function mcpWarm(argv = []) {
+  const timeoutMs = 3e5;
+  const targets = warmTargets();
+  const only = argv.filter((a) => !a.startsWith("-"));
+  const selected = only.length > 0 ? targets.filter((t2) => only.includes(t2.id)) : targets;
+  const result = { warmed: [], skipped: [], failed: [] };
+  console.log(`[codeam mcp-warm] ${selected.length} MCP package(s) to pre-fetch`);
+  for (const target of selected) {
+    const cmd = warmCommand(target);
+    if (!cmd) {
+      result.skipped.push(`${target.spec} (no warm recipe for '${target.launcher}')`);
+      continue;
+    }
+    const started = Date.now();
+    const run = (0, import_node_child_process35.spawnSync)(cmd.command, cmd.args, {
+      stdio: ["ignore", "ignore", "pipe"],
+      timeout: timeoutMs,
+      encoding: "utf8"
+    });
+    const secs = ((Date.now() - started) / 1e3).toFixed(1);
+    if (run.status === 0) {
+      result.warmed.push(target.spec);
+      console.log(`  OK   ${target.spec} (${secs}s)`);
+    } else {
+      const reason = run.error?.message ?? (run.stderr ?? "").trim().split("\n").slice(-1)[0] ?? `exit ${String(run.status)}`;
+      result.failed.push({ spec: target.spec, reason });
+      console.log(`  MISS ${target.spec} (${secs}s) \u2014 fetched at runtime instead: ${reason}`);
+    }
+  }
+  console.log(
+    `[codeam mcp-warm] warmed=${result.warmed.length} failed=${result.failed.length} skipped=${result.skipped.length}`
+  );
+  log.info(
+    "mcpWarm",
+    `warmed=${result.warmed.length} failed=${result.failed.length} skipped=${result.skipped.length}`
+  );
+}
+
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.73.2" : "unknown";
+  const v = true ? "2.73.4" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 
@@ -47657,6 +47758,9 @@ async function main() {
   if (command === "mcp-run") {
     return mcpRun(args);
   }
+  if (command === "mcp-warm") {
+    return mcpWarm(args);
+  }
   if (command === "deploy") {
     if (args[0] === "ls" || args[0] === "list") return deployList();
     if (args[0] === "stop" || args[0] === "remove") return deployStop();

package/package.json

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