scenri 0.9.4 → 0.10.0

package/dist/serve.js

@@ -1,6 +1,6 @@
 import { createUpdateChecker, classify, isReleaseTriplet, findNpm, stageVersion } from './chunk-FYQ5BAFA.js';
 import { shouldAdoptRunning, anotherScenriLines, portBusyLines } from './chunk-CMLJGPYC.js';
-import { SchemaTooNewError, createCore, BUDGET_EXHAUSTED, SpendCapError, budgetSize, EDIT_REFERENCE_ROLE_DIRECTIVE, REFERENCE_ROLE_DIRECTIVE, ratioLabel, searchTerms, termMatches, SCHEMA_VERSION, ASPECT_TOLERANCE } from './chunk-3ZRMKVBB.js';
+import { SchemaTooNewError, createCore, BUDGET_EXHAUSTED, SpendCapError, budgetSize, EDIT_REFERENCE_ROLE_DIRECTIVE, REFERENCE_ROLE_DIRECTIVE, ratioLabel, searchTerms, termMatches, SCHEMA_VERSION, ASPECT_TOLERANCE } from './chunk-WORM6GB3.js';
 import { detectInstallKind } from './chunk-PAIAXRAC.js';
 export { detectInstallKind } from './chunk-PAIAXRAC.js';
 import { readMeta, repoSlug } from './chunk-Y3ZPBPLP.js';
@@ -1238,6 +1238,15 @@ function createRunner(opts = {}) {
   }
   return { run: run2, withWorkDir, probe, invalidateProbe, connect, invalidateConnection, noteConnection };
 }
+var PHOTO_VIEWS = [
+  "portrait",
+  "front",
+  "three-quarter",
+  "back",
+  "left",
+  "right",
+  "other"
+];
 var OUT_FILE = "analysis.json";
 function createCodexAnalyzer(opts = {}) {
   const runner = opts.runner ?? createRunner(opts);
@@ -1289,7 +1298,10 @@ function presenterBody(req, refCount) {
   const same = refCount > 1 ? " Every attached photograph is the same person." : "";
   const ask = req.instruction ? ` The person who supplied these adds: ${req.instruction}.` : "";
   const categories = req.vocabulary?.categories?.length ? ` Choose "suitableCategories" only from this list: ${req.vocabulary.categories.join(", ")}.` : "";
-  return `These are photographs of one person, supplied by the person casting them.${same}${ask} Write a casting sheet: what a photographer would need in order to recognise this person again in a different shot. Do not name, identify, or guess who this person is, and do not use any proper name anywhere in your answer. Describe the person, not the photograph: their build, face and hair belong to them, but the background, crop, pose, clothing and lighting of these pictures belong to a shoot and must be left out. ${OUT_FILE} must be a JSON object with exactly these keys: "promptName": a short noun phrase a generator can be handed, such as "a woman in her early thirties with dark shoulder-length waves"; "presentation": either "woman" or "man"; "descriptor": a three-beat casting caption joined by " \xB7 ", such as "Warm editorial \xB7 dark waves \xB7 composed"; "ageRange": an approximate range such as "early 30s"; "hair": colour, length, texture and how it is worn; "identityNotes": one paragraph naming the two or three features that must survive every generation, drawn from face shape, eyes, nose, mouth, jaw, skin, distinctive marks, and build where it is visible; "negativeConstraints": an array of short refusals for the drift these photographs invite, such as "no youth-smoothing that erases the natural lines"; "suitableCategories": the industries this person would be cast for.${categories} "coverage": an array of at most two short sentences naming a view that is missing and would make this person more consistent, such as "A three-quarter photo would pin the cheekbones down." Use an empty array when the coverage is already good.`;
+  return `These are photographs of one person, supplied by the person casting them.${same}${ask} Write a casting sheet: what a photographer would need in order to recognise this person again in a different shot. Do not name, identify, or guess who this person is, and do not use any proper name anywhere in your answer. Describe the person, not the photograph: their build, face and hair belong to them, but the background, crop, pose, clothing and lighting of these pictures belong to a shoot and must be left out. ${OUT_FILE} must be a JSON object with exactly these keys: "promptName": a short noun phrase a generator can be handed, such as "a woman in her early thirties with dark shoulder-length waves"; "presentation": either "woman" or "man"; "descriptor": a three-beat casting caption joined by " \xB7 ", such as "Warm editorial \xB7 dark waves \xB7 composed"; "ageRange": an approximate range such as "early 30s"; "hair": colour, length, texture and how it is worn; "identityNotes": one paragraph naming the two or three features that must survive every generation, drawn from face shape, eyes, nose, mouth, jaw, skin, distinctive marks, and build where it is visible; "negativeConstraints": an array of short refusals for the drift these photographs invite, such as "no youth-smoothing that erases the natural lines"; "suitableCategories": the industries this person would be cast for.${categories} "coverage": an array of at most two short sentences naming a view that is missing and would make this person more consistent, such as "A three-quarter photo would pin the cheekbones down." Use an empty array when the coverage is already good; "facial": bone structure in words, the face shape, jaw, cheekbones, eyes and brows a photographer would need to recognise them again; "skin": their skin tone and texture exactly as the photographs show it, never smoothed; "build": their body type and proportions where the photographs show them.` + (req.classifyPhotos ? photosClause(refCount) : "");
+}
+function photosClause(refCount) {
+  return ` Also write "photos": an array with one entry per attached image in attachment order (ref-1.png is index 0, up to index ${Math.max(0, refCount - 1)}), each an object {"index", "view", "usable", "note"}, where "view" is exactly one of "portrait" (head and shoulders, the face large and facing the camera), "front" (full length, standing, facing the camera), "three-quarter" (turned about forty-five degrees, both eyes visible), "back" (full length, facing away from the camera), "left" (full length, the left side of the body to the camera), "right" (full length, the right side of the body to the camera), or "other"; "usable" is true only when the image is sharp, evenly lit, unobstructed, and shows this person clearly enough to stand in as that view; "note" is a few words on why. If the photographs appear to show more than one person, also write "conflict": one sentence saying which images disagree; otherwise leave "conflict" out.`;
 }
 function sceneBody(req) {
   const ask = req.instruction ? ` The person who chose these references says what matters in them: ${req.instruction}. Treat that as the deciding word: whatever it calls essential IS essential even if only one reference shows it, and whatever it tells you to ignore stays out even if every reference contains it.` : "";
@@ -1332,10 +1344,34 @@ function parsePresenter(req, o) {
       identityNotes: cap(identityNotes, 900),
       negativeConstraints: list(o.negativeConstraints, 6, 160),
       suitableCategories: pick(o.suitableCategories, req.vocabulary?.categories, 6),
-      coverage: list(o.coverage, 2, 160)
+      coverage: list(o.coverage, 2, 160),
+      // Non-blocking, like scene's `camera`: a model that omits or fumbles
+      // these must not burn the single retry that exists for a broken contract.
+      ...optional("facial", cap(str(o.facial), 300)),
+      ...optional("skin", cap(str(o.skin), 200)),
+      ...optional("build", cap(str(o.build), 200)),
+      ...req.classifyPhotos ? optional("photos", photoFilings(o.photos, req.imagePaths.length)) : {},
+      ...req.classifyPhotos ? optional("conflict", cap(str(o.conflict), 200)) : {}
     }
   };
 }
