vibeview 0.26.0 → 0.27.1

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

@@ -1,12 +1,17 @@
 #!/usr/bin/env node
 import {
   ApiClient,
+  AuthError,
+  NotFoundError,
   UsageError,
   createSpinner,
+  errorExitCode,
+  formatUtcTimestamp,
   loadConfig,
+  queueReasonCopy,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-RFFCCPGZ.js";
+} from "./chunk-FTTWLCTE.js";
 
 // src/lib/dev-config.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -269,7 +274,7 @@ function formatBuildRowsHuman(app, rows) {
     r.version ? `${r.version}${r.build_number ? ` (${r.build_number})` : ""}` : r.build_number ?? "",
     r.platform,
     r.kind,
-    r.uploaded_at ?? "",
+    formatUtcTimestamp(r.uploaded_at),
     (r.note ?? "").split("\n")[0]
   ]);
   const widths = HEADERS.map((h, i) => Math.max(h.length, ...cells.map((c) => c[i].length)));
@@ -293,7 +298,7 @@ async function listBuilds(appId, opts, deps) {
     const message = err instanceof Error ? err.message : String(err);
     if (opts.json) console.log(JSON.stringify({ event: "error", message }));
     console.error(chalk.red(`error: ${message}`));
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 
@@ -1073,7 +1078,7 @@ async function buildCommand(opts, cloudDeps) {
     if (!(err instanceof BuildFailError)) {
       printFailure(opts, err instanceof Error ? err.message : String(err));
     }
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function printFailure(opts, message, code) {
@@ -2182,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));
 }
@@ -2218,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;
@@ -2309,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 (; ; ) {
@@ -2316,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) {
@@ -2335,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));
@@ -2354,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");
@@ -2404,12 +2420,29 @@ 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";
   if (json || !isTTY) return "pick";
   return "ask";
 }
+function noBuildConfigMessage(platform, interactive) {
+  const addKey = `add platforms.${platform}.build {command, artifact} to vibeview.json`;
+  return interactive ? `no build config for ${platform}: ${addKey}, or run \`vibeview build --platform ${platform}\` once to set it up` : `no build config for ${platform}: ${addKey}`;
+}
 function requireNonInteractive(json, message) {
   if (!json) return;
   emit(json, { event: "error", code: "config_required", message });
@@ -2477,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);
   }
@@ -2574,15 +2605,17 @@ Run \`vibeview dev\` without --app to pick from the list.`
     firstRunMetro,
     firstRunBuild
   });
-  saveDevConfig(process.cwd(), cfg);
-  if (isFirstRun) {
-    console.error(chalk4.dim(`Created vibeview.json (platform: ${platform}, app: ${appId}).`));
-    const hint = fillLaterHint(
-      { build: !firstRunBuild, metro: PLATFORM_NEEDS_METRO[platform] && !firstRunMetro },
-      platform
-    );
-    if (hint) console.error(chalk4.dim(hint));
-  }
+  const commitConfig = () => {
+    saveDevConfig(process.cwd(), cfg);
+    if (isFirstRun) {
+      console.error(chalk4.dim(`Created vibeview.json (platform: ${platform}, app: ${appId}).`));
+      const hint = fillLaterHint(
+        { build: !firstRunBuild, metro: PLATFORM_NEEDS_METRO[platform] && !firstRunMetro },
+        platform
+      );
+      if (hint) console.error(chalk4.dim(hint));
+    }
+  };
   const finalMetro = isFirstRun ? resolveMetro(cfg, platform, opts.metroPort ? parseInt(opts.metroPort, 10) : void 0) : metroResolved;
   return {
     platform,
@@ -2592,7 +2625,9 @@ Run \`vibeview dev\` without --app to pick from the list.`
     metroPort: finalMetro.port,
     metroCommand: finalMetro.command,
     platformHasMetroOverride: finalMetro.platformHasOverride,
-    builtThisRun
+    builtThisRun,
+    savedConfig: cfg,
+    commitConfig
   };
 }
 async function runDevInProcess(opts) {
@@ -2641,11 +2676,20 @@ async function runDevInProcess(opts) {
       process.exit(1);
     }
   }
