vibeview 0.23.0 → 0.25.0

package/dist/{server-XMSBLIWY.js → server-6EUBLXKE.js}

@@ -5,22 +5,26 @@ import {
   PLATFORM_DEVICE,
   PLATFORM_NEEDS_METRO,
   ROKU_LIVENESS_INTERVAL_MS,
+  buildRows,
   buildToolCall,
+  checkDevBuild,
   checkMetro,
   createRokuPush,
   decodeScreenshotResult,
   filterDeviceModels,
+  formatBuildRowsHuman,
   formatDeviceModelsHuman,
   isDevPlatform,
   loadDevConfig,
+  parseBuildId,
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-E2LZSLRF.js";
+} from "./chunk-GEKYHEWU.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-PSFXVUHG.js";
+} from "./chunk-RFFCCPGZ.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -84,10 +88,32 @@ 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).'
+    },
+    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.',
@@ -138,7 +164,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 +194,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 +279,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 +316,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 +376,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-ZAKAOJKE.js");
+    const { uploadAppBuild } = await import("./upload-app-E32EZXYQ.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -319,11 +394,17 @@ async function handleUploadApp(args, deps) {
     package_name: result.package_name,
     platform: result.platform,
     is_new: isNew,
+    build_id: result.build_id ?? null,
+    version: result.version ?? null,
+    build_number: result.build_number ?? null,
     warnings
   };
   const lines = [
     `${isNew ? "New app created" : "Build added to existing app"}: ${result.name}`,
     `app_id: ${result.public_id}  [${result.platform}]  ${result.package_name}`,
+    ...result.build_id != null ? [
+      `build_id: ${result.build_id}${result.version ? `  version ${result.version}${result.build_number ? ` (${result.build_number})` : ""}` : ""}`
+    ] : [],
     ...warnings.map((w) => `warning: ${w}`)
   ];
   return textResult(lines.join("\n"), payload);
@@ -375,6 +456,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({
@@ -386,6 +474,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
       });

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

@@ -1,9 +1,11 @@
 #!/usr/bin/env node
 import {
+  describeBuild,
   uploadApp,
   uploadAppBuild
-} from "./chunk-PSFXVUHG.js";
+} from "./chunk-RFFCCPGZ.js";
 export {
+  describeBuild,
   uploadApp,
   uploadAppBuild
 };

package/package.json

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

package/skills/vibeview-agent/SKILL.md

@@ -214,6 +214,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
 
@@ -250,9 +255,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 +279,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`