vibeview 0.21.0 → 0.23.0

package/dist/{chunk-VVKF7GGL.js → chunk-E2LZSLRF.js}

@@ -6,7 +6,7 @@ import {
   loadConfig,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-KON2FOEC.js";
+} from "./chunk-PSFXVUHG.js";
 
 // src/lib/dev-state.ts
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
@@ -528,10 +528,6 @@ function noAppsMessage(platform, hasBuildConfig) {
   }
   return `No ${platform} apps found. Run \`vibeview build --platform ${platform}\` to build and upload one (it will ask for your build command), or upload a build with \`vibeview upload-app\`.`;
 }
-function firstRunAppStrategy(apps, buildConfigured) {
-  if (!buildConfigured) return "picker";
-  return apps.length === 0 ? "build_now" : "ask";
-}
 function fillLaterHint(skipped, platform) {
   if (!skipped.build && !skipped.metro) return "";
   const lines = ["You can enable one-command builds later \u2014 add to vibeview.json:"];
@@ -1586,6 +1582,38 @@ function printOutcomeLine(build, multi) {
   console.error(line);
 }
 
+// src/lib/roku-push.ts
+function createRokuPush(opts) {
+  const runBuild = opts.runBuild ?? runBuildForPlatform;
+  return async () => {
+    const started = Date.now();
+    let result;
+    try {
+      result = await runBuild(
+        opts.cwd,
+        "roku",
+        opts.build,
+        { token: opts.token, baseUrl: opts.baseUrl },
+        opts.log
+      );
+    } catch (err) {
+      const message = err.message;
+      if (/artifact not found/i.test(message)) {
+        throw new Error(
+          `${message}
+your build command must produce a zip \u2014 use the package/zip step, not deploy`
+        );
+      }
+      throw err;
+    }
+    if (!result.build_id) {
+      throw new Error(`upload returned no build id for ${result.name ?? result.public_id}`);
+    }
+    await opts.api.installBuild(opts.sessionId, result.build_id, true);
+    opts.log(`reloaded in ${((Date.now() - started) / 1e3).toFixed(1)}s`);
+  };
+}
+
 // src/commands/dev.ts
 import { spawn as spawn4 } from "child_process";
 import { createWriteStream, mkdirSync as mkdirSync3 } from "fs";
@@ -2015,38 +2043,6 @@ function watchProjectFiles(cwd, artifact, userIgnore = []) {
   };
 }
 
-// src/lib/roku-push.ts
-function createRokuPush(opts) {
-  const runBuild = opts.runBuild ?? runBuildForPlatform;
-  return async () => {
-    const started = Date.now();
-    let result;
-    try {
-      result = await runBuild(
-        opts.cwd,
-        "roku",
-        opts.build,
-        { token: opts.token, baseUrl: opts.baseUrl },
-        opts.log
-      );
-    } catch (err) {
-      const message = err.message;
-      if (/artifact not found/i.test(message)) {
-        throw new Error(
-          `${message}
-your build command must produce a zip \u2014 use the package/zip step, not deploy`
-        );
-      }
-      throw err;
-    }
-    if (!result.build_id) {
-      throw new Error(`upload returned no build id for ${result.name ?? result.public_id}`);
-    }
-    await opts.api.installBuild(opts.sessionId, result.build_id, true);
-    opts.log(`reloaded in ${((Date.now() - started) / 1e3).toFixed(1)}s`);
-  };
-}
-
 // src/commands/dev.ts
 function parseWatchSeconds(flag) {
   if (flag === void 0 || flag === false) return void 0;
@@ -2064,7 +2060,10 @@ async function startDevSession(cfg, onEvent = () => {
 }, onTunnelState) {
   const api = new ApiClient(cfg.baseUrl, cfg.token);
   const usesTunnel = PLATFORM_NEEDS_METRO[cfg.platform];
-  const created = await api.createSession(devSessionCreateBody(cfg));
+  const pool = cfg.model ? resolveDeviceModel(await api.listDeviceModels(), cfg.platform, cfg.model) : null;
+  const created = await api.createSession(
+    devSessionCreateBody(pool ? { ...cfg, deviceCategory: pool.category, model: pool.model } : cfg)
+  );
   const sessionId = created.session_id;
   let stopping = false;
   let tunnel = null;
@@ -2134,7 +2133,13 @@ async function startDevSession(cfg, onEvent = () => {
     }
     if (cfg.open !== false) await openBrowser(pageUrl).catch(() => {
     });
-    const active = await pollUntilActive(api, sessionId, 18e4);
+    const active = await pollUntilActive(
+      api,
+      sessionId,
+      18e4,
+      2e3,
+      () => onEvent({ event: "installing", session_id: sessionId })
+    );
     for (const w of active.warnings ?? []) {
       if (reportedWarnings.has(w)) continue;
       reportedWarnings.add(w);
@@ -2152,9 +2157,23 @@ function devSessionCreateBody(cfg) {
     device_category: cfg.deviceCategory,
     app_id: cfg.appId,
     // Roku has no JS bundle to serve, so there is nothing to tunnel.
-    tunnel: PLATFORM_NEEDS_METRO[cfg.platform]
+    tunnel: PLATFORM_NEEDS_METRO[cfg.platform],
+    ...cfg.model ? { model: cfg.model } : {}
   };
 }
+function resolveDeviceModel(pools, platform, model) {
+  const { deviceType, tv } = PLATFORM_DEVICE[platform];
+  const candidates = pools.filter(
+    (p) => p.device_type === deviceType && p.category === "tv" === tv
+  );
+  const wanted = model.trim();
+  const match = candidates.find((p) => p.model === wanted) ?? candidates.find((p) => p.model.toLowerCase() === wanted.toLowerCase());
+  if (match) return match;
+  const names = [...new Set(candidates.map((p) => p.model))].sort();
+  throw new Error(
+    names.length ? `no ${platform} device model named "${model}" \u2014 available: ${names.join(", ")} (see \`vibeview list-devices --models\`)` : `no ${platform} devices are available right now`
+  );
+}
 var BLOCKING_WARNING_PREFIXES = ["No debug build", "App install failed", "App not found"];
 function findBlockingWarning(info) {
   return (info.warnings ?? []).find((w) => BLOCKING_WARNING_PREFIXES.some((p) => w.includes(p)));
@@ -2192,13 +2211,18 @@ async function pollUntilTunnelReady(api, sessionId, timeoutMs, intervalMs = 2e3)
     await new Promise((r) => setTimeout(r, intervalMs));
   }
 }
-async function pollUntilActive(api, sessionId, timeoutMs, intervalMs = 2e3) {
+async function pollUntilActive(api, sessionId, timeoutMs, intervalMs = 2e3, onInstallPending) {
   const deadline = Date.now() + timeoutMs;
+  let pendingReported = false;
   for (; ; ) {
-    const info = await api.getSession(sessionId);
+    const info = await api.touchSession(sessionId);
     const blocking = findBlockingWarning(info);
     if (blocking) throw new Error(blocking);
-    if (info.status === "active") return info;
+    if (info.status === "active" && info.app_install_pending && !pendingReported) {
+      pendingReported = true;
+      onInstallPending?.();
+    }
+    if (info.status === "active" && !info.app_install_pending) return info;
     if (info.status === "stopped" || info.status === "failed") {
       throw new Error(`session ${info.status} before it became active`);
     }
@@ -2250,6 +2274,12 @@ function validateAppChoice(requested, fromFlag, apps) {
   if (apps.some((a) => a.public_id === requested)) return { appId: requested };
   return fromFlag ? { staleFlag: requested } : { staleCached: requested };
 }
+function buildAppStrategy(apps, buildFlag, json, isTTY) {
+  if (buildFlag) return "build";
+  if (apps.length === 0) return "build";
+  if (json || !isTTY) return "pick";
+  return "ask";
+}
 function requireNonInteractive(json) {
   if (!json) return;
   emit(json, {
@@ -2283,6 +2313,16 @@ async function ensureConfig(api, opts) {
     console.error(chalk3.red(`error: use --platform tvos or --platform androidtv for TV devices`));
     process.exit(2);
   }
+  if (opts.model !== void 0 && opts.deviceCategory) {
+    console.error(chalk3.red("error: pass --model or --device-category, not both"));
+    process.exit(2);
+  }
+  if (opts.model !== void 0 && !opts.model.trim()) {
+    console.error(
+      chalk3.red("error: --model needs a model name (see `vibeview list-devices --models`)")
+    );
+    process.exit(2);
+  }
   let firstRunBuild = null;
   let firstRunMetro = null;
   let isFirstRun = false;
@@ -2325,9 +2365,10 @@ Run \`vibeview dev\` without --app to pick from the list.`
       chalk3.yellow(`\u26A0 app "${choice.staleCached}" no longer exists \u2014 pick your debug build again`)
     );
   }
-  if (isFirstRun && !appId) {
-    const strategy = firstRunAppStrategy(apps, firstRunBuild !== null);
-    let action = strategy === "build_now" ? "build" : "pick";
+  const buildConfig = firstRunBuild ?? entry?.build ?? null;
+  if (!appId && buildConfig) {
+    const strategy = buildAppStrategy(apps, Boolean(opts.build), opts.json, process.stdin.isTTY);
+    let action = strategy === "ask" ? "pick" : strategy;
     if (strategy === "ask") {
       action = await select3({
         message: "Run against which build?",
@@ -2343,7 +2384,7 @@ Run \`vibeview dev\` without --app to pick from the list.`
         const result = await runBuildForPlatform(
           process.cwd(),
           platform,
-          firstRunBuild,
+          buildConfig,
           opts,
           (l) => console.error(chalk3.dim(l))
         );
@@ -2352,6 +2393,7 @@ Run \`vibeview dev\` without --app to pick from the list.`
       } catch (err) {
         const message = err.message;
         console.error(chalk3.red(`error: ${message}`));
+        emit(opts.json, { event: "error", message });
         process.exit(1);
       }
     }
@@ -2415,6 +2457,7 @@ Run \`vibeview dev\` without --app to pick from the list.`
     platform,
     appId,
     deviceCategory,
+    model: opts.model,
     metroPort: finalMetro.port,
     metroCommand: finalMetro.command,
     platformHasMetroOverride: finalMetro.platformHasOverride,
@@ -2558,6 +2601,7 @@ async function runDevInProcess(opts) {
         platform: cfg.platform,
         appId: cfg.appId,
         deviceCategory: cfg.deviceCategory,
+        model: cfg.model,
         metroPort: cfg.metroPort ?? 8081,
         // startDevSession's own browser-open happens before we've written the
         // state file / emitted session_ready — open it ourselves afterward
@@ -2583,6 +2627,10 @@ async function runDevInProcess(opts) {
         } else if (evt.event === "tunnel_connected") {
           everConnected = true;
           console.error(chalk3.green("\u2713 tunnel connected \u2014 edit away, Fast Refresh is live"));
+        } else if (evt.event === "installing") {
+          console.error(
+            chalk3.dim("  Putting the channel on the Roku \u2014 the link appears once it is up.")
+          );
         } else if (evt.event === "session_ended" && !stopping && handle) {
           console.error(chalk3.red("tunnel closed by server \u2014 session ended"));
           stopping = true;
@@ -2692,7 +2740,7 @@ async function runDevInProcess(opts) {
             if (stopping) return;
             let info = null;
             try {
-              info = await api.getSession(sessionId);
+              info = await api.touchSession(sessionId);
             } catch {
             }
             const verdict = sessionLivenessVerdict(info);
@@ -2801,6 +2849,55 @@ async function dev(opts) {
   if (process.exitCode === 1) return;
 }
 
+// src/lib/formatters/devices.ts
+import chalk4 from "chalk";
+var HEADERS = ["DEVICE_ID", "NAME", "TYPE", "CATEGORY", "OS", "STATUS"];
+function formatDevicesHuman(devices) {
+  if (devices.length === 0) {
+    return "No devices registered.\n";
+  }
+  const rows = devices.map((d) => [
+    d.device_id,
+    d.name,
+    d.type,
+    d.category,
+    d.os_version,
+    d.status
+  ]);
+  const widths = HEADERS.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
+  const lines = [chalk4.bold(fmt(HEADERS))];
+  for (const row of rows.sort(rowSort)) {
+    const statusColored = row[5] === "available" ? chalk4.green(row[5]) : row[5] === "busy" ? chalk4.yellow(row[5]) : chalk4.dim(row[5]);
+    lines.push(fmt([row[0], row[1], row[2], row[3], row[4], statusColored]));
+  }
+  return lines.join("\n") + "\n";
+}
+function rowSort(a, b) {
+  return a[2].localeCompare(b[2]) || a[3].localeCompare(b[3]) || a[0].localeCompare(b[0]);
+}
+function filterDeviceModels(models, opts) {
+  return models.filter((m) => !opts.type || m.device_type === opts.type).filter((m) => !opts.category || m.category === opts.category).map((m) => ({
+    model: m.model,
+    os_version: m.os_version,
+    device_type: m.device_type,
+    category: m.category,
+    form_factor: m.form_factor ?? null
+  }));
+}
+var MODEL_HEADERS = ["MODEL", "OS", "TYPE", "CATEGORY", "FORM FACTOR"];
+function formatDeviceModelsHuman(models) {
+  if (models.length === 0) {
+    return "No device models available right now.\n";
+  }
+  const rows = models.map((m) => [m.model, m.os_version, m.device_type, m.category, m.form_factor ?? "-"]).sort(
+    (a, b) => a[2].localeCompare(b[2]) || a[3].localeCompare(b[3]) || a[0].localeCompare(b[0]) || a[1].localeCompare(b[1])
+  );
+  const widths = MODEL_HEADERS.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const fmt = (cells) => cells.map((c, i) => c.padEnd(widths[i])).join("  ").trimEnd();
+  return [chalk4.bold(fmt(MODEL_HEADERS)), ...rows.map(fmt)].join("\n") + "\n";
+}
+
 // src/agent/registry.ts
 var AGENT_COMMANDS = [
   {
@@ -3116,6 +3213,52 @@ var AGENT_COMMANDS = [
       }
     ]
   },
+  {
+    // set_posture: { posture: 'closed' | 'partial' | 'open' } OR { angle: 0..180 }
+    // — exactly one (buildToolCall enforces it CLI-side, agent_control.py's
+    // validate_tool_args at the gate). The angle is a settle-once fold, the
+    // same as the dashboard slider's release, not its live drag stream.
+    // Foldable devices only.
+    verb: "set-posture",
+    tool: "set_posture",
+    summary: "Fold or unfold a foldable device (iPhone Duo): a preset (closed, partial, open) or an exact hinge angle in degrees (--angle 0-180) \u2014 pass exactly one. Reports the posture it settled in, the angle, and which screen is lit. Errors on a device without a hinge.",
+    mutating: true,
+    params: [
+      {
+        name: "posture",
+        cli: "positional",
+        type: "string",
+        required: false,
+        description: "One of 'closed', 'partial', 'open'. Omit when passing an angle."
+      },
+      {
+        name: "angle",
+        cli: "--angle",
+        type: "number",
+        required: false,
+        description: "Exact hinge angle in whole degrees, 0 (shut) to 180 (flat open). Omit when passing a posture."
+      }
+    ]
+  },
+  {
+    // rotate: { degrees?: 90 | 180 | 270 } (default 90). The same control as
+    // the dashboard's Rotate button. A foldable turns its body by quarter
+    // turns (90 clockwise, 270 back, 180 a half turn); a rigid phone toggles
+    // portrait <-> landscape and accepts only 90. Refused on TV devices.
+    verb: "rotate",
+    tool: "rotate",
+    summary: "Rotate the device. A phone toggles between portrait and landscape; a foldable (iPhone Duo) turns a quarter clockwise, or by --degrees 180/270. Reports the new orientation. Not available on TV devices.",
+    mutating: true,
+    params: [
+      {
+        name: "degrees",
+        cli: "--degrees",
+        type: "number",
+        required: false,
+        description: "Foldable only: 90 (default, a quarter turn clockwise), 180, or 270 (a quarter turn back). A phone accepts only 90."
+      }
+    ]
+  },
   {
     // tools.py wait: { seconds?: number } (default: 2). Note the wire arg is
     // "seconds", NOT "ms" — tool_dispatch.py reads args.get("seconds", 2)
@@ -3207,18 +3350,18 @@ var AGENT_COMMANDS = [
 ];
 
 // src/agent/render.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 function renderEnvelope(env) {
   const lines = [];
   if (env.ok) {
-    lines.push(chalk4.green(`ok`) + chalk4.dim(` (${env.tool})`));
+    lines.push(chalk5.green(`ok`) + chalk5.dim(` (${env.tool})`));
   } else {
-    lines.push(chalk4.red(`error`) + chalk4.dim(` (${env.tool})`));
+    lines.push(chalk5.red(`error`) + chalk5.dim(` (${env.tool})`));
   }
   lines.push(...resultLines(env.result));
   if (env.observation) {
     if (env.observation.kind === "unavailable") {
-      lines.push(chalk4.yellow(`warning: ${env.observation.text}`));
+      lines.push(chalk5.yellow(`warning: ${env.observation.text}`));
     } else {
       lines.push(env.observation.text);
     }
@@ -3231,17 +3374,17 @@ function resultLines(result) {
   const lines = [];
   if (Array.isArray(r.entries) && typeof r.cursor === "number") {
     if (r.entries.length === 0) {
-      lines.push(chalk4.dim("(no log lines)"));
+      lines.push(chalk5.dim("(no log lines)"));
     }
     for (const e of r.entries) {
       if (!e || typeof e !== "object") continue;
       const entry = e;
       const ts = typeof entry.timestamp === "number" ? new Date(entry.timestamp).toISOString().slice(11, 23) : "??:??:??.???";
       const level = typeof entry.level === "string" ? entry.level : "info";
-      const levelTag = level === "error" ? chalk4.red(level) : level === "warn" ? chalk4.yellow(level) : chalk4.dim(level);
-      lines.push(`${chalk4.dim(ts)} ${levelTag} ${String(entry.message ?? "")}`);
+      const levelTag = level === "error" ? chalk5.red(level) : level === "warn" ? chalk5.yellow(level) : chalk5.dim(level);
+      lines.push(`${chalk5.dim(ts)} ${levelTag} ${String(entry.message ?? "")}`);
     }
-    lines.push(chalk4.dim(`cursor: ${r.cursor}`));
+    lines.push(chalk5.dim(`cursor: ${r.cursor}`));
   }
   if (r.found === true && typeof r.ref === "string" && r.ref) {
     let found = `found: @${r.ref}`;
@@ -3253,14 +3396,43 @@ function resultLines(result) {
         const text = typeof a.text === "string" && a.text ? ` ${JSON.stringify(a.text)}` : "";
         return `${ref}${text}`;
       });
-      if (alts.length > 0) lines.push(chalk4.dim(`alternatives: ${alts.join(", ")}`));
+      if (alts.length > 0) lines.push(chalk5.dim(`alternatives: ${alts.join(", ")}`));
     }
   }
-  if (typeof r.note === "string" && r.note) lines.push(chalk4.dim(r.note));
+  if (r.action === "posture_set" || r.action === "rotated") {
+    const state = deviceStateLine(r);
+    if (state) lines.push(state);
+  }
+  if (typeof r.note === "string" && r.note) lines.push(chalk5.dim(r.note));
   if (typeof r.message === "string" && r.message) lines.push(r.message);
   if (typeof r.warning === "string" && r.warning) lines.push(r.warning);
   return lines;
 }
+function deviceStateLine(r) {
+  const parts = [];
+  if (r.action === "rotated") {
+    if (typeof r.device_orientation === "string") {
+      let o = `orientation: ${r.device_orientation}`;
+      if (typeof r.screen_orientation === "string" && r.screen_orientation !== r.device_orientation) {
+        o += ` (screen shows ${r.screen_orientation})`;
+      }
+      parts.push(o);
+    }
+  }
+  if (typeof r.posture === "string") {
+    let p = `posture: ${r.posture}`;
+    if (typeof r.angle === "number") p += ` at ${r.angle}\xB0`;
+    const extras = [];
+    if (typeof r.screen === "string") extras.push(`${r.screen} screen`);
+    const d = r.display;
+    if (d && typeof d.width === "number" && typeof d.height === "number") {
+      extras.push(`${d.width}x${d.height}`);
+    }
+    if (extras.length) p += ` (${extras.join(", ")})`;
+    parts.push(p);
+  }
+  return parts.length ? parts.join("; ") : null;
+}
 function agentExitCode(env) {
   return env.ok ? 0 : 1;
 }
@@ -3382,6 +3554,15 @@ function buildToolCall(cmd, positionals, opts) {
     }
     return { tool: cmd.tool, args: args2 };
   }
+  if (cmd.verb === "set-posture") {
+    const hasPosture = positionals[0] !== void 0 && positionals[0] !== "";
+    const hasAngle = opts.angle !== void 0 && opts.angle !== "";
+    if (hasPosture === hasAngle) {
+      throw new FlagError(
+        hasPosture ? "set-posture takes a posture or --angle, not both" : "set-posture requires a posture (closed, partial, open) or --angle <0-180>"
+      );
+    }
+  }
   const args = {};
   let positionalIndex = 0;
   for (const param of cmd.params) {
@@ -3488,6 +3669,7 @@ async function runAgentVerb(cmd, positionals, opts) {
 export {
   readDevState,
   clearDevState,
+  DEV_PLATFORMS,
   PLATFORM_NEEDS_METRO,
   isDevPlatform,
   loadDevConfig,
@@ -3501,9 +3683,14 @@ export {
   newTransitionState,
   printTransition,
   printOutcomeLine,
+  createRokuPush,
   startDevSession,
+  ROKU_LIVENESS_INTERVAL_MS,
   PLATFORM_DEVICE,
   dev,
+  formatDevicesHuman,
+  filterDeviceModels,
+  formatDeviceModelsHuman,
   AGENT_COMMANDS,
   renderEnvelope,
   buildToolCall,

package/dist/{chunk-KON2FOEC.js → chunk-PSFXVUHG.js}

@@ -238,6 +238,10 @@ var ApiClient = class {
     }
     return all;
   }
+  /** The startable device models (see `DeviceModelPool`). */
+  async listDeviceModels() {
+    return this.requestRaw("GET", "/devices/pools");
+  }
   async getDevice(deviceId) {
     return this.requestRaw("GET", `/devices/${deviceId}`);
   }
@@ -250,6 +254,13 @@ var ApiClient = class {
   async getSession(sessionId) {
     return this.requestRaw("GET", `/sessions/${sessionId}`);
   }
+  /** Report presence on a session and read it back in one call. A Roku dev
+   *  loop has no tunnel and no browser, so this is what tells the backend
+   *  someone is still using the session between device commands. Same
+   *  response shape as `getSession`. */
+  async touchSession(sessionId) {
+    return this.requestRaw("POST", `/sessions/${sessionId}/presence`);
+  }
   async stopSession(sessionId) {
     await this.requestRaw("DELETE", `/sessions/${sessionId}`);
   }