vibeview 0.27.1 → 0.28.0

package/dist/{chunk-7IOGMM5W.js → chunk-OKOAWGWV.js}

@@ -8,10 +8,12 @@ import {
   errorExitCode,
   formatUtcTimestamp,
   loadConfig,
+  prepareUploadArtifact,
   queueReasonCopy,
+  resolveArtifact,
   resolveAuth,
   uploadAppBuild
-} from "./chunk-FTTWLCTE.js";
+} from "./chunk-2JLTC67A.js";
 
 // src/lib/dev-config.ts
 import { readFileSync, writeFileSync } from "fs";
@@ -166,6 +168,30 @@ function validateBuildEnv(env, platformKey) {
 function saveDevConfig(cwd, cfg) {
   writeFileSync(join(cwd, FILE), JSON.stringify(cfg, null, 2) + "\n");
 }
+function describeConfigChanges(before, after) {
+  const flat = (value, prefix, out) => {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+      for (const [k, v] of Object.entries(value)) {
+        flat(v, prefix ? `${prefix}.${k}` : k, out);
+      }
+    } else if (value !== void 0) {
+      out.set(prefix, typeof value === "string" ? value : JSON.stringify(value));
+    }
+    return out;
+  };
+  const a = flat(before, "", /* @__PURE__ */ new Map());
+  const b = flat(after, "", /* @__PURE__ */ new Map());
+  const changes = [];
+  for (const [key, next] of b) {
+    const prev = a.get(key);
+    if (prev === void 0) changes.push(`${key} (added) ${next}`);
+    else if (prev !== next) changes.push(`${key} ${prev} \u2192 ${next}`);
+  }
+  for (const [key, prev] of a) {
+    if (!b.has(key)) changes.push(`${key} (removed, was ${prev})`);
+  }
+  return changes;
+}
 function resolveMetro(cfg, platform, portFlag) {
   const entry = cfg?.platforms?.[platform];
   return {
@@ -223,7 +249,7 @@ function buildKind(isDebug) {
   if (isDebug === false) return "release";
   return "unknown";
 }
-function checkDevBuild(app, buildId, platform) {
+function checkDevBuild(app, buildId, platform, opts = {}) {
   if (platform === "roku") {
     throw new Error(
       "a build id cannot be pinned on roku \u2014 `vibeview dev` packages and sideloads the channel itself"
@@ -240,7 +266,7 @@ function checkDevBuild(app, buildId, platform) {
       `build ${buildId} is not a build of app ${app.public_id} \u2014 see \`vibeview list-builds ${app.public_id}\``
     );
   }
-  if (build.is_debug !== true) {
+  if (!opts.standalone && build.is_debug !== true) {
     const why = build.is_debug === false ? "it runs standalone (a release build, or one with an embedded JS bundle)" : "it could not be identified as a Metro debug build";
     throw new Error(
       `build ${buildId} is not a debug build \u2014 ${why}. \`vibeview dev\` needs ${platformWithArticle(platform)} debug simulator/emulator build without an embedded JS bundle (see \`vibeview list-builds ${app.public_id}\`)`
@@ -383,81 +409,24 @@ import { createInterface } from "readline";
 import { select as select2 } from "@inquirer/prompts";
 import chalk3 from "chalk";
 
-// src/lib/artifact.ts
-import { existsSync as existsSync2, mkdtempSync, readdirSync, rmSync as rmSync2, statSync } from "fs";
-import { spawnSync } from "child_process";
-import { tmpdir } from "os";
-import { basename, dirname as dirname2, isAbsolute, join as join3 } from "path";
-function resolveArtifact(cwd, pattern) {
-  const abs = isAbsolute(pattern) ? pattern : join3(cwd, pattern);
-  if (!basename(abs).includes("*")) {
-    if (!existsSync2(abs)) {
-      throw new Error(
-        `artifact not found: ${pattern} (looked at ${abs}) \u2014 did the build produce it?`
-      );
-    }
-    return abs;
-  }
-  const dir = dirname2(abs);
-  const re = new RegExp("^" + basename(abs).split("*").map(escapeRegExp).join(".*") + "$");
-  let entries;
-  try {
-    entries = readdirSync(dir);
-  } catch {
-    throw new Error(`artifact not found: ${pattern} (directory ${dir} does not exist)`);
-  }
-  const matches = entries.filter((e) => re.test(e)).map((e) => join3(dir, e)).sort((a, b) => statSync(b).mtimeMs - statSync(a).mtimeMs);
-  if (matches.length === 0) {
-    throw new Error(`artifact not found: no match for ${pattern} in ${dir}`);
-  }
-  return matches[0];
-}
-function escapeRegExp(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-function prepareUploadArtifact(path) {
-  if (!(statSync(path).isDirectory() && path.endsWith(".app"))) {
-    return { uploadPath: path, cleanup: () => {
-    } };
-  }
-  const tmp = mkdtempSync(join3(tmpdir(), "vibeview-zip-"));
-  const out = join3(tmp, `${basename(path)}.zip`);
-  const res = spawnSync("zip", ["-qry", out, basename(path)], { cwd: dirname2(path) });
-  if (res.error) {
-    rmSync2(tmp, { recursive: true, force: true });
-    const errorCode = res.error.code;
-    const errorMsg = res.error.message;
-    throw new Error(
-      `failed to zip ${path}: spawn zip ${errorCode} \u2014 ${errorMsg} \u2014 is the \`zip\` command installed?`
-    );
-  }
-  if (res.status !== 0) {
-    rmSync2(tmp, { recursive: true, force: true });
-    throw new Error(
-      `failed to zip ${path}: ${res.stderr?.toString().trim() || `zip exited ${res.status}`}`
-    );
-  }
-  return { uploadPath: out, cleanup: () => rmSync2(tmp, { recursive: true, force: true }) };
-}
-
 // src/lib/dev-setup.ts
 import chalk2 from "chalk";
 import { input, select } from "@inquirer/prompts";
 
 // src/lib/project-detect.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync2, readFileSync as readFileSync3, readdirSync, statSync } from "fs";
+import { join as join3 } from "path";
 import ignore from "ignore";
 function readJson(cwd, name) {
   try {
-    return JSON.parse(readFileSync3(join4(cwd, name), "utf-8"));
+    return JSON.parse(readFileSync3(join3(cwd, name), "utf-8"));
   } catch {
     return null;
   }
 }
 function isFile(path) {
   try {
-    return statSync2(path).isFile();
+    return statSync(path).isFile();
   } catch {
     return false;
   }
@@ -465,19 +434,19 @@ function isFile(path) {
 function detectFlavor(cwd) {
   let deps = {};
   try {
-    const pkg = JSON.parse(readFileSync3(join4(cwd, "package.json"), "utf-8"));
+    const pkg = JSON.parse(readFileSync3(join3(cwd, "package.json"), "utf-8"));
     deps = { ...pkg.dependencies, ...pkg.devDependencies };
   } catch {
   }
   if ("expo" in deps) return "expo";
-  if (existsSync3(join4(cwd, "android", "gradlew")) || iosWorkspaceName(cwd)) return "bare-rn";
-  if (isFile(join4(cwd, "manifest"))) return "roku";
+  if (existsSync2(join3(cwd, "android", "gradlew")) || iosWorkspaceName(cwd)) return "bare-rn";
+  if (isFile(join3(cwd, "manifest"))) return "roku";
   return "unknown";
 }
 function nativeDirShipped(cwd, dir) {
-  if (!existsSync3(join4(cwd, dir))) return false;
+  if (!existsSync2(join3(cwd, dir))) return false;
   try {
-    const ig = ignore().add(readFileSync3(join4(cwd, ".gitignore"), "utf-8"));
+    const ig = ignore().add(readFileSync3(join3(cwd, ".gitignore"), "utf-8"));
     return !ig.ignores(`${dir}/`);
   } catch {
     return true;
@@ -493,7 +462,7 @@ function isManagedExpo(cwd, platform) {
 }
 function iosWorkspaceName(cwd) {
   try {
-    const found = readdirSync2(join4(cwd, "ios")).find((f) => f.endsWith(".xcworkspace"));
+    const found = readdirSync(join3(cwd, "ios")).find((f) => f.endsWith(".xcworkspace"));
     return found ? found.replace(/\.xcworkspace$/, "") : null;
   } catch {
     return null;
@@ -502,9 +471,9 @@ function iosWorkspaceName(cwd) {
 var IOS_ARTIFACT = "ios/build/Build/Products/Debug-iphonesimulator/*.app";
 var ANDROID_ARTIFACT = "android/app/build/outputs/apk/debug/*.apk";
 function installCommand(cwd) {
-  if (existsSync3(join4(cwd, "yarn.lock"))) return "yarn install --immutable";
-  if (existsSync3(join4(cwd, "pnpm-lock.yaml"))) return "pnpm install --frozen-lockfile";
-  if (existsSync3(join4(cwd, "package-lock.json"))) return "npm ci";
+  if (existsSync2(join3(cwd, "yarn.lock"))) return "yarn install --immutable";
+  if (existsSync2(join3(cwd, "pnpm-lock.yaml"))) return "pnpm install --frozen-lockfile";
+  if (existsSync2(join3(cwd, "package-lock.json"))) return "npm ci";
   return "yarn install --immutable";
 }
 function managedExpoAndroidCommand(cwd) {
@@ -518,7 +487,7 @@ var ROKU_ZIP_COMMAND = "zip -r out/channel.zip manifest source components images
 function rokuDefaults(cwd) {
   const pkg = readJson(cwd, "package.json");
   const scripts = pkg?.scripts ?? {};
-  const runner = existsSync3(join4(cwd, "yarn.lock")) ? "yarn" : "npm run";
+  const runner = existsSync2(join3(cwd, "yarn.lock")) ? "yarn" : "npm run";
   const packageScript = Object.entries(scripts).find(
     ([name, body]) => !name.startsWith("deploy") && (name.startsWith("package") || body.includes("--package-only") || body.includes("zipPackage"))
   );
@@ -576,7 +545,7 @@ function expoSanitizedName(name) {
   return name.replace(/[\W_]+/g, "").normalize("NFD").replace(/[\u0300-\u036f]/g, "");
 }
 function managedExpoIosName(cwd) {
-  if (existsSync3(join4(cwd, "app.config.js")) || existsSync3(join4(cwd, "app.config.ts"))) {
+  if (existsSync2(join3(cwd, "app.config.js")) || existsSync2(join3(cwd, "app.config.ts"))) {
     return null;
   }
   const raw = readJson(cwd, "app.config.json") ?? readJson(cwd, "app.json");
@@ -721,9 +690,9 @@ async function promptMetroCommand(cwd, platform) {
 
 // src/lib/source-pack.ts
 import { execFile, spawn } from "child_process";
-import { lstatSync, mkdtempSync as mkdtempSync2, readFileSync as readFileSync4, rmSync as rmSync3, statSync as statSync3, writeFileSync as writeFileSync3 } from "fs";
-import { tmpdir as tmpdir2 } from "os";
-import { join as join5 } from "path";
+import { lstatSync, mkdtempSync, readFileSync as readFileSync4, rmSync as rmSync2, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { tmpdir } from "os";
+import { join as join4 } from "path";
 import ignore2 from "ignore";
 var NotAGitRepoError = class extends Error {
   constructor(message) {
@@ -749,7 +718,7 @@ async function listSourceFiles(projectRoot) {
   const stdout = await runGitLsFiles(projectRoot);
   const rawPaths = stdout.length ? stdout.split("\0").filter((p) => p.length > 0) : [];
   let filtered = rawPaths;
-  const vvignorePath = join5(projectRoot, ".vvignore");
+  const vvignorePath = join4(projectRoot, ".vvignore");
   if (statOrNull(vvignorePath)?.isFile()) {
     const ig = ignore2().add(readFileSync4(vvignorePath, "utf-8"));
     filtered = filtered.filter((p) => !ig.ignores(p));
@@ -757,7 +726,7 @@ async function listSourceFiles(projectRoot) {
   const result = [];
   for (const relPath of filtered) {
     if (isForceExcluded(relPath)) continue;
-    const st = statOrNull(join5(projectRoot, relPath));
+    const st = statOrNull(join4(projectRoot, relPath));
     if (!st) continue;
     result.push(relPath);
   }
@@ -807,7 +776,7 @@ async function packSource(projectRoot, files, opts = {}) {
   let totalBytes = 0;
   const sized = [];
   for (const relPath of files) {
-    const bytes = lstatSync(join5(projectRoot, relPath)).size;
+    const bytes = lstatSync(join4(projectRoot, relPath)).size;
     totalBytes += bytes;
     sized.push({ path: relPath, bytes });
   }
@@ -818,13 +787,13 @@ async function packSource(projectRoot, files, opts = {}) {
       largest
     );
   }
-  const tmpDir = mkdtempSync2(join5(tmpdir2(), "vibeview-source-pack-"));
-  const cleanup = () => rmSync3(tmpDir, { recursive: true, force: true });
+  const tmpDir = mkdtempSync(join4(tmpdir(), "vibeview-source-pack-"));
+  const cleanup = () => rmSync2(tmpDir, { recursive: true, force: true });
   try {
     const supportsNull = await probeTarNullSupport();
-    const tarPath = join5(tmpDir, "source.tgz");
+    const tarPath = join4(tmpDir, "source.tgz");
     if (supportsNull) {
-      const listPath = join5(tmpDir, "files.list");
+      const listPath = join4(tmpDir, "files.list");
       writeFileSync3(listPath, files.map((f) => `${f}\0`).join(""));
       await runTar(["-czf", tarPath, "-C", projectRoot, "--null", "-T", listPath]);
     } else {
@@ -834,12 +803,12 @@ async function packSource(projectRoot, files, opts = {}) {
           `cannot pack source: filename contains a newline (${JSON.stringify(badName)}) and the installed tar doesn't support --null -T; rename the file or install a tar that supports --null`
         );
       }
-      const listPath = join5(tmpDir, "files.list");
+      const listPath = join4(tmpDir, "files.list");
       writeFileSync3(listPath, files.map((f) => `${f}
 `).join(""));
       await runTar(["-czf", tarPath, "-C", projectRoot, "-T", listPath]);
     }
-    const sizeBytes = statSync3(tarPath).size;
+    const sizeBytes = statSync2(tarPath).size;
     return { tarPath, sizeBytes, cleanup };
   } catch (err) {
     cleanup();
@@ -855,12 +824,12 @@ var nullSupportCache = null;
 function probeTarNullSupport() {
   if (!nullSupportCache) {
     nullSupportCache = new Promise((resolve) => {
-      const tmp = mkdtempSync2(join5(tmpdir2(), "vibeview-tar-probe-"));
-      const listPath = join5(tmp, "empty.list");
+      const tmp = mkdtempSync(join4(tmpdir(), "vibeview-tar-probe-"));
+      const listPath = join4(tmp, "empty.list");
       writeFileSync3(listPath, "");
-      const out = join5(tmp, "probe.tgz");
+      const out = join4(tmp, "probe.tgz");
       execFile("tar", ["-czf", out, "-C", tmp, "--null", "-T", listPath], (err) => {
-        rmSync3(tmp, { recursive: true, force: true });
+        rmSync2(tmp, { recursive: true, force: true });
         resolve(!err);
       });
     });
@@ -1543,7 +1512,9 @@ async function waitForCloudBuilds(builds, opts, deps) {
         id: final.id,
         status: final.status,
         cost_micro: final.cost_micro,
-        error_summary: final.error_summary
+        error_summary: final.error_summary,
+        app_build_id: final.app_build_id ?? null,
+        app_public_id: final.app_public_id ?? null
       });
       finalized.add(build.id);
     }
@@ -1731,7 +1702,7 @@ your build command must produce a zip \u2014 use the package/zip step, not deplo
 // src/commands/dev.ts
 import { spawn as spawn4 } from "child_process";
 import { createWriteStream, mkdirSync as mkdirSync3 } from "fs";
-import { dirname as dirname5 } from "path";
+import { dirname as dirname4 } from "path";
 import { createInterface as createInterface3 } from "readline";
 import { select as select3 } from "@inquirer/prompts";
 import chalk4 from "chalk";
@@ -1926,15 +1897,15 @@ import { spawn as spawn3 } from "child_process";
 import { createInterface as createInterface2 } from "readline";
 
 // src/lib/metro-state.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync5, rmSync as rmSync4, writeFileSync as writeFileSync4 } from "fs";
-import { dirname as dirname3, join as join6 } from "path";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync5, rmSync as rmSync3, writeFileSync as writeFileSync4 } from "fs";
+import { dirname as dirname2, join as join5 } from "path";
 var STATE_DIR2 = ".vibeview";
 var STATE_FILE2 = "metro-state.json";
 function statePath2(cwd) {
-  return join6(cwd, STATE_DIR2, STATE_FILE2);
+  return join5(cwd, STATE_DIR2, STATE_FILE2);
 }
 function metroLogPath(cwd) {
-  return join6(cwd, STATE_DIR2, "metro.log");
+  return join5(cwd, STATE_DIR2, "metro.log");
 }
 function isPidAlive2(pid) {
   try {
@@ -1946,7 +1917,7 @@ function isPidAlive2(pid) {
 }
 function writeMetroState(cwd, state) {
   const path = statePath2(cwd);
-  mkdirSync2(dirname3(path), { recursive: true });
+  mkdirSync2(dirname2(path), { recursive: true });
   writeFileSync4(path, JSON.stringify(state, null, 2) + "\n");
 }
 function readMetroState(cwd) {
@@ -1964,7 +1935,7 @@ function readMetroState(cwd) {
 }
 function clearMetroState(cwd) {
   const path = statePath2(cwd);
-  if (existsSync4(path)) rmSync4(path, { force: true });
+  if (existsSync3(path)) rmSync3(path, { force: true });
 }
 function killOwnedMetro(cwd) {
   const state = readMetroState(cwd);
@@ -2072,7 +2043,7 @@ async function waitFor(cond, timeoutMs, everyMs) {
 
 // src/lib/reload-loop.ts
 import { watch } from "fs";
-import { basename as basename2, dirname as dirname4 } from "path";
+import { basename, dirname as dirname3 } from "path";
 function createReloadLoop(deps) {
   let inFlight = null;
   let pendingFollowUp = false;
@@ -2153,16 +2124,16 @@ function isIgnoredWatchPath(relPath, artifact, userIgnore = []) {
   if (IGNORED_FILES.includes(rel)) return true;
   if (userIgnore.some((entry) => isUnderPath(rel, entry))) return true;
   const artifactPattern = artifact.replace(/\\/g, "/").replace(/^\.\//, "");
-  const artifactDir = dirname4(artifactPattern);
+  const artifactDir = dirname3(artifactPattern);
   if (artifactDir !== "." && (rel === artifactDir || rel.startsWith(`${artifactDir}/`))) {
     return true;
   }
-  if (dirname4(rel) !== artifactDir) return false;
-  const name = basename2(artifactPattern);
-  const re = new RegExp(`^${name.split("*").map(escapeRegExp2).join(".*")}$`);
-  return re.test(basename2(rel));
+  if (dirname3(rel) !== artifactDir) return false;
+  const name = basename(artifactPattern);
+  const re = new RegExp(`^${name.split("*").map(escapeRegExp).join(".*")}$`);
+  return re.test(basename(rel));
 }
-function escapeRegExp2(s) {
+function escapeRegExp(s) {
   return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function watchProjectFiles(cwd, artifact, userIgnore = []) {
@@ -2198,7 +2169,7 @@ function emit(json, evt) {
 async function startDevSession(cfg, onEvent = () => {
 }, onTunnelState) {
   const api = new ApiClient(cfg.baseUrl, cfg.token);
-  const usesTunnel = PLATFORM_NEEDS_METRO[cfg.platform];
+  const usesTunnel = PLATFORM_NEEDS_METRO[cfg.platform] && !cfg.standalone;
   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)
@@ -2286,7 +2257,7 @@ async function startDevSession(cfg, onEvent = () => {
       reportedWarnings.add(w);
       onEvent({ event: "warning", message: w });
     }
-    return { sessionId, pageUrl, stop: () => stopSession(0), reportedWarnings };
+    return { sessionId, pageUrl, stop: () => stopSession(0), reportedWarnings, session: active };
   } catch (err) {
     await stopSession(1);
     throw err;
@@ -2297,8 +2268,9 @@ function devSessionCreateBody(cfg) {
     device_type: PLATFORM_DEVICE[cfg.platform].deviceType,
     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],
+    // Roku has no JS bundle to serve, so there is nothing to tunnel; a
+    // standalone session runs the build as it is, without Metro.
+    tunnel: PLATFORM_NEEDS_METRO[cfg.platform] && !cfg.standalone,
     ...cfg.model ? { model: cfg.model } : {},
     ...cfg.buildId ? { build_id: cfg.buildId } : {}
   };
@@ -2312,10 +2284,36 @@ function resolveDeviceModel(pools, platform, model) {
   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();
+  const guess = closestModelName(wanted, names);
   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`
+    names.length ? `no ${platform} device model named "${model}"` + (guess ? ` (did you mean "${guess}"?)` : "") + ` \u2014 available: ${names.join(", ")} (see \`vibeview list-devices --models\`)` : `no ${platform} devices are available right now`
   );
 }
+function closestModelName(wanted, names) {
+  const squash = (s) => s.toLowerCase().replace(/[^a-z0-9]/g, "");
+  const words = (s) => new Set(s.toLowerCase().match(/[a-z0-9]+/g) ?? []);
+  const w = squash(wanted);
+  if (!w) return null;
+  const unique = (list) => list.length === 1 ? list[0] : null;
+  const same = names.filter((n) => squash(n) === w);
+  if (same.length) return unique(same);
+  const containing = names.filter((n) => squash(n).includes(w) || w.includes(squash(n)));
+  if (containing.length) return unique(containing);
+  const wantedWords = words(wanted);
+  let best = 0;
+  let bestNames = [];
+  for (const n of names) {
+    let shared = 0;
+    for (const word of words(n)) if (wantedWords.has(word)) shared++;
+    if (shared > best) {
+      best = shared;
+      bestNames = [n];
+    } else if (shared === best && shared > 0) {
+      bestNames.push(n);
+    }
+  }
+  return best >= 2 ? unique(bestNames) : null;
+}
 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)));
@@ -2607,6 +2605,12 @@ ${hint}`);
   });
   const commitConfig = () => {
     saveDevConfig(process.cwd(), cfg);
+    if (existing) {
+      const changes = describeConfigChanges(existing, cfg);
+      if (changes.length) {
+        console.error(chalk4.dim(`Updated vibeview.json: ${changes.join(", ")}`));
+      }
+    }
     if (isFirstRun) {
       console.error(chalk4.dim(`Created vibeview.json (platform: ${platform}, app: ${appId}).`));
       const hint = fillLaterHint(
@@ -2726,7 +2730,7 @@ async function runDevInProcess(opts) {
       const captureMetroLine = (line) => {
         try {
           if (!metroLogStream) {
-            mkdirSync3(dirname5(metroLogPath(process.cwd())), { recursive: true });
+            mkdirSync3(dirname4(metroLogPath(process.cwd())), { recursive: true });
             metroLogStream = createWriteStream(metroLogPath(process.cwd()), { flags: "w" });
           }
           metroLogStream.write(line.replace(/^\[metro\] /, "") + "\n");
@@ -3078,20 +3082,34 @@ function filterDeviceModels(models, opts) {
     os_version: m.os_version,
     device_type: m.device_type,
     category: m.category,
-    form_factor: m.form_factor ?? null
+    form_factor: m.form_factor ?? null,
+    // MCP only: an agent has no other way to see whether a model is free.
+    ...opts.availability && typeof m.free === "number" && typeof m.total === "number" ? { free: m.free, total: m.total } : {}
   }));
 }
 var MODEL_HEADERS = ["MODEL", "OS", "TYPE", "CATEGORY", "FORM FACTOR"];
-function formatDeviceModelsHuman(models) {
+function formatDeviceModelsHuman(models, opts = {}) {
   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(
+  const headers = [...MODEL_HEADERS, ...opts.availability ? ["FREE", "BUSY"] : []];
+  const rows = models.map((m) => [
+    m.model,
+    m.os_version,
+    m.device_type,
+    m.category,
+    m.form_factor ?? "-",
+    ...opts.availability ? availabilityCells(m) : []
+  ]).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 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();
-  return [chalk5.bold(fmt(MODEL_HEADERS)), ...rows.map(fmt)].join("\n") + "\n";
+  return [chalk5.bold(fmt(headers)), ...rows.map(fmt)].join("\n") + "\n";
+}
+function availabilityCells(m) {
+  if (typeof m.free !== "number" || typeof m.total !== "number") return ["?", "?"];
+  return [String(m.free), String(Math.max(0, m.total - m.free))];
 }
 
 // src/agent/registry.ts