codeam-cli 2.39.20 → 2.39.22

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.39.21] — 2026-06-16
+
+### Fixed
+
+- **cli:** Serialize onboarding welcome before the command relay starts (#343)
+
+## [2.39.20] — 2026-06-15
+
+### Fixed
+
+- **cli:** Handle ACP adapter spawn errors instead of crashing the relay
+
 ## [2.39.19] — 2026-06-15
 
 ### Fixed

package/dist/index.js

@@ -498,7 +498,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.39.20",
+  version: "2.39.22",
   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",
@@ -5908,7 +5908,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.39.20" : "0.0.0-dev",
+    cliVersion: true ? "2.39.22" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -15451,7 +15451,7 @@ function buildOnboardingWelcome(cwd) {
     `Ready when you are \u2014 try **"explain ${repo}"** or **"what should I work on first?"**`
   ].join("\n");
 }
-function maybeSendOnboardingWelcome(opts) {
+async function maybeSendOnboardingWelcome(opts) {
   if (_onboardingSeam.disabled()) return;
   const marker = _onboardingSeam.markerPath(opts.sessionId);
   try {
@@ -15462,17 +15462,19 @@ function maybeSendOnboardingWelcome(opts) {
     return;
   }
   log.info("acpRunner", `sending first-pair onboarding welcome for session=${opts.sessionId.slice(0, 8)}`);
-  void runOnboardingTurn(opts).catch((err) => {
+  try {
+    await runOnboardingTurn(opts);
+  } catch (err) {
     log.warn(
       "acpRunner",
       `onboarding welcome turn failed (non-fatal): ${err instanceof Error ? err.message : String(err)}`
     );
-  });
+  }
 }
 async function runOnboardingTurn(opts) {
   const { streaming, history, cwd } = opts;
   const welcome = buildOnboardingWelcome(cwd);
-  await streaming.beginTurn();
+  await streaming.beginTurn({ clear: false });
   try {
     streaming.append({ chunkId: "onboarding-welcome", kind: "text", delta: welcome });
     await streaming.closeAll();
@@ -21434,14 +21436,16 @@ var StreamingState = class {
   getCurrentText() {
     return this.text;
   }
-  async beginTurn() {
+  async beginTurn(opts) {
     this.text = "";
     this.streamingChunks.clear();
     if (this.pending?.kind === "permission") {
       clearTimeout(this.pending.timeoutTimer);
     }
     this.pending = null;
-    await this.publisher.publishOutput({ type: "clear" });
+    if (opts?.clear !== false) {
+      await this.publisher.publishOutput({ type: "clear" });
+    }
     await this.publisher.publishOutput({ type: "new_turn", done: false });
   }
   append(delta) {
@@ -21762,7 +21766,7 @@ async function runAcpSession(opts) {
   const runtime = createInteractiveAgentStrategy(opts.agent, createOsStrategy());
   const models = await runtime.listModels();
   const history = new AcpHistory(publisher, { agent: opts.agent, acpSessionId });
-  maybeSendOnboardingWelcome({
+  const onboardingWelcomeDone = maybeSendOnboardingWelcome({
     streaming,
     history,
     sessionId: opts.sessionId,
@@ -21821,6 +21825,7 @@ async function runAcpSession(opts) {
     },
     { id: opts.agent, name: opts.agent, displayName: opts.agent }
   );
+  await onboardingWelcomeDone;
   relay.start();
   const prewarmTimer = setTimeout(() => prewarmPreviewDetection(runtime), 2e4);
   const shutdown = async (signal) => {
@@ -27064,7 +27069,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.39.20" : "0.0.0-dev";
+  const cliVersion = true ? "2.39.22" : "0.0.0-dev";
   const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -27263,7 +27268,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.39.20" : "unknown";
+  const v = true ? "2.39.22" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -27549,7 +27554,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.39.20" : null;
+  const current = true ? "2.39.22" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;

package/dist/postinstall.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+"use strict";
+
+// src/postinstall.ts
+var c = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  green: "\x1B[32m",
+  cyan: "\x1B[36m",
+  violet: "\x1B[35m",
+  white: "\x1B[97m"
+};
+var lines = [
+  "",
+  `  ${c.violet}${c.bold}codeam-cli${c.reset}  ${c.dim}\u2014 Claude Code remote control${c.reset}`,
+  "",
+  `  ${c.dim}1.${c.reset} Pair your phone:`,
+  `     ${c.cyan}codeam pair${c.reset}`,
+  "",
+  `  ${c.dim}2.${c.reset} Launch Claude Code with mobile control:`,
+  `     ${c.cyan}codeam${c.reset}`,
+  "",
+  `  ${c.dim}Other commands:${c.reset}`,
+  `     ${c.white}codeam sessions${c.reset}   ${c.dim}list paired devices${c.reset}`,
+  `     ${c.white}codeam status${c.reset}     ${c.dim}show connection info${c.reset}`,
+  `     ${c.white}codeam logout${c.reset}     ${c.dim}remove all sessions${c.reset}`,
+  "",
+  `  ${c.dim}Requires Claude Code:${c.reset} ${c.green}npm install -g @anthropic-ai/claude-code${c.reset}`,
+  `  ${c.dim}Mobile app:${c.reset}           ${c.green}https://www.codeagent-mobile.com${c.reset}`,
+  ""
+];
+process.stdout.write(lines.join("\n") + "\n");

package/package.json

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