codeam-cli 2.18.2 → 2.20.0

package/CHANGELOG.md

@@ -4,6 +4,129 @@ 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.19.0] — 2026-05-24
+
+### Added
+
+- **both-plugins:** PostHog telemetry, mirrors the CLI (closes #95) (#142)
+- **both-plugins:** Bundle Hanken Grotesk + JetBrains Mono fonts (closes #96) (#147)
+- **vsc-plugin:** Add Copy Install Command CTA to empty agents state (closes #116) (#166)
+- **vsc-plugin:** 3-state status bar with rich Markdown tooltip (closes #115) (#167)
+- **both-plugins:** All-detector agent discovery; enable cursor/coderabbit/aider (closes #102 follow-up) (#171)
+- **both-plugins:** A11y pass — ARIA, focus rings, mnemonics, focus order (closes #106) (#172)
+- **both-plugins:** FooterStatusStrip — at-a-glance connection summary (closes #114) (#174)
+- **vsc-plugin:** Brand polish — GlassCard + cyberpunk h3 voice (closes #79) (#175)
+
+### CI
+
+- Drop node 18 + skip Vitest on Windows + advisory backend probes (#128)
+
+### Changed
+
+- **vsc-plugin:** Split controller-panel.ts (partial #89) (#143)
+- **jetbrains-plugin:** Extract RemoteCommandRouter (partial #89) (#144)
+- **jetbrains-plugin:** Split AgentOutputMonitor — publisher + text utils (partial #89) (#145)
+- **both-plugins:** Remove dead WebSocketService + AgentBridgeService (closes #90) (#149)
+- **jetbrains-plugin:** Extract RoundedPanel + DeviceConnectionPanel (further #89) (#151)
+- **jetbrains-plugin:** Split TerminalAgentService — publisher + reader (further #89) (#152)
+- **jetbrains-plugin:** Extract Swing-walk helpers from AgentOutputMonitor (further #89) (#153)
+- **jetbrains-plugin:** Extract Cascade JS + Codeium process tap (further #89) (#154)
+- **jetbrains-plugin:** Extract AIAssistant text-extraction helpers (further #89) (#155)
+- **jetbrains-plugin:** Extract JcefCaptureState from AgentOutputMonitor (closes #89 follow-up) (#156)
+- **jetbrains-plugin:** Split ControllerPanel HTTP + QR + row factory (closes #89 follow-up) (#157)
+- **shared:** Centralize PROTOCOL_VERSION + lifecycle constants (closes #97) (#164)
+- **both-plugins:** Lock notification voice to canonical CodeAgent Mobile copy (closes #105) (#165)
+- **vsc-plugin:** Deprecate Claude PTY-directo + Claude handlers (closes #102) (#169)
+- **jetbrains-plugin:** Deprecate Claude PTY-directo + handlers (closes #102) (#170)
+
+### Chore
+
+- **jetbrains-plugin:** Delete dead RobotPasteStrategy (partial #90) (#139)
+- **workflow:** Delete release-single.yml — drift surface (closes #110) (#158)
+- **both-plugins:** Wire logger.trace into every empty catch (closes #111) (#173)
+
+### Fixed
+
+- **ci:** Smoke test reads stderr too — banners moved off stdout in v2.18.x
+- **vsc-plugin:** Add webview CSP + render QR locally (closes #70) (#117)
+- **both-plugins:** Store pluginAuthToken in SecretStorage / PasswordSafe (closes #71) (#118)
+- **vsc-plugin:** Authenticate the observer-bridge on 127.0.0.1:47832 (closes #72) (#119)
+- **vsc-plugin:** Realpath candidate + workspace before sandbox check (closes #73) (#120)
+- **vsc-plugin:** Gate workbench-injection cleanup behind a one-shot flag (closes #74) (#121)
+- **jetbrains-plugin:** Drop untilBuild cap + re-enable plugin-structure warnings (closes #76) (#122)
+- **jetbrains-plugin:** Adopt CodeAgent Mobile brand palette + drop stale strings (closes #80) (#123)
+- **jetbrains-plugin:** Lift resume_session 500ms sleeps off EDT + WS reader (partial #75) (#124)
+- **jetbrains-plugin:** Surface action group under Tools menu (closes #77) (#125)
+- **both-plugins:** 401 recovery — clear token, stop transports, surface re-pair UX (closes #78) (#126)
+- **vsc-plugin:** Adopt CodeAgent brand palette in webview (partial #79) (#127)
+- **cli:** Make tests + parser cross-platform; restore Windows in CI (#129)
+- **both-plugins:** Align clearRemoteOutput on CLI wire shape (closes #83) (#130)
+- **both-plugins:** Honor heartbeatIntervalMs setting in CommandRelayService (closes #84) (#131)
+- **both-plugins:** Cap base64 attachments at 10 MB (closes #92) (#132)
+- **both-plugins:** Refuse to overwrite malformed MCP config (closes #93) (#133)
+- **vsc-plugin:** Exclude .pdb + tests from .vsix (closes #86) (#134)
+- **both-plugins:** De-dup commands by id on SSE reconnect (closes #85) (#135)
+- **both-plugins:** Surface a 3-state Connected/Reconnecting/Offline dot (closes #94) (#136)
+- **both-plugins:** Align strategy contract — same fields + StrategyResult (closes #82) (#137)
+- **vsc-plugin:** Defer eager activation work to first pair (closes #87) (#138)
+- **both-plugins:** Align command-handler surface (closes #81) (#140)
+- **vsc-plugin:** Drop Python PTY helper, route Claude through node-pty (closes #88) (#146)
+- **jetbrains-plugin:** Lift remaining EDT-blocking sites in dispatch (closes #75) (#150)
+- **jetbrains-plugin:** Multi-IDE verifier matrix + dynamic-plugin marker (closes #100, #108) (#159)
+- **jetbrains-plugin:** Track all known projects in IdeIntegrationService (closes #99) (#160)
+- **vsc-plugin:** Per-window port + per-workspace pluginId (closes #103) (#161)
+- **vsc-plugin:** Cache SettingsService config + react to mid-session changes (closes #107) (#162)
+- **vsc-plugin:** Drop \`as unknown as Record<string, unknown>\` casts (closes #104) (#163)
+
+### Tests
+
+- **vsc-plugin:** Cover webview-security helpers + extract sanitizeSessionId (partial #91) (#141)
+- **vsc-plugin:** Cover CommandRelayService dispatch + dedup + state (closes #91) (#148)
+
+## [2.18.2] — 2026-05-24
+
+### Fixed
+
+- **cli:** Doctor node-pty check uses vendored loader + skips non-windows
+
+## [2.18.1] — 2026-05-24
+
+### Added
+
+- **cli:** Split AgentStrategy into Interactive + Batch shapes (#58)
+- **cli:** CodeRabbit BatchAgentStrategy (#59)
+- **cli:** Cursor agent strategy (InteractiveAgentStrategy) (#60)
+- **cli:** Aider agent strategy (InteractiveAgentStrategy) (#61)
+- **cli:** \`codeam doctor\` diagnostic command (#64)
+- **cli:** PostHog telemetry with full session + user context (#65)
+- **cli:** Log rotation + JSON mode + XDG-aware paths (#66)
+- **cli:** Quick wins bundle — banner→stderr, unknown cmd, exit-codes, --api-key-file, logout heartbeat (#67)
+- **cli:** Unknown-command typo suggester + shell completion command (#68)
+
+### CI
+
+- **cli:** MacOS runner + Node 18/20/22 matrix + coverage gate (#63)
+
+### Changed
+
+- **cli:** Extract OsStrategy interface — pure helpers slice (#48)
+- **cli:** Move buildClaudeLaunch wrap to OsStrategy.buildLaunch (#49)
+- **cli:** Inject OsStrategy into RuntimeStrategy — compose, don't branch (#50)
+- **cli:** Move PTY factories under OsStrategy.createPtyStrategies (#51)
+- **cli:** Relocate claude-resolver + claude-installer to agents/claude/ (#53)
+- **cli:** Extract LinkStrategy + drop link.ts AGENT_META hardcode (#56)
+- **cli:** Switch HistoryService to /api/sessions/conversation + /list (#54)
+
+### Fixed
+
+- **cli:** AgentService.restart routes through RuntimeStrategy (#52)
+- **cli:** Cap PtyBuffer + StreamingEmitter rawBuffer + eager cleanup on exit (#57)
+- **cli:** Doctor marks agent-binary probes as optional
+
+### Tests
+
+- **cli:** Agent contract suite — one spec runs against every registered agent (#62)
+
 ## [2.17.7] — 2026-05-24
 
 ### Fixed

package/dist/index.js

@@ -89,6 +89,9 @@ var require_src = __commonJS({
 // src/commands/start.ts
 var import_picocolors2 = __toESM(require("picocolors"));
 
+// ../../packages/shared/src/protocol/constants.ts
+var PROTOCOL_VERSION = "2.0.0";
+
 // ../../packages/shared/src/protocol/renderToLines.ts
 function renderToLines(raw) {
   const screen = [""];
@@ -275,11 +278,7 @@ var AGENT_REGISTRY = {
     id: "coderabbit",
     displayName: "CodeRabbit",
     binaryName: "coderabbit",
-    // Gated behind a feature flag until the per-agent contract test +
-    // a real PR review smoke pass on a paid CodeRabbit tenant. Strategy
-    // is fully implemented (BatchAgentStrategy); the flip from false →
-    // true happens in a follow-up release.
-    enabled: false,
+    enabled: true,
     supportedAuthKinds: ["oauth_token", "api_key"],
     preferredAuthKind: "oauth_token"
   },
@@ -287,12 +286,7 @@ var AGENT_REGISTRY = {
     id: "cursor",
     displayName: "Cursor Agent",
     binaryName: "cursor-agent",
-    // Gated. Strategy implemented as InteractiveAgentStrategy; TUI
-    // parser borrows the Codex baseline because Cursor's CLI ships a
-    // similar ratatui-style chrome. Real parser fixtures need to be
-    // captured against a paid Cursor account before the flag flips
-    // false → true.
-    enabled: false,
+    enabled: true,
     supportedAuthKinds: ["oauth_token", "api_key"],
     preferredAuthKind: "oauth_token"
   },
@@ -300,12 +294,10 @@ var AGENT_REGISTRY = {
     id: "aider",
     displayName: "Aider",
     binaryName: "aider",
-    // Gated. Aider is OAuth-less — auth is ANTHROPIC_API_KEY / OPENAI_API_KEY
-    // / etc. env vars. The link flow surfaces this via the existing
-    // --api-key escape hatch in commands/link.ts. Flip false → true
-    // after a real PTY capture lands + the contract test passes.
-    enabled: false,
-    // Aider only supports api_key (raw model-provider key, not OAuth).
+    enabled: true,
+    // Aider is OAuth-less — auth is via ANTHROPIC_API_KEY / OPENAI_API_KEY
+    // / etc. env vars or `~/.aider.conf.yml`. The link flow surfaces
+    // this via the existing --api-key escape hatch in commands/link.ts.
     supportedAuthKinds: ["api_key"],
     preferredAuthKind: "api_key"
   }
@@ -324,6 +316,15 @@ function isKnownAgentId(id) {
 
 // ../../packages/shared/src/api-url.ts
 var DEFAULT_API_BASE_URL = "https://api.codeagent-mobile.com";
+var DEV_API_BASE_URL = "https://dev-api.codeagent-mobile.com";
+function resolveApiBaseUrl() {
+  const env = globalThis.process?.env;
+  const explicit = env?.CODEAM_API_URL?.trim();
+  if (explicit) return explicit;
+  const testFlag = env?.CODEAM_TEST_MODE?.trim();
+  if (testFlag === "1" || testFlag?.toLowerCase() === "true") return DEV_API_BASE_URL;
+  return DEFAULT_API_BASE_URL;
+}
 
 // src/config.ts
 var fs = __toESM(require("fs"));
@@ -440,7 +441,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.18.2",
+  version: "2.20.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",
@@ -627,7 +628,7 @@ function computePollDelay({ baseMs, failures }) {
 }
 
 // src/services/pairing.service.ts
-var API_BASE = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+var API_BASE = resolveApiBaseUrl();
 async function requestCode(pluginId) {
   try {
     const runtime = process.env.CODESPACES === "true" ? "github-codespaces" : "local";
@@ -5739,7 +5740,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.18.2" : "0.0.0-dev",
+    cliVersion: true ? "2.20.0" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -5830,7 +5831,7 @@ function maybePrintFirstRunBanner() {
 }
 
 // src/services/command-relay.service.ts
-var API_BASE2 = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+var API_BASE2 = resolveApiBaseUrl();
 var CommandRelayService = class {
   constructor(pluginId, onCommand, agentMeta) {
     this.pluginId = pluginId;
@@ -10599,7 +10600,7 @@ var SEVERITY_MAP = {
 };
 function parseReview(stdout) {
   const hunks = [];
-  const lines = stdout.split("\n");
+  const lines = stdout.split(/\r?\n/);
   for (const line of lines) {
     const m = line.match(HUNK_LINE_RE);
     if (!m) continue;
@@ -11165,17 +11166,13 @@ var ChromeStepTracker = class {
 // src/services/output/chunk-emitter.ts
 var https3 = __toESM(require("https"));
 var http3 = __toESM(require("http"));
-var API_BASE3 = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+var API_BASE3 = resolveApiBaseUrl();
 var ChunkEmitter = class {
   constructor(opts) {
     this.opts = opts;
     this.headers = {
       "Content-Type": "application/json",
-      // Tell the backend which wire-format version we speak so
-      // it can route legacy translations / 426 us when we're
-      // too far behind. Bumped to 2.0.0 with the discriminated-
-      // chunk + delta-chrome refactor in this release.
-      "X-Codeam-Protocol-Version": "2.0.0",
+      "X-Codeam-Protocol-Version": PROTOCOL_VERSION,
       ...vercelBypassHeader()
     };
     if (opts.pluginAuthToken) {
@@ -11674,7 +11671,7 @@ var historyRecordSchema = import_zod.z.object({
     content: import_zod.z.union([import_zod.z.string(), import_zod.z.array(import_zod.z.unknown())]).optional()
   }).passthrough().optional()
 }).passthrough();
-var API_BASE4 = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+var API_BASE4 = resolveApiBaseUrl();
 function extractText2(content) {
   if (typeof content === "string") return content;
   if (Array.isArray(content)) {
@@ -12281,7 +12278,7 @@ function _post2(url, headers, payload) {
 }
 
 // src/services/file-watcher.service.ts
-var API_BASE5 = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+var API_BASE5 = resolveApiBaseUrl();
 var DEBOUNCE_MS = 250;
 var MAX_RETRIES = 2;
 var RETRY_BACKOFF_MS = 300;
@@ -12757,7 +12754,7 @@ function _get(url, headers) {
 }
 
 // src/services/streaming-emitter.service.ts
-var API_BASE6 = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+var API_BASE6 = resolveApiBaseUrl();
 var TICK_MS = 50;
 var ANSWER_POLL_MS = 1500;
 var SELECTOR_STABLE_MS = 800;
@@ -14629,7 +14626,7 @@ async function pair(args2 = []) {
 var fs24 = __toESM(require("fs"));
 var os24 = __toESM(require("os"));
 var import_crypto6 = require("crypto");
-var API_BASE7 = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+var API_BASE7 = resolveApiBaseUrl();
 function fail(msg) {
   console.error(`
   ${msg}
@@ -14859,7 +14856,7 @@ function status() {
 
 // src/commands/logout.ts
 var import_picocolors6 = __toESM(require("picocolors"));
-var API_BASE8 = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+var API_BASE8 = resolveApiBaseUrl();
 async function notifyBackendOffline() {
   const cfg = loadCliConfig();
   const pluginIds = /* @__PURE__ */ new Set([
@@ -17333,8 +17330,8 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.18.2" : "0.0.0-dev";
-  const apiBase = process.env.CODEAM_API_URL ?? DEFAULT_API_BASE_URL;
+  const cliVersion = true ? "2.20.0" : "0.0.0-dev";
+  const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto5.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
   const [dns, health] = await Promise.all([
@@ -17384,6 +17381,13 @@ ${import_picocolors12.default.bold("  codeam doctor")}
 `);
   out2.write(`  ${import_picocolors12.default.dim("api")}      ${r.apiBase}
 `);
+  if (process.env.CODEAM_TEST_MODE === "1" || process.env.CODEAM_TEST_MODE?.toLowerCase() === "true") {
+    out2.write(`  ${import_picocolors12.default.dim("mode")}     ${import_picocolors12.default.yellow("TEST_MODE \u2014 using dev preview")}
+`);
+  } else if (process.env.CODEAM_API_URL) {
+    out2.write(`  ${import_picocolors12.default.dim("mode")}     ${import_picocolors12.default.yellow("CODEAM_API_URL override")}
+`);
+  }
   out2.write(`  ${import_picocolors12.default.dim("diag id")}  ${r.diagnosticId}
 `);
   out2.write("\n");
@@ -17525,7 +17529,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.18.2" : "unknown";
+  const v = true ? "2.20.0" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -17753,7 +17757,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.18.2" : null;
+  const current = true ? "2.20.0" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;

package/package.json

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