vibeview 0.21.0 → 0.23.0

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

@@ -1,21 +1,26 @@
 #!/usr/bin/env node
 import {
   AGENT_COMMANDS,
+  DEV_PLATFORMS,
   PLATFORM_DEVICE,
   PLATFORM_NEEDS_METRO,
+  ROKU_LIVENESS_INTERVAL_MS,
   buildToolCall,
   checkMetro,
+  createRokuPush,
   decodeScreenshotResult,
+  filterDeviceModels,
+  formatDeviceModelsHuman,
   isDevPlatform,
   loadDevConfig,
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-VVKF7GGL.js";
+} from "./chunk-E2LZSLRF.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-KON2FOEC.js";
+} from "./chunk-PSFXVUHG.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -26,7 +31,7 @@ var SESSION_ID_PROPERTY = {
   type: "string",
   description: "Session ID to target. Optional: falls back to the MCP-server-held dev_start session, then this project's `vibeview dev --detach` state, if either is available."
 };
-var MCP_DEV_PLATFORMS = ["ios", "android", "tvos", "androidtv"];
+var MCP_DEV_PLATFORMS = DEV_PLATFORMS;
 function isMcpDevPlatform(p) {
   return isDevPlatform(p) && MCP_DEV_PLATFORMS.includes(p);
 }
@@ -75,10 +80,27 @@ var DEV_START_DEF = {
     metro_port: {
       type: "number",
       description: "Local Metro port (default: 8081, or vibeview.json)."
+    },
+    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).'
     }
   },
   required: ["platform"]
 };
+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.',
+  mutating: false,
+  properties: {
+    device_type: {
+      type: "string",
+      description: "Only models of this device type.",
+      enum: ["ios", "android", "roku"]
+    }
+  },
+  required: []
+};
 var DEV_STOP_DEF = {
   name: "dev_stop",
   description: "Stop the dev-loop session started by dev_start.",
@@ -86,9 +108,16 @@ var DEV_STOP_DEF = {
   properties: { session_id: SESSION_ID_PROPERTY },
   required: []
 };
+var DEV_RELOAD_DEF = {
+  name: "dev_reload",
+  description: "Roku only: re-package the channel with the build command from vibeview.json (platforms.roku.build), upload it, and reload it into the session dev_start is holding (or, with no held session, this project's `vibeview dev --detach` session) \u2014 the MCP equivalent of pressing `r` in `vibeview dev`. Returns once the device restarts the channel (a few seconds); call ui_tree afterwards. Other platforms hot-reload through Metro and need no call.",
+  mutating: true,
+  properties: { session_id: SESSION_ID_PROPERTY },
+  required: []
+};
 var UPLOAD_APP_DEF = {
   name: "upload_app",
-  description: "Upload an app build (zipped simulator .app for iOS, .apk for Android) and return its app_id for dev_start. The MCP equivalent of `vibeview upload-app`.",
+  description: "Upload an app build (zipped simulator .app for iOS/tvOS, .apk for Android/Android TV, or a Roku channel .zip) and return its app_id for dev_start. The MCP equivalent of `vibeview upload-app`.",
   mutating: true,
   properties: {
     file: {
@@ -103,7 +132,14 @@ var UPLOAD_APP_DEF = {
   required: ["file"]
 };
 function buildToolDefinitions() {
-  return [...AGENT_COMMANDS.map(toolDefFromCommand), DEV_START_DEF, DEV_STOP_DEF, UPLOAD_APP_DEF];
+  return [
+    ...AGENT_COMMANDS.map(toolDefFromCommand),
+    DEV_START_DEF,
+    DEV_STOP_DEF,
+    DEV_RELOAD_DEF,
+    UPLOAD_APP_DEF,
+    LIST_DEVICE_MODELS_DEF
+  ];
 }
 function textResult(text, structuredContent, isError = false) {
   return { content: [{ type: "text", text }], structuredContent, isError };
@@ -121,9 +157,15 @@ async function handleToolCall(toolName, args, deps) {
   if (toolName === "dev_stop") {
     return handleDevStop(deps);
   }
+  if (toolName === "dev_reload") {
+    return handleDevReload(args, deps);
+  }
   if (toolName === "upload_app") {
     return handleUploadApp(args, deps);
   }
+  if (toolName === "list_device_models") {
+    return handleListDeviceModels(args, deps);
+  }
   const cmd = findCommand(toolName);
   if (!cmd) {
     return errorResult(`Unknown tool: ${toolName}`);
@@ -198,11 +240,6 @@ function optsFor(cmd, args) {
 }
 async function handleDevStart(args, deps) {
   const platform = args.platform;
-  if (platform === "roku") {
-    return errorResult(
-      "dev_start does not support roku \u2014 the reload loop needs a foreground terminal; run `vibeview dev --platform roku` instead"
-    );
-  }
   if (!isMcpDevPlatform(platform)) {
     return errorResult(
       `dev_start: platform must be one of ${MCP_DEV_PLATFORMS.join(", ")}, got "${String(platform)}"`
@@ -212,7 +249,8 @@ async function handleDevStart(args, deps) {
     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
+      metroPort: typeof args.metro_port === "number" ? args.metro_port : void 0,
+      model: typeof args.model === "string" && args.model.trim() ? args.model : void 0
     });
     const payload = { session_id: result.sessionId, page_url: result.pageUrl };
     return textResult(`dev session started: ${payload.session_id}
@@ -221,6 +259,30 @@ ${payload.page_url}`, payload);
     return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
   }
 }
+async function handleListDeviceModels(args, deps) {
+  const list = deps.listDeviceModels ?? (() => new ApiClient(deps.auth.baseUrl, deps.auth.token).listDeviceModels());
+  let models;
+  try {
+    models = filterDeviceModels(await list(), {
+      type: typeof args.device_type === "string" ? args.device_type : void 0
+    });
+  } catch (err) {
+    return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  return textResult(formatDeviceModelsHuman(models).trimEnd(), { models });
+}
+async function handleDevReload(args, deps) {
+  const requested = typeof args.session_id === "string" ? args.session_id : void 0;
+  try {
+    const { sessionId, seconds } = await deps.devSession.reload(requested);
+    return textResult(`channel reloaded in ${seconds.toFixed(1)}s`, {
+      session_id: sessionId,
+      seconds
+    });
+  } catch (err) {
+    return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
+  }
+}
 async function handleDevStop(deps) {
   const current = deps.devSession.current();
   try {
@@ -239,7 +301,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-W6NOSJPA.js");
+    const { uploadAppBuild } = await import("./upload-app-ZAKAOJKE.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -268,6 +330,22 @@ async function handleUploadApp(args, deps) {
 }
 function createDevSessionController(auth, webUrl) {
   let handle = null;
+  let platform = null;
+  let presence = null;
+  let reloading = null;
+  const stopPresence = () => {
+    if (presence) clearInterval(presence);
+    presence = null;
+  };
+  const readRokuBuild = () => {
+    try {
+      return loadDevConfig(process.cwd())?.platforms?.roku?.build ?? null;
+    } catch (err) {
+      throw new Error(
+        `vibeview.json could not be read: ${err instanceof Error ? err.message : String(err)}`
+      );
+    }
+  };
   return {
     async start(cfg) {
       if (handle) {
@@ -298,6 +376,7 @@ function createDevSessionController(auth, webUrl) {
         }
       }
       const isTv = PLATFORM_DEVICE[cfg.platform].tv;
+      platform = cfg.platform;
       handle = await startDevSession({
         token: auth.token,
         baseUrl: auth.baseUrl,
@@ -305,19 +384,92 @@ function createDevSessionController(auth, webUrl) {
         platform: cfg.platform,
         appId,
         deviceCategory: isTv ? "tv" : entry?.deviceCategory ?? "phone",
+        // A named model decides the category itself (startDevSession).
+        model: cfg.model,
         metroPort,
         open: false
       });
+      if (cfg.platform === "roku") {
+        const api = new ApiClient(auth.baseUrl, auth.token);
+        const sessionId = handle.sessionId;
+        presence = setInterval(() => {
+          api.touchSession(sessionId).catch(() => {
+          });
+        }, ROKU_LIVENESS_INTERVAL_MS);
+        presence.unref?.();
+      }
       return handle;
     },
     async stop() {
+      stopPresence();
       await handle?.stop();
       handle = null;
+      platform = null;
     },
     current() {
       return handle ? { sessionId: handle.sessionId, pageUrl: handle.pageUrl } : null;
+    },
+    async reload(requested) {
+      if (reloading) {
+        throw new Error(
+          "a reload is already in progress \u2014 wait for it to finish, then call dev_reload again"
+        );
+      }
+      reloading = reloadOnce(requested).finally(() => {
+        reloading = null;
+      });
+      return reloading;
     }
   };
+  async function reloadOnce(requested) {
+    {
+      let target;
+      if (handle) {
+        if (requested && requested !== handle.sessionId) {
+          throw new Error(
+            `dev_reload can only reload the session this server holds (${handle.sessionId}); got session_id "${requested}". Call dev_stop first, or omit session_id.`
+          );
+        }
+        target = {
+          sessionId: handle.sessionId,
+          platform: platform ?? "",
+          build: platform === "roku" ? readRokuBuild() : null
+        };
+      } else {
+        const state = readDevState(process.cwd());
+        if (!state || requested && requested !== state.session_id) {
+          throw new Error(
+            requested ? `session "${requested}" is neither held by dev_start nor this project's \`vibeview dev --detach\` session \u2014 dev_reload needs one of those two` : 'no dev session to reload \u2014 call dev_start with platform "roku" first'
+          );
+        }
+        target = { sessionId: state.session_id, platform: state.platform, build: readRokuBuild() };
+      }
+      if (target.platform !== "roku") {
+        throw new Error(
+          `dev_reload is for Roku channels; a ${target.platform} session hot-reloads through Metro on its own`
+        );
+      }
+      if (!target.build) {
+        throw new Error(
+          "no build config for roku \u2014 add platforms.roku.build ({ command, artifact }) to vibeview.json, or run `vibeview build --platform roku` once to set it up"
+        );
+      }
+      const started = Date.now();
+      const push = createRokuPush({
+        cwd: process.cwd(),
+        sessionId: target.sessionId,
+        build: target.build,
+        token: auth.token,
+        baseUrl: auth.baseUrl,
+        api: new ApiClient(auth.baseUrl, auth.token),
+        // Build output has no stdout to go to over MCP (stdout IS the
+        // protocol); stderr is the server's log.
+        log: (line) => console.error(line)
+      });
+      await push();
+      return { sessionId: target.sessionId, seconds: (Date.now() - started) / 1e3 };
+    }
+  }
 }
 function makeSessionResolver(devSession) {
   return () => devSession.current()?.sessionId ?? readDevState(process.cwd())?.session_id;
@@ -373,6 +525,7 @@ async function runMcpServer(opts) {
 }
 export {
   buildToolDefinitions,
+  createDevSessionController,
   handleToolCall,
   runMcpServer
 };

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

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

package/package.json

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

package/skills/vibeview-agent/SKILL.md

@@ -156,6 +156,37 @@ 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:
+  ```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)
+  ```
+  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
+  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
+  rotate.
+- **Roku channels (beta)**: start the session with
+  `vibeview dev --platform roku --detach` (or `dev_start` with platform
+  `roku` over MCP); after an edit run `vibeview dev-reload` (MCP:
+  `dev_reload`) to re-package, upload and restart the channel in the same
+  session — about five seconds. The remote's names are `press up/down/left/right/select/back`
+  (`dpad_*` also works); `home` is not forwarded. `type` lands in a focused
+  on-screen keyboard; the typed text shows up in the tree as the text box's
+  child label, which is what the response verifies against. `logs` returns
+  the channel's console output (its `print` lines, why it exited, and the
+  error plus backtrace after a runtime error); `open-url` is unavailable. A
+  Back on the channel's root
+  screen exits it; the session relaunches it within seconds, so a fresh
+  first screen after `press back` is not a crash.
 
 ## 4. When only a human can act — stop and hand off
 
@@ -207,6 +238,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. |
 | `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. |
@@ -216,9 +249,11 @@ 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. |
+| `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. |
+| `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. |
+| `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
 
@@ -230,13 +265,14 @@ hyphens replaced by underscores (`ui_tree`, `tap`, `scroll_to`, `long_press`,
 `drag {from: "@e5", to: "300,400"}`, `alert {action: "get"}`) plus an
 optional `session_id`.
 
-Three tools exist **only** over MCP, with no registry verb — they cover the
+These tools exist **only** over MCP, with no registry verb — they cover the
 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`), `app`, `metro_port` | Start a dev-loop session held open by the MCP server. The MCP equivalent of `vibeview dev --detach`. 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` | 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. |
+| `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`. |
 | `dev_stop` | — | Stop the session `dev_start` started. The MCP equivalent of `vibeview dev-stop`. |
 
 **`dev_start` is stateful — it changes the default session for every later