@spark-apps/quickpeek 1.2.4 → 1.2.5

package/dist/mcp-tools.mjs

@@ -230,7 +230,7 @@ function spawnFFmpeg(cmd2, args) {
   return trackChild(spawn(cmd2, args));
 }
 function runFFmpeg(args, errorLabel) {
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const proc = spawnFFmpeg("ffmpeg", args);
     let stderr = "";
     proc.stderr.on("data", (d) => {
@@ -238,7 +238,7 @@ function runFFmpeg(args, errorLabel) {
     });
     proc.on("close", (code) => {
       if (code !== 0) reject(new Error(`${errorLabel}: ${stderr.slice(-500)}`));
-      else resolve12();
+      else resolve13();
     });
     proc.on("error", reject);
   });
@@ -254,6 +254,48 @@ var init_spawn = __esm({
   }
 });
 
+// src/lib/image-kind.ts
+import { readFileSync as readFileSync3 } from "fs";
+function mimeForKind(kind) {
+  return MIME[kind];
+}
+function sniffImageKind(buf) {
+  if (buf.length < 12) return null;
+  if (buf[0] === 137 && buf[1] === 80 && buf[2] === 78 && buf[3] === 71) return "png";
+  if (buf[0] === 255 && buf[1] === 216 && buf[2] === 255) return "jpeg";
+  if (buf.subarray(0, 3).toString("latin1") === "GIF") return "gif";
+  if (buf.subarray(0, 4).toString("latin1") === "RIFF" && buf.subarray(8, 12).toString("latin1") === "WEBP") {
+    return "webp";
+  }
+  const head = buf.subarray(0, 1024).toString("utf8").replace(/^/, "").trimStart();
+  if (/^<(\?xml|!--|!doctype svg|svg)[\s>]/i.test(head) && /<svg[\s>]/i.test(head)) return "svg";
+  return null;
+}
+function imageDataUri(path) {
+  try {
+    const buf = readFileSync3(path);
+    const kind = sniffImageKind(buf);
+    if (!kind) return null;
+    return `data:${mimeForKind(kind)};base64,${buf.toString("base64")}`;
+  } catch {
+    return null;
+  }
+}
+var MIME, MIN_ICON_PX;
+var init_image_kind = __esm({
+  "src/lib/image-kind.ts"() {
+    "use strict";
+    MIME = {
+      png: "image/png",
+      jpeg: "image/jpeg",
+      gif: "image/gif",
+      webp: "image/webp",
+      svg: "image/svg+xml"
+    };
+    MIN_ICON_PX = 48;
+  }
+});
+
 // src/lib/api-client.ts
 function apiKey() {
   return process.env.SPARK_AI_KEY || "";
@@ -370,7 +412,7 @@ async function executeChat(chatUrl, bearerToken, systemPrompt, userPrompt, tier,
             ...detail ? { detail } : {},
             ...retryAfter2 ? { retryAfterSeconds: parseInt(retryAfter2, 10) } : {}
           };
-          await new Promise((resolve12) => setTimeout(resolve12, Math.min(delayMs, 3e4)));
+          await new Promise((resolve13) => setTimeout(resolve13, Math.min(delayMs, 3e4)));
           continue;
         }
         const retryAfter = response.headers.get("Retry-After");
@@ -410,7 +452,7 @@ async function executeChat(chatUrl, bearerToken, systemPrompt, userPrompt, tier,
         return { success: false, error: `${host} unreachable: ${getErrorMessage(err)}`, host };
       }
       const delayMs = 1e3 * 2 ** (attempt - 1);
-      await new Promise((resolve12) => setTimeout(resolve12, delayMs));
+      await new Promise((resolve13) => setTimeout(resolve13, delayMs));
     }
   }
   return lastRetriableError || { success: false, error: `${host}: request failed after retries`, host };
@@ -572,9 +614,6 @@ var init_SparkStripe_feature_gating = __esm({
 });
 
 // src/lib/billing.ts
-function shouldWatermark(tier, videoDurationSeconds) {
-  return tier === "free" && videoDurationSeconds > 20;
-}
 function getUpgradeUrl(userEmail) {
   return pricingUrl(userEmail ? { email: userEmail } : void 0);
 }
@@ -609,7 +648,10 @@ function applyProfile(config, profile) {
       format: "mp3",
       bitrate: "192k",
       ...config.audio,
-      speed: config.audio?.speed ?? preset.audioSpeed,
+      // outroOnly is on unless turned off, matching the video phase. The
+      // speedup buys the song its window, so it applies to the profile's own
+      // pace only: a speed somebody set by hand is the speed they wanted.
+      speed: config.audio?.speed ?? preset.audioSpeed * (config.music?.outroOnly !== false ? OUTRO_SONG_SPEEDUP : 1),
       ...config.audio?.voice || !preset.voice ? {} : { voice: preset.voice }
     }
   };
@@ -646,11 +688,11 @@ function defaultCaptionsFor(width, height) {
     maxChars: 20
   };
 }
