@vosjs/cli 0.50.4 → 0.52.0

package/dist/{chunk-D6AP7Y3G.js → chunk-F2QCWV4U.js}

@@ -1,19 +1,94 @@
 #!/usr/bin/env node
 import {
   BrowserUnavailableError,
+  CREDENTIALS_PATH,
+  MEDIA_HEAD_BYTES,
+  SYNC_STATE_NAME,
+  TAKE_MEDIA_EXTENSIONS,
+  UsageError,
+  apiError,
+  apiJson,
+  clientId,
+  containerMismatch,
+  deriveSlug,
   directoryKind,
+  extensionFor,
+  formatChanges,
+  hasFlag,
   launchBrowser,
-  noteGivenFlag,
-  trackFlags
-} from "./chunk-FACYY7VV.js";
+  nameForType,
+  numFlag2 as numFlag,
+  parseArgs2 as parseArgs,
+  parseVosId,
+  platformOrigin,
+  readSyncState,
+  requireCredential,
+  resolveCredential,
+  resolveMediaType,
+  sniffMediaType,
+  strFlag,
+  videoFormat,
+  writeCredential,
+  writeSyncState
+} from "./chunk-KSEU3YK5.js";
 import {
   deadLine,
   deadWarns
 } from "./chunk-6XPFWQKP.js";
 
+// src/plugin/landed.ts
+var absolute = (origin, url) => typeof url === "string" && url ? /^https?:/.test(url) ? url : `${origin}${url.startsWith("/") ? "" : "/"}${url}` : null;
+async function waitForLanded(opts) {
+  const origin = opts.origin.replace(/\/+$/, "");
+  const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+  const now = opts.now ?? (() => Date.now());
+  const timeoutMs = opts.timeoutMs ?? 3e5;
+  const intervalMs = opts.intervalMs ?? 4e3;
+  const started = now();
+  let still = false;
+  if (opts.versionId) {
+    opts.log?.("waiting for the still to render\u2026");
+    for (; ; ) {
+      const res = await fetch(
+        `${origin}/api/vos/${opts.vosId}/versions/${opts.versionId}/thumbnail`,
+        { headers: { authorization: `Bearer ${opts.key}` } }
+      );
+      await res.arrayBuffer().catch(() => void 0);
+      if (res.ok) {
+        still = true;
+        break;
+      }
+      if (now() - started >= timeoutMs) break;
+      await sleep(intervalMs);
+    }
+  }
+  const meta = await apiJson(origin, `/api/vos/${opts.vosId}`, {
+    key: opts.key
+  });
+  const vos = meta.body.vos ?? {};
+  const urls = vos.contentUrls ?? {};
+  return {
+    still,
+    watchUrl: `${origin}/vos/${opts.vosId}`,
+    studioUrl: `${origin}/studio?vos=${opts.vosId}`,
+    thumbnailUrl: still ? absolute(origin, urls.thumbnail) : null,
+    previewUrl: still ? absolute(origin, urls.preview) : null,
+    waitedMs: now() - started
+  };
+}
+function landedLines(l) {
+  if (!l.still) {
+    return `  still:  not rendered yet (the fleet renders it after the push; open the watch page in a minute)`;
+  }
+  return [
+    l.thumbnailUrl ? `  still:   ${l.thumbnailUrl}` : null,
+    l.previewUrl ? `  preview: ${l.previewUrl}` : null
+  ].filter(Boolean).join("\n");
+}
+
 // src/plugin/run.ts
-import { mkdir as mkdir11, readFile as readFile16, rm as rm5 } from "fs/promises";
-import { existsSync as existsSync19 } from "fs";
+import { mkdir as mkdir11, readFile as readFile17, rm as rm5 } from "fs/promises";
+import { existsSync as existsSync20 } from "fs";
 import { join as join22, resolve as resolve10 } from "path";
 import {
   END_CARD_FROM as END_CARD_FROM2,
@@ -21,63 +96,6 @@ import {
   migrateHostedDoc as migrateHostedDoc5
 } from "@vosjs/studio-core";
 
-// src/plugin/args.ts
-var UsageError = class extends Error {
-};
-function parseArgs(argv, booleanFlags, multiFlags = /* @__PURE__ */ new Set()) {
-  const positionals = [];
-  const flags = {};
-  const multi = {};
-  const put = (name, value) => {
-    if (multiFlags.has(name)) (multi[name] ??= []).push(value);
-    else flags[name] = value;
-  };
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg === "--") {
-      positionals.push(...argv.slice(i + 1));
-      break;
-    }
-    if (arg.startsWith("--")) {
-      const eq = arg.indexOf("=");
-      if (eq !== -1) {
-        put(arg.slice(2, eq), arg.slice(eq + 1));
-        continue;
-      }
-      const name = arg.slice(2);
-      if (booleanFlags.has(name)) {
-        flags[name] = true;
-        continue;
-      }
-      if (i + 1 >= argv.length || argv[i + 1].startsWith("--")) {
-        throw new UsageError(`--${name} expects a value`);
-      }
-      put(name, argv[i + 1]);
-      i++;
-      continue;
-    }
-    positionals.push(arg);
-  }
-  for (const name of Object.keys(flags)) noteGivenFlag(name);
-  for (const name of Object.keys(multi)) noteGivenFlag(name);
-  return { positionals, flags: trackFlags(flags), multi: trackFlags(multi) };
-}
-function numFlag(flags, name, fallback) {
-  const v = flags[name];
-  if (typeof v !== "string") return fallback;
-  const n = Number(v);
-  if (!Number.isFinite(n))
-    throw new UsageError(`--${name} expects a number, got "${v}"`);
-  return n;
-}
-function strFlag(flags, name) {
-  const v = flags[name];
-  return typeof v === "string" ? v : void 0;
-}
-function hasFlag(flags, name) {
-  return Object.prototype.hasOwnProperty.call(flags, name);
-}
-
 // src/plugin/output.ts
 var EXIT_OK = 0;
 var EXIT_ERROR = 1;
@@ -1634,111 +1652,14 @@ function framingWarnings(docIn, doc, zoom, overlays, warnings) {
   }
 }
 
-// src/plugin/container.ts
-var OCTET_STREAM = "application/octet-stream";
-var TYPES_BY_EXTENSION = {
-  svg: "image/svg+xml",
-  png: "image/png",
-  jpg: "image/jpeg",
-  jpeg: "image/jpeg",
-  webp: "image/webp",
-  gif: "image/gif",
-  avif: "image/avif",
-  webm: "video/webm",
-  mp4: "video/mp4",
-  mov: "video/quicktime",
-  mp3: "audio/mpeg",
-  wav: "audio/wav",
-  ogg: "audio/ogg",
-  m4a: "audio/mp4"
-};
-var EXTENSION_BY_TYPE = {
-  "image/jpeg": ".jpg",
-  "video/mp4": ".mp4",
-  "audio/mp4": ".m4a"
-};
-var TAKE_MEDIA_EXTENSIONS = [
-  ".webm",
-  ".mp4",
-  ".mov",
-  ".m4a",
-  ".mp3",
-  ".ogg",
-  ".wav"
-];
-var MEDIA_HEAD_BYTES = 16;
-var ISO_BRANDS = {
-  "qt  ": "video/quicktime",
-  "M4A ": "audio/mp4",
-  "M4B ": "audio/mp4",
-  avif: "image/avif",
-  avis: "image/avif"
-};
-var RIFF_FORMS = {
-  WEBP: "image/webp",
-  WAVE: "audio/wav",
-  "AVI ": "video/x-msvideo"
-};
-function sniffMediaType(head) {
-  const ascii = (at2, len) => head.length >= at2 + len ? String.fromCharCode(...head.subarray(at2, at2 + len)) : "";
-  const startsWith = (...bytes) => bytes.every((b, i) => head[i] === b);
-  if (startsWith(26, 69, 223, 163)) return "video/webm";
-  if (ascii(4, 4) === "ftyp") return ISO_BRANDS[ascii(8, 4)] ?? "video/mp4";
-  if (ascii(0, 4) === "RIFF") return RIFF_FORMS[ascii(8, 4)] ?? null;
-  if (startsWith(137, 80, 78, 71, 13, 10, 26, 10))
-    return "image/png";
-  if (startsWith(255, 216, 255)) return "image/jpeg";
-  if (ascii(0, 4) === "GIF8") return "image/gif";
-  if (ascii(0, 4) === "OggS") return "audio/ogg";
-  if (ascii(0, 3) === "ID3") return "audio/mpeg";
-  return null;
-}
-function bareType(value) {
-  const type = (value ?? "").split(";")[0].trim().toLowerCase();
-  return !type || type === OCTET_STREAM || type === "binary/octet-stream" ? "" : type;
-}
-function mediaContentType(file) {
-  const ext = (/\.([a-z0-9]+)$/i.exec(file)?.[1] ?? "").toLowerCase();
-  return TYPES_BY_EXTENSION[ext] ?? OCTET_STREAM;
-}
-function extensionFor(contentType) {
-  const type = (contentType ?? "").split(";")[0].trim().toLowerCase();
-  if (EXTENSION_BY_TYPE[type]) return EXTENSION_BY_TYPE[type];
-  const ext = Object.keys(TYPES_BY_EXTENSION).find(
-    (e) => TYPES_BY_EXTENSION[e] === type
-  );
-  return ext ? `.${ext}` : "";
-}
-function resolveMediaType(claims) {
-  const sniffed = claims.head?.length ? sniffMediaType(claims.head) : null;
-  if (sniffed) return { type: sniffed, from: "bytes" };
-  const declared = bareType(claims.declared);
-  if (declared) return { type: declared, from: "declared" };
-  const named = mediaContentType(claims.filename ?? "");
-  if (named !== OCTET_STREAM) return { type: named, from: "filename" };
-  return { type: OCTET_STREAM, from: "unknown" };
-}
-function nameForType(filename, type) {
-  const ext = extensionFor(type);
-  if (!ext) return filename;
-  const current = /\.[a-z0-9]+$/i.exec(filename)?.[0] ?? "";
-  if (current && mediaContentType(`x${current}`) === type) return filename;
-  return `${filename.slice(0, filename.length - current.length)}${ext}`;
-}
-function containerMismatch(filename, head) {
-  const actual = sniffMediaType(head);
-  if (!actual) return null;
-  const claimed = mediaContentType(filename);
-  if (claimed === actual) return null;
-  return `${filename} is ${actual}, not the ${claimed} its name claims \u2014 rename it to ${nameForType(filename, actual)}`;
-}
-
 // src/plugin/media.ts
 import { isKeyedOverlay } from "@vosjs/studio-core";
