codeam-cli 2.56.0 → 2.57.0

package/CHANGELOG.md

@@ -4,6 +4,14 @@ 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.56.0] — 2026-07-07
+
+### Changed
+
+- **cli:** Runner.ts dispatch table — AcpCommandContext replaces the 19-param handleCommand (Phase 3)
+- **cli:** Split host-agent.ts into commands/host/ modules + one spawnHeadroomProxy (Phase 3)
+- **cli:** Decompose previewStartH into stages + event-driven tunnel wait (Phase 3 wave 2)
+
 ## [2.55.1] — 2026-07-07
 
 ## [2.54.0] — 2026-07-06

package/dist/index.js

@@ -5621,7 +5621,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.56.0" : "0.0.0-dev",
+    cliVersion: true ? "2.57.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5802,7 +5802,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.56.0",
+  version: "2.57.0",
   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",
@@ -6850,7 +6850,7 @@ var CommandRelayService = class {
       // 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.56.0" ? { ideVersion: "2.56.0" } : {}
+      ..."2.57.0" ? { ideVersion: "2.57.0" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -15878,7 +15878,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.56.0" : null;
+  const current = true ? "2.57.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -15895,7 +15895,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.56.0" : null;
+  const current = true ? "2.57.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -15915,7 +15915,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.56.0" : null;
+  return true ? "2.57.0" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve7) => {
@@ -25478,67 +25478,6 @@ var AcpPublisher = class {
   }
 };
 
-// src/agents/acp/oneMContextRecovery.ts
-var ONE_M_CONTEXT_CREDITS_RE = /usage credits required for 1m context/i;
-function looksLike1mContextCreditsError(text) {
-  return ONE_M_CONTEXT_CREDITS_RE.test(text);
-}
-var ONE_M_DISABLE_OPTION = "Disable 1M context and continue";
-function shouldOfferOneMRecovery(opts) {
-  return looksLike1mContextCreditsError(opts.detail) || looksLike1mContextCreditsError(opts.recentStderr) || looksLike1mContextCreditsError(opts.finalText);
-}
-function oneMRecoverySelectPrompt() {
-  return {
-    question: "\u26A0\uFE0F This agent's Anthropic account needs usage credits for 1M context. You can disable 1M context (uses standard 200K context) and continue.",
-    options: [ONE_M_DISABLE_OPTION]
-  };
-}
-function createOneMRecovery(deps) {
-  let pending = null;
-  const sp = oneMRecoverySelectPrompt();
-  return {
-    offer: async (commandId, blocks) => {
-      pending = { blocks };
-      await deps.publishText(sp.question);
-      await deps.publishSelectPrompt(sp.question, sp.options);
-      await deps.publishAwaitingAnswer(sp.question, sp.options);
-      deps.appendAgentReply(sp.question);
-      deps.flushHistory();
-      deps.log?.(`1M-context credits gate \u2014 recovery offered id=${commandId.slice(0, 8)}`);
-      await deps.sendResult(commandId, "failed", {
-        error: "1M context requires usage credits \u2014 recovery offered"
-      });
-    },
-    tryRecover: async (commandId) => {
-      if (!pending) return false;
-      const blocks = pending.blocks;
-      pending = null;
-      deps.log?.("1M-context recovery \u2192 disable + reconnect + rerun");
-      await deps.reconnectWith1mDisabled();
-      await deps.beginTurn();
-      try {
-        const reply = await deps.promptAgent(blocks);
-        const finalText = deps.getCurrentText();
-        await deps.closeTurn();
-        deps.appendAgentReply(finalText);
-        deps.flushHistory();
-        await deps.sendResult(commandId, "completed", { stopReason: reply.stopReason });
-      } catch (err) {
-        await deps.recoverFromFailedTurn();
-        const d3 = deps.describeError(err);
-        const b = deps.failureBubbleFor(d3);
-        if (b) {
-          await deps.publishText(b);
-          deps.appendAgentReply(b);
-          deps.flushHistory();
-        }
-        await deps.sendResult(commandId, "failed", { error: d3 });
-      }
-      return true;
-    }
-  };
-}
-
 // src/agents/acp/budgetRecovery.ts
 var BUDGET_EXCEEDED_RE = /budget exceeded for (\w+) period/i;
 function looksLikeBudgetExceeded(text) {
@@ -26506,6 +26445,50 @@ function withTimeout(p2, ms) {
   });
 }
 