+  const interactive = !opts.json && Boolean(process.stdin.isTTY);
+  const plannedBuild = cfg.savedConfig.platforms?.[cfg.platform]?.build;
+  if (!plannedBuild && (opts.build === true && !cfg.builtThisRun || !PLATFORM_NEEDS_METRO[cfg.platform])) {
+    const message = noBuildConfigMessage(cfg.platform, interactive);
+    console.error(chalk4.red(`error: ${message}`));
+    emit(opts.json, { event: "error", code: "config_required", message });
+    process.exit(1);
+  }
+  cfg.commitConfig();
   if (opts.build === true && !cfg.builtThisRun) {
     const reloaded = loadDevConfig(process.cwd());
     const build = reloaded?.platforms?.[cfg.platform]?.build;
     if (!build) {
-      const message = `no build config for ${cfg.platform} \u2014 run vibeview build once to set it up`;
+      const message = noBuildConfigMessage(cfg.platform, interactive);
       console.error(chalk4.red(`error: ${message}`));
       emit(opts.json, { event: "error", code: "config_required", message });
       process.exit(1);
@@ -2718,7 +2762,7 @@ async function runDevInProcess(opts) {
     rokuBuild = rokuEntry?.build;
     watchIgnore = rokuEntry?.watchIgnore ?? [];
     if (!rokuBuild) {
-      const message = `no build config for ${cfg.platform} \u2014 run \`vibeview build --platform ${cfg.platform}\` once to set it up`;
+      const message = noBuildConfigMessage(cfg.platform, interactive);
       console.error(chalk4.red(`error: ${message}`));
       emit(opts.json, { event: "error", code: "config_required", message });
       process.exit(1);
@@ -2775,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"));
@@ -3025,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";
@@ -3056,6 +3095,66 @@ function formatDeviceModelsHuman(models) {
 }
 
 // src/agent/registry.ts
+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: [
+    "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:", ...pressButtonLines("  ")].join("\n");
+}
 var AGENT_COMMANDS = [
   {
     verb: "ui-tree",
@@ -3089,7 +3188,7 @@ var AGENT_COMMANDS = [
   {
     verb: "screenshot",
     tool: "screenshot",
-    summary: "Capture a screenshot of the current screen. Use it to check how something LOOKS \u2014 the UI tree carries no colour, contrast, or stacking information, so a screen can pass every check the tree can express and still be visibly broken. Saved to disk; over MCP, pass inline: true to receive the image itself.",
+    summary: "Capture a screenshot of the current screen. Use it to check how something LOOKS \u2014 the UI tree carries no colour, contrast, or stacking information, so a screen can pass every check the tree can express and still be visibly broken. Saved to disk; over MCP, pass inline: true to receive the image itself. On a phone or tablet its pixels are the coordinates `tap`/`drag` take, so a point read off it can be tapped as is.",
     mutating: false,
     params: [
       {
@@ -3324,7 +3423,7 @@ var AGENT_COMMANDS = [
         cli: "positional",
         type: "string",
         required: true,
-        description: "Text to type into the focused field."
+        description: "Text to type into the focused field. On a phone or tablet a line break presses Enter, which submits the field (bash: $'query\\n'); `press enter` does the same."
       }
     ]
   },
@@ -3350,7 +3449,7 @@ var AGENT_COMMANDS = [
         cli: "positional",
         type: "string",
         required: true,
-        description: "Button to press: home, back, lock, siri, dpad_up, dpad_down, dpad_left, dpad_right, or dpad_center."
+        description: `Button to press. ${pressButtonLines("").join(". ")}.`
       }
     ]
   },
@@ -3358,7 +3457,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.",
+    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.",
     mutating: true,
     params: [
       {
@@ -3787,13 +3886,13 @@ async function runAgentVerb(cmd, positionals, opts) {
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     if (opts.json) {
-      const code = /^authentication failed/i.test(message) ? "auth_failed" : /^not found:/i.test(message) ? "not_found" : void 0;
+      const code = err instanceof AuthError ? "auth_failed" : err instanceof NotFoundError ? "not_found" : void 0;
       console.log(JSON.stringify({ event: "error", code, message }));
     } else {
       process.stderr.write(`error: ${message}
 `);
     }
-    process.exit(1);
+    process.exit(errorExitCode(err));
   }
   if (cmd.verb === "screenshot" && envelope.ok && envelope.result) {
     const outPath = opts.out || defaultScreenshotPath();
@@ -3819,6 +3918,7 @@ async function runAgentVerb(cmd, positionals, opts) {
     console.log(JSON.stringify(envelope));
   } else {
     console.log(renderEnvelope(envelope));
+    if (cmd.verb === "press" && !envelope.ok) process.stderr.write(pressButtonsHelp() + "\n");
   }
   process.exit(agentExitCode(envelope));
 }
@@ -3854,6 +3954,7 @@ export {
   formatDevicesHuman,
   filterDeviceModels,
   formatDeviceModelsHuman,
+  pressButtonsHelp,
   AGENT_COMMANDS,
   renderEnvelope,
   buildToolCall,

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

@@ -42,6 +42,51 @@ 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);
+    this.name = "AuthError";
+  }
+};
+function errorExitCode(err, otherwise = 1) {
+  return err instanceof AuthError ? 2 : otherwise;
+}
+function reportCommandError(json, err) {
+  const message = err instanceof Error ? err.message : String(err);
+  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);
@@ -52,13 +97,15 @@ function extractDetail(text) {
   try {
     const parsed = JSON.parse(text);
     if (parsed && typeof parsed.detail === "string") return parsed.detail;
+    if (parsed && parsed.detail && typeof parsed.detail.message === "string")
+      return parsed.detail.message;
   } catch {
   }
   return void 0;
 }
 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) {
@@ -96,7 +143,7 @@ var ApiClient = class {
     });
     if (!resp.ok) {
       const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
+      if (resp.status === 401) throw new AuthError();
       if (resp.status === 404) throw new NotFoundError(`Not found: ${extractDetail(text) ?? path}`);
       throw new Error(extractDetail(text) ?? `API error ${resp.status}: ${text}`);
     }
@@ -168,7 +215,7 @@ var ApiClient = class {
     });
     if (!resp.ok) {
       const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
+      if (resp.status === 401) throw new AuthError();
       if (resp.status === 404) throw new NotFoundError(`Not found: ${extractDetail(text) ?? path}`);
       throw new Error(extractDetail(text) ?? `API error ${resp.status}: ${text}`);
     }
@@ -188,7 +235,7 @@ var ApiClient = class {
     });
     if (!resp.ok) {
       const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
+      if (resp.status === 401) throw new AuthError();
       if (resp.status === 404) throw new NotFoundError(`Not found: ${extractDetail(text) ?? path}`);
       throw new Error(extractDetail(text) ?? `API error ${resp.status}: ${text}`);
     }
@@ -347,7 +394,7 @@ var ApiClient = class {
     const resp = await this.fetchOrExplain(url, { method: "GET", headers });
     if (!resp.ok) {
       const text = await resp.text().catch(() => "");
-      if (resp.status === 401) throw new Error("Authentication failed. Check your API token.");
+      if (resp.status === 401) throw new AuthError();
       if (resp.status === 404)
         throw new NotFoundError(`Not found: ${extractDetail(text) ?? `/builds/${id}/artifact`}`);
       throw new Error(extractDetail(text) ?? `API error ${resp.status}: ${text}`);
@@ -646,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) {
@@ -729,6 +786,11 @@ export {
   loadConfig,
   saveConfig,
   resolveAuth,
+  formatUtcTimestamp,
+  AuthError,
+  errorExitCode,
+  reportCommandError,
+  printJsonError,
   NotFoundError,
   ApiClient,
   createSpinner,
@@ -736,6 +798,8 @@ export {
   EXIT_TEST_FAIL,
   EXIT_INFRA_ERROR,
   UsageError,
+  DEVICE_STATUS_FILTERS,
+  queueReasonCopy,
   uploadAppBuild,
   describeBuild,
   uploadApp

package/dist/cli.js

@@ -16,29 +16,35 @@ import {
   loadDevConfig,
   newTransitionState,
   platformWithArticle,
+  pressButtonsHelp,
   printOutcomeLine,
   printTransition,
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-JK3T3AMW.js";
+} from "./chunk-7IOGMM5W.js";
 import {
   ApiClient,
+  DEVICE_STATUS_FILTERS,
   EXIT_INFRA_ERROR,
   EXIT_PASS,
   EXIT_TEST_FAIL,
   NotFoundError,
   UsageError,
   createSpinner,
+  errorExitCode,
+  formatUtcTimestamp,
   loadConfig,
+  printJsonError,
+  reportCommandError,
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-RFFCCPGZ.js";
+} from "./chunk-FTTWLCTE.js";
 
 // src/cli.ts
 import { createRequire } from "module";
-import { Command } from "commander";
+import { Command, Option } from "commander";
 
 // src/commands/run-suite.ts
 import chalk3 from "chalk";
@@ -48,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) {
@@ -73,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)}`);
@@ -130,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 = [];
@@ -144,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") {
@@ -501,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);
@@ -589,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);
@@ -676,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);
   }
@@ -813,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);
@@ -834,10 +869,16 @@ import chalk6 from "chalk";
 async function listSuites(options) {
   const { token, baseUrl } = resolveAuth(options);
   const client = new ApiClient(baseUrl, token);
-  const suites = await client.listSuites({
-    tags: options.tag && options.tag.length > 0 ? options.tag : void 0,
-    match: options.match
-  });
+  let suites;
+  try {
+    suites = await client.listSuites({
+      tags: options.tag && options.tag.length > 0 ? options.tag : void 0,
+      match: options.match
+    });
+  } catch (err) {
+    reportCommandError(options.output === "json", err);
+    process.exit(EXIT_INFRA_ERROR);
+  }
   if (options.output === "json") {
     console.log(JSON.stringify(suites, null, 2));
     return;
@@ -862,7 +903,13 @@ import chalk7 from "chalk";
 async function listApps(options) {
   const { token, baseUrl } = resolveAuth(options);
   const client = new ApiClient(baseUrl, token);
-  const apps = await client.listApps();
+  let apps;
+  try {
+    apps = await client.listApps();
+  } catch (err) {
+    reportCommandError(options.output === "json", err);
+    process.exit(EXIT_INFRA_ERROR);
+  }
   if (options.output === "json") {
     console.log(JSON.stringify(apps, null, 2));
     return;
@@ -896,7 +943,7 @@ async function stopCommand(sessionId, opts, deps) {
     const message = err instanceof Error ? err.message : String(err);
     if (opts.json) console.log(JSON.stringify({ stopped: false, session_id: id, message }));
     console.error(chalk8.red(`error: ${message}`));
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
     return;
   }
   const state = readDevState(process.cwd());
@@ -1278,8 +1325,10 @@ import chalk13 from "chalk";
 // src/lib/formatters/builds.ts
 import chalk12 from "chalk";
 var HEADERS = ["ID", "PLATFORM", "STATUS", "CREATED", "COST", "APP"];
-function formatCostCell(costMicro) {
-  return costMicro > 0 ? `$${(costMicro / 1e6).toFixed(2)}` : "";
+var UNBILLED_STATUSES = /* @__PURE__ */ new Set(["queued", "running"]);
+function formatCostCell(costMicro, status) {
+  if (costMicro <= 0 && UNBILLED_STATUSES.has(status)) return "-";
+  return `$${(Math.max(costMicro, 0) / 1e6).toFixed(2)}`;
 }
 var STATUS_COLOR = {
   succeeded: chalk12.green,
@@ -1298,8 +1347,8 @@ function formatBuildsHuman(builds2) {
     b.id,
     b.platform,
     b.status,
-    b.created_at ?? "",
-    formatCostCell(b.cost_micro),
+    formatUtcTimestamp(b.created_at),
+    formatCostCell(b.cost_micro, b.status),
     b.app_public_id ?? ""
   ]);
   const widths = HEADERS.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
@@ -1350,7 +1399,7 @@ async function buildsList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function buildsLogs(id, opts, deps) {
@@ -1373,7 +1422,7 @@ async function buildsLogs(id, opts, deps) {
     process.exitCode = final.status === "succeeded" ? 0 : 1;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 var MAX_CONSECUTIVE_POLL_FAILURES = 5;
@@ -1466,7 +1515,7 @@ async function buildsDownload(id, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function buildsCancel(id, opts, deps) {
@@ -1483,7 +1532,7 @@ async function buildsCancel(id, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function buildsDeleteArtifact(id, opts, deps) {
@@ -1500,7 +1549,7 @@ async function buildsDeleteArtifact(id, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function printError(opts, err) {
@@ -1692,7 +1741,7 @@ async function submitCommand(opts, deps) {
     process.exitCode = final.status === "succeeded" ? 0 : 1;
   } catch (err) {
     printError2(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
@@ -1723,7 +1772,7 @@ async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
     process.exitCode = result.ready ? 0 : 1;
   } catch (err) {
     printError2(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function resolveLatestBuild(platform, deps) {
@@ -1853,7 +1902,7 @@ async function versionsList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError3(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function versionsSet(buildNumber, opts, deps) {
@@ -1886,7 +1935,7 @@ async function versionsSet(buildNumber, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError3(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 var HEADERS2 = ["PLATFORM", "BUILD NUMBER", "UPDATED"];
@@ -1962,7 +2011,7 @@ Create an admin API token in the dashboard and use ${chalk16.bold("--token")} or
       console.log(JSON.stringify({ event: "error", message }));
     }
     console.error(chalk16.red(`error: ${message}`));
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 
@@ -2040,7 +2089,7 @@ async function envList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError4(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatEnvVarsHuman(variables) {
@@ -2089,7 +2138,7 @@ async function envSet(name, value, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError4(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function resolveVisibility(opts) {
@@ -2122,7 +2171,7 @@ async function envRm(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError4(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function envPull(opts, deps) {
@@ -2154,7 +2203,7 @@ async function envPull(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError4(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function isLossyEnvValue(value) {
@@ -2347,7 +2396,7 @@ async function credentialsAdd(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function credentialsGenerate(opts, deps) {
@@ -2421,7 +2470,7 @@ async function credentialsGenerate(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function generateAppleCredential(platform, opts, d) {
@@ -2457,7 +2506,7 @@ async function generateAppleCredential(platform, opts, d) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function credentialsDownload(name, opts, deps) {
@@ -2532,7 +2581,7 @@ async function credentialsDownload(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function ascKeyAdd(opts, deps) {
@@ -2572,7 +2621,7 @@ async function ascKeyAdd(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function ascKeyList(opts, deps) {
@@ -2587,7 +2636,7 @@ async function ascKeyList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatAscKeysHuman(keys) {
@@ -2595,7 +2644,7 @@ function formatAscKeysHuman(keys) {
     return "No App Store Connect keys found.\n";
   }
   const HEADERS3 = ["NAME", "KEY ID", "ISSUER ID", "CREATED"];
-  const rows = keys.map((k) => [k.name, k.key_id, k.issuer_id, k.created_at ?? ""]);
+  const rows = keys.map((k) => [k.name, k.key_id, k.issuer_id, formatUtcTimestamp(k.created_at)]);
   const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join3 = (cells) => cells.join("  ").trimEnd();
@@ -2615,7 +2664,7 @@ async function ascKeyRm(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function playKeyAdd(opts, deps) {
@@ -2648,7 +2697,7 @@ async function playKeyAdd(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function playKeyList(opts, deps) {
@@ -2663,7 +2712,7 @@ async function playKeyList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatPlayKeysHuman(keys) {
@@ -2671,7 +2720,7 @@ function formatPlayKeysHuman(keys) {
     return "No Google Play keys found.\n";
   }
   const HEADERS3 = ["NAME", "CLIENT EMAIL", "CREATED"];
-  const rows = keys.map((k) => [k.name, k.client_email, k.created_at ?? ""]);
+  const rows = keys.map((k) => [k.name, k.client_email, formatUtcTimestamp(k.created_at)]);
   const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join3 = (cells) => cells.join("  ").trimEnd();
@@ -2691,7 +2740,7 @@ async function playKeyRm(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function credentialsList(opts, deps) {
@@ -2712,7 +2761,7 @@ async function credentialsList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatIdentity(c) {
@@ -2731,10 +2780,10 @@ function earliestExpiry(c) {
 function formatExpires(c) {
   const parts = [];
   if (c.profile_expires_at) {
-    if (c.expires_at) parts.push(`cert ${c.expires_at}`);
-    parts.push(`profile ${c.profile_expires_at}`);
+    if (c.expires_at) parts.push(`cert ${formatUtcTimestamp(c.expires_at)}`);
+    parts.push(`profile ${formatUtcTimestamp(c.profile_expires_at)}`);
   } else if (c.expires_at) {
-    parts.push(c.expires_at);
+    parts.push(formatUtcTimestamp(c.expires_at));
   }
   if (parts.length === 0) return "";
   const cell = parts.join(" \xB7 ");
@@ -2771,7 +2820,7 @@ async function credentialsRm(name, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError5(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function printKeystoreWriteFailure(opts, err, result) {
@@ -2849,14 +2898,14 @@ async function webhooksAdd(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError6(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function formatLastDelivery(ld) {
   if (!ld) return "\u2014";
   if (ld.status === "pending") return "pending";
   const code = ld.response_code != null ? ` (${ld.response_code})` : "";
-  const at = ld.at != null ? ` ${ld.at}` : "";
+  const at = ld.at != null ? ` ${formatUtcTimestamp(ld.at)}` : "";
   return `${ld.status}${code}${at}`;
 }
 function formatWebhooksHuman(webhooks2) {
@@ -2869,7 +2918,7 @@ function formatWebhooksHuman(webhooks2) {
     w.url,
     w.active ? "yes" : "no",
     formatLastDelivery(w.last_delivery),
-    w.created_at
+    formatUtcTimestamp(w.created_at)
   ]);
   const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
@@ -2890,7 +2939,7 @@ async function webhooksList(opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError6(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 async function webhooksRm(id, opts, deps) {
@@ -2905,7 +2954,7 @@ async function webhooksRm(id, opts, deps) {
     process.exitCode = 0;
   } catch (err) {
     printError6(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function parseUtcTimestamp(iso) {
@@ -2939,7 +2988,7 @@ async function webhooksTest(id, opts, deps) {
         } else {
           if (!opts.json) {
             const code = ld.response_code != null ? `HTTP ${ld.response_code}` : "no response";
-            console.error(chalk19.red(`\u2717 Failed (${code}) at ${ld.at}`));
+            console.error(chalk19.red(`\u2717 Failed (${code}) at ${formatUtcTimestamp(ld.at)}`));
           }
           process.exitCode = 1;
         }
@@ -2955,7 +3004,7 @@ async function webhooksTest(id, opts, deps) {
     process.exitCode = 1;
   } catch (err) {
     printError6(opts, err);
-    process.exitCode = 1;
+    process.exitCode = errorExitCode(err);
   }
 }
 function printError6(opts, err) {
@@ -2978,8 +3027,7 @@ async function listDevicesCommand(options) {
       }
       process.exit(EXIT_PASS);
     } catch (err) {
-      process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}
-`);
+      reportCommandError(options.output === "json", err);
       process.exit(EXIT_INFRA_ERROR);
     }
     return;
@@ -2997,8 +3045,7 @@ async function listDevicesCommand(options) {
     }
     process.exit(EXIT_PASS);
   } catch (err) {
-    process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}
-`);
+    reportCommandError(options.output === "json", err);
     process.exit(EXIT_INFRA_ERROR);
   }
 }
@@ -3271,7 +3318,16 @@ program.command("list-apps").description("List apps in your organization").optio
 program.command("list-builds <app>").description(
   "List an app's uploaded builds, newest first: id, version, platform, debug/release, upload time and note (the ids `dev --build <id>` and `run-test --build` take)"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--json", "Print the builds as a JSON array", false).action((app, opts) => listBuilds(app, opts));
-program.command("list-devices").description("List devices registered with the platform (filterable by type and category)").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--type <type>", "Filter by device type: ios, android, roku").option("--category <category>", "Filter by category: phone, tablet, tv").option("--status <status>", "Filter by status: available, busy, offline").option(
+program.command("list-devices").description("List devices registered with the platform (filterable by type and category)").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").addOption(
+  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 (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
@@ -3445,8 +3501,8 @@ 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-KYDTXPRZ.js");
-  await runMcpServer(opts);
+  const { runMcpServer } = await import("./server-ZIUZ7U5T.js");
+  await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(
   "Make VibeView discoverable to your coding agent: install the vibeview-agent skill (and optionally register the MCP server with Claude Code)"
@@ -3456,6 +3512,8 @@ for (const cmd of AGENT_COMMANDS) {
   const flagParams = cmd.params.filter((p) => p.cli !== "positional");
   const argSignature = positionalParams.map((p) => p.required ? `<${p.name}>` : `[${p.name}]`).join(" ");
   let command = program.command(argSignature ? `${cmd.verb} ${argSignature}` : cmd.verb).description(cmd.summary);
+  if (cmd.verb === "press") command.addHelpText("after", `
+${pressButtonsHelp()}`);
   for (const param of flagParams) {
     const flagArg = param.type === "number" ? `${param.cli} <n>` : `${param.cli} <value>`;
     command = command.option(flagArg, param.description);

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

@@ -21,11 +21,11 @@ import {
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-JK3T3AMW.js";
+} from "./chunk-7IOGMM5W.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-RFFCCPGZ.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-E32EZXYQ.js");
+    const { uploadAppBuild } = await import("./upload-app-MDKTSG4O.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -578,7 +578,7 @@ async function createMcpServer(opts) {
     agentTool: client.agentTool.bind(client),
     devSession
   };
-  const server = new McpServer({ name: "vibeview", version: "1.0.0" });
+  const server = new McpServer({ name: "vibeview", version: opts.version ?? "0.0.0" });
   function zodShape(def) {
     const shape = {};
     for (const [key, prop] of Object.entries(def.properties)) {

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

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

package/package.json

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

package/skills/vibeview-agent/SKILL.md

@@ -134,6 +134,9 @@ it rather than letting it appear unexplained in their `git status`.
   ```bash
   vibeview scroll-to "Delete account" --session <id>
   ```
+  A `scroll-to` that never finds its text, or a `type` whose field does not
+  end up holding the text, prints `error` and exits 1 — check the reason
+  line and the screen before retrying.
 - **Precise two-point gestures** (sliders, drag-and-drop reorder, map
   panning) need `drag` — `swipe`/`scroll` are direction-only and can't
   express them. Each end is independently a ref or `x,y`:
@@ -247,18 +250,18 @@ human-readable text.
 |------|------|---------|
 | `ui-tree` | — | Fetch the ref-annotated UI tree for the current screen. |
 | `logs` | `[--tail <n>] [--since <cursor>]` | Read recent app logs from the device (JS console, native errors, crash messages). The response's `cursor` feeds the next call's `--since`. |
-| `screenshot` | `[--out <path>]` | Capture a screenshot of the current screen and save it to disk. |
-| `tap` | `<target>` | Tap an element by ref (e.g. `@e5`), or raw coordinates (e.g. `100,200`). |
+| `screenshot` | `[--out <path>]` | Capture a screenshot of the current screen and save it to disk. On a phone or tablet its pixels are tap coordinates: a point read off it can be tapped as is — never rescale. |
+| `tap` | `<target>` | Tap an element by ref (e.g. `@e5`), or coordinates (e.g. `100,200`) in the space of the tree's rects and the screenshot's pixels. |
 | `long-press` | `<ref>` `[--ms <n>]` | Long-press (touch and hold) an element by its ref. |
 | `swipe` | `<direction>` `[--distance <short\|medium\|long>]` | Perform a scrollbar-semantic swipe gesture in one of four directions. |
 | `scroll` | `<direction>` | Scroll the current view up, down, left, or right using a gesture preset. |
 | `scroll-to` | `<text>` `[--direction <up\|down\|left\|right>] [--max-scrolls <n>] [--element-type <type>]` | Scroll until an element matching the text is visible. Stops at end of list. |
 | `drag` | `<from>` `<to>` `[--velocity <n>] [--press-ms <n>] [--hold-ms <n>]` | Drag between two points, each an `@ref` or `x,y`. The only precise two-point gesture. |
 | `alert` | `<get\|accept\|dismiss>` `[--button <label>]` | Inspect or respond to a system alert on iOS or Apple TV. |
-| `type` | `<text>` | Type text into the currently focused input field. |
+| `type` | `<text>` | Type text into the currently focused input field. On a phone or tablet a line break presses Enter and submits the field (`$'query\n'`), like `press enter`. |
 | `clear-text` | — | Clear the text in the currently focused input field. |
 | `press` | `<button>` | Press a device button or perform a system gesture (home, back, d-pad, etc). |
-| `open-url` | `<url>` | Open a deep link or URL in the app under test. |
+| `open-url` | `<url>` | Open a deep link or URL in the app under test. The link goes to that app only; a link it has no screen for fails (no browser). |
 | `set-posture` | `<closed\|partial\|open>` or `--angle <0-180>` | Fold or unfold a foldable device (form factor `foldable`: the iPhone Duo, Android foldables) to a preset or an exact hinge angle — exactly one. Reports posture, angle and lit screen. Errors on a device without a hinge. |
 | `rotate` | `[--degrees <90\|180\|270>]` | Rotate the device and report the new orientation. Phones/tablets and Android foldables toggle portrait/landscape (90 only); the iPhone Duo turns a quarter clockwise by default. Not on TV. |
 | `wait` | `[--ms <n>]` | Wait for a specified number of seconds before continuing (default: 2s). |