vibeview 0.22.0 → 0.23.0

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

@@ -6,7 +6,7 @@ import {
   loadConfig,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-UGCGJ6IN.js";
+} from "./chunk-PSFXVUHG.js";
 
 // src/lib/dev-state.ts
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
@@ -2060,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;
@@ -2154,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)));
@@ -2296,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;
@@ -2430,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,
@@ -2573,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
@@ -2820,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 = [
   {
@@ -3135,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)
@@ -3226,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);
     }
@@ -3250,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}`;
@@ -3272,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;
 }
@@ -3401,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) {
@@ -3526,6 +3688,9 @@ export {
   ROKU_LIVENESS_INTERVAL_MS,
   PLATFORM_DEVICE,
   dev,
+  formatDevicesHuman,
+  filterDeviceModels,
+  formatDeviceModelsHuman,
   AGENT_COMMANDS,
   renderEnvelope,
   buildToolCall,

package/dist/{chunk-UGCGJ6IN.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}`);
   }

package/dist/cli.js

@@ -7,6 +7,9 @@ import {
   createRokuPush,
   dev,
   fetchFinalSummary,
+  filterDeviceModels,
+  formatDeviceModelsHuman,
+  formatDevicesHuman,
   formatDuration,
   killOwnedMetro,
   loadDevConfig,
@@ -16,7 +19,7 @@ import {
   readDevState,
   readMetroState,
   runAgentVerb
-} from "./chunk-SHS5PCSS.js";
+} from "./chunk-E2LZSLRF.js";
 import {
   ApiClient,
   EXIT_INFRA_ERROR,
@@ -29,7 +32,7 @@ import {
   resolveAuth,
   saveConfig,
   uploadApp
-} from "./chunk-UGCGJ6IN.js";
+} from "./chunk-PSFXVUHG.js";
 
 // src/cli.ts
 import { createRequire } from "module";