+// src/agents/acp/oneMContextRecovery.ts
+var ONE_M_CONTEXT_CREDITS_RE = /usage credits required for 1m context/i;
+function looksLike1mContextCreditsError(text) {
+  return ONE_M_CONTEXT_CREDITS_RE.test(text);
+}
+function shouldOfferOneMRecovery(opts) {
+  return looksLike1mContextCreditsError(opts.detail) || looksLike1mContextCreditsError(opts.recentStderr) || looksLike1mContextCreditsError(opts.finalText);
+}
+
+// src/agents/acp/agent-hooks.ts
+function replyIsCursorUpgradeRequired(finalText) {
+  const t2 = finalText.trim().toLowerCase();
+  if (t2.length === 0 || t2.length > 200) return false;
+  return t2.includes("upgrade your plan to continue") || t2.includes("upgrade your plan") && t2.includes("continue");
+}
+function isGeminiIneligibleTier(haystack) {
+  return /IneligibleTierError|UNSUPPORTED_CLIENT|no longer supported for Gemini Code Assist|not eligible for Gemini Code Assist/i.test(
+    haystack
+  );
+}
+var ACP_AGENT_HOOKS = {
+  claude: {
+    statusPage: { vendor: "Anthropic", url: "https://status.anthropic.com" }
+  },
+  codex: {
+    statusPage: { vendor: "OpenAI", url: "https://status.openai.com" },
+    startupExtraEnv: ({ autoApprovePermissions }) => autoApprovePermissions ? { INITIAL_AGENT_MODE: "agent-full-access" } : {}
+  },
+  gemini: {
+    statusPage: { vendor: "Google", url: "https://status.cloud.google.com" },
+    classifyStartupFailure: (haystack) => isGeminiIneligibleTier(haystack) ? "ineligible_tier" : null
+  },
+  copilot: {
+    statusPage: { vendor: "GitHub", url: "https://www.githubstatus.com" }
+  },
+  cursor: {
+    statusPage: { vendor: "Cursor", url: "https://status.cursor.com" },
+    classifyCompletedReply: (finalText) => replyIsCursorUpgradeRequired(finalText) ? "upgrade_required" : null
+  }
+};
+function agentHooks(agent) {
+  return ACP_AGENT_HOOKS[agent];
+}
+
 // src/agents/acp/failure-messages.ts
 function describeError(err) {
   if (err instanceof Error) return err.message;
@@ -26520,11 +26503,6 @@ function replyIsAuthFailure(finalText) {
   return t2.length > 0 && t2.length <= 200 && looksLikeAuthFailure(t2);
 }
 var AUTH_FAILURE_MESSAGE = "\u{1F512} **Authentication failed \u2014 your agent credentials are invalid or expired (API 401).**\n\nTap [Re-authenticate this agent](codeam://reauth) to renew your credentials in Profile \u203A Agents, then send your message again.";
-function replyIsCursorUpgradeRequired(finalText) {
-  const t2 = finalText.trim().toLowerCase();
-  if (t2.length === 0 || t2.length > 200) return false;
-  return t2.includes("upgrade your plan to continue") || t2.includes("upgrade your plan") && t2.includes("continue");
-}
 var CURSOR_UPGRADE_MESSAGE = "\u26A1 **Cursor needs a paid plan to run the agent.**\n\nThe headless Cursor Agent requires Cursor **Pro** \u2014 your Free plan\u2019s included usage does NOT cover Agent runs, even with quota left. This is your Cursor account (not CodeAgent). Upgrade, then send your message again:\n\n[Upgrade to Cursor Pro \u2192](https://cursor.com/dashboard)";
 var ONE_M_CREDITS_MESSAGE = "\u{1F504} **Reconnect your Claude subscription to continue.**\n\nClaude requested 1M-context but your account doesn\u2019t have the usage credits for it on this credential. Reconnecting refreshes your subscription so the agent can keep going \u2014 disabling 1M context won\u2019t fix a credits gate.\n\nTap [Reconnect this agent](codeam://reauth) to reconnect your Claude subscription in Profile \u203A Agents, then send your message again.";
 var TURN_FAILURE_MESSAGE = "\u26A0\uFE0F **The agent hit an error and couldn\u2019t finish this turn.** Please send your message again.";
@@ -26534,17 +26512,8 @@ function looksLikeProviderOutage(text) {
 }
 function agentStatusPage(agent) {
   const a = (agent ?? "").toLowerCase();
-  if (a.includes("claude") || a.includes("anthropic"))
-    return { vendor: "Anthropic", url: "https://status.anthropic.com" };
-  if (a.includes("codex") || a.includes("openai"))
-    return { vendor: "OpenAI", url: "https://status.openai.com" };
-  if (a.includes("gemini") || a.includes("google"))
-    return { vendor: "Google", url: "https://status.cloud.google.com" };
-  if (a.includes("copilot"))
-    return { vendor: "GitHub", url: "https://www.githubstatus.com" };
-  if (a.includes("cursor"))
-    return { vendor: "Cursor", url: "https://status.cursor.com" };
-  return null;
+  const id = a.includes("claude") || a.includes("anthropic") ? "claude" : a.includes("codex") || a.includes("openai") ? "codex" : a.includes("gemini") || a.includes("google") ? "gemini" : a.includes("copilot") ? "copilot" : a.includes("cursor") ? "cursor" : null;
+  return id ? agentHooks(id)?.statusPage ?? null : null;
 }
 function providerOutageMessage(agent) {
   const info = agentStatusPage(agent);
@@ -26555,15 +26524,10 @@ The agent provider returned an overload/outage error, so this turn couldn\u2019t
 
 Follow the status here: [${info.url}](${info.url})` : "");
 }
-function isGeminiIneligibleTier(haystack) {
-  return /IneligibleTierError|UNSUPPORTED_CLIENT|no longer supported for Gemini Code Assist|not eligible for Gemini Code Assist/i.test(
-    haystack
-  );
-}
 function startupFailureMessage(agent, detail, recentStderr) {
   const haystack = `${detail}
 ${recentStderr}`;
-  if (agent === "gemini" && isGeminiIneligibleTier(haystack)) {
+  if (agentHooks(agent)?.classifyStartupFailure?.(haystack) === "ineligible_tier") {
     return [
       "\u26A0\uFE0F **Gemini couldn't start \u2014 your Google account isn't eligible.**",
       "",
@@ -26750,19 +26714,13 @@ async function handleGetConversation(args2) {
 }
 function buildLegacyContextForACP(opts, relay, runtime) {
   return {
-    outputSvc: null,
-    agent: null,
-    historySvc: null,
     runtime,
     relay,
-    setKeepAlive: null,
-    keepAliveCtx: null,
     pluginId: opts.pluginId,
     sessionId: opts.sessionId,
     // The running ACP agent (claude/codex/gemini/cursor). REQUIRED: headroom_configure
     // resolves the agent from ctx.agentId; without it the enable gate sees '' and
-    // returns {supported:false} for a real Claude session (the `as unknown` cast
-    // below previously hid this missing field from the type checker).
+    // returns {supported:false} for a real Claude session.
     agentId: opts.agent,
     pluginAuthToken: opts.pluginAuthToken
   };
@@ -26820,7 +26778,7 @@ async function startTaskH(ctx) {
   try {
     const reply = await client2.prompt(blocks);
     const finalText = streaming.getCurrentText();
-    if (opts.agent === "cursor" && replyIsCursorUpgradeRequired(finalText)) {
+    if (agentHooks(opts.agent)?.classifyCompletedReply?.(finalText) === "upgrade_required") {
       await streaming.closeWithBubble(CURSOR_UPGRADE_MESSAGE);
       history.appendAgentReply(CURSOR_UPGRADE_MESSAGE);
       void history.flush();
@@ -26989,8 +26947,7 @@ async function ackEmptyH(ctx) {
   return;
 }
 async function selectOptionH(ctx) {
-  const { cmd, client: client2, relay, streaming, history, oneMRecovery, budgetRecovery } = ctx;
-  if (await oneMRecovery.tryRecover(cmd.id)) return;
+  const { cmd, client: client2, relay, streaming, history, budgetRecovery } = ctx;
   const payload = cmd.payload;
   const index = typeof payload?.index === "number" ? payload.index : 0;
   const offset = typeof payload?.from === "number" ? payload.from : 0;
@@ -27710,9 +27667,12 @@ function buildRelaunchProxyEnv(baseEnv) {
 function computeAdapterExtraEnv(params) {
   const env = {};
   if (params.disable1mContext) env.CLAUDE_CODE_DISABLE_1M_CONTEXT = "1";
-  if (params.agent === "codex" && params.autoApprovePermissions) {
-    env.INITIAL_AGENT_MODE = "agent-full-access";
-  }
+  Object.assign(
+    env,
+    agentHooks(params.agent)?.startupExtraEnv?.({
+      autoApprovePermissions: params.autoApprovePermissions
+    }) ?? {}
+  );
   return env;
 }
 async function runAcpSession(opts) {
@@ -27818,48 +27778,7 @@ async function runAcpSession(opts) {
       })();
     }
   };
-  let client2 = new AcpClient(clientOptions);
-  const reconnectWith1mDisabled = async () => {
-    setDisable1mContext(opts.pluginId, true);
-    try {
-      await client2.stop();
-    } catch {
-    }
-    client2 = new AcpClient({
-      ...clientOptions,
-      extraEnv: { ...extraEnv, CLAUDE_CODE_DISABLE_1M_CONTEXT: "1" }
-    });
-    await client2.start();
-  };
-  const oneMRecovery = createOneMRecovery({
-    publishText: (text) => publisher.publishOutput({ type: "text", content: text, done: true }),
-    publishSelectPrompt: (question, options) => publisher.publishOutput({
-      type: "select_prompt",
-      content: question,
-      options,
-      optionDescriptions: options.map(() => ""),
-      currentIndex: 0,
-      done: true
-    }),
-    // The button driver — mobile renders the tappable option from this
-    // awaiting-answer event; the user's tap returns as a `select_option`
-    // command, caught at the top of the select_option case by tryRecover.
-    publishAwaitingAnswer: (prompt, options) => publisher.publishAwaitingAnswer({ questionId: (0, import_node_crypto7.randomUUID)(), prompt, options }),
-    sendResult: (commandId, status2, result) => relay.sendResult(commandId, status2, result),
-    appendAgentReply: (text) => history.appendAgentReply(text),
-    flushHistory: () => void history.flush(),
-    beginTurn: () => streaming.beginTurn(),
-    getCurrentText: () => streaming.getCurrentText(),
-    closeTurn: async () => {
-      await streaming.closeTurnWithInteractiveDetection();
-    },
-    recoverFromFailedTurn: () => recoverFromFailedTurn(client2, streaming),
-    reconnectWith1mDisabled,
-    promptAgent: (blocks) => client2.prompt(blocks),
-    failureBubbleFor: (detail) => failureBubble({ detail, recentStderr: recentStderr.join("\n"), hadText: false, agent: opts.agent }),
-    describeError,
-    log: (msg) => log.info("acpRunner", msg)
-  });
+  const client2 = new AcpClient(clientOptions);
   let _budgetReachedPosted = false;
   const relaunchProxyWithoutBudget = async () => {
     const { spawn: spawn38 } = await import("child_process");
@@ -28013,7 +27932,6 @@ async function runAcpSession(opts) {
         getBeads,
         publisher,
         recentStderr,
-        oneMRecovery,
         budgetRecovery,
         { get: () => _budgetReachedPosted, set: (v) => {
           _budgetReachedPosted = v;
@@ -28052,7 +27970,7 @@ async function runAcpSession(opts) {
   await new Promise(() => {
   });
 }
-async function handleCommand(cmd, client2, relay, acpSessionId, models, streaming, opts, history, jsonlHistory, agentCaps, turnFiles, getBeads, publisher, recentStderr, oneMRecovery, budgetRecovery, budgetReachedFlag) {
+async function handleCommand(cmd, client2, relay, acpSessionId, models, streaming, opts, history, jsonlHistory, agentCaps, turnFiles, getBeads, publisher, recentStderr, budgetRecovery, budgetReachedFlag) {
   await dispatchAcpCommand({
     cmd,
     client: client2,
@@ -28068,7 +27986,6 @@ async function handleCommand(cmd, client2, relay, acpSessionId, models, streamin
     getBeads,
     publisher,
     recentStderr,
-    oneMRecovery,
     budgetRecovery,
     budgetReachedFlag
   });
@@ -31970,7 +31887,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.56.0" : "0.0.0-dev";
+  const cliVersion = true ? "2.57.0" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -32169,7 +32086,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.56.0" : "unknown";
+  const v = true ? "2.57.0" : "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.56.0",
+  "version": "2.57.0",
   "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",