codeam-cli 2.43.0 → 2.43.2

package/CHANGELOG.md

@@ -4,6 +4,31 @@ 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.43.1] — 2026-06-24
+
+### Fixed
+
+- **cli:** 1M-context recovery must publish an awaiting-answer (the tappable button), not just a select_prompt chunk
+
+## [2.43.0] — 2026-06-24
+
+### Added
+
+- **cli:** Classify the 1M-context usage-credits error
+- **cli:** Persist per-session disable1mContext flag
+- **cli:** AcpClient accepts extraEnv for the adapter spawn
+- **cli:** OneMContextRecovery offer + decision helper
+- **cli:** OneMContextRecovery offer + decision helper + DI recovery factory
+- **cli:** On-demand 1M-context disable recovery — offer action, re-spawn ACP with the knob, auto-rerun
+
+### Changed
+
+- **cli:** Move 1M-context classifier into oneMContextRecovery (break runner import cycle)
+
+### Documentation
+
+- **meta:** Record agent-failure-messaging + heartbeat + credential rules (AGENTS.md + CLAUDE.md)
+
 ## [2.42.0] — 2026-06-24
 
 ### Added

package/dist/index.js

@@ -5397,7 +5397,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.43.0" : "0.0.0-dev",
+    cliVersion: true ? "2.43.2" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5578,7 +5578,7 @@ var os4 = __toESM(require("os"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.43.0",
+  version: "2.43.2",
   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",
@@ -17361,15 +17361,25 @@ function writeFile0600(filePath, contents) {
   fs37.writeFileSync(filePath, contents, { encoding: "utf8", mode: 384 });
   fs37.chmodSync(filePath, 384);
 }
+function rmIfExists(filePath) {
+  try {
+    fs37.rmSync(filePath, { force: true });
+  } catch {
+  }
+}
 var claudeProvisioner = {
   write(auth, home) {
+    const credentialsJson = path43.join(home, ".claude", ".credentials.json");
     if (auth.kind === "api_key") {
+      rmIfExists(credentialsJson);
       return { ANTHROPIC_API_KEY: auth.value };
     }
     const value = auth.value.trim();
     const isJsonBlob = value.startsWith("{");
     if (isJsonBlob) {
-      writeFile0600(path43.join(home, ".claude", ".credentials.json"), value);
+      writeFile0600(credentialsJson, value);
+    } else {
+      rmIfExists(credentialsJson);
     }
     const claudeJson = path43.join(home, ".claude.json");
     if (!fs37.existsSync(claudeJson)) {
@@ -17383,10 +17393,12 @@ var claudeProvisioner = {
 };
 var codexProvisioner = {
   write(auth, home) {
+    const authJson = path43.join(home, ".codex", "auth.json");
     if (auth.kind === "api_key") {
+      rmIfExists(authJson);
       return { OPENAI_API_KEY: auth.value };
     }
-    writeFile0600(path43.join(home, ".codex", "auth.json"), auth.value);
+    writeFile0600(authJson, auth.value);
     return {};
   }
 };
@@ -17811,7 +17823,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.43.0" : null;
+  const current = true ? "2.43.2" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -17828,7 +17840,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.43.0" : null;
+  const current = true ? "2.43.2" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -18266,7 +18278,7 @@ var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process14.s
   detached: false
 });
 function currentCliVersion() {
-  return true ? "2.43.0" : null;
+  return true ? "2.43.2" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve7) => {
@@ -23464,6 +23476,7 @@ function createOneMRecovery(deps) {
       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)}`);
@@ -23510,6 +23523,7 @@ function reconcileCumulative(existing, incoming) {
 }
 
 // src/agents/acp/onboarding.ts
+var import_child_process22 = require("child_process");
 var fs44 = __toESM(require("fs"));
 var os37 = __toESM(require("os"));
 var path51 = __toESM(require("path"));
@@ -23523,10 +23537,44 @@ var _onboardingSeam = {
   disabled: () => {
     const v = process.env.CODEAM_ONBOARDING_DISABLED;
     return !!v && v !== "0" && v.toLowerCase() !== "false";
+  },
+  /**
+   * The `origin` remote URL for `cwd`, or null when there's no git repo /
+   * remote. Seam so tests drive `resolveRepoName` without a real checkout.
+   */
+  gitRemoteUrl: (cwd) => {
+    try {
+      return (0, import_child_process22.execFileSync)("git", ["-C", cwd, "remote", "get-url", "origin"], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: 2e3
+      }).trim();
+    } catch {
+      return null;
+    }
   }
 };
+function isUuid(s) {
+  return /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(s);
+}
+function repoNameFromRemoteUrl(url) {
+  const m = url.trim().replace(/\.git$/, "").replace(/\/$/, "").match(/[/:]([^/]+)\/([^/]+)$/);
+  return m ? m[2] : null;
+}
+function resolveRepoName(cwd) {
+  if (cwd) {
+    const url = _onboardingSeam.gitRemoteUrl(cwd);
+    if (url) {
+      const name = repoNameFromRemoteUrl(url);
+      if (name) return name;
+    }
+  }
+  const base = path51.basename(cwd || "");
+  if (base && !isUuid(base)) return base;
+  return "this project";
+}
 function buildOnboardingWelcome(cwd) {
-  const repo = path51.basename(cwd || "") || "this project";
+  const repo = resolveRepoName(cwd);
   return [
     `Welcome to CodeAgent Mobile! \u{1F44B} You're now driving this agent from your phone \u2014 and it comes fully wired, zero setup:`,
     "",
@@ -23798,7 +23846,7 @@ function extractSelectPrompt(text) {
 var import_crypto5 = require("crypto");
 
 // src/services/turn-files/git-changeset.ts
-var import_child_process22 = require("child_process");
+var import_child_process23 = require("child_process");
 var fs45 = __toESM(require("fs/promises"));
 var path52 = __toESM(require("path"));
 async function collectRepoChangeset(opts) {
@@ -23913,7 +23961,7 @@ function defaultRunGit(cwd, args2) {
   return new Promise((resolve7) => {
     let proc;
     try {
-      proc = (0, import_child_process22.spawn)("git", args2, { cwd, env: process.env });
+      proc = (0, import_child_process23.spawn)("git", args2, { cwd, env: process.env });
     } catch {
       resolve7(null);
       return;
@@ -24953,6 +25001,10 @@ async function runAcpSession(opts) {
       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(),
@@ -27165,11 +27217,11 @@ async function logout() {
 var import_picocolors11 = __toESM(require("picocolors"));
 
 // src/services/providers/github-codespaces.ts
-var import_child_process23 = require("child_process");
+var import_child_process24 = require("child_process");
 var import_util4 = require("util");
 var import_picocolors9 = __toESM(require("picocolors"));
 var path55 = __toESM(require("path"));
-var execFileP6 = (0, import_util4.promisify)(import_child_process23.execFile);
+var execFileP6 = (0, import_util4.promisify)(import_child_process24.execFile);
 var MAX_BUFFER = 8 * 1024 * 1024;
 function resetStdinForChild() {
   if (process.stdin.isTTY) {
@@ -27213,7 +27265,7 @@ var GitHubCodespacesProvider = class {
     if (!isAuthed) {
       resetStdinForChild();
       await new Promise((resolve7, reject) => {
-        const proc = (0, import_child_process23.spawn)("gh", ["auth", "login", "-s", "codespace,repo,read:user"], {
+        const proc = (0, import_child_process24.spawn)("gh", ["auth", "login", "-s", "codespace,repo,read:user"], {
           stdio: "inherit"
         });
         proc.on("exit", (code) => {
@@ -27247,7 +27299,7 @@ var GitHubCodespacesProvider = class {
       wt(noteLines.join("\n"), "One more permission needed");
       resetStdinForChild();
       const refreshCode = await new Promise((resolve7, reject) => {
-        const proc = (0, import_child_process23.spawn)(
+        const proc = (0, import_child_process24.spawn)(
           "gh",
           ["auth", "refresh", "-h", "github.com", "-s", "codespace"],
           { stdio: "inherit" }
@@ -27397,7 +27449,7 @@ var GitHubCodespacesProvider = class {
     O2.step(`Installing gh via ${installCmd.describe}\u2026`);
     resetStdinForChild();
     const ok = await new Promise((resolve7) => {
-      const proc = (0, import_child_process23.spawn)(installCmd.exe, installCmd.args, { stdio: "inherit" });
+      const proc = (0, import_child_process24.spawn)(installCmd.exe, installCmd.args, { stdio: "inherit" });
       proc.on("exit", (code) => resolve7(code === 0));
       proc.on("error", () => resolve7(false));
     });
@@ -27424,7 +27476,7 @@ var GitHubCodespacesProvider = class {
     );
     resetStdinForChild();
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process23.spawn)(
+      const proc = (0, import_child_process24.spawn)(
         "gh",
         ["auth", "refresh", "-h", "github.com", "-s", "repo,read:org"],
         { stdio: "inherit" }
@@ -27602,7 +27654,7 @@ var GitHubCodespacesProvider = class {
   async streamCommand(workspaceId, command2) {
     resetStdinForChild();
     return new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process23.spawn)(
+      const proc = (0, import_child_process24.spawn)(
         "gh",
         ["codespace", "ssh", "-c", workspaceId, "--", "-tt", command2],
         { stdio: "inherit" }
@@ -27629,11 +27681,11 @@ var GitHubCodespacesProvider = class {
       `mkdir -p ${shellQuote(remoteDir)} && tar -xzf - -C ${shellQuote(remoteDir)}`
     ];
     await new Promise((resolve7, reject) => {
-      const tar = (0, import_child_process23.spawn)("tar", tarArgs, {
+      const tar = (0, import_child_process24.spawn)("tar", tarArgs, {
         stdio: ["ignore", "pipe", "pipe"],
         env: tarEnv
       });
-      const ssh = (0, import_child_process23.spawn)("gh", sshArgs, {
+      const ssh = (0, import_child_process24.spawn)("gh", sshArgs, {
         stdio: [tar.stdout, "pipe", "pipe"]
       });
       let tarErr = "";
@@ -27667,7 +27719,7 @@ var GitHubCodespacesProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process23.spawn)(
+      const proc = (0, import_child_process24.spawn)(
         "gh",
         ["codespace", "ssh", "-c", workspaceId, "--", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -27725,11 +27777,11 @@ function shellQuote(s) {
 }
 
 // src/services/providers/gitpod.ts
-var import_child_process24 = require("child_process");
+var import_child_process25 = require("child_process");
 var import_util5 = require("util");
 var path56 = __toESM(require("path"));
 var import_picocolors10 = __toESM(require("picocolors"));
-var execFileP7 = (0, import_util5.promisify)(import_child_process24.execFile);
+var execFileP7 = (0, import_util5.promisify)(import_child_process25.execFile);
 var MAX_BUFFER2 = 8 * 1024 * 1024;
 function resetStdinForChild2() {
   if (process.stdin.isTTY) {
@@ -27769,7 +27821,7 @@ var GitpodProvider = class {
     );
     resetStdinForChild2();
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process24.spawn)("gitpod", ["login"], { stdio: "inherit" });
+      const proc = (0, import_child_process25.spawn)("gitpod", ["login"], { stdio: "inherit" });
       proc.on("exit", (code) => {
         if (code === 0) resolve7();
         else reject(new Error("gitpod login failed."));
@@ -27921,7 +27973,7 @@ var GitpodProvider = class {
   async streamCommand(workspaceId, command2) {
     resetStdinForChild2();
     return new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process24.spawn)(
+      const proc = (0, import_child_process25.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", "-tt", command2],
         { stdio: "inherit" }
@@ -27941,11 +27993,11 @@ var GitpodProvider = class {
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote2(remoteDir)} && tar -xzf - -C ${shellQuote2(remoteDir)}`;
     await new Promise((resolve7, reject) => {
-      const tar = (0, import_child_process24.spawn)("tar", tarArgs, {
+      const tar = (0, import_child_process25.spawn)("tar", tarArgs, {
         stdio: ["ignore", "pipe", "pipe"],
         env: tarEnv
       });
-      const ssh = (0, import_child_process24.spawn)(
+      const ssh = (0, import_child_process25.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -27977,7 +28029,7 @@ var GitpodProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process24.spawn)(
+      const proc = (0, import_child_process25.spawn)(
         "gitpod",
         ["workspace", "ssh", workspaceId, "--", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -28001,10 +28053,10 @@ function shellQuote2(s) {
 }
 
 // src/services/providers/gitlab-workspaces.ts
-var import_child_process25 = require("child_process");
+var import_child_process26 = require("child_process");
 var import_util6 = require("util");
 var path57 = __toESM(require("path"));
-var execFileP8 = (0, import_util6.promisify)(import_child_process25.execFile);
+var execFileP8 = (0, import_util6.promisify)(import_child_process26.execFile);
 var MAX_BUFFER3 = 8 * 1024 * 1024;
 var GITLAB_API_BASE = process.env.CODEAM_GITLAB_API_URL ?? "https://gitlab.com/api/v4";
 function resetStdinForChild3() {
@@ -28046,7 +28098,7 @@ var GitLabWorkspacesProvider = class {
     );
     resetStdinForChild3();
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process25.spawn)(
+      const proc = (0, import_child_process26.spawn)(
         "glab",
         ["auth", "login", "--scopes", "api,read_user,read_repository"],
         { stdio: "inherit" }
@@ -28218,7 +28270,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
     const sshHost = process.env.CODEAM_GITLAB_SSH_HOST ?? "workspaces.gitlab.com";
     resetStdinForChild3();
     return new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process25.spawn)(
+      const proc = (0, import_child_process26.spawn)(
         "ssh",
         ["-tt", "-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, command2],
         { stdio: "inherit" }
@@ -28239,8 +28291,8 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote3(remoteDir)} && tar -xzf - -C ${shellQuote3(remoteDir)}`;
     await new Promise((resolve7, reject) => {
-      const tar = (0, import_child_process25.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
-      const ssh = (0, import_child_process25.spawn)(
+      const tar = (0, import_child_process26.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
+      const ssh = (0, import_child_process26.spawn)(
         "ssh",
         ["-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -28270,7 +28322,7 @@ Docs: https://docs.gitlab.com/ee/user/workspace/configuration.html`
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process25.spawn)(
+      const proc = (0, import_child_process26.spawn)(
         "ssh",
         ["-o", "StrictHostKeyChecking=accept-new", `${workspaceId}@${sshHost}`, cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -28329,10 +28381,10 @@ function shellQuote3(s) {
 }
 
 // src/services/providers/railway.ts
-var import_child_process26 = require("child_process");
+var import_child_process27 = require("child_process");
 var import_util7 = require("util");
 var path58 = __toESM(require("path"));
-var execFileP9 = (0, import_util7.promisify)(import_child_process26.execFile);
+var execFileP9 = (0, import_util7.promisify)(import_child_process27.execFile);
 var MAX_BUFFER4 = 8 * 1024 * 1024;
 function resetStdinForChild4() {
   if (process.stdin.isTTY) {
@@ -28373,7 +28425,7 @@ var RailwayProvider = class {
     );
     resetStdinForChild4();
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process26.spawn)("railway", ["login"], { stdio: "inherit" });
+      const proc = (0, import_child_process27.spawn)("railway", ["login"], { stdio: "inherit" });
       proc.on("exit", (code) => {
         if (code === 0) resolve7();
         else reject(new Error("railway login failed."));
@@ -28516,7 +28568,7 @@ var RailwayProvider = class {
     }
     resetStdinForChild4();
     return new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process26.spawn)(
+      const proc = (0, import_child_process27.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", command2],
         { stdio: "inherit" }
@@ -28540,8 +28592,8 @@ var RailwayProvider = class {
     const tarEnv = { ...process.env, COPYFILE_DISABLE: "1" };
     const remoteCmd = `mkdir -p ${shellQuote4(remoteDir)} && tar -xzf - -C ${shellQuote4(remoteDir)}`;
     await new Promise((resolve7, reject) => {
-      const tar = (0, import_child_process26.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
-      const sh = (0, import_child_process26.spawn)(
+      const tar = (0, import_child_process27.spawn)("tar", tarArgs, { stdio: ["ignore", "pipe", "pipe"], env: tarEnv });
+      const sh = (0, import_child_process27.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", remoteCmd],
         { stdio: [tar.stdout, "pipe", "pipe"] }
@@ -28574,7 +28626,7 @@ var RailwayProvider = class {
     }
     const cmd = parts.join(" && ");
     await new Promise((resolve7, reject) => {
-      const proc = (0, import_child_process26.spawn)(
+      const proc = (0, import_child_process27.spawn)(
         "railway",
         ["shell", "--project", projectId, "--service", serviceId, "--command", cmd],
         { stdio: ["pipe", "pipe", "pipe"] }
@@ -29324,7 +29376,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.43.0" : "0.0.0-dev";
+  const cliVersion = true ? "2.43.2" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -29523,7 +29575,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors14 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.43.0" : "unknown";
+  const v = true ? "2.43.2" : "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.43.0",
+  "version": "2.43.2",
   "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",