vibeview 0.20.4 → 0.22.0

package/dist/{server-WOIB6CDQ.js → server-6IJ44HAX.js}

@@ -1,21 +1,24 @@
 #!/usr/bin/env node
 import {
   AGENT_COMMANDS,
+  DEV_PLATFORMS,
   PLATFORM_DEVICE,
   PLATFORM_NEEDS_METRO,
+  ROKU_LIVENESS_INTERVAL_MS,
   buildToolCall,
   checkMetro,
+  createRokuPush,
   decodeScreenshotResult,
   isDevPlatform,
   loadDevConfig,
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-BBGXBKJQ.js";
+} from "./chunk-SHS5PCSS.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-KON2FOEC.js";
+} from "./chunk-UGCGJ6IN.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -26,7 +29,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);
 }
@@ -86,9 +89,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 +113,13 @@ 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
+  ];
 }
 function textResult(text, structuredContent, isError = false) {
   return { content: [{ type: "text", text }], structuredContent, isError };
@@ -121,6 +137,9 @@ 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);
   }
@@ -198,11 +217,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)}"`
@@ -221,6 +235,18 @@ ${payload.page_url}`, payload);
     return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
   }
 }
+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 +265,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-LJH3PETS.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -268,6 +294,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 +340,7 @@ function createDevSessionController(auth, webUrl) {
         }
       }
       const isTv = PLATFORM_DEVICE[cfg.platform].tv;
+      platform = cfg.platform;
       handle = await startDevSession({
         token: auth.token,
         baseUrl: auth.baseUrl,
@@ -308,16 +351,87 @@ function createDevSessionController(auth, webUrl) {
         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 +487,7 @@ async function runMcpServer(opts) {
 }
 export {
   buildToolDefinitions,
+  createDevSessionController,
   handleToolCall,
   runMcpServer
 };

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.20.4",
+  "version": "0.22.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
@@ -154,6 +156,19 @@ 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).
+- **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
 
@@ -200,7 +215,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). |
@@ -217,6 +232,7 @@ Dev-loop lifecycle commands (not registry verbs, but needed for every run):
 | `dev --detach --json` | Start a device + Metro-tunnel session in the background, emitting `session_ready`/`warning`/`error` JSON events on stdout. |
 | `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