vibeview 0.20.3 → 0.21.0

package/dist/{chunk-MCCXPIGE.js → chunk-KON2FOEC.js}

@@ -490,6 +490,15 @@ var ApiClient = class {
       ...body.changesNotSentForReview !== void 0 ? { changes_not_sent_for_review: body.changesNotSentForReview } : {}
     });
   }
+  /** GET /api/v1/submissions/preflight — is the store ready to receive
+   *  this app? Answers by identifier (bundle id / package name), so it can
+   *  run before any build exists. Always resolves — a "not ready" is an
+   *  answer carried in `status`/`message`, never a thrown error. */
+  async checkStorePreflight(q) {
+    const params = new URLSearchParams({ platform: q.platform, identifier: q.identifier });
+    if (q.ascKey !== void 0) params.set("asc_key", q.ascKey);
+    return this.requestRaw("GET", `/submissions/preflight?${params.toString()}`);
+  }
   /** GET /api/v1/submissions?build=<id> — that build's submissions, newest
    *  first. */
   async listSubmissions(build) {

package/dist/{chunk-QZNZPKHV.js → chunk-VVKF7GGL.js}

@@ -6,7 +6,7 @@ import {
   loadConfig,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-MCCXPIGE.js";
+} from "./chunk-KON2FOEC.js";
 
 // src/lib/dev-state.ts
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
@@ -2068,16 +2068,33 @@ async function startDevSession(cfg, onEvent = () => {
   const sessionId = created.session_id;
   let stopping = false;
   let tunnel = null;
+  let queueEntryId = null;
   const stopSession = async (code) => {
     if (stopping) return;
     stopping = true;
     tunnel?.stop();
+    if (queueEntryId !== null) {
+      await api.cancelQueueEntry(queueEntryId).catch(() => {
+      });
+      queueEntryId = null;
+    }
     await api.stopSession(sessionId).catch(() => {
     });
     onEvent({ event: "session_ended", session_id: sessionId, code });
   };
   try {
-    await api.startSession(sessionId);
+    const started = await api.startSession(sessionId);
+    if (started.status === "queued") {
+      queueEntryId = started.queue_entry_id ?? null;
+      onEvent({
+        event: "queued",
+        session_id: sessionId,
+        position: started.position ?? null,
+        queue_entry_id: queueEntryId
+      });
+      await pollWhileQueued(api, sessionId, QUEUE_WAIT_MS);
+      queueEntryId = null;
+    }
     const pageUrl = `${cfg.webUrl || cfg.baseUrl}/sandbox/${sessionId}`;
     const reportedWarnings = /* @__PURE__ */ new Set();
     if (usesTunnel) {
@@ -2142,6 +2159,25 @@ var BLOCKING_WARNING_PREFIXES = ["No debug build", "App install failed", "App no
 function findBlockingWarning(info) {
   return (info.warnings ?? []).find((w) => BLOCKING_WARNING_PREFIXES.some((p) => w.includes(p)));
 }
+var QUEUE_WAIT_MS = 30 * 6e4;
+async function pollWhileQueued(api, sessionId, timeoutMs, intervalMs = 3e3) {
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    const info = await api.getSession(sessionId);
+    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`);
+    }
+    if (info.status !== "pending" && info.status !== "queued") return info;
+    if (Date.now() > deadline) {
+      throw new Error(
+        `no device became free within ${Math.round(timeoutMs / 6e4)} minutes \u2014 try again later or pick another device`
+      );
+    }
+    await new Promise((r) => setTimeout(r, intervalMs));
+  }
+}
 async function pollUntilTunnelReady(api, sessionId, timeoutMs, intervalMs = 2e3) {
   const deadline = Date.now() + timeoutMs;
   for (; ; ) {
@@ -2537,6 +2573,13 @@ async function runDevInProcess(opts) {
           } else {
             console.error(chalk3.yellow(`\u26A0 ${evt.message}`));
           }
+        } else if (evt.event === "queued") {
+          const where = evt.position ? ` (position ${evt.position})` : "";
+          console.error(
+            chalk3.yellow(
+              `\u23F3 every device is busy \u2014 waiting in the queue${where}, Ctrl-C to give up`
+            )
+          );
         } else if (evt.event === "tunnel_connected") {
           everConnected = true;
           console.error(chalk3.green("\u2713 tunnel connected \u2014 edit away, Fast Refresh is live"));

package/dist/cli.js

@@ -15,7 +15,7 @@ import {
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-QZNZPKHV.js";
+} from "./chunk-VVKF7GGL.js";
 import {
   ApiClient,
   EXIT_INFRA_ERROR,
@@ -28,7 +28,7 @@ import {
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-MCCXPIGE.js";
+} from "./chunk-KON2FOEC.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -1387,7 +1387,8 @@ function defaultDeps2(client) {
     createSubmission: client.createSubmission.bind(client),
     getSubmission: client.getSubmission.bind(client),
     getSubmissionLog: client.getSubmissionLog.bind(client),
-    listCloudBuilds: client.listCloudBuilds.bind(client)
+    listCloudBuilds: client.listCloudBuilds.bind(client),
+    checkStorePreflight: client.checkStorePreflight.bind(client)
   };
 }
 var POLL_INTERVAL_MS2 = 2e3;
@@ -1450,10 +1451,20 @@ async function submitCommand(opts, deps) {
   }
   const platform = opts.platform;
   const androidFamily = platform === "android" || platform === "androidtv";
-  if (opts.build && opts.latest) {
+  if (opts.check && (opts.build || opts.latest)) {
+    throw new UsageError(
+      "--check looks the app up by identifier, not by build \u2014 drop --build/--latest (pass --bundle-id for ios/tvos or --package for android/androidtv)"
+    );
+  }
+  if (!opts.check && opts.bundleId !== void 0) {
+    throw new UsageError(
+      "--bundle-id only applies with --check \u2014 a submission reads the bundle id from the build itself"
+    );
+  }
+  if (!opts.check && opts.build && opts.latest) {
     throw new UsageError("pass either --build <id> or --latest, not both");
   }
-  if (!opts.build && !opts.latest) {
+  if (!opts.check && !opts.build && !opts.latest) {
     throw new UsageError(
       "pass --build <id> (see `vibeview builds list`) or --latest (the newest succeeded production build for this platform)"
     );
@@ -1467,6 +1478,11 @@ async function submitCommand(opts, deps) {
   if (androidFamily && opts.ascKey !== void 0) {
     throw new UsageError(`--asc-key only applies to ios/tvos (TestFlight) \u2014 not ${platform}`);
   }
+  if (androidFamily && opts.bundleId !== void 0) {
+    throw new UsageError(
+      `--bundle-id only applies to ios/tvos \u2014 for ${platform} pass --package <name>`
+    );
+  }
   if (!androidFamily && opts.releaseStatus !== void 0) {
     throw new UsageError(
       `--release-status only applies to android/androidtv (Play) \u2014 not ${platform}`
@@ -1508,6 +1524,10 @@ async function submitCommand(opts, deps) {
   const { token, baseUrl } = resolveAuth(opts);
   const client = new ApiClient(baseUrl, token);
   const d = deps ?? defaultDeps2(client);
+  if (opts.check) {
+    await checkStore(platform, androidFamily, ascKey2, opts, d);
+    return;
+  }
   try {
     const buildId = opts.build ?? await resolveLatestBuild(platform, d);
     const sub = await d.createSubmission({
@@ -1546,6 +1566,37 @@ async function submitCommand(opts, deps) {
     process.exitCode = 1;
   }
 }
+async function checkStore(platform, androidFamily, ascKey2, opts, deps) {
+  const identifier = androidFamily ? opts.package : opts.bundleId;
+  if (!identifier) {
+    throw new UsageError(
+      androidFamily ? `--check needs the package name to look up: --package <name> (e.g. --package io.example.app)` : `--check needs the bundle identifier to look up: --bundle-id <id> (e.g. --bundle-id io.example.app)`
+    );
+  }
+  try {
+    const result = await deps.checkStorePreflight({
+      platform,
+      identifier,
+      ...ascKey2 !== void 0 ? { ascKey: ascKey2 } : {}
+    });
+    emit(opts.json, { event: "preflight", ...result });
+    if (!opts.json) {
+      const mark = result.ready ? chalk12.green("\u2713") : chalk12.red("\u2717");
+      console.error(`${mark} ${result.message}`);
+      if (result.ready) {
+        console.error(
+          chalk12.dim(
+            `  next: vibeview build --cloud --production --platform ${platform}, then vibeview submit --platform ${platform} --latest`
+          )
+        );
+      }
+    }
+    process.exitCode = result.ready ? 0 : 1;
+  } catch (err) {
+    printError2(opts, err);
+    process.exitCode = 1;
+  }
+}
 async function resolveLatestBuild(platform, deps) {
   const { builds: builds2 } = await deps.listCloudBuilds({
     platform,
@@ -3025,7 +3076,7 @@ function resolveMetadata(opts) {
 }
 var program = new Command();
 program.name("vibeview").description("VibeView CLI -- run mobile tests from CI/CD pipelines").version(pkg.version);
-program.command("run-suite <suite-id>").description("Run all test cases in a suite").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-case breakdown", false).option("--timeout <seconds>", "Max wait time in seconds", "300").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+program.command("run-suite <suite-id>").description("Run all test cases in a suite").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-case breakdown", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: phone when --device is not set)",
   parseDeviceCategory
@@ -3053,7 +3104,7 @@ program.command("run-suites").description("Run all suites matching a tag filter"
 ).option("--match <mode>", "any (default) or all", "any").option(
   "--platform <platform>",
   "Filter matched suites to one platform: ios, android, tvos, androidtv (default: no filter)"
-).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-suite progress", false).option("--timeout <seconds>", "Per-suite timeout, capped at 2 hours total", "300").option("--commit-sha <sha>", "Git commit SHA propagated to every SuiteRun").option("--model <model>", "AI model").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-suite progress", false).option("--timeout <seconds>", "Per-suite timeout, capped at 2 hours total", "1800").option("--commit-sha <sha>", "Git commit SHA propagated to every SuiteRun").option("--model <model>", "AI model").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: phone when --device is not set)",
   parseDeviceCategory
@@ -3073,7 +3124,7 @@ program.command("run-suites").description("Run all suites matching a tag filter"
     build: opts.build ? parseInt(opts.build, 10) : void 0
   });
 });
-program.command("run-test <test-id>").description("Run a single test case").option("--token <token>", "API token").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show step details", false).option("--timeout <seconds>", "Max wait time in seconds", "300").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
+program.command("run-test <test-id>").description("Run a single test case").option("--token <token>", "API token").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show step details", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
   "Device category: phone, tablet, tv (default: phone when --device is not set)",
   parseDeviceCategory
@@ -3163,7 +3214,11 @@ program.command("submit").description(
 ).option(
   "--rollout <fraction>",
   "android/androidtv only: staged-rollout fraction, 0 < f < 1 (requires --release-status inProgress)"
-).option("--no-wait", "Print the submission id and exit without waiting for completion").option("--json", "Emit line-delimited JSON events on stdout instead of human output", false).action((opts) => submitCommand(opts));
+).option(
+  "--check",
+  "Only check store readiness: does the store know this app with your stored key? Takes --platform plus --bundle-id (ios/tvos) or --package (android/androidtv); no build needed. Exit 0 when ready",
+  false
+).option("--bundle-id <id>", "ios/tvos, with --check: the bundle identifier to look up").option("--no-wait", "Print the submission id and exit without waiting for completion").option("--json", "Emit line-delimited JSON events on stdout instead of human output", false).action((opts) => submitCommand(opts));
 var builds = program.command("builds").description("Manage cloud builds (see `vibeview build --cloud`)");
 builds.command("list").description("List cloud builds in your organization").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--json", "Print the raw build summaries as a JSON array", false).option("--limit <n>", "Max builds to return (default 50, max 200)").action((opts) => buildsList(opts));
 builds.command("logs <id>").description("Print a cloud build's log output").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--json", "Print NDJSON log/outcome events instead of raw text", false).option("--follow", "Keep polling until the build reaches a terminal status", false).action((id, opts) => buildsLogs(id, opts));
@@ -3255,7 +3310,7 @@ program.command("dev-stop").description("Stop a `vibeview dev --detach` session
 program.command("mcp").description(
   "Run an MCP stdio server exposing the agent verbs (tap, swipe, type, ...) plus dev_start/dev_stop as tools"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").action(async (opts) => {
-  const { runMcpServer } = await import("./server-UN5JRYGY.js");
+  const { runMcpServer } = await import("./server-WWNWYD4Q.js");
   await runMcpServer(opts);
 });
 program.command("agent-setup").description(

package/dist/{server-UN5JRYGY.js → server-WWNWYD4Q.js}

@@ -11,11 +11,11 @@ import {
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-QZNZPKHV.js";
+} from "./chunk-VVKF7GGL.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-MCCXPIGE.js";
+} from "./chunk-KON2FOEC.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -239,7 +239,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-HUMMA6UY.js");
+    const { uploadAppBuild } = await import("./upload-app-W6NOSJPA.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });

package/dist/{upload-app-HUMMA6UY.js → upload-app-W6NOSJPA.js}

@@ -2,7 +2,7 @@
 import {
   uploadApp,
   uploadAppBuild
-} from "./chunk-MCCXPIGE.js";
+} from "./chunk-KON2FOEC.js";
 export {
   uploadApp,
   uploadAppBuild

package/package.json

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

package/skills/vibeview-agent/SKILL.md

@@ -5,8 +5,8 @@ description: Verify a React Native change on a real running app — install/laun
 
 # VibeView agent control
 
-Drive a live iOS/Android VibeView session from the CLI to verify a React
-Native change actually works, not just that it compiles. Requires the
+Drive a live iOS, Android, Apple TV or Android TV VibeView session from the
+CLI to verify a React Native change actually works, not just that it compiles. Requires the
 `vibeview` CLI installed and authenticated (`vibeview login`, or
 `VIBEVIEW_API_TOKEN` set).
 
@@ -137,13 +137,15 @@ it rather than letting it appear unexplained in their `git status`.
   ```
   Use `--press-ms 500` or more for long-press-to-reorder lists, and
   `--velocity 150` for slow, precise slider adjustments.
-- **iOS system alerts** (permission prompts and similar) sit above the app
+- **System alerts** (permission prompts and similar) sit above the app
   and block it. Call `alert get` first to read the message and the exact
   button labels, then act on one:
   ```bash
   vibeview alert get --session <id>
   vibeview alert accept --button "Allow" --session <id>
   ```
+  On Apple TV this also covers the "Open in …?" prompt a deep link raises;
+  the button is answered with the remote.
 - Use `open-url` to jump straight to a deep link instead of navigating by
   hand:
   ```bash
@@ -200,7 +202,7 @@ human-readable text.
 | `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 visible iOS system alert. |
+| `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. |
 | `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). |