vibeview 0.26.0 → 0.27.0

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

@@ -1,12 +1,15 @@
 #!/usr/bin/env node
 import {
   ApiClient,
+  AuthError,
+  NotFoundError,
   UsageError,
   createSpinner,
+  errorExitCode,
   loadConfig,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-RFFCCPGZ.js";
+} from "./chunk-U7FCGMWG.js";
 
 // src/lib/dev-config.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -246,6 +249,17 @@ 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,
@@ -269,7 +283,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 +307,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 +1087,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) {
@@ -2410,6 +2424,10 @@ function buildAppStrategy(apps, buildFlag, json, isTTY) {
   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 });
@@ -2574,15 +2592,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 +2612,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 +2663,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 +2749,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);
@@ -3056,6 +3087,26 @@ 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"]
+  ],
+  [
+    "Roku (beta)",
+    ["up", "down", "left", "right", "select", "back", "(dpad_* also work; home is not forwarded)"]
+  ]
+];
+function pressButtonsHelp() {
+  return [
+    "Valid buttons:",
+    ...PRESS_BUTTONS_BY_PLATFORM.map(
+      ([platform, buttons]) => `  ${platform}: ${buttons.join(", ")}`
+    )
+  ].join("\n");
+}
 var AGENT_COMMANDS = [
   {
     verb: "ui-tree",
@@ -3089,7 +3140,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 +3375,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 +3401,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. 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)."
       }
     ]
   },
@@ -3358,7 +3409,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 +3838,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 +3870,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));
 }
@@ -3831,6 +3883,7 @@ export {
   loadDevConfig,
   parseBuildId,
   checkDevBuild,
+  formatUtcTimestamp,
   buildRows,
   formatBuildRowsHuman,
   listBuilds,
@@ -3854,6 +3907,7 @@ export {
   formatDevicesHuman,
   filterDeviceModels,
   formatDeviceModelsHuman,
+  pressButtonsHelp,
   AGENT_COMMANDS,
   renderEnvelope,
   buildToolCall,

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

@@ -42,6 +42,21 @@ 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";
+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) console.log(JSON.stringify({ event: "error", message }));
+  process.stderr.write(`error: ${message}
+`);
+}
 var NotFoundError = class extends Error {
   constructor(message) {
     super(message);
@@ -52,6 +67,8 @@ 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;
@@ -96,7 +113,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 +185,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 +205,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 +364,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}`);
@@ -729,6 +746,9 @@ export {
   loadConfig,
   saveConfig,
   resolveAuth,
+  AuthError,
+  errorExitCode,
+  reportCommandError,
   NotFoundError,
   ApiClient,
   createSpinner,

package/dist/cli.js

@@ -11,17 +11,19 @@ import {
   formatDeviceModelsHuman,
   formatDevicesHuman,
   formatDuration,
+  formatUtcTimestamp,
   killOwnedMetro,
   listBuilds,
   loadDevConfig,
   newTransitionState,
   platformWithArticle,
+  pressButtonsHelp,
   printOutcomeLine,
   printTransition,
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-JK3T3AMW.js";
+} from "./chunk-46X7UN6Y.js";
 import {
   ApiClient,
   EXIT_INFRA_ERROR,
@@ -30,15 +32,17 @@ import {
   NotFoundError,
   UsageError,
   createSpinner,
+  errorExitCode,
   loadConfig,
+  reportCommandError,
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-RFFCCPGZ.js";
+} from "./chunk-U7FCGMWG.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";
@@ -834,10 +838,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 +872,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 +912,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 +1294,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 +1316,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 +1368,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 +1391,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 +1484,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 +1501,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 +1518,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 +1710,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 +1741,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 +1871,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 +1904,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 +1980,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 +2058,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 +2107,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 +2140,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 +2172,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 +2365,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 +2439,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 +2475,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 +2550,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 +2590,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 +2605,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 +2613,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 +2633,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 +2666,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 +2681,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 +2689,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 +2709,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 +2730,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 +2749,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 +2789,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 +2867,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 +2887,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 +2908,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 +2923,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 +2957,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 +2973,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 +2996,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 +3014,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 +3287,11 @@ 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").choices(["available", "busy"])).option(
   "--models",
   "List the device models you can start instead (the names `dev --model` takes)",
   false
@@ -3445,8 +3465,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-XJREB7KU.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 +3476,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-XJREB7KU.js}

@@ -21,11 +21,11 @@ import {
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-JK3T3AMW.js";
+} from "./chunk-46X7UN6Y.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-RFFCCPGZ.js";
+} from "./chunk-U7FCGMWG.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-QUUXKNR2.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-QUUXKNR2.js}

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "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). |