codeam-cli 2.26.10 → 2.26.12

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.26.11] — 2026-06-03
+
+### Added
+
+- **cli:** Emit preview_progress SSE events at each bring-up milestone (#244)
+
+## [2.26.10] — 2026-06-03
+
+### Fixed
+
+- **cli:** Cloudflared DNS probe is best-effort, no longer fails the preview (#243)
+
 ## [2.26.9] — 2026-06-03
 
 ### Added

package/dist/index.js

@@ -472,7 +472,7 @@ var import_qrcode_terminal = __toESM(require("qrcode-terminal"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.26.10",
+  version: "2.26.12",
   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",
@@ -5829,7 +5829,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.26.10" : "0.0.0-dev",
+    cliVersion: true ? "2.26.12" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -16057,25 +16057,29 @@ async function linkDryRunPreflight(ctx) {
 }
 
 // src/services/preview/cloudflared.ts
+var import_promises = require("dns/promises");
 var import_fs = require("fs");
-var import_promises = __toESM(require("fs/promises"));
+var import_promises2 = __toESM(require("fs/promises"));
 var import_os7 = __toESM(require("os"));
 var import_path4 = __toESM(require("path"));
-var import_promises2 = require("stream/promises");
+var import_promises3 = require("stream/promises");
 var import_which = __toESM(require("which"));
 var CACHED_BINARY = import_path4.default.join(import_os7.default.homedir(), ".codeam", "bin", "cloudflared");
-async function waitForCloudflaredReady(url, timeoutMs = 3e4) {
+async function waitForCloudflaredReady(url, timeoutMs = 6e4) {
+  const hostname3 = new URL(url).hostname;
+  const resolver = new import_promises.Resolver();
+  resolver.setServers(["1.1.1.1", "1.0.0.1"]);
   const start2 = Date.now();
   while (Date.now() - start2 < timeoutMs) {
     try {
-      const res = await fetch(url, { method: "HEAD" });
-      if (res.status < 500) return;
+      const addrs = await resolver.resolve4(hostname3);
+      if (addrs.length > 0) return;
     } catch {
     }
     await new Promise((r) => setTimeout(r, 500));
   }
   throw new Error(
-    `Tunnel URL ${url} not reachable after ${timeoutMs}ms (DNS may still be propagating).`
+    `DNS for ${hostname3} did not resolve within ${timeoutMs}ms (Cloudflare Quick Tunnel registration may have failed).`
   );
 }
 async function resolveCloudflared(opts = {}) {
@@ -16084,7 +16088,7 @@ async function resolveCloudflared(opts = {}) {
   } catch {
   }
   try {
-    await import_promises.default.access(CACHED_BINARY);
+    await import_promises2.default.access(CACHED_BINARY);
     return CACHED_BINARY;
   } catch {
   }
@@ -16098,14 +16102,14 @@ async function resolveCloudflared(opts = {}) {
 }
 async function downloadCloudflared(target) {
   const url = downloadUrlForPlatform();
-  await import_promises.default.mkdir(import_path4.default.dirname(target), { recursive: true });
+  await import_promises2.default.mkdir(import_path4.default.dirname(target), { recursive: true });
   const response = await fetch(url);
   if (!response.ok || !response.body) {
     throw new Error(
       `Failed to download cloudflared from ${url}: HTTP ${response.status}. Install manually from https://github.com/cloudflare/cloudflared/releases.`
     );
   }
-  await (0, import_promises2.pipeline)(
+  await (0, import_promises3.pipeline)(
     response.body,
     (0, import_fs.createWriteStream)(target, { mode: 493 })
   );
@@ -16158,7 +16162,7 @@ async function waitForCodespacePortReady(url, timeoutMs = 15e3) {
 }
 
 // src/services/preview/config-file.ts
-var import_promises3 = __toESM(require("fs/promises"));
+var import_promises4 = __toESM(require("fs/promises"));
 var import_path5 = __toESM(require("path"));
 var CONFIG_DIR = ".codeam";
 var CONFIG_FILE = "preview.json";
@@ -16175,7 +16179,7 @@ var REQUIRED_FIELDS = [
 async function readPreviewConfig(cwd) {
   let raw;
   try {
-    raw = await import_promises3.default.readFile(configPath(cwd), "utf-8");
+    raw = await import_promises4.default.readFile(configPath(cwd), "utf-8");
   } catch {
     return null;
   }
@@ -16194,8 +16198,8 @@ async function readPreviewConfig(cwd) {
 }
 async function writePreviewConfig(cwd, detection) {
   const filePath = configPath(cwd);
-  await import_promises3.default.mkdir(import_path5.default.dirname(filePath), { recursive: true });
-  await import_promises3.default.writeFile(filePath, JSON.stringify(detection, null, 2) + "\n", "utf-8");
+  await import_promises4.default.mkdir(import_path5.default.dirname(filePath), { recursive: true });
+  await import_promises4.default.writeFile(filePath, JSON.stringify(detection, null, 2) + "\n", "utf-8");
 }
 
 // src/services/preview/parser.ts
@@ -16899,6 +16903,15 @@ var previewStartH = (ctx, _cmd, parsed) => {
     return;
   }
   const pluginAuthToken = ctx.pluginAuthToken;
+  const emitProgress = (step, message) => {
+    void postPreviewEvent({
+      sessionId: ctx.sessionId,
+      pluginId: ctx.pluginId,
+      pluginAuthToken,
+      type: "preview_progress",
+      payload: { step, message, timestamp: Date.now() }
+    });
+  };
   void (async () => {
     void postPreviewEvent({
       sessionId: ctx.sessionId,
@@ -16907,7 +16920,9 @@ var previewStartH = (ctx, _cmd, parsed) => {
       type: "preview_starting",
       payload: { framework: detection.framework, port: detection.port }
     });
+    emitProgress("ENV_DETECTED", `${detection.framework}`);
     for (const setup of detection.setup_commands ?? []) {
+      emitProgress("SETUP_RUN", `${setup.cmd} ${setup.args.join(" ")}`);
       const exitCode = await runOnce(setup.cmd, setup.args, process.cwd(), detection.env);
       if (exitCode !== 0) {
         void postPreviewEvent({
@@ -16923,11 +16938,17 @@ var previewStartH = (ctx, _cmd, parsed) => {
         return;
       }
     }
+    emitProgress(
+      "BOOT_SEQUENCE",
+      `${detection.command} ${detection.args.join(" ")}`
+    );
     const devServer = (0, import_child_process15.spawn)(detection.command, detection.args, {
       cwd: process.cwd(),
       env: { ...process.env, ...detection.env ?? {} },
       stdio: ["ignore", "pipe", "pipe"]
     });
+    emitProgress("BIND_PORT", String(detection.port));
+    emitProgress("WAITING_FOR_READY", detection.ready_pattern);
     let readyMatched = false;
     let expoUrl = null;
     const readyRe = new RegExp(detection.ready_pattern);
@@ -16969,6 +16990,11 @@ var previewStartH = (ctx, _cmd, parsed) => {
       });
       return;
     }
+    emitProgress("READY_DETECTED", `port ${detection.port}`);
+    emitProgress(
+      "TUNNEL_STARTING",
+      detection.framework === "Expo" ? "Expo (self-tunnelled)" : isCodespaceSession() ? "GitHub Codespaces public port" : "cloudflared quick tunnel"
+    );
     let tunnel = null;
     let url;
     if (detection.framework === "Expo") {
@@ -17080,9 +17106,33 @@ var previewStartH = (ctx, _cmd, parsed) => {
         });
         return;
       }
-      void waitForCloudflaredReady(parsedUrl, 3e4).then(() => log.info("preview", `cloudflared probe: ${parsedUrl} reachable from CLI host`)).catch((e) => log.info("preview", `cloudflared probe: ${String(e.message)} (non-fatal)`));
+      try {
+        await waitForCloudflaredReady(parsedUrl, 6e4);
+        log.info("preview", `cloudflared probe: ${parsedUrl} reachable from CLI host`);
+      } catch (e) {
+        try {
+          tunnel.kill("SIGTERM");
+        } catch {
+        }
+        try {
+          devServer.kill("SIGTERM");
+        } catch {
+        }
+        void postPreviewEvent({
+          sessionId: ctx.sessionId,
+          pluginId: ctx.pluginId,
+          pluginAuthToken,
+          type: "preview_error",
+          payload: {
+            stage: "tunnel",
+            message: `Tunnel ${parsedUrl} did not become reachable within 60s (${e.message}). Cloudflare Quick Tunnels occasionally fail to register \u2014 retry usually succeeds.`
+          }
+        });
+        return;
+      }
       url = parsedUrl;
     }
+    emitProgress("TUNNEL_READY", url);
     registerPreview(ctx.sessionId, {
       sessionId: ctx.sessionId,
       devServer,
@@ -20137,7 +20187,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.26.10" : "0.0.0-dev";
+  const cliVersion = true ? "2.26.12" : "0.0.0-dev";
   const apiBase = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto6.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -20336,7 +20386,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors13 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.26.10" : "unknown";
+  const v = true ? "2.26.12" : "unknown";
   console.log(`${import_picocolors13.default.bold("codeam-cli")} ${import_picocolors13.default.cyan(v)}`);
 }
 
@@ -20564,7 +20614,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.26.10" : null;
+  const current = true ? "2.26.12" : 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.26.10",
+  "version": "2.26.12",
   "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",