+function optional(key, value) {
+  return value === void 0 || value === "" || Array.isArray(value) && value.length === 0 ? {} : { [key]: value };
+}
+function photoFilings(raw, count) {
+  if (!Array.isArray(raw)) return void 0;
+  const out = [];
+  for (const row of raw) {
+    if (!row || typeof row !== "object") continue;
+    const r = row;
+    const index = Number(r.index);
+    if (!Number.isInteger(index) || index < 0 || index >= count) continue;
+    const view = PHOTO_VIEWS.includes(str(r.view).toLowerCase()) ? str(r.view).toLowerCase() : "other";
+    const usable2 = r.usable === true || /^(true|yes)$/i.test(str(r.usable));
+    out.push({ index, view, usable: usable2, note: cap(str(r.note), 160) });
+  }
+  return out.length ? out : void 0;
+}
 function parseScene(req, o) {
   const problems = [];
   const prompt = str(o.prompt);
@@ -1839,9 +1875,13 @@ function demoOptionsFromEnv(env) {
   const out = {};
   const stagger = Number(env.SCENRI_DEMO_STAGGER_MS);
   if (env.SCENRI_DEMO_STAGGER_MS && Number.isFinite(stagger) && stagger > 0) out.staggerMs = stagger;
+  const delay = Number(env.SCENRI_DEMO_DELAY_MS);
+  if (env.SCENRI_DEMO_DELAY_MS && Number.isFinite(delay) && delay > 0) out.delayMs = delay;
   if (env.SCENRI_DEMO_ORDER === "reverse") out.order = "reverse";
-  const fail = Number(env.SCENRI_DEMO_FAIL_SLOT);
-  if (env.SCENRI_DEMO_FAIL_SLOT && Number.isInteger(fail) && fail >= 0) out.failSlot = fail;
+  const fail2 = Number(env.SCENRI_DEMO_FAIL_SLOT);
+  if (env.SCENRI_DEMO_FAIL_SLOT && Number.isInteger(fail2) && fail2 >= 0) out.failSlot = fail2;
+  const refs = Number(env.SCENRI_DEMO_REFS);
+  if (env.SCENRI_DEMO_REFS && Number.isInteger(refs) && refs > 0) out.maxReferenceImages = refs;
   return out;
 }
 function sleep2(ms, signal) {
@@ -1894,7 +1934,7 @@ function createDemoEngine(saveImage, opts = {}) {
         // development and in the end-to-end suite. `placeholder` below is what
         // says none of this is a real picture.
         supportsOutpaint: true,
-        maxReferenceImages: 0,
+        maxReferenceImages: opts.maxReferenceImages ?? 0,
         placeholder: true
       };
     },
@@ -1912,6 +1952,7 @@ function createDemoEngine(saveImage, opts = {}) {
       const landed = /* @__PURE__ */ new Map();
       const failures = [];
       for (const [position, slot] of slots.entries()) {
+        if (opts.delayMs) await sleep2(opts.delayMs, signal);
         if (position > 0 && opts.staggerMs) await sleep2(opts.staggerMs, signal);
         if (signal?.aborted) {
           if (signal.reason === BUDGET_EXHAUSTED) break;
@@ -1921,7 +1962,9 @@ function createDemoEngine(saveImage, opts = {}) {
           failures.push(`demo: slot ${slot + 1} refused`);
           continue;
         }
-        const hash = saveImage(await render(colors, req.prompt, req.width, req.height, slot + req.prompt.length));
+        const refs = req.referenceImages?.length ?? 0;
+        const label = refs ? `refs=${refs} ${req.prompt}` : req.prompt;
+        const hash = saveImage(await render(colors, label, req.width, req.height, slot + req.prompt.length));
         landed.set(slot, hash);
         onImage?.(slot, hash);
       }
@@ -1943,6 +1986,30 @@ function createDemoEngine(saveImage, opts = {}) {
     }
   };
 }
+function createDemoAnalyzer(opts = {}) {
+  const rejects = opts.photos === "unusable";
+  const filing = (i) => ({
+    index: i,
+    view: rejects || i > 0 ? "other" : "portrait",
+    usable: !rejects,
+    note: rejects ? "too unclear to read a face from" : "sharp enough"
+  });
+  return {
+    isAvailable: async () => ({ ok: true }),
+    analyze: async (req) => ({
+      promptName: "a person in their thirties",
+      presentation: "woman",
+      descriptor: "Demo read",
+      ageRange: "30s",
+      hair: "dark hair",
+      identityNotes: "read by the demo analyzer, which never looked at anything",
+      negativeConstraints: [],
+      suitableCategories: [],
+      coverage: [],
+      photos: req.imagePaths.map((_, i) => filing(i))
+    })
+  };
+}
 var SUBJECTS = /* @__PURE__ */ new Set(["product", "person", "either"]);
 var ID = /^[a-z0-9-]+$/;
 function isScene(x) {
@@ -2246,6 +2313,10 @@ var SEAT_TIER = {
   product: 0,
   character: 0,
   scene: 0,
+  // One detail of a person, behind every chip they placed: a picture of the
+  // exact glasses is worth having, and never worth the product or the face it
+  // would push out of a four-slot engine.
+  detail: 1,
   composition: 1,
   style: 2
 };
@@ -2255,8 +2326,9 @@ var ROLE_PRIORITY = {
   brand: 2,
   reference: 3,
   scene: 4,
-  composition: 5,
-  style: 6
+  detail: 5,
+  composition: 6,
+  style: 7
 };
 function allocateAttachments(attachments, cap2) {
   const max = Math.max(0, cap2);
@@ -2392,6 +2464,13 @@ function createThumbStore(core, opts = {}) {
     async settle() {
       await Promise.allSettled([...inflight.values()]);
     },
+    evict(hash) {
+      if (!/^[a-f0-9]{32}$/.test(hash)) return;
+      for (const w of THUMB_WIDTHS) {
+        failed.delete(`${hash}-w${w}`);
+        rmSync(pathFor(hash, w), { force: true });
+      }
+    },
     clear() {
       failed.clear();
       rmSync(dir, { recursive: true, force: true, maxRetries: 5, retryDelay: 100 });
@@ -2513,6 +2592,19 @@ var serveJpegSized = async (req, reply, path, thumbs, key) => {
   reply.header("content-type", "image/webp").header("cache-control", immutable).header("etag", etag).header("content-length", String(size));
   return reply.send(thumbs.stream(made));
 };
+async function pickBuildEngine(engines, opts = {}) {
+  const ordered = [...engines.all()].sort((a, b) => {
+    const rank = (e) => e.capabilities().id === "codex-cli" ? 0 : 1;
+    return rank(a) - rank(b);
+  });
+  for (const engine of ordered) {
+    const caps = engine.capabilities();
+    if (!caps.maxReferenceImages) continue;
+    if (caps.placeholder && !opts.allowPlaceholder) continue;
+    if ((await engine.isAvailable()).ok) return engine;
+  }
+  return null;
+}
 
 // src/briefDirectives.ts
 function productFidelityDirective(attached) {
@@ -2599,6 +2691,41 @@ function shotAsksForAPerson(text) {
     text
   );
 }
+function askedView(text) {
+  if (/\b(from behind|from the back|back view|walking away|rear view|seen from behind)\b/i.test(text)) return "back";
+  if (/\b(in profile|profile view|side view|from the side)\b/i.test(text)) return "profile";
+  if (/\b(three[- ]quarter|turned|over the shoulder|over-the-shoulder)\b/i.test(text)) return "three-quarter";
+  return null;
+}
+var ANSWERING_ANGLES = {
+  back: ["back"],
+  profile: ["left", "right", "left-profile", "right-profile"],
+  "three-quarter": ["three-quarter"]
+};
+function characterRefs(shots, userWords, max) {
+  const cap2 = Math.max(0, max);
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  const board = (s) => {
+    if (!s || out.length >= cap2) return;
+    const file = s.file == null ? null : String(s.file);
+    if (file !== null) {
+      if (seen.has(file)) return;
+      seen.add(file);
+    }
+    out.push(s);
+  };
+  const byAngle = (angle) => shots.find((s) => s.angle === angle);
+  board(byAngle("portrait") ?? shots[0]);
+  const asked = askedView(userWords);
+  if (asked) {
+    const answer = ANSWERING_ANGLES[asked].map(byAngle).find(Boolean);
+    board(answer);
+  }
+  board(byAngle("front"));
+  for (const s of shots) board(s);
+  return out;
+}
 function sceneFigureDirectives(opts) {
   const figure = opts.figure.trim().replace(/[.\s]+$/, "");
   if (!figure) return [];
@@ -2716,7 +2843,7 @@ function validateBrief(brief) {
   const b = brief;
   if (!b || typeof b !== "object") return ["brief must be an object"];
   if (!Array.isArray(b.tokens)) return ["brief.tokens must be an array"];
-  const str4 = (v) => typeof v === "string" && v.length > 0;
+  const str5 = (v) => typeof v === "string" && v.length > 0;
   b.tokens.forEach((raw, i) => {
     const at = `tokens[${i}]`;
     if (!raw || typeof raw !== "object") {
@@ -2729,19 +2856,19 @@ function validateBrief(brief) {
         if (typeof t.v !== "string") errors.push(`${at}.v must be a string`);
         break;
       case "product":
-        if (!str4(t.id)) errors.push(`${at}.id must be a non-empty string`);
-        if (t.angle !== void 0 && !str4(t.angle)) errors.push(`${at}.angle must be a non-empty string`);
+        if (!str5(t.id)) errors.push(`${at}.id must be a non-empty string`);
+        if (t.angle !== void 0 && !str5(t.angle)) errors.push(`${at}.angle must be a non-empty string`);
         break;
       case "character":
       case "template":
-        if (!str4(t.id)) errors.push(`${at}.id must be a non-empty string`);
+        if (!str5(t.id)) errors.push(`${at}.id must be a non-empty string`);
         break;
       case "color":
-        if (!str4(t.hex) || !/^#[0-9a-fA-F]{6}$/.test(String(t.hex))) errors.push(`${at}.hex must be a #RRGGBB color`);
+        if (!str5(t.hex) || !/^#[0-9a-fA-F]{6}$/.test(String(t.hex))) errors.push(`${at}.hex must be a #RRGGBB color`);
         break;
       case "ref":
       case "mark":
-        if (!str4(t.imageHash)) errors.push(`${at}.imageHash must be a non-empty string`);
+        if (!str5(t.imageHash)) errors.push(`${at}.imageHash must be a non-empty string`);
         if (t.t === "ref" && t.label !== void 0 && typeof t.label !== "string")
           errors.push(`${at}.label must be a string when present`);
         break;
@@ -2771,7 +2898,7 @@ function compileBrief(brief, ctx) {
   let hasPerson = false;
   let people = 0;
   let sentence = "";
-  let userWords = "";
+  const userWords = brief.tokens.map((t) => t.t === "text" ? ` ${t.v}` : "").join("");
   const append = (s) => {
     sentence += (sentence && !sentence.endsWith(" ") ? " " : "") + s;
   };
@@ -2782,7 +2909,6 @@ 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);
@@ -2833,7 +2959,11 @@ function compileBrief(brief, ctx) {
         hasPerson = true;
         people += 1;
         append(c.promptName ?? c.name);
-        const cshots = (c.shots ?? []).slice(0, CHARACTER_REF_MAX).map((s) => ({ h: assetHash2(s?.file), angle: s?.angle ? String(s.angle) : void 0 })).filter((x) => !!x.h && ctx.images.has(x.h));
+        const cshots = [];
+        for (const s of characterRefs(c.shots ?? [], userWords, CHARACTER_REF_MAX)) {
+          const h = assetHash2(s?.file);
+          if (h && ctx.images.has(h)) cshots.push({ h, ...s?.angle ? { angle: String(s.angle) } : {} });
+        }
         if (cshots.length) {
           cshots.forEach(({ h, angle }, i) => {
             attachments.push({
@@ -3571,6 +3701,50 @@ var brand_schema_default = {
           avatar: {
             $ref: "#/$defs/assetRef",
             description: "Square head-and-shoulders portrait, for surfaces that render a person small or round. Also a crop of the first shot."
+          },
+          source: {
+            enum: ["synthetic", "photos"],
+            description: "Where this person came from: made in Scenri from a description (synthetic) or built from photographs of a real person (photos). Absent on a record written before the distinction existed, which is read as photos. There is no third value: a public figure is not a source Scenri offers."
+          },
+          likeness: {
+            type: "object",
+            additionalProperties: false,
+            required: ["attestedAt", "version"],
+            properties: {
+              attestedAt: {
+                type: "string",
+                description: "When the person casting them confirmed they have permission to use this real person's likeness commercially (ISO 8601)."
+              },
+              version: { const: "v1", description: "Which wording of the confirmation was shown." }
+            },
+            description: "The likeness confirmation recorded for a person built from photographs of a real person. Never set on a synthetic person."
+          },
+          facial: {
+            type: "string",
+            description: "Bone structure in words, because full-length pictures cannot carry it: face shape, jaw, cheekbones, eyes, brows. Injected verbatim, name-prefixed."
+          },
+          skin: {
+            type: "string",
+            description: "Skin tone and texture exactly as the references show it. Injected verbatim, name-prefixed."
+          },
+          build: {
+            type: "string",
+            description: "Body type and proportions. Injected verbatim, name-prefixed."
+          },
+          revisionOf: {
+            type: "string",
+            description: "The record this one replaced: an edit that changes a picture or the identity prose is a new record, so shots made against the old one keep refining against what they were made from."
+          },
+          supersededBy: {
+            type: "string",
+            description: "The record that replaced this one. Absent on the current record; a tool lists only records without it and maps an old id to the current record through it."
+          },
+          identityEdits: {
+            type: "array",
+            items: {
+              type: "string"
+            },
+            description: `The identity-wide instructions accepted when this record's views were drawn, e.g. "shorter hair". Read after identityNotes, so later views follow the change rather than the originals.`
           }
         }
       },
@@ -4274,19 +4448,70 @@ function svgAsMark(markup, longEdge = 1024) {
 
 // ../brand-spec/src/scrapeError.ts
 var ScrapeError = class extends Error {
-  constructor(code, message, statusCode = 502) {
+  constructor(code, message, statusCode = 502, httpStatus) {
     super(message);
     this.code = code;
     this.statusCode = statusCode;
+    this.httpStatus = httpStatus;
   }
   code;
   statusCode;
+  httpStatus;
   name = "ScrapeError";
 };
+function isRefusal(err) {
+  if (!(err instanceof ScrapeError)) return false;
+  if (err.code === "timeout") return true;
+  if (err.code !== "http_status" || err.httpStatus === void 0) return false;
+  return err.httpStatus === 401 || err.httpStatus === 403 || err.httpStatus === 429 || err.httpStatus >= 500;
+}
 function urlRefusal(reason, message) {
   return new ScrapeError(`url_${reason}`, message, 400);
 }
 
+// ../brand-spec/src/hostManners.ts
+var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
+var cooledUntil = /* @__PURE__ */ new Map();
+var hostOf = (url) => {
+  try {
+    return new URL(url).host;
+  } catch {
+    return "";
+  }
+};
+async function waitForHost(host, signal) {
+  if (!host) return;
+  for (; ; ) {
+    const left = (cooledUntil.get(host) ?? 0) - Date.now();
+    if (left <= 0 || signal?.aborted) return;
+    await sleep3(Math.min(left, 250));
+  }
+}
+function coolHost(host, ms) {
+  if (!host || ms <= 0) return;
+  const until = Date.now() + ms;
+  if (until > (cooledUntil.get(host) ?? 0)) cooledUntil.set(host, until);
+}
+var RETRY_AFTER_CAP_MS = 6e4;
+function retryAfterMs(header, now = Date.now()) {
+  if (!header) return null;
+  const secs = Number(header.trim());
+  if (Number.isFinite(secs) && secs >= 0) return Math.min(secs * 1e3, RETRY_AFTER_CAP_MS);
+  const at = Date.parse(header);
+  if (Number.isNaN(at)) return null;
+  return Math.min(Math.max(0, at - now), RETRY_AFTER_CAP_MS);
+}
+function isChallenge(res) {
+  if (res.status !== 429 && res.status !== 503) return false;
+  if (res.headers.get("cf-mitigated")) return true;
+  if (res.headers.get("retry-after")) return false;
+  return /text\/html/i.test(res.headers.get("content-type") ?? "");
+}
+function throttleBackoff(attempt) {
+  const base = Math.min(1e3 * 2 ** attempt, 16e3);
+  return base + Math.floor(Math.random() * 400);
+}
+
 // ../brand-spec/src/safeFetch.ts
 var DEFAULTS = {
   budgetMs: 2e4,
@@ -4380,6 +4605,7 @@ function createGuardedFetch(opts = {}) {
         }
       }
       assertPublicHost(u.hostname, addresses, Boolean(o.allowPrivateHosts));
+      await waitForHost(u.host);
       const left = remaining();
       if (left <= 0) throw new ScrapeError("timeout", "Reading that site took too long.");
       const signal = AbortSignal.any([AbortSignal.timeout(Math.min(o.requestMs, left))]);
@@ -4409,14 +4635,24 @@ function createGuardedFetch(opts = {}) {
         continue;
       }
       if (!res.ok) {
-        if (RETRYABLE.has(res.status) && attempts < 1 && remaining() > 2e3) {
+        const refused = () => new ScrapeError("http_status", statusSentence(u.hostname, res.status, isChallenge(res)), 502, res.status);
+        if (isChallenge(res)) {
           await res.body?.cancel().catch(() => {
           });
-          await sleep3(700);
-          attempts++;
-          continue;
+          throw refused();
         }
-        throw new ScrapeError("http_status", statusSentence(u.hostname, res.status));
+        if (RETRYABLE.has(res.status)) {
+          const wait = retryAfterMs(res.headers.get("retry-after")) ?? throttleBackoff(attempts);
+          coolHost(u.host, wait);
+          if (attempts < 1 && remaining() > wait + 2e3) {
+            await res.body?.cancel().catch(() => {
+            });
+            await sleep4(wait);
+            attempts++;
+            continue;
+          }
+        }
+        throw refused();
       }
       const contentType = (res.headers.get("content-type") ?? "").toLowerCase();
       const cap2 = o[LIMIT[as]];
@@ -4437,10 +4673,10 @@ function createGuardedFetch(opts = {}) {
   return guarded;
 }
 var USER_AGENT = "scenri/0.1 (+https://scenri.co)";
-var sleep3 = (ms) => new Promise((r) => setTimeout(r, ms));
+var sleep4 = (ms) => new Promise((r) => setTimeout(r, ms));
 var RETRYABLE = /* @__PURE__ */ new Set([403, 408, 425, 429, 500, 502, 503, 504]);
-function statusSentence(host, status) {
-  if (status === 401 || status === 403)
+function statusSentence(host, status, challenged = false) {
+  if (challenged || status === 401 || status === 403)
     return `${host} would not let Scenri read it. Some sites block anything that is not a person in a browser; you can still add the logo and colours by hand.`;
   if (status === 404) return `There is no page at that address on ${host}.`;
   if (status === 429) return `${host} asked Scenri to slow down. Try again in a minute.`;
@@ -4538,7 +4774,10 @@ function unwrap(value) {
   const pairs = [
     ["<", ">"],
     ['"', '"'],
-    ["'", "'"]
+    ["'", "'"],
+    ["\u201C", "\u201D"],
+    ["\u2018", "\u2019"],
+    ["\xAB", "\xBB"]
   ];
   for (const [open, close] of pairs) {
     if (value.length >= 2 && value.startsWith(open) && value.endsWith(close)) return value.slice(1, -1).trim();
@@ -4589,7 +4828,25 @@ async function buildFromUrl(url, opts = {}) {
     ...opts.guard,
     ...opts.fetchImpl ? { fetchImpl: opts.fetchImpl, allowPrivateHosts: true } : {}
   });
-  const page = await get(normalized.url, "html");
+  let page = null;
+  let refused = null;
+  let missed = null;
+  for (const candidate of readOrder(normalized.url)) {
+    try {
+      page = await get(candidate, "html");
+      break;
+    } catch (err) {
+      if (isRefusal(err)) {
+        refused = err;
+        break;
+      }
+      missed = err;
+    }
+  }
+  if (!page) {
+    if (refused) return addressOnlyBrand(normalized.url, refused.message, opts);
+    throw missed;
+  }
   const origin = new URL(page.finalUrl);
   const $ = cheerio.load(page.text);
   const base = baseOf($, origin);
@@ -4622,11 +4879,12 @@ async function buildFromUrl(url, opts = {}) {
   const manifest = await readManifest($, base, get);
   const candidates = logoCandidates($, base, manifest);
   const picked = await downloadMark(candidates, get, opts, warnings);
+  const iconRef = await downloadIcon(candidates, get, opts, picked);
   const brand = {
     specVersion: "0.1",
     meta: {
       name: named.value,
-      slug: named.value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48) || origin.hostname,
+      slug: slugOf(named.value, origin.hostname),
       ...tagline ? { tagline } : {},
       website: origin.origin,
       createdWith: opts.createdWith ?? "scenri",
@@ -4640,13 +4898,16 @@ async function buildFromUrl(url, opts = {}) {
         ...palette.neutrals.length ? { neutrals: palette.neutrals.map((hex) => ({ hex })) } : {}
       }
     } : {},
-    ...picked.ref ? {
+    ...picked.ref || iconRef ? {
       logos: [
-        {
-          role: picked.role,
-          file: picked.ref,
-          ...picked.background ? { background: picked.background } : {}
-        }
+        ...picked.ref ? [
+          {
+            role: picked.role,
+            file: picked.ref,
+            ...picked.background ? { background: picked.background } : {}
+          }
+        ] : [],
+        ...iconRef ? [{ role: "mark", file: iconRef }] : []
       ]
     } : {}
   };
@@ -4656,6 +4917,7 @@ async function buildFromUrl(url, opts = {}) {
     report: {
       url: page.finalUrl,
       host: origin.hostname,
+      read: true,
       name: named,
       tagline: tagline ?? null,
       logo: {
@@ -4668,6 +4930,45 @@ async function buildFromUrl(url, opts = {}) {
     }
   };
 }
+function readOrder(url) {
+  try {
+    const u = new URL(url);
+    return u.pathname === "/" && !u.search ? [url] : [url, u.origin];
+  } catch {
+    return [url];
+  }
+}
+function slugOf(name, fallback) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 48) || fallback;
+}
+function addressOnlyBrand(url, reason, opts) {
+  const origin = new URL(url);
+  const name = origin.hostname.replace(/^www\./, "");
+  return {
+    brand: {
+      specVersion: "0.1",
+      meta: {
+        name,
+        slug: slugOf(name, origin.hostname),
+        website: origin.origin,
+        createdWith: opts.createdWith ?? "scenri",
+        updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+      }
+    },
+    // The first sentence is the site's own refusal, already written for a
+    // person by `statusSentence`; the second is what they can do about it.
+    warnings: [reason, "The brand was made from the address. Add the logo and colours in Settings."],
+    report: {
+      url: origin.origin,
+      host: origin.hostname,
+      read: false,
+      name: { value: name, source: "hostname" },
+      tagline: null,
+      logo: { status: "none", source: null },
+      colors: { count: 0 }
+    }
+  };
+}
 function baseOf($, origin) {
   const declared = $("base[href]").attr("href");
   if (!declared) return origin;
@@ -4765,14 +5066,9 @@ async function downloadMark(candidates, get, opts, warnings) {
   for (const candidate of candidates) {
     if (tried >= LOGO_TRIES || get.remaining() <= 0) break;
     let buf = null;
-    if (candidate.svg) {
-      const sized = svgAsMark(candidate.svg);
-      if (!sized) continue;
-      buf = Buffer.from(sized, "utf8");
-    } else if (candidate.url?.startsWith("data:")) {
-      const comma = candidate.url.indexOf(",");
-      const body = candidate.url.slice(comma + 1);
-      buf = candidate.url.slice(0, comma).includes(";base64") ? Buffer.from(body, "base64") : Buffer.from(decodeURIComponent(body), "utf8");
+    if (carriesBytes(candidate)) {
+      buf = inlineBytes(candidate);
+      if (!buf) continue;
     } else if (candidate.url) {
       tried++;
       try {
@@ -4826,6 +5122,45 @@ async function downloadMark(candidates, get, opts, warnings) {
   warnings.push("No logo captured. Add one manually.");
   return { role: "primary", source: null };
 }
+function carriesBytes(candidate) {
+  return Boolean(candidate.svg) || Boolean(candidate.url?.startsWith("data:"));
+}
+function inlineBytes(candidate) {
+  if (candidate.svg) {
+    const sized = svgAsMark(candidate.svg);
+    return sized ? Buffer.from(sized, "utf8") : null;
+  }
+  if (!candidate.url) return null;
+  const comma = candidate.url.indexOf(",");
+  const body = candidate.url.slice(comma + 1);
+  return candidate.url.slice(0, comma).includes(";base64") ? Buffer.from(body, "base64") : Buffer.from(decodeURIComponent(body), "utf8");
+}
+async function downloadIcon(candidates, get, opts, picked) {
+  if (!opts.saveAsset) return null;
+  if (picked.source && ICON_SOURCES.has(picked.source)) return null;
+  const best = candidates.find((c) => ICON_SOURCES.has(c.source) && (c.svg || c.url));
+  if (!best) return null;
+  let buf = null;
+  if (carriesBytes(best)) {
+    buf = inlineBytes(best);
+  } else if (best.url) {
+    if (get.remaining() <= 0) return null;
+    try {
+      buf = (await get(best.url, "asset")).bytes;
+    } catch {
+      return null;
+    }
+  }
+  if (!buf || buf.length === 0) return null;
+  try {
+    const ref = await opts.saveAsset(buf, "logo");
+    if (ref === picked.ref) return null;
+    const shape = opts.inspectMark ? await opts.inspectMark(buf).catch(() => null) : null;
+    return shape?.blank ? null : ref;
+  } catch {
+    return null;
+  }
+}
 
 // ../brand-spec/src/mergeScrape.ts
 var str2 = (v) => typeof v === "string" ? v.trim() : "";
@@ -4888,7 +5223,8 @@ async function inspectMark(buf, toPng2) {
 }
 
 // ../catalog/src/failures.ts
-function pageFailure(status) {
+function pageFailure(status, challenged = false) {
+  if (challenged) return "CHALLENGED";
   if (status === 429 || status === 503) return "RATE_LIMITED";
   if (status === 401 || status === 403 || status === 405) return "PAGE_BLOCKED";
   if (status === 404 || status === 410) return "PAGE_NOT_FOUND";
@@ -4910,25 +5246,34 @@ function tally(into, reason, n = 1) {
   into[reason] = (into[reason] ?? 0) + n;
 }
 function leadingReason(t) {
-  const rows = Object.entries(t);
+  const rows = Object.entries(t).filter(([, n]) => n > 0);
   if (!rows.length) return null;
   return rows.sort((a, b) => b[1] - a[1])[0][0];
 }
-function summarise(t, saved, asked) {
+function shortfall(asked, worked) {
+  return Math.max(0, asked - Math.max(0, worked));
+}
+function summarise(t, saved, asked, failedCount) {
   const reason = leadingReason(t);
   if (!reason) return null;
   const none = saved === 0;
+  const failed = Math.min(asked, failedCount ?? Math.max(0, asked - saved));
   switch (reason) {
     case "RATE_LIMITED":
-      return none ? "The store asked us to slow down, so nothing could be read. Waiting a few minutes and trying again usually works." : `The store asked us to slow down partway, so ${asked - saved} of ${asked} products were skipped. Trying again picks up the rest.`;
+      return none ? "The store asked us to slow down, so nothing could be read. Waiting a few minutes and trying again usually works." : `The store asked us to slow down partway, so ${failed} of ${asked} products were skipped. Trying again picks up the rest.`;
+    // Never "try again in a few minutes": this one does not clear with time,
+    // and saying so would be advice that cannot work.
+    case "CHALLENGED":
+      return none ? "This store checks that visitors are a web browser, so its catalogue could not be read automatically. You can still add products by hand." : `This store started checking that visitors are a web browser, so ${failed} of ${asked} products were skipped.`;
     case "PAGE_BLOCKED":
-      return none ? "This store would not let us read its product pages." : `${asked - saved} of ${asked} product pages would not open.`;
+      return none ? "This store would not let us read its product pages." : `${failed} of ${asked} product pages would not open.`;
     case "PAGE_NOT_FOUND":
-      return `${asked - saved} of ${asked} products are no longer on the site.`;
+      return `${failed} of ${asked} products are no longer on the site.`;
     case "IMAGE_FORBIDDEN":
     case "IMAGE_NOT_FOUND":
     case "IMAGE_TIMEOUT":
     case "IMAGE_EMPTY":
+    case "UNSUPPORTED_MEDIA":
     case "DOWNLOAD_FAILED":
       return none ? "We found the products, but none of their pictures could be downloaded." : "Some pictures could not be downloaded. The products they belong to are still here.";
     case "ABORTED":
@@ -4970,6 +5315,19 @@ function absolutize(base, href) {
     return null;
   }
 }
+var CARD_WIDTH = 400;
+function cardImageUrl(url, width = CARD_WIDTH) {
+  try {
+    const u = new URL(url);
+    for (const key of u.searchParams.keys()) {
+      if (/^(x-amz-|signature|sig|token|expires|policy)/i.test(key)) return url;
+    }
+    u.searchParams.set("width", String(width));
+    return u.toString();
+  } catch {
+    return url;
+  }
+}
 function upgradeImageUrl(url) {
   try {
     const u = new URL(url);
@@ -5153,43 +5511,9 @@ async function readBounded2(res, maxBytes) {
   }
   return out + decoder.decode();
 }
-function sleep4(ms) {
+function sleep5(ms) {
   return new Promise((r) => setTimeout(r, ms));
 }
-var cooledUntil = /* @__PURE__ */ new Map();
-var hostOf = (url) => {
-  try {
-    return new URL(url).host;
-  } catch {
-    return "";
-  }
-};
-async function waitForHost(host, signal) {
-  if (!host) return;
-  for (; ; ) {
-    const left = (cooledUntil.get(host) ?? 0) - Date.now();
-    if (left <= 0 || signal?.aborted) return;
-    await sleep4(Math.min(left, 250));
-  }
-}
-function coolHost(host, ms) {
-  if (!host || ms <= 0) return;
-  const until = Date.now() + ms;
-  if (until > (cooledUntil.get(host) ?? 0)) cooledUntil.set(host, until);
-}
-var RETRY_AFTER_CAP_MS = 6e4;
-function retryAfterMs(header, now = Date.now()) {
-  if (!header) return null;
-  const secs = Number(header.trim());
-  if (Number.isFinite(secs) && secs >= 0) return Math.min(secs * 1e3, RETRY_AFTER_CAP_MS);
-  const at = Date.parse(header);
-  if (Number.isNaN(at)) return null;
-  return Math.min(Math.max(0, at - now), RETRY_AFTER_CAP_MS);
-}
-function throttleBackoff(attempt) {
-  const base = Math.min(1e3 * 2 ** attempt, 16e3);
-  return base + Math.floor(Math.random() * 400);
-}
 async function httpGet(url, opts = {}) {
   const fetchImpl = opts.fetchImpl ?? fetch;
   const retries = opts.retries ?? 3;
@@ -5230,6 +5554,7 @@ async function httpGet(url, opts = {}) {
         } catch {
         }
       }
+      if (isChallenge(res)) return res;
       if (res.status === 429 || res.status === 503) {
         const asked = retryAfterMs(res.headers.get("retry-after"));
         const wait = asked ?? throttleBackoff(attempt);
@@ -5242,7 +5567,7 @@ async function httpGet(url, opts = {}) {
         return res;
       }
       if (res.status >= 500 && attempt < retries) {
-        await sleep4(throttleBackoff(attempt));
+        await sleep5(throttleBackoff(attempt));
         continue;
       }
       return res;
@@ -5250,7 +5575,7 @@ async function httpGet(url, opts = {}) {
       lastErr = err;
       if (opts.signal?.aborted) throw err;
       if (attempt < retries) {
-        await sleep4(400 * 2 ** attempt);
+        await sleep5(400 * 2 ** attempt);
         continue;
       }
       throw err;
@@ -5263,12 +5588,14 @@ async function httpGet(url, opts = {}) {
 }
 async function httpText(url, opts = {}) {
   const res = await httpGet(url, opts);
+  const challenged = isChallenge(res);
   const text = await readBounded2(res, opts.maxBytes);
-  return { ok: res.ok, status: res.status, text, url: res.url || url };
+  return { ok: res.ok, status: res.status, text, url: res.url || url, challenged };
 }
 async function httpJson(url, opts = {}) {
   const res = await httpGet(url, { ...opts, accept: opts.accept ?? "application/json" });
-  const text = await res.text();
+  const challenged = isChallenge(res);
+  const text = await readBounded2(res, opts.maxBytes ?? 16e6);
   let json = null;
   if (res.ok) {
     try {
@@ -5277,7 +5604,10 @@ async function httpJson(url, opts = {}) {
       json = null;
     }
   }
-  return { ok: res.ok && json !== null, status: res.status, json, url: res.url || url, text };
+  return { ok: res.ok && json !== null, status: res.status, json, url: res.url || url, text, challenged };
+}
+function outOfTime(deadline) {
+  return deadline != null && Date.now() > deadline;
 }
 async function mapPool(items, concurrency, fn, signal) {
   const results = new Array(items.length);
@@ -5434,6 +5764,16 @@ var PRODUCT_MARKERS = [
 var BUY_WORDS = /add to (cart|bag|basket)|buy now|add to my bag/i;
 var BUILD_ASSET = /\/_next\/static\/|\/static\/media\/|\/assets\/(icons|flags|ui)\//i;
 var NOT_A_PACKSHOT = /logo|icon|sprite|pixel|avatar|\bflags?\b|\/flags?\/|locale|country|currency|badge|payment|social/i;
+var SITE_CHROME = /login|sign-?in|account|\bcart\b|\bsearch\b|\bmenu\b|burger|newsletter|placeholder|spacer|spinner/i;
+var VECTOR = /\.svgz?(\?|#|$)/i;
+var MIN_PACKSHOT_PX = 100;
+function imageKey(url) {
+  return url.replace(/^https?:/i, "").toLowerCase();
+}
+function declaredPx(value) {
+  const n = Number(String(value ?? "").trim());
+  return Number.isFinite(n) && n > 0 ? n : null;
+}
 function looksLikeProduct(html, doc) {
   const $ = doc ?? loadHtml(html);
   for (const sel of PRODUCT_MARKERS) {
@@ -5450,17 +5790,27 @@ function looksLikeProduct(html, doc) {
 }
 function galleryImages($, pageUrl, cap2 = 12) {
   const images = [];
+  const taken = /* @__PURE__ */ new Set();
   const og = attr($.querySelector('meta[property="og:image"]'), "content");
   if (og) {
     const abs = absolutize(pageUrl, og);
-    if (abs) images.push({ url: abs, position: 0, width: null, height: null, alt: null });
+    if (abs && !VECTOR.test(abs)) {
+      images.push({ url: abs, position: 0, width: null, height: null, alt: null });
+      taken.add(imageKey(abs));
+    }
   }
   for (const el of $.querySelectorAll("img[src]")) {
     if (images.length >= cap2) break;
     const src = attr(el, "src") || attr(el, "data-src");
     const abs = src ? absolutize(pageUrl, src) : null;
     if (!abs || NOT_A_PACKSHOT.test(abs) || BUILD_ASSET.test(abs)) continue;
-    if (images.some((x) => x.url === abs)) continue;
+    if (SITE_CHROME.test(abs) || VECTOR.test(abs)) continue;
+    const w = declaredPx(attr(el, "width"));
+    const h = declaredPx(attr(el, "height"));
+    if (w !== null && w < MIN_PACKSHOT_PX || h !== null && h < MIN_PACKSHOT_PX) continue;
+    const key = imageKey(abs);
+    if (taken.has(key)) continue;
+    taken.add(key);
     images.push({ url: abs, position: images.length, width: null, height: null, alt: attr(el, "alt") ?? null });
   }
   return images;
@@ -5511,7 +5861,7 @@ function productsFromPage(html, url) {
   const one = parseProductHtml(html, url, doc);
   return one ? [one] : [];
 }
-var sleep5 = (ms) => new Promise((r) => setTimeout(r, ms));
+var sleep6 = (ms) => new Promise((r) => setTimeout(r, ms));
 async function fetchProductPages(ctx, urls, opts = {}) {
   const out = [];
   const seen = /* @__PURE__ */ new Set();
@@ -5531,8 +5881,8 @@ async function fetchProductPages(ctx, urls, opts = {}) {
       if (opts.deadline != null && Date.now() > opts.deadline) return;
       if (opts.maxTotalBytes != null && bytes >= opts.maxTotalBytes) return;
       try {
-        if (opts.delayMs) await sleep5(opts.delayMs);
-        const { ok, status, text, url } = await httpText(u, {
+        if (opts.delayMs) await sleep6(opts.delayMs);
+        const { ok, status, text, url, challenged } = await httpText(u, {
           fetchImpl: ctx.fetchImpl,
           signal: ctx.signal,
           accept: "text/html",
@@ -5546,7 +5896,7 @@ async function fetchProductPages(ctx, urls, opts = {}) {
         if (!ok) {
           if (opts.stats) {
             opts.stats.refused = (opts.stats.refused ?? 0) + 1;
-            if (opts.stats.reasons) tally(opts.stats.reasons, pageFailure(status));
+            if (opts.stats.reasons) tally(opts.stats.reasons, pageFailure(status, challenged));
           }
           if (++refusedRun >= giveUpAt) givenUp = true;
           return;
@@ -5565,6 +5915,7 @@ async function fetchProductPages(ctx, urls, opts = {}) {
           opts.stats.refused = (opts.stats.refused ?? 0) + 1;
           if (opts.stats.reasons) tally(opts.stats.reasons, thrownFailure(err, ctx.signal?.aborted));
         }
+        if (!ctx.signal?.aborted && ++refusedRun >= giveUpAt) givenUp = true;
       }
     },
     ctx.signal
@@ -5631,14 +5982,28 @@ async function fetchProductsJsonPage(ctx, page, limit = 250) {
   if (ok && json?.products) return { products: json.products, blocked: false };
   return { products: [], blocked: status === 401 || status === 403 || status === 404 || status >= 500 };
 }
+function cardOf(origin, p) {
+  const handle = String(p.handle ?? "");
+  const first = (p.images ?? [])[0] ?? p.image ?? null;
+  const src = first ? String(first.src ?? first) : null;
+  return {
+    externalKey: String(p.id),
+    title: String(p.title ?? handle),
+    url: absolutize(origin, `/products/${handle}`) ?? `${originOf(origin)}/products/${handle}`,
+    handle: handle || null,
+    image: src ? cardImageUrl(upgradeImageUrl(src)) : null
+  };
+}
 var JSON_BLOCKED = "json-blocked";
+var JSON_GIVE_UP = 3;
+var MAX_SITEMAPS = 40;
 async function collectSitemapProductUrls(ctx) {
   const origin = originOf(ctx.baseUrl);
   const urls = /* @__PURE__ */ new Set();
   const candidates = [`${origin}/sitemap.xml`, `${origin}/sitemap_products_1.xml`];
   const queue = [...candidates];
   const seen = /* @__PURE__ */ new Set();
-  while (queue.length) {
+  while (queue.length && seen.size < MAX_SITEMAPS && !outOfTime(ctx.deadline)) {
     const next = queue.shift();
     if (seen.has(next)) continue;
     seen.add(next);
@@ -5692,11 +6057,16 @@ var shopifyAdapter = {
     const hints = [];
     const keys = /* @__PURE__ */ new Set();
     const productUrls = /* @__PURE__ */ new Set();
+    const cards = [];
     const origin = originOf(ctx.baseUrl);
     let page = 1;
     let emptyStreak = 0;
     while (emptyStreak < 1) {
       if (ctx.signal?.aborted) throw new Error("aborted");
+      if (outOfTime(ctx.deadline)) {
+        warnings.push("This store was slow to list its catalogue, so only part of it was read");
+        break;
+      }
       const { products, blocked: blocked2 } = await fetchProductsJsonPage(ctx, page);
       ctx.onProgress?.({ stage: "discovering", discovered: keys.size, message: `Shopify page ${page}` });
       if (blocked2 && page === 1) {
@@ -5710,6 +6080,7 @@ var shopifyAdapter = {
       for (const p of products) {
         keys.add(String(p.id));
         if (p.handle) productUrls.add(`${origin}/products/${p.handle}`);
+        cards.push(cardOf(origin, p));
       }
       if (products.length < 250) break;
       page++;
@@ -5730,6 +6101,7 @@ var shopifyAdapter = {
     return {
       productKeys: [...keys],
       productUrls: [...productUrls],
+      cards,
       estimatedTotal: keys.size || productUrls.size || null,
       // A store whose own product API answered but refused us leaves nothing
       // to read but the pages themselves, one request each. That is what
@@ -5739,6 +6111,43 @@ var shopifyAdapter = {
       hints
     };
   },
+  /**
+   * The chosen products, read from the listing instead of a page each.
+   *
+   * Walks `/products.json` only until every handle asked for has been found,
+   * so a small pick is usually one request and the whole catalogue is a
+   * handful. Returns null the moment the listing refuses us, because then the
+   * pages are the only way in and the caller already knows how to read them.
+   */
+  async fetchSome(ctx, urls) {
+    const origin = originOf(ctx.baseUrl);
+    const handleOf = (u) => {
+      const raw = /\/products\/([^/?#]+)/i.exec(u)?.[1];
+      return raw ? decodeURIComponent(raw) : null;
+    };
+    const want = new Set(urls.map(handleOf).filter((h) => Boolean(h)));
+    if (!want.size) return null;
+    const out = [];
+    let page = 1;
+    while (want.size) {
+      if (ctx.signal?.aborted) throw new Error("aborted");
+      if (outOfTime(ctx.deadline)) break;
+      const { products, blocked: blocked2 } = await fetchProductsJsonPage(ctx, page);
+      if (blocked2 && page === 1) return null;
+      if (!products.length) break;
+      for (const p of products) {
+        const h = String(p.handle ?? "");
+        if (want.delete(h)) {
+          out.push(mapShopifyProduct(origin, p));
+          ctx.onProgress?.({ stage: "fetching_products", fetched: out.length });
+        }
+      }
+      if (products.length < 250) break;
+      page++;
+      if (page > 1e4) break;
+    }
+    return out.length ? out : null;
+  },
   async fetchAll(ctx, discovered) {
     const origin = originOf(ctx.baseUrl);
     const out = [];
@@ -5772,20 +6181,29 @@ var shopifyAdapter = {
       const handle = handleOf(u);
       return handle && !out.some((p) => p.handle === handle);
     });
-    if (!jsonBlocked) {
+    const bulkCoveredAll = out.length > 0 && out.length >= discovered.productKeys.length;
+    if (!jsonBlocked && !bulkCoveredAll) {
       const missingUrls = stillMissing();
       if (missingUrls.length) {
+        let refusedRun = 0;
+        let abandoned = false;
         await mapPool(
           missingUrls,
-          6,
+          4,
           async (u) => {
+            if (abandoned) return;
             const handle = handleOf(u);
             if (!handle) return;
-            const { ok, json } = await httpJson(`${origin}/products/${handle}.json`, {
+            const { ok, json, challenged } = await httpJson(`${origin}/products/${handle}.json`, {
               fetchImpl: ctx.fetchImpl,
               signal: ctx.signal
             });
-            if (ok && json?.product) {
+            if (!ok) {
+              if (challenged || ++refusedRun >= JSON_GIVE_UP) abandoned = true;
+              return;
+            }
+            refusedRun = 0;
+            if (json?.product) {
               const mapped = mapShopifyProduct(origin, json.product);
               if (!seen.has(mapped.externalKey)) {
                 seen.add(mapped.externalKey);
@@ -5843,7 +6261,7 @@ async function extractSitemapUrls(ctx, filter = () => true) {
       }
       if (filter(loc)) out.add(loc.split("?")[0]);
     }
-    if (seen.size > 200) break;
+    if (seen.size > 200 || outOfTime(ctx.deadline)) break;
   }
   return preferCanonicalLocale([...out]);
 }
@@ -5882,7 +6300,7 @@ async function crawlListingPages(ctx) {
   const found = /* @__PURE__ */ new Set();
   const visited = /* @__PURE__ */ new Set();
   const queue = [origin, `${origin}/collections/all`, `${origin}/shop`, `${origin}/products`, `${origin}/catalog`];
-  while (queue.length && visited.size < 40) {
+  while (queue.length && visited.size < 40 && !outOfTime(ctx.deadline)) {
     const page = queue.shift();
     if (visited.has(page)) continue;
     visited.add(page);
@@ -6038,6 +6456,11 @@ var woocommerceAdapter = {
     let page = 1;
     let usedApi = false;
     while (true) {
+      if (ctx.signal?.aborted) throw new Error("aborted");
+      if (outOfTime(ctx.deadline)) {
+        warnings.push("This store was slow to list its catalogue, so only part of it was read");
+        break;
+      }
       const batch = await tryStoreApi(ctx, page, 100);
       if (batch === null) break;
       usedApi = true;
@@ -6397,6 +6820,7 @@ var DEFAULT_SCAN_BUDGET = {
    */
   previewFloorMs: 12e3
 };
+var DISCOVERY_FLOOR_MS = 8e3;
 var COMMERCE_SIGNALS = /* @__PURE__ */ new Set([
   "products.json",
   "shopify-html",
@@ -6427,12 +6851,14 @@ async function scanOnce(opts, baseUrl) {
   const started = Date.now();
   const budget = { ...DEFAULT_SCAN_BUDGET, ...opts.budget };
   const deadline = started + budget.budgetMs;
+  const discoveryDeadline = Math.max(deadline, started + DISCOVERY_FLOOR_MS);
   const fetchImpl = opts.fetchImpl ?? fetch;
   const ctx = {
     fetchImpl,
     baseUrl,
     signal: opts.signal,
-    onProgress: opts.onProgress
+    onProgress: opts.onProgress,
+    deadline: discoveryDeadline
   };
   const warnings = [];
   const stats = { pages: 0, bytes: 0 };
@@ -6453,10 +6879,18 @@ async function scanOnce(opts, baseUrl) {
   if (refused > 0) warnings.push(`${refused} pages are disallowed by this site's robots.txt`);
   const fromApi = detection.platform !== "generic" && !discovered.hints?.includes("json-blocked");
   const countSource = urls.length === 0 ? "none" : fromApi ? "api" : "sitemap";
+  const commerce = detection.signals.some((sig) => COMMERCE_SIGNALS.has(sig));
   if (urls.length === 0) {
-    const commerce = detection.signals.some((sig) => COMMERCE_SIGNALS.has(sig));
     return done(commerce ? "likely" : "none", [], [], 0, countSource, warnings);
   }
+  const listed = discovered.cards ?? [];
+  if (listed.length) {
+    const byUrl = new Set(urls);
+    const usable2 = listed.filter((c) => byUrl.has(c.url));
+    const cards = usable2.length ? usable2 : listed;
+    opts.onProgress?.({ stage: "discovering", discovered: cards.length, message: `Found ${cards.length} products` });
+    return done("found", [], urls, urls.length || cards.length, countSource, warnings, cards);
+  }
   opts.onProgress?.({ stage: "discovering", discovered: urls.length, message: "Reading a few products" });
   const previewDeadline = Math.max(deadline, Date.now() + budget.previewFloorMs);
   const read = dedupeProducts(
@@ -6472,15 +6906,16 @@ async function scanOnce(opts, baseUrl) {
     })
   );
   const preview = read.slice(0, budget.maxPreviewPages);
-  const verdict = preview.length ? "found" : "blocked";
+  const verdict = preview.length ? "found" : commerce ? "blocked" : "none";
   return done(verdict, preview, urls, urls.length, countSource, warnings);
-  function done(verdict2, candidates, candidateUrls, count, source, notes) {
+  function done(verdict2, candidates, candidateUrls, count, source, notes, cards = []) {
     return {
       baseUrl,
       platform: detection?.platform ?? "unknown",
       signals: detection?.signals ?? [],
       verdict: verdict2,
       count,
+      cards,
       countSource: source,
       candidates,
       candidateUrls,
@@ -6548,11 +6983,14 @@ function progressWriter(patch2) {
     });
   };
 }
+function stoppedMessage(saved) {
+  return saved ? `Stopped after saving ${saved.toLocaleString()} products` : "Stopped before anything was saved";
+}
 async function runJob(deps, jobId, brandId, url, signal, only) {
   const { core, fetchImpl } = deps;
   const patch2 = (p) => core.catalog.updateJob(jobId, p);
+  const tally2 = { fetched: 0, upserted: 0, imagesDone: 0, imagesTotal: 0, errors: [], seenKeys: [] };
   try {
-    const tally2 = { fetched: 0, upserted: 0, imagesDone: 0, imagesTotal: 0, errors: [], seenKeys: [] };
     const ctx = { fetchImpl: fetchImpl ?? fetch, baseUrl: url, signal };
     let urls = [];
     let bulk = null;
@@ -6568,6 +7006,16 @@ async function runJob(deps, jobId, brandId, url, signal, only) {
       baseUrl = url;
       platform = detection.platform;
       discovered = only.length;
+      const adapter = adapterFor(detection.platform);
+      const listed = adapter.fetchSome ? await adapter.fetchSome({ ...ctx, baseUrl }, only) : null;
+      if (listed?.length) {
+        bulk = listed;
+        const got = new Set(listed.map((p) => p.handle ?? "").filter(Boolean));
+        urls = only.filter((u) => {
+          const h = /\/products\/([^/?#]+)/i.exec(u)?.[1];
+          return !h || !got.has(decodeURIComponent(h));
+        });
+      }
     } else {
       patch2({ stage: "discovering", message: "Detecting store platform" });
       const found = await discoverCatalog({ url, fetchImpl, signal, onProgress: progressWriter(patch2) });
@@ -6591,7 +7039,7 @@ async function runJob(deps, jobId, brandId, url, signal, only) {
       if (!found.byPage) {
         const products = await found.fetchAll();
         if (signal.aborted) {
-          patch2({ stage: "cancelled", errors: [], message: "Stopped before anything was saved", finished: true });
+          patch2({ stage: "cancelled", errors: [], message: stoppedMessage(tally2.upserted), finished: true });
           return;
         }
         if (!products.length) {
@@ -6617,18 +7065,23 @@ async function runJob(deps, jobId, brandId, url, signal, only) {
       }
     }
     const run2 = beginWrite(deps, jobId, brandId, baseUrl, platform, tally2, discovered);
-    const pictures = drainPictures(deps, jobId, brandId, tally2, signal);
+    const pictures = drainPictures(deps, jobId, brandId, tally2, signal, hostOf(baseUrl));
     let pictureErrors;
     let pictureReasons = {};
     const stats = { pages: 0, bytes: 0, refused: 0, reasons: {} };
     try {
       if (bulk) for (const p of bulk) run2.write(p);
-      else
+      if (urls.length)
         await fetchProductPages(ctx, urls, {
           concurrency: IMPORT_CONCURRENCY,
           maxBytes: 15e5,
           onEach: run2.write,
           stats,
+          // A run that cannot finish still has to end. Generous enough for a
+          // 2,200 page catalogue, which measures around sixteen minutes, and
+          // short of the forever this had before. Stopping here leaves the run
+          // `partial` with what it saved, never `completed`.
+          deadline: Date.now() + IMPORT_DEADLINE_MS,
           // Past this many refusals in a row the store is not going to change
           // its mind inside this import, and waiting out its cooldown for the
           // rest of the catalogue is time nobody gets a product for.
@@ -6652,7 +7105,7 @@ async function runJob(deps, jobId, brandId, url, signal, only) {
       patch2({
         stage: "cancelled",
         errors: [],
-        message: tally2.upserted ? `Stopped after saving ${tally2.upserted.toLocaleString()} products` : "Stopped before anything was saved",
+        message: stoppedMessage(tally2.upserted),
         finished: true
       });
       core.catalog.setSourceStatus(run2.sourceId, "partial", true);
@@ -6664,14 +7117,21 @@ async function runJob(deps, jobId, brandId, url, signal, only) {
       errors: pictureErrors,
       refused: stats.refused,
       reasons: { ...stats.reasons, ...pictureReasons },
-      asked: bulk ? bulk.length : urls.length,
-      // Every address was read. A bulk API hands the catalogue over whole, so
-      // there is nothing to cover.
-      covered: bulk ? true : stats.pages >= urls.length
+      // A chosen set can now come partly from the listing and partly from the
+      // pages it did not carry, so both halves count.
+      asked: (bulk?.length ?? 0) + urls.length,
+      // Addresses that actually yielded a page, which is the unit the person's
+      // question was asked in. Products are the wrong unit: one address can
+      // carry several, and counting them made a run that lost three addresses
+      // report that it had lost one. A listing answers for itself.
+      worked: (bulk?.length ?? 0) + Math.max(0, stats.pages - stats.refused),
+      // Every address was read. A bulk API hands its share over whole, so only
+      // the pages left over have to be covered.
+      covered: stats.pages >= urls.length
     });
   } catch (err) {
     if (signal.aborted) {
-      patch2({ stage: "cancelled", errors: [], message: "Stopped before anything was saved", finished: true });
+      patch2({ stage: "cancelled", errors: [], message: stoppedMessage(tally2.upserted), finished: true });
       return;
     }
     patch2({
@@ -6685,7 +7145,15 @@ async function runJob(deps, jobId, brandId, url, signal, only) {
 var IMAGES_PER_PRODUCT = 3;
 var TERMINAL = /* @__PURE__ */ new Set(["completed", "partial", "no_catalog", "cancelled", "failed"]);
 var IMAGE_CONCURRENCY = 4;
-var sleep6 = (ms) => new Promise((r) => setTimeout(r, ms));
+var IMAGE_CONCURRENCY_OFF_HOST = 12;
+function allOffHost(round, storeHost) {
+  if (!storeHost || !round.length) return false;
+  return round.every((img) => {
+    const h = hostOf(img.sourceUrl);
+    return h !== "" && h !== storeHost;
+  });
+}
+var sleep7 = (ms) => new Promise((r) => setTimeout(r, ms));
 function beginWrite(deps, jobId, brandId, baseUrl, platform, tally2, discovered) {
   const { core } = deps;
   const patch2 = (p) => core.catalog.updateJob(jobId, p);
@@ -6736,14 +7204,22 @@ function beginWrite(deps, jobId, brandId, baseUrl, platform, tally2, discovered)
       refused = 0,
       covered = true,
       reasons = {},
-      asked = 0
+      asked = 0,
+      worked
     }) {
       const mayRetire = sweep && covered && refused === 0 && tally2.upserted > 0;
       if (mayRetire) core.catalog.markMissingUnavailable(source.id, tally2.seenKeys);
+      if (tally2.upserted > 0) core.catalog.excludeSharedImages(source.id);
       tally2.errors = errors;
       const partial = !covered || refused > 0;
       const savedNothing = tally2.upserted === 0;
-      const said = summarise(reasons, tally2.upserted, asked || discovered || tally2.fetched);
+      const total = asked || discovered || tally2.fetched;
+      const said = summarise(
+        reasons,
+        tally2.upserted,
+        total,
+        worked === void 0 ? void 0 : shortfall(total, worked)
+      );
       const stage = savedNothing ? "failed" : partial ? "partial" : "completed";
       const message = savedNothing ? said ?? "We found the products on this site, but none of them could be imported." : said ?? (partial ? `Imported ${tally2.upserted.toLocaleString()} products with ${(errors.length + refused).toLocaleString()} issue${errors.length + refused === 1 ? "" : "s"}` : `Imported ${tally2.upserted.toLocaleString()} products`);
       patch2({
@@ -6762,8 +7238,9 @@ function beginWrite(deps, jobId, brandId, baseUrl, platform, tally2, discovered)
   };
 }
 var IMPORT_CONCURRENCY = 4;
+var IMPORT_DEADLINE_MS = 40 * 6e4;
 var PICTURE_ROUND = 60;
-function drainPictures(deps, jobId, brandId, tally2, signal, imagesPerProduct = IMAGES_PER_PRODUCT) {
+function drainPictures(deps, jobId, brandId, tally2, signal, storeHost = "", imagesPerProduct = IMAGES_PER_PRODUCT) {
   const { core, fetchImpl } = deps;
   const patch2 = (p) => core.catalog.updateJob(jobId, p);
   const errors = [...core.catalog.getJob(jobId)?.errors ?? []];
@@ -6774,13 +7251,13 @@ function drainPictures(deps, jobId, brandId, tally2, signal, imagesPerProduct =
       const round = core.catalog.listImagesNeedingAssets(brandId, PICTURE_ROUND).filter((img) => img.position < imagesPerProduct);
       if (!round.length) {
         if (stopped) break;
-        await sleep6(150);
+        await sleep7(150);
         continue;
       }
-      tally2.imagesTotal += round.length;
+      tally2.imagesTotal = tally2.imagesDone + core.catalog.countImagesNeedingAssets(brandId, imagesPerProduct);
       await mapPool(
         round,
-        IMAGE_CONCURRENCY,
+        allOffHost(round, storeHost) ? IMAGE_CONCURRENCY_OFF_HOST : IMAGE_CONCURRENCY,
         async (img) => {
           if (signal.aborted) return;
           try {
@@ -6797,6 +7274,11 @@ function drainPictures(deps, jobId, brandId, tally2, signal, imagesPerProduct =
               return;
             }
             const probe = await sharp21(buf).metadata();
+            if (probe.format === "svg") {
+              errors.push({ code: "image_unsupported", message: "Not a photograph", url: img.sourceUrl });
+              tally(reasons, "UNSUPPORTED_MEDIA");
+              return;
+            }
             const turned = (probe.orientation ?? 1) > 1;
             const keep = turned ? await sharp21(buf).rotate().toBuffer() : buf;
             const meta = turned ? await sharp21(keep).metadata() : probe;
@@ -6896,12 +7378,26 @@ function brandJsonWithCatalogProducts(core, brandId) {
 function runningImportCount() {
   return running.size;
 }
+var IDENTITY_EDITS_MAX = 8;
+var IDENTITY_EDIT_CHARS = 120;
+var PRESENTER_SOURCES = ["synthetic", "photos"];
+var LIKENESS_VERSION = "v1";
 var PRESENTER_ID_PREFIX = "up";
 var SCENE_ID_PREFIX = "us";
 var ASSET_WIDTH = 1024;
 var ASSET_HEIGHT = 1280;
 var mintId = (prefix) => `${prefix}-${randomUUID().slice(0, 8)}`;
 var str3 = (v, max) => String(v ?? "").trim().slice(0, max);
+var phrase = (v, max) => {
+  const whole = String(v ?? "").trim();
+  if (whole.length <= max) return whole;
+  const cut = whole.slice(0, max);
+  const stop = Math.max(cut.lastIndexOf(". "), cut.lastIndexOf("! "), cut.lastIndexOf("? "));
+  if (stop >= max * 0.6) return cut.slice(0, stop + 1);
+  const space = cut.lastIndexOf(" ");
+  if (space < max * 0.6) return cut;
+  return cut.slice(0, space).replace(/[\s,;:]+$/, "");
+};
 var strList = (v, max, each) => Array.isArray(v) ? v.map((x) => str3(x, each)).filter(Boolean).slice(0, max) : [];
 var assetRef = (hash) => {
   const h = String(hash ?? "");
@@ -6919,6 +7415,30 @@ function brandSceneById(brandJson, id) {
 function isCustomPresenter(c) {
   return c?.origin === "custom";
 }
+function headOf(brandJson, id) {
+  const rows = brandCharacters(brandJson);
+  const seen = /* @__PURE__ */ new Set([id]);
+  let cur = id;
+  for (; ; ) {
+    const next = rows.find((c) => c?.id === cur)?.supersededBy;
+    if (typeof next !== "string" || !next || seen.has(next) || !rows.some((c) => c?.id === next)) return cur;
+    seen.add(next);
+    cur = next;
+  }
+}
+function identityEditsOf(v) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const raw of Array.isArray(v) ? v : []) {
+    const s = str3(raw, IDENTITY_EDIT_CHARS).replace(/\s+/g, " ");
+    const key = s.toLowerCase();
+    if (!s || seen.has(key)) continue;
+    seen.add(key);
+    out.push(s);
+    if (out.length >= IDENTITY_EDITS_MAX) break;
+  }
+  return out;
+}
 var SUBJECTS2 = /* @__PURE__ */ new Set(["product", "person", "either"]);
 function sceneRecordFrom(input, base) {
   const has = (k) => input[k] !== void 0;
@@ -6969,7 +7489,11 @@ function presenterRecordFrom(input, base) {
   const name = has("name") ? str3(input.name, 60) : base?.name ?? "";
   if (!name) return { ok: false, error: "a presenter needs a name" };
   const angles = has("shotAngles") ? strList(input.shotAngles, 8, 32) : [];
-  const shots = has("shotHashes") ? strList(input.shotHashes, 8, 64).map((h) => assetRef(h)).filter((f) => !!f).map((file, i) => angles[i] ? { file, angle: angles[i], locked: true } : { file, locked: true }) : base?.shots ?? [];
+  const knownAngle = (file) => base?.shots?.find((s) => s.file === file)?.angle;
+  const shots = has("shotHashes") ? strList(input.shotHashes, 8, 64).map((h) => assetRef(h)).filter((f) => !!f).map((file, i) => {
+    const angle = angles[i] ?? knownAngle(file);
+    return angle ? { file, angle, locked: true } : { file, locked: true };
+  }) : base?.shots ?? [];
   if (!shots.length) return { ok: false, error: "a presenter needs at least one photo" };
   const sources = has("sourceHashes") ? strList(input.sourceHashes, 8, 64).map((h) => assetRef(h)).filter((f) => !!f).map((file) => ({ file })) : base?.sourceRefs;
   const presenter = {
@@ -6982,13 +7506,13 @@ function presenterRecordFrom(input, base) {
   if (promptName) presenter.promptName = promptName;
   const presentation = has("presentation") ? str3(input.presentation, 10).toLowerCase() : base?.presentation;
   if (presentation === "woman" || presentation === "man") presenter.presentation = presentation;
-  const descriptor = has("descriptor") ? str3(input.descriptor, 120) : base?.descriptor;
+  const descriptor = has("descriptor") ? phrase(input.descriptor, 120) : base?.descriptor;
   if (descriptor) presenter.descriptor = descriptor;
   const ageRange = has("ageRange") ? str3(input.ageRange, 40) : base?.ageRange;
   if (ageRange) presenter.ageRange = ageRange;
-  const hair = has("hair") ? str3(input.hair, 120) : base?.hair;
+  const hair = has("hair") ? phrase(input.hair, 120) : base?.hair;
   if (hair) presenter.hair = hair;
-  const identityNotes = has("identityNotes") ? str3(input.identityNotes, 900) : base?.identityNotes;
+  const identityNotes = has("identityNotes") ? phrase(input.identityNotes, 900) : base?.identityNotes;
   if (identityNotes) presenter.identityNotes = identityNotes;
   const negatives = has("negativeConstraints") ? strList(input.negativeConstraints, 8, 160) : base?.negativeConstraints;
   if (negatives?.length) presenter.negativeConstraints = negatives;
@@ -6999,8 +7523,36 @@ function presenterRecordFrom(input, base) {
   if (previewRef) presenter.preview = previewRef;
   const avatarRef = has("avatarHash") ? assetRef(input.avatarHash) : base?.avatar ?? null;
   if (avatarRef) presenter.avatar = avatarRef;
+  const source = has("source") ? str3(input.source, 16) : base?.source;
+  if (source && PRESENTER_SOURCES.includes(source)) presenter.source = source;
+  const likeness = has("likeness") ? likenessOf(input.likeness) : base?.likeness;
+  if (likeness) presenter.likeness = likeness;
+  const facial = has("facial") ? str3(input.facial, 300) : base?.facial;
+  if (facial) presenter.facial = facial;
+  const skin = has("skin") ? str3(input.skin, 200) : base?.skin;
+  if (skin) presenter.skin = skin;
+  const build = has("build") ? str3(input.build, 200) : base?.build;
+  if (build) presenter.build = build;
+  const edits = has("identityEdits") ? identityEditsOf(input.identityEdits) : base?.identityEdits;
+  if (edits?.length) presenter.identityEdits = edits;
+  const revisionOf = has("revisionOf") ? str3(input.revisionOf, 64) : base?.revisionOf;
+  if (revisionOf) presenter.revisionOf = revisionOf;
+  if (base?.supersededBy) presenter.supersededBy = base.supersededBy;
   return { ok: true, presenter };
 }
+function mintRevision(base, input) {
+  const built = presenterRecordFrom(input, base);
+  if (!built.ok) return built;
+  const { supersededBy: _head, ...rest } = built.presenter;
+  return { ok: true, presenter: { ...rest, id: mintId(PRESENTER_ID_PREFIX), revisionOf: base.id } };
+}
+function likenessOf(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const at = str3(raw.attestedAt, 40);
+  const version = str3(raw.version, 8);
+  if (!at || version !== LIKENESS_VERSION) return void 0;
+  return { attestedAt: at, version: LIKENESS_VERSION };
+}
 function lintSceneProse(brandJson, scene) {
   const haystack = `${scene.prompt} ${scene.description} ${scene.figure ?? ""} ${scene.figureTreatment ?? ""}`.toLowerCase();
   const named = /* @__PURE__ */ new Set();
@@ -7016,14 +7568,14 @@ function lintSceneProse(brandJson, scene) {
     `This scene names ${[...named].join(", ")}. A scene is a place, so whatever you stage in it later has to argue with that.`
   ] : [];
 }
-function commit(core, brandId, mutate) {
+function commit(core, brandId, mutate2, dropDraftId) {
   const brand = core.store.getBrand(brandId);
   if (!brand) throw Object.assign(new Error("brand not found"), { statusCode: 404 });
   const json = { ...brand.json };
-  mutate(json);
+  mutate2(json);
   const v = validateBrand(json);
   if (!v.valid) throw Object.assign(new Error(`brand became invalid: ${v.errors.join("; ")}`), { statusCode: 400 });
-  return core.store.updateBrand(brand.id, json);
+  return dropDraftId ? core.store.updateBrandAndDropPresenterDraft(brand.id, json, dropDraftId) : core.store.updateBrand(brand.id, json);
 }
 
 // src/customAssets.ts
@@ -7055,20 +7607,17 @@ function startAssetBuild(deps, input) {
   if (input.sceneId && !prior) throw Object.assign(new Error("scene not found"), { statusCode: 404 });
   const supplied = input.imageHashes.length ? input.imageHashes : (prior?.refs ?? []).map((r) => String(r?.file ?? "").replace(/^asset:/, ""));
   const hashes = supplied.filter((h) => /^[a-f0-9]{32}$/.test(h) && core.images.has(h));
-  if (input.kind === "presenter" && !hashes.length) {
-    throw Object.assign(new Error("add at least one photo of this person"), { statusCode: 400 });
-  }
-  if (input.kind === "scene" && !hashes.length && !input.instruction?.trim()) {
+  if (!hashes.length && !input.instruction?.trim()) {
     throw Object.assign(new Error("add a reference image, or describe the place in a sentence"), { statusCode: 400 });
   }
   const job = {
     id: `ab-${randomUUID().slice(0, 8)}`,
     brandId: brand.id,
     kind: input.kind,
-    name: str3(input.name, 60) || (input.kind === "presenter" ? "New presenter" : "New scene"),
+    name: str3(input.name, 60) || "New scene",
     stage: "queued",
     step: 0,
-    steps: input.kind === "presenter" ? STUDIO_FRAMES.length : 1,
+    steps: 1,
     message: null,
     assetId: null,
     previewHash: null,
@@ -7096,8 +7645,7 @@ function patch(job, next) {
 }
 async function runBuild(deps, job, hashes, instruction, signal) {
   try {
-    if (job.kind === "presenter") await runPresenterBuild(deps, job, hashes, instruction, signal);
-    else await runSceneBuild(deps, job, hashes, instruction, signal);
+    await runSceneBuild(deps, job, hashes, instruction, signal);
   } catch (err) {
     if (signal.aborted) {
       patch(job, { stage: "cancelled", message: null, finished: true });
@@ -7106,162 +7654,6 @@ async function runBuild(deps, job, hashes, instruction, signal) {
     patch(job, { stage: "failed", error: err?.message ?? "build failed", message: null, finished: true });
   }
 }
-var STUDIO_FRAMES = [
-  /*
-   * The identity frame, and it comes first because that is the order a brief
-   * attaches: `shots[0]` is the essential character reference.
-   *
-   * Every other frame here is full-length head-to-toe, which is right for
-   * build, proportion and wardrobe and useless for a face — in a 1024x1280
-   * full-length frame the face is about 105px brow to chin, while a portrait
-   * output renders it at four times that. Measured 2026-08-30 against the
-   * reported failure: four outputs of one brief, four different jaws, and
-   * drift that tracked nothing but how big the face was in the output.
-   *
-   * Drawn `from: 'sources'` rather than chained off the front view, because
-   * the user's own photographs are the only real face evidence in the system
-   * and a chain would just enlarge the same 105px.
-   */
-  {
-    angle: "portrait",
-    from: "sources",
-    subject: (who) => `${who}, head-and-shoulders portrait framing from just above the top of the head down to the collarbone, facing the camera straight-on, relaxed neutral expression, eyes to the lens, their own hair exactly as the references show it, the same plain studio backdrop and even frontal light`
-  },
-  {
-    angle: "front",
-    from: "sources",
-    subject: (who) => `${who}, wearing a fitted off-white ribbed tank top and matching fitted off-white leggings, barefoot, standing naturally in a relaxed straight standing pose, full-length head-to-toe framing, facing the camera straight-on`
-  },
-  {
-    angle: "left-profile",
-    from: "front",
-    subject: () => "the same person in the identical standing pose, full-length head-to-toe framing, rotated a full 90 degrees to show their left side in full profile, facing screen-left, same wardrobe"
-  },
-  {
-    angle: "right-profile",
-    from: "left-profile",
-    subject: () => "the attached image shows this exact same person in full left profile, standing: generate the precise mirror-flipped view of that same pose, the same person now in full right profile, facing the exact opposite horizontal direction, same standing pose, same wardrobe, same lighting and background"
-  },
-  {
-    angle: "back",
-    from: "front",
-    subject: () => "the same person in the identical standing pose, full-length head-to-toe framing, rotated to face fully away from the camera, back view, same wardrobe"
-  }
-];
-var STUDIO_SET = "against a solid seamless white studio background, eye-level camera with gentle 85mm-equivalent portrait compression and a soft shallow depth of field, one large soft key light with gentle fill producing even, flattering, true-to-life beauty light, while keeping fine natural skin texture at pore scale and true-to-life proportions, the complexion even and uniform in tone across face, neck and shoulders, never airbrushed, plastic, or synthetic-looking, a calm quietly confident expression, true-to-life color grade with minimal retouch";
-function studioPrompt(subject) {
-  return `Full-bleed photograph filling the entire frame edge to edge with no border, frame, letterbox band or matte of any kind, the seamless studio backdrop runs past all four edges and is the only thing behind the subject at every edge of the frame. ${subject}, ${STUDIO_SET}. No text, no logos, no watermarks anywhere in the frame.`;
-}
-function whoIs(name, draft) {
-  if (!draft) return `the exact person in the attached photographs`;
-  const bits = [draft.promptName];
-  if (draft.hair && !draft.promptName.toLowerCase().includes(draft.hair.toLowerCase())) bits.push(draft.hair);
-  if (draft.identityNotes) bits.push(draft.identityNotes);
-  return bits.filter(Boolean).join(", ") || name;
-}
-async function runPresenterBuild(deps, job, hashes, instruction, signal) {
-  const { core } = deps;
-  const sourcePaths = hashes.map((h) => core.images.pathFor(h));
-  let draft = null;
-  if (deps.analyzer) {
-    patch(job, { stage: "analyzing", message: "Reading the photos" });
-    draft = await deps.analyzer.analyze(
-      {
-        kind: "presenter",
-        imagePaths: sourcePaths,
-        name: job.name,
-        instruction: instruction || void 0,
-        vocabulary: deps.vocabulary
-      },
-      signal
-    );
-    patch(job, { coverage: draft.coverage ?? [] });
-  }
-  if (signal.aborted) throw new Error("cancelled");
-  let shotHashes = hashes;
-  let shotAngles = [];
-  const warnings = [];
-  if (deps.engine) {
-    patch(job, { stage: "building", steps: STUDIO_FRAMES.length, message: "Building the studio views" });
-    const built2 = await generateStudioSet(deps, job, whoIs(job.name, draft), sourcePaths, signal);
-    if (built2.hashes.length) {
-      shotHashes = built2.hashes;
-      shotAngles = built2.angles;
-    } else warnings.push("The studio views could not be drawn, so the photos are being used directly.");
-  } else {
-    warnings.push("No engine could draw the studio views, so the photos are being used directly.");
-  }
-  if (signal.aborted) throw new Error("cancelled");
-  patch(job, { stage: "saving", message: null });
-  const generated = shotHashes !== hashes;
-  const frontIndex = shotAngles.indexOf("front");
-  const cardSource = frontIndex === -1 ? shotHashes[0] : shotHashes[frontIndex];
-  const { previewHash, avatarHash } = await presenterCrops(core, cardSource, generated ? "generated" : "upload");
-  const built = presenterRecordFrom({
-    name: job.name,
-    shotHashes,
-    shotAngles,
-    sourceHashes: hashes,
-    previewHash,
-    avatarHash,
-    promptName: draft?.promptName,
-    presentation: draft?.presentation,
-    descriptor: draft?.descriptor,
-    ageRange: draft?.ageRange,
-    hair: draft?.hair,
-    identityNotes: draft?.identityNotes,
-    negativeConstraints: draft?.negativeConstraints,
-    // What the caller asked for wins over what the analyzer guessed: the
-    // person choosing where this belongs knows their own library.
-    suitableCategories: job.facets.length ? job.facets : draft?.suitableCategories
-  });
-  if (!built.ok) throw new Error(built.error);
-  commit(core, job.brandId, (json) => {
-    json.characters = [...brandCharacters(json), built.presenter];
-  });
-  patch(job, {
-    stage: "done",
-    step: job.steps,
-    assetId: built.presenter.id,
-    previewHash: previewHash ?? cardSource ?? null,
-    warnings: [...job.warnings, ...warnings],
-    finished: true
-  });
-}
-async function generateStudioSet(deps, job, who, sourcePaths, signal) {
-  const engine = deps.engine;
-  if (!engine) return { hashes: [], angles: [] };
-  const caps = engine.capabilities();
-  if (!caps.maxReferenceImages) return { hashes: [], angles: [] };
-  const byAngle = /* @__PURE__ */ new Map();
-  for (const frame of STUDIO_FRAMES) {
-    if (signal.aborted) throw new Error("cancelled");
-    const refs = frame.from === "sources" ? sourcePaths.slice(0, caps.maxReferenceImages) : [byAngle.get(frame.from)].filter((h) => !!h).map((h) => deps.core.images.pathFor(h));
-    if (!refs.length) continue;
-    try {
-      const drawn = await draw(deps, {
-        prompt: studioPrompt(frame.subject(who)),
-        brandId: job.brandId,
-        referenceImages: refs,
-        referenceRoles: refs.map(() => "character"),
-        signal
-      });
-      const hash = await trimEdgeBars(deps.core, drawn);
-      byAngle.set(frame.angle, hash);
-      patch(job, {
-        step: byAngle.size,
-        previewHash: job.previewHash ?? hash,
-        message: `Building the studio views (${byAngle.size} of ${STUDIO_FRAMES.length})`
-      });
-    } catch (err) {
-      if (signal.aborted) throw err;
-      if (frame.angle === "front") throw err;
-      patch(job, { warnings: [...job.warnings, `The ${frame.angle} view could not be drawn.`] });
-    }
-  }
-  const kept = STUDIO_FRAMES.filter((f) => byAngle.get(f.angle));
-  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 W = info.width;
@@ -7332,7 +7724,7 @@ async function cardCrop(core, hash) {
 }
 var AVATAR_FIGURE_FRACTION = 0.22;
 var AVATAR_HEADROOM = 0.1;
-var AVATAR_MAX_PX = 512;
+var AVATAR_MAX_PX = 1024;
 var FIGURE_TRIM_THRESHOLDS = [12, 25];
 async function avatarCrop(core, hash) {
   if (!hash || !core.images.has(hash)) return void 0;
@@ -7435,10 +7827,25 @@ async function figureBox(buf) {
   return null;
 }
 async function presenterCrops(core, hash, mode) {
+  if (mode === "portrait") {
+    const exists = !!hash && core.images.has(hash);
+    return { previewHash: exists ? hash : void 0, avatarHash: await portraitAvatarCrop(core, hash) };
+  }
   const previewHash = mode === "generated" ? await cardCrop(core, hash) ?? await cardCropSmart(core, hash) : await cardCropSmart(core, hash) ?? await cardCrop(core, hash);
   const avatarHash = mode === "generated" ? await avatarCrop(core, hash) ?? await avatarCropSmart(core, hash) : await avatarCropSmart(core, hash) ?? await avatarCrop(core, hash);
   return { previewHash, avatarHash };
 }
+async function portraitAvatarCrop(core, hash) {
+  return crop(
+    core,
+    hash,
+    (w, h) => {
+      const size = Math.min(w, h);
+      return { left: Math.max(0, Math.round((w - size) / 2)), top: 0, width: size, height: size };
+    },
+    AVATAR_MAX_PX
+  );
+}
 async function cardCropSmart(core, hash) {
   return smartCover(core, hash, (w, h) => {
     if (w / h > 0.8) return { width: Math.round(h * 0.8), height: h };
@@ -7577,8 +7984,8 @@ async function draw(deps, req) {
     brand: deps.brandContext(req.brandId),
     referenceImages: req.referenceImages,
     referenceRoles: req.referenceRoles,
-    width: ASSET_WIDTH,
-    height: ASSET_HEIGHT,
+    width: req.width ?? ASSET_WIDTH,
+    height: req.height ?? ASSET_HEIGHT,
     count: 1
   };
   const estimate = await engine.costEstimate(generateReq).catch(() => 0);
@@ -8733,6 +9140,8 @@ function registerLogoRoutes(app, deps) {
 var scans = /* @__PURE__ */ new Map();
 var controllers = /* @__PURE__ */ new Map();
 var KEEP = 32;
+var HARD_STOP_MS = 42e3;
+var KEEP_MS = 10 * 6e4;
 function remember(state) {
   scans.set(state.id, state);
   while (scans.size > KEEP) {
@@ -8743,7 +9152,20 @@ function remember(state) {
   }
 }
 function getScan(scanId) {
-  return scans.get(scanId);
+  const state = scans.get(scanId);
+  if (!state) return void 0;
+  if (state.status !== "running" && Date.now() - state.startedAt > KEEP_MS) {
+    scans.delete(scanId);
+    controllers.delete(scanId);
+    return void 0;
+  }
+  return state;
+}
+function cancelScan(scanId) {
+  const ctrl = controllers.get(scanId);
+  if (!ctrl) return false;
+  ctrl.abort();
+  return true;
 }
 function startCatalogScan(deps, brandId, url) {
   const { core, fetchImpl } = deps;
@@ -8753,13 +9175,22 @@ function startCatalogScan(deps, brandId, url) {
   const state = { id, brandId, url, status: "running", startedAt: Date.now() };
   remember(state);
   controllers.set(id, ctrl);
+  let hardStopped = false;
+  const stopper = setTimeout(() => {
+    hardStopped = true;
+    ctrl.abort();
+  }, HARD_STOP_MS);
+  stopper.unref?.();
   void scanForCandidates({ url, fetchImpl, signal: ctrl.signal }).then((result) => {
     state.result = result;
     state.status = "done";
   }).catch((err) => {
     state.status = "error";
-    state.error = err instanceof Error ? err.message : String(err);
-  }).finally(() => controllers.delete(id));
+    state.error = hardStopped ? "This site took too long to look through." : err instanceof Error ? err.message : String(err);
+  }).finally(() => {
+    clearTimeout(stopper);
+    controllers.delete(id);
+  });
   return { scanId: id };
 }
 
@@ -8803,6 +9234,13 @@ function registerCatalogImportRoutes(app, deps) {
     if (!scan || scan.brandId !== brandId) return reply.status(404).send({ error: "scan not found" });
     return scan;
   });
+  app.post("/api/brands/:id/catalog/scans/:scanId/cancel", async (req, reply) => {
+    const brandId = req.params.id;
+    const scanId = req.params.scanId;
+    const scan = getScan(scanId);
+    if (!scan || scan.brandId !== brandId) return reply.status(404).send({ error: "scan not found" });
+    return { ok: cancelScan(scanId) };
+  });
   app.post("/api/brands/:id/catalog/details", async (req, reply) => {
     const brand = core.store.getBrand(req.params.id);
     if (!brand) return reply.status(404).send({ error: "brand not found" });
@@ -9052,8 +9490,11 @@ function registerPresenterRoutes(app, deps) {
 }
 
 // src/presenterRepair.ts
-function presenterCropMode(firstShotFile, firstSourceFile) {
-  return firstShotFile && firstShotFile === firstSourceFile ? "upload" : "generated";
+function presenterCropMode(firstShotFile, sourceFiles, firstShotAngle) {
+  const sources = Array.isArray(sourceFiles) ? sourceFiles : [sourceFiles];
+  if (firstShotFile && sources.includes(firstShotFile)) return "upload";
+  if (firstShotAngle === "portrait") return "portrait";
+  return "generated";
 }
 async function repairPresenterCrops(core, log = () => {
 }) {
@@ -9065,7 +9506,11 @@ async function repairPresenterCrops(core, log = () => {
         const firstShot = c.shots?.[0]?.file;
         const hash = typeof firstShot === "string" && firstShot.startsWith("asset:") ? firstShot.slice(6) : null;
         if (!hash) continue;
-        const mode = presenterCropMode(firstShot, c.sourceRefs?.[0]?.file);
+        const mode = presenterCropMode(
+          firstShot,
+          (c.sourceRefs ?? []).map((s) => s?.file),
+          c.shots?.[0]?.angle
+        );
         const { previewHash, avatarHash } = await presenterCrops(core, hash, mode);
         const preview = previewHash ? `asset:${previewHash}` : void 0;
         const avatar = avatarHash ? `asset:${avatarHash}` : void 0;
@@ -9084,22 +9529,1164 @@ async function repairPresenterCrops(core, log = () => {
   return { repaired };
 }
 
+// src/presenterPrompts.ts
+var CAPTURE_UNIFORM = "a fitted off-white ribbed tank top and matching fitted off-white leggings, barefoot";
+var STUDIO_SET = "against a solid seamless white studio background, eye-level camera with gentle 85mm-equivalent portrait compression and a soft shallow depth of field, one large soft key light with gentle fill producing even, flattering, true-to-life beauty light, while keeping fine natural skin texture at pore scale and true-to-life proportions, the complexion even and uniform in tone across face, neck and shoulders, never airbrushed, plastic, or synthetic-looking, a calm quietly confident expression, true-to-life color grade with minimal retouch";
+function studioPrompt(subject) {
+  return `Full-bleed photograph filling the entire frame edge to edge with no border, frame, letterbox band or matte of any kind, the seamless studio backdrop runs past all four edges and is the only thing behind the subject at every edge of the frame. ${subject}, ${STUDIO_SET}. No text, no logos, no watermarks anywhere in the frame.`;
+}
+var VIEW_ROLES = [
+  { id: "portrait", tier: "core", gate: true, from: [], label: "face" },
+  { id: "front", tier: "core", gate: true, from: ["portrait"], label: "front view" },
+  { id: "three-quarter", tier: "core", from: ["portrait", "front"], label: "three-quarter view" },
+  { id: "back", tier: "supplementary", from: ["portrait", "front"], label: "back view" },
+  { id: "left", tier: "supplementary", from: ["portrait", "front"], label: "left view" },
+  // Never from the left: drawing one profile off the other is the surest way
+  // to put a trait on the wrong side of a face. See refDeps.
+  { id: "right", tier: "supplementary", from: ["portrait", "front", "left"], label: "right view" }
+];
+var idsWhere = (want) => VIEW_ROLES.filter(want).map((r) => r.id);
+var PRESENTER_VIEWS = idsWhere(() => true);
+var CORE_VIEWS = idsWhere((r) => r.tier === "core");
+var EXTRA_VIEWS = idsWhere((r) => r.tier === "supplementary");
+var DEPENDS = Object.fromEntries(VIEW_ROLES.map((r) => [r.id, r.from]));
+var VIEW_LABEL = Object.fromEntries(VIEW_ROLES.map((r) => [r.id, r.label]));
+var HAND_APPROVED = new Set(idsWhere((r) => r.gate === true));
+function viewSubject(view, who) {
+  switch (view) {
+    case "portrait":
+      return `${who}, head-and-shoulders portrait framing from just above the top of the head down to the collarbone, facing the camera straight-on, relaxed neutral expression, eyes to the lens, wearing ${CAPTURE_UNIFORM}, their own hair exactly as the references show it, the same plain studio backdrop and even frontal light`;
+    case "front":
+      return `${who}: the same person as the attached images, wearing ${CAPTURE_UNIFORM}, standing naturally in a relaxed straight standing pose, full-length head-to-toe framing, facing the camera straight-on, their own hair exactly as the attached images show it, the same plain studio backdrop and even light`;
+    case "three-quarter":
+      return `${who}: the same person as the attached images, wearing ${CAPTURE_UNIFORM}, standing naturally in a relaxed straight standing pose, full-length head-to-toe framing, turned about forty-five degrees from the camera so that both eyes stay in frame (a three-quarter view), the head turned with the body, their own hair exactly as the attached images show it, the same plain studio backdrop and even light`;
+    case "left":
+      return `${who}: the same person as the attached images, wearing ${CAPTURE_UNIFORM}, standing naturally in a relaxed straight standing pose, full-length head-to-toe framing, turned so that their left side faces the camera in a full profile, the head in profile too, this being a turn of the same body and never a mirror image of it so anything on one side of them stays on that side, their own hair exactly as the attached images show it, the same plain studio backdrop and even light`;
+    case "back":
+      return `${who}: the same person as the attached images, wearing ${CAPTURE_UNIFORM}, standing naturally in a relaxed straight standing pose, full-length head-to-toe framing, turned to face directly away from the camera so the back of the head, the shoulders and the legs are to the lens, their own hair exactly as the attached images show it, the same plain studio backdrop and even light`;
+    case "right":
+      return `${who}: the same person as the attached images, wearing ${CAPTURE_UNIFORM}, standing naturally in a relaxed straight standing pose, full-length head-to-toe framing, turned so that their right side faces the camera in a full profile, the head in profile too, this being a turn of the same body and never a mirror image of it so anything on one side of them stays on that side, their own hair exactly as the attached images show it, the same plain studio backdrop and even light`;
+  }
+}
+function syntheticIdentitySubject(direction, opts = {}) {
+  const person = `an adult, ${direction.trim()}: an original person who does not resemble any real, famous or public figure, mature adult facial structure`;
+  const framing = "head-and-shoulders portrait framing from just above the top of the head down to the collarbone, facing the camera straight-on, relaxed neutral expression, eyes to the lens";
+  const skin = "visible natural skin texture with pores and fine lines, no beauty filter, no digital smoothing, the plain studio backdrop and even frontal light";
+  const body = `${person}, ${framing}, wearing ${CAPTURE_UNIFORM}, ${skin}`;
+  const adjustment = opts.adjustment?.trim();
+  if (!adjustment) return body;
+  return `the same person as the attached image, changed only in this: ${adjustment}. That change is the point of this picture and overrides anything below that describes it otherwise. ${keptAspects(adjustment)}; ${body}`;
+}
+var ASPECTS = [
+  {
+    name: "face",
+    except: "the rest of the face",
+    words: /\b(face|facial|jaw|chin|cheeks?|cheekbones?|nose|mouth|lips?|teeth|smile|eyes?|eyelids?|eyebrows?|brows?|lashes|freckles?|beard|moustache|mustache|stubble|glasses|expression|skin|complexion|wrinkles?|scars?|birthmarks?|moles?|piercings?|studs?|makeup|make-up|eyeliner|lipstick)\b/i
+  },
+  {
+    name: "hair",
+    words: /\b(hair|haircut|hairline|bob|fringe|bangs|ponytail|bun|braids?|curls?|curly|straighter|bald|shaved|beard)\b/i
+  },
+  { name: "age", words: /\b(age|aged|older|younger|youthful|years old|teenage|[2-7]0s)\b/i },
+  {
+    name: "build",
+    words: /\b(build|body|frame|slim|slimmer|slender|thin|athletic|muscular|heavier|leaner|fuller|broader|broad|shoulders|weight|taller|shorter)\b/i
+  },
+  {
+    // What a body carries rather than what shape it is. Without this row an ask
+    // for a tattoo or a prosthetic arm shipped "otherwise identical in face,
+    // hair, age and build" beside it, which is a contradiction: the picture
+    // being asked for is not identical, that is the point of asking.
+    name: "marks and limbs",
+    except: "their other marks and limbs",
+    words: /\b(tattoos?|tattooed|scars?|birthmarks?|moles?|piercings?|prosthetics?|prosthesis|bionic|limbs?|arms?|hands?|legs?)\b/i
+  }
+];
+function keptAspects(adjustment) {
+  const kept = ASPECTS.map((a) => a.words.test(adjustment) ? a.except : a.name).filter((x) => !!x);
+  if (!kept.length) return "Otherwise the same person as the attached image";
+  const list2 = kept.length === 1 ? kept[0] : `${kept.slice(0, -1).join(", ")} and ${kept.at(-1)}`;
+  return `Otherwise identical to the attached image in ${list2}`;
+}
+var keepSentenceOf = (items) => items.map((i) => i.words).join(", ");
+function itemsFromKeep(keep) {
+  return (keep ?? "").split(",").map((w) => w.trim()).filter(Boolean).map((words, i) => ({ id: `said-${i}`, words }));
+}
+function sideNote(keep) {
+  return /\b(left|right)\b/i.test(keep) ? " (their own left and right, not the viewer's)" : "";
+}
+var KEEP_FACE = /\b(face|facial|jaw|chin|cheeks?|cheekbones?|nose|nostrils?|septum|mouth|lips?|teeth|smile|eyes?|eyelids?|eyebrows?|brows?|lashes|freckles?|beard|moustache|mustache|stubble|glasses|spectacles|ears?|lobes?|temples?|forehead|skin|complexion|wrinkles?|makeup|make-up|eyeliner|lipstick)\b/i;
+var KEEP_BODY = /\b(arms?|forearms?|wrists?|hands?|knuckles?|fingers?|shoulders?|back|chest|collarbones?|torso|stomach|waist|hips?|legs?|thighs?|calf|calves|ankles?|feet|foot|toes?|knees?|prosthetics?|prosthesis|bionic|limbs?|sleeve)\b/i;
+var ROW_LIVES = {
+  glasses: "face",
+  freckles: "face",
+  makeup: "face",
+  scar: "face",
+  piercing: "face"
+};
+function shows(view, item) {
+  const lives = ROW_LIVES[item.id];
+  const face = lives ? lives === "face" : KEEP_FACE.test(item.words);
+  const body = lives ? lives === "body" : KEEP_BODY.test(item.words);
+  if (face && !body) return view !== "back";
+  if (body && !face) return view !== "portrait";
+  return true;
+}
+function itemsFor(view, items) {
+  return items.filter((i) => shows(view, i));
+}
+function keepFor(view, items) {
+  return keepSentenceOf(itemsFor(view, items));
+}
+var ATTACHED_PERSON = "the exact person in the attached photographs";
+function identityOf2(rec) {
+  return {
+    said: (rec.direction ?? "").trim(),
+    read: rec.analysis ?? null,
+    items: rec.keepItems ?? itemsFromKeep(rec.keep),
+    edits: (rec.identityEdits ?? []).filter(Boolean)
+  };
+}
+function whoIs(id, view) {
+  if (!id) return ATTACHED_PERSON;
+  const bits = [];
+  const read = id.read;
+  const named = read?.promptName ?? "";
+  if (named && id.said.toLowerCase().includes(named.toLowerCase())) bits.push(id.said);
+  else if (named) bits.push(named);
+  else if (id.said) bits.push(id.said);
+  const already = (v) => bits.some((b) => b.toLowerCase().includes(v.toLowerCase()));
+  if (read?.hair && !already(read.hair)) bits.push(read.hair);
+  if (read?.identityNotes) bits.push(read.identityNotes);
+  if (id.said && !already(id.said)) bits.push(id.said);
+  const said = bits.filter(Boolean).join(", ") || ATTACHED_PERSON;
+  const keep = keepFor(view, id.items);
+  const who = keep ? `${said}, who also has ${keep}${sideNote(keep)}, which is part of who they are and is drawn in this view whether or not the attached images show it` : said;
+  if (!id.edits.length) return who;
+  return `${who}, except as changed here: ${id.edits.join("; ")}; the attached drawn views show the change`;
+}
+var RESULTS_MAX = 60;
+var isView = (v) => PRESENTER_VIEWS.includes(String(v));
+var isExtra = (v) => EXTRA_VIEWS.includes(v);
+var HASH = /^[a-f0-9]{32}$/;
+var fail = (message, statusCode) => Object.assign(new Error(message), { statusCode });
+var str4 = (v, max) => String(v ?? "").trim().slice(0, max);
+var emptySlot = () => ({ status: "empty", attempts: 0, rejected: [] });
+function fromRow(row) {
+  const j = row.json ?? {};
+  const views = {};
+  for (const v of PRESENTER_VIEWS) views[v] = { ...emptySlot(), ...j.views?.[v] ?? {} };
+  const rec = {
+    id: row.id,
+    brandId: row.brandId,
+    source: j.source === "synthetic" ? "synthetic" : "photos",
+    name: String(j.name ?? ""),
+    facets: Array.isArray(j.facets) ? j.facets.map(String) : [],
+    sources: Array.isArray(j.sources) ? j.sources.map(String) : [],
+    views,
+    extras: j.extras === true,
+    generations: Number(j.generations ?? 0),
+    activeView: isView(j.activeView) ? j.activeView : null,
+    stage: j.stage === "analyzing" || j.stage === "drawing" ? j.stage : "idle",
+    identityEdits: identityEditsOf(j.identityEdits),
+    asks: asksOf(j.asks),
+    results: resultsOf(j.results),
+    decisions: decisionsOf(j.decisions),
+    createdAt: row.createdAt,
+    updatedAt: row.updatedAt
+  };
+  if (j.direction) rec.direction = String(j.direction);
+  if (j.keep) rec.keep = String(j.keep);
+  if (j.setup) rec.setup = String(j.setup);
+  const keepItems = keepItemsOf(j.keepItems);
+  if (keepItems) rec.keepItems = keepItems;
+  const detailRefs = detailRefsOf(j.detailRefs);
+  if (detailRefs) rec.detailRefs = detailRefs;
+  if (j.attestation) rec.attestation = j.attestation;
+  if (j.analysis) rec.analysis = j.analysis;
+  if (j.readError) rec.readError = String(j.readError);
+  if (j.presenterId) rec.presenterId = String(j.presenterId);
+  if (j.baseId) rec.baseId = String(j.baseId);
+  if (Array.isArray(j.keptShots) && j.keptShots.length) rec.keptShots = j.keptShots.map(shotOf);
+  backfillRecord(rec);
+  return rec;
+}
+function backfillRecord(rec) {
+  if (rec.results.length) return;
+  const at = rec.updatedAt || rec.createdAt;
+  for (const v of PRESENTER_VIEWS) {
+    const s = rec.views[v];
+    if (!s.hash || s.origin !== "generated") continue;
+    if (s.adjustment && !rec.asks.some((a) => a.view === v && a.text === s.adjustment)) {
+      rec.asks = [...rec.asks, { view: v, text: s.adjustment, at }];
+    }
+    rec.results = [
+      ...rec.results,
+      { view: v, hash: s.hash, at, ...s.adjustment ? { ask: s.adjustment } : {}, how: "drawn" }
+    ];
+  }
+}
+var asksOf = (v) => (Array.isArray(v) ? v : []).filter((a) => isView(a?.view) && typeof a?.text === "string" && a.text.trim()).map((a) => ({ view: a.view, text: String(a.text), at: String(a.at ?? "") })).slice(-40);
+var resultsOf = (v) => (Array.isArray(v) ? v : []).filter((r) => isView(r?.view) && HASH.test(String(r?.hash ?? ""))).map((r) => ({
+  view: r.view,
+  hash: String(r.hash),
+  at: String(r.at ?? ""),
+  ...typeof r.ask === "string" && r.ask ? { ask: String(r.ask) } : {},
+  how: r.how === "restored" ? "restored" : "drawn"
+})).slice(-RESULTS_MAX);
+var decisionsOf = (v) => (Array.isArray(v) ? v : []).filter((d) => isView(d?.view) && ["use", "again", "keep"].includes(d?.what)).map((d) => ({ view: d.view, what: d.what, at: String(d.at ?? "") })).slice(-RESULTS_MAX);
+var shotOf = (s) => ({
+  file: String(s?.file ?? ""),
+  ...s?.angle ? { angle: String(s.angle) } : {},
+  ...s?.locked ? { locked: true } : {}
+});
+function put(core, rec) {
+  const { id, brandId, createdAt: _c, updatedAt: _u, ...json } = rec;
+  return fromRow(core.store.putPresenterDraft({ id, brandId, json }));
+}
+function mutate(core, id, fn) {
+  const rec = getPresenterDraft(core, id);
+  if (!rec) throw fail("draft not found", 404);
+  fn(rec);
+  return put(core, rec);
+}
+function getPresenterDraft(core, id) {
+  const row = core.store.getPresenterDraft(id);
+  return row ? fromRow(row) : null;
+}
+function bestPicture(rec) {
+  const drawn = PRESENTER_VIEWS.map((v) => rec.views[v]).find((s) => s.hash);
+  return rec.views.portrait.hash ?? drawn?.hash ?? rec.sources[0];
+}
+function summarisePresenterDraft(rec) {
+  const wanted = rec.extras ? PRESENTER_VIEWS : CORE_VIEWS;
+  const summary = {
+    id: rec.id,
+    name: rec.name,
+    source: rec.source,
+    updatedAt: rec.updatedAt,
+    createdAt: rec.createdAt,
+    stage: rec.stage,
+    approved: wanted.filter((v) => rec.views[v].status === "approved").length,
+    of: wanted.length,
+    drawing: rec.stage !== "idle" || !!rec.activeView,
+    // Drawn work a discard would throw away, decided or not. A photograph is
+    // still on disk as itself, so it does not count; a candidate face does,
+    // which counting approved views alone would have missed.
+    drawn: PRESENTER_VIEWS.some((v) => {
+      const s = rec.views[v];
+      return !!s.hash && s.origin !== "photo" && s.status !== "empty";
+    })
+  };
+  const hash = bestPicture(rec);
+  if (hash) summary.hash = hash;
+  if (rec.presenterId) summary.presenterId = rec.presenterId;
+  return summary;
+}
+function listPresenterDraftSummaries(core, brandId) {
+  return listPresenterDrafts(core, brandId).map(summarisePresenterDraft).sort((a, b) => a.createdAt < b.createdAt ? -1 : a.createdAt > b.createdAt ? 1 : a.id < b.id ? -1 : 1);
+}
+function listPresenterDrafts(core, brandId) {
+  return core.store.listPresenterDrafts(brandId).map(fromRow);
+}
+var running3 = /* @__PURE__ */ new Map();
+function runningDraftJobCount() {
+  return running3.size;
+}
+function sweepPresenterDrafts(core) {
+  let swept = 0;
+  for (const brand of core.store.listBrands()) {
+    for (const rec of listPresenterDrafts(core, brand.id)) {
+      const stuck = PRESENTER_VIEWS.filter((v) => rec.views[v].status === "generating");
+      if (!stuck.length && !rec.activeView && rec.stage === "idle") continue;
+      for (const v of stuck) {
+        const slot = rec.views[v];
+        slot.status = slot.hash ? "candidate" : "empty";
+        slot.error = "interrupted: server restarted mid-generation";
+        slot.startedAt = void 0;
+      }
+      rec.activeView = null;
+      rec.stage = "idle";
+      put(core, rec);
+      swept += 1;
+    }
+  }
+  return swept;
+}
+var KEEP_ITEM_CHARS = 200;
+var SETUP_CHARS = 4e4;
+var KEEP_ITEMS_MAX = 12;
+function keepItemsOf(raw, has) {
+  if (!Array.isArray(raw)) return void 0;
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const r of raw.slice(0, KEEP_ITEMS_MAX)) {
+    if (!r || typeof r !== "object") continue;
+    const words = str4(r.words, KEEP_ITEM_CHARS);
+    if (!words) continue;
+    let id = str4(r.id, 40) || "said";
+    while (seen.has(id)) id = `${id}+`;
+    seen.add(id);
+    const refs = (Array.isArray(r.refs) ? r.refs : []).map(String).filter((h) => HASH.test(h) && (!has || has(h))).slice(0, 4);
+    out.push(refs.length ? { id, words, refs } : { id, words });
+  }
+  return out;
+}
+function writeItems(r, items) {
+  r.keepItems = items.length ? items : void 0;
+  r.keep = keepSentenceOf(items) || void 0;
+  const refs = {};
+  for (const i of items) if (i.refs?.length) refs[i.id] = i.refs;
+  r.detailRefs = Object.keys(refs).length ? refs : void 0;
+}
+function detailRefsOf(raw, has) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return void 0;
+  const out = {};
+  for (const [k, v] of Object.entries(raw).slice(0, 8)) {
+    const key = str4(k, 40);
+    if (!key || !Array.isArray(v)) continue;
+    const hashes = v.map(String).filter((h) => HASH.test(h) && (!has || has(h))).slice(0, 4);
+    if (hashes.length) out[key] = hashes;
+  }
+  return Object.keys(out).length ? out : void 0;
+}
+async function createPresenterDraft(deps, input) {
+  const { core } = deps;
+  const brand = core.store.getBrand(input.brandId);
+  if (!brand) throw fail("brand not found", 404);
+  const source = input.source === "synthetic" ? "synthetic" : "photos";
+  const direction = str4(input.direction, 400);
+  const keep = str4(input.keep, 240);
+  const keepItems = keepItemsOf(input.keepItems, (h) => core.images.has(h));
+  const sources = (input.imageHashes ?? []).map(String).filter((h) => HASH.test(h) && core.images.has(h));
+  if (source === "synthetic" && !direction) throw fail("describe who they are in a sentence", 400);
+  if (source === "synthetic" && !deps.engine) throw fail("no engine here can draw a person", 400);
+  if (source === "photos" && !sources.length) throw fail("add at least one photo of this person", 400);
+  if (source === "photos" && !input.attestation) {
+    throw fail("confirm you have permission to use this person's likeness", 400);
+  }
+  const views = {};
+  for (const v of PRESENTER_VIEWS) views[v] = emptySlot();
+  const rec = {
+    id: `pd-${randomUUID().slice(0, 8)}`,
+    brandId: brand.id,
+    source,
+    name: str4(input.name, 60),
+    facets: (input.facets ?? []).map((f) => str4(f, 40)).filter(Boolean).slice(0, 8),
+    sources: source === "photos" ? sources : [],
+    views,
+    extras: input.extras === true,
+    generations: 0,
+    activeView: null,
+    stage: "idle",
+    identityEdits: [],
+    asks: [],
+    results: [],
+    decisions: [],
+    createdAt: "",
+    updatedAt: ""
+  };
+  if (keepItems) writeItems(rec, keepItems);
+  else {
+    if (keep) rec.keep = keep;
+    const detailRefs = detailRefsOf(input.detailRefs, (h) => core.images.has(h));
+    if (detailRefs) rec.detailRefs = detailRefs;
+  }
+  if (source === "synthetic") rec.direction = direction;
+  else {
+    rec.attestation = { attestedAt: (/* @__PURE__ */ new Date()).toISOString(), version: LIKENESS_VERSION };
+    if (direction) rec.direction = direction;
+  }
+  const saved = put(core, rec);
+  if (source === "photos") startJob(deps, saved.id, null, (signal) => filePhotos(deps, saved.id, signal));
+  return saved;
+}
+var hashOfFile = (file) => {
+  const s = String(file ?? "");
+  return s.startsWith("asset:") && HASH.test(s.slice(6)) ? s.slice(6) : null;
+};
+var seedDirection = (p) => {
+  const said = str4(p.identityNotes ?? p.descriptor ?? p.promptName, 400);
+  if (said) return said;
+  return str4([p.presentation, p.ageRange, p.hair && `${p.hair} hair`].filter(Boolean).join(", "), 400);
+};
+function slotsFromRecord(presenter) {
+  const sources = (presenter.sourceRefs ?? []).map((s) => hashOfFile(s.file)).filter((h) => !!h);
+  const views = {};
+  for (const v of PRESENTER_VIEWS) views[v] = emptySlot();
+  const kept = [];
+  const shots = presenter.shots ?? [];
+  const hasPortrait = shots.some((s) => s.angle === "portrait" && hashOfFile(s.file));
+  shots.forEach((shot, i) => {
+    const hash = hashOfFile(shot.file);
+    const angle = !hasPortrait && i === 0 ? "portrait" : shot.angle;
+    if (hash && isView(angle) && views[angle].status === "empty") {
+      const origin = sources.includes(hash) ? "photo" : "generated";
+      views[angle] = { ...emptySlot(), status: "approved", hash, origin };
+    } else kept.push({ ...shot });
+  });
+  return { views, kept, sources };
+}
+function seedDraftFromPresenter(core, brandId, presenter) {
+  const { views, kept, sources } = slotsFromRecord(presenter);
+  const source = presenter.source ?? (presenter.sourceRefs?.length ? "photos" : "synthetic");
+  const direction = seedDirection(presenter);
+  const rec = {
+    id: `pd-${randomUUID().slice(0, 8)}`,
+    brandId,
+    source,
+    name: str4(presenter.name, 60),
+    facets: (presenter.suitableCategories ?? []).map((f) => str4(f, 40)).filter(Boolean).slice(0, 8),
+    sources,
+    views,
+    // Every one of them, not any: a record carrying a single supplementary
+    // view was never a record whose owner asked for the whole set, and
+    // reading it that way made the save demand two more nobody wanted.
+    extras: EXTRA_VIEWS.every((v) => views[v].status !== "empty"),
+    generations: 0,
+    activeView: null,
+    stage: "idle",
+    presenterId: presenter.id,
+    baseId: presenter.id,
+    identityEdits: identityEditsOf(presenter.identityEdits),
+    asks: [],
+    results: [],
+    decisions: [],
+    createdAt: "",
+    updatedAt: ""
+  };
+  if (direction) rec.direction = direction;
+  if (presenter.likeness) rec.attestation = presenter.likeness;
+  if (kept.length) rec.keptShots = kept;
+  return put(core, rec);
+}
+function openPresenterEdit(core, brandId, presenterId) {
+  const brand = core.store.getBrand(brandId);
+  if (!brand) throw fail("brand not found", 404);
+  const rows = brandCharacters(brand.json);
+  const asked = rows.find((c) => c?.id === presenterId);
+  if (!asked) throw fail("presenter not found", 404);
+  if (!isCustomPresenter(asked)) throw fail("this presenter is not editable", 400);
+  const headId = headOf(brand.json, presenterId);
+  const head = rows.find((c) => c?.id === headId);
+  return listPresenterDrafts(core, brandId).find((d) => d.presenterId === headId) ?? seedDraftFromPresenter(core, brandId, head);
+}
+var IDENTITY_WORDS = [
+  "hair",
+  "fringe",
+  "bangs",
+  "curls",
+  "beard",
+  "moustache",
+  "mustache",
+  "stubble",
+  "eyebrows",
+  "eyebrow",
+  "brows",
+  "brow",
+  "eyes",
+  "eye",
+  "lashes",
+  "nose",
+  "lips",
+  "mouth",
+  "teeth",
+  "smile",
+  "chin",
+  "jawline",
+  "jaw",
+  "cheekbones",
+  "cheeks",
+  "ears",
+  "neck",
+  "skin",
+  "freckles",
+  "scar",
+  "mole",
+  "tattoo",
+  "wrinkles",
+  "glasses",
+  "earrings",
+  "earring",
+  "piercing",
+  "makeup",
+  "age",
+  "older",
+  "younger",
+  "build",
+  "weight",
+  "height",
+  "shoulders"
+];
+var TRAIT_ALIAS = {
+  fringe: "hair",
+  bangs: "hair",
+  curls: "hair",
+  mustache: "moustache",
+  stubble: "beard",
+  eyebrow: "brow",
+  eyebrows: "brow",
+  brows: "brow",
+  eye: "eyes",
+  lashes: "eyes",
+  jawline: "jaw",
+  cheeks: "cheekbones",
+  earring: "earrings",
+  older: "age",
+  younger: "age",
+  weight: "build",
+  height: "build"
+};
+var TRAIT = new RegExp(`\\b(${IDENTITY_WORDS.join("|")})\\b`, "i");
+function traitOf(sentence) {
+  const m = TRAIT.exec(sentence);
+  if (!m) return null;
+  const word = m[1].toLowerCase();
+  return TRAIT_ALIAS[word] ?? word;
+}
+function mergeIdentityEdits(existing, adjustment) {
+  const next = str4(adjustment, IDENTITY_EDIT_CHARS).replace(/\s+/g, " ");
+  if (!next) return existing.slice(-IDENTITY_EDITS_MAX);
+  const trait = traitOf(next);
+  const kept = existing.filter((e) => e.toLowerCase() !== next.toLowerCase() && (!trait || traitOf(e) !== trait));
+  return [...kept, next].slice(-IDENTITY_EDITS_MAX);
+}
+async function filePhotos(deps, id, signal) {
+  const { core, analyzer } = deps;
+  const rec = getPresenterDraft(core, id);
+  if (!rec) return;
+  let analysis;
+  let readError;
+  if (analyzer) {
+    mutate(core, id, (r) => {
+      r.stage = "analyzing";
+    });
+    try {
+      analysis = await analyzer.analyze(
+        {
+          kind: "presenter",
+          imagePaths: rec.sources.map((h) => core.images.pathFor(h)),
+          name: rec.name || "New presenter",
+          instruction: rec.direction || void 0,
+          vocabulary: deps.vocabulary,
+          classifyPhotos: true
+        },
+        signal
+      );
+    } catch (err) {
+      if (signal.aborted) return;
+      readError = String(err?.message ?? "the photos could not be read");
+    }
+  }
+  if (signal.aborted) return;
+  mutate(core, id, (r) => {
+    if (analysis) r.analysis = analysis;
+    r.readError = readError;
+  });
+}
+function startJob(deps, id, view, work) {
+  const ctrl = new AbortController();
+  running3.set(id, { view, ctrl });
+  void work(ctrl.signal).catch(() => {
+  }).finally(() => {
+    running3.delete(id);
+    try {
+      mutate(deps.core, id, (r) => {
+        r.activeView = null;
+        r.stage = "idle";
+      });
+    } catch {
+    }
+  });
+}
+async function generateView(deps, id, view, opts = {}) {
+  const { core, engine } = deps;
+  if (!isView(view)) throw fail("no such view", 400);
+  let rec = getPresenterDraft(core, id);
+  if (!rec) throw fail("draft not found", 404);
+  if (running3.has(id)) throw fail("a view is still being drawn", 409);
+  if (isExtra(view) && !rec.extras) throw fail("extra views are built on request", 400);
+  if (rec.source === "synthetic" && !rec.direction?.trim()) {
+    const said = str4(opts.adjustment, 400);
+    if (!said) throw fail("describe who they are in a sentence", 400);
+    rec = mutate(core, id, (r) => {
+      r.direction = said;
+    });
+  }
+  if (opts.decide === "auto" && HAND_APPROVED.has(view))
+    throw fail(`the ${VIEW_LABEL[view]} is always decided by hand`, 400);
+  for (const dep of DEPENDS[view]) {
+    if (rec.views[dep].status !== "approved") throw fail(`approve the ${VIEW_LABEL[dep]} first`, 400);
+  }
+  if (!engine || !engine.capabilities().maxReferenceImages) throw fail("no engine here can draw a person", 400);
+  const adjustment = str4(opts.adjustment, 240) || void 0;
+  const decide = opts.decide === "auto" ? "auto" : void 0;
+  const before = rec.views[view].status;
+  const saved = mutate(core, id, (r) => {
+    r.views[view].status = "generating";
+    r.views[view].error = void 0;
+    r.views[view].startedAt = (/* @__PURE__ */ new Date()).toISOString();
+    r.activeView = view;
+    r.stage = "drawing";
+    const last = r.asks[r.asks.length - 1];
+    if (adjustment && !(last && last.view === view && last.text === adjustment)) {
+      r.asks = [...r.asks, { view, text: adjustment, at: (/* @__PURE__ */ new Date()).toISOString() }].slice(-40);
+    }
+  });
+  startJob(deps, id, view, (signal) => drawView(deps, id, view, before, adjustment, decide, signal));
+  return { draft: saved };
+}
+async function drawView(deps, id, view, before, adjustment, decide, signal) {
+  const { core, engine, analyzer } = deps;
+  const caps = engine.capabilities();
+  let rec = getPresenterDraft(core, id);
+  try {
+    if (!rec.analysis && analyzer && view !== "portrait" && rec.views.portrait.hash) {
+      mutate(core, id, (r) => {
+        r.stage = "analyzing";
+      });
+      const analysis = await analyzer.analyze(
+        {
+          kind: "presenter",
+          imagePaths: [core.images.pathFor(rec.views.portrait.hash)],
+          name: rec.name || "New presenter",
+          instruction: rec.direction || void 0,
+          vocabulary: deps.vocabulary
+        },
+        signal
+      );
+      rec = mutate(core, id, (r) => {
+        r.analysis = analysis;
+        r.stage = "drawing";
+      });
+    }
+    if (signal.aborted) throw new Error("cancelled");
+    const { prompt, refs, roles } = planStep(rec, view, adjustment, caps.maxReferenceImages);
+    const builtOn = new Map(refDeps(rec, view).map((v) => [v, rec.views[v].hash]));
+    const paths = [];
+    for (const h of refs) {
+      const p = core.images.pathFor(h);
+      paths.push(caps.maxReferenceEdge ? await capReferenceEdge(core, p, caps.maxReferenceEdge) : p);
+    }
+    const drawn = await draw(deps, {
+      prompt,
+      brandId: rec.brandId,
+      ...paths.length ? { referenceImages: paths, referenceRoles: roles } : {},
+      signal
+    });
+    const hash = await trimEdgeBars(core, drawn);
+    mutate(core, id, (r) => {
+      const slot = r.views[view];
+      if (slot.hash && slot.hash !== hash) {
+        if (before === "approved") {
+          if (slot.prior && slot.prior !== slot.hash && !r.sources.includes(slot.prior)) {
+            slot.rejected = [...slot.rejected, slot.prior];
+          }
+          slot.prior = slot.hash;
+        } else if (slot.origin === "generated") slot.rejected = [...slot.rejected, slot.hash];
+      }
+      slot.status = "candidate";
+      slot.hash = hash;
+      slot.origin = "generated";
+      slot.attempts += 1;
+      slot.conditionedOn = refs;
+      slot.adjustment = adjustment;
+      slot.error = void 0;
+      slot.startedAt = void 0;
+      r.generations += 1;
+      r.results = [
+        ...r.results,
+        { view, hash, at: (/* @__PURE__ */ new Date()).toISOString(), ...adjustment ? { ask: adjustment } : {}, how: "drawn" }
+      ].slice(-RESULTS_MAX);
+      if (decide === "auto") {
+        slot.status = "approved";
+        if (slot.prior) staleDependents(r, view);
+      }
+      for (const [v, was] of builtOn) {
+        if (r.views[v].hash !== was) {
+          slot.status = "stale";
+          break;
+        }
+      }
+    });
+  } catch (err) {
+    mutate(core, id, (r) => {
+      const slot = r.views[view];
+      if (!slot.hash && slot.prior) {
+        slot.hash = slot.prior;
+        slot.prior = void 0;
+        slot.origin = "generated";
+        slot.status = dependents(view).some((v) => r.views[v].hash) ? "approved" : "candidate";
+      } else slot.status = before === "generating" ? slot.hash ? "candidate" : "empty" : before;
+      slot.attempts += 1;
+      if (adjustment) slot.adjustment = adjustment;
+      slot.error = signal.aborted ? "cancelled" : String(err?.message ?? "the view could not be drawn");
+      slot.startedAt = void 0;
+      r.generations += 1;
+    });
+  }
+}
+function rolledFrom(rec) {
+  const id = identityOf2(rec);
+  const said = id.said.replace(/[.\s]+$/, "");
+  const keep = keepFor("portrait", id.items);
+  if (!keep) return said;
+  return said ? `${said}, ${keep}` : keep;
+}
+var namesASide = (text) => /\b(left|right)\b/i.test(text ?? "");
+function refDeps(rec, view) {
+  const deps = DEPENDS[view];
+  if (view !== "right" || !namesASide(rec.keep)) return deps;
+  return deps.filter((d) => d !== "left");
+}
+function usableSource(rec, hash) {
+  const filings = rec.analysis?.photos;
+  if (!filings?.length) return true;
+  const i = rec.sources.indexOf(hash);
+  const said = filings.find((p) => p.index === i);
+  return said ? said.usable !== false : true;
+}
+function planStep(rec, view, adjustment, cap2) {
+  const slot = rec.views[view];
+  const id = identityOf2(rec);
+  const room = Math.max(1, cap2);
+  const shown = itemsFor(view, id.items);
+  const wanted = rec.keepItems ? [...new Set(shown.flatMap((i) => i.refs ?? []))] : [...new Set(Object.values(rec.detailRefs ?? {}).flat())];
+  const roll = rec.source === "synthetic" && view === "portrait";
+  const identity = [];
+  if (roll) {
+    if (adjustment && slot.hash) identity.push(slot.hash);
+  } else {
+    for (const dep of refDeps(rec, view)) {
+      const h = rec.views[dep].hash;
+      if (h && rec.views[dep].status === "approved" && !identity.includes(h)) identity.push(h);
+    }
+    const stood = rec.sources.filter((h) => usableSource(rec, h));
+    for (const h of stood.length ? stood : rec.sources) if (!identity.includes(h)) identity.push(h);
+  }
+  const hold = wanted.length && identity.length >= room ? 1 : 0;
+  const kept = identity.slice(0, Math.max(1, room - hold));
+  const extra = wanted.filter((h) => !kept.includes(h)).slice(0, Math.max(0, room - kept.length));
+  const dropped = [
+    ...identity.slice(kept.length).map((h) => `identity ${h}: no room`),
+    ...wanted.filter((h) => !kept.includes(h) && !extra.includes(h)).map((h) => `detail ${h}: no room`),
+    ...id.items.filter((i) => i.refs?.length && !shown.includes(i)).map((i) => `detail ${i.id}: not shown in this view`)
+  ];
+  const refs = [...kept, ...extra];
+  const roles = [...kept.map(() => "character"), ...extra.map(() => "detail")];
+  const named = shown.filter((i) => (i.refs ?? []).some((h) => extra.includes(h)));
+  const legend = named.length ? ` The attached detail pictures show, in this order: ${named.map((i) => i.words).join("; ")}.` : "";
+  const who = whoIs(id, view);
+  const subject = roll ? syntheticIdentitySubject(rolledFrom(rec), { adjustment: kept.length ? adjustment : void 0 }) : adjustment ? (
+    // The ask is scoped to this view and has to win where it meets the
+    // view's own fixed clauses, which is why the override sentence rides
+    // with it: every non-face subject already pins "the same person as the
+    // attached images" and "their own hair exactly as the attached images
+    // show it", so a repair that names hair or a feature was asking for one
+    // thing and being told the opposite in the same breath. A second
+    // "otherwise identical" would not have settled that; saying which one
+    // wins does. What the ask does not name is then held still, the same
+    // way it is on a described person's face.
+    `${viewSubject(view, who)}. For this view only: ${adjustment}. That change is the point of this picture and overrides anything above that describes it otherwise. ${keptAspects(adjustment)}`
+  ) : viewSubject(view, who);
+  return { prompt: studioPrompt(subject) + legend, refs, roles, dropped };
+}
+async function approveView(deps, id, view) {
+  if (!isView(view)) throw fail("no such view", 400);
+  const rec = getPresenterDraft(deps.core, id);
+  if (!rec) throw fail("draft not found", 404);
+  const slot = rec.views[view];
+  if (slot.status === "approved") {
+    if (!slot.prior) return rec;
+    return mutate(deps.core, id, (r) => {
+      const s = r.views[view];
+      if (s.prior && !r.sources.includes(s.prior)) s.rejected = [...s.rejected, s.prior];
+      s.prior = void 0;
+    });
+  }
+  if (slot.status === "stale") throw fail(`redo the ${VIEW_LABEL[view]}: it was built on a view you changed`, 400);
+  if (slot.status !== "candidate" || !slot.hash) throw fail(`there is no ${VIEW_LABEL[view]} to approve yet`, 400);
+  return mutate(deps.core, id, (r) => {
+    const s = r.views[view];
+    s.status = "approved";
+    r.decisions = [...r.decisions, { view, what: "use", at: (/* @__PURE__ */ new Date()).toISOString() }].slice(-RESULTS_MAX);
+    if (s.prior) {
+      if (!r.sources.includes(s.prior)) s.rejected = [...s.rejected, s.prior];
+      s.prior = void 0;
+    }
+    reconcileDependents(r, view);
+    if (view === "portrait" && r.presenterId && s.adjustment) {
+      r.identityEdits = mergeIdentityEdits(r.identityEdits, s.adjustment);
+    }
+  });
+}
+async function revertView(deps, id, view) {
+  if (!isView(view)) throw fail("no such view", 400);
+  if (running3.has(id)) throw fail("a view is still being drawn", 409);
+  const rec = getPresenterDraft(deps.core, id);
+  if (!rec) throw fail("draft not found", 404);
+  if (!rec.views[view].prior) throw fail(`there is no previous ${VIEW_LABEL[view]} to keep`, 400);
+  return mutate(deps.core, id, (r) => {
+    const s = r.views[view];
+    const prior = s.prior;
+    if (s.hash && s.hash !== prior && !r.sources.includes(s.hash)) s.rejected = [...s.rejected, s.hash];
+    s.hash = prior;
+    s.origin = r.sources.includes(prior) ? "photo" : "generated";
+    s.status = "approved";
+    s.prior = void 0;
+    s.adjustment = void 0;
+    s.conditionedOn = void 0;
+    s.error = void 0;
+    r.decisions = [...r.decisions, { view, what: "keep", at: (/* @__PURE__ */ new Date()).toISOString() }].slice(-RESULTS_MAX);
+  });
+}
+async function restoreView(deps, id, view, hash) {
+  if (!isView(view)) throw fail("no such view", 400);
+  if (!HASH.test(String(hash))) throw fail("no such picture", 400);
+  if (running3.has(id)) throw fail("a view is still being drawn", 409);
+  const rec = getPresenterDraft(deps.core, id);
+  if (!rec) throw fail("draft not found", 404);
+  const slot = rec.views[view];
+  const known = rec.results.some((r) => r.view === view && r.hash === hash) || slot.prior === hash || slot.rejected.includes(hash);
+  if (!known) throw fail(`that was never the ${VIEW_LABEL[view]}`, 400);
+  if (!existsSync(deps.core.images.pathFor(hash))) throw fail("that picture is gone", 410);
+  if (slot.hash === hash) return rec;
+  const from = [...rec.results].reverse().find((r) => r.view === view && r.hash === hash);
+  return mutate(deps.core, id, (r) => {
+    const s = r.views[view];
+    const was = s.hash;
+    if (s.prior && s.prior !== was && s.prior !== hash && !r.sources.includes(s.prior)) {
+      s.rejected = [...s.rejected, s.prior];
+    }
+    if (was) s.prior = was;
+    s.rejected = s.rejected.filter((h) => h !== hash);
+    s.hash = hash;
+    s.origin = r.sources.includes(hash) ? "photo" : "generated";
+    s.adjustment = from?.ask;
+    s.conditionedOn = void 0;
+    s.error = void 0;
+    reconcileDependents(r, view);
+  });
+}
+function dependents(view) {
+  return PRESENTER_VIEWS.filter((v) => v !== view && reaches(v, view));
+}
+function reaches(from, to) {
+  return DEPENDS[from].some((d) => d === to || reaches(d, to));
+}
+function stillStands(r, view) {
+  const on = r.views[view].conditionedOn;
+  if (!on?.length) return false;
+  for (const h of on) {
+    const owner = r.results.find((x) => x.hash === h)?.view;
+    if (!owner || owner === view) continue;
+    if (r.views[owner].hash !== h) return false;
+  }
+  return true;
+}
+function reconcileDependents(r, view) {
+  for (const d of dependents(view)) {
+    const s = r.views[d];
+    if (!s.hash) continue;
+    if (stillStands(r, d)) {
+      if (s.status === "stale") s.status = "approved";
+    } else if (s.status === "approved" || s.status === "candidate") s.status = "stale";
+  }
+}
+function staleDependents(r, view) {
+  for (const d of dependents(view)) {
+    const s = r.views[d];
+    if (s.origin === "photo") continue;
+    if (s.status === "approved" || s.status === "candidate") s.status = "stale";
+  }
+}
+async function redoView(deps, id, view) {
+  if (!isView(view)) throw fail("no such view", 400);
+  if (running3.has(id)) throw fail("a view is still being drawn", 409);
+  return mutate(deps.core, id, (r) => {
+    const slot = r.views[view];
+    const gone = [slot.prior].filter((h) => !!h && h !== slot.hash && !r.sources.includes(h));
+    r.views[view] = {
+      ...emptySlot(),
+      attempts: slot.attempts,
+      rejected: [...slot.rejected, ...gone],
+      ...slot.hash && !r.sources.includes(slot.hash) ? { prior: slot.hash } : {}
+    };
+    if (view === "portrait" && r.source === "synthetic") r.analysis = void 0;
+    r.decisions = [...r.decisions, { view, what: "again", at: (/* @__PURE__ */ new Date()).toISOString() }].slice(-RESULTS_MAX);
+  });
+}
+async function usePhotoForView(deps, id, view, hash) {
+  if (!isView(view)) throw fail("no such view", 400);
+  if (running3.has(id)) throw fail("a view is still being drawn", 409);
+  const rec = getPresenterDraft(deps.core, id);
+  if (!rec) throw fail("draft not found", 404);
+  if (rec.source !== "photos" || !rec.sources.includes(hash)) throw fail("that is not one of their photos", 400);
+  return mutate(deps.core, id, (r) => {
+    const slot = r.views[view];
+    if (slot.hash === hash && slot.origin === "photo") return;
+    const gone = [slot.hash, slot.prior].filter((h) => !!h && !r.sources.includes(h));
+    r.views[view] = {
+      ...emptySlot(),
+      attempts: slot.attempts,
+      rejected: [...slot.rejected, ...gone],
+      status: "approved",
+      hash,
+      origin: "photo"
+    };
+    staleDependents(r, view);
+  });
+}
+async function updatePresenterDraft(core, id, patch2) {
+  return mutate(core, id, (r) => {
+    if (patch2.extras !== void 0) r.extras = patch2.extras === true;
+    if (patch2.name !== void 0) r.name = str4(patch2.name, 60);
+    if (Array.isArray(patch2.facets))
+      r.facets = patch2.facets.map((f) => str4(f, 40)).filter(Boolean).slice(0, 8);
+    if (patch2.direction !== void 0) r.direction = str4(patch2.direction, 400) || void 0;
+    if (patch2.setup !== void 0) r.setup = str4(patch2.setup, SETUP_CHARS) || void 0;
+    const items = keepItemsOf(patch2.keepItems, (h) => core.images.has(h));
+    if (items) writeItems(r, items);
+    else {
+      if (patch2.keep !== void 0) r.keep = str4(patch2.keep, 240) || void 0;
+      if (patch2.detailRefs !== void 0) r.detailRefs = detailRefsOf(patch2.detailRefs, (h) => core.images.has(h));
+    }
+  });
+}
+async function savePresenterDraft(deps, id, hooks = {}) {
+  const { core } = deps;
+  const rec = getPresenterDraft(core, id);
+  if (!rec) throw fail("draft not found", 404);
+  if (running3.has(id)) throw fail("a view is still being drawn", 409);
+  if (rec.presenterId) return saveEdit(deps, rec, hooks);
+  if (!rec.name.trim()) throw fail("give them a name", 400);
+  const blind = !deps.engine;
+  const required = blind ? ["portrait"] : [...CORE_VIEWS, ...EXTRA_VIEWS.filter((v) => rec.views[v].status !== "empty")];
+  for (const v of required) {
+    const s = rec.views[v];
+    if (s.status === "stale") throw fail(`redo the ${VIEW_LABEL[v]}: it was built on a view you changed`, 400);
+    if (s.status !== "approved" || !s.hash) throw fail(`approve the ${VIEW_LABEL[v]} first`, 400);
+  }
+  const approved = required.map((v) => rec.views[v].hash);
+  const shots = blind ? [...approved, ...rec.sources.filter((h) => !approved.includes(h))] : approved;
+  const angles = blind ? ["portrait"] : [...required];
+  const portraitFile = `asset:${shots[0]}`;
+  const sourceFiles = rec.sources.map((h) => `asset:${h}`);
+  const mode = presenterCropMode(portraitFile, sourceFiles, "portrait");
+  const { previewHash, avatarHash } = await presenterCrops(core, shots[0], mode);
+  const a = rec.analysis;
+  const built = presenterRecordFrom({
+    name: rec.name,
+    shotHashes: shots,
+    shotAngles: angles,
+    ...rec.sources.length ? { sourceHashes: rec.sources } : {},
+    previewHash,
+    avatarHash,
+    promptName: a?.promptName ?? (rec.source === "synthetic" ? rec.direction : void 0),
+    presentation: a?.presentation,
+    descriptor: a?.descriptor,
+    ageRange: a?.ageRange,
+    hair: a?.hair,
+    identityNotes: keptNotes(rec, a),
+    negativeConstraints: a?.negativeConstraints,
+    // What the person filing this chose wins over what the analyzer guessed.
+    suitableCategories: rec.facets.length ? rec.facets : a?.suitableCategories,
+    facial: a?.facial,
+    skin: a?.skin,
+    build: a?.build,
+    source: rec.source,
+    ...rec.source === "photos" && rec.attestation ? { likeness: rec.attestation } : {}
+  });
+  if (!built.ok) throw fail(built.error, 400);
+  commit(
+    core,
+    rec.brandId,
+    (json) => {
+      json.characters = [...brandCharacters(json), built.presenter];
+    },
+    // the row goes with the append, in one transaction: see `commit`
+    id
+  );
+  removeUnreferenced(core, letGoOf(rec), hooks);
+  return { presenter: built.presenter, brand: core.store.getBrand(rec.brandId) };
+}
+function keptNotes(rec, a) {
+  const keep = rec.keep?.trim();
+  const said = keep ? /[.!?]$/.test(keep) ? keep : `${keep}.` : "";
+  return [said, a?.identityNotes ?? ""].filter(Boolean).join(" ") || void 0;
+}
+function letGoOf(rec) {
+  return PRESENTER_VIEWS.flatMap((v) => {
+    const s = rec.views[v];
+    return [...s.rejected, ...s.prior && s.prior !== s.hash ? [s.prior] : []];
+  });
+}
+async function saveEdit(deps, rec, hooks) {
+  const { core } = deps;
+  const brand = core.store.getBrand(rec.brandId);
+  if (!brand) throw fail("brand not found", 404);
+  const base = brandCharacters(brand.json).find((c) => c?.id === rec.presenterId);
+  if (!base) throw fail("this presenter no longer exists", 404);
+  const moved = () => fail("this presenter changed elsewhere; reload to continue", 409);
+  const baseId = rec.baseId ?? "";
+  if (!baseId || headOf(brand.json, baseId) !== baseId) throw moved();
+  if (!rec.name.trim()) throw fail("give them a name", 400);
+  const seeded = slotsFromRecord(base);
+  const required = PRESENTER_VIEWS.filter((v) => rec.views[v].status !== "empty" || seeded.views[v].status !== "empty");
+  for (const v of required) {
+    const s = rec.views[v];
+    if (s.status === "stale") throw fail(`redo the ${VIEW_LABEL[v]}: it was built on a view you changed`, 400);
+    if (s.status !== "approved" || !s.hash) throw fail(`approve the ${VIEW_LABEL[v]} first`, 400);
+  }
+  const views = required.map((v) => ({ hash: rec.views[v].hash, angle: v }));
+  const kept = rec.keptShots ?? [];
+  const nextFiles = [...views.map((v) => `asset:${v.hash}`), ...kept.map((k) => k.file)];
+  const baseFiles = (base.shots ?? []).map((s) => s.file);
+  const samePictures = nextFiles.length === baseFiles.length && nextFiles.every((f) => baseFiles.includes(f));
+  const sameEdits = JSON.stringify(rec.identityEdits) === JSON.stringify(base.identityEdits ?? []);
+  const direction = rec.direction ?? "";
+  const sameDirection = direction === seedDirection(base);
+  let head;
+  if (samePictures && sameEdits && sameDirection) {
+    const built = presenterRecordFrom({ name: rec.name, suitableCategories: rec.facets }, base);
+    if (!built.ok) throw fail(built.error, 400);
+    const patched = built.presenter;
+    commit(core, rec.brandId, (json) => {
+      if (headOf(json, baseId) !== baseId) throw moved();
+      json.characters = brandCharacters(json).map((c) => c.id === base.id ? patched : c);
+    });
+    head = patched;
+  } else {
+    if (!views.length) throw fail("approve the face first", 400);
+    const first = views[0];
+    const mode = presenterCropMode(
+      `asset:${first.hash}`,
+      rec.sources.map((h) => `asset:${h}`),
+      first.angle
+    );
+    const { previewHash, avatarHash } = await presenterCrops(core, first.hash, mode);
+    const built = mintRevision(base, {
+      name: rec.name,
+      shotHashes: views.map((v) => v.hash),
+      shotAngles: views.map((v) => v.angle),
+      ...rec.sources.length ? { sourceHashes: rec.sources } : {},
+      previewHash,
+      avatarHash,
+      suitableCategories: rec.facets,
+      identityEdits: rec.identityEdits,
+      // Recorded, never inferred: a record with no source stays without one.
+      ...base.source ? { source: rec.source } : {},
+      ...sameDirection ? {} : { identityNotes: direction },
+      // A read taken in this session describes the face as it is now; with
+      // none, the record's own words and casting prose carry.
+      ...readWords(rec.analysis)
+    });
+    if (!built.ok) throw fail(built.error, 400);
+    const faceMoved = rec.views.portrait.hash !== seeded.views.portrait.hash;
+    const carried = faceMoved ? [] : kept;
+    const minted = carried.length ? { ...built.presenter, shots: [...built.presenter.shots ?? [], ...carried] } : built.presenter;
+    commit(core, rec.brandId, (json) => {
+      if (headOf(json, baseId) !== baseId) throw moved();
+      json.characters = [
+        ...brandCharacters(json).map((c) => c.id === base.id ? { ...c, supersededBy: minted.id } : c),
+        minted
+      ];
+    });
+    head = minted;
+  }
+  core.store.deletePresenterDraft(rec.id);
+  removeUnreferenced(core, letGoOf(rec), hooks);
+  return { presenter: head, brand: core.store.getBrand(rec.brandId) };
+}
+function readWords(a) {
+  if (!a) return {};
+  const out = {};
+  const said = (v) => v != null && v !== "" && !(Array.isArray(v) && !v.length);
+  if (said(a.promptName)) out.promptName = a.promptName;
+  if (said(a.presentation)) out.presentation = a.presentation;
+  if (said(a.descriptor)) out.descriptor = a.descriptor;
+  if (said(a.ageRange)) out.ageRange = a.ageRange;
+  if (said(a.hair)) out.hair = a.hair;
+  if (said(a.negativeConstraints)) out.negativeConstraints = a.negativeConstraints;
+  if (said(a.facial)) out.facial = a.facial;
+  if (said(a.skin)) out.skin = a.skin;
+  if (said(a.build)) out.build = a.build;
+  return out;
+}
+async function stopPresenterDraft(deps, id) {
+  const rec = getPresenterDraft(deps.core, id);
+  if (!rec) throw fail("draft not found", 404);
+  const job = running3.get(id);
+  if (!job) return rec;
+  job.ctrl.abort();
+  for (let i = 0; i < 500 && running3.has(id); i++) await new Promise((r) => setTimeout(r, 10));
+  return getPresenterDraft(deps.core, id) ?? rec;
+}
+async function discardPresenterDraft(deps, id, hooks = {}) {
+  running3.get(id)?.ctrl.abort();
+  running3.delete(id);
+  const rec = getPresenterDraft(deps.core, id);
+  if (!rec) return;
+  dropDraft(deps.core, rec, hooks);
+}
+async function releasePresenter(deps, brandId, presenter, hooks = {}) {
+  for (const d of listPresenterDrafts(deps.core, brandId)) {
+    if (d.presenterId === presenter.id) await discardPresenterDraft(deps, d.id, hooks);
+  }
+  const held = [
+    ...(presenter.shots ?? []).map((s) => s?.file),
+    ...presenter.sourceRefs ?? [],
+    presenter.preview,
+    presenter.avatar
+  ];
+  removeUnreferenced(
+    deps.core,
+    held.map(hashOfFile).filter((h) => !!h),
+    hooks
+  );
+}
+var ABANDONED_DRAFT_MS = 14 * 24 * 60 * 60 * 1e3;
+function sweepAbandonedPresenterDrafts(core, hooks = {}, now = Date.now()) {
+  let swept = 0;
+  for (const brand of core.store.listBrands()) {
+    for (const rec of listPresenterDrafts(core, brand.id)) {
+      if (running3.has(rec.id)) continue;
+      const touched = stampMs(rec.updatedAt);
+      if (Number.isNaN(touched) || now - touched < ABANDONED_DRAFT_MS) continue;
+      dropDraft(core, rec, hooks);
+      swept += 1;
+    }
+  }
+  return swept;
+}
+function stampMs(s) {
+  const iso = s.includes("T") ? s : s.replace(" ", "T");
+  return Date.parse(/Z$|[+-]\d\d:\d\d$/.test(iso) ? iso : `${iso}Z`);
+}
+function dropDraft(core, rec, hooks) {
+  core.store.deletePresenterDraft(rec.id);
+  const generated = PRESENTER_VIEWS.flatMap((v) => {
+    const s = rec.views[v];
+    return [...s.rejected, ...s.hash && s.origin === "generated" ? [s.hash] : [], ...s.prior ? [s.prior] : []];
+  });
+  removeUnreferenced(core, [...generated, ...rec.sources], hooks);
+}
+function removeUnreferenced(core, hashes, hooks) {
+  const brands = core.store.listBrands().map((b) => JSON.stringify(b.json));
+  for (const h of new Set(hashes)) {
+    if (!HASH.test(h)) continue;
+    if (core.store.imageReferenced(h)) continue;
+    if (brands.some((b) => b.includes(h))) continue;
+    if (core.images.remove(h)) hooks.evict?.(h);
+  }
+}
+
 // src/routes/assetBuilds.ts
-function registerAssetBuildRoutes(app, deps) {
+function makeBuildDeps(deps) {
   const { core, engines, scenes, presenters } = deps;
   const analyzer = deps.analyzer ?? createCodexAnalyzer({ runner: engines.codexRunner });
-  const buildEngine = async () => {
-    const ordered = [...engines.all()].sort((a, b) => {
-      const rank = (e) => e.capabilities().id === "codex-cli" ? 0 : 1;
-      return rank(a) - rank(b);
-    });
-    for (const engine of ordered) {
-      const caps = engine.capabilities();
-      if (!caps.maxReferenceImages || caps.placeholder) continue;
-      if ((await engine.isAvailable()).ok) return engine;
-    }
-    return null;
-  };
+  const allowPlaceholder = process.env.SCENRI_DEMO_BUILDS === "1";
+  const buildEngine = () => pickBuildEngine(engines, { allowPlaceholder });
   const buildDeps = async () => ({
     core,
     engine: await buildEngine(),
@@ -9109,8 +10696,17 @@ function registerAssetBuildRoutes(app, deps) {
     // person can actually click rather than inventing a category of one.
     vocabulary: { ...facetsOf(scenes), categories: presenterFacetsOf(presenters).categories }
   });
+  return { buildEngine, buildDeps, analyzer };
+}
+function registerAssetBuildRoutes(app, deps) {
+  const { core } = deps;
+  const { buildEngine, buildDeps, analyzer } = makeBuildDeps(deps);
+  const hooks = { evict: (hash) => deps.thumbs?.evict(hash) };
   app.get("/api/asset-builds/capabilities", async () => {
-    const [engine, probe] = await Promise.all([buildEngine(), analyzer?.isAvailable() ?? { ok: false }]);
+    const [engine, probe] = await Promise.all([
+      buildEngine(),
+      analyzer?.isAvailable() ?? Promise.resolve({ ok: false })
+    ]);
     return {
       canAnalyze: probe.ok,
       analyzeReason: probe.ok ? null : probe.reason ?? null,
@@ -9140,8 +10736,9 @@ function registerAssetBuildRoutes(app, deps) {
     if (!brand) return;
     const body = req.body ?? {};
     const kind = String(body.kind ?? "");
-    if (kind !== "presenter" && kind !== "scene")
-      return reply.status(400).send({ error: "kind must be presenter|scene" });
+    if (kind === "presenter")
+      return reply.status(400).send({ error: "presenters are cast in the studio now: POST /api/brands/:id/presenter-drafts" });
+    if (kind !== "scene") return reply.status(400).send({ error: "kind must be scene" });
     try {
       return startAssetBuild(await buildDeps(), {
         brandId: brand.id,
@@ -9215,6 +10812,32 @@ function registerAssetBuildRoutes(app, deps) {
     }
     return { presenter: built.presenter, brand: core.store.getBrand(brand.id) };
   });
+  app.post("/api/brands/:id/presenters/:presenterId/revert", async (req, reply) => {
+    const brand = brandOr404(req, reply);
+    if (!brand) return;
+    const id = String(req.params.presenterId);
+    const rows = brandCharacters(brand.json);
+    const current = rows.find((c) => c.id === id);
+    if (!current) return reply.status(404).send({ error: "presenter not found" });
+    if (!isCustomPresenter(current)) return reply.status(400).send({ error: "this presenter is not editable" });
+    const older = current.revisionOf && !current.supersededBy ? rows.find((c) => c.id === current.revisionOf) : void 0;
+    if (!older) return reply.status(400).send({ error: "nothing to revert" });
+    try {
+      commit(core, brand.id, (json) => {
+        json.characters = brandCharacters(json).map((c) => {
+          if (c.id === older.id) {
+            const { supersededBy: _cleared, ...head } = c;
+            return head;
+          }
+          return c.id === current.id ? { ...c, supersededBy: older.id } : c;
+        });
+      });
+    } catch (err) {
+      return reply.status(err.statusCode ?? 500).send({ error: err.message });
+    }
+    const after = core.store.getBrand(brand.id);
+    return { presenter: brandCharacters(after?.json).find((c) => c.id === older.id), brand: after };
+  });
   app.delete("/api/brands/:id/presenters/:presenterId", async (req, reply) => {
     const brand = brandOr404(req, reply);
     if (!brand) return;
@@ -9225,7 +10848,8 @@ function registerAssetBuildRoutes(app, deps) {
     commit(core, brand.id, (json) => {
       json.characters = brandCharacters(json).filter((c) => c.id !== id);
     });
-    return { ok: true };
+    await releasePresenter(await buildDeps(), brand.id, base, hooks);
+    return { ok: true, brand: core.store.getBrand(brand.id) };
   });
   app.post("/api/brands/:id/scenes", async (req, reply) => {
     const brand = brandOr404(req, reply);
@@ -9338,14 +10962,191 @@ async function withDerivedCrops(core, body, base) {
   const shots = Array.isArray(body?.shotHashes) ? body.shotHashes : null;
   if (!shots?.length || body.previewHash !== void 0 && body.avatarHash !== void 0) return body;
   const firstShot = `asset:${String(shots[0])}`;
-  const firstSource = Array.isArray(body.sourceHashes) ? `asset:${String(body.sourceHashes[0])}` : base?.sourceRefs?.[0]?.file;
-  const derived = await presenterCrops(core, String(shots[0]), presenterCropMode(firstShot, firstSource));
+  const sourceFiles = Array.isArray(body.sourceHashes) ? body.sourceHashes.map((h) => `asset:${String(h)}`) : (base?.sourceRefs ?? []).map((s) => s?.file);
+  const angles = Array.isArray(body.shotAngles) ? body.shotAngles : [];
+  const firstAngle = angles[0] ?? base?.shots?.find((s) => s?.file === firstShot)?.angle;
+  const derived = await presenterCrops(core, String(shots[0]), presenterCropMode(firstShot, sourceFiles, firstAngle));
   return {
     ...body,
     ...body.previewHash === void 0 && derived.previewHash ? { previewHash: derived.previewHash } : {},
     ...body.avatarHash === void 0 && derived.avatarHash ? { avatarHash: derived.avatarHash } : {}
   };
 }
+
+// src/routes/presenterDrafts.ts
+function registerPresenterDraftRoutes(app, deps) {
+  const { core, thumbs } = deps;
+  const { buildDeps } = makeBuildDeps(deps);
+  const hooks = { evict: (hash) => thumbs.evict(hash) };
+  const brandOr404 = (req, reply) => {
+    const brand = core.store.getBrand(String(req.params.id));
+    if (!brand) {
+      reply.status(404).send({ error: "brand not found" });
+      return null;
+    }
+    return brand;
+  };
+  const draftOr404 = (req, reply) => {
+    const brand = brandOr404(req, reply);
+    if (!brand) return null;
+    const draft = getPresenterDraft(core, String(req.params.draftId));
+    if (!draft || draft.brandId !== brand.id) {
+      reply.status(404).send({ error: "draft not found" });
+      return null;
+    }
+    return draft;
+  };
+  const answer = async (reply, work) => {
+    try {
+      return await work();
+    } catch (err) {
+      return reply.status(err?.statusCode ?? 500).send({ error: err?.message ?? "something went wrong" });
+    }
+  };
+  const viewOf = (req) => String(req.params.view);
+  app.post("/api/brands/:id/presenter-drafts", async (req, reply) => {
+    const brand = brandOr404(req, reply);
+    if (!brand) return;
+    const body = req.body ?? {};
+    return answer(
+      reply,
+      async () => createPresenterDraft(await buildDeps(), {
+        brandId: brand.id,
+        source: body.source === "synthetic" ? "synthetic" : "photos",
+        direction: body.direction == null ? void 0 : String(body.direction),
+        keep: body.keep == null ? void 0 : String(body.keep),
+        keepItems: body.keepItems,
+        detailRefs: body.detailRefs,
+        imageHashes: Array.isArray(body.imageHashes) ? body.imageHashes.map((h) => String(h)) : [],
+        attestation: body.attestation === true,
+        name: body.name == null ? void 0 : String(body.name),
+        facets: Array.isArray(body.facets) ? body.facets.map((f) => String(f)) : [],
+        extras: body.extras === true
+      })
+    );
+  });
+  app.get("/api/brands/:id/presenter-drafts", async (req, reply) => {
+    const brand = brandOr404(req, reply);
+    if (!brand) return;
+    return { drafts: listPresenterDraftSummaries(core, brand.id) };
+  });
+  app.post("/api/brands/:id/presenters/:presenterId/edit", async (req, reply) => {
+    const brand = brandOr404(req, reply);
+    if (!brand) return;
+    return answer(reply, async () => openPresenterEdit(core, brand.id, String(req.params.presenterId)));
+  });
+  app.get("/api/brands/:id/presenter-drafts/:draftId", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    return draft;
+  });
+  app.patch("/api/brands/:id/presenter-drafts/:draftId", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    const body = req.body ?? {};
+    return answer(
+      reply,
+      () => updatePresenterDraft(core, draft.id, {
+        name: body.name,
+        facets: body.facets,
+        direction: body.direction,
+        keep: body.keep,
+        keepItems: body.keepItems,
+        setup: body.setup,
+        detailRefs: body.detailRefs,
+        extras: body.extras
+      })
+    );
+  });
+  app.get("/api/brands/:id/presenter-drafts/:draftId/views/:view/plan", async (req, reply) => {
+    if (!process.env.SCENRI_DEBUG) return reply.status(404).send({ error: "not found" });
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    const view = viewOf(req);
+    if (!PRESENTER_VIEWS.includes(view))
+      return reply.status(400).send({ error: "no such view" });
+    return answer(reply, async () => {
+      const { engine } = await buildDeps();
+      const cap2 = engine?.capabilities().maxReferenceImages ?? 0;
+      const adjustment = req.query?.adjustment;
+      const step = planStep(draft, view, adjustment == null ? void 0 : String(adjustment), cap2);
+      return {
+        view,
+        cap: cap2,
+        ...step,
+        held: {
+          source: draft.source,
+          direction: draft.direction ?? "",
+          keep: draft.keep ?? "",
+          detailRefs: draft.detailRefs ?? null,
+          identityEdits: draft.identityEdits ?? [],
+          analysis: draft.analysis ?? null,
+          sources: draft.sources
+        }
+      };
+    });
+  });
+  app.post("/api/brands/:id/presenter-drafts/:draftId/views/:view/generate", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    const body = req.body ?? {};
+    return answer(
+      reply,
+      async () => generateView(await buildDeps(), draft.id, viewOf(req), {
+        adjustment: body.adjustment == null ? void 0 : String(body.adjustment),
+        decide: body.decide === "auto" ? "auto" : void 0
+      })
+    );
+  });
+  app.post("/api/brands/:id/presenter-drafts/:draftId/views/:view/approve", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    return answer(reply, async () => approveView(await buildDeps(), draft.id, viewOf(req)));
+  });
+  app.post("/api/brands/:id/presenter-drafts/:draftId/views/:view/redo", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    return answer(reply, async () => redoView(await buildDeps(), draft.id, viewOf(req)));
+  });
+  app.post("/api/brands/:id/presenter-drafts/:draftId/views/:view/revert", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    return answer(reply, async () => revertView(await buildDeps(), draft.id, viewOf(req)));
+  });
+  app.post("/api/brands/:id/presenter-drafts/:draftId/views/:view/restore", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    const hash = String(req.body?.hash ?? "");
+    return answer(reply, async () => restoreView(await buildDeps(), draft.id, viewOf(req), hash));
+  });
+  app.post("/api/brands/:id/presenter-drafts/:draftId/views/:view/use-photo", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    const body = req.body ?? {};
+    return answer(
+      reply,
+      async () => usePhotoForView(await buildDeps(), draft.id, viewOf(req), String(body.hash ?? ""))
+    );
+  });
+  app.post("/api/brands/:id/presenter-drafts/:draftId/save", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    return answer(reply, async () => savePresenterDraft(await buildDeps(), draft.id, hooks));
+  });
+  app.post("/api/brands/:id/presenter-drafts/:draftId/stop", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    return answer(reply, async () => stopPresenterDraft(await buildDeps(), draft.id));
+  });
+  app.delete("/api/brands/:id/presenter-drafts/:draftId", async (req, reply) => {
+    const draft = draftOr404(req, reply);
+    if (!draft) return;
+    return answer(reply, async () => {
+      await discardPresenterDraft(await buildDeps(), draft.id, hooks);
+      return { ok: true };
+    });
+  });
+}
 function registerDemoProductRoutes(app, deps) {
   const { templatesRoot, demoProducts, demoProductById, thumbs } = deps;
   const demoProductThumbPath = (id) => {
@@ -9824,13 +11625,12 @@ function registerImageRoutes(app, deps) {
     return reply.send(thumbs.stream(path));
   });
   app.post("/api/images", async (req, reply) => {
-    const part = await req.file();
-    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();
-    return { hash: core.images.save(png) };
+    const part = await readImagePart(core, req, async (buf) => {
+      const fmt = (await sharp21(buf).metadata().catch(() => null))?.format;
+      return fmt === "svg" ? await toMarkPng(buf) : await sharp21(buf).rotate().png().toBuffer();
+    });
+    if ("error" in part) return reply.status(400).send({ error: part.error });
+    return { hash: part.hash };
   });
   app.post("/api/diff", async (req, reply) => {
     const { imageA, imageB } = req.body;
@@ -9851,6 +11651,21 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.10.0",
+    date: "2026-09-16",
+    title: "Presenters are cast by talking to Scenri, one question at a time.",
+    sections: [
+      {
+        heading: "Presenters",
+        body: "Casting a presenter is a conversation: describe someone or add a few photos, and their portrait arrives first, then each further view as you go. Editing a saved presenter opens that same conversation, seeded from what is already there, and every change becomes a new version you can step back through. An unfinished presenter is saved as a draft and offered back the next time you open Presenters, and deleting one clears it everywhere it was used."
+      },
+      {
+        heading: "Products",
+        body: "Importing a store's products shows its progress in the library as it happens, carrying the brand's own mark and a running clock. A site that is rate-limiting requests is reported as such instead of looking like an empty import, and a run that stops partway keeps what it already found rather than losing it."
+      }
+    ]
+  },
   {
     version: "0.9.4",
     date: "2026-09-14",
@@ -10859,7 +12674,7 @@ function registerDesktopRoutes(app, deps) {
         record: null
       };
     }
-    const { installDeps } = await import('./cli-MQO66C5O.js');
+    const { installDeps } = await import('./cli-EXASA5BK.js');
     const { desktopStatus } = await import('./install-VXJPLYWM.js');
     return desktopStatus(installDeps(runtime.entry));
   });
@@ -10867,7 +12682,7 @@ function registerDesktopRoutes(app, deps) {
     if (!runtime.entry) {
       return { ok: false, reason: "unsupported", message: "Desktop shortcuts are not available on this system yet." };
     }
-    const { addToDesktop } = await import('./cli-MQO66C5O.js');
+    const { addToDesktop } = await import('./cli-EXASA5BK.js');
     return addToDesktop(runtime.entry);
   });
   app.get("/api/desktop", async () => {
@@ -11153,7 +12968,10 @@ function buildServer(opts) {
   const presentersDir = join(templatesRoot, "presenters");
   const { presenters } = loadPresenters(presentersDir);
   registerPresenterRoutes(app, { templatesRoot, presenters, thumbs });
-  registerAssetBuildRoutes(app, { core, engines, analyzer: opts.analyzer, scenes, presenters });
+  registerAssetBuildRoutes(app, { core, engines, analyzer: opts.analyzer, scenes, presenters, thumbs });
+  sweepPresenterDrafts(core);
+  sweepAbandonedPresenterDrafts(core, { evict: (hash) => thumbs.evict(hash) });
+  registerPresenterDraftRoutes(app, { core, engines, analyzer: opts.analyzer, scenes, presenters, thumbs });
   const { demoProducts } = loadDemoProducts(join(templatesRoot, "demo-products"));
   const demoProductById = demoProductResolver(demoProducts);
   registerDemoProductRoutes(app, { templatesRoot, demoProducts, demoProductById, thumbs });
@@ -12287,7 +14105,7 @@ function buildServer(opts) {
     // one physical run counts once, however many sibling nodes share its
     // controller — an update gate held open by a 4-shot batch is still held
     // open by exactly one piece of work
-    busyCount: () => new Set(runningGenerations.values()).size + runningImportCount() + runningAssetBuildCount()
+    busyCount: () => new Set(runningGenerations.values()).size + runningImportCount() + runningAssetBuildCount() + runningDraftJobCount()
   });
   let drained = null;
   app.decorate("drain", () => {
@@ -12309,7 +14127,7 @@ function buildServer(opts) {
     core,
     runtime,
     exitImpl: opts.exitImpl,
-    busyCount: () => new Set(runningGenerations.values()).size + runningImportCount() + runningAssetBuildCount()
+    busyCount: () => new Set(runningGenerations.values()).size + runningImportCount() + runningAssetBuildCount() + runningDraftJobCount()
   });
   if (opts.studioDist && existsSync(opts.studioDist)) {
     const dist = opts.studioDist;
@@ -12354,6 +14172,7 @@ async function run() {
   const core = createCore();
   const stubs = process.env.SCENRI_DEMO_ENGINE === "1" ? [createDemoEngine((b) => core.images.save(b), demoOptionsFromEnv(process.env))] : [];
   const engines = createEngineRegistry(core, stubs);
+  const analyzer = process.env.SCENRI_DEMO_ANALYSIS === "usable" || process.env.SCENRI_DEMO_ANALYSIS === "unusable" ? createDemoAnalyzer({ photos: process.env.SCENRI_DEMO_ANALYSIS }) : void 0;
   const here = dirname(fileURLToPath(import.meta.url));
   const candidates = [join(here, "..", "..", "..", "apps", "studio", "dist"), join(here, "..", "studio-dist")];
   const studioDist = candidates.find((p) => existsSync(p));
@@ -12365,6 +14184,7 @@ async function run() {
   const app = buildServer({
     core,
     engines,
+    analyzer,
     studioDist,
     access: { allowedHosts: reachableAt, token },
     runtime: {
@@ -12470,7 +14290,7 @@ async function run() {
     }
   }
   const ownEntry = fileURLToPath(import.meta.url);
-  const { addToDesktop, installDeps } = await import('./cli-MQO66C5O.js');
+  const { addToDesktop, installDeps } = await import('./cli-EXASA5BK.js');
   const { refreshLauncher } = await import('./refresh-5HBDLLLB.js');
   const { askOnTerminal, offerDesktop, shouldOfferDesktop } = await import('./offer-W6NJXMWT.js');
   const { launcherInstalled } = await import('./paths-6ZXRZUHY.js');