@vosjs/cli 0.80.0 → 0.81.0

package/dist/{chunk-SP5OHTVB.js → chunk-S3RI2SHH.js}

@@ -28,6 +28,7 @@ import {
   isTakeRelativeKey,
   loadTake,
   localManifestRefs,
+  notePlannedDoc,
   prepareReRecord,
   pullManifest,
   pullMedia,
@@ -45,7 +46,7 @@ import {
   uploadDocRefs,
   uploadManifest,
   writeJson
-} from "./chunk-PJ6MEJZV.js";
+} from "./chunk-352AC3V6.js";
 import {
   CREDENTIALS_PATH,
   MEDIA_HEAD_BYTES,
@@ -145,8 +146,8 @@ function landedLines(l) {
 
 // src/plugin/run.ts
 import { mkdir as mkdir13, readFile as readFile18, rm as rm6 } from "fs/promises";
-import { existsSync as existsSync29 } from "fs";
-import { dirname as dirname11, join as join33, resolve as resolve20 } from "path";
+import { existsSync as existsSync30 } from "fs";
+import { dirname as dirname11, join as join33, resolve as resolve21 } from "path";
 import {
   END_CARD_FROM as END_CARD_FROM2,
   docOutputDuration as docOutputDuration5,
@@ -662,6 +663,56 @@ function lintDoc(docIn) {
           );
       }
     }
+    const cursorStyle = isObj(doc.cursor) ? doc.cursor : {};
+    if (recording && cursorStyle.off !== void 0) {
+      const off2 = cursorStyle.off;
+      if (!Array.isArray(off2)) {
+        problems.push(
+          "cursor.off must be an array of { in, out?, from? } ranges (OUTPUT seconds)"
+        );
+      } else {
+        let end = null;
+        const filmEnd = () => {
+          if (end === null) {
+            const rated = ratedSegments(doc);
+            end = outputEnd(
+              resolveOverlayAnchors(doc, rated),
+              rated.reduce((a, s) => a + (s.out - s.in) / (s.rate ?? 1), 0)
+            );
+          }
+          return end;
+        };
+        for (const [i, raw] of off2.entries()) {
+          const name = `cursor.off[${i}]`;
+          if (!isObj(raw)) {
+            problems.push(
+              `${name} must be an object { in, out?, from? } (OUTPUT seconds)`
+            );
+            continue;
+          }
+          for (const k of Object.keys(raw))
+            if (k !== "in" && k !== "out" && k !== "from")
+              problems.push(`${name}.${k}: not a range field (in, out, from)`);
+          lintFrom(name, raw.from, problems);
+          if (!isNum(raw.in) || raw.in < 0) {
+            problems.push(
+              `${name}.in=${String(raw.in)} must be a number \u2265 0 (OUTPUT seconds)`
+            );
+            continue;
+          }
+          if (raw.out !== void 0 && (!isNum(raw.out) || raw.out <= raw.in)) {
+            problems.push(
+              `${name}.out=${String(raw.out)} must be a number past in (${raw.in}s); leave it out to hide the cursor to the end of the film`
+            );
+            continue;
+          }
+          if (raw.in > filmEnd() + 1e-6)
+            warnings.push(
+              `${name} starts at ${raw.in}s, past the film's end (${filmEnd().toFixed(2)}s): it hides nothing`
+            );
+        }
+      }
+    }
     for (const [i, seg] of (Array.isArray(doc.segments) ? doc.segments : []).entries()) {
       const hold = seg.hold;
       if (hold === void 0) continue;
@@ -4103,6 +4154,36 @@ import {
   spanOutputExtent as spanOutputExtent3
 } from "@vosjs/studio-core";
 
+// src/plugin/captionFit.ts
+var CAPTION_MAX = 3;
+var CAPTION_MIN = 1.2;
+var CAPTION_GAP = 0.1;
+function fitCaptions(items, slotOf, opts = {}) {
+  const max = opts.max ?? CAPTION_MAX;
+  const min = opts.min ?? CAPTION_MIN;
+  const gap = opts.gap ?? CAPTION_GAP;
+  const ordered = items.map((item) => ({ item, slot: slotOf(item) })).sort((a, b) => a.slot.start - b.slot.start);
+  const kept = [];
+  const dropped = [];
+  let nextStart = Infinity;
+  for (let i = ordered.length - 1; i >= 0; i--) {
+    const { item, slot } = ordered[i];
+    const clipRoom = slot.end - slot.start;
+    const nextRoom = nextStart - gap - slot.start;
+    const duration = Math.min(max, clipRoom, nextRoom);
+    if (duration < min - 1e-9) {
+      dropped.unshift({
+        item,
+        why: nextRoom < clipRoom ? `the next caption starts ${(nextStart - slot.start).toFixed(2)}s after it, too soon to read it (more time on its step, its ms, gives it room)` : `it plays in the last ${Math.max(0, clipRoom).toFixed(2)}s of its clip, too short to read it (a wait after its step gives it room)`
+      });
+      continue;
+    }
+    kept.unshift({ item, duration: +duration.toFixed(3) });
+    nextStart = slot.start;
+  }
+  return { kept, dropped };
+}
+
 // src/plugin/moments.ts
 import {
   hasReplay,
@@ -4131,6 +4212,7 @@ var LOOP_DESTINATIONS = /* @__PURE__ */ new Set(["github-readme-loop"]);
 var BED_ID = "bed";
 var CLICK_ID_PREFIX = "click-";
 var CAPTION_ID_PREFIX = "caption-";
+var CAPTION_BEAT_MAX = 3.5;
 function houseCaption(id, text, start, duration) {
   return {
     id,
@@ -4215,6 +4297,19 @@ var outputLength = (doc) => ratedSegments4(doc).reduce((acc, s) => {
   const rate = s.rate && s.rate > 0 ? s.rate : 1;
   return acc + (s.out - s.in) / rate;
 }, 0);
+function withEndCardCursorOff(doc, start) {
+  const own = (doc.cursor.off ?? []).filter((r) => r.from !== END_CARD_FROM);
+  return {
+    ...doc,
+    cursor: {
+      ...doc.cursor,
+      off: [
+        ...own,
+        { in: +Math.max(0, start).toFixed(3), from: END_CARD_FROM }
+      ]
+    }
+  };
+}
 function templateWords(words2) {
   const headline = (words2.headline ?? "").trim();
   const kicker = (words2.kicker ?? "").trim();
@@ -4283,6 +4378,7 @@ function proposeMotion(input, opts) {
       skipped.push(`${t.from}: ${anchorWord(t.at)} was not recorded`);
       continue;
     }
+    const before = outputLength(doc);
     const applied = applyTemplate(t.doc, doc, {
       at: at2,
       from: t.from,
@@ -4290,6 +4386,10 @@ function proposeMotion(input, opts) {
       keys
     });
     doc = applied.doc;
+    if (t.from === END_CARD_FROM) {
+      const starts = (doc.overlays ?? []).filter((o) => o.from === END_CARD_FROM && o.start !== void 0).map((o) => o.start);
+      doc = withEndCardCursorOff(doc, Math.min(before, ...starts));
+    }
     notes.push(`${t.from} at ${anchorWord(t.at)}`);
     for (const n of applied.notes) skipped.push(`${t.from}: ${n}`);
   }
@@ -4338,6 +4438,7 @@ function proposeMotion(input, opts) {
         ...doc.frame.anim ?? {},
         exit: { kind: "recede", seconds: END_CARD_SECONDS }
       };
+      doc = withEndCardCursorOff(doc, endStart);
       notes.push("end card");
     } else {
       skipped.push(
@@ -4352,22 +4453,30 @@ function proposeMotion(input, opts) {
   if (opts.captions.length && !off(launch.captions)) {
     const rated = ratedSegments4(doc);
     const steps = doc.source.meta.steps ?? [];
+    const beats = [];
     for (const c of opts.captions) {
       const step = steps.find(
         (s) => c.id !== void 0 && s.id === c.id || s.step === c.step
       );
       if (!step || step.skipped) continue;
       const t = stepOutputTime(rated, step, 0.2);
-      if (t === null || t < 0 || t > footage - 1) continue;
+      if (t === null || t < 0 || t >= footage) continue;
+      beats.push({ caption: c, t: +t.toFixed(3) });
+    }
+    const fit = fitCaptions(beats, (b) => ({ start: b.t, end: footage }), {
+      max: CAPTION_BEAT_MAX
+    });
+    for (const { item, why } of fit.dropped)
+      skipped.push(`caption for step ${item.caption.step}: ${why}`);
+    for (const { item, duration } of fit.kept)
       captionClips.push(
         houseCaption(
-          `${CAPTION_ID_PREFIX}${c.step}`,
-          c.caption,
-          +t.toFixed(3),
-          Math.min(3.5, Math.max(2.5, footage - t - 0.2))
+          `${CAPTION_ID_PREFIX}${item.caption.step}`,
+          item.caption.caption,
+          item.t,
+          duration
         )
       );
-    }
     if (captionClips.length) notes.push(`${captionClips.length} caption(s)`);
   }
   const overlays = [...kept, ...captionClips];
@@ -4452,6 +4561,10 @@ function destinationMechanics(d, doc) {
     const keptFreezes = (doc.freeze ?? []).filter((f) => !f.from);
     if (keptFreezes.length !== (doc.freeze ?? []).length)
       set.push(`freeze=${JSON.stringify(keptFreezes)}`);
+    const off2 = doc.cursor?.off ?? [];
+    const keptOff = off2.filter((r) => !r.from);
+    if (keptOff.length !== off2.length)
+      set.push(`cursor.off=${JSON.stringify(keptOff)}`);
   }
   if (portrait) {
     set.push("frame.fit=cover");
@@ -5879,14 +5992,14 @@ function chromeTree(rows, pid) {
 }
 function readChromeTree(pid) {
   if (process.platform === "win32") return Promise.resolve(null);
-  return new Promise((resolve21) => {
+  return new Promise((resolve22) => {
     execFile2(
       "ps",
       ["-A", "-o", "pid=", "-o", "ppid=", "-o", "command="],
       { maxBuffer: 16 * 1024 * 1024, timeout: 5e3 },
       (err, stdout) => {
-        if (err) resolve21(null);
-        else resolve21(chromeTree(parseProcessTable(stdout), pid));
+        if (err) resolve22(null);
+        else resolve22(chromeTree(parseProcessTable(stdout), pid));
       }
     );
   });
@@ -5988,7 +6101,7 @@ function enterPressed() {
     } };
   const rl = createInterface({ input: process.stdin });
   const pressed = new Promise(
-    (resolve21) => rl.once("line", () => resolve21())
+    (resolve22) => rl.once("line", () => resolve22())
   );
   return { pressed, close: () => rl.close() };
 }
@@ -6161,14 +6274,14 @@ async function openSessionWindow(opts) {
   const child = spawn(exe, args, { stdio: "ignore" });
   let failed = null;
   let code = null;
-  const exited = new Promise((resolve21) => {
+  const exited = new Promise((resolve22) => {
     child.once("exit", (c) => {
       code = c;
-      resolve21();
+      resolve22();
     });
     child.once("error", (e) => {
       failed = e;
-      resolve21();
+      resolve22();
     });
   });
   try {
@@ -6507,13 +6620,58 @@ import {
 import {
   SetupEnvError,
   SetupError,
+  TEARDOWN_BOUND_MS,
   parseHeaders,
   resolveSetupText,
   runSetup,
+  scriptEnvNames,
   setupEnvNames,
+  teardownEnvProblem,
+  teardownLine,
   validateSetup
 } from "@vosjs/render-core/record";
 
+// src/plugin/sessionExec.ts
+import { existsSync as existsSync10 } from "fs";
+import { resolve as resolve7 } from "path";
+import { pathToFileURL } from "url";
+var ExecScriptError = class extends Error {
+};
+async function loadExecScript(path) {
+  const file = resolve7(path);
+  if (!existsSync10(file)) throw new ExecScriptError(`no script at ${file}`);
+  if (!/\.(m?js|cjs)$/.test(file))
+    throw new ExecScriptError(
+      `${path}: a script is a .mjs or .js module (compile TypeScript first)`
+    );
+  const mod = await import(pathToFileURL(file).href);
+  if (typeof mod.default !== "function")
+    throw new ExecScriptError(
+      `${path} has no default export function: export default async ({ context, page, url }) => { \u2026 }`
+    );
+  return mod.default;
+}
+async function execInProfile(dir, script, opts) {
+  return withProfile(
+    dir,
+    async (context2) => {
+      const page = context2.pages()[0] ?? await context2.newPage();
+      if (opts.url)
+        await page.goto(opts.url, { waitUntil: "load", timeout: 3e4 });
+      return await script({
+        context: context2,
+        page,
+        name: opts.name,
+        ...opts.url ? { url: opts.url } : {}
+      });
+    },
+    {
+      headless: opts.headless ?? true,
+      ...opts.viewport ? { viewport: opts.viewport } : {}
+    }
+  );
+}
+
 // src/plugin/recordingCap.ts
 import {
   capReached,
@@ -6569,7 +6727,7 @@ async function encodeRecording(browser, takeDir, onProgress) {
 }
 
 // src/plugin/plan.ts
-import { existsSync as existsSync10 } from "fs";
+import { existsSync as existsSync11 } from "fs";
 import { readFile as readFile9 } from "fs/promises";
 import { join as join11 } from "path";
 import {
@@ -6862,9 +7020,21 @@ function outputToSource(pieces, t) {
   }
   return pieces.at(-1)?.out ?? t;
 }
+function footageOutputEnd(doc) {
+  const own = {
+    ...doc,
+    freeze: (doc.freeze ?? []).filter((f) => !f.from)
+  };
+  return ratedSegments6(own).reduce((acc, s) => {
+    const rate = s.rate && s.rate > 0 ? s.rate : 1;
+    return acc + (s.out - s.in) / rate;
+  }, 0);
+}
 function retimeOverlays(prev, next, report) {
   const overlays = prev.overlays ?? [];
   if (!overlays.length) return [];
+  const oldEnd = footageOutputEnd(prev);
+  const endShift = footageOutputEnd(next) - oldEnd;
   const oldSteps = prev.source.meta.steps ?? [];
   const newSteps = next.source.meta.steps ?? [];
   const oldPieces = ratedSegments6(prev);
@@ -6916,6 +7086,10 @@ function retimeOverlays(prev, next, report) {
       const moved = follow(o, at2, pin.press, placed.at);
       return { ...moved, pin: { ...pin, press: +placed.at.toFixed(3) } };
     }
+    if (at2 >= oldEnd - 1e-6) {
+      if (Math.abs(endShift) < 1e-6) return o;
+      return { ...o, start: +Math.max(0, at2 + endShift).toFixed(3) };
+    }
     const under = stepUnder(
       outputToSource(oldPieces, at2),
       oldSteps,
@@ -6943,7 +7117,7 @@ function retimeOverlays(prev, next, report) {
 var overlaps = (a, b) => a.in < b.out && b.in < a.out;
 async function readDigestActivity(dir) {
   const file = join11(dir, "digest", "digest.json");
-  if (!existsSync10(file)) return null;
+  if (!existsSync11(file)) return null;
   try {
     const d = JSON.parse(await readFile9(file, "utf8"));
     return Array.isArray(d.activity) && d.activity.every((v) => typeof v === "number") ? d.activity : null;
@@ -7064,6 +7238,20 @@ async function planTake(dir, opts = {}) {
     withPageSound(doc, meta.media);
     if (prev.still !== void 0) doc.still = prev.still;
     if (opts.still != null) doc.still = opts.still;
+    if (prev.cursor?.off?.length) {
+      const oldEnd = footageOutputEnd(prev);
+      const shift = footageOutputEnd(doc) - oldEnd;
+      doc.cursor = {
+        ...doc.cursor,
+        off: prev.cursor.off.map(
+          (r) => r.in >= oldEnd - 1e-6 && Math.abs(shift) > 1e-6 ? {
+            ...r,
+            in: +Math.max(0, r.in + shift).toFixed(3),
+            ...r.out !== void 0 ? { out: +Math.max(0, r.out + shift).toFixed(3) } : {}
+          } : { ...r }
+        )
+      };
+    }
     await writeJson(take.paths.doc, doc, true);
     return {
       doc,
@@ -7173,14 +7361,14 @@ async function planTake(dir, opts = {}) {
 
 // src/plugin/sync.ts
 import { createHash } from "crypto";
-import { existsSync as existsSync12, readFileSync as readFileSync3, readdirSync as readdirSync2 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync3, readdirSync as readdirSync2 } from "fs";
 import { readFile as readFile11 } from "fs/promises";
 import { createInterface as createInterface2 } from "readline/promises";
 import { basename as basename2, join as join14 } from "path";
 import { lowerToComposition as lowerToComposition3, migrateHostedDoc as migrateHostedDoc2 } from "@vosjs/studio-core";
 
 // src/plugin/takeScript.ts
-import { existsSync as existsSync11 } from "fs";
+import { existsSync as existsSync12 } from "fs";
 import { readFile as readFile10, writeFile as writeFile7 } from "fs/promises";
 import { readFileSync as readFileSync2 } from "fs";
 import { basename, join as join12 } from "path";
@@ -7201,26 +7389,27 @@ function scriptToWrite(doc, hasLocal) {
 function publicScript(script) {
   const peers = publicPeers(script.peers);
   if (peers) script = { ...script, peers };
-  const setup = script.setup;
-  if (!Array.isArray(setup)) return script;
-  return {
-    ...script,
-    setup: setup.map((step) => {
-      if (!step || typeof step !== "object") return step;
-      const s = step;
-      if (s.do === "type" && typeof s.text === "string")
-        return { ...s, text: "[typed value not stored]" };
-      if (s.do === "goto" && typeof s.url === "string") {
-        try {
-          const u = new URL(s.url);
-          return { ...s, url: `${u.origin}${u.pathname}` };
-        } catch {
-          return s;
-        }
-      }
+  for (const key of ["setup", "teardown"]) {
+    const steps = script[key];
+    if (Array.isArray(steps))
+      script = { ...script, [key]: steps.map(publicStep) };
+  }
+  return script;
+}
+function publicStep(step) {
+  if (!step || typeof step !== "object") return step;
+  const s = step;
+  if (s.do === "type" && typeof s.text === "string")
+    return { ...s, text: "[typed value not stored]" };
+  if (s.do === "goto" && typeof s.url === "string") {
+    try {
+      const u = new URL(s.url);
+      return { ...s, url: `${u.origin}${u.pathname}` };
+    } catch {
       return s;
-    })
-  };
+    }
+  }
+  return s;
 }
 function publicPeers(peers) {
   if (!Array.isArray(peers)) return null;
@@ -7233,20 +7422,20 @@ function publicPeers(peers) {
 }
 function embedScript(doc, dir) {
   const path = join12(dir, "actions.json");
-  if (!existsSync11(path)) return;
+  if (!existsSync12(path)) return;
   const script = scriptFromText(readFileSync2(path, "utf8"));
   if (script) doc.source.script = publicScript(script);
 }
 async function writeScriptBeside(dir, doc) {
   const path = join12(dir, "actions.json");
-  const text = scriptToWrite(doc, existsSync11(path));
+  const text = scriptToWrite(doc, existsSync12(path));
   if (text === null) return false;
   await writeFile7(path, text, "utf8");
   return true;
 }
 async function readScript(dir) {
   const path = join12(dir, "actions.json");
-  if (!existsSync11(path)) return null;
+  if (!existsSync12(path)) return null;
   return scriptFromText(await readFile10(path, "utf8"));
 }
 
@@ -7737,7 +7926,7 @@ async function pushTake(dir, flags, r) {
     throw new Error(`doc.json fails lint:
   ${lint.problems.join("\n  ")}`);
   }
-  if (!existsSync12(take.paths.recording)) {
+  if (!existsSync13(take.paths.recording)) {
     throw new Error(
       "no recording in this take \u2014 record it, or `vos pull --media` to bring it home"
     );
@@ -7972,7 +8161,7 @@ async function pullTake(dir, flags, r) {
       };
     }
     let media2;
-    if (flags.media && existsSync12(join14(dir, "doc.json"))) {
+    if (flags.media && existsSync13(join14(dir, "doc.json"))) {
       const local = JSON.parse(
         await readFile11(join14(dir, "doc.json"), "utf8")
       );
@@ -8035,7 +8224,7 @@ async function pullTake(dir, flags, r) {
   const hostedDoc = migrateHostedDoc2(docRes.json);
   const doc = hostedDoc;
   const localRecording = takeMediaFile(dir, "recording", RECORDING_NAME);
-  if (existsSync12(localRecording)) {
+  if (existsSync13(localRecording)) {
     doc.source.videoKey = basename2(localRecording);
   }
   await writeJson(join14(dir, "doc.json"), doc, true);
@@ -8111,7 +8300,7 @@ async function pushTakeClaimable(dir, flags, r) {
       );
     }
     const path = join14(dir, file);
-    const now = existsSync12(path) ? await fileSha256(path) : null;
+    const now = existsSync13(path) ? await fileSha256(path) : null;
     if (now !== origin2.sha256) {
       throw new PushRefusedError(
         `${ref.where} (${file}) changed since it was fetched, so it is no longer the hosted file. A claimable push names only the original; push with an account to upload the new one`
@@ -8160,7 +8349,7 @@ async function pushTakeClaimable(dir, flags, r) {
 }
 
 // src/plugin/program.ts
-import { existsSync as existsSync14 } from "fs";
+import { existsSync as existsSync15 } from "fs";
 import { mkdir as mkdir7, readFile as readFile12 } from "fs/promises";
 import { createInterface as createInterface3 } from "readline/promises";
 import { basename as basename4, dirname as dirname2, join as join15 } from "path";
@@ -8173,12 +8362,12 @@ import { lowerProgramDoc, migrateHostedDoc as migrateHostedDoc3 } from "@vosjs/s
 
 // src/plugin/programFiles.ts
 import { basename as basename3, extname as extname2, relative as relative2 } from "path";
-import { existsSync as existsSync13, realpathSync as realpathSync2 } from "fs";
+import { existsSync as existsSync14, realpathSync as realpathSync2 } from "fs";
 function isLocalName(value) {
   if (/^(https?:|data:|blob:|asset:|media:)/.test(value)) return false;
   if (value.startsWith("$")) return false;
   if (value.startsWith("<svg") || value.startsWith("<?xml")) return false;
-  if (value.startsWith("/")) return existsSync13(value);
+  if (value.startsWith("/")) return existsSync14(value);
   return true;
 }
 var FILE_EXT = /\.(png|jpe?g|webp|gif|avif|svg|mp4|webm|mov|mp3|m4a|ogg|wav|flac|aac|glb|gltf|woff2?|ttf|otf|hdr|exr)$/i;
@@ -8354,7 +8543,7 @@ function preflightConfig(parsed) {
 function resolveConfigPath(target) {
   if (target.endsWith(".json")) return target;
   const inDir = join15(target, "config.json");
-  if (existsSync14(inDir)) return inDir;
+  if (existsSync15(inDir)) return inDir;
   throw new UsageError(
     `${target} has no config.json (and is not a take \u2014 no doc.json)`
   );
@@ -8912,7 +9101,7 @@ async function cmdPullProgram(argv) {
     throw new Error(apiError(`fetch head config for ${vosId}`, cfg));
   const configPath = join15(dir, "config.json");
   let backedUp = false;
-  if (existsSync14(configPath)) {
+  if (existsSync15(configPath)) {
     await writeFileSafe(
       join15(dir, "config.backup.json"),
       await readFile12(configPath)
@@ -9058,7 +9247,7 @@ function storedProgramConfig(config, programDoc) {
 }
 async function readProgramDoc(dir, config) {
   const docPath = join15(dir, "doc.json");
-  if (!existsSync14(docPath)) return null;
+  if (!existsSync15(docPath)) return null;
   const parsed = JSON.parse(await readFile12(docPath, "utf8"));
   if (typeof parsed !== "object" || parsed === null || "source" in parsed)
     return null;
@@ -9069,7 +9258,7 @@ async function readProgramDoc(dir, config) {
 async function setProgramStill(dir, t) {
   const docPath = join15(dir, "doc.json");
   let doc = { program: {}, audio: [] };
-  if (existsSync14(docPath)) {
+  if (existsSync15(docPath)) {
     const parsed = JSON.parse(await readFile12(docPath, "utf8"));
     if (!parsed || typeof parsed !== "object" || "source" in parsed)
       throw new UsageError(
@@ -9624,7 +9813,7 @@ async function cmdAsset(argv) {
 }
 
 // src/plugin/remove.ts
-import { existsSync as existsSync15, rmSync as rmSync2, statSync as statSync3 } from "fs";
+import { existsSync as existsSync16, rmSync as rmSync2, statSync as statSync3 } from "fs";
 import { join as join16 } from "path";
 import { createInterface as createInterface4 } from "readline/promises";
 
@@ -9804,7 +9993,7 @@ async function cmdDelete(argv) {
     api: strFlag(flags, "api")
   }).replace(/\/+$/, "");
   const key = requireCredential(strFlag(flags, "key"));
-  const dir = existsSync15(target) && statSync3(target).isDirectory() ? target : null;
+  const dir = existsSync16(target) && statSync3(target).isDirectory() ? target : null;
   const vosId = dir ? readSyncState(dir)?.vosId : parseVosId(target);
   if (!vosId)
     throw new UsageError(
@@ -9872,14 +10061,14 @@ async function cmdDelete(argv) {
 }
 function trackingCwd(vosId) {
   const cwd = process.cwd();
-  if (!existsSync15(join16(cwd, SYNC_STATE_NAME))) return null;
+  if (!existsSync16(join16(cwd, SYNC_STATE_NAME))) return null;
   return readSyncState(cwd)?.vosId === vosId ? cwd : null;
 }
 
 // src/plugin/buildProgram.ts
 import { readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "fs";
-import { basename as basename6, dirname as dirname3, join as join17, resolve as resolve7 } from "path";
-import { pathToFileURL } from "url";
+import { basename as basename6, dirname as dirname3, join as join17, resolve as resolve8 } from "path";
+import { pathToFileURL as pathToFileURL2 } from "url";
 import { parse } from "acorn";
 import { fullAncestor } from "acorn-walk";
 var FUNCTION_KEYS = [
@@ -10078,9 +10267,9 @@ async function cmdBuild(argv) {
   if (!source)
     throw new UsageError("vos build <program.mjs> [--out config.json] [--json]");
   const r = createReporter(flags.json === true);
-  const file = resolve7(source);
+  const file = resolve8(source);
   const text = readFileSync5(file, "utf8");
-  const mod = await import(`${pathToFileURL(file).href}?t=${Date.now()}`);
+  const mod = await import(`${pathToFileURL2(file).href}?t=${Date.now()}`);
   const program = mod.default ?? mod.program;
   if (!program || typeof program !== "object")
     throw new UsageError(
@@ -10095,7 +10284,7 @@ async function cmdBuild(argv) {
     );
     return EXIT_ERROR;
   }
-  const out = resolve7(
+  const out = resolve8(
     strFlag(flags, "out") ?? join17(dirname3(file), "config.json")
   );
   writeFileSync2(out, JSON.stringify(built.config, null, 2) + "\n");
@@ -10113,8 +10302,8 @@ async function cmdBuild(argv) {
 
 // src/plugin/compare.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync16, mkdirSync as mkdirSync2, statSync as statSync4, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname4, join as join18, resolve as resolve8 } from "path";
+import { existsSync as existsSync17, mkdirSync as mkdirSync2, statSync as statSync4, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname4, join as join18, resolve as resolve9 } from "path";
 var BOOLEAN_FLAGS7 = /* @__PURE__ */ new Set(["json", "help"]);
 function sampleTimes(duration, every) {
   const step = every > 0 ? every : 1;
@@ -10175,13 +10364,13 @@ async function cmdCompare(argv) {
     );
   requireFfmpeg();
   const r = createReporter(flags.json === true);
-  const ref = resolve8(against);
+  const ref = resolve9(against);
   const loaded = await loadVosConfig(source);
   for (const w of loaded.warnings) r.log(`note: ${w}`);
   const config = loaded.config;
   const duration = configDuration(config) ?? 5;
   const assets = await programAssets(config, {
-    baseDir: /^https?:\/\//.test(source) ? null : existsSync16(source) && statSync4(source).isDirectory() ? source : dirname4(source),
+    baseDir: /^https?:\/\//.test(source) ? null : existsSync17(source) && statSync4(source).isDirectory() ? source : dirname4(source),
     origin: platformOrigin({}),
     key: resolveCredential(),
     log: (line) => r.log(line)
@@ -10197,7 +10386,7 @@ async function cmdCompare(argv) {
   const threshold = Number(strFlag(flags, "threshold") ?? 0.95);
   const timesRaw = strFlag(flags, "times");
   const times = timesRaw ? parseTimes(timesRaw, duration) : sampleTimes(duration, Number(strFlag(flags, "every") ?? 1));
-  const outDir = resolve8(strFlag(flags, "out") ?? "compare");
+  const outDir = resolve9(strFlag(flags, "out") ?? "compare");
   mkdirSync2(outDir, { recursive: true });
   const browser = await launchBrowser();
   const scores = [];
@@ -10300,25 +10489,25 @@ async function cmdCompare(argv) {
 }
 
 // src/plugin/port.ts
-import { existsSync as existsSync20, mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
-import { dirname as dirname7, join as join22, resolve as resolve11 } from "path";
-import { pathToFileURL as pathToFileURL3 } from "url";
+import { existsSync as existsSync21, mkdirSync as mkdirSync5, readFileSync as readFileSync8, writeFileSync as writeFileSync5 } from "fs";
+import { dirname as dirname7, join as join22, resolve as resolve12 } from "path";
+import { pathToFileURL as pathToFileURL4 } from "url";
 
 // src/plugin/portInventory.ts
 import { spawnSync as spawnSync2 } from "child_process";
 import {
-  existsSync as existsSync18,
+  existsSync as existsSync19,
   mkdirSync as mkdirSync3,
   readFileSync as readFileSync7,
   readdirSync as readdirSync4,
   statSync as statSync6
 } from "fs";
-import { dirname as dirname5, join as join20, relative as relative3, resolve as resolve9 } from "path";
-import { pathToFileURL as pathToFileURL2 } from "url";
+import { dirname as dirname5, join as join20, relative as relative3, resolve as resolve10 } from "path";
+import { pathToFileURL as pathToFileURL3 } from "url";
 import { findFontFamily as findFontFamily3 } from "@vosjs/shared";
 
 // src/plugin/portRemotion.ts
-import { existsSync as existsSync17, readFileSync as readFileSync6, readdirSync as readdirSync3, statSync as statSync5 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync6, readdirSync as readdirSync3, statSync as statSync5 } from "fs";
 import { createServer as createServer2 } from "http";
 import { createRequire } from "module";
 import { basename as basename7, extname as extname3, join as join19 } from "path";
@@ -10394,7 +10583,7 @@ function sourceTexts(dir) {
     }
   };
   const src = join19(dir, "src");
-  walk(existsSync17(src) ? src : dir, 0);
+  walk(existsSync18(src) ? src : dir, 0);
   return out;
 }
 function entryPoint(dir) {
@@ -10406,7 +10595,7 @@ function entryPoint(dir) {
     "remotion/index.ts",
     "remotion/index.tsx"
   ])
-    if (existsSync17(join19(dir, p))) return join19(dir, p);
+    if (existsSync18(join19(dir, p))) return join19(dir, p);
   return null;
 }
 var TYPES = {
@@ -10499,7 +10688,7 @@ async function readRemotion(dir, log) {
   const server = createServer2((rq, rs) => {
     const path = decodeURIComponent(new URL(rq.url ?? "/", "http://x").pathname);
     let f = join19(out, path);
-    if (!f.startsWith(out) || !existsSync17(f) || statSync5(f).isDirectory())
+    if (!f.startsWith(out) || !existsSync18(f) || statSync5(f).isDirectory())
       f = join19(out, "index.html");
     rs.writeHead(200, {
       "content-type": TYPES[extname3(f)] ?? "application/octet-stream"
@@ -10602,7 +10791,7 @@ async function readRemotion(dir, log) {
     const publicDir = join19(dir, "public");
     const media = tree.audio.map((a) => {
       const name = basename7(a.src.split("?")[0]);
-      const local = existsSync17(join19(publicDir, name)) ? `public/${name}` : a.src;
+      const local = existsSync18(join19(publicDir, name)) ? `public/${name}` : a.src;
       return {
         kind: "audio",
         src: local,
@@ -10643,9 +10832,9 @@ async function readRemotion(dir, log) {
 
 // src/plugin/portInventory.ts
 function detectEngine(dir) {
-  if (existsSync18(join20(dir, "hyperframes.json"))) return "hyperframes";
+  if (existsSync19(join20(dir, "hyperframes.json"))) return "hyperframes";
   const pkg = join20(dir, "package.json");
-  if (existsSync18(pkg)) {
+  if (existsSync19(pkg)) {
     try {
       const p = JSON.parse(readFileSync7(pkg, "utf8"));
       const deps = { ...p.dependencies ?? {}, ...p.devDependencies ?? {} };
@@ -10659,13 +10848,13 @@ function detectEngine(dir) {
   return "page";
 }
 function sourcePage(source) {
-  if (!existsSync18(source)) return null;
+  if (!existsSync19(source)) return null;
   if (statSync6(source).isFile()) return /\.html?$/i.test(source) ? source : null;
   const index = join20(source, "index.html");
-  return existsSync18(index) ? index : null;
+  return existsSync19(index) ? index : null;
 }
 function findRender(dir) {
-  const videos = (d) => existsSync18(d) ? readdirSync4(d).filter((f) => /\.(mp4|webm|mov)$/i.test(f)).map((f) => join20(d, f)) : [];
+  const videos = (d) => existsSync19(d) ? readdirSync4(d).filter((f) => /\.(mp4|webm|mov)$/i.test(f)).map((f) => join20(d, f)) : [];
   for (const d of [join20(dir, "renders"), join20(dir, "out"), dir]) {
     const found = videos(d);
     if (found.length) return found[0];
@@ -10936,8 +11125,8 @@ var SEEK_AND_READ = `((args) => {
   return out
 })`;
 async function readInventory(source, opts) {
-  const abs = resolve9(source);
-  const dir = existsSync18(abs) && statSync6(abs).isDirectory() ? abs : dirname5(abs);
+  const abs = resolve10(source);
+  const dir = existsSync19(abs) && statSync6(abs).isDirectory() ? abs : dirname5(abs);
   const engine = detectEngine(dir);
   const page = sourcePage(abs);
   const render = opts.render === void 0 ? findRender(dir) : opts.render;
@@ -10968,7 +11157,7 @@ async function readInventory(source, opts) {
       });
       const p = await ctx.newPage();
       await p.addInitScript("window.__timelines = window.__timelines || {}");
-      await p.goto(pathToFileURL2(page).href, { waitUntil: "load" });
+      await p.goto(pathToFileURL3(page).href, { waitUntil: "load" });
       await p.evaluate("document.fonts && document.fonts.ready");
       await p.waitForTimeout(300);
       read = await p.evaluate(READ_PAGE);
@@ -11103,8 +11292,8 @@ async function readInventory(source, opts) {
 
 // src/plugin/portScaffold.ts
 import { spawnSync as spawnSync3 } from "child_process";
-import { copyFileSync, existsSync as existsSync19, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
-import { basename as basename8, dirname as dirname6, join as join21, resolve as resolve10 } from "path";
+import { copyFileSync, existsSync as existsSync20, mkdirSync as mkdirSync4, writeFileSync as writeFileSync4 } from "fs";
+import { basename as basename8, dirname as dirname6, join as join21, resolve as resolve11 } from "path";
 import { findFontFamily as findFontFamily4, fontFaceUrl, nearestFontWeight } from "@vosjs/shared";
 
 // src/plugin/painterLib.ts
@@ -11513,9 +11702,9 @@ function planScaffold(inv, opts) {
   const audio = [];
   const copies = [];
   inv.media.filter((m) => m.kind === "audio" && m.src).forEach((m, i) => {
-    const from = resolve10(opts.sourceDir, m.src);
+    const from = resolve11(opts.sourceDir, m.src);
     const name = basename8(from);
-    if (!existsSync19(from)) {
+    if (!existsSync20(from)) {
       report.push(
         `- the audio ${m.src} is not in the source folder; add it to doc.json by hand`
       );
@@ -11754,11 +11943,11 @@ async function inventory(argv) {
   const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   const source = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
-  const outDir = resolve11(strFlag(flags, "out") ?? "port");
+  const outDir = resolve12(strFlag(flags, "out") ?? "port");
   mkdirSync5(outDir, { recursive: true });
   const renderFlag = strFlag(flags, "render");
   const inv = await readInventory(source, {
-    render: renderFlag === void 0 ? void 0 : resolve11(renderFlag),
+    render: renderFlag === void 0 ? void 0 : resolve12(renderFlag),
     outDir,
     log: (l) => r.log(`note: ${l}`)
   });
@@ -11794,13 +11983,13 @@ function summary(inv) {
 async function scaffold(argv) {
   const { flags } = parseArgs(argv, BOOLEAN_FLAGS8);
   const r = createReporter(flags.json === true);
-  const from = resolve11(strFlag(flags, "from") ?? join22("port", "inventory.json"));
-  if (!existsSync20(from))
+  const from = resolve12(strFlag(flags, "from") ?? join22("port", "inventory.json"));
+  if (!existsSync21(from))
     throw new UsageError(
       `no inventory at ${from}: run npx vos port inventory <source> first`
     );
   const inv = JSON.parse(readFileSync8(from, "utf8"));
-  const outDir = resolve11(
+  const outDir = resolve12(
     strFlag(flags, "out") ?? join22(dirname7(from), "program")
   );
   const plan = planScaffold(inv, {
@@ -11809,7 +11998,7 @@ async function scaffold(argv) {
   });
   writeScaffold(plan, outDir);
   const programFile = join22(outDir, "program.mjs");
-  const mod = await import(`${pathToFileURL3(programFile).href}?t=${Date.now()}`);
+  const mod = await import(`${pathToFileURL4(programFile).href}?t=${Date.now()}`);
   const built = buildProgram(mod.default, "program.mjs", plan.program);
   for (const p of built.problems) r.log(`error ${p.fn}: ${p.message}`);
   if (built.problems.length) return EXIT_ERROR;
@@ -11825,7 +12014,7 @@ async function scaffold(argv) {
 }
 function scaffoldSourceDir(inv) {
   if (inv.root) return inv.root;
-  return inv.source.endsWith(".html") ? dirname7(resolve11(inv.source)) : resolve11(inv.source);
+  return inv.source.endsWith(".html") ? dirname7(resolve12(inv.source)) : resolve12(inv.source);
 }
 
 // src/plugin/recipe.ts
@@ -11917,7 +12106,7 @@ async function cmdRecipe(argv) {
 
 // src/plugin/brand.ts
 import { writeFile as writeFile8 } from "fs/promises";
-import { resolve as resolve12 } from "path";
+import { resolve as resolve13 } from "path";
 import { parseFrontmatter as parseFrontmatter2 } from "@vosjs/shared/frontmatter";
 import { lookKindForGround } from "@vosjs/studio-core";
 var HEX_RE = /#(?:[0-9a-f]{6}|[0-9a-f]{3})\b/gi;
@@ -12238,7 +12427,7 @@ async function cmdBrand(argv) {
   const refused = fetchRefusal(url);
   if (refused) throw new UsageError(refused);
   const r = createReporter(flags.json === true);
-  const out = resolve12(strFlag(flags, "out") ?? "BRAND.md");
+  const out = resolve13(strFlag(flags, "out") ?? "BRAND.md");
   r.log(`reading ${origin}/design.md and /llms.txt\u2026`);
   const [designText, llmsText] = await Promise.all([
     fetchText(`${origin}/design.md`),
@@ -12290,25 +12479,31 @@ async function cmdBrand(argv) {
 }
 
 // src/plugin/hostedRecord.ts
-import { setupEnvNames as setupEnvNames2 } from "@vosjs/render-core/record";
+import { scriptEnvNames as scriptEnvNames2, setupEnvNames as setupEnvNames2 } from "@vosjs/render-core/record";
 var POLL_MS = 3e3;
 var DEFAULT_TIMEOUT_MS = 20 * 60 * 1e3;
 function hostedEnv(actions, shell) {
   const env = {};
   const missing = [];
-  for (const name of setupEnvNames2(actions.setup)) {
+  for (const name of scriptEnvNames2(actions)) {
     const v = shell[name];
     if (v === void 0 || v === "") missing.push(name);
     else env[name] = v;
   }
   return { env, missing };
 }
+function envReaders(actions) {
+  const setup = setupEnvNames2(actions.setup).length > 0;
+  const teardown = setupEnvNames2(actions.teardown).length > 0;
+  if (setup && teardown) return "the setup and teardown read";
+  return teardown ? "the teardown reads" : "the setup reads";
+}
 function envNamesNotice(actions) {
-  const names = setupEnvNames2(actions.setup);
+  const names = scriptEnvNames2(actions);
   if (names.length === 0) return null;
   return {
     names,
-    line: `the setup reads ${names.length === 1 ? "this environment variable" : "these environment variables"} from this shell: ${names.join(", ")} (names only; a value is never printed or stored)`
+    line: `${envReaders(actions)} ${names.length === 1 ? "this environment variable" : "these environment variables"} from this shell: ${names.join(", ")} (names only; a value is never printed or stored)`
   };
 }
 function announceEnvNames(actions, r) {
@@ -12405,7 +12600,7 @@ import { urlSchemeProblem as urlSchemeProblem2 } from "@vosjs/render-core/record
 
 // src/plugin/agentBrowser.ts
 import { writeFile as writeFile9 } from "fs/promises";
-import { resolve as resolve13 } from "path";
+import { resolve as resolve14 } from "path";
 function parseAgentBrowserLog(text) {
   const records = [];
   const problems = [];
@@ -12876,7 +13071,7 @@ async function cmdActions(argv) {
     );
   }
   const r = createReporter(flags.json === true);
-  const out = resolve13(strFlag(flags, "out") ?? "actions.json");
+  const out = resolve14(strFlag(flags, "out") ?? "actions.json");
   const viewportFlag = strFlag(flags, "viewport");
   let viewport;
   if (viewportFlag) {
@@ -12885,7 +13080,7 @@ async function cmdActions(argv) {
     viewport = { width: Number(m[1]), height: Number(m[2]) };
   }
   const { readFile: readFile19 } = await import("fs/promises");
-  const text = await readFile19(resolve13(input), "utf8");
+  const text = await readFile19(resolve14(input), "utf8");
   const { records, problems } = parseAgentBrowserLog(text);
   for (const p of problems) r.log(`  ${p}`);
   const result = convertAgentBrowser(records, {
@@ -12923,8 +13118,8 @@ function summary2(result) {
 async function cmdActionsScript(input, flags) {
   const r = createReporter(flags.json === true);
   const { readFile: readFile19 } = await import("fs/promises");
-  const { shotList, formatShotList } = await import("./shotList-MSNWLVDN.js");
-  const raw = JSON.parse(await readFile19(resolve13(input), "utf8"));
+  const { shotList, formatShotList } = await import("./shotList-PL7XP6AC.js");
+  const raw = JSON.parse(await readFile19(resolve14(input), "utf8"));
   const errors = validateActions(raw);
   if (errors.length) throw new UsageError(`${input}:
   ${errors.join("\n  ")}`);
@@ -12934,9 +13129,9 @@ async function cmdActionsScript(input, flags) {
 }
 
 // src/plugin/ingest.ts
-import { existsSync as existsSync21 } from "fs";
+import { existsSync as existsSync22 } from "fs";
 import { copyFile, mkdir as mkdir8, readFile as readFile13, stat as stat2 } from "fs/promises";
-import { basename as basename10, join as join23, resolve as resolve14 } from "path";
+import { basename as basename10, join as join23, resolve as resolve15 } from "path";
 
 // src/plugin/traceInflate.ts
 import { inflateRawSync } from "zlib";
@@ -13099,10 +13294,10 @@ async function cmdIngest(argv) {
     throw new UsageError(
       "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 = resolve14(source);
-  if (!existsSync21(videoPath)) throw new UsageError(`${source}: no such file`);
+  const videoPath = resolve15(source);
+  if (!existsSync22(videoPath)) throw new UsageError(`${source}: no such file`);
   const r = createReporter(flags.json === true);
-  const outDir = resolve14(strFlag(flags, "out") ?? "take");
+  const outDir = resolve15(strFlag(flags, "out") ?? "take");
   const offsetMs = numFlag(flags, "offset", 0);
   const viewportFlag = parseViewport(strFlag(flags, "viewport"));
   const cursorPath = strFlag(flags, "cursor");
@@ -13124,10 +13319,10 @@ async function cmdIngest(argv) {
   }
   let trace = null;
   if (cursorPath) {
-    trace = await readTraceFile(resolve14(cursorPath), offsetMs);
+    trace = await readTraceFile(resolve15(cursorPath), offsetMs);
     for (const n of trace.notes) r.log(`note: ${n}`);
   }
-  if (existsSync21(join23(outDir, "meta.json"))) {
+  if (existsSync22(join23(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` : "")
@@ -13201,9 +13396,9 @@ async function cmdIngest(argv) {
 
 // src/plugin/checkVideo.ts
 import { createRequire as createRequire2 } from "module";
-import { existsSync as existsSync22 } from "fs";
+import { existsSync as existsSync23 } from "fs";
 import { mkdir as mkdir9, readFile as readFile14, stat as stat3, writeFile as writeFile10 } from "fs/promises";
-import { basename as basename11, dirname as dirname8, extname as extname4, join as join24, resolve as resolve15 } from "path";
+import { basename as basename11, dirname as dirname8, extname as extname4, join as join24, resolve as resolve16 } from "path";
 import { ALL_FORMATS as ALL_FORMATS2, FilePathSource as FilePathSource2, Input as Input2 } from "mediabunny";
 
 // src/plugin/videoChecks.ts
@@ -13487,7 +13682,7 @@ async function probeVideoFacts(file) {
 async function mediabunnyBundle() {
   const entry = createRequire2(import.meta.url).resolve("mediabunny");
   const bundle = join24(dirname8(entry), "mediabunny.min.mjs");
-  if (existsSync22(bundle)) return readFile14(bundle, "utf8");
+  if (existsSync23(bundle)) return readFile14(bundle, "utf8");
   return readFile14(
     join24(entry.split("/dist/")[0], "dist/bundles/mediabunny.min.mjs"),
     "utf8"
@@ -13711,7 +13906,7 @@ async function checkVideo(browser, file, outDir) {
   );
   const long = Math.max(facts.width, facts.height, 1);
   const side = (n) => Math.max(1, Math.round(n / long * THUMB_LONG_SIDE));
-  const server = await startTakeServer(dirname8(resolve15(file)), {
+  const server = await startTakeServer(dirname8(resolve16(file)), {
     "/check.html": '<!doctype html><html><head><meta charset="utf-8"><link rel="icon" href="data:,"></head><body></body></html>'
   });
   const page = await browser.newPage();
@@ -13829,10 +14024,10 @@ async function cmdCheckVideo(argv) {
     throw new UsageError(
       "vos check-video <file.mp4|webm> [--out dir] [--strict] [--json]"
     );
-  if (!existsSync22(file)) throw new UsageError(`${file} does not exist`);
+  if (!existsSync23(file)) throw new UsageError(`${file} does not exist`);
   const r = createReporter(flags.json === true);
   const strict = flags.strict === true;
-  const outDir = resolve15(
+  const outDir = resolve16(
     strFlag(flags, "out") ?? join24(dirname8(file), `${basename11(file, extname4(file))}-check`)
   );
   const browser = await launchBrowser();
@@ -13848,7 +14043,7 @@ async function cmdCheckVideo(argv) {
 }
 
 // src/plugin/join.ts
-import { existsSync as existsSync25, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
+import { existsSync as existsSync26, readdirSync as readdirSync5, statSync as statSync7 } from "fs";
 import { copyFile as copyFile3, mkdir as mkdir11, readFile as readFile17, rm as rm4 } from "fs/promises";
 import {
   basename as basename13,
@@ -13856,7 +14051,7 @@ import {
   isAbsolute as isAbsolute4,
   join as join27,
   relative as relative5,
-  resolve as resolve17,
+  resolve as resolve18,
   sep as sep4
 } from "path";
 import {
@@ -13872,7 +14067,7 @@ import {
 import { totalDuration as totalDuration3 } from "@vosjs/timeline";
 
 // src/plugin/score.ts
-import { existsSync as existsSync23 } from "fs";
+import { existsSync as existsSync24 } from "fs";
 import {
   copyFile as copyFile2,
   mkdir as mkdir10,
@@ -13882,7 +14077,7 @@ import {
   writeFile as writeFile11
 } from "fs/promises";
 import { tmpdir as tmpdir2 } from "os";
-import { basename as basename12, isAbsolute as isAbsolute3, join as join25, relative as relative4, resolve as resolve16, sep as sep3 } from "path";
+import { basename as basename12, isAbsolute as isAbsolute3, join as join25, relative as relative4, resolve as resolve17, sep as sep3 } from "path";
 import {
   NORMALIZE_MAX_LUFS as NORMALIZE_MAX_LUFS2,
   NORMALIZE_MIN_LUFS as NORMALIZE_MIN_LUFS2,
@@ -14297,9 +14492,9 @@ function resolveAt(doc, raw) {
   return { at: r.start, via: `step ${v} (${r.start.toFixed(2)}s)` };
 }
 async function resolveTrack(dir, ref, flags, dryRun) {
-  const local = resolve16(ref);
-  if (existsSync23(local)) {
-    const rel = relative4(resolve16(dir), local);
+  const local = resolve17(ref);
+  if (existsSync24(local)) {
+    const rel = relative4(resolve17(dir), local);
     const inside = !!rel && !rel.startsWith(`..${sep3}`) && rel !== ".." && !isAbsolute3(rel);
     const key = inside ? rel.split(sep3).join("/") : `music/${basename12(local)}`;
     if (!inside && !dryRun) {
@@ -14438,7 +14633,7 @@ async function cmdScore(argv) {
   const placeLine = at2 && plan.swellAt !== null ? `the track starts at ${plan.in.toFixed(2)}s, so the swell lands at ${plan.swellAt.toFixed(2)}s of film (asked: ${at2.via})` : `the track starts at ${plan.in.toFixed(2)}s${at2 ? ` (asked: ${at2.via})` : ", its first rise above its median level"}`;
   r.done(
     {
-      take: resolve16(dir),
+      take: resolve17(dir),
       dryRun,
       track: { key: track.key, name: track.name, duration: clip.duration },
       film: r3(film),
@@ -14534,9 +14729,6 @@ function scriptDriftLine(d, file = "actions.json") {
 // src/plugin/stepCaptions.ts
 var STEP_CAPTIONS_FROM = "steps";
 var STEP_CAPTION_AT = "start";
-var CAPTION_MAX = 3;
-var CAPTION_MIN = 1.2;
-var CAPTION_GAP = 0.1;
 function captionOf(step, actions, script, recorded = []) {
   const own = step.caption;
   if (typeof own === "string" && own.trim()) return own.trim();
@@ -14570,6 +14762,7 @@ function landStepCaptions(doc, actions, opts = {}) {
     return footageEnd;
   };
   const ends = /* @__PURE__ */ new Map();
+  const labels = /* @__PURE__ */ new Map();
   const spoken = (media, step, steps) => kept.some((o) => {
     if (o.kind !== "text" || o.preset !== "caption") return false;
     if (o.anchor && mediaKey(o.anchor.media) === media)
@@ -14622,6 +14815,7 @@ function landStepCaptions(doc, actions, opts = {}) {
         from: STEP_CAPTIONS_FROM
       };
       ends.set(clip, end);
+      labels.set(clip, label);
       fresh.push(clip);
       report.landed.push({
         id,
@@ -14632,18 +14826,19 @@ function landStepCaptions(doc, actions, opts = {}) {
     }
     if (steps.length && !captioned) report.uncaptioned.push(media);
   }
-  fresh.sort((a, b) => a.start - b.start);
-  fresh.forEach((c, i) => {
-    const next = fresh[i + 1];
-    const clipRoom = (ends.get(c) ?? footageEnd) - c.start;
-    const nextRoom = next ? next.start - CAPTION_GAP - c.start : Infinity;
-    c.duration = +Math.min(
-      CAPTION_MAX,
-      clipRoom,
-      Math.max(CAPTION_MIN, nextRoom)
-    ).toFixed(3);
+  const fit = fitCaptions(fresh, (c) => ({
+    start: c.start,
+    end: ends.get(c) ?? footageEnd
+  }));
+  for (const { item, why } of fit.dropped) {
+    report.skipped.push(`${labels.get(item) ?? item.id}: ${why}`);
+    report.landed = report.landed.filter((l) => l.id !== item.id);
+  }
+  const landedClips = fit.kept.map(({ item, duration }) => {
+    item.duration = duration;
+    return item;
   });
-  const overlays = [...kept, ...fresh];
+  const overlays = [...kept, ...landedClips];
   if (overlays.length) doc.overlays = overlays;
   else delete doc.overlays;
   return report;
@@ -14951,7 +15146,7 @@ function perBeatLine(r, name = (m) => m ? `media ${m}` : "the primary") {
 
 // src/plugin/rejoin.ts
 import { createHash as createHash4 } from "crypto";
-import { createReadStream, existsSync as existsSync24 } from "fs";
+import { createReadStream, existsSync as existsSync25 } from "fs";
 import { readFile as readFile16 } from "fs/promises";
 import { join as join26 } from "path";
 import {
@@ -14979,11 +15174,11 @@ async function partFootage(part) {
   if (!isTakeRelativeKey(key))
     return `key:${createHash4("sha256").update(key).digest("hex")}`;
   const file = join26(part.dir, takeRelativeFile(key));
-  return existsSync24(file) ? fileHash(file) : `key:${createHash4("sha256").update(key).digest("hex")}`;
+  return existsSync25(file) ? fileHash(file) : `key:${createHash4("sha256").update(key).digest("hex")}`;
 }
 async function readJoinRecord(dir) {
   const file = join26(dir, JOIN_RECORD_NAME);
-  if (!existsSync24(file)) return null;
+  if (!existsSync25(file)) return null;
   try {
     const v = JSON.parse(await readFile16(file, "utf8"));
     return v && v.version === 1 && Array.isArray(v.inputs) ? v : null;
@@ -14996,7 +15191,7 @@ async function recordFromFootage(dir, doc) {
     if (!isTakeRelativeKey(key))
       return `key:${createHash4("sha256").update(key).digest("hex")}`;
     const file = join26(dir, takeRelativeFile(key));
-    return existsSync24(file) ? fileHash(file) : `missing:${key}`;
+    return existsSync25(file) ? fileHash(file) : `missing:${key}`;
   };
   const inputs = [
     {
@@ -16002,10 +16197,10 @@ var within = (inner, outer) => {
   return rel === "" || !rel.startsWith(`..${sep4}`) && rel !== ".." && !isAbsolute4(rel);
 };
 async function readPart(arg) {
-  const path = resolve17(arg);
-  if (!existsSync25(path)) throw new UsageError(`${arg}: no such take or file`);
+  const path = resolve18(arg);
+  if (!existsSync26(path)) throw new UsageError(`${arg}: no such take or file`);
   if (statSync7(path).isDirectory()) {
-    if (!existsSync25(join27(path, "meta.json")))
+    if (!existsSync26(join27(path, "meta.json")))
       throw new UsageError(
         `${arg}: not a take directory (no meta.json); a video file is joined by its path`
       );
@@ -16052,11 +16247,11 @@ async function cmdJoin(argv) {
     throw new UsageError(
       "--force replaces the joined take and --keep-edits keeps its edits; pass one"
     );
-  const out = resolve17(outArg);
-  const inputs = positionals.map((p) => resolve17(p));
+  const out = resolve18(outArg);
+  const inputs = positionals.map((p) => resolve18(p));
   const muted = /* @__PURE__ */ new Set();
   for (const m of multi.mute ?? []) {
-    const i = inputs.indexOf(resolve17(m));
+    const i = inputs.indexOf(resolve18(m));
     if (i < 0)
       throw new UsageError(
         `--mute ${m}: not one of the inputs; name a file as it is given to vos join`
@@ -16070,19 +16265,19 @@ async function cmdJoin(argv) {
       );
   }
   let rejoin = false;
-  if (existsSync25(out)) {
+  if (existsSync26(out)) {
     if (!force && !keepEdits)
       throw new UsageError(
         `--out ${outArg} exists; pass --keep-edits to join again and keep every edit made since (its trims, spans, layers, frame, sound), --force to replace it, or name a new directory`
       );
     if (keepEdits) {
-      if (!existsSync25(join27(out, "doc.json")))
+      if (!existsSync26(join27(out, "doc.json")))
         throw new UsageError(
           `--keep-edits: ${outArg} holds no doc.json, so there are no edits to keep; name a new directory, or --force to replace it`
         );
       rejoin = true;
     } else {
-      const isTake = existsSync25(join27(out, "doc.json")) || existsSync25(join27(out, "meta.json"));
+      const isTake = existsSync26(join27(out, "doc.json")) || existsSync26(join27(out, "meta.json"));
       if (!isTake && readdirSync5(out).length > 0)
         throw new UsageError(
           `--force replaces a take directory, and ${outArg} holds other files; name a new directory`
@@ -16128,7 +16323,7 @@ async function cmdJoin(argv) {
       );
     }
     rejoined = rejoinDocs(migrateMotion3(prev), record, read, {
-      where: (p) => relative5(process.cwd(), resolve17(out, p)) || "."
+      where: (p) => relative5(process.cwd(), resolve18(out, p)) || "."
     });
     plan = rejoined.plan;
   } else plan = joinDocs(parts);
@@ -16169,11 +16364,11 @@ async function cmdJoin(argv) {
     for (const k of rejoined.dropped) {
       if (!/^[A-Za-z0-9_-]+$/.test(k)) continue;
       const dir = join27(out, k);
-      if (existsSync25(dir) && statSync7(dir).isDirectory())
+      if (existsSync26(dir) && statSync7(dir).isDirectory())
         await rm4(dir, { recursive: true, force: true });
     }
   } else {
-    if (existsSync25(out)) await rm4(out, { recursive: true, force: true });
+    if (existsSync26(out)) await rm4(out, { recursive: true, force: true });
     await mkdir11(out, { recursive: true });
   }
   for (const c of plan.copies) {
@@ -16257,7 +16452,7 @@ async function cmdJoin(argv) {
 }
 
 // src/plugin/timeline.ts
-import { join as join28, resolve as resolve18 } from "path";
+import { join as join28, resolve as resolve19 } from "path";
 import {
   docFreezes as docFreezes2,
   docMediaList as docMediaList4,
@@ -16548,7 +16743,7 @@ async function cmdTakeInfo(argv) {
   if (drift) r.warn(scriptDriftLine(drift));
   const timeline = takeTimeline(take.doc, /* @__PURE__ */ new Map([["", take.actions]]));
   r.done(
-    { take: resolve18(dir), doc: join28(resolve18(dir), "doc.json"), ...timeline },
+    { take: resolve19(dir), doc: join28(resolve19(dir), "doc.json"), ...timeline },
     formatTimeline(timeline, dir)
   );
   return EXIT_OK;
@@ -16652,8 +16847,8 @@ async function cmdAudio(argv) {
 
 // src/plugin/look.ts
 import { mkdir as mkdir12 } from "fs/promises";
-import { existsSync as existsSync26 } from "fs";
-import { join as join30, resolve as resolve19 } from "path";
+import { existsSync as existsSync27 } from "fs";
+import { join as join30, resolve as resolve20 } from "path";
 import { headersFor, urlSchemeProblem } from "@vosjs/render-core/record";
 function quote(value) {
   return `"${value.replace(/\s+/g, " ").replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
@@ -17195,15 +17390,15 @@ async function cmdLook(argv) {
   if (scheme) throw new UsageError(scheme);
   const r = createReporter(flags.json === true);
   const viewport = parseViewport2(strFlag(flags, "viewport"));
-  const outDir = resolve19(strFlag(flags, "out") ?? "look");
+  const outDir = resolve20(strFlag(flags, "out") ?? "look");
   const headed = flags.headed === true;
   const waitRaw = strFlag(flags, "wait");
   const waitMs = waitRaw === void 0 ? 0 : Number(waitRaw);
   if (!Number.isFinite(waitMs) || waitMs < 0 || waitMs > 6e4)
     throw new UsageError("--wait expects milliseconds, 0 to 60000");
   const storageRaw = strFlag(flags, "storage-state");
-  const storageState = storageRaw ? resolve19(storageRaw) : void 0;
-  if (storageState && !existsSync26(storageState))
+  const storageState = storageRaw ? resolve20(storageRaw) : void 0;
+  if (storageState && !existsSync27(storageState))
     throw new UsageError(`--storage-state: no such file: ${storageState}`);
   const sessionName = strFlag(flags, "session");
   if (sessionName) {
@@ -17213,7 +17408,7 @@ async function cmdLook(argv) {
       throw new UsageError(
         "--session and --storage-state are two doors to one page: a persistent profile cannot take a storage state. Pass one"
       );
-    if (!existsSync26(sessionDir(sessionName)))
+    if (!existsSync27(sessionDir(sessionName)))
       throw new UsageError(
         `no session "${sessionName}". Make one: vos session open <url> --name ${sessionName} (a Chrome window opens; sign in and close it)`
       );
@@ -17276,7 +17471,7 @@ async function cmdLook(argv) {
 import { spawnSync as spawnSync4 } from "child_process";
 import {
   cpSync,
-  existsSync as existsSync28,
+  existsSync as existsSync29,
   mkdirSync as mkdirSync6,
   readFileSync as readFileSync11,
   rmSync as rmSync3,
@@ -17287,7 +17482,7 @@ import { join as join32 } from "path";
 import { chromium as chromium2 } from "playwright";
 
 // src/plugin/machine.ts
-import { existsSync as existsSync27, readFileSync as readFileSync10, readdirSync as readdirSync6, statSync as statSync8 } from "fs";
+import { existsSync as existsSync28, readFileSync as readFileSync10, readdirSync as readdirSync6, statSync as statSync8 } from "fs";
 import { dirname as dirname10, join as join31 } from "path";
 var AGENT_NAMES = [
   "claude",
@@ -17308,7 +17503,7 @@ var HOME_DIRS = {
   copilot: [".copilot"]
 };
 function detectAgents(root, opts = {}) {
-  const exists = opts.exists ?? existsSync27;
+  const exists = opts.exists ?? existsSync28;
   const out = [];
   for (const agent of AGENT_NAMES) {
     for (const rel of PROJECT_DIRS[agent]) {
@@ -17355,7 +17550,7 @@ function skillsDirFor(home) {
 function fallbackSkillsHome(root) {
   return { agent: "codex", dir: join31(root, ".agents"), scope: "project" };
 }
-function installedSkills(dir, exists = existsSync27, list = (p) => {
+function installedSkills(dir, exists = existsSync28, list = (p) => {
   try {
     return readdirSync6(p);
   } catch {
@@ -17396,7 +17591,7 @@ ${RULES_BLOCK}
   }
   return { text, changed: text !== current };
 }
-function rulesFileFor(root, exists = existsSync27) {
+function rulesFileFor(root, exists = existsSync28) {
   const agents = join31(root, "AGENTS.md");
   if (exists(agents)) return agents;
   const claude = join31(root, "CLAUDE.md");
@@ -17511,12 +17706,12 @@ function bundledSkillsDir(from) {
   let dir = dirname10(from);
   for (let i = 0; i < 6; i++) {
     const pkg = join31(dir, "package.json");
-    if (existsSync27(pkg)) {
+    if (existsSync28(pkg)) {
       try {
         const name = JSON.parse(readFileSync10(pkg, "utf8")).name;
         if (name === "@vosjs/cli") {
           const skills = join31(dir, "skills");
-          return existsSync27(skills) && statSync8(skills).isDirectory() ? skills : null;
+          return existsSync28(skills) && statSync8(skills).isDirectory() ? skills : null;
         }
       } catch {
       }
@@ -17552,7 +17747,7 @@ function npx() {
 function bundledChromium() {
   try {
     const p = chromium2.executablePath();
-    return p && existsSync28(p) ? p : null;
+    return p && existsSync29(p) ? p : null;
   } catch {
     return null;
   }
@@ -17561,7 +17756,7 @@ function probe2() {
   return probeBrowser({
     platform: process.platform,
     env: process.env,
-    exists: existsSync28,
+    exists: existsSync29,
     bundled: bundledChromium
   });
 }
@@ -17714,7 +17909,7 @@ async function cmdSetup(argv) {
   let rules = null;
   if (!noRules) {
     const file = rulesFileFor(root);
-    const existing = existsSync28(file) ? readFileSync11(file, "utf8") : null;
+    const existing = existsSync29(file) ? readFileSync11(file, "utf8") : null;
     const { text, changed } = applyRulesBlock(existing);
     if (changed) writeFileSync6(file, text);
     rules = { file, changed };
@@ -17828,7 +18023,7 @@ async function cmdWhoami(argv) {
 function cmdLogout(argv) {
   const { flags } = parseArgs(argv, BOOLEAN_FLAGS14);
   const r = reporterFor(flags);
-  const had = existsSync28(CREDENTIALS_PATH);
+  const had = existsSync29(CREDENTIALS_PATH);
   rmSync3(CREDENTIALS_PATH, { force: true });
   const envKey = Boolean(process.env.VOS_API_KEY?.trim());
   r.done(
@@ -17882,8 +18077,9 @@ var MULTI_FLAGS2 = /* @__PURE__ */ new Set([
 var HELP = `vos \u2014 record a browser flow, plan effects, render a product video; sync with vos.so
 
 Take pipeline
-  vos create --actions actions.json [--url <url>] [--out take] [out.webm] [--strict] [--allow-wall] [--keep-frames] [--max-duration <s>] [--ready dom|networkidle] [--storage-state <file>|--session <name>] [--header name=value]... [--confirm <id>]... [--browser-arg=<switch>]... [--background <slug|url|none>] [render flags] [--json]
-  vos record --actions actions.json [--url <url>] [--out take] [--strict] [--dry-run] [--allow-wall] [--keep-frames] [--max-duration <s>] [--ready dom|networkidle] [--storage-state <file>|--session <name>] [--header name=value]... [--confirm <id>]... [--browser-arg=<switch>]... [--background <slug|url|none>] [--verbose] [--json]
+  vos create --actions actions.json [--url <url>] [--out take] [--reuse] [out.webm] [--strict] [--allow-wall] [--keep-frames] [--max-duration <s>] [--ready dom|networkidle] [--storage-state <file>|--session <name>] [--header name=value]... [--confirm <id>]... [--browser-arg=<switch>]... [--background <slug|url|none>] [render flags] [--json]
+  vos record --actions actions.json [--url <url>] [--out take] [--reuse] [--strict] [--dry-run] [--allow-wall] [--keep-frames] [--max-duration <s>] [--ready dom|networkidle] [--storage-state <file>|--session <name>] [--header name=value]... [--confirm <id>]... [--browser-arg=<switch>]... [--background <slug|url|none>] [--verbose] [--json]
+            --reuse, recording again into a take that has a cut: the cut (kept as doc.prev.json) goes onto the new footage as vos plan --reuse does; without it the take is planned fresh and its last line says where the cut is
   vos record --hosted --actions actions.json [--url <url>] [--out take] [--title "\u2026"] [--folder <id>] [--header name=value]... [--json]
             the take recorded on vos.so's fleet (no browser here): lands as a private vos with its doc and digest, then fetched into --out with its media
   vos plan <take> [--fresh] [--reuse [--from <doc.json>]] [--style <doc.json|vosId>] [--with <doc.json|vosId>[@end|@start|@step:<id>|@<s>]]... [--background <slug|url|none>] [--motion] [--headline "\u2026"] [--kicker "\u2026"] [--launch LAUNCH.md] [--brand BRAND.md] [--music <slug|mood|none>] [--entrance tilt-in|pull-out|rise|fade|slide|none] [--transitions slide|fade|scale|none] [--end-card on|none|<doc.json|vosId>] [--captions|--captions none] [--clicks none] [--still <t>] [--release v2.1] [--zooms per-beat] [--json]
@@ -17923,6 +18119,8 @@ Take pipeline
             see a page before scripting it, signed in the way vos record would be: <out>/look.png and every control in view with ONE proposed selector (test id, aria-label, role + name, then words in its dialog or landmark), UNIQUE or AMBIGUOUS as the recorder's own engine counts it, plus what the frame exposes. --click/--type run first, in order; a click on a spend or delete word is refused. Exit 4 at a sign-in wall
   vos session open <url> --name <app>   a plain Chrome window on a vos-owned profile; sign in, set the account up, close the window (or Enter)
   vos session check <name> [--url <url>] [--strict]   headless, against a stranger: does the page open as you? exit 0/4
+  vos session exec <name> <script.mjs> [--url <url>] [--headed] [--viewport WxH] [--json]
+            run your own Playwright code inside the session: the module's default export gets { context, page, url, name } and what it returns is printed (result under --json). The ONLY safe way to script a session: a profile opened by any other browser (Playwright's bundled one, a mock keychain) cannot read its cookies and is signed out
   vos session list | rm <name>          what exists and how old; delete one
   vos actions script <actions.json> [--json]
             the flow as numbered beats in words, for a person recording it by hand
@@ -18336,6 +18534,13 @@ function exposureNote(rec) {
 ${rec.exposures.map((e) => `    - ${exposureLine(e)}`).join("\n")}
   ${EXPOSURE_ADVICE}`;
 }
+function teardownNote(rec) {
+  return rec.teardown ? `
+  ${teardownLine(rec.teardown)}` : "";
+}
+function teardownField(rec) {
+  return rec.teardown ? { teardown: rec.teardown } : {};
+}
 function takeConfirm(multi, actions, opts) {
   const given = (multi.confirm ?? []).filter(Boolean);
   if (opts.dryRun) return given;
@@ -18399,8 +18604,8 @@ function takeBrowserArgs(multi) {
 function takeStorageState(flags) {
   const raw = strFlag(flags, "storage-state");
   if (!raw) return void 0;
-  const path = resolve20(raw);
-  if (!existsSync29(path))
+  const path = resolve21(raw);
+  if (!existsSync30(path))
     throw new UsageError(`--storage-state: no such file: ${path}`);
   return path;
 }
@@ -18413,7 +18618,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 (!existsSync29(sessionDir(name)))
+  if (!existsSync30(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)`
     );
@@ -18429,6 +18634,63 @@ async function inSession(name, actions, fn) {
     }
   });
 }
+function reRecord(outDir, flags, r) {
+  const wantsReuse = flags.reuse === true;
+  if (wantsReuse && !existsSync30(join33(outDir, "doc.json")))
+    throw new UsageError(
+      `--reuse: ${outDir} has no cut to keep (no doc.json); record without --reuse`
+    );
+  let previousCut = null;
+  return {
+    prepare: async () => {
+      if (existsSync30(join33(outDir, "meta.json"))) {
+        const { prevDoc, kept } = await prepareReRecord(outDir);
+        if (prevDoc) previousCut = join33(outDir, PREV_DOC_NAME);
+        r.log(
+          `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? wantsReuse ? "; the previous cut goes onto the new footage when it is recorded (--reuse)" : `; the previous cut is ${PREV_DOC_NAME}` : "")
+        );
+      }
+      await mkdir13(outDir, { recursive: true });
+      await ensureTakeDir(outDir);
+    },
+    plan: async (backdrop) => {
+      const from = wantsReuse ? previousCut : null;
+      const plan = await planTake(outDir, {
+        backdrop,
+        ...from ? {
+          reuse: {
+            from,
+            doc: JSON.parse(await readFile18(from, "utf8"))
+          }
+        } : {}
+      });
+      if (!from) await notePlannedDoc(outDir);
+      return plan;
+    },
+    previousCut: () => previousCut
+  };
+}
+function previousCutReport(outDir, previousCut, plan) {
+  if (plan?.reuse) {
+    const s = plan.reuse;
+    return {
+      line: `
+  reused ${s.from}: ${s.anchored} anchored + ${s.mapped} mapped span(s)` + (s.flagged.length ? `
+  flagged:
+    ${s.flagged.join("\n    ")}` : ""),
+      next: null,
+      fields: { previousCut: s.from, reuse: s }
+    };
+  }
+  if (!previousCut) return { line: "", next: null, fields: {} };
+  const next = `vos plan ${outDir} --reuse`;
+  return {
+    line: `
+  YOUR PREVIOUS CUT is kept in ${previousCut}, not on this footage. Apply it: ${next} (or record with --reuse next time)`,
+    next,
+    fields: { previousCut, next_step: next }
+  };
+}
 async function takeBackdrop(flags, r) {
   const { backdrop, note } = await openingBackdrop(
     strFlag(flags, "background"),
@@ -18485,7 +18747,7 @@ async function cmdRecord(argv) {
   const scheme = urlSchemeProblem2(url);
   if (scheme) throw new UsageError(scheme);
   announceEnvNames(actions, r);
-  const outDir = resolve20(strFlag(flags, "out") ?? "take");
+  const outDir = resolve21(strFlag(flags, "out") ?? "take");
   const storageState = takeStorageState(flags);
   const sessionName = takeSessionName(flags, storageState);
   const browserArgs = takeBrowserArgs(multi);
@@ -18505,7 +18767,7 @@ async function cmdRecord(argv) {
       );
     const hostedActions = await scriptForHost(
       actions,
-      dirname11(resolve20(actionsPath))
+      dirname11(resolve21(actionsPath))
     ).catch((e) => {
       throw new UsageError(e instanceof Error ? e.message : String(e));
     });
@@ -18530,7 +18792,7 @@ async function cmdRecord(argv) {
     const { env, missing } = hostedEnv(actions, process.env);
     if (missing.length)
       throw new UsageError(
-        `the setup reads ${missing.map((n) => `{ "env": "${n}" }`).join(", ")} and this shell has no ${missing.length === 1 ? "value for it" : "values for them"}; export ${missing.join(", ")} and run again (the value rides the job, and is never stored)`
+        `${envReaders(actions)} ${missing.map((n) => `{ "env": "${n}" }`).join(", ")} and this shell has no ${missing.length === 1 ? "value for it" : "values for them"}; export ${missing.join(", ")} and run again (the value rides the job, and is never stored)`
       );
     r.log("recording on vos.so\u2026");
     r.event({ event: "phase", phase: "record" });
@@ -18601,9 +18863,11 @@ async function cmdRecord(argv) {
   }
   const backdrop = await takeBackdrop(flags, r);
   const maxDurationSeconds = await maxDuration(flags, r);
+  const cut = reRecord(outDir, flags, r);
   if (flags["dry-run"] === true) {
     void flags.strict;
     void flags["keep-frames"];
+    void flags.reuse;
     const browser2 = await launchBrowser(browserArgs);
     try {
       r.log("rehearsing (nothing is captured or written)\u2026");
@@ -18613,7 +18877,7 @@ async function cmdRecord(argv) {
         sessionName,
         actions,
         (context2) => recordTake(browser2, url, actions, takePaths(outDir), r.log, {
-          actionsDir: dirname11(resolve20(actionsPath)),
+          actionsDir: dirname11(resolve21(actionsPath)),
           storageState,
           headers,
           context: context2,
@@ -18677,7 +18941,9 @@ async function cmdRecord(argv) {
         ...Object.keys(headers).map((k) => `--header ${k}=\u2026`),
         ...sessionName ? [`--session ${sessionName}`] : [],
         ...flags["allow-wall"] === true ? ["--allow-wall"] : [],
-        ...confirm.map((c) => `--confirm ${c}`)
+        ...confirm.map((c) => `--confirm ${c}`),
+        // A take that already has a cut keeps it on the new footage.
+        ...existsSync30(join33(outDir, "doc.json")) ? ["--reuse"] : []
       ].join(" ");
       const nextOut = strFlag(flags, "out") ?? "take";
       const guardNote = !unconfirmed.ok ? unconfirmed.unconfirmed.length ? ` (it refuses until you add ${unconfirmed.unconfirmed.map((id) => `--confirm ${id}`).join(" ")}: ${unconfirmed.unconfirmed.length === 1 ? "that step spends" : "those steps spend"} something real)` : ` (${unconfirmed.unknown.map((c) => `--confirm ${c}`).join(", ")} names no guarded step)` : "";
@@ -18698,11 +18964,12 @@ async function cmdRecord(argv) {
           exposures: rec.exposures,
           notices: rec.notices,
           masks: rec.masks,
-          ...rec.peers.length ? { peers: rec.peers } : {}
+          ...rec.peers.length ? { peers: rec.peers } : {},
+          ...teardownField(rec)
         },
         `${failed ? "REHEARSAL FAILED" : "Rehearsal passed"}: ${resolved}/${actions.steps.length} steps resolved in ${((Date.now() - started) / 1e3).toFixed(1)}s${rec.navTimeout ? " (the first load never reached networkidle)" : rec.ready.capped ? " (the first page never stopped changing)" : ""}
 ${lines.join("\n")}
-  ${maskMisses(rec).length ? `MASK hid nothing: ${maskMisses(rec).join(", ")} (the selector reached no element). ` : ""}${rec.stopped ? `STOPPED: ${rec.stopped.reason}. ` : ""}${failed ? "Fix the script, rehearse again, then record." : `Rects are capture px (the step rects a pin or a callout reads). Next: vos record --actions ${actionsPath} --out ${nextOut}${carried ? ` ${carried}` : ""} --strict${guardNote}`}${exposureNote(rec)}${noticeNote(rec)}`
+  ${maskMisses(rec).length ? `MASK hid nothing: ${maskMisses(rec).join(", ")} (the selector reached no element). ` : ""}${rec.stopped ? `STOPPED: ${rec.stopped.reason}. ` : ""}${failed ? "Fix the script, rehearse again, then record." : `Rects are capture px (the step rects a pin or a callout reads). Next: vos record --actions ${actionsPath} --out ${nextOut}${carried ? ` ${carried}` : ""} --strict${guardNote}`}${exposureNote(rec)}${noticeNote(rec)}${teardownNote(rec)}`
       );
       return rec.stopped ? EXIT_ERROR : failed ? EXIT_USAGE : EXIT_OK;
     } finally {
@@ -18710,16 +18977,6 @@ ${lines.join("\n")}
     }
   }
   const paths = takePaths(outDir);
-  const prepare = async () => {
-    if (existsSync29(join33(outDir, "meta.json"))) {
-      const { prevDoc, kept } = await prepareReRecord(outDir);
-      r.log(
-        `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? "; apply the previous cut to the new footage with: vos plan " + outDir + " --reuse" : "")
-      );
-    }
-    await mkdir13(outDir, { recursive: true });
-    await ensureTakeDir(outDir);
-  };
   const browser = await launchBrowser(browserArgs);
   try {
     r.log("recording\u2026");
@@ -18728,7 +18985,7 @@ ${lines.join("\n")}
       sessionName,
       actions,
       (context2) => recordTake(browser, url, actions, paths, r.log, {
-        actionsDir: dirname11(resolve20(actionsPath)),
+        actionsDir: dirname11(resolve21(actionsPath)),
         maxDurationSeconds,
         storageState,
         headers,
@@ -18739,7 +18996,7 @@ ${lines.join("\n")}
         onEvent: (e) => r.event(e),
         onArrival: wallGate(flags, r, {
           strict: flags.strict === true,
-          prepare
+          prepare: cut.prepare
         })
       })
     );
@@ -18752,7 +19009,8 @@ ${lines.join("\n")}
     );
     await releaseFrames(paths, flags, r.log);
     r.event({ event: "phase", phase: "plan" });
-    const plan = await planTake(outDir, { backdrop });
+    const plan = await cut.plan(backdrop);
+    const kept = previousCutReport(outDir, cut.previousCut(), plan);
     const clicks = rec.events.filter((e) => e.type === "down").length;
     const strict = flags.strict === true;
     const strictFail = strict && strictFails(rec);
@@ -18771,10 +19029,12 @@ ${lines.join("\n")}
           confirmed: rec.confirmed,
           skips: rec.skips,
           outputs: rec.outputs,
-          pageErrors: rec.pageErrors
+          pageErrors: rec.pageErrors,
+          ...kept.fields,
+          ...teardownField(rec)
         },
         `FAILED: ${rec.stopped.reason}.
-  The footage up to it is in ${outDir}.${skippedNote}${stepNote}${navTimeoutNote(rec)}`
+  The footage up to it is in ${outDir}.${skippedNote}${stepNote}${navTimeoutNote(rec)}${kept.line}${teardownNote(rec)}`
       );
       return EXIT_ERROR;
     }
@@ -18807,11 +19067,13 @@ ${lines.join("\n")}
         overruns: rec.overruns,
         pageErrors: rec.pageErrors,
         ...rec.peers.length ? { peers: rec.peers } : {},
-        ...strictFail ? { strictFailed: true } : {}
+        ...teardownField(rec),
+        ...strictFail ? { strictFailed: true } : {},
+        ...kept.fields
       },
-      strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}${stepNote}${navTimeoutNote(rec)}${exposureNote(rec)}${noticeNote(rec)}` : `Take ready: ${outDir}
-  ${(rec.meta.durationMs / 1e3).toFixed(1)}s \xB7 ${rec.frames.length} frames \xB7 ${rec.events.length} cursor events \xB7 ${clicks} clicks \xB7 ${plan.doc.zoom.length} zoom spans planned \xB7 ${rec.freezePct}% frozen \xB7 ${rec.dead.pct}% dead${deadWarns(rec.dead) ? " \u26A0 " + deadLine(rec.dead) : ""}${skippedNote}${stepNote}${navTimeoutNote(rec)}${pageSoundNote(rec)}
-  Next: edit ${join33(outDir, "doc.json")} (optional), then: vos render ${outDir}${exposureNote(rec)}${noticeNote(rec)}`
+      strictFail ? `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; fix the flow and re-record.${skippedNote}${stepNote}${navTimeoutNote(rec)}${kept.line}${exposureNote(rec)}${noticeNote(rec)}` : `Take ready: ${outDir}
+  ${(rec.meta.durationMs / 1e3).toFixed(1)}s \xB7 ${rec.frames.length} frames \xB7 ${rec.events.length} cursor events \xB7 ${clicks} clicks \xB7 ${plan.doc.zoom.length} zoom spans planned \xB7 ${rec.freezePct}% frozen \xB7 ${rec.dead.pct}% dead${deadWarns(rec.dead) ? " \u26A0 " + deadLine(rec.dead) : ""}${skippedNote}${stepNote}${navTimeoutNote(rec)}${pageSoundNote(rec)}${kept.line}
+  Next: ${kept.next ? `${kept.next}, then` : `edit ${join33(outDir, "doc.json")} (optional), then:`} vos render ${outDir}${exposureNote(rec)}${noticeNote(rec)}${teardownNote(rec)}`
     );
     return strictFail ? EXIT_USAGE : EXIT_OK;
   } finally {
@@ -18838,7 +19100,7 @@ async function cmdCreate2(argv) {
   const scheme = urlSchemeProblem2(url);
   if (scheme) throw new UsageError(scheme);
   announceEnvNames(actions, r);
-  const outDir = resolve20(strFlag(flags, "out") ?? "take");
+  const outDir = resolve21(strFlag(flags, "out") ?? "take");
   const format = videoFormat(strFlag(flags, "format"), positionals[0]);
   const out = positionals[0] ?? join33(outDir, `out.${format}`);
   const parallel = numFlag(flags, "parallel", 1);
@@ -18853,16 +19115,7 @@ async function cmdCreate2(argv) {
   const headers = takeHeaders(multi);
   const confirm = takeConfirm(multi, actions, { dryRun: false, r });
   const paths = takePaths(outDir);
-  const prepare = async () => {
-    if (existsSync29(join33(outDir, "meta.json"))) {
-      const { prevDoc, kept } = await prepareReRecord(outDir);
-      r.log(
-        `note: re-recording ${outDir} \u2014 kept ${kept.length ? kept.join(", ") : "nothing"}` + (prevDoc ? "; apply the previous cut to the new footage with: vos plan " + outDir + " --reuse" : "")
-      );
-    }
-    await mkdir13(outDir, { recursive: true });
-    await ensureTakeDir(outDir);
-  };
+  const cut = reRecord(outDir, flags, r);
   const browser = await launchBrowser(browserArgs);
   try {
     r.log("recording\u2026");
@@ -18871,7 +19124,7 @@ async function cmdCreate2(argv) {
       sessionName,
       actions,
       (context2) => recordTake(browser, url, actions, paths, r.log, {
-        actionsDir: dirname11(resolve20(actionsPath)),
+        actionsDir: dirname11(resolve21(actionsPath)),
         maxDurationSeconds,
         storageState,
         headers,
@@ -18882,7 +19135,7 @@ async function cmdCreate2(argv) {
         onEvent: (e) => r.event(e),
         onArrival: wallGate(flags, r, {
           strict: flags.strict === true,
-          prepare
+          prepare: cut.prepare
         })
       })
     );
@@ -18895,7 +19148,8 @@ async function cmdCreate2(argv) {
     );
     await releaseFrames(paths, flags, r.log);
     r.event({ event: "phase", phase: "plan" });
-    await planTake(outDir, { backdrop });
+    const plan = await cut.plan(backdrop);
+    const kept = previousCutReport(outDir, cut.previousCut(), plan);
     if (rec.stopped) {
       r.done(
         {
@@ -18903,9 +19157,11 @@ async function cmdCreate2(argv) {
           ok: false,
           stopped: rec.stopped,
           skipped: rec.skipped,
-          rendered: false
+          rendered: false,
+          ...kept.fields,
+          ...teardownField(rec)
         },
-        `FAILED: ${rec.stopped.reason}. NOT rendering; the footage up to it is in ${outDir}.`
+        `FAILED: ${rec.stopped.reason}. NOT rendering; the footage up to it is in ${outDir}.${kept.line}${teardownNote(rec)}`
       );
       return EXIT_ERROR;
     }
@@ -18919,9 +19175,11 @@ async function cmdCreate2(argv) {
           ready: rec.ready,
           capped: rec.capped,
           strictFailed: true,
-          rendered: false
+          rendered: false,
+          ...kept.fields,
+          ...teardownField(rec)
         },
-        `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; NOT rendering. Fix the flow and re-run, or render the partial take with: vos render ${outDir}`
+        `STRICT: take recorded but incomplete \u2014 ${strictReason(rec)}; NOT rendering. Fix the flow and re-run, or render the partial take with: vos render ${outDir}${kept.line}${teardownNote(rec)}`
       );
       return EXIT_USAGE;
     }
@@ -18967,10 +19225,12 @@ async function cmdCreate2(argv) {
         ...rec.media.length ? { media: rec.media } : {},
         overruns: rec.overruns,
         pageErrors: rec.pageErrors,
-        ...flags.draft === true ? { draft: true } : {}
+        ...teardownField(rec),
+        ...flags.draft === true ? { draft: true } : {},
+        ...kept.fields
       },
       `Created ${result.out} (${(result.bytes / 1024).toFixed(0)} KB, ${result.width}x${result.height}@${result.fps}, ${result.duration.toFixed(1)}s, ${result.zoomSpans} zoom spans, ${result.clicks} click effects${result.audio ? ", audio" : ""}${flags.draft === true ? ", DRAFT" : ""})
-  take: ${outDir} \u2014 inspect with: vos frames ${outDir} --at-zooms; edit doc.json and re-render with: vos render ${outDir}${stepReportNote(rec)}${navTimeoutNote(rec)}${exposureNote(rec)}${noticeNote(rec)}`
+  take: ${outDir} \u2014 inspect with: vos frames ${outDir} --at-zooms; edit doc.json and re-render with: vos render ${outDir}${stepReportNote(rec)}${navTimeoutNote(rec)}${kept.line}${exposureNote(rec)}${noticeNote(rec)}${teardownNote(rec)}`
     );
     return EXIT_OK;
   } finally {
@@ -18996,8 +19256,8 @@ async function cmdPlan(argvIn) {
   }
   let reuse;
   if (flags.reuse === true) {
-    const from = resolve20(strFlag(flags, "from") ?? join33(dir, PREV_DOC_NAME));
-    if (!existsSync29(from)) {
+    const from = resolve21(strFlag(flags, "from") ?? join33(dir, PREV_DOC_NAME));
+    if (!existsSync30(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>`
       );
@@ -19008,7 +19268,7 @@ async function cmdPlan(argvIn) {
     };
   }
   const style = await resolveStyleRef(flags);
-  const hasDoc = existsSync29(join33(dir, "doc.json"));
+  const hasDoc = existsSync30(join33(dir, "doc.json"));
   const backdrop = hasDoc ? null : await takeBackdrop(flags, r);
   const release = await releaseInputs(dir, flags, r, multi.with ?? []);
   const stepCaptions = strFlag(flags, "captions") === "steps";
@@ -19086,7 +19346,7 @@ async function cmdPlan(argvIn) {
     ${s.reuse.flagged.join("\n    ")}` : "") : "";
   r.done(
     {
-      take: resolve20(dir),
+      take: resolve21(dir),
       fresh: s.fresh,
       cursorKept: s.cursorKept,
       zoomAuto,
@@ -19466,11 +19726,11 @@ async function resolveStyleRef(flags) {
 }
 async function resolveDocRef(ref, flags, what) {
   const styleRef = ref;
-  const file = existsSync29(styleRef) ? resolve20(
+  const file = existsSync30(styleRef) ? resolve21(
     styleRef,
-    existsSync29(join33(styleRef, "doc.json")) ? "doc.json" : ""
+    existsSync30(join33(styleRef, "doc.json")) ? "doc.json" : ""
   ) : null;
-  if (file && existsSync29(file)) {
+  if (file && existsSync30(file)) {
     return {
       from: file,
       doc: migrateHostedDoc4(
@@ -19585,14 +19845,14 @@ async function cmdOpen(argv) {
   if (!dir) throw new UsageError("vos open <take> [--studio <url>]");
   const r = createReporter(flags.json === true);
   const take = await loadTake(dir);
-  if (!existsSync29(take.paths.recording)) {
+  if (!existsSync30(take.paths.recording)) {
     throw new UsageError(`${dir} has no recording \u2014 re-run record`);
   }
   const studio = (strFlag(flags, "studio") ?? platformOrigin()).replace(
     /\/+$/,
     ""
   );
-  const server = await startTakeServer(resolve20(dir), {});
+  const server = await startTakeServer(resolve21(dir), {});
   const url = `${studio}/studio?take=${encodeURIComponent(server.base)}`;
   r.event({ event: "open", server: server.base, url });
   r.log(`take served at ${server.base}`);
@@ -19718,7 +19978,7 @@ async function cmdValidate(argv) {
   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 : existsSync29(join33(target, "kit.json")) && !isTakeDir(target) ? join33(target, "kit.json") : null;
+  const kitTarget = target.endsWith("kit.json") ? target : existsSync30(join33(target, "kit.json")) && !isTakeDir(target) ? join33(target, "kit.json") : null;
   if (kitTarget) {
     const picture = flags.picture === true;
     const verdict = await validateKit(kitTarget, { picture });
@@ -19750,7 +20010,7 @@ async function cmdValidate(argv) {
     r.done({ valid: true, target }, `${target}: valid actions file`);
     return EXIT_OK;
   }
-  if (!isTakeDir(target) && existsSync29(join33(target, "config.json"))) {
+  if (!isTakeDir(target) && existsSync30(join33(target, "config.json"))) {
     const parsed = JSON.parse(
       await readFile18(join33(target, "config.json"), "utf8")
     );
@@ -19794,7 +20054,7 @@ async function cmdValidate(argv) {
   const problems = [];
   const warnings = [];
   const notes = [];
-  if (!existsSync29(take.paths.recording)) {
+  if (!existsSync30(take.paths.recording)) {
     problems.push("missing recording (re-run record)");
   } else {
     const mismatch = containerMismatch(
@@ -19835,7 +20095,7 @@ async function cmdValidate(argv) {
       const found = localFile(rel, target);
       if (!("refused" in found)) continue;
       problems.push(
-        existsSync29(resolve20(target, rel)) ? `doc.json: ${ref.where}: ${ref.key} ${found.refused}` : `doc.json: ${ref.where}: ${ref.key} is not a file in the take, so a render plays the film without it (put the file there, or fix the key)`
+        existsSync30(resolve21(target, rel)) ? `doc.json: ${ref.where}: ${ref.key} ${found.refused}` : `doc.json: ${ref.where}: ${ref.key} is not a file in the take, so a render plays the film without it (put the file there, or fix the key)`
       );
     }
     if (flags.picture === true && (take.doc.overlays ?? []).some((o) => o.kind === "html")) {
@@ -19914,7 +20174,7 @@ async function cmdPush3(argv) {
     );
   const refusal = takePushRefusal({
     vos: strFlag(flags, "vos"),
-    trackedVosId: readSyncState(resolve20(dir))?.vosId ?? null,
+    trackedVosId: readSyncState(resolve21(dir))?.vosId ?? null,
     programOnly: ["slug", "desc", "tags", "base", "remix-of", "still"].filter(
       (name) => hasFlag(flags, name)
     )
@@ -19930,7 +20190,7 @@ async function cmdPush3(argv) {
         `--claimable creates a NEW claimable vos; ${iterating.map((f) => `--${f}`).join(", ")} ${iterating.length > 1 ? "apply" : "applies"} to a keyed push`
       );
     const claim = await pushTakeClaimable(
-      resolve20(dir),
+      resolve21(dir),
       {
         api: strFlag(flags, "api"),
         origin: strFlag(flags, "origin"),
@@ -19953,7 +20213,7 @@ reference and the only credential.`
   }
   const overrides = multi.override;
   const result = await pushTake(
-    resolve20(dir),
+    resolve21(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -20008,7 +20268,7 @@ async function cmdPull2(argv) {
   const dir = positionals[0] ?? ".";
   const r = createReporter(flags.json === true);
   const result = await pullTake(
-    resolve20(dir),
+    resolve21(dir),
     {
       key: strFlag(flags, "key"),
       api: strFlag(flags, "api"),
@@ -20183,10 +20443,13 @@ function verdictExit(v, strict, none) {
   return strict ? EXIT_WALL : EXIT_OK;
 }
 async function cmdSession(argv) {
-  const { positionals, flags } = parseArgs(argv, BOOLEAN_FLAGS15);
+  const { positionals, flags } = parseArgs(
+    argv,
+    /* @__PURE__ */ new Set([...BOOLEAN_FLAGS15, "headed"])
+  );
   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>";
+  const usage = "vos session open <url> --name <app> | check <name> [--url <url>] | exec <name> <script.mjs> [--url <url>] [--headed] [--viewport WxH] | list | rm <name>";
   switch (sub) {
     case "open": {
       if (!arg) throw new UsageError(usage);
@@ -20227,7 +20490,7 @@ async function cmdSession(argv) {
       if (!arg) throw new UsageError(usage);
       const bad = sessionNameVerdict(arg);
       if (bad) throw new UsageError(bad);
-      if (!existsSync29(sessionDir(arg)))
+      if (!existsSync30(sessionDir(arg)))
         throw new UsageError(`no session "${arg}" (vos session list)`);
       const summary3 = await summarizeSession(arg);
       const url = strFlag(flags, "url");
@@ -20252,10 +20515,58 @@ async function cmdSession(argv) {
           origins: summary3.origins,
           newestExpires: summary3.newestExpires
         },
-        `session "${arg}": ${verdictLine(verdict, url, arg)}${verdict.state === "not-signed-in" ? `. It expired, or the sign-in never landed. Sign in again: vos session open ${url} --name ${arg}` : `. ${summaryLine(summary3)}`}`
+        `session "${arg}": ${verdictLine(verdict, url, arg)}${verdict.state === "not-signed-in" ? `. It expired, the sign-in never landed, or the profile was opened by a browser that cannot read its cookies (a script launching it itself signs it out; run scripts with vos session exec). Sign in again: vos session open ${url} --name ${arg}` : `. ${summaryLine(summary3)}`}`
       );
       return verdictExit(verdict, flags.strict === true, EXIT_WALL);
     }
+    case "exec": {
+      const scriptPath = positionals[2];
+      if (!arg || !scriptPath) throw new UsageError(usage);
+      const bad = sessionNameVerdict(arg);
+      if (bad) throw new UsageError(bad);
+      if (!existsSync30(sessionDir(arg)))
+        throw new UsageError(`no session "${arg}" (vos session list)`);
+      const url = strFlag(flags, "url");
+      if (url && !/^https?:\/\//.test(url))
+        throw new UsageError("--url wants an http(s) URL");
+      const viewport = strFlag(flags, "viewport");
+      const size = viewport ? /^(\d+)x(\d+)$/.exec(viewport) : null;
+      if (viewport && !size)
+        throw new UsageError("--viewport wants WxH, e.g. 1280x720");
+      let script;
+      try {
+        script = await loadExecScript(scriptPath);
+      } catch (e) {
+        if (e instanceof ExecScriptError) throw new UsageError(e.message);
+        throw new UsageError(
+          `${scriptPath} could not be loaded: ${e instanceof Error ? e.message.split("\n")[0] : String(e)}`
+        );
+      }
+      let result;
+      try {
+        result = await execInProfile(sessionDir(arg), script, {
+          name: arg,
+          ...url ? { url } : {},
+          headless: flags.headed !== true,
+          ...size ? { viewport: { width: +size[1], height: +size[2] } } : {}
+        });
+      } catch (e) {
+        r.done(
+          {
+            name: arg,
+            ok: false,
+            error: e instanceof Error ? e.message.split("\n")[0] : String(e)
+          },
+          `the script failed in session "${arg}": ${e instanceof Error ? e.message.split("\n")[0] : String(e)} (the session was closed cleanly)`
+        );
+        return EXIT_ERROR;
+      }
+      r.done(
+        { name: arg, ok: true, ...result !== void 0 ? { result } : {} },
+        result === void 0 ? `ran ${scriptPath} in session "${arg}"` : typeof result === "string" ? result : JSON.stringify(result, null, 2)
+      );
+      return EXIT_OK;
+    }
     case "list": {
       const rows = listSessions();
       r.done(
@@ -20300,8 +20611,10 @@ export {
   HELP,
   strictFails,
   takeBrowserArgs,
+  reRecord,
+  previousCutReport,
   takeBackdrop,
   verbHelp,
   run
 };
-//# sourceMappingURL=chunk-SP5OHTVB.js.map
+//# sourceMappingURL=chunk-S3RI2SHH.js.map