codeam-cli 2.61.15 → 2.61.17

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.61.16] — 2026-07-17
+
+### Fixed
+
+- **cli:** ACP dispatch is registry-static — never silently downgrade an ACP agent to PTY
+
+## [2.61.15] — 2026-07-17
+
+### Added
+
+- **shared:** Integration category field + getIntegrationsByCategory
+
 ## [2.61.14] — 2026-07-17
 
 ### Fixed

package/dist/index.js

@@ -841,8 +841,8 @@ var HEADROOM_MODELS = [
   }
 ];
 function headroomSnapshotDownloadLine(model, opts = {}) {
-  const sep7 = opts.spaceAfterComma ? ", " : ",";
-  const patterns = model.allowPatterns.map((p2) => `"${p2}"`).join(sep7);
+  const sep6 = opts.spaceAfterComma ? ", " : ",";
+  const patterns = model.allowPatterns.map((p2) => `"${p2}"`).join(sep6);
   return `snapshot_download("${model.repo}", allow_patterns=[${patterns}])`;
 }
 function headroomModelPredownloadScript(opts = {}) {
@@ -6024,7 +6024,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.61.15" : "0.0.0-dev",
+    cliVersion: true ? "2.61.17" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -6205,7 +6205,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.61.15",
+  version: "2.61.17",
   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",
@@ -7348,7 +7348,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.15" ? { ideVersion: "2.61.15" } : {}
+      ..."2.61.17" ? { ideVersion: "2.61.17" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -12211,12 +12211,12 @@ function isAvailable() {
 }
 function augmentPath() {
   const dirs = probeInstallDirs();
-  const sep7 = path16.delimiter;
+  const sep6 = path16.delimiter;
   const current = process.env.PATH ?? "";
-  const existing = new Set(current.split(sep7).filter(Boolean));
+  const existing = new Set(current.split(sep6).filter(Boolean));
   const additions = dirs.filter((d3) => !existing.has(d3));
   if (additions.length === 0) return;
-  process.env.PATH = additions.join(sep7) + sep7 + current;
+  process.env.PATH = additions.join(sep6) + sep6 + current;
 }
 function runInstaller() {
   const isWindows = process.platform === "win32";
@@ -17949,7 +17949,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.15" : null;
+  const current = true ? "2.61.17" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -17966,7 +17966,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.15" : null;
+  const current = true ? "2.61.17" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -17986,7 +17986,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.15" : null;
+  return true ? "2.61.17" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve8) => {
@@ -22655,13 +22655,15 @@ function buildNpmInstallInvocation(opts) {
   const entryScript = opts?.entryScript ?? process.argv[1] ?? "";
   const execPath = opts?.execPath ?? process.execPath;
   const exists2 = opts?.existsSync ?? fs55.existsSync;
-  const normalized = entryScript.split(path59.sep).join("/");
+  const platform3 = opts?.platform ?? process.platform;
+  const p2 = platform3 === "win32" ? path59.win32 : path59.posix;
+  const normalized = entryScript.split(/[\\/]/).join("/");
   const marker = "/lib/node_modules/codeam-cli/";
   const markerIdx = normalized.indexOf(marker);
   const prefix = markerIdx > 0 ? entryScript.slice(0, markerIdx) : null;
-  const siblingNpm = path59.join(
-    path59.dirname(execPath),
-    process.platform === "win32" ? "npm.cmd" : "npm"
+  const siblingNpm = p2.join(
+    p2.dirname(execPath),
+    platform3 === "win32" ? "npm.cmd" : "npm"
   );
   const npmCommand = exists2(siblingNpm) ? siblingNpm : "npm";
   const npmArgs = prefix ? ["install", "-g", "--prefix", prefix, "codeam-cli@latest"] : ["install", "-g", "codeam-cli@latest"];
@@ -24490,12 +24492,43 @@ var REGISTRY = {
     }
   })
 };
+var resolvedAdapterCache = /* @__PURE__ */ new Map();
 function getAcpAdapter(agent) {
+  const cached2 = resolvedAdapterCache.get(agent);
+  if (cached2) return cached2;
   const factory = REGISTRY[agent];
-  return factory ? factory() : null;
+  if (!factory) return null;
+  const spec = factory();
+  if (spec) resolvedAdapterCache.set(agent, spec);
+  return spec;
 }
 function requiresAcp(agent) {
-  return getAcpAdapter(agent) !== null;
+  return Object.prototype.hasOwnProperty.call(REGISTRY, agent);
+}
+var DEFAULT_ADAPTER_RETRY_TIMEOUT_MS = 8e3;
+var DEFAULT_ADAPTER_RETRY_POLL_MS = 750;
+async function resolveAcpAdapterWithRetry(agent, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_ADAPTER_RETRY_TIMEOUT_MS;
+  const pollMs = opts.pollMs ?? DEFAULT_ADAPTER_RETRY_POLL_MS;
+  const now = opts.now ?? Date.now;
+  const sleep5 = opts.sleep ?? ((ms) => new Promise((resolve9) => setTimeout(resolve9, ms)));
+  const resolve8 = opts.resolve ?? getAcpAdapter;
+  const attempt = () => {
+    try {
+      return resolve8(agent);
+    } catch {
+      return null;
+    }
+  };
+  let spec = attempt();
+  if (spec) return spec;
+  const deadline = now() + timeoutMs;
+  while (now() < deadline) {
+    await sleep5(pollMs);
+    spec = attempt();
+    if (spec) return spec;
+  }
+  return null;
 }
 
 // src/agents/acp/runner.ts
@@ -31648,7 +31681,7 @@ async function startTaskH(ctx) {
       await relay.sendResult(cmd.id, "completed", { stopReason: reply.stopReason });
     }
   } catch (err) {
-    const hadText = streaming.getCurrentText().trim().length > 0;
+    const hadText = streaming.hasVisibleProgress();
     const detail = describeError(err);
     log.warn("acpRunner", `prompt failed: ${detail}`);
     await cancelStuckTurn(client3);
@@ -32227,6 +32260,31 @@ var StreamingState = class {
   getCurrentText() {
     return this.text;
   }
+  /**
+   * True when the in-progress turn has ALREADY streamed VISIBLE content —
+   * assistant text OR any thinking / tool_use / tool_result activity (the
+   * SessionDetail rich feed). Deliberately BROADER than {@link getCurrentText}:
+   * a long agentic turn can stream lots of tool/thinking progress and yet NOT
+   * have emitted a final assistant `text` reply at the instant `client.prompt`
+   * throws — the idle watchdog tripping just as the agent finishes its last
+   * tool, or a trailing adapter error AFTER the work completed. Keying the
+   * failure-bubble decision off `text` alone then mis-reads that visible work
+   * as "nothing streamed" → fires the generic TURN_FAILURE_MESSAGE, and
+   * {@link closeWithBubble} REPLACES the whole turn with it (overwriting the
+   * durable snapshot) — an error wiping a fully-streamed transcript AND a false
+   * "couldn't finish" (2026-07-17 incident). The catch path keys "don't clobber
+   * — a partial reply already serves as the terminal frame" off THIS instead,
+   * routing to the non-destructive {@link closeAll}. streamingChunks still holds
+   * the turn's content at catch time (none of the close/flush methods have run
+   * yet on the throw path), so this reflects the real streamed progress.
+   */
+  hasVisibleProgress() {
+    if (this.text.trim().length > 0) return true;
+    for (const { content } of this.streamingChunks.values()) {
+      if (content.trim().length > 0) return true;
+    }
+    return false;
+  }
   async beginTurn(opts) {
     this.text = "";
     this.streamingChunks.clear();
@@ -34759,7 +34817,7 @@ async function start(requestedAgent) {
   const depsReady = process.env.CODESPACES === "true" ? provisionProjectDependencies(cwd).catch(() => void 0) : Promise.resolve();
   if (process.env.CODESPACES === "true") {
     const GATE_TIMEOUT_MS = 24e4;
-    const acpAdapterForGate = getAcpAdapter(session.agent);
+    const acpAdapterForGate = requiresAcp(session.agent) ? await resolveAcpAdapterWithRetry(session.agent) : null;
     const agentBinaryReady = acpAdapterForGate ? Promise.all([
       acpAdapterForGate.waitForBinary({ timeoutMs: GATE_TIMEOUT_MS }).catch(() => false),
       waitForAdapterModuleGraph(acpAdapterForGate.command, acpAdapterForGate.args, {
@@ -34780,7 +34838,7 @@ async function start(requestedAgent) {
     );
   }
   if (isLocalSession() && requiresAcp(session.agent)) {
-    const adapter = getAcpAdapter(session.agent);
+    const adapter = await resolveAcpAdapterWithRetry(session.agent);
     const batonCapable = runtimeSupportsBaton(createRuntimeStrategy(session.agent));
     if (batonCapable && adapter && session.pluginAuthToken) {
       await runBatonSession({
@@ -34798,8 +34856,35 @@ async function start(requestedAgent) {
     }
   }
   if (requiresAcp(session.agent)) {
-    const adapter = getAcpAdapter(session.agent);
-    if (!adapter || !session.pluginAuthToken) {
+    let adapter = getAcpAdapter(session.agent);
+    if (!adapter) {
+      adapter = await resolveAcpAdapterWithRetry(session.agent);
+    }
+    if (!adapter) {
+      log.error(
+        "acp",
+        `[acp] REQUIRED adapter unresolvable \u2014 refusing PTY downgrade (agent=${session.agent})`
+      );
+      const failureMsg = `${AGENT_REGISTRY[session.agent].displayName}'s ACP adapter is unavailable \u2014 the session cannot start; redeploy or retry.`;
+      if (session.pluginAuthToken) {
+        await surfaceStartupFailure({
+          agent: session.agent,
+          pluginId,
+          detail: failureMsg,
+          recentStderr: "",
+          publisher: new AcpPublisher({
+            sessionId: session.id,
+            pluginId,
+            pluginAuthToken: session.pluginAuthToken,
+            refreshAuthToken: () => fetchCurrentPluginAuthToken(session.id, pluginId, session.pollSecret)
+          })
+        });
+        return;
+      }
+      showError(failureMsg);
+      process.exit(1);
+    }
+    if (!session.pluginAuthToken) {
       showError(
         `${AGENT_REGISTRY[session.agent].displayName} requires a paired session with an auth token. Re-pair with \`codeam pair\` to continue.`
       );
@@ -34825,6 +34910,9 @@ async function start(requestedAgent) {
     });
     return;
   }
+  if (requiresAcp(session.agent)) {
+    log.error("acp", `[anomaly] acp-required agent on PTY runtime (agent=${session.agent})`);
+  }
   const runtime = createRuntimeStrategy(session.agent);
   const historySvc = new HistoryService(runtime, pluginId, cwd, {
     pluginAuthToken: session.pluginAuthToken
@@ -37545,7 +37633,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.61.15" : "0.0.0-dev";
+  const cliVersion = true ? "2.61.17" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto12.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -38056,7 +38144,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.61.15" : "unknown";
+  const v = true ? "2.61.17" : "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.15",
+  "version": "2.61.17",
   "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",