codeam-cli 2.47.1 → 2.48.1

package/CHANGELOG.md

@@ -4,6 +4,27 @@ 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.48.0] — 2026-06-26
+
+### Added
+
+- **shared:** EnvVar wire type for env-config
+- **cli:** Dotenv parse/serialize util for env-config
+- **cli:** Accept env-config vars[] in startCommandSchema
+- **cli:** Env_read handler
+- **cli:** Env_write handler (validate + atomic write)
+- **cli:** Preview_restart handler (kill + re-spawn from stored detection)
+
+### Changed
+
+- **cli:** Store detection on ActivePreview + extract startPreviewFromDetection
+
+## [2.47.1] — 2026-06-26
+
+### Chore
+
+- **plugins:** Cloud-fallback follow-ups — test await, validated narrowing, repoSlug+learnMoreUrl tests, path-preserving probe URL, detached-HEAD parity, drop vestigial param (#393)
+
 ## [2.47.0] — 2026-06-26
 
 ### Added

package/dist/index.js

@@ -1093,12 +1093,12 @@ var PromiseQueue = class {
     return promise;
   }
   async join() {
-    let promises2 = Object.values(this.promiseByIds);
-    let length = promises2.length;
+    let promises3 = Object.values(this.promiseByIds);
+    let length = promises3.length;
     while (length > 0) {
-      await Promise.all(promises2);
-      promises2 = Object.values(this.promiseByIds);
-      length = promises2.length;
+      await Promise.all(promises3);
+      promises3 = Object.values(this.promiseByIds);
+      length = promises3.length;
     }
   }
   get length() {
@@ -1436,8 +1436,8 @@ function safeSetTimeout(fn, timeout) {
   return t2;
 }
 var isError = (x) => x instanceof Error;
-function allSettled(promises2) {
-  return Promise.all(promises2.map((p2) => (p2 ?? Promise.resolve()).then((value) => ({
+function allSettled(promises3) {
+  return Promise.all(promises3.map((p2) => (p2 ?? Promise.resolve()).then((value) => ({
     status: "fulfilled",
     value
   }), (reason) => ({
@@ -5397,7 +5397,7 @@ function readAnonId() {
 }
 function superProperties() {
   return {
-    cliVersion: true ? "2.47.1" : "0.0.0-dev",
+    cliVersion: true ? "2.48.1" : "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.47.1",
+  version: "2.48.1",
   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",
@@ -7817,7 +7817,16 @@ var startCommandSchema = import_zod.z.object({
       })
     ).max(32).optional(),
     notes: import_zod.z.string().max(4096).nullable().optional()
-  }).optional()
+  }).optional(),
+  // `env_write` carries the full desired set of environment variables
+  // for the project `.env`. Bounded so a malformed payload can't flood
+  // the disk-side serializer. `env_read` / `preview_restart` send no payload.
+  vars: import_zod.z.array(
+    import_zod.z.object({
+      key: import_zod.z.string().min(1).max(256),
+      value: import_zod.z.string().max(32768)
+    })
+  ).max(512).optional()
 });
 function parsePayload2(schema, raw) {
   const result = schema.safeParse(raw);
@@ -13991,6 +14000,47 @@ async function writePreviewConfig(cwd, detection) {
   await import_promises3.default.writeFile(filePath, JSON.stringify(detection, null, 2) + "\n", "utf-8");
 }
 
+// src/services/preview/dotenv.ts
+var ENV_KEY_RE = /^[A-Za-z_][A-Za-z0-9_]*$/;
+function parseDotenv(raw) {
+  const order = [];
+  const map = /* @__PURE__ */ new Map();
+  for (const rawLine of raw.split(/\r?\n/)) {
+    const line = rawLine.trim();
+    if (line === "" || line.startsWith("#")) continue;
+    const body = line.startsWith("export ") ? line.slice("export ".length).trim() : line;
+    const eq = body.indexOf("=");
+    if (eq <= 0) continue;
+    const key = body.slice(0, eq).trim();
+    if (!ENV_KEY_RE.test(key)) continue;
+    let value = body.slice(eq + 1).trim();
+    value = unquote(value);
+    if (!map.has(key)) order.push(key);
+    map.set(key, value);
+  }
+  return order.map((key) => ({ key, value: map.get(key) }));
+}
+function unquote(value) {
+  if (value.length >= 2 && value.startsWith('"') && value.endsWith('"')) {
+    return value.slice(1, -1).replace(/\\n/g, "\n").replace(/\\"/g, '"');
+  }
+  if (value.length >= 2 && value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+function serializeDotenv(vars) {
+  const lines = vars.map(({ key, value }) => `${key}=${quoteIfNeeded(value)}`);
+  return `# Managed by CodeAgent
+${lines.join("\n")}${lines.length ? "\n" : ""}`;
+}
+function quoteIfNeeded(value) {
+  if (/[\s#=]/.test(value) || value.includes("\n")) {
+    return `"${value.replace(/"/g, '\\"').replace(/\n/g, "\\n")}"`;
+  }
+  return value;
+}
+
 // src/services/preview/parser.ts
 var REQUIRED_FIELDS2 = [
   "framework",
@@ -15917,6 +15967,51 @@ var listFiles = async (ctx, cmd, parsed) => {
   const result = await listProjectFiles({ query: parsed.query });
   await ctx.relay.sendResult(cmd.id, "completed", result);
 };
+var envReadH = async (ctx, cmd) => {
+  const envPath = path40.join(process.cwd(), ".env");
+  try {
+    const raw = await fs34.promises.readFile(envPath, "utf8");
+    await ctx.relay.sendResult(cmd.id, "completed", {
+      exists: true,
+      vars: parseDotenv(raw)
+    });
+  } catch (err) {
+    if (err.code === "ENOENT") {
+      await ctx.relay.sendResult(cmd.id, "completed", { exists: false, vars: [] });
+      return;
+    }
+    await ctx.relay.sendResult(cmd.id, "failed", { error: err.message });
+  }
+};
+var envWriteH = async (ctx, cmd, parsed) => {
+  const vars = parsed.vars;
+  if (!Array.isArray(vars)) {
+    await ctx.relay.sendResult(cmd.id, "failed", { error: "Missing vars" });
+    return;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  for (const v of vars) {
+    if (!ENV_KEY_RE.test(v.key)) {
+      await ctx.relay.sendResult(cmd.id, "failed", { error: `Invalid key: ${v.key}` });
+      return;
+    }
+    if (seen.has(v.key)) {
+      await ctx.relay.sendResult(cmd.id, "failed", { error: `Duplicate key: ${v.key}` });
+      return;
+    }
+    seen.add(v.key);
+  }
+  const envPath = path40.join(process.cwd(), ".env");
+  const tmpPath = path40.join(process.cwd(), ".env.codeam.tmp");
+  try {
+    await fs34.promises.writeFile(tmpPath, serializeDotenv(vars), "utf8");
+    await fs34.promises.rename(tmpPath, envPath);
+    await ctx.relay.sendResult(cmd.id, "completed", { ok: true, count: vars.length });
+  } catch (err) {
+    await fs34.promises.rm(tmpPath, { force: true }).catch(() => void 0);
+    await ctx.relay.sendResult(cmd.id, "failed", { error: err.message });
+  }
+};
 var terminalOpenH = async (ctx, cmd, parsed) => {
   const r = openTerminal({
     cols: typeof parsed.cols === "number" ? parsed.cols : void 0,
@@ -16372,8 +16467,9 @@ var previewStartH = (ctx, _cmd, parsed) => {
     log.info("preview", "start: no detection in payload");
     return;
   }
-  const detection = rawDetection;
-  const pluginAuthToken = ctx.pluginAuthToken;
+  startPreviewFromDetection(ctx, rawDetection, ctx.pluginAuthToken);
+};
+function startPreviewFromDetection(ctx, detection, pluginAuthToken) {
   const emitProgress = (step, message) => {
     void postPreviewEvent({
       sessionId: ctx.sessionId,
@@ -16791,7 +16887,8 @@ var previewStartH = (ctx, _cmd, parsed) => {
       devServer,
       tunnel,
       url,
-      framework: detection.framework
+      framework: detection.framework,
+      detection
     });
     log.info("preview", `ready: ${detection.framework} at ${url}`);
     void postPreviewEvent({
@@ -16812,7 +16909,7 @@ var previewStartH = (ctx, _cmd, parsed) => {
       payload: { stage: "spawn", message: `Preview failed to start: ${message}` }
     });
   });
-};
+}
 var previewStopH = (ctx) => {
   if (!ctx.pluginAuthToken) {
     log.info("preview", "no pluginAuthToken \u2014 skipping stop");
@@ -16831,6 +16928,21 @@ var previewStopH = (ctx) => {
     });
   })();
 };
+var previewRestartH = async (ctx, cmd) => {
+  if (!ctx.pluginAuthToken) {
+    await ctx.relay.sendResult(cmd.id, "completed", { restarted: false });
+    return;
+  }
+  const preview = activePreviews.get(ctx.sessionId);
+  if (!preview) {
+    await ctx.relay.sendResult(cmd.id, "completed", { restarted: false });
+    return;
+  }
+  await killPreview(ctx.sessionId);
+  await new Promise((r) => setTimeout(r, 150));
+  startPreviewFromDetection(ctx, preview.detection, ctx.pluginAuthToken);
+  await ctx.relay.sendResult(cmd.id, "completed", { restarted: true });
+};
 var savePreviewConfigH = (_ctx, _cmd, parsed) => {
   const detection = parsed.detection;
   if (!detection) {
@@ -16880,7 +16992,10 @@ var handlers = {
   request_preview_detect: requestPreviewDetectH,
   preview_start: previewStartH,
   preview_stop: previewStopH,
-  save_preview_config: savePreviewConfigH
+  preview_restart: previewRestartH,
+  save_preview_config: savePreviewConfigH,
+  env_read: envReadH,
+  env_write: envWriteH
 };
 async function dispatchCommand(ctx, cmd) {
   if (cmd.type === "beads_action") {
@@ -18022,7 +18137,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.47.1" : null;
+  const current = true ? "2.48.1" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -18039,7 +18154,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.47.1" : null;
+  const current = true ? "2.48.1" : null;
   if (!current) return;
   const cache = readCache();
   const fresh = cache && Date.now() - cache.fetchedAt < TTL_MS;
@@ -18481,7 +18596,7 @@ var defaultSpawner = (env, cwd, args2 = []) => (0, import_node_child_process14.s
   detached: false
 });
 function currentCliVersion() {
-  return true ? "2.47.1" : null;
+  return true ? "2.48.1" : null;
 }
 function runCmd(cmd, args2, timeoutMs) {
   return new Promise((resolve7) => {
@@ -24947,6 +25062,11 @@ var StreamingState = class {
    */
   async closeWithBubble(bubble) {
     this.text = "";
+    for (const [chunkId, chunk] of this.streamingChunks) {
+      if (chunk.kind === "text") {
+        this.streamingChunks.set(chunkId, { kind: "text", content: bubble });
+      }
+    }
     await Promise.all([
       this.publisher.publishOutput({ type: "text", content: bubble, done: true }),
       this.flushStreamingChunks()
@@ -25620,10 +25740,11 @@ async function handleCommand(cmd, client2, relay, acpSessionId, models, streamin
         }
       } catch (err) {
         const hadText = streaming.getCurrentText().trim().length > 0;
-        await recoverFromFailedTurn(client2, streaming);
         const detail = describeError(err);
         log.warn("acpRunner", `prompt failed: ${detail}`);
+        await cancelStuckTurn(client2);
         if (shouldOfferOneMRecovery({ detail, recentStderr: recentStderr.join("\n"), finalText: "" })) {
+          await streaming.closeAll();
           await oneMRecovery.offer(cmd.id, blocks);
           return;
         }
@@ -25634,9 +25755,11 @@ async function handleCommand(cmd, client2, relay, acpSessionId, models, streamin
           agent: opts.agent
         });
         if (bubble) {
-          await publisher.publishOutput({ type: "text", content: bubble, done: true });
+          await streaming.closeWithBubble(bubble);
           history.appendAgentReply(bubble);
           void history.flush();
+        } else {
+          await streaming.closeAll();
         }
         if (bubble === AUTH_FAILURE_MESSAGE) {
           void reportCredentialInvalid(opts);
@@ -25947,12 +26070,15 @@ function describeError(err) {
   return String(err);
 }
 async function recoverFromFailedTurn(client2, streaming) {
+  await cancelStuckTurn(client2);
+  await streaming.closeAll();
+}
+async function cancelStuckTurn(client2) {
   try {
     await client2.cancel();
   } catch (err) {
     log.warn("acpRunner", `post-failure cancel failed: ${describeError(err)}`);
   }
-  await streaming.closeAll();
 }
 function buildBannerSubtitle(agentId, acpSessionId, model, tier) {
   const meta = AGENT_REGISTRY[agentId];
@@ -29849,7 +29975,7 @@ function checkChokidar() {
 }
 async function doctor(args2 = []) {
   const json = args2.includes("--json");
-  const cliVersion = true ? "2.47.1" : "0.0.0-dev";
+  const cliVersion = true ? "2.48.1" : "0.0.0-dev";
   const apiBase2 = resolveApiBaseUrl();
   const diagnosticId = (0, import_node_crypto8.randomUUID)();
   log.info("doctor", `run id=${diagnosticId} cli=${cliVersion}`);
@@ -30048,7 +30174,7 @@ async function completion(args2) {
 // src/commands/version.ts
 var import_picocolors15 = __toESM(require("picocolors"));
 function version2() {
-  const v = true ? "2.47.1" : "unknown";
+  const v = true ? "2.48.1" : "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.47.1",
+  "version": "2.48.1",
   "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",