+import { createHash } from "crypto";
 import { createWriteStream, existsSync as existsSync2 } from "fs";
 import {
   mkdir as mkdir2,
   open,
+  readFile as readFile2,
   readdir,
   rename as rename2,
   rm as rm2,
@@ -1847,6 +1768,150 @@ async function loadTake(dir) {
   return { paths, cursor, meta, actions, doc };
 }
 
+// src/plugin/uploadAsset.ts
+var SINGLE_SHOT_MAX_BYTES = 32 * 1024 * 1024;
+var PART_ATTEMPTS = 3;
+function planParts(totalBytes, partBytes) {
+  if (totalBytes <= 0 || partBytes <= 0) return [];
+  const parts = [];
+  for (let start = 0; start < totalBytes; start += partBytes) {
+    parts.push({
+      partNumber: parts.length + 1,
+      start,
+      end: Math.min(start + partBytes, totalBytes)
+    });
+  }
+  return parts;
+}
+function failed(what, r) {
+  const detail = typeof r.body.error === "string" ? r.body.error : "";
+  return new Error(`${what} (${r.status})${detail ? `: ${detail}` : ""}`);
+}
+function asAsset(body) {
+  return {
+    id: String(body.id),
+    url: String(body.url),
+    size: typeof body.size === "number" ? body.size : 0,
+    reused: body.reused === true
+  };
+}
+function transient(status) {
+  return status >= 500 || status === 429;
+}
+var wait = (ms) => new Promise((r) => setTimeout(r, ms));
+async function uploadAsset(target, bytes, opts) {
+  if (bytes.length > SINGLE_SHOT_MAX_BYTES && opts.folderId) {
+    throw new Error(
+      `${opts.filename} is over ${SINGLE_SHOT_MAX_BYTES / 1024 / 1024} MB, and a file that large cannot be filed into a project on upload yet. Push it without --folder and reference it from a document, which keeps it`
+    );
+  }
+  return bytes.length > SINGLE_SHOT_MAX_BYTES ? uploadInParts(target, bytes, opts) : uploadWhole(target, bytes, opts);
+}
+async function uploadWhole(target, bytes, opts) {
+  const res = await apiJson(target.origin, "/api/assets/recording", {
+    method: "POST",
+    key: target.key,
+    headers: {
+      "Content-Type": opts.contentType,
+      "Content-Length": String(bytes.length),
+      "X-Filename": opts.filename,
+      "X-Content-Hash": opts.contentHash,
+      ...opts.durationSeconds && opts.durationSeconds > 0 ? { "X-Content-Duration": opts.durationSeconds.toFixed(3) } : {},
+      ...opts.folderId ? { "X-Folder-Id": opts.folderId } : {}
+    },
+    raw: bytes
+  });
+  if (res.status !== 201 && res.status !== 200)
+    throw failed("upload failed", res);
+  return asAsset(res.body);
+}
+async function uploadInParts(target, bytes, opts) {
+  const begun = await apiJson(
+    target.origin,
+    "/api/assets/recording/multipart",
+    {
+      method: "POST",
+      key: target.key,
+      body: {
+        filename: opts.filename,
+        contentType: opts.contentType,
+        size: bytes.length,
+        contentHash: opts.contentHash,
+        ...opts.durationSeconds && opts.durationSeconds > 0 ? { durationSeconds: opts.durationSeconds } : {}
+      }
+    }
+  );
+  if (begun.status !== 201 && begun.status !== 200) {
+    throw failed("upload failed", begun);
+  }
+  if (begun.body.reused === true || typeof begun.body.url === "string") {
+    return asAsset(begun.body);
+  }
+  const uploadId = String(begun.body.id);
+  const partBytes = Number(begun.body.partBytes);
+  if (!Number.isFinite(partBytes) || partBytes <= 0) {
+    throw new Error("upload failed: the platform returned no part size");
+  }
+  const parts = planParts(bytes.length, partBytes);
+  const etags = [];
+  try {
+    for (const part of parts) {
+      const chunk2 = bytes.subarray(part.start, part.end);
+      let sent = null;
+      for (let attempt = 1; attempt <= PART_ATTEMPTS; attempt++) {
+        try {
+          sent = await apiJson(
+            target.origin,
+            `/api/assets/recording/multipart/${uploadId}/parts/${part.partNumber}`,
+            {
+              method: "PUT",
+              key: target.key,
+              headers: {
+                "Content-Type": "application/octet-stream",
+                "Content-Length": String(chunk2.length)
+              },
+              raw: chunk2
+            }
+          );
+        } catch (networkError) {
+          if (attempt === PART_ATTEMPTS) throw networkError;
+          await wait(500 * 2 ** (attempt - 1));
+          continue;
+        }
+        if (sent.status === 200) break;
+        if (!transient(sent.status) || attempt === PART_ATTEMPTS) {
+          throw failed(`part ${part.partNumber} failed`, sent);
+        }
+        await wait(500 * 2 ** (attempt - 1));
+      }
+      if (!sent || sent.status !== 200) {
+        throw new Error(`part ${part.partNumber} failed`);
+      }
+      etags.push({
+        partNumber: Number(sent.body.partNumber),
+        etag: String(sent.body.etag)
+      });
+      opts.onPart?.(etags.length, parts.length);
+    }
+    const sealed = await apiJson(
+      target.origin,
+      `/api/assets/recording/multipart/${uploadId}/complete`,
+      { method: "POST", key: target.key, body: { parts: etags } }
+    );
+    if (sealed.status !== 201 && sealed.status !== 200) {
+      throw failed("upload failed", sealed);
+    }
+    return asAsset(sealed.body);
+  } catch (err) {
+    await apiJson(
+      target.origin,
+      `/api/assets/recording/multipart/${uploadId}`,
+      { method: "DELETE", key: target.key }
+    ).catch(() => void 0);
+    throw err;
+  }
+}
+
 // src/plugin/media.ts
 var SOURCE_MEDIA = [
   { key: "videoKey", stem: "recording", fallbackExt: ".webm" },
@@ -1915,8 +1980,58 @@ function docMediaRefs(doc, keep = isTakeRelativeKey) {
         bg.key = next;
       }
     });
+  out.push(...docAudioRefs(doc, keep));
+  return out;
+}
+function docAudioRefs(doc, keep = isTakeRelativeKey) {
+  const out = [];
+  for (const clip of doc.audio ?? []) {
+    if (!keep(clip.key)) continue;
+    out.push({
+      where: `audio ${clip.id}`,
+      key: clip.key,
+      set: (next) => {
+        clip.key = next;
+      }
+    });
+  }
   return out;
 }
