@jokerized/decksmith 0.3.1 → 0.3.2

package/dist/mcp.js

@@ -5,7 +5,7 @@ import { homedir as homedir3 } from "node:os";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-import { z as z5 } from "zod";
+import { z as z6 } from "zod";
 
 // src/version.ts
 import { createRequire } from "node:module";
@@ -13,17 +13,232 @@ var VERSION = createRequire(import.meta.url)("../package.json").version;
 
 // src/mcp/tools.ts
 import { randomBytes } from "node:crypto";
-import { mkdir as mkdir10, readFile as readFile12 } from "node:fs/promises";
+import { mkdir as mkdir11, mkdtemp as mkdtemp3, readFile as readFile13, rm as rm8 } from "node:fs/promises";
 import { tmpdir as tmpdir3 } from "node:os";
-import { isAbsolute, join as join12, resolve as resolve5, sep as sep2 } from "node:path";
-import { z as z4 } from "zod";
+import { basename as basename4, isAbsolute as isAbsolute2, join as join13, resolve as resolve6, sep as sep2 } from "node:path";
+import { zipSync as zipSync2 } from "fflate";
+import { z as z5 } from "zod";
 
 // src/index.ts
-import { cp, mkdir as mkdir8, readdir, readFile as readFile10, stat, writeFile as writeFile10 } from "node:fs/promises";
+import { cp, mkdir as mkdir9, readdir as readdir2, readFile as readFile11, stat as stat2, writeFile as writeFile11 } from "node:fs/promises";
 import { createRequire as createRequire2 } from "node:module";
-import { dirname as dirname3, join as join10, resolve as resolve3 } from "node:path";
+import { dirname as dirname3, join as join11, resolve as resolve4 } from "node:path";
 import { fileURLToPath } from "node:url";
 
