vibeview 0.27.0 → 0.27.1

package/dist/{chunk-46X7UN6Y.js → chunk-7IOGMM5W.js}

@@ -6,10 +6,12 @@ import {
   UsageError,
   createSpinner,
   errorExitCode,
+  formatUtcTimestamp,
   loadConfig,
+  queueReasonCopy,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-U7FCGMWG.js";
+} from "./chunk-FTTWLCTE.js";
 
 // src/lib/dev-config.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -249,17 +251,6 @@ function checkDevBuild(app, buildId, platform) {
 
 // src/commands/list-builds.ts
 import chalk from "chalk";
-
-// src/lib/formatters/time.ts
-function formatUtcTimestamp(iso) {
-  if (!iso) return "";
-  const hasZone = /(?:Z|[+-]\d{2}:?\d{2})$/i.test(iso);
-  const d = new Date(hasZone ? iso : `${iso}Z`);
-  if (Number.isNaN(d.getTime())) return iso;
-  return `${d.toISOString().slice(0, 19).replace("T", " ")} UTC`;
-}
-
-// src/commands/list-builds.ts
 function buildRows(app) {
   return app.builds.map((b) => ({
     id: b.id,
@@ -2196,6 +2187,11 @@ function parseWatchSeconds(flag) {
   }
   return seconds;
 }
+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 emit(json, evt) {
   if (json) console.log(JSON.stringify(evt));
 }
@@ -2232,7 +2228,9 @@ async function startDevSession(cfg, onEvent = () => {
         event: "queued",
         session_id: sessionId,
         position: started.position ?? null,
-        queue_entry_id: queueEntryId
+        queue_entry_id: queueEntryId,
+        queue_reason: started.queue_reason ?? null,
+        message: queueReasonCopy(started.queue_reason)
       });
       await pollWhileQueued(api, sessionId, QUEUE_WAIT_MS);
       queueEntryId = null;
@@ -2323,6 +2321,10 @@ function findBlockingWarning(info) {
   return (info.warnings ?? []).find((w) => BLOCKING_WARNING_PREFIXES.some((p) => w.includes(p)));
 }
 var QUEUE_WAIT_MS = 30 * 6e4;
+function sessionEndedMessage(info, when) {
+  const reason = info.status === "failed" && info.failure_reason ? `: ${info.failure_reason}` : "";
+  return `session ${info.status} ${when}${reason}`;
+}
 async function pollWhileQueued(api, sessionId, timeoutMs, intervalMs = 3e3) {
   const deadline = Date.now() + timeoutMs;
   for (; ; ) {
@@ -2330,7 +2332,7 @@ async function pollWhileQueued(api, sessionId, timeoutMs, intervalMs = 3e3) {
     const blocking = findBlockingWarning(info);
     if (blocking) throw new Error(blocking);
     if (info.status === "stopped" || info.status === "failed") {
-      throw new Error(`session ${info.status} while waiting for a device`);
+      throw new Error(sessionEndedMessage(info, "while waiting for a device"));
     }
     if (info.status !== "pending" && info.status !== "queued") return info;
     if (Date.now() > deadline) {
@@ -2349,7 +2351,7 @@ async function pollUntilTunnelReady(api, sessionId, timeoutMs, intervalMs = 2e3)
     if (blocking) throw new Error(blocking);
     if (info.tunnel_url) return info;
     if (info.status === "stopped" || info.status === "failed") {
-      throw new Error(`session ${info.status} before the tunnel came up`);
+      throw new Error(sessionEndedMessage(info, "before the tunnel came up"));
     }
     if (Date.now() > deadline) throw new Error("timed out waiting for the device to start");
     await new Promise((r) => setTimeout(r, intervalMs));
@@ -2368,7 +2370,7 @@ async function pollUntilActive(api, sessionId, timeoutMs, intervalMs = 2e3, onIn
     }
     if (info.status === "active" && !info.app_install_pending) return info;
     if (info.status === "stopped" || info.status === "failed") {
-      throw new Error(`session ${info.status} before it became active`);
+      throw new Error(sessionEndedMessage(info, "before it became active"));
     }
     if (Date.now() > deadline) {
       throw new Error("timed out waiting for the session to become active");
@@ -2418,6 +2420,19 @@ function validateAppChoice(requested, fromFlag, apps) {
   if (apps.some((a) => a.public_id === requested)) return { appId: requested };
   return fromFlag ? { staleFlag: requested } : { staleCached: requested };
 }
+function staleAppFlagError(requested, platform, allApps) {
+  const other = allApps.find((a) => a.public_id === requested);
+  if (other) {
+    return {
+      message: `app "${requested}" is ${platformWithArticle(other.platform)} app, not ${platformWithArticle(platform)} app.`,
+      hint: `Run \`vibeview dev --platform ${other.platform} --app ${requested}\`, or \`vibeview dev --platform ${platform}\` without --app to pick ${platformWithArticle(platform)} app.`
+    };
+  }
+  return {
+    message: `app "${requested}" not found \u2014 it may have been deleted.`,
+    hint: "Run `vibeview dev` without --app to pick from the list."
+  };
+}
 function buildAppStrategy(apps, buildFlag, json, isTTY) {
   if (buildFlag) return "build";
   if (apps.length === 0) return "build";
@@ -2495,11 +2510,9 @@ async function ensureConfig(api, opts) {
   const apps = appsForPlatform(allApps, platform);
   const choice = validateAppChoice(opts.app || entry?.appId, Boolean(opts.app), apps);
   if (choice.staleFlag) {
-    const message = `app "${choice.staleFlag}" not found \u2014 it may have been deleted.`;
-    console.error(
-      chalk4.red(`error: ${message}`) + `
-Run \`vibeview dev\` without --app to pick from the list.`
-    );
+    const { message, hint } = staleAppFlagError(choice.staleFlag, platform, allApps);
+    console.error(chalk4.red(`error: ${message}`) + `
+${hint}`);
     emit(opts.json, { event: "error", message });
     process.exit(2);
   }
@@ -2806,12 +2819,7 @@ async function runDevInProcess(opts) {
             console.error(chalk4.yellow(`\u26A0 ${evt.message}`));
           }
         } else if (evt.event === "queued") {
-          const where = evt.position ? ` (position ${evt.position})` : "";
-          console.error(
-            chalk4.yellow(
-              `\u23F3 every device is busy \u2014 waiting in the queue${where}, Ctrl-C to give up`
-            )
-          );
+          console.error(chalk4.yellow(queuedLine(evt.position, evt.message)));
         } else if (evt.event === "tunnel_connected") {
           everConnected = true;
           console.error(chalk4.green("\u2713 tunnel connected \u2014 edit away, Fast Refresh is live"));
@@ -3056,7 +3064,7 @@ function formatDevicesHuman(devices) {
   const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
   const lines = [chalk5.bold(fmt(HEADERS2))];
   for (const row of rows.sort(rowSort)) {
-    const statusColored = row[5] === "available" ? chalk5.green(row[5]) : row[5] === "busy" ? chalk5.yellow(row[5]) : chalk5.dim(row[5]);
+    const statusColored = row[5] === "available" ? chalk5.green(row[5]) : row[5] === "busy" || row[5] === "updating" ? chalk5.yellow(row[5]) : chalk5.dim(row[5]);
     lines.push(fmt([row[0], row[1], row[2], row[3], row[4], statusColored]));
   }
   return lines.join("\n") + "\n";
@@ -3087,25 +3095,65 @@ function formatDeviceModelsHuman(models) {
 }
 
 // src/agent/registry.ts
-var PRESS_BUTTONS_BY_PLATFORM = [
-  ["iPhone / iPad", ["home", "back", "lock", "siri"]],
-  ["Android phone / tablet", ["home", "back", "lock"]],
-  [
-    "Apple TV / Android TV",
-    ["dpad_up", "dpad_down", "dpad_left", "dpad_right", "dpad_center", "back", "home"]
+var PRESS_BUTTONS = {
+  ios: ["home", "back", "lock", "siri", "enter"],
+  android: ["home", "back", "lock", "enter"],
+  appleTv: [
+    "dpad_up",
+    "dpad_down",
+    "dpad_left",
+    "dpad_right",
+    "dpad_center",
+    "back",
+    "home",
+    "menu"
+  ],
+  androidTv: [
+    "dpad_up",
+    "dpad_down",
+    "dpad_left",
+    "dpad_right",
+    "dpad_center",
+    "back",
+    "home",
+    "enter"
   ],
-  [
-    "Roku (beta)",
-    ["up", "down", "left", "right", "select", "back", "(dpad_* also work; home is not forwarded)"]
+  roku: [
+    "dpad_up",
+    "dpad_down",
+    "dpad_left",
+    "dpad_right",
+    "dpad_center",
+    "back",
+    "enter",
+    "up",
+    "down",
+    "left",
+    "right",
+    "select",
+    "backspace",
+    "play",
+    "rewind",
+    "forward",
+    "replay",
+    "info"
   ]
+};
+var PRESS_PLATFORM_LABELS = [
+  ["ios", "iPhone / iPad"],
+  ["android", "Android phone / tablet"],
+  ["appleTv", "Apple TV"],
+  ["androidTv", "Android TV"],
+  ["roku", "Roku (beta)"]
 ];
+var PRESS_BUTTONS_BY_PLATFORM = PRESS_PLATFORM_LABELS.map(([key, label]) => [label, PRESS_BUTTONS[key]]);
+function pressButtonLines(indent) {
+  return PRESS_BUTTONS_BY_PLATFORM.map(
+    ([platform, buttons]) => `${indent}${platform}: ${buttons.join(", ")}`
+  );
+}
 function pressButtonsHelp() {
-  return [
-    "Valid buttons:",
-    ...PRESS_BUTTONS_BY_PLATFORM.map(
-      ([platform, buttons]) => `  ${platform}: ${buttons.join(", ")}`
-    )
-  ].join("\n");
+  return ["Valid buttons:", ...pressButtonLines("  ")].join("\n");
 }
 var AGENT_COMMANDS = [
   {
@@ -3401,7 +3449,7 @@ var AGENT_COMMANDS = [
         cli: "positional",
         type: "string",
         required: true,
-        description: "Button to press. iPhone/iPad: home, back, lock, siri. Android: home, back, lock. Apple TV / Android TV: dpad_up, dpad_down, dpad_left, dpad_right, dpad_center, back, home. Roku: up, down, left, right, select, back (dpad_* also work; home is not forwarded)."
+        description: `Button to press. ${pressButtonLines("").join(". ")}.`
       }
     ]
   },
@@ -3883,7 +3931,6 @@ export {
   loadDevConfig,
   parseBuildId,
   checkDevBuild,
-  formatUtcTimestamp,
   buildRows,
   formatBuildRowsHuman,
   listBuilds,

package/dist/{chunk-U7FCGMWG.js → chunk-FTTWLCTE.js}

@@ -42,6 +42,32 @@ import { createWriteStream, mkdirSync as mkdirSync2, renameSync, rmSync } from "
 import { basename, join as join2, resolve, sep } from "path";
 import { pipeline } from "stream/promises";
 import { Readable } from "stream";
+
+// src/lib/formatters/time.ts
+function formatUtcTimestamp(iso) {
+  if (!iso) return "";
+  const hasZone = /(?:Z|[+-]\d{2}:?\d{2})$/i.test(iso);
+  const d = new Date(hasZone ? iso : `${iso}Z`);
+  if (Number.isNaN(d.getTime())) return iso;
+  return `${d.toISOString().slice(0, 19).replace("T", " ")} UTC`;
+}
+var NAIVE_ISO_DATETIME = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?$/;
+function withUtcTimestamps(value) {
+  if (typeof value === "string") {
+    return NAIVE_ISO_DATETIME.test(value) ? `${value}Z` : value;
+  }
+  if (Array.isArray(value)) return value.map((v) => withUtcTimestamps(v));
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const [k, v] of Object.entries(value)) {
+      out[k] = withUtcTimestamps(v);
+    }
+    return out;
+  }
+  return value;
+}
+
+// src/lib/api-client.ts
 var AuthError = class extends Error {
   constructor(message = "Authentication failed. Check your API token.") {
     super(message);
@@ -53,10 +79,14 @@ function errorExitCode(err, otherwise = 1) {
 }
 function reportCommandError(json, err) {
   const message = err instanceof Error ? err.message : String(err);
-  if (json) console.log(JSON.stringify({ event: "error", message }));
+  if (json) printJsonError(err);
   process.stderr.write(`error: ${message}
 `);
 }
+function printJsonError(err) {
+  const message = err instanceof Error ? err.message : String(err);
+  console.log(JSON.stringify({ event: "error", message }));
+}
 var NotFoundError = class extends Error {
   constructor(message) {
     super(message);
@@ -75,7 +105,7 @@ function extractDetail(text) {
 }
 async function parseJsonBody(resp) {
   if (resp.status === 204 || resp.status === 205) return void 0;
-  return resp.json();
+  return withUtcTimestamps(await resp.json());
 }
 var ApiClient = class {
   constructor(baseUrl, token) {
@@ -663,6 +693,16 @@ var UsageError = class extends Error {
     this.name = "UsageError";
   }
 };
+var DEVICE_STATUS_FILTERS = ["available", "busy", "updating"];
+var QUEUE_REASON_COPY = {
+  devices_busy: "All devices are in use right now.",
+  devices_updating: "Devices are being updated and will be back shortly.",
+  plan_limit: "The most sessions this app can run at once are already running.",
+  link_limit: "The most people who can play at once are already playing."
+};
+function queueReasonCopy(reason) {
+  return reason ? QUEUE_REASON_COPY[reason] ?? null : null;
+}
 
 // src/commands/upload-app.ts
 async function uploadAppBuild(filePath, options) {
@@ -746,9 +786,11 @@ export {
   loadConfig,
   saveConfig,
   resolveAuth,
+  formatUtcTimestamp,
   AuthError,
   errorExitCode,
   reportCommandError,
+  printJsonError,
   NotFoundError,
   ApiClient,
   createSpinner,
@@ -756,6 +798,8 @@ export {
   EXIT_TEST_FAIL,
   EXIT_INFRA_ERROR,
   UsageError,
+  DEVICE_STATUS_FILTERS,
+  queueReasonCopy,
   uploadAppBuild,
   describeBuild,
   uploadApp

package/dist/cli.js

@@ -11,7 +11,6 @@ import {
   formatDeviceModelsHuman,
   formatDevicesHuman,
   formatDuration,
-  formatUtcTimestamp,
   killOwnedMetro,
   listBuilds,
   loadDevConfig,
@@ -23,9 +22,10 @@ import {
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-46X7UN6Y.js";
+} from "./chunk-7IOGMM5W.js";
 import {
   ApiClient,
+  DEVICE_STATUS_FILTERS,
   EXIT_INFRA_ERROR,
   EXIT_PASS,
   EXIT_TEST_FAIL,
@@ -33,12 +33,14 @@ import {
   UsageError,
   createSpinner,
   errorExitCode,
+  formatUtcTimestamp,
   loadConfig,
+  printJsonError,
   reportCommandError,
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-U7FCGMWG.js";
+} from "./chunk-FTTWLCTE.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -52,6 +54,26 @@ import chalk2 from "chalk";
 
 // src/lib/formatters/human.ts
 import chalk from "chalk";
+
+// src/lib/formatters/cases.ts
+function resultCases(result) {
+  if (Array.isArray(result.test_runs)) return result.test_runs;
+  const failedStep = result.steps?.find((s) => s.status !== "passed");
+  return [
+    {
+      case_name: result.case_name || result.run_id,
+      status: result.status,
+      duration_ms: result.duration_ms,
+      error_message: result.error_message ?? failedStep?.error ?? null,
+      error_kind: failedStep?.error_kind ?? null,
+      error_kind_description: failedStep?.error_kind_description ?? null,
+      screenshot_signed_url: failedStep?.screenshot_signed_url ?? null,
+      url: result.url
+    }
+  ];
+}
+
+// src/lib/formatters/human.ts
 function failureLines(failure) {
   const lines = [];
   if (failure.error_kind) {
@@ -77,15 +99,17 @@ function formatHuman(result, verbose) {
   } else {
     lines.push(`  ${icon}  ${chalk.bold(result.run_id)}  ${chalk.dim(duration)}`);
   }
-  const passed = result.test_runs.filter((t) => t.status === "passed").length;
-  const total = result.test_runs.length;
+  const cases = resultCases(result);
+  const passed = cases.filter((t) => t.status === "passed").length;
+  const total = cases.length;
   lines.push(`  ${chalk.dim(`${passed}/${total} cases passed`)}`);
   if (result.url) {
     lines.push(`  ${chalk.dim(result.url)}`);
   }
-  if (result.test_runs.length > 0) {
+  const suiteCases = result.test_runs ?? [];
+  if (suiteCases.length > 0) {
     lines.push("");
-    for (const tr of result.test_runs) {
+    for (const tr of suiteCases) {
       const caseIcon = tr.status === "passed" ? chalk.green("  PASS") : tr.status === "cancelled" || tr.status === "pending" || tr.status === "running" ? chalk.yellow("  SKIP") : chalk.red("  FAIL");
       const caseDuration = tr.duration_ms ? `${(tr.duration_ms / 1e3).toFixed(1)}s` : "-";
       lines.push(`  ${caseIcon}  ${tr.case_name}  ${chalk.dim(caseDuration)}`);
@@ -134,10 +158,11 @@ function escapeXml(s) {
   return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
 function formatJunit(result) {
-  const suiteName = escapeXml(result.suite_name || result.run_id);
-  const tests = result.test_runs.length;
-  const failures = result.test_runs.filter((t) => t.status === "failed").length;
-  const errors = result.test_runs.filter((t) => t.status === "error").length;
+  const suiteName = escapeXml(result.suite_name || result.case_name || result.run_id);
+  const cases = resultCases(result);
+  const tests = cases.length;
+  const failures = cases.filter((t) => t.status === "failed").length;
+  const errors = cases.filter((t) => t.status === "error").length;
   const totalTime = result.duration_ms ? (result.duration_ms / 1e3).toFixed(1) : "0";
   const timestamp = (/* @__PURE__ */ new Date()).toISOString();
   const lines = [];
@@ -148,7 +173,7 @@ function formatJunit(result) {
   lines.push(
     `  <testsuite name="${suiteName}" tests="${tests}" failures="${failures}" errors="${errors}" time="${totalTime}" timestamp="${timestamp}">`
   );
-  for (const tr of result.test_runs) {
+  for (const tr of cases) {
     const caseName = escapeXml(tr.case_name);
     const caseTime = tr.duration_ms ? (tr.duration_ms / 1e3).toFixed(1) : "0";
     if (tr.status === "passed") {
@@ -505,6 +530,7 @@ ${chalk3.dim("Run:")} ${response.run_id}
     process.exit(mapExitCode(result.status));
   } catch (err) {
     spinner.fail(err instanceof Error ? err.message : "Unknown error");
+    if (options.output === "json") printJsonError(err);
     if (lastQueueEntryId !== void 0) {
       try {
         await client.cancelQueueEntry(lastQueueEntryId);
@@ -593,10 +619,13 @@ ${signal} received.
     const msg = err instanceof Error ? err.message : String(err);
     if (msg.startsWith("Not found:") || msg.includes("404") || /No suites match tags/.test(msg)) {
       const suffix = opts.platform ? ` on platform ${opts.platform}` : "";
-      process.stderr.write(chalk4.yellow(`No suites match tags: ${opts.tag.join(", ")}${suffix}
+      const noMatch = `No suites match tags: ${opts.tag.join(", ")}${suffix}`;
+      if (opts.output === "json") printJsonError(noMatch);
+      process.stderr.write(chalk4.yellow(`${noMatch}
 `));
       process.exit(EXIT_INFRA_ERROR);
     }
+    if (opts.output === "json") printJsonError(err);
     process.stderr.write(chalk4.red(`Failed to start: ${msg}
 `));
     process.exit(EXIT_INFRA_ERROR);
@@ -680,6 +709,7 @@ ${chalk4.dim("Matched:")} ${totalMatched} suite(s)${matchedNames.length ? " \u20
     process.stdin.pause();
   }
   if (!last) {
+    if (opts.output === "json") printJsonError("Timed out before any status was returned.");
     process.stderr.write(chalk4.red("Timed out before any status was returned.\n"));
     process.exit(EXIT_INFRA_ERROR);
   }
@@ -817,6 +847,7 @@ ${chalk5.dim("Run:")} ${response.run_id}
     process.exit(mapExitCode(result.status));
   } catch (err) {
     spinner.fail(err instanceof Error ? err.message : "Unknown error");
+    if (options.output === "json") printJsonError(err);
     if (lastQueueEntryId !== void 0) {
       try {
         await client.cancelQueueEntry(lastQueueEntryId);
@@ -3291,7 +3322,12 @@ program.command("list-devices").description("List devices registered with the pl
   new Option("--type <type>", "Filter by device type").choices(["ios", "android", "roku"])
 ).addOption(
   new Option("--category <category>", "Filter by category").choices(["phone", "tablet", "tv"])
-).addOption(new Option("--status <status>", "Filter by status").choices(["available", "busy"])).option(
+).addOption(
+  new Option(
+    "--status <status>",
+    "Filter by status (updating = being updated, takes no new session yet)"
+  ).choices([...DEVICE_STATUS_FILTERS])
+).option(
   "--models",
   "List the device models you can start instead (the names `dev --model` takes)",
   false
@@ -3465,7 +3501,7 @@ program.command("dev-reload").description(
 program.command("mcp").description(
   "Run an MCP stdio server exposing the agent verbs (tap, swipe, type, ...) plus dev_start/dev_stop/dev_reload as tools"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").action(async (opts) => {
-  const { runMcpServer } = await import("./server-XJREB7KU.js");
+  const { runMcpServer } = await import("./server-ZIUZ7U5T.js");
   await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(

package/dist/{server-XJREB7KU.js → server-ZIUZ7U5T.js}

@@ -21,11 +21,11 @@ import {
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-46X7UN6Y.js";
+} from "./chunk-7IOGMM5W.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-U7FCGMWG.js";
+} from "./chunk-FTTWLCTE.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -377,7 +377,7 @@ async function handleUploadApp(args, deps) {
   }
   const name = typeof args.name === "string" && args.name ? args.name : void 0;
   const upload = deps.uploadApp ?? (async (f, n) => {
-    const { uploadAppBuild } = await import("./upload-app-QUUXKNR2.js");
+    const { uploadAppBuild } = await import("./upload-app-MDKTSG4O.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });

package/dist/{upload-app-QUUXKNR2.js → upload-app-MDKTSG4O.js}

@@ -3,7 +3,7 @@ import {
   describeBuild,
   uploadApp,
   uploadAppBuild
-} from "./chunk-U7FCGMWG.js";
+} from "./chunk-FTTWLCTE.js";
 export {
   describeBuild,
   uploadApp,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.27.0",
+  "version": "0.27.1",
   "description": "VibeView CLI -- run mobile tests from CI/CD pipelines",
   "mcpName": "io.github.vibeview/vibeview",
   "type": "module",