+async function uploadDocRefs(refs, dir, target, log) {
+  for (const ref of refs) {
+    const file = join2(dir, takeRelativeFile(ref.key));
+    if (!existsSync2(file)) {
+      log(`  ${ref.where}: ${ref.key} is not beside the document \u2014 left as is`);
+      continue;
+    }
+    const media = await readFile2(file);
+    const mediaHash = createHash("sha256").update(media).digest("hex");
+    const { type } = resolveMediaType({
+      head: media.subarray(0, MEDIA_HEAD_BYTES),
+      filename: file
+    });
+    const name = nameForType(basename2(file), type);
+    if (name !== basename2(file)) {
+      log(`  ${ref.where}: ${basename2(file)} holds ${type} \u2014 sent as ${name}`);
+    }
+    let put;
+    try {
+      put = await uploadAsset(target, new Uint8Array(media), {
+        filename: name,
+        contentType: type,
+        contentHash: mediaHash
+      });
+    } catch (e) {
+      throw new Error(
+        `${ref.where} upload failed: ${e instanceof Error ? e.message : String(e)}`
+      );
+    }
+    ref.set(put.url);
+    log(
+      `  ${ref.where}: ${ref.key} \u2192 asset ${put.id}${put.reused ? " (reused)" : ""}`
+    );
+  }
+}
 function assetIdOf(url) {
   if (!url) return null;
   const m = /\/api\/assets\/([A-Za-z0-9_-]+)\/file/.exec(url);
@@ -2105,7 +2220,7 @@ function mediaProbeLints(results) {
 }
 
 // src/plugin/framesTake.ts
-import { mkdir as mkdir4, readFile as readFile4, rename as rename4, writeFile as writeFile5 } from "fs/promises";
+import { mkdir as mkdir4, readFile as readFile5, rename as rename4, writeFile as writeFile5 } from "fs/promises";
 import { existsSync as existsSync5 } from "fs";
 import { join as join5, resolve as resolve2 } from "path";
 import { compileVosConfig } from "@vosjs/core";
@@ -2246,7 +2361,7 @@ async function waitForPageDone(page, label, onProgress, timeoutMs) {
 }
 
 // src/plugin/renderAnimation.ts
-import { readFile as readFile2, rm as rm3 } from "fs/promises";
+import { readFile as readFile3, rm as rm3 } from "fs/promises";
 import { tweenRuntimeCode } from "@vosjs/tween/bundle";
 import { elementsBundleCode } from "@vosjs/elements/bundle";
 import { concatEncodedVideo, planChunks } from "@vosjs/render-core";
@@ -2541,7 +2656,7 @@ async function renderAnimation(browser, opts) {
       )
     );
     const files = await Promise.all(
-      outNames.map((name) => readFile2(`${opts.workDir}/${name}`))
+      outNames.map((name) => readFile3(`${opts.workDir}/${name}`))
     );
     await Promise.all(
       outNames.map((name) => rm3(`${opts.workDir}/${name}`, { force: true }))
@@ -2799,7 +2914,7 @@ function applyAndValidate(doc, o) {
 }
 
 // src/plugin/digestTake.ts
-import { mkdir as mkdir3, readFile as readFile3, rename as rename3, writeFile as writeFile4 } from "fs/promises";
+import { mkdir as mkdir3, readFile as readFile4, rename as rename3, writeFile as writeFile4 } from "fs/promises";
 import { existsSync as existsSync4 } from "fs";
 import { join as join4, resolve } from "path";
 import {
@@ -3199,7 +3314,7 @@ async function discoverTranscript(dir) {
   const file = join4(dir, "transcript.json");
   if (!existsSync4(file)) return null;
   try {
-    return parseTranscript(JSON.parse(await readFile3(file, "utf8")));
+    return parseTranscript(JSON.parse(await readFile4(file, "utf8")));
   } catch {
     return null;
   }
@@ -3207,7 +3322,7 @@ async function discoverTranscript(dir) {
 async function readPriorDigest(outDir) {
   try {
     const raw = JSON.parse(
-      await readFile3(join4(outDir, "digest.json"), "utf8")
+      await readFile4(join4(outDir, "digest.json"), "utf8")
     );
     return raw.digestVersion === DIGEST_VERSION && Array.isArray(raw.moments) ? raw : null;
   } catch {
@@ -3216,7 +3331,7 @@ async function readPriorDigest(outDir) {
 }
 async function pngSize(file) {
   try {
-    const buf = await readFile3(file);
+    const buf = await readFile4(file);
     if (buf.length < 24 || buf.readUInt32BE(0) !== 2303741511) return null;
     return { width: buf.readUInt32BE(16), height: buf.readUInt32BE(20) };
   } catch {
@@ -3456,7 +3571,7 @@ async function momentsFor(dir, doc) {
   const file = join5(dir, DIGEST_DIR, "digest.json");
   if (existsSync5(file)) {
     try {
-      const d = JSON.parse(await readFile4(file, "utf8"));
+      const d = JSON.parse(await readFile5(file, "utf8"));
       if (Array.isArray(d.moments)) return d.moments;
     } catch {
     }
@@ -3496,9 +3611,9 @@ async function writeIndexJson(result) {
 // src/plugin/deliver.ts
 import { mkdir as mkdir5, mkdtemp, rename as rename5, rm as rm4, stat as stat2, writeFile as writeFile7 } from "fs/promises";
 import { tmpdir } from "os";
-import { join as join8, relative, resolve as resolve4 } from "path";
+import { join as join7, relative, resolve as resolve4 } from "path";
 import { existsSync as existsSync7 } from "fs";
-import { readFile as readFile6 } from "fs/promises";
+import { readFile as readFile7 } from "fs/promises";
 import { parseFrontmatter } from "@vosjs/shared/frontmatter";
 import {
   CHANNEL_SPECS_VERIFIED,
@@ -4478,176 +4593,15 @@ function isLightHexGround(hex2) {
 
 // src/plugin/posterDoc.ts
 import { existsSync as existsSync6 } from "fs";
-import { readFile as readFile5 } from "fs/promises";
-import { isAbsolute, join as join7, resolve as resolve3 } from "path";
+import { readFile as readFile6 } from "fs/promises";
+import { isAbsolute, join as join6, resolve as resolve3 } from "path";
 import {
   computeCardLayout,
-  docStillTime as docStillTime2,
-  migrateHostedDoc,
-  overlayRect,
-  resolveOverlayStyle
-} from "@vosjs/studio-core";
-
-// src/plugin/platform.ts
-import { mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
-import { homedir } from "os";
-import { join as join6 } from "path";
-function platformOrigin(flags = {}) {
-  const legacyEnv = process.env.VOS_API_BASE?.trim();
-  const raw = flags.origin ?? flags.api ?? process.env.VOS_ORIGIN?.trim() ?? legacyEnv ?? "https://vos.so";
-  if (!flags.origin && !flags.api && !process.env.VOS_ORIGIN && legacyEnv) {
-    process.stderr.write(
-      "note: VOS_API_BASE is deprecated \u2014 set VOS_ORIGIN (an origin, no /api suffix)\n"
-    );
-  }
-  return raw.replace(/\/+$/, "").replace(/\/api$/, "");
-}
-function parseVosId(input) {
-  if (!/^https?:\/\//.test(input)) {
-    if (/^[A-Za-z0-9_-]+$/.test(input)) return input;
-    throw new UsageError(`"${input}" is not a vos id or URL`);
-  }
-  let url;
-  try {
-    url = new URL(input);
-  } catch {
-    throw new UsageError(`"${input}" is not a valid URL`);
-  }
-  const query = url.searchParams.get("vos");
-  if (query) return query;
-  const path = url.pathname.match(/\/vos\/([A-Za-z0-9_-]+)/);
-  if (path) return path[1];
-  throw new UsageError(
-    `could not find a vos id in ${input} \u2014 expected /vos/{id} or ?vos={id}`
-  );
-}
-function deriveSlug(title) {
-  return title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 50).replace(/-+$/, "") || "remix";
-}
-var CREDENTIALS_PATH = join6(homedir(), ".config", "vos", "credentials");
-function resolveCredential(explicit) {
-  const flag = explicit?.trim();
-  if (flag) return flag;
-  const env = process.env.VOS_API_KEY?.trim();
-  if (env) return env;
-  try {
-    const first = readFileSync2(CREDENTIALS_PATH, "utf8").split("\n")[0].trim();
-    return first || null;
-  } catch {
-    return null;
-  }
-}
-function requireCredential(explicit) {
-  const key = resolveCredential(explicit);
-  if (!key) {
-    throw new Error(
-      "no credential found \u2014 pass --key, set VOS_API_KEY, or run `vos login` (mint a content key at https://vos.so/app/api; a vos_rg_ remix grant works too)"
-    );
-  }
-  return key;
-}
-function writeCredential(key) {
-  mkdirSync(join6(homedir(), ".config", "vos"), { recursive: true, mode: 448 });
-  writeFileSync(CREDENTIALS_PATH, `${key.trim()}
-`, { mode: 384 });
-  return CREDENTIALS_PATH;
-}
-function clientId() {
-  const env = process.env.VOS_CLIENT?.trim();
-  if (env && env.length <= 60 && !/[\r\n]/.test(env)) return env;
-  return "vos-cli";
-}
-async function apiJson(origin, path, init = {}) {
-  const headers = {
-    accept: "application/json",
-    ...init.headers
-  };
-  if (init.key) headers.authorization = `Bearer ${init.key}`;
-  if (init.body !== void 0) headers["content-type"] = "application/json";
-  const reqBody = init.raw !== void 0 ? init.raw : init.body === void 0 ? void 0 : JSON.stringify(init.body);
-  const res = await fetch(`${origin}${path}`, {
-    method: init.method ?? "GET",
-    headers,
-    body: reqBody
-  });
-  let body = {};
-  try {
-    body = await res.json();
-  } catch {
-  }
-  return { status: res.status, body };
-}
-function apiError(what, r) {
-  const detail = typeof r.body.error === "string" ? r.body.error : r.body.details !== void 0 ? JSON.stringify(r.body.details) : "";
-  const hint = r.status === 401 ? " (run `vos login`, or set VOS_API_KEY \u2014 mint a key at https://vos.so/app/api)" : "";
-  return `${what} \u2192 ${r.status}${detail ? `: ${detail}` : ""}${hint}`;
-}
-var SYNC_STATE_NAME = "vos.json";
-function readJsonFile(file) {
-  try {
-    return JSON.parse(readFileSync2(file, "utf8"));
-  } catch {
-    return null;
-  }
-}
-function readSyncState(dir) {
-  const own = readJsonFile(join6(dir, SYNC_STATE_NAME));
-  if (own && typeof own.vosId === "string") {
-    return {
-      vosId: own.vosId,
-      versionId: typeof own.versionId === "string" ? own.versionId : null,
-      ...typeof own.pushedAt === "string" ? { pushedAt: own.pushedAt } : {},
-      ...typeof own.title === "string" ? { title: own.title } : {},
-      ...typeof own.slug === "string" ? { slug: own.slug } : {},
-      ...typeof own.remixOfId === "string" ? { remixOfId: own.remixOfId } : {}
-    };
-  }
-  const push = readJsonFile(join6(dir, "push.json"));
-  if (push && typeof push.vosId === "string") {
-    return {
-      vosId: push.vosId,
-      versionId: typeof push.versionId === "string" ? push.versionId : null,
-      ...typeof push.pushedAt === "string" ? { pushedAt: push.pushedAt } : {}
-    };
-  }
-  const meta = readJsonFile(join6(dir, "meta.json"));
-  if (meta && typeof meta.id === "string") {
-    return {
-      vosId: meta.id,
-      versionId: typeof meta.currentVersionId === "string" ? meta.currentVersionId : null,
-      ...typeof meta.title === "string" ? { title: meta.title } : {},
-      ...typeof meta.slug === "string" ? { slug: meta.slug } : {},
-      ...typeof meta.remixOfId === "string" ? { remixOfId: meta.remixOfId } : {}
-    };
-  }
-  return null;
-}
-function writeSyncState(dir, patch) {
-  const merged = {
-    ...readSyncState(dir) ?? { versionId: null },
-    ...patch
-  };
-  writeFileSync(
-    join6(dir, SYNC_STATE_NAME),
-    `${JSON.stringify(merged, null, 2)}
-`
-  );
-  return merged;
-}
-function formatChanges(changes) {
-  const lines = [];
-  for (const ch of changes) {
-    const label = ch.label ? ` \xB7 ${ch.label}` : "";
-    const who = ch.origin === "studio" ? "human" : ch.origin ?? "unknown";
-    lines.push(
-      `v${String(ch.versionNumber ?? "?")} (${who}${label}): ${ch.summary ?? ""}`
-    );
-    if (ch.note) lines.push(`    note: ${ch.note}`);
-  }
-  return lines;
-}
-
-// src/plugin/posterDoc.ts
+  docStillTime as docStillTime2,
+  migrateHostedDoc,
+  overlayRect,
+  resolveOverlayStyle
+} from "@vosjs/studio-core";
 var POSTER_CLASSES = [
   "landscape",
   "square",
@@ -4667,8 +4621,8 @@ var roleFor = (cls) => `poster-${cls}`;
 async function readPosterAt(cls, path, takeDir, from) {
   let file = path;
   let docDir = path;
-  if (existsSync6(join7(path, "doc.json"))) {
-    file = join7(path, "doc.json");
+  if (existsSync6(join6(path, "doc.json"))) {
+    file = join6(path, "doc.json");
   } else if (!/\.json$/i.test(path) || !existsSync6(path)) {
     return null;
   } else {
@@ -4676,7 +4630,7 @@ async function readPosterAt(cls, path, takeDir, from) {
   }
   let raw;
   try {
-    raw = JSON.parse(await readFile5(file, "utf8"));
+    raw = JSON.parse(await readFile6(file, "utf8"));
   } catch {
     return null;
   }
@@ -4686,7 +4640,7 @@ async function readPosterAt(cls, path, takeDir, from) {
   const doc = migrateHostedDoc(
     raw
   );
-  const ownFootage = existsSync6(join7(docDir, "meta.json")) && existsSync6(join7(docDir, source.videoKey));
+  const ownFootage = existsSync6(join6(docDir, "meta.json")) && existsSync6(join6(docDir, source.videoKey));
   const sync = readSyncState(docDir);
   return {
     cls,
@@ -4709,10 +4663,10 @@ async function findPosterDocs(takeDir, launchRoles) {
       candidates.push({ path: at2(named.trim()), from: `LAUNCH.md ${role}` });
     }
     candidates.push({
-      path: join7(takeDir, "poster", cls),
+      path: join6(takeDir, "poster", cls),
       from: `poster/${cls}`
     });
-    candidates.push({ path: join7(takeDir, "poster"), from: "poster" });
+    candidates.push({ path: join6(takeDir, "poster"), from: "poster" });
     for (const c of candidates) {
       const ref = await readPosterAt(cls, c.path, takeDir, c.from);
       if (ref) {
@@ -4808,19 +4762,19 @@ function resolveChannels(raw) {
   return out;
 }
 async function readBrandBesideTake(dir, explicit) {
-  const candidates = explicit ? [explicit] : [join8(dir, "BRAND.md"), join8(dir, "..", "BRAND.md")];
+  const candidates = explicit ? [explicit] : [join7(dir, "BRAND.md"), join7(dir, "..", "BRAND.md")];
   for (const file of candidates) {
     if (!existsSync7(file)) continue;
-    const roles = parseFrontmatter(await readFile6(file, "utf8"));
+    const roles = parseFrontmatter(await readFile7(file, "utf8"));
     return { file, roles };
   }
   return null;
 }
 async function readLaunchBesideTake(dir, explicit) {
-  const candidates = explicit ? [explicit] : [join8(dir, "LAUNCH.md"), join8(dir, "..", "LAUNCH.md")];
+  const candidates = explicit ? [explicit] : [join7(dir, "LAUNCH.md"), join7(dir, "..", "LAUNCH.md")];
   for (const file of candidates) {
     if (!existsSync7(file)) continue;
-    return { file, roles: parseFrontmatter(await readFile6(file, "utf8")) };
+    return { file, roles: parseFrontmatter(await readFile7(file, "utf8")) };
   }
   return null;
 }
@@ -4884,7 +4838,7 @@ async function pickStillTimes(browser, dir, doc, duration, opts) {
   const meta = doc.source.meta;
   const vw = meta.captureWidth ?? meta.width;
   const vh = meta.captureHeight ?? meta.height;
-  const probeDir = await mkdtemp(join8(tmpdir(), "vos-moments-"));
+  const probeDir = await mkdtemp(join7(tmpdir(), "vos-moments-"));
   try {
     const probe2 = await framesTake(browser, dir, {
       times: candidates.map((c) => c.time),
@@ -4898,7 +4852,7 @@ async function pickStillTimes(browser, dir, doc, duration, opts) {
     });
     const byTime = /* @__PURE__ */ new Map();
     for (const frame of probe2.frames) {
-      const img = decodePng(new Uint8Array(await readFile6(frame.file)));
+      const img = decodePng(new Uint8Array(await readFile7(frame.file)));
       if (!img) continue;
       const whole = { x: 0, y: 0, w: img.w, h: img.h };
       byTime.set(+frame.time.toFixed(3), {
@@ -4971,7 +4925,7 @@ async function deliverTake(browser, dir, opts) {
   const doc = take.doc;
   const duration = docOutputDuration2(doc);
   const videoSeconds = opts.range ? Math.min(opts.range[1], duration) - Math.min(opts.range[0], duration) : duration;
-  const outDir = resolve4(opts.outDir ?? join8(dir, "kit"));
+  const outDir = resolve4(opts.outDir ?? join7(dir, "kit"));
   await mkdir5(outDir, { recursive: true });
   const destinations = opts.channels.flatMap((c) => destinationsForChannel(c));
   const assets = [];
@@ -5032,7 +4986,7 @@ async function deliverTake(browser, dir, opts) {
     opts.onPhase?.(
       `${label} (${specWords(d)}) from ${ref.from}${ref.vosId ? ` ${ref.vosId}` : ""}, the rest at ${time.toFixed(2)}s`
     );
-    const shotDir = await mkdtemp(join8(tmpdir(), "vos-poster-"));
+    const shotDir = await mkdtemp(join7(tmpdir(), "vos-poster-"));
     try {
       const captured = await framesTake(browser, ref.takeDir, {
         times: [time],
@@ -5042,7 +4996,7 @@ async function deliverTake(browser, dir, opts) {
         doc: ref.doc,
         overrides: opts.overrides
       });
-      const to = join8(outDir, `${d.id}.png`);
+      const to = join7(outDir, `${d.id}.png`);
       await rename5(captured.frames[0].file, to);
       const bytes = (await stat2(to)).size;
       if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
@@ -5114,7 +5068,7 @@ async function deliverTake(browser, dir, opts) {
         }
       }
       opts.onPhase?.(`${label} (${specWords(d)})`);
-      const outFile = join8(outDir, `${d.id}.${d.format}`);
+      const outFile = join7(outDir, `${d.id}.${d.format}`);
       const bitrate = d.maxBytes !== void 0 ? Math.min(
         1e7,
         Math.floor(d.maxBytes * 8 / seconds * 0.85)
@@ -5161,7 +5115,7 @@ async function deliverTake(browser, dir, opts) {
     for (let i = 0; i < captured.frames.length; i++) {
       const frame = captured.frames[i];
       const name = captured.frames.length > 1 ? `${d.id}-${i + 1}.png` : `${d.id}.png`;
-      const to = join8(outDir, name);
+      const to = join7(outDir, name);
       await rename5(frame.file, to);
       const bytes = (await stat2(to)).size;
       if (d.maxBytes !== void 0 && bytes > d.maxBytes) {
@@ -5199,15 +5153,15 @@ async function deliverTake(browser, dir, opts) {
     skipped,
     assets
   };
-  const kitFile = join8(outDir, "kit.json");
+  const kitFile = join7(outDir, "kit.json");
   await writeFile7(kitFile, JSON.stringify(kit, null, 2));
   return { kit, kitFile, outDir };
 }
 
 // src/plugin/markAsset.ts
-import { mkdir as mkdir6, readFile as readFile7, writeFile as writeFile8 } from "fs/promises";
+import { mkdir as mkdir6, readFile as readFile8, writeFile as writeFile8 } from "fs/promises";
 import { existsSync as existsSync8 } from "fs";
-import { isAbsolute as isAbsolute2, join as join9, resolve as resolve5 } from "path";
+import { isAbsolute as isAbsolute2, join as join8, resolve as resolve5 } from "path";
 function markExtension(url) {
   const m = /\.(svg|png|webp|jpe?g)(?:[?#]|$)/i.exec(url);
   if (!m) return null;
@@ -5290,7 +5244,7 @@ async function fetchBrandMarks(takeDir, roles) {
       } else {
         const file = isAbsolute2(src) ? src : resolve5(takeDir, src);
         if (!existsSync8(file)) throw new Error("no such file");
-        bytes = new Uint8Array(await readFile7(file));
+        bytes = new Uint8Array(await readFile8(file));
       }
     } catch (e) {
       out.notes.push(
@@ -5305,8 +5259,8 @@ async function fetchBrandMarks(takeDir, roles) {
       );
       return null;
     }
-    await mkdir6(join9(takeDir, "brand"), { recursive: true });
-    await writeFile8(join9(takeDir, "brand", `${name}.${ext}`), bytes);
+    await mkdir6(join8(takeDir, "brand"), { recursive: true });
+    await writeFile8(join8(takeDir, "brand", `${name}.${ext}`), bytes);
     return { key: `/brand/${name}.${ext}`, aspect };
   };
   out.light = await one("logoUrl", "mark");
@@ -5343,8 +5297,8 @@ async function fetchMusicCatalog(origin) {
 
 // src/plugin/judge.ts
 import { existsSync as existsSync9 } from "fs";
-import { mkdir as mkdir7, readFile as readFile8, writeFile as writeFile9 } from "fs/promises";
-import { dirname as dirname2, isAbsolute as isAbsolute3, join as join10, resolve as resolve6 } from "path";
+import { mkdir as mkdir7, readFile as readFile9, writeFile as writeFile9 } from "fs/promises";
+import { dirname as dirname2, isAbsolute as isAbsolute3, join as join9, resolve as resolve6 } from "path";
 import { DESTINATIONS as DESTINATIONS2 } from "@vosjs/studio-core";
 
 // src/plugin/shotBake.ts
@@ -5515,28 +5469,28 @@ function composeSheet(left, right, height = 540, gutter = 32) {
   return { w, h, data: out };
 }
 async function judgeKit(kitPath, manifestPath, outDir) {
-  const kit = JSON.parse(await readFile8(kitPath, "utf8"));
+  const kit = JSON.parse(await readFile9(kitPath, "utf8"));
   const manifest = JSON.parse(
-    await readFile8(manifestPath, "utf8")
+    await readFile9(manifestPath, "utf8")
   );
   const manifestDir = dirname2(resolve6(manifestPath));
   const kitDir = dirname2(resolve6(kitPath));
-  const out = resolve6(outDir ?? join10(kitDir, "judge"));
+  const out = resolve6(outDir ?? join9(kitDir, "judge"));
   await mkdir7(out, { recursive: true });
   const sheets = [];
   const skipped = [];
   const refCache = /* @__PURE__ */ new Map();
   const loadRef = async (file) => {
     if (refCache.has(file)) return refCache.get(file) ?? null;
-    const p = join10(manifestDir, file);
-    const img = existsSync9(p) ? decodePng(new Uint8Array(await readFile8(p))) : null;
+    const p = join9(manifestDir, file);
+    const img = existsSync9(p) ? decodePng(new Uint8Array(await readFile9(p))) : null;
     refCache.set(file, img);
     return img;
   };
   for (const a of kit.assets) {
     if (!/\.png$/i.test(a.path)) continue;
-    const file = isAbsolute3(a.path) && existsSync9(a.path) ? a.path : join10(kitDir, a.path.split("/").pop() ?? a.path);
-    const img = existsSync9(file) ? decodePng(new Uint8Array(await readFile8(file))) : null;
+    const file = isAbsolute3(a.path) && existsSync9(a.path) ? a.path : join9(kitDir, a.path.split("/").pop() ?? a.path);
+    const img = existsSync9(file) ? decodePng(new Uint8Array(await readFile9(file))) : null;
     if (!img) {
       skipped.push(`${a.destination ?? a.path}: unreadable`);
       continue;
@@ -5567,8 +5521,8 @@ async function judgeKit(kitPath, manifestPath, outDir) {
     const id = stem.replace(/[^A-Za-z0-9_-]+/g, "-") || a.destination || "asset";
     const nameA = `${id}--A.png`;
     const nameB = `${id}--B.png`;
-    await writeFile9(join10(out, nameA), encodePng(composeSheet(img, refImg)));
-    await writeFile9(join10(out, nameB), encodePng(composeSheet(refImg, img)));
+    await writeFile9(join9(out, nameA), encodePng(composeSheet(img, refImg)));
+    await writeFile9(join9(out, nameB), encodePng(composeSheet(refImg, img)));
     const rubric = [
       `# ${id} against ${ref.id} (${ref.file})`,
       "",
@@ -5588,7 +5542,7 @@ async function judgeKit(kitPath, manifestPath, outDir) {
       "In judge.json: `win` true when the kit asset is at least as good as the reference on the rules that apply to its genre, false when it is worse, null for a tie; `reasons` names the rules by number.",
       ""
     ].join("\n");
-    await writeFile9(join10(out, `${id}.md`), rubric);
+    await writeFile9(join9(out, `${id}.md`), rubric);
     sheets.push({
       asset: id,
       reference: ref.id,
@@ -5597,7 +5551,7 @@ async function judgeKit(kitPath, manifestPath, outDir) {
       rubric: `${id}.md`
     });
   }
-  const verdictFile = join10(out, "judge.json");
+  const verdictFile = join9(out, "judge.json");
   if (!existsSync9(verdictFile)) {
     await writeFile9(
       verdictFile,
@@ -5651,8 +5605,8 @@ function catalogFamily(family) {
 
 // src/plugin/callout.ts
 import { existsSync as existsSync10 } from "fs";
-import { readFile as readFile9 } from "fs/promises";
-import { join as join11 } from "path";
+import { readFile as readFile10 } from "fs/promises";
+import { join as join10 } from "path";
 import { lerpArray, sample } from "@vosjs/timeline";
 import {
   CALLOUT_DEFAULT_BODY_PX,
@@ -5849,13 +5803,13 @@ async function footageFrames(browser, dir, doc, times, framesTake2) {
   const out = /* @__PURE__ */ new Map();
   if (!times.length) return out;
   const bare = { ...doc, overlays: [] };
-  const outDir = join11(dir, ".ground-check");
+  const outDir = join10(dir, ".ground-check");
   const res = await framesTake2(browser, dir, { times, outDir, doc: bare });
   for (const f of res.frames) {
     if (!existsSync10(f.file)) continue;
     out.set(
       +f.time.toFixed(3),
-      decodePng(new Uint8Array(await readFile9(f.file)))
+      decodePng(new Uint8Array(await readFile10(f.file)))
     );
   }
   return out;
@@ -5864,7 +5818,7 @@ async function footageFrames(browser, dir, doc, times, framesTake2) {
 // src/plugin/kitPicture.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
-import { readFile as readFile10 } from "fs/promises";
+import { readFile as readFile11 } from "fs/promises";
 var execFileP = promisify(execFile);
 var SUBJECT_BAND = { min: 0.6, max: 0.92 };
 var BLANK_INK = 0.12;
@@ -6140,7 +6094,7 @@ async function pictureChecks(assets) {
   let ffmpeg = null;
   for (const a of assets) {
     if (/\.png$/i.test(a.file)) {
-      const img = decodePng(new Uint8Array(await readFile10(a.file)));
+      const img = decodePng(new Uint8Array(await readFile11(a.file)));
       if (!img) {
         findings.push({
           code: "unreadable",
@@ -6234,8 +6188,8 @@ function formatFinding(f) {
 
 // src/plugin/validateKit.ts
 import { existsSync as existsSync11 } from "fs";
-import { readFile as readFile11, stat as stat3 } from "fs/promises";
-import { dirname as dirname3, isAbsolute as isAbsolute4, join as join12 } from "path";
+import { readFile as readFile12, stat as stat3 } from "fs/promises";
+import { dirname as dirname3, isAbsolute as isAbsolute4, join as join11 } from "path";
 import { DESTINATIONS as DESTINATIONS3 } from "@vosjs/studio-core";
 var PNG_SIG2 = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
 function pngDimensions(bytes) {
@@ -6254,7 +6208,7 @@ async function probeVideo(path) {
   const MB = await import("mediabunny");
   const input = new MB.Input({
     formats: MB.ALL_FORMATS,
-    source: new MB.BufferSource(new Uint8Array(await readFile11(path)))
+    source: new MB.BufferSource(new Uint8Array(await readFile12(path)))
   });
   try {
     const track = await input.getPrimaryVideoTrack();
@@ -6275,7 +6229,7 @@ async function validateKit(kitPath, opts = {}) {
   const measured = [];
   let kit;
   try {
-    kit = JSON.parse(await readFile11(kitPath, "utf8"));
+    kit = JSON.parse(await readFile12(kitPath, "utf8"));
   } catch (e) {
     return {
       valid: false,
@@ -6295,7 +6249,7 @@ async function validateKit(kitPath, opts = {}) {
   const base = dirname3(kitPath);
   const resolvePath = (p) => {
     if (isAbsolute4(p) && existsSync11(p)) return p;
-    const beside = join12(base, p.split("/").pop() ?? p);
+    const beside = join11(base, p.split("/").pop() ?? p);
     return beside;
   };
   const perDestination = /* @__PURE__ */ new Map();
@@ -6321,7 +6275,7 @@ async function validateKit(kitPath, opts = {}) {
     let h = null;
     let seconds = null;
     if (/\.(png|jpe?g|webp)$/i.test(file)) {
-      const head = Buffer.from(await readFile11(file));
+      const head = Buffer.from(await readFile12(file));
       const kind = sniffImage(head);
       if (file.toLowerCase().endsWith(".png") && kind !== "png")
         problems.push(
@@ -6430,8 +6384,8 @@ async function validateKit(kitPath, opts = {}) {
 }
 
 // src/plugin/recorder.ts
-import { writeFileSync as writeFileSync2 } from "fs";
-import { join as join13 } from "path";
+import { writeFileSync } from "fs";
+import { join as join12 } from "path";
 import { recordTake as recordTakeCore } from "@vosjs/render-core/record";
 async function recordTake(browser, url, actions, paths, log, opts = {}) {
   const dry = opts.dryRun === true;
@@ -6441,7 +6395,7 @@ async function recordTake(browser, url, actions, paths, log, opts = {}) {
     actions,
     {
       frame: (file, bytes) => {
-        writeFileSync2(join13(paths.framesDir, file), bytes);
+        writeFileSync(join12(paths.framesDir, file), bytes);
       }
     },
     log,
@@ -6493,11 +6447,11 @@ import {
 
 // src/plugin/session.ts
 import { spawn } from "child_process";
-import { existsSync as existsSync12, mkdirSync as mkdirSync2, readdirSync as readdirSync2, rmSync, statSync as statSync3 } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join14 } from "path";
+import { existsSync as existsSync12, mkdirSync, readdirSync as readdirSync2, rmSync, statSync as statSync3 } from "fs";
+import { homedir } from "os";
+import { join as join13 } from "path";
 import { chromium } from "playwright";
-var SESSIONS_DIR = join14(homedir2(), ".config", "vos", "sessions");
+var SESSIONS_DIR = join13(homedir(), ".config", "vos", "sessions");
 var NAME = /^[a-z0-9][a-z0-9._-]{0,63}$/i;
 function sessionNameVerdict(name) {
   if (!name) return "a session needs a name: --name <app>";
@@ -6506,20 +6460,20 @@ function sessionNameVerdict(name) {
   return null;
 }
 function sessionDir(name) {
-  return join14(SESSIONS_DIR, name);
+  return join13(SESSIONS_DIR, name);
 }
 function systemChromePath() {
   const explicit = process.env.VOS_BROWSER_PATH;
   if (explicit) return explicit;
   const candidates = process.platform === "darwin" ? ["/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"] : process.platform === "win32" ? [
-    join14(
+    join13(
       process.env["PROGRAMFILES"] ?? "C:\\Program Files",
       "Google",
       "Chrome",
       "Application",
       "chrome.exe"
     ),
-    join14(
+    join13(
       process.env["LOCALAPPDATA"] ?? "",
       "Google",
       "Chrome",
@@ -6541,7 +6495,7 @@ function systemChromePath() {
 async function openSession(name, url, opts = { log: () => {
 } }) {
   const dir = sessionDir(name);
-  mkdirSync2(dir, { recursive: true, mode: 448 });
+  mkdirSync(dir, { recursive: true, mode: 448 });
   const exe = systemChromePath();
   const args = [
     `--user-data-dir=${dir}`,
@@ -6613,7 +6567,7 @@ function summaryLine(s) {
 function listSessions() {
   if (!existsSync12(SESSIONS_DIR)) return [];
   return readdirSync2(SESSIONS_DIR, { withFileTypes: true }).filter((d) => d.isDirectory() && NAME.test(d.name)).map((d) => {
-    const st = statSync3(join14(SESSIONS_DIR, d.name));
+    const st = statSync3(join13(SESSIONS_DIR, d.name));
     return {
       name: d.name,
       ageDays: Math.floor(
@@ -6690,8 +6644,8 @@ async function encodeRecording(browser, takeDir, onProgress) {
 
 // src/plugin/plan.ts
 import { existsSync as existsSync13 } from "fs";
-import { readFile as readFile12 } from "fs/promises";
-import { join as join15 } from "path";
+import { readFile as readFile13 } from "fs/promises";
+import { join as join14 } from "path";
 import {
   DEFAULT_FRAME_STYLE,
   STYLE_FIELDS,
@@ -6913,10 +6867,10 @@ function retimeCut(prev, newSteps, newDurationMs) {
 // src/plugin/plan.ts
 var overlaps = (a, b) => a.in < b.out && b.in < a.out;
 async function readDigestActivity(dir) {
-  const file = join15(dir, "digest", "digest.json");
+  const file = join14(dir, "digest", "digest.json");
   if (!existsSync13(file)) return null;
   try {
-    const d = JSON.parse(await readFile12(file, "utf8"));
+    const d = JSON.parse(await readFile13(file, "utf8"));
     return Array.isArray(d.activity) && d.activity.every((v) => typeof v === "number") ? d.activity : null;
   } catch {
     return null;
@@ -6977,7 +6931,7 @@ async function planTake(dir, opts = {}) {
   const take = await loadTake(dir);
   const { meta, cursor } = take;
   const activity = await readDigestActivity(dir);
-  const ingest = opts.backdrop ? { frame: withBackdrop(DEFAULT_FRAME_STYLE, opts.backdrop) } : {};
+  const ingest = opts.footage ? { footage: true } : opts.backdrop ? { frame: withBackdrop(DEFAULT_FRAME_STYLE, opts.backdrop) } : {};
   let doc;
   let fresh;
   let layout;
@@ -7129,16 +7083,16 @@ async function planTake(dir, opts = {}) {
 }
 
 // src/plugin/sync.ts
-import { createHash } from "crypto";
-import { existsSync as existsSync14, readFileSync as readFileSync3, readdirSync as readdirSync3 } from "fs";
-import { readFile as readFile13 } from "fs/promises";
+import { createHash as createHash2 } from "crypto";
+import { existsSync as existsSync14, readFileSync as readFileSync2, readdirSync as readdirSync3 } from "fs";
+import { readFile as readFile14 } from "fs/promises";
 import { createInterface } from "readline/promises";
-import { basename as basename3, join as join17 } from "path";
+import { basename as basename3, join as join16 } from "path";
 import { lowerToComposition as lowerToComposition3, migrateHostedDoc as migrateHostedDoc3 } from "@vosjs/studio-core";
 
 // src/plugin/folder.ts
 import { mkdir as mkdir8, writeFile as writeFile10 } from "fs/promises";
-import { join as join16 } from "path";
+import { join as join15 } from "path";
 import { recipeHints } from "@vosjs/shared/frontmatter";
 import { migrateHostedDoc as migrateHostedDoc2 } from "@vosjs/studio-core";
 var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["json", "help", "media"]);
@@ -7314,18 +7268,18 @@ async function cmdPull(argv) {
     throw new Error(apiError(`pull folder ${folder.slug}`, res));
   const payload = res.body;
   const out = strFlag(flags, "out") ?? folder.slug;
-  await mkdir8(join16(out, "recipes"), { recursive: true });
+  await mkdir8(join15(out, "recipes"), { recursive: true });
   const lines = [];
   const recipes = [];
   for (const rec of payload.recipes) {
-    const path = join16(out, "recipes", safeName(rec.filename));
+    const path = join15(out, "recipes", safeName(rec.filename));
     await writeFile10(path, rec.body ?? "");
     recipes.push({ path, line: recipeLine(rec.filename, rec.body ?? "") });
   }
   for (const rec of payload.inheritedRecipes) {
     const from = safeName(rec.folderSlug ?? "inherited");
-    await mkdir8(join16(out, "recipes", "_inherited", from), { recursive: true });
-    const path = join16(
+    await mkdir8(join15(out, "recipes", "_inherited", from), { recursive: true });
+    const path = join15(
       out,
       "recipes",
       "_inherited",
@@ -7340,7 +7294,7 @@ async function cmdPull(argv) {
   }
   const members = [];
   for (const v of payload.voses) {
-    const dir = join16(out, "members", safeName(v.slug || v.title || v.id));
+    const dir = join15(out, "members", safeName(v.slug || v.title || v.id));
     await mkdir8(dir, { recursive: true });
     const cfg = await apiJson(origin, `/api/vos/${v.id}/config`, { key });
     if (cfg.status !== 200) {
@@ -7348,7 +7302,7 @@ async function cmdPull(argv) {
       continue;
     }
     await writeFile10(
-      join16(dir, "config.json"),
+      join15(dir, "config.json"),
       JSON.stringify(cfg.body.config, null, 2)
     );
     let take = false;
@@ -7360,7 +7314,7 @@ async function cmdPull(argv) {
       );
       if (doc.status === 200) {
         await writeFile10(
-          join16(dir, "doc.json"),
+          join15(dir, "doc.json"),
           JSON.stringify(doc.body, null, 2)
         );
         take = true;
@@ -7430,144 +7384,6 @@ async function cmdFolder(argv) {
   }
 }
 
-// src/plugin/uploadAsset.ts
-var SINGLE_SHOT_MAX_BYTES = 32 * 1024 * 1024;
-var PART_ATTEMPTS = 3;
-function planParts(totalBytes, partBytes) {
-  if (totalBytes <= 0 || partBytes <= 0) return [];
-  const parts = [];
-  for (let start = 0; start < totalBytes; start += partBytes) {
-    parts.push({
-      partNumber: parts.length + 1,
-      start,
-      end: Math.min(start + partBytes, totalBytes)
-    });
-  }
-  return parts;
-}
-function failed(what, r) {
-  const detail = typeof r.body.error === "string" ? r.body.error : "";
-  return new Error(`${what} (${r.status})${detail ? `: ${detail}` : ""}`);
-}
-function asAsset(body) {
-  return {
-    id: String(body.id),
-    url: String(body.url),
-    size: typeof body.size === "number" ? body.size : 0,
-    reused: body.reused === true
-  };
-}
-function transient(status) {
-  return status >= 500 || status === 429;
-}
-var wait = (ms) => new Promise((r) => setTimeout(r, ms));
-async function uploadAsset(target, bytes, opts) {
-  return bytes.length > SINGLE_SHOT_MAX_BYTES ? uploadInParts(target, bytes, opts) : uploadWhole(target, bytes, opts);
-}
-async function uploadWhole(target, bytes, opts) {
-  const res = await apiJson(target.origin, "/api/assets/recording", {
-    method: "POST",
-    key: target.key,
-    headers: {
-      "Content-Type": opts.contentType,
-      "Content-Length": String(bytes.length),
-      "X-Filename": opts.filename,
-      "X-Content-Hash": opts.contentHash,
-      ...opts.durationSeconds && opts.durationSeconds > 0 ? { "X-Content-Duration": opts.durationSeconds.toFixed(3) } : {}
-    },
-    raw: bytes
-  });
-  if (res.status !== 201 && res.status !== 200)
-    throw failed("upload failed", res);
-  return asAsset(res.body);
-}
-async function uploadInParts(target, bytes, opts) {
-  const begun = await apiJson(
-    target.origin,
-    "/api/assets/recording/multipart",
-    {
-      method: "POST",
-      key: target.key,
-      body: {
-        filename: opts.filename,
-        contentType: opts.contentType,
-        size: bytes.length,
-        contentHash: opts.contentHash,
-        ...opts.durationSeconds && opts.durationSeconds > 0 ? { durationSeconds: opts.durationSeconds } : {}
-      }
-    }
-  );
-  if (begun.status !== 201 && begun.status !== 200) {
-    throw failed("upload failed", begun);
-  }
-  if (begun.body.reused === true || typeof begun.body.url === "string") {
-    return asAsset(begun.body);
-  }
-  const uploadId = String(begun.body.id);
-  const partBytes = Number(begun.body.partBytes);
-  if (!Number.isFinite(partBytes) || partBytes <= 0) {
-    throw new Error("upload failed: the platform returned no part size");
-  }
-  const parts = planParts(bytes.length, partBytes);
-  const etags = [];
-  try {
-    for (const part of parts) {
-      const chunk2 = bytes.subarray(part.start, part.end);
-      let sent = null;
-      for (let attempt = 1; attempt <= PART_ATTEMPTS; attempt++) {
-        try {
-          sent = await apiJson(
-            target.origin,
-            `/api/assets/recording/multipart/${uploadId}/parts/${part.partNumber}`,
-            {
-              method: "PUT",
-              key: target.key,
-              headers: {
-                "Content-Type": "application/octet-stream",
-                "Content-Length": String(chunk2.length)
-              },
-              raw: chunk2
-            }
-          );
-        } catch (networkError) {
-          if (attempt === PART_ATTEMPTS) throw networkError;
-          await wait(500 * 2 ** (attempt - 1));
-          continue;
-        }
-        if (sent.status === 200) break;
-        if (!transient(sent.status) || attempt === PART_ATTEMPTS) {
-          throw failed(`part ${part.partNumber} failed`, sent);
-        }
-        await wait(500 * 2 ** (attempt - 1));
-      }
-      if (!sent || sent.status !== 200) {
-        throw new Error(`part ${part.partNumber} failed`);
-      }
-      etags.push({
-        partNumber: Number(sent.body.partNumber),
-        etag: String(sent.body.etag)
-      });
-      opts.onPart?.(etags.length, parts.length);
-    }
-    const sealed = await apiJson(
-      target.origin,
-      `/api/assets/recording/multipart/${uploadId}/complete`,
-      { method: "POST", key: target.key, body: { parts: etags } }
-    );
-    if (sealed.status !== 201 && sealed.status !== 200) {
-      throw failed("upload failed", sealed);
-    }
-    return asAsset(sealed.body);
-  } catch (err) {
-    await apiJson(
-      target.origin,
-      `/api/assets/recording/multipart/${uploadId}`,
-      { method: "DELETE", key: target.key }
-    ).catch(() => void 0);
-    throw err;
-  }
-}
-
 // src/plugin/sync.ts
 function apiContext(flags) {
   return {
@@ -7634,8 +7450,8 @@ function storageStateInDir(dir) {
     if (!f.endsWith(".json") || f === "doc.json" || f === "meta.json" || f === "actions.json" || f === "cursor.json" || f === "vos.json" || f === "doc.prev.json")
       continue;
     try {
-      const v = JSON.parse(readFileSync3(join17(dir, f), "utf8"));
-      if (looksLikeStorageState(v)) return join17(dir, f);
+      const v = JSON.parse(readFileSync2(join16(dir, f), "utf8"));
+      if (looksLikeStorageState(v)) return join16(dir, f);
     } catch {
     }
   }
@@ -7705,8 +7521,8 @@ async function pushTake(dir, flags, r) {
       throw new Error("push cancelled");
     }
   }
-  const bytes = await readFile13(take.paths.recording);
-  const hash = createHash("sha256").update(bytes).digest("hex");
+  const bytes = await readFile14(take.paths.recording);
+  const hash = createHash2("sha256").update(bytes).digest("hex");
   const { type: contentType } = resolveMediaType({
     head: bytes.subarray(0, MEDIA_HEAD_BYTES),
     filename: take.paths.recordingName
@@ -7747,39 +7563,7 @@ async function pushTake(dir, flags, r) {
     r.log("  mic track is local-only \u2014 dropped from the push");
     delete docForPush.source.micKey;
   }
-  for (const ref of docMediaRefs(docForPush)) {
-    const file = join17(dir, takeRelativeFile(ref.key));
-    if (!existsSync14(file)) {
-      r.log(`  ${ref.where}: ${ref.key} is not in the take \u2014 left as is`);
-      continue;
-    }
-    const media = await readFile13(file);
-    const mediaHash = createHash("sha256").update(media).digest("hex");
-    const { type } = resolveMediaType({
-      head: media.subarray(0, MEDIA_HEAD_BYTES),
-      filename: file
-    });
-    const name = nameForType(basename3(file), type);
-    if (name !== basename3(file)) {
-      r.log(`  ${ref.where}: ${basename3(file)} holds ${type} \u2014 sent as ${name}`);
-    }
-    let put;
-    try {
-      put = await uploadAsset(ctx, new Uint8Array(media), {
-        filename: name,
-        contentType: type,
-        contentHash: mediaHash
-      });
-    } catch (e) {
-      throw new Error(
-        `${ref.where} upload failed: ${e instanceof Error ? e.message : String(e)}`
-      );
-    }
-    ref.set(put.url);
-    r.log(
-      `  ${ref.where}: ${ref.key} \u2192 asset ${put.id}${put.reused ? " (reused)" : ""}`
-    );
-  }
+  await uploadDocRefs(docMediaRefs(docForPush), dir, ctx, (l) => r.log(l));
   const lowered = lowerToComposition3(docForPush);
   const config = { ...lowered.config, data: lowered.data };
   if (!state) {
@@ -7893,9 +7677,9 @@ async function pullTake(dir, flags, r) {
       };
     }
     let media2;
-    if (flags.media && existsSync14(join17(dir, "doc.json"))) {
+    if (flags.media && existsSync14(join16(dir, "doc.json"))) {
       const local = JSON.parse(
-        await readFile13(join17(dir, "doc.json"), "utf8")
+        await readFile14(join16(dir, "doc.json"), "utf8")
       );
       media2 = await pullMedia(ctx, dir, local, r.log);
     }
@@ -7959,7 +7743,7 @@ async function pullTake(dir, flags, r) {
   if (existsSync14(localRecording)) {
     doc.source.videoKey = basename3(localRecording);
   }
-  await writeJson(join17(dir, "doc.json"), doc, true);
+  await writeJson(join16(dir, "doc.json"), doc, true);
   const media = flags.media ? await pullMedia(ctx, dir, doc, r.log) : void 0;
   const versions = await api(ctx, `/vos/${vosId}/versions`);
   const headRow = (versions.json.versions ?? []).find((v) => v.id === head);
@@ -7979,9 +7763,9 @@ async function pullTake(dir, flags, r) {
 
 // src/plugin/program.ts
 import { existsSync as existsSync15 } from "fs";
-import { mkdir as mkdir9, readFile as readFile14, writeFile as writeFile11 } from "fs/promises";
+import { mkdir as mkdir9, readFile as readFile15, writeFile as writeFile11 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline/promises";
-import { basename as basename4, dirname as dirname4, join as join18 } from "path";
+import { basename as basename4, dirname as dirname4, join as join17 } from "path";
 import {
   CURRENT_CONFIG_VERSION,
   migrateConfig,
@@ -8121,7 +7905,8 @@ var BOOLEAN_FLAGS2 = /* @__PURE__ */ new Set([
   "check",
   "yes",
   "claimable",
-  "no-browser"
+  "no-browser",
+  "wait"
 ]);
 var MULTI_FLAGS = /* @__PURE__ */ new Set(["override"]);
 function preflightConfig(parsed) {
@@ -8186,7 +7971,7 @@ function preflightConfig(parsed) {
 }
 function resolveConfigPath(target) {
   if (target.endsWith(".json")) return target;
-  const inDir = join18(target, "config.json");
+  const inDir = join17(target, "config.json");
   if (existsSync15(inDir)) return inDir;
   throw new UsageError(
     `${target} has no config.json (and is not a take \u2014 no doc.json)`
@@ -8215,7 +8000,7 @@ async function cmdFetch(argv) {
   const out = strFlag(flags, "out") ?? slug;
   await mkdir9(out, { recursive: true });
   await writeFile11(
-    join18(out, "config.json"),
+    join17(out, "config.json"),
     JSON.stringify(cfg.body.config, null, 2)
   );
   const title = typeof vosMeta.title === "string" ? vosMeta.title : "";
@@ -8240,12 +8025,12 @@ async function cmdFetch(argv) {
       const hosted = migrateHostedDoc4(doc.body);
       const { config: own } = await writeProgramDoc(out, hosted);
       if (own) {
-        await writeFile11(join18(out, "config.json"), JSON.stringify(own, null, 2));
+        await writeFile11(join17(out, "config.json"), JSON.stringify(own, null, 2));
       }
     } else if (doc.status === 200) {
       take = true;
       const hosted = migrateHostedDoc4(doc.body);
-      await writeFile11(join18(out, "doc.json"), JSON.stringify(hosted, null, 2));
+      await writeFile11(join17(out, "doc.json"), JSON.stringify(hosted, null, 2));
       if (flags.media === true) {
         const media = await pullMedia({ origin, key }, out, hosted, r.log);
         mediaLine = media.downloaded.length ? ` + ${media.downloaded.map((m) => m.file).join(", ")}` : "";
@@ -8358,7 +8143,7 @@ async function cmdPushProgram(argv) {
     api: strFlag(flags, "api")
   });
   const dir = dirname4(source);
-  const parsed = JSON.parse(await readFile14(source, "utf8"));
+  const parsed = JSON.parse(await readFile15(source, "utf8"));
   const pre = preflightConfig(parsed);
   if (!pre.ok || !pre.config) {
     for (const issue of pre.issues) r.log(`error ${issue}`);
@@ -8387,7 +8172,25 @@ async function cmdPushProgram(argv) {
     }
     const fallback = state?.title ? `${state.title} remix` : basename4(source).replace(/\.json$/i, "") || "vos program";
     const title2 = (strFlag(flags, "title") ?? fallback).slice(0, 100);
-    const body = { title: title2, config };
+    let claimDoc = programDoc;
+    if (programDoc) {
+      const sound = soundOf(programDoc);
+      const local = docAudioRefs(sound);
+      if (local.length) {
+        const dropped = new Set(local.map((ref) => ref.key));
+        claimDoc = {
+          ...programDoc,
+          audio: (sound.audio ?? []).filter((a) => !dropped.has(a.key))
+        };
+        r.log(
+          `warning a claimable push carries no files, so ${local.length} local sound${local.length === 1 ? "" : "s"} (${[...dropped].join(", ")}) ${local.length === 1 ? "was" : "were"} left out. After the claim, push again with a key to add ${local.length === 1 ? "it" : "them"}`
+        );
+      }
+    }
+    const body = {
+      title: title2,
+      config: storedProgramConfig(config, claimDoc)
+    };
     const slug = strFlag(flags, "slug");
     if (slug) body.slug = slug;
     const res = await apiJson(origin, "/api/claim", { method: "POST", body });
@@ -8407,6 +8210,15 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
     return EXIT_OK;
   }
   const key = requireCredential(strFlag(flags, "key"));
+  void flags.yes;
+  if (programDoc) {
+    await uploadDocRefs(
+      docAudioRefs(soundOf(programDoc)),
+      dir,
+      { origin, key },
+      (l) => r.log(l)
+    );
+  }
   const overrides = [
     ...multi.override ?? [],
     ...strFlag(flags, "overrides")?.split(",") ?? []
@@ -8476,6 +8288,13 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
     }
     const watchUrl2 = `${origin}/vos/${vosId}`;
     const studioUrl2 = `${origin}/studio?vos=${vosId}`;
+    const landed2 = flags.wait === true ? await waitForLanded({
+      origin,
+      key,
+      vosId,
+      versionId: typeof version.id === "string" ? version.id : null,
+      log: (l) => r.log(l)
+    }) : null;
     r.done(
       {
         id: vosId,
@@ -8483,11 +8302,17 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
         versionNumber: version.versionNumber ?? null,
         base: base ?? null,
         watchUrl: watchUrl2,
-        studioUrl: studioUrl2
+        studioUrl: studioUrl2,
+        ...landed2 ? {
+          still: landed2.still,
+          thumbnailUrl: landed2.thumbnailUrl,
+          previewUrl: landed2.previewUrl
+        } : {}
       },
       `Pushed version ${String(version.versionNumber ?? "?")} of ${vosId}
   watch:  ${watchUrl2}
-  studio: ${studioUrl2}`
+  studio: ${studioUrl2}` + (landed2 ? `
+${landedLines(landed2)}` : "")
     );
     return EXIT_OK;
   }
@@ -8523,20 +8348,35 @@ with their key: vos push ${source} --vos ${String(created2.id ?? "<id>")}`
   });
   const watchUrl = `${origin}/vos/${created.id}`;
   const studioUrl = `${origin}/studio?vos=${created.id}`;
+  const landed = flags.wait === true ? await waitForLanded({
+    origin,
+    key,
+    vosId: created.id,
+    versionId: created.currentVersionId,
+    log: (l) => r.log(l)
+  }) : null;
   r.done(
     {
       id: created.id,
       slug: created.slug,
       title,
       visibility: "private",
+      folder: folderRef ?? null,
       remixOfId: remixOfId ?? null,
       currentVersionId: created.currentVersionId,
       watchUrl,
-      studioUrl
+      studioUrl,
+      ...landed ? {
+        still: landed.still,
+        thumbnailUrl: landed.thumbnailUrl,
+        previewUrl: landed.previewUrl
+      } : {}
     },
     `Created private vos ${created.id} (${title})
   watch:  ${watchUrl}
   studio: ${studioUrl}
+` + (landed ? `${landedLines(landed)}
+` : "") + `  shelf:  ${folderRef ? `in ${folderRef}` : `unfiled, at the root of your shelf (file it: vos folder move ${created.id} --to <slug>)`}
 Iterate with: vos push ${source} --vos ${created.id}`
   );
   return EXIT_OK;
@@ -8608,10 +8448,10 @@ async function cmdPullProgram(argv) {
   const cfg = await apiJson(origin, `/api/vos/${vosId}/config`, { key });
   if (cfg.status !== 200)
     throw new Error(apiError(`fetch head config for ${vosId}`, cfg));
-  const configPath = join18(dir, "config.json");
+  const configPath = join17(dir, "config.json");
   let backedUp = false;
   if (existsSync15(configPath)) {
-    await writeFile11(join18(dir, "config.backup.json"), await readFile14(configPath));
+    await writeFile11(join17(dir, "config.backup.json"), await readFile15(configPath));
     backedUp = true;
   }
   let headConfig = cfg.body.config;
@@ -8644,7 +8484,7 @@ async function cmdPullProgram(argv) {
       protected: protectedIds,
       changes,
       out: configPath,
-      backup: backedUp ? join18(dir, "config.backup.json") : null
+      backup: backedUp ? join17(dir, "config.backup.json") : null
     },
     `Pulled ${changes.length} version${changes.length === 1 ? "" : "s"} \u2192 ${configPath}` + (backedUp ? ` (previous copy: config.backup.json)` : "") + `
 Re-apply your edit on the new head, then: vos push ${configPath} --vos ${vosId}`
@@ -8715,15 +8555,18 @@ async function storeKey(key, origin, r) {
 function isTakeDir(target) {
   return directoryKind(target) === "take";
 }
+function soundOf(doc) {
+  return { audio: Array.isArray(doc.audio) ? doc.audio : [] };
+}
 function storedProgramConfig(config, programDoc) {
   if (!programDoc) return config;
   const doc = { audio: [], ...programDoc };
   return lowerProgramDoc(doc).config;
 }
 async function readProgramDoc(dir, config) {
-  const docPath = join18(dir, "doc.json");
+  const docPath = join17(dir, "doc.json");
   if (!existsSync15(docPath)) return null;
-  const parsed = JSON.parse(await readFile14(docPath, "utf8"));
+  const parsed = JSON.parse(await readFile15(docPath, "utf8"));
   if (typeof parsed !== "object" || parsed === null || "source" in parsed)
     return null;
   const raw = parsed;
@@ -8734,14 +8577,15 @@ async function writeProgramDoc(dir, hosted) {
   const program = hosted.program && typeof hosted.program === "object" ? hosted.program : {};
   const { config, ...rest } = program;
   const onDisk = { ...hosted, program: rest };
-  await writeFile11(join18(dir, "doc.json"), JSON.stringify(onDisk, null, 2));
+  await writeFile11(join17(dir, "doc.json"), JSON.stringify(onDisk, null, 2));
   return {
     config: config && typeof config === "object" ? config : null
   };
 }
 
 // src/plugin/asset.ts
-import { readFileSync as readFileSync4 } from "fs";
+import { createHash as createHash3 } from "crypto";
+import { readFileSync as readFileSync3 } from "fs";
 import { basename as basename5, extname as extname2 } from "path";
 var BOOLEAN_FLAGS3 = /* @__PURE__ */ new Set(["json", "help"]);
 var MIME_BY_EXT = {
@@ -8792,10 +8636,38 @@ async function cmdPush(argv) {
   const folderRef = strFlag(flags, "folder");
   const folder = folderRef ? resolveFolder(await listFolders(origin, key), folderRef) : null;
   const uploaded = [];
+  let unfiledMedia = 0;
   for (const file of positionals) {
     const name = basename5(file);
+    const body = readFileSync3(file);
+    const media = resolveMediaType({
+      head: body.subarray(0, MEDIA_HEAD_BYTES),
+      filename: name
+    });
+    if (/^(audio|video)\//.test(media.type)) {
+      const sent = nameForType(name, media.type);
+      let put;
+      try {
+        put = await uploadAsset({ origin, key }, new Uint8Array(body), {
+          filename: sent,
+          contentType: media.type,
+          contentHash: createHash3("sha256").update(body).digest("hex"),
+          ...folder ? { folderId: folder.id } : {}
+        });
+      } catch (e) {
+        const landed = uploaded.length ? ` (${uploaded.length} of ${positionals.length} landed before it)` : "";
+        throw new Error(
+          `push ${name}${landed}: ${e instanceof Error ? e.message : String(e)}`
+        );
+      }
+      if (!folder && !put.reused) unfiledMedia += 1;
+      uploaded.push({ id: put.id, filename: sent });
+      r.log(
+        `uploaded ${sent} (${put.id})${put.reused ? " \u2014 already on your shelf" : ""}  ${put.url}`
+      );
+      continue;
+    }
     const mime = MIME_BY_EXT[extname2(name).toLowerCase()] ?? "application/octet-stream";
-    const body = readFileSync4(file);
     const form = new FormData();
     form.set("file", new Blob([body], { type: mime }), name);
     if (folder) form.set("folderId", folder.id);
@@ -8829,7 +8701,8 @@ async function cmdPush(argv) {
       count: uploaded.length,
       folder: folder?.slug ?? null
     },
-    `pushed ${uploaded.length} asset${uploaded.length === 1 ? "" : "s"}${folder ? ` into ${folder.slug}` : ""}`
+    `pushed ${uploaded.length} asset${uploaded.length === 1 ? "" : "s"}${folder ? ` into ${folder.slug}` : ""}` + (unfiledMedia ? `
+note: an unfiled sound or video that no document uses is removed after 7 days. Reference it from a doc (doc.audio key = its url) or push it with --folder <slug>` : "")
   );
   return EXIT_OK;
 }
@@ -8848,10 +8721,69 @@ async function cmdAsset(argv) {
   }
 }
 
+// src/plugin/remove.ts
+import { existsSync as existsSync16, rmSync as rmSync2, statSync as statSync4 } from "fs";
+import { join as join18 } from "path";
+import { createInterface as createInterface3 } from "readline/promises";
+var BOOLEAN_FLAGS4 = /* @__PURE__ */ new Set(["json", "help", "yes"]);
+async function cmdDelete(argv) {
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS4);
+  const target = positionals[0];
+  if (!target)
+    throw new UsageError("vos delete <vosId|watch-url|dir> [--yes] [--json]");
+  const r = createReporter(flags.json === true);
+  const origin = platformOrigin({
+    origin: strFlag(flags, "origin"),
+    api: strFlag(flags, "api")
+  }).replace(/\/+$/, "");
+  const key = requireCredential(strFlag(flags, "key"));
+  const dir = existsSync16(target) && statSync4(target).isDirectory() ? target : null;
+  const vosId = dir ? readSyncState(dir)?.vosId : parseVosId(target);
+  if (!vosId)
+    throw new UsageError(
+      `${target} tracks no vos (no ${SYNC_STATE_NAME}): pass the vos id or its watch URL`
+    );
+  const meta = await apiJson(origin, `/api/vos/${vosId}`, { key });
+  if (meta.status !== 200) throw new Error(apiError(`read ${vosId}`, meta));
+  const vos = meta.body.vos ?? {};
+  const title = typeof vos.title === "string" ? vos.title : vosId;
+  if (flags.yes !== true) {
+    if (!process.stdin.isTTY)
+      throw new UsageError(
+        `deleting "${title}" (${vosId}) cannot be undone: re-run with --yes to confirm`
+      );
+    const rl = createInterface3({ input: process.stdin, output: process.stderr });
+    const answer = await rl.question(
+      `Delete "${title}" (${vosId}) and every version of it? This cannot be undone. [y/N] `
+    );
+    rl.close();
+    if (!/^y(es)?$/i.test(answer.trim())) {
+      r.done({ id: vosId, deleted: false }, "kept \u2014 nothing was deleted");
+      return EXIT_OK;
+    }
+  }
+  const res = await apiJson(origin, `/api/vos/${vosId}`, {
+    method: "DELETE",
+    key
+  });
+  if (res.status !== 200 && res.status !== 204)
+    throw new Error(apiError(`delete ${vosId}`, res));
+  let unlinked = false;
+  if (dir) {
+    rmSync2(join18(dir, SYNC_STATE_NAME), { force: true });
+    unlinked = true;
+  }
+  r.done(
+    { id: vosId, title, deleted: true, unlinked },
+    `deleted "${title}" (${vosId})${unlinked ? `; ${dir} no longer tracks it` : ""}`
+  );
+  return EXIT_OK;
+}
+
 // src/plugin/recipe.ts
-import { readFileSync as readFileSync5 } from "fs";
+import { readFileSync as readFileSync4 } from "fs";
 import { basename as basename6 } from "path";
-var BOOLEAN_FLAGS4 = /* @__PURE__ */ new Set(["json", "help"]);
+var BOOLEAN_FLAGS5 = /* @__PURE__ */ new Set(["json", "help"]);
 var USAGE = "vos recipe push <file.md> (--folder <folderId|slug> | --asset <assetId>)";
 function recipeFilename(file) {
   const name = basename6(file);
@@ -8861,7 +8793,7 @@ function recipeFilename(file) {
   return name;
 }
 async function cmdPush2(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS4);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS5);
   const [file] = positionals;
   const folderRef = strFlag(flags, "folder");
   const assetId = strFlag(flags, "asset");
@@ -8869,7 +8801,7 @@ async function cmdPush2(argv) {
     throw new UsageError(USAGE);
   }
   const filename = recipeFilename(file);
-  const body = readFileSync5(file);
+  const body = readFileSync4(file);
   const r = createReporter(flags.json === true);
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -9890,8 +9822,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: readFile17 } = await import("fs/promises");
-  const text = await readFile17(resolve8(input), "utf8");
+  const { readFile: readFile18 } = await import("fs/promises");
+  const text = await readFile18(resolve8(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -9928,9 +9860,9 @@ function summary(result) {
 }
 async function cmdActionsScript(input, flags) {
   const r = createReporter(flags.json === true);
-  const { readFile: readFile17 } = await import("fs/promises");
+  const { readFile: readFile18 } = await import("fs/promises");
   const { shotList, formatShotList } = await import("./shotList-KH6FTX4L.js");
-  const raw = JSON.parse(await readFile17(resolve8(input), "utf8"));
+  const raw = JSON.parse(await readFile18(resolve8(input), "utf8"));
   const errors = validateActions(raw);
   if (errors.length) throw new UsageError(`${input}:
   ${errors.join("\n  ")}`);
@@ -9940,8 +9872,8 @@ async function cmdActionsScript(input, flags) {
 }
 
 // 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 { existsSync as existsSync17 } from "fs";
+import { copyFile, mkdir as mkdir10, readFile as readFile16, stat as stat4 } from "fs/promises";
 import { basename as basename7, join as join19, resolve as resolve9 } from "path";
 import { inflateRawSync } from "zlib";
 import {
@@ -9962,7 +9894,7 @@ import {
   Output,
   WebMOutputFormat
 } from "mediabunny";
-var BOOLEAN_FLAGS5 = /* @__PURE__ */ new Set(["json", "help"]);
+var BOOLEAN_FLAGS6 = /* @__PURE__ */ new Set(["json", "help"]);
 async function probeVideoFile(path) {
   const input = new Input({
     source: new FilePathSource(path),
@@ -10030,7 +9962,7 @@ async function readTraceFile(path, offsetMs) {
     );
   }
   if (kind === "zip") {
-    const bytes = new Uint8Array(await readFile15(path));
+    const bytes = new Uint8Array(await readFile16(path));
     const entry = playwrightTraceEntry(zipEntries(bytes));
     if (!entry) {
       throw new UsageError(
@@ -10043,7 +9975,7 @@ async function readTraceFile(path, offsetMs) {
     );
     return cursorFromPlaywrightTrace(text2, { offsetMs });
   }
-  const text = await readFile15(path, "utf8");
+  const text = await readFile16(path, "utf8");
   return cursorFromTrace(basename7(path), text, { offsetMs });
 }
 function parseViewport(v) {
@@ -10053,20 +9985,28 @@ function parseViewport(v) {
   return { width: Number(m[1]), height: Number(m[2]) };
 }
 async function cmdIngest(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS5, MULTI_FLAGS2);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS6, 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]"
+      "vos ingest <video.webm|mp4> [--cursor <trace.zip|steps.jsonl|cursor.csv>] [--as footage|take] [--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`);
+  if (!existsSync17(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);
+  const asFlag = strFlag(flags, "as");
+  if (asFlag !== void 0 && asFlag !== "footage" && asFlag !== "take")
+    throw new UsageError("--as expects footage or take");
+  const footage = asFlag ? asFlag === "footage" : !cursorPath;
+  if (footage && strFlag(flags, "background") !== void 0)
+    r.log(
+      "note: finished footage opens bare, so --background is not used (pass --as take for the screen-recording card and its ground)"
+    );
+  const backdrop = footage ? null : await takeBackdrop(flags, r);
   r.log(`probing ${basename7(videoPath)}\u2026`);
   const probed = await probeVideoFile(videoPath);
   if (!(probed.durationMs > 0)) {
@@ -10079,7 +10019,7 @@ async function cmdIngest(argv) {
     trace = await readTraceFile(resolve9(cursorPath), offsetMs);
     for (const n of trace.notes) r.log(`note: ${n}`);
   }
-  if (existsSync16(join19(outDir, "meta.json"))) {
+  if (existsSync17(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` : "")
@@ -10112,12 +10052,13 @@ async function cmdIngest(argv) {
   };
   await writeJson(paths.meta, meta, true);
   if (events.length) await writeJson(paths.cursor, events);
-  const plan = await planTake(outDir, { backdrop });
+  const plan = await planTake(outDir, { backdrop, footage });
   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`;
+  const opened = footage ? `opened as finished footage: no card, no browser bar, no drawn cursor, ${meta.fps > 30 ? 60 : 30} fps export (--as take for a screen recording's card)` : `opened as a screen recording: the card, its ground and the drawn cursor (--as footage to open it bare)`;
+  const next = footage && !trace ? `Next: vos push ${outDir} --wait \u2014 it lands as it is; trim or add to it in the studio` : 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,
@@ -10139,9 +10080,11 @@ async function cmdIngest(argv) {
         notes: trace.notes
       } : null,
       zooms: plan.zoomAuto,
-      backdrop: plan.backdrop ?? null
+      backdrop: plan.backdrop ?? null,
+      as: footage ? "footage" : "take"
     },
     `Ingested ${basename7(videoPath)} \u2192 ${outDir}/${basename7(recording)} (${facts})
+  ${opened}
   ${cursorLine}
   ${next}`
   );
@@ -10152,18 +10095,18 @@ async function cmdIngest(argv) {
 import { spawnSync } from "child_process";
 import {
   cpSync,
-  existsSync as existsSync18,
-  mkdirSync as mkdirSync3,
-  readFileSync as readFileSync7,
-  rmSync as rmSync2,
-  writeFileSync as writeFileSync3
+  existsSync as existsSync19,
+  mkdirSync as mkdirSync2,
+  readFileSync as readFileSync6,
+  rmSync as rmSync3,
+  writeFileSync as writeFileSync2
 } from "fs";
-import { homedir as homedir3 } from "os";
+import { homedir as homedir2 } from "os";
 import { join as join21 } from "path";
 import { chromium as chromium2 } from "playwright";
 
 // src/plugin/machine.ts
-import { existsSync as existsSync17, readFileSync as readFileSync6, readdirSync as readdirSync4, statSync as statSync4 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync5, readdirSync as readdirSync4, statSync as statSync5 } from "fs";
 import { dirname as dirname5, join as join20 } from "path";
 var AGENT_NAMES = [
   "claude",
@@ -10184,7 +10127,7 @@ var HOME_DIRS = {
   copilot: [".copilot"]
 };
 function detectAgents(root, opts = {}) {
-  const exists = opts.exists ?? existsSync17;
+  const exists = opts.exists ?? existsSync18;
   const out = [];
   for (const agent of AGENT_NAMES) {
     for (const rel of PROJECT_DIRS[agent]) {
@@ -10231,7 +10174,7 @@ function skillsDirFor(home) {
 function fallbackSkillsHome(root) {
   return { agent: "codex", dir: join20(root, ".agents"), scope: "project" };
 }
-function installedSkills(dir, exists = existsSync17, list = (p) => {
+function installedSkills(dir, exists = existsSync18, list = (p) => {
   try {
     return readdirSync4(p);
   } catch {
@@ -10271,7 +10214,7 @@ ${RULES_BLOCK}
   }
   return { text, changed: text !== current };
 }
-function rulesFileFor(root, exists = existsSync17) {
+function rulesFileFor(root, exists = existsSync18) {
   const agents = join20(root, "AGENTS.md");
   if (exists(agents)) return agents;
   const claude = join20(root, "CLAUDE.md");
@@ -10378,12 +10321,12 @@ function bundledSkillsDir(from) {
   let dir = dirname5(from);
   for (let i = 0; i < 6; i++) {
     const pkg = join20(dir, "package.json");
-    if (existsSync17(pkg)) {
+    if (existsSync18(pkg)) {
       try {
-        const name = JSON.parse(readFileSync6(pkg, "utf8")).name;
+        const name = JSON.parse(readFileSync5(pkg, "utf8")).name;
         if (name === "@vosjs/cli") {
           const skills = join20(dir, "skills");
-          return existsSync17(skills) && statSync4(skills).isDirectory() ? skills : null;
+          return existsSync18(skills) && statSync5(skills).isDirectory() ? skills : null;
         }
       } catch {
       }
@@ -10396,7 +10339,7 @@ function bundledSkillsDir(from) {
 }
 
 // src/plugin/machineCmd.ts
-var BOOLEAN_FLAGS6 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS7 = /* @__PURE__ */ new Set([
   "json",
   "help",
   "global",
@@ -10414,7 +10357,7 @@ function npx() {
 function bundledChromium() {
   try {
     const p = chromium2.executablePath();
-    return p && existsSync18(p) ? p : null;
+    return p && existsSync19(p) ? p : null;
   } catch {
     return null;
   }
@@ -10423,7 +10366,7 @@ function probe() {
   return probeBrowser({
     platform: process.platform,
     env: process.env,
-    exists: existsSync18,
+    exists: existsSync19,
     bundled: bundledChromium
   });
 }
@@ -10474,7 +10417,7 @@ async function doctorFacts(opts) {
   };
 }
 async function cmdSetup(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   const r = reporterFor(flags);
   const root = process.cwd();
   const global = flags.global === true;
@@ -10489,7 +10432,7 @@ async function cmdSetup(argv) {
     if ("error" in v) throw new UsageError(v.error);
     homes = v.homes;
   } else {
-    homes = detectAgents(root, { home: homedir3(), global });
+    homes = detectAgents(root, { home: homedir2(), global });
   }
   const agents = [...new Set(homes.map((h) => h.agent))];
   r.event({ event: "agents", agents, global });
@@ -10525,7 +10468,7 @@ async function cmdSetup(argv) {
       const targets = homes.length ? homes : [fallbackSkillsHome(root)];
       for (const home of targets) {
         const dest = skillsDirFor(home);
-        mkdirSync3(dest, { recursive: true });
+        mkdirSync2(dest, { recursive: true });
         for (const name of installedSkills(bundled)) {
           cpSync(join21(bundled, name), join21(dest, name), { recursive: true });
         }
@@ -10562,9 +10505,9 @@ async function cmdSetup(argv) {
   let rules = null;
   if (!noRules) {
     const file = rulesFileFor(root);
-    const existing = existsSync18(file) ? readFileSync7(file, "utf8") : null;
+    const existing = existsSync19(file) ? readFileSync6(file, "utf8") : null;
     const { text, changed } = applyRulesBlock(existing);
-    if (changed) writeFileSync3(file, text);
+    if (changed) writeFileSync2(file, text);
     rules = { file, changed };
     r.log(
       changed ? `rules: wrote the vosso block into ${file}` : `rules: ${file} already carries the block`
@@ -10593,10 +10536,10 @@ Next: ${report.next_step}`
   return report.ok ? EXIT_OK : EXIT_NO_BROWSER;
 }
 async function cmdDoctor(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   const r = reporterFor(flags);
   const root = process.cwd();
-  const homes = detectAgents(root, { home: homedir3(), global: true });
+  const homes = detectAgents(root, { home: homedir2(), global: true });
   const report = doctorReport(
     await doctorFacts({
       homes: homes.length ? homes : [fallbackSkillsHome(root)],
@@ -10612,7 +10555,7 @@ Next: ${report.next_step}`
   return report.ok ? EXIT_OK : EXIT_NO_BROWSER;
 }
 async function cmdWhoami(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   const r = reporterFor(flags);
   const origin = platformOrigin({
     origin: strFlag(flags, "origin"),
@@ -10674,10 +10617,10 @@ async function cmdWhoami(argv) {
   return EXIT_OK;
 }
 function cmdLogout(argv) {
-  const { flags } = parseArgs(argv, BOOLEAN_FLAGS6);
+  const { flags } = parseArgs(argv, BOOLEAN_FLAGS7);
   const r = reporterFor(flags);
-  const had = existsSync18(CREDENTIALS_PATH);
-  rmSync2(CREDENTIALS_PATH, { force: true });
+  const had = existsSync19(CREDENTIALS_PATH);
+  rmSync3(CREDENTIALS_PATH, { force: true });
   const envKey = Boolean(process.env.VOS_API_KEY?.trim());
   r.done(
     {
@@ -10692,9 +10635,10 @@ function cmdLogout(argv) {
 }
 
 // src/plugin/run.ts
-var BOOLEAN_FLAGS7 = /* @__PURE__ */ new Set([
+var BOOLEAN_FLAGS8 = /* @__PURE__ */ new Set([
   "json",
   "help",
+  "wait",
   "picture",
   "fresh",
   "reuse",
@@ -10735,8 +10679,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 ingest <video.webm|mp4> [--cursor <trace.zip|steps.jsonl|cursor.csv>] [--as footage|take] [--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. Without a trace the file opens as FINISHED footage (a render from HyperFrames or Remotion, a film): no card, no browser bar, no drawn cursor, its own frame rate; --as take gives a screen demo the card
   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
@@ -10772,7 +10716,7 @@ Platform (vos.so) \u2014 fetch, edit, push, pull, repeat
   vos push  <config.json|take> [--vos id] [--title t] [--slug s] [--remix-of id]
             [--desc d] [--tags a,b] [--folder <folderId|slug>]
             [--note n] [--label l] [--base versionId] [--override <id>]... [--yes] [--json]
-            [--claimable]
+            [--claimable] [--wait]
             a take DIRECTORY (doc.json) pushes recording + doc; a config.json
             pushes the program. No --vos: create a PRIVATE vos; with --vos:
             add a version against the tracked base \u2014 a stale push 409s WITH
@@ -10784,6 +10728,14 @@ Platform (vos.so) \u2014 fetch, edit, push, pull, repeat
             user and nowhere else; unclaimed work is deleted after 72h.
             --override consents to touching
             protected (human-edited) nodes, ONLY when the user asked.
+            Without --folder a new vos lands unfiled, at the root of your
+            shelf. A document's local sound (doc.json audio keys) uploads
+            with the push. --wait stays until the version's still has
+            rendered and prints absolute still and preview links.
+  vos delete <vosId|watch-url|dir> [--yes] [--json]
+            take a vos off vos.so, every version of it, for good. Asks on a
+            terminal; headless it needs --yes. A dir that tracked it is
+            unlinked (its vos.json removed)
   vos pull  [dir|take] [--vos <id>] [--since versionId] [--check] [--media] [--json]
             what changed on vos.so since your base; syncs config.json (backup
             kept) or the take's doc.json. ALWAYS pull before editing pushed work.
@@ -10805,7 +10757,10 @@ Platform (vos.so) \u2014 fetch, edit, push, pull, repeat
   vos asset push <file...> [--folder <folderId|slug>]
             upload files onto your shelf (a key takes models .glb/.gltf,
             recipes .md and images .png/.jpg/.webp/.gif \u2014 posters and
-            store stills file into the release's project; 40 images/24h)
+            store stills file into the release's project; 40 images/24h \u2014
+            and sound and video, which land in Sound > Uploads and print
+            the url a doc.json audio key takes; an unfiled one that no
+            document uses is removed after 7 days, so pass --folder)
   vos recipe push <file.md> --folder <folderId|slug>
   vos recipe push <file.md> --asset <assetId>
             put a recipe (a plain .md) on the shelf: --folder creates it
@@ -10994,7 +10949,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 readFile16(file, "utf8"));
+  const raw = JSON.parse(await readFile17(file, "utf8"));
   const errors = validateActions(raw);
   if (errors.length)
     throw new UsageError(`invalid actions file:
@@ -11057,7 +11012,7 @@ function takeStorageState(flags) {
   const raw = strFlag(flags, "storage-state");
   if (!raw) return void 0;
   const path = resolve10(raw);
-  if (!existsSync19(path))
+  if (!existsSync20(path))
     throw new UsageError(`--storage-state: no such file: ${path}`);
   return path;
 }
@@ -11070,7 +11025,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 (!existsSync19(sessionDir(name)))
+  if (!existsSync20(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)`
     );
@@ -11126,7 +11081,7 @@ function wallGate(flags, r, opts) {
 async function cmdRecord(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS7,
+    BOOLEAN_FLAGS8,
     MULTI_FLAGS2
   );
   const actionsPath = strFlag(flags, "actions") ?? positionals[0];
@@ -11293,7 +11248,7 @@ ${lines.join("\n")}
   }
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync19(join22(outDir, "meta.json"))) {
+    if (existsSync20(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" : "")
@@ -11368,7 +11323,7 @@ ${lines.join("\n")}
 async function cmdCreate2(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS7,
+    BOOLEAN_FLAGS8,
     MULTI_FLAGS2
   );
   const actionsPath = strFlag(flags, "actions");
@@ -11383,10 +11338,7 @@ async function cmdCreate2(argv) {
   if (!url)
     throw new UsageError('no URL \u2014 set "url" in the actions file or pass --url');
   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 format = videoFormat(strFlag(flags, "format"), positionals[0]);
   const out = positionals[0] ?? join22(outDir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
@@ -11400,7 +11352,7 @@ async function cmdCreate2(argv) {
   const headers = takeHeaders(multi);
   const paths = takePaths(outDir);
   const prepare = async () => {
-    if (existsSync19(join22(outDir, "meta.json"))) {
+    if (existsSync20(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" : "")
@@ -11497,7 +11449,7 @@ async function cmdCreate2(argv) {
 async function cmdPlan(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS7,
+    BOOLEAN_FLAGS8,
     /* @__PURE__ */ new Set(["with"])
   );
   const dir = positionals[0];
@@ -11513,18 +11465,18 @@ async function cmdPlan(argv) {
   let reuse;
   if (flags.reuse === true) {
     const from = resolve10(strFlag(flags, "from") ?? join22(dir, PREV_DOC_NAME));
-    if (!existsSync19(from)) {
+    if (!existsSync20(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 readFile16(from, "utf8"))
+      doc: JSON.parse(await readFile17(from, "utf8"))
     };
   }
   const style = await resolveStyleRef(flags);
-  const hasDoc = existsSync19(join22(dir, "doc.json"));
+  const hasDoc = existsSync20(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;
@@ -11695,7 +11647,7 @@ async function releaseInputs(dir, flags, r, withRefs = []) {
 async function cmdRender(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS7,
+    BOOLEAN_FLAGS8,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -11704,10 +11656,7 @@ async function cmdRender(argv) {
       "vos render <take> [out] [--width] [--height] [--fps] [--format] [--parallel]"
     );
   const r = createReporter(flags.json === true);
-  const fmtRaw = strFlag(flags, "format") ?? "webm";
-  if (fmtRaw !== "webm" && fmtRaw !== "mp4")
-    throw new UsageError("--format must be webm or mp4");
-  const format = fmtRaw;
+  const format = videoFormat(strFlag(flags, "format"), positionals[1]);
   const out = positionals[1] ?? join22(dir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
   if (!Number.isInteger(parallel) || parallel < 1 || parallel > 16) {
@@ -11766,7 +11715,7 @@ async function cmdRender(argv) {
 async function cmdFrames(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS7,
+    BOOLEAN_FLAGS8,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -11839,7 +11788,7 @@ async function cmdFrames(argv) {
 async function cmdDeliver(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS7,
+    BOOLEAN_FLAGS8,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -11955,15 +11904,15 @@ async function resolveStyleRef(flags) {
 }
 async function resolveDocRef(ref, flags, what) {
   const styleRef = ref;
-  const file = existsSync19(styleRef) ? resolve10(
+  const file = existsSync20(styleRef) ? resolve10(
     styleRef,
-    existsSync19(join22(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync20(join22(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync19(file)) {
+  if (file && existsSync20(file)) {
     return {
       from: file,
       doc: migrateHostedDoc5(
-        JSON.parse(await readFile16(file, "utf8"))
+        JSON.parse(await readFile17(file, "utf8"))
       )
     };
   }
@@ -12005,7 +11954,7 @@ async function officialTemplate(origin, ref) {
   }
 }
 async function cmdDigest(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   const dir = positionals[0];
   if (!dir)
     throw new UsageError(
@@ -12015,7 +11964,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 readFile16(transcriptPath, "utf8"))) : null;
+  const transcript = transcriptPath ? parseTranscript(JSON.parse(await readFile17(transcriptPath, "utf8"))) : null;
   const style = await resolveStyleRef(flags);
   const noFrames = flags["no-frames"] === true;
   let browser = null;
@@ -12069,12 +12018,12 @@ async function cmdDigest(argv) {
   }
 }
 async function cmdOpen(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   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 (!existsSync19(take.paths.recording)) {
+  if (!existsSync20(take.paths.recording)) {
     throw new UsageError(`${dir} has no recording \u2014 re-run record`);
   }
   const studio = (strFlag(flags, "studio") ?? platformOrigin()).replace(
@@ -12107,7 +12056,7 @@ async function cmdOpen(argv) {
   return EXIT_OK;
 }
 async function cmdJudge(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   const target = positionals[0];
   const against = strFlag(flags, "against");
   if (!target || !against)
@@ -12116,11 +12065,11 @@ async function cmdJudge(argv) {
     );
   const r = createReporter(flags.json === true);
   const kitFile = target.endsWith("kit.json") ? target : join22(target, "kit.json");
-  if (!existsSync19(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
-  if (!existsSync19(against))
+  if (!existsSync20(kitFile)) throw new UsageError(`${kitFile}: no kit manifest`);
+  if (!existsSync20(against))
     throw new UsageError(`${against}: no reference manifest`);
   const result = await judgeKit(kitFile, against, strFlag(flags, "out"));
-  const verdicts = JSON.parse(await readFile16(result.verdictFile, "utf8")).verdicts;
+  const verdicts = JSON.parse(await readFile17(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}`
@@ -12136,7 +12085,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_FLAGS7);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   const dir = positionals[0];
   const shape = positionals[1];
   if (!dir || !shape || !isCalloutShape(shape))
@@ -12160,7 +12109,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 readFile16(codeFile, "utf8") : strFlag(flags, "code");
+  const code = codeFile ? await readFile17(codeFile, "utf8") : strFlag(flags, "code");
   const words = {
     kicker: strFlag(flags, "kicker"),
     title: strFlag(flags, "title"),
@@ -12235,11 +12184,11 @@ async function cmdCallout(argv) {
   return EXIT_OK;
 }
 async function cmdValidate(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   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 : existsSync19(join22(target, "kit.json")) && !isTakeDir(target) ? join22(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync20(join22(target, "kit.json")) && !isTakeDir(target) ? join22(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -12271,9 +12220,9 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync19(join22(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync20(join22(target, "config.json"))) {
     const parsed = JSON.parse(
-      await readFile16(join22(target, "config.json"), "utf8")
+      await readFile17(join22(target, "config.json"), "utf8")
     );
     const pre = preflightConfig(parsed);
     const problems2 = pre.ok ? [] : pre.issues.map((i) => `config.json: ${i}`);
@@ -12314,7 +12263,7 @@ async function cmdValidate(argv) {
   const take = await loadTake(target);
   const problems = [];
   const warnings = [];
-  if (!existsSync19(take.paths.recording)) {
+  if (!existsSync20(take.paths.recording)) {
     problems.push("missing recording (re-run record)");
   } else {
     const mismatch = containerMismatch(
@@ -12397,7 +12346,7 @@ async function cmdValidate(argv) {
 async function cmdPush3(argv) {
   const { positionals, flags, multi } = parseArgs(
     argv,
-    BOOLEAN_FLAGS7,
+    BOOLEAN_FLAGS8,
     MULTI_FLAGS2
   );
   const dir = positionals[0];
@@ -12435,16 +12384,33 @@ async function cmdPush3(argv) {
     origin: strFlag(flags, "origin"),
     api: strFlag(flags, "api")
   }).replace(/\/+$/, "");
+  const landed = flags.wait === true ? await waitForLanded({
+    origin: pushedTo,
+    key: requireCredential(strFlag(flags, "key")),
+    vosId: result.vosId,
+    versionId: result.versionId ?? null,
+    log: (l) => r.log(l)
+  }) : null;
+  const filed = result.versionNumber === 1 ? `
+  shelf:  ${strFlag(flags, "folder") ? `in ${strFlag(flags, "folder")}` : `unfiled, at the root of your shelf (file it: vos folder move ${result.vosId} --to <slug>)`}` : "";
   r.done(
-    { ...result },
+    {
+      ...result,
+      ...landed ? {
+        still: landed.still,
+        thumbnailUrl: landed.thumbnailUrl,
+        previewUrl: landed.previewUrl
+      } : {}
+    },
     `pushed v${result.versionNumber} \u2192 vos ${result.vosId}
   review: ${pushedTo}/vos/${result.vosId}
-  studio: ${pushedTo}/studio?vos=${result.vosId}`
+  studio: ${pushedTo}/studio?vos=${result.vosId}` + filed + (landed ? `
+${landedLines(landed)}` : "")
   );
   return EXIT_OK;
 }
 async function cmdPull2(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7, MULTI_FLAGS2);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS8, MULTI_FLAGS2);
   const dir = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
   const result = await pullTake(
@@ -12555,6 +12521,8 @@ async function run(argv) {
         const target = rest.find((a) => !a.startsWith("-")) ?? ".";
         return isTakeDir(target) ? await cmdPull2(rest) : await cmdPullProgram(rest);
       }
+      case "delete":
+        return await cmdDelete(rest);
       case "folder":
         return await cmdFolder(rest);
       case "asset":
@@ -12601,7 +12569,7 @@ async function run(argv) {
   }
 }
 async function cmdSession(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS7);
+  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   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>";
@@ -12637,7 +12605,7 @@ async function cmdSession(argv) {
       if (!arg) throw new UsageError(usage);
       const bad = sessionNameVerdict(arg);
       if (bad) throw new UsageError(bad);
-      if (!existsSync19(sessionDir(arg)))
+      if (!existsSync20(sessionDir(arg)))
         throw new UsageError(`no session "${arg}" (vos session list)`);
       const summary2 = await summarizeSession(arg);
       const url = strFlag(flags, "url");
@@ -12728,13 +12696,6 @@ export {
   digestTake,
   parseTranscript,
   renderTake,
-  platformOrigin,
-  parseVosId,
-  resolveCredential,
-  apiJson,
-  apiError,
-  readSyncState,
-  writeSyncState,
   recordTake,
   encodeRecording,
   planTake,
@@ -12748,4 +12709,4 @@ export {
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-D6AP7Y3G.js.map
+//# sourceMappingURL=chunk-F2QCWV4U.js.map