+// src/pack/media.ts
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { extname } from "node:path";
+var PLAYERS = [
+  "youtube.com",
+  "youtube-nocookie.com",
+  "youtu.be",
+  "vimeo.com",
+  "dailymotion.com",
+  "dai.ly",
+  "twitch.tv",
+  "loom.com",
+  "wistia.com",
+  "wistia.net",
+  "streamable.com",
+  "bilibili.com",
+  "soundcloud.com",
+  "tiktok.com"
+];
+var FILE_EXT = /* @__PURE__ */ new Set([
+  ".png",
+  ".jpg",
+  ".jpeg",
+  ".gif",
+  ".webp",
+  ".avif",
+  ".svg",
+  ".mp4",
+  ".webm",
+  ".mov",
+  ".m4v",
+  ".mp3",
+  ".m4a",
+  ".wav",
+  ".ogg",
+  ".opus",
+  ".pdf"
+]);
+function isEmbed(url) {
+  const host2 = hostOf(url);
+  return host2 !== null && PLAYERS.some((p) => host2 === p || host2.endsWith(`.${p}`));
+}
+function segments(u) {
+  return u.pathname.split("/").filter(Boolean);
+}
+function token(raw2) {
+  return raw2 && /^[A-Za-z0-9_-]{1,64}$/.test(raw2) ? raw2 : void 0;
+}
+var YOUTUBE_EMBED = "https://www.youtube-nocookie.com";
+var youtube = (id2) => id2 === void 0 ? void 0 : `${YOUTUBE_EMBED}/embed/${id2}`;
+var YOUTUBE = {
+  origin: YOUTUBE_EMBED,
+  embed: (u) => {
+    const seg = segments(u);
+    const path2 = seg[0];
+    return youtube(
+      token(
+        path2 === "watch" ? u.searchParams.get("v") : path2 === "embed" || path2 === "shorts" || path2 === "live" || path2 === "v" ? seg[1] : void 0
+      )
+    );
+  }
+};
+var YOUTU_BE = {
+  origin: YOUTUBE_EMBED,
+  embed: (u) => youtube(token(segments(u)[0]))
+};
+var VIMEO_EMBED = "https://player.vimeo.com";
+var VIMEO = {
+  origin: VIMEO_EMBED,
+  embed: (u) => {
+    const seg = segments(u);
+    const [head, next] = seg[0] === "video" ? [seg[1], seg[2]] : [seg[0], seg[1]];
+    if (head === void 0 || !/^\d+$/.test(head)) return void 0;
+    const hash = token(next ?? u.searchParams.get("h"));
+    return `${VIMEO_EMBED}/video/${head}?${hash ? `h=${hash}&` : ""}dnt=1`;
+  }
+};
+var DAILYMOTION_EMBED = "https://www.dailymotion.com";
+var dailymotion = (id2) => id2 === void 0 ? void 0 : `${DAILYMOTION_EMBED}/embed/video/${id2}`;
+var DAILYMOTION = {
+  origin: DAILYMOTION_EMBED,
+  embed: (u) => {
+    const seg = segments(u);
+    return dailymotion(
+      token(seg[0] === "video" ? seg[1] : seg[0] === "embed" ? seg[2] : void 0)
+    );
+  }
+};
+var DAI_LY = {
+  origin: DAILYMOTION_EMBED,
+  embed: (u) => dailymotion(token(segments(u)[0]))
+};
+var LOOM = {
+  origin: "https://www.loom.com",
+  embed: (u) => {
+    const seg = segments(u);
+    const id2 = token(seg[0] === "share" || seg[0] === "embed" ? seg[1] : void 0);
+    return id2 === void 0 ? void 0 : `https://www.loom.com/embed/${id2}`;
+  }
+};
+var EMBEDS = {
+  "youtube.com": YOUTUBE,
+  "youtube-nocookie.com": YOUTUBE,
+  "youtu.be": YOUTU_BE,
+  "vimeo.com": VIMEO,
+  "dailymotion.com": DAILYMOTION,
+  "dai.ly": DAI_LY,
+  "loom.com": LOOM
+};
+var EMBED_ORIGINS = [
+  ...new Set(Object.values(EMBEDS).map((e) => e.origin))
+];
+function embedUrl(url) {
+  const host2 = hostOf(url);
+  if (host2 === null) return void 0;
+  let u;
+  try {
+    u = new URL(url);
+  } catch {
+    return void 0;
+  }
+  if (u.protocol !== "https:" && u.protocol !== "http:") return void 0;
+  const rule = Object.entries(EMBEDS).find(([h]) => host2 === h || host2.endsWith(`.${h}`))?.[1];
+  return rule?.embed(u);
+}
+function policyFor(url, prefer) {
+  if (isEmbed(url)) return "embed";
+  const host2 = hostOf(url);
+  if (host2 === null || /^data:/i.test(url)) return "bake";
+  if (prefer === "link") return "link";
+  return FILE_EXT.has(extOf(url)) ? "bake" : "link";
+}
+async function planMedia(assets, fetcher = fetchAsset) {
+  const plan = {
+    media: [],
+    files: {},
+    bakedCount: 0,
+    bakedBytes: 0,
+    demoted: [],
+    promoted: []
+  };
+  for (const asset of assets) {
+    const policy = policyFor(asset.url, asset.prefer);
+    if (policy !== "bake") {
+      if (asset.prefer === "bake") plan.demoted.push(asset.id);
+      plan.media.push({ id: asset.id, policy, url: asset.url, mime: asset.mime });
+      continue;
+    }
+    if (asset.prefer === "link") plan.promoted.push(asset.id);
+    const got = await fetcher(asset.url);
+    const mime = clean(got.mime) ?? asset.mime;
+    if (mime === "text/html") {
+      plan.demoted.push(asset.id);
+      plan.media.push({ id: asset.id, policy: "link", url: asset.url, mime });
+      continue;
+    }
+    const path2 = `media/${bakedName(asset.id, asset.url, mime)}`;
+    plan.files[path2] = got.bytes;
+    plan.bakedCount += 1;
+    plan.bakedBytes += got.bytes.length;
+    plan.media.push({ id: asset.id, policy: "bake", path: path2, mime, bytes: got.bytes.length });
+  }
+  return plan;
+}
+function bakedName(id2, url, mime) {
+  const slug = id2.toLowerCase().replace(/[^a-z0-9_-]+/g, "-") || "asset";
+  const hash = createHash("sha256").update(url).digest("hex").slice(0, 8);
+  return `${slug}-${hash}${extOf(url) || extFor(mime)}`;
+}
+function extOf(url) {
+  const path2 = hostOf(url) === null ? url : new URL(url).pathname;
+  const ext = extname(path2).toLowerCase();
+  return FILE_EXT.has(ext) ? ext : "";
+}
+var MIME_EXT = {
+  "image/png": ".png",
+  "image/jpeg": ".jpg",
+  "image/gif": ".gif",
+  "image/webp": ".webp",
+  "image/avif": ".avif",
+  "image/svg+xml": ".svg",
+  "video/mp4": ".mp4",
+  "video/webm": ".webm",
+  "audio/mpeg": ".mp3",
+  "application/pdf": ".pdf"
+};
+function extFor(mime) {
+  return (mime && MIME_EXT[mime]) ?? ".bin";
+}
+function hostOf(url) {
+  try {
+    const u = new URL(url);
+    if (u.protocol === "file:" || u.protocol === "data:") return null;
+    return u.hostname.toLowerCase().replace(/^www\./, "");
+  } catch {
+    return null;
+  }
+}
+function clean(mime) {
+  return mime?.split(";")[0]?.trim().toLowerCase() || void 0;
+}
+async function fetchAsset(url) {
+  if (/^(https?|data):/i.test(url)) {
+    const res = await fetch(url);
+    if (!res.ok) throw new Error(`${url}: HTTP ${res.status}`);
+    return {
+      bytes: new Uint8Array(await res.arrayBuffer()),
+      mime: res.headers.get("content-type") ?? void 0
+    };
+  }
+  return { bytes: new Uint8Array(await readFile(url)) };
+}
+
 // src/types.ts
 import { z } from "zod";
 var refSchema = z.object({
@@ -32,9 +247,34 @@ var refSchema = z.object({
 });
 var figureSchema = z.object({
   id: z.string(),
+  /**
+   * WHAT THE ASSET IS. A CLIP IS A FIGURE.
+   *
+   * A harvested page hands back stills and video in one pass, and the obvious
+   * shape for the video — a fifth `Source` array and a fifth `refSchema` kind —
+   * costs every layer that already knows what a figure is: the inventory
+   * `renderSource` prints, `assertRefsResolve`, the archetypes that take a
+   * `figureId`, and the pack. All of them would need a second word for "the
+   * thing this beat points at", and `refSchema` is a CLOSED enum of four kinds
+   * that a fifth entry would put into every stored plan's schema. A clip is a
+   * rectangle with intrinsic pixels and a caption that a beat points at, which
+   * is what a figure is; what differs is one branch at emit.
+   *
+   * DEFAULTED rather than required, and that is the whole point of the field
+   * being an enum with a default: every `source.json` written before clips
+   * existed parses unchanged and comes back an `image`, which is what it has
+   * always been.
+   */
+  kind: z.enum(["image", "clip"]).default("image"),
   /** Path relative to the deck's asset directory. */
   src: z.string(),
   caption: z.string(),
+  /**
+   * The intrinsic pixel size layout keys off — for a clip, the VIDEO's own
+   * dimensions, not the poster's. Every fit, crop and leader-line fraction
+   * downstream is expressed against this box, so a clip whose poster was
+   * letterboxed to another shape would put every annotation in the wrong place.
+   */
   width: z.int().positive(),
   height: z.int().positive(),
   /**
@@ -52,7 +292,26 @@ var figureSchema = z.object({
    */
   sectionId: z.string().optional(),
   /** The sentence or paragraph that refers to it, verbatim from the document. */
-  mention: z.string().optional()
+  mention: z.string().optional(),
+  // THE THREE FIELDS ONLY A CLIP USES. All optional, for the same reason `kind`
+  // is defaulted: an image carries none of them, and a source written before
+  // clips existed parses into exactly the object it always did.
+  /**
+   * The local still that represents the clip — what the deck shows before
+   * anyone presses play, and what stands in wherever the video cannot run at
+   * all. A clip whose video could not be downloaded is this still and nothing
+   * else, so it is the picture the beat is really planned around.
+   */
+  poster: z.string().optional(),
+  /** How long the clip runs. Seconds, as measured off the file, never guessed. */
+  seconds: z.number().positive().optional(),
+  /**
+   * The page the video lives ON, when the video itself is not a file we can
+   * fetch — a player page, an embed, anything whose terms or DRM make the bytes
+   * unavailable. Then `poster` is all the deck can show, and this is where a
+   * viewer goes to watch the thing. Absent for a clip we hold the file for.
+   */
+  href: z.string().optional()
 });
 var equationSchema = z.object({
   id: z.string(),
@@ -910,8 +1169,8 @@ function clock(seconds) {
 }
 
 // src/source/fonts.ts
-import { createHash } from "node:crypto";
-import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { createHash as createHash2 } from "node:crypto";
+import { mkdir, readFile as readFile2, writeFile } from "node:fs/promises";
 import { join } from "node:path";
 function familyFor(lang) {
   const tag = lang.toLowerCase();
@@ -925,11 +1184,11 @@ async function bundleFont(lang, glyphs, dir) {
   const family = familyFor(lang);
   if (!family) return null;
   const text2 = [...new Set(glyphs)].filter((c) => c > " ").sort().join("");
-  const stamp = `/* decksmith ${createHash("sha256").update(`${family}
+  const stamp = `/* decksmith ${createHash2("sha256").update(`${family}
 ${text2}`).digest("hex").slice(0, 16)} */`;
   await mkdir(dir, { recursive: true });
   const cssPath = join(dir, "fonts.css");
-  const cached = await readFile(cssPath, "utf8").catch(() => "");
+  const cached = await readFile2(cssPath, "utf8").catch(() => "");
   if (cached.startsWith(stamp)) return { family, css: cached, files: localNames(cached) };
   const res = await fetch(
     `https://fonts.googleapis.com/css2?family=${family.replaceAll(" ", "+")}:wght@400;500;700&text=${encodeURIComponent(text2)}&display=block`,
@@ -1811,11 +2070,11 @@ function unwidow(text2, width, size, weight = 700, face = "latin") {
 function wrapTokens(tokens, size, width, weight, face) {
   const lines = [];
   let line2 = "";
-  for (const token of tokens) {
-    const candidate = line2 ? `${line2} ${token}` : token;
+  for (const token2 of tokens) {
+    const candidate = line2 ? `${line2} ${token2}` : token2;
     if (line2 && textWidth(candidate, size, weight, 0, false, face) > width) {
       lines.push(line2);
-      line2 = token;
+      line2 = token2;
       continue;
     }
     line2 = candidate;
@@ -2165,6 +2424,11 @@ var annotatedFigure = (beat, ctx) => {
       `annotated-figure ${beat.id}: no figure "${p.figureId}" in source ${ctx.source.id}`
     );
   }
+  if (fig.kind === "clip") {
+    throw new Error(
+      `annotated-figure ${beat.id}: figure "${fig.id}" is a clip, and notes can only be pinned to a still \u2014 use claim-figure, which plays it, or point this beat at the clip's poster as a figure of its own`
+    );
+  }
   const crop = p.crop;
   const view = crop ? { width: fig.width * crop.w, height: fig.height * crop.h } : { width: fig.width, height: fig.height };
   const clamp3 = (v) => Math.min(1, Math.max(0, v));
@@ -2183,7 +2447,7 @@ var annotatedFigure = (beat, ctx) => {
   }
   const plan = planFigure(STAGE_W, notes, view, budget2, isPortrait(ctx.format), face);
   const stageH = plan.height;
-  const plate = {
+  const plate2 = {
     x: plan.img.x - PLATE,
     y: plan.img.y - PLATE,
     w: plan.img.w + 2 * PLATE,
@@ -2337,7 +2601,7 @@ var annotatedFigure = (beat, ctx) => {
       // Per-scene geometry: the overlay is only correct because the image box is
       // stated rather than negotiated with the layout engine.
       `#${sid}-stage{width:${STAGE_W}px;height:${n(stageH)}px;margin-top:${STAGE_GAP}px}`,
-      `#${sid}-plate{left:${n(plate.x)}px;top:${n(plate.y)}px;width:${n(plate.w)}px;height:${n(plate.h)}px}`,
+      `#${sid}-plate{left:${n(plate2.x)}px;top:${n(plate2.y)}px;width:${n(plate2.w)}px;height:${n(plate2.h)}px}`,
       // `overflow:visible` because a dot sitting on the figure's own edge puts its
       // halo outside the viewBox, and a clipped halo reads as a rendering fault.
       `#${sid}-ov{position:absolute;left:0;top:0;overflow:visible}`,
@@ -2793,6 +3057,31 @@ var CLAIM_LH = 1.5;
 var CLAIM_RULE = 6 + 32;
 var BESIDE_COL = 560;
 var MIN_PLATE = 2 * Math.round(BODY_SIZE * BODY_LH);
+function plate(fig, sid, beatId, start) {
+  const img = (src) => ({
+    html: `<img src="assets/${esc(src)}" alt="${esc(fig.caption)}" />`,
+    el: "img"
+  });
+  if (fig.kind !== "clip") return img(fig.src);
+  if (fig.href !== void 0) {
+    if (fig.poster === void 0) {
+      throw new Error(
+        `claim-figure ${beatId}: figure "${fig.id}" is a clip we hold no file for and no still of \u2014 re-ingest it so its poster is measured, or point the beat at a figure this deck has`
+      );
+    }
+    return img(fig.poster);
+  }
+  if (start === void 0) {
+    throw new Error(
+      `claim-figure ${beatId}: figure "${fig.id}" is a clip, and nobody said when this scene starts \u2014 the video is seeked on the deck's absolute clock, so \`EmitContext.start\` has to be passed`
+    );
+  }
+  const poster = fig.poster === void 0 ? "" : ` poster="assets/${esc(fig.poster)}"`;
+  return {
+    html: `<video id="${sid}-v" src="assets/${esc(fig.src)}"${poster} data-start="${start}" preload="auto" playsinline muted></video>`,
+    el: "video"
+  };
+}
 var claimFigure = (beat, ctx) => {
   const { sid, theme } = ctx;
   const p = beat.params;
@@ -2832,7 +3121,8 @@ var claimFigure = (beat, ctx) => {
     );
   }
   const claim = `<div class="claim" id="${sid}-c">${words(p.claim)}</div>`;
-  const figure = `<div class="figwrap" id="${sid}-f"><img src="assets/${esc(fig.src)}" alt="${esc(fig.caption)}" /></div>`;
+  const held = plate(fig, sid, beat.id, ctx.start);
+  const figure = `<div class="figwrap" id="${sid}-f">${held.html}</div>`;
   const caption = `<div class="caption" id="${sid}-cap">${esc(fig.caption)}</div>`;
   const body = tall ? `<div class="cf-stack">${claim}
 <div>${figure}
@@ -2900,12 +3190,22 @@ ${body}`,
       // Height-capped rather than width-driven: a square figure in the beside
       // layout would otherwise be ~970px tall and run off the canvas. The cap is
       // the measured remainder, not a constant — see `figMax`.
-      `.figwrap img{max-width:100%;max-height:${figMax}px;width:auto;height:auto;display:block}`,
+      //
+      // NAMED FOR THE TAG THAT IS ACTUALLY THERE rather than written for both.
+      // A rule listing `img, video` would move the bytes of every deck we have
+      // ever built to describe an element almost none of them contain, and a
+      // rule naming only `img` over a clip is a cap that silently does not
+      // apply — the video would render at its natural 1920x1080 and run off the
+      // canvas, which is invariant-5 territory that no gate reads.
+      `.figwrap ${held.el}{max-width:100%;max-height:${figMax}px;width:auto;height:auto;display:block}`,
       `.caption{font-size:${BODY_SIZE}px;line-height:${BODY_LH};color:${theme.dim};margin-top:16px}`,
       // The image, not its wrapper: the wrapper's entrance already writes
       // `transform`. 1.2% of the 550px cap is 3.3px a side, which the wrapper's
-      // 16px padding absorbs — the swell can never reach the canvas edge.
-      ambient(sid, "-f img", DRIFT)
+      // 16px padding absorbs — the swell can never reach the canvas edge. Same
+      // reason as the cap above for naming the tag: a drift rule aimed at `img`
+      // over a `<video>` is one ambient rule that animates nothing, and the
+      // slide reads as dead rather than as held.
+      ambient(sid, `-f ${held.el}`, DRIFT)
     ].join("\n")
   };
 };
@@ -3025,8 +3325,8 @@ var dataTable = (beat, ctx) => {
   p.highlight.forEach((h, i) => {
     const index = shown.findIndex((row) => row[0] === h.row);
     if (index < 0) {
-      const why = table.rows.some((row) => row[0] === h.row) ? `no row labelled "${h.row}" is drawn \u2014 table ${table.id} has one, but params.rows left it out` : `no row labelled "${h.row}" in table ${table.id}`;
-      throw new Error(`data-table ${beat.id}: ${why}`);
+      const why2 = table.rows.some((row) => row[0] === h.row) ? `no row labelled "${h.row}" is drawn \u2014 table ${table.id} has one, but params.rows left it out` : `no row labelled "${h.row}" in table ${table.id}`;
+      throw new Error(`data-table ${beat.id}: ${why2}`);
     }
     const at = settled + 0.3 + i * step;
     tl.push(
@@ -3341,14 +3641,14 @@ var MORPH_SECONDS = 1.6;
 var equationMorph = (beat, ctx) => {
   const { sid, theme } = ctx;
   const p = beat.params;
-  const find2 = (id2) => {
+  const find3 = (id2) => {
     const eq = ctx.source.equations.find((e) => e.id === id2);
     if (!eq)
       throw new Error(`equation-morph ${beat.id}: no equation "${id2}" in source ${ctx.source.id}`);
     return eq;
   };
-  const a = find2(p.fromId);
-  const b = find2(p.toId);
+  const a = find3(p.fromId);
+  const b = find3(p.toId);
   const both = p.terms.filter((t2) => locate(a.tex, t2.tex) && locate(b.tex, t2.tex));
   if (both.length === 0) {
     throw new Error(
@@ -3558,10 +3858,10 @@ var grid = (beat, ctx) => {
       h: r.h * y0.w + (r.h - 1) * f.gap + 2 * bleed
     };
   };
-  const boxes = p.regions.map(boxOf);
+  const boxes3 = p.regions.map(boxOf);
   const lx = W - gutter + 40;
   const outside = p.regions.map((r, i) => ({ r, i })).filter(({ i }) => inGutter[i]).map(({ r, i }) => {
-    const b = boxes[i] ?? { x: fx, y: fy, w: f.cell, h: f.cell };
+    const b = boxes3[i] ?? { x: fx, y: fy, w: f.cell, h: f.cell };
     const half = lines(r) * LABEL * LH / 2;
     return { i, half, y: b.y + b.h / 2, from: { x: b.x + b.w, y: b.y + b.h / 2 } };
   }).sort((a, b) => a.y - b.y || a.i - b.i);
@@ -3579,7 +3879,7 @@ var grid = (beat, ctx) => {
   const parts = {};
   p.regions.forEach((r, i) => {
     parts[`rgn${i}`] = r.label;
-    const b = boxes[i] ?? { x: fx, y: fy, w: f.cell, h: f.cell };
+    const b = boxes3[i] ?? { x: fx, y: fy, w: f.cell, h: f.cell };
     const tone2 = theme.tones[r.tone];
     rects.push(
       `<defs><clipPath id="${id(sid, "rgnclip", i)}">${rect({ x: b.x, y: b.y, w: 0, h: b.h }, { id: id(sid, "sweep", i) })}</clipPath></defs>` + roundRect(b, corner, {
@@ -3687,7 +3987,7 @@ var grid = (beat, ctx) => {
   tl.push(...dimCells);
   p.regions.forEach((_, i) => {
     const at = first + i * step;
-    const b = boxes[i] ?? { x: 0, y: 0, w: 0, h: 0 };
+    const b = boxes3[i] ?? { x: 0, y: 0, w: 0, h: 0 };
     tl.push(
       tween(
         `#${id(sid, "rgn", i)}`,
@@ -4087,12 +4387,12 @@ function balance(label, k, face) {
   if (cur.length > 0) lines.push(cur.join(" "));
   return lines;
 }
-function centre(boxes, i) {
-  const b = boxes[i];
+function centre(boxes3, i) {
+  const b = boxes3[i];
   return b ? b.x + b.w / 2 : 0;
 }
-function loopLabelWidth(boxes, from, to, stageW) {
-  const mid = (centre(boxes, from) + centre(boxes, to)) / 2;
+function loopLabelWidth(boxes3, from, to, stageW) {
+  const mid = (centre(boxes3, from) + centre(boxes3, to)) / 2;
   return Math.max(NOTE * 6, Math.min(stageW - 2 * M - 80, 2 * Math.min(mid, stageW - mid) - 40));
 }
 function widest(lines, face) {
@@ -4125,11 +4425,11 @@ function pipeLayout(stageW, stages, loop, face = "latin") {
   let fit = solve(stages, capped, stageW, face);
   if (!fit.ok && capped < width) fit = solve(stages, width, stageW, face);
   const size = Math.max(MIN_FONT, Math.floor(fit.size));
-  const boxes = fit.boxes;
-  const innerW = Math.max(size, (boxes[0]?.w ?? width) - 2 * PAD_X_EM * size);
+  const boxes3 = fit.boxes;
+  const innerW = Math.max(size, (boxes3[0]?.w ?? width) - 2 * PAD_X_EM * size);
   const labelLines = stages.map((s) => wrap(s.label, size, innerW, 600, 0, face));
   const noteLines = stages.map((s) => s.note ? wrap(s.note, NOTE, innerW, 400, 0, face) : []);
-  const boxW = boxes[0]?.w ?? width;
+  const boxW = boxes3[0]?.w ?? width;
   const need = Math.max(
     MIN_BOX_H,
     Math.min(MAX_BOX_H, boxW * BOX_ASPECT),
@@ -4139,15 +4439,15 @@ function pipeLayout(stageW, stages, loop, face = "latin") {
       return Math.ceil(2 * PAD_Y2 + label + (note > 0 ? NOTE_TOP + note * NOTE * NOTE_LH : 0));
     })
   );
-  const loopLines = loop ? wrap(loop.label, NOTE, loopLabelWidth(boxes, loop.from, loop.to, stageW), 500, 0, face) : [];
+  const loopLines = loop ? wrap(loop.label, NOTE, loopLabelWidth(boxes3, loop.from, loop.to, stageW), 500, 0, face) : [];
   const below = loop ? LOOP_TOP + LOOP_LABEL_TOP + loopLines.length * NOTE * NOTE_LH + LOOP_BOTTOM : M;
   const boxH = need;
   return {
     size,
-    boxes,
+    boxes: boxes3,
     boxH,
     boxX: M,
-    boxW: boxes[0]?.w ?? width,
+    boxW: boxes3[0]?.w ?? width,
     vertical: false,
     innerW,
     labelLines,
@@ -4475,6 +4775,11 @@ var splitCompare = (beat, ctx) => {
     if (fig.width <= 0 || fig.height <= 0) {
       throw new Error(`split-compare ${beat.id}: figure "${fig.id}" has no usable dimensions`);
     }
+    if (fig.kind === "clip") {
+      throw new Error(
+        `split-compare ${beat.id}: the ${NAME[i]} figure "${fig.id}" is a clip, and a side draws a still <image> \u2014 use claim-figure, which plays it, or point this side at the clip's poster as a figure of its own`
+      );
+    }
     return fig;
   });
   sides.forEach((side, i) => {
@@ -4773,9 +5078,9 @@ var clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
 function stackLayout(p, format, face = "latin") {
   const stacked = solve2(p, format, false, face);
   if (stacked.fits || !p.layers.some((l) => l.note)) return stacked;
-  const inline = solve2(p, format, true, face);
-  if (inline.fits) return inline;
-  return inline.wide && inline.blockH < stacked.blockH ? inline : stacked;
+  const inline2 = solve2(p, format, true, face);
+  if (inline2.fits) return inline2;
+  return inline2.wide && inline2.blockH < stacked.blockH ? inline2 : stacked;
 }
 function labelWeight(i, count) {
   return i === count - 1 ? 700 : 600;
@@ -4784,7 +5089,7 @@ function floorFor(p, format) {
   if (!p.tilt) return MIN_FONT;
   return tiltedFloor({ ...DEFAULT_POSE, rotateX: p.tilt }, contentH(format), MIN_FONT);
 }
-function solve2(p, format, inline, face) {
+function solve2(p, format, inline2, face) {
   const width = contentW(format);
   const boxH = contentH(format);
   const floor = floorFor(p, format);
@@ -4793,15 +5098,15 @@ function solve2(p, format, inline, face) {
   const riseMax = RISE_MAX[k];
   const syMax = SY_MAX[k];
   const tMax = T_MAX[k];
-  const noteW = (l) => inline && l.note !== void 0 ? textWidth(l.note, floor, 400, 0, false, face) + 28 : 0;
+  const noteW = (l) => inline2 && l.note !== void 0 ? textWidth(l.note, floor, 400, 0, false, face) + 28 : 0;
   const want = Math.max(
     ...p.layers.map(
       (l, i) => textWidth(l.label, LABEL_SIZE2, labelWeight(i, count), 0, false, face) + noteW(l)
     )
   );
-  const colCap = inline ? width * 0.56 : width * 0.5;
+  const colCap = inline2 ? width * 0.56 : width * 0.5;
   const colW = clamp(Math.ceil(want) + 12, Math.min(520, width * 0.34), colCap);
-  const wide = !inline || Math.ceil(want) + 12 <= colCap;
+  const wide = !inline2 || Math.ceil(want) + 12 <= colCap;
   const labelX = width - colW;
   const labelRoom = Math.min(
     ...p.layers.map(
@@ -4816,14 +5121,14 @@ function solve2(p, format, inline, face) {
       label: wrap(l.label, labelSize, labelMaxW, labelWeight(i, count), 0, face),
       // Inline notes stay on one line by contract — the schema calls a note "one
       // short line" — and wrapping one would put its second line under the label.
-      note: l.note === void 0 ? [] : inline ? [l.note] : wrap(l.note, floor, colW, 400, 0, face),
+      note: l.note === void 0 ? [] : inline2 ? [l.note] : wrap(l.note, floor, colW, 400, 0, face),
       noteW: nw,
       labelMaxW
     };
   });
   const blockH = Math.max(
     ...lines.map(
-      (l) => inline ? Math.max(l.label.length * labelSize, l.note.length * floor) * 1.16 : l.label.length * labelSize * 1.16 + (l.note.length > 0 ? 6 + l.note.length * floor * 1.16 : 0)
+      (l) => inline2 ? Math.max(l.label.length * labelSize, l.note.length * floor) * 1.16 : l.label.length * labelSize * 1.16 + (l.note.length > 0 ? 6 + l.note.length * floor * 1.16 : 0)
     )
   );
   const pad = Math.max(EDGE2, blockH / 2);
@@ -4845,7 +5150,7 @@ function solve2(p, format, inline, face) {
     fits: room >= blockH + 10 && height <= free && wide,
     floor,
     wide,
-    inline,
+    inline: inline2,
     width,
     height,
     avail,
@@ -5249,7 +5554,8 @@ function emitDeck(storyboard, source, format, runtimeJs, opts = {}) {
       format,
       laid.slides,
       runtimeJs,
-      narrationIsland(opts.narration, laid.spoken)
+      narrationIsland(opts.narration, laid.spoken),
+      videoIsland(laid.embeds)
     )
   };
 }
@@ -5260,17 +5566,20 @@ function planCut(storyboard, source, format, opts = {}) {
   const seconds = {};
   const undrawable = /* @__PURE__ */ new Set();
   floor.forEach((beat, i) => {
-    const segments = opts.narration?.beats[beat.id];
+    const segments2 = opts.narration?.beats[beat.id];
     let scene;
     try {
-      ({ scene } = stageScene(emitScene(beat, { source, format, theme, sid: `s${i + 1}` }), speed));
+      ({ scene } = stageScene(
+        emitScene(beat, { source, format, theme, sid: `s${i + 1}`, start: 0 }),
+        speed
+      ));
     } catch (err) {
       if (!opts.onBeatError) throw err;
       opts.onBeatError(beat.id, err instanceof Error ? err : new Error(String(err)));
       undrawable.add(beat.id);
       return;
     }
-    seconds[beat.id] = beatSeconds(beat.seconds * speed, scene, segments);
+    seconds[beat.id] = beatSeconds(beat.seconds * speed, scene, segments2);
   });
   if (floor.length > 0 && undrawable.size === floor.length) {
     throw new Error(`every one of ${floor.length} beat(s) failed to draw \u2014 there is no deck`);
@@ -5303,31 +5612,29 @@ function layout(storyboard, source, format, opts = {}) {
   const scenes = [];
   const slides = [];
   const spoken = {};
+  const embeds = {};
   const entered = enteredParts(beats);
+  let at = 0;
   const cuts = beats.map((beat, i) => {
     const sid = `s${i + 1}`;
-    const ctx = { source, format, theme, sid };
-    const segments = opts.narration?.beats[beat.id];
+    const ctx = { source, format, theme, sid, start: rnd(at) };
+    const segments2 = opts.narration?.beats[beat.id];
     const { scene } = stageScene(emitScene(beat, ctx), speed);
-    const seconds = beatSeconds(beat.seconds * speed, scene, segments);
+    const seconds = beatSeconds(beat.seconds * speed, scene, segments2);
     const inside = entered[i];
     const dive = inside ? { t0: rnd(seconds), dur: rnd(MOVE_SECONDS * speed), fade: rnd(FADE_SECONDS * speed) } : void 0;
-    return {
-      beat,
-      sid,
-      scene,
-      segments,
-      inside,
-      dive,
-      duration: dive ? seconds + diveTail(dive) : seconds
-    };
+    const duration = dive ? seconds + diveTail(dive) : seconds;
+    const start = at;
+    at += duration;
+    return { beat, sid, scene, segments: segments2, inside, dive, duration, start };
   });
-  let start = 0;
   let builds = false;
   const plugins = /* @__PURE__ */ new Set();
   cuts.forEach((cut2, i) => {
-    const { beat, sid, dive, inside, duration } = cut2;
+    const { beat, sid, dive, inside, duration, start } = cut2;
     if (cut2.segments?.length) spoken[sid] = cut2.segments;
+    const embed = playerEmbed(beat, source);
+    if (embed) embeds[sid] = embed;
     const next = cuts[i + 1];
     const over = next ? rnd(Math.min(HANDOFF_SECONDS * speed, next.duration)) : 0;
     let scene = cut2.scene;
@@ -5357,7 +5664,6 @@ function layout(storyboard, source, format, opts = {}) {
       notes: beat.narration ?? beat.intent,
       holds: scene.holds
     });
-    start += duration;
   });
   return {
     family,
@@ -5369,7 +5675,11 @@ function layout(storyboard, source, format, opts = {}) {
     scenes,
     slides,
     spoken,
-    total: start,
+    embeds,
+    // The clock after the last scene: the sum the map above finished with, which
+    // is the number the second pass used to arrive at by re-adding the same
+    // durations in the same order.
+    total: at,
     cut,
     builds,
     plugins
@@ -5420,23 +5730,23 @@ function openSeconds(scene) {
   const first = scene.holds.filter((h) => Number.isFinite(h) && h > 0).sort((a, b) => a - b)[0];
   return rnd(first ?? 0);
 }
-function beatSeconds(authored, scene, segments) {
-  if (!segments?.length) return authored;
+function beatSeconds(authored, scene, segments2) {
+  if (!segments2?.length) return authored;
   const lastHold = scene.holds.reduce((a, b) => Math.max(a, b), 0);
   const usable = [...new Set(scene.holds.filter((h) => Number.isFinite(h) && h > 0))].sort(
     (a, b) => a - b
   );
-  const ends = speechPlan(openSeconds(scene), usable, segments).end;
+  const ends = speechPlan(openSeconds(scene), usable, segments2).end;
   return Math.max(authored, lastHold + SETTLE_SECONDS, ends + SETTLE_SECONDS);
 }
 function stageScene(scene, speed) {
   const paced = pace(scene, speed);
   return { scene: paced, open: openSeconds(paced) };
 }
-function speechPlan(open, holds, segments) {
+function speechPlan(open, holds, segments2) {
   const starts = [];
   let at = open;
-  for (const [i, segment] of segments.entries()) {
+  for (const [i, segment] of segments2.entries()) {
     const hold = holds[Math.min(segment.stop, holds.length - 1)] ?? 0;
     if (i > 0) at = Math.max(at, hold);
     starts.push(at);
@@ -5528,9 +5838,9 @@ function narrationIsland(narration, scenes) {
     voice: narration.voice,
     dir: narration.dir,
     scenes: Object.fromEntries(
-      Object.entries(scenes).map(([sid, segments]) => [
+      Object.entries(scenes).map(([sid, segments2]) => [
         sid,
-        segments.map((s) => ({ stop: s.stop, audio: s.audio, seconds: s.seconds, cues: s.cues }))
+        segments2.map((s) => ({ stop: s.stop, audio: s.audio, seconds: s.seconds, cues: s.cues }))
       ])
     )
   };
@@ -5540,7 +5850,22 @@ function narrationIsland(narration, scenes) {
 ${json}
     </script>`;
 }
-function emitDeckPage(storyboard, format, slides, runtimeJs, narration) {
+function playerEmbed(beat, source) {
+  if (beat.archetype !== "claim-figure") return void 0;
+  const fig = source.figures.find((f) => f.id === beat.params.figureId);
+  if (fig?.kind !== "clip" || fig.href === void 0) return void 0;
+  const url = embedUrl(fig.href);
+  return url === void 0 ? void 0 : { url, title: fig.caption };
+}
+function videoIsland(clips) {
+  if (Object.keys(clips).length === 0) return "";
+  const json = JSON.stringify({ scenes: clips }, null, 2).replace(/</g, "\\u003c");
+  return `
+    <script type="application/decksmith-video+json">
+${json}
+    </script>`;
+}
+function emitDeckPage(storyboard, format, slides, runtimeJs, narration, video) {
   return `<!doctype html>
 <html lang="${esc(storyboard.lang)}">
   <head>
@@ -5559,7 +5884,7 @@ function emitDeckPage(storyboard, format, slides, runtimeJs, narration) {
       width="${format.width}"
       height="${format.height}"
     ></hyperframes-player>
-${emitIsland(slides)}${narration}
+${emitIsland(slides)}${narration}${video}
     <script>
 ${closeSafe(runtimeJs)}
     </script>
@@ -5711,7 +6036,7 @@ function readFragments(html) {
   return out;
 }
 function holdsFor(beat, source, format, theme, sid, speed) {
-  const ctx = { source, format, theme, sid };
+  const ctx = { source, format, theme, sid, start: 0 };
   const { scene, open } = stageScene(emitScene(beat, ctx), speed);
   return {
     holds: [...new Set(scene.holds.filter((h) => Number.isFinite(h) && h > 0))].sort(
@@ -5735,15 +6060,15 @@ function assertHoldsAgree(scenes, fragments) {
 function place(scenes, spoken) {
   const out = [];
   for (const scene of scenes) {
-    const segments = [...spoken[scene.id] ?? []].sort((a, b) => a.stop - b.stop);
-    if (segments.length === 0) continue;
+    const segments2 = [...spoken[scene.id] ?? []].sort((a, b) => a.stop - b.stop);
+    if (segments2.length === 0) continue;
     if (scene.holds.length === 0) {
       throw new Error(
         `${scene.id}: narrated but has no hold to speak at. Re-run \`narrate\` for this format.`
       );
     }
-    const { starts } = speechPlan(scene.open, scene.holds, segments);
-    for (const [i, segment] of segments.entries()) {
+    const { starts } = speechPlan(scene.open, scene.holds, segments2);
+    for (const [i, segment] of segments2.entries()) {
       const index = Math.min(segment.stop, scene.holds.length - 1);
       out.push({
         id: `${scene.id}.${segment.stop}`,
@@ -5759,9 +6084,9 @@ function place(scenes, spoken) {
   }
   return out;
 }
-function assertFits(scenes, segments) {
+function assertFits(scenes, segments2) {
   for (const scene of scenes) {
-    const mine = segments.filter((s) => s.scene === scene.id);
+    const mine = segments2.filter((s) => s.scene === scene.id);
     if (mine.length === 0) continue;
     const spoken = mine.reduce((sum, s) => sum + s.duration, 0);
     const need = scene.open + spoken;
@@ -5805,8 +6130,8 @@ function planTiming(input) {
     const staging = holdsFor(beat, source, format, theme, scene.id, speed);
     scene.holds = staging.holds;
     scene.open = staging.open;
-    const segments2 = narration?.beats[beat.id];
-    if (segments2?.length) spoken[scene.id] = segments2;
+    const segments3 = narration?.beats[beat.id];
+    if (segments3?.length) spoken[scene.id] = segments3;
   });
   const fragments = readFragments(composition);
   if (fragments) {
@@ -5815,18 +6140,18 @@ function planTiming(input) {
       fragments
     );
   }
-  const segments = place(scenes, spoken);
-  assertFits(scenes, segments);
+  const segments2 = place(scenes, spoken);
+  assertFits(scenes, segments2);
   return {
     version: 1,
     width: format.width,
     height: format.height,
     duration: readDuration(composition),
     lang: storyboard.lang,
-    audioDir: segments.length > 0 ? narration?.dir ?? "" : "",
-    voice: segments.length > 0 ? narration?.voice ?? "" : "",
+    audioDir: segments2.length > 0 ? narration?.dir ?? "" : "",
+    voice: segments2.length > 0 ? narration?.voice ?? "" : "",
     scenes,
-    segments
+    segments: segments2
   };
 }
 function framePlan(timing, fps) {
@@ -5838,12 +6163,12 @@ function framePlan(timing, fps) {
   for (const scene of timing.scenes) {
     const first = f(scene.start);
     const last = f(scene.start + scene.duration);
-    const segments = timing.segments.filter((s) => s.scene === scene.id).sort((a, b) => a.hold - b.hold || a.stop - b.stop);
-    if (segments.length === 0) {
+    const segments2 = timing.segments.filter((s) => s.scene === scene.id).sort((a, b) => a.hold - b.hold || a.stop - b.stop);
+    if (segments2.length === 0) {
       pieces.push({ from: first, motion: last - first, freeze: 0 });
       continue;
     }
-    const tail = segments[segments.length - 1];
+    const tail = segments2[segments2.length - 1];
     const silent = f(tail.start + tail.duration);
     if (silent > last) {
       throw new Error(
@@ -5851,7 +6176,7 @@ function framePlan(timing, fps) {
       );
     }
     pieces.push({ from: first, motion: last - first, freeze: 0 });
-    for (const segment of segments) {
+    for (const segment of segments2) {
       const at = f(segment.start);
       audio.push({
         id: segment.id,
@@ -5924,7 +6249,7 @@ function round5(n3) {
 }
 
 // src/source/markdown.ts
-import { createHash as createHash2 } from "node:crypto";
+import { createHash as createHash3 } from "node:crypto";
 import remarkGfm from "remark-gfm";
 import remarkMath from "remark-math";
 import remarkParse from "remark-parse";
@@ -5976,6 +6301,9 @@ function parseMarkdown(md, opts = {}) {
       for (const img of images) {
         const figure = {
           id: `fig${figures.length + 1}`,
+          // Markdown carries no video: an image node is an image. A clip only
+          // ever enters through `harvest`, which sets this itself.
+          kind: "image",
           src: img.url,
           caption: caption ?? img.alt ?? "",
           // 1x1 until assets.ts reads the actual bytes. The schema has no "unknown",
@@ -6011,7 +6339,7 @@ function parseMarkdown(md, opts = {}) {
     if (mention) p.figure.mention = mention;
   }
   return sourceSchema.parse({
-    id: opts.id ?? createHash2("sha256").update(md).digest("hex").slice(0, 12),
+    id: opts.id ?? createHash3("sha256").update(md).digest("hex").slice(0, 12),
     title: title2 || "Untitled",
     lang: opts.lang ?? sniffLang(md),
     sections,
@@ -6020,10 +6348,14 @@ function parseMarkdown(md, opts = {}) {
     tables
   });
 }
+var SCRIPT_SHARE = 0.02;
 function sniffLang(md) {
-  if (/[가-힣]/.test(md)) return "ko";
-  if (/[぀-ヿ]/.test(md)) return "ja";
-  if (/[一-鿿]/.test(md)) return "zh";
+  const total = md.replace(/\s+/g, "").length;
+  if (total === 0) return "en";
+  const share2 = (re) => (md.match(re)?.length ?? 0) / total;
+  if (share2(/[가-힣]/g) >= SCRIPT_SHARE) return "ko";
+  if (share2(/[぀-ヿ]/g) >= SCRIPT_SHARE) return "ja";
+  if (share2(/[一-鿿]/g) >= SCRIPT_SHARE) return "zh";
   return "en";
 }
 function onlyImages(kids) {
@@ -6044,7 +6376,11 @@ function mentionOf(caption, prose, at, opened) {
     const found = before ?? prose.find((p) => p.at > at && name.test(p.text));
     if (found) return found.text;
   }
-  return prose.filter((p) => p.at > opened && p.at < at).at(-1)?.text;
+  const near = prose.filter((p) => p.at > opened && p.at < at).at(-1)?.text;
+  return near !== void 0 && isSentence(near) ? near : void 0;
+}
+function isSentence(text2) {
+  return (text2.match(/[\p{L}\p{N}]+/gu) ?? []).length >= 3;
 }
 function figureName(caption) {
   const match = /^\s*(fig(?:ure)?\.?|그림|図|图)\s*([0-9]+)/i.exec(caption);
@@ -6104,91 +6440,2022 @@ function textOf(node) {
   }
 }
 
-// src/source/assets.ts
-import { createHash as createHash3 } from "node:crypto";
-import { mkdir as mkdir2, readFile as readFile2, writeFile as writeFile2 } from "node:fs/promises";
-import { extname, join as join2 } from "node:path";
-async function fetchFigures(source, dir) {
-  await mkdir2(dir, { recursive: true });
-  const figures = [];
-  for (const figure of source.figures) {
-    const name = assetName(figure.id, figure.src);
-    const bytes = await cache(join2(dir, name), figure.src);
-    figures.push({ ...figure, src: name, ...imageSize(bytes) });
-  }
-  return sourceSchema.parse({ ...source, figures });
-}
-function assetName(id2, src) {
-  const ext = extname(new URL(src, "file:///").pathname).toLowerCase().replace(/[^.a-z0-9]/g, "");
-  return `${id2}-${createHash3("sha256").update(src).digest("hex").slice(0, 8)}${ext || ".img"}`;
-}
-async function cache(path2, src) {
-  const hit = await readFile2(path2).catch(() => null);
-  if (hit) return hit;
-  let bytes;
-  if (/^https?:/i.test(src)) {
-    const res = await fetch(src);
-    if (!res.ok) throw new Error(`${src}: HTTP ${res.status}`);
-    bytes = Buffer.from(await res.arrayBuffer());
-  } else {
-    bytes = await readFile2(src);
+// src/source/harvest.ts
+import { createHash as createHash5 } from "node:crypto";
+import { copyFile, mkdir as mkdir3, rm as rm2, stat, writeFile as writeFile3 } from "node:fs/promises";
+import { basename as basename2, join as join4, resolve } from "node:path";
+
+// src/net/fetch.ts
+import { lookup as resolveHost } from "node:dns/promises";
+import { request as httpRequest } from "node:http";
+import { request as httpsRequest } from "node:https";
+import { isIP } from "node:net";
+import { brotliDecompressSync, gunzipSync } from "node:zlib";
+var BLOCKED_V4 = [
+  // "This network". Already in the original list as /^0\./, which is 0.0.0.0/8.
+  { re: /^0\./, why: "the unspecified network (0.0.0.0/8)" },
+  { re: /^10\./, why: "a private address (10.0.0.0/8)" },
+  // NEW: carrier-grade NAT. A mobile or datacentre network hands these out, and
+  // on a host that has one, the whole /10 is the neighbourhood.
+  {
+    re: /^100\.(6[4-9]|[7-9]\d|1[01]\d|12[0-7])\./,
+    why: "carrier-grade NAT space (100.64.0.0/10)"
+  },
+  { re: /^127\./, why: "loopback (127.0.0.0/8)" },
+  { re: /^169\.254\./, why: "link-local, where the cloud metadata service lives (169.254.0.0/16)" },
+  { re: /^172\.(1[6-9]|2\d|3[01])\./, why: "a private address (172.16.0.0/12)" },
+  // NEW: IETF protocol assignments — 192.0.0.8, the NAT64 well-known prefix and
+  // friends. Not routable on the public internet, so a URL pointing here is
+  // pointing at something local.
+  { re: /^192\.0\.0\./, why: "IETF protocol assignment space (192.0.0.0/24)" },
+  { re: /^192\.168\./, why: "a private address (192.168.0.0/16)" },
+  // NEW: benchmarking. Reserved for test equipment, and some networks route it
+  // internally precisely because it will never collide with anything real.
+  { re: /^198\.1[89]\./, why: "benchmarking space (198.18.0.0/15)" }
+];
+var USER_AGENT = `DeckSmith/${VERSION} (+https://github.com/ca1773130n/DeckSmith)`;
+function isBlockedAddress(ip) {
+  const bare = ip.trim().replace(/^\[|\]$/g, "").toLowerCase();
+  const kind = isIP(bare);
+  if (kind === 0) return `not an IP address (${ip})`;
+  if (kind === 4) {
+    for (const { re, why: why2 } of BLOCKED_V4) if (re.test(bare)) return why2;
+    return null;
   }
-  await writeFile2(path2, bytes);
-  return bytes;
-}
-function imageSize(b) {
-  if (b.length >= 24 && b.readUInt32BE(0) === 2303741511)
-    return { width: b.readUInt32BE(16), height: b.readUInt32BE(20) };
-  if (b.length >= 10 && b.toString("latin1", 0, 4) === "GIF8")
-    return { width: b.readUInt16LE(6), height: b.readUInt16LE(8) };
-  if (b.length >= 4 && b.readUInt16BE(0) === 65496) return jpegSize(b);
-  throw new Error("unrecognised image header (expected PNG, JPEG or GIF)");
+  const groups = expandV6(bare);
+  if (groups === null) return `not an IP address (${ip})`;
+  if (groups.every((n3) => n3 === 0)) return "the unspecified address (::)";
+  if (groups.slice(0, 7).every((n3) => n3 === 0) && groups[7] === 1) return "IPv6 loopback (::1)";
+  const embedded = groups.slice(0, 5).every((n3) => n3 === 0) && (groups[5] === 65535 || groups[5] === 0);
+  if (embedded) {
+    const hi = groups[6] ?? 0;
+    const lo = groups[7] ?? 0;
+    return isBlockedAddress(`${hi >> 8}.${hi & 255}.${lo >> 8}.${lo & 255}`);
+  }
+  const top = groups[0] ?? 0;
+  if ((top & 65472) === 65152) return "IPv6 link-local (fe80::/10)";
+  if ((top & 65024) === 64512) return "IPv6 unique-local (fc00::/7)";
+  return null;
 }
-function jpegSize(b) {
-  let i = 2;
-  while (i + 9 < b.length) {
-    if (b[i] !== 255) {
-      i++;
-      continue;
+function expandV6(v6) {
+  let text2 = v6;
+  const quad = /(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})$/.exec(text2);
+  if (quad?.[1]) {
+    const [a = 0, b = 0, c = 0, d = 0] = quad[1].split(".").map(Number);
+    const head = text2.slice(0, text2.length - quad[1].length);
+    text2 = `${head}${(a << 8 | b).toString(16)}:${(c << 8 | d).toString(16)}`;
+  }
+  const halves = text2.split("::");
+  if (halves.length > 2) return null;
+  const left = halves[0] ? halves[0].split(":") : [];
+  const right = halves.length === 2 ? halves[1] ? halves[1].split(":") : [] : null;
+  const fill = 8 - left.length - (right?.length ?? 0);
+  if (right !== null && fill < 0) return null;
+  const parts = right === null ? left : [...left, ...new Array(fill).fill("0"), ...right];
+  if (parts.length !== 8) return null;
+  const groups = parts.map((p) => Number.parseInt(p, 16));
+  return groups.every((n3) => Number.isInteger(n3) && n3 >= 0 && n3 <= 65535) ? groups : null;
+}
+function isLoopback(ip) {
+  const bare = ip.trim().replace(/^\[|\]$/g, "").toLowerCase();
+  return /^127\./.test(bare) || bare === "::1" || /^::ffff:127\./.test(bare);
+}
+var MAX_REDIRECTS = 5;
+var WEB_PORTS = /* @__PURE__ */ new Set([80, 443]);
+var REDIRECTS = /* @__PURE__ */ new Set([301, 302, 303, 307, 308]);
+var CREDENTIALS = ["authorization", "cookie"];
+async function fetchGuarded(url, opts) {
+  const signal = AbortSignal.timeout(opts.timeoutMs);
+  let target;
+  try {
+    target = new URL(url);
+  } catch {
+    throw new Error(`refusing ${url}: not a URL. Give an absolute http:// or https:// URL.`);
+  }
+  let headers = lowercased(opts.headers);
+  for (let hop = 0; ; hop++) {
+    if (hop > MAX_REDIRECTS) {
+      throw new Error(
+        `refusing ${url}: more than ${MAX_REDIRECTS} redirects, last to ${target.href}. Link the final URL directly.`
+      );
     }
-    const marker = b[i + 1];
-    if (marker === void 0) break;
-    if (marker === 255) {
-      i++;
+    const res = await send(url, target, headers, signal, opts);
+    const status = res.statusCode ?? 0;
+    if (REDIRECTS.has(status)) {
+      const location = res.headers.location;
+      res.destroy();
+      if (location === void 0) {
+        throw new Error(`refusing ${url}: HTTP ${status} from ${target.href} with no Location.`);
+      }
+      let next;
+      try {
+        next = new URL(location, target);
+      } catch {
+        throw new Error(
+          `refusing ${url}: HTTP ${status} to an unparseable Location (${location}).`
+        );
+      }
+      const sameOrigin = next.protocol === target.protocol && next.hostname === target.hostname && next.port === target.port;
+      if (!sameOrigin) headers = withoutCredentials(headers);
+      target = next;
       continue;
     }
-    if (marker === 1 || marker >= 208 && marker <= 217) {
-      i += 2;
-      continue;
+    if (status < 200 || status >= 300) {
+      res.destroy();
+      throw new Error(`${target.href}: HTTP ${status}`);
     }
-    if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204)
-      return { width: b.readUInt16BE(i + 7), height: b.readUInt16BE(i + 5) };
-    i += 2 + b.readUInt16BE(i + 2);
+    const contentType = (res.headers["content-type"] ?? "").trim();
+    const media = (contentType.split(";")[0] ?? "").trim().toLowerCase();
+    if (opts.accept && media.match(opts.accept) === null) {
+      res.destroy();
+      throw new Error(
+        `refusing ${url}: ${target.href} served ${media || "no Content-Type"}, which does not match ${opts.accept}. Link the file itself, not a page about it.`
+      );
+    }
+    const raw2 = await readCapped(res, opts.maxBytes, url, signal, opts.timeoutMs);
+    const bytes = decode(raw2, res.headers["content-encoding"], opts.maxBytes, url);
+    return { bytes, contentType, url: target.href };
   }
-  throw new Error("JPEG has no SOF segment");
-}
-
-// src/plan/codex.ts
-import { spawn } from "node:child_process";
-import { mkdtemp, readFile as readFile3, rm, writeFile as writeFile3 } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join as join3 } from "node:path";
-import { z as z2 } from "zod";
-
-// src/plan/arc.ts
-var ARC_ROLES = ["intro", "background", "limitations", "conclusion"];
-function requiredRoles(beatCount) {
-  if (beatCount >= 8) return ARC_ROLES;
-  if (beatCount >= 5) return ["limitations", "conclusion"];
-  return [];
-}
-function paperArcRequested(prefs) {
-  return prefs.genre === "paper";
 }
-
-// src/plan/duration.ts
-var SPEECH_CPS = { latin: 14.4, cjk: 6.5 };
-var LAST_HOLD_SECONDS = 4.2;
+async function send(url, target, headers, signal, opts) {
+  const secure = target.protocol === "https:";
+  if (!secure && target.protocol !== "http:") {
+    throw new Error(
+      `refusing ${url}: ${target.protocol}// is not http or https (${target.href}). Only web URLs are followed.`
+    );
+  }
+  const port = Number(target.port || (secure ? 443 : 80));
+  if (!WEB_PORTS.has(port) && opts.allowLoopback !== true) {
+    throw new Error(
+      `refusing ${url}: port ${port} on ${target.hostname} \u2014 only 80 and 443 are fetched. A URL naming another port is naming a service, not a page.`
+    );
+  }
+  const host2 = target.hostname.replace(/^\[|\]$/g, "");
+  let addresses;
+  try {
+    addresses = await Promise.race([resolveHost(host2, { all: true }), rejectsOnAbort(signal)]);
+  } catch {
+    if (signal.aborted) throw timedOut(url, opts.timeoutMs);
+    throw new Error(`refusing ${url}: ${host2} does not resolve.`);
+  }
+  const pinned = addresses[0];
+  if (pinned === void 0) throw new Error(`refusing ${url}: ${host2} does not resolve.`);
+  for (const { address } of addresses) {
+    const why2 = isBlockedAddress(address);
+    if (why2 !== null && !(opts.allowLoopback === true && isLoopback(address))) {
+      throw new Error(
+        `refusing ${url}: ${host2} resolves to ${address}, which is ${why2}. Host the file somewhere this server can reach from the public internet.`
+      );
+    }
+  }
+  const options = {
+    hostname: host2,
+    port,
+    path: `${target.pathname}${target.search}`,
+    method: "GET",
+    // IDENTIFY OURSELVES, AND ACCEPT HTML.
+    //
+    // Measured against the first real page this was ever pointed at: Wikipedia
+    // answers a request with no `user-agent` with a bare 403, and so do a great
+    // many sites behind a CDN. A fetcher that will not say who it is looks
+    // exactly like a scraper worth blocking, and the failure arrives as an
+    // HTTP status with nothing in it to explain itself. Both headers are
+    // DEFAULTS rather than overrides — a caller that sets either wins, because
+    // the spread below them is the caller's.
+    headers: {
+      "user-agent": USER_AGENT,
+      accept: "text/html,application/xhtml+xml,image/*;q=0.8,*/*;q=0.5",
+      ...headers,
+      "accept-encoding": "gzip, br"
+    },
+    signal,
+    // THE PIN. Without this line every check above is advisory: `dns.lookup`
+    // would run a second time inside the connect and could answer differently.
+    lookup: pin(pinned.address, pinned.family),
+    // No connection pool. This is a one-shot against a stranger's host, and a
+    // pooled socket outlives the call that validated it — nothing should be able
+    // to inherit a connection this module opened.
+    agent: false,
+    // Say out loud which name the certificate has to match. Node derives this
+    // from `hostname` today, but the pin means the socket is opened to a bare
+    // address, and a future refactor that stops setting `hostname` would turn
+    // verification off silently rather than fail.
+    ...secure && isIP(host2) === 0 ? { servername: host2 } : {}
+  };
+  try {
+    return await new Promise((resolve7, reject) => {
+      const req = (secure ? httpsRequest : httpRequest)(options, resolve7);
+      req.on("error", reject);
+      req.end();
+    });
+  } catch (err) {
+    if (signal.aborted) throw timedOut(url, opts.timeoutMs);
+    throw new Error(`refusing ${url}: ${target.href} could not be reached (${message(err)}).`);
+  }
+}
+function pin(address, family) {
+  return (_hostname, options, callback) => {
+    if (options.all) callback(null, [{ address, family }]);
+    else callback(null, address, family);
+  };
+}
+async function readCapped(res, maxBytes, url, signal, timeoutMs) {
+  const chunks = [];
+  let total = 0;
+  let oversize = false;
+  try {
+    for await (const chunk of res) {
+      total += chunk.length;
+      if (total > maxBytes) {
+        oversize = true;
+        res.destroy();
+        break;
+      }
+      chunks.push(chunk);
+    }
+  } catch (err) {
+    if (signal.aborted) throw timedOut(url, timeoutMs);
+    throw new Error(`refusing ${url}: the body stopped arriving (${message(err)}).`);
+  }
+  if (oversize) {
+    throw new Error(
+      `refusing ${url}: body is larger than ${maxBytes} bytes. Link a smaller file, or raise maxBytes if this one is expected.`
+    );
+  }
+  return Buffer.concat(chunks);
+}
+function decode(raw2, header, maxBytes, url) {
+  const encoding = (header ?? "").trim().toLowerCase();
+  if (encoding === "" || encoding === "identity") return raw2;
+  try {
+    if (encoding === "gzip" || encoding === "x-gzip") {
+      return gunzipSync(raw2, { maxOutputLength: maxBytes });
+    }
+    if (encoding === "br") return brotliDecompressSync(raw2, { maxOutputLength: maxBytes });
+  } catch (err) {
+    throw new Error(
+      `refusing ${url}: ${encoding} body does not decompress within ${maxBytes} bytes (${message(err)}). Serve it uncompressed, or raise maxBytes.`
+    );
+  }
+  throw new Error(
+    `refusing ${url}: Content-Encoding "${encoding}" was never offered \u2014 this request asked for gzip or br. Serve one of those, or no encoding.`
+  );
+}
+function lowercased(headers) {
+  const out = {};
+  for (const [name, value] of Object.entries(headers ?? {})) out[name.toLowerCase()] = value;
+  return out;
+}
+function withoutCredentials(headers) {
+  const out = { ...headers };
+  for (const name of CREDENTIALS) delete out[name];
+  return out;
+}
+function rejectsOnAbort(signal) {
+  return new Promise((_, reject) => {
+    if (signal.aborted) reject(signal.reason);
+    else signal.addEventListener("abort", () => reject(signal.reason), { once: true });
+  });
+}
+function timedOut(url, timeoutMs) {
+  return new Error(
+    `refusing ${url}: nothing completed within ${timeoutMs}ms. Raise timeoutMs, or use a URL that answers faster.`
+  );
+}
+function message(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+
+// src/render/capture.ts
+import { homedir } from "node:os";
+import { join as join2 } from "node:path";
+async function chromePath(need = "open the deck with") {
+  const explicit = process.env.DECKSMITH_CHROME || process.env.CHROME_PATH;
+  if (explicit) return explicit;
+  const { getInstalledBrowsers } = await import("@puppeteer/browsers");
+  const cacheDir = process.env.PUPPETEER_CACHE_DIR || join2(homedir(), ".cache", "puppeteer");
+  const installed2 = await getInstalledBrowsers({ cacheDir }).catch(() => []);
+  const found = installed2.find((b) => b.browser === "chrome-headless-shell") ?? installed2.find((b) => b.browser === "chrome");
+  if (found) return found.executablePath;
+  throw new Error(
+    `no Chrome to ${need} \u2014 run \`npx puppeteer browsers install chrome\`, or set DECKSMITH_CHROME to a Chrome binary.`
+  );
+}
+
+// src/source/assets.ts
+import { createHash as createHash4 } from "node:crypto";
+import { mkdir as mkdir2, readdir, readFile as readFile3, writeFile as writeFile2 } from "node:fs/promises";
+import { extname as extname2, join as join3 } from "node:path";
+import { z as z2 } from "zod";
+async function fetchFigures(source, dir, warnings) {
+  const drops = warnings ?? [];
+  await mkdir2(dir, { recursive: true });
+  const cached = await readdir(dir).catch(() => []);
+  const figures = [];
+  for (const figure of source.figures) {
+    if (figure.kind === "clip") {
+      figures.push(figure);
+      continue;
+    }
+    try {
+      figures.push(figureSchema.parse(await localize(figure, dir, cached)));
+    } catch (err) {
+      drops.push(`figure ${figure.id} was left out: ${reason(err)}`);
+    }
+  }
+  if (!warnings) for (const drop of drops) console.warn(`decksmith: ${drop}`);
+  const parsed = sourceSchema.safeParse({ ...source, figures });
+  if (!parsed.success) {
+    throw new Error(
+      `source "${source.id}" no longer parses after localising its figures: ${reason(parsed.error)}. Every figure kept was checked on its own, so the fault is in the document around them, not in an image.`
+    );
+  }
+  return parsed.data;
+}
+async function localize(figure, dir, cached) {
+  const stem = assetStem(figure.id, figure.src);
+  const hit = cached.find((name) => name.startsWith(`${stem}.`));
+  const bytes = hit ? await readFile3(join3(dir, hit)) : await load(figure.src);
+  const size = imageSize(bytes);
+  if (hit) return { ...figure, src: hit, ...size };
+  const src = `${stem}${assetExt(bytes, figure.src)}`;
+  await writeFile2(join3(dir, src), bytes);
+  cached.push(src);
+  return { ...figure, src, ...size };
+}
+function assetStem(id2, src) {
+  const readable = id2.replace(/[^a-zA-Z0-9_-]+/g, "-").replace(/^-+/, "") || "figure";
+  return `${readable}-${createHash4("sha256").update(src).digest("hex").slice(0, 8)}`;
+}
+var EXT = {
+  png: ".png",
+  jpeg: ".jpg",
+  gif: ".gif",
+  webp: ".webp",
+  avif: ".avif",
+  svg: ".svg"
+};
+function assetExt(bytes, src) {
+  const format = sniffFormat(bytes);
+  if (format) return EXT[format];
+  const fromUrl = extname2(new URL(src, "file:///").pathname).toLowerCase().replace(/[^.a-z0-9]/g, "");
+  return fromUrl || ".img";
+}
+var FIGURE_MAX_BYTES = 32 * 1024 * 1024;
+var FIGURE_TIMEOUT_MS = 2e4;
+async function load(src) {
+  if (!/^https?:/i.test(src)) return readFile3(src);
+  const got = await fetchGuarded(src, {
+    maxBytes: FIGURE_MAX_BYTES,
+    timeoutMs: FIGURE_TIMEOUT_MS
+  });
+  return got.bytes;
+}
+function reason(err) {
+  if (err instanceof z2.ZodError)
+    return err.issues.map((i) => `${i.path.join(".") || "(root)"}: ${i.message}`).join("; ");
+  return err instanceof Error ? err.message : String(err);
+}
+var SVG_WINDOW = 64 * 1024;
+function sniffFormat(b) {
+  if (b.length >= 8 && b.readUInt32BE(0) === 2303741511 && b.readUInt32BE(4) === 218765834)
+    return "png";
+  if (b.length >= 6 && b.toString("latin1", 0, 4) === "GIF8") return "gif";
+  if (b.length >= 2 && b.readUInt16BE(0) === 65496) return "jpeg";
+  if (b.length >= 12 && b.toString("latin1", 0, 4) === "RIFF" && b.toString("latin1", 8, 12) === "WEBP")
+    return "webp";
+  if (b.length >= 12 && b.toString("latin1", 4, 8) === "ftyp" && isAvifBrand(b)) return "avif";
+  if (isSvg(b)) return "svg";
+  return void 0;
+}
+function isAvifBrand(b) {
+  const declared = b.readUInt32BE(0);
+  const end = Math.min(declared >= 16 ? declared : b.length, b.length);
+  const brand = (at) => b.toString("latin1", at, at + 4);
+  if (brand(8) === "avif" || brand(8) === "avis") return true;
+  for (let i = 16; i + 4 <= end; i += 4)
+    if (brand(i) === "avif" || brand(i) === "avis") return true;
+  return false;
+}
+function isSvg(b) {
+  const text2 = b.toString("utf8", 0, Math.min(b.length, SVG_WINDOW)).replace(/^\uFEFF/, "");
+  let i = 0;
+  for (; ; ) {
+    while (i < text2.length && /\s/.test(text2.charAt(i))) i++;
+    const comment = text2.startsWith("<!--", i);
+    if (text2.startsWith("<?", i) || comment || /^<!doctype\s+svg\b/i.test(text2.slice(i, i + 20))) {
+      const end = comment ? text2.indexOf("-->", i) + 3 : text2.indexOf(">", i) + 1;
+      if (end <= 0) return false;
+      i = end;
+      continue;
+    }
+    return /^<svg[\s/>]/i.test(text2.slice(i, i + 5));
+  }
+}
+function imageSize(b) {
+  const format = sniffFormat(b);
+  const raw2 = measure2(b, format);
+  const width = Math.round(raw2.width);
+  const height = Math.round(raw2.height);
+  if (!Number.isFinite(width) || !Number.isFinite(height) || width < 1 || height < 1)
+    throw new Error(`${format ?? "image"} header claims ${raw2.width}x${raw2.height}, not a size`);
+  return { width, height };
+}
+function measure2(b, format) {
+  switch (format) {
+    case "png":
+      return pngSize(b);
+    case "gif":
+      return gifSize(b);
+    case "jpeg":
+      return jpegSize(b);
+    case "webp":
+      return webpSize(b);
+    case "avif":
+      return avifSize(b);
+    case "svg":
+      return svgFigureSize(b);
+    default:
+      throw new Error(
+        `unrecognised image header (expected PNG, JPEG, GIF, WebP, AVIF or SVG; got ${describe(b)})`
+      );
+  }
+}
+function describe(b) {
+  if (b.length === 0) return "an empty file";
+  if (b.length >= 12 && b.toString("latin1", 4, 8) === "ftyp")
+    return `an ISO-BMFF file branded "${b.toString("latin1", 8, 12)}" \u2014 HEIC and its relatives are not drawn by the renderer`;
+  const head = b.toString("latin1", 0, Math.min(b.length, 64));
+  if (/^\s*<(?:!doctype\s+html|html|head|body)\b/i.test(head))
+    return "an HTML page \u2014 the URL answered with a page, not a picture";
+  if (head.startsWith("%PDF")) return "a PDF";
+  const hex = [...b.subarray(0, 8)].map((x) => x.toString(16).padStart(2, "0")).join(" ");
+  return `${b.length} bytes beginning ${hex}`;
+}
+function pngSize(b) {
+  if (b.length < 24) throw new Error(`PNG is truncated: ${b.length} bytes, IHDR ends at 24`);
+  if (b.toString("latin1", 12, 16) !== "IHDR") throw new Error("PNG does not open with IHDR");
+  return { width: b.readUInt32BE(16), height: b.readUInt32BE(20) };
+}
+function gifSize(b) {
+  if (b.length < 10)
+    throw new Error(`GIF is truncated: ${b.length} bytes, the screen descriptor ends at 10`);
+  return { width: b.readUInt16LE(6), height: b.readUInt16LE(8) };
+}
+function jpegSize(b) {
+  let i = 2;
+  while (i + 9 < b.length) {
+    if (b[i] !== 255) {
+      i++;
+      continue;
+    }
+    const marker = b[i + 1];
+    if (marker === void 0) break;
+    if (marker === 255) {
+      i++;
+      continue;
+    }
+    if (marker === 1 || marker >= 208 && marker <= 217) {
+      i += 2;
+      continue;
+    }
+    if (marker >= 192 && marker <= 207 && marker !== 196 && marker !== 200 && marker !== 204)
+      return { width: b.readUInt16BE(i + 7), height: b.readUInt16BE(i + 5) };
+    i += 2 + b.readUInt16BE(i + 2);
+  }
+  throw new Error("JPEG has no SOF segment");
+}
+function webpSize(b) {
+  const chunk = b.length >= 16 ? b.toString("latin1", 12, 16) : "";
+  if (chunk === "VP8 ") {
+    if (b.length < 30) throw new Error(`WebP VP8 chunk is truncated: ${b.length} bytes, needs 30`);
+    if (b[23] !== 157 || b[24] !== 1 || b[25] !== 42)
+      throw new Error("WebP VP8 chunk has no keyframe sync code");
+    return { width: b.readUInt16LE(26) & 16383, height: b.readUInt16LE(28) & 16383 };
+  }
+  if (chunk === "VP8L") {
+    if (b.length < 25) throw new Error(`WebP VP8L chunk is truncated: ${b.length} bytes, needs 25`);
+    if (b[20] !== 47) throw new Error("WebP VP8L chunk has no 0x2f signature");
+    const bits = b.readUInt32LE(21);
+    return { width: (bits & 16383) + 1, height: (bits >>> 14 & 16383) + 1 };
+  }
+  if (chunk === "VP8X") {
+    if (b.length < 30) throw new Error(`WebP VP8X chunk is truncated: ${b.length} bytes, needs 30`);
+    return { width: b.readUIntLE(24, 3) + 1, height: b.readUIntLE(27, 3) + 1 };
+  }
+  throw new Error(`WebP opens with chunk "${chunk}", not one of VP8 , VP8L, VP8X`);
+}
+function avifSize(b) {
+  const meta = find(b, 0, b.length, "meta");
+  if (!meta) throw new Error("AVIF has no meta box (truncated, or not an image item)");
+  const iprp = find(b, meta.start + 4, meta.end, "iprp");
+  const ipco = iprp && find(b, iprp.start, iprp.end, "ipco");
+  if (!ipco) throw new Error("AVIF has no ipco box (no item properties to read a size from)");
+  let best = { width: 0, height: 0 };
+  for (const box of boxes(b, ipco.start, ipco.end)) {
+    if (box.type !== "ispe" || box.end - box.start < 12) continue;
+    const found = { width: b.readUInt32BE(box.start + 4), height: b.readUInt32BE(box.start + 8) };
+    if (found.width * found.height > best.width * best.height) best = found;
+  }
+  if (best.width < 1 || best.height < 1) throw new Error("AVIF has no usable ispe property");
+  return cleanAperture(b, ipco, best) ?? best;
+}
+function cleanAperture(b, ipco, ispe) {
+  for (const box of boxes(b, ipco.start, ipco.end)) {
+    if (box.type !== "clap" || box.end - box.start < 16) continue;
+    const at = (offset) => b.readUInt32BE(box.start + offset);
+    if (at(4) === 0 || at(12) === 0) continue;
+    const width = Math.round(at(0) / at(4));
+    const height = Math.round(at(8) / at(12));
+    if (width > ispe.width || height > ispe.height) continue;
+    if (width * 2 < ispe.width || height * 2 < ispe.height) continue;
+    return { width, height };
+  }
+  return void 0;
+}
+function find(b, from, to, type) {
+  for (const box of boxes(b, from, to)) if (box.type === type) return box;
+  return void 0;
+}
+function* boxes(b, from, to) {
+  let i = from;
+  while (i + 8 <= to) {
+    let size = b.readUInt32BE(i);
+    const type = b.toString("latin1", i + 4, i + 8);
+    let start = i + 8;
+    if (size === 1) {
+      if (i + 16 > to) return;
+      const large = b.readBigUInt64BE(i + 8);
+      if (large > BigInt(Number.MAX_SAFE_INTEGER)) return;
+      size = Number(large);
+      start = i + 16;
+    } else if (size === 0) {
+      size = to - i;
+    }
+    if (size < start - i || i + size > to) return;
+    yield { type, start, end: i + size };
+    i += size;
+  }
+}
+function svgFigureSize(b) {
+  const moving = /<(?:animate|animateTransform|animateMotion|set|script)\b|@keyframes\b/i.exec(
+    b.toString("utf8")
+  );
+  if (moving)
+    throw new Error(
+      `SVG carries "${moving[0]}": animation is drawn against the capture clock, so the render would differ every run. Convert the figure to PNG and point at that.`
+    );
+  return svgSize(b);
+}
+function svgSize(bytes) {
+  const text2 = bytes.toString("utf8", 0, Math.min(bytes.length, SVG_WINDOW));
+  const tag = /<svg\b[^>]*>/i.exec(text2)?.[0];
+  if (!tag) throw new Error(`SVG root element is not closed within ${SVG_WINDOW} bytes`);
+  const width = cssPixels(attrOf(tag, "width"));
+  const height = cssPixels(attrOf(tag, "height"));
+  if (width !== void 0 && height !== void 0) return { width, height };
+  const box = attrOf(tag, "viewBox")?.trim().split(/[\s,]+/).map(Number);
+  const w = box?.[2];
+  const h = box?.[3];
+  if (box?.length === 4 && w !== void 0 && h !== void 0 && w > 0 && h > 0)
+    return { width: w, height: h };
+  throw new Error("SVG declares no absolute width and height, and no usable viewBox");
+}
+function attrOf(tag, name) {
+  const m = new RegExp(`\\s${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)')`, "i").exec(tag);
+  return m?.[1] ?? m?.[2];
+}
+var UNIT = {
+  "": 1,
+  px: 1,
+  pt: 96 / 72,
+  pc: 16,
+  in: 96,
+  cm: 96 / 2.54,
+  mm: 96 / 25.4,
+  q: 96 / 101.6,
+  em: 16,
+  rem: 16
+};
+function cssPixels(value) {
+  if (value === void 0) return void 0;
+  const m = /^\s*([+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?)\s*([a-z%]*)\s*$/i.exec(value);
+  if (!m?.[1]) return void 0;
+  const scale = UNIT[(m[2] ?? "").toLowerCase()];
+  if (scale === void 0) return void 0;
+  const px = Number(m[1]) * scale;
+  return px > 0 ? px : void 0;
+}
+
+// src/source/readability.ts
+var CONTENT_MARKER = "data-ds-content";
+function readContentRegion() {
+  const MARKER = "data-ds-content";
+  const MIN_TEXT = 250;
+  const MAX_ANCESTORS = 5;
+  const SIBLING_FRACTION = 0.2;
+  const MIN_SIBLING_SCORE = 10;
+  const MIN_PARAGRAPH = 25;
+  const UNLIKELY = /-ad-|ai2html|banner|breadcrumb|combx|comment|community|consent|cookie|disqus|extra|footer|gdpr|legends|masthead|menu|modal|newsletter|paywall|popup|promo|related|remark|replies|rss|share|shoutbox|sidebar|skyscraper|social|sponsor|subscribe|supplemental|pagination|pager|toolbar|yom-remote/i;
+  const MAYBE = /and|article|body|column|content|main|shadow|story/i;
+  const POSITIVE = /article|body|content|entry|hentry|h-entry|main|page|post|story|text|blog/i;
+  const NEGATIVE = /-ad-|banner|combx|comment|com-|contact|foot|footer|footnote|gdpr|masthead|media|meta|outbrain|promo|related|scroll|share|shoutbox|sidebar|skyscraper|sponsor|shopping|tags|widget/i;
+  const CHROME_ROLES = /* @__PURE__ */ new Set([
+    "alert",
+    "alertdialog",
+    "banner",
+    "complementary",
+    "contentinfo",
+    "dialog",
+    "menu",
+    "menubar",
+    "navigation",
+    "search",
+    "toolbar",
+    "tooltip"
+  ]);
+  const CHROME_TAGS = /* @__PURE__ */ new Set([
+    "nav",
+    "aside",
+    "footer",
+    "script",
+    "style",
+    "noscript",
+    "form",
+    "svg",
+    "canvas",
+    "template",
+    "button",
+    "select",
+    "textarea"
+  ]);
+  const SCORED = "p, td, pre, section, h2, h3, h4, h5, h6";
+  function textOf2(node) {
+    return (node?.textContent ?? "").replace(/\s+/g, " ").trim();
+  }
+  function labelOf(el) {
+    return `${el.getAttribute("class") ?? ""} ${el.getAttribute("id") ?? ""}`;
+  }
+  function nameOf(el) {
+    const id2 = el.getAttribute("id");
+    const cls = (el.getAttribute("class") ?? "").trim().split(/\s+/)[0];
+    return el.tagName.toLowerCase() + (id2 ? `#${id2}` : "") + (cls ? `.${cls}` : "");
+  }
+  function pathOf(el) {
+    const parts = [];
+    let node = el;
+    while (node && parts.length < 3) {
+      parts.unshift(nameOf(node));
+      node = node.parentElement;
+    }
+    return parts.join(" > ");
+  }
+  function round6(n3) {
+    return Math.round(n3 * 1e3) / 1e3;
+  }
+  function linkDensity(el) {
+    const total = textOf2(el).length;
+    if (total === 0) return 0;
+    let inLinks = 0;
+    for (const a of el.querySelectorAll("a")) {
+      const href = a.getAttribute("href") ?? "";
+      inLinks += textOf2(a).length * (href.startsWith("#") ? 0.3 : 1);
+    }
+    return inLinks / total;
+  }
+  function classWeight(el) {
+    let weight = 0;
+    for (const label of [el.getAttribute("class") ?? "", el.getAttribute("id") ?? ""]) {
+      if (label === "") continue;
+      if (NEGATIVE.test(label)) weight -= 25;
+      if (POSITIVE.test(label)) weight += 25;
+    }
+    return weight;
+  }
+  function tagBonus(tag) {
+    if (tag === "div") return 5;
+    if (tag === "pre" || tag === "td" || tag === "blockquote") return 3;
+    if (tag === "th" || /^h[1-6]$/.test(tag)) return -5;
+    if (/^(address|ol|ul|dl|dd|dt|li|form)$/.test(tag)) return -3;
+    return 0;
+  }
+  const scores = /* @__PURE__ */ new Map();
+  function scoreOf(el) {
+    const at = scores.get(el);
+    if (at !== void 0) return at;
+    const start = tagBonus(el.tagName.toLowerCase()) + classWeight(el);
+    scores.set(el, start);
+    return start;
+  }
+  const removed = [];
+  function strip(el) {
+    const parent = el.parentElement;
+    if (!parent) return;
+    removed.push({ node: el, parent, next: el.nextSibling });
+    el.remove();
+  }
+  function restore() {
+    for (let i = removed.length - 1; i >= 0; i--) {
+      const at = removed[i];
+      if (at) at.parent.insertBefore(at.node, at.next);
+    }
+    removed.length = 0;
+  }
+  function declined(reason3, candidates2) {
+    restore();
+    return {
+      marked: false,
+      reason: reason3,
+      candidates: candidates2,
+      merged: 0,
+      stripped: 0,
+      text: 0,
+      mediaDropped: 0
+    };
+  }
+  try {
+    if (!document.body) {
+      return declined("the document has no <body>, so there is no region to choose", []);
+    }
+    const mediaBefore = document.querySelectorAll("video, iframe").length;
+    for (const el of [...document.body.querySelectorAll("*")]) {
+      if (!el.isConnected) continue;
+      const tag = el.tagName.toLowerCase();
+      if (CHROME_TAGS.has(tag)) {
+        strip(el);
+        continue;
+      }
+      if (tag === "header" && el.parentElement?.closest("article, main, section") == null) {
+        strip(el);
+        continue;
+      }
+      if (el.hasAttribute("hidden") || el.getAttribute("aria-hidden") === "true") {
+        strip(el);
+        continue;
+      }
+      if (CHROME_ROLES.has((el.getAttribute("role") ?? "").toLowerCase())) {
+        strip(el);
+        continue;
+      }
+      const label = labelOf(el);
+      if (UNLIKELY.test(label) && !MAYBE.test(label) && !el.querySelector("main, article")) {
+        strip(el);
+      }
+    }
+    for (const el of document.body.querySelectorAll(SCORED)) {
+      const text3 = textOf2(el);
+      if (text3.length < MIN_PARAGRAPH) continue;
+      const base = 1 + (text3.split(",").length - 1) + Math.min(Math.floor(text3.length / 100), 3);
+      let node = el.parentElement;
+      let level = 0;
+      while (node && node !== document.documentElement && level < MAX_ANCESTORS) {
+        const divider = level === 0 ? 1 : level === 1 ? 2 : level * 3;
+        scores.set(node, scoreOf(node) + base / divider);
+        node = node.parentElement;
+        level++;
+      }
+    }
+    const ranked = [];
+    for (const [el, content] of scores) {
+      const density = linkDensity(el);
+      ranked.push({
+        el,
+        report: {
+          path: pathOf(el),
+          content: round6(content),
+          linkDensity: round6(density),
+          // THE WHOLE POINT OF THE PASS. A rail of related headlines and an
+          // article of the same length hold the same number of characters; only
+          // this term separates them, and it is why the discount is a
+          // multiplier rather than a subtraction — a candidate that is entirely
+          // links scores zero however long it is.
+          score: round6(content * (1 - density)),
+          text: textOf2(el).length
+        }
+      });
+    }
+    ranked.sort((a, b) => b.report.score - a.report.score);
+    const report2 = ranked.slice(0, 5).map((r) => r.report);
+    let top = ranked[0];
+    if (!top) {
+      return declined(
+        `nothing scored: the page has no paragraph of ${MIN_PARAGRAPH} characters or more outside its chrome. Save the page and ingest the file if a script builds its body.`,
+        report2
+      );
+    }
+    const byElement = new Map(ranked.map((r) => [r.el, r]));
+    const floor = top.report.score / 3;
+    let last = top.report.score;
+    let up = top.el.parentElement;
+    while (up && up !== document.body && up !== document.documentElement) {
+      const here = byElement.get(up);
+      if (here) {
+        if (here.report.score < floor) break;
+        if (here.report.score > last) {
+          top = here;
+          break;
+        }
+        last = here.report.score;
+      }
+      up = up.parentElement;
+    }
+    if (top.el === document.body) {
+      const text3 = textOf2(document.body).length;
+      if (text3 < MIN_TEXT) {
+        return declined(
+          `the page holds ${text3} characters of text outside its chrome, under the ${MIN_TEXT} this pass needs to be sure of a region; left it for the simpler heuristic`,
+          report2
+        );
+      }
+      document.body.setAttribute(MARKER, "");
+      return {
+        marked: true,
+        reason: `chose <body>: nothing narrower than the page itself scored, ${text3} characters`,
+        candidates: report2,
+        merged: 0,
+        stripped: removed.length,
+        text: text3,
+        mediaDropped: mediaBefore - document.body.querySelectorAll("video, iframe").length
+      };
+    }
+    const parent = top.el.parentElement;
+    if (!parent) {
+      return declined("the winning candidate is not in the document any more", report2);
+    }
+    const threshold = Math.max(MIN_SIBLING_SCORE, top.report.score * SIBLING_FRACTION);
+    const topClass = top.el.getAttribute("class") ?? "";
+    const keep = [];
+    for (const sib of [...parent.children]) {
+      if (sib === top.el) {
+        keep.push(sib);
+        continue;
+      }
+      const twin = topClass !== "" && sib.getAttribute("class") === topClass;
+      const bonus = twin ? top.report.score * SIBLING_FRACTION : 0;
+      const here = byElement.get(sib);
+      if (here && here.report.score + bonus >= threshold) {
+        keep.push(sib);
+        continue;
+      }
+      if (sib.tagName.toLowerCase() === "p") {
+        const text3 = textOf2(sib);
+        const density = linkDensity(sib);
+        const long = text3.length > 80 && density < 0.25;
+        const sentence = text3.length > 0 && text3.length <= 80 && density === 0 && /\.( |$)/.test(text3);
+        if (long || sentence) keep.push(sib);
+      }
+    }
+    const text2 = keep.reduce((n3, el) => n3 + textOf2(el).length, 0);
+    if (text2 < MIN_TEXT) {
+      return declined(
+        `the best region (${top.report.path}) holds ${text2} characters, under the ${MIN_TEXT} this pass needs to be sure of it; left the page for the simpler heuristic`,
+        report2
+      );
+    }
+    let region;
+    if (keep.length === 1 && keep[0]) {
+      region = keep[0];
+    } else {
+      const box = document.createElement("div");
+      for (const el of keep) box.appendChild(el);
+      document.body.appendChild(box);
+      region = box;
+    }
+    region.setAttribute(MARKER, "");
+    return {
+      marked: true,
+      reason: `chose ${top.report.path} \u2014 score ${top.report.score}, link density ${top.report.linkDensity}, ${textOf2(region).length} characters` + (keep.length > 1 ? `, with ${keep.length - 1} sibling(s) merged in` : ""),
+      candidates: report2,
+      merged: keep.length - 1,
+      stripped: removed.length,
+      text: textOf2(region).length,
+      mediaDropped: mediaBefore - region.querySelectorAll("video, iframe").length
+    };
+  } catch (e) {
+    return declined(
+      `the readability pass failed inside the page (${e instanceof Error ? e.message : String(e)}); the page was left as it was found and the simpler heuristic still applies`,
+      []
+    );
+  }
+}
+
+// src/source/transcode.ts
+import { readFile as readFile4, rm } from "node:fs/promises";
+import { basename } from "node:path";
+
+// src/render/ffmpeg.ts
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+var run = promisify(execFile);
+var DEFAULT_TIMEOUT_MS = 36e5;
+async function runTool(file, args, opts = {}) {
+  try {
+    return await run(file, args, {
+      cwd: opts.cwd,
+      timeout: opts.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+      maxBuffer: 64 << 20
+    });
+  } catch (err) {
+    const e = err;
+    if (e.code === "ENOENT") {
+      throw new Error(`${file} is not installed, or not on PATH. \`render\` needs it.`);
+    }
+    const tail = (e.stderr ?? e.stdout ?? e.message).trim().split("\n").slice(-8).join("\n");
+    throw new Error(`${file} failed:
+${tail}`);
+  }
+}
+function runLive(file, args) {
+  return new Promise((resolve7, reject) => {
+    const child = spawn(file, args, { stdio: ["ignore", "inherit", "inherit"] });
+    child.on("error", (err) => {
+      reject(
+        err.code === "ENOENT" ? new Error(`${file} is not installed, or not on PATH. \`render\` needs it.`) : err
+      );
+    });
+    child.on("close", (code, signal) => {
+      if (code === 0) resolve7();
+      else if (signal) {
+        reject(
+          new Error(
+            `${file} was killed by ${signal}. On a machine under memory pressure this is the OS reclaiming the browser; free memory, or lower --workers, and run again.`
+          )
+        );
+      } else reject(new Error(`${file} exited ${code}.`));
+    });
+  });
+}
+async function probe(path2) {
+  const { stdout } = await runTool("ffprobe", [
+    "-v",
+    "error",
+    "-show_entries",
+    "stream=codec_type,width,height,r_frame_rate,nb_frames:format=duration",
+    "-of",
+    "json",
+    path2
+  ]);
+  const json = JSON.parse(stdout);
+  const streams = json.streams ?? [];
+  const video = streams.find((s) => s.codec_type === "video");
+  if (!video) throw new Error(`${path2} has no video stream.`);
+  const [num2, den] = (video.r_frame_rate ?? "30/1").split("/");
+  const fps = Number(num2) / (Number(den) || 1);
+  const seconds = Number(json.format?.duration ?? 0);
+  const frames = Number(video.nb_frames ?? 0) || Math.round(seconds * fps);
+  return {
+    width: video.width ?? 0,
+    height: video.height ?? 0,
+    fps,
+    frames,
+    seconds,
+    hasAudio: streams.some((s) => s.codec_type === "audio")
+  };
+}
+function encoderArgs(fps) {
+  return [
+    "-c:v",
+    "libx264",
+    "-preset",
+    "veryfast",
+    "-crf",
+    "16",
+    "-pix_fmt",
+    "yuv420p",
+    "-g",
+    "12",
+    "-r",
+    String(fps),
+    "-fps_mode",
+    "cfr"
+  ];
+}
+function pieceFilter(motion, freeze) {
+  const chain = [`trim=end_frame=${motion}`, "setpts=N/FRAME_RATE/TB"];
+  if (freeze > 0) chain.push(`tpad=stop_mode=clone:stop=${freeze}`);
+  return chain.join(",");
+}
+function pieceArgs(source, fromFrame, motion, freeze, fps, out) {
+  return [
+    "-y",
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    // Half a frame in, so a time that is exactly on a boundary cannot round to
+    // the frame before it.
+    "-ss",
+    ((fromFrame + 0.5) / fps).toFixed(6),
+    "-i",
+    source,
+    "-an",
+    "-vf",
+    pieceFilter(motion, freeze),
+    "-frames:v",
+    String(motion + freeze),
+    ...encoderArgs(fps),
+    "-f",
+    "mpegts",
+    out
+  ];
+}
+var LOUDNESS = "loudnorm=I=-16:TP=-1.5:LRA=11,aresample=48000";
+function audioGraph(inputs, seconds, first = 1) {
+  const lines = inputs.map(
+    (input, i) => `[${first + i}:a]aresample=48000,aformat=sample_fmts=fltp:channel_layouts=stereo,adelay=${input.delayMs}:all=1[d${i}]`
+  );
+  const labels = inputs.map((_, i) => `[d${i}]`).join("");
+  lines.push(
+    `${labels}amix=inputs=${inputs.length}:normalize=0:dropout_transition=0:duration=longest,${LOUDNESS},apad=whole_dur=${seconds.toFixed(3)}[aout]`
+  );
+  return lines.join(";\n");
+}
+function respeedArgs(source, factor, chain, fps, hasAudio, out) {
+  const video = `[0:v]setpts=PTS/${factor}[v]`;
+  const audio = hasAudio ? `;[0:a]${chain.map((t2) => `atempo=${t2}`).join(",")}[a]` : "";
+  return [
+    "-y",
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-i",
+    source,
+    "-filter_complex",
+    `${video}${audio}`,
+    "-map",
+    "[v]",
+    ...hasAudio ? ["-map", "[a]", "-c:a", "aac", "-b:a", "160k"] : ["-an"],
+    ...encoderArgs(fps),
+    out
+  ];
+}
+function burnStyle(width, height, font = "Arial") {
+  return {
+    width,
+    height,
+    font,
+    // MEASURED, not guessed. `splitCue` caps a cue at 84 characters and `wrap`
+    // breaks it near the middle, so the longer of the two lines runs to about
+    // 46 characters in real caption prose. Bold Arial advances 0.485em per
+    // character on that prose (measured in a browser over the demo's own
+    // narration), so 46 characters at F px is 22.3F wide, and the usable width
+    // here is 978px. F = 40 leaves 9% of headroom; F = 45 — which is what
+    // "4% of the width" looked like on paper — overflows to a THIRD line, and a
+    // three-line band covers the bottom of the slide.
+    fontSize: Math.round(width * 0.037),
+    // Clear of the play button, the progress bar and the handle every vertical
+    // player draws across the bottom eighth of the frame.
+    marginV: Math.round(height * 0.09),
+    marginX: Math.round(width * 0.04)
+  };
+}
+
+// src/source/transcode.ts
+var CLIP_EDGE_PX = 1280;
+var MAX_CLIP_SECONDS = 60;
+var TIMEOUT_MS = 6e5;
+function fitBox(width, height, maxEdgePx) {
+  const scale = Math.min(1, maxEdgePx / width, maxEdgePx / height);
+  return { width: even(width * scale), height: even(height * scale) };
+}
+function even(n3) {
+  return Math.max(2, Math.floor(Math.round(n3) / 2) * 2);
+}
+function transcodeArgs(input, out, plan) {
+  return [
+    "-y",
+    "-hide_banner",
+    "-loglevel",
+    "error",
+    "-i",
+    input,
+    ...plan.seconds === void 0 ? [] : ["-t", plan.seconds.toFixed(3)],
+    "-an",
+    "-map_metadata",
+    "-1",
+    "-vf",
+    `scale=${plan.width}:${plan.height}`,
+    "-c:v",
+    "libvpx-vp9",
+    "-crf",
+    "32",
+    "-b:v",
+    "0",
+    "-deadline",
+    "good",
+    "-cpu-used",
+    "4",
+    "-row-mt",
+    "1",
+    "-pix_fmt",
+    "yuv420p",
+    "-fflags",
+    "+bitexact",
+    "-flags:v",
+    "+bitexact",
+    out
+  ];
+}
+var probed = /* @__PURE__ */ new Map();
+function installed(file) {
+  const asked = probed.get(file);
+  if (asked !== void 0) return asked;
+  const answer = runTool(file, ["-version"], { timeoutMs: 5e3 }).then(
+    () => true,
+    () => false
+  );
+  probed.set(file, answer);
+  return answer;
+}
+async function transcode(input, out, opts = {}) {
+  const file = opts.ffmpeg ?? "ffmpeg";
+  const maxSeconds = opts.maxSeconds ?? MAX_CLIP_SECONDS;
+  const timeoutMs = opts.timeoutMs ?? TIMEOUT_MS;
+  const name = basename(input);
+  const source = videoSize(await readFile4(input));
+  const box = fitBox(source.width, source.height, opts.maxEdgePx ?? CLIP_EDGE_PX);
+  const kept = (why2) => ({
+    path: input,
+    width: source.width,
+    height: source.height,
+    seconds: source.seconds,
+    transcoded: false,
+    warnings: [`${name} was shipped as the page served it: ${why2}`]
+  });
+  if (!await installed(file)) {
+    return kept(
+      `${file} is not installed, or not on PATH, so it could not be shrunk to ${box.width}x${box.height} VP9 \u2014 \`brew install ffmpeg\` / \`apt install ffmpeg\` and re-ingest to spend fewer bytes and a shorter render on it.`
+    );
+  }
+  const trim = source.seconds === void 0 || source.seconds > maxSeconds;
+  const started = Date.now();
+  try {
+    await runTool(
+      file,
+      transcodeArgs(input, out, { ...box, ...trim ? { seconds: maxSeconds } : {} }),
+      { timeoutMs }
+    );
+  } catch (err) {
+    await rm(out, { force: true });
+    const over = Date.now() - started >= timeoutMs;
+    return kept(
+      over ? `${file} ran past its ${(timeoutMs / 1e3).toFixed(0)}s budget and was stopped (raise timeoutMs, or cap the clip harder with maxSeconds).` : `${file} failed \u2014 ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  let measured;
+  try {
+    measured = videoSize(await readFile4(out));
+  } catch (err) {
+    await rm(out, { force: true });
+    return kept(
+      `the webm ${file} wrote could not be measured \u2014 ${err instanceof Error ? err.message : String(err)}`
+    );
+  }
+  const warnings = [];
+  if (trim && measured.seconds !== void 0 && measured.seconds >= maxSeconds - 0.05) {
+    warnings.push(
+      `${name} was trimmed to the ${maxSeconds}s cap (maxSeconds) from ${source.seconds === void 0 ? "an unstated length" : `${source.seconds.toFixed(1)}s`}: a clip is pre-decoded to one still per output frame, so everything past the cap is bytes and decode that no beat is long enough to reach.`
+    );
+  }
+  return {
+    path: out,
+    width: measured.width,
+    height: measured.height,
+    seconds: measured.seconds,
+    transcoded: true,
+    warnings
+  };
+}
+
+// src/source/harvest.ts
+var HTML_MAX_BYTES = 8 * 1024 * 1024;
+var ASSET_MAX_BYTES = 32 * 1024 * 1024;
+var TIMEOUT_MS2 = 2e4;
+var MAX_ASSETS = 40;
+var MAX_CLIPS = 4;
+var MAX_TOTAL_BYTES = 96 * 1024 * 1024;
+var MAX_WALL_MS = 18e4;
+var MIN_FIGURE_PX = 64;
+var HTML_TYPES = /^text\/html$|^application\/xhtml\+xml$/;
+async function harvest(url, dir, opts = {}) {
+  const timeoutMs = opts.timeoutMs ?? TIMEOUT_MS2;
+  const warnings = [];
+  const assets = resolve(dir);
+  await mkdir3(assets, { recursive: true });
+  const page = await fetchGuarded(url, {
+    maxBytes: opts.maxBytes ?? HTML_MAX_BYTES,
+    timeoutMs,
+    accept: HTML_TYPES,
+    ...opts.allowLoopback === true ? { allowLoopback: true } : {}
+  });
+  const html = decodeHtml(page.bytes, page.contentType, url, warnings);
+  const { seen, pick } = await readInBrowser(html, timeoutMs);
+  if (!pick.marked) {
+    warnings.push(
+      `the article could not be scored out of this page \u2014 ${pick.reason}. The densest container was taken instead: read the section count below, and if it is the whole page rather than the piece, save the article and ingest the file.`
+    );
+  } else if (pick.mediaDropped > 0) {
+    warnings.push(
+      `${pick.mediaDropped} video or embed(s) sat outside the article region and were dropped with the page's chrome. If one of them was the video the piece is about, ingest the saved page instead, where the region is the whole document.`
+    );
+  }
+  const base = absolute(seen.base, page.url) ?? page.url;
+  const local = await localise(seen, base, assets, opts, timeoutMs, warnings);
+  return {
+    markdown: toMarkdown(titled(seen.title, local.blocks)),
+    assets: local.assets,
+    clips: local.clips,
+    warnings,
+    title: seen.title
+  };
+}
+function titled(title2, blocks) {
+  const first = blocks[0];
+  const already = first?.kind === "heading" && first.depth === 1 && first.text.trim() === title2.trim();
+  return title2 && !already ? [{ kind: "heading", depth: 1, text: title2 }, ...blocks] : [...blocks];
+}
+function decodeHtml(bytes, contentType, url, warnings) {
+  const declared = /charset\s*=\s*["']?([\w.:-]+)/i.exec(contentType)?.[1];
+  const head = bytes.toString("latin1", 0, Math.min(bytes.length, 4096));
+  const meta = /<meta[^>]+charset\s*=\s*["']?([\w.:-]+)/i.exec(head)?.[1];
+  const label = declared ?? meta;
+  if (label === void 0) return bytes.toString("utf8");
+  try {
+    return new TextDecoder(label).decode(bytes);
+  } catch {
+    warnings.push(
+      `${url} declares charset "${label}", which this Node cannot decode; read as UTF-8 instead. Non-ASCII text may be wrong \u2014 serve the page as UTF-8, or save it and ingest the file.`
+    );
+    return bytes.toString("utf8");
+  }
+}
+async function readInBrowser(html, timeoutMs) {
+  const { default: puppeteer } = await import("puppeteer-core");
+  const browser = await puppeteer.launch({
+    executablePath: await chromePath("read the page with"),
+    headless: true,
+    // Chrome's own background traffic — variations, safe browsing, first-run
+    // pings — never goes through page interception, so it is switched off here
+    // rather than assumed absent. It is not an SSRF path, but "the browser makes
+    // no requests" should be true of the whole process, not just of the tab.
+    args: [
+      "--disable-background-networking",
+      "--disable-extensions",
+      "--no-default-browser-check",
+      "--no-first-run"
+    ]
+  });
+  try {
+    const page = await browser.newPage();
+    await page.setRequestInterception(true);
+    page.on("request", (request) => {
+      request.abort().catch(() => {
+      });
+    });
+    await page.setContent(html, { waitUntil: "domcontentloaded", timeout: timeoutMs });
+    const pick = await page.evaluate(readContentRegion);
+    return { seen: await page.evaluate(readDom, CONTENT_MARKER), pick };
+  } finally {
+    await browser.close().catch(() => {
+    });
+  }
+}
+function readDom(marker) {
+  const SKIP = /* @__PURE__ */ new Set([
+    "nav",
+    "aside",
+    "footer",
+    "script",
+    "style",
+    "noscript",
+    "form",
+    "svg",
+    "canvas",
+    "template",
+    "button",
+    "select",
+    "textarea"
+  ]);
+  const BLOCKY = /* @__PURE__ */ new Set([
+    "p",
+    "div",
+    "section",
+    "article",
+    "main",
+    "ul",
+    "ol",
+    "table",
+    "figure",
+    "blockquote",
+    "pre",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6"
+  ]);
+  const PLAYER = /(?:youtube\.com\/(?:watch|embed|shorts)|youtu\.be\/|(?:player\.)?vimeo\.com\/|dailymotion\.com\/video\/|\.(?:mp4|webm|m4v|mov)(?:[?#]|$))/i;
+  function words2(node) {
+    return (node?.textContent ?? "").replace(/\s+/g, " ").trim();
+  }
+  function skipped(el) {
+    return SKIP.has(el.tagName.toLowerCase()) || el.hasAttribute("hidden") || el.getAttribute("aria-hidden") === "true";
+  }
+  function pickSrc(el) {
+    const candidates2 = (el.getAttribute("srcset") ?? "").split(",").map((part) => part.trim().split(/\s+/)).filter((bits) => (bits[0] ?? "") !== "").map((bits) => ({ url: bits[0] ?? "", w: Number.parseInt(bits[1] ?? "", 10) || 0 }));
+    let widest2 = candidates2[0];
+    for (const candidate of candidates2) if (candidate.w >= (widest2?.w ?? -1)) widest2 = candidate;
+    return widest2?.url ?? el.getAttribute("src") ?? el.getAttribute("data-src") ?? "";
+  }
+  function imageOf(el, caption) {
+    const src = pickSrc(el);
+    if (!src) return void 0;
+    return { kind: "image", src, alt: words2(el.getAttributeNode("alt")), caption };
+  }
+  function videoOf(el, caption) {
+    const source = el.querySelector("source");
+    return {
+      kind: "video",
+      src: el.getAttribute("src") ?? source?.getAttribute("src") ?? "",
+      poster: el.getAttribute("poster") ?? "",
+      href: "",
+      caption
+    };
+  }
+  function figureOf(el, out) {
+    const caption = words2(el.querySelector("figcaption"));
+    const video = el.querySelector("video");
+    if (video) {
+      out.push(videoOf(video, caption));
+      return;
+    }
+    const image2 = el.querySelector("img");
+    const block2 = image2 ? imageOf(image2, caption) : void 0;
+    if (block2) {
+      out.push(block2);
+      return;
+    }
+    const text2 = words2(el);
+    if (text2) out.push({ kind: "paragraph", text: text2 });
+  }
+  function paragraphOf(el, out) {
+    const solid = [...el.childNodes].filter(
+      (n3) => n3.nodeType !== Node.TEXT_NODE || (n3.textContent ?? "").trim() !== ""
+    );
+    const only = solid.length === 1 ? solid[0] : void 0;
+    if (only instanceof HTMLAnchorElement && PLAYER.test(only.getAttribute("href") ?? "")) {
+      const href = only.getAttribute("href") ?? "";
+      out.push({ kind: "video", src: "", poster: "", href, caption: words2(only) });
+      return;
+    }
+    let buffer = "";
+    const flush = () => {
+      const text2 = buffer.replace(/\s+/g, " ").trim();
+      if (text2) out.push({ kind: "paragraph", text: text2 });
+      buffer = "";
+    };
+    const scan = (node) => {
+      if (node.nodeType === Node.TEXT_NODE) {
+        buffer += node.textContent ?? "";
+        return;
+      }
+      if (!(node instanceof Element)) return;
+      if (skipped(node)) return;
+      const tag = node.tagName.toLowerCase();
+      if (tag === "br") {
+        buffer += " ";
+        return;
+      }
+      if (tag === "img" || tag === "video" || BLOCKY.has(tag)) {
+        flush();
+        block(node, out);
+        return;
+      }
+      for (const kid of node.childNodes) scan(kid);
+    };
+    for (const kid of el.childNodes) scan(kid);
+    flush();
+  }
+  function listOf(el) {
+    return {
+      kind: "list",
+      ordered: el.tagName === "OL",
+      // A nested list flattens into its parent item, exactly as `blockText` in
+      // src/source/markdown.ts already flattens one on the way back out.
+      items: [...el.children].filter((li) => li.tagName === "LI").map(words2).filter((text2) => text2 !== "")
+    };
+  }
+  function tableOf(el) {
+    const rows = [...el.querySelectorAll("tr")].map(
+      (tr) => [...tr.children].filter((c) => c.tagName === "TD" || c.tagName === "TH").map(words2)
+    );
+    const [head, ...body] = rows;
+    return head ? { kind: "table", columns: head, rows: body } : void 0;
+  }
+  function block(el, out) {
+    if (skipped(el)) return;
+    const tag = el.tagName.toLowerCase();
+    if (/^h[1-6]$/.test(tag)) {
+      const text2 = words2(el);
+      if (text2) out.push({ kind: "heading", depth: Number(tag[1]), text: text2 });
+      return;
+    }
+    if (tag === "p" || tag === "blockquote") {
+      paragraphOf(el, out);
+      return;
+    }
+    if (tag === "ul" || tag === "ol") {
+      const list = listOf(el);
+      if (list.kind === "list" && list.items.length > 0) out.push(list);
+      return;
+    }
+    if (tag === "table") {
+      const table = tableOf(el);
+      if (table) out.push(table);
+      return;
+    }
+    if (tag === "figure") {
+      figureOf(el, out);
+      return;
+    }
+    if (tag === "img") {
+      const image2 = imageOf(el, "");
+      if (image2) out.push(image2);
+      return;
+    }
+    if (tag === "video") {
+      out.push(videoOf(el, ""));
+      return;
+    }
+    if (tag === "iframe") {
+      const href = el.getAttribute("src") ?? "";
+      if (PLAYER.test(href)) {
+        out.push({
+          kind: "video",
+          src: "",
+          poster: "",
+          href,
+          caption: words2(el.getAttributeNode("title"))
+        });
+      }
+      return;
+    }
+    if (tag === "pre") {
+      const text2 = (el.textContent ?? "").replace(/\s+$/, "");
+      if (text2) out.push({ kind: "code", text: text2 });
+      return;
+    }
+    const direct = [...el.childNodes].some(
+      (n3) => n3.nodeType === Node.TEXT_NODE && (n3.textContent ?? "").trim() !== ""
+    );
+    if (direct) {
+      paragraphOf(el, out);
+      return;
+    }
+    walk(el, out);
+  }
+  function walk(el, out) {
+    for (const kid of el.children) block(kid, out);
+  }
+  function score(el) {
+    let text2 = 0;
+    for (const p of el.querySelectorAll("p, li, td, h1, h2, h3, h4, h5, h6")) {
+      text2 += (p.textContent ?? "").trim().length;
+    }
+    let links = 0;
+    for (const a of el.querySelectorAll("a")) links += (a.textContent ?? "").trim().length;
+    return text2 - links;
+  }
+  function pickRoot() {
+    const marked = document.querySelector(`[${marker}]`);
+    if (marked) return marked;
+    const main = document.querySelector("main");
+    if (main && score(main) > 0) return main;
+    const article = document.querySelector("article");
+    if (article && score(article) > 0) return article;
+    let best = document.body;
+    let top = score(document.body);
+    for (const el of document.body.querySelectorAll("div, section, td")) {
+      const here = score(el);
+      if (here >= top) {
+        top = here;
+        best = el;
+      }
+    }
+    return best;
+  }
+  const root2 = pickRoot();
+  const blocks = [];
+  walk(root2, blocks);
+  const heading = words2(root2.querySelector("h1")) || words2(document.querySelector("h1"));
+  const og = document.querySelector('meta[property="og:image"], meta[name="og:image"]') ?? document.querySelector('meta[property="og:image:url"], meta[name="twitter:image"]');
+  return {
+    title: heading || (document.title ?? "").replace(/\s+/g, " ").trim(),
+    base: document.querySelector("base[href]")?.getAttribute("href") ?? "",
+    ogImage: og?.getAttribute("content") ?? "",
+    blocks
+  };
+}
+async function localise(seen, base, dir, opts, timeoutMs, warnings) {
+  const maxAssets = opts.maxAssets ?? MAX_ASSETS;
+  const maxClips = opts.maxClips ?? MAX_CLIPS;
+  const maxBytes = opts.maxTotalBytes ?? MAX_TOTAL_BYTES;
+  const wallMs = opts.maxWallMs ?? MAX_WALL_MS;
+  const deadline = Date.now() + wallMs;
+  const out = [];
+  const assets = [];
+  const clips = [];
+  let spent = 0;
+  const done = /* @__PURE__ */ new Map();
+  const ref = (got) => opts.refs === "relative" ? basename2(got.path) : got.path;
+  const overdrawn = () => {
+    if (Date.now() >= deadline) {
+      return `the harvest has used its ${Math.round(wallMs / 1e3)}s budget \u2014 raise maxWallMs`;
+    }
+    if (spent >= maxBytes) {
+      return `the harvest has downloaded ${mb(spent)} of its ${mb(maxBytes)} \u2014 raise maxTotalBytes`;
+    }
+    return null;
+  };
+  const bytesOf = async (url) => {
+    const got = await fetchGuarded(url, {
+      maxBytes: opts.maxAssetBytes ?? ASSET_MAX_BYTES,
+      timeoutMs,
+      ...opts.allowLoopback === true ? { allowLoopback: true } : {}
+    });
+    spent += got.bytes.length;
+    return got.bytes;
+  };
+  const grab = async (raw2, what) => {
+    const url = absolute(raw2, base);
+    if (url === null) {
+      warnings.push(
+        `${what} was left out: "${raw2.slice(0, 120)}" is not an http(s) URL. Only web URLs are fetched; a data: or blob: source has to be saved by hand.`
+      );
+      return null;
+    }
+    const already = done.get(url);
+    if (already !== void 0) return already;
+    if (assets.length >= maxAssets) {
+      done.set(url, null);
+      warnings.push(
+        `${what} was left out: ${url} \u2014 already at ${maxAssets} assets. Raise maxAssets if the page really has that many figures.`
+      );
+      return null;
+    }
+    const capped = overdrawn();
+    if (capped !== null) {
+      done.set(url, null);
+      warnings.push(`${what} was left out: ${url} \u2014 ${capped} if the page is worth the wait.`);
+      return null;
+    }
+    let got = null;
+    try {
+      const bytes = await bytesOf(url);
+      const size = imageSize(bytes);
+      if (size.width < MIN_FIGURE_PX || size.height < MIN_FIGURE_PX) {
+        throw new Error(
+          `it is ${size.width}x${size.height}, under ${MIN_FIGURE_PX}px \u2014 spacers, icons and tracking pixels look like this, and a slide cannot use one`
+        );
+      }
+      const path2 = join4(dir, assetName(url, extFor2(sniffFormat(bytes))));
+      await writeFile3(path2, bytes);
+      assets.push(path2);
+      got = { path: path2, width: size.width, height: size.height };
+    } catch (err) {
+      got = null;
+      warnings.push(`${what} was left out: ${url} \u2014 ${why(err)}`);
+    }
+    done.set(url, got);
+    return got;
+  };
+  const shrink = async (url, path2, measured, what) => {
+    if (opts.transcode === false) return { path: path2, ...measured };
+    const out2 = join4(dir, assetName(url, ".vp9.webm"));
+    let small;
+    try {
+      small = await transcode(path2, out2, {
+        ...opts.maxClipSeconds === void 0 ? {} : { maxSeconds: opts.maxClipSeconds }
+      });
+    } catch (err) {
+      warnings.push(`${what} was shipped as the page served it: ${why(err)}`);
+      return { path: path2, ...measured };
+    }
+    for (const w of small.warnings) warnings.push(`${what} \u2014 ${w}`);
+    if (small.transcoded) {
+      const [before, after] = await Promise.all([sizeOf(path2), sizeOf(small.path)]);
+      if (before > 0 && after > before) {
+        warnings.push(
+          `${what} \u2014 ${basename2(small.path)} came back LARGER than the page's own file (${mb(before)} \u2192 ${mb(after)}) at ${small.width}x${small.height}. The encode is sized for the render, which pre-decodes every clip to one still per output frame, so it still costs less to render; pass --no-transcode if the deck's size is what matters here.`
+        );
+      }
+      await rm2(path2, { force: true });
+    }
+    return {
+      path: small.path,
+      width: small.width,
+      height: small.height,
+      ...small.seconds === void 0 ? {} : { seconds: small.seconds }
+    };
+  };
+  const grabVideo = async (url, what) => {
+    if (clips.length >= maxClips) {
+      warnings.push(
+        maxClips === 0 ? `${what} is a link only: this harvest downloads no videos at all (maxClips is 0).` : `${what} is a link only: already holding ${maxClips} clips. Raise maxClips if the page really is that many videos.`
+      );
+      return null;
+    }
+    const capped = overdrawn();
+    if (capped !== null) {
+      warnings.push(`${what} is a link only: ${capped} if the video is worth the wait.`);
+      return null;
+    }
+    try {
+      const bytes = await bytesOf(url);
+      const measured = videoSize(bytes);
+      const path2 = join4(dir, assetName(url, `.${measured.container}`));
+      await writeFile3(path2, bytes);
+      return await shrink(url, path2, measured, what);
+    } catch (err) {
+      warnings.push(`${what} was not downloaded: ${url} \u2014 ${why(err)}`);
+      return null;
+    }
+  };
+  let ogSpent = false;
+  const stillFor = async (poster, named, needed) => {
+    if (poster) return grab(poster, `the poster of ${named}`);
+    if (needed && seen.ogImage && !ogSpent) {
+      ogSpent = true;
+      return grab(seen.ogImage, `the page's og:image, taken as the still of ${named}`);
+    }
+    return null;
+  };
+  for (const item of seen.blocks) {
+    if (item.kind === "image") {
+      const named = item.caption || item.alt;
+      const got = await grab(item.src, named ? `the image "${named}"` : "an image");
+      if (got) out.push({ ...item, src: ref(got) });
+      continue;
+    }
+    if (item.kind === "video") {
+      const named = item.caption ? `the video "${item.caption}"` : "a video";
+      const file = absolute(item.src, base);
+      const page = absolute(item.href, base);
+      const subject = file ?? page;
+      const watch = page ?? file;
+      const policy = subject === null ? null : policyFor(subject, "bake");
+      const held = policy === "bake" && subject !== null ? await grabVideo(subject, named) : null;
+      const still = await stillFor(item.poster, named, held === null);
+      if (held !== null) {
+        clips.push({
+          file: held.path,
+          poster: still?.path ?? "",
+          href: "",
+          width: held.width,
+          height: held.height,
+          ...held.seconds === void 0 ? {} : { seconds: held.seconds },
+          caption: item.caption
+        });
+        out.push({ ...item, src: "", poster: still ? ref(still) : "", href: "" });
+        continue;
+      }
+      if (still !== null && watch !== null) {
+        clips.push({
+          file: "",
+          poster: still.path,
+          href: watch,
+          width: still.width,
+          height: still.height,
+          caption: item.caption
+        });
+        warnings.push(
+          `${named} is a link only: ${unheld(policy)}. The still is what the deck shows, and a viewer goes to ${watch}.`
+        );
+        out.push({ ...item, src: "", poster: ref(still), href: watch });
+        continue;
+      }
+      if (still !== null) {
+        warnings.push(
+          `${named} is a still only: the page names no source for it, so there is nothing to play.`
+        );
+        out.push({ ...item, src: "", poster: ref(still), href: "" });
+        continue;
+      }
+      if (watch === null) {
+        warnings.push(`${named} was left out: it names neither a poster image nor a URL.`);
+        continue;
+      }
+      warnings.push(
+        `${named} is a link only and the page gave it no still: no poster attribute, no og:image left to spend. Save a frame by hand and add it to source.json as a clip figure.`
+      );
+      out.push({ ...item, src: "", poster: "", href: watch });
+      continue;
+    }
+    out.push(item);
+  }
+  return { blocks: out, assets, clips };
+}
+function unheld(policy) {
+  if (policy === "embed") return "it is a player page, which is never downloaded";
+  if (policy === "link") {
+    return "its URL does not end in a video extension, so what came back could as easily be a page";
+  }
+  return "the file could not be held";
+}
+async function sizeOf(path2) {
+  return await stat(path2).then(
+    (s) => s.size,
+    () => 0
+  );
+}
+function mb(bytes) {
+  return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+function absolute(raw2, base) {
+  const trimmed = raw2.trim();
+  if (!trimmed) return null;
+  try {
+    const url = new URL(trimmed, base);
+    return url.protocol === "http:" || url.protocol === "https:" ? url.href : null;
+  } catch {
+    return null;
+  }
+}
+function assetName(url, ext) {
+  const last = new URL(url).pathname.split("/").pop() ?? "";
+  const stem = last.replace(/\.[^.]*$/, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40) || "figure";
+  const hash = createHash5("sha256").update(url).digest("hex").slice(0, 8);
+  return `${stem}-${hash}${ext}`;
+}
+function extFor2(format) {
+  if (format === void 0) return ".img";
+  return format === "jpeg" ? ".jpg" : `.${format}`;
+}
+function why(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+function sniffVideo(b) {
+  if (b.length >= 12 && b.toString("latin1", 4, 8) === "ftyp") return "mp4";
+  if (b.length >= 4 && b.readUInt32BE(0) === 440786851) return "webm";
+  return void 0;
+}
+function videoSize(b) {
+  const container = sniffVideo(b);
+  if (container === void 0) {
+    throw new Error(
+      "its first bytes are neither an ISO base media (mp4) header nor an EBML (webm) one, so it is not a video this can measure \u2014 which is what an interstitial or a login page looks like"
+    );
+  }
+  const measured = container === "mp4" ? mp4Size(b) : webmSize(b);
+  if (measured.width < MIN_FIGURE_PX || measured.height < MIN_FIGURE_PX) {
+    throw new Error(
+      `it measures ${measured.width}x${measured.height}, under ${MIN_FIGURE_PX}px \u2014 a slide cannot use one`
+    );
+  }
+  return { ...measured, container };
+}
+function boxes2(b, from, to) {
+  const out = [];
+  let at = from;
+  while (at + 8 <= to) {
+    let size = b.readUInt32BE(at);
+    const type = b.toString("latin1", at + 4, at + 8);
+    let body = at + 8;
+    if (size === 1) {
+      if (body + 8 > to) return out;
+      size = Number(b.readBigUInt64BE(body));
+      body += 8;
+    } else if (size === 0) {
+      size = to - at;
+    }
+    const end = at + size;
+    if (size < body - at || end > to) return out;
+    out.push({ type, body, end });
+    at = end;
+  }
+  return out;
+}
+function mp4Size(b) {
+  const moov = boxes2(b, 0, b.length).find((box) => box.type === "moov");
+  if (moov === void 0) {
+    throw new Error(
+      "it has no moov box \u2014 the file is truncated, or it is a fragmented stream whose header never arrived"
+    );
+  }
+  let seconds;
+  let size;
+  for (const box of boxes2(b, moov.body, moov.end)) {
+    if (box.type === "mvhd") seconds = mvhdSeconds(b, box.body);
+    if (box.type !== "trak") continue;
+    for (const inner of boxes2(b, box.body, box.end)) {
+      if (inner.type === "tkhd" && size === void 0) size = tkhdSize(b, inner.body);
+    }
+  }
+  if (size === void 0) {
+    throw new Error(
+      "no track in it declares a width and a height, so there is no picture to place"
+    );
+  }
+  return { ...size, ...seconds === void 0 ? {} : { seconds } };
+}
+function tkhdSize(b, body) {
+  const matrix = body + (b[body] === 1 ? 52 : 40);
+  const at = matrix + 36;
+  if (at + 8 > b.length) return void 0;
+  const width = Math.round(b.readUInt32BE(at) / 65536);
+  const height = Math.round(b.readUInt32BE(at + 4) / 65536);
+  if (width <= 0 || height <= 0) return void 0;
+  const quarterTurn = b.readInt32BE(matrix) === 0 && b.readInt32BE(matrix + 16) === 0;
+  return quarterTurn ? { width: height, height: width } : { width, height };
+}
+function mvhdSeconds(b, body) {
+  const long = b[body] === 1;
+  const at = body + (long ? 20 : 12);
+  if (at + (long ? 12 : 8) > b.length) return void 0;
+  const timescale = b.readUInt32BE(at);
+  const ticks = long ? Number(b.readBigUInt64BE(at + 4)) : b.readUInt32BE(at + 4);
+  if (timescale <= 0 || ticks <= 0 || ticks === 4294967295) return void 0;
+  return sane(ticks / timescale);
+}
+var EBML_SEGMENT = 408125543;
+var EBML_INFO = 357149030;
+var EBML_TRACKS = 374648427;
+var EBML_TRACK_ENTRY = 174;
+var EBML_VIDEO = 224;
+var EBML_PIXEL_WIDTH = 176;
+var EBML_PIXEL_HEIGHT = 186;
+var EBML_DISPLAY_WIDTH = 21680;
+var EBML_DISPLAY_HEIGHT = 21690;
+var EBML_TIMECODE_SCALE = 2807729;
+var EBML_DURATION = 17545;
+function webmSize(b) {
+  let pixel = { width: 0, height: 0 };
+  let display = { width: 0, height: 0 };
+  let scale = 1e6;
+  let ticks;
+  const masters = /* @__PURE__ */ new Set([EBML_SEGMENT, EBML_INFO, EBML_TRACKS, EBML_TRACK_ENTRY, EBML_VIDEO]);
+  const scan = (from, to, depth) => {
+    let at = from;
+    while (at < to) {
+      const el = ebml(b, at, to);
+      if (el === void 0 || el.end <= at) return;
+      if (masters.has(el.id)) {
+        if (depth < 6) scan(el.body, el.end, depth + 1);
+      } else if (el.id === EBML_PIXEL_WIDTH && pixel.width === 0) {
+        pixel = { ...pixel, width: uint(b, el) };
+      } else if (el.id === EBML_PIXEL_HEIGHT && pixel.height === 0) {
+        pixel = { ...pixel, height: uint(b, el) };
+      } else if (el.id === EBML_DISPLAY_WIDTH && display.width === 0) {
+        display = { ...display, width: uint(b, el) };
+      } else if (el.id === EBML_DISPLAY_HEIGHT && display.height === 0) {
+        display = { ...display, height: uint(b, el) };
+      } else if (el.id === EBML_TIMECODE_SCALE) {
+        scale = uint(b, el) || scale;
+      } else if (el.id === EBML_DURATION) {
+        ticks = float(b, el);
+      }
+      at = el.end;
+    }
+  };
+  scan(0, b.length, 0);
+  const width = display.width || pixel.width;
+  const height = display.height || pixel.height;
+  if (width <= 0 || height <= 0) {
+    throw new Error(
+      "no track in it declares PixelWidth and PixelHeight, so there is no picture to place"
+    );
+  }
+  const seconds = ticks === void 0 ? void 0 : sane(ticks * scale / 1e9);
+  return { width, height, ...seconds === void 0 ? {} : { seconds } };
+}
+function ebml(b, at, to) {
+  const idLen = vintLen(b[at]);
+  if (idLen === 0 || at + idLen > to) return void 0;
+  let id2 = 0;
+  for (let i = 0; i < idLen; i += 1) id2 = id2 * 256 + (b[at + i] ?? 0);
+  let p = at + idLen;
+  const sizeLen = vintLen(b[p]);
+  if (sizeLen === 0 || p + sizeLen > to) return void 0;
+  const first = b[p] ?? 0;
+  const mask = 255 >> sizeLen;
+  let size = first & mask;
+  let unknown = size === mask;
+  for (let i = 1; i < sizeLen; i += 1) {
+    const byte = b[p + i] ?? 0;
+    size = size * 256 + byte;
+    unknown = unknown && byte === 255;
+  }
+  p += sizeLen;
+  return { id: id2, body: p, end: unknown ? to : Math.min(p + size, to) };
+}
+function vintLen(first) {
+  if (first === void 0 || first === 0) return 0;
+  let len = 1;
+  for (let mask = 128; (first & mask) === 0; mask >>= 1) len += 1;
+  return len;
+}
+function uint(b, el) {
+  let value = 0;
+  for (let at = el.body; at < el.end && at - el.body < 8; at += 1)
+    value = value * 256 + (b[at] ?? 0);
+  return value;
+}
+function float(b, el) {
+  const width = el.end - el.body;
+  if (width === 4) return b.readFloatBE(el.body);
+  if (width === 8) return b.readDoubleBE(el.body);
+  return void 0;
+}
+function sane(seconds) {
+  return Number.isFinite(seconds) && seconds > 0 && seconds < 86400 ? seconds : void 0;
+}
+function toMarkdown(blocks) {
+  const out = [];
+  for (const item of blocks) {
+    switch (item.kind) {
+      case "heading":
+        out.push(`${"#".repeat(Math.min(Math.max(item.depth, 1), 6))} ${inline(item.text)}`);
+        break;
+      case "paragraph":
+        out.push(inline(item.text));
+        break;
+      case "code":
+        out.push(fenced(item.text));
+        break;
+      case "list":
+        out.push(
+          item.items.map((li, n3) => `${item.ordered ? `${n3 + 1}.` : "-"} ${inline(li)}`).join("\n")
+        );
+        break;
+      case "table":
+        out.push(pipes(item.columns, item.rows));
+        break;
+      case "image":
+        out.push(`![${inline(item.alt)}](${destination(item.src)})`);
+        if (item.caption || item.alt) out.push(`*${inline(item.caption || item.alt)}*`);
+        break;
+      case "video": {
+        if (item.poster) {
+          out.push(`![${inline(item.caption)}](${destination(item.poster)})`);
+          if (item.caption) out.push(`*${inline(item.caption)}*`);
+        } else if (item.caption) {
+          out.push(inline(item.caption));
+        }
+        const link = item.href || item.src;
+        if (/^https?:/i.test(link)) out.push(`Video: <${link}>`);
+        break;
+      }
+    }
+  }
+  return `${out.filter((block) => block !== "").join("\n\n")}
+`;
+}
+function inline(text2) {
+  return text2.replace(/\s+/g, " ").trim().replace(/([\\`*_[\]<>])/g, "\\$1").replace(/^(#{1,6}\s|[-+]\s)/, "\\$&").replace(/^(\d{1,9})([.)]\s)/, "$1\\$2");
+}
+function destination(path2) {
+  if (/[<>]/.test(path2)) {
+    throw new Error(
+      `cannot reference ${path2} from markdown: a path containing < or > has no spelling as a link destination. Harvest into a directory without them.`
+    );
+  }
+  return /[\s()]/.test(path2) ? `<${path2}>` : path2;
+}
+function pipes(columns2, rows) {
+  const width = Math.max(columns2.length, ...rows.map((r) => r.length), 1);
+  const cells = (row) => `| ${Array.from({ length: width }, (_, i) => inline(row[i] ?? "").replace(/\|/g, "\\|")).join(" | ")} |`;
+  const rule = `| ${Array.from({ length: width }, () => "---").join(" | ")} |`;
+  return [cells(columns2), rule, ...rows.map(cells)].join("\n");
+}
+function fenced(code) {
+  const runs = [...code.matchAll(/`+/g)].map((m) => m[0].length + 1);
+  const fence = "`".repeat(Math.max(3, ...runs));
+  return `${fence}
+${code}
+${fence}`;
+}
+
+// src/plan/codex.ts
+import { spawn as spawn2 } from "node:child_process";
+import { mkdtemp, readFile as readFile5, rm as rm3, writeFile as writeFile4 } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join as join5 } from "node:path";
+import { z as z3 } from "zod";
+
+// src/plan/arc.ts
+var ARC_ROLES = ["intro", "background", "limitations", "conclusion"];
+function requiredRoles(beatCount) {
+  if (beatCount >= 8) return ARC_ROLES;
+  if (beatCount >= 5) return ["limitations", "conclusion"];
+  return [];
+}
+function paperArcRequested(prefs) {
+  return prefs.genre === "paper";
+}
+
+// src/plan/duration.ts
+var SPEECH_CPS = { latin: 14.4, cjk: 6.5 };
+var LAST_HOLD_SECONDS = 4.2;
 var STOPS_PER_BEAT = 3.1;
 var MOTION_SHARE = 0.35;
 var MIN_SENTENCE_CHARS = 30;
@@ -6927,9 +9194,28 @@ function renderSource(source) {
   } else {
     const n3 = source.figures.length;
     out.push(`${n3 === 1 ? "1 figure" : `${n3} figures`} in this document.`);
+    if (source.figures.some((f) => f.kind === "clip")) {
+      out.push(
+        "",
+        "A CLIP is a figure whose asset is video. Cite it exactly as you cite any other",
+        "figure \u2014 `figureId` on the beat, `[figure id]` in evidence \u2014 and pick it for the",
+        "same reason: it is the picture that carries the point.",
+        "WHAT IT COSTS, and it decides whether a beat is worth spending on one: the deck",
+        "holds a clip PAUSED AND MUTED, so a viewer clicking through sees one frame until",
+        "they press play, and the rendered video shows that same frame unless the clip is",
+        "a file this deck actually holds. A clip listed as watchable only at a link is a",
+        "page whose video we could not download, and its still is all any format will ever",
+        "show. So write the beat for the FRAME: claim what the picture states, and never",
+        "narrate a motion the still does not."
+      );
+    }
     const headings = new Map(source.sections.map((s) => [s.id, s.heading]));
     for (const f of source.figures) {
-      out.push("", `[figure ${f.id}] ${f.width}x${f.height} \u2014 ${f.caption}`);
+      const size = f.kind === "clip" ? `CLIP ${f.width}x${f.height}${f.seconds === void 0 ? "" : `, ${Math.round(f.seconds * 10) / 10}s`}` : `${f.width}x${f.height}`;
+      out.push("", `[figure ${f.id}] ${size} \u2014 ${f.caption}`);
+      if (f.kind === "clip" && f.href) {
+        out.push(`  watchable only at ${f.href} \u2014 the deck shows its still, never the video`);
+      }
       const heading = f.sectionId === void 0 ? void 0 : headings.get(f.sectionId);
       if (f.sectionId !== void 0) {
         out.push(`  under: [section ${f.sectionId}]${heading ? ` ${heading}` : ""}`);
@@ -7063,7 +9349,7 @@ function assertRefsResolve(storyboard, source, opts = {}) {
 }
 
 // src/plan/codex.ts
-var DEFAULT_TIMEOUT_MS = 10 * 6e4;
+var DEFAULT_TIMEOUT_MS2 = 10 * 6e4;
 var UNSUPPORTED = /* @__PURE__ */ new Set([
   "$schema",
   "default",
@@ -7138,26 +9424,26 @@ function hideFromPlanner(node, hidden) {
 }
 function schemaFor(prefs) {
   return hideFromPlanner(
-    forStructuredOutput(z2.toJSONSchema(storyboardSchema, { io: "input" })),
+    forStructuredOutput(z3.toJSONSchema(storyboardSchema, { io: "input" })),
     plannerInvisible(prefs)
   );
 }
 var SCHEMA = schemaFor({ genre: "general" });
 async function codexPlanner(source, opts = {}) {
   const prefs = opts.prefs ?? prefsSchema.parse({});
-  const dir = await mkdtemp(join3(tmpdir(), "decksmith-plan-"));
+  const dir = await mkdtemp(join5(tmpdir(), "decksmith-plan-"));
   try {
-    const schemaPath = join3(dir, "storyboard.schema.json");
-    const outPath = join3(dir, "storyboard.json");
-    await writeFile3(schemaPath, JSON.stringify(schemaFor(prefs)));
+    const schemaPath = join5(dir, "storyboard.schema.json");
+    const outPath = join5(dir, "storyboard.json");
+    await writeFile4(schemaPath, JSON.stringify(schemaFor(prefs)));
     await (opts.run ?? runCodex)({
       prompt: buildPrompt(source, prefs),
       schemaPath,
       outPath,
       ...opts.model === void 0 ? {} : { model: opts.model },
-      timeoutMs: opts.timeoutMs ?? DEFAULT_TIMEOUT_MS
+      timeoutMs: opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2
     });
-    const raw2 = await readFile3(outPath, "utf8").catch(() => "");
+    const raw2 = await readFile5(outPath, "utf8").catch(() => "");
     if (raw2.trim() === "") {
       throw new Error("Codex produced no final message. Re-run, or try a shorter source.");
     }
@@ -7188,7 +9474,7 @@ ${issues}`);
     assertRefsResolve(result.data, source, { pending: prefs.images.enabled ? "allow" : "refuse" });
     return result.data;
   } finally {
-    await rm(dir, { recursive: true, force: true });
+    await rm3(dir, { recursive: true, force: true });
   }
 }
 function buildPrompt(source, prefs) {
@@ -7230,8 +9516,8 @@ function codexCommand(args) {
 }
 function runCodex(args) {
   const { argv, env: env2 } = codexCommand(args);
-  return new Promise((resolve6, reject) => {
-    const child = spawn("codex", argv, {
+  return new Promise((resolve7, reject) => {
+    const child = spawn2("codex", argv, {
       stdio: ["pipe", "ignore", "pipe"],
       ...env2 === void 0 ? {} : { env: env2 }
     });
@@ -7253,7 +9539,7 @@ function runCodex(args) {
     });
     child.on("close", (code) => {
       clearTimeout(timer);
-      if (code === 0) return resolve6();
+      if (code === 0) return resolve7();
       reject(
         new Error(`codex exec exited ${code}.
 ${stderr.trim().split("\n").slice(-8).join("\n")}`)
@@ -7264,16 +9550,16 @@ ${stderr.trim().split("\n").slice(-8).join("\n")}`)
 }
 
 // src/images/illustrate.ts
-import { createHash as createHash5 } from "node:crypto";
-import { mkdir as mkdir3, readFile as readFile5, rename, rm as rm3, writeFile as writeFile5 } from "node:fs/promises";
-import { join as join5 } from "node:path";
+import { createHash as createHash7 } from "node:crypto";
+import { mkdir as mkdir4, readFile as readFile7, rename, rm as rm5, writeFile as writeFile6 } from "node:fs/promises";
+import { join as join7 } from "node:path";
 
 // src/images/providers.ts
-import { createHash as createHash4 } from "node:crypto";
-import { mkdtemp as mkdtemp2, readFile as readFile4, rm as rm2, writeFile as writeFile4 } from "node:fs/promises";
+import { createHash as createHash6 } from "node:crypto";
+import { mkdtemp as mkdtemp2, readFile as readFile6, rm as rm4, writeFile as writeFile5 } from "node:fs/promises";
 import { tmpdir as tmpdir2 } from "node:os";
-import { join as join4, resolve } from "node:path";
-import { z as z3 } from "zod";
+import { join as join6, resolve as resolve2 } from "node:path";
+import { z as z4 } from "zod";
 var SIZE = {
   landscape: { width: 1536, height: 1024 },
   square: { width: 1024, height: 1024 },
@@ -7296,11 +9582,11 @@ var DEFAULT_BASE_URL = "https://api.openai.com/v1";
 var DEFAULT_MODEL = "gpt-image-2";
 var REQUEST_TIMEOUT_MS = 12e4;
 var MAX_BYTES = 16 * 1024 * 1024;
-var generatedSchema = z3.object({
-  data: z3.array(z3.object({ b64_json: z3.string().optional(), url: z3.string().optional() })).optional()
+var generatedSchema = z4.object({
+  data: z4.array(z4.object({ b64_json: z4.string().optional(), url: z4.string().optional() })).optional()
 });
-var failedSchema = z3.object({
-  error: z3.object({ code: z3.string().nullish(), type: z3.string().nullish() }).nullish()
+var failedSchema = z4.object({
+  error: z4.object({ code: z4.string().nullish(), type: z4.string().nullish() }).nullish()
 });
 function openaiImages(opts) {
   const base = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
@@ -7325,8 +9611,8 @@ function openaiImages(opts) {
         }),
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
       });
-      const body = await readCapped(res);
-      if (!res.ok) throw new Error(`openai images: HTTP ${res.status}${reason(body)}`);
+      const body = await readCapped2(res);
+      if (!res.ok) throw new Error(`openai images: HTTP ${res.status}${reason2(body)}`);
       const first = generatedSchema.safeParse(parseJson(body)).data?.data?.[0];
       if (first?.b64_json) return raster(Buffer.from(first.b64_json, "base64"), "openai images");
       if (!first?.url) throw new Error("openai images: answer carried neither b64_json nor url");
@@ -7339,14 +9625,14 @@ function openaiImages(opts) {
         redirect: "error",
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
       });
-      const bytes = await readCapped(picture);
+      const bytes = await readCapped2(picture);
       if (!picture.ok)
         throw new Error(`openai images: HTTP ${picture.status} fetching the picture`);
       return raster(bytes, "openai images");
     }
   };
 }
-function reason(body) {
+function reason2(body) {
   const error = failedSchema.safeParse(parseJson(body)).data?.error;
   const code = error?.code ?? error?.type;
   return code ? ` (${code})` : "";
@@ -7358,7 +9644,7 @@ function parseJson(body) {
     return void 0;
   }
 }
-async function readCapped(res) {
+async function readCapped2(res) {
   const over = `openai images: answer is over ${MAX_BYTES >> 20} MB`;
   if (Number(res.headers.get("content-length")) > MAX_BYTES) throw new Error(over);
   const reader = res.body?.getReader();
@@ -7388,10 +9674,10 @@ var ANSWER_SCHEMA = {
   required: ["ok", "file", "reason"],
   additionalProperties: false
 };
-var answerSchema = z3.object({
-  ok: z3.boolean(),
-  file: z3.string().nullish(),
-  reason: z3.string().nullish()
+var answerSchema = z4.object({
+  ok: z4.boolean(),
+  file: z4.string().nullish(),
+  reason: z4.string().nullish()
 });
 function codexImages(opts = {}) {
   const run5 = opts.run ?? runCodex;
@@ -7404,11 +9690,11 @@ function codexImages(opts = {}) {
     async check() {
     },
     async generate(req) {
-      const dir = await mkdtemp2(join4(tmpdir2(), "decksmith-image-"));
+      const dir = await mkdtemp2(join6(tmpdir2(), "decksmith-image-"));
       try {
-        const schemaPath = join4(dir, "answer.schema.json");
-        const outPath = join4(dir, "answer.json");
-        await writeFile4(schemaPath, JSON.stringify(ANSWER_SCHEMA));
+        const schemaPath = join6(dir, "answer.schema.json");
+        const outPath = join6(dir, "answer.json");
+        await writeFile5(schemaPath, JSON.stringify(ANSWER_SCHEMA));
         await run5({
           prompt: codexPrompt(req),
           schemaPath,
@@ -7417,7 +9703,7 @@ function codexImages(opts = {}) {
           cwd: dir,
           sandbox: "workspace-write"
         });
-        const raw2 = await readFile4(outPath, "utf8").catch(() => "");
+        const raw2 = await readFile6(outPath, "utf8").catch(() => "");
         const answer = answerSchema.safeParse(parseJson(Buffer.from(raw2)));
         if (!answer.success) throw new Error("codex could not generate a picture: no final answer");
         if (!answer.data.ok) {
@@ -7425,15 +9711,15 @@ function codexImages(opts = {}) {
             `codex could not generate a picture: ${answer.data.reason ?? "no reason given"}`
           );
         }
-        const candidates2 = [join4(dir, "picture.png")];
-        if (answer.data.file) candidates2.push(resolve(dir, answer.data.file));
+        const candidates2 = [join6(dir, "picture.png")];
+        if (answer.data.file) candidates2.push(resolve2(dir, answer.data.file));
         for (const path2 of candidates2) {
-          const bytes = await readFile4(path2).catch(() => null);
+          const bytes = await readFile6(path2).catch(() => null);
           if (bytes) return raster(bytes, "codex");
         }
         throw new Error("codex said ok but wrote no picture.png");
       } finally {
-        await rm2(dir, { recursive: true, force: true });
+        await rm4(dir, { recursive: true, force: true });
       }
     }
   };
@@ -7468,7 +9754,7 @@ function mulberry32(seed) {
 }
 function drawSvg(req) {
   const { width: W, height: H } = SIZE[req.aspect];
-  const seed = createHash4("sha256").update([req.prompt, req.style, req.aspect].join("|")).digest();
+  const seed = createHash6("sha256").update([req.prompt, req.style, req.aspect].join("|")).digest();
   const rand = mulberry32(seed.readUInt32BE(0));
   const accent = ACCENTS[Math.floor(rand() * ACCENTS.length)];
   const count = 6 + Math.floor(rand() * 5);
@@ -7499,11 +9785,6 @@ function drawSvg(req) {
   return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 ${W} ${H}" width="${W}" height="${H}">${parts.join("")}</svg>
 `;
 }
-function svgSize(bytes) {
-  const m = /viewBox="0 0 (\d+) (\d+)"/.exec(bytes.toString("utf8", 0, 200));
-  if (!m) throw new Error("svg has no viewBox");
-  return { width: Number(m[1]), height: Number(m[2]) };
-}
 function toolSvg() {
   return {
     id: "svg",
@@ -7547,7 +9828,7 @@ function imageChain(images, backend) {
 }
 
 // src/images/illustrate.ts
-var EXT = {
+var EXT2 = {
   "image/png": ".png",
   "image/jpeg": ".jpg",
   "image/svg+xml": ".svg"
@@ -7565,7 +9846,7 @@ async function illustrate(storyboard, source, opts) {
   const tool = last?.id === "svg" ? last : toolSvg();
   if (tool !== last) chain.push(tool);
   const dropped = /* @__PURE__ */ new Set();
-  if (pending.length > 0) await mkdir3(opts.assetsDir, { recursive: true });
+  if (pending.length > 0) await mkdir4(opts.assetsDir, { recursive: true });
   for (const [i, slot] of pending.entries()) {
     let rungs = chain;
     if (i >= images.max) {
@@ -7585,6 +9866,9 @@ async function illustrate(storyboard, source, opts) {
         const picture = await draw(provider, req, name, opts.assetsDir);
         const figure = {
           id: slot.figureId,
+          // An illustration is always a still: every provider draws a picture,
+          // and there is no rung that returns a video.
+          kind: "image",
           src: picture.src,
           caption: slot.brief.caption,
           width: picture.width,
@@ -7603,8 +9887,8 @@ async function illustrate(storyboard, source, opts) {
       } catch (err) {
         const after = live[j + 1];
         if (!after) throw err;
-        const why = err instanceof Error ? err.message : String(err);
-        step(`illustrate: ${slot.label} via ${provider.id} failed (${why}); trying ${after.id}`);
+        const why2 = err instanceof Error ? err.message : String(err);
+        step(`illustrate: ${slot.label} via ${provider.id} failed (${why2}); trying ${after.id}`);
         dropped.add(provider.id);
       }
     }
@@ -7654,36 +9938,36 @@ function slots(storyboard, known) {
   return out;
 }
 function cacheKey(providerId, req) {
-  return createHash5("sha256").update(["v1", providerId, req.model ?? "", req.aspect, req.style, req.prompt].join("\n")).digest("hex");
+  return createHash7("sha256").update(["v1", providerId, req.model ?? "", req.aspect, req.style, req.prompt].join("\n")).digest("hex");
 }
 async function draw(provider, req, name, dir) {
-  for (const ext of Object.values(EXT)) {
+  for (const ext of Object.values(EXT2)) {
     const src2 = `${name}${ext}`;
-    const bytes = await readFile5(join5(dir, src2)).catch(() => null);
-    if (bytes) return { src: src2, ...sizeOf(bytes, ext), cached: true };
+    const bytes = await readFile7(join7(dir, src2)).catch(() => null);
+    if (bytes) return { src: src2, ...sizeOf2(bytes, ext), cached: true };
   }
   await provider.check();
   const img = await provider.generate(req);
-  const src = `${name}${EXT[img.mime]}`;
-  const tmp = join5(dir, `.${name}.tmp`);
+  const src = `${name}${EXT2[img.mime]}`;
+  const tmp = join7(dir, `.${name}.tmp`);
   try {
-    await writeFile5(tmp, img.bytes);
-    await rename(tmp, join5(dir, src));
+    await writeFile6(tmp, img.bytes);
+    await rename(tmp, join7(dir, src));
   } finally {
-    await rm3(tmp, { force: true });
+    await rm5(tmp, { force: true });
   }
   return { src, width: img.width, height: img.height, cached: false };
 }
-function sizeOf(bytes, ext) {
+function sizeOf2(bytes, ext) {
   return ext === ".svg" ? svgSize(bytes) : imageSize(bytes);
 }
 
 // src/narrate/tts.ts
-import { spawn as spawn2 } from "node:child_process";
-import { createHash as createHash6 } from "node:crypto";
-import { mkdir as mkdir4, readFile as readFile6, rm as rm4, writeFile as writeFile6 } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join as join6 } from "node:path";
+import { spawn as spawn3 } from "node:child_process";
+import { createHash as createHash8 } from "node:crypto";
+import { mkdir as mkdir5, readFile as readFile8, rm as rm6, writeFile as writeFile7 } from "node:fs/promises";
+import { homedir as homedir2 } from "node:os";
+import { join as join8 } from "node:path";
 var MISSING = [
   "edge-tts is not installed, so narration cannot be synthesised.",
   "",
@@ -7694,14 +9978,14 @@ var MISSING = [
 ].join("\n");
 function candidates() {
   const env2 = process.env.DECKSMITH_EDGE_TTS?.trim();
-  const home = homedir();
+  const home = homedir2();
   return [
     ...env2 ? [[env2]] : [],
     ["edge-tts"],
     // pip --user on macOS and on Linux respectively. Neither is on PATH by
     // default, and both are where this actually lands in practice.
-    [join6(home, "Library", "Python", "3.9", "bin", "edge-tts")],
-    [join6(home, ".local", "bin", "edge-tts")],
+    [join8(home, "Library", "Python", "3.9", "bin", "edge-tts")],
+    [join8(home, ".local", "bin", "edge-tts")],
     // Last resort: the module is installed even though its console script is
     // nowhere findable, which is the normal state of a pip --user install.
     ["python3", "-m", "edge_tts"]
@@ -7715,19 +9999,19 @@ async function answersHelp(argv) {
 }
 var resolved = null;
 function resolveEdgeTts(can = answersHelp) {
-  if (can !== answersHelp) return find(can);
-  resolved ??= find(can);
+  if (can !== answersHelp) return find2(can);
+  resolved ??= find2(can);
   return resolved;
 }
-async function find(can) {
+async function find2(can) {
   for (const argv of candidates()) {
     if (await can(argv)) return argv;
   }
   throw new Error(MISSING);
 }
 function runArgv(cmd, args) {
-  return new Promise((resolve6) => {
-    const child = spawn2(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
+  return new Promise((resolve7) => {
+    const child = spawn3(cmd, args, { stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let stderr = "";
     child.stdout.on("data", (b) => {
@@ -7736,8 +10020,8 @@ function runArgv(cmd, args) {
     child.stderr.on("data", (b) => {
       stderr += b.toString();
     });
-    child.on("error", (e) => resolve6({ code: -1, stderr: String(e), stdout }));
-    child.on("close", (code) => resolve6({ code: code ?? -1, stderr, stdout }));
+    child.on("error", (e) => resolve7({ code: -1, stderr: String(e), stdout }));
+    child.on("close", (code) => resolve7({ code: code ?? -1, stderr, stdout }));
   });
 }
 var edgeTts = {
@@ -7804,8 +10088,8 @@ function edgeProvider(runner = edgeTts) {
     async speak(req) {
       const subs = `${req.audio.replace(/\.mp3$/, "")}.srt`;
       await runner.speak({ ...req, subs });
-      const raw2 = await readFile6(subs, "utf8").catch(() => "");
-      await rm4(subs, { force: true });
+      const raw2 = await readFile8(subs, "utf8").catch(() => "");
+      await rm6(subs, { force: true });
       const cues = parseCues(raw2);
       const measured = await runner.measure(req.audio);
       const lastCue = cues.length > 0 ? cues[cues.length - 1].end : 0;
@@ -7814,7 +10098,7 @@ function edgeProvider(runner = edgeTts) {
   };
 }
 function cacheKey2(text2, voice, rate, pitch) {
-  return createHash6("sha256").update([text2, voice, rate, pitch].join("\0")).digest("hex").slice(0, 16);
+  return createHash8("sha256").update([text2, voice, rate, pitch].join("\0")).digest("hex").slice(0, 16);
 }
 async function synthesize(text2, opts) {
   const rate = opts.rate ?? "+0%";
@@ -7822,11 +10106,11 @@ async function synthesize(text2, opts) {
   const provider = opts.provider ?? edgeProvider(opts.runner ?? edgeTts);
   const key = cacheKey2(text2, opts.voice, rate, pitch);
   const file = `${key}.mp3`;
-  const audio = join6(opts.dir, file);
-  const sidecar = join6(opts.dir, `${key}.json`);
+  const audio = join8(opts.dir, file);
+  const sidecar = join8(opts.dir, `${key}.json`);
   const cached = await readSidecar(sidecar);
   if (cached) return { audio, file, seconds: cached.seconds, cues: cached.cues };
-  await mkdir4(opts.dir, { recursive: true });
+  await mkdir5(opts.dir, { recursive: true });
   const spoken = await provider.speak({ text: text2, voice: opts.voice, rate, pitch, audio });
   const { cues, seconds } = spoken;
   const clamped = cues.map((c) => ({
@@ -7835,13 +10119,13 @@ async function synthesize(text2, opts) {
     text: c.text
   }));
   const body = { seconds, cues: clamped, text: text2, voice: opts.voice };
-  await writeFile6(sidecar, `${JSON.stringify(body, null, 2)}
+  await writeFile7(sidecar, `${JSON.stringify(body, null, 2)}
 `);
   return { audio, file, seconds, cues: clamped };
 }
 async function readSidecar(path2) {
   try {
-    const parsed = JSON.parse(await readFile6(path2, "utf8"));
+    const parsed = JSON.parse(await readFile8(path2, "utf8"));
     const s = parsed;
     return typeof s?.seconds === "number" && s.seconds > 0 && Array.isArray(s.cues) ? s : null;
   } catch {
@@ -7894,7 +10178,7 @@ function stopCount(holds) {
   return Math.max(1, usable.size);
 }
 function stopsFor(beat, source, format, sid = "s1") {
-  const ctx = { source, format, theme: ink, sid };
+  const ctx = { source, format, theme: ink, sid, start: 0 };
   try {
     return stopCount(emitScene(beat, ctx).holds);
   } catch {
@@ -7933,7 +10217,7 @@ async function narrate(storyboard, source, prefs, opts) {
   for (const [i, beat] of storyboard.beats.entries()) {
     const text2 = beat.narration?.trim();
     if (!text2) continue;
-    const segments = [];
+    const segments2 = [];
     const stops = Math.min(stopsFor(beat, source, format, `s${i + 1}`), paced.speakingStops);
     const plan = planSegments(text2, stops);
     for (const [stop, line2] of plan.entries()) {
@@ -7945,7 +10229,7 @@ async function narrate(storyboard, source, prefs, opts) {
         dir: opts.dir,
         runner: opts.runner
       });
-      segments.push({
+      segments2.push({
         stop,
         text: line2,
         // Content-addressed and flat, so the path is the filename and the deck
@@ -7955,37 +10239,21 @@ async function narrate(storyboard, source, prefs, opts) {
         cues: speech.cues
       });
     }
-    if (segments.length > 0) beats[beat.id] = segments;
+    if (segments2.length > 0) beats[beat.id] = segments2;
   }
   return { voice, beats };
 }
 
 // src/verify/check.ts
-import { execFile } from "node:child_process";
-import { promisify } from "node:util";
-var run = promisify(execFile);
-
-// src/render/capture.ts
-import { homedir as homedir2 } from "node:os";
-import { join as join7 } from "node:path";
-async function chromePath(need = "open the deck with") {
-  const explicit = process.env.DECKSMITH_CHROME || process.env.CHROME_PATH;
-  if (explicit) return explicit;
-  const { getInstalledBrowsers } = await import("@puppeteer/browsers");
-  const cacheDir = process.env.PUPPETEER_CACHE_DIR || join7(homedir2(), ".cache", "puppeteer");
-  const installed = await getInstalledBrowsers({ cacheDir }).catch(() => []);
-  const found = installed.find((b) => b.browser === "chrome-headless-shell") ?? installed.find((b) => b.browser === "chrome");
-  if (found) return found.executablePath;
-  throw new Error(
-    `no Chrome to ${need} \u2014 run \`npx puppeteer browsers install chrome\`, or set DECKSMITH_CHROME to a Chrome binary.`
-  );
-}
-
-// src/verify/drift.ts
 import { execFile as execFile2 } from "node:child_process";
 import { promisify as promisify2 } from "node:util";
 var run2 = promisify2(execFile2);
 
+// src/verify/drift.ts
+import { execFile as execFile3 } from "node:child_process";
+import { promisify as promisify3 } from "node:util";
+var run3 = promisify3(execFile3);
+
 // src/verify/index.ts
 function scanBeatCount(storyboard, prefs) {
   const got = storyboard.beats.length;
@@ -8004,12 +10272,12 @@ function scanBeatCount(storyboard, prefs) {
 }
 
 // src/render/render.ts
-import { mkdir as mkdir6, readFile as readFile7, rename as rename2, rm as rm5, writeFile as writeFile8 } from "node:fs/promises";
-import { basename, dirname, join as join9, resolve as resolve2 } from "node:path";
+import { mkdir as mkdir7, readFile as readFile9, rename as rename2, rm as rm7, writeFile as writeFile9 } from "node:fs/promises";
+import { basename as basename3, dirname, join as join10, resolve as resolve3 } from "node:path";
 
 // src/render/captions.ts
-import { mkdir as mkdir5, writeFile as writeFile7 } from "node:fs/promises";
-import { join as join8 } from "node:path";
+import { mkdir as mkdir6, writeFile as writeFile8 } from "node:fs/promises";
+import { join as join9 } from "node:path";
 import { pathToFileURL } from "node:url";
 var DECK_FONT_CSS = "assets/fonts/fonts.css";
 function cssString(value) {
@@ -8065,7 +10333,7 @@ ${bands}
 </div>
 `;
 }
-function measure2(count) {
+function measure3(count) {
   const doc = document;
   const probe3 = doc.getElementById("c0");
   if (probe3) {
@@ -8093,247 +10361,81 @@ async function captionBlocker() {
   try {
     await import("puppeteer-core");
     await chromePath(CAPTION_NEED);
-    return null;
-  } catch (err) {
-    return err instanceof Error ? err.message : String(err);
-  }
-}
-async function renderCaptions(cues, style, deck, work2) {
-  if (cues.length === 0) throw new Error("renderCaptions was given no cues.");
-  const fontCss = join8(deck, DECK_FONT_CSS);
-  const href = await import("node:fs/promises").then((fs) => fs.stat(fontCss).catch(() => null)) ? pathToFileURL(fontCss).href : null;
-  const page = join8(work2, "captions.html");
-  await mkdir5(work2, { recursive: true });
-  await writeFile7(page, captionPage(cues, style, href));
-  const { default: puppeteer } = await import("puppeteer-core");
-  const browser = await puppeteer.launch({
-    executablePath: await chromePath(CAPTION_NEED),
-    headless: true,
-    args: ["--force-device-scale-factor=1", "--hide-scrollbars"]
-  });
-  try {
-    const tab = await browser.newPage();
-    await tab.setViewport({ width: style.width, height: style.height, deviceScaleFactor: 1 });
-    await tab.goto(pathToFileURL(page).href, { waitUntil: "load" });
-    await tab.evaluate(() => document.fonts.ready);
-    const rects = await tab.evaluate(measure2, cues.length);
-    const box = union(rects);
-    const files = [];
-    for (const [i, cue] of cues.entries()) {
-      void cue;
-      const name = `cap${String(i).padStart(4, "0")}.png`;
-      await tab.evaluate((id2) => document.getElementById(id2)?.classList.add("on"), `c${i}`);
-      await tab.screenshot({
-        path: join8(work2, name),
-        type: "png",
-        omitBackground: true,
-        clip: { x: box.x, y: box.y, width: box.width, height: box.height }
-      });
-      await tab.evaluate((id2) => document.getElementById(id2)?.classList.remove("on"), `c${i}`);
-      files.push(name);
-    }
-    return { files, ...box };
-  } finally {
-    await browser.close();
-  }
-}
-function union(rects) {
-  const left = Math.floor(Math.min(...rects.map((r) => r.x)));
-  const top = Math.floor(Math.min(...rects.map((r) => r.y)));
-  const right = Math.ceil(Math.max(...rects.map((r) => r.x + r.w)));
-  const bottom = Math.ceil(Math.max(...rects.map((r) => r.y + r.h)));
-  return { x: left, y: top, width: right - left, height: bottom - top };
-}
-var t3 = (seconds) => seconds.toFixed(3);
-function overlayGraph(cues, band, input = "0:v", output = "vout") {
-  return cues.map((cue, i) => {
-    const from = i === 0 ? `[${input}]` : `[v${i}]`;
-    const to = i === cues.length - 1 ? `[${output}]` : `[v${i + 1}]`;
-    const enable = `enable='gte(t,${t3(cue.start)})*lt(t,${t3(cue.end)})'`;
-    return `${from}[${i + 1}:v]overlay=x=${band.x}:y=${band.y}:format=yuv444:${enable}${to}`;
-  }).join(";\n");
-}
-function overlayInputs(band) {
-  return band.files.flatMap((file) => ["-i", file]);
-}
-
-// src/render/ffmpeg.ts
-import { execFile as execFile3, spawn as spawn3 } from "node:child_process";
-import { promisify as promisify3 } from "node:util";
-var run3 = promisify3(execFile3);
-var DEFAULT_TIMEOUT_MS2 = 36e5;
-async function runTool(file, args, opts = {}) {
-  try {
-    return await run3(file, args, {
-      cwd: opts.cwd,
-      timeout: opts.timeoutMs ?? DEFAULT_TIMEOUT_MS2,
-      maxBuffer: 64 << 20
-    });
-  } catch (err) {
-    const e = err;
-    if (e.code === "ENOENT") {
-      throw new Error(`${file} is not installed, or not on PATH. \`render\` needs it.`);
-    }
-    const tail = (e.stderr ?? e.stdout ?? e.message).trim().split("\n").slice(-8).join("\n");
-    throw new Error(`${file} failed:
-${tail}`);
-  }
-}
-function runLive(file, args) {
-  return new Promise((resolve6, reject) => {
-    const child = spawn3(file, args, { stdio: ["ignore", "inherit", "inherit"] });
-    child.on("error", (err) => {
-      reject(
-        err.code === "ENOENT" ? new Error(`${file} is not installed, or not on PATH. \`render\` needs it.`) : err
-      );
-    });
-    child.on("close", (code, signal) => {
-      if (code === 0) resolve6();
-      else if (signal) {
-        reject(
-          new Error(
-            `${file} was killed by ${signal}. On a machine under memory pressure this is the OS reclaiming the browser; free memory, or lower --workers, and run again.`
-          )
-        );
-      } else reject(new Error(`${file} exited ${code}.`));
-    });
-  });
-}
-async function probe(path2) {
-  const { stdout } = await runTool("ffprobe", [
-    "-v",
-    "error",
-    "-show_entries",
-    "stream=codec_type,width,height,r_frame_rate,nb_frames:format=duration",
-    "-of",
-    "json",
-    path2
-  ]);
-  const json = JSON.parse(stdout);
-  const streams = json.streams ?? [];
-  const video = streams.find((s) => s.codec_type === "video");
-  if (!video) throw new Error(`${path2} has no video stream.`);
-  const [num2, den] = (video.r_frame_rate ?? "30/1").split("/");
-  const fps = Number(num2) / (Number(den) || 1);
-  const seconds = Number(json.format?.duration ?? 0);
-  const frames = Number(video.nb_frames ?? 0) || Math.round(seconds * fps);
-  return {
-    width: video.width ?? 0,
-    height: video.height ?? 0,
-    fps,
-    frames,
-    seconds,
-    hasAudio: streams.some((s) => s.codec_type === "audio")
-  };
-}
-function encoderArgs(fps) {
-  return [
-    "-c:v",
-    "libx264",
-    "-preset",
-    "veryfast",
-    "-crf",
-    "16",
-    "-pix_fmt",
-    "yuv420p",
-    "-g",
-    "12",
-    "-r",
-    String(fps),
-    "-fps_mode",
-    "cfr"
-  ];
-}
-function pieceFilter(motion, freeze) {
-  const chain = [`trim=end_frame=${motion}`, "setpts=N/FRAME_RATE/TB"];
-  if (freeze > 0) chain.push(`tpad=stop_mode=clone:stop=${freeze}`);
-  return chain.join(",");
-}
-function pieceArgs(source, fromFrame, motion, freeze, fps, out) {
-  return [
-    "-y",
-    "-hide_banner",
-    "-loglevel",
-    "error",
-    // Half a frame in, so a time that is exactly on a boundary cannot round to
-    // the frame before it.
-    "-ss",
-    ((fromFrame + 0.5) / fps).toFixed(6),
-    "-i",
-    source,
-    "-an",
-    "-vf",
-    pieceFilter(motion, freeze),
-    "-frames:v",
-    String(motion + freeze),
-    ...encoderArgs(fps),
-    "-f",
-    "mpegts",
-    out
-  ];
+    return null;
+  } catch (err) {
+    return err instanceof Error ? err.message : String(err);
+  }
 }
-var LOUDNESS = "loudnorm=I=-16:TP=-1.5:LRA=11,aresample=48000";
-function audioGraph(inputs, seconds, first = 1) {
-  const lines = inputs.map(
-    (input, i) => `[${first + i}:a]aresample=48000,aformat=sample_fmts=fltp:channel_layouts=stereo,adelay=${input.delayMs}:all=1[d${i}]`
-  );
-  const labels = inputs.map((_, i) => `[d${i}]`).join("");
-  lines.push(
-    `${labels}amix=inputs=${inputs.length}:normalize=0:dropout_transition=0:duration=longest,${LOUDNESS},apad=whole_dur=${seconds.toFixed(3)}[aout]`
-  );
-  return lines.join(";\n");
+async function renderCaptions(cues, style, deck, work2) {
+  if (cues.length === 0) throw new Error("renderCaptions was given no cues.");
+  const fontCss = join9(deck, DECK_FONT_CSS);
+  const href = await import("node:fs/promises").then((fs) => fs.stat(fontCss).catch(() => null)) ? pathToFileURL(fontCss).href : null;
+  const page = join9(work2, "captions.html");
+  await mkdir6(work2, { recursive: true });
+  await writeFile8(page, captionPage(cues, style, href));
+  const { default: puppeteer } = await import("puppeteer-core");
+  const browser = await puppeteer.launch({
+    executablePath: await chromePath(CAPTION_NEED),
+    headless: true,
+    args: ["--force-device-scale-factor=1", "--hide-scrollbars"]
+  });
+  try {
+    const tab = await browser.newPage();
+    await tab.setViewport({ width: style.width, height: style.height, deviceScaleFactor: 1 });
+    await tab.goto(pathToFileURL(page).href, { waitUntil: "load" });
+    await tab.evaluate(() => document.fonts.ready);
+    const rects = await tab.evaluate(measure3, cues.length);
+    const box = union(rects);
+    const files = [];
+    for (const [i, cue] of cues.entries()) {
+      void cue;
+      const name = `cap${String(i).padStart(4, "0")}.png`;
+      await tab.evaluate((id2) => document.getElementById(id2)?.classList.add("on"), `c${i}`);
+      await tab.screenshot({
+        path: join9(work2, name),
+        type: "png",
+        omitBackground: true,
+        clip: { x: box.x, y: box.y, width: box.width, height: box.height }
+      });
+      await tab.evaluate((id2) => document.getElementById(id2)?.classList.remove("on"), `c${i}`);
+      files.push(name);
+    }
+    return { files, ...box };
+  } finally {
+    await browser.close();
+  }
 }
-function respeedArgs(source, factor, chain, fps, hasAudio, out) {
-  const video = `[0:v]setpts=PTS/${factor}[v]`;
-  const audio = hasAudio ? `;[0:a]${chain.map((t2) => `atempo=${t2}`).join(",")}[a]` : "";
-  return [
-    "-y",
-    "-hide_banner",
-    "-loglevel",
-    "error",
-    "-i",
-    source,
-    "-filter_complex",
-    `${video}${audio}`,
-    "-map",
-    "[v]",
-    ...hasAudio ? ["-map", "[a]", "-c:a", "aac", "-b:a", "160k"] : ["-an"],
-    ...encoderArgs(fps),
-    out
-  ];
+function union(rects) {
+  const left = Math.floor(Math.min(...rects.map((r) => r.x)));
+  const top = Math.floor(Math.min(...rects.map((r) => r.y)));
+  const right = Math.ceil(Math.max(...rects.map((r) => r.x + r.w)));
+  const bottom = Math.ceil(Math.max(...rects.map((r) => r.y + r.h)));
+  return { x: left, y: top, width: right - left, height: bottom - top };
 }
-function burnStyle(width, height, font = "Arial") {
-  return {
-    width,
-    height,
-    font,
-    // MEASURED, not guessed. `splitCue` caps a cue at 84 characters and `wrap`
-    // breaks it near the middle, so the longer of the two lines runs to about
-    // 46 characters in real caption prose. Bold Arial advances 0.485em per
-    // character on that prose (measured in a browser over the demo's own
-    // narration), so 46 characters at F px is 22.3F wide, and the usable width
-    // here is 978px. F = 40 leaves 9% of headroom; F = 45 — which is what
-    // "4% of the width" looked like on paper — overflows to a THIRD line, and a
-    // three-line band covers the bottom of the slide.
-    fontSize: Math.round(width * 0.037),
-    // Clear of the play button, the progress bar and the handle every vertical
-    // player draws across the bottom eighth of the frame.
-    marginV: Math.round(height * 0.09),
-    marginX: Math.round(width * 0.04)
-  };
+var t3 = (seconds) => seconds.toFixed(3);
+function overlayGraph(cues, band, input = "0:v", output = "vout") {
+  return cues.map((cue, i) => {
+    const from = i === 0 ? `[${input}]` : `[v${i}]`;
+    const to = i === cues.length - 1 ? `[${output}]` : `[v${i + 1}]`;
+    const enable = `enable='gte(t,${t3(cue.start)})*lt(t,${t3(cue.end)})'`;
+    return `${from}[${i + 1}:v]overlay=x=${band.x}:y=${band.y}:format=yuv444:${enable}${to}`;
+  }).join(";\n");
+}
+function overlayInputs(band) {
+  return band.files.flatMap((file) => ["-i", file]);
 }
 
 // src/render/render.ts
-var SRT_NAME = (out) => `${basename(out).replace(/\.[^.]+$/, "")}.srt`;
+var SRT_NAME = (out) => `${basename3(out).replace(/\.[^.]+$/, "")}.srt`;
 function subtitlePlan(mode) {
   return { sidecar: mode !== "none", burn: mode === "burn" };
 }
 async function render(opts) {
   const log = opts.log ?? (() => {
   });
-  const deck = resolve2(opts.deck);
-  const out = resolve2(opts.out);
-  const work2 = join9(dirname(out), `.${basename(out)}.parts`);
+  const deck = resolve3(opts.deck);
+  const out = resolve3(opts.out);
+  const work2 = join10(dirname(out), `.${basename3(out)}.parts`);
   const timing = await readTiming(deck);
   if (opts.targetSeconds && !opts.allowFastPlayback) {
     const refusal = playbackRefusal(
@@ -8349,9 +10451,9 @@ async function render(opts) {
     if (blocker) throw new Error(`Cannot burn in captions: ${blocker}`);
   }
   const burnable = plan0.burn;
-  await mkdir6(work2, { recursive: true });
+  await mkdir7(work2, { recursive: true });
   try {
-    const raw2 = opts.video ? resolve2(opts.video) : await capture(deck, join9(work2, "raw.mp4"), opts, log);
+    const raw2 = opts.video ? resolve3(opts.video) : await capture(deck, join10(work2, "raw.mp4"), opts, log);
     const shot = await probe(raw2);
     log(
       `render: ${shot.frames} frames, ${shot.width}\xD7${shot.height}, ${shot.fps.toFixed(3)} fps, ${shot.seconds.toFixed(2)}s`
@@ -8364,18 +10466,18 @@ async function render(opts) {
       );
     }
     const retimed = await retime(raw2, plan, work2, log);
-    const srtPath = join9(dirname(out), SRT_NAME(out));
+    const srtPath = join10(dirname(out), SRT_NAME(out));
     const playback = opts.targetSeconds ? playbackFactor(plan.frames / shot.fps, opts.targetSeconds) : 1;
     const cues = playback > 1 ? plan.cues.map((c) => scaleCue(c, playback)) : plan.cues;
     const srt = plan0.sidecar ? toSrt(cues) : "";
-    if (srt) await writeFile8(srtPath, srt);
+    if (srt) await writeFile9(srtPath, srt);
     const burn = burnable && srt.length > 0;
     await mux(retimed, timing, plan, deck, out, work2, burn ? plan.cues : void 0, shot.fps, log);
     if (playback > 1) {
       log(`render: speeding playback ${playback}\xD7 to reach ${opts.targetSeconds}s`);
       const warning = playbackWarning(playback, p95CueRate(plan.cues));
       if (warning) log(`render: ${warning}`);
-      const fast = join9(work2, `fast.${basename(out)}`);
+      const fast = join10(work2, `fast.${basename3(out)}`);
       const muxed = await probe(out);
       await runTool(
         "ffmpeg",
@@ -8401,12 +10503,12 @@ async function render(opts) {
       captionCps: p95CueRate(cues)
     };
   } finally {
-    if (!opts.keep) await rm5(work2, { recursive: true, force: true });
+    if (!opts.keep) await rm7(work2, { recursive: true, force: true });
   }
 }
 async function readTiming(deck) {
-  const path2 = join9(deck, TIMING_FILE);
-  const text2 = await readFile7(path2, "utf8").catch(() => {
+  const path2 = join10(deck, TIMING_FILE);
+  const text2 = await readFile9(path2, "utf8").catch(() => {
     throw new Error(
       `${path2} is missing. \`render\` needs the timing manifest \`build\` writes; rebuild the deck.`
     );
@@ -8445,20 +10547,20 @@ async function retime(raw2, plan, work2, log) {
   if (plan.pieces.every((p) => p.freeze === 0)) return raw2;
   const list = [];
   for (const [i, piece] of plan.pieces.entries()) {
-    const file = join9(work2, `p${String(i).padStart(4, "0")}.ts`);
+    const file = join10(work2, `p${String(i).padStart(4, "0")}.ts`);
     await runTool("ffmpeg", pieceArgs(raw2, piece.from, piece.motion, piece.freeze, plan.fps, file));
     list.push(file);
     if ((i + 1) % 10 === 0 || i === plan.pieces.length - 1) {
       log(`render: retimed ${i + 1}/${plan.pieces.length} pieces`);
     }
   }
-  const listFile = join9(work2, "pieces.txt");
-  await writeFile8(
+  const listFile = join10(work2, "pieces.txt");
+  await writeFile9(
     listFile,
     `${list.map((f) => `file '${f.replace(/'/g, "'\\''")}'`).join("\n")}
 `
   );
-  const joined = join9(work2, "retimed.mp4");
+  const joined = join10(work2, "retimed.mp4");
   await runTool("ffmpeg", [
     "-y",
     "-hide_banner",
@@ -8480,7 +10582,7 @@ async function retime(raw2, plan, work2, log) {
 }
 async function mux(video, timing, plan, deck, out, work2, burnCues, fps, log) {
   const inputs = plan.audio.map((a) => ({
-    file: join9(deck, timing.audioDir, a.audio),
+    file: join10(deck, timing.audioDir, a.audio),
     delayMs: a.delayMs
   }));
   const args = ["-y", "-hide_banner", "-loglevel", "error", "-i", video];
@@ -8501,8 +10603,8 @@ async function mux(video, timing, plan, deck, out, work2, burnCues, fps, log) {
     graph.push(audioGraph(inputs, plan.frames / fps, 1 + (band?.files.length ?? 0)));
   }
   if (graph.length > 0) {
-    const script = join9(work2, "mux.filter");
-    await writeFile8(script, `${graph.join(";\n")}
+    const script = join10(work2, "mux.filter");
+    await writeFile9(script, `${graph.join(";\n")}
 `);
     args.push("-filter_complex_script", script);
   }
@@ -8517,13 +10619,13 @@ async function mux(video, timing, plan, deck, out, work2, burnCues, fps, log) {
   log(
     `render: muxing ${inputs.length} segment(s)${burnCues ? " and burning in the captions" : ""} \u2192 ${out}`
   );
-  await mkdir6(dirname(out), { recursive: true });
+  await mkdir7(dirname(out), { recursive: true });
   await runTool("ffmpeg", args, { cwd: work2 });
 }
 
 // src/pack/pack.ts
-import { mkdir as mkdir7, readFile as readFile8, writeFile as writeFile9 } from "node:fs/promises";
-import { dirname as dirname2, extname as extname2 } from "node:path";
+import { mkdir as mkdir8, readFile as readFile10, writeFile as writeFile10 } from "node:fs/promises";
+import { dirname as dirname2, extname as extname3 } from "node:path";
 import { unzipSync, zipSync } from "fflate";
 var MTIME = Date.UTC(1980, 0, 2, 12);
 var STORED = /* @__PURE__ */ new Set([
@@ -8559,11 +10661,11 @@ async function writePack(pack3, files, out) {
     if (!bytes) continue;
     if (path2 === "deck.json") throw new Error("deck.json is written from the manifest, not passed");
     check2(path2);
-    entries[path2] = STORED.has(extname2(path2).toLowerCase()) ? [bytes, { level: 0 }] : bytes;
+    entries[path2] = STORED.has(extname3(path2).toLowerCase()) ? [bytes, { level: 0 }] : bytes;
   }
   const zip = zipSync(entries, { mtime: MTIME });
-  await mkdir7(dirname2(out), { recursive: true });
-  await writeFile9(out, zip);
+  await mkdir8(dirname2(out), { recursive: true });
+  await writeFile10(out, zip);
   return zip.length;
 }
 function check2(label, path2 = label) {
@@ -8571,137 +10673,6 @@ function check2(label, path2 = label) {
     throw new Error(`${label}: unsafe path in pack`);
 }
 
-// src/pack/media.ts
-import { createHash as createHash7 } from "node:crypto";
-import { readFile as readFile9 } from "node:fs/promises";
-import { extname as extname3 } from "node:path";
-var PLAYERS = [
-  "youtube.com",
-  "youtube-nocookie.com",
-  "youtu.be",
-  "vimeo.com",
-  "dailymotion.com",
-  "dai.ly",
-  "twitch.tv",
-  "loom.com",
-  "wistia.com",
-  "wistia.net",
-  "streamable.com",
-  "bilibili.com",
-  "soundcloud.com",
-  "tiktok.com"
-];
-var FILE_EXT = /* @__PURE__ */ new Set([
-  ".png",
-  ".jpg",
-  ".jpeg",
-  ".gif",
-  ".webp",
-  ".avif",
-  ".svg",
-  ".mp4",
-  ".webm",
-  ".mov",
-  ".m4v",
-  ".mp3",
-  ".m4a",
-  ".wav",
-  ".ogg",
-  ".opus",
-  ".pdf"
-]);
-function isEmbed(url) {
-  const host2 = hostOf(url);
-  return host2 !== null && PLAYERS.some((p) => host2 === p || host2.endsWith(`.${p}`));
-}
-function policyFor(url, prefer) {
-  if (isEmbed(url)) return "embed";
-  const host2 = hostOf(url);
-  if (host2 === null || /^data:/i.test(url)) return "bake";
-  if (prefer === "link") return "link";
-  return FILE_EXT.has(extOf(url)) ? "bake" : "link";
-}
-async function planMedia(assets, fetcher = fetchAsset) {
-  const plan = {
-    media: [],
-    files: {},
-    bakedCount: 0,
-    bakedBytes: 0,
-    demoted: [],
-    promoted: []
-  };
-  for (const asset of assets) {
-    const policy = policyFor(asset.url, asset.prefer);
-    if (policy !== "bake") {
-      if (asset.prefer === "bake") plan.demoted.push(asset.id);
-      plan.media.push({ id: asset.id, policy, url: asset.url, mime: asset.mime });
-      continue;
-    }
-    if (asset.prefer === "link") plan.promoted.push(asset.id);
-    const got = await fetcher(asset.url);
-    const mime = clean(got.mime) ?? asset.mime;
-    if (mime === "text/html") {
-      plan.demoted.push(asset.id);
-      plan.media.push({ id: asset.id, policy: "link", url: asset.url, mime });
-      continue;
-    }
-    const path2 = `media/${bakedName(asset.id, asset.url, mime)}`;
-    plan.files[path2] = got.bytes;
-    plan.bakedCount += 1;
-    plan.bakedBytes += got.bytes.length;
-    plan.media.push({ id: asset.id, policy: "bake", path: path2, mime, bytes: got.bytes.length });
-  }
-  return plan;
-}
-function bakedName(id2, url, mime) {
-  const slug = id2.toLowerCase().replace(/[^a-z0-9_-]+/g, "-") || "asset";
-  const hash = createHash7("sha256").update(url).digest("hex").slice(0, 8);
-  return `${slug}-${hash}${extOf(url) || extFor(mime)}`;
-}
-function extOf(url) {
-  const path2 = hostOf(url) === null ? url : new URL(url).pathname;
-  const ext = extname3(path2).toLowerCase();
-  return FILE_EXT.has(ext) ? ext : "";
-}
-var MIME_EXT = {
-  "image/png": ".png",
-  "image/jpeg": ".jpg",
-  "image/gif": ".gif",
-  "image/webp": ".webp",
-  "image/avif": ".avif",
-  "image/svg+xml": ".svg",
-  "video/mp4": ".mp4",
-  "video/webm": ".webm",
-  "audio/mpeg": ".mp3",
-  "application/pdf": ".pdf"
-};
-function extFor(mime) {
-  return (mime && MIME_EXT[mime]) ?? ".bin";
-}
-function hostOf(url) {
-  try {
-    const u = new URL(url);
-    if (u.protocol === "file:" || u.protocol === "data:") return null;
-    return u.hostname.toLowerCase().replace(/^www\./, "");
-  } catch {
-    return null;
-  }
-}
-function clean(mime) {
-  return mime?.split(";")[0]?.trim().toLowerCase() || void 0;
-}
-async function fetchAsset(url) {
-  if (/^(https?|data):/i.test(url)) {
-    const res = await fetch(url);
-    if (!res.ok) throw new Error(`${url}: HTTP ${res.status}`);
-    return {
-      bytes: new Uint8Array(await res.arrayBuffer()),
-      mime: res.headers.get("content-type") ?? void 0
-    };
-  }
-  return { bytes: new Uint8Array(await readFile9(url)) };
-}
-
 // src/prefs.ts
 var PREF_KEYS = Object.keys(prefsSchema.shape);
 var NARRATION_KEYS = Object.keys(prefsSchema.shape.narration.unwrap().shape);
@@ -8713,8 +10684,8 @@ async function buildDeck(storyboard, source, outDir, opts = {}) {
   if (!format) throw new Error("no deck-16x9 format");
   const step = opts.onStep ?? (() => {
   });
-  const out = resolve3(outDir);
-  await mkdir8(out, { recursive: true });
+  const out = resolve4(outDir);
+  await mkdir9(out, { recursive: true });
   const speed = opts.speed ?? 1;
   const fontCss = await refreshFont(storyboard, source, out, step);
   const deck = emitDeck(storyboard, source, format, await deckRuntime(), {
@@ -8726,8 +10697,8 @@ async function buildDeck(storyboard, source, outDir, opts = {}) {
   });
   const files = [];
   const write = async (name, text2) => {
-    await writeFile10(join10(out, name), text2);
-    files.push(join10(out, name));
+    await writeFile11(join11(out, name), text2);
+    files.push(join11(out, name));
   };
   await write("index.html", deck.composition);
   await write("hyperframes.json", HYPERFRAMES_JSON);
@@ -8756,8 +10727,8 @@ async function buildDeck(storyboard, source, outDir, opts = {}) {
   }
   if (deck.page) {
     await write(DECK_PAGE, deck.page);
-    await cp(playerBundle(), join10(out, PLAYER_FILE));
-    files.push(join10(out, PLAYER_FILE));
+    await cp(playerBundle(), join11(out, PLAYER_FILE));
+    files.push(join11(out, PLAYER_FILE));
   }
   files.push(...await vendorKatex(out));
   if (opts.assetsFrom) files.push(...await copyAssets(opts.assetsFrom, out));
@@ -8766,7 +10737,7 @@ async function buildDeck(storyboard, source, outDir, opts = {}) {
   }
   const of = deck.cut.kept.length === storyboard.beats.length ? "" : ` of ${storyboard.beats.length}`;
   step(
-    `build: ${deck.cut.kept.length}${of} beats at ${format.width}\xD7${format.height} \u2192 ${join10(out, "index.html")}`
+    `build: ${deck.cut.kept.length}${of} beats at ${format.width}\xD7${format.height} \u2192 ${join11(out, "index.html")}`
   );
   for (const d of deck.cut.dropped) step(`build:   cut ${d.beat.id} \u2014 ${d.reason}`);
   for (const d of deck.cut.dangling) step(`build:   check the wording \u2014 ${d.reason}`);
@@ -8784,7 +10755,7 @@ var HYPERFRAMES_JSON = `${JSON.stringify(
 async function deckRuntime() {
   const path2 = fileURLToPath(new URL(`./${"deck-runtime.js"}`, import.meta.url));
   try {
-    return await readFile10(path2, "utf8");
+    return await readFile11(path2, "utf8");
   } catch {
     throw new Error(`Deck runtime missing at ${path2}. Run "npm run build" first.`);
   }
@@ -8792,57 +10763,57 @@ async function deckRuntime() {
 function playerBundle() {
   const require2 = createRequire2(import.meta.url);
   try {
-    return join10(dirname3(require2.resolve("hyperframes/package.json")), "dist", PLAYER_FILE);
+    return join11(dirname3(require2.resolve("hyperframes/package.json")), "dist", PLAYER_FILE);
   } catch {
     throw new Error('Cannot locate the hyperframes player. Run "npm install".');
   }
 }
 async function vendorKatex(out) {
   const require2 = createRequire2(import.meta.url);
-  const dist = join10(dirname3(require2.resolve("katex/package.json")), "dist");
-  const css = await readFile10(join10(dist, "katex.min.css"), "utf8");
+  const dist = join11(dirname3(require2.resolve("katex/package.json")), "dist");
+  const css = await readFile11(join11(dist, "katex.min.css"), "utf8");
   const written = [];
-  await mkdir8(join10(out, "katex/fonts"), { recursive: true });
-  for (const file of await readdir(join10(dist, "fonts"))) {
+  await mkdir9(join11(out, "katex/fonts"), { recursive: true });
+  for (const file of await readdir2(join11(dist, "fonts"))) {
     if (!file.endsWith(".woff2")) continue;
-    await cp(join10(dist, "fonts", file), join10(out, "katex/fonts", file));
-    written.push(join10(out, "katex/fonts", file));
+    await cp(join11(dist, "fonts", file), join11(out, "katex/fonts", file));
+    written.push(join11(out, "katex/fonts", file));
   }
   const woff2Only = css.replace(/src:([^;}]*)/g, (whole, list) => {
     const kept = list.split(",").filter((part) => part.includes(".woff2")).join(",");
     return kept ? `src:${kept}` : whole;
   });
-  await writeFile10(join10(out, "katex/katex.min.css"), woff2Only);
-  written.push(join10(out, "katex/katex.min.css"));
+  await writeFile11(join11(out, "katex/katex.min.css"), woff2Only);
+  written.push(join11(out, "katex/katex.min.css"));
   return written;
 }
 async function copyAssets(sourceDir, out) {
-  const from = join10(resolve3(sourceDir), "assets");
-  if (!await stat(from).catch(() => null)) return [];
-  await cp(from, join10(out, "assets"), { recursive: true });
-  return [join10(out, "assets")];
+  const from = join11(resolve4(sourceDir), "assets");
+  if (!await stat2(from).catch(() => null)) return [];
+  await cp(from, join11(out, "assets"), { recursive: true });
+  return [join11(out, "assets")];
 }
 async function copyAudio(from, narration, out) {
-  const dir = join10(out, narration.dir);
-  await mkdir8(dir, { recursive: true });
+  const dir = join11(out, narration.dir);
+  await mkdir9(dir, { recursive: true });
   const names = [
     ...new Set(
       Object.values(narration.beats).flat().map((s) => s.audio)
     )
   ].sort();
   for (const name of names) {
-    await cp(join10(resolve3(from), name), join10(dir, name)).catch(() => {
+    await cp(join11(resolve4(from), name), join11(dir, name)).catch(() => {
       throw new Error(`Narration names ${name}, but it is not in ${from}. Re-run \`narrate\`.`);
     });
   }
-  return names.map((n3) => join10(dir, n3));
+  return names.map((n3) => join11(dir, n3));
 }
 async function refreshFont(storyboard, source, out, step) {
   try {
     const bundle = await bundleFont(
       storyboard.lang,
       JSON.stringify(source) + JSON.stringify(storyboard),
-      join10(out, "assets", "fonts")
+      join11(out, "assets", "fonts")
     );
     if (bundle) step(`build: font bundle covers ${bundle.family}`);
     return bundle?.css;
@@ -8867,8 +10838,8 @@ var MARKDOWN_EXTS = [".md", ".markdown", ".txt"];
 var UploadError = class extends Error {
   hint;
   status;
-  constructor(message, hint, status = 400) {
-    super(message);
+  constructor(message2, hint, status = 400) {
+    super(message2);
     this.name = "UploadError";
     this.hint = hint;
     this.status = status;
@@ -8879,10 +10850,10 @@ function looksLikeZip(bytes) {
 }
 function safeEntryPath(name) {
   if (name.includes("\0")) return null;
-  const segments = name.replace(/\\/g, "/").split("/");
+  const segments2 = name.replace(/\\/g, "/").split("/");
   if (/^[a-zA-Z]:/.test(name) || name.startsWith("/") || name.startsWith("\\")) return null;
   const kept = [];
-  for (const segment of segments) {
+  for (const segment of segments2) {
     if (segment === "" || segment === ".") continue;
     if (segment === "..") return null;
     kept.push(segment);
@@ -8925,14 +10896,14 @@ function readZip(bytes, limits = ZIP_LIMITS) {
     }
     if (entry.originalSize > limits.maxEntryBytes) {
       throw new UploadError(
-        `"${entry.name}" unpacks to ${mb(entry.originalSize)}, over the ${mb(limits.maxEntryBytes)} per-file limit.`,
+        `"${entry.name}" unpacks to ${mb2(entry.originalSize)}, over the ${mb2(limits.maxEntryBytes)} per-file limit.`,
         "Leave the large file out; a deck reads the document and its figures, not the dataset."
       );
     }
     total += entry.originalSize;
     if (total > limits.maxTotalBytes) {
       throw new UploadError(
-        `The archive unpacks to more than ${mb(limits.maxTotalBytes)}.`,
+        `The archive unpacks to more than ${mb2(limits.maxTotalBytes)}.`,
         "Send only the document and the figures it cites."
       );
     }
@@ -8959,7 +10930,7 @@ function readZip(bytes, limits = ZIP_LIMITS) {
     actual += data.length;
     if (actual > limits.maxTotalBytes) {
       throw new UploadError(
-        `The archive unpacks to more than ${mb(limits.maxTotalBytes)}.`,
+        `The archive unpacks to more than ${mb2(limits.maxTotalBytes)}.`,
         "Send only the document and the figures it cites."
       );
     }
@@ -8992,7 +10963,7 @@ function pickMarkdown(files) {
 function isNoise(name) {
   return name.startsWith("__MACOSX/") || name.includes("/__MACOSX/") || posix.basename(name) === ".DS_Store" || posix.basename(name) === "Thumbs.db";
 }
-function mb(bytes) {
+function mb2(bytes) {
   return `${Math.round(bytes / 1024 / 1024)} MB`;
 }
 
@@ -9116,8 +11087,8 @@ function withCanvas(preset, fields, warnings) {
       `Send both, or neither and let the "${preset.id}" preset decide.`
     );
   }
-  const width = even("width", fields.width, warnings);
-  const height = even("height", fields.height, warnings);
+  const width = even2("width", fields.width, warnings);
+  const height = even2("height", fields.height, warnings);
   const problem = canvasProblem(width, height);
   if (problem) {
     throw new UploadError(
@@ -9134,7 +11105,7 @@ function withCanvas(preset, fields, warnings) {
   warnings.push(...canvasWarnings(width, height));
   return resizeFormat(preset, width, height);
 }
-function even(name, raw2, warnings) {
+function even2(name, raw2, warnings) {
   const n3 = int(name, raw2);
   if (n3 % 2 === 0 || !Number.isFinite(n3)) return n3;
   warnings.push(`${name} ${n3} rounded down to ${n3 - 1}; h264 needs even dimensions`);
@@ -9197,11 +11168,18 @@ function int(name, raw2) {
 }
 
 // src/server/pipeline.ts
-import { mkdir as mkdir9, readFile as readFile11, stat as stat2, writeFile as writeFile11 } from "node:fs/promises";
-import { dirname as dirname4, join as join11, relative, resolve as resolve4 } from "node:path";
+import { mkdir as mkdir10, readFile as readFile12, stat as stat3, writeFile as writeFile12 } from "node:fs/promises";
+import { dirname as dirname4, isAbsolute, join as join12, relative, resolve as resolve5 } from "node:path";
 var AUDIO_DIR = "audio";
 var NARRATION_FILE = "narration.json";
 var MAX_REMOTE_FIGURES = 40;
+var HARVEST_LIMITS = {
+  maxBytes: 4 * 1024 * 1024,
+  maxAssetBytes: 8 * 1024 * 1024,
+  timeoutMs: 12e3,
+  maxAssets: 24
+};
+var HARVEST_DEADLINE_MS = 9e4;
 var FEED_FORMATS = /* @__PURE__ */ new Set(["short-9x16", "post-1x1"]);
 function stagesFor(options) {
   const stages = ["ingest", "plan"];
@@ -9214,10 +11192,10 @@ function stagesFor(options) {
 async function runPipeline(job, input) {
   const { options } = input;
   const dirs = {
-    upload: join11(job.dir, "upload"),
-    src: join11(job.dir, "src"),
-    audio: join11(job.dir, AUDIO_DIR),
-    deck: join11(job.dir, "deck")
+    upload: join12(job.dir, "upload"),
+    src: join12(job.dir, "src"),
+    audio: join12(job.dir, AUDIO_DIR),
+    deck: join12(job.dir, "deck")
   };
   const warnings = [...options.warnings];
   const url = (rel) => `/d/${job.id}/${rel}`;
@@ -9241,21 +11219,21 @@ async function runPipeline(job, input) {
     theme: options.stated.theme ? prefs.theme : planned.theme
   };
   assertRefsResolve(storyboard, source, { pending: options.images ? "allow" : "refuse" });
-  await writeJson(join11(job.dir, "storyboard.json"), storyboard);
+  await writeJson(join12(job.dir, "storyboard.json"), storyboard);
   job.done("plan", `${storyboard.beats.length} beats`);
   for (const f of scanBeatCount(storyboard, prefs)) warnings.push(f.message);
   if (options.images) {
     job.begin("illustrate");
     const drawn = await illustrate(storyboard, source, {
       prefs,
-      assetsDir: join11(dirs.src, "assets"),
+      assetsDir: join12(dirs.src, "assets"),
       ...input.imageChain ? { chain: input.imageChain } : {},
       onStep: (line2) => job.log(line2)
     });
     storyboard = drawn.storyboard;
     source = drawn.source;
-    await writeJson(join11(dirs.src, "source.json"), source);
-    await writeJson(join11(job.dir, "storyboard.json"), storyboard);
+    await writeJson(join12(dirs.src, "source.json"), source);
+    await writeJson(join12(job.dir, "storyboard.json"), storyboard);
     for (const p of drawn.illustrated) {
       job.log(
         `illustrate: ${p.beatId} \u2192 assets/${p.src} via ${p.provider}${p.cached ? " (cached)" : ""}`
@@ -9277,16 +11255,16 @@ async function runPipeline(job, input) {
       warnings.push("the plan had nothing to say aloud, so the deck is silent");
     } else {
       job.log(`narrate: ${speaking} of ${storyboard.beats.length} beats speak`);
-      await mkdir9(dirs.audio, { recursive: true });
+      await mkdir10(dirs.audio, { recursive: true });
       const spoken = await narrate(storyboard, source, prefs, {
         dir: dirs.audio,
         format: options.format
       });
-      await writeJson(join11(dirs.audio, NARRATION_FILE), spoken);
+      await writeJson(join12(dirs.audio, NARRATION_FILE), spoken);
       narration = { voice: spoken.voice, dir: AUDIO_DIR, beats: spoken.beats };
-      const segments = Object.values(spoken.beats).flat();
-      const seconds = segments.reduce((sum, s) => sum + s.seconds, 0);
-      job.done("narrate", `${segments.length} segments, ${seconds.toFixed(1)}s in ${spoken.voice}`);
+      const segments2 = Object.values(spoken.beats).flat();
+      const seconds = segments2.reduce((sum, s) => sum + s.seconds, 0);
+      job.done("narrate", `${segments2.length} segments, ${seconds.toFixed(1)}s in ${spoken.voice}`);
     }
   }
   job.begin("build");
@@ -9329,7 +11307,7 @@ async function runPipeline(job, input) {
       job.log("render: capturing frames \u2014 two minutes for a four-minute video");
       const out = await render({
         deck: dirs.deck,
-        out: join11(dirs.deck, "video.mp4"),
+        out: join12(dirs.deck, "video.mp4"),
         subtitles: "sidecar",
         log: (line2) => job.log(line2),
         // The last of the three length levers, and the only one that acts on a
@@ -9378,35 +11356,61 @@ async function runPipeline(job, input) {
   };
 }
 async function ingest(job, input, dirs, warnings) {
-  await mkdir9(dirs.upload, { recursive: true });
-  const root2 = resolve4(dirs.upload);
+  await mkdir10(dirs.upload, { recursive: true });
+  const root2 = resolve5(dirs.upload);
   let docPath;
-  if (looksLikeZip(input.upload.bytes)) {
-    const { files, warnings: zipWarnings } = readZip(input.upload.bytes);
+  const upload = input.upload;
+  const bothOrNeither = new UploadError(
+    "A job needs exactly one of an upload and a url.",
+    "PipelineInput carries `upload` or `url`; it was handed both, or neither.",
+    500
+  );
+  if (input.url !== void 0) {
+    if (upload !== void 0) throw bothOrNeither;
+    const harvested = await harvestBounded(input.url, join12(root2, "assets"), {
+      ...HARVEST_LIMITS,
+      ...input.harvest
+    });
+    warnings.push(...harvested.warnings);
+    docPath = join12(root2, "document.md");
+    await writeFile12(docPath, harvested.markdown);
+    job.log(
+      `ingest: harvested ${input.url} \u2014 "${harvested.title}", ${harvested.assets.length} asset(s)`
+    );
+    if (harvested.markdown.trim() === "") {
+      throw new UploadError(
+        `Nothing readable came back from ${input.url}.`,
+        "A page that builds its body from a third-party script harvests to nothing, because the harvester runs none of them \u2014 that trade is written up at the top of src/source/harvest.ts. Save the page as markdown and upload the file instead."
+      );
+    }
+  } else if (upload === void 0) {
+    throw bothOrNeither;
+  } else if (looksLikeZip(upload.bytes)) {
+    const { files, warnings: zipWarnings } = readZip(upload.bytes);
     warnings.push(...zipWarnings);
     for (const [rel, bytes] of Object.entries(files)) {
-      const to = resolve4(join11(root2, rel));
+      const to = resolve5(join12(root2, rel));
       if (!insideRoot(root2, to))
         throw new UploadError(`Refusing to write ${rel}.`, "Re-zip from inside the folder.");
-      await mkdir9(dirname4(to), { recursive: true });
-      await writeFile11(to, bytes);
+      await mkdir10(dirname4(to), { recursive: true });
+      await writeFile12(to, bytes);
     }
-    docPath = join11(root2, pickMarkdown(files));
+    docPath = join12(root2, pickMarkdown(files));
     job.log(
       `ingest: unpacked ${Object.keys(files).length} file(s), reading ${pickMarkdown(files)}`
     );
   } else {
-    const ext = (input.upload.filename.match(/\.[^.\\/]+$/)?.[0] ?? "").toLowerCase();
+    const ext = (upload.filename.match(/\.[^.\\/]+$/)?.[0] ?? "").toLowerCase();
     if (ext && !MARKDOWN_EXTS.includes(ext)) {
       throw new UploadError(
-        `"${input.upload.filename}" is a ${ext} file.`,
+        `"${upload.filename}" is a ${ext} file.`,
         `DeckSmith reads ${MARKDOWN_EXTS.join(", ")} or a .zip containing one. Export the document to markdown first.`
       );
     }
-    docPath = join11(root2, "document.md");
-    await writeFile11(docPath, input.upload.bytes);
+    docPath = join12(root2, "document.md");
+    await writeFile12(docPath, upload.bytes);
   }
-  const text2 = await readFile11(docPath, "utf8");
+  const text2 = await readFile12(docPath, "utf8");
   const parsed = parseMarkdown(text2, {
     lang: input.options.stated.lang ? input.options.prefs.lang : void 0
   });
@@ -9426,18 +11430,30 @@ async function ingest(job, input, dirs, warnings) {
     `ingest: ${parsed.sections.length} sections, ${parsed.figures.length} figures, ${parsed.equations.length} equations, ${parsed.tables.length} tables`
   );
   const guarded = await guardFigures(parsed, root2, input.fetchRemoteFigures, warnings);
-  const source = await fetchFigures(guarded, join11(resolve4(dirs.src), "assets"));
-  await writeJson(join11(dirs.src, "source.json"), source);
+  const source = await fetchFigures(guarded, join12(resolve5(dirs.src), "assets"), warnings);
+  await writeJson(join12(dirs.src, "source.json"), source);
   return source;
 }
-var BLOCKED = [
-  /^10\./,
-  /^127\./,
-  /^169\.254\./,
-  /^172\.(1[6-9]|2\d|3[01])\./,
-  /^192\.168\./,
-  /^0\./
-];
+async function harvestBounded(url, dir, opts) {
+  let timer;
+  const deadline = new Promise((_, reject) => {
+    timer = setTimeout(
+      () => reject(
+        new UploadError(
+          `${url} took longer than ${HARVEST_DEADLINE_MS / 1e3}s to read.`,
+          "The page or its images are answering too slowly to build a deck from. Save the page as markdown and upload the file instead.",
+          504
+        )
+      ),
+      HARVEST_DEADLINE_MS
+    );
+  });
+  try {
+    return await Promise.race([harvest(url, dir, opts), deadline]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
 async function reachable(url) {
   let host2;
   try {
@@ -9454,11 +11470,8 @@ async function reachable(url) {
     return "does not resolve";
   }
   for (const addr of addrs) {
-    if (BLOCKED.some((re) => re.test(addr))) return `resolves to a private address (${addr})`;
-    const v6 = addr.toLowerCase();
-    if (v6 === "::1" || v6.startsWith("fe80:") || v6.startsWith("fc") || v6.startsWith("fd")) {
-      return `resolves to a private address (${addr})`;
-    }
+    const why2 = isBlockedAddress(addr);
+    if (why2) return `resolves to a private address (${addr})`;
   }
   return addrs.length === 0 ? "does not resolve" : null;
 }
@@ -9475,17 +11488,18 @@ async function guardFigures(source, root2, allowRemote, warnings) {
         );
         continue;
       }
-      if (++remote > MAX_REMOTE_FIGURES) {
+      if (remote >= MAX_REMOTE_FIGURES) {
         warnings.push(
           `figure ${figure.id} was left out: more than ${MAX_REMOTE_FIGURES} remote figures`
         );
         continue;
       }
-      const why = await reachable(src);
-      if (why) {
-        warnings.push(`figure ${figure.id} was left out: ${host(src)} ${why}`);
+      const why2 = await reachable(src);
+      if (why2) {
+        warnings.push(`figure ${figure.id} was left out: ${host(src)} ${why2}`);
         continue;
       }
+      remote++;
       figures.push(figure);
       continue;
     }
@@ -9493,12 +11507,12 @@ async function guardFigures(source, root2, allowRemote, warnings) {
       warnings.push(`figure ${figure.id} was left out: "${scheme}:" figures are not read`);
       continue;
     }
-    const abs = resolve4(join11(root2, src.replace(/^\.?\//, "")));
+    const abs = isAbsolute(src) ? resolve5(src) : resolve5(join12(root2, src.replace(/^\.?\//, "")));
     if (!insideRoot(root2, abs)) {
       warnings.push(`figure ${figure.id} was left out: "${src}" points outside the upload`);
       continue;
     }
-    if (!(await stat2(abs).catch(() => null))?.isFile()) {
+    if (!(await stat3(abs).catch(() => null))?.isFile()) {
       warnings.push(`figure ${figure.id} was left out: "${src}" is not in the upload`);
       continue;
     }
@@ -9508,19 +11522,19 @@ async function guardFigures(source, root2, allowRemote, warnings) {
 }
 async function pack2(job, ctx) {
   try {
-    const assets = join11(resolve4(ctx.dirs.src), "assets");
+    const assets = join12(resolve5(ctx.dirs.src), "assets");
     const requests = ctx.source.figures.map((f) => ({
       id: f.id,
-      url: join11(assets, f.src),
+      url: join12(assets, f.src),
       prefer: "bake"
     }));
     const plan = await planMedia(requests, async (url) => ({
-      bytes: new Uint8Array(await readFile11(url))
+      bytes: new Uint8Array(await readFile12(url))
     }));
     const files = { ...plan.files };
     if (ctx.narration) {
       for (const name of audioNames(ctx.narration)) {
-        files[`${AUDIO_DIR}/${name}`] = new Uint8Array(await readFile11(join11(ctx.dirs.audio, name)));
+        files[`${AUDIO_DIR}/${name}`] = new Uint8Array(await readFile12(join12(ctx.dirs.audio, name)));
       }
     }
     const container = {
@@ -9537,10 +11551,10 @@ async function pack2(job, ctx) {
       },
       source: ctx.source,
       storyboard: ctx.storyboard,
-      ...ctx.narration ? { narration: await readJson(join11(ctx.dirs.audio, NARRATION_FILE)) } : {},
+      ...ctx.narration ? { narration: await readJson(join12(ctx.dirs.audio, NARRATION_FILE)) } : {},
       media: plan.media
     };
-    const bytes = await writePack(container, files, join11(ctx.dirs.deck, "deck.deck"));
+    const bytes = await writePack(container, files, join12(ctx.dirs.deck, "deck.deck"));
     job.log(`pack: ${Math.round(bytes / 1024)} KB \u2192 deck.deck`);
     return ctx.url("deck.deck");
   } catch (err) {
@@ -9563,12 +11577,12 @@ function host(src) {
   }
 }
 async function writeJson(path2, value) {
-  await mkdir9(dirname4(path2), { recursive: true });
-  await writeFile11(path2, `${JSON.stringify(value, null, 2)}
+  await mkdir10(dirname4(path2), { recursive: true });
+  await writeFile12(path2, `${JSON.stringify(value, null, 2)}
 `);
 }
 async function readJson(path2) {
-  return JSON.parse(await readFile11(path2, "utf8"));
+  return JSON.parse(await readFile12(path2, "utf8"));
 }
 
 // src/server/errors.ts
@@ -9664,9 +11678,9 @@ var HINTS = [
 var FALLBACK = "This one is not a document problem we recognise. The stage list above shows how far it got; re-running an identical upload is worth one try.";
 function explain(err) {
   if (err instanceof UploadError) return { message: err.message, hint: err.hint };
-  const message = err instanceof Error ? err.message : String(err);
-  const clean2 = message.split("\n    at ")[0]?.trim() || "The job failed.";
-  return { message: clean2, hint: HINTS.find((h) => h.when.test(message))?.hint ?? FALLBACK };
+  const message2 = err instanceof Error ? err.message : String(err);
+  const clean2 = message2.split("\n    at ")[0]?.trim() || "The job failed.";
+  return { message: clean2, hint: HINTS.find((h) => h.when.test(message2))?.hint ?? FALLBACK };
 }
 
 // src/server/queue.ts
@@ -9827,10 +11841,10 @@ var Queue = class {
         if (detail) step.detail = detail;
         this.#emit(job.id);
       },
-      skip: (stage, why) => {
+      skip: (stage, why2) => {
         const step = this.#step(job, stage);
         step.state = "skipped";
-        step.detail = why;
+        step.detail = why2;
         this.#emit(job.id);
       },
       log: (line2) => this.#note(job, line2)
@@ -9909,37 +11923,37 @@ function missingFor(found, opts) {
 // src/mcp/tools.ts
 var formatIds = Object.keys(FORMATS);
 var themeIds = [...THEME_NAMES];
-var settingsSchema = z4.object({
-  format: z4.enum(formatIds).optional().describe(
+var settingsSchema = z5.object({
+  format: z5.enum(formatIds).optional().describe(
     "deck-16x9 is a navigable slide deck. video-16x9, short-9x16 and post-1x1 are linear and budgeted \u2014 they drop beats that do not fit their length."
   ),
-  theme: z4.enum(themeIds).optional().describe("Omit and the storyboard's own theme wins."),
-  lang: z4.string().regex(/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8}){0,3}$/).optional().describe(
+  theme: z5.enum(themeIds).optional().describe("Omit and the storyboard's own theme wins."),
+  lang: z5.string().regex(/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8}){0,3}$/).optional().describe(
     "BCP-47. OMIT THIS unless you want a translation \u2014 absent means the document's own language."
   ),
-  tone: z4.enum(["plain", "academic", "conversational", "punchy"]).optional(),
-  density: z4.enum(["sparse", "normal", "dense"]).optional().describe("How much text a SLIDE carries. A different axis from narration_density."),
-  genre: z4.enum(["general", "paper"]).optional().describe(
+  tone: z5.enum(["plain", "academic", "conversational", "punchy"]).optional(),
+  density: z5.enum(["sparse", "normal", "dense"]).optional().describe("How much text a SLIDE carries. A different axis from narration_density."),
+  genre: z5.enum(["general", "paper"]).optional().describe(
     "DECLARED, never detected. `paper` asks for a research-talk shape \u2014 an introduction and background at the front, a limitations slide and then a conclusion at the end \u2014 and reports where the deck missed it. There is no detector: the documents this tool ingests are analyses OF papers, rewritten in a way that drops the headings a detector would need, so nothing infers this and absent means `general`."
   ),
-  duration: z4.number().min(10).max(1800).optional().describe(
+  duration: z5.number().min(10).max(1800).optional().describe(
     "Target seconds. Sets the pace, derives the slide count when you give none, and overrides animation_speed. Call decksmith_estimate_length first \u2014 a short target buys its words by saying less, not by playing faster."
   ),
-  slides: z4.int().min(3).max(40).optional().describe(
+  slides: z5.int().min(3).max(40).optional().describe(
     "Target beat count. Derived from duration when omitted. Stating it is obeyed even when it cannot flow, and you are told what it cost."
   ),
-  animation_speed: z4.number().min(0.25).max(3).optional().describe("Multiplies every tween. IGNORED when duration is set."),
-  narrate: z4.boolean().optional().describe("Speak the deck with edge-tts. Required for video."),
-  voice: z4.string().optional().describe('e.g. "en-US-AndrewMultilingualNeural". Omit to have one chosen for lang and tone.'),
-  rate: z4.string().regex(/^[+-]\d{1,3}%$/).optional().describe("IGNORED when duration is set."),
-  pitch: z4.string().regex(/^[+-]\d{1,3}Hz$/).optional(),
-  narration_density: z4.enum(["high", "medium", "low"]).optional().describe(
+  animation_speed: z5.number().min(0.25).max(3).optional().describe("Multiplies every tween. IGNORED when duration is set."),
+  narrate: z5.boolean().optional().describe("Speak the deck with edge-tts. Required for video."),
+  voice: z5.string().optional().describe('e.g. "en-US-AndrewMultilingualNeural". Omit to have one chosen for lang and tone.'),
+  rate: z5.string().regex(/^[+-]\d{1,3}%$/).optional().describe("IGNORED when duration is set."),
+  pitch: z5.string().regex(/^[+-]\d{1,3}Hz$/).optional(),
+  narration_density: z5.enum(["high", "medium", "low"]).optional().describe(
     "How many of a beat's stops SPEAK. `low` is one sentence a beat and is what makes a short target reachable \u2014 the demo has 12 beats but 37 stops, so a 60s target spread over stops is four words each."
   ),
-  video: z4.boolean().optional().describe(
+  video: z5.boolean().optional().describe(
     "Also render an mp4. Adds 1-2 minutes, needs ffmpeg and Chrome, and turns narrate on."
   ),
-  images: z4.boolean().optional().describe(
+  images: z5.boolean().optional().describe(
     "Let the plan ask for a picture where the document has no figure to show. Each brief is drawn through the configured image backend, else the Codex account's own image tool, else an SVG DeckSmith draws itself \u2014 so it never fails for lack of one. Adds about 30 seconds a picture; decksmith_capabilities says which backend is configured."
   )
 });
@@ -9966,34 +11980,64 @@ function fieldsFor(s) {
   put("images", s.images);
   return f;
 }
-var capabilitiesSchema = z4.object({});
-var estimateSchema = z4.object({
+var PAGE_BUDGET = {
+  maxAssetBytes: 8 * 1024 * 1024,
+  maxTotalBytes: 16 * 1024 * 1024,
+  maxWallMs: 6e4,
+  maxClips: 0,
+  refs: "relative"
+};
+async function readPage(url, work2) {
+  await mkdir11(work2, { recursive: true });
+  const dir = await mkdtemp3(join13(work2, "harvest-"));
+  try {
+    const page = await harvest(url, dir, PAGE_BUDGET);
+    const files = {
+      "document.md": new TextEncoder().encode(page.markdown)
+    };
+    for (const asset of page.assets) files[basename4(asset)] = await readFile13(asset);
+    const warnings = [...page.warnings];
+    if (page.clips.length > 0) {
+      warnings.push(
+        `${page.clips.length} video(s) travel as their still image and a link only: this tool ships the page as a markdown document, which has no way to say kind: "clip". \`decksmith ingest <url>\` keeps them as clips.`
+      );
+    }
+    return { zip: zipSync2(files), warnings };
+  } finally {
+    await rm8(dir, { recursive: true, force: true });
+  }
+}
+var capabilitiesSchema = z5.object({});
+var estimateSchema = z5.object({
   settings: settingsSchema.describe("The same settings you would pass to decksmith_create_deck.")
 });
-var createSchema = z4.object({
-  document_path: z4.string().optional().describe("Absolute path to a markdown file. Must sit under the server's root."),
-  document_text: z4.string().optional().describe("The markdown itself, if you have no file."),
+var createSchema = z5.object({
+  document_path: z5.string().optional().describe("Absolute path to a markdown file. Must sit under the server's root."),
+  document_text: z5.string().optional().describe("The markdown itself, if you have no file."),
+  document_url: z5.string().optional().describe(
+    "An http(s) page to read the document out of. The page is fetched through the same guard as every other URL, opened in a browser that is allowed to request nothing, and reduced to its prose, tables, code and figures; the figures are downloaded and measured here. Videos come back as their still image and a link \u2014 the deck cannot play a video it reached this way. Anything the harvest left out is listed in harvest_warnings on the answer."
+  ),
   settings: settingsSchema.optional(),
-  wait_seconds: z4.number().min(0).max(300).optional().describe(
+  wait_seconds: z5.number().min(0).max(300).optional().describe(
     "How long to block before answering. Default 45. The job keeps running when this expires \u2014 poll decksmith_job_status with the id."
   )
 });
-var statusSchema = z4.object({
-  job_id: z4.string(),
-  wait_seconds: z4.number().min(0).max(300).optional().describe("Block up to this long for the job to finish or change stage. Default 45.")
+var statusSchema = z5.object({
+  job_id: z5.string(),
+  wait_seconds: z5.number().min(0).max(300).optional().describe("Block up to this long for the job to finish or change stage. Default 45.")
 });
 var DEFAULT_WAIT = 45;
 function deckTools(opts) {
   const queue = new Queue({ maxQueued: 8 });
-  const root2 = resolve5(opts.root);
+  const root2 = resolve6(opts.root);
   let cached;
   const found = async () => {
     cached ??= await (opts.probe ?? prereqs)();
     return cached;
   };
   const insideRoot2 = (p) => {
-    if (!isAbsolute(p)) throw new Error(`document_path must be absolute; got "${p}".`);
-    const full = resolve5(p);
+    if (!isAbsolute2(p)) throw new Error(`document_path must be absolute; got "${p}".`);
+    const full = resolve6(p);
     if (full !== root2 && !full.startsWith(root2 + sep2)) {
       throw new Error(
         `document_path is outside the server's root. It may only read files under ${root2}.`
@@ -10049,8 +12093,9 @@ function deckTools(opts) {
     },
     /** Submit a document, wait a bounded slice, report. */
     async create(input) {
-      if (!input.document_path === !input.document_text) {
-        throw new Error("Pass exactly one of document_path or document_text.");
+      const given = [input.document_path, input.document_text, input.document_url].filter(Boolean);
+      if (given.length !== 1) {
+        throw new Error("Pass exactly one of document_path, document_text or document_url.");
       }
       const settings = input.settings ?? {};
       const options = parseOptions(fieldsFor(settings));
@@ -10069,16 +12114,17 @@ function deckTools(opts) {
           );
         }
       }
-      const filename = input.document_path ? input.document_path.split(sep2).pop() : "document.md";
-      const bytes = file ? await readFile12(file) : new TextEncoder().encode(input.document_text);
+      const page = input.document_url === void 0 ? void 0 : await readPage(input.document_url, opts.work);
+      const filename = page ? "page.zip" : input.document_path ? input.document_path.split(sep2).pop() : "document.md";
+      const bytes = page ? page.zip : file ? await readFile13(file) : new TextEncoder().encode(input.document_text);
       if (bytes.byteLength > MAX_UPLOAD_BYTES) {
         throw new Error(
-          `Document is ${(bytes.byteLength / 1e6).toFixed(1)} MB, over the ${(MAX_UPLOAD_BYTES / 1e6).toFixed(0)} MB cap.`
+          `Document is ${(bytes.byteLength / 1e6).toFixed(1)} MB, over the ${(MAX_UPLOAD_BYTES / 1e6).toFixed(0)} MB cap.` + (page ? " Harvest fewer figures with a smaller maxAssets, or save the page and edit it." : "")
         );
       }
       const id2 = randomBytes(16).toString("base64url");
-      const dir = join12(opts.work, id2);
-      await mkdir10(dir, { recursive: true });
+      const dir = join13(opts.work, id2);
+      await mkdir11(dir, { recursive: true });
       queue.submit({
         id: id2,
         dir,
@@ -10092,7 +12138,8 @@ function deckTools(opts) {
           fetchRemoteFigures: true
         })
       });
-      return this.status({ job_id: id2, wait_seconds: input.wait_seconds });
+      const view = await this.status({ job_id: id2, wait_seconds: input.wait_seconds });
+      return page === void 0 ? view : { ...view, harvest_warnings: page.warnings };
     },
     /** Poll, blocking up to `wait_seconds` for the job to move on. */
     async status(input) {
@@ -10104,7 +12151,7 @@ function deckTools(opts) {
   };
 }
 function dirOf(work2, id2) {
-  return join12(work2, id2);
+  return join13(work2, id2);
 }
 function waitFor(queue, id2, seconds) {
   const now = queue.view(id2);
@@ -10136,9 +12183,9 @@ function report(view, dir) {
     // (src/server/pipeline.ts). This said `src/storyboard.json` for one run, which
     // is the shape of the CLI's output directory and not the server's, and an
     // agent told to read it would have found nothing there.
-    storyboard_path: join12(dir, "storyboard.json"),
+    storyboard_path: join13(dir, "storyboard.json"),
     ...done && view.result ? {
-      deck_path: join12(dir, "deck"),
+      deck_path: join13(dir, "deck"),
       slides: view.result.slides,
       duration_seconds: view.result.duration,
       warnings: view.result.warnings
@@ -10147,7 +12194,7 @@ function report(view, dir) {
   };
 }
 function defaultWork() {
-  return join12(tmpdir3(), "decksmith-mcp");
+  return join13(tmpdir3(), "decksmith-mcp");
 }
 
 // src/mcp/main.ts
@@ -10161,7 +12208,7 @@ var env = process.env;
 var root = env.DECKSMITH_MCP_ROOT ?? homedir3();
 var work = env.DECKSMITH_MCP_WORK ?? defaultWork();
 var tools = deckTools({ root, work });
-var schema = (s) => z5.toJSONSchema(s, { io: "input", unrepresentable: "any", target: "draft-2020-12" });
+var schema = (s) => z6.toJSONSchema(s, { io: "input", unrepresentable: "any", target: "draft-2020-12" });
 var TOOLS = [
   {
     name: "decksmith_capabilities",