@vosjs/cli 0.49.0 → 0.50.0

package/dist/{chunk-TAWRT7UM.js → chunk-SE4F3OMQ.js}

@@ -12,9 +12,9 @@ import {
 } from "./chunk-72ADTMWW.js";
 
 // src/plugin/run.ts
-import { mkdir as mkdir10, readFile as readFile15, rm as rm5 } from "fs/promises";
-import { existsSync as existsSync18 } from "fs";
-import { join as join21, resolve as resolve9 } from "path";
+import { mkdir as mkdir11, readFile as readFile16, rm as rm5 } from "fs/promises";
+import { existsSync as existsSync19 } from "fs";
+import { join as join22, resolve as resolve10 } from "path";
 import {
   END_CARD_FROM as END_CARD_FROM2,
   docOutputDuration as docOutputDuration3,
@@ -2213,10 +2213,10 @@ function startTakeServer(rootDir, pages) {
     res.writeHead(404).end();
   });
   return new Promise(
-    (resolve10) => server.listen(0, () => {
+    (resolve11) => server.listen(0, () => {
       const addr = server.address();
       const port = typeof addr === "object" && addr ? addr.port : 0;
-      resolve10({ base: `http://localhost:${port}`, close: () => server.close() });
+      resolve11({ base: `http://localhost:${port}`, close: () => server.close() });
     })
   );
 }
@@ -6554,10 +6554,10 @@ async function openSession(name, url, opts = { log: () => {
   opts.log(
     `a Chrome window opened on session "${name}": sign in to ${new URL(url).host}, ${leave}`
   );
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     const child = spawn(exe, args, { stdio: "ignore" });
     child.on("error", reject);
-    child.on("exit", (code) => resolve10({ code }));
+    child.on("exit", (code) => resolve11({ code }));
   });
 }
 async function withSession(name, fn, opts = {}) {
@@ -9890,8 +9890,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: readFile16 } = await import("fs/promises");
-  const text = await readFile16(resolve8(input), "utf8");
+  const { readFile: readFile17 } = await import("fs/promises");
+  const text = await readFile17(resolve8(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -9928,9 +9928,9 @@ function summary(result) {
 }
 async function cmdActionsScript(input, flags) {
   const r = createReporter(flags.json === true);
-  const { readFile: readFile16 } = await import("fs/promises");
+  const { readFile: readFile17 } = await import("fs/promises");
   const { shotList, formatShotList } = await import("./shotList-IYFDHSIK.js");
-  const raw = JSON.parse(await readFile16(resolve8(input), "utf8"));
+  const raw = JSON.parse(await readFile17(resolve8(input), "utf8"));
   const errors = validateActions(raw);
   if (errors.length) throw new UsageError(`${input}:
   ${errors.join("\n  ")}`);
@@ -9939,23 +9939,232 @@ async function cmdActionsScript(input, flags) {
   return EXIT_OK;
 }
 
+// src/plugin/ingest.ts
+import { existsSync as existsSync16 } from "fs";
+import { copyFile, mkdir as mkdir10, readFile as readFile15, stat as stat4 } from "fs/promises";
+import { basename as basename7, join as join19, resolve as resolve9 } from "path";
+import { inflateRawSync } from "zlib";
+import {
+  cursorFromPlaywrightTrace,
+  cursorFromTrace,
+  playwrightTraceEntry,
+  traceKindOf,
+  zipEntries,
+  zipEntryBytes
+} from "@vosjs/studio-core";
+import {
+  ALL_FORMATS,
+  Conversion,
+  FilePathSource,
+  FilePathTarget,
+  Input,
+  Mp4OutputFormat,
+  Output,
+  WebMOutputFormat
+} from "mediabunny";
+var BOOLEAN_FLAGS5 = /* @__PURE__ */ new Set(["json", "help"]);
+async function probeVideoFile(path) {
+  const input = new Input({
+    source: new FilePathSource(path),
+    formats: ALL_FORMATS
+  });
+  try {
+    const format = await input.getFormat();
+    const video = await input.getPrimaryVideoTrack();
+    if (!video) throw new UsageError(`${path} has no video track`);
+    const [duration, stats, audio] = await Promise.all([
+      input.computeDuration(),
+      video.computePacketStats(240),
+      input.getPrimaryAudioTrack()
+    ]);
+    const mimeType = format.mimeType;
+    const ext = mimeType.includes("mp4") ? "mp4" : mimeType.includes("quicktime") ? "mov" : "webm";
+    return {
+      width: video.displayWidth,
+      height: video.displayHeight,
+      durationMs: Math.round(duration * 1e3),
+      fps: Math.round(stats.averagePacketRate * 100) / 100,
+      hasAudio: !!audio,
+      mimeType,
+      ext
+    };
+  } finally {
+    await input.dispose?.();
+  }
+}
+async function copyRecording(src, dest, ext) {
+  if (ext === "mov") {
+    await copyFile(src, dest);
+    return false;
+  }
+  const input = new Input({
+    source: new FilePathSource(src),
+    formats: ALL_FORMATS
+  });
+  const target = new FilePathTarget(dest);
+  const output = new Output({
+    format: ext === "mp4" ? new Mp4OutputFormat({ fastStart: "in-memory" }) : new WebMOutputFormat(),
+    target
+  });
+  try {
+    const conversion = await Conversion.init({ input, output });
+    if (!conversion.isValid || conversion.discardedTracks.length > 0) {
+      await conversion.cancel?.();
+      await copyFile(src, dest);
+      return false;
+    }
+    await conversion.execute();
+    return true;
+  } catch {
+    await copyFile(src, dest);
+    return false;
+  } finally {
+    await input.dispose?.();
+  }
+}
+async function readTraceFile(path, offsetMs) {
+  const kind = traceKindOf(basename7(path));
+  if (!kind) {
+    throw new UsageError(
+      `${path}: not a trace the recorder reads (trace.zip, .trace, .jsonl, .json or .csv)`
+    );
+  }
+  if (kind === "zip") {
+    const bytes = new Uint8Array(await readFile15(path));
+    const entry = playwrightTraceEntry(zipEntries(bytes));
+    if (!entry) {
+      throw new UsageError(
+        `${path}: no trace.trace inside; a Playwright trace.zip is what --cursor reads as a zip`
+      );
+    }
+    const raw = zipEntryBytes(bytes, entry);
+    const text2 = new TextDecoder().decode(
+      entry.method === 8 ? new Uint8Array(inflateRawSync(raw)) : raw
+    );
+    return cursorFromPlaywrightTrace(text2, { offsetMs });
+  }
+  const text = await readFile15(path, "utf8");
+  return cursorFromTrace(basename7(path), text, { offsetMs });
+}
+function parseViewport(v) {
+  if (!v) return null;
+  const m = /^(\d+)x(\d+)$/i.exec(v.trim());
+  if (!m) throw new UsageError("--viewport expects WxH, like 1280x720");
+  return { width: Number(m[1]), height: Number(m[2]) };
+}
+async function cmdIngest(argv) {
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS5, MULTI_FLAGS2);
+  const source = positionals[0];
+  if (!source)
+    throw new UsageError(
+      "vos ingest <video.webm|mp4> [--cursor <trace.zip|steps.jsonl|cursor.csv>] [--out take] [--offset <ms>] [--viewport WxH] [--background <slug|url|none>] [--json]"
+    );
+  const videoPath = resolve9(source);
+  if (!existsSync16(videoPath)) throw new UsageError(`${source}: no such file`);
+  const r = createReporter(flags.json === true);
+  const outDir = resolve9(strFlag(flags, "out") ?? "take");
+  const offsetMs = numFlag(flags, "offset", 0);
+  const viewportFlag = parseViewport(strFlag(flags, "viewport"));
+  const cursorPath = strFlag(flags, "cursor");
+  const backdrop = await takeBackdrop(flags, r);
+  r.log(`probing ${basename7(videoPath)}\u2026`);
+  const probed = await probeVideoFile(videoPath);
+  if (!(probed.durationMs > 0)) {
+    throw new UsageError(
+      `${source}: the file reports no duration; a stream-shaped recording needs its container fixed first (ffmpeg -i in.webm -c copy out.webm)`
+    );
+  }
+  let trace = null;
+  if (cursorPath) {
+    trace = await readTraceFile(resolve9(cursorPath), offsetMs);
+    for (const n of trace.notes) r.log(`note: ${n}`);
+  }
+  if (existsSync16(join19(outDir, "meta.json"))) {
+    const { prevDoc, kept } = await prepareReRecord(outDir);
+    r.log(
+      `note: re-ingesting into ${outDir}; kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? `; apply the previous cut with: vos plan ${outDir} --reuse` : "")
+    );
+  }
+  await mkdir10(outDir, { recursive: true });
+  const paths = await ensureTakeDir(outDir);
+  const recording = join19(outDir, `recording.${probed.ext}`);
+  r.log("copying the recording\u2026");
+  const remuxed = await copyRecording(videoPath, recording, probed.ext);
+  const viewport = viewportFlag ?? trace?.viewport ?? {
+    width: probed.width,
+    height: probed.height
+  };
+  const events = trace?.events ?? [];
+  const fileStat = await stat4(videoPath);
+  const meta = {
+    dpr: 1,
+    zoom: 1,
+    t0: trace?.t0 ?? Math.round(fileStat.mtimeMs),
+    durationMs: probed.durationMs,
+    width: viewport.width,
+    height: viewport.height,
+    captureWidth: probed.width,
+    captureHeight: probed.height,
+    fps: probed.fps > 0 ? probed.fps : 30,
+    hasAudio: probed.hasAudio,
+    producer: "ingest",
+    ...events.length ? { captureSurface: "tab" } : {}
+  };
+  await writeJson(paths.meta, meta, true);
+  if (events.length) await writeJson(paths.cursor, events);
+  const plan = await planTake(outDir, { backdrop });
+  const clicks = events.filter((e) => e.type === "down").length;
+  const seconds = (probed.durationMs / 1e3).toFixed(1);
+  const facts = `${seconds}s, ${probed.width}\xD7${probed.height} @ ${meta.fps} fps${probed.hasAudio ? ", audio" : ", no audio"}${remuxed ? "" : ", copied as is"}`;
+  const cursorLine = trace ? `${events.length} cursor events (${clicks} clicks) from ${basename7(cursorPath)}${trace.dropped ? `, ${trace.dropped} not placed` : ""}; ${plan.zoomAuto} zoom${plan.zoomAuto === 1 ? "" : "s"} planned` : "no cursor track, so nothing was planned";
+  const next = trace ? `Next: vos digest ${outDir} \u2014 look before you cut; edit doc.json; vos push ${outDir}` : `Add --cursor <trace> recorded beside the video (a Playwright trace.zip, stamped JSON records, or a t,x,y,type CSV) to plan zooms from its clicks; else place them by eye: vos frames ${outDir} --times 0,25%,50%,75%,100%, then edit doc.json`;
+  r.done(
+    {
+      out: outDir,
+      recording: basename7(recording),
+      durationMs: probed.durationMs,
+      width: probed.width,
+      height: probed.height,
+      viewport,
+      fps: meta.fps,
+      hasAudio: probed.hasAudio,
+      remuxed,
+      cursor: trace ? {
+        file: basename7(cursorPath),
+        kind: trace.kind,
+        events: events.length,
+        clicks,
+        placed: trace.placed,
+        dropped: trace.dropped,
+        notes: trace.notes
+      } : null,
+      zooms: plan.zoomAuto,
+      backdrop: plan.backdrop ?? null
+    },
+    `Ingested ${basename7(videoPath)} \u2192 ${outDir}/${basename7(recording)} (${facts})
+  ${cursorLine}
+  ${next}`
+  );
+  return EXIT_OK;
+}
+
 // src/plugin/machineCmd.ts
 import { spawnSync } from "child_process";
 import {
   cpSync,
-  existsSync as existsSync17,
+  existsSync as existsSync18,
   mkdirSync as mkdirSync3,
   readFileSync as readFileSync7,
   rmSync as rmSync2,
   writeFileSync as writeFileSync3
 } from "fs";
 import { homedir as homedir3 } from "os";
-import { join as join20 } from "path";
+import { join as join21 } from "path";
 import { chromium as chromium2 } from "playwright";
 
 // src/plugin/machine.ts
-import { existsSync as existsSync16, readFileSync as readFileSync6, readdirSync as readdirSync4, statSync as statSync4 } from "fs";
-import { dirname as dirname5, join as join19 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync6, readdirSync as readdirSync4, statSync as statSync4 } from "fs";
+import { dirname as dirname5, join as join20 } from "path";
 var AGENT_NAMES = [
   "claude",
   "cursor",
@@ -9975,17 +10184,17 @@ var HOME_DIRS = {
   copilot: [".copilot"]
 };
 function detectAgents(root, opts = {}) {
-  const exists = opts.exists ?? existsSync16;
+  const exists = opts.exists ?? existsSync17;
   const out = [];
   for (const agent of AGENT_NAMES) {
     for (const rel of PROJECT_DIRS[agent]) {
-      const dir = join19(root, rel);
+      const dir = join20(root, rel);
       if (exists(dir)) out.push({ agent, dir, scope: "project" });
     }
-    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join19(root, ".github", "copilot-instructions.md"))) {
+    if (agent === "copilot" && !out.some((h) => h.agent === "copilot") && exists(join20(root, ".github", "copilot-instructions.md"))) {
       out.push({
         agent,
-        dir: join19(root, ".github", "copilot"),
+        dir: join20(root, ".github", "copilot"),
         scope: "project"
       });
     }
@@ -9993,7 +10202,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 = join19(opts.home, rel);
+        const dir = join20(opts.home, rel);
         if (exists(dir)) out.push({ agent, dir, scope: "global" });
       }
     }
@@ -10011,18 +10220,18 @@ function agentsFromFlag(value, root) {
   return {
     homes: wanted.map((agent) => ({
       agent,
-      dir: join19(root, PROJECT_DIRS[agent][0]),
+      dir: join20(root, PROJECT_DIRS[agent][0]),
       scope: "project"
     }))
   };
 }
 function skillsDirFor(home) {
-  return join19(home.dir, "skills");
+  return join20(home.dir, "skills");
 }
 function fallbackSkillsHome(root) {
-  return { agent: "codex", dir: join19(root, ".agents"), scope: "project" };
+  return { agent: "codex", dir: join20(root, ".agents"), scope: "project" };
 }
-function installedSkills(dir, exists = existsSync16, list = (p) => {
+function installedSkills(dir, exists = existsSync17, list = (p) => {
   try {
     return readdirSync4(p);
   } catch {
@@ -10030,7 +10239,7 @@ function installedSkills(dir, exists = existsSync16, list = (p) => {
   }
 }) {
   if (!exists(dir)) return [];
-  return list(dir).filter((name) => exists(join19(dir, name, "SKILL.md"))).sort();
+  return list(dir).filter((name) => exists(join20(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 -->";
@@ -10062,10 +10271,10 @@ ${RULES_BLOCK}
   }
   return { text, changed: text !== current };
 }
-function rulesFileFor(root, exists = existsSync16) {
-  const agents = join19(root, "AGENTS.md");
+function rulesFileFor(root, exists = existsSync17) {
+  const agents = join20(root, "AGENTS.md");
   if (exists(agents)) return agents;
-  const claude = join19(root, "CLAUDE.md");
+  const claude = join20(root, "CLAUDE.md");
   if (exists(claude)) return claude;
   return agents;
 }
@@ -10074,14 +10283,14 @@ function chromeCandidates(platform, env) {
     return ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"];
   if (platform === "win32")
     return [
-      join19(
+      join20(
         env["PROGRAMFILES"] ?? "C:\\Program Files",
         "Google",
         "Chrome",
         "Application",
         "chrome.exe"
       ),
-      join19(
+      join20(
         env["LOCALAPPDATA"] ?? "",
         "Google",
         "Chrome",
@@ -10168,13 +10377,13 @@ function doctorReport(facts) {
 function bundledSkillsDir(from) {
   let dir = dirname5(from);
   for (let i = 0; i < 6; i++) {
-    const pkg = join19(dir, "package.json");
-    if (existsSync16(pkg)) {
+    const pkg = join20(dir, "package.json");
+    if (existsSync17(pkg)) {
       try {
         const name = JSON.parse(readFileSync6(pkg, "utf8")).name;
         if (name === "@vosjs/cli") {
-          const skills = join19(dir, "skills");
-          return existsSync16(skills) && statSync4(skills).isDirectory() ? skills : null;
+          const skills = join20(dir, "skills");
+          return existsSync17(skills) && statSync4(skills).isDirectory() ? skills : null;
         }
       } catch {
       }
@@ -10187,7 +10396,7 @@ function bundledSkillsDir(from) {
 }
 
 // src/plugin/machineCmd.ts
-var BOOLEAN_FLAGS5 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS6 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "global",
@@ -10205,7 +10414,7 @@ function npx() {
 function bundledChromium() {
   try {
     const p = chromium2.executablePath();
-    return p && existsSync17(p) ? p : null;
+    return p && existsSync18(p) ? p : null;
   } catch {
     return null;
   }
@@ -10214,7 +10423,7 @@ function probe() {
   return probeBrowser({
     platform: process.platform,
     env: process.env,
-    exists: existsSync17,
+    exists: existsSync18,
     bundled: bundledChromium
   });
 }
@@ -10265,7 +10474,7 @@ async function doctorFacts(opts) {
   };
 }
 async function cmdSetup(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS5);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS6);
   const r = reporterFor(flags);
   const root = process.cwd();
   const global = flags.global === true;
@@ -10318,7 +10527,7 @@ async function cmdSetup(argv) {
         const dest = skillsDirFor(home);
         mkdirSync3(dest, { recursive: true });
         for (const name of installedSkills(bundled)) {
-          cpSync(join20(bundled, name), join20(dest, name), { recursive: true });
+          cpSync(join21(bundled, name), join21(dest, name), { recursive: true });
         }
       }
       skillsVia = "bundled";
@@ -10353,7 +10562,7 @@ async function cmdSetup(argv) {
   let rules = null;
   if (!noRules) {
     const file = rulesFileFor(root);
-    const existing = existsSync17(file) ? readFileSync7(file, "utf8") : null;
+    const existing = existsSync18(file) ? readFileSync7(file, "utf8") : null;
     const { text, changed } = applyRulesBlock(existing);
     if (changed) writeFileSync3(file, text);
     rules = { file, changed };
@@ -10384,7 +10593,7 @@ Next: ${report.next_step}`
   return report.ok ? EXIT_OK : EXIT_NO_BROWSER;
 }
 async function cmdDoctor(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS5);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS6);
   const r = reporterFor(flags);
   const root = process.cwd();
   const homes = detectAgents(root, { home: homedir3(), global: true });
@@ -10403,7 +10612,7 @@ Next: ${report.next_step}`
   return report.ok ? EXIT_OK : EXIT_NO_BROWSER;
 }
 async function cmdWhoami(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS5);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS6);
   const r = reporterFor(flags);
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -10465,9 +10674,9 @@ async function cmdWhoami(argv) {
   return EXIT_OK;
 }
 function cmdLogout(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS5);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS6);
   const r = reporterFor(flags);
-  const had = existsSync17(CREDENTIALS_PATH);
+  const had = existsSync18(CREDENTIALS_PATH);
   rmSync2(CREDENTIALS_PATH, { force: true });
   const envKey = Boolean(process.env.VOS_API_KEY?.trim());
   r.done(
@@ -10483,7 +10692,7 @@ function cmdLogout(argv) {
 }
 
 // src/plugin/run.ts
-var BOOLEAN_FLAGS6 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS7 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "picture",
@@ -10526,6 +10735,8 @@ Take pipeline
   vos validate <actions.json|take|kit.json> [--picture] [--json]
   vos judge <kit.json> --against <MANIFEST.json> [--out dir] [--json]
   vos actions from-agent-browser <steps.jsonl> [--out actions.json] [--url <url>] [--viewport WxH] [--json]
+  vos ingest <video.webm|mp4> [--cursor <trace.zip|steps.jsonl|cursor.csv>] [--out take] [--offset <ms>] [--viewport WxH] [--background <slug|url|none>] [--json]
+            a take from a recording someone else made (a cloud agent's PR video, a Playwright run's video, a Loom export): the file becomes recording.<container>, meta.json from its own dimensions and duration, and a trace beside it becomes cursor.json so the planner has clicks to zoom on; without one, nothing is planned and the done event says so
   vos session open <url> --name <app>   a plain Chrome window on a vos-owned profile; sign in, close it
   vos session check <name> [--url <url>]   headless: does the session still open the page? exit 0/4
   vos session list | rm <name>          what exists and how old; delete one
@@ -10783,7 +10994,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 readFile15(file, "utf8"));
+  const raw = JSON.parse(await readFile16(file, "utf8"));
   const errors = validateActions(raw);
   if (errors.length)
     throw new UsageError(`invalid actions file:
@@ -10845,8 +11056,8 @@ function takeBrowserArgs(multi) {
 function takeStorageState(flags) {
   const raw = strFlag(flags, "storage-state");
   if (!raw) return void 0;
-  const path = resolve9(raw);
-  if (!existsSync18(path))
+  const path = resolve10(raw);
+  if (!existsSync19(path))
     throw new UsageError(`--storage-state: no such file: ${path}`);
   return path;
 }
@@ -10859,7 +11070,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 (!existsSync18(sessionDir(name)))
+  if (!existsSync19(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)`
     );
@@ -10915,7 +11126,7 @@ function wallGate(flags, r, opts) {
 async function cmdRecord(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS6,
+    BOOLEAN_FLAGS7,
     MULTI_FLAGS2
   );
   const actionsPath = strFlag(flags, "actions") ?? positionals[0];
@@ -10928,7 +11139,7 @@ async function cmdRecord(argv) {
   const url = strFlag(flags, "url") ?? actions.url;
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
-  const outDir = resolve9(strFlag(flags, "out") ?? "take");
+  const outDir = resolve10(strFlag(flags, "out") ?? "take");
   const storageState = takeStorageState(flags);
   const sessionName = takeSessionName(flags, storageState);
   const browserArgs = takeBrowserArgs(multi);
@@ -11082,13 +11293,13 @@ ${lines.join("\n")}
   }
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync18(join21(outDir, "meta.json"))) {
+    if (existsSync19(join22(outDir, "meta.json"))) {
       const { prevDoc, kept } = await prepareReRecord(outDir);
       r.log(
         `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? "; apply the previous cut to the new footage with: vos plan " + outDir + " --reuse" : "")
       );
     }
-    await mkdir10(outDir, { recursive: true });
+    await mkdir11(outDir, { recursive: true });
     await ensureTakeDir(outDir);
   };
   const browser = await launchBrowser(browserArgs);
@@ -11147,7 +11358,7 @@ ${lines.join("\n")}
       },
       strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}${exposureNote(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}
-  Next: edit ${join21(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}`
+  Next: edit ${join22(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}`
     );
     return strictFail ? EXIT_USAGE : EXIT_OK;
   } finally {
@@ -11157,7 +11368,7 @@ ${lines.join("\n")}
 async function cmdCreate2(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS6,
+    BOOLEAN_FLAGS7,
     MULTI_FLAGS2
   );
   const actionsPath = strFlag(flags, "actions");
@@ -11171,12 +11382,12 @@ async function cmdCreate2(argv) {
   const url = strFlag(flags, "url") ?? actions.url;
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
-  const outDir = resolve9(strFlag(flags, "out") ?? "take");
+  const outDir = resolve10(strFlag(flags, "out") ?? "take");
   const fmtRaw = strFlag(flags, "format") ?? "webm";
   if (fmtRaw !== "webm" && fmtRaw !== "mp4")
     throw new UsageError("--format must be webm or mp4");
   const format = fmtRaw;
-  const out = positionals[0] ?? join21(outDir, `out.${format}`);
+  const out = positionals[0] ?? join22(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");
@@ -11189,13 +11400,13 @@ async function cmdCreate2(argv) {
   const headers = takeHeaders(multi);
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync18(join21(outDir, "meta.json"))) {
+    if (existsSync19(join22(outDir, "meta.json"))) {
       const { prevDoc, kept } = await prepareReRecord(outDir);
       r.log(
         `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? "; apply the previous cut to the new footage with: vos plan " + outDir + " --reuse" : "")
       );
     }
-    await mkdir10(outDir, { recursive: true });
+    await mkdir11(outDir, { recursive: true });
     await ensureTakeDir(outDir);
   };
   const browser = await launchBrowser(browserArgs);
@@ -11286,7 +11497,7 @@ async function cmdCreate2(argv) {
 async function cmdPlan(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS6,
+    BOOLEAN_FLAGS7,
     /* @__PURE__ */ new Set(["with"])
   );
   const dir = positionals[0];
@@ -11296,24 +11507,24 @@ async function cmdPlan(argv) {
     );
   const r = createReporter(flags.json === true);
   if (flags.fresh === true) {
-    await rm5(join21(dir, "doc.json"), { force: true });
+    await rm5(join22(dir, "doc.json"), { force: true });
     r.log("note: --fresh discarded the existing doc.json");
   }
   let reuse;
   if (flags.reuse === true) {
-    const from = resolve9(strFlag(flags, "from") ?? join21(dir, PREV_DOC_NAME));
-    if (!existsSync18(from)) {
+    const from = resolve10(strFlag(flags, "from") ?? join22(dir, PREV_DOC_NAME));
+    if (!existsSync19(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 readFile15(from, "utf8"))
+      doc: JSON.parse(await readFile16(from, "utf8"))
     };
   }
   const style = await resolveStyleRef(flags);
-  const hasDoc = existsSync18(join21(dir, "doc.json"));
+  const hasDoc = existsSync19(join22(dir, "doc.json"));
   const backdrop = hasDoc ? null : await takeBackdrop(flags, r);
   const release = await releaseInputs(dir, flags, r, multi.with ?? []);
   const motionWanted = !hasDoc || flags.motion === true || flags.fresh === true;
@@ -11359,7 +11570,7 @@ async function cmdPlan(argv) {
     ${s.reuse.flagged.join("\n    ")}` : "") : "";
   r.done(
     {
-      take: resolve9(dir),
+      take: resolve10(dir),
       fresh: s.fresh,
       cursorKept: s.cursorKept,
       zoomAuto: s.zoomAuto,
@@ -11371,7 +11582,7 @@ async function cmdPlan(argv) {
       ...s.motion ? { motion: s.motion } : {},
       ...s.reuse ? { reuse: s.reuse } : {}
     },
-    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join21(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}`
+    `${s.reuse ? "Reused" : s.fresh ? "Planned" : "Refreshed"} ${join22(dir, "doc.json")}: ${s.zoomAuto} auto + ${s.zoomManual} manual zoom spans${s.cursorKept ? "" : " (cursor track dropped)"}${layoutLines}${motionLines}${reuseLines}`
   );
   return EXIT_OK;
 }
@@ -11484,7 +11695,7 @@ async function releaseInputs(dir, flags, r, withRefs = []) {
 async function cmdRender(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS6,
+    BOOLEAN_FLAGS7,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -11497,7 +11708,7 @@ async function cmdRender(argv) {
   if (fmtRaw !== "webm" && fmtRaw !== "mp4")
     throw new UsageError("--format must be webm or mp4");
   const format = fmtRaw;
-  const out = positionals[1] ?? join21(dir, `out.${format}`);
+  const out = positionals[1] ?? join22(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");
@@ -11555,7 +11766,7 @@ async function cmdRender(argv) {
 async function cmdFrames(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS6,
+    BOOLEAN_FLAGS7,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -11628,7 +11839,7 @@ async function cmdFrames(argv) {
 async function cmdDeliver(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS6,
+    BOOLEAN_FLAGS7,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -11744,15 +11955,15 @@ async function resolveStyleRef(flags) {
 }
 async function resolveDocRef(ref, flags, what) {
   const styleRef = ref;
-  const file = existsSync18(styleRef) ? resolve9(
+  const file = existsSync19(styleRef) ? resolve10(
     styleRef,
-    existsSync18(join21(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync19(join22(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync18(file)) {
+  if (file && existsSync19(file)) {
     return {
       from: file,
       doc: migrateHostedDoc5(
-        JSON.parse(await readFile15(file, "utf8"))
+        JSON.parse(await readFile16(file, "utf8"))
       )
     };
   }
@@ -11794,7 +12005,7 @@ async function officialTemplate(origin, ref) {
   }
 }
 async function cmdDigest(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   const dir = positionals[0];
   if (!dir)
     throw new UsageError(
@@ -11804,7 +12015,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 readFile15(transcriptPath, "utf8"))) : null;
+  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile16(transcriptPath, "utf8"))) : null;
   const style = await resolveStyleRef(flags);
   const noFrames = flags["no-frames"] === true;
   let browser = null;
@@ -11835,7 +12046,7 @@ async function cmdDigest(argv) {
         kinds,
         frames: d.images.full,
         crops: d.images.crop,
-        sheet: d.images.sheet ? join21(result.outDir, d.images.sheet) : null,
+        sheet: d.images.sheet ? join22(result.outDir, d.images.sheet) : null,
         scenes: kinds.scene ?? 0,
         sourceDuration: d.take.sourceDuration,
         outputDuration: d.take.outputDuration,
@@ -11858,19 +12069,19 @@ async function cmdDigest(argv) {
   }
 }
 async function cmdOpen(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   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 (!existsSync18(take.paths.recording)) {
+  if (!existsSync19(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(resolve9(dir), {});
+  const server = await startTakeServer(resolve10(dir), {});
   const url = `${studio}/studio?take=${encodeURIComponent(server.base)}`;
   r.event({ event: "open", server: server.base, url });
   r.log(`take served at ${server.base}`);
@@ -11896,7 +12107,7 @@ async function cmdOpen(argv) {
   return EXIT_OK;
 }
 async function cmdJudge(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   const target = positionals[0];
   const against = strFlag(flags, "against");
   if (!target || !against)
@@ -11904,12 +12115,12 @@ async function cmdJudge(argv) {
       "vos judge <kit.json> --against <MANIFEST.json> [--out dir] [--json]\n(the manifest names the reference set: id, file, role, layout, facts, rule per asset)"
     );
   const r = createReporter(flags.json === true);
-  const kitFile = target.endsWith("kit.json") ? target : join21(target, "kit.json");
-  if (!existsSync18(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
-  if (!existsSync18(against))
+  const kitFile = target.endsWith("kit.json") ? target : join22(target, "kit.json");
+  if (!existsSync19(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
+  if (!existsSync19(against))
     throw new UsageError(`${against}: no reference manifest`);
   const result = await judgeKit(kitFile, against, strFlag(flags, "out"));
-  const verdicts = JSON.parse(await readFile15(result.verdictFile, "utf8")).verdicts;
+  const verdicts = JSON.parse(await readFile16(result.verdictFile, "utf8")).verdicts;
   const rate = winRate(verdicts);
   const lines = result.sheets.map(
     (s) => `${s.asset} vs ${s.reference}: ${s.sheetA}, ${s.sheetB}, ${s.rubric}`
@@ -11925,7 +12136,7 @@ Win rate so far: ${rate.wins} win(s), ${rate.ties} tie(s) of ${rate.judged} judg
   return EXIT_OK;
 }
 async function cmdCallout(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   const dir = positionals[0];
   const shape = positionals[1];
   if (!dir || !shape || !isCalloutShape(shape))
@@ -11949,7 +12160,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 readFile15(codeFile, "utf8") : strFlag(flags, "code");
+  const code = codeFile ? await readFile16(codeFile, "utf8") : strFlag(flags, "code");
   const words = {
     kicker: strFlag(flags, "kicker"),
     title: strFlag(flags, "title"),
@@ -12024,11 +12235,11 @@ async function cmdCallout(argv) {
   return EXIT_OK;
 }
 async function cmdValidate(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   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 : existsSync18(join21(target, "kit.json")) && !isTakeDir(target) ? join21(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync19(join22(target, "kit.json")) && !isTakeDir(target) ? join22(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -12060,9 +12271,9 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync18(join21(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync19(join22(target, "config.json"))) {
     const parsed = JSON.parse(
-      await readFile15(join21(target, "config.json"), "utf8")
+      await readFile16(join22(target, "config.json"), "utf8")
     );
     const pre = preflightConfig(parsed);
     const problems2 = pre.ok ? [] : pre.issues.map((i) => `config.json: ${i}`);
@@ -12103,7 +12314,7 @@ async function cmdValidate(argv) {
   const take = await loadTake(target);
   const problems = [];
   const warnings = [];
-  if (!existsSync18(take.paths.recording)) {
+  if (!existsSync19(take.paths.recording)) {
     problems.push("missing recording (re-run record)");
   } else {
     const mismatch = containerMismatch(
@@ -12186,7 +12397,7 @@ async function cmdValidate(argv) {
 async function cmdPush3(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS6,
+    BOOLEAN_FLAGS7,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -12196,7 +12407,7 @@ async function cmdPush3(argv) {
     );
   const refusal = takePushRefusal({
     vos: strFlag(flags, "vos"),
-    trackedVosId: readSyncState(resolve9(dir))?.vosId ?? null,
+    trackedVosId: readSyncState(resolve10(dir))?.vosId ?? null,
     programOnly: ["slug", "desc", "tags", "base", "remix-of"].filter(
       (name) => hasFlag(flags, name)
     )
@@ -12205,7 +12416,7 @@ async function cmdPush3(argv) {
   const r = createReporter(flags.json === true);
   const overrides = multi.override;
   const result = await pushTake(
-    resolve9(dir),
+    resolve10(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -12233,11 +12444,11 @@ async function cmdPush3(argv) {
   return EXIT_OK;
 }
 async function cmdPull2(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS6, MULTI_FLAGS2);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7, MULTI_FLAGS2);
   const dir = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
   const result = await pullTake(
-    resolve9(dir),
+    resolve10(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -12356,6 +12567,8 @@ async function run(argv) {
         return await cmdSession(rest);
       case "actions":
         return await cmdActions(rest);
+      case "ingest":
+        return await cmdIngest(rest);
       default:
         throw new UsageError(`unknown command "${cmd}" \u2014 run: vos help`);
     }
@@ -12388,7 +12601,7 @@ async function run(argv) {
   }
 }
 async function cmdSession(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   const [sub, arg] = positionals;
   const r = createReporter(flags.json === true);
   const usage = "vos session open <url> --name <app> | check <name> [--url <url>] | list | rm <name>";
@@ -12424,7 +12637,7 @@ async function cmdSession(argv) {
       if (!arg) throw new UsageError(usage);
       const bad = sessionNameVerdict(arg);
       if (bad) throw new UsageError(bad);
-      if (!existsSync18(sessionDir(arg)))
+      if (!existsSync19(sessionDir(arg)))
         throw new UsageError(`no session "${arg}" (vos session list)`);
       const summary2 = await summarizeSession(arg);
       const url = strFlag(flags, "url");
@@ -12531,7 +12744,8 @@ export {
   MULTI_FLAGS2 as MULTI_FLAGS,
   HELP,
   takeBrowserArgs,
+  takeBackdrop,
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-TAWRT7UM.js.map
+//# sourceMappingURL=chunk-SE4F3OMQ.js.map