vibeview 0.34.0 → 0.36.0

package/dist/cli.js

@@ -23,8 +23,9 @@ import {
   readDevState,
   readDevStateFile,
   readMetroState,
+  recordDevUse,
   runAgentVerb
-} from "./chunk-TPZG7NCU.js";
+} from "./chunk-VFCG4U7V.js";
 import {
   ApiClient,
   ApiStatusError,
@@ -45,7 +46,7 @@ import {
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-4D2E2PE4.js";
+} from "./chunk-QRJAFBH3.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -412,6 +413,7 @@ function printStepLines(stepNum, total, status, text, actions, error) {
   process.stderr.write(`  ${icon} Step ${stepNum}/${total}: ${text}
 `);
   for (const action of actions ?? []) {
+    if (action.tool === "fast_replay") continue;
     process.stderr.write(`    ${chalk2.dim(formatAction(action))}
 `);
   }
@@ -1786,6 +1788,7 @@ async function devReload(opts) {
   } catch (err) {
     fail(opts, "reload_failed", err instanceof Error ? err.message : String(err), 1);
   }
+  recordDevUse(state.session_id);
   if (opts.json) {
     console.log(
       JSON.stringify({
@@ -3834,7 +3837,7 @@ function resolveMetadata(opts) {
 }
 var program = new Command();
 program.name("vibeview").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 (dev), device control for you or your coding agent (ui-tree, tap, mcp), and tests from CI (run-test, run-suites)"
+  "VibeView CLI -- run your app on cloud iOS simulators, Android emulators, Apple TV, Android TV and Roku devices: a React Native dev loop (dev), device control for you or your coding agent (ui-tree, tap, mcp), and tests from CI (run-test, run-suites)"
 ).version(pkg.version);
 program.command("run-suite <suite-id>").description("Run all test cases in a suite").option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").option("--output <format>", "Output format: human, json, junit", "human").option("--verbose", "Show per-case breakdown", false).option("--timeout <seconds>", "Max wait time in seconds (queue wait plus execution)", "1800").option("--commit-sha <sha>", "Git commit SHA for GitHub status checks").option("--model <model>", "AI model to use").option("--provider <provider>", "AI provider").option("--mode <mode>", "Execution mode: hybrid, ai, replay").option(
   "--device-category <category>",
@@ -4144,7 +4147,7 @@ program.command("dev-reload").description(
 program.command("mcp").description(
   "Run an MCP stdio server exposing the agent verbs (tap, swipe, type, ...) plus dev_start/dev_stop/dev_reload as tools"
 ).option("--token <token>", "API token (or set VIBEVIEW_API_TOKEN)").action(async (opts) => {
-  const { runMcpServer } = await import("./server-RDGEVJD4.js");
+  const { runMcpServer } = await import("./server-2CDIRTBV.js");
   await runMcpServer({ ...opts, version: pkg.version });
 });
 program.command("agent-setup").description(

package/dist/{server-RDGEVJD4.js → server-2CDIRTBV.js}

@@ -9,6 +9,7 @@ import {
   buildToolCall,
   checkDevBuild,
   checkMetro,
+  countsAsUse,
   createRokuPush,
   decodeScreenshotResult,
   describeDevBuild,
@@ -20,17 +21,19 @@ import {
   loadDevConfig,
   loadLocalDevConfig,
   parseBuildId,
+  parseIdleWarningSeconds,
   platformWithArticle,
   readDevState,
+  recordDevUse,
   renderEnvelope,
   resolveMetro,
   startDevSession
-} from "./chunk-TPZG7NCU.js";
+} from "./chunk-VFCG4U7V.js";
 import {
   ApiClient,
   NotFoundError,
   resolveAuth
-} from "./chunk-4D2E2PE4.js";
+} from "./chunk-QRJAFBH3.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -241,9 +244,15 @@ function capitalize(text) {
   return text.charAt(0).toUpperCase() + text.slice(1);
 }
 function endedLine(ended) {
+  if (ended.status === "replaced") {
+    return `session ${ended.sessionId} was taken over by another VibeView dev connection and is no longer held here (it keeps running there)`;
+  }
   const why = ended.reason ? `: ${ended.reason}` : "";
   return `session ${ended.sessionId} has ended (${ended.status}${why})`;
 }
+function idleNoticeText(sessionId, seconds) {
+  return `Session ${sessionId} ends in ${seconds} s for inactivity: a device action (tap, type, swipe, press, \u2026) keeps it; ui_tree, screenshot, logs, find and wait do not.`;
+}
 async function explainInactive(sessionId, deps) {
   let info;
   try {
@@ -266,7 +275,7 @@ async function explainInactive(sessionId, deps) {
 function findCommand(toolName) {
   return AGENT_COMMANDS.find((c) => toolNameFor(c.verb) === toolName);
 }
-async function handleToolCall(toolName, args, deps, extra = {}) {
+async function dispatchToolCall(toolName, args, deps, extra = {}) {
   if (toolName === "dev_start") {
     return handleDevStart(args, deps, extra);
   }
@@ -331,6 +340,55 @@ async function handleToolCall(toolName, args, deps, extra = {}) {
   }
   return textResult(renderEnvelope(envelope, toolNameFor(cmd.verb)), envelope, !envelope.ok);
 }
+async function handleToolCall(toolName, args, deps, extra = {}) {
+  const held = deps.devSession.current?.()?.sessionId;
+  const dispatched = typeof args.session_id === "string" ? args.session_id.trim() : deps.resolveSessionId();
+  const usesBefore = deps.devSession.useGeneration?.();
+  const result = await dispatchToolCall(toolName, args, deps, extra);
+  noteDeviceUse(toolName, result, deps, held, dispatched);
+  const usedSince = usesBefore !== void 0 && (deps.devSession.useGeneration?.() ?? usesBefore) > usesBefore;
+  return withIdleNotice(toolName, args, result, deps, held, dispatched, usedSince);
+}
+function noteDeviceUse(toolName, result, deps, held, dispatched) {
+  const cmd = findCommand(toolName);
+  if (!cmd || !dispatched || !result.structuredContent) return;
+  if (!countsAsUse(cmd.tool)) return;
+  if (dispatched === held) deps.devSession.noteUse?.(dispatched);
+  else recordDevUse(dispatched);
+}
+var IDLE_NOTICE_DISCARD = /* @__PURE__ */ new Set(["dev_start", "dev_stop", "dev_reload"]);
+function withIdleNotice(toolName, args, result, deps, held, dispatched, usedSince = false) {
+  const dev = deps.devSession;
+  const stopsHeld = toolName === "stop_session" && held !== void 0 && (typeof args.session_id === "string" ? args.session_id.trim() : held) === held;
+  if ((IDLE_NOTICE_DISCARD.has(toolName) || stopsHeld) && !result.isError) {
+    const about = toolName === "dev_start" ? dev.current?.()?.sessionId : held;
+    if (about !== void 0) dev.takeIdleWarning?.(about);
+    return result;
+  }
+  if (findCommand(toolName) && result.structuredContent && typeof result.structuredContent === "object") {
+    const own = result.structuredContent.idle_warning;
+    if (own !== void 0) {
+      const target = dispatched;
+      if (target !== void 0 && target === held) dev.takeIdleWarning?.(target);
+      const seconds = parseIdleWarningSeconds(own?.seconds_remaining);
+      if (usedSince && target === held) return result;
+      if (target && seconds !== null) return appendNotice(result, idleNoticeText(target, seconds));
+      return result;
+    }
+  }
+  const notice = dev.takeIdleWarning?.() ?? null;
+  return notice ? appendNotice(result, notice) : result;
+}
+function appendNotice(result, notice) {
+  const i = result.content.findIndex((b) => b.type === "text");
+  if (i === -1) return { ...result, content: [...result.content, { type: "text", text: notice }] };
+  const content = result.content.slice();
+  const block = content[i];
+  content[i] = { type: "text", text: `${block.text}
+
+${notice}` };
+  return { ...result, content };
+}
 function screenshotToolResult(envelope, args) {
   const { image, preview } = splitScreenshotResult(envelope.result);
   let imageBytes;
@@ -613,7 +671,7 @@ async function handleDevStop(deps) {
   }
   if (!current) {
     return textResult(
-      ended ? `no dev session was running \u2014 it had already ended. ${capitalize(endedLine(ended))}` : "no dev session was running",
+      ended ? ended.status === "replaced" ? `no dev session was running here. ${capitalize(endedLine(ended))}` : `no dev session was running \u2014 it had already ended. ${capitalize(endedLine(ended))}` : "no dev session was running",
       { session_id: null, stopped: false }
     );
   }
@@ -629,7 +687,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-AKD73742.js");
+    const { uploadAppBuild } = await import("./upload-app-BPTGBDQB.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -725,6 +783,7 @@ function createDevSessionController(auth, webUrl) {
   let ended = null;
   let reloading = null;
   let pending = null;
+  let idle = null;
   const readRokuBuild = () => {
     try {
       return loadDevConfig(process.cwd())?.platforms?.roku?.build ?? null;
@@ -739,10 +798,25 @@ function createDevSessionController(auth, webUrl) {
     const dead = handle;
     handle = null;
     platform = null;
+    idle = null;
     ended = { ...e, reason: e.reason ?? dead.lapsedReason?.() ?? null };
     void dead.stop().catch(() => {
     });
   };
+  const markReplaced = (sessionId) => {
+    if (!handle || handle.sessionId !== sessionId) return;
+    handle = null;
+    platform = null;
+    idle = null;
+    ended = { sessionId, status: "replaced", reason: null };
+  };
+  let uses = 0;
+  const noteHeldUse = (sessionId) => {
+    if (!handle || handle.sessionId !== sessionId) return;
+    uses++;
+    handle.noteUse?.();
+    if (idle?.sessionId === sessionId) idle = null;
+  };
   const api = () => new ApiClient(auth.baseUrl, auth.token);
   return {
     async start(cfg) {
@@ -832,11 +906,18 @@ function createDevSessionController(auth, webUrl) {
             onCreated: (created) => {
               pending = created;
             },
-            onDequeued: () => progress.dequeued()
+            onDequeued: () => progress.dequeued(),
+            onIdleWarning: (id, warning) => {
+              idle = warning ? { sessionId: id, endsAt: Date.now() + warning.seconds_remaining * 1e3 } : null;
+            }
           },
           (evt) => {
             progress.event(evt);
             if (evt.event === "warning") warnings.push(evt.message);
+            if (evt.event === "session_ended" && evt.replaced && started) {
+              markReplaced(evt.session_id);
+              return;
+            }
             if (evt.event === "session_ended" && evt.code !== 0 && started) {
               const id = evt.session_id;
               void api().getSession(id).then(
@@ -882,6 +963,7 @@ function createDevSessionController(auth, webUrl) {
       await handle?.stop();
       handle = null;
       platform = null;
+      idle = null;
       ended = null;
     },
     async shutdown() {
@@ -890,6 +972,7 @@ function createDevSessionController(auth, webUrl) {
       const starting = pending;
       handle = null;
       platform = null;
+      idle = null;
       pending = null;
       await Promise.all([
         held ? held.stop().then(
@@ -912,6 +995,17 @@ function createDevSessionController(auth, webUrl) {
     lastEnded() {
       return ended;
     },
+    noteUse: noteHeldUse,
+    useGeneration: () => uses,
+    takeIdleWarning(sessionId) {
+      const w = idle;
+      if (sessionId !== void 0 && w?.sessionId !== sessionId) return null;
+      idle = null;
+      if (!w || !handle || handle.sessionId !== w.sessionId) return null;
+      const seconds = Math.ceil((w.endsAt - Date.now()) / 1e3);
+      if (seconds <= 0) return null;
+      return idleNoticeText(w.sessionId, seconds);
+    },
     async reload(requested) {
       if (reloading) {
         throw new Error(
@@ -970,6 +1064,8 @@ function createDevSessionController(auth, webUrl) {
         log: (line) => console.error(line)
       });
       await push();
+      if (handle?.sessionId === target.sessionId) noteHeldUse(target.sessionId);
+      else recordDevUse(target.sessionId);
       return { sessionId: target.sessionId, seconds: (Date.now() - started) / 1e3 };
     }
   }
@@ -978,12 +1074,13 @@ 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.",
+  "VibeView runs your app on a cloud iOS simulator, Android emulator, Apple TV, Android TV or Roku 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.",
   "set_location sets the simulated GPS position (phones and tablets) for location-based flows.",
   "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."
+  "A session stopped elsewhere is reported as ended; call dev_start again for a new one.",
+  'A session nobody uses ends after the idle timeout. A result that ends with "Session \u2026 ends in N s for inactivity" means act (tap, type, swipe, press) to keep it, or dev_stop if you are done; ui_tree, screenshot, logs, find and wait do not count as use.'
 ].join("\n");
 async function createMcpServer(opts) {
   const [{ McpServer }, { z }] = await Promise.all([
@@ -1100,6 +1197,7 @@ export {
   deviceLine,
   forMcp,
   handleToolCall,
+  idleNoticeText,
   mcpText,
   progressReporter,
   runMcpServer,

package/dist/{upload-app-AKD73742.js → upload-app-BPTGBDQB.js}

@@ -3,7 +3,7 @@ import {
   describeBuild,
   uploadApp,
   uploadAppBuild
-} from "./chunk-4D2E2PE4.js";
+} from "./chunk-QRJAFBH3.js";
 export {
   describeBuild,
   uploadApp,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vibeview",
-  "version": "0.34.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",
+  "version": "0.36.0",
+  "description": "VibeView CLI -- run your app on cloud iOS simulators, Android emulators, Apple TV, Android TV and Roku 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

@@ -211,7 +211,7 @@ appear unexplained in their `git status`.
   `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
+- **Roku channels**: 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
@@ -254,6 +254,10 @@ vibeview dev-stop
 If the `dev --detach` process is killed or the computer sleeps, its session
 ends on its own within about 90 seconds (unless a browser tab is watching
 it) — but don't rely on that; stop it.
+A session nobody uses also ends on its own after the organization's idle
+timeout (30 minutes by default). Only device actions (tap, type, swipe,
+press, …) and app reloads count as use; `ui-tree`, `screenshot`, `logs`,
+`find` and `wait` do not, and neither does keeping `dev --detach` running.
 A session you did not start with `dev` (one created through the API, the
 sandbox, or a collaboration link) is stopped by id:
 ```bash
@@ -332,6 +336,10 @@ steps the CLI does with plain shell commands:
 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.
+A tool result that ends with `Session … ends in N s for inactivity` means
+the held session is about to time out: act on the device to keep it, or call
+`dev_stop` if you are done. A session another VibeView dev connection took
+over is reported as taken over; it keeps running there, so don't stop it.
 
 **`dev_start` is stateful — it changes the default session for every later
 call.** Once it succeeds, any tool called without an explicit `session_id`