codeam-cli 2.41.0 → 2.42.0

package/CHANGELOG.md

@@ -4,6 +4,16 @@ 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.41.0] — 2026-06-24
+
+### Added
+
+- **cli:** Surface friendly provider-outage message + status-page link instead of silent hang
+
+### Merge
+
+- Friendly provider-outage message + status-page link (no silent hang on provider 529/5xx)
+
 ## [2.40.2] — 2026-06-24
 
 ### Fixed

package/dist/index.js

@@ -5390,7 +5390,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.41.0" : "0.0.0-dev",
+    cliVersion: true ? "2.42.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5536,6 +5536,28 @@ var _execSeam = {
     return typeof out2 === "string" ? out2 : out2.toString("utf8");
   }
 };
+var _execSeamAsync = {
+  exec: (file, args2, opts) => new Promise((resolve7, reject) => {
+    (0, import_child_process.execFile)(file, args2, opts, (err, stdout) => {
+      if (err) reject(err);
+      else resolve7(typeof stdout === "string" ? stdout : stdout.toString("utf8"));
+    });
+  })
+};
+async function detectCurrentBranchAsync(cwd = process.cwd()) {
+  try {
+    const raw = await _execSeamAsync.exec("git", ["branch", "--show-current"], {
+      cwd,
+      timeout: 1e3,
+      encoding: "utf8",
+      windowsHide: true
+    });
+    const trimmed = raw.trim();
+    return trimmed.length > 0 ? trimmed : null;
+  } catch {
+    return null;
+  }
+}
 
 // src/services/command-relay.service.ts
 var https2 = __toESM(require("https"));
