vibeview 0.32.0 → 0.34.0

package/dist/{chunk-ZZK7YQSP.js → chunk-4D2E2PE4.js}

@@ -377,9 +377,19 @@ var ApiClient = class {
   /** Report presence on a session and read it back in one call. A Roku dev
    *  loop has no tunnel and no browser, so this is what tells the backend
    *  someone is still using the session between device commands. Same
-   *  response shape as `getSession`. */
-  async touchSession(sessionId) {
-    return this.requestRaw("POST", `/sessions/${sessionId}/presence`);
+   *  response shape as `getSession`.
+   *
+   *  `lease: true` also renews the caller's hold on the session: a dev loop
+   *  (`vibeview dev`, `--detach`, MCP `dev_start`) renews it every
+   *  `AGENT_LEASE_RENEW_MS`, and once renewals stop — the process was killed,
+   *  crashed, or the computer went to sleep — the backend ends the session
+   *  about a minute later instead of after the org idle timeout. */
+  async touchSession(sessionId, opts = {}) {
+    return this.requestRaw(
+      "POST",
+      `/sessions/${sessionId}/presence`,
+      opts.lease ? { lease: true } : void 0
+    );
   }
   async stopSession(sessionId) {
     await this.requestRaw("DELETE", `/sessions/${sessionId}`);

package/dist/{chunk-T6H5XTBX.js → chunk-TPZG7NCU.js}

@@ -13,7 +13,7 @@ import {
   resolveArtifact,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-ZZK7YQSP.js";
+} from "./chunk-4D2E2PE4.js";
 
 // src/lib/dev-config.ts
 import { readFileSync, renameSync, rmSync, writeFileSync } from "fs";
@@ -360,6 +360,104 @@ function checkDevBuild(app, buildId, platform, opts = {}) {
   }
   return build;
 }
+function debugBuildsNewestFirst(app) {
+  const time = (b) => b.uploaded_at ? Date.parse(b.uploaded_at) || 0 : 0;
+  return app.builds.filter((b) => canUseMetro(b) === true).sort((a, b) => time(b) - time(a) || b.id - a.id);
+}
+function pickDevBuild(app, localVersion) {
+  const builds = debugBuildsNewestFirst(app);
+  if (builds.length === 0) return null;
+  const newest = builds[0];
+  if (!localVersion || newest.version === localVersion) return { build: newest, reason: null };
+  const match = builds.find((b) => b.version === localVersion);
+  if (!match) return { build: newest, reason: null };
+  return {
+    build: match,
+    reason: `the newest debug build (${newest.id}) is version ${newest.version ?? "unknown"}, this project is version ${localVersion}`
+  };
+}
+function buildLabel(b) {
+  const parts = [];
+  if (b.version) parts.push(`version ${b.version}${b.build_number ? ` (${b.build_number})` : ""}`);
+  parts.push(b.kind ?? buildKind(b));
+  if (b.uploaded_at) parts.push(`uploaded ${formatUtcTimestamp(b.uploaded_at)}`);
+  if (b.note) parts.push(JSON.stringify(b.note.length > 60 ? `${b.note.slice(0, 57)}...` : b.note));
+  return `${b.id} (${parts.join(", ")})`;
+}
+function startedBuild(b) {
+  return {
+    id: b.id,
+    version: b.version ?? null,
+    build_number: b.build_number ?? null,
+    kind: buildKind(b),
+    uploaded_at: b.uploaded_at ?? null,
+    note: b.note ?? null
+  };
+}
+function otherDebugBuilds(app, installedId) {
+  const builds = debugBuildsNewestFirst(app);
+  const installed = app.builds.find((b) => b.id === installedId);
+  const seen = /* @__PURE__ */ new Set();
+  if (installed) seen.add(installed.version ?? "");
+  const out = [];
+  for (const b of builds) {
+    if (b.id === installedId) continue;
+    const key = b.version ?? "";
+    if (seen.has(key)) continue;
+    seen.add(key);
+    out.push(b);
+  }
+  return out;
+}
+function preferDevBuild(app, pinned, project) {
+  if (pinned !== void 0 || !app) return { buildId: pinned, reason: null };
+  const picked = pickDevBuild(app, project?.version ?? null);
+  return picked?.reason ? { buildId: picked.build.id, reason: picked.reason } : { buildId: void 0, reason: null };
+}
+function describeDevBuild(app, session, pick, project) {
+  const installedId = session?.app_build_id ?? pick.buildId ?? null;
+  const installed = app?.builds.find((b) => b.id === installedId);
+  const build = installed ? startedBuild(installed) : typeof installedId === "number" ? {
+    id: installedId,
+    version: session?.app_version ?? null,
+    build_number: session?.app_build_number ?? null,
+    kind: "unknown",
+    uploaded_at: null,
+    note: null
+  } : null;
+  return {
+    build,
+    reason: pick.reason,
+    pinned: pick.pinned,
+    other_debug_builds: app ? otherDebugBuilds(app, installedId).map(startedBuild) : [],
+    project
+  };
+}
+function buildLines(choice, opts) {
+  const lines = [];
+  if (!choice) return lines;
+  if (choice.build) lines.push(`build: ${buildLabel(choice.build)}`);
+  if (choice.reason) lines.push(`picked that build because ${choice.reason}`);
+  const project = choice.project;
+  if (!opts.standalone && !choice.pinned && !choice.reason && project && !project.version) {
+    const why = project.versionUnreadable ? ` (${project.versionUnreadable})` : "";
+    lines.push(
+      `couldn't read this project's app version${why}, so this is the newest debug build, not necessarily one of this version`
+    );
+  }
+  if (choice.other_debug_builds.length > 0) {
+    lines.push(
+      `other debug builds: ${choice.other_debug_builds.map((b) => buildLabel(b)).join("; ")} \u2014 pass ${opts.flag} to run one`
+    );
+  }
+  const rn = project?.reactNative;
+  if (!opts.standalone && rn) {
+    lines.push(
+      `this project: react-native ${rn}${project?.version ? `, version ${project.version}` : ""}. If the app shows a red error screen right after it starts (for example "React Native version mismatch", or "undefined is not a function" inside a native module), the build may have been made from other native code than this project \u2014 try a build of this project (${opts.flag}, see ${opts.listBuilds}).`
+    );
+  }
+  return lines;
+}
 
 // src/commands/list-builds.ts
 import chalk from "chalk";
@@ -615,6 +713,7 @@ import chalk2 from "chalk";
 import { input, select } from "@inquirer/prompts";
 
 // src/lib/project-detect.ts
+import { execFile } from "child_process";
 import { existsSync as existsSync2, readFileSync as readFileSync4, readdirSync, statSync } from "fs";
 import { join as join4 } from "path";
 import ignore from "ignore";
@@ -791,6 +890,110 @@ function productionDefaultsFor(cwd, platform) {
   }
   return {};
 }
+function uniqueMatch(text, re) {
+  const found = /* @__PURE__ */ new Set();
+  for (const m of text.matchAll(re)) {
+    const v = m[1].trim().replace(/^"|"$/g, "");
+    if (v && !v.includes("$")) found.add(v);
+  }
+  return found.size === 1 ? [...found][0] : null;
+}
+function readText(path) {
+  try {
+    return readFileSync4(path, "utf-8");
+  } catch {
+    return null;
+  }
+}
+function pbxprojText(cwd) {
+  try {
+    const proj = readdirSync(join4(cwd, "ios")).find((f) => f.endsWith(".xcodeproj"));
+    return proj ? readText(join4(cwd, "ios", proj, "project.pbxproj")) : null;
+  } catch {
+    return null;
+  }
+}
+var readExpoConfig = (cwd) => {
+  const cli = join4(cwd, "node_modules", "expo", "bin", "cli");
+  if (!existsSync2(cli)) {
+    return Promise.reject(new Error("Expo is not installed in this project (node_modules/expo)"));
+  }
+  return new Promise((resolve, reject) => {
+    execFile(
+      process.execPath,
+      [cli, "config", "--json", "--type", "public"],
+      {
+        cwd,
+        timeout: 3e4,
+        maxBuffer: 8 * 1024 * 1024,
+        env: { ...process.env, EXPO_NO_TELEMETRY: "1", CI: "1" }
+      },
+      (err, stdout, stderr) => {
+        if (err) {
+          const why = String(stderr || err.message).split("\n").map((l) => l.trim()).find((l) => l.length > 0);
+          reject(new Error(`expo config failed${why ? `: ${why}` : ""}`));
+          return;
+        }
+        try {
+          const parsed = JSON.parse(stdout);
+          if (parsed && typeof parsed === "object") resolve(parsed);
+          else reject(new Error("expo config printed no config"));
+        } catch {
+          reject(new Error("expo config printed something that is not JSON"));
+        }
+      }
+    );
+  });
+};
+async function localAppIdentity(cwd, platform, readConfig = readExpoConfig) {
+  const rn = readJson(cwd, "node_modules/react-native/package.json");
+  const reactNative = typeof rn?.version === "string" ? rn.version : null;
+  const android = platform === "android" || platform === "androidtv";
+  const ios = platform === "ios" || platform === "tvos";
+  let version = null;
+  let bundleId = null;
+  let versionUnreadable = null;
+  const dynamicName = ["app.config.ts", "app.config.js", "app.config.mjs", "app.config.cjs"].find(
+    (f) => existsSync2(join4(cwd, f))
+  );
+  const staticRaw = readJson(cwd, "app.config.json") ?? readJson(cwd, "app.json");
+  const isExpo = Boolean(dynamicName) || staticRaw !== null && "expo" in staticRaw || existsSync2(join4(cwd, "node_modules", "expo", "package.json"));
+  let expo = null;
+  if (isExpo && (dynamicName || existsSync2(join4(cwd, "node_modules", "expo", "bin", "cli")))) {
+    try {
+      expo = await readConfig(cwd);
+    } catch (err) {
+      if (dynamicName) {
+        versionUnreadable = `${dynamicName} is dynamic and could not be evaluated: ${err instanceof Error ? err.message : String(err)}`;
+      }
+    }
+  }
+  if (expo === null && !dynamicName && staticRaw) {
+    expo = "expo" in staticRaw ? staticRaw.expo : staticRaw;
+  }
+  if (expo && typeof expo === "object") {
+    const cfg = expo;
+    if (typeof cfg.version === "string") version = cfg.version;
+    const section = android ? cfg.android : ios ? cfg.ios : null;
+    const id = android ? section?.package : section?.bundleIdentifier;
+    if (typeof id === "string") bundleId = id;
+  }
+  if (android && (!version || !bundleId)) {
+    const gradle = readText(join4(cwd, "android", "app", "build.gradle")) ?? readText(join4(cwd, "android", "app", "build.gradle.kts"));
+    if (gradle) {
+      version ??= uniqueMatch(gradle, /versionName\s*=?\s*["']([^"']+)["']/g);
+      bundleId ??= uniqueMatch(gradle, /applicationId\s*=?\s*["']([^"']+)["']/g);
+    }
+  }
+  if (ios && (!version || !bundleId)) {
+    const pbx = pbxprojText(cwd);
+    if (pbx) {
+      version ??= uniqueMatch(pbx, /MARKETING_VERSION = ([^;]+);/g);
+      bundleId ??= uniqueMatch(pbx, /PRODUCT_BUNDLE_IDENTIFIER = ([^;]+);/g);
+    }
+  }
+  return { reactNative, version, bundleId, versionUnreadable: version ? null : versionUnreadable };
+}
 
 // src/lib/dev-setup.ts
 function platformChoices(cwd) {
@@ -890,7 +1093,7 @@ async function promptMetroCommand(cwd, platform) {
 }
 
 // src/lib/source-pack.ts
-import { execFile, spawn } from "child_process";
+import { execFile as execFile2, spawn } from "child_process";
 import { lstatSync, mkdtempSync, readFileSync as readFileSync5, rmSync as rmSync4, statSync as statSync2, writeFileSync as writeFileSync4 } from "fs";
 import { tmpdir } from "os";
 import { join as join5 } from "path";
@@ -1029,7 +1232,7 @@ function probeTarNullSupport() {
       const listPath = join5(tmp, "empty.list");
       writeFileSync4(listPath, "");
       const out = join5(tmp, "probe.tgz");
-      execFile("tar", ["-czf", out, "-C", tmp, "--null", "-T", listPath], (err) => {
+      execFile2("tar", ["-czf", out, "-C", tmp, "--null", "-T", listPath], (err) => {
         rmSync4(tmp, { recursive: true, force: true });
         resolve(!err);
       });
@@ -2359,11 +2562,24 @@ function parseWatchSeconds(flag) {
   }
   return seconds;
 }
+var AGENT_LEASE_RENEW_MS = 15e3;
+var AGENT_LEASE_TTL_MS = 6e4;
+function leaseLapsedReason(gapMs) {
+  if (gapMs <= AGENT_LEASE_TTL_MS) return void 0;
+  return `the session ended because this computer did not check in with VibeView for ${Math.round(gapMs / 1e3)}s (asleep, offline, or the process was paused) \u2014 start a new session to continue`;
+}
 function queuedLine(position, reasonMessage) {
   const where = position ? ` (position ${position})` : "";
   const why = reasonMessage ?? "Every device is busy.";
   return `\u23F3 ${why} Waiting in the queue${where}, Ctrl-C to give up.`;
 }
+function devBuildLines(choice, standalone) {
+  return buildLines(choice, {
+    standalone,
+    flag: "--build <id>",
+    listBuilds: "vibeview list-builds"
+  });
+}
 function emit(json, evt) {
   if (json) console.log(JSON.stringify(evt));
 }
@@ -2372,16 +2588,43 @@ async function startDevSession(cfg, onEvent = () => {
   const api = new ApiClient(cfg.baseUrl, cfg.token);
   const usesTunnel = PLATFORM_NEEDS_METRO[cfg.platform] && !cfg.standalone;
   const pool = cfg.model ? resolveDeviceModel(await api.listDeviceModels(), cfg.platform, cfg.model) : null;
+  let app = null;
+  let project = null;
+  let pick = {
+    buildId: cfg.buildId,
+    reason: null
+  };
+  if (usesTunnel && cfg.projectDir) {
+    try {
+      app = cfg.app ?? await api.getApp(cfg.appId);
+    } catch {
+      app = null;
+    }
+    try {
+      project = await localAppIdentity(cfg.projectDir, cfg.platform);
+    } catch {
+      project = null;
+    }
+    pick = preferDevBuild(app, cfg.buildId, project);
+  }
+  const body = { ...cfg, buildId: pick.buildId };
   const created = await api.createSession(
-    devSessionCreateBody(pool ? { ...cfg, deviceCategory: pool.category, model: pool.model } : cfg)
+    devSessionCreateBody(
+      pool ? { ...body, deviceCategory: pool.category, model: pool.model } : body
+    )
   );
   const sessionId = created.session_id;
   let stopping = false;
   let tunnel = null;
   let queueEntryId = null;
+  let lastLeaseAt = Date.now();
+  let leaseTimer = null;
   const stopSession = async (code) => {
     if (stopping) return;
     stopping = true;
+    if (leaseTimer) clearInterval(leaseTimer);
+    leaseTimer = null;
+    const reason = code !== 0 ? leaseLapsedReason(Date.now() - lastLeaseAt) : void 0;
     tunnel?.stop();
     if (queueEntryId !== null) {
       await api.cancelQueueEntry(queueEntryId).catch(() => {
@@ -2390,8 +2633,27 @@ async function startDevSession(cfg, onEvent = () => {
     }
     await api.stopSession(sessionId).catch(() => {
     });
-    onEvent({ event: "session_ended", session_id: sessionId, code });
+    onEvent({ event: "session_ended", session_id: sessionId, code, ...reason ? { reason } : {} });
+  };
+  const renewLease = async () => {
+    if (stopping) return;
+    let info;
+    try {
+      info = await api.touchSession(sessionId, { lease: true });
+    } catch {
+      return;
+    }
+    if (stopping) return;
+    if (info.status === "stopped" || info.status === "failed") {
+      void stopSession(1);
+      return;
+    }
+    lastLeaseAt = Date.now();
   };
+  void renewLease();
+  leaseTimer = setInterval(() => void renewLease(), AGENT_LEASE_RENEW_MS);
+  leaseTimer.unref?.();
+  cfg.onCreated?.({ sessionId, stop: () => stopSession(1) });
   try {
     const started = await api.startSession(sessionId);
     if (started.status === "queued") {
@@ -2406,6 +2668,7 @@ async function startDevSession(cfg, onEvent = () => {
       });
       await pollWhileQueued(api, sessionId, QUEUE_WAIT_MS);
       queueEntryId = null;
+      cfg.onDequeued?.();
     }
     const pageUrl = `${cfg.webUrl || cfg.baseUrl}/sandbox/${sessionId}`;
     const reportedWarnings = /* @__PURE__ */ new Set();
@@ -2458,7 +2721,15 @@ async function startDevSession(cfg, onEvent = () => {
       reportedWarnings.add(w);
       onEvent({ event: "warning", message: w });
     }
-    return { sessionId, pageUrl, stop: () => stopSession(0), reportedWarnings, session: active };
+    return {
+      sessionId,
+      pageUrl,
+      stop: () => stopSession(0),
+      reportedWarnings,
+      session: active,
+      lapsedReason: () => leaseLapsedReason(Date.now() - lastLeaseAt),
+      build: usesTunnel && cfg.projectDir ? describeDevBuild(app, active, { ...pick, pinned: cfg.buildId !== void 0 }, project) : null
+    };
   } catch (err) {
     await stopSession(1);
     throw err;
@@ -3076,6 +3347,7 @@ async function runDevInProcess(opts) {
         deviceCategory: cfg.deviceCategory,
         model: cfg.model,
         buildId: pinnedBuildId,
+        projectDir: process.cwd(),
         ...standalone ? { standalone } : {},
         metroPort: cfg.metroPort ?? 8081,
         // startDevSession's own browser-open happens before we've written the
@@ -3102,7 +3374,7 @@ async function runDevInProcess(opts) {
             chalk4.dim("  Putting the channel on the Roku \u2014 the link appears once it is up.")
           );
         } else if (evt.event === "session_ended" && !stopping && handle) {
-          console.error(chalk4.red("tunnel closed by server \u2014 session ended"));
+          console.error(chalk4.red(evt.reason ?? "session ended by the server"));
           stopping = true;
           endedEmitted = true;
           emit(opts.json, evt);
@@ -3133,6 +3405,8 @@ async function runDevInProcess(opts) {
       }
     );
     const keysLine = rokuBuild ? `Press ${chalk4.bold("r")} to reload the channel, ${chalk4.bold("q")} or Ctrl-C to end the session.` : "Ctrl-C to end the session.";
+    for (const line of devBuildLines(handle.build, standalone))
+      console.error(chalk4.dim(`  ${line}`));
     console.error(`
   Watch and interact: ${chalk4.cyan(handle.pageUrl)}
   ${keysLine}
@@ -3150,7 +3424,8 @@ async function runDevInProcess(opts) {
       event: "session_ready",
       session_id: handle.sessionId,
       url: handle.pageUrl,
-      pid: process.pid
+      pid: process.pid,
+      build: handle.build ?? null
     });
     if (opts.open !== false) await openBrowser(handle.pageUrl).catch(() => {
     });
@@ -3217,8 +3492,14 @@ async function runDevInProcess(opts) {
             }
             const verdict = sessionLivenessVerdict(info);
             if (verdict.end && !stopping) {
-              console.error(chalk4.red(verdict.message));
-              emit(opts.json, { event: "session_ended", session_id: sessionId, code: 1 });
+              const reason = handle?.lapsedReason?.();
+              console.error(chalk4.red(reason ?? verdict.message));
+              emit(opts.json, {
+                event: "session_ended",
+                session_id: sessionId,
+                code: 1,
+                ...reason ? { reason } : {}
+              });
               endedEmitted = true;
               await stopSession(1);
               return;
@@ -3276,6 +3557,8 @@ async function dev(opts) {
         } else {
           console.error(chalk4.dim(`Using ${resolveAuth(opts).baseUrl}`));
           console.error(chalk4.green(`\u2713 dev session started in the background (pid ${parsed.pid})`));
+          for (const line2 of devBuildLines(parsed.build, false))
+            console.error(chalk4.dim(`  ${line2}`));
           console.error(`
   Watch and interact: ${chalk4.cyan(parsed.url)}`);
           console.error(chalk4.dim(`  vibeview dev-status  \u2014 check on it`));
@@ -3664,7 +3947,7 @@ var AGENT_COMMANDS = [
     // iOS system alerts only.
     verb: "alert",
     tool: "alert",
-    summary: "Inspect or respond to a visible iOS system alert (get, accept, or dismiss).",
+    summary: "Inspect or respond to a visible system alert on iOS or Apple TV (get, accept, or dismiss). `get` returns the message and the button labels.",
     mutating: true,
     params: [
       {
@@ -3747,7 +4030,7 @@ var AGENT_COMMANDS = [
     // tools.py open_url: { url: string }.
     verb: "open-url",
     tool: "open_url",
-    summary: "Open a deep link or URL in the app under test. The link goes to that app only; one it has no screen for fails rather than opening a browser.",
+    summary: "Open a deep link in the app under test. The link goes to that app only, never a browser: on Android a link the app has no screen for fails; on iOS only the app's own URL scheme (e.g. myapp://settings) is accepted, and a web or system link is refused.",
     mutating: true,
     params: [
       {
@@ -3759,6 +4042,16 @@ var AGENT_COMMANDS = [
       }
     ]
   },
+  {
+    // relaunch_app: {} — terminate the session's app and launch it again the
+    // way the session launched it (same launch params); its data is kept.
+    // Refused on embed sessions (their watchdog owns launching) and on Roku.
+    verb: "relaunch-app",
+    tool: "relaunch_app",
+    summary: "Close the app under test and start it again: a cold start that keeps the app's data, e.g. to check that something persists. Its log keeps streaming across the restart. Not available on Roku or embed sessions.",
+    mutating: true,
+    params: []
+  },
   {
     // set_posture: { posture: 'closed' | 'partial' | 'open' } OR { angle: 0..180 }
     // — exactly one (buildToolCall enforces it CLI-side, agent_control.py's
@@ -3805,6 +4098,33 @@ var AGENT_COMMANDS = [
       }
     ]
   },
+  {
+    // set_location: { latitude: -90..90, longitude: -180..180 } — both
+    // required (agent_control.py validate_tool_args refuses anything else).
+    // The same control as the dashboard's Set location. Flags rather than
+    // positionals: a western/southern coordinate starts with `-`, which a
+    // positional would read as an option.
+    verb: "set-location",
+    tool: "set_location",
+    summary: "Set the device's simulated GPS location, for location-based flows. Phones, tablets and foldables (iOS and Android); not available on TV devices.",
+    mutating: true,
+    params: [
+      {
+        name: "latitude",
+        cli: "--lat",
+        type: "number",
+        required: true,
+        description: "Latitude in decimal degrees, -90 to 90."
+      },
+      {
+        name: "longitude",
+        cli: "--lon",
+        type: "number",
+        required: true,
+        description: "Longitude in decimal degrees, -180 to 180 (west is negative)."
+      }
+    ]
+  },
   {
     // tools.py wait: { seconds?: number } (default: 2). Note the wire arg is
     // "seconds", NOT "ms" — tool_dispatch.py reads args.get("seconds", 2)
@@ -3897,12 +4217,12 @@ var AGENT_COMMANDS = [
 
 // src/agent/render.ts
 import chalk6 from "chalk";
-function renderEnvelope(env) {
+function renderEnvelope(env, label = env.tool) {
   const lines = [];
   if (env.ok) {
-    lines.push(chalk6.green(`ok`) + chalk6.dim(` (${env.tool})`));
+    lines.push(chalk6.green(`ok`) + chalk6.dim(` (${label})`));
   } else {
-    lines.push(chalk6.red(`error`) + chalk6.dim(` (${env.tool})`));
+    lines.push(chalk6.red(`error`) + chalk6.dim(` (${label})`));
   }
   lines.push(...resultLines(env.result));
   if (env.observation) {
@@ -3949,6 +4269,14 @@ function resultLines(result) {
     const state = deviceStateLine(r);
     if (state) lines.push(state);
   }
+  if (Array.isArray(r.buttons) && r.buttons.length > 0) {
+    const labels = r.buttons.filter((b) => typeof b === "string");
+    if (labels.length > 0)
+      lines.push(`buttons: ${labels.map((b) => JSON.stringify(b)).join(", ")}`);
+  }
+  if (r.action === "location_set" && typeof r.latitude === "number" && typeof r.longitude === "number") {
+    lines.push(`location: ${r.latitude}, ${r.longitude}`);
+  }
   if (typeof r.note === "string" && r.note) lines.push(chalk6.dim(r.note));
   if (typeof r.message === "string" && r.message) lines.push(r.message);
   if (typeof r.warning === "string" && r.warning) lines.push(r.warning);
@@ -3959,8 +4287,8 @@ function deviceStateLine(r) {
   if (r.action === "rotated") {
     if (typeof r.device_orientation === "string") {
       let o = `device held ${r.device_orientation}`;
-      if (typeof r.screen_orientation === "string" && r.screen_orientation !== r.device_orientation) {
-        o += ` (picture on the lit screen: ${r.screen_orientation})`;
+      if (typeof r.screen_orientation === "string" && !r.device_orientation.startsWith(r.screen_orientation)) {
+        o += typeof r.posture === "string" ? ` (picture on the lit screen: ${r.screen_orientation})` : ` (screen stayed ${r.screen_orientation})`;
       }
       parts.push(o);
     }
@@ -4196,9 +4524,11 @@ async function runAgentVerb(cmd, positionals, opts) {
     }
     writeFileSync6(outPath, imageBytes);
     if (opts.json) {
-      console.log(JSON.stringify(envelope));
+      console.log(
+        JSON.stringify({ ...envelope, result: { written_to: outPath, bytes: imageBytes.length } })
+      );
     } else {
-      process.stderr.write(renderEnvelope(envelope) + "\n");
+      process.stderr.write(renderEnvelope(envelope, cmd.verb) + "\n");
       console.log(outPath);
     }
     process.exit(agentExitCode(envelope));
@@ -4207,7 +4537,7 @@ async function runAgentVerb(cmd, positionals, opts) {
   if (opts.json) {
     console.log(JSON.stringify(envelope));
   } else {
-    console.log(renderEnvelope(envelope));
+    console.log(renderEnvelope(envelope, cmd.verb));
     if (cmd.verb === "press" && !envelope.ok) process.stderr.write(pressButtonsHelp() + "\n");
   }
   process.exit(agentExitCode(envelope));
@@ -4223,6 +4553,8 @@ export {
   resolveMetro,
   parseBuildId,
   checkDevBuild,
+  describeDevBuild,
+  buildLines,
   buildRows,
   formatBuildRowsHuman,
   listBuilds,
@@ -4243,7 +4575,6 @@ export {
   printOutcomeLine,
   createRokuPush,
   startDevSession,
-  ROKU_LIVENESS_INTERVAL_MS,
   PLATFORM_DEVICE,
   dev,
   formatDevicesHuman,