-var VERSION, CONFIG_FILE, SIZE_PRESETS, RATE_FACTOR, NO_CLIP_OUTRO, DEFAULT_CONFIG, VIDEO_PROFILES, DEFAULT_CAPTIONS;
+var VERSION, CONFIG_FILE, SIZE_PRESETS, RATE_FACTOR, NO_CLIP_OUTRO, DEFAULT_CONFIG, VIDEO_PROFILES, OUTRO_SONG_SPEEDUP, DEFAULT_CAPTIONS;
 var init_config = __esm({
   "src/lib/config.ts"() {
     "use strict";
-    VERSION = "1.2.3";
+    VERSION = "1.2.5";
     CONFIG_FILE = "quickpeek.config.json";
     SIZE_PRESETS = {
       wide: { width: 1920, height: 1080, zoom: 1 },
@@ -677,11 +719,12 @@ var init_config = __esm({
         // ms
         transitions: "none",
         contrast: 0.25,
-        // A demo plays a touch faster than it was recorded, because a recording
-        // paced for the narration reads as slow next to anything else on the same
-        // feed. 1.2 is the most that still sounds like a person talking; set 1 in
-        // quickpeek.config.json for the raw pace.
-        tempo: 1.2,
+        // The recording plays at the pace it was filmed at. A tempo above 1 is
+        // multiplied by the narration speed in VIDEO_PROFILES and by the fit
+        // pass's squeeze, and the three together read as frantic rather than
+        // brisk. Speed belongs in one place, so it lives in audioSpeed; set a
+        // tempo in quickpeek.config.json to push the picture on top of that.
+        tempo: 1,
         stepDelay: 200
         // ms delay between steps
       },
@@ -695,18 +738,24 @@ var init_config = __esm({
       // these bitrates - the encode is pure wall-clock tax on every run.
       wide: {
         video: { width: 1920, height: 1080, zoom: 1.5, fitLimitSecs: 0, maxSpeedup: 1, preset: "veryfast" },
-        audioSpeed: 1.6
+        // A tutorial is watched to learn something, so the narrator is allowed to
+        // be brisk but never hurried.
+        audioSpeed: 1.15
       },
       short: {
         // fadeOut 0: the video ends on a card the viewer is meant to read,
         // and a fade takes it away mid-sentence.
         video: { width: 1080, height: 1920, zoom: 3, fitLimitSecs: 60, maxSpeedup: 1.7, preset: "veryfast", fadeOut: 0 },
-        audioSpeed: 1.8,
+        // 1.8 was unwatchable: stacked on tempo 1.2 and the outro speedup it ran
+        // the voice at better than twice its natural rate. A short wants energy,
+        // which is the voice and the cutting, not the tape running fast.
+        audioSpeed: 1,
         // A short lives or dies on energy. Ava is the warmest, most animated of
         // the free neural voices; Sonia reads a short like the shipping forecast.
         voice: "en-US-AvaMultilingualNeural"
       }
     };
+    OUTRO_SONG_SPEEDUP = 1.13;
     DEFAULT_CAPTIONS = {
       font: "Arial",
       outline: "#000000",
@@ -856,6 +905,7 @@ async function waitForPlaceholdersGone(page, cap = PLACEHOLDER_CAP_MS) {
   const deadline = Date.now() + cap;
   let previous = -1;
   let unchanged = 0;
+  let clear = 0;
   while (Date.now() < deadline) {
     const count = await page.evaluate((selector) => {
       let visible = 0;
@@ -865,7 +915,12 @@ async function waitForPlaceholdersGone(page, cap = PLACEHOLDER_CAP_MS) {
       }
       return visible;
     }, PLACEHOLDER_SELECTOR).catch(() => 0);
-    if (count === 0) return;
+    if (count === 0) {
+      if (++clear >= PLACEHOLDER_CLEAR_POLLS) return;
+      await page.waitForTimeout(PLACEHOLDER_POLL_MS);
+      continue;
+    }
+    clear = 0;
     if (count === previous) {
       if (++unchanged >= PLACEHOLDER_STATIC_POLLS) return;
     } else {
@@ -1125,7 +1180,7 @@ async function crawlPage(url, task2 = noopTask, storageStatePath, viewport) {
     });
   }
 }
-var SETTLE_POLL_MS, SETTLE_STABLE_POLLS, SETTLE_CAP_MS, PLACEHOLDER_POLL_MS, PLACEHOLDER_CAP_MS, PLACEHOLDER_STATIC_POLLS, PLACEHOLDER_SELECTOR, noopTask, CRAWL_CACHE_TTL_MS, CRAWL_CACHE_MAX_ENTRIES, crawlCache;
+var SETTLE_POLL_MS, SETTLE_STABLE_POLLS, SETTLE_CAP_MS, PLACEHOLDER_POLL_MS, PLACEHOLDER_CAP_MS, PLACEHOLDER_STATIC_POLLS, PLACEHOLDER_CLEAR_POLLS, PLACEHOLDER_SELECTOR, noopTask, CRAWL_CACHE_TTL_MS, CRAWL_CACHE_MAX_ENTRIES, crawlCache;
 var init_crawl = __esm({
   "src/lib/crawl.ts"() {
     "use strict";
@@ -1136,6 +1191,7 @@ var init_crawl = __esm({
     PLACEHOLDER_POLL_MS = 250;
     PLACEHOLDER_CAP_MS = 8e3;
     PLACEHOLDER_STATIC_POLLS = 4;
+    PLACEHOLDER_CLEAR_POLLS = 3;
     PLACEHOLDER_SELECTOR = [
       '[aria-busy="true"]',
       '[role="progressbar"]',
@@ -1287,13 +1343,13 @@ function canEncode(encoder) {
   ]);
 }
 function run(args) {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     let settled = false;
     const done = (ok) => {
       if (settled) return;
       settled = true;
       clearTimeout(timer);
-      resolve12(ok);
+      resolve13(ok);
     };
     const proc = trackChild(spawn3("ffmpeg", args, { stdio: "ignore" }));
     const timer = setTimeout(() => {
@@ -1350,8 +1406,13 @@ async function composeVideo(opts) {
     musicPath,
     musicVolume = 0.3,
     musicTargetLufs = MUSIC_BED_LUFS,
-    musicFadeIn = 2,
-    musicFadeOut = 2,
+    // Sized for the outro window: the song has 5.5s, so a 2s fade at each end
+    // left 1.5s of music anyone could actually hear. Up fast, hold, out slow.
+    musicFadeIn = 1,
+    musicFadeOut = 1.5,
+    tempo = 1,
+    musicStartSecs = 0,
+    musicDurationSecs = 0,
     width,
     height,
     fps,
@@ -1412,7 +1473,19 @@ async function composeVideo(opts) {
   const clipAudioLabel = opts.hasClipAudio ? "[0:a]" : "";
   const hasVoiceover = !!voiceoverPath;
   const hasMusic = !!musicPath;
-  const musicFadeOutStart = Math.max(0, effectiveDuration - musicFadeOut);
+  const bedStart = Math.max(0, Math.min(musicStartSecs, Math.max(0, effectiveDuration - 0.5)));
+  const bedLength = Math.max(0.5, effectiveDuration - bedStart);
+  const bedDelay = bedStart > 0 ? `adelay=${Math.round(bedStart * 1e3)}|${Math.round(bedStart * 1e3)},` : "";
+  const bedTempo = tempo > 1 ? 1 / tempo : 1;
+  const bedSlow = bedTempo === 1 ? "" : `atempo=${bedTempo.toFixed(6)},`;
+  const bedSource = bedLength * bedTempo;
+  const bedSeek = musicDurationSecs > bedSource + 0.05 ? musicDurationSecs - bedSource : 0;
+  const bedTrimIn = bedSeek > 0 ? `atrim=start=${bedSeek.toFixed(3)},asetpts=PTS-STARTPTS,` : "";
+  const bedFadeOut = bedSeek > 0 ? 0 : musicFadeOut * tempo;
+  const bedLoop = bedSeek > 0 ? "" : "aloop=loop=-1:size=2e+09,";
+  const bedFadeIn = musicFadeIn * tempo;
+  const musicFadeOutStart = Math.max(0, bedLength - bedFadeOut);
+  const bedFadeOutFilter = bedFadeOut > 0 ? `afade=t=out:st=${musicFadeOutStart}:d=${bedFadeOut},` : "";
   const vfStr = [...vf, ...encoder.filter ? [encoder.filter] : []].join(",");
   if (hasVoiceover && hasMusic) {
     const mixInputs = clipAudioLabel ? 3 : 2;
@@ -1428,7 +1501,7 @@ async function composeVideo(opts) {
       // card, which is the one place the bed is the only thing playing.
       `[voicekey0]apad=whole_dur=${effectiveDuration}[voicekey]`,
       // Music: normalised to a known level, trimmed, then faded.
-      `[2:a]aloop=loop=-1:size=2e+09,atrim=0:${effectiveDuration},loudnorm=I=${musicTargetLufs}:TP=-9:LRA=11,volume=${musicVolume},afade=t=in:st=0:d=${musicFadeIn},afade=t=out:st=${musicFadeOutStart}:d=${musicFadeOut}[bed]`,
+      `[2:a]${bedTrimIn}${bedLoop}${bedSlow}atrim=0:${bedLength},loudnorm=I=${musicTargetLufs}:TP=-9:LRA=11,volume=${musicVolume},afade=t=in:st=0:d=${bedFadeIn},${bedFadeOutFilter}${bedDelay}apad=whole_dur=${effectiveDuration}[bed]`,
       `[bed][voicekey]${DUCK}[music]`,
       // normalize=0, because amix's default divides every input by the number
       // of them: adding the bed used to quietly take 6 dB off the narration,
@@ -1452,7 +1525,7 @@ async function composeVideo(opts) {
     args.push(...encoder.output);
     args.push("-c:a", "aac", "-b:a", audioBitrate);
   } else if (hasMusic) {
-    const musicFilter = `aloop=loop=-1:size=2e+09,atrim=0:${effectiveDuration},volume=${musicVolume},afade=t=in:st=0:d=${musicFadeIn},afade=t=out:st=${musicFadeOutStart}:d=${musicFadeOut},${MASTER_CHAIN}`;
+    const musicFilter = `${bedTrimIn}${bedLoop}${bedSlow}atrim=0:${bedLength},volume=${musicVolume},afade=t=in:st=0:d=${bedFadeIn},${bedFadeOutFilter}${bedDelay}apad=whole_dur=${effectiveDuration},${MASTER_CHAIN}`;
     args.push("-vf", vfStr);
     args.push("-map", "0:v", "-map", "1:a", "-af", musicFilter);
     args.push(...encoder.output);
@@ -1584,7 +1657,7 @@ function cacheKey(filePath) {
   }
 }
 function getVideoDimensions(filePath) {
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const args = [
       "-v",
       "error",
@@ -1615,12 +1688,12 @@ function getVideoDimensions(filePath) {
         reject(new Error(`ffprobe returned no dimensions for ${filePath}`));
         return;
       }
-      resolve12({ width: w, height: h });
+      resolve13({ width: w, height: h });
     });
   });
 }
 function hasAudioStream(filePath) {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffprobe", [
       "-v",
       "error",
@@ -1636,15 +1709,15 @@ function hasAudioStream(filePath) {
     proc.stdout.on("data", (d) => {
       out += d;
     });
-    proc.on("close", () => resolve12(out.trim().length > 0));
-    proc.on("error", () => resolve12(false));
+    proc.on("close", () => resolve13(out.trim().length > 0));
+    proc.on("error", () => resolve13(false));
   });
 }
 function getMediaDuration(filePath) {
   const key = cacheKey(filePath);
   const cached = key === null ? void 0 : durationCache.get(key);
   if (cached !== void 0) return Promise.resolve(cached);
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const args = [
       "-v",
       "error",
@@ -1671,13 +1744,13 @@ function getMediaDuration(filePath) {
       const ms = Math.ceil(parseFloat(stdout.trim()) * 1e3);
       const freshKey = cacheKey(filePath);
       if (freshKey !== null && Number.isFinite(ms)) durationCache.set(freshKey, ms);
-      resolve12(ms);
+      resolve13(ms);
     });
     proc.on("error", reject);
   });
 }
 function getAudioCodec(filePath) {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const args = [
       "-v",
       "error",
@@ -1694,8 +1767,8 @@ function getAudioCodec(filePath) {
     proc.stdout.on("data", (data) => {
       stdout += data;
     });
-    proc.on("close", (code) => resolve12(code === 0 ? stdout.trim() : ""));
-    proc.on("error", () => resolve12(""));
+    proc.on("close", (code) => resolve13(code === 0 ? stdout.trim() : ""));
+    proc.on("error", () => resolve13(""));
   });
 }
 async function isHonestWav(filePath) {
@@ -1849,7 +1922,7 @@ var init_media = __esm({
 
 // src/lib/ffmpeg/silence.ts
 function getVideoStreamDuration(inputPath) {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffprobe", [
       "-v",
       "error",
@@ -1866,12 +1939,12 @@ function getVideoStreamDuration(inputPath) {
     proc.stdout.on("data", (d) => {
       out += d;
     });
-    proc.on("error", () => resolve12(0));
-    proc.on("close", () => resolve12(Number.parseFloat(out.trim()) || 0));
+    proc.on("error", () => resolve13(0));
+    proc.on("close", () => resolve13(Number.parseFloat(out.trim()) || 0));
   });
 }
 function detectSilences(inputPath, minDurSecs) {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffmpeg", [
       "-hide_banner",
       "-nostats",
@@ -1890,7 +1963,7 @@ function detectSilences(inputPath, minDurSecs) {
     proc.stderr.on("data", (d) => {
       err += d;
     });
-    proc.on("error", () => resolve12([]));
+    proc.on("error", () => resolve13([]));
     proc.on("close", () => {
       const spans = [];
       let start = null;
@@ -1905,12 +1978,12 @@ function detectSilences(inputPath, minDurSecs) {
           start = null;
         }
       }
-      resolve12(spans);
+      resolve13(spans);
     });
   });
 }
 function detectFrozenSpans(inputPath, minDurSecs) {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffmpeg", [
       "-hide_banner",
       "-nostats",
@@ -1931,7 +2004,7 @@ function detectFrozenSpans(inputPath, minDurSecs) {
     proc.stderr.on("data", (d) => {
       err += d;
     });
-    proc.on("error", () => resolve12([]));
+    proc.on("error", () => resolve13([]));
     proc.on("close", () => {
       const spans = [];
       let start = null;
@@ -1944,12 +2017,12 @@ function detectFrozenSpans(inputPath, minDurSecs) {
           start = null;
         }
       }
-      resolve12(spans);
+      resolve13(spans);
     });
   });
 }
 function detectBlackSpans(inputPath, minDurSecs) {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffmpeg", [
       "-hide_banner",
       "-nostats",
@@ -1972,19 +2045,19 @@ function detectBlackSpans(inputPath, minDurSecs) {
     proc.stderr.on("data", (d) => {
       err += d;
     });
-    proc.on("error", () => resolve12([]));
+    proc.on("error", () => resolve13([]));
     proc.on("close", () => {
       const spans = [];
       for (const line of err.split("\n")) {
         const m = line.match(/black_start:\s*([\d.]+)\s+black_end:\s*([\d.]+)/);
         if (m?.[1] && m[2]) spans.push({ start: Number.parseFloat(m[1]), end: Number.parseFloat(m[2]) });
       }
-      resolve12(spans);
+      resolve13(spans);
     });
   });
 }
 function detectWhiteSpans(inputPath, minDurSecs) {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffmpeg", [
       "-hide_banner",
       "-nostats",
@@ -2002,14 +2075,14 @@ function detectWhiteSpans(inputPath, minDurSecs) {
     proc.stderr.on("data", (d) => {
       err += d;
     });
-    proc.on("error", () => resolve12([]));
+    proc.on("error", () => resolve13([]));
     proc.on("close", () => {
       const spans = [];
       for (const line of err.split("\n")) {
         const m = line.match(/black_start:\s*([\d.]+)\s+black_end:\s*([\d.]+)/);
         if (m?.[1] && m[2]) spans.push({ start: Number.parseFloat(m[1]), end: Number.parseFloat(m[2]) });
       }
-      resolve12(spans);
+      resolve13(spans);
     });
   });
 }
@@ -2099,7 +2172,7 @@ async function cutSpansFromVideo(inputPath, outputPath, spans, preset) {
   const drop = keep.map((s) => `between(t,${s.start.toFixed(3)},${s.end.toFixed(3)})`).join("+");
   const filter = `[0:v]select='not(${drop})',setpts=N/FRAME_RATE/TB[outv]`;
   const enc = await passEncoder(preset);
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffmpeg", [
       "-y",
       ...filterThreadArgs(),
@@ -2117,8 +2190,8 @@ async function cutSpansFromVideo(inputPath, outputPath, spans, preset) {
       outputPath
     ]);
     proc.stderr.resume();
-    proc.on("error", () => resolve12(false));
-    proc.on("close", (code) => resolve12(code === 0));
+    proc.on("error", () => resolve13(false));
+    proc.on("close", (code) => resolve13(code === 0));
   });
 }
 function buildRetimeFilter(spans, stepBounds, speed, fps) {
@@ -2200,7 +2273,7 @@ async function retimeSpansInVideo(inputPath, outputPath, spans, stepBounds, spee
   const filter = buildRetimeFilter(spans, stepBounds, speed, fps);
   if (!filter) return false;
   const enc = await passEncoder(preset);
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffmpeg", [
       "-y",
       ...filterThreadArgs(),
@@ -2218,8 +2291,8 @@ async function retimeSpansInVideo(inputPath, outputPath, spans, stepBounds, spee
       outputPath
     ]);
     proc.stderr.resume();
-    proc.on("error", () => resolve12(false));
-    proc.on("close", (code) => resolve12(code === 0));
+    proc.on("error", () => resolve13(false));
+    proc.on("close", (code) => resolve13(code === 0));
   });
 }
 async function compressSilentSpans(inputPath, outputPath, totalSecs, maxSecs, preset, protectAfterSecs, narrationPath, protectBeforeSecs, leadSpans, keepSpans) {
@@ -2245,7 +2318,7 @@ async function compressSilentSpans(inputPath, outputPath, totalSecs, maxSecs, pr
   const filter = buildCompressionFilter(spans, totalSecs, maxSecs, protectAfterSecs, protectBeforeSecs);
   if (!filter) return false;
   const enc = await passEncoder(preset);
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffmpeg", [
       "-y",
       ...filterThreadArgs(),
@@ -2271,8 +2344,8 @@ async function compressSilentSpans(inputPath, outputPath, totalSecs, maxSecs, pr
       outputPath
     ]);
     proc.stderr.resume();
-    proc.on("error", () => resolve12(false));
-    proc.on("close", (code) => resolve12(code === 0));
+    proc.on("error", () => resolve13(false));
+    proc.on("close", (code) => resolve13(code === 0));
   });
 }
 async function speedUpMiddle(inputPath, outputPath, totalSecs, targetSecs, introSecs, outroSecs, maxFactor, preset) {
@@ -2296,7 +2369,7 @@ async function speedUpMiddle(inputPath, outputPath, totalSecs, targetSecs, intro
     "[v0][a0][v1][a1][v2][a2]concat=n=3:v=1:a=1[outv][outa]"
   ].join(";");
   const enc = await passEncoder(preset);
-  const ok = await new Promise((resolve12) => {
+  const ok = await new Promise((resolve13) => {
     const proc = spawnFFmpeg("ffmpeg", [
       "-y",
       ...filterThreadArgs(),
@@ -2317,8 +2390,8 @@ async function speedUpMiddle(inputPath, outputPath, totalSecs, targetSecs, intro
       outputPath
     ]);
     proc.stderr.resume();
-    proc.on("error", () => resolve12(false));
-    proc.on("close", (code) => resolve12(code === 0));
+    proc.on("error", () => resolve13(false));
+    proc.on("close", (code) => resolve13(code === 0));
   });
   return { ok, factor, reachedTarget: needed <= maxFactor };
 }
@@ -2354,7 +2427,7 @@ async function spliceVideos(opts) {
   const audioPresent = await Promise.all(
     overlays.map((o) => o.still ? Promise.resolve(false) : hasAudioStream(o.path))
   );
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const args = ["-y", "-i", inputPath];
     for (const overlay of overlays) {
       if (overlay.still) {
@@ -2417,7 +2490,7 @@ async function spliceVideos(opts) {
     args.push("-c:v", "libx264", "-preset", preset, "-crf", "18", "-pix_fmt", "yuv420p");
     if (clipAudio.length > 0) args.push("-c:a", "aac");
     args.push(outputPath);
-    runFFmpeg(args, "ffmpeg splice failed").then(resolve12, reject);
+    runFFmpeg(args, "ffmpeg splice failed").then(resolve13, reject);
   });
 }
 var CLIP_AUDIO_GAIN, STILL_FRAMERATE, COVER_WASH_W, COVER_WASH_H, COVER_BLUR_SIGMA;
@@ -2453,10 +2526,10 @@ function buildStepTransitions(steps, stepDurations, defaultTransition) {
   return transitions;
 }
 function applyTransitions(opts) {
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const { inputVideo, outputVideo, transitions, videoDuration, preset = "fast" } = opts;
     if (transitions.length === 0) {
-      runFFmpeg(["-y", "-i", inputVideo, "-c", "copy", outputVideo], "FFmpeg copy failed").then(resolve12, reject);
+      runFFmpeg(["-y", "-i", inputVideo, "-c", "copy", outputVideo], "FFmpeg copy failed").then(resolve13, reject);
       return;
     }
     const sorted = [...transitions].sort((a, b) => a.timestamp - b.timestamp);
@@ -2504,7 +2577,7 @@ function applyTransitions(opts) {
       "yuv420p",
       outputVideo
     ];
-    runFFmpeg(args, "FFmpeg transitions failed").then(resolve12, reject);
+    runFFmpeg(args, "FFmpeg transitions failed").then(resolve13, reject);
   });
 }
 var init_transitions = __esm({
@@ -2977,6 +3050,9 @@ function renderHormoziAss(ctx) {
   return `${header2}${lines.join("\n")}
 `;
 }
+function looksLikeAddress(token) {
+  return /^(?:https?:\/\/)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z]{2,}(?:\/[^\s]*)?[.,!?]?$/i.test(token);
+}
 function renderShortsAss(ctx) {
   const { captions, width, height } = ctx;
   const font = resolveCaptionFont(captions.font === "Arial" ? "Arial Black" : captions.font);
@@ -2987,7 +3063,7 @@ function renderShortsAss(ctx) {
   const alignment = positionToAlignment(captions.position);
   const outline = Math.max(2, Math.round(fontSize / 22));
   const upper = true;
-  const caseOf = (t) => toCaptionCase(t, upper);
+  const caseOf = (t) => looksLikeAddress(t) ? t : toCaptionCase(t, upper);
   const maxChars = fittingMaxChars(width, fontSize, SIDE_MARGIN, captions.maxChars, upper);
   const header2 = `[Script Info]
 Title: QuickPeek Demo
@@ -3549,6 +3625,8 @@ asyncio.run(main())
     await writeFile3(tempScriptPath, pythonScript);
     const pythonCmd = isWindows ? `wsl python3 "${wslScriptPath}"` : `python3 "${wslScriptPath}"`;
     await execAsync(pythonCmd, { timeout: 3e4 });
+    const written = await stat(outputPath).catch(() => null);
+    if (!written?.size) throw new Error("edge-tts produced no audio");
     return await readWordsSidecar(outputPath);
   } finally {
     await unlink4(tempScriptPath).catch(() => {
@@ -3736,11 +3814,17 @@ function spellAcronyms(text) {
   );
 }
 function bindDomains(text) {
-  return text.replace(/\b([a-z0-9][a-z0-9-]*)\.([a-z]{2,24})\b/gi, "$1-dot-$2");
+  return text.replace(/\b([a-z0-9][a-z0-9._+-]*)@(?=[a-z0-9][a-z0-9-]*\.[a-z]{2,24}\b)/gi, "$1-at-").replace(
+    /\b([a-z0-9][a-z0-9-]*)\.([a-z]{2,24})\b/gi,
+    (_m, host, tld) => `${host}-dot-${SPOKEN_TLD[tld.toLowerCase()] ?? tld}`
+  );
 }
 function speakSymbols(text) {
   return text.replace(/\s*&\s*/g, " and ").replace(/[<>]/g, " ").replace(/\s{2,}/g, " ").trim();
 }
+function spokenForm(caption) {
+  return speakNumbers(spellAcronyms(toSpokenForm(bindDomains(speakSymbols(caption)))));
+}
 async function generateVoiceover(steps, config, workDir, outputDir, logError2, task2, info2) {
   resetVoiceEngine();
   const voice = resolveVoice2(config);
@@ -3787,7 +3871,7 @@ async function generateVoiceover(steps, config, workDir, outputDir, logError2, t
     }
     const audioPath = join9(audioDir, `step-${stepNum}.mp3`);
     try {
-      const spokenText = speakNumbers(spellAcronyms(toSpokenForm(bindDomains(speakSymbols(step.caption)))));
+      const spokenText = spokenForm(step.caption);
       const key = clipKey(spokenText, voice, ratePercent ?? "");
       const cacheDir = join9(outputDir, ".tts-clips");
       const cached = await reuseClip(cacheDir, key, audioPath);
@@ -3868,7 +3952,7 @@ async function generateVoiceover(steps, config, workDir, outputDir, logError2, t
   await saveVoiceoverMeta(outputDir, meta);
   return { voiceoverPath, stepAudio };
 }
-var TTS_POOL, ONES, TENS, SPELLED_OUT, LETTER_SOUNDS;
+var TTS_POOL, ONES, TENS, SPELLED_OUT, LETTER_SOUNDS, SPOKEN_TLD;
 var init_generate = __esm({
   "src/lib/tts/generate.ts"() {
     "use strict";
@@ -3933,6 +4017,9 @@ var init_generate = __esm({
       Y: "why",
       Z: "zed"
     };
+    SPOKEN_TLD = {
+      ai: "ay-eye"
+    };
   }
 });
 
@@ -3992,6 +4079,7 @@ __export(lib_exports, {
   NO_CLIP_OUTRO: () => NO_CLIP_OUTRO,
   PLAN_MAX_TOKENS: () => PLAN_MAX_TOKENS,
   RATE_FACTOR: () => RATE_FACTOR,
+  RELAY_BASE: () => RELAY_BASE,
   SERVER_BACKOFF_MS: () => SERVER_BACKOFF_MS,
   SIZE_PRESETS: () => SIZE_PRESETS,
   TRIM_EDGE_SILENCE: () => TRIM_EDGE_SILENCE,
@@ -4043,6 +4131,7 @@ __export(lib_exports, {
   getErrorMessage: () => getErrorMessage,
   getLanguageName: () => getLanguageName,
   getMediaDuration: () => getMediaDuration,
+  getOrRefreshRelayToken: () => getOrRefreshRelayToken,
   getStatus: () => getStatus,
   getStatusCached: () => getStatusCached,
   getTierByEmail: () => getTierByEmail,
@@ -4086,12 +4175,12 @@ __export(lib_exports, {
   runPooled: () => runPooled,
   salvageTruncatedJson: () => salvageTruncatedJson,
   shouldSkipLink: () => shouldSkipLink,
-  shouldWatermark: () => shouldWatermark,
   showPaywall: () => showPaywall,
   speakSymbols: () => speakSymbols,
   speedUpMiddle: () => speedUpMiddle,
   speedUpVideo: () => speedUpVideo,
   spliceVideos: () => spliceVideos,
+  spokenForm: () => spokenForm,
   spokenWordTimings: () => spokenWordTimings,
   stripLongDashes: () => stripLongDashes,
   synthesizeSpeech: () => synthesizeSpeech,
@@ -4401,7 +4490,10 @@ async function loadCaptions() {
 async function savePlan(plan, planPath) {
   const cleanPlan = {
     ...plan,
-    steps: plan.steps.map(({ duration, ...step }) => step)
+    steps: plan.steps.map(({ duration, ...step }) => ({
+      ...step,
+      ...typeof duration === "number" && duration > 0 ? { duration: Math.min(duration, 30) } : {}
+    }))
   };
   await mkdir4(dirname2(planPath), { recursive: true });
   await writeFile5(planPath, JSON.stringify(cleanPlan, null, 2));
@@ -4514,55 +4606,16 @@ var init_mcp_context = __esm({
   }
 });
 
-// src/lib/image-kind.ts
-function mimeForKind(kind) {
-  return MIME[kind];
-}
-function sniffImageKind(buf) {
-  if (buf.length < 12) return null;
-  if (buf[0] === 137 && buf[1] === 80 && buf[2] === 78 && buf[3] === 71) return "png";
-  if (buf[0] === 255 && buf[1] === 216 && buf[2] === 255) return "jpeg";
-  if (buf.subarray(0, 3).toString("latin1") === "GIF") return "gif";
-  if (buf.subarray(0, 4).toString("latin1") === "RIFF" && buf.subarray(8, 12).toString("latin1") === "WEBP") {
-    return "webp";
-  }
-  const head = buf.subarray(0, 1024).toString("utf8").replace(/^/, "").trimStart();
-  if (/^<(\?xml|!--|!doctype svg|svg)[\s>]/i.test(head) && /<svg[\s>]/i.test(head)) return "svg";
-  return null;
-}
-var MIME, MIN_ICON_PX;
-var init_image_kind = __esm({
-  "src/lib/image-kind.ts"() {
-    "use strict";
-    MIME = {
-      png: "image/png",
-      jpeg: "image/jpeg",
-      gif: "image/gif",
-      webp: "image/webp",
-      svg: "image/svg+xml"
-    };
-    MIN_ICON_PX = 48;
-  }
-});
-
 // src/lib/outro-card.ts
-import { readFileSync as readFileSync5 } from "fs";
-function dataUri(path) {
-  try {
-    const buf = readFileSync5(path);
-    const kind = sniffImageKind(buf);
-    if (!kind) return null;
-    return `data:${mimeForKind(kind)};base64,${buf.toString("base64")}`;
-  } catch {
-    return null;
-  }
-}
 function escapeHtml(text) {
   return text.replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
 }
 function buildOutroCardHtml(options) {
   const { subject, credits = [], promo, width, height } = options;
   const unit = Math.min(width, height);
+  const markFraction = width > height ? 0.28 : 0.46;
+  const markSize = unit * markFraction;
+  const padTop = width > height ? unit * 0.08 : unit * 0.23;
   const creditRows = credits.map((credit) => {
     const icon = credit.iconPath ? dataUri(credit.iconPath) : null;
     return `<div class="credit">
@@ -4571,7 +4624,8 @@ function buildOutroCardHtml(options) {
         ${icon ? `<img class="cicon" src="${icon}" alt="" />` : ""}
       </div>`;
   }).join("");
-  const subjectIcon = subject.iconPath ? dataUri(subject.iconPath) : null;
+  const animated = subject.animatedMark;
+  const subjectIcon = animated ? null : subject.iconPath ? dataUri(subject.iconPath) : null;
   return `<!doctype html>
 <html><head><meta charset="utf-8" /><style>
   * { box-sizing: border-box; margin: 0; padding: 0; }
@@ -4589,7 +4643,7 @@ function buildOutroCardHtml(options) {
     position: relative;
     display: flex; flex-direction: column;
     align-items: center; justify-content: flex-start;
-    padding-top: ${unit * 0.23}px;
+    padding-top: ${padTop}px;
     gap: ${unit * 0.028}px;
   }
   /* Toolchain credits: top right, deliberately small. */
@@ -4607,7 +4661,7 @@ function buildOutroCardHtml(options) {
   /* The app the video is about. */
   /* The app's mark leads the card, and it is meant to be seen: at 46% of
      the short edge it reads at a glance on a phone. */
-  .mark { width: ${unit * 0.46}px; height: ${unit * 0.46}px; object-fit: contain; border-radius: ${unit * 0.09}px; }
+  .mark { width: ${markSize}px; height: ${markSize}px; object-fit: contain; border-radius: ${unit * 0.09}px; }
   /* A dark mark on a dark card is invisible, which looks exactly like a
      failed image. Sites that publish a black-on-transparent logo are common
      enough to be worth catching, and a light plate is what their own site
@@ -4629,8 +4683,12 @@ function buildOutroCardHtml(options) {
   }
 
   /* Today's offer, along the very bottom edge. */
+  /* In the flow, not pinned to the bottom edge. Pinned, it was laid out
+     without reference to the text above it, so on a short canvas it simply
+     covered whatever had grown into its space. margin-top pushes it clear of
+     the domain instead. */
   .promo {
-    position: absolute; bottom: ${unit * 0.2}px;
+    margin-top: ${unit * 0.05}px;
     display: flex; align-items: baseline; gap: ${unit * 0.022}px;
     padding: ${unit * 0.026}px ${unit * 0.055}px;
     border: 2px solid rgba(255, 209, 64, .85); border-radius: ${unit * 0.024}px;
@@ -4638,9 +4696,60 @@ function buildOutroCardHtml(options) {
   }
   .ppct { font-size: ${unit * 0.056}px; font-weight: 700; color: #ffd140; }
   .pcode { font-size: ${unit * 0.048}px; font-weight: 700; letter-spacing: .05em; }
+
+  /* The animated mark, sized to the same 46% slot the still one occupies so
+     the rest of the card's rhythm is unchanged. Ported from VidLet's
+     src/gui/css/loader.css: the amber tip flies off and snaps back into the
+     cut - a jump cut, on a loop. Pure CSS, because the renderer steps these
+     animations frame by frame and a JS-driven one could not be stepped.
+
+     No prefers-reduced-motion fallback here, unlike the original: this runs
+     in a headless Chromium rendering a video, where there is no viewer whose
+     preference could be read, and honouring the default would silently flatten
+     the animation to a fade in CI. */
+  .amark { width: ${markSize}px; height: ${markSize}px; display: block; }
+  .amark path {
+    /* Without fill-box the origin is the whole SVG viewport, which swings the
+       tip off its own centre on the scale steps. */
+    transform-box: fill-box;
+    transform-origin: center;
+  }
+  .amark .vl-body { fill: #fff6e5; stroke: #fff6e5; animation: vl-nudge 1.4s cubic-bezier(.4,0,.2,1) infinite; }
+  .amark .vl-tip { fill: #ffc53d; stroke: #ffc53d; animation: vl-cut 1.4s cubic-bezier(.4,0,.2,1) infinite; }
+  .amark .vl-ghost { opacity: .35; }
+  .amark .vl-ghost .vl-tip { animation-delay: -.1s; }
+
+  /* Translations are in viewBox units, so the motion scales with the mark. */
+  @keyframes vl-cut {
+    0%, 30%  { transform: translateX(0) scale(1);       opacity: 1; }
+    48%      { transform: translateX(62px) scale(.94);  opacity: 1; }
+    60%      { transform: translateX(88px) scale(.86);  opacity: 0; }
+    61%, 74% { transform: translateX(-58px) scale(.86); opacity: 0; }
+    86%      { transform: translateX(6px) scale(1.06);  opacity: 1; }
+    100%     { transform: translateX(0) scale(1);       opacity: 1; }
+  }
+  /* The body takes the recoil, so the cut lands rather than just sliding. */
+  @keyframes vl-nudge {
+    0%, 30% { transform: scaleX(1); }
+    55%     { transform: scaleX(1.04); }
+    86%     { transform: scaleX(.97); }
+    100%    { transform: scaleX(1); }
+  }
+  ${/* The card normally reads its palette off the mark's pixels, and an SVG
+     drawn by this stylesheet has none to read - the measuring script finds
+     no <img class="mark"> and leaves the defaults, which would put VidLet's
+     amber on a teal card. Stated instead of measured, last so it wins. */
+  animated === "vidlet" ? ":root { --bg-in: #1f1a10; --bg-out: #07060a; --accent: #ffc53d; }" : ""}
 </style></head>
 <body>
   ${credits.length ? `<div class="credits">${creditRows}</div>` : ""}
+  ${animated === "vidlet" ? `<svg class="amark" viewBox="0 0 512 512" aria-hidden="true">
+           <g stroke-linejoin="round" stroke-width="20">
+             <g class="vl-ghost"><path class="vl-tip" d="M318 246 L410 302 L318 358 Z"/></g>
+             <path class="vl-body" d="M176 124 L300 200 L300 312 L176 388 Z"/>
+             <path class="vl-tip" d="M318 246 L410 302 L318 358 Z"/>
+           </g>
+         </svg>` : ""}
   ${subjectIcon ? `<img class="mark" src="${subjectIcon}" alt="" />` : ""}
   <div class="name">${escapeHtml(subject.name)}</div>
   ${subject.tagline ? `<div class="tagline">${escapeHtml(subject.tagline)}</div>` : ""}
@@ -4743,10 +4852,18 @@ function buildOutroCardHtml(options) {
 </script>
 </body></html>`;
 }
+var ANIMATED_MARK_LOOP_SECONDS, dataUri;
 var init_outro_card = __esm({
   "src/lib/outro-card.ts"() {
     "use strict";
     init_image_kind();
+    ANIMATED_MARK_LOOP_SECONDS = {
+      // Matches `vl-cut` / `vl-nudge` in VidLet's src/gui/css/loader.css. Changing
+      // it there without changing it here makes the encoded loop stutter at the
+      // seam, because the clip is cut to exactly this length and then repeated.
+      vidlet: 1.4
+    };
+    dataUri = imageDataUri;
   }
 });
 
@@ -4756,8 +4873,8 @@ __export(render_outro_exports, {
   renderOutroClip: () => renderOutroClip,
   renderOutroPng: () => renderOutroPng
 });
-import { writeFile as writeFile8 } from "fs/promises";
-import { join as join15, resolve as resolve5 } from "path";
+import { mkdir as mkdir7, rm as rm2, writeFile as writeFile8 } from "fs/promises";
+import { join as join15, resolve as resolve6 } from "path";
 import { pathToFileURL as pathToFileURL2 } from "url";
 import { chromium as chromium6 } from "playwright";
 async function renderOutroPng(options) {
@@ -4768,7 +4885,7 @@ async function renderOutroPng(options) {
   const browser = await chromium6.launch({ headless: true });
   try {
     const page = await browser.newPage({ viewport: { width, height } });
-    await page.goto(pathToFileURL2(resolve5(htmlPath)).href, { waitUntil: "load" });
+    await page.goto(pathToFileURL2(resolve6(htmlPath)).href, { waitUntil: "load" });
     await page.waitForSelector('body[data-cards-ready="1"]', { timeout: 3e3 }).catch(() => page.waitForTimeout(300));
     await page.screenshot({ path: pngPath });
   } finally {
@@ -4781,11 +4898,14 @@ async function renderOutroClip(options) {
   const htmlPath = join15(workDir, "outro-card.html");
   const pngPath = join15(workDir, "outro-card.png");
   const clipPath = join15(workDir, "outro-card.mp4");
+  if (options.subject.animatedMark) {
+    return renderAnimatedOutroClip(options, { htmlPath, clipPath, seconds, fps });
+  }
   await writeFile8(htmlPath, buildOutroCardHtml(options));
   const browser = await chromium6.launch({ headless: true });
   try {
     const page = await browser.newPage({ viewport: { width, height } });
-    await page.goto(pathToFileURL2(resolve5(htmlPath)).href, { waitUntil: "load" });
+    await page.goto(pathToFileURL2(resolve6(htmlPath)).href, { waitUntil: "load" });
     await page.waitForSelector('body[data-cards-ready="1"]', { timeout: 3e3 }).catch(() => {
     });
     await page.waitForTimeout(300);
@@ -4823,6 +4943,70 @@ async function renderOutroClip(options) {
   );
   return clipPath;
 }
+async function renderAnimatedOutroClip(options, paths) {
+  const { htmlPath, clipPath, seconds, fps } = paths;
+  const { workDir, width, height } = options;
+  const loopSeconds = ANIMATED_MARK_LOOP_SECONDS[options.subject.animatedMark];
+  const frameCount = Math.max(1, Math.round(loopSeconds * fps));
+  const framesDir = join15(workDir, "outro-frames");
+  await rm2(framesDir, { recursive: true, force: true });
+  await mkdir7(framesDir, { recursive: true });
+  await writeFile8(htmlPath, buildOutroCardHtml(options));
+  const browser = await chromium6.launch({ headless: true });
+  try {
+    const page = await browser.newPage({ viewport: { width, height } });
+    await page.goto(pathToFileURL2(resolve6(htmlPath)).href, { waitUntil: "load" });
+    await page.waitForSelector('body[data-cards-ready="1"]', { timeout: 3e3 }).catch(() => {
+    });
+    await page.waitForTimeout(300);
+    await page.evaluate(() => {
+      for (const animation of document.getAnimations()) animation.pause();
+    });
+    for (let frame = 0; frame < frameCount; frame++) {
+      const elapsedMs = frame / frameCount * loopSeconds * 1e3;
+      await page.evaluate((ms) => {
+        for (const animation of document.getAnimations()) animation.currentTime = ms;
+      }, elapsedMs);
+      await page.screenshot({ path: join15(framesDir, `f-${String(frame).padStart(4, "0")}.png`) });
+    }
+  } finally {
+    await browser.close();
+  }
+  await runFFmpeg(
+    [
+      "-y",
+      // -stream_loop applies to the input that FOLLOWS it, so it has to sit
+      // before -framerate/-i, not after.
+      "-stream_loop",
+      "-1",
+      "-framerate",
+      String(fps),
+      "-i",
+      join15(framesDir, "f-%04d.png"),
+      "-f",
+      "lavfi",
+      "-i",
+      "anullsrc=channel_layout=stereo:sample_rate=44100",
+      "-t",
+      String(seconds),
+      "-r",
+      String(fps),
+      "-pix_fmt",
+      "yuv420p",
+      "-c:v",
+      "libx264",
+      "-preset",
+      "veryfast",
+      "-c:a",
+      "aac",
+      "-shortest",
+      clipPath
+    ],
+    "ffmpeg animated outro card render failed"
+  );
+  await rm2(framesDir, { recursive: true, force: true });
+  return clipPath;
+}
 var init_render_outro = __esm({
   "src/browser/render-outro.ts"() {
     "use strict";
@@ -4890,11 +5074,11 @@ __export(external_clips_exports, {
   findStepClips: () => findStepClips,
   loadExternalNarration: () => loadExternalNarration
 });
-import { existsSync as existsSync21, mkdirSync as mkdirSync2, readdirSync as readdirSync4, rmSync as rmSync3 } from "fs";
+import { existsSync as existsSync22, mkdirSync as mkdirSync2, readdirSync as readdirSync4, rmSync as rmSync3 } from "fs";
 import { join as join27 } from "path";
 function findStepClips(dir) {
   const clips = /* @__PURE__ */ new Map();
-  if (!existsSync21(dir)) return clips;
+  if (!existsSync22(dir)) return clips;
   for (const name of readdirSync4(dir)) {
     const match = /^step-0*(\d+)\.(wav|mp3|m4a|flac|ogg)$/i.exec(name);
     if (match?.[1]) clips.set(Number(match[1]), join27(dir, name));
@@ -5147,8 +5331,8 @@ async function fileResult(output, data, poster) {
 }
 
 // src/mcp/tools.ts
-import { existsSync as existsSync26, mkdirSync as mkdirSync3, readdirSync as readdirSync6, readFileSync as readFileSync10, statSync as statSync4 } from "fs";
-import { basename as basename5, join as join33, resolve as resolve11 } from "path";
+import { existsSync as existsSync27, mkdirSync as mkdirSync3, readdirSync as readdirSync6, readFileSync as readFileSync10, statSync as statSync4 } from "fs";
+import { basename as basename5, dirname as dirname5, join as join33, resolve as resolve12 } from "path";
 import { MALE_VOICES as MALE_VOICES3, WIDE_VOICES as WIDE_VOICES3 } from "@spark-apps/video-kit";
 
 // src/browser/auth-state.ts
@@ -5263,9 +5447,100 @@ init_lifecycle();
 import { mkdir as mkdir2 } from "fs/promises";
 import { chromium as chromium2 } from "playwright";
 
+// src/browser/brand-watermark.ts
+init_image_kind();
+function watermarkInitScript(payload) {
+  return `(() => {
+  var ID = '__quickpeek_brand_watermark';
+  var P = ${embedJson(payload)};
+  var vertical = P.position.indexOf('top') === 0 ? 'top:22px' : 'bottom:22px';
+  var horizontal = P.position.indexOf('right') > -1 ? 'right:24px' : 'left:24px';
+  var SHELL = [
+    'position:fixed',
+    vertical,
+    horizontal,
+    'z-index:2147483646',
+    'display:flex',
+    'align-items:center',
+    'gap:10px',
+    'padding:8px 16px 8px 10px',
+    'border-radius:999px',
+    // A hairline and a blur rather than a solid plate: the mark sits on top of
+    // whatever the app is showing, and a hard box reads as part of the UI.
+    // The alpha is high enough to stay dark over a LIGHT app: at 0.55 the blur
+    // averaged a pale page up into grey and the white label sat on it at about
+    // 2:1, which photographs as a smudge.
+    'background:rgba(12,12,18,0.78)',
+    'border:1px solid rgba(255,255,255,0.14)',
+    'backdrop-filter:blur(14px) saturate(1.3)',
+    '-webkit-backdrop-filter:blur(14px) saturate(1.3)',
+    'box-shadow:0 6px 24px rgba(0,0,0,0.30)',
+    'opacity:' + P.opacity,
+    'pointer-events:none',
+    'user-select:none'
+  ].join(';');
+  var ICON = 'width:26px;height:26px;border-radius:7px;object-fit:contain;display:block';
+  var NAME = [
+    'font:600 15px/1 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,sans-serif',
+    'letter-spacing:0.015em',
+    'color:#ffffff',
+    'white-space:nowrap'
+  ].join(';');
+
+  function mount() {
+    try {
+      if (!document.body || document.getElementById(ID)) return;
+      var el = document.createElement('div');
+      el.id = ID;
+      el.setAttribute('style', SHELL);
+      if (P.icon) {
+        var img = document.createElement('img');
+        img.setAttribute('style', ICON);
+        img.src = P.icon;
+        img.alt = '';
+        el.appendChild(img);
+      }
+      var label = document.createElement('span');
+      label.setAttribute('style', NAME);
+      label.textContent = P.name;
+      el.appendChild(label);
+      document.body.appendChild(el);
+    } catch (e) {
+      // A page that refuses the node still records; the mark is cosmetic.
+    }
+  }
+
+  if (document.body) mount();
+  else document.addEventListener('DOMContentLoaded', mount, { once: true });
+  setInterval(mount, 400);
+})();`;
+}
+async function applyBrandWatermark(context, watermark) {
+  if (!watermark?.name) return false;
+  const payload = {
+    name: watermark.name,
+    icon: watermark.iconPath ? imageDataUri(watermark.iconPath) : null,
+    position: watermark.position ?? "top-right",
+    opacity: clampOpacity(watermark.opacity)
+  };
+  try {
+    await context.addInitScript(watermarkInitScript(payload));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function embedJson(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+function clampOpacity(value) {
+  if (typeof value !== "number" || !Number.isFinite(value)) return 0.92;
+  return Math.min(1, Math.max(0.35, value));
+}
+
 // src/browser/wsl.ts
 import { execSync, spawn as spawn2 } from "child_process";
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync4 } from "fs";
 import { request } from "http";
 import { chromium } from "playwright";
 function isWSL() {
@@ -5310,7 +5585,7 @@ function getWindowsHostIP() {
   } catch {
   }
   try {
-    const m = readFileSync3("/etc/resolv.conf", "utf-8").match(/nameserver\s+(\d+\.\d+\.\d+\.\d+)/);
+    const m = readFileSync4("/etc/resolv.conf", "utf-8").match(/nameserver\s+(\d+\.\d+\.\d+\.\d+)/);
     if (m?.[1]) return m[1];
   } catch {
   }
@@ -5318,7 +5593,7 @@ function getWindowsHostIP() {
 }
 function startRelay(nodePath, windowsHost, targetPort) {
   const script = `var n=require('net'),s=n.createServer(function(c){var r=n.createConnection(${targetPort},'127.0.0.1');c.pipe(r);r.pipe(c);r.on('error',function(){c.destroy()});c.on('error',function(){r.destroy()});});s.listen(0,'${windowsHost}',function(){process.stdout.write('PORT:'+s.address().port+'\\n')});`;
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const proc = spawn2(nodePath, ["-e", script], { stdio: ["ignore", "pipe", "ignore"], detached: true });
     const timer = setTimeout(() => reject(new Error("relay startup timed out")), 6e3);
     let buf = "";
@@ -5327,7 +5602,7 @@ function startRelay(nodePath, windowsHost, targetPort) {
       const m = buf.match(/PORT:(\d+)/);
       if (m) {
         clearTimeout(timer);
-        resolve12({ proc, port: +m[1] });
+        resolve13({ proc, port: +m[1] });
       }
     });
     proc.on("error", (e) => {
@@ -5337,7 +5612,7 @@ function startRelay(nodePath, windowsHost, targetPort) {
   });
 }
 function waitForChrome(host, port) {
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const deadline = Date.now() + 2e4;
     const poll = () => {
       if (Date.now() > deadline) {
@@ -5346,7 +5621,7 @@ function waitForChrome(host, port) {
       }
       const req = request({ host, port, path: "/json/version", method: "GET" }, (res) => {
         res.resume();
-        resolve12();
+        resolve13();
       });
       req.on("error", () => setTimeout(poll, 600));
       req.setTimeout(1e3, () => {
@@ -5489,6 +5764,7 @@ async function launchBrowserContext(config, userDataDir, recordVideo, storageSta
     });
   }
   await hideDevOverlays(context);
+  await applyBrandWatermark(context, config.video.watermark);
   const session = { context, browser, chromeSession };
   session.release = onCleanup(() => closeBrowserSession(session));
   return session;
@@ -5716,7 +5992,7 @@ async function importBrowserSession(url) {
 }
 
 // src/commands/edit-cmd.ts
-import { existsSync as existsSync9, readdirSync, readFileSync as readFileSync4 } from "fs";
+import { existsSync as existsSync10, readdirSync, readFileSync as readFileSync5 } from "fs";
 import { join as join14 } from "path";
 import chalk7 from "chalk";
 
@@ -5791,8 +6067,8 @@ function editorBaseUrl() {
 function openInBrowser(url) {
   const isWSL2 = process.platform === "linux" && Boolean(process.env.WSL_DISTRO_NAME);
   const command = isWSL2 ? `cmd.exe /c start "" "${url}"` : process.platform === "darwin" ? `open "${url}"` : `xdg-open "${url}"`;
-  return new Promise((resolve12) => {
-    exec2(command, () => resolve12());
+  return new Promise((resolve13) => {
+    exec2(command, () => resolve13());
   });
 }
 
@@ -5951,8 +6227,72 @@ function planEditorUrl(baseUrl, plan) {
   return url.length <= MAX_HANDOFF_URL_CHARS ? url : null;
 }
 
+// src/lib/plan-thumbs.ts
+init_spawn();
+import { existsSync as existsSync9 } from "fs";
+import { isAbsolute as isAbsolute2, resolve as resolve4 } from "path";
+var MEDIA_ACTIONS = ["image", "media", "video"];
+var THUMB_WIDTH = 160;
+var MAX_THUMB_CHARS = 1e4;
+var MAX_TOTAL_THUMB_CHARS = 16e3;
+var THUMB_TIMEOUT_MS = 3e3;
+function thumbnail(path) {
+  return new Promise((done) => {
+    const proc = spawnFFmpeg("ffmpeg", [
+      "-v",
+      "error",
+      "-i",
+      path,
+      "-frames:v",
+      "1",
+      "-vf",
+      `scale=${THUMB_WIDTH}:-2`,
+      "-q:v",
+      "14",
+      "-f",
+      "mjpeg",
+      "-"
+    ]);
+    const chunks = [];
+    const timer = setTimeout(() => {
+      proc.kill();
+      done(null);
+    }, THUMB_TIMEOUT_MS);
+    const finish = (result) => {
+      clearTimeout(timer);
+      done(result);
+    };
+    proc.stdout.on("data", (chunk) => chunks.push(chunk));
+    proc.on("error", () => finish(null));
+    proc.on("close", (code) => {
+      const bytes = Buffer.concat(chunks);
+      if (code !== 0 || bytes.length === 0) return finish(null);
+      const base64 = bytes.toString("base64");
+      finish(base64.length > MAX_THUMB_CHARS ? null : `data:image/jpeg;base64,${base64}`);
+    });
+  });
+}
+async function withEditorThumbs(plan, baseDir) {
+  const steps = [...plan.steps];
+  let budget = MAX_TOTAL_THUMB_CHARS;
+  for (const [index, step] of steps.entries()) {
+    if (!step.value || !MEDIA_ACTIONS.includes(step.action)) continue;
+    const path = isAbsolute2(step.value) ? step.value : resolve4(baseDir, step.value);
+    if (!existsSync9(path)) continue;
+    const thumb = await thumbnail(path);
+    if (!thumb || thumb.length > budget) continue;
+    budget -= thumb.length;
+    steps[index] = { ...step, thumb };
+  }
+  return { ...plan, steps };
+}
+async function editorUrlWithThumbs(baseUrl, plan, baseDir) {
+  const withThumbs = await withEditorThumbs(plan, baseDir);
+  return planEditorUrl(baseUrl, withThumbs) ?? planEditorUrl(baseUrl, plan);
+}
+
 // src/utils/ui.ts
-import { resolve as resolve4 } from "path";
+import { resolve as resolve5 } from "path";
 import { createInterface } from "readline";
 import chalk2 from "chalk";
 import ora from "ora";
@@ -6019,7 +6359,7 @@ function waitForEnter(prompt2 = `${INDENT}Press Enter when done...`) {
       )
     );
   }
-  return new Promise((resolve12, reject) => {
+  return new Promise((resolve13, reject) => {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
     let done = false;
     rl.on("close", () => {
@@ -6030,13 +6370,13 @@ function waitForEnter(prompt2 = `${INDENT}Press Enter when done...`) {
     rl.question(prompt2, () => {
       done = true;
       rl.close();
-      resolve12();
+      resolve13();
     });
   });
 }
 var _isWSL = process.platform === "linux" && process.env.WSL_DISTRO_NAME;
 function formatClickablePath(filePath) {
-  const absolutePath = resolve4(filePath);
+  const absolutePath = resolve5(filePath);
   if (_isWSL || process.platform !== "win32") {
     return absolutePath;
   }
@@ -6077,13 +6417,13 @@ import chalk3 from "chalk";
 init_SparkStripe_feature_gating();
 var TIMEOUT_MS = 12e4;
 async function browserLogin() {
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     let server;
     let timer;
     const cleanup = (email) => {
       clearTimeout(timer);
       server?.close();
-      resolve12(email);
+      resolve13(email);
     };
     server = createServer((req, res) => {
       const url = new URL2(req.url || "/", `http://localhost`);
@@ -6234,10 +6574,10 @@ function getLastRateLimitInfo() {
 }
 function prompt(question) {
   const rl = createInterface2({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve12) => {
+  return new Promise((resolve13) => {
     rl.question(question, (answer) => {
       rl.close();
-      resolve12(answer.trim());
+      resolve13(answer.trim());
     });
   });
 }
@@ -6246,8 +6586,10 @@ async function setupUserEmail() {
   console.log(chalk4.yellow("  \u2709 Account Setup"));
   console.log(chalk4.dim("  \u2500".repeat(20)));
   console.log();
-  console.log(chalk4.white("  Sign in with your Google account to track usage"));
-  console.log(chalk4.white("  and unlock Pro features."));
+  console.log(chalk4.white("  The AI that plans your demo runs on our servers, so it"));
+  console.log(chalk4.white("  needs an address to meter. No card, and no verification"));
+  console.log(chalk4.white("  needed for your first 5 videos."));
+  console.log(chalk4.dim("  After that, signing in gets you 10 videos a day."));
   const browserEmail = await browserLogin();
   if (browserEmail) {
     console.log();
@@ -6256,11 +6598,15 @@ async function setupUserEmail() {
     return browserEmail;
   }
   console.log();
-  console.log(chalk4.dim("  Or enter your email manually:"));
+  console.log(chalk4.dim("  Or enter your email (Enter to skip):"));
   const email = await prompt(chalk4.white("  Email: "));
   if (!email) {
     console.log();
-    console.log(chalk4.red("  No email provided. Exiting."));
+    console.log(chalk4.yellow("  No email given, so the AI planner cannot be reached."));
+    console.log(chalk4.dim("  Nothing has been recorded. Run qp again when you are ready."));
+    console.log(chalk4.dim("  To record with no account at all, use the MCP server:"));
+    console.log(chalk4.dim("    https://quickpeek.co/mcp"));
+    console.log();
     process.exit(1);
   }
   if (!email.includes("@") || !email.includes(".")) {
@@ -6268,6 +6614,9 @@ async function setupUserEmail() {
     console.log(chalk4.yellow("  \u26A0 That doesn't look like a valid email address."));
     const proceed = await prompt(chalk4.white("  Continue anyway? ") + chalk4.dim("[y/N] "));
     if (proceed.toLowerCase() !== "y") {
+      console.log();
+      console.log(chalk4.dim("  Nothing has been recorded. Run qp again when you are ready."));
+      console.log();
       process.exit(1);
     }
   }
@@ -6394,6 +6743,17 @@ async function parseAIJsonWithRepair(content, opts) {
 init_mcp_context();
 init_lib();
 init_json_repair();
+var WRITTEN_ADDRESS = /\b(?:https?:\/\/)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z]{2,}(?:\/[^\s]*)?/gi;
+var SPELLED_OUT_ACRONYM = /\b[A-Z](?:\s+[A-Z])+\b/g;
+function spokenCaption(caption) {
+  const held = [];
+  const masked = caption.replace(SPELLED_OUT_ACRONYM, (run2) => run2.replace(/\s+/g, "")).replace(WRITTEN_ADDRESS, (address) => {
+    held.push(address);
+    return `qpaddr${held.length - 1}qp`;
+  });
+  const shaped = toTitleCase(toSpokenForm2(masked));
+  return shaped.replace(/qpaddr(\d+)qp/gi, (_match, index) => held[Number(index)] ?? "");
+}
 async function crawlExtension(url, extensionPath, workDir, task2) {
   const browserTask = task2("Launching browser with extension");
   const userDataDir = join12(workDir, ".browser-data");
@@ -6522,8 +6882,18 @@ async function crawlAndAnalyze(url, lang, description, maxSteps, task2, logError
       // The spoken form is what the voice will actually say, so it is what
       // the caption shows: burning the written form instead left the words on
       // screen out of step with the words in the ear wherever the two differ
-      // (a domain read with its dot, a number read as words).
-      caption: s.caption ? toTitleCase(toSpokenForm2(s.caption)) : s.caption
+      // (a number read as words).
+      //
+      // Addresses are the exception. Expanding one here turned "quickpeek.co"
+      // into three caption words, "Quickpeek Dot Co", which the line packer
+      // is then free to break across lines: the call to action arrived on
+      // screen as "DOT C O" with the name on the row above. An address is the
+      // one thing in a demo a viewer has to be able to read and type, so it
+      // is held back verbatim from both passes and rejoins as written. The
+      // voice is unaffected: generate.ts derives its own spoken form from
+      // this caption at synthesis time, and word timings fall back to an even
+      // spread across the speech envelope when the counts no longer line up.
+      caption: s.caption ? spokenCaption(s.caption) : s.caption
     }));
     aiTask.succeed(`Plan: ${plan.steps.length} steps`);
     return plan;
@@ -6701,9 +7071,9 @@ var PLAN_FILE = /^plan-([a-z]{2}(?:-[A-Z]{2})?)\.json$/;
 function findPlanFile(dir, lang) {
   if (lang) {
     const exact = join14(dir, `plan-${lang}.json`);
-    return existsSync9(exact) ? exact : null;
+    return existsSync10(exact) ? exact : null;
   }
-  if (!existsSync9(dir)) return null;
+  if (!existsSync10(dir)) return null;
   const plans = readdirSync(dir).filter((f) => PLAN_FILE.test(f));
   const preferred = plans.find((f) => f === "plan-en.json") ?? plans[0];
   return preferred ? join14(dir, preferred) : null;
@@ -6711,10 +7081,35 @@ function findPlanFile(dir, lang) {
 
 // src/commands/record-cmd.ts
 init_mcp_context();
-import { existsSync as existsSync25 } from "fs";
-import { mkdir as mkdir9, readFile as readFile12 } from "fs/promises";
-import { basename as basename4, isAbsolute as isAbsolute6, join as join31, resolve as resolve10 } from "path";
+import { existsSync as existsSync26 } from "fs";
+import { mkdir as mkdir10, readFile as readFile12 } from "fs/promises";
+import { basename as basename4, isAbsolute as isAbsolute7, join as join31, resolve as resolve11 } from "path";
 import chalk17 from "chalk";
+
+// src/lib/demo-registry.ts
+init_api_client();
+var TIMEOUT_MS2 = 4e3;
+async function registerDemoRun(email, run2) {
+  if (!email || email === "anonymous") return false;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), TIMEOUT_MS2);
+  try {
+    const token = await getOrRefreshRelayToken(email);
+    const response = await fetch(`${RELAY_BASE}/api/cli/demos`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+      body: JSON.stringify(run2),
+      signal: controller.signal
+    });
+    return response.ok;
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// src/commands/record-cmd.ts
 init_lib();
 init_config_loader();
 init_run_root();
@@ -6734,7 +7129,7 @@ async function handleRegistrationGate() {
   console.log(chalk8.white("     Sign in to continue creating videos."));
   console.log();
   console.log(chalk8.dim("  Benefits of signing in:"));
-  console.log(chalk8.dim("    \u2022 20 more videos per month"));
+  console.log(chalk8.dim("    \u2022 10 videos a day instead of 5 in total"));
   console.log(chalk8.dim("    \u2022 Keep your video history"));
   console.log(chalk8.dim("    \u2022 Upgrade to Pro anytime"));
   let email = await browserLogin();
@@ -6785,9 +7180,12 @@ async function runAuthPhase(input) {
   const { isVerified: isVerified2 } = input;
   const mcpTool = currentMcpTool();
   if (mcpTool && !(userEmail && isVerified2)) {
-    throw new Error(
-      `"${mcpTool}" needs a verified QuickPeek account and this machine has none saved${userEmail ? ` (${userEmail} is registered but unverified)` : ""}. Sign in once from a terminal with \`qp login\` \u2014 it is a browser flow and cannot run inside an MCP call \u2014 then retry. Use check_account to confirm.`
-    );
+    if (localVideoCount >= FREE_VIDEO_LIMIT) {
+      throw new Error(
+        `"${mcpTool}" has used all ${FREE_VIDEO_LIMIT} free videos on this machine and needs a verified QuickPeek account to continue${userEmail ? ` (${userEmail} is registered but unverified)` : ""}. Sign in once from a terminal with \`qp login\`, a browser flow that cannot run inside an MCP call, then retry. Use check_account to confirm.`
+      );
+    }
+    return { userEmail: "anonymous", userTier: "free", localVideoCount, isVerified: false };
   }
   if (userEmail && isVerified2) {
     const tierTask = task("Checking subscription");
@@ -6878,7 +7276,7 @@ async function runAuthPhase(input) {
     const remaining2 = FREE_VIDEO_LIMIT - localVideoCount;
     console.log();
     console.log(chalk9.cyan(`  \u{1F3AC} Video ${localVideoCount + 1}/${FREE_VIDEO_LIMIT} free`));
-    console.log(chalk9.dim(`     ${remaining2 - 1} more after this \u2022 Sign up for unlimited`));
+    console.log(chalk9.dim(`     ${remaining2 - 1} more after this \u2022 Sign up for 10 a day`));
     userEmail = await setupUserEmail();
     let registeredVerified = false;
     try {
@@ -6897,7 +7295,7 @@ async function runAuthPhase(input) {
 }
 
 // src/commands/phases/plan-phase.ts
-import { existsSync as existsSync20, readdirSync as readdirSync3 } from "fs";
+import { existsSync as existsSync21, readdirSync as readdirSync3 } from "fs";
 import { readFile as readFile9 } from "fs/promises";
 import { basename as basename3, join as join26 } from "path";
 import chalk13 from "chalk";
@@ -7059,13 +7457,13 @@ init_config_loader();
 
 // src/commands/phases/plan-cards.ts
 init_render_outro();
-import { existsSync as existsSync19 } from "fs";
-import { isAbsolute as isAbsolute5, join as join25 } from "path";
+import { existsSync as existsSync20 } from "fs";
+import { isAbsolute as isAbsolute6, join as join25 } from "path";
 import chalk12 from "chalk";
 
 // src/lib/og-card.ts
 init_image_kind();
-import { existsSync as existsSync10, readFileSync as readFileSync6 } from "fs";
+import { existsSync as existsSync11, readFileSync as readFileSync6 } from "fs";
 import { writeFile as writeFile9 } from "fs/promises";
 import { join as join16 } from "path";
 var PORTRAIT_PATHS = ["/opengraph-image/portrait", "/opengraph-image-portrait", "/og/portrait"];
@@ -7235,7 +7633,7 @@ function existingIcon(dir) {
   for (const ext of ["png", "svg", "jpg", "webp", "gif"]) {
     const path = join16(dir, `app-icon.${ext}`);
     try {
-      if (!existsSync10(path)) continue;
+      if (!existsSync11(path)) continue;
       if (!sniffImageKind(readFileSync6(path))) continue;
       return path;
     } catch {
@@ -7279,9 +7677,9 @@ function jpegSize(buf) {
 }
 
 // src/commands/phases/video-phase.ts
-import { existsSync as existsSync18, statSync as statSync3 } from "fs";
+import { existsSync as existsSync19, statSync as statSync3 } from "fs";
 import { copyFile as copyFile3 } from "fs/promises";
-import { join as join24, resolve as resolve9 } from "path";
+import { join as join24, resolve as resolve10 } from "path";
 
 // src/browser/signed-in.ts
 function pathDepth(raw) {
@@ -7387,7 +7785,7 @@ async function hasHeadroom() {
 async function withRenderSlot(render, onWait) {
   if (active >= MAX_CONCURRENT_RENDERS) {
     onWait?.(`waiting for a render slot (${active}/${MAX_CONCURRENT_RENDERS} busy)`);
-    await new Promise((resolve12) => waiting.push(resolve12));
+    await new Promise((resolve13) => waiting.push(resolve13));
   }
   active++;
   try {
@@ -7416,20 +7814,20 @@ init_lib();
 init_helpers();
 
 // src/record.ts
-import { existsSync as existsSync15 } from "fs";
-import { mkdir as mkdir7 } from "fs/promises";
+import { existsSync as existsSync16 } from "fs";
+import { mkdir as mkdir8, rm as rm3 } from "fs/promises";
 import { join as join21 } from "path";
 import chalk10 from "chalk";
 
 // src/browser/actions.ts
 init_lib();
-import { existsSync as existsSync12 } from "fs";
+import { existsSync as existsSync13 } from "fs";
 import { readFile as readFile7 } from "fs/promises";
-import { isAbsolute as isAbsolute2, resolve as resolve6 } from "path";
+import { isAbsolute as isAbsolute3, resolve as resolve7 } from "path";
 
 // src/browser/effects.ts
 init_lib();
-import { existsSync as existsSync11, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync12, readFileSync as readFileSync7 } from "fs";
 import { join as join17 } from "path";
 
 // src/browser/page-eval.ts
@@ -7449,7 +7847,7 @@ function loadHighlightCSS() {
     // src/browser/ → src/
   ];
   for (const p of candidates) {
-    if (existsSync11(p)) return readFileSync7(p, "utf-8");
+    if (existsSync12(p)) return readFileSync7(p, "utf-8");
   }
   return "";
 }
@@ -7662,6 +8060,7 @@ function locatorFor(page, keyword) {
 var WAIT_MS = 450;
 var HANDLE_MS = 3e3;
 var RESOLVE_BUDGET_MS2 = 2e4;
+var DOM_POLL_MS = 150;
 function remaining(deadline) {
   return Math.max(1, deadline - Date.now());
 }
@@ -7772,7 +8171,7 @@ async function resolveElementSettled(page, target, deadlineMs = RESOLVE_DEADLINE
   }
 }
 async function resolvePlainText(page, text, deadline) {
-  const scanned = await domTextMatch(page, text);
+  let scanned = await domTextMatch(page, text);
   const stages = plainTextStages(page, text);
   while (Date.now() < deadline) {
     for (const { locator, state } of stages) {
@@ -7783,6 +8182,12 @@ async function resolvePlainText(page, text, deadline) {
       }
     }
     if (scanned) return scanned;
+    while (Date.now() < deadline) {
+      await page.waitForTimeout(Math.min(DOM_POLL_MS, remaining(deadline)));
+      scanned = await domTextMatch(page, text);
+      if (scanned) break;
+    }
+    if (!scanned) return null;
   }
   return scanned ?? null;
 }
@@ -8207,8 +8612,8 @@ async function executeStep(page, step, plan, config, cursorInjected, baseDir, pr
           const isPlaceholder = !rawPath || rawPath.startsWith("[") || rawPath.includes("example");
           if (!isPlaceholder) {
             const normalizedPath = rawPath.startsWith("mnt/") ? `/${rawPath}` : rawPath;
-            const filePath = isAbsolute2(normalizedPath) ? normalizedPath : resolve6(baseDir, normalizedPath);
-            if (existsSync12(filePath)) {
+            const filePath = isAbsolute3(normalizedPath) ? normalizedPath : resolve7(baseDir, normalizedPath);
+            if (existsSync13(filePath)) {
               await fileInput.setInputFiles(filePath);
               await page.waitForTimeout(2e3);
               break;
@@ -8324,8 +8729,8 @@ async function executeStep(page, step, plan, config, cursorInjected, baseDir, pr
     case "wait":
       break;
     case "image": {
-      const imagePath = step.value ? isAbsolute2(step.value) ? step.value : resolve6(baseDir, step.value) : null;
-      if (imagePath && existsSync12(imagePath)) {
+      const imagePath = step.value ? isAbsolute3(step.value) ? step.value : resolve7(baseDir, step.value) : null;
+      if (imagePath && existsSync13(imagePath)) {
         const imgStyle = step.target === "stretch" ? "width: 100vw; height: 100vh; object-fit: cover;" : "max-width: 90%; max-height: 90%;";
         if (await showImagePage(page, imagePath, imgStyle, config, cursorInjected, false)) injected = true;
       }
@@ -8354,7 +8759,7 @@ async function executeStep(page, step, plan, config, cursorInjected, baseDir, pr
         await pendingDownload;
         pendingDownload = null;
       }
-      if (lastDownloadPath && existsSync12(lastDownloadPath)) {
+      if (lastDownloadPath && existsSync13(lastDownloadPath)) {
         const imgStyle = step.target === "stretch" ? "width: 100%; height: 100%; object-fit: contain;" : "max-width: 90%; max-height: 90%; object-fit: contain;";
         if (await showImagePage(page, lastDownloadPath, imgStyle, config, cursorInjected)) injected = true;
       }
@@ -8462,13 +8867,13 @@ async function getPageElementSelectors(page, query, limit, keyword = "") {
 // src/browser/step-validator.ts
 init_crawl();
 init_utils();
-import { existsSync as existsSync13, readdirSync as readdirSync2 } from "fs";
-import { basename as basename2, isAbsolute as isAbsolute3, join as join18, resolve as resolve7 } from "path";
+import { existsSync as existsSync14, readdirSync as readdirSync2 } from "fs";
+import { basename as basename2, isAbsolute as isAbsolute4, join as join18, resolve as resolve8 } from "path";
 function findMediaFile(filename, baseDir) {
   const name = basename2(filename);
   const searchDirs = [baseDir, join18(baseDir, "res"), join18(baseDir, "assets"), join18(baseDir, "media")];
   for (const dir of searchDirs) {
-    if (!existsSync13(dir)) continue;
+    if (!existsSync14(dir)) continue;
     try {
       const files = readdirSync2(dir);
       if (files.includes(name)) return join18(dir, name);
@@ -8521,8 +8926,8 @@ function resolveMediaStep(step, baseDir, label, startTime) {
   if (!step.value) {
     return { success: false, error: `Missing ${label} path`, executionTimeMs: Date.now() - startTime };
   }
-  const specifiedPath = isAbsolute3(step.value) ? step.value : resolve7(baseDir, step.value);
-  if (existsSync13(specifiedPath)) return { success: true, executionTimeMs: Date.now() - startTime };
+  const specifiedPath = isAbsolute4(step.value) ? step.value : resolve8(baseDir, step.value);
+  if (existsSync14(specifiedPath)) return { success: true, executionTimeMs: Date.now() - startTime };
   const foundPath = findMediaFile(step.value, baseDir);
   if (foundPath) {
     step.value = `./${foundPath.replace(`${baseDir}/`, "").replace(`${baseDir}\\`, "")}`;
@@ -8650,8 +9055,8 @@ async function validateAndExecuteStep(page, step, plan, baseDir) {
         const isPlaceholder = !rawPath || rawPath.startsWith("[") || rawPath.includes("example");
         if (!isPlaceholder) {
           const normalizedPath = rawPath.startsWith("mnt/") ? `/${rawPath}` : rawPath;
-          let filePath = isAbsolute3(normalizedPath) ? normalizedPath : resolve7(baseDir, normalizedPath);
-          if (!existsSync13(filePath)) {
+          let filePath = isAbsolute4(normalizedPath) ? normalizedPath : resolve8(baseDir, normalizedPath);
+          if (!existsSync14(filePath)) {
             const foundPath = findMediaFile(rawPath, baseDir);
             if (foundPath) {
               const relativePath = `./${foundPath.replace(`${baseDir}/`, "").replace(`${baseDir}\\`, "")}`;
@@ -8793,7 +9198,7 @@ async function validateStepsOnPage(plan, config, logError2, baseDir, onStepStart
 }
 
 // src/browser/meta.ts
-import { existsSync as existsSync14 } from "fs";
+import { existsSync as existsSync15 } from "fs";
 import { readFile as readFile8, writeFile as writeFile10 } from "fs/promises";
 import { join as join20 } from "path";
 var RECORDING_FILE = "recording.mp4";
@@ -8803,7 +9208,7 @@ function getRecordingPath(outputDir) {
 }
 async function loadRecordingMeta(outputDir) {
   const metaPath = join20(outputDir, RECORDING_META_FILE);
-  if (!existsSync14(metaPath)) return null;
+  if (!existsSync15(metaPath)) return null;
   try {
     const content = await readFile8(metaPath, "utf-8");
     return JSON.parse(content);
@@ -8910,7 +9315,7 @@ async function leavesApp(el, step, plannedUrl) {
 }
 async function recordSession(plan, config, stepDurations, workDir, baseDir, task2, logError2, opts = {}) {
   const videoDir = join21(workDir, "video");
-  await mkdir7(videoDir, { recursive: true });
+  await mkdir8(videoDir, { recursive: true });
   const getStepDuration = (stepNum) => {
     return stepDurations[stepNum - 1] ?? config.timing.minStepDuration;
   };
@@ -8921,11 +9326,33 @@ async function recordSession(plan, config, stepDurations, workDir, baseDir, task
   const authState = findAuthState(plan.url);
   const { context, browser, chromeSession } = await launchBrowserContext(config, userDataDir, recordVideo, authState);
   try {
+    const isExtensionPage = plan.url.startsWith("chrome-extension://");
+    if (!isExtensionPage) {
+      const warm = await context.newPage();
+      const warmVideo = warm.video();
+      const warmUrls = [plan.url];
+      for (const step of plan.steps) {
+        if (step.action !== "navigate" || !step.target) continue;
+        if (!warmUrls.includes(step.target)) warmUrls.push(step.target);
+      }
+      try {
+        for (const url of warmUrls) {
+          await gotoSettled(warm, url).catch(() => {
+          });
+        }
+      } catch {
+      } finally {
+        await warm.close().catch(() => {
+        });
+        const stray = await warmVideo?.path().catch(() => void 0);
+        if (stray) await rm3(stray, { force: true }).catch(() => {
+        });
+      }
+    }
     const page = context.pages()[0] || await context.newPage();
     setupDownloadTracking(page);
     context.on("page", (p) => setupDownloadTracking(p));
     const firstStepIsMedia = ["media", "image", "video"].includes(plan.steps[0]?.action ?? "");
-    const isExtensionPage = plan.url.startsWith("chrome-extension://");
     let signInChecked = false;
     const guardSignedIn = async () => {
       if (signInChecked || opts.allowLoggedOut || isExtensionPage) return;
@@ -9002,7 +9429,7 @@ async function recordSession(plan, config, stepDurations, workDir, baseDir, task
           if (!targetEl) {
             console.log(
               `
-    \u26A0 target "${step.target}" not found on ${page.url()} \u2014 step ${stepNum} recorded without the action`
+    \u26A0 target "${step.target}" not found on ${page.url()}; step ${stepNum} recorded without the action`
             );
           }
         }
@@ -9141,7 +9568,7 @@ async function recordSession(plan, config, stepDurations, workDir, baseDir, task
     if (!pageClosedEarly) await page.close();
     const videoPath = await video.path();
     await cleanupBrowserSession({ context, browser, chromeSession });
-    if (!videoPath || !existsSync15(videoPath)) {
+    if (!videoPath || !existsSync16(videoPath)) {
       throw new Error("Video file was not created");
     }
     saveTask.succeed("Video saved");
@@ -9156,20 +9583,20 @@ init_run_root();
 
 // src/utils/video-pipeline.ts
 init_lib();
-import { existsSync as existsSync17 } from "fs";
-import { mkdir as mkdir8, writeFile as writeFile11 } from "fs/promises";
-import { isAbsolute as isAbsolute4, join as join23, resolve as resolve8 } from "path";
+import { existsSync as existsSync18 } from "fs";
+import { mkdir as mkdir9, writeFile as writeFile11 } from "fs/promises";
+import { isAbsolute as isAbsolute5, join as join23, resolve as resolve9 } from "path";
 import chalk11 from "chalk";
 
 // src/utils/music.ts
-import { existsSync as existsSync16, readFileSync as readFileSync8 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync8 } from "fs";
 import { dirname as dirname4, join as join22 } from "path";
-var DEFAULT_MOOD = "calm";
+var DEFAULT_MOOD = "corporate";
 function musicDir() {
   let dir = getScriptDir();
   for (let i = 0; i < 6; i++) {
     const candidate = join22(dir, "assets", "music");
-    if (existsSync16(join22(candidate, "manifest.json"))) return candidate;
+    if (existsSync17(join22(candidate, "manifest.json"))) return candidate;
     const parent = dirname4(dir);
     if (parent === dir) break;
     dir = parent;
@@ -9182,7 +9609,7 @@ function listBundledMusic() {
   try {
     const parsed = JSON.parse(readFileSync8(join22(dir, "manifest.json"), "utf8"));
     const tracks = Array.isArray(parsed.tracks) ? parsed.tracks : [];
-    return tracks.filter((t) => typeof t?.file === "string").map((t) => ({ ...t, path: join22(dir, t.file) })).filter((t) => existsSync16(t.path));
+    return tracks.filter((t) => typeof t?.file === "string").map((t) => ({ ...t, path: join22(dir, t.file) })).filter((t) => existsSync17(t.path));
   } catch {
     return [];
   }
@@ -9196,6 +9623,16 @@ function resolveBundledBed(mood = DEFAULT_MOOD) {
 // src/utils/video-pipeline.ts
 init_run_root();
 var INDENT3 = "   ";
+function captionWordTimings(caption, spoken, duration) {
+  const captionWords = caption.split(/\s+/).filter(Boolean);
+  if (spoken.length === 0 || captionWords.length === 0) {
+    return estimateWordTimings(caption, duration);
+  }
+  if (spoken.length === captionWords.length) {
+    return spoken.map((w, i) => ({ ...w, word: captionWords[i] ?? w.word }));
+  }
+  return estimateWordTimings(caption, duration);
+}
 async function generateASS(plan, stepAudio, workDir, config, captions) {
   const cues = [];
   let currentTime = VOICE_LEAD_MS;
@@ -9206,7 +9643,7 @@ async function generateASS(plan, stepAudio, workDir, config, captions) {
       currentTime += config.timing.minStepDuration;
       continue;
     }
-    const words = audio.words.length > 0 ? audio.words : estimateWordTimings(step.caption || "", audio.duration);
+    const words = captionWordTimings(step.caption || "", audio.words, audio.duration);
     if (words.length > 0 && !step.spokenOnly) {
       const offset = currentTime;
       cues.push({
@@ -9226,7 +9663,7 @@ async function generateASS(plan, stepAudio, workDir, config, captions) {
   return assPath;
 }
 var STILL_EXTENSIONS = ["png", "jpg", "jpeg", "webp"];
-function buildVideoOverlays(steps, stepDurations, baseDir, leadInSecs = 0) {
+function buildVideoOverlays(steps, stepDurations, baseDir, leadInSecs = 0, totalSecs, blackSpans) {
   const overlays = [];
   let cumulativeTime = leadInSecs;
   for (let i = 0; i < steps.length; i++) {
@@ -9239,13 +9676,20 @@ function buildVideoOverlays(steps, stepDurations, baseDir, leadInSecs = 0) {
       const ext = step.value.split(".").pop()?.toLowerCase() || "";
       const still = isCard && STILL_EXTENSIONS.includes(ext);
       if (still || isClip && ["mp4", "webm", "mov"].includes(ext)) {
-        const mediaPath = isAbsolute4(step.value) ? step.value : resolve8(baseDir, step.value);
-        if (existsSync17(mediaPath) && durationSec > 0) {
+        const mediaPath = isAbsolute5(step.value) ? step.value : resolve9(baseDir, step.value);
+        if (existsSync18(mediaPath) && durationSec > 0) {
           const partial = parsePartial(step.partial);
+          const runsToEnd = still && i === steps.length - 1 && totalSecs !== void 0;
+          let duration = runsToEnd ? Math.max(durationSec, totalSecs - cumulativeTime) : durationSec;
+          if (still && !runsToEnd && blackSpans) {
+            const endsAt = cumulativeTime + duration;
+            const following = blackSpans.find((sp) => sp.start <= endsAt + 0.25 && sp.end > endsAt);
+            if (following) duration = following.end - cumulativeTime;
+          }
           overlays.push({
             path: mediaPath,
             startTime: cumulativeTime,
-            duration: durationSec,
+            duration,
             mode: step.target === "stretch" ? "stretch" : step.target === "cover" ? "cover" : "center",
             ...still ? { still: true } : {},
             ...partial.trimStart !== void 0 ? { trimStart: partial.trimStart } : {},
@@ -9258,7 +9702,7 @@ function buildVideoOverlays(steps, stepDurations, baseDir, leadInSecs = 0) {
   }
   return overlays;
 }
-async function composeAndFinish(videoPath, audioPath, assPath, config, userTier = "free", mainContentDuration, trimStart = 0.5, stepTransitions, hasClipAudio = false, endsOnCreditsCard = false, _stepSync) {
+async function composeAndFinish(videoPath, audioPath, assPath, config, userTier = "free", mainContentDuration, trimStart = 0.5, stepTransitions, hasClipAudio = false, endsOnCreditsCard = false, _stepSync, musicStartSecs = 0) {
   header("Compose");
   const configPath = join23(runRoot(), CONFIG_FILE);
   console.log(`${INDENT3}${chalk11.dim(`Config: ${formatClickablePath(configPath)}`)}`);
@@ -9270,13 +9714,13 @@ async function composeAndFinish(videoPath, audioPath, assPath, config, userTier
     process.exit(0);
   }
   const composeTask = task("Building final video");
-  await mkdir8(config.output.dir, { recursive: true });
+  await mkdir9(config.output.dir, { recursive: true });
   const suffix = config.lang ? `-${config.lang}` : "";
   const finalPath = join23(config.output.dir, `demo${suffix}.${config.video.format}`);
   const videoDuration = await getMediaDuration(videoPath) / 1e3;
-  const hasVoiceover = audioPath && existsSync17(audioPath);
-  const musicPath = config.music?.path ? isAbsolute4(config.music.path) ? config.music.path : resolve8(config.output.dir, config.music.path) : "";
-  let hasMusic = musicPath && existsSync17(musicPath);
+  const hasVoiceover = audioPath && existsSync18(audioPath);
+  const musicPath = config.music?.path ? isAbsolute5(config.music.path) ? config.music.path : resolve9(config.output.dir, config.music.path) : "";
+  let hasMusic = musicPath && existsSync18(musicPath);
   let bedPath = "";
   let bedCredit = "";
   if (!hasMusic && config.audio?.ambience !== false) {
@@ -9328,7 +9772,14 @@ async function composeAndFinish(videoPath, audioPath, assPath, config, userTier
       hasClipAudio,
       mainContentDuration,
       stepTransitions,
-      hwaccel: config.video.hwaccel
+      hwaccel: config.video.hwaccel,
+      // The tempo pass runs after this and speeds the whole file up, music
+      // included. Told about it, compose lays the bed down pre-slowed so the
+      // song comes out at its own speed.
+      tempo: config.video.tempo,
+      musicStartSecs,
+      // So the bed can be landed with its last note on the last frame.
+      musicDurationSecs: hasMusic ? await getMediaDuration(backingPath).then((ms) => ms / 1e3).catch(() => 0) : 0
     });
     composeTask.succeed("Video composed");
     return finalPath;
@@ -9390,18 +9841,18 @@ function resolveOutro(config, userTier, userEmail) {
   if (!usesQuickPeekOutro(userTier, userEmail)) {
     const custom = config.video.outro?.trim();
     if (!custom) return void 0;
-    const path = resolve9(custom);
-    if (existsSync18(path)) return path;
+    const path = resolve10(custom);
+    if (existsSync19(path)) return path;
     info(`${INDENT4}\u26A0 outro not found: ${path}`);
     return void 0;
   }
   const scriptDir = getScriptDir();
   const bundled = join24(scriptDir, "assets", "qp.wm");
-  if (existsSync18(bundled)) return bundled;
+  if (existsSync19(bundled)) return bundled;
   const fallback = join24(scriptDir, "..", "dist", "assets", "qp.wm");
-  return existsSync18(fallback) ? fallback : void 0;
+  return existsSync19(fallback) ? fallback : void 0;
 }
-var EMPTY_MIN_SECS = 0.5;
+var EMPTY_MIN_SECS = 0.4;
 var OUTRO_TAIL_MS = 900;
 var FIT_SECOND_PASS_CUSHION_SECS = 1;
 var FIT_SECOND_PASS_MAX_SPEEDUP = 1.45;
@@ -9426,11 +9877,12 @@ async function renderVideoPhase(params) {
     })
   );
   const recordingPath = getRecordingPath(config.output.dir);
-  const hasExistingRecording = existingRecordingMeta && existsSync18(recordingPath);
+  const hasExistingRecording = existingRecordingMeta && existsSync19(recordingPath);
   let videoPath = recordingPath;
   const firstStep = plan.steps[0];
   const firstStepIsVideo = firstStep && (firstStep.action === "video" || firstStep.action === "media");
   let trimStart = 0;
+  let recordedStepLengths = null;
   const doRecord = async () => {
     header("Record");
     const result = await recordSession(plan, config, stepDurations, workDir, config.output.dir, task, logError, {
@@ -9442,6 +9894,7 @@ async function renderVideoPhase(params) {
     ]);
     const detectedEmpty = mergeSpans([...result.leadSpans ?? [], ...emptyBlack, ...emptyWhite]);
     let stepLengths = result.actualStepDurations;
+    let zeroAnchored = false;
     if (detectedEmpty.length > 0) {
       const bounds = [];
       let at = 0;
@@ -9466,6 +9919,7 @@ async function renderVideoPhase(params) {
         const sum = result.actualStepDurations.reduce((a, b2) => a + b2, 0);
         const factor = sum > 0 && realSecs > 0 ? realSecs * 1e3 / sum : 1;
         stepLengths = result.actualStepDurations.map((ms) => ms * factor);
+        zeroAnchored = true;
         info(`Sped up ${emptySecs.toFixed(1)}s of loading screens at ${EMPTY_SPAN_SPEED}x`);
       } else {
         await discardPartial(retimed);
@@ -9482,16 +9936,19 @@ async function renderVideoPhase(params) {
     const meta = buildRecordingMeta(plan, config, stepDurations);
     meta.actualStepDurations = stepLengths;
     meta.pageLoadTime = result.pageLoadTime;
+    meta.zeroAnchored = zeroAnchored;
     await saveRecordingMeta(config.output.dir, meta);
     videoPath = recordingPath;
-    trimStart = firstStepIsVideo ? 0 : result.pageLoadTime;
+    recordedStepLengths = stepLengths;
+    trimStart = firstStepIsVideo || zeroAnchored ? 0 : result.pageLoadTime;
   };
   if (hasExistingRecording) {
     const reuseCheck = canReuseRecording(plan, config, stepDurations, existingRecordingMeta);
     if (reuseCheck.canReuse) {
       info("Reusing existing recording");
       videoPath = recordingPath;
-      trimStart = firstStepIsVideo ? 0 : existingRecordingMeta?.pageLoadTime ?? 0.5;
+      recordedStepLengths = existingRecordingMeta.actualStepDurations ?? existingRecordingMeta.stepDurations;
+      trimStart = firstStepIsVideo || existingRecordingMeta.zeroAnchored ? 0 : existingRecordingMeta?.pageLoadTime ?? 0.5;
       stepAudio = await alignVoiceoverToRecording(
         stepAudio,
         existingRecordingMeta.actualStepDurations ?? existingRecordingMeta.stepDurations,
@@ -9505,9 +9962,23 @@ async function renderVideoPhase(params) {
   } else {
     await doRecord();
   }
-  const alignedStepDurations = plan.steps.map((_, i) => stepAudio.get(i + 1)?.duration ?? 0);
+  const alignedStepDurations = plan.steps.map(
+    (step, i) => Math.max(
+      stepAudio.get(i + 1)?.duration ?? recordedStepLengths?.[i] ?? stepDurations[i] ?? 0,
+      step.duration ? step.duration * 1e3 : 0
+    )
+  );
   let splicedClipAudio = false;
-  const videoOverlays = buildVideoOverlays(plan.steps, alignedStepDurations, config.output.dir, trimStart);
+  const recordingSecs = await getMediaDuration(videoPath).then((ms) => ms / 1e3).catch(() => void 0);
+  const blackSpans = await detectBlackSpans(videoPath, 0.3).catch(() => []);
+  const videoOverlays = buildVideoOverlays(
+    plan.steps,
+    alignedStepDurations,
+    config.output.dir,
+    trimStart,
+    recordingSecs,
+    blackSpans
+  );
   if (videoOverlays.length > 0) {
     const spliceTask = task("Painting cards and clips into recording");
     try {
@@ -9561,11 +10032,13 @@ async function renderVideoPhase(params) {
   const cardStepSeconds = (index) => {
     const action = plan.steps[index]?.action;
     if (action !== "image" && action !== "media") return 0;
-    return (stepAudio.get(index + 1)?.duration ?? 0) / 1e3;
+    const audioSecs = (stepAudio.get(index + 1)?.duration ?? 0) / 1e3;
+    const tail = index === plan.steps.length - 1 && action === "image" ? OUTRO_TAIL_MS / 1e3 : 0;
+    return Math.max(audioSecs, plan.steps[index]?.duration ?? 0) + tail;
   };
   const introSecs = cardStepSeconds(0);
   const outroStepSecs = cardStepSeconds(plan.steps.length - 1);
-  const outroSeconds = config.video.outroCard?.seconds ?? (outroStepSecs || 3.5);
+  const outroSeconds = Math.max(config.video.outroCard?.seconds ?? 3.5, outroStepSecs);
   const card = config.video.outroCard;
   if (card?.subject?.name) {
     const cardTask = task("Rendering credits card");
@@ -9609,6 +10082,20 @@ async function renderVideoPhase(params) {
       mainContentDuration = void 0;
     }
   }
+  const outroOnly = config.music?.outroOnly !== false;
+  let musicStartSecs = 0;
+  if (outroOnly) {
+    let trailingCards = 0;
+    for (let i = plan.steps.length - 1; i >= 0; i--) {
+      const action = plan.steps[i]?.action;
+      if (action !== "image" && action !== "media") break;
+      trailingCards++;
+    }
+    if (trailingCards > 0 && trailingCards < plan.steps.length) {
+      const upTo = plan.steps.length - trailingCards;
+      musicStartSecs = alignedStepDurations.slice(0, upTo).reduce((a, b) => a + b, 0) / 1e3;
+    }
+  }
   let finalPath = await composeAndFinish(
     videoToCompose,
     voiceoverPath,
@@ -9620,7 +10107,9 @@ async function renderVideoPhase(params) {
     stepTransitions,
     // The splice writes a clip-audio track only when a spliced clip had one.
     splicedClipAudio,
-    endsOnCreditsCard
+    endsOnCreditsCard,
+    void 0,
+    musicStartSecs
   );
   const maxSilence = config.video.maxSilenceSecs ?? 0.6;
   if (maxSilence > 0) {
@@ -9785,7 +10274,7 @@ async function discardPartial(path) {
 }
 var MIN_ARTIFACT_BYTES = 1024;
 function assertArtifact(finalPath) {
-  const size = existsSync18(finalPath) ? statSync3(finalPath).size : 0;
+  const size = existsSync19(finalPath) ? statSync3(finalPath).size : 0;
   if (size >= MIN_ARTIFACT_BYTES) return;
   throw new Error(
     `The run finished without producing a video: ${finalPath} ${size === 0 ? "does not exist" : `is only ${size} bytes`}. Check the log above for the failed ffmpeg pass.`
@@ -9839,7 +10328,7 @@ async function useOgCardAsIntro(plan, url, config, fresh = false) {
   const rewritable = first.action === "wait" && !first.target;
   const portrait = (config.video.height ?? 0) > (config.video.width ?? 0);
   const existing = join25(config.output.dir, "og-card.png");
-  const fetched = !fresh && existsSync19(existing) ? existing : await fetchOgCard(url, config.output.dir, portrait);
+  const fetched = !fresh && existsSync20(existing) ? existing : await fetchOgCard(url, config.output.dir, portrait);
   const ogPath = fetched && coversFrame(fetched, config) ? fetched : null;
   const cardPath = ogPath ?? await renderGeneratedIntroCard(url, config);
   if (!cardPath) {
@@ -9929,30 +10418,20 @@ function fitFor(cardPath, config) {
   return Math.abs(size.width / size.height - frame) < 0.06 ? "stretch" : "cover";
 }
 function resolveCardPath(value, config) {
-  return isAbsolute5(value) ? value : join25(config.output.dir, value.replace(/^\.\//, ""));
+  return isAbsolute6(value) ? value : join25(config.output.dir, value.replace(/^\.\//, ""));
 }
 var DEFAULT_INTRO_CARD_SECONDS = 2.5;
 function packageAsset(relative) {
   let dir = getScriptDir();
   for (let up = 0; up < 6; up++) {
     const candidate = join25(dir, relative);
-    if (existsSync19(candidate)) return candidate;
-    dir = join25(dir, "..");
-  }
-  return void 0;
-}
-function siblingAsset(relative) {
-  let dir = join25(getScriptDir(), "..");
-  for (let up = 0; up < 7; up++) {
-    const candidate = join25(dir, relative);
-    if (existsSync19(candidate)) return candidate;
+    if (existsSync20(candidate)) return candidate;
     dir = join25(dir, "..");
   }
   return void 0;
 }
 var CREDIT_TOOLS = [
-  { name: "QuickPeek", role: "Video generated by", icon: () => packageAsset("imgs/qp.png") },
-  { name: "Vidlet", role: "Video edited by", icon: () => siblingAsset("VidLet/res/icons/vidlet-512.png") }
+  { name: "QuickPeek", role: "Video generated by", icon: () => packageAsset("imgs/qp.png") }
 ];
 function oneTagline(text) {
   if (!text) return void 0;
@@ -10044,7 +10523,7 @@ async function runPlanPhase(params) {
   const extensionPath = config.browser?.extension;
   let existingPlan = null;
   let existingPlanPath = null;
-  if (existsSync20(planPath)) {
+  if (existsSync21(planPath)) {
     try {
       const parsed = JSON.parse(await readFile9(planPath, "utf-8"));
       if (parsed.url && parsed.steps?.length > 0) {
@@ -10074,7 +10553,22 @@ async function runPlanPhase(params) {
     }
   }
   const normalizeUrl2 = (u) => u.replace(/\/+$/, "").toLowerCase();
-  const urlMatches = existingPlan && normalizeUrl2(existingPlan.url) === normalizeUrl2(url);
+  const isBareOrigin = (u) => {
+    try {
+      const parsed = new URL(u);
+      return parsed.pathname === "/" && !parsed.search && !parsed.hash;
+    } catch {
+      return false;
+    }
+  };
+  const sameOrigin = (a, b) => {
+    try {
+      return new URL(a).origin === new URL(b).origin;
+    } catch {
+      return false;
+    }
+  };
+  const urlMatches = existingPlan && (normalizeUrl2(existingPlan.url) === normalizeUrl2(url) || isBareOrigin(existingPlan.url) && sameOrigin(existingPlan.url, url));
   if (existingPlan && !urlMatches && isAutoYes()) {
     console.log();
     console.log(chalk13.dim(`  Existing plan is for ${existingPlan.url}, not ${url}, regenerating.`));
@@ -10218,7 +10712,7 @@ async function runPlanPhase(params) {
   const planLang = plan.lang || "en";
   if (planLang !== targetLang) {
     let useExistingTranslation = false;
-    if (existsSync20(planPath) && existingPlanPath !== planPath) {
+    if (existsSync21(planPath) && existingPlanPath !== planPath) {
       try {
         const translatedPlan = JSON.parse(await readFile9(planPath, "utf-8"));
         if (translatedPlan.steps?.length === plan.steps.length && translatedPlan.lang === targetLang) {
@@ -10397,7 +10891,7 @@ async function runValidationPhase(params) {
 
 // src/commands/phases/voiceover-phase.ts
 init_lib();
-import { existsSync as existsSync22 } from "fs";
+import { existsSync as existsSync23 } from "fs";
 import { join as join28 } from "path";
 import chalk15 from "chalk";
 var INDENT6 = "   ";
@@ -10458,14 +10952,14 @@ async function clearCachedFiles(outputDir) {
   const { unlink: unlink5 } = await import("fs/promises");
   for (const file of CACHED_FILES) {
     const filePath = join28(outputDir, file);
-    if (existsSync22(filePath)) await unlink5(filePath).catch(() => {
+    if (existsSync23(filePath)) await unlink5(filePath).catch(() => {
     });
   }
   info("Cleared cached files (--fresh)");
 }
 async function usableVoiceover(outputDir, meta) {
   const voiceoverFile = join28(outputDir, "voiceover.wav");
-  if (!meta || !existsSync22(voiceoverFile)) return null;
+  if (!meta || !existsSync23(voiceoverFile)) return null;
   if (await isHonestWav(voiceoverFile)) return meta;
   info("Existing voiceover has a stale container, regenerating");
   return null;
@@ -10543,7 +11037,7 @@ async function ensureCliSignIn(url, opts) {
 }
 
 // src/commands/utils/chrome-extension.ts
-import { existsSync as existsSync23, readdirSync as readdirSync5, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync24, readdirSync as readdirSync5, readFileSync as readFileSync9 } from "fs";
 import { homedir as homedir4 } from "os";
 import { join as join29 } from "path";
 function resolveChromeExtension(extensionId) {
@@ -10579,7 +11073,7 @@ function resolveChromeExtension(extensionId) {
   }
   for (const chromeExtDir of possibleDirs) {
     const extDir = join29(chromeExtDir, extensionId);
-    if (!existsSync23(extDir)) continue;
+    if (!existsSync24(extDir)) continue;
     try {
       const versions = readdirSync5(extDir).filter((f) => !f.startsWith("."));
       if (versions.length === 0) continue;
@@ -10588,7 +11082,7 @@ function resolveChromeExtension(extensionId) {
       let name = extensionId;
       let popupPath = "popup.html";
       const manifestPath = join29(extPath, "manifest.json");
-      if (existsSync23(manifestPath)) {
+      if (existsSync24(manifestPath)) {
         try {
           const manifest = JSON.parse(readFileSync9(manifestPath, "utf-8"));
           if (manifest.name && !manifest.name.startsWith("__MSG_")) {
@@ -10611,7 +11105,7 @@ function resolveChromeExtension(extensionId) {
 
 // src/commands/utils/plan-review.ts
 import { createHash as createHash2 } from "crypto";
-import { existsSync as existsSync24 } from "fs";
+import { existsSync as existsSync25 } from "fs";
 import { readFile as readFile11, writeFile as writeFile12 } from "fs/promises";
 import { join as join30 } from "path";
 var REVIEW_FILE = "plan-review.json";
@@ -10624,7 +11118,7 @@ async function hashPlanFile(planPath) {
 }
 async function loadPlanReview(outputDir) {
   const path = join30(outputDir, REVIEW_FILE);
-  if (!existsSync24(path)) return {};
+  if (!existsSync25(path)) return {};
   try {
     return JSON.parse(await readFile11(path, "utf-8"));
   } catch {
@@ -10746,8 +11240,8 @@ async function recordCommand(url, options = {}) {
   }
   if (langOverride) config.lang = langOverride;
   if (config.music?.path) {
-    const musicPath = isAbsolute6(config.music.path) ? config.music.path : resolve10(config.output.dir, config.music.path);
-    if (!existsSync25(musicPath)) {
+    const musicPath = isAbsolute7(config.music.path) ? config.music.path : resolve11(config.output.dir, config.music.path);
+    if (!existsSync26(musicPath)) {
       console.log();
       console.log(chalk17.yellow(`  \u26A0 Music file not found: ${config.music.path}`));
       console.log(chalk17.dim(`    Config: ${join31(runRoot(), CONFIG_FILE)}`));
@@ -10768,7 +11262,7 @@ async function recordCommand(url, options = {}) {
   const targetLang = config.lang || "en";
   const planPath = join31(config.output.dir, `plan-${targetLang}.json`);
   const isExtensionUrl = url.startsWith("chrome-extension://");
-  await mkdir9(config.output.dir, { recursive: true });
+  await mkdir10(config.output.dir, { recursive: true });
   await setLogFilePath(config.output.dir);
   const preRunHash = await hashPlanFile(planPath);
   try {
@@ -10857,6 +11351,13 @@ async function recordCommand(url, options = {}) {
       userTier,
       userEmail
     });
+    await registerDemoRun(userEmail, {
+      source: currentMcpTool2() ? "mcp" : "cli",
+      targetUrl: validatedPlan.url || url,
+      localPath: finalPath,
+      title: validatedPlan.title,
+      ...config.lang ? { language: config.lang } : {}
+    });
     if (!userEmail || userEmail === "anonymous") {
       const newCount = localVideoCount + 1;
       await saveUserData({ localVideoCount: newCount });
@@ -11287,7 +11788,7 @@ function withTierNote(result, tier) {
       ...result.content,
       {
         type: "text",
-        text: `Free tier: this demo carries a watermark and the free video limit applies. Upgrade at ${pricingUrl()}`
+        text: `Free tier: a demo of 20 seconds or under comes out clean; over 20 seconds it carries a watermark. The free video limit applies. Upgrade at ${pricingUrl()}`
       }
     ]
   };
@@ -11383,7 +11884,7 @@ var FORMAT_PROPERTY = {
 var APPROVE_PLAN_PROPERTY = {
   approve_plan: {
     type: "boolean",
-    description: "The user has reviewed and approved the planned steps this tool returned as plan_ready \u2014 record them. Only honored while the plan file is unchanged since the call started, so it can never approve steps the user was not shown. Never pass it on a first call."
+    description: "The user has reviewed and approved the planned steps this tool returned as plan_ready. Record them. Only honored while the plan file is unchanged since the call started, so it can never approve steps the user was not shown. Never pass it on a first call."
   }
 };
 var DRAFT_PROPERTY = {
@@ -11430,7 +11931,7 @@ var OUTRO_PROPERTY = {
 var QUICKPEEK_TOOLS = [
   {
     name: "generate_demo",
-    description: "Record a narrated demo video of a web app, end to end: an AI plans the walkthrough, Playwright drives a real browser, and the result is composed with voiceover and burned karaoke captions. This is the headline tool. It takes minutes, not seconds, because a real browser session is recorded. Returns the finished MP4 path and a file:// url. The flow is interactive: with no saved session the user is asked to sign in first (a visible browser opens; QuickPeek never sees the password) so the demo starts inside the app instead of the logged-out landing page; the user picks voice gender, pace and video size on the first run (remembered afterwards); and the planned steps pause for the user\u2019s review before recording. On clients that cannot prompt, the tool returns setup_required / plan_ready statuses instead \u2014 ask the USER the questions they carry (never answer them yourself) and re-call with the answers. Pass skip_auth for public sites. The result says whether this recording was signed in.",
+    description: "Record a narrated demo video of a web app, end to end: an AI plans the walkthrough, Playwright drives a real browser, and the result is composed with voiceover and burned karaoke captions. This is the headline tool. It takes minutes, not seconds, because a real browser session is recorded. Returns the finished MP4 path and a file:// url. The flow is interactive: with no saved session the user is asked to sign in first (a visible browser opens; QuickPeek never sees the password) so the demo starts inside the app instead of the logged-out landing page; the user picks voice gender, pace and video size on the first run (remembered afterwards); and the planned steps pause for the user\u2019s review before recording. On clients that cannot prompt, the tool returns setup_required / plan_ready statuses instead. Ask the USER the questions they carry (never answer them yourself) and re-call with the answers. Pass skip_auth for public sites. The result says whether this recording was signed in.",
     inputSchema: {
       type: "object",
       properties: {
@@ -11506,7 +12007,7 @@ var QUICKPEEK_TOOLS = [
   },
   {
     name: "start_auth",
-    description: "Open a visible browser on a site so the user can sign in, once, by hand. Everything recorded afterwards starts from that session, and demos of the bare URL begin on the page the user leaves open when the session is saved \u2014 tell them to finish on their dashboard. QuickPeek never sees the password: only the resulting cookies are saved. On clients that support prompting, this saves the session as soon as the user confirms; otherwise call finish_auth when they say they are done.",
+    description: "Open a visible browser on a site so the user can sign in, once, by hand. Everything recorded afterwards starts from that session, and demos of the bare URL begin on the page the user leaves open when the session is saved. Tell them to finish on their dashboard. QuickPeek never sees the password: only the resulting cookies are saved. On clients that support prompting, this saves the session as soon as the user confirms; otherwise call finish_auth when they say they are done.",
     inputSchema: {
       type: "object",
       properties: { ...URL_PROPERTY },
@@ -11543,7 +12044,7 @@ var QUICKPEEK_TOOLS = [
   },
   {
     name: "check_account",
-    description: "Report the signed-in account and its tier, so you know whether a demo will carry a watermark or hit the free video limit before spending minutes recording one.",
+    description: "Report the signed-in account and its tier, so you know whether a demo will carry a watermark or hit the free video limit before spending minutes recording one. Over MCP a free demo of 20 seconds or under is clean; only a longer one is watermarked.",
     inputSchema: { type: "object", properties: {} }
   }
 ];
@@ -11628,7 +12129,7 @@ async function runDemoGates(url, args) {
       ...missing.length ? { options_needed: missing } : {},
       next_steps: [
         ...authNeeded ? ["Ask the user whether to sign in; start_auth then finish_auth, or skip_auth: true."] : [],
-        ...missing.length ? [`Ask the USER to choose ${missing.join(", ")} \u2014 do not pick for them \u2014 and pass the answers as params.`] : [],
+        ...missing.length ? [`Ask the USER to choose ${missing.join(", ")}, do not pick for them, and pass the answers as params.`] : [],
         "Then call this tool again with the same arguments plus the answers."
       ]
     });
@@ -11664,7 +12165,7 @@ async function runDemoGates(url, args) {
         return jsonContent({
           status: "setup_required",
           host,
-          sign_in: `The client could not show the sign-in prompt. Call start_auth with this url, then finish_auth once the user confirms \u2014 or pass skip_auth: true for a logged-out demo.`
+          sign_in: `The client could not show the sign-in prompt. Call start_auth with this url, then finish_auth once the user confirms, or pass skip_auth: true for a logged-out demo.`
         });
       }
     }
@@ -11714,7 +12215,7 @@ async function runDemoGates(url, args) {
 }
 function mcpPlanReview() {
   return async (plan, planPath) => {
-    const editorUrl = planEditorUrl(editorBaseUrl(), plan);
+    const editorUrl = await editorUrlWithThumbs(editorBaseUrl(), plan, dirname5(planPath));
     if (!canElicit()) throw new PlanReviewPending(plan, planPath, editorUrl);
     if (editorUrl) await openInBrowser(editorUrl);
     const steps = plan.steps.map((s, i) => `${i + 1}. [${s.action}] ${s.caption ?? ""}`).join("\n");
@@ -11723,7 +12224,7 @@ function mcpPlanReview() {
 
 ${steps}
 
-` + (editorUrl ? `The plan is open in your browser editor \u2014 to change it, edit there and Save over the plan file first. ` : "") + `Accept to record, decline to cancel.`,
+` + (editorUrl ? `The plan is open in your browser editor. To change it, edit there and Save over the plan file first. ` : "") + `Accept to record, decline to cancel.`,
       "approved",
       "Record this plan?"
     );
@@ -11741,14 +12242,14 @@ function planReadyResult(pending2) {
     next_steps: [
       "Show these steps to the USER and ask whether to record them (they can also fine-tune in editor_url).",
       "If approved, call this tool again with the same arguments plus approve_plan: true.",
-      "To change the story instead, re-call with fresh: true and a `description` saying what to cover \u2014 without fresh, the cached plan is reused as-is."
+      "To change the story instead, re-call with fresh: true and a `description` saying what to cover. Without fresh, the cached plan is reused as-is."
     ]
   });
 }
 function planRejectedResult(e) {
   return jsonContent({
     status: e.outcome === "decline" ? "plan_rejected" : "cancelled",
-    note: e.outcome === "decline" ? "The user declined the planned steps; nothing was recorded. Ask what the demo should cover, then re-call with a `description` that says so (or let them edit the plan file) \u2014 fresh: true regenerates from scratch." : "The review prompt was dismissed; nothing was recorded."
+    note: e.outcome === "decline" ? "The user declined the planned steps; nothing was recorded. Ask what the demo should cover, then re-call with a `description` that says so (or let them edit the plan file). Passing fresh: true regenerates from scratch." : "The review prompt was dismissed; nothing was recorded."
   });
 }
 async function handleGenerateDemo(args) {
@@ -11841,7 +12342,7 @@ async function handleOpenInEditor(args) {
     const parsed = parsePlanText(readFileSync10(planPath, "utf8"));
     if (!parsed.ok) return errorContent(`${planPath} cannot be opened: ${parsed.error}`);
     const base = editorBaseUrl();
-    const editorUrl = planEditorUrl(base, parsed.plan);
+    const editorUrl = await editorUrlWithThumbs(base, parsed.plan, dir);
     await openInBrowser(editorUrl ?? `${base}/edit`);
     return jsonContent({
       opened: true,
@@ -11930,7 +12431,7 @@ async function handleCheckAccount() {
       return jsonContent({
         signedIn: false,
         tier: "free",
-        note: "Not signed in. Demos carry a watermark and the free video limit applies."
+        note: "Not signed in. Over MCP a demo of 20 seconds or under comes out clean; a longer one carries a watermark. The free video limit applies."
       });
     }
     const tier = await getTierByEmail(userData.email);
@@ -11938,15 +12439,15 @@ async function handleCheckAccount() {
       signedIn: true,
       email: userData.email,
       tier,
-      note: tier === "free" ? "Free tier: demos carry a watermark and the free video limit applies." : `${tier} tier: no watermark.`
+      note: tier === "free" ? "Free tier: a demo of 20 seconds or under comes out clean; a longer one carries a watermark. The free video limit applies." : `${tier} tier: no watermark.`
     });
   });
 }
 var PROMO_DIR = "promo";
 function resolveRunRoot(projectDir) {
   if (typeof projectDir !== "string" || !projectDir.trim()) return process.cwd();
-  const abs = resolve11(projectDir.trim());
-  if (!existsSync26(abs) || !statSync4(abs).isDirectory()) {
+  const abs = resolve12(projectDir.trim());
+  if (!existsSync27(abs) || !statSync4(abs).isDirectory()) {
     throw new Error(`project_dir is not an existing directory: ${abs}`);
   }
   const root = basename5(abs) === PROMO_DIR ? abs : join33(abs, PROMO_DIR);