@@ -5549,7 +5571,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.41.0",
+  version: "2.42.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",
@@ -6044,13 +6066,31 @@ var CommandRelayService = class {
    */
   sseWatchdog = null;
   sseLastByteAt = 0;
+  /**
+   * Last-known git branch, shipped on every heartbeat. Seeded with a
+   * single SYNCHRONOUS read at `start()` (before any turn is running)
+   * for an accurate first beat, then refreshed ASYNCHRONOUSLY off the
+   * recurring heartbeat tick. The heartbeat POST reads this cached
+   * value and never spawns `git` synchronously — so the 20 s beat
+   * stays punctual even while a long agent tool call is hammering the
+   * event loop. Trade-off: because the async refresh fires alongside
+   * the POST (not before it), a `git checkout` propagates on the NEXT
+   * beat — up to ~40 s worst case vs the old at-POST-time read. The
+   * backend dedupes a stable branch, so this lag costs nothing but
+   * freshness, and a punctual heartbeat matters far more.
+   */
+  cachedBranch = null;
   start() {
     this.cleanup();
     this._running = true;
     this.agentsRegistered = false;
     log.info("relay", `start pluginId=${this.pluginId.slice(0, 8)} agent=${this.agentMeta.id}`);
+    this.cachedBranch = detectCurrentBranch();
     this.sendHeartbeat(true);
-    this.heartbeatTimer = setInterval(() => this.sendHeartbeat(true), 2e4);
+    this.heartbeatTimer = setInterval(() => {
+      void this.refreshBranch();
+      this.sendHeartbeat(true);
+    }, 2e4);
     this.agentsTimer = setInterval(() => {
       if (this._running && !this.agentsRegistered) this.reportAgents();
     }, 5e3);
@@ -6294,9 +6334,20 @@ var CommandRelayService = class {
       pluginId: this.pluginId,
       online,
       agentId: this.agentMeta.id,
-      branch: detectCurrentBranch()
+      branch: this.cachedBranch
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
+  /**
+   * Refresh {@link cachedBranch} without blocking the event loop.
+   * Fire-and-forget from the heartbeat tick; failures leave the last
+   * known value in place (the backend dedupes a stable branch).
+   */
+  async refreshBranch() {
+    try {
+      this.cachedBranch = await detectCurrentBranchAsync();
+    } catch {
+    }
+  }
   reportAgents() {
     const agents = this.agentsOverride ? [...this.agentsOverride] : [
       {
@@ -17753,7 +17804,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.41.0" : null;
+  const current = true ? "2.42.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -17770,7 +17821,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.41.0" : null;
+  const current = true ? "2.42.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -18208,7 +18259,7 @@ var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process14.s
   detached: false
 });
 function currentCliVersion() {
-  return true ? "2.41.0" : null;
+  return true ? "2.42.0" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve7) => {
@@ -24450,6 +24501,22 @@ var StreamingState = class {
       this.flushStreamingChunks()
     ]);
   }
+  /**
+   * Close the turn but REPLACE the streamed reply with `bubble` as the
+   * terminal chat frame. The chat pipe treats each `text` chunk's content as
+   * the full (replacing) bubble body, so a final `done:true` carrying the
+   * bubble overwrites whatever raw text streamed. Used when the agent's
+   * completed-turn reply was itself an auth-failure notice
+   * ({@link replyIsAuthFailure}) → swap the raw "Please run /login" for the
+   * actionable re-auth bubble.
+   */
+  async closeWithBubble(bubble) {
+    this.text = "";
+    await Promise.all([
+      this.publisher.publishOutput({ type: "text", content: bubble, done: true }),
+      this.flushStreamingChunks()
+    ]);
+  }
   /**
    * Re-emit every open streaming-chunk buffer with `isFinal: true`
    * so SessionDetailScreen's bubbles flip out of "still streaming"
@@ -24617,6 +24684,10 @@ var AUTH_FAILURE_RE = /invalid authentication credentials|authentication[_ ]erro
 function looksLikeAuthFailure(text) {
   return AUTH_FAILURE_RE.test(text);
 }
+function replyIsAuthFailure(finalText) {
+  const t2 = finalText.trim();
+  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.";
 var TURN_FAILURE_MESSAGE = "\u26A0\uFE0F **The agent hit an error and couldn\u2019t finish this turn.** Please send your message again.";
 var PROVIDER_OUTAGE_RE = /overloaded_error|\boverloaded\b|service[ _]unavailable|temporarily[ _]unavailable|(?:api error|http|status)[:\s]+(?:529|503|502|504)\b|\b(?:529|503|502|504)\b[^\n]{0,40}(?:overload|unavailable|gateway|upstream|server error)|bad gateway|gateway time-?out|upstream (?:error|connect|timeout)/i;
@@ -24631,8 +24702,10 @@ function agentStatusPage(agent) {
     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" };
+  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;
 }
 function providerOutageMessage(agent) {
@@ -24946,18 +25019,30 @@ async function handleCommand(cmd, client2, relay, acpSessionId, models, streamin
       try {
         const reply = await client2.prompt(blocks);
         const finalText = streaming.getCurrentText();
-        await streaming.closeTurnWithInteractiveDetection();
-        const replyLine = formatAgentReplyLine(finalText);
-        if (replyLine.length > 0) {
-          showInfo(replyLine);
+        if (replyIsAuthFailure(finalText)) {
+          await streaming.closeWithBubble(AUTH_FAILURE_MESSAGE);
+          history.appendAgentReply(AUTH_FAILURE_MESSAGE);
+          void history.flush();
+          turnFiles.flushTurn().catch((err) => {
+            log.warn("acpRunner", `turnFiles.flushTurn failed: ${describeError(err)}`);
+          });
+          void reportCredentialInvalid(opts);
+          log.info("acpRunner", `start_task \u2190 auth-failure-in-reply id=${cmd.id.slice(0, 8)}`);
+          await relay.sendResult(cmd.id, "failed", { error: "agent reply reported auth failure" });
+        } else {
+          await streaming.closeTurnWithInteractiveDetection();
+          const replyLine = formatAgentReplyLine(finalText);
+          if (replyLine.length > 0) {
+            showInfo(replyLine);
+          }
+          history.appendAgentReply(finalText);
+          void history.flush();
+          turnFiles.flushTurn().catch((err) => {
+            log.warn("acpRunner", `turnFiles.flushTurn failed: ${describeError(err)}`);
+          });
+          log.info("acpRunner", `start_task \u2190 done stopReason=${reply.stopReason ?? "?"} id=${cmd.id.slice(0, 8)}`);
+          await relay.sendResult(cmd.id, "completed", { stopReason: reply.stopReason });
         }
-        history.appendAgentReply(finalText);
-        void history.flush();
-        turnFiles.flushTurn().catch((err) => {
-          log.warn("acpRunner", `turnFiles.flushTurn failed: ${describeError(err)}`);
-        });
-        log.info("acpRunner", `start_task \u2190 done stopReason=${reply.stopReason ?? "?"} id=${cmd.id.slice(0, 8)}`);
-        await relay.sendResult(cmd.id, "completed", { stopReason: reply.stopReason });
       } catch (err) {
         const hadText = streaming.getCurrentText().trim().length > 0;
         await recoverFromFailedTurn(client2, streaming);
@@ -28900,9 +28985,9 @@ async function probeCodeamPair(provider, workspace) {
 }
 async function stopWorkspaceFromLocal(target) {
   if (target.provider.id === "github-codespaces") {
-    const { execFile: execFile12 } = await import("child_process");
+    const { execFile: execFile13 } = await import("child_process");
     const { promisify: promisify11 } = await import("util");
-    const execFileP10 = promisify11(execFile12);
+    const execFileP10 = promisify11(execFile13);
     await execFileP10("gh", ["codespace", "stop", "-c", target.id], { maxBuffer: 8 * 1024 * 1024 });
     return;
   }
@@ -29126,7 +29211,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.41.0" : "0.0.0-dev";
+  const cliVersion = true ? "2.42.0" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -29325,7 +29410,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors14 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.41.0" : "unknown";
+  const v = true ? "2.42.0" : "unknown";
   console.log(`${import_picocolors14.default.bold("codeam-cli")} ${import_picocolors14.default.cyan(v)}`);
 }
 

package/package.json

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