@vosjs/cli 0.87.0 → 0.88.0

package/dist/{chunk-ACWV3Y6Y.js → chunk-BHWDA2KG.js}

@@ -165,9 +165,9 @@ function landedLines(l) {
 }
 
 // src/plugin/run.ts
-import { mkdir as mkdir13, readFile as readFile19, rm as rm7 } from "fs/promises";
-import { existsSync as existsSync31 } from "fs";
-import { dirname as dirname12, join as join33, resolve as resolve22 } from "path";
+import { mkdir as mkdir14, readFile as readFile20, rm as rm7 } from "fs/promises";
+import { existsSync as existsSync32 } from "fs";
+import { dirname as dirname12, join as join34, resolve as resolve23 } from "path";
 import {
   END_CARD_FROM as END_CARD_FROM2,
   docOutputDuration as docOutputDuration5,
@@ -6089,14 +6089,14 @@ function chromeTree(rows, pid) {
 }
 function readChromeTree(pid) {
   if (process.platform === "win32") return Promise.resolve(null);
-  return new Promise((resolve23) => {
+  return new Promise((resolve24) => {
     execFile2(
       "ps",
       ["-A", "-o", "pid=", "-o", "ppid=", "-o", "command="],
       { maxBuffer: 16 * 1024 * 1024, timeout: 5e3 },
       (err, stdout) => {
-        if (err) resolve23(null);
-        else resolve23(chromeTree(parseProcessTable(stdout), pid));
+        if (err) resolve24(null);
+        else resolve24(chromeTree(parseProcessTable(stdout), pid));
       }
     );
   });
@@ -6198,7 +6198,7 @@ function enterPressed() {
     } };
   const rl = createInterface({ input: process.stdin });
   const pressed = new Promise(
-    (resolve23) => rl.once("line", () => resolve23())
+    (resolve24) => rl.once("line", () => resolve24())
   );
   return { pressed, close: () => rl.close() };
 }
@@ -6371,14 +6371,14 @@ async function openSessionWindow(opts) {
   const child = spawn(exe, args, { stdio: "ignore" });
   let failed = null;
   let code = null;
-  const exited = new Promise((resolve23) => {
+  const exited = new Promise((resolve24) => {
     child.once("exit", (c) => {
       code = c;
-      resolve23();
+      resolve24();
     });
     child.once("error", (e) => {
       failed = e;
-      resolve23();
+      resolve24();
     });
   });
   try {
@@ -13291,8 +13291,8 @@ async function cmdActions(argv) {
     if (!m) throw new UsageError("--viewport expects WxH, e.g. 1280x720");
     viewport = { width: Number(m[1]), height: Number(m[2]) };
   }
-  const { readFile: readFile20 } = await import("fs/promises");
-  const text = await readFile20(resolve14(input), "utf8");
+  const { readFile: readFile21 } = await import("fs/promises");
+  const text = await readFile21(resolve14(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -13329,9 +13329,9 @@ function summary2(result) {
 }
 async function cmdActionsScript(input, flags) {
   const r = createReporter(flags.json === true);
-  const { readFile: readFile20 } = await import("fs/promises");
+  const { readFile: readFile21 } = await import("fs/promises");
   const { shotList, formatShotList } = await import("./shotList-PL7XP6AC.js");
-  const raw = JSON.parse(await readFile20(resolve14(input), "utf8"));
+  const raw = JSON.parse(await readFile21(resolve14(input), "utf8"));
   const errors = validateActions(raw);
   if (errors.length) throw new UsageError(`${input}:
   ${errors.join("\n  ")}`);
@@ -13606,11 +13606,169 @@ async function cmdIngest(argv) {
   return EXIT_OK;
 }
 
+// src/plugin/recordApp.ts
+import { existsSync as existsSync23 } from "fs";
+import { mkdir as mkdir9, readFile as readFile14 } from "fs/promises";
+import { join as join24, resolve as resolve16 } from "path";
+var BOOLEAN_FLAGS11 = /* @__PURE__ */ new Set(["json", "help", "windows"]);
+var USAGE2 = "vos record --app <name|bundle id> [--out take] [--seconds <n>] [--max-duration <s>] [--background <slug|url|none>] [--json]\n       vos record --window <id> \u2026   one window by its id\n       vos record --windows         list the windows that can be recorded";
+function isDesktopRecord(argv) {
+  return argv.some(
+    (a) => a === "--app" || a === "--window" || a === "--windows" || a.startsWith("--app=") || a.startsWith("--window=")
+  );
+}
+async function loadDriver() {
+  try {
+    return await import("@vosjs/driver");
+  } catch {
+    throw new Error(
+      "Recording a desktop app needs @vosjs/driver, which is not installed here. Install again without --omit=optional."
+    );
+  }
+}
+function driverFailure(error) {
+  const e = error;
+  if (e.code === "no-window")
+    return new Error(
+      "No window on screen matches. vos record --windows lists the windows that can be recorded."
+    );
+  return new Error(e.message ?? String(error));
+}
+var SCREEN_RECORDING = "Screen Recording is not granted to the app this was run from (the terminal, the editor or the agent host). Switch it on in System Settings, Privacy & Security, Screen & System Audio Recording, then start that app again.";
+function windowLine(w) {
+  const size = `${Math.round(w.frame.w)}\xD7${Math.round(w.frame.h)}`;
+  return `${String(w.id).padStart(7)}  ${w.app || "(no name)"}  ${size}${w.titled ? "" : "  (untitled: an alert or a panel)"}`;
+}
+async function cmdRecordApp(argv, deps = {}) {
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS11, MULTI_FLAGS2);
+  const r = createReporter(flags.json === true);
+  const driver = deps.driver ?? await loadDriver();
+  let granted;
+  try {
+    granted = await driver.check();
+  } catch (error) {
+    throw driverFailure(error);
+  }
+  if (!granted.screenRecording) throw new Error(SCREEN_RECORDING);
+  if (flags.windows === true) {
+    const windows = await driver.windows().catch((error) => {
+      throw driverFailure(error);
+    });
+    r.done(
+      { windows },
+      windows.length ? `${windows.map(windowLine).join("\n")}
+
+Record one: vos record --app "<name>" --out take` : "No window that can be recorded is on screen."
+    );
+    return EXIT_OK;
+  }
+  const app = strFlag(flags, "app");
+  const windowFlag = hasFlag(flags, "window") ? numFlag(flags, "window", NaN) : void 0;
+  if (windowFlag !== void 0 && !Number.isInteger(windowFlag))
+    throw new UsageError(
+      "--window expects a window id from vos record --windows"
+    );
+  if (!app && windowFlag === void 0) throw new UsageError(USAGE2);
+  const seconds = hasFlag(flags, "seconds") ? numFlag(flags, "seconds", NaN) : void 0;
+  if (seconds !== void 0 && !(seconds > 0))
+    throw new UsageError("--seconds expects a length above 0");
+  const outDir = resolve16(strFlag(flags, "out") ?? "take");
+  const backdrop = await takeBackdrop(flags, r);
+  const cap = await maxDuration(flags, r);
+  if (existsSync23(join24(outDir, "meta.json"))) {
+    const { prevDoc, kept } = await prepareReRecord(outDir);
+    r.log(
+      `note: recording again into ${outDir}; kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? `; apply the previous cut with: vos plan ${outDir} --reuse` : "")
+    );
+  }
+  await mkdir9(outDir, { recursive: true });
+  const paths = takePaths(outDir);
+  const notes = [];
+  if (!granted.accessibility) {
+    notes.push(
+      "Accessibility is not granted to the app this was run from, so a press carries no bounds of what was pressed and its zoom cannot fit the control. Switch it on in System Settings, Privacy & Security, Accessibility, for zooms that fit."
+    );
+    r.log(`note: ${notes[0]}`);
+  }
+  const request = {
+    ...windowFlag !== void 0 ? { window: windowFlag } : { app },
+    out: outDir,
+    maxSeconds: seconds !== void 0 ? Math.min(seconds, cap) : cap,
+    pointer: true,
+    frames: granted.accessibility
+  };
+  r.event({ event: "phase", phase: "record" });
+  const take = driver.record(request);
+  const end = () => void take.stop().catch(() => {
+  });
+  process.on("SIGINT", end);
+  process.on("SIGTERM", end);
+  let stopped;
+  try {
+    const ready = await take.ready;
+    r.event({
+      event: "recording",
+      app: ready.app,
+      window: ready.window,
+      width: ready.captureWidth,
+      height: ready.captureHeight
+    });
+    r.log(
+      `recording ${ready.app || "the window"} (${ready.captureWidth}\xD7${ready.captureHeight})${seconds !== void 0 ? ` for ${seconds}s` : ". Use the app; Ctrl-C ends the take"}\u2026`
+    );
+    stopped = await take.done;
+  } catch (error) {
+    throw driverFailure(error);
+  } finally {
+    process.off("SIGINT", end);
+    process.off("SIGTERM", end);
+  }
+  if (!existsSync23(paths.meta))
+    throw new Error(`the recording ended without a take in ${outDir}`);
+  const events = existsSync23(paths.cursor) ? JSON.parse(await readFile14(paths.cursor, "utf8")) : [];
+  const clicks = events.filter((e) => e.type === "down").length;
+  const typing = events.filter((e) => e.type === "key").length;
+  const plan = await planTake(outDir, { backdrop });
+  const said = notes.length;
+  if (stopped.reason === "cap" && seconds === void 0)
+    notes.push("stopped at --max-duration");
+  if (stopped.resized)
+    notes.push(
+      "the window changed size during the take, so the picture is scaled to fit from there on"
+    );
+  const held = stopped.heldFrames;
+  if (held > 0)
+    notes.push(
+      `another app's window was over this one for a moment: ${held} frame${held === 1 ? " was" : "s were"} held back so it is not in the take`
+    );
+  for (const n of notes.slice(said)) r.log(`note: ${n}`);
+  const length = (stopped.durationMs / 1e3).toFixed(1);
+  const cursorLine = events.length ? `${events.length} cursor events (${clicks} click${clicks === 1 ? "" : "s"}, ${typing} typing ping${typing === 1 ? "" : "s"}); ${plan.zoomAuto} zoom${plan.zoomAuto === 1 ? "" : "s"} planned` : "no pointer came over the window, so nothing was planned";
+  r.done(
+    {
+      out: outDir,
+      recording: "recording.mp4",
+      durationMs: stopped.durationMs,
+      frames: stopped.frames,
+      bytes: stopped.bytes,
+      reason: stopped.reason,
+      cursor: { events: events.length, clicks, typing },
+      zooms: plan.zoomAuto,
+      backdrop: plan.backdrop ?? null,
+      notes
+    },
+    `Recorded ${app ?? `window ${windowFlag}`} \u2192 ${outDir}/recording.mp4 (${length}s, ${stopped.frames} frames)
+  ${cursorLine}
+  Next: vos digest ${outDir} \u2014 look before you cut; edit doc.json; vos open ${outDir} or vos push ${outDir}`
+  );
+  return EXIT_OK;
+}
+
 // src/plugin/checkVideo.ts
 import { createRequire as createRequire2 } from "module";
-import { existsSync as existsSync23 } from "fs";
-import { mkdir as mkdir9, readFile as readFile14, stat as stat3, writeFile as writeFile7 } from "fs/promises";
-import { basename as basename12, dirname as dirname8, extname as extname4, join as join24, resolve as resolve16 } from "path";
+import { existsSync as existsSync24 } from "fs";
+import { mkdir as mkdir10, readFile as readFile15, stat as stat3, writeFile as writeFile7 } from "fs/promises";
+import { basename as basename12, dirname as dirname8, extname as extname4, join as join25, resolve as resolve17 } from "path";
 import { ALL_FORMATS as ALL_FORMATS2, FilePathSource as FilePathSource2, Input as Input2 } from "mediabunny";
 
 // src/plugin/videoChecks.ts
@@ -13850,7 +14008,7 @@ function posterWarning(which, deviation) {
 }
 
 // src/plugin/checkVideo.ts
-var BOOLEAN_FLAGS11 = /* @__PURE__ */ new Set(["json", "help", "strict"]);
+var BOOLEAN_FLAGS12 = /* @__PURE__ */ new Set(["json", "help", "strict"]);
 var THUMB_LONG_SIDE = 160;
 var CELLS_LONG_SIDE = 16;
 async function probeVideoFacts(file) {
@@ -13893,10 +14051,10 @@ async function probeVideoFacts(file) {
 }
 async function mediabunnyBundle() {
   const entry = createRequire2(import.meta.url).resolve("mediabunny");
-  const bundle = join24(dirname8(entry), "mediabunny.min.mjs");
-  if (existsSync23(bundle)) return readFile14(bundle, "utf8");
-  return readFile14(
-    join24(entry.split("/dist/")[0], "dist/bundles/mediabunny.min.mjs"),
+  const bundle = join25(dirname8(entry), "mediabunny.min.mjs");
+  if (existsSync24(bundle)) return readFile15(bundle, "utf8");
+  return readFile15(
+    join25(entry.split("/dist/")[0], "dist/bundles/mediabunny.min.mjs"),
     "utf8"
   );
 }
@@ -14118,7 +14276,7 @@ async function checkVideo(browser, file, outDir) {
   );
   const long = Math.max(facts.width, facts.height, 1);
   const side = (n) => Math.max(1, Math.round(n / long * THUMB_LONG_SIDE));
-  const server = await startTakeServer(dirname8(resolve16(file)), {
+  const server = await startTakeServer(dirname8(resolve17(file)), {
     "/check.html": '<!doctype html><html><head><meta charset="utf-8"><link rel="icon" href="data:,"></head><body></body></html>'
   });
   const page = await browser.newPage();
@@ -14153,9 +14311,9 @@ async function checkVideo(browser, file, outDir) {
     await page.close();
     server.close();
   }
-  await mkdir9(outDir, { recursive: true });
-  const firstFile = join24(outDir, "first.png");
-  const lastFile = join24(outDir, "last.png");
+  await mkdir10(outDir, { recursive: true });
+  const firstFile = join25(outDir, "first.png");
+  const lastFile = join25(outDir, "last.png");
   await writeFile7(firstFile, Buffer.from(done.firstPng, "base64"));
   await writeFile7(lastFile, Buffer.from(done.lastPng, "base64"));
   const changes = sceneChanges2(
@@ -14204,7 +14362,7 @@ async function checkVideo(browser, file, outDir) {
     outDir
   };
   await writeFile7(
-    join24(outDir, "check.json"),
+    join25(outDir, "check.json"),
     `${JSON.stringify(result, null, 2)}
 `
   );
@@ -14226,21 +14384,21 @@ function checkVideoLines(r) {
     `  scene changes: ${cuts.length}${cuts.length ? ` (${cuts.map((c) => `${c.time.toFixed(2)}s`).join(", ")})` : ""}; per ${r.scenes.window} s: ${r.scenes.perWindow.map((w) => w.count).join(", ")}`,
     r.audio ? `  loudness: ${l?.integrated ?? "silent"}${l?.integrated !== null ? " LUFS" : ""} integrated; short-term every 3 s: ${st?.join(", ")}; sample peak ${l?.samplePeakDb ?? "-inf"} dBFS` : "  loudness: no audio track",
     `  posters: ${r.posters.first.file} (deviation ${r.posters.first.deviation}), ${r.posters.last.file} (deviation ${r.posters.last.deviation})`,
-    `  ${r.warnings.length ? `${r.warnings.length} warning${r.warnings.length === 1 ? "" : "s"}` : "no warnings"}; ${join24(r.outDir, "check.json")}`
+    `  ${r.warnings.length ? `${r.warnings.length} warning${r.warnings.length === 1 ? "" : "s"}` : "no warnings"}; ${join25(r.outDir, "check.json")}`
   ].join("\n");
 }
 async function cmdCheckVideo(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS11);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS12);
   const file = positionals[0];
   if (!file)
     throw new UsageError(
       "vos check-video <file.mp4|webm> [--out dir] [--strict] [--json]"
     );
-  if (!existsSync23(file)) throw new UsageError(`${file} does not exist`);
+  if (!existsSync24(file)) throw new UsageError(`${file} does not exist`);
   const r = createReporter(flags.json === true);
   const strict = flags.strict === true;
-  const outDir = resolve16(
-    strFlag(flags, "out") ?? join24(dirname8(file), `${basename12(file, extname4(file))}-check`)
+  const outDir = resolve17(
+    strFlag(flags, "out") ?? join25(dirname8(file), `${basename12(file, extname4(file))}-check`)
   );
   const browser = await launchBrowser();
   try {
@@ -14255,15 +14413,15 @@ async function cmdCheckVideo(argv) {
 }
 
 // src/plugin/join.ts
-import { existsSync as existsSync26, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
-import { copyFile as copyFile3, mkdir as mkdir11, readFile as readFile17, rm as rm4 } from "fs/promises";
+import { existsSync as existsSync27, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
+import { copyFile as copyFile3, mkdir as mkdir12, readFile as readFile18, rm as rm4 } from "fs/promises";
 import {
   basename as basename14,
   dirname as dirname9,
   isAbsolute as isAbsolute4,
-  join as join27,
+  join as join28,
   relative as relative5,
-  resolve as resolve18,
+  resolve as resolve19,
   sep as sep4
 } from "path";
 import {
@@ -14279,17 +14437,17 @@ import {
 import { totalDuration as totalDuration3 } from "@vosjs/timeline";
 
 // src/plugin/score.ts
-import { existsSync as existsSync24 } from "fs";
+import { existsSync as existsSync25 } from "fs";
 import {
   copyFile as copyFile2,
-  mkdir as mkdir10,
+  mkdir as mkdir11,
   mkdtemp,
-  readFile as readFile15,
+  readFile as readFile16,
   rm as rm3,
   writeFile as writeFile8
 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import { basename as basename13, isAbsolute as isAbsolute3, join as join25, relative as relative4, resolve as resolve17, sep as sep3 } from "path";
+import { basename as basename13, isAbsolute as isAbsolute3, join as join26, relative as relative4, resolve as resolve18, sep as sep3 } from "path";
 import { rankBeds as rankBeds2 } from "@vosjs/shared/music";
 import {
   NORMALIZE_MAX_LUFS as NORMALIZE_MAX_LUFS2,
@@ -14603,7 +14761,7 @@ async function measureInNode(path) {
 var PAGE_CHUNK_SECONDS = 10;
 var BROWSER_DECODE_MAX_BYTES = 200 * 1024 * 1024;
 async function measureInBrowser(path) {
-  const bytes = await readFile15(path);
+  const bytes = await readFile16(path);
   if (bytes.length > BROWSER_DECODE_MAX_BYTES)
     throw new Error(
       `${basename13(path)} is ${Math.round(bytes.length / 1048576)} MB, past the ${BROWSER_DECODE_MAX_BYTES / 1048576} MB the browser decode takes whole`
@@ -14706,14 +14864,14 @@ function resolveAt(doc, raw) {
   return { at: r.start, via: `step ${v} (${r.start.toFixed(2)}s)` };
 }
 async function resolveTrack(dir, ref, flags, dryRun) {
-  const local = resolve17(ref);
-  if (existsSync24(local)) {
-    const rel = relative4(resolve17(dir), local);
+  const local = resolve18(ref);
+  if (existsSync25(local)) {
+    const rel = relative4(resolve18(dir), local);
     const inside = !!rel && !rel.startsWith(`..${sep3}`) && rel !== ".." && !isAbsolute3(rel);
     const key = inside ? rel.split(sep3).join("/") : `music/${basename13(local)}`;
     if (!inside && !dryRun) {
-      await mkdir10(join25(dir, "music"), { recursive: true });
-      await copyFile2(local, join25(dir, key));
+      await mkdir11(join26(dir, "music"), { recursive: true });
+      await copyFile2(local, join26(dir, key));
     }
     return { path: local, key, name: basename13(local) };
   }
@@ -14729,8 +14887,8 @@ async function resolveTrack(dir, ref, flags, dryRun) {
     );
   const res = await fetch(track.url);
   if (!res.ok) throw new Error(`GET ${track.url} answered ${res.status}`);
-  const tmp = await mkdtemp(join25(tmpdir2(), "vos-score-"));
-  const path = join25(tmp, basename13(new URL(track.url).pathname) || "track");
+  const tmp = await mkdtemp(join26(tmpdir2(), "vos-score-"));
+  const path = join26(tmp, basename13(new URL(track.url).pathname) || "track");
   await writeFile8(path, new Uint8Array(await res.arrayBuffer()));
   return {
     path,
@@ -14739,13 +14897,13 @@ async function resolveTrack(dir, ref, flags, dryRun) {
     cleanup: () => rm3(tmp, { recursive: true, force: true })
   };
 }
-var BOOLEAN_FLAGS12 = /* @__PURE__ */ new Set(["json", "help", "dry-run"]);
-var USAGE2 = 'vos score <take> --track <slug|file|best> [--at <step id|output seconds>] [--mood <slug|tag>] [--words "\u2026"] [--gain 0..1] [--normalize <lufs|off>] [--fade-in <s>] [--fade-out <s>] [--dry-run] [--json]';
+var BOOLEAN_FLAGS13 = /* @__PURE__ */ new Set(["json", "help", "dry-run"]);
+var USAGE3 = 'vos score <take> --track <slug|file|best> [--at <step id|output seconds>] [--mood <slug|tag>] [--words "\u2026"] [--gain 0..1] [--normalize <lufs|off>] [--fade-in <s>] [--fade-out <s>] [--dry-run] [--json]';
 async function cmdScore(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS12);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS13);
   const dir = positionals[0];
   const trackRef = strFlag(flags, "track");
-  if (!dir || !trackRef) throw new UsageError(USAGE2);
+  if (!dir || !trackRef) throw new UsageError(USAGE3);
   const r = createReporter(flags.json === true);
   const dryRun = flags["dry-run"] === true;
   const gain = numFlag(flags, "gain", 0.5);
@@ -14776,7 +14934,7 @@ async function cmdScore(argv) {
     });
     const catalog = await fetchMusicCatalog(origin);
     const film2 = filmSummaryOf2(doc, {
-      seed: readSyncState(dir)?.vosId ?? basename13(resolve17(dir)),
+      seed: readSyncState(dir)?.vosId ?? basename13(resolve18(dir)),
       ...at2 ? { payoff: at2.at } : {},
       mood: strFlag(flags, "mood"),
       words: strFlag(flags, "words")
@@ -14878,7 +15036,7 @@ async function cmdScore(argv) {
   const placeLine = at2 && plan.swellAt !== null ? `the track starts at ${plan.in.toFixed(2)}s, so the swell lands at ${plan.swellAt.toFixed(2)}s of film (asked: ${at2.via})` : `the track starts at ${plan.in.toFixed(2)}s${at2 ? ` (asked: ${at2.via})` : ", its first rise above its median level"}`;
   r.done(
     {
-      take: resolve17(dir),
+      take: resolve18(dir),
       dryRun,
       track: { key: track.key, name: track.name, duration: clip.duration },
       film: r3(film),
@@ -15405,9 +15563,9 @@ function perBeatLine(r, name = (m) => m ? `media ${m}` : "the primary") {
 
 // src/plugin/rejoin.ts
 import { createHash as createHash4 } from "crypto";
-import { createReadStream, existsSync as existsSync25 } from "fs";
-import { readFile as readFile16 } from "fs/promises";
-import { join as join26 } from "path";
+import { createReadStream, existsSync as existsSync26 } from "fs";
+import { readFile as readFile17 } from "fs/promises";
+import { join as join27 } from "path";
 import {
   isRejected as isRejected2,
   layerStart as layerStart3,
@@ -15432,14 +15590,14 @@ async function partFootage(part) {
   const key = part.doc.source.videoKey;
   if (!isTakeRelativeKey(key))
     return `key:${createHash4("sha256").update(key).digest("hex")}`;
-  const file = join26(part.dir, takeRelativeFile(key));
-  return existsSync25(file) ? fileHash(file) : `key:${createHash4("sha256").update(key).digest("hex")}`;
+  const file = join27(part.dir, takeRelativeFile(key));
+  return existsSync26(file) ? fileHash(file) : `key:${createHash4("sha256").update(key).digest("hex")}`;
 }
 async function readJoinRecord(dir) {
-  const file = join26(dir, JOIN_RECORD_NAME);
-  if (!existsSync25(file)) return null;
+  const file = join27(dir, JOIN_RECORD_NAME);
+  if (!existsSync26(file)) return null;
   try {
-    const v = JSON.parse(await readFile16(file, "utf8"));
+    const v = JSON.parse(await readFile17(file, "utf8"));
     return v && v.version === 1 && Array.isArray(v.inputs) ? v : null;
   } catch {
     return null;
@@ -15449,8 +15607,8 @@ async function recordFromFootage(dir, doc) {
   const hash = async (key) => {
     if (!isTakeRelativeKey(key))
       return `key:${createHash4("sha256").update(key).digest("hex")}`;
-    const file = join26(dir, takeRelativeFile(key));
-    return existsSync25(file) ? fileHash(file) : `missing:${key}`;
+    const file = join27(dir, takeRelativeFile(key));
+    return existsSync26(file) ? fileHash(file) : `missing:${key}`;
   };
   const inputs = [
     {
@@ -16212,7 +16370,7 @@ function joinDocs(parts, opts = {}) {
     ];
     for (const ref of refs)
       copy({
-        from: join27(first.dir, takeRelativeFile(ref.key)),
+        from: join28(first.dir, takeRelativeFile(ref.key)),
         to: takeRelativeFile(ref.key),
         base: first.dir
       });
@@ -16295,7 +16453,7 @@ function joinDocs(parts, opts = {}) {
       for (const ref of refs) {
         const to = prefixed(pid, ref.key);
         copy({
-          from: join27(part.dir, takeRelativeFile(ref.key)),
+          from: join28(part.dir, takeRelativeFile(ref.key)),
           to,
           base: part.dir
         });
@@ -16442,7 +16600,7 @@ function joinDocs(parts, opts = {}) {
     owners
   };
 }
-var BOOLEAN_FLAGS13 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS14 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "force",
@@ -16450,16 +16608,16 @@ var BOOLEAN_FLAGS13 = /* @__PURE__ */ new Set([
   "captions"
 ]);
 var MULTI = /* @__PURE__ */ new Set(["mute"]);
-var USAGE3 = "vos join <take> <take|file.mp4>\u2026 --out <dir> [--keep-edits|--force] [--captions] [--zooms per-beat] [--mute <file>]... [--json]";
+var USAGE4 = "vos join <take> <take|file.mp4>\u2026 --out <dir> [--keep-edits|--force] [--captions] [--zooms per-beat] [--mute <file>]... [--json]";
 var within = (inner, outer) => {
   const rel = relative5(outer, inner);
   return rel === "" || !rel.startsWith(`..${sep4}`) && rel !== ".." && !isAbsolute4(rel);
 };
 async function readPart(arg) {
-  const path = resolve18(arg);
-  if (!existsSync26(path)) throw new UsageError(`${arg}: no such take or file`);
+  const path = resolve19(arg);
+  if (!existsSync27(path)) throw new UsageError(`${arg}: no such take or file`);
   if (statSync7(path).isDirectory()) {
-    if (!existsSync26(join27(path, "meta.json")))
+    if (!existsSync27(join28(path, "meta.json")))
       throw new UsageError(
         `${arg}: not a take directory (no meta.json); a video file is joined by its path`
       );
@@ -16492,7 +16650,7 @@ async function readPart(arg) {
   };
 }
 async function cmdJoin(argv) {
-  const { positionals, flags, multi } = parseArgs(argv, BOOLEAN_FLAGS13, MULTI);
+  const { positionals, flags, multi } = parseArgs(argv, BOOLEAN_FLAGS14, MULTI);
   const r = createReporter(flags.json === true);
   const outArg = strFlag(flags, "out");
   const force = flags.force === true;
@@ -16501,16 +16659,16 @@ async function cmdJoin(argv) {
   const zoomMode = zoomModeOf(strFlag(flags, "zooms"));
   if (zoomMode && typeof zoomMode === "object")
     throw new UsageError(zoomMode.error);
-  if (positionals.length < 2 || !outArg) throw new UsageError(USAGE3);
+  if (positionals.length < 2 || !outArg) throw new UsageError(USAGE4);
   if (force && keepEdits)
     throw new UsageError(
       "--force replaces the joined take and --keep-edits keeps its edits; pass one"
     );
-  const out = resolve18(outArg);
-  const inputs = positionals.map((p) => resolve18(p));
+  const out = resolve19(outArg);
+  const inputs = positionals.map((p) => resolve19(p));
   const muted = /* @__PURE__ */ new Set();
   for (const m of multi.mute ?? []) {
-    const i = inputs.indexOf(resolve18(m));
+    const i = inputs.indexOf(resolve19(m));
     if (i < 0)
       throw new UsageError(
         `--mute ${m}: not one of the inputs; name a file as it is given to vos join`
@@ -16524,19 +16682,19 @@ async function cmdJoin(argv) {
       );
   }
   let rejoin = false;
-  if (existsSync26(out)) {
+  if (existsSync27(out)) {
     if (!force && !keepEdits)
       throw new UsageError(
         `--out ${outArg} exists; pass --keep-edits to join again and keep every edit made since (its trims, spans, layers, frame, sound), --force to replace it, or name a new directory`
       );
     if (keepEdits) {
-      if (!existsSync26(join27(out, "doc.json")))
+      if (!existsSync27(join28(out, "doc.json")))
         throw new UsageError(
           `--keep-edits: ${outArg} holds no doc.json, so there are no edits to keep; name a new directory, or --force to replace it`
         );
       rejoin = true;
     } else {
-      const isTake = existsSync26(join27(out, "doc.json")) || existsSync26(join27(out, "meta.json"));
+      const isTake = existsSync27(join28(out, "doc.json")) || existsSync27(join28(out, "meta.json"));
       if (!isTake && readdirSync5(out).length > 0)
         throw new UsageError(
           `--force replaces a take directory, and ${outArg} holds other files; name a new directory`
@@ -16572,7 +16730,7 @@ async function cmdJoin(argv) {
   let rejoined = null;
   if (rejoin) {
     const prev = JSON.parse(
-      await readFile17(join27(out, "doc.json"), "utf8")
+      await readFile18(join28(out, "doc.json"), "utf8")
     );
     let record = await readJoinRecord(out);
     if (!record) {
@@ -16582,7 +16740,7 @@ async function cmdJoin(argv) {
       );
     }
     rejoined = rejoinDocs(migrateMotion3(prev), record, read, {
-      where: (p) => relative5(process.cwd(), resolve18(out, p)) || "."
+      where: (p) => relative5(process.cwd(), resolve19(out, p)) || "."
     });
     plan = rejoined.plan;
   } else plan = joinDocs(parts);
@@ -16623,17 +16781,17 @@ async function cmdJoin(argv) {
   if (rejoined) {
     for (const k of rejoined.dropped) {
       if (!/^[A-Za-z0-9_-]+$/.test(k)) continue;
-      const dir = join27(out, k);
-      if (existsSync26(dir) && statSync7(dir).isDirectory())
+      const dir = join28(out, k);
+      if (existsSync27(dir) && statSync7(dir).isDirectory())
         await rm4(dir, { recursive: true, force: true });
     }
   } else {
-    if (existsSync26(out)) await rm4(out, { recursive: true, force: true });
-    await mkdir11(out, { recursive: true });
+    if (existsSync27(out)) await rm4(out, { recursive: true, force: true });
+    await mkdir12(out, { recursive: true });
   }
   for (const c of plan.copies) {
-    const to = join27(out, c.to);
-    await mkdir11(dirname9(to), { recursive: true });
+    const to = join28(out, c.to);
+    await mkdir12(dirname9(to), { recursive: true });
     if (c.remux) {
       const remuxed = await copyRecording(c.from, to, c.remux);
       if (!remuxed && c.remux !== "mov")
@@ -16649,7 +16807,7 @@ async function cmdJoin(argv) {
   for (const clip of doc.audio) {
     if (!added.has(clip.id) || !isTakeRelativeKey(clip.key)) continue;
     try {
-      const m = await measureTrack(join27(out, takeRelativeFile(clip.key)));
+      const m = await measureTrack(join28(out, takeRelativeFile(clip.key)));
       if (m.lufs !== null)
         clip.loudness = loudnessFact(
           { lufs: m.lufs, peakDb: m.peakDb },
@@ -16661,14 +16819,14 @@ async function cmdJoin(argv) {
       );
     }
   }
-  await writeJson(join27(out, "meta.json"), doc.source.meta, true);
+  await writeJson(join28(out, "meta.json"), doc.source.meta, true);
   if (doc.source.cursor.length)
-    await writeJson(join27(out, "cursor.json"), doc.source.cursor);
+    await writeJson(join28(out, "cursor.json"), doc.source.cursor);
   if (parts[0].actions)
-    await writeJson(join27(out, "actions.json"), parts[0].actions, true);
-  await writeJson(join27(out, "doc.json"), doc, true);
+    await writeJson(join28(out, "actions.json"), parts[0].actions, true);
+  await writeJson(join28(out, "doc.json"), doc, true);
   await writeJson(
-    join27(out, JOIN_RECORD_NAME),
+    join28(out, JOIN_RECORD_NAME),
     joinRecordOf(read, plan.ids),
     true
   );
@@ -16712,7 +16870,7 @@ async function cmdJoin(argv) {
 }
 
 // src/plugin/timeline.ts
-import { join as join28, resolve as resolve19 } from "path";
+import { join as join29, resolve as resolve20 } from "path";
 import {
   docFreezes as docFreezes2,
   docMediaList as docMediaList4,
@@ -17003,7 +17161,7 @@ async function cmdTakeInfo(argv) {
   if (drift) r.warn(scriptDriftLine(drift));
   const timeline = takeTimeline(take.doc, /* @__PURE__ */ new Map([["", take.actions]]));
   r.done(
-    { take: resolve19(dir), doc: join28(resolve19(dir), "doc.json"), ...timeline },
+    { take: resolve20(dir), doc: join29(resolve20(dir), "doc.json"), ...timeline },
     formatTimeline(timeline, dir)
   );
   return EXIT_OK;
@@ -17012,9 +17170,9 @@ async function cmdTakeInfo(argv) {
 // src/plugin/audio.ts
 import { mkdtemp as mkdtemp2, rm as rm5, writeFile as writeFile9 } from "fs/promises";
 import { tmpdir as tmpdir3 } from "os";
-import { basename as basename15, join as join29 } from "path";
+import { basename as basename15, join as join30 } from "path";
 import { clipGain as clipGain3 } from "@vosjs/studio-core";
-var USAGE4 = "vos audio measure <take> [--json]";
+var USAGE5 = "vos audio measure <take> [--json]";
 async function fileFor(dir, key, fetchImpl) {
   if (isTakeRelativeKey(key)) {
     const found = localFile(takeRelativeFile(key), dir);
@@ -17024,8 +17182,8 @@ async function fileFor(dir, key, fetchImpl) {
   if (/^https?:\/\//.test(key)) {
     const res = await fetchImpl(key);
     if (!res.ok) return { skipped: `GET ${key} answered ${res.status}` };
-    const tmp = await mkdtemp2(join29(tmpdir3(), "vos-audio-"));
-    const path = join29(tmp, basename15(new URL(key).pathname) || "audio");
+    const tmp = await mkdtemp2(join30(tmpdir3(), "vos-audio-"));
+    const path = join30(tmp, basename15(new URL(key).pathname) || "audio");
     await writeFile9(path, new Uint8Array(await res.arrayBuffer()));
     return { path, cleanup: () => rm5(tmp, { recursive: true, force: true }) };
   }
@@ -17081,7 +17239,7 @@ function clipLine(c) {
 async function cmdAudio(argv) {
   const { positionals, flags } = parseArgs(argv, /* @__PURE__ */ new Set(["json", "help"]));
   const [sub, dir] = positionals;
-  if (sub !== "measure" || !dir) throw new UsageError(USAGE4);
+  if (sub !== "measure" || !dir) throw new UsageError(USAGE5);
   const r = createReporter(flags.json === true);
   const take = await loadTake(dir);
   if (!take.doc)
@@ -17106,11 +17264,11 @@ async function cmdAudio(argv) {
 }
 
 // src/plugin/musicCmd.ts
-import { existsSync as existsSync27, readFileSync as readFileSync10, statSync as statSync8 } from "fs";
-import { basename as basename16, resolve as resolve20 } from "path";
+import { existsSync as existsSync28, readFileSync as readFileSync10, statSync as statSync8 } from "fs";
+import { basename as basename16, resolve as resolve21 } from "path";
 import { rankBeds as rankBeds3, trackBySlug as trackBySlug2 } from "@vosjs/shared/music";
 import { filmSummaryOf as filmSummaryOf3, musicSlugsOfDoc } from "@vosjs/studio-core";
-var BOOLEAN_FLAGS14 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS15 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "loops",
@@ -17119,7 +17277,7 @@ var BOOLEAN_FLAGS14 = /* @__PURE__ */ new Set([
   "fade-in"
 ]);
 var MULTI_FLAGS3 = /* @__PURE__ */ new Set(["like"]);
-var USAGE5 = 'vos music ls [--mood <slug>] [--vocals none|chops|lead] [--loops] [--bpm <lo>-<hi>] [--min-length <s>] [--q <words>] [--json]\nvos music pick <take|config.json> [--at <step id|seconds>] [--mood <slug|tag>] [--words "\u2026"] [--voice|--no-voice] [--like <vos id|slug>]... [--top <n>] [--json]';
+var USAGE6 = 'vos music ls [--mood <slug>] [--vocals none|chops|lead] [--loops] [--bpm <lo>-<hi>] [--min-length <s>] [--q <words>] [--json]\nvos music pick <take|config.json> [--at <step id|seconds>] [--mood <slug|tag>] [--words "\u2026"] [--voice|--no-voice] [--like <vos id|slug>]... [--top <n>] [--json]';
 var mmss = (s) => {
   const whole = Math.round(s);
   return `${Math.floor(whole / 60)}:${String(whole % 60).padStart(2, "0")}`;
@@ -17181,8 +17339,8 @@ function filterTracks(tracks, f) {
   });
 }
 async function loadFilm(ref) {
-  const path = resolve20(ref);
-  if (!existsSync27(path)) throw new UsageError(`${ref}: no such take or file`);
+  const path = resolve21(ref);
+  if (!existsSync28(path)) throw new UsageError(`${ref}: no such take or file`);
   if (statSync8(path).isDirectory()) {
     const take = await loadTake(path);
     if (!take.doc)
@@ -17261,12 +17419,12 @@ ${lines.join("\n")}${tail}`;
 async function cmdMusic(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS14,
+    BOOLEAN_FLAGS15,
     MULTI_FLAGS3
   );
   const verb = positionals[0];
   if (flags.help === true || !verb || !["ls", "pick"].includes(verb))
-    throw new UsageError(USAGE5);
+    throw new UsageError(USAGE6);
   const r = createReporter(flags.json === true);
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -17292,7 +17450,7 @@ async function cmdMusic(argv) {
     return EXIT_OK;
   }
   const ref = positionals[1];
-  if (!ref) throw new UsageError(USAGE5);
+  if (!ref) throw new UsageError(USAGE6);
   const { doc, seed, dir } = await loadFilm(ref);
   const atRaw = strFlag(flags, "at");
   const at2 = atRaw !== void 0 ? resolveAt(doc, atRaw) : null;
@@ -17333,10 +17491,10 @@ async function cmdMusic(argv) {
 }
 
 // src/plugin/look.ts
-import { mkdir as mkdir12, mkdtemp as mkdtemp3, readFile as readFile18, rm as rm6 } from "fs/promises";
-import { existsSync as existsSync28 } from "fs";
+import { mkdir as mkdir13, mkdtemp as mkdtemp3, readFile as readFile19, rm as rm6 } from "fs/promises";
+import { existsSync as existsSync29 } from "fs";
 import { tmpdir as tmpdir4 } from "os";
-import { dirname as dirname10, join as join30, resolve as resolve21 } from "path";
+import { dirname as dirname10, join as join31, resolve as resolve22 } from "path";
 import { headersFor, urlSchemeProblem } from "@vosjs/render-core/record";
 function quote(value) {
   return `"${value.replace(/\s+/g, " ").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
@@ -17799,8 +17957,8 @@ async function inspectPage(page, opts) {
   const { url, wall, settled } = opts;
   const ran = opts.steps;
   if (opts.waitMs && opts.waitMs > 0) await page.waitForTimeout(opts.waitMs);
-  await mkdir12(opts.outDir, { recursive: true });
-  const screenshot = join30(opts.outDir, "look.png");
+  await mkdir13(opts.outDir, { recursive: true });
+  const screenshot = join31(opts.outDir, "look.png");
   await page.screenshot({ path: screenshot });
   const scan = await page.evaluate(EXPOSURE_PROBE).catch(() => null);
   const step = ran.length ? ran.length - 1 : -1;
@@ -17855,7 +18013,7 @@ async function inspectPage(page, opts) {
     settled
   };
 }
-var USAGE6 = "vos look <url> [--session <name> | --storage-state <file>] [--viewport WxH] [--headed] [--click <selector>]... [--type <selector>=<text>]... [--wait <ms>] [--out <dir>] [--json]\n       vos look [url] --actions actions.json --until <step id> [--session <name> | --storage-state <file>] [--viewport WxH] [--headed] [--wait <ms>] [--out <dir>] [--json]";
+var USAGE7 = "vos look <url> [--session <name> | --storage-state <file>] [--viewport WxH] [--headed] [--click <selector>]... [--type <selector>=<text>]... [--wait <ms>] [--out <dir>] [--json]\n       vos look [url] --actions actions.json --until <step id> [--session <name> | --storage-state <file>] [--viewport WxH] [--headed] [--wait <ms>] [--out <dir>] [--json]";
 function untilProblem(given, steps) {
   if (given.until !== void 0 && given.actions === void 0)
     return "--until names a step of a script: pass the script with --actions actions.json";
@@ -17914,7 +18072,7 @@ async function cmdLook(argv) {
   if (early) throw new UsageError(early);
   let actions;
   if (actionsArg) {
-    actions = await loadLookActions(resolve21(actionsArg));
+    actions = await loadLookActions(resolve22(actionsArg));
     const bad = untilProblem(
       { actions: actionsArg, until: untilId, clicks: 0 },
       actions.steps
@@ -17922,21 +18080,21 @@ async function cmdLook(argv) {
     if (bad) throw new UsageError(bad);
   }
   const url = positionals[0] ?? actions?.url;
-  if (!url) throw new UsageError(USAGE6);
+  if (!url) throw new UsageError(USAGE7);
   const scheme = urlSchemeProblem(url);
   if (scheme) throw new UsageError(scheme);
   const r = createReporter(flags.json === true);
   const viewportFlag = strFlag(flags, "viewport");
   const viewport = !viewportFlag && actions?.viewport ? actions.viewport : parseViewport2(viewportFlag);
-  const outDir = resolve21(strFlag(flags, "out") ?? "look");
+  const outDir = resolve22(strFlag(flags, "out") ?? "look");
   const headed = flags.headed === true;
   const waitRaw = strFlag(flags, "wait");
   const waitMs = waitRaw === void 0 ? 0 : Number(waitRaw);
   if (!Number.isFinite(waitMs) || waitMs < 0 || waitMs > 6e4)
     throw new UsageError("--wait expects milliseconds, 0 to 60000");
   const storageRaw = strFlag(flags, "storage-state");
-  const storageState = storageRaw ? resolve21(storageRaw) : void 0;
-  if (storageState && !existsSync28(storageState))
+  const storageState = storageRaw ? resolve22(storageRaw) : void 0;
+  if (storageState && !existsSync29(storageState))
     throw new UsageError(`--storage-state: no such file: ${storageState}`);
   const sessionName = strFlag(flags, "session");
   if (sessionName) {
@@ -17946,7 +18104,7 @@ async function cmdLook(argv) {
       throw new UsageError(
         "--session and --storage-state are two doors to one page: a persistent profile cannot take a storage state. Pass one"
       );
-    if (!existsSync28(sessionDir(sessionName)))
+    if (!existsSync29(sessionDir(sessionName)))
       throw new UsageError(
         `no session "${sessionName}". Make one: vos session open <url> --name ${sessionName} (a Chrome window opens; sign in and close it)`
       );
@@ -17963,7 +18121,7 @@ async function cmdLook(argv) {
       r,
       url,
       actions,
-      actionsPath: resolve21(actionsArg),
+      actionsPath: resolve22(actionsArg),
       untilId,
       viewport,
       outDir,
@@ -18023,7 +18181,7 @@ async function cmdLook(argv) {
 async function loadLookActions(file) {
   let raw;
   try {
-    raw = JSON.parse(await readFile18(file, "utf8"));
+    raw = JSON.parse(await readFile19(file, "utf8"));
   } catch (e) {
     throw new UsageError(
       `--actions ${file}: ${e instanceof Error ? e.message : String(e)}`
@@ -18041,7 +18199,7 @@ async function lookUntil(o) {
   const actions = { ...o.actions, viewport: o.viewport };
   let wall = null;
   let looked = null;
-  const scratch = await mkdtemp3(join30(tmpdir4(), "vos-look-"));
+  const scratch = await mkdtemp3(join31(tmpdir4(), "vos-look-"));
   r.log(
     `walking ${o.actionsPath} to step ${o.untilId} (a rehearsal: guarded steps hovered, never pressed)\u2026`
   );
@@ -18127,18 +18285,18 @@ async function lookUntil(o) {
 import { spawnSync as spawnSync4 } from "child_process";
 import {
   cpSync,
-  existsSync as existsSync30,
+  existsSync as existsSync31,
   mkdirSync as mkdirSync6,
   readFileSync as readFileSync12,
   writeFileSync as writeFileSync6
 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join32 } from "path";
+import { join as join33 } from "path";
 import { chromium as chromium2 } from "playwright";
 
 // src/plugin/machine.ts
-import { existsSync as existsSync29, readFileSync as readFileSync11, readdirSync as readdirSync6, statSync as statSync9 } from "fs";
-import { dirname as dirname11, join as join31 } from "path";
+import { existsSync as existsSync30, readFileSync as readFileSync11, readdirSync as readdirSync6, statSync as statSync9 } from "fs";
+import { dirname as dirname11, join as join32 } from "path";
 var AGENT_NAMES = [
   "claude",
   "cursor",
@@ -18158,17 +18316,17 @@ var HOME_DIRS = {
   copilot: [".copilot"]
 };
 function detectAgents(root, opts = {}) {
-  const exists = opts.exists ?? existsSync29;
+  const exists = opts.exists ?? existsSync30;
   const out = [];
   for (const agent of AGENT_NAMES) {
     for (const rel of PROJECT_DIRS[agent]) {
-      const dir = join31(root, rel);
+      const dir = join32(root, rel);
       if (exists(dir)) out.push({ agent, dir, scope: "project" });
     }
-    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join31(root, ".github", "copilot-instructions.md"))) {
+    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join32(root, ".github", "copilot-instructions.md"))) {
       out.push({
         agent,
-        dir: join31(root, ".github", "copilot"),
+        dir: join32(root, ".github", "copilot"),
         scope: "project"
       });
     }
@@ -18176,7 +18334,7 @@ function detectAgents(root, opts = {}) {
   if (opts.global && opts.home) {
     for (const agent of AGENT_NAMES) {
       for (const rel of HOME_DIRS[agent]) {
-        const dir = join31(opts.home, rel);
+        const dir = join32(opts.home, rel);
         if (exists(dir)) out.push({ agent, dir, scope: "global" });
       }
     }
@@ -18194,18 +18352,18 @@ function agentsFromFlag(value, root) {
   return {
     homes: wanted.map((agent) => ({
       agent,
-      dir: join31(root, PROJECT_DIRS[agent][0]),
+      dir: join32(root, PROJECT_DIRS[agent][0]),
       scope: "project"
     }))
   };
 }
 function skillsDirFor(home) {
-  return join31(home.dir, "skills");
+  return join32(home.dir, "skills");
 }
 function fallbackSkillsHome(root) {
-  return { agent: "codex", dir: join31(root, ".agents"), scope: "project" };
+  return { agent: "codex", dir: join32(root, ".agents"), scope: "project" };
 }
-function installedSkills(dir, exists = existsSync29, list = (p) => {
+function installedSkills(dir, exists = existsSync30, list = (p) => {
   try {
     return readdirSync6(p);
   } catch {
@@ -18213,7 +18371,7 @@ function installedSkills(dir, exists = existsSync29, list = (p) => {
   }
 }) {
   if (!exists(dir)) return [];
-  return list(dir).filter((name) => exists(join31(dir, name, "SKILL.md"))).sort();
+  return list(dir).filter((name) => exists(join32(dir, name, "SKILL.md"))).sort();
 }
 var RULES_BEGIN = "<!-- vos:begin (written by vos setup; the block is replaced on the next run) -->";
 var RULES_END = "<!-- vos:end -->";
@@ -18246,10 +18404,10 @@ ${RULES_BLOCK}
   }
   return { text, changed: text !== current };
 }
-function rulesFileFor(root, exists = existsSync29) {
-  const agents = join31(root, "AGENTS.md");
+function rulesFileFor(root, exists = existsSync30) {
+  const agents = join32(root, "AGENTS.md");
   if (exists(agents)) return agents;
-  const claude = join31(root, "CLAUDE.md");
+  const claude = join32(root, "CLAUDE.md");
   if (exists(claude)) return claude;
   return agents;
 }
@@ -18258,14 +18416,14 @@ function chromeCandidates(platform, env) {
     return ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"];
   if (platform === "win32")
     return [
-      join31(
+      join32(
         env["PROGRAMFILES"] ?? "C:\\Program Files",
         "Google",
         "Chrome",
         "Application",
         "chrome.exe"
       ),
-      join31(
+      join32(
         env["LOCALAPPDATA"] ?? "",
         "Google",
         "Chrome",
@@ -18303,6 +18461,12 @@ var NODE_MIN_MAJOR = 18;
 function major(version) {
   return parseInt(version.split(".")[0] ?? "0", 10);
 }
+function desktopLine(d) {
+  if (!d.available) return `not available (${d.reason})`;
+  if (!d.screenRecording)
+    return `vos-driver ${d.version}; Screen Recording not granted \u2717  switch it on for the app this runs from: System Settings, Privacy & Security, Screen & System Audio Recording`;
+  return `vos-driver ${d.version}; Screen Recording \u2713; Accessibility ${d.accessibility ? "\u2713" : "not granted (a press then carries no bounds, so its zoom cannot fit the control)"}`;
+}
 function credentialLine(facts) {
   const accounts = facts.accounts ?? [];
   const active = accounts.find((a) => a.active);
@@ -18341,6 +18505,7 @@ function doctorReport(facts) {
     lines.push("skills      none \u2717  run: npx vos setup");
   }
   lines.push(`credential  ${credentialLine(facts)}`);
+  if (facts.desktop) lines.push(`desktop     ${desktopLine(facts.desktop)}`);
   if (facts.devServer) {
     const d = facts.devServer;
     lines.push(
@@ -18361,7 +18526,7 @@ function doctorReport(facts) {
 }
 function bundledSkillsVersion(dir) {
   try {
-    const v = readFileSync11(join31(dir, "VERSION"), "utf8").trim();
+    const v = readFileSync11(join32(dir, "VERSION"), "utf8").trim();
     return /^\d+\.\d+\.\d+$/.test(v) ? v : null;
   } catch {
     return null;
@@ -18370,13 +18535,13 @@ function bundledSkillsVersion(dir) {
 function bundledSkillsDir(from) {
   let dir = dirname11(from);
   for (let i = 0; i < 6; i++) {
-    const pkg = join31(dir, "package.json");
-    if (existsSync29(pkg)) {
+    const pkg = join32(dir, "package.json");
+    if (existsSync30(pkg)) {
       try {
         const name = JSON.parse(readFileSync11(pkg, "utf8")).name;
         if (name === "@vosjs/cli") {
-          const skills = join31(dir, "skills");
-          return existsSync29(skills) && statSync9(skills).isDirectory() ? skills : null;
+          const skills = join32(dir, "skills");
+          return existsSync30(skills) && statSync9(skills).isDirectory() ? skills : null;
         }
       } catch {
       }
@@ -18389,7 +18554,7 @@ function bundledSkillsDir(from) {
 }
 
 // src/plugin/machineCmd.ts
-var BOOLEAN_FLAGS15 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS16 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "global",
@@ -18398,7 +18563,7 @@ var BOOLEAN_FLAGS15 = /* @__PURE__ */ new Set([
   "no-rules",
   "no-browser"
 ]);
-var LOGOUT_FLAGS = /* @__PURE__ */ new Set([...BOOLEAN_FLAGS15, "all"]);
+var LOGOUT_FLAGS = /* @__PURE__ */ new Set([...BOOLEAN_FLAGS16, "all"]);
 var SKILLS_SOURCE = "vosjs/skills";
 var SKILLS_CLI_VERSION = "1.7.2";
 function skillsCatalogAt(version) {
@@ -18413,7 +18578,7 @@ function npx() {
 function bundledChromium() {
   try {
     const p = chromium2.executablePath();
-    return p && existsSync30(p) ? p : null;
+    return p && existsSync31(p) ? p : null;
   } catch {
     return null;
   }
@@ -18422,7 +18587,7 @@ function probe2() {
   return probeBrowser({
     platform: process.platform,
     env: process.env,
-    exists: existsSync30,
+    exists: existsSync31,
     bundled: bundledChromium
   });
 }
@@ -18470,9 +18635,28 @@ async function doctorFacts(opts) {
     skills: skillsFacts(opts.homes),
     credential: safeResolve() !== null,
     accounts: storedAccounts(platformOrigin()),
-    ...opts.url ? { devServer: await devServerFact(opts.url) } : {}
+    ...opts.url ? { devServer: await devServerFact(opts.url) } : {},
+    desktop: await desktopFact()
   };
 }
+async function desktopFact() {
+  try {
+    const { check } = await import("@vosjs/driver");
+    const c = await check();
+    return {
+      available: true,
+      version: c.version,
+      screenRecording: c.screenRecording,
+      accessibility: c.accessibility
+    };
+  } catch (error) {
+    const message = error.message;
+    return {
+      available: false,
+      reason: (message ?? "the helper is not installed").replace(/\.$/, "")
+    };
+  }
+}
 function safeResolve() {
   try {
     return resolveCredential();
@@ -18487,7 +18671,7 @@ function storedAccounts(origin, store = DEFAULT_STORE) {
   }));
 }
 async function cmdSetup(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS15);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS16);
   const r = reporterFor(flags);
   const root = process.cwd();
   const global = flags.global === true;
@@ -18521,7 +18705,7 @@ async function cmdSetup(argv) {
         const dest = skillsDirFor(home);
         mkdirSync6(dest, { recursive: true });
         for (const name of installedSkills(dir)) {
-          cpSync(join32(dir, name), join32(dest, name), { recursive: true });
+          cpSync(join33(dir, name), join33(dest, name), { recursive: true });
         }
       }
     };
@@ -18589,7 +18773,7 @@ async function cmdSetup(argv) {
   let rules = null;
   if (!noRules) {
     const file = rulesFileFor(root);
-    const existing = existsSync30(file) ? readFileSync12(file, "utf8") : null;
+    const existing = existsSync31(file) ? readFileSync12(file, "utf8") : null;
     const { text, changed } = applyRulesBlock(existing);
     if (changed) writeFileSync6(file, text);
     rules = { file, changed };
@@ -18620,7 +18804,7 @@ Next: ${report.next_step}`
   return report.ok ? EXIT_OK : EXIT_NO_BROWSER;
 }
 async function cmdDoctor(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS15);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS16);
   const r = reporterFor(flags);
   const root = process.cwd();
   const homes = detectAgents(root, { home: homedir2(), global: true });
@@ -18639,7 +18823,7 @@ Next: ${report.next_step}`
   return report.ok ? EXIT_OK : EXIT_NO_BROWSER;
 }
 async function cmdWhoami(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS15);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS16);
   const r = reporterFor(flags);
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -18734,7 +18918,7 @@ async function cmdWhoami(argv) {
   return EXIT_OK;
 }
 function cmdSwitch(argv) {
-  const { flags, positionals } = parseArgs(argv, BOOLEAN_FLAGS15);
+  const { flags, positionals } = parseArgs(argv, BOOLEAN_FLAGS16);
   const r = reporterFor(flags);
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -18838,7 +19022,7 @@ function cmdLogout(argv) {
 }
 
 // src/plugin/run.ts
-var BOOLEAN_FLAGS16 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS17 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "wait",
@@ -18881,6 +19065,8 @@ Take pipeline
             --reuse, recording again into a take that has a cut: the cut (kept as doc.prev.json) goes onto the new footage as vos plan --reuse does; without it the take is planned fresh and its last line says where the cut is
   vos record --hosted --actions actions.json [--url <url>] [--out take] [--title "\u2026"] [--folder <id>] [--header name=value]... [--json]
             the take recorded on vos.so's fleet (no browser here): lands as a private vos with its doc and digest, then fetched into --out with its media
+  vos record --app <name|bundle id> [--out take] [--seconds <n>] [--max-duration <s>] [--background <slug|url|none>] [--json]
+            a desktop app's window (macOS), performed by whoever is at the machine: you or your agent's computer use works the app, and the take has no system pointer in its pixels and the pointer's path beside it, planned like a page take; Ctrl-C ends it, or --seconds; --window <id> names one window, vos record --windows lists what can be recorded; needs Screen Recording for the app this runs from (vos doctor says)
   vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--with <doc.json|vosId>[@end|@start|@step:<id>|@<s>]]... [--background <slug|url|none>] [--motion] [--headline "\u2026"] [--kicker "\u2026"] [--launch LAUNCH.md] [--brand BRAND.md] [--music <slug|mood|none>] [--entrance tilt-in|pull-out|rise|fade|slide|none] [--transitions slide|fade|scale|none] [--end-card on|none|<doc.json|vosId>] [--captions|--captions none] [--clicks none] [--still <t>] [--release v2.1] [--zooms per-beat] [--json]
             --zooms per-beat keeps at most one zoom per beat: the beats are the captioned steps of actions.json (each runs until the next one starts, plus the opening before the first); a step marked "zoom": true in actions.json is its beat's payoff, and the beat keeps the proposal that overlaps it most (one per marked step, never two overlapping), promoted to manual; a beat with no marked step keeps no zoom; when no step of the take is marked, each beat's last click, drag, type or paste stands in (the opening keeps none) and the done line says so; a step marked "zoom": false is never zoomed on; the rest go into doc.rejected like a person deleting them, and a beat with a manual zoom keeps only its manual ones. A media with no captioned step keeps its zooms as planned, and the done line says so
   vos render <take> [out.webm] [--width] [--height] [--fps] [--format webm|mp4] [--parallel N] [--range a..b] [--draft] [--frame <kind>] [--background <url|slug>] [--set <path=value>]... [--json]
@@ -19252,7 +19438,7 @@ lint-gated, so a bad override fails like a bad doc.json):
                        first ready loop (the house backdrop the studio opens on), or a flat ground offline
 `;
 async function loadActions(file) {
-  const raw = JSON.parse(await readFile19(file, "utf8"));
+  const raw = JSON.parse(await readFile20(file, "utf8"));
   const errors = validateActions(raw);
   if (!errors.length) errors.push(...jsSyntaxProblems(raw));
   if (errors.length)
@@ -19418,8 +19604,8 @@ function takeBrowserArgs(multi) {
 function takeStorageState(flags) {
   const raw = strFlag(flags, "storage-state");
   if (!raw) return void 0;
-  const path = resolve22(raw);
-  if (!existsSync31(path))
+  const path = resolve23(raw);
+  if (!existsSync32(path))
     throw new UsageError(`--storage-state: no such file: ${path}`);
   return path;
 }
@@ -19432,7 +19618,7 @@ function takeSessionName(flags, storageState) {
     throw new UsageError(
       "--session and --storage-state are two doors to one take: a persistent profile cannot take a storage state. Pass one"
     );
-  if (!existsSync31(sessionDir(name)))
+  if (!existsSync32(sessionDir(name)))
     throw new UsageError(
       `no session "${name}". Make one: vos session open <url> --name ${name} (a Chrome window opens; sign in and close it)`
     );
@@ -19450,21 +19636,21 @@ async function inSession(name, actions, fn) {
 }
 function reRecord(outDir, flags, r) {
   const wantsReuse = flags.reuse === true;
-  if (wantsReuse && !existsSync31(join33(outDir, "doc.json")))
+  if (wantsReuse && !existsSync32(join34(outDir, "doc.json")))
     throw new UsageError(
       `--reuse: ${outDir} has no cut to keep (no doc.json); record without --reuse`
     );
   let previousCut = null;
   return {
     prepare: async () => {
-      if (existsSync31(join33(outDir, "meta.json"))) {
+      if (existsSync32(join34(outDir, "meta.json"))) {
         const { prevDoc, kept } = await prepareReRecord(outDir);
-        if (prevDoc) previousCut = join33(outDir, PREV_DOC_NAME);
+        if (prevDoc) previousCut = join34(outDir, PREV_DOC_NAME);
         r.log(
           `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? wantsReuse ? "; the previous cut goes onto the new footage when it is recorded (--reuse)" : `; the previous cut is ${PREV_DOC_NAME}` : "")
         );
       }
-      await mkdir13(outDir, { recursive: true });
+      await mkdir14(outDir, { recursive: true });
       await ensureTakeDir(outDir);
     },
     plan: async (backdrop) => {
@@ -19474,7 +19660,7 @@ function reRecord(outDir, flags, r) {
         ...from ? {
           reuse: {
             from,
-            doc: JSON.parse(await readFile19(from, "utf8"))
+            doc: JSON.parse(await readFile20(from, "utf8"))
           }
         } : {}
       });
@@ -19543,9 +19729,10 @@ function wallGate(flags, r, opts) {
   };
 }
 async function cmdRecord(argv) {
+  if (isDesktopRecord(argv)) return cmdRecordApp(argv);
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS16,
+    BOOLEAN_FLAGS17,
     MULTI_FLAGS2
   );
   const actionsPath = strFlag(flags, "actions") ?? positionals[0];
@@ -19561,7 +19748,7 @@ async function cmdRecord(argv) {
   const scheme = urlSchemeProblem2(url);
   if (scheme) throw new UsageError(scheme);
   announceEnvNames(actions, r);
-  const outDir = resolve22(strFlag(flags, "out") ?? "take");
+  const outDir = resolve23(strFlag(flags, "out") ?? "take");
   const storageState = takeStorageState(flags);
   const sessionName = takeSessionName(flags, storageState);
   const browserArgs = takeBrowserArgs(multi);
@@ -19581,7 +19768,7 @@ async function cmdRecord(argv) {
       );
     const hostedActions = await scriptForHost(
       actions,
-      dirname12(resolve22(actionsPath))
+      dirname12(resolve23(actionsPath))
     ).catch((e) => {
       throw new UsageError(e instanceof Error ? e.message : String(e));
     });
@@ -19691,7 +19878,7 @@ async function cmdRecord(argv) {
         sessionName,
         actions,
         (context2) => recordTake(browser2, url, actions, takePaths(outDir), r.log, {
-          actionsDir: dirname12(resolve22(actionsPath)),
+          actionsDir: dirname12(resolve23(actionsPath)),
           storageState,
           headers,
           context: context2,
@@ -19757,7 +19944,7 @@ async function cmdRecord(argv) {
         ...flags["allow-wall"] === true ? ["--allow-wall"] : [],
         ...confirm.map((c) => `--confirm ${c}`),
         // A take that already has a cut keeps it on the new footage.
-        ...existsSync31(join33(outDir, "doc.json")) ? ["--reuse"] : []
+        ...existsSync32(join34(outDir, "doc.json")) ? ["--reuse"] : []
       ].join(" ");
       const nextOut = strFlag(flags, "out") ?? "take";
       const guardNote = !unconfirmed.ok ? unconfirmed.unconfirmed.length ? ` (it refuses until you add ${unconfirmed.unconfirmed.map((id) => `--confirm ${id}`).join(" ")}: ${unconfirmed.unconfirmed.length === 1 ? "that step spends" : "those steps spend"} something real)` : ` (${unconfirmed.unknown.map((c) => `--confirm ${c}`).join(", ")} names no guarded step)` : "";
@@ -19799,7 +19986,7 @@ ${lines.join("\n")}
       sessionName,
       actions,
       (context2) => recordTake(browser, url, actions, paths, r.log, {
-        actionsDir: dirname12(resolve22(actionsPath)),
+        actionsDir: dirname12(resolve23(actionsPath)),
         maxDurationSeconds,
         storageState,
         headers,
@@ -19887,7 +20074,7 @@ ${lines.join("\n")}
       },
       strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}${stepNote}${navTimeoutNote(rec)}${kept.line}${exposureNote(rec)}${noticeNote(rec)}` : `Take ready: ${outDir}
   ${(rec.meta.durationMs / 1e3).toFixed(1)}s \xB7 ${rec.frames.length} frames \xB7 ${rec.events.length} cursor events \xB7 ${clicks} clicks \xB7 ${plan.doc.zoom.length} zoom spans planned \xB7 ${rec.freezePct}% frozen \xB7 ${rec.dead.pct}% dead${deadWarns(rec.dead) ? " \u26A0 " + deadLine(rec.dead) : ""}${skippedNote}${stepNote}${navTimeoutNote(rec)}${pageSoundNote(rec)}${kept.line}
-  Next: ${kept.next ? `${kept.next}, then` : `edit ${join33(outDir, "doc.json")} (optional), then:`} vos render ${outDir}${exposureNote(rec)}${noticeNote(rec)}${teardownNote(rec)}`
+  Next: ${kept.next ? `${kept.next}, then` : `edit ${join34(outDir, "doc.json")} (optional), then:`} vos render ${outDir}${exposureNote(rec)}${noticeNote(rec)}${teardownNote(rec)}`
     );
     return strictFail ? EXIT_USAGE : EXIT_OK;
   } finally {
@@ -19897,7 +20084,7 @@ ${lines.join("\n")}
 async function cmdCreate2(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS16,
+    BOOLEAN_FLAGS17,
     MULTI_FLAGS2
   );
   const actionsPath = strFlag(flags, "actions");
@@ -19914,9 +20101,9 @@ async function cmdCreate2(argv) {
   const scheme = urlSchemeProblem2(url);
   if (scheme) throw new UsageError(scheme);
   announceEnvNames(actions, r);
-  const outDir = resolve22(strFlag(flags, "out") ?? "take");
+  const outDir = resolve23(strFlag(flags, "out") ?? "take");
   const format = videoFormat(strFlag(flags, "format"), positionals[0]);
-  const out = positionals[0] ?? join33(outDir, `out.${format}`);
+  const out = positionals[0] ?? join34(outDir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
     throw new UsageError("--parallel expects an integer between 1 and 16");
@@ -19938,7 +20125,7 @@ async function cmdCreate2(argv) {
       sessionName,
       actions,
       (context2) => recordTake(browser, url, actions, paths, r.log, {
-        actionsDir: dirname12(resolve22(actionsPath)),
+        actionsDir: dirname12(resolve23(actionsPath)),
         maxDurationSeconds,
         storageState,
         headers,
@@ -20055,7 +20242,7 @@ async function cmdPlan(argvIn) {
   const argv = bareCaptionsFlag(argvIn);
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS16,
+    BOOLEAN_FLAGS17,
     /* @__PURE__ */ new Set(["with"])
   );
   const dir = positionals[0];
@@ -20065,24 +20252,24 @@ async function cmdPlan(argvIn) {
     );
   const r = createReporter(flags.json === true);
   if (flags.fresh === true) {
-    await rm7(join33(dir, "doc.json"), { force: true });
+    await rm7(join34(dir, "doc.json"), { force: true });
     r.log("note: --fresh discarded the existing doc.json");
   }
   let reuse;
   if (flags.reuse === true) {
-    const from = resolve22(strFlag(flags, "from") ?? join33(dir, PREV_DOC_NAME));
-    if (!existsSync31(from)) {
+    const from = resolve23(strFlag(flags, "from") ?? join34(dir, PREV_DOC_NAME));
+    if (!existsSync32(from)) {
       throw new UsageError(
         `--reuse: ${from} does not exist \u2014 a re-record into this take writes doc.prev.json, or pass --from <doc.json>`
       );
     }
     reuse = {
       from,
-      doc: JSON.parse(await readFile19(from, "utf8"))
+      doc: JSON.parse(await readFile20(from, "utf8"))
     };
   }
   const style = await resolveStyleRef(flags);
-  const hasDoc = existsSync31(join33(dir, "doc.json"));
+  const hasDoc = existsSync32(join34(dir, "doc.json"));
   const backdrop = hasDoc ? null : await takeBackdrop(flags, r);
   const release = await releaseInputs(dir, flags, r, multi.with ?? []);
   const stepCaptions = strFlag(flags, "captions") === "steps";
@@ -20162,7 +20349,7 @@ async function cmdPlan(argvIn) {
     ${s.reuse.flagged.join("\n    ")}` : "") : "";
   r.done(
     {
-      take: resolve22(dir),
+      take: resolve23(dir),
       fresh: s.fresh,
       cursorKept: s.cursorKept,
       zoomAuto,
@@ -20176,7 +20363,7 @@ async function cmdPlan(argvIn) {
       ...captions ? { captions } : {},
       ...perBeat ? { perBeat } : {}
     },
-    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join33(dir, "doc.json")}: ${zoomAuto} auto + ${zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}${captionLines}${marksLine ? `
+    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join34(dir, "doc.json")}: ${zoomAuto} auto + ${zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}${captionLines}${marksLine ? `
   ${marksLine}` : ""}${perBeat ? `
   ${perBeatLine(perBeat)}` : ""}`
   );
@@ -20291,7 +20478,7 @@ async function releaseInputs(dir, flags, r, withRefs = []) {
 async function cmdRender(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS16,
+    BOOLEAN_FLAGS17,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -20301,7 +20488,7 @@ async function cmdRender(argv) {
     );
   const r = createReporter(flags.json === true);
   const format = videoFormat(strFlag(flags, "format"), positionals[1]);
-  const out = positionals[1] ?? join33(dir, `out.${format}`);
+  const out = positionals[1] ?? join34(dir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
     throw new UsageError("--parallel expects an integer between 1 and 16");
@@ -20359,7 +20546,7 @@ async function cmdRender(argv) {
 async function cmdFrames(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS16,
+    BOOLEAN_FLAGS17,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -20442,7 +20629,7 @@ async function cmdFrames(argv) {
 async function cmdDeliver(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS16,
+    BOOLEAN_FLAGS17,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -20542,15 +20729,15 @@ async function resolveStyleRef(flags) {
 }
 async function resolveDocRef(ref, flags, what) {
   const styleRef = ref;
-  const file = existsSync31(styleRef) ? resolve22(
+  const file = existsSync32(styleRef) ? resolve23(
     styleRef,
-    existsSync31(join33(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync32(join34(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync31(file)) {
+  if (file && existsSync32(file)) {
     return {
       from: file,
       doc: migrateHostedDoc4(
-        JSON.parse(await readFile19(file, "utf8"))
+        JSON.parse(await readFile20(file, "utf8"))
       )
     };
   }
@@ -20592,7 +20779,7 @@ async function officialTemplate(origin, ref) {
   }
 }
 async function cmdDigest(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS16);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS17);
   const dir = positionals[0];
   if (!dir)
     throw new UsageError(
@@ -20602,7 +20789,7 @@ async function cmdDigest(argv) {
   const take = await loadTake(dir);
   if (!take.doc) throw new UsageError(`${dir} has no doc.json \u2014 run plan first`);
   const transcriptPath = strFlag(flags, "transcript");
-  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile19(transcriptPath, "utf8"))) : null;
+  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile20(transcriptPath, "utf8"))) : null;
   const style = await resolveStyleRef(flags);
   const noFrames = flags["no-frames"] === true;
   let browser = null;
@@ -20633,7 +20820,7 @@ async function cmdDigest(argv) {
         kinds,
         frames: d.images.full,
         crops: d.images.crop,
-        sheet: d.images.sheet ? join33(result.outDir, d.images.sheet) : null,
+        sheet: d.images.sheet ? join34(result.outDir, d.images.sheet) : null,
         scenes: kinds.scene ?? 0,
         sourceDuration: d.take.sourceDuration,
         outputDuration: d.take.outputDuration,
@@ -20656,19 +20843,19 @@ async function cmdDigest(argv) {
   }
 }
 async function cmdOpen(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS16);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS17);
   const dir = positionals[0];
   if (!dir) throw new UsageError("vos open <take> [--studio <url>]");
   const r = createReporter(flags.json === true);
   const take = await loadTake(dir);
-  if (!existsSync31(take.paths.recording)) {
+  if (!existsSync32(take.paths.recording)) {
     throw new UsageError(`${dir} has no recording \u2014 re-run record`);
   }
   const studio = (strFlag(flags, "studio") ?? platformOrigin()).replace(
     /\/+$/,
     ""
   );
-  const server = await startTakeServer(resolve22(dir), {});
+  const server = await startTakeServer(resolve23(dir), {});
   const url = `${studio}/studio?take=${encodeURIComponent(server.base)}`;
   r.event({ event: "open", server: server.base, url });
   r.log(`take served at ${server.base}`);
@@ -20691,7 +20878,7 @@ async function cmdOpen(argv) {
   return EXIT_OK;
 }
 async function cmdCallout(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS16);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS17);
   const dir = positionals[0];
   const shape = positionals[1];
   if (!dir || !shape || !isCalloutShape(shape))
@@ -20715,7 +20902,7 @@ async function cmdCallout(argv) {
       `no register: put a BRAND.md beside the take (vos brand <url> --out BRAND.md; its bgA and accent are the ground and the accent), or pass --ground #hex --accent #hex`
     );
   const codeFile = strFlag(flags, "code-file");
-  const code = codeFile ? await readFile19(codeFile, "utf8") : strFlag(flags, "code");
+  const code = codeFile ? await readFile20(codeFile, "utf8") : strFlag(flags, "code");
   const words2 = {
     kicker: strFlag(flags, "kicker"),
     title: strFlag(flags, "title"),
@@ -20790,11 +20977,11 @@ async function cmdCallout(argv) {
   return EXIT_OK;
 }
 async function cmdValidate(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS16);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS17);
   const target = positionals[0];
   if (!target) throw new UsageError("vos validate <actions.json|take>");
   const r = createReporter(flags.json === true);
-  const kitTarget = target.endsWith("kit.json") ? target : existsSync31(join33(target, "kit.json")) && !isTakeDir(target) ? join33(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync32(join34(target, "kit.json")) && !isTakeDir(target) ? join34(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -20826,9 +21013,9 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync31(join33(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync32(join34(target, "config.json"))) {
     const parsed = JSON.parse(
-      await readFile19(join33(target, "config.json"), "utf8")
+      await readFile20(join34(target, "config.json"), "utf8")
     );
     const pre = preflightConfig(parsed);
     const problems2 = pre.ok ? [] : pre.issues.map((i) => `config.json: ${i}`);
@@ -20870,7 +21057,7 @@ async function cmdValidate(argv) {
   const problems = [];
   const warnings = [];
   const notes = [];
-  if (!existsSync31(take.paths.recording)) {
+  if (!existsSync32(take.paths.recording)) {
     problems.push("missing recording (re-run record)");
   } else {
     const mismatch = containerMismatch(
@@ -20911,7 +21098,7 @@ async function cmdValidate(argv) {
       const found = localFile(rel, target);
       if (!("refused" in found)) continue;
       problems.push(
-        existsSync31(resolve22(target, rel)) ? `doc.json: ${ref.where}: ${ref.key} ${found.refused}` : `doc.json: ${ref.where}: ${ref.key} is not a file in the take, so a render plays the film without it (put the file there, or fix the key)`
+        existsSync32(resolve23(target, rel)) ? `doc.json: ${ref.where}: ${ref.key} ${found.refused}` : `doc.json: ${ref.where}: ${ref.key} is not a file in the take, so a render plays the film without it (put the file there, or fix the key)`
       );
     }
     if (flags.picture === true && (take.doc.overlays ?? []).some((o) => o.kind === "html")) {
@@ -20980,7 +21167,7 @@ async function cmdValidate(argv) {
 async function cmdPush3(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS16,
+    BOOLEAN_FLAGS17,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -20990,7 +21177,7 @@ async function cmdPush3(argv) {
     );
   const refusal = takePushRefusal({
     vos: strFlag(flags, "vos"),
-    trackedVosId: readSyncState(resolve22(dir))?.vosId ?? null,
+    trackedVosId: readSyncState(resolve23(dir))?.vosId ?? null,
     programOnly: ["slug", "tags", "base", "remix-of", "still"].filter(
       (name) => hasFlag(flags, name)
     )
@@ -21009,7 +21196,7 @@ async function cmdPush3(argv) {
         `--claimable creates a NEW claimable vos; ${iterating.map((f) => `--${f}`).join(", ")} ${iterating.length > 1 ? "apply" : "applies"} to a keyed push`
       );
     const claim = await pushTakeClaimable(
-      resolve22(dir),
+      resolve23(dir),
       {
         api: strFlag(flags, "api"),
         origin: strFlag(flags, "origin"),
@@ -21033,7 +21220,7 @@ reference and the only credential.`
   }
   const overrides = multi.override;
   const result = await pushTake(
-    resolve22(dir),
+    resolve23(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -21085,11 +21272,11 @@ ${landedLines(landed)}` : "")
   return EXIT_OK;
 }
 async function cmdPull2(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS16, MULTI_FLAGS2);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS17, MULTI_FLAGS2);
   const dir = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
   const result = await pullTake(
-    resolve22(dir),
+    resolve23(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -21270,7 +21457,7 @@ function verdictExit(v, strict, none) {
 async function cmdSession(argv) {
   const { positionals, flags } = parseArgs(
     argv,
-    /* @__PURE__ */ new Set([...BOOLEAN_FLAGS16, "headed"])
+    /* @__PURE__ */ new Set([...BOOLEAN_FLAGS17, "headed"])
   );
   const [sub, arg] = positionals;
   const r = createReporter(flags.json === true);
@@ -21315,7 +21502,7 @@ async function cmdSession(argv) {
       if (!arg) throw new UsageError(usage);
       const bad = sessionNameVerdict(arg);
       if (bad) throw new UsageError(bad);
-      if (!existsSync31(sessionDir(arg)))
+      if (!existsSync32(sessionDir(arg)))
         throw new UsageError(`no session "${arg}" (vos session list)`);
       const summary3 = await summarizeSession(arg);
       const url = strFlag(flags, "url");
@@ -21349,7 +21536,7 @@ async function cmdSession(argv) {
       if (!arg || !scriptPath) throw new UsageError(usage);
       const bad = sessionNameVerdict(arg);
       if (bad) throw new UsageError(bad);
-      if (!existsSync31(sessionDir(arg)))
+      if (!existsSync32(sessionDir(arg)))
         throw new UsageError(`no session "${arg}" (vos session list)`);
       const url = strFlag(flags, "url");
       if (url && !/^https?:\/\//.test(url))
@@ -21434,6 +21621,7 @@ export {
   convertAgentBrowser,
   MULTI_FLAGS2 as MULTI_FLAGS,
   HELP,
+  maxDuration,
   strictFails,
   takeBrowserArgs,
   reRecord,
@@ -21442,4 +21630,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-ACWV3Y6Y.js.map
+//# sourceMappingURL=chunk-BHWDA2KG.js.map