vibeview 0.24.0 → 0.26.0

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

@@ -5,22 +5,27 @@ import {
   PLATFORM_DEVICE,
   PLATFORM_NEEDS_METRO,
   ROKU_LIVENESS_INTERVAL_MS,
+  buildRows,
   buildToolCall,
+  checkDevBuild,
   checkMetro,
   createRokuPush,
   decodeScreenshotResult,
   filterDeviceModels,
+  formatBuildRowsHuman,
   formatDeviceModelsHuman,
   isDevPlatform,
   loadDevConfig,
+  parseBuildId,
+  platformWithArticle,
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-MVNMGB6I.js";
+} from "./chunk-JK3T3AMW.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-2WNJYNDW.js";
+} from "./chunk-RFFCCPGZ.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -83,14 +88,36 @@ var DEV_START_DEF = {
     },
     model: {
       type: "string",
-      description: 'Run on this exact device model, e.g. "iPhone Duo" for the foldable. Names come from list_device_models. Omit for a default phone (or TV on TV platforms).'
+      description: 'Run on this exact device model, e.g. "iPhone Duo" or "Pixel 9 Pro Fold" for a foldable (any model list_device_models marks form_factor "foldable"). Names come from list_device_models. Omit for a default phone (or TV on TV platforms).'
+    },
+    build_id: {
+      type: "number",
+      description: 'Run this uploaded build of the app instead of its newest debug build. Must be a debug build (kind "debug" in list_builds) for the platform \u2014 a release build or one with an embedded JS bundle is refused. Not for roku.'
     }
   },
   required: ["platform"]
 };
+var LIST_BUILDS_DEF = {
+  name: "list_builds",
+  description: "List an app's uploaded builds, newest first: id, version, build number, platform, kind (debug/release/unknown), upload time and note. Pass a debug build's id to dev_start as build_id.",
+  mutating: false,
+  properties: {
+    app: { type: "string", description: "App id (public_id, from upload_app or list-apps)." }
+  },
+  required: ["app"]
+};
+var STOP_SESSION_DEF = {
+  name: "stop_session",
+  description: "Stop any session by id \u2014 e.g. one created through the API, the sandbox, or a collaboration link. For the session dev_start started, dev_stop does the same without an id.",
+  mutating: true,
+  properties: {
+    session_id: { type: "string", description: "The session to stop." }
+  },
+  required: ["session_id"]
+};
 var LIST_DEVICE_MODELS_DEF = {
   name: "list_device_models",
-  description: 'List the device models you can start right now (model, OS version, platform, category, and form_factor "foldable" for a device that folds, like the iPhone Duo). Pass a model name to dev_start to run on it.',
+  description: 'List the device models you can start right now (model, OS version, platform, category, and form_factor "foldable" for any device with a hinge \u2014 the iPhone Duo, Android foldables such as the Pixel 9 Pro Fold). Pass a model name to dev_start to run on it.',
   mutating: false,
   properties: {
     device_type: {
@@ -138,7 +165,9 @@ function buildToolDefinitions() {
     DEV_STOP_DEF,
     DEV_RELOAD_DEF,
     UPLOAD_APP_DEF,
-    LIST_DEVICE_MODELS_DEF
+    LIST_DEVICE_MODELS_DEF,
+    LIST_BUILDS_DEF,
+    STOP_SESSION_DEF
   ];
 }
 function textResult(text, structuredContent, isError = false) {
@@ -166,6 +195,12 @@ async function handleToolCall(toolName, args, deps) {
   if (toolName === "list_device_models") {
     return handleListDeviceModels(args, deps);
   }
+  if (toolName === "list_builds") {
+    return handleListBuilds(args, deps);
+  }
+  if (toolName === "stop_session") {
+    return handleStopSession(args, deps);
+  }
   const cmd = findCommand(toolName);
   if (!cmd) {
     return errorResult(`Unknown tool: ${toolName}`);
@@ -245,12 +280,23 @@ async function handleDevStart(args, deps) {
       `dev_start: platform must be one of ${MCP_DEV_PLATFORMS.join(", ")}, got "${String(platform)}"`
     );
   }
+  let buildId;
+  if (args.build_id !== void 0 && args.build_id !== null) {
+    try {
+      buildId = parseBuildId(args.build_id);
+    } catch {
+      return errorResult(
+        `dev_start: build_id must be a positive build id (see list_builds), got "${String(args.build_id)}"`
+      );
+    }
+  }
   try {
     const result = await deps.devSession.start({
       platform,
       app: typeof args.app === "string" ? args.app : void 0,
       metroPort: typeof args.metro_port === "number" ? args.metro_port : void 0,
-      model: typeof args.model === "string" && args.model.trim() ? args.model : void 0
+      model: typeof args.model === "string" && args.model.trim() ? args.model : void 0,
+      ...buildId !== void 0 ? { buildId } : {}
     });
     const payload = { session_id: result.sessionId, page_url: result.pageUrl };
     return textResult(`dev session started: ${payload.session_id}
@@ -271,6 +317,36 @@ async function handleListDeviceModels(args, deps) {
   }
   return textResult(formatDeviceModelsHuman(models).trimEnd(), { models });
 }
+async function handleListBuilds(args, deps) {
+  const appId = typeof args.app === "string" ? args.app.trim() : "";
+  if (!appId) return errorResult("list_builds: `app` is required \u2014 an app id from list-apps");
+  const getApp = deps.getApp ?? ((id) => new ApiClient(deps.auth.baseUrl, deps.auth.token).getApp(id));
+  try {
+    const app = await getApp(appId);
+    const builds = buildRows(app);
+    return textResult(formatBuildRowsHuman(app, builds).trimEnd(), {
+      app_id: app.public_id,
+      builds
+    });
+  } catch (err) {
+    return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
+async function handleStopSession(args, deps) {
+  const sessionId = typeof args.session_id === "string" ? args.session_id.trim() : "";
+  if (!sessionId) return errorResult("stop_session: `session_id` is required");
+  const stop = deps.stopSession ?? ((id) => new ApiClient(deps.auth.baseUrl, deps.auth.token).stopSession(id));
+  try {
+    if (deps.devSession.current()?.sessionId === sessionId) {
+      await deps.devSession.stop();
+    } else {
+      await stop(sessionId);
+    }
+  } catch (err) {
+    return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  return textResult(`session stopped: ${sessionId}`, { session_id: sessionId, stopped: true });
+}
 async function handleDevReload(args, deps) {
   const requested = typeof args.session_id === "string" ? args.session_id : void 0;
   try {
@@ -301,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-BXXKH65S.js");
+    const { uploadAppBuild } = await import("./upload-app-E32EZXYQ.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -381,6 +457,13 @@ function createDevSessionController(auth, webUrl) {
           );
         }
       }
+      if (cfg.buildId !== void 0) {
+        checkDevBuild(
+          await new ApiClient(auth.baseUrl, auth.token).getApp(appId),
+          cfg.buildId,
+          cfg.platform
+        );
+      }
       const isTv = PLATFORM_DEVICE[cfg.platform].tv;
       platform = cfg.platform;
       handle = await startDevSession({
@@ -392,6 +475,7 @@ function createDevSessionController(auth, webUrl) {
         deviceCategory: isTv ? "tv" : entry?.deviceCategory ?? "phone",
         // A named model decides the category itself (startDevSession).
         model: cfg.model,
+        buildId: cfg.buildId,
         metroPort,
         open: false
       });
@@ -452,7 +536,7 @@ function createDevSessionController(auth, webUrl) {
       }
       if (target.platform !== "roku") {
         throw new Error(
-          `dev_reload is for Roku channels; a ${target.platform} session hot-reloads through Metro on its own`
+          `dev_reload is for Roku channels; ${platformWithArticle(target.platform)} session hot-reloads through Metro on its own`
         );
       }
       if (!target.build) {

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

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

package/package.json

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

package/skills/vibeview-agent/SKILL.md

@@ -38,10 +38,17 @@ https://vibeview.io/docs/preparing-your-build.
    ```
 2. Start Metro in the React Native project (`yarn start` or equivalent) and
    leave it running.
-3. Start a dev session in the background and get structured output:
+3. Start a dev session in the background and get structured output. No
+   `vibeview.json` yet in this project (first run here)? Pass `--platform`
+   and `--app` explicitly — non-interactive runs never prompt, so both must
+   be given up front (`--app` is `app_id` from step 1's upload output):
    ```bash
-   vibeview dev --detach --json
+   vibeview dev --platform ios --app <app_id> --detach --json
    ```
+   Once `vibeview.json` exists (this run or an earlier one), a bare
+   `vibeview dev --detach --json` reruns the same platform/app. A
+   `{"event":"error","code":"config_required",...}` line names exactly what's
+   still missing (usually `--platform` or `--app`) — pass it and retry.
 4. Parse the `session_ready` line from stdout:
    ```json
    {"event":"session_ready","session_id":"...","url":"...","pid":1234}
@@ -156,20 +163,29 @@ it rather than letting it appear unexplained in their `git status`.
   (`dpad_up`/`dpad_down`/`dpad_left`/`dpad_right`/`dpad_center`), or move
   focus directly with `tap-focused` (moves focus AND activates) / `focus`
   (moves focus only, no activation).
-- **Foldable (iPhone Duo)**: start on it by model name —
-  `vibeview dev --detach --json --model "iPhone Duo"` (MCP: `dev_start` with
-  `model`). Exact names come from `vibeview list-devices --models` (MCP:
-  `list_device_models`); a foldable is marked `foldable`. It starts closed, on
-  the cover screen. Fold with a preset or an exact hinge angle, and rotate:
+- **Foldables**: any model `vibeview list-devices --models` (MCP:
+  `list_device_models`) marks form factor `foldable` — the iPhone Duo,
+  Android foldables such as the Pixel 9 Pro Fold. Start on one by its exact
+  model name from that list, e.g.
+  `vibeview dev --detach --json --model "iPhone Duo"` or
+  `vibeview dev --platform android --detach --json --model "Pixel 9 Pro Fold"`
+  (MCP: `dev_start` with `model`). It starts closed, on the cover screen. Fold with a preset
+  or an exact hinge angle, and rotate:
   ```bash
   vibeview set-posture open --session <id>        # closed | partial | open
   vibeview set-posture --angle 75 --session <id>  # 0 (shut) to 180 (flat)
-  vibeview rotate --session <id>                  # quarter turn clockwise
-  vibeview rotate --degrees 270 --session <id>    # quarter turn back (180: half)
+  vibeview rotate --session <id>                  # Duo: quarter turn clockwise
+  vibeview rotate --degrees 270 --session <id>    # Duo: quarter turn back (180: half)
   ```
   Each response says where the device ended up — posture, angle and which
-  screen is lit (`cover` or `inner`; the device decides — a small angle can
-  keep the inner screen lit on the way down), or the new orientation. Folding
+  screen is lit (`cover` or `inner`; the device decides — on the Duo a small
+  angle can keep the inner screen lit on the way down), or the new
+  orientation. The posture names come from each device's own angle ranges,
+  so trust the reported `posture` over the angle you asked for: the Duo
+  reads 120-169 as `partial`, 170 up as `open`, and 1-119 by direction of
+  travel; an Android foldable uses its own ranges (the Pixel 9 Pro Fold: below
+  30 `closed`, 30-149 `partial`, 150 up `open`) and its inner screen whenever
+  it is not closed. An Android foldable rotates like a phone. Folding
   switches screens of different sizes and rotating turns the picture, so run
   `ui-tree` afterwards — old refs are stale. On other phones and tablets
   `rotate` toggles portrait/landscape (only 90 is accepted); TV devices don't
@@ -214,6 +230,11 @@ streaming minutes even when idle:
 ```bash
 vibeview dev-stop
 ```
+A session you did not start with `dev` (one created through the API, the
+sandbox, or a collaboration link) is stopped by id:
+```bash
+vibeview stop <session-id>
+```
 
 ## 6. Command reference
 
@@ -238,8 +259,8 @@ human-readable text.
 | `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. |
-| `set-posture` | `<closed\|partial\|open>` or `--angle <0-180>` | Fold or unfold a foldable device (iPhone Duo) 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 toggle portrait/landscape (90 only); a foldable turns a quarter clockwise by default. Not on TV. |
+| `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). |
 | `find` | `<text>` `[--below <text>] [--above <text>] [--near <text>]` | Find an element by text with optional spatial constraints. |
 | `tap-focused` | `<ref>` | TV: move focus to an element and press SELECT in one step. |
@@ -250,9 +271,12 @@ Dev-loop lifecycle commands (not registry verbs, but needed for every run):
 | Command | Purpose |
 |---------|---------|
 | `dev --detach --json` | Start a device + Metro-tunnel session in the background, emitting `session_ready`/`warning`/`error` JSON events on stdout. Add `--model "<name>"` to pick an exact device model. |
+| `dev --build <id>` | Run that uploaded build instead of the app's newest debug build (combine with `--app`, `--platform`, `--model`, `--detach --json`). Only a debug build (kind `debug` in `list-builds`) is accepted; a release build or one with an embedded JS bundle is refused. Not on Roku. |
+| `list-builds <app>` | List an app's uploaded builds, newest first: id, version (build number), platform, kind (`debug`/`release`/`unknown`), upload time, note. `--json` prints an array. |
 | `list-devices --models` | List the device models you can start (the names `--model` takes); foldables are marked `foldable`. |
 | `dev-status` | Check on the current project's detached dev session. |
 | `dev-stop` | End the current project's detached dev session. |
+| `vibeview stop <session-id>` | End any session by id — one created through the API, the sandbox, or a collaboration link. |
 | `dev-reload` | Roku only: re-package, upload and restart the channel in the detached session (the `r` key of the foreground loop). |
 
 ## 7. If you're calling VibeView over MCP
@@ -271,9 +295,11 @@ steps the CLI does with plain shell commands:
 | MCP tool | Args | Purpose |
 |----------|------|---------|
 | `upload_app` | `file` (required path), `name` | Upload a debug build. The MCP equivalent of `vibeview upload-app`, so step 1 of the loop needs no shell. Returns the `app_id` to pass to `dev_start`. |
-| `dev_start` | `platform` (required: `ios`/`android`/`tvos`/`androidtv`/`roku`), `app`, `metro_port`, `model` | Start a dev-loop session held open by the MCP server. The MCP equivalent of `vibeview dev --detach`; `model` picks an exact device model (e.g. `"iPhone Duo"`). Returns `page_url` — relay it to the developer immediately, same as step 5 of the loop. |
+| `dev_start` | `platform` (required: `ios`/`android`/`tvos`/`androidtv`/`roku`), `app`, `metro_port`, `model`, `build_id` | Start a dev-loop session held open by the MCP server. The MCP equivalent of `vibeview dev --detach`; `model` picks an exact device model (e.g. `"iPhone Duo"`); `build_id` runs that debug build instead of the newest one (see `list_builds`). Returns `page_url` — relay it to the developer immediately, same as step 5 of the loop. |
 | `list_device_models` | `device_type` | List the device models you can start (model, OS, platform, category, `foldable` marker). The MCP equivalent of `vibeview list-devices --models`. |
+| `list_builds` | `app` (required) | List an app's uploaded builds with their kind (`debug`/`release`/`unknown`). The MCP equivalent of `vibeview list-builds`. |
 | `dev_stop` | — | Stop the session `dev_start` started. The MCP equivalent of `vibeview dev-stop`. |
+| `stop_session` | `session_id` (required) | Stop any session by id. The MCP equivalent of `vibeview stop <session-id>`. |
 
 **`dev_start` is stateful — it changes the default session for every later
 call.** Once it succeeds, any tool called without an explicit `session_id`