codeam-cli 2.73.3 → 2.73.5

package/CHANGELOG.md

@@ -4,6 +4,18 @@ 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.4] — 2026-09-03
+
+### Fixed
+
+- **cli:** MCP startup budget that fits our shim + stop the baton mirror replaying history as live turns (#686)
+
+## [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

package/dist/index.js

@@ -1872,8 +1872,27 @@ var INTEGRATION_REGISTRY = {
       mcp: {
         // Postman's OFFICIAL stdio MCP server (Node). BYO key via POSTMAN_API_KEY
         // (env only). Version PINNED; bump only after re-verifying headless.
+        //
+        // ⚠️ `--ignore-scripts` IS LOAD-BEARING — without it this integration
+        // does not work at all, on any box, and never did. The package declares
+        // a `preinstall` guard of `npx only-allow pnpm`, so npm REFUSES to
+        // install it:
+        //   info run @postman/postman-mcp-server@2.11.2 preinstall npx only-allow pnpm
+        //   info run @postman/postman-mcp-server@2.11.2 preinstall { code: 1 }
+        // and `npx -y @postman/postman-mcp-server@2.11.2` exits 1 before the
+        // server is ever reached — which the agent reports as
+        // `Server "postman" is not connected`, indistinguishable from a slow
+        // start (found while pre-warming the box image, 2026-09-03; the user's
+        // report was "Postman: idem", alongside clickup/trello, whose cause was
+        // entirely different).
+        //
+        // Skipping scripts is safe here: the guard is the only preinstall step
+        // and the published tarball already ships the built
+        // `dist/src/index.js` its `bin` points at. Verified on node:22-slim:
+        // `npx -y <pkg>` → exit 1; `npx -y --ignore-scripts <pkg>` with a key in
+        // the env → starts; and warmed once, the bin resolves offline.
         command: "npx",
-        args: ["-y", "@postman/postman-mcp-server@2.11.2"],
+        args: ["-y", "--ignore-scripts", "@postman/postman-mcp-server@2.11.2"],
         envMapping: {
           POSTMAN_API_KEY: "accessToken"
         }
@@ -8097,7 +8116,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.73.3" : "0.0.0-dev",
+    cliVersion: true ? "2.73.5" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8339,7 +8358,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.73.3",
+  version: "2.73.5",
   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 +9951,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.3" ? { ideVersion: "2.73.3" } : {}
+      ..."2.73.5" ? { ideVersion: "2.73.5" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -22208,7 +22227,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.3" : null;
+  const current2 = true ? "2.73.5" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22225,7 +22244,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.3" : null;
+  const current2 = true ? "2.73.5" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22248,7 +22267,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.3" : null;
+  return true ? "2.73.5" : null;
 }
 async function installedVersion(deps) {
   const ls = await deps.run(
@@ -35677,6 +35696,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;
@@ -35855,7 +35875,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;
@@ -43702,12 +43730,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;
@@ -43730,7 +43768,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;
@@ -43741,7 +43779,7 @@ var TranscriptMirror = class {
       this.pollHandle = null;
     }
   }
-  emit(file) {
+  emit(file, preexisting = false) {
     let all;
     try {
       all = this.deps.runtime.parseHistoryFile(file);
@@ -43751,7 +43789,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) {
@@ -43803,10 +43841,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) => ({
@@ -43821,7 +43858,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",
@@ -43829,7 +43866,6 @@ function makeMirrorOnNewMessages(deps) {
         );
       });
     }
-    isFirstEmit = false;
   };
 }
 function makeSerializedBatonPoster(post2) {
@@ -43956,9 +43992,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,
@@ -43967,8 +44002,7 @@ async function runBatonSession(opts) {
       onNewMessages: makeMirrorOnNewMessages({
         publisher,
         agentId: opts.agent,
-        conversationId,
-        fresh
+        conversationId
       })
     });
     mirror.start();
@@ -43990,9 +44024,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();
       }
@@ -47086,7 +47118,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.73.3" : "0.0.0-dev";
+  const cliVersion = true ? "2.73.5" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -47474,10 +47506,90 @@ 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 launcherFlagsOf(delivery) {
+  const args2 = delivery.args ?? [];
+  const specIndex = args2.findIndex((a) => !a.startsWith("-"));
+  return specIndex === -1 ? [...args2] : args2.slice(0, specIndex);
+}
+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,
+        flags: launcherFlagsOf(delivery),
+        spec
+      });
+    }
+  }
+  return [...bySpec.values()];
+}
+function warmCommand(target) {
+  if (target.launcher === "npx") {
+    const extra = target.flags.filter((f) => f !== "-y");
+    return { command: "npx", args: ["-y", ...extra, "--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 noise = /^npm (warn|notice)\b/;
+      const lines = (run.stderr ?? "").split("\n").map((l) => l.trim()).filter((l) => l.length > 0 && !noise.test(l));
+      const reason = run.error?.message ?? lines[lines.length - 1] ?? `exit ${String(run.status)} (no stderr)`;
+      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.3" : "unknown";
+  const v = true ? "2.73.5" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 
@@ -47678,6 +47790,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.3",
+  "version": "2.73.5",
   "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",