scenri 0.8.2 → 0.8.3

package/dist/serve.js

@@ -8,9 +8,9 @@ import Database from 'better-sqlite3';
 import { randomBytes, createHash, randomUUID, timingSafeEqual } from 'crypto';
 import fs, { realpathSync, existsSync, readFileSync, mkdirSync, chmodSync, writeFileSync, createReadStream, rmSync, readdirSync, statSync, renameSync } from 'fs';
 import { fileURLToPath } from 'url';
-import { readFile, copyFile, stat, access, readdir, mkdtemp, rm, rename, unlink, writeFile } from 'fs/promises';
+import { readFile, copyFile, stat, readdir, mkdtemp, rm, access, rename, unlink, writeFile } from 'fs/promises';
 import { spawn } from 'child_process';
-import sharp21 from 'sharp';
+import sharp20 from 'sharp';
 import Fastify from 'fastify';
 import fastifyStatic from '@fastify/static';
 import fastifyMultipart from '@fastify/multipart';
@@ -690,6 +690,7 @@ var headOf = (prompt) => Array.from(String(prompt ?? "")).slice(0, PROMPT_HEAD_C
 var CHILD_COUNT_SQL = "(CASE WHEN n.kind = 'root' THEN 0 ELSE (SELECT count(*) FROM nodes c WHERE c.parent_id = n.id AND c.archived = 0) END)";
 var LINEAGE_SIBLINGS_RADIUS = 25;
 var LINEAGE_CHILDREN_MAX = 60;
+var LINEAGE_HISTORY_MAX = 60;
 var FEED_COLS = `n.id, n.project_id, n.parent_id, n.kind, substr(n.prompt, 1, ${PROMPT_HEAD_CHARS}) AS prompt_head,
   n.engine_id, n.status, n.images, n.cost_usd, n.duration_ms, n.kept, n.error, n.created_at, n.brief, n.archived,
   n.batch_id, n.batch_index, ${CHILD_COUNT_SQL} AS child_count`;
@@ -1137,7 +1138,7 @@ function createStore(db) {
     lineageOf(id) {
       const node = this.getFeedNode(id);
       if (!node) return null;
-      if (node.kind === "root") return { ancestors: [], siblings: [], children: [] };
+      if (node.kind === "root") return { ancestors: [], siblings: [], children: [], history: [] };
       const ancestors = [];
       let cur = node.parentId ? this.getFeedNode(node.parentId) : null;
       for (let hops = 0; cur && cur.kind !== "root" && hops < 64; hops++) {
@@ -1155,7 +1156,18 @@ function createStore(db) {
               ORDER BY n.created_at, n.id LIMIT ? OFFSET ?`
       ).all(node.parentId, take, skip).map(rowToFeedNode);
       const children = db.prepare(`SELECT ${FEED_COLS} FROM nodes n WHERE n.parent_id = ? ORDER BY n.created_at, n.id LIMIT ?`).all(node.id, LINEAGE_CHILDREN_MAX).map(rowToFeedNode);
-      return { ancestors, siblings, children };
+      const rootShot = ancestors[0] ?? node;
+      const history = db.prepare(
+        `WITH RECURSIVE d(id) AS (SELECT @root UNION ALL SELECT c.id FROM nodes c JOIN d ON c.parent_id = d.id)
+             SELECT ${FEED_COLS} FROM nodes n
+              WHERE n.id IN (SELECT id FROM d) AND (n.archived = 0 OR n.id = @self)
+              ORDER BY n.created_at, n.id LIMIT @limit`
+      ).all({ root: rootShot.id, self: node.id, limit: LINEAGE_HISTORY_MAX }).map(rowToFeedNode);
+      if (!history.some((n) => n.id === node.id)) {
+        history.pop();
+        history.push(node);
+      }
+      return { ancestors, siblings, children, history };
     },
     /** The newest finished shots, newest first, for the rail and the attach panel. */
     recentShots(projectId, limit = 48) {
@@ -3508,7 +3520,7 @@ function createDemoEngine(saveImage, opts = {}) {
       <text x="24" y="${h - 48}" font-family="Helvetica, Arial" font-size="${Math.max(14, Math.round(w / 42))}" fill="#ffffff" opacity="0.92">${esc(label)}</text>
       <text x="24" y="${h - 22}" font-family="Helvetica, Arial" font-size="12" fill="#ffffff" opacity="0.6">Scenri demo engine</text>
     </svg>`;
-    return sharp21(Buffer.from(svg)).png().toBuffer();
+    return sharp20(Buffer.from(svg)).png().toBuffer();
   }
   return {
     capabilities() {
@@ -3699,7 +3711,7 @@ var resolvedRefs = /* @__PURE__ */ new Map();
 async function refHash(core, path) {
   const hit = resolvedRefs.get(path);
   if (hit && core.images.has(hit)) return hit;
-  const hash = core.images.save(await sharp21(readFileSync(path)).png().toBuffer());
+  const hash = core.images.save(await sharp20(readFileSync(path)).png().toBuffer());
   resolvedRefs.set(path, hash);
   return hash;
 }
@@ -3803,7 +3815,7 @@ var resolvedRefs2 = /* @__PURE__ */ new Map();
 async function refHash2(core, path) {
   const hit = resolvedRefs2.get(path);
   if (hit && core.images.has(hit)) return hit;
-  const hash = core.images.save(await sharp21(readFileSync(path)).png().toBuffer());
+  const hash = core.images.save(await sharp20(readFileSync(path)).png().toBuffer());
   resolvedRefs2.set(path, hash);
   return hash;
 }
@@ -3940,6 +3952,109 @@ function mergeEditAttachments(own, inherited, cap2) {
   const borrowed = inherited.filter((a) => !seen.has(a.hash)).map((a) => ({ ...a, inherited: true }));
   return allocateAttachments([...own, ...borrowed], cap2);
 }
+var THUMB_WIDTHS = [640, 320, 160];
+var WARM_WIDTHS = [640, 160];
+var isThumbWidth = (w) => THUMB_WIDTHS.includes(w);
+var THUMB_WIDTH_LIST = THUMB_WIDTHS.join(", ");
+var QUALITY = { 640: 82, 320: 80, 160: 75 };
+var FILE_KEY = /^[a-z0-9-]{1,120}$/;
+function createThumbStore(core, opts = {}) {
+  const dir = join(core.home, "thumbs");
+  let enabled = true;
+  try {
+    mkdirSync(dir, { recursive: true, mode: 448 });
+  } catch {
+    enabled = false;
+  }
+  const pathFor = (key, w) => join(dir, `${key}-w${w}.webp`);
+  const inflight = /* @__PURE__ */ new Map();
+  const failed = /* @__PURE__ */ new Set();
+  const concurrency = Math.max(1, opts.concurrency ?? 2);
+  let active = 0;
+  const waiting = [];
+  const acquire = () => new Promise((resolve) => {
+    if (active < concurrency) {
+      active++;
+      resolve();
+    } else waiting.push(resolve);
+  });
+  const release = () => {
+    const next = waiting.shift();
+    if (next) next();
+    else active--;
+  };
+  async function make(key, source, w) {
+    const final = pathFor(key, w);
+    const tmp = `${final}.${process.pid}.${Math.random().toString(36).slice(2, 8)}.tmp`;
+    await acquire();
+    try {
+      await sharp20(source).resize({ width: w, withoutEnlargement: true }).webp({ quality: QUALITY[w], effort: 4 }).toFile(tmp);
+      await rename(tmp, final);
+      return final;
+    } catch {
+      await unlink(tmp).catch(() => {
+      });
+      failed.add(`${key}-w${w}`);
+      return null;
+    } finally {
+      release();
+    }
+  }
+  async function ensureKey(key, source, w) {
+    if (!enabled) return null;
+    const memo = `${key}-w${w}`;
+    if (failed.has(memo)) return null;
+    const final = pathFor(key, w);
+    try {
+      await access(final);
+      return final;
+    } catch {
+    }
+    let job = inflight.get(memo);
+    if (!job) {
+      job = make(key, source, w).finally(() => inflight.delete(memo));
+      inflight.set(memo, job);
+    }
+    return job;
+  }
+  return {
+    dir,
+    async ensure(hash, w) {
+      if (!/^[a-f0-9]{32}$/.test(hash)) return null;
+      return ensureKey(hash, core.images.pathFor(hash), w);
+    },
+    async ensureFile(key, sourcePath, w) {
+      if (!FILE_KEY.test(key)) return null;
+      return ensureKey(`f-${key}`, sourcePath, w);
+    },
+    warm(hash) {
+      for (const w of WARM_WIDTHS) void this.ensure(hash, w);
+    },
+    async settle() {
+      await Promise.allSettled([...inflight.values()]);
+    },
+    clear() {
+      failed.clear();
+      rmSync(dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
+      try {
+        mkdirSync(dir, { recursive: true, mode: 448 });
+      } catch {
+        enabled = false;
+      }
+    },
+    stream: (path) => createReadStream(path)
+  };
+}
+async function fileSize(path) {
+  try {
+    const s = await stat(path);
+    return s.isFile() ? s.size : null;
+  } catch {
+    return null;
+  }
+}
+
+// src/routes/shared.ts
 function joinNames(labels) {
   const uniq = [...new Set(labels)];
   if (uniq.length <= 1) return uniq[0] ?? "";
@@ -3963,7 +4078,7 @@ var assetHash = (ref) => {
 };
 var LOGO_ROLES = ["primary", "mark", "wordmark", "monochrome", "alternate"];
 var LOGO_BACKGROUNDS = ["light", "dark", "any"];
-var toPng = (buf) => sharp21(buf).rotate().png().toBuffer();
+var toPng = (buf) => sharp20(buf).rotate().png().toBuffer();
 var COST_PROBE = {
   prompt: "",
   brand: { brand: {}, assetPaths: {} },
@@ -3976,11 +4091,11 @@ var MARK_MIN_EDGE = 1024;
 var MARK_TINY_EDGE = 256;
 var MARK_WARN_EDGE = 512;
 var toMarkPng = async (buf) => {
-  const out = await sharp21(buf, { density: 384 }).rotate().resize({ width: MARK_MAX_EDGE, height: MARK_MAX_EDGE, fit: "inside", withoutEnlargement: true }).png().toBuffer();
-  const meta = await sharp21(out).metadata();
+  const out = await sharp20(buf, { density: 384 }).rotate().resize({ width: MARK_MAX_EDGE, height: MARK_MAX_EDGE, fit: "inside", withoutEnlargement: true }).png().toBuffer();
+  const meta = await sharp20(out).metadata();
   const edge = Math.max(meta.width ?? 0, meta.height ?? 0);
   if (edge >= MARK_TINY_EDGE && edge < MARK_MIN_EDGE) {
-    return sharp21(out).resize({ width: MARK_MIN_EDGE, height: MARK_MIN_EDGE, fit: "inside", kernel: "lanczos3" }).png().toBuffer();
+    return sharp20(out).resize({ width: MARK_MIN_EDGE, height: MARK_MIN_EDGE, fit: "inside", kernel: "lanczos3" }).png().toBuffer();
   }
   return out;
 };
@@ -3991,9 +4106,9 @@ async function capReferenceEdge(core, path, maxEdge) {
   if (hit) return hit;
   let out = path;
   try {
-    const meta = await sharp21(path).metadata();
+    const meta = await sharp20(path).metadata();
     if ((meta.width ?? 0) > maxEdge || (meta.height ?? 0) > maxEdge) {
-      const buf = await sharp21(path).resize({ width: maxEdge, height: maxEdge, fit: "inside", withoutEnlargement: true }).png().toBuffer();
+      const buf = await sharp20(path).resize({ width: maxEdge, height: maxEdge, fit: "inside", withoutEnlargement: true }).png().toBuffer();
       out = core.images.pathFor(core.images.save(buf));
     }
   } catch {
@@ -4020,6 +4135,25 @@ var serveJpeg = (req, reply, path) => {
   if (req.headers["if-none-match"] === etag) return reply.status(304).send();
   return reply.header("content-type", "image/jpeg").send(readFileSync(path));
 };
+var fileKey = (prefix, id, path) => `${prefix}-${id}-${Math.round(statSync(path).mtimeMs)}`;
+var serveJpegSized = async (req, reply, path, thumbs, key) => {
+  const raw = req.query?.w;
+  if (raw === void 0 || raw === "") return serveJpeg(req, reply, path);
+  const w = Number(raw);
+  if (!isThumbWidth(w)) return reply.status(400).send({ error: `w must be one of ${THUMB_WIDTH_LIST}` });
+  const immutable = "public, max-age=31536000, immutable";
+  const etag = `"${key}-w${w}"`;
+  if (req.headers["if-none-match"] === etag) return reply.status(304).header("cache-control", immutable).send();
+  const made = await thumbs.ensureFile(key, path, w);
+  const size = made ? await fileSize(made) : null;
+  if (!made || size === null) {
+    const back = new URL(req.url, "http://scenri.local");
+    back.searchParams.delete("w");
+    return reply.header("cache-control", "no-store").redirect(`${back.pathname}${back.search}`, 307);
+  }
+  reply.header("content-type", "image/webp").header("cache-control", immutable).header("etag", etag).header("content-length", String(size));
+  return reply.send(thumbs.stream(made));
+};
 
 // src/briefDirectives.ts
 function productFidelityDirective(attached) {
@@ -4100,6 +4234,12 @@ function shotSpecifiesCamera(text) {
 function namesAreNotLetteringDirective() {
   return "The names in this brief identify what to show and are never text to render: no caption, label, signage, engraving or lettering spells a product name or a person's name, in any language or script, anywhere in the picture. Printing that is part of a product's own packaging stays exactly as photographed, and nothing else spells a name unless the direction above explicitly asks for it to be written.";
 }
+var PERSON_SCENE_FIGURE = "the one person this set is shot around";
+function shotAsksForAPerson(text) {
+  return /\b(?:person|people|man|men|woman|women|models?|figures?|someone|somebody|anyone|hands?(?!-)|arms?(?!-)|portrait|girls?|boys?|guys?|lady|ladies|couple|family|child|children|kids?|baby|crowd|presenter|character|athlete|dancer|customer|shopper|wearer|wearing|holding|holds)\b/i.test(
+    text
+  );
+}
 function sceneFigureDirectives(opts) {
   const figure = opts.figure.trim().replace(/[.\s]+$/, "");
   if (!figure) return [];
@@ -4113,15 +4253,23 @@ function sceneFigureDirectives(opts) {
     out.push(
       `This world is built around one figure: ${figure}. The attached presenter is that figure. Any person the scene direction describes IS the presenter and never a second person, and their identity comes from their own attached photograph alone, never from anything the scene direction says about a body.`
     );
+  } else if (opts.asked) {
+    out.push(
+      `This world is built around one figure: ${figure}. The brief asks for a person and nobody is attached, so someone fills that role in the frame, and they are nobody in particular: an anonymous person invented for this photograph only, with no recognisable identity to preserve and nothing about them carried anywhere else.`
+    );
   } else {
     out.push(
-      `This world is built around one figure: ${figure}. Someone fills that role in the frame, and they are nobody in particular: an anonymous person invented for this photograph only, with no recognisable identity to preserve and nothing about them carried anywhere else. Show them unless the direction above asks for no people.`
+      `This world is built around one figure: ${figure}. Nobody is attached to take that role, so the role stays empty and nobody is in this image. The frame holds the set, the light and any treatment this world applies.`
     );
   }
   if (treatment) {
     const who = opts.hasPerson ? "The face and body underneath are still exactly theirs - same structure, same proportions, same build - and any earlier instruction that their features must survive unchanged is a rule about who they are, which this does not alter. " : "";
     out.push(
-      `The art direction of this world is what has been done to that figure: ${treatment}. Render it as a real physical treatment, following the shape of the face and body it sits on rather than floating in the frame. Spread it across the whole form the way the reference does, reaching every part it covers there - brow, forehead, nose, both cheeks, jaw - instead of massing it in one area and leaving the rest untouched. Reaching wide is not the same as covering more: keep the number of pieces and the bare surface between them exactly as the description says, so a sparse treatment stays sparse while still touching every part of the form. Each piece sits on the plane beneath it, curving and catching light with the surface it is stuck to. ${who}The figure is bodily present and in shot: where the treatment covers or hides them, that is the photograph working as intended and never a reason to leave them out, crop them away, or reduce them to a shadow. If no person appears in this shot, the treatment does not go with them: it is what this world looks like, so it applies to whatever the frame does hold - the product, the surfaces, the set - as real pieces resting on those things. Applied on top, never redesigning them: the product keeps the exact form, colour, material and its own printed label that its reference shows, with the treatment sitting over it. Where the treatment carries printing, render it as genuinely designed print: real letterforms, readable words, numerals, illustration and colour, at the quality of commercial label artwork. Invent the companies - every name, logotype and piece of packaging artwork must be plausible but fictional, resembling no existing brand. That includes near-misses: do not borrow, extend or re-spell a name that appears in any attached reference, and use ordinary words for the produce itself rather than any company that sells it.` + // The fictional-brands rule and an attached brand mark are in direct
+      `The art direction of this world is what has been done to that figure: ${treatment}. Render it as a real physical treatment, following the shape of the face and body it sits on rather than floating in the frame. Spread it across the whole form the way the reference does, reaching every part it covers there - brow, forehead, nose, both cheeks, jaw - instead of massing it in one area and leaving the rest untouched. Reaching wide is not the same as covering more: keep the number of pieces and the bare surface between them exactly as the description says, so a sparse treatment stays sparse while still touching every part of the form. Each piece sits on the plane beneath it, curving and catching light with the surface it is stuck to. ${who}` + (opts.hasPerson ? "The figure is bodily present and in shot: where the treatment covers or hides them, that is the photograph working as intended and never a reason to leave them out, crop them away, or reduce them to a shadow. " : "") + // The treatment is the art direction, not a property of the person. Ask
+      // for this world with no people in it and the stickers should still be
+      // there, on whatever the frame does hold - that IS the scene. Suppressing
+      // them left a plain product on a plinth with nothing of the scene in it.
+      "If no person appears in this shot, the treatment does not go with them: it is what this world looks like, so it applies to whatever the frame does hold - the product, the surfaces, the set - as real pieces resting on those things. Applied on top, never redesigning them: the product keeps the exact form, colour, material and its own printed label that its reference shows, with the treatment sitting over it. Where the treatment carries printing, render it as genuinely designed print: real letterforms, readable words, numerals, illustration and colour, at the quality of commercial label artwork. Invent the companies - every name, logotype and piece of packaging artwork must be plausible but fictional, resembling no existing brand. That includes near-misses: do not borrow, extend or re-spell a name that appears in any attached reference, and use ordinary words for the produce itself rather than any company that sells it." + // The fictional-brands rule and an attached brand mark are in direct
       // conflict without this: "resembling no existing brand" reads as an
       // instruction to mutate the one real mark the user deliberately
       // attached. Same shape as pairDirectives' packshot override - name the
@@ -4161,6 +4309,12 @@ function sceneGuardDirectives(opts) {
       );
     }
   }
+  const emptyRole = (opts.emptyRole ?? "").trim().replace(/[.\s]+$/, "");
+  if (emptyRole) {
+    out.push(
+      `Disregard any person, figure, hand, face or silhouette described in the scene direction or the camera note above: that is the role this world is built around (${emptyRole}), nobody is attached to take it, and it stays empty. Nobody is in this image: no person, no hands, no reflection or shadow of anyone. The set, the light and any treatment this world applies fill the frame on their own.`
+    );
+  }
   return out;
 }
 function brandRuleDirectives(brand) {
@@ -4188,7 +4342,6 @@ function markLabel(brand, logo) {
 // src/brief.ts
 var PRODUCT_REF_MAX = 3;
 var CHARACTER_REF_MAX = 3;
-var SCENE_REF_MAX = 1;
 var FORMATS = [
   { id: "square", label: "Square 1:1", w: 1024, h: 1024 },
   { id: "story", label: "Story 9:16", w: 1080, h: 1920 },
@@ -4247,7 +4400,6 @@ function compileBrief(brief, ctx) {
   const warnings = [];
   const attachments = [];
   const unattachable = [];
-  const rawSceneFallback = [];
   const productDirectives = [];
   const personDirectives = [];
   const otherDirectives = [];
@@ -4260,6 +4412,7 @@ function compileBrief(brief, ctx) {
   let hasPerson = false;
   let people = 0;
   let sentence = "";
+  let userWords = "";
   const append = (s) => {
     sentence += (sentence && !sentence.endsWith(" ") ? " " : "") + s;
   };
@@ -4270,6 +4423,7 @@ function compileBrief(brief, ctx) {
     switch (tok.t) {
       case "text":
         append(tok.v);
+        userWords += ` ${tok.v}`;
         break;
       case "product": {
         const p = products.find((x) => x.id === tok.id);
@@ -4426,14 +4580,8 @@ function compileBrief(brief, ctx) {
         append(composePrompt(t, { fields: brief.templateFields ?? {}, notes: "" }));
         if (ctx.mode !== "edit" && t.figure) {
           const plate = assetHash2(t.preview);
-          const hasPlate = !!plate && ctx.images.has(plate);
-          const candidates = hasPlate ? [plate] : (t.refs ?? []).slice(0, SCENE_REF_MAX).map((r) => assetHash2(r?.file));
-          for (const h of candidates) {
-            if (h && ctx.images.has(h)) {
-              const a = { role: "scene", id: t.id, label: t.name, hash: h, essential: false };
-              attachments.push(a);
-              if (!hasPlate) rawSceneFallback.push(a);
-            }
+          if (plate && ctx.images.has(plate)) {
+            attachments.push({ role: "scene", id: t.id, label: t.name, hash: plate, essential: false });
           }
         }
         break;
@@ -4479,15 +4627,12 @@ function compileBrief(brief, ctx) {
   if (scene?.subject === "product" && !productId) {
     warnings.push(`${scene.name} is built around a product. Add one to this brief.`);
   } else if (scene?.subject === "person" && !hasPerson) {
-    warnings.push(`${scene.name} is built around a person. Add a presenter.`);
+    warnings.push(`${scene.name} is built around a person. With nobody attached, the set renders on its own.`);
   }
   const sceneCamera = inlineTemplates[0]?.camera?.trim() || ctx.template?.camera?.trim() || "";
   const cameraDirectives = sceneCamera && !shotSpecifiesCamera(sentence) ? [`Camera for this shot: ${sceneCamera}`] : [];
-  if (hasPerson && rawSceneFallback.length) {
-    for (const a of rawSceneFallback) {
-      const i = attachments.indexOf(a);
-      if (i !== -1) attachments.splice(i, 1);
-    }
+  if (!hasPerson) {
+    for (let i = attachments.length - 1; i >= 0; i--) if (attachments[i].role === "scene") attachments.splice(i, 1);
   }
   const identityHashes = /* @__PURE__ */ new Map();
   for (const a of attachments)
@@ -4533,10 +4678,14 @@ function compileBrief(brief, ctx) {
       );
     }
   }
+  const figureRole = scene?.figure ?? (scene?.subject === "person" && !hasPerson ? PERSON_SCENE_FIGURE : void 0);
+  const asked = shotAsksForAPerson(userWords);
+  const emptyRole = figureRole && !hasPerson && !asked && ctx.mode !== "edit" ? figureRole : void 0;
   const guard = scene ? sceneGuardDirectives({
     hasProduct: !!productId,
     hasPerson,
-    hasScenePhoto: kept.some((a) => a.role === "scene")
+    hasScenePhoto: kept.some((a) => a.role === "scene"),
+    emptyRole
   }) : [];
   const pairDirectives = productId && hasPerson ? [
     "If the attached product is something a person wears, the presenter wears that exact product, with the rest of the outfit styled around it; otherwise the presenter presents or uses the product naturally.",
@@ -4550,10 +4699,11 @@ function compileBrief(brief, ctx) {
     productHandlingDirective()
   ] : [];
   const nameDirectives = productId || hasPerson ? [namesAreNotLetteringDirective()] : [];
-  const figureDirectives = scene?.figure ? sceneFigureDirectives({
-    figure: scene.figure,
-    treatment: scene.figureTreatment,
+  const figureDirectives = figureRole && (hasPerson || ctx.mode !== "edit") ? sceneFigureDirectives({
+    figure: figureRole,
+    treatment: scene?.figureTreatment,
     hasPerson,
+    asked,
     people,
     // The treatment's fictional-brands rule needs to know a real mark is
     // deliberately in play - and only one that actually rides counts,
@@ -6639,8 +6789,8 @@ async function runJob(deps, jobId, brandId, url, signal) {
             errors.push({ code: "image_empty", message: "Empty image", url: img.sourceUrl });
             return;
           }
-          const png = await sharp21(buf).rotate().png().toBuffer();
-          const meta = await sharp21(png).metadata();
+          const png = await sharp20(buf).rotate().png().toBuffer();
+          const meta = await sharp20(png).metadata();
           const hash = core.images.save(png);
           core.catalog.setImageAsset(img.productId, img.sourceUrl, `asset:${hash}`, {
             width: meta.width,
@@ -7117,7 +7267,7 @@ async function generateStudioSet(deps, job, who, sourcePaths, signal) {
   return { hashes: kept.map((f) => byAngle.get(f.angle)), angles: kept.map((f) => f.angle) };
 }
 async function edgeBarGeometry(buf) {
-  const { data, info } = await sharp21(buf).greyscale().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp20(buf).greyscale().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const scan = (len, cross, at) => {
@@ -7171,7 +7321,7 @@ async function trimEdgeBars(core, hash) {
     const width = g.right - g.left + 1;
     const height = g.bottom - g.top + 1;
     if (width < g.W * 0.6 || height < g.H * 0.6) return hash;
-    const png = await sharp21(buf).extract({ left: g.left, top: g.top, width, height }).png().toBuffer();
+    const png = await sharp20(buf).extract({ left: g.left, top: g.top, width, height }).png().toBuffer();
     return core.images.save(png);
   } catch {
     return hash;
@@ -7242,7 +7392,7 @@ async function identityCrop(core, hash) {
   if (!out) return void 0;
   try {
     const height = Math.min(IDENTITY_TARGET_HEIGHT, Math.round(nativeHeight * IDENTITY_MAX_UPSCALE)) || IDENTITY_TARGET_HEIGHT;
-    const png = await sharp21(core.images.read(out)).resize({ height, fit: "inside", kernel: "lanczos3", withoutEnlargement: false }).png().toBuffer();
+    const png = await sharp20(core.images.read(out)).resize({ height, fit: "inside", kernel: "lanczos3", withoutEnlargement: false }).png().toBuffer();
     const scaled = core.images.save(png);
     identityCrops.set(hash, scaled);
     return scaled;
@@ -7271,12 +7421,12 @@ async function brandJsonWithIdentityCrops(core, json, characterIds) {
   return changed ? { ...json, characters } : json;
 }
 async function figureBox(buf) {
-  const meta = await sharp21(buf).metadata();
+  const meta = await sharp20(buf).metadata();
   const W = meta.width ?? 0;
   const H = meta.height ?? 0;
   if (!W || !H) return null;
   for (const threshold of FIGURE_TRIM_THRESHOLDS) {
-    const { info } = await sharp21(buf).trim({ threshold }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp20(buf).trim({ threshold }).toBuffer({ resolveWithObject: true });
     const left = Math.abs(info.trimOffsetLeft ?? 0);
     const top = Math.abs(info.trimOffsetTop ?? 0);
     const width = info.width ?? 0;
@@ -7309,13 +7459,13 @@ async function smartCover(core, hash, box) {
   if (!hash || !core.images.has(hash)) return void 0;
   try {
     const buf = core.images.read(hash);
-    const meta = await sharp21(buf).metadata();
+    const meta = await sharp20(buf).metadata();
     const w = meta.width ?? 0;
     const h = meta.height ?? 0;
     if (!w || !h) return void 0;
     const raw = box(w, h);
     const target = { width: Math.max(1, raw.width), height: Math.max(1, raw.height) };
-    const png = await sharp21(buf).resize(target.width, target.height, { fit: "cover", position: "attention" }).png().toBuffer();
+    const png = await sharp20(buf).resize(target.width, target.height, { fit: "cover", position: "attention" }).png().toBuffer();
     return core.images.save(png);
   } catch {
     return void 0;
@@ -7324,11 +7474,11 @@ async function smartCover(core, hash, box) {
 async function crop(core, hash, region, cap2) {
   if (!hash || !core.images.has(hash)) return void 0;
   try {
-    const meta = await sharp21(core.images.read(hash)).metadata();
+    const meta = await sharp20(core.images.read(hash)).metadata();
     const w = meta.width ?? 0;
     const h = meta.height ?? 0;
     if (!w || !h) return void 0;
-    let pipeline = sharp21(core.images.read(hash)).extract(region(w, h));
+    let pipeline = sharp20(core.images.read(hash)).extract(region(w, h));
     if (cap2) pipeline = pipeline.resize(cap2, cap2, { fit: "inside", withoutEnlargement: true });
     const png = await pipeline.png().toBuffer();
     return core.images.save(png);
@@ -7675,7 +7825,7 @@ var fromLab = (l, a, bb) => {
   return [clamp(R), clamp(G), clamp(B)];
 };
 var rawAt = async (png, edge) => {
-  let img = sharp21(png);
+  let img = sharp20(png);
   if (edge) img = img.resize(edge, edge, { fit: "fill" });
   const { data, info } = await img.removeAlpha().raw().toBuffer({ resolveWithObject: true });
   return { data, width: info.width, height: info.height };
@@ -7738,7 +7888,7 @@ async function gradeComposite(originalPng, modelInputPng, modelOutputPng) {
     if (residual > GRADE_GATE_MEAN_DELTA) return null;
     const full = await rawAt(originalPng);
     applyAffine(full, T);
-    const image = await sharp21(full.data, {
+    const image = await sharp20(full.data, {
       raw: { width: full.width, height: full.height, channels: 3 }
     }).png().toBuffer();
     return { image, residual };
@@ -7912,7 +8062,7 @@ function fitExpandToBudget(plan, source, pixelBudget) {
 }
 async function attentionCropOrigin(srcBuf, source, plan) {
   try {
-    const { info } = await sharp21(srcBuf).resize(plan.width, plan.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp20(srcBuf).resize(plan.width, plan.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
     const attnLeft = typeof info.cropOffsetLeft === "number" ? Math.abs(info.cropOffsetLeft) : plan.left;
     const attnTop = typeof info.cropOffsetTop === "number" ? Math.abs(info.cropOffsetTop) : plan.top;
     const left = Math.round((attnLeft + plan.left) / 2);
@@ -8065,23 +8215,23 @@ function relax(grid, seam, fixedSweeps) {
 
 // src/expand.ts
 async function expandCanvas(source, plan) {
-  const bed = await sharp21(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
-  return sharp21(bed).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
+  const bed = await sharp20(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
+  return sharp20(bed).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
 }
 async function compositeExpand(engineImage, source, plan) {
-  const meta = await sharp21(engineImage).metadata();
+  const meta = await sharp20(engineImage).metadata();
   const want = plan.width / plan.height;
   const got = meta.width && meta.height ? meta.width / meta.height : 0;
   const sameOrientation = got > 0 && got >= 1 === want >= 1;
   const aligned = sameOrientation;
   const exact = meta.width === plan.width && meta.height === plan.height;
-  const surround = aligned ? exact ? engineImage : await sharp21(engineImage).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).toBuffer() : await expandCanvasBedOnly(source, plan);
+  const surround = aligned ? exact ? engineImage : await sharp20(engineImage).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).toBuffer() : await expandCanvasBedOnly(source, plan);
   const matched = aligned ? await matchMarginsToSeam(surround, source, plan) : surround;
-  const image = await sharp21(matched).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
+  const image = await sharp20(matched).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
   return { image, aligned };
 }
 async function matchMarginsToSeam(surround, source, plan) {
-  const src = await sharp21(source).metadata();
+  const src = await sharp20(source).metadata();
   if (!src.width || !src.height) return surround;
   const SW = src.width;
   const SH = src.height;
@@ -8128,8 +8278,8 @@ var MAX_CORRECTION = 60;
 async function reconcile(surround, source, side, axis) {
   const { margin } = side;
   if (margin.width < 1 || margin.height < 1) return surround;
-  const marginRaw = await sharp21(surround).extract(margin).removeAlpha().raw().toBuffer();
-  const edgeRaw = await sharp21(source).extract(side.srcEdge).removeAlpha().raw().toBuffer();
+  const marginRaw = await sharp20(surround).extract(margin).removeAlpha().raw().toBuffer();
+  const edgeRaw = await sharp20(source).extract(side.srcEdge).removeAlpha().raw().toBuffer();
   const W = margin.width;
   const H = margin.height;
   const along = axis === "width" ? H : W;
@@ -8183,11 +8333,11 @@ async function reconcile(surround, source, side, axis) {
       }
     }
   }
-  const patch2 = await sharp21(corrected, { raw: { width: W, height: H, channels: 3 } }).png().toBuffer();
-  return sharp21(surround).composite([{ input: patch2, left: margin.left, top: margin.top }]).toBuffer();
+  const patch2 = await sharp20(corrected, { raw: { width: W, height: H, channels: 3 } }).png().toBuffer();
+  return sharp20(surround).composite([{ input: patch2, left: margin.left, top: margin.top }]).toBuffer();
 }
 async function expandCanvasBedOnly(source, plan) {
-  return sharp21(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
+  return sharp20(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
 }
 function medianOf(rgb, channel, from, to) {
   const n = to - from;
@@ -8198,17 +8348,17 @@ function medianOf(rgb, channel, from, to) {
   return n % 2 ? values[(n - 1) / 2] : (values[n / 2 - 1] + values[n / 2]) / 2;
 }
 async function reframeExpand(engineImage, plan) {
-  const meta = await sharp21(engineImage).metadata();
+  const meta = await sharp20(engineImage).metadata();
   if (!(meta.width && meta.height)) return null;
   const want = plan.width / plan.height;
   const got = meta.width / meta.height;
   if (got >= 1 !== want >= 1) return null;
   if (meta.width === plan.width && meta.height === plan.height) return engineImage;
   const straight = Math.abs(got - want) / want <= 0.02;
-  return sharp21(engineImage).resize(plan.width, plan.height, { fit: straight ? "fill" : "cover", position: "centre" }).png().toBuffer();
+  return sharp20(engineImage).resize(plan.width, plan.height, { fit: straight ? "fill" : "cover", position: "centre" }).png().toBuffer();
 }
 async function seamScore(image, plan, source) {
-  const { data, info } = await sharp21(image).removeAlpha().greyscale().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp20(image).removeAlpha().greyscale().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const horizontal = plan.axis === "width";
@@ -8241,7 +8391,7 @@ var SEAM_VISIBLE = 2.2;
 var OFFSET = 4;
 var RESIDUAL_VISIBLE = 15;
 async function seamResidual(image, plan, source) {
-  const { data, info } = await sharp21(image).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp20(image).removeAlpha().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const ch = info.channels;
@@ -8276,7 +8426,7 @@ var MAX_SHARE = 0.8;
 async function subjectFraction(src, source, axis) {
   try {
     const window = axis === "width" ? { width: Math.max(8, Math.round(source.width * 0.5)), height: source.height } : { width: source.width, height: Math.max(8, Math.round(source.height * 0.5)) };
-    const { info } = await sharp21(src).resize(window.width, window.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp20(src).resize(window.width, window.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
     const offset = axis === "width" ? Math.abs(typeof info.cropOffsetLeft === "number" ? info.cropOffsetLeft : 0) : Math.abs(typeof info.cropOffsetTop === "number" ? info.cropOffsetTop : 0);
     const span = axis === "width" ? source.width : source.height;
     const extent = axis === "width" ? window.width : window.height;
@@ -8299,14 +8449,14 @@ function placeExpand(plan, source, fraction) {
 }
 var NEUTRAL = { r: 128, g: 128, b: 128 };
 async function conditioningCanvas(source, plan, fill = "edge") {
-  const meta = await sharp21(source).metadata();
+  const meta = await sharp20(source).metadata();
   const sw = meta.width ?? 0;
   const sh = meta.height ?? 0;
   if (!(sw > 0 && sh > 0)) throw new Error("conditioningCanvas: source has no dimensions");
   const layers = [];
   if (fill === "edge") layers.push(...await edgeMargins(source, plan, { width: sw, height: sh }));
   layers.push({ input: source, left: plan.left, top: plan.top });
-  const canvas = sharp21({
+  const canvas = sharp20({
     create: {
       width: plan.width,
       height: plan.height,
@@ -8318,7 +8468,7 @@ async function conditioningCanvas(source, plan, fill = "edge") {
 }
 async function edgeMargins(source, plan, size) {
   const out = [];
-  const strip = async (extract, width, height) => sharp21(source).extract(extract).resize(width, height, { fit: "fill" }).png().toBuffer();
+  const strip = async (extract, width, height) => sharp20(source).extract(extract).resize(width, height, { fit: "fill" }).png().toBuffer();
   if (plan.axis === "width") {
     const before = plan.left;
     const after = plan.width - plan.left - size.width;
@@ -8409,12 +8559,12 @@ async function resolveOutpaintRoute(all, shot) {
   return { engine: shot, method: "reframe", crossed: false };
 }
 async function driftDiff(a, b) {
-  const metaA = await sharp21(a).metadata();
-  const metaB = await sharp21(b).metadata();
+  const metaA = await sharp20(a).metadata();
+  const metaB = await sharp20(b).metadata();
   const width = Math.min(metaA.width ?? 1, metaB.width ?? 1, 1024);
   const height = Math.min(metaA.height ?? 1, metaB.height ?? 1, 1024);
   const [rawA, rawB] = await Promise.all(
-    [a, b].map((buf) => sharp21(buf).resize(width, height, { fit: "cover" }).ensureAlpha().raw().toBuffer())
+    [a, b].map((buf) => sharp20(buf).resize(width, height, { fit: "cover" }).ensureAlpha().raw().toBuffer())
   );
   const out = new PNG({ width, height });
   const changed = pixelmatch(rawA, rawB, out.data, width, height, { threshold: 0.1, diffColor: [255, 64, 64] });
@@ -8426,11 +8576,11 @@ async function driftDiff(a, b) {
   };
 }
 async function changeMask(a, b, cap2 = 1024) {
-  const metaA = await sharp21(a).metadata();
+  const metaA = await sharp20(a).metadata();
   const width = Math.min(metaA.width ?? 1, cap2);
   const height = Math.min(metaA.height ?? 1, cap2);
   const [rawA, rawB] = await Promise.all(
-    [a, b].map((buf) => sharp21(buf).resize(width, height, { fit: "fill" }).ensureAlpha().raw().toBuffer())
+    [a, b].map((buf) => sharp20(buf).resize(width, height, { fit: "fill" }).ensureAlpha().raw().toBuffer())
   );
   const out = new PNG({ width, height });
   pixelmatch(rawA, rawB, out.data, width, height, { threshold: 0.1, includeAA: true, diffMask: true });
@@ -8479,8 +8629,8 @@ function dilationFor(longEdge) {
 // src/localEdit.ts
 async function preserveOutsideChange(source, edited) {
   try {
-    const srcMeta = await sharp21(source).metadata();
-    const outMeta = await sharp21(edited).metadata();
+    const srcMeta = await sharp20(source).metadata();
+    const outMeta = await sharp20(edited).metadata();
     if (!srcMeta.width || !srcMeta.height || !outMeta.width || !outMeta.height)
       return { image: edited, outcome: "error", changed: 0 };
     const sameShape = Math.abs(outMeta.width / outMeta.height - srcMeta.width / srcMeta.height) / (srcMeta.width / srcMeta.height) <= 0.01;
@@ -8490,15 +8640,15 @@ async function preserveOutsideChange(source, edited) {
     if (outcome !== "composited") return { image: edited, outcome, changed: shape.changed };
     const r = dilationFor(Math.max(shape.width, shape.height));
     const rawShape = { raw: { width: shape.width, height: shape.height, channels: 1 } };
-    const spread = await sharp21(shape.mask, rawShape).blur(r).toColourspace("b-w").raw().toBuffer();
-    const dilated = await sharp21(spread, rawShape).threshold(8).toColourspace("b-w").raw().toBuffer();
-    const feathered = await sharp21(dilated, rawShape).blur(Math.max(2, r / 3)).toColourspace("b-w").raw().toBuffer();
-    const grown = await sharp21(feathered, rawShape).resize(srcMeta.width, srcMeta.height, { fit: "fill", kernel: "cubic" }).toColourspace("b-w").raw().toBuffer();
-    const editedRgb = await sharp21(edited).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).removeAlpha().raw().toBuffer();
-    const masked = await sharp21(editedRgb, {
+    const spread = await sharp20(shape.mask, rawShape).blur(r).toColourspace("b-w").raw().toBuffer();
+    const dilated = await sharp20(spread, rawShape).threshold(8).toColourspace("b-w").raw().toBuffer();
+    const feathered = await sharp20(dilated, rawShape).blur(Math.max(2, r / 3)).toColourspace("b-w").raw().toBuffer();
+    const grown = await sharp20(feathered, rawShape).resize(srcMeta.width, srcMeta.height, { fit: "fill", kernel: "cubic" }).toColourspace("b-w").raw().toBuffer();
+    const editedRgb = await sharp20(edited).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).removeAlpha().raw().toBuffer();
+    const masked = await sharp20(editedRgb, {
       raw: { width: srcMeta.width, height: srcMeta.height, channels: 3 }
     }).joinChannel(grown, { raw: { width: srcMeta.width, height: srcMeta.height, channels: 1 } }).png().toBuffer();
-    const image = await sharp21(source).removeAlpha().composite([{ input: masked }]).png().toBuffer();
+    const image = await sharp20(source).removeAlpha().composite([{ input: masked }]).png().toBuffer();
     return { image, outcome: "composited", changed: shape.changed };
   } catch {
     return { image: edited, outcome: "error", changed: 0 };
@@ -8536,7 +8686,7 @@ function registerLogoRoutes(app, deps) {
     const v = validateBrand(json);
     if (!v.valid) return reply.status(400).send({ error: "brand became invalid", details: v.errors });
     const row = core.store.updateBrand(brand.id, json);
-    const meta = await sharp21(core.images.read(part.hash)).metadata().catch(() => null);
+    const meta = await sharp20(core.images.read(part.hash)).metadata().catch(() => null);
     const logoEdge = meta ? Math.max(meta.width ?? 0, meta.height ?? 0) || null : null;
     return { ...row, logoHash: part.hash, logoEdge };
   });
@@ -8658,7 +8808,7 @@ async function vibrantColor(input) {
   let data;
   let channels;
   try {
-    const out = await sharp21(input).resize(48, 48, { fit: "inside" }).raw().toBuffer({ resolveWithObject: true });
+    const out = await sharp20(input).resize(48, 48, { fit: "inside" }).raw().toBuffer({ resolveWithObject: true });
     data = out.data;
     channels = out.info.channels;
   } catch {
@@ -8681,7 +8831,7 @@ async function vibrantColor(input) {
   const best = buckets.reduce((a, b) => b.score > a.score ? b : a, buckets[0]);
   if (best.score <= 0) {
     try {
-      const { dominant } = await sharp21(input).stats();
+      const { dominant } = await sharp20(input).stats();
       return toHex(dominant.r, dominant.g, dominant.b);
     } catch {
       return null;
@@ -8708,7 +8858,7 @@ var toHex = (r, g, b) => "#" + [r, g, b].map(
 
 // src/routes/scenes.ts
 function registerSceneRoutes(app, deps) {
-  const { templatesRoot, scenes } = deps;
+  const { templatesRoot, scenes, thumbs } = deps;
   const previewPath = (id) => contentFile(templatesRoot, "previews", `${id}.jpg`);
   const previewColors = /* @__PURE__ */ new Map();
   const previewColor = async (id) => {
@@ -8731,7 +8881,8 @@ function registerSceneRoutes(app, deps) {
   app.get("/api/scene-thumbnails/:file", async (req, reply) => {
     const m = /^([a-z0-9-]+)\.jpg$/.exec(String(req.params.file));
     if (!m || !existsSync(previewPath(m[1]))) return reply.status(404).send({ error: "no preview" });
-    return serveJpeg(req, reply, previewPath(m[1]));
+    const path = previewPath(m[1]);
+    return serveJpegSized(req, reply, path, thumbs, fileKey("scene", m[1], path));
   });
   const refPath = (id, slot) => contentFile(templatesRoot, "previews", id, `${slot}.jpg`);
   app.get("/api/scene-previews/:id", async (req, reply) => {
@@ -8749,7 +8900,7 @@ function registerSceneRoutes(app, deps) {
   });
 }
 function registerPresenterRoutes(app, deps) {
-  const { templatesRoot, presenters } = deps;
+  const { templatesRoot, presenters, thumbs } = deps;
   const presenterThumbPath = (id) => contentFile(templatesRoot, "previews", "presenters", `${id}.jpg`);
   const avatarPath = (id) => presenterAvatarPath(templatesRoot, id);
   const decoratePresenter = (p) => ({
@@ -8766,12 +8917,14 @@ function registerPresenterRoutes(app, deps) {
   app.get("/api/presenter-thumbnails/:file", async (req, reply) => {
     const m = /^([a-z0-9-]+)\.jpg$/.exec(String(req.params.file));
     if (!m || !existsSync(presenterThumbPath(m[1]))) return reply.status(404).send({ error: "no preview" });
-    return serveJpeg(req, reply, presenterThumbPath(m[1]));
+    const path = presenterThumbPath(m[1]);
+    return serveJpegSized(req, reply, path, thumbs, fileKey("presenter", m[1], path));
   });
   app.get("/api/presenter-avatars/:file", async (req, reply) => {
     const m = /^([a-z0-9-]+)\.jpg$/.exec(String(req.params.file));
     if (!m || !existsSync(avatarPath(m[1]))) return reply.status(404).send({ error: "no avatar" });
-    return serveJpeg(req, reply, avatarPath(m[1]));
+    const path = avatarPath(m[1]);
+    return serveJpegSized(req, reply, path, thumbs, fileKey("avatar", m[1], path));
   });
   app.get("/api/presenter-previews/:id", async (req, reply) => {
     const id = /^[a-z0-9-]+$/.exec(String(req.params.id))?.[0];
@@ -9085,7 +9238,7 @@ async function withDerivedCrops(core, body, base) {
   };
 }
 function registerDemoProductRoutes(app, deps) {
-  const { templatesRoot, demoProducts, demoProductById } = deps;
+  const { templatesRoot, demoProducts, demoProductById, thumbs } = deps;
   const demoProductThumbPath = (id) => {
     const p = demoProductById(id);
     if (!p) return null;
@@ -9111,9 +9264,10 @@ function registerDemoProductRoutes(app, deps) {
   }));
   app.get("/api/demo-product-thumbnails/:file", async (req, reply) => {
     const m = /^([a-z0-9-]+)\.jpg$/.exec(String(req.params.file));
-    const path = m ? demoProductThumbPath(m[1]) : null;
+    if (!m) return reply.status(404).send({ error: "no preview" });
+    const path = demoProductThumbPath(m[1]);
     if (!path || !existsSync(path)) return reply.status(404).send({ error: "no preview" });
-    return serveJpeg(req, reply, path);
+    return serveJpegSized(req, reply, path, thumbs, fileKey("demo", m[1], path));
   });
   app.get("/api/demo-product-previews/:id", async (req, reply) => {
     const id = /^[a-z0-9-]+$/.exec(String(req.params.id))?.[0];
@@ -9354,22 +9508,6 @@ function registerCodexSetupRoutes(app, deps) {
     }
   });
 }
-var EXPORT_PRESETS = [
-  { id: "original", label: "Original", width: null, height: null },
-  { id: "ig-post", label: "Instagram post 1080\xD71080", width: 1080, height: 1080 },
-  { id: "ig-story", label: "Story 1080\xD71920", width: 1080, height: 1920 },
-  { id: "banner", label: "Banner 1200\xD7628", width: 1200, height: 628 }
-];
-async function buildExportZip(image, baseName, presetIds) {
-  const zip = new JSZip();
-  const chosen = EXPORT_PRESETS.filter((p) => presetIds.includes(p.id));
-  if (chosen.length === 0) throw new Error("No valid export presets selected");
-  for (const p of chosen) {
-    const buf = p.width && p.height ? await sharp21(image).resize(p.width, p.height, { fit: "cover", position: "attention" }).png().toBuffer() : image;
-    zip.file(`${baseName}-${p.id}.png`, buf);
-  }
-  return zip.generateAsync({ type: "nodebuffer" });
-}
 var slug = (v, fallback) => {
   const s = String(v ?? "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 40);
   return s || fallback;
@@ -9511,96 +9649,6 @@ function readme(json, missing) {
 ${missing} referenced image${missing === 1 ? " was" : "s were"} missing and left out.` : ""
   ].join("\n");
 }
-var THUMB_WIDTHS = [640, 160];
-var isThumbWidth = (w) => THUMB_WIDTHS.includes(w);
-var QUALITY = { 640: 82, 160: 75 };
-function createThumbStore(core, opts = {}) {
-  const dir = join(core.home, "thumbs");
-  let enabled = true;
-  try {
-    mkdirSync(dir, { recursive: true, mode: 448 });
-  } catch {
-    enabled = false;
-  }
-  const pathFor = (hash, w) => join(dir, `${hash}-w${w}.webp`);
-  const inflight = /* @__PURE__ */ new Map();
-  const failed = /* @__PURE__ */ new Set();
-  const concurrency = Math.max(1, opts.concurrency ?? 2);
-  let active = 0;
-  const waiting = [];
-  const acquire = () => new Promise((resolve) => {
-    if (active < concurrency) {
-      active++;
-      resolve();
-    } else waiting.push(resolve);
-  });
-  const release = () => {
-    const next = waiting.shift();
-    if (next) next();
-    else active--;
-  };
-  async function make(hash, w) {
-    const final = pathFor(hash, w);
-    const tmp = `${final}.${process.pid}.${Math.random().toString(36).slice(2, 8)}.tmp`;
-    await acquire();
-    try {
-      await sharp21(core.images.pathFor(hash)).resize({ width: w, withoutEnlargement: true }).webp({ quality: QUALITY[w], effort: 4 }).toFile(tmp);
-      await rename(tmp, final);
-      return final;
-    } catch {
-      await unlink(tmp).catch(() => {
-      });
-      failed.add(`${hash}-w${w}`);
-      return null;
-    } finally {
-      release();
-    }
-  }
-  return {
-    dir,
-    async ensure(hash, w) {
-      if (!enabled || !/^[a-f0-9]{32}$/.test(hash)) return null;
-      const key = `${hash}-w${w}`;
-      if (failed.has(key)) return null;
-      const final = pathFor(hash, w);
-      try {
-        await access(final);
-        return final;
-      } catch {
-      }
-      let job = inflight.get(key);
-      if (!job) {
-        job = make(hash, w).finally(() => inflight.delete(key));
-        inflight.set(key, job);
-      }
-      return job;
-    },
-    warm(hash) {
-      for (const w of THUMB_WIDTHS) void this.ensure(hash, w);
-    },
-    async settle() {
-      await Promise.allSettled([...inflight.values()]);
-    },
-    clear() {
-      failed.clear();
-      rmSync(dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
-      try {
-        mkdirSync(dir, { recursive: true, mode: 448 });
-      } catch {
-        enabled = false;
-      }
-    },
-    stream: (path) => createReadStream(path)
-  };
-}
-async function fileSize(path) {
-  try {
-    const s = await stat(path);
-    return s.isFile() ? s.size : null;
-  } catch {
-    return null;
-  }
-}
 
 // src/routes/images.ts
 var IMMUTABLE = "public, max-age=31536000, immutable";
@@ -9621,7 +9669,7 @@ function registerImageRoutes(app, deps) {
   app.get("/api/images/:hash/thumb", async (req, reply) => {
     const hash = String(req.params.hash);
     const w = Number(req.query?.w);
-    if (!isThumbWidth(w)) return reply.status(400).send({ error: "w must be 640 or 160" });
+    if (!isThumbWidth(w)) return reply.status(400).send({ error: `w must be one of ${THUMB_WIDTH_LIST}` });
     if (!/^[a-f0-9]{32}$/.test(hash)) return reply.status(404).send({ error: "image not found" });
     const etag = `"${hash}-w${w}"`;
     if (req.headers["if-none-match"] === etag) return reply.status(304).header("cache-control", IMMUTABLE).send();
@@ -9639,8 +9687,8 @@ function registerImageRoutes(app, deps) {
     if (!part) return reply.status(400).send({ error: "multipart file field required" });
     const buf = await part.toBuffer();
     if (buf.length === 0) return reply.status(400).send({ error: "empty file" });
-    const fmt = (await sharp21(buf).metadata().catch(() => null))?.format;
-    const png = fmt === "svg" ? await toMarkPng(buf) : await sharp21(buf).rotate().png().toBuffer();
+    const fmt = (await sharp20(buf).metadata().catch(() => null))?.format;
+    const png = fmt === "svg" ? await toMarkPng(buf) : await sharp20(buf).rotate().png().toBuffer();
     return { hash: core.images.save(png) };
   });
   app.post("/api/diff", async (req, reply) => {
@@ -9651,7 +9699,6 @@ function registerImageRoutes(app, deps) {
     const heatmapHash = core.images.save(d.heatmap);
     return { score: d.score, heatmapHash, width: d.width, height: d.height };
   });
-  app.get("/api/export/presets", async () => EXPORT_PRESETS);
   app.get("/api/brands/:id/export", async (req, reply) => {
     const brandId = String(req.params.id);
     if (!core.store.getBrand(brandId)) return reply.status(404).send({ error: "brand not found" });
@@ -9659,22 +9706,32 @@ function registerImageRoutes(app, deps) {
     reply.header("content-type", "application/zip").header("content-disposition", `attachment; filename="${filename}"`);
     return reply.send(zip);
   });
-  app.post("/api/export", async (req, reply) => {
-    const { imageHash, presets, baseName = "scenri-export" } = req.body;
-    if (!core.images.has(String(imageHash))) return reply.status(404).send({ error: "image not found" });
-    const safeBase = String(baseName).replace(/[^a-zA-Z0-9_-]+/g, "-").slice(0, 60) || "export";
-    const zip = await buildExportZip(
-      core.images.read(String(imageHash)),
-      safeBase,
-      Array.isArray(presets) ? presets.map(String) : []
-    );
-    reply.header("content-type", "application/zip").header("content-disposition", `attachment; filename="${safeBase}.zip"`);
-    return reply.send(zip);
-  });
 }
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.8.3",
+    date: "2026-09-06",
+    sections: [
+      {
+        heading: "Create",
+        body: "The + beside the prompt is a picker for adding to the shot: products, presenters, scenes, brand colours, your logo and finished shots in one grid, with search, Upload image and paste. A tile pressed again takes its chip out, and every tab can make a new one of its own."
+      },
+      {
+        heading: "Shots",
+        body: "An open shot has the rest of the feed beside it as a rail, and its own history under the picture as a trail of tiles, the original and each refinement. A right click on the picture holds its actions, Download is one click, and Compare is gone."
+      },
+      {
+        heading: "Refine",
+        body: "Refining is the ask alone. The field names the picture it is about and follows the stage as you step, and a refinement is recorded as what you asked, not the references that rode along."
+      },
+      {
+        heading: "Scenes",
+        body: "A scene with nobody attached renders its set alone. No stand-in person appears."
+      }
+    ]
+  },
   {
     version: "0.8.2",
     date: "2026-09-03",
@@ -10618,7 +10675,7 @@ function buildServer(opts) {
       // Measured as stored (post-toMarkPng), so the scrape judges the same
       // pixels the compiler will one day attach.
       probeLongEdge: async (buf) => {
-        const m = await sharp21(await toMarkPng(buf)).metadata();
+        const m = await sharp20(await toMarkPng(buf)).metadata();
         return Math.max(m.width ?? 0, m.height ?? 0) || null;
       },
       createdWith: `${meta.name}/${meta.version}`
@@ -10707,7 +10764,7 @@ function buildServer(opts) {
       fetchImpl: opts.fetchImpl,
       saveAsset: async (buf) => `asset:${core.images.save(await toMarkPng(buf))}`,
       probeLongEdge: async (buf) => {
-        const m = await sharp21(await toMarkPng(buf)).metadata();
+        const m = await sharp20(await toMarkPng(buf)).metadata();
         return Math.max(m.width ?? 0, m.height ?? 0) || null;
       },
       createdWith: `${meta.name}/${meta.version}`
@@ -10802,14 +10859,14 @@ function buildServer(opts) {
   });
   registerCatalogImportRoutes(app, { core, fetchImpl: opts.fetchImpl });
   const templatesRoot = opts.templatesDir ?? defaultScenesDir();
-  registerSceneRoutes(app, { templatesRoot, scenes });
+  registerSceneRoutes(app, { templatesRoot, scenes, thumbs });
   const presentersDir = join(templatesRoot, "presenters");
   const { presenters } = loadPresenters(presentersDir);
-  registerPresenterRoutes(app, { templatesRoot, presenters });
+  registerPresenterRoutes(app, { templatesRoot, presenters, thumbs });
   registerAssetBuildRoutes(app, { core, engines, analyzer: opts.analyzer, scenes, presenters });
   const { demoProducts } = loadDemoProducts(join(templatesRoot, "demo-products"));
   const demoProductById = demoProductResolver(demoProducts);
-  registerDemoProductRoutes(app, { templatesRoot, demoProducts, demoProductById });
+  registerDemoProductRoutes(app, { templatesRoot, demoProducts, demoProductById, thumbs });
   registerShowcaseRoutes(app, { templatesRoot });
   app.get("/api/formats", async () => FORMATS);
   function briefInputsOnly(brief) {
@@ -11080,11 +11137,11 @@ function buildServer(opts) {
     const out = [];
     for (const h of images) {
       const buf = core.images.read(h);
-      const meta2 = await sharp21(buf).metadata().catch(() => null);
+      const meta2 = await sharp20(buf).metadata().catch(() => null);
       if (!meta2?.width || !meta2.height) throw new Error("engine returned an undecodable image");
       const oriented = (meta2.orientation ?? 1) !== 1;
       out.push(
-        buf.subarray(0, 8).equals(PNG_SIG) && !oriented ? h : core.images.save(await sharp21(buf).rotate().png().toBuffer())
+        buf.subarray(0, 8).equals(PNG_SIG) && !oriented ? h : core.images.save(await sharp20(buf).rotate().png().toBuffer())
       );
     }
     return out;
@@ -11096,7 +11153,7 @@ function buildServer(opts) {
       const out = [];
       for (const h of images) {
         const buf = core.images.read(h);
-        const meta2 = await sharp21(buf).metadata();
+        const meta2 = await sharp20(buf).metadata();
         if (!meta2.width || !meta2.height) {
           out.push(h);
           continue;
@@ -11109,7 +11166,7 @@ function buildServer(opts) {
         }
         const w = got > target ? Math.round(meta2.height * target) : meta2.width;
         const hpx = got > target ? meta2.height : Math.round(meta2.width / target);
-        const cropped = await sharp21(buf).resize(w, hpx, { fit: "cover", position: "attention" }).png().toBuffer();
+        const cropped = await sharp20(buf).resize(w, hpx, { fit: "cover", position: "attention" }).png().toBuffer();
         app.log.info(
           { nodeId, got: `${meta2.width}x${meta2.height}`, want: `${w}x${hpx}` },
           "canvas: cropped a drifted frame to the asked ratio"
@@ -11128,7 +11185,7 @@ function buildServer(opts) {
   async function assertAspect(images, expect) {
     const want = expect.width / expect.height;
     for (const h of images) {
-      const meta2 = await sharp21(core.images.read(h)).metadata();
+      const meta2 = await sharp20(core.images.read(h)).metadata();
       if (!meta2.width || !meta2.height) continue;
       const got = meta2.width / meta2.height;
       if (Math.abs(got - want) / want > ASPECT_TOLERANCE)
@@ -11159,7 +11216,7 @@ function buildServer(opts) {
         if (post) own = await post(own);
         if (expect) await assertAspect(own, expect);
         try {
-          const meta2 = await sharp21(core.images.read(own[0])).metadata();
+          const meta2 = await sharp20(core.images.read(own[0])).metadata();
           const node = core.store.getNode(id);
           if (node && meta2.width && meta2.height) {
             const brief = node.brief ?? {};
@@ -11268,7 +11325,7 @@ function buildServer(opts) {
         crop: window
       });
       const work2 = async () => ({
-        images: [core.images.save(await sharp21(args.srcBuf).extract(window).png().toBuffer())],
+        images: [core.images.save(await sharp20(args.srcBuf).extract(window).png().toBuffer())],
         costUsd: 0
       });
       void runNode([node2.id], null, 0, work2, { width: plan2.width, height: plan2.height }).catch(
@@ -11293,7 +11350,7 @@ function buildServer(opts) {
       if (!srcHash || !core.images.has(String(srcHash)))
         return reply.status(400).send({ error: "edit needs a parent node with an image (sourceImage)" });
       const srcBuf = core.images.read(String(srcHash));
-      const srcMeta = await sharp21(srcBuf).metadata();
+      const srcMeta = await sharp20(srcBuf).metadata();
       if (!srcMeta.width || !srcMeta.height) return reply.status(400).send({ error: "source image unreadable" });
       return runCropNode({
         parentId: cropParentId,
@@ -11342,7 +11399,7 @@ function buildServer(opts) {
         );
         extraWarnings.push(...edit.warnings.filter((w) => !compiled2?.warnings.includes(w)));
         if (!compiled2.prompt.trim() && reshape !== "extend")
-          return reply.status(400).send({ error: "the brief is empty" });
+          return reply.status(400).send({ error: "the prompt is empty" });
       } else {
         const brandJson = await brandJsonWithIdentityCrops(
           core,
@@ -11370,7 +11427,7 @@ function buildServer(opts) {
           template: brief.templateId ? sceneById(String(brief.templateId)) : void 0,
           templateById: sceneById
         });
-        if (!compiled2.prompt.trim()) return reply.status(400).send({ error: "the brief is empty" });
+        if (!compiled2.prompt.trim()) return reply.status(400).send({ error: "the prompt is empty" });
       }
     }
     let finalPrompt = String(prompt ?? "");
@@ -11409,7 +11466,7 @@ function buildServer(opts) {
       });
       if (productId && !compiled2.attachments.some((a) => a.role === "product"))
         return reply.status(400).send({ error: "product has no usable shots" });
-      if (!compiled2.prompt.trim()) return reply.status(400).send({ error: "the brief is empty" });
+      if (!compiled2.prompt.trim()) return reply.status(400).send({ error: "the prompt is empty" });
     }
     let estimate;
     let work;
@@ -11508,7 +11565,7 @@ function buildServer(opts) {
         );
       }
       const srcBuf = core.images.read(String(srcHash));
-      const srcMeta = await sharp21(srcBuf).metadata();
+      const srcMeta = await sharp20(srcBuf).metadata();
       if (srcMeta.width && srcMeta.height) expectShape = { width: srcMeta.width, height: srcMeta.height };
       const parentFormat = parent?.brief?.tokens?.find((t) => t?.t === "format");
       const parentNominal = parentFormat && Number(parentFormat.w) > 0 && Number(parentFormat.h) > 0 ? { width: Number(parentFormat.w), height: Number(parentFormat.h) } : null;
@@ -11542,7 +11599,7 @@ function buildServer(opts) {
         } else if (decision.op === "extend") {
           if (decision.assist) {
             expandAssist = { width: decision.assist.width, height: decision.assist.height };
-            workBuf = await sharp21(srcBuf).extract(decision.assist).png().toBuffer();
+            workBuf = await sharp20(srcBuf).extract(decision.assist).png().toBuffer();
             workSize = { width: decision.assist.width, height: decision.assist.height };
           }
           expandPlan = planExpand(workSize, targetRatio);
@@ -11563,7 +11620,7 @@ function buildServer(opts) {
         const fit = fitExpandToBudget(expandPlan, workSize, runEngine.capabilities().editPixelBudget);
         if (fit.scale < 1) {
           expandPlan = fit.plan;
-          workBuf = await sharp21(workBuf).resize(fit.source.width, fit.source.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer();
+          workBuf = await sharp20(workBuf).resize(fit.source.width, fit.source.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer();
           workSize = fit.source;
           extraWarnings.push(
             `${runEngine.capabilities().displayName} draws about ${((runEngine.capabilities().editPixelBudget ?? 0) / 1e6).toFixed(1)} megapixels, so this shape continues as a ${fit.plan.width}x${fit.plan.height} frame with the photograph riding inside it at ${fit.source.width}x${fit.source.height}. Nothing is upscaled; the stored size is the size the engine truly drew.`
@@ -11586,7 +11643,7 @@ function buildServer(opts) {
       if (editPixelBudget && stepped && (stepped.width !== srcMeta.width || stepped.height !== srcMeta.height)) {
         sentSize = stepped;
         budgetSourceHash = core.images.save(
-          await sharp21(srcBuf).resize(sentSize.width, sentSize.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer()
+          await sharp20(srcBuf).resize(sentSize.width, sentSize.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer()
         );
         if (!gradeOnlyAsk)
           extraWarnings.push(
@@ -11726,11 +11783,11 @@ function buildServer(opts) {
     const original = editedFrom ? core.images.read(editedFrom) : null;
     const localScope = kind === "edit" && !plan && editScope === "local" && original;
     const enforceEditCanvas = async (images) => {
-      const srcMeta = await sharp21(original).metadata();
+      const srcMeta = await sharp20(original).metadata();
       if (!srcMeta.width || !srcMeta.height) return images;
       const out = [];
       for (const h of images) {
-        const meta2 = await sharp21(core.images.read(h)).metadata();
+        const meta2 = await sharp20(core.images.read(h)).metadata();
         const got = { width: meta2.width ?? 0, height: meta2.height ?? 0 };
         const verdict = judgeEditSize({ width: srcMeta.width, height: srcMeta.height }, got, {
           pixelBudget: runEngine.capabilities().editPixelBudget
@@ -11760,7 +11817,7 @@ function buildServer(opts) {
           );
           out.push(
             core.images.save(
-              await sharp21(core.images.read(h)).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).png().toBuffer()
+              await sharp20(core.images.read(h)).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).png().toBuffer()
             )
           );
           try {
@@ -11782,7 +11839,7 @@ function buildServer(opts) {
       const out = [];
       for (const h of images) {
         const answer = core.images.read(h);
-        const got = await sharp21(answer).metadata();
+        const got = await sharp20(answer).metadata();
         if (got.width !== plan.width || got.height !== plan.height)
           app.log.info(
             { nodeId: node.id, got: `${got.width}x${got.height}`, want: `${plan.width}x${plan.height}` },
@@ -12118,8 +12175,8 @@ async function verify() {
     const db = new Database2(":memory:");
     db.pragma("user_version");
     db.close();
-    const { default: sharp22 } = await import('sharp');
-    await sharp22({ create: { width: 1, height: 1, channels: 3, background: "#000" } }).png().toBuffer();
+    const { default: sharp21 } = await import('sharp');
+    await sharp21({ create: { width: 1, height: 1, channels: 3, background: "#000" } }).png().toBuffer();
     console.log(JSON.stringify({ ok: true, version: readMeta().version }));
   } catch (err) {
     console.log(JSON.stringify({ ok: false, error: String(err?.message ?? err) }));