vibeview 0.27.0 → 0.28.0

package/dist/{server-XJREB7KU.js → server-6SRFOQ6B.js}

@@ -21,11 +21,12 @@ import {
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-46X7UN6Y.js";
+} from "./chunk-OKOAWGWV.js";
 import {
   ApiClient,
+  NotFoundError,
   resolveAuth
-} from "./chunk-U7FCGMWG.js";
+} from "./chunk-2JLTC67A.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -40,8 +41,14 @@ var MCP_DEV_PLATFORMS = DEV_PLATFORMS;
 function isMcpDevPlatform(p) {
   return isDevPlatform(p) && MCP_DEV_PLATFORMS.includes(p);
 }
-function paramToProperty(param) {
-  return { type: param.type, description: param.description };
+var MCP_PARAM_DESCRIPTIONS = {
+  wait: { seconds: "How long to wait, in seconds. Default: 2." }
+};
+function paramToProperty(cmd, param) {
+  return {
+    type: param.type,
+    description: MCP_PARAM_DESCRIPTIONS[cmd.verb]?.[param.name] ?? param.description
+  };
 }
 function toolNameFor(verb) {
   return verb.replace(/-/g, "_");
@@ -50,7 +57,7 @@ function toolDefFromCommand(cmd) {
   const properties = { session_id: SESSION_ID_PROPERTY };
   const required = [];
   for (const param of cmd.params) {
-    properties[param.name] = paramToProperty(param);
+    properties[param.name] = paramToProperty(cmd, param);
     if (param.required) required.push(param.name);
   }
   if (cmd.verb === "screenshot") {
@@ -69,7 +76,7 @@ function toolDefFromCommand(cmd) {
 }
 var DEV_START_DEF = {
   name: "dev_start",
-  description: "Start a VibeView dev-loop session (device + tunnel) held in-process by this MCP server, and use it as the default session for every other tool call until dev_stop. Returns once the session accepts commands (device up, app installed) \u2014 call ui_tree right away, no readiness polling needed.",
+  description: "Start a VibeView session held by this MCP server, and use it as the default session for every other tool call until dev_stop. By default it is a React Native dev loop: a debug build that loads its JS from your local Metro. Pass standalone: true to run any build as it is (a release, CI or cloud build) with no Metro. Returns once the session accepts commands (device up, app installed), with the device it got (model, OS, form factor, posture) \u2014 call ui_tree next.",
   mutating: true,
   properties: {
     session_id: SESSION_ID_PROPERTY,
@@ -80,11 +87,11 @@ var DEV_START_DEF = {
     },
     app: {
       type: "string",
-      description: "Uploaded debug build (app_id) to run. Defaults to vibeview.json config."
+      description: "App id to run (from list_apps or upload_app). Must be an app for the chosen platform. Defaults to vibeview.json config."
     },
     metro_port: {
       type: "number",
-      description: "Local Metro port (default: 8081, or vibeview.json)."
+      description: "Local Metro port (default: 8081, or vibeview.json). Ignored with standalone."
     },
     model: {
       type: "string",
@@ -92,7 +99,11 @@ var DEV_START_DEF = {
     },
     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.'
+      description: 'Run this uploaded build of the app (an id from list_builds). Without standalone it must be a debug build (kind "debug"); with standalone any build of the app works. Omitted: the newest debug build, or with standalone the newest release build. Not for roku.'
+    },
+    standalone: {
+      type: "boolean",
+      description: "Run the build as it is, with no Metro and no tunnel: for release builds, builds with an embedded JS bundle, CI and cloud builds. Code changes do not hot-reload. Default false."
     }
   },
   required: ["platform"]
@@ -102,7 +113,7 @@ var LIST_BUILDS_DEF = {
   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)." }
+    app: { type: "string", description: "App id (from list_apps or upload_app)." }
   },
   required: ["app"]
 };
@@ -117,7 +128,7 @@ var STOP_SESSION_DEF = {
 };
 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 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.',
+  description: 'List the device models you can start right now (model, OS version, platform, category, form_factor "foldable" for any device with a hinge \u2014 the iPhone Duo, Android foldables such as the Pixel 9 Pro Fold \u2014 and how many of each are free and busy). Pass a model name to dev_start to run on it; a model with none free queues until one is.',
   mutating: false,
   properties: {
     device_type: {
@@ -128,6 +139,19 @@ var LIST_DEVICE_MODELS_DEF = {
   },
   required: []
 };
+var LIST_APPS_DEF = {
+  name: "list_apps",
+  description: "List your organization's uploaded apps: app id, name, platform and bundle id / package name. Pass an app id to dev_start (app) or list_builds.",
+  mutating: false,
+  properties: {
+    platform: {
+      type: "string",
+      description: "Only apps for this platform.",
+      enum: [...DEV_PLATFORMS]
+    }
+  },
+  required: []
+};
 var DEV_STOP_DEF = {
   name: "dev_stop",
   description: "Stop the dev-loop session started by dev_start.",
@@ -149,7 +173,7 @@ var UPLOAD_APP_DEF = {
   properties: {
     file: {
       type: "string",
-      description: "Path to the build file on this machine (.apk, or a zipped iOS simulator .app)."
+      description: "Path to the build file on this machine: a zipped iOS/tvOS simulator .app, an Android/Android TV .apk, or a Roku channel .zip."
     },
     name: {
       type: "string",
@@ -166,6 +190,7 @@ function buildToolDefinitions() {
     DEV_RELOAD_DEF,
     UPLOAD_APP_DEF,
     LIST_DEVICE_MODELS_DEF,
+    LIST_APPS_DEF,
     LIST_BUILDS_DEF,
     STOP_SESSION_DEF
   ];
@@ -174,7 +199,44 @@ function textResult(text, structuredContent, isError = false) {
   return { content: [{ type: "text", text }], structuredContent, isError };
 }
 function errorResult(message) {
-  return { content: [{ type: "text", text: message }], isError: true };
+  return { content: [{ type: "text", text: forMcp(message) }], isError: true };
+}
+function forMcp(message) {
+  let text = message.replace(/`vibeview list-devices --models`/g, "list_device_models").replace(/`vibeview list-builds <app>`/g, "list_builds").replace(/`vibeview list-builds ([^`\s]+)`/g, 'list_builds (app "$1")').replace(/`vibeview list-apps`/g, "list_apps").replace(/\blist-apps\b/g, "list_apps").replace(/`vibeview upload-app`/g, "upload_app").replace(/`vibeview dev` needs/g, "dev_start needs");
+  if (/No debug build|is not a debug build/.test(text) && !/standalone: true/.test(text)) {
+    text += " To run a release build as it is, with no Metro, call dev_start with standalone: true.";
+  }
+  return text;
+}
+async function readSession(deps, sessionId) {
+  const get = deps.getSession ?? ((id) => new ApiClient(deps.auth.baseUrl, deps.auth.token).getSession(id));
+  return get(sessionId);
+}
+function isEndedStatus(status) {
+  return status === "stopped" || status === "failed";
+}
+function endedLine(ended) {
+  const why = ended.reason ? `: ${ended.reason}` : "";
+  return `session ${ended.sessionId} has ended (${ended.status}${why})`;
+}
+async function explainInactive(sessionId, deps) {
+  let info;
+  try {
+    info = await readSession(deps, sessionId);
+  } catch {
+    return null;
+  }
+  if (!isEndedStatus(info.status)) return null;
+  const ended = {
+    sessionId,
+    status: info.status,
+    reason: info.failure_reason ?? null
+  };
+  const held = deps.devSession.current()?.sessionId === sessionId;
+  if (held) deps.devSession.markEnded(ended);
+  return errorResult(
+    `${endedLine(ended)} \u2014 ${held ? "call dev_start to start a new one" : "start a new session"}`
+  );
 }
 function findCommand(toolName) {
   return AGENT_COMMANDS.find((c) => toolNameFor(c.verb) === toolName);
@@ -198,6 +260,9 @@ async function handleToolCall(toolName, args, deps) {
   if (toolName === "list_builds") {
     return handleListBuilds(args, deps);
   }
+  if (toolName === "list_apps") {
+    return handleListApps(args, deps);
+  }
   if (toolName === "stop_session") {
     return handleStopSession(args, deps);
   }
@@ -207,6 +272,8 @@ async function handleToolCall(toolName, args, deps) {
   }
   const sessionId = typeof args.session_id === "string" ? args.session_id : deps.resolveSessionId();
   if (!sessionId) {
+    const ended = deps.devSession.lastEnded();
+    if (ended) return errorResult(`${endedLine(ended)} \u2014 call dev_start to start a new one`);
     return errorResult(
       "No session to target. Call dev_start first, or pass session_id (e.g. from a running `vibeview dev --detach`)."
     );
@@ -224,7 +291,12 @@ async function handleToolCall(toolName, args, deps) {
   try {
     envelope = await deps.agentTool(sessionId, call.tool, call.args);
   } catch (err) {
-    return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
+    const message = err instanceof Error ? err.message : String(err);
+    if (/Session is not active/i.test(message)) {
+      const explained = await explainInactive(sessionId, deps);
+      if (explained) return explained;
+    }
+    return errorResult(`error: ${message}`);
   }
   if (cmd.verb === "screenshot" && envelope.ok) {
     return screenshotToolResult(envelope, args);
@@ -290,32 +362,94 @@ async function handleDevStart(args, deps) {
       );
     }
   }
+  const standalone = args.standalone === true;
   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,
-      ...buildId !== void 0 ? { buildId } : {}
+      ...buildId !== void 0 ? { buildId } : {},
+      ...standalone ? { standalone } : {}
     });
-    const payload = { session_id: result.sessionId, page_url: result.pageUrl };
-    return textResult(`dev session started: ${payload.session_id}
-${payload.page_url}`, payload);
+    const warnings = result.warnings ?? [];
+    const payload = {
+      session_id: result.sessionId,
+      page_url: result.pageUrl,
+      standalone,
+      device: result.device ?? null,
+      warnings
+    };
+    const lines = [`${standalone ? "session" : "dev session"} started: ${payload.session_id}`];
+    const device = result.device ? deviceLine(result.device) : null;
+    if (device) lines.push(device);
+    lines.push(payload.page_url, ...warnings.map((w) => `warning: ${w}`));
+    return textResult(lines.join("\n"), payload);
   } catch (err) {
     return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
   }
 }
+function deviceLine(d) {
+  const name = d.model || d.name;
+  if (!name) return null;
+  const parts = [name];
+  if (d.os_version) parts.push(`OS ${d.os_version}`);
+  if (d.category) parts.push(d.category);
+  if (d.form_factor) {
+    const fold = [d.posture ? `posture ${d.posture}` : null, d.screen ? `${d.screen} screen` : null].filter(Boolean).join(", ");
+    parts.push(fold ? `${d.form_factor} (${fold})` : d.form_factor);
+  }
+  return `device: ${parts.join(", ")}`;
+}
+function startedDevice(info) {
+  if (!info) return null;
+  const posture = info.posture ?? null;
+  return {
+    name: info.device_name ?? null,
+    model: info.device_model ?? null,
+    os_version: info.os_version ?? null,
+    category: info.device_category ?? null,
+    form_factor: info.form_factor ?? null,
+    posture,
+    screen: info.form_factor === "foldable" && posture ? posture === "closed" ? "cover" : "inner" : null
+  };
+}
 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
+      type: typeof args.device_type === "string" ? args.device_type : void 0,
+      availability: true
     });
   } catch (err) {
     return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
   }
-  return textResult(formatDeviceModelsHuman(models).trimEnd(), { models });
+  return textResult(formatDeviceModelsHuman(models, { availability: true }).trimEnd(), {
+    models: models.map(({ free, total, ...m }) => ({
+      ...m,
+      available: free ?? null,
+      busy: typeof free === "number" && typeof total === "number" ? total - free : null
+    }))
+  });
+}
+async function handleListApps(args, deps) {
+  const list = deps.listApps ?? (() => new ApiClient(deps.auth.baseUrl, deps.auth.token).listApps());
+  const platform = typeof args.platform === "string" && args.platform ? args.platform : void 0;
+  let apps;
+  try {
+    apps = (await list()).filter((a) => !platform || a.platform === platform);
+  } catch (err) {
+    return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  const rows = apps.map((a) => ({
+    app_id: a.public_id,
+    name: a.name,
+    platform: a.platform,
+    package_name: a.package_name
+  }));
+  const text = rows.length ? rows.map((a) => `${a.app_id}  ${a.name}  [${a.platform}]  ${a.package_name}`).join("\n") : platform ? `No ${platform} apps yet \u2014 upload a build with upload_app.` : "No apps yet \u2014 upload a build with upload_app.";
+  return textResult(text, { apps: rows });
 }
 async function handleListBuilds(args, deps) {
   const appId = typeof args.app === "string" ? args.app.trim() : "";
@@ -336,8 +470,28 @@ 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));
+  const held = deps.devSession.current()?.sessionId === sessionId;
+  let before = null;
+  try {
+    before = await readSession(deps, sessionId);
+  } catch (err) {
+    return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  if (before && isEndedStatus(before.status)) {
+    if (held) {
+      deps.devSession.markEnded({
+        sessionId,
+        status: before.status,
+        reason: before.failure_reason ?? null
+      });
+    }
+    return textResult(
+      `session ${sessionId} was already ${before.status === "failed" ? "over (it failed)" : "stopped"}`,
+      { session_id: sessionId, stopped: false, already_ended: true, status: before.status }
+    );
+  }
   try {
-    if (deps.devSession.current()?.sessionId === sessionId) {
+    if (held) {
       await deps.devSession.stop();
     } else {
       await stop(sessionId);
@@ -361,13 +515,21 @@ async function handleDevReload(args, deps) {
 }
 async function handleDevStop(deps) {
   const current = deps.devSession.current();
+  const ended = deps.devSession.lastEnded();
   try {
     await deps.devSession.stop();
   } catch (err) {
     return errorResult(`error: ${err instanceof Error ? err.message : String(err)}`);
   }
-  return textResult(current ? `dev session stopped: ${current.sessionId}` : "dev session stopped", {
-    session_id: current?.sessionId ?? null
+  if (!current) {
+    return textResult(
+      ended ? `no dev session was running \u2014 ${endedLine(ended)} already` : "no dev session was running",
+      { session_id: null, stopped: false }
+    );
+  }
+  return textResult(`dev session stopped: ${current.sessionId}`, {
+    session_id: current.sessionId,
+    stopped: true
   });
 }
 async function handleUploadApp(args, deps) {
@@ -377,7 +539,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-QUUXKNR2.js");
+    const { uploadAppBuild } = await import("./upload-app-WROTRZCA.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -413,6 +575,7 @@ async function handleUploadApp(args, deps) {
 function createDevSessionController(auth, webUrl) {
   let handle = null;
   let platform = null;
+  let ended = null;
   let presence = null;
   let reloading = null;
   const stopPresence = () => {
@@ -428,12 +591,32 @@ function createDevSessionController(auth, webUrl) {
       );
     }
   };
+  const markEnded = (e) => {
+    if (!handle || handle.sessionId !== e.sessionId) return;
+    const dead = handle;
+    stopPresence();
+    handle = null;
+    platform = null;
+    ended = e;
+    void dead.stop().catch(() => {
+    });
+  };
+  const api = () => new ApiClient(auth.baseUrl, auth.token);
   return {
     async start(cfg) {
       if (handle) {
-        throw new Error(
-          `a dev session is already running (${handle.sessionId}) \u2014 call dev_stop first`
-        );
+        const info = await api().getSession(handle.sessionId).catch(() => null);
+        if (info && isEndedStatus(info.status)) {
+          markEnded({
+            sessionId: handle.sessionId,
+            status: info.status,
+            reason: info.failure_reason ?? null
+          });
+        } else {
+          throw new Error(
+            `a dev session is already running (${handle.sessionId}) \u2014 call dev_stop first`
+          );
+        }
       }
       let devConfig = null;
       try {
@@ -448,8 +631,26 @@ function createDevSessionController(auth, webUrl) {
           `dev_start: no app to run for platform "${cfg.platform}" \u2014 pass the app arg (an app id from list-apps) or run \`vibeview dev\` once in this project to write vibeview.json`
         );
       }
+      let app;
+      try {
+        app = await api().getApp(appId);
+      } catch (err) {
+        if (err instanceof NotFoundError) {
+          throw new Error(
+            `app "${appId}" not found \u2014 it may have been deleted; see list_apps for your app ids`
+          );
+        }
+        throw err;
+      }
+      if (app.platform !== cfg.platform) {
+        throw new Error(
+          `app "${appId}" is ${platformWithArticle(app.platform)} app, not ${platformWithArticle(cfg.platform)} app \u2014 call dev_start with platform "${app.platform}", or pick ${platformWithArticle(cfg.platform)} app from list_apps`
+        );
+      }
+      const standalone = cfg.standalone === true;
+      const usesMetro = PLATFORM_NEEDS_METRO[cfg.platform] && !standalone;
       const metroPort = cfg.metroPort ?? devConfig?.metroPort ?? 8081;
-      if (PLATFORM_NEEDS_METRO[cfg.platform]) {
+      if (usesMetro) {
         const metro = await checkMetro(metroPort);
         if (metro === "down") {
           throw new Error(
@@ -458,47 +659,77 @@ function createDevSessionController(auth, webUrl) {
         }
       }
       if (cfg.buildId !== void 0) {
-        checkDevBuild(
-          await new ApiClient(auth.baseUrl, auth.token).getApp(appId),
-          cfg.buildId,
-          cfg.platform
-        );
+        checkDevBuild(app, cfg.buildId, cfg.platform, { standalone });
       }
       const isTv = PLATFORM_DEVICE[cfg.platform].tv;
+      const warnings = [];
+      let started = null;
+      started = await startDevSession(
+        {
+          token: auth.token,
+          baseUrl: auth.baseUrl,
+          webUrl,
+          platform: cfg.platform,
+          appId,
+          deviceCategory: isTv ? "tv" : entry?.deviceCategory ?? "phone",
+          // A named model decides the category itself (startDevSession).
+          model: cfg.model,
+          buildId: cfg.buildId,
+          ...standalone ? { standalone } : {},
+          metroPort,
+          open: false
+        },
+        (evt) => {
+          if (evt.event === "warning") warnings.push(evt.message);
+          if (evt.event === "session_ended" && evt.code !== 0 && started) {
+            const id = evt.session_id;
+            void api().getSession(id).then(
+              (info) => ({ status: info.status, reason: info.failure_reason ?? null }),
+              () => ({ status: "stopped", reason: null })
+            ).then(({ status, reason }) => markEnded({ sessionId: id, status, reason }));
+          }
+        }
+      );
+      handle = started;
       platform = cfg.platform;
-      handle = await startDevSession({
-        token: auth.token,
-        baseUrl: auth.baseUrl,
-        webUrl,
-        platform: cfg.platform,
-        appId,
-        deviceCategory: isTv ? "tv" : entry?.deviceCategory ?? "phone",
-        // A named model decides the category itself (startDevSession).
-        model: cfg.model,
-        buildId: cfg.buildId,
-        metroPort,
-        open: false
-      });
-      if (cfg.platform === "roku") {
-        const api = new ApiClient(auth.baseUrl, auth.token);
+      ended = null;
+      if (!usesMetro) {
+        const client = api();
         const sessionId = handle.sessionId;
         presence = setInterval(() => {
-          api.touchSession(sessionId).catch(() => {
-          });
+          client.touchSession(sessionId).then(
+            (info) => {
+              if (info && isEndedStatus(info.status)) {
+                markEnded({ sessionId, status: info.status, reason: info.failure_reason ?? null });
+              }
+            },
+            () => {
+            }
+          );
         }, ROKU_LIVENESS_INTERVAL_MS);
         presence.unref?.();
       }
-      return handle;
+      return {
+        sessionId: handle.sessionId,
+        pageUrl: handle.pageUrl,
+        device: startedDevice(handle.session),
+        warnings
+      };
     },
     async stop() {
       stopPresence();
       await handle?.stop();
       handle = null;
       platform = null;
+      ended = null;
     },
     current() {
       return handle ? { sessionId: handle.sessionId, pageUrl: handle.pageUrl } : null;
     },
+    markEnded,
+    lastEnded() {
+      return ended;
+    },
     async reload(requested) {
       if (reloading) {
         throw new Error(
@@ -564,6 +795,13 @@ function createDevSessionController(auth, webUrl) {
 function makeSessionResolver(devSession) {
   return () => devSession.current()?.sessionId ?? readDevState(process.cwd())?.session_id;
 }
+var MCP_INSTRUCTIONS = [
+  "VibeView runs your app on a cloud iOS simulator, Android emulator, Apple TV, Android TV or Roku (beta) device you control with these tools.",
+  "Loop: dev_start (platform, app from list_apps; add standalone: true for a release or CI build that needs no Metro) -> ui_tree -> act with refs (tap @e5, type, swipe, press) and read the change each action reports -> dev_stop when done.",
+  "Foldables: pick one by model in dev_start (list_device_models marks them foldable, with free/busy counts), then set_posture and rotate.",
+  "screenshot writes a PNG and returns its path; pass inline: true to see the image. logs reads the app output after a crash or blank screen.",
+  "A session stopped elsewhere is reported as ended; call dev_start again for a new one."
+].join("\n");
 async function createMcpServer(opts) {
   const [{ McpServer }, { z }] = await Promise.all([
     import("@modelcontextprotocol/sdk/server/mcp.js"),
@@ -578,7 +816,10 @@ async function createMcpServer(opts) {
     agentTool: client.agentTool.bind(client),
     devSession
   };
-  const server = new McpServer({ name: "vibeview", version: opts.version ?? "0.0.0" });
+  const server = new McpServer(
+    { name: "vibeview", version: opts.version ?? "0.0.0" },
+    { instructions: MCP_INSTRUCTIONS }
+  );
   function zodShape(def) {
     const shape = {};
     for (const [key, prop] of Object.entries(def.properties)) {
@@ -614,8 +855,12 @@ async function runMcpServer(opts) {
   await server.connect(transport);
 }
 export {
+  MCP_INSTRUCTIONS,
   buildToolDefinitions,
   createDevSessionController,
+  deviceLine,
+  forMcp,
   handleToolCall,
-  runMcpServer
+  runMcpServer,
+  startedDevice
 };

package/dist/{upload-app-QUUXKNR2.js → upload-app-WROTRZCA.js}

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vibeview",
-  "version": "0.27.0",
-  "description": "VibeView CLI -- run mobile tests from CI/CD pipelines",
+  "version": "0.28.0",
+  "description": "VibeView CLI -- run your app on cloud iOS simulators, Android emulators, Apple TV, Android TV and Roku (beta) devices: a React Native dev loop, device control for you or your coding agent (CLI or MCP), and tests from CI",
   "mcpName": "io.github.vibeview/vibeview",
   "type": "module",
   "bin": {

package/skills/vibeview-agent/SKILL.md

@@ -297,12 +297,17 @@ 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`, `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`. |
+| `upload_app` | `file` (required path), `name` | Upload a build (zipped iOS/tvOS simulator `.app`, Android/Android TV `.apk`, Roku channel `.zip`). 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`. |
+| `list_apps` | `platform` | List the org's apps (app id, name, platform, bundle id). The MCP equivalent of `vibeview list-apps` — use it to find an app someone else uploaded. |
+| `dev_start` | `platform` (required: `ios`/`android`/`tvos`/`androidtv`/`roku`), `app`, `metro_port`, `model`, `build_id`, `standalone` | Start a 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 build instead of the newest debug one (see `list_builds`). `standalone: true` runs any build as it is with no Metro — a release, CI or cloud build (without `build_id`: the newest release build). An app for another platform is refused before a device is taken. Returns `page_url` — relay it to the developer immediately, same as step 5 of the loop — and the device it got (model, OS, category; posture and lit screen on a foldable). |
+| `list_device_models` | `device_type` | List the device models you can start (model, OS, platform, category, `foldable` marker, and how many are free/busy). 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_stop` | — | Stop the session `dev_start` started. The MCP equivalent of `vibeview dev-stop`. Says "no dev session was running" when there was none. |
+| `stop_session` | `session_id` (required) | Stop any session by id. The MCP equivalent of `vibeview stop <session-id>`. Says so when the session had already ended. |
+
+If the held session ends elsewhere (dashboard, idle timeout, failure), the
+next tool call answers "session … has ended (…) — call dev_start"; the
+server has already let it go, so `dev_start` starts a fresh one.
 
 **`dev_start` is stateful — it changes the default session for every later
 call.** Once it succeeds, any tool called without an explicit `session_id`