codeam-cli 2.67.5 → 2.67.7

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.67.5] — 2026-08-27
+
+### Fixed
+
+- **cli:** Un preview parado no puede resucitar por auto-sanacion
+
 ## [2.67.3] — 2026-08-25
 
 ### Fixed

package/dist/index.js

@@ -8081,7 +8081,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.67.5" : "0.0.0-dev",
+    cliVersion: true ? "2.67.7" : "0.0.0-dev",
     nodeVersion: process.version,
     platform: process.platform,
     arch: process.arch,
@@ -8323,7 +8323,7 @@ var http = __toESM(require("http"));
 // package.json
 var package_default = {
   name: "codeam-cli",
-  version: "2.67.5",
+  version: "2.67.7",
   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",
@@ -9855,7 +9855,7 @@ var CommandRelayService = class _CommandRelayService {
       // fresh + clear the "CLI update available" banner after a self-update
       // (a codespace that reinstalls @latest reconnects via heartbeat, not
       // pair/reconnect). Older backends ignore the extra field.
-      ..."2.67.5" ? { ideVersion: "2.67.5" } : {}
+      ..."2.67.7" ? { ideVersion: "2.67.7" } : {}
     }).then(() => log.trace("relay", `heartbeat ok online=${online}`)).catch((err) => log.trace("relay", `heartbeat failed online=${online}`, err));
   }
   /**
@@ -19743,6 +19743,38 @@ async function linkDryRunPreflight(ctx) {
   process.exit(1);
 }
 
+// src/services/preview/serialized-emitter.ts
+function makeSerializedEmitter(post2) {
+  let chain = Promise.resolve();
+  return (args2) => {
+    chain = chain.then(() => post2(args2)).then(
+      () => void 0,
+      () => void 0
+    );
+    void chain;
+  };
+}
+
+// src/services/preview/reaffirm.ts
+var PREVIEW_REAFFIRM_INTERVAL_MS = 5 * 6e4;
+function makePreviewHeartbeatReaffirm(deps) {
+  const now = deps.now ?? Date.now;
+  const intervalMs = deps.intervalMs ?? PREVIEW_REAFFIRM_INTERVAL_MS;
+  let lastAffirmedAt = null;
+  return ({ firstAfterConnect }) => {
+    const current2 = deps.serving();
+    if (!current2) {
+      lastAffirmedAt = null;
+      return;
+    }
+    const at3 = now();
+    if (!firstAfterConnect && lastAffirmedAt !== null && at3 - lastAffirmedAt < intervalMs) return;
+    lastAffirmedAt = at3;
+    log.trace("preview", `reaffirm: preview sigue sirviendo en ${current2.url}`);
+    deps.emitReady(current2);
+  };
+}
+
 // src/agents/coderabbit/configure.ts
 var import_node_child_process17 = require("child_process");
 var import_node_fs6 = require("fs");
@@ -22082,7 +22114,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 current2 = true ? "2.67.5" : null;
+  const current2 = true ? "2.67.7" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22099,7 +22131,7 @@ function checkForUpdates() {
   if (process.env.CODEAM_DISABLE_UPDATE_CHECK === "1") return;
   if (process.env.CI) return;
   if (!process.stdout.isTTY) return;
-  const current2 = true ? "2.67.5" : null;
+  const current2 = true ? "2.67.7" : null;
   if (!current2) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -22122,7 +22154,7 @@ var SELF_UPDATE_INSTALL_TIMEOUT_MS = 18e4;
 var SELF_UPDATE_LS_TIMEOUT_MS = 15e3;
 var SUDO_PREFLIGHT_TIMEOUT_MS = 5e3;
 function currentCliVersion() {
-  return true ? "2.67.5" : null;
+  return true ? "2.67.7" : null;
 }
 async function installedVersion(deps) {
   const ls = await deps.run(
@@ -28288,6 +28320,9 @@ function parseInsightText(text) {
     securityNote: securityMatch?.[1]?.trim() || void 0
   };
 }
+var emitPreviewEvent = makeSerializedEmitter(
+  (args2) => postPreviewEvent(args2)
+);
 var requestPreviewDetectH = (ctx) => {
   if (!ctx.pluginAuthToken) {
     log.info("preview", "no pluginAuthToken \u2014 skipping detect");
@@ -28295,7 +28330,7 @@ var requestPreviewDetectH = (ctx) => {
   }
   if (typeof ctx.runtime.generateOneShot !== "function") {
     log.info("preview", `runtime ${ctx.runtime.id} has no generateOneShot \u2014 emitting unsupported`);
-    void postPreviewEvent({
+    emitPreviewEvent({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
       pluginAuthToken: ctx.pluginAuthToken,
@@ -28312,7 +28347,7 @@ var requestPreviewDetectH = (ctx) => {
     const fromFile = await readPreviewConfig(process.cwd());
     if (fromFile) {
       log.info("preview", `detect: using .codeam/preview.json (${fromFile.framework})`);
-      void postPreviewEvent({
+      emitPreviewEvent({
         sessionId: ctx.sessionId,
         pluginId: ctx.pluginId,
         pluginAuthToken,
@@ -28321,7 +28356,7 @@ var requestPreviewDetectH = (ctx) => {
       });
       return;
     }
-    void postPreviewEvent({
+    emitPreviewEvent({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
       pluginAuthToken,
@@ -28337,7 +28372,7 @@ var requestPreviewDetectH = (ctx) => {
     const detection = safeParseDetection(raw);
     if (!detection) {
       log.info("preview", `detect: invalid agent output after ${tookMs}ms`);
-      void postPreviewEvent({
+      emitPreviewEvent({
         sessionId: ctx.sessionId,
         pluginId: ctx.pluginId,
         pluginAuthToken,
@@ -28351,7 +28386,7 @@ var requestPreviewDetectH = (ctx) => {
     }
     if (detection.framework === "unsupported") {
       log.info("preview", "detect: framework=unsupported");
-      void postPreviewEvent({
+      emitPreviewEvent({
         sessionId: ctx.sessionId,
         pluginId: ctx.pluginId,
         pluginAuthToken,
@@ -28367,7 +28402,7 @@ var requestPreviewDetectH = (ctx) => {
     void writePreviewConfig(process.cwd(), detection).catch((err) => {
       log.info("preview", `detect: writePreviewConfig failed (non-fatal): ${String(err)}`);
     });
-    void postPreviewEvent({
+    emitPreviewEvent({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
       pluginAuthToken,
@@ -28377,6 +28412,31 @@ var requestPreviewDetectH = (ctx) => {
   })();
 };
 var previewPrewarmStarted = false;
+function makePreviewReaffirm(args2) {
+  const token = args2.pluginAuthToken;
+  const sessionId = args2.sessionId;
+  if (!token || !sessionId) return void 0;
+  return makePreviewHeartbeatReaffirm({
+    serving: () => {
+      const active2 = activePreviews.get(sessionId);
+      if (!active2 || active2.devServer.exitCode !== null) return null;
+      return {
+        url: active2.url,
+        framework: active2.framework,
+        port: active2.detection.port
+      };
+    },
+    emitReady: (payload) => {
+      emitPreviewEvent({
+        sessionId,
+        pluginId: args2.pluginId,
+        pluginAuthToken: token,
+        type: USER_EVENTS.PREVIEW_READY,
+        payload
+      });
+    }
+  });
+}
 function prewarmPreviewDetection(runtime) {
   if (previewPrewarmStarted) return;
   previewPrewarmStarted = true;
@@ -28412,7 +28472,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
 };
 function startPreviewFromDetection(ctx, detection, pluginAuthToken) {
   const emit2 = (type, payload) => {
-    void postPreviewEvent({
+    emitPreviewEvent({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
       pluginAuthToken,
@@ -28455,7 +28515,7 @@ function maybeAttachBuildHeal(ctx, pluginAuthToken) {
       })();
     },
     notify: (message) => {
-      void postPreviewEvent({
+      emitPreviewEvent({
         sessionId: ctx.sessionId,
         pluginId: ctx.pluginId,
         pluginAuthToken,
@@ -28476,7 +28536,7 @@ var previewStopH = (ctx) => {
     await killPreview(ctx.sessionId);
     resetBuildHealState(ctx.sessionId);
     log.info("preview", `stopped session=${ctx.sessionId}`);
-    void postPreviewEvent({
+    emitPreviewEvent({
       sessionId: ctx.sessionId,
       pluginId: ctx.pluginId,
       pluginAuthToken,
@@ -28774,8 +28834,16 @@ async function startInfraOnly(agentId) {
       }
     },
     agentMeta,
-    []
+    [],
     // empty agents list → dashboard renders NoAgentHero
+    void 0,
+    // El camino infra-only NO tiene agente, pero SÍ puede tener preview (es la
+    // ruta del panel de archivos), así que su snapshot caduca igual.
+    makePreviewReaffirm({
+      sessionId: session.id,
+      pluginId,
+      pluginAuthToken: session.pluginAuthToken ?? void 0
+    })
   );
   ctx.relay = relay;
   relayRef = relay;
@@ -40650,7 +40718,22 @@ async function runAcpSession(opts) {
         emitSwitchEvent
       );
     },
-    { id: opts.agent, name: opts.agent, displayName: opts.agent }
+    { id: opts.agent, name: opts.agent, displayName: opts.agent },
+    void 0,
+    void 0,
+    // Pasajero del tick de 20 s que YA existe: re-afirma el preview mientras su
+    // dev server siga vivo, para que el snapshot (1 h de TTL en Redis) no
+    // caduque y la sesión no vuelva al estado vacío al refrescar. Ni un
+    // temporizador nuevo. Ver `services/preview/reaffirm.ts`.
+    //
+    // ⚠️ Va en ESTE relay, el que vive lo que dura la sesión — no en el
+    // `errRelay` del camino de fallo, que es efímero y donde no hay preview
+    // ninguno que afirmar.
+    makePreviewReaffirm({
+      sessionId: opts.sessionId,
+      pluginId: opts.pluginId,
+      pluginAuthToken: opts.pluginAuthToken
+    })
   );
   const HANDOFF_MAX_CHARS = 16e3;
   const pendingHandoff = { current: null };
@@ -43276,9 +43359,23 @@ async function start(requestedAgent, presetSession) {
     agentId: session.agent,
     pluginAuthToken: session.pluginAuthToken ?? void 0
   };
-  const relay = new CommandRelayService(pluginId, async (cmd) => {
-    await dispatchCommand(ctx, cmd);
-  }, runtime.meta);
+  const relay = new CommandRelayService(
+    pluginId,
+    async (cmd) => {
+      await dispatchCommand(ctx, cmd);
+    },
+    runtime.meta,
+    void 0,
+    void 0,
+    // Pasajero del tick de 20 s que ya existe: re-afirma el preview para que
+    // su snapshot (1 h de TTL en Redis) no caduque con el dev server vivo.
+    // Ni un temporizador nuevo. Ver `services/preview/reaffirm.ts`.
+    makePreviewReaffirm({
+      sessionId: session.id,
+      pluginId,
+      pluginAuthToken: session.pluginAuthToken
+    })
+  );
   ctx.relay = relay;
   void beadsReady.then((started) => {
     ctx.beads = started;
@@ -45893,7 +45990,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.67.5" : "0.0.0-dev";
+  const cliVersion = true ? "2.67.7" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto13.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -46284,7 +46381,7 @@ async function mcpRun(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.67.5" : "unknown";
+  const v = true ? "2.67.7" : "unknown";
   console.log(`${import_picocolors15.default.bold("codeam-cli")} ${import_picocolors15.default.cyan(v)}`);
 }
 

package/package.json

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