@@ -1998,17 +2001,17 @@ function formatEnvVarsHuman(variables) {
   if (variables.length === 0) {
     return "No build variables found.\n";
   }
-  const HEADERS4 = ["NAME", "VISIBILITY", "SCOPE", "HINT"];
+  const HEADERS3 = ["NAME", "VISIBILITY", "SCOPE", "HINT"];
   const rows = variables.map((v) => [
     v.name,
     v.is_file ? `${v.visibility} (file)` : v.visibility,
     v.app_public_id ?? "org-wide",
     v.value_hint ?? ""
   ]);
-  const widths = HEADERS4.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join3 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk16.bold(join3(padCells(HEADERS4)))];
+  const lines = [chalk16.bold(join3(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join3(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -2545,12 +2548,12 @@ function formatAscKeysHuman(keys) {
   if (keys.length === 0) {
     return "No App Store Connect keys found.\n";
   }
-  const HEADERS4 = ["NAME", "KEY ID", "ISSUER ID", "CREATED"];
+  const HEADERS3 = ["NAME", "KEY ID", "ISSUER ID", "CREATED"];
   const rows = keys.map((k) => [k.name, k.key_id, k.issuer_id, k.created_at ?? ""]);
-  const widths = HEADERS4.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join3 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk17.bold(join3(padCells(HEADERS4)))];
+  const lines = [chalk17.bold(join3(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join3(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -2621,12 +2624,12 @@ function formatPlayKeysHuman(keys) {
   if (keys.length === 0) {
     return "No Google Play keys found.\n";
   }
-  const HEADERS4 = ["NAME", "CLIENT EMAIL", "CREATED"];
+  const HEADERS3 = ["NAME", "CLIENT EMAIL", "CREATED"];
   const rows = keys.map((k) => [k.name, k.client_email, k.created_at ?? ""]);
-  const widths = HEADERS4.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join3 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk17.bold(join3(padCells(HEADERS4)))];
+  const lines = [chalk17.bold(join3(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join3(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -2695,7 +2698,7 @@ function formatCredentialsHuman(credentials2) {
   if (credentials2.length === 0) {
     return "No signing credentials found.\n";
   }
-  const HEADERS4 = ["NAME", "PLATFORM", "SCOPE", "IDENTITY", "EXPIRES"];
+  const HEADERS3 = ["NAME", "PLATFORM", "SCOPE", "IDENTITY", "EXPIRES"];
   const rows = credentials2.map((c) => [
     c.name,
     c.platform,
@@ -2703,10 +2706,10 @@ function formatCredentialsHuman(credentials2) {
     formatIdentity(c),
     formatExpires(c)
   ]);
-  const widths = HEADERS4.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join3 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk17.bold(join3(padCells(HEADERS4)))];
+  const lines = [chalk17.bold(join3(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join3(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -2814,7 +2817,7 @@ function formatWebhooksHuman(webhooks2) {
   if (webhooks2.length === 0) {
     return "No webhooks found.\n";
   }
-  const HEADERS4 = ["ID", "URL", "ACTIVE", "LAST DELIVERY", "CREATED"];
+  const HEADERS3 = ["ID", "URL", "ACTIVE", "LAST DELIVERY", "CREATED"];
   const rows = webhooks2.map((w) => [
     w.id,
     w.url,
@@ -2822,10 +2825,10 @@ function formatWebhooksHuman(webhooks2) {
     formatLastDelivery(w.last_delivery),
     w.created_at
   ]);
-  const widths = HEADERS4.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
+  const widths = HEADERS3.map((h, i) => Math.max(h.length, ...rows.map((r) => r[i].length)));
   const padCells = (cells) => cells.map((c, i) => c.padEnd(widths[i]));
   const join3 = (cells) => cells.join("  ").trimEnd();
-  const lines = [chalk18.bold(join3(padCells(HEADERS4)))];
+  const lines = [chalk18.bold(join3(padCells(HEADERS3)))];
   for (const row of rows) lines.push(join3(padCells(row)));
   return lines.join("\n") + "\n";
 }
@@ -2915,38 +2918,26 @@ function printError6(opts, err) {
   console.error(chalk18.red(`error: ${message}`));
 }
 
-// src/lib/formatters/devices.ts
-import chalk19 from "chalk";
-var HEADERS3 = ["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 = HEADERS3.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 = [chalk19.bold(fmt(HEADERS3))];
-  for (const row of rows.sort(rowSort)) {
-    const statusColored = row[5] === "available" ? chalk19.green(row[5]) : row[5] === "busy" ? chalk19.yellow(row[5]) : chalk19.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]);
-}
-
 // src/commands/list-devices.ts
 async function listDevicesCommand(options) {
   const { token, baseUrl } = resolveAuth(options);
   const client = new ApiClient(baseUrl, token);
+  if (options.models) {
+    try {
+      const models = filterDeviceModels(await client.listDeviceModels(), options);
+      if (options.output === "json") {
+        process.stdout.write(JSON.stringify(models, null, 2) + "\n");
+      } else {
+        process.stdout.write(formatDeviceModelsHuman(models));
+      }
+      process.exit(EXIT_PASS);
+    } catch (err) {
+      process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(EXIT_INFRA_ERROR);
+    }
+    return;
+  }
   try {
     const devices = await client.listDevices({
       type: options.type,
@@ -3024,7 +3015,7 @@ import { dirname, join as join2 } from "path";
 import { fileURLToPath } from "url";
 import { spawnSync } from "child_process";
 import { confirm } from "@inquirer/prompts";
-import chalk20 from "chalk";
+import chalk19 from "chalk";
 function resolveShippedSkillPath(fromDir) {
   for (const rel of ["..", join2("..", "..")]) {
     const candidate = join2(fromDir, rel, "skills", "vibeview-agent", "SKILL.md");
@@ -3052,23 +3043,23 @@ function registerMcp() {
     encoding: "utf8"
   });
   if (res.status === 0) {
-    console.log(chalk20.green("\u2713 MCP server registered with Claude Code (claude mcp add vibeview)"));
+    console.log(chalk19.green("\u2713 MCP server registered with Claude Code (claude mcp add vibeview)"));
     return;
   }
   const out = `${res.stderr ?? ""}${res.stdout ?? ""}`;
   if (out.includes("already exists")) {
-    console.log(chalk20.dim("MCP server already registered with Claude Code \u2014 nothing to do"));
+    console.log(chalk19.dim("MCP server already registered with Claude Code \u2014 nothing to do"));
     return;
   }
-  console.error(chalk20.yellow(`\u26A0 could not register the MCP server: ${out.trim() || res.error}`));
-  console.error(chalk20.yellow("  register it manually: claude mcp add vibeview -- vibeview mcp"));
+  console.error(chalk19.yellow(`\u26A0 could not register the MCP server: ${out.trim() || res.error}`));
+  console.error(chalk19.yellow("  register it manually: claude mcp add vibeview -- vibeview mcp"));
 }
 async function agentSetup(opts) {
   const moduleDir = dirname(fileURLToPath(import.meta.url));
   const shipped = resolveShippedSkillPath(moduleDir);
   if (!shipped) {
     console.error(
-      chalk20.red(
+      chalk19.red(
         "error: could not find the packaged skill (skills/vibeview-agent/SKILL.md) \u2014 is this a complete install of the vibeview package?"
       )
     );
@@ -3077,9 +3068,9 @@ async function agentSetup(opts) {
   }
   const targetDir = skillInstallDir(opts.project ?? false, process.cwd(), homedir());
   const result = installSkill(shipped, targetDir);
-  console.log(chalk20.green(`\u2713 vibeview-agent skill ${result}: ${join2(targetDir, "SKILL.md")}`));
+  console.log(chalk19.green(`\u2713 vibeview-agent skill ${result}: ${join2(targetDir, "SKILL.md")}`));
   console.log(
-    chalk20.dim(
+    chalk19.dim(
       opts.project ? "  Claude Code discovers it automatically for anyone working in this project." : "  Claude Code discovers it automatically in every project on this machine."
     )
   );
@@ -3087,7 +3078,7 @@ async function agentSetup(opts) {
     if (!claudeCliAvailable()) {
       if (opts.mcp === true) {
         console.error(
-          chalk20.yellow(
+          chalk19.yellow(
             "\u26A0 claude CLI not found \u2014 install Claude Code, then run: claude mcp add vibeview -- vibeview mcp"
           )
         );
@@ -3101,7 +3092,7 @@ async function agentSetup(opts) {
   }
   console.log(
     `
-Suggested line for your project's ${chalk20.bold("CLAUDE.md")} (or ${chalk20.bold(
+Suggested line for your project's ${chalk19.bold("CLAUDE.md")} (or ${chalk19.bold(
       "AGENTS.md"
     )} for other agents):
 `
@@ -3109,7 +3100,7 @@ Suggested line for your project's ${chalk20.bold("CLAUDE.md")} (or ${chalk20.bol
   console.log(`  ${CLAUDE_MD_SUGGESTION}
 `);
   console.log(
-    chalk20.dim(
+    chalk19.dim(
       "Other agents (Cursor, Copilot, Codex, ...): install the same skill from GitHub with\n  npx skills add vibeview/skills\nor point them at the skill file above, or add the MCP server per client \u2014\nsee https://vibeview.io/docs/agent-control"
     )
   );
@@ -3231,7 +3222,11 @@ program.command("list-suites").description("List available test suites").option(
   []
 ).option("--match <mode>", "When multiple --tag flags: any (default) or all", "any").action((opts) => listSuites(opts));
 program.command("list-apps").description("List apps in your organization").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").action((opts) => listApps(opts));
-program.command("list-devices").description("List devices registered with the platform (filterable by type and category)").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--type <type>", "Filter by device type: ios, android, roku").option("--category <category>", "Filter by category: phone, tablet, tv").option("--status <status>", "Filter by status: available, busy, offline").action((opts) => listDevicesCommand(opts));
+program.command("list-devices").description("List devices registered with the platform (filterable by type and category)").option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--type <type>", "Filter by device type: ios, android, roku").option("--category <category>", "Filter by category: phone, tablet, tv").option("--status <status>", "Filter by status: available, busy, offline").option(
+  "--models",
+  "List the device models you can start instead (the names `dev --model` takes)",
+  false
+).action((opts) => listDevicesCommand(opts));
 program.command("upload-app <file>").description(
   "Upload an app build (zipped simulator .app for iOS/tvOS, .apk for Android/Android TV, or a Roku channel .zip)"
 ).option("--token <token>", "API token").option("--output <format>", "Output format: human, json", "human").option("--name <name>", "App name (auto-detected if not provided)").action((file, opts) => uploadApp(file, opts));
@@ -3247,6 +3242,9 @@ program.command("dev").description(
   "--device-category <category>",
   "phone or tablet (default: phone; TV platforms always use tv)",
   parseDeviceCategory
+).option(
+  "--model <name>",
+  'Run on this exact device model, e.g. "iPhone Duo" (see `vibeview list-devices --models`)'
 ).option("--no-open", "Do not open the browser automatically").option("--debug", "Log raw tunnel lifecycle events (close codes, reconnects) for diagnostics").option("--json", "Emit line-delimited JSON events on stdout instead of human output", false).option(
   "--detach",
   "Run the dev session in the background; prints session info and exits (see `dev-status`, `dev-stop`, and `dev-reload` for Roku)",
@@ -3395,7 +3393,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-6IJ44HAX.js");
+  const { runMcpServer } = await import("./server-XMSBLIWY.js");
   await runMcpServer(opts);
 });
 program.command("agent-setup").description(

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

@@ -9,16 +9,18 @@ import {
   checkMetro,
   createRokuPush,
   decodeScreenshotResult,
+  filterDeviceModels,
+  formatDeviceModelsHuman,
   isDevPlatform,
   loadDevConfig,
   readDevState,
   renderEnvelope,
   startDevSession
-} from "./chunk-SHS5PCSS.js";
+} from "./chunk-E2LZSLRF.js";
 import {
   ApiClient,
   resolveAuth
-} from "./chunk-UGCGJ6IN.js";
+} from "./chunk-PSFXVUHG.js";
 
 // src/mcp/server.ts
 import { writeFileSync } from "fs";
@@ -78,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.",
@@ -118,7 +137,8 @@ function buildToolDefinitions() {
     DEV_START_DEF,
     DEV_STOP_DEF,
     DEV_RELOAD_DEF,
-    UPLOAD_APP_DEF
+    UPLOAD_APP_DEF,
+    LIST_DEVICE_MODELS_DEF
   ];
 }
 function textResult(text, structuredContent, isError = false) {
@@ -143,6 +163,9 @@ async function handleToolCall(toolName, 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}`);
@@ -226,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}
@@ -235,6 +259,18 @@ ${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 {
@@ -265,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-LJH3PETS.js");
+    const { uploadAppBuild } = await import("./upload-app-ZAKAOJKE.js");
     const { result: result2 } = await uploadAppBuild(f, { ...deps.auth, name: n });
     return result2;
   });
@@ -348,6 +384,8 @@ 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
       });

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibeview",
-  "version": "0.22.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,24 @@ 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:
@@ -220,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. |
@@ -229,7 +249,8 @@ 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). |
@@ -244,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