scenri 0.6.13 → 0.7.1

package/dist/serve.js

@@ -10,7 +10,7 @@ import fs, { realpathSync, existsSync, readFileSync, mkdirSync, chmodSync, write
 import { fileURLToPath } from 'url';
 import { readFile, copyFile, stat, mkdtemp, rm, readdir, writeFile } from 'fs/promises';
 import { spawn } from 'child_process';
-import sharp19 from 'sharp';
+import sharp20 from 'sharp';
 import Fastify from 'fastify';
 import fastifyStatic from '@fastify/static';
 import fastifyMultipart from '@fastify/multipart';
@@ -1295,7 +1295,13 @@ var REFERENCE_ROLE_DIRECTIVE = {
   // names staged objects as stand-ins rather than just "no product": a bare
   // prohibition still left the demo object in the frame, because the model had
   // nowhere to put what the photograph so vividly showed.
-  scene: "a reference for this world and for the treatment applied to the figure in it \u2014 match the environment, the light, and the material, density, scale, finish and spread of that treatment, including which parts of the form it covers and how far it reaches; take no identity from the person in it, and treat any product, garment or prop staged in it as a stand-in whose place the attached subject takes \u2014 never an object to reproduce",
+  //
+  // The carve-out leads. It used to sit forty words in, one subordinate
+  // clause after a paragraph of "match this" - and the tester case (a close
+  // portrait as the scene image beside a selected presenter) showed which
+  // half the model heard. Every treatment clause is retained word for word;
+  // only the order and the register of the identity refusal changed.
+  scene: "a reference for this world, never for a person: take no identity from the person in it \u2014 not their face, not their likeness \u2014 they are an anonymous stand-in whose place the attached subject takes. Match the environment, the light, and the material, density, scale, finish and spread of the treatment applied to the figure, including which parts of the form it covers and how far it reaches; treat any product, garment or prop staged in it as the same kind of stand-in, demonstrating placement and scale \u2014 never an object to reproduce",
   composition: "a reference for framing, camera angle and pose only \u2014 take no subject, color, material or branding from it",
   style: "a reference for overall treatment and mood only \u2014 take no composition, subject or product detail from it",
   reference: "a reference to match in composition, lighting and treatment"
@@ -1304,11 +1310,12 @@ var EDIT_REFERENCE_ROLE_DIRECTIVE = {
   product: "the exact product: keep or restore its label, shape and design faithfully",
   character: "the exact person: keep their face, facial structure, skin, hair and build faithfully; take no clothing, pose or background from this reference, and keep the source image's existing outfit unless the instruction changes it",
   brand: "the brand's own mark: reproduce it exactly as drawn wherever it appears \u2014 every character down to the smallest secondary lettering, in its original script and reading direction \u2014 never redrawn, re-lettered, translated or transliterated",
-  scene: "a reference for environment and light only",
+  scene: "a reference for environment, light and treatment only \u2014 take no identity from any person in it",
   composition: "a reference for framing and pose only",
   style: "a reference for treatment and mood only",
   reference: "a reference for composition, lighting and treatment only"
 };
+var BUDGET_EXHAUSTED = "scenri:budget-exhausted";
 var ASPECT_TOLERANCE = 0.15;
 var NAMED_RATIOS = [
   ["1:1", 1],
@@ -1332,6 +1339,14 @@ function ratioLabel(width, height) {
   const d = gcd(width, height) || 1;
   return `${Math.round(width / d)}:${Math.round(height / d)}`;
 }
+function budgetSize(width, height, pixelBudget) {
+  const ratio = width / height;
+  if (!(ratio > 0) || !Number.isFinite(ratio) || !(pixelBudget > 0)) return { width, height };
+  return {
+    width: Math.round(Math.sqrt(pixelBudget * ratio)),
+    height: Math.round(Math.sqrt(pixelBudget / ratio))
+  };
+}
 
 // ../core/src/index.ts
 function defaultHome() {
@@ -1349,6 +1364,7 @@ function createCore(homeDir = defaultHome()) {
   };
 }
 var ENDPOINT = "https://openrouter.ai/api/v1/chat/completions";
+var PER_IMAGE_TIMEOUT_MS = 3e5;
 var DEFAULT_MODEL = "google/gemini-2.5-flash-image";
 var DEFAULT_COST_PER_IMAGE_USD = 0.04;
 function dataUrl(path) {
@@ -1387,6 +1403,7 @@ function createOpenRouterEngine(opts) {
     return key;
   }
   async function post(key, body, signal) {
+    const bound = AbortSignal.timeout(PER_IMAGE_TIMEOUT_MS);
     const res = await fetchImpl(ENDPOINT, {
       method: "POST",
       headers: {
@@ -1394,7 +1411,7 @@ function createOpenRouterEngine(opts) {
         "Content-Type": "application/json"
       },
       body: JSON.stringify(body),
-      signal
+      signal: signal ? AbortSignal.any([signal, bound]) : bound
     });
     const text = await res.text();
     if (!res.ok) {
@@ -1437,7 +1454,11 @@ function createOpenRouterEngine(opts) {
         localOnly: false,
         supportsEdit: true,
         supportsMask: false,
-        maxReferenceImages: 4
+        maxReferenceImages: 4,
+        // N sequential calls, one image each: the server budgets the node by
+        // that shape instead of handing the whole run one flat ten minutes.
+        perImageTimeoutMs: PER_IMAGE_TIMEOUT_MS,
+        imageConcurrency: 1
       };
     },
     async isAvailable() {
@@ -1458,12 +1479,14 @@ function createOpenRouterEngine(opts) {
         const role = roles[i] ?? "reference";
         return refs.length > 1 ? `Attached image ${i + 1} is ${roleDirective[role]}.` : `The attached image is ${roleDirective[role]}.`;
       }).join(" ");
+      const identityCoda = roles.includes("character") && roles.some((r) => r === "scene" || r === "reference") ? "Identity check: the person in this image comes only from the character reference image(s); the scene and reference images lend world, composition, lighting and treatment \u2014 take no face or likeness from them." : null;
       const content = [
         { type: "text", text: refDirectives ? `${req.prompt} ${refDirectives}` : req.prompt },
         ...refs.map((p) => ({
           type: "image_url",
           image_url: { url: dataUrl(p) }
-        }))
+        })),
+        ...identityCoda ? [{ type: "text", text: identityCoda }] : []
       ];
       const body = {
         model: opts.model ?? DEFAULT_MODEL,
@@ -1476,7 +1499,12 @@ function createOpenRouterEngine(opts) {
       let reportedCost = 0;
       let sawReportedCost = false;
       for (let i = 0; i < req.count; i++) {
-        const json = await post(key, body, signal);
+        const variation = req.variations?.[i];
+        const json = await post(
+          key,
+          variation ? { ...body, messages: [{ role: "user", content: [...content, { type: "text", text: variation }] }] } : body,
+          signal
+        );
         raws.push(json);
         for (const buf of extractImages(json)) hashes.push(opts.saveImage(buf));
         if (typeof json?.usage?.cost === "number") {
@@ -2511,20 +2539,12 @@ function createCodexSetup(opts = {}) {
 
 // ../engines/codex/src/index.ts
 var CODEX_POOL = 2;
-function codexNodeBudgetMs(count) {
-  return Math.ceil(Math.max(1, count) / CODEX_POOL) * DEFAULT_TIMEOUT_MS2 + 6e4;
-}
 function orientationOf(width, height) {
   return width === height ? "square" : width > height ? "landscape" : "portrait";
 }
 var CODEX_PIXEL_BUDGET = 1572864;
 function codexNativeSize(width, height) {
-  const ratio = width / height;
-  if (!(ratio > 0) || !Number.isFinite(ratio)) return { width, height };
-  return {
-    width: Math.round(Math.sqrt(CODEX_PIXEL_BUDGET * ratio)),
-    height: Math.round(Math.sqrt(CODEX_PIXEL_BUDGET / ratio))
-  };
+  return budgetSize(width, height, CODEX_PIXEL_BUDGET);
 }
 function refFileNames(roles, count) {
   const perRole = /* @__PURE__ */ new Map();
@@ -2550,7 +2570,7 @@ function createCodexEngine(opts) {
       return /* @__PURE__ */ new Set();
     }
   }
-  async function collectImages(dir, before = null) {
+  async function collectImages(dir, before = null, claimed) {
     const entries = await readdir(dir);
     const outFiles = entries.filter((name) => /^out-.*\.png$/.test(name)).sort((a, b) => {
       const na = Number(/^out-(\d+)\.png$/.exec(a)?.[1] ?? NaN);
@@ -2560,7 +2580,7 @@ function createCodexEngine(opts) {
     });
     if (outFiles.length === 0) {
       if (before) {
-        const recovered = await recoverFromGenerated(before);
+        const recovered = await recoverFromGenerated(before, claimed);
         if (recovered) return [recovered];
       }
       throw new Error("Codex finished but produced no images");
@@ -2573,11 +2593,11 @@ function createCodexEngine(opts) {
     }
     return hashes;
   }
-  async function recoverFromGenerated(before) {
+  async function recoverFromGenerated(before, claimed) {
     const home = generatedImagesDir();
     let names;
     try {
-      names = (await readdir(home)).filter((n) => !before.has(n));
+      names = (await readdir(home)).filter((n) => !before.has(n) && !claimed?.has(n));
     } catch {
       return null;
     }
@@ -2585,6 +2605,7 @@ function createCodexEngine(opts) {
     const stamped = await Promise.all(names.map(async (n) => ({ n, mtime: (await stat(join(home, n))).mtimeMs })));
     stamped.sort((a, b) => b.mtime - a.mtime);
     const pick2 = stamped[0].n;
+    claimed?.add(pick2);
     console.warn(`codex: workdir empty, recovered ${pick2} from ${home}`);
     return saveImage(await readFile(join(home, pick2)));
   }
@@ -2597,6 +2618,10 @@ function createCodexEngine(opts) {
         // OSS-local only: the user's own session, on the user's own machine
         supportsEdit: true,
         supportsMask: false,
+        // The image tool draws at this fixed pixel count (measured, the
+        // native-size probe): an edit of a larger source steps down honestly
+        // instead of being upscaled back into pixels the tool never drew.
+        editPixelBudget: CODEX_PIXEL_BUDGET,
         /*
          * Five, and it is a hard constraint of the image tool, not a product
          * choice.
@@ -2630,7 +2655,12 @@ function createCodexEngine(opts) {
          * budget — a full-resolution phone-photo PNG is tens of megabytes that
          * buy nothing. Same cap as brand marks (MARK_MAX_EDGE).
          */
-        maxReferenceEdge: 2048
+        maxReferenceEdge: 2048,
+        // One exec per image at CODEX_POOL at a time, each carrying its own
+        // full timer. The server turns these two numbers into the node bound,
+        // which is the same arithmetic codexNodeBudgetMs states above.
+        perImageTimeoutMs: DEFAULT_TIMEOUT_MS2,
+        imageConcurrency: CODEX_POOL
       };
     },
     isAvailable() {
@@ -2644,8 +2674,9 @@ function createCodexEngine(opts) {
       const refs = req.referenceImages ?? [];
       const roles = req.referenceRoles ?? refs.map(() => "reference");
       const inner = new AbortController();
-      const onOuterAbort = () => inner.abort();
-      if (signal?.aborted) inner.abort();
+      const claimed = /* @__PURE__ */ new Set();
+      const onOuterAbort = () => inner.abort(signal?.reason);
+      if (signal?.aborted) inner.abort(signal.reason);
       else signal?.addEventListener("abort", onOuterAbort, { once: true });
       const jobs = Array.from(
         { length: count },
@@ -2664,7 +2695,7 @@ function createCodexEngine(opts) {
             stdin: buildPrompt2(req, i, roles),
             label: `gen v${i + 1}/${count} refs=${refs.length} refKB=${Math.round(refBytes / 1024)}`
           });
-          return collectImages(dir, before);
+          return collectImages(dir, before, claimed);
         })
       );
       const results = new Array(count);
@@ -2678,7 +2709,7 @@ function createCodexEngine(opts) {
             try {
               results[i] = await jobs[i]();
             } catch (err) {
-              if (signal?.aborted) throw err;
+              if (signal?.aborted && signal.reason !== BUDGET_EXHAUSTED) throw err;
               results[i] = [];
               failures.push(err);
               if (fatal == null && isFatalSetupError(err)) {
@@ -2761,10 +2792,10 @@ function createCodexEngine(opts) {
     );
   }
   function buildPrompt2(req, index, roles) {
+    const variation = req.variations?.[index] ?? "";
     const roleDirective = REFERENCE_ROLE_DIRECTIVE;
     const names = refFileNames(roles, roles.length);
     const refDirectives = roles.map((role, i) => `${names[i]} shows ${roleDirective[role]}.`).join(" ");
-    const count = Math.max(1, req.count);
     const native = codexNativeSize(req.width, req.height);
     return (
       // "professional-grade", not "flawless": the audit of the waxy-presenter
@@ -2778,13 +2809,19 @@ function createCodexEngine(opts) {
       // to the requested one, and the aspect check passed BECAUSE of the shear
       // - the reported crushed faces. Copy/move stays licensed because the
       // win32 recovery path moves files out of generated_images.
-      ` Do not browse the web or explore files. Save the tool's output in the current directory as out-1.png, byte-for-byte unchanged: you may run the commands needed to copy or move the file, but never resize, scale, stretch, pad, crop or re-encode it \u2014 deliver the tool's own pixels at the tool's own size. Nothing else.` + // Every take in a batch gets the SAME-shaped clause. Take 1 used to get
-      // nothing - so the first output was literally asked for the most
-      // reference-faithful decode - and later takes were licensed to a
-      // "different composition", which read as permission to drift from the
-      // directives. Reported as: output #1 copies the scene reference, output
-      // #2 mixes identities. A single generation stays byte-stable.
-      (count > 1 ? ` (take ${index + 1} of ${count} \u2014 same brief, same identities and constraints, a naturally different moment and framing of the same shoot)` : "")
+      ` Do not browse the web or explore files. Save the tool's output in the current directory as out-1.png, byte-for-byte unchanged: you may run the commands needed to copy or move the file, but never resize, scale, stretch, pad, crop or re-encode it \u2014 deliver the tool's own pixels at the tool's own size. Nothing else.` + // The set clause, built once by the server for the whole run and handed
+      // over index-aligned with the output slots. It carries the photographic
+      // move this frame explores and the locks every frame shares.
+      //
+      // What used to be here was a COUNTER — "take 3 of 4". Every take got the
+      // same-shaped sentence, so this was already the hardened version, and the
+      // drift survived it: a rising take number is not neutral text. In shoot
+      // language it reads as "we have already done that, go further", a licence
+      // to deviate that grows with the output index, which is precisely the
+      // reported shape (output 1 holds the presenter, 2 and 3 and 4 drift). No
+      // frame is described in terms of any other frame now, and no number
+      // reaches the model at all.
+      (variation ? ` ${variation}` : "")
     );
   }
 }
@@ -2831,7 +2868,7 @@ function createDemoEngine(saveImage) {
       <text x="24" y="${h - 48}" font-family="Helvetica, Arial" font-size="${Math.max(14, Math.round(w / 42))}" fill="#ffffff" opacity="0.92">${esc(label)}</text>
       <text x="24" y="${h - 22}" font-family="Helvetica, Arial" font-size="12" fill="#ffffff" opacity="0.6">Scenri demo engine</text>
     </svg>`;
-    return sharp19(Buffer.from(svg)).png().toBuffer();
+    return sharp20(Buffer.from(svg)).png().toBuffer();
   }
   return {
     capabilities() {
@@ -3000,14 +3037,22 @@ function presenterRefPath(templatesRoot, id, slot) {
 function presenterAvatarPath(templatesRoot, id) {
   return contentFile(templatesRoot, "previews", "presenters", id, "avatar.jpg");
 }
+var resolvedRefs = /* @__PURE__ */ new Map();
+async function refHash(core, path) {
+  const hit = resolvedRefs.get(path);
+  if (hit && core.images.has(hit)) return hit;
+  const hash = core.images.save(await sharp20(readFileSync(path)).png().toBuffer());
+  resolvedRefs.set(path, hash);
+  return hash;
+}
 async function resolvePresenterImages(core, templatesRoot, presenter) {
   const shots = [];
+  const avatar = presenterAvatarPath(templatesRoot, presenter.id);
+  if (existsSync(avatar)) shots.push({ file: `asset:${await refHash(core, avatar)}`, angle: "portrait", locked: true });
   for (const [slot, angle] of PRESENTER_ANGLES) {
     const path = presenterRefPath(templatesRoot, presenter.id, slot);
     if (!existsSync(path)) continue;
-    const png = await sharp19(readFileSync(path)).png().toBuffer();
-    const hash = core.images.save(png);
-    shots.push({ file: `asset:${hash}`, angle, locked: true });
+    shots.push({ file: `asset:${await refHash(core, path)}`, angle, locked: true });
   }
   if (!shots.length) return null;
   return {
@@ -3016,6 +3061,8 @@ async function resolvePresenterImages(core, templatesRoot, presenter) {
     ...presenter.identityNotes ? { identityNotes: presenter.identityNotes } : {},
     ...presenter.negativeConstraints?.length ? { negativeConstraints: presenter.negativeConstraints } : {},
     ...presenter.skin ? { skin: presenter.skin } : {},
+    ...presenter.facial ? { facial: presenter.facial } : {},
+    ...presenter.build ? { build: presenter.build } : {},
     shots
   };
 }
@@ -3100,7 +3147,7 @@ async function resolveDemoProductImages(core, templatesRoot, product) {
   for (const angle of angles) {
     const path = demoProductRefPath(templatesRoot, product.id, angle);
     if (!existsSync(path)) continue;
-    const png = await sharp19(readFileSync(path)).png().toBuffer();
+    const png = await sharp20(readFileSync(path)).png().toBuffer();
     const hash = core.images.save(png);
     shots.push({ file: `asset:${hash}`, angle, locked: true });
   }
@@ -3239,7 +3286,7 @@ var assetHash = (ref) => {
 };
 var LOGO_ROLES = ["primary", "mark", "wordmark", "monochrome", "alternate"];
 var LOGO_BACKGROUNDS = ["light", "dark", "any"];
-var toPng = (buf) => sharp19(buf).rotate().png().toBuffer();
+var toPng = (buf) => sharp20(buf).rotate().png().toBuffer();
 var COST_PROBE = {
   prompt: "",
   brand: { brand: {}, assetPaths: {} },
@@ -3252,11 +3299,11 @@ var MARK_MIN_EDGE = 1024;
 var MARK_TINY_EDGE = 256;
 var MARK_WARN_EDGE = 512;
 var toMarkPng = async (buf) => {
-  const out = await sharp19(buf, { density: 384 }).rotate().resize({ width: MARK_MAX_EDGE, height: MARK_MAX_EDGE, fit: "inside", withoutEnlargement: true }).png().toBuffer();
-  const meta = await sharp19(out).metadata();
+  const out = await sharp20(buf, { density: 384 }).rotate().resize({ width: MARK_MAX_EDGE, height: MARK_MAX_EDGE, fit: "inside", withoutEnlargement: true }).png().toBuffer();
+  const meta = await sharp20(out).metadata();
   const edge = Math.max(meta.width ?? 0, meta.height ?? 0);
   if (edge >= MARK_TINY_EDGE && edge < MARK_MIN_EDGE) {
-    return sharp19(out).resize({ width: MARK_MIN_EDGE, height: MARK_MIN_EDGE, fit: "inside", kernel: "lanczos3" }).png().toBuffer();
+    return sharp20(out).resize({ width: MARK_MIN_EDGE, height: MARK_MIN_EDGE, fit: "inside", kernel: "lanczos3" }).png().toBuffer();
   }
   return out;
 };
@@ -3267,12 +3314,13 @@ async function capReferenceEdge(core, path, maxEdge) {
   if (hit) return hit;
   let out = path;
   try {
-    const meta = await sharp19(path).metadata();
+    const meta = await sharp20(path).metadata();
     if ((meta.width ?? 0) > maxEdge || (meta.height ?? 0) > maxEdge) {
-      const buf = await sharp19(path).resize({ width: maxEdge, height: maxEdge, fit: "inside", withoutEnlargement: true }).png().toBuffer();
+      const buf = await sharp20(path).resize({ width: maxEdge, height: maxEdge, fit: "inside", withoutEnlargement: true }).png().toBuffer();
       out = core.images.pathFor(core.images.save(buf));
     }
   } catch {
+    return path;
   }
   cappedRefs.set(key, out);
   return out;
@@ -3306,12 +3354,21 @@ function productFidelityDirective(attached) {
 function editPreservationDirective(scope, opts) {
   if (scope === "local") {
     const removal = opts?.removal ? " What is removed leaves nothing behind: the surface and the scene continue as if it had never been there, with no outline, silhouette, residue or ghost of it." : "";
-    return "This is a change to a photograph that already exists, not a new photograph. Return the same image with one change made. Everything the instruction does not name comes back exactly as it is now: the same framing, the same crop, the same camera position, the same subject placement and pose, the same lighting, the same colours, the same background and the same dimensions. Do not re-render, re-stage, re-light or re-compose the picture. Change only what was asked for, together with the shadows, reflections and contact points that move with it." + removal;
+    return "This is a change to a photograph that already exists, not a new photograph. Return the same image with one change made. Everything the instruction does not name comes back exactly as it is now: the same framing, the same crop, the same camera position, the same subject placement and pose, the same lighting, the same colours, the same background and the same dimensions. Do not re-render, re-stage, re-light or re-compose the picture. Change only what was asked for, together with the shadows, reflections and contact points that move with it. Every surface keeps the texture it already has: no invented pattern, grain, weave or embossing on fabric, skin or walls that the photograph does not carry now." + removal;
   }
-  return "This is a change to a photograph that already exists, not a new photograph. Apply the instruction to the image you were given and keep what it does not name: the same subject and the same face, the same product with the same label, geometry and colour, and the same dimensions. Do not replace the subject and do not redesign the product.";
+  return "This is a change to a photograph that already exists, not a new photograph. Apply the instruction to the image you were given and keep what it does not name: the same subject and the same face, the same product with the same label, geometry and colour, and the same dimensions. Do not replace the subject and do not redesign the product. Every surface keeps the texture it already has: no invented pattern, grain, weave or embossing on fabric, skin or walls that the photograph does not carry now.";
+}
+function inheritedIdentityDirective(kinds) {
+  const product = kinds?.product ?? true;
+  const person = kinds?.person ?? true;
+  if (product && person)
+    return "The attached product and person references are the same product and the same person that are already in this picture. Use them to hold that identity exact while you make the change, not as a reason to re-stage the shot.";
+  if (product)
+    return "The attached product references show the same product that is already in this picture. Use them to hold its identity exact while you make the change, not as a reason to re-stage the shot.";
+  return "The attached person reference shows the same person who is already in this picture. Use it to hold their identity exact while you make the change, not as a reason to re-stage the shot.";
 }
-function inheritedIdentityDirective() {
-  return "The extra attached references are the same product and the same person that are already in this picture. Use them to hold that identity exact while you make the change, not as a reason to re-stage the shot.";
+function inheritedRefDirective() {
+  return "The carried reference is attached for composition, lighting and treatment only. Any person or product visible in it lends mood, never identity \u2014 nobody and nothing in this photograph takes a face, a body or a design from it.";
 }
 function productFactDirectives(p) {
   const out = [];
@@ -3340,6 +3397,9 @@ function productEditFidelityDirective(name) {
 function characterEditIdentityDirective(name) {
   return `${name} is the person in this photograph: keep them present and clearly visible. Match their face, facial structure, skin, hair and build to the attached person reference exactly. The reference's plain outfit and studio backdrop are capture conditions, not direction: keep the styling this photograph already has unless the instruction itself changes it, and never return them to the plain base layers they were photographed in.`;
 }
+function referenceIdentityGuard() {
+  return "A reference shot lends its composition, lighting and treatment, never its cast: the attached presenter is the only source of person identity in this shot, and any person visible in a reference shot is a stand-in whose place the presenter takes. This holds even where the direction asks to use someone from a reference \u2014 the attached presenter is that someone.";
+}
 function markEditDirective() {
   return "The attached brand mark is this brand's own mark: wherever the logo appears or the instruction asks for it, reproduce it exactly as drawn \u2014 same colours, letterforms and proportions \u2014 never redrawn or re-lettered. Every character it carries stays intact, including the smallest secondary lettering, in its original script and reading direction \u2014 never translated, transliterated or re-spelled.";
 }
@@ -3440,7 +3500,7 @@ function markLabel(brand, logo) {
 
 // src/brief.ts
 var PRODUCT_REF_MAX = 3;
-var CHARACTER_REF_MAX = 2;
+var CHARACTER_REF_MAX = 3;
 var SCENE_REF_MAX = 1;
 var FORMATS = [
   { id: "square", label: "Square 1:1", w: 1024, h: 1024 },
@@ -3497,6 +3557,7 @@ function validateBrief(brief) {
 function compileBrief(brief, ctx) {
   const warnings = [];
   const attachments = [];
+  const rawSceneFallback = [];
   const productDirectives = [];
   const personDirectives = [];
   const otherDirectives = [];
@@ -3529,17 +3590,25 @@ function compileBrief(brief, ctx) {
         append(p.promptName ?? p.name);
         const primary = tok.angle && p.shots?.find((s) => s.angle === tok.angle) || p.shots?.[0];
         const orderedShots = [primary, ...(p.shots ?? []).filter((s) => s && s !== primary)];
-        const phashes = [];
+        const pshots = [];
         for (const s of orderedShots) {
-          if (phashes.length >= PRODUCT_REF_MAX) break;
+          if (pshots.length >= PRODUCT_REF_MAX) break;
           const h = assetHash2(s?.file);
-          if (h && ctx.images.has(h) && !phashes.includes(h)) phashes.push(h);
+          if (h && ctx.images.has(h) && !pshots.some((x) => x.h === h))
+            pshots.push({ h, ...s?.angle ? { angle: String(s.angle) } : {} });
         }
-        if (phashes.length) {
-          phashes.forEach((h, i) => {
-            attachments.push({ role: "product", id: p.id, label: p.name, hash: h, essential: i === 0 });
+        if (pshots.length) {
+          pshots.forEach(({ h, angle }, i) => {
+            attachments.push({
+              role: "product",
+              id: p.id,
+              label: p.name,
+              hash: h,
+              essential: i === 0,
+              ...angle ? { angle } : {}
+            });
           });
-          productDirectives.push(productFidelityDirective(phashes.length));
+          productDirectives.push(productFidelityDirective(pshots.length));
           productDirectives.push(...productFactDirectives(p));
           if (p.description && !p.dimensions)
             productDirectives.push(
@@ -3558,10 +3627,17 @@ function compileBrief(brief, ctx) {
         }
         hasPerson = true;
         append(c.promptName ?? c.name);
-        const chashes = (c.shots ?? []).slice(0, CHARACTER_REF_MAX).map((s) => assetHash2(s?.file)).filter((h) => !!h && ctx.images.has(h));
-        if (chashes.length) {
-          chashes.forEach((chash, i) => {
-            attachments.push({ role: "character", id: c.id, label: c.name, hash: chash, essential: i === 0 });
+        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));
+        if (cshots.length) {
+          cshots.forEach(({ h, angle }, i) => {
+            attachments.push({
+              role: "character",
+              id: c.id,
+              label: c.name,
+              hash: h,
+              essential: i === 0,
+              ...angle ? { angle } : {}
+            });
           });
           personDirectives.push(
             `${c.promptName ?? c.name} is in this photograph: a real person, clearly visible in the frame. Do not leave them out, crop them out, or reduce them to a reflection or a shadow.`
@@ -3574,6 +3650,11 @@ function compileBrief(brief, ctx) {
             personDirectives.push(
               `${c.promptName ?? c.name}'s skin, exactly as the reference photographs show it: ${c.skin}.`
             );
+          if (c.facial)
+            personDirectives.push(
+              `${c.promptName ?? c.name}'s face, which must survive every generation unchanged: ${c.facial}.`
+            );
+          if (c.build) personDirectives.push(`${c.promptName ?? c.name}'s build: ${c.build}.`);
         } else {
           warnings.push(`${c.name} has no usable photo, so they are named but not attached.`);
         }
@@ -3633,10 +3714,14 @@ function compileBrief(brief, ctx) {
         inlineTemplates.push(t);
         append(composePrompt(t, { fields: brief.templateFields ?? {}, notes: "" }));
         if (ctx.mode !== "edit" && t.figure) {
-          for (const r of (t.refs ?? []).slice(0, SCENE_REF_MAX)) {
-            const h = assetHash2(r?.file);
+          const plate = assetHash2(t.preview);
+          const hasPlate = !!plate && ctx.images.has(plate);
+          const candidates = hasPlate ? [plate] : (t.refs ?? []).slice(0, SCENE_REF_MAX).map((r) => assetHash2(r?.file));
+          for (const h of candidates) {
             if (h && ctx.images.has(h)) {
-              attachments.push({ role: "scene", id: t.id, label: t.name, hash: h, essential: false });
+              const a = { role: "scene", id: t.id, label: t.name, hash: h, essential: false };
+              attachments.push(a);
+              if (!hasPlate) rawSceneFallback.push(a);
             }
           }
         }
@@ -3687,6 +3772,12 @@ function compileBrief(brief, ctx) {
   }
   const sceneCamera = inlineTemplates[0]?.camera?.trim() || ctx.template?.camera?.trim() || "";
   const cameraDirectives = sceneCamera && !shotSpecifiesCamera(sentence) ? [`Camera for this shot: ${sceneCamera}`] : [];
+  if (hasPerson && rawSceneFallback.length) {
+    for (const a of rawSceneFallback) {
+      const i = attachments.indexOf(a);
+      if (i !== -1) attachments.splice(i, 1);
+    }
+  }
   const max = ctx.engineCaps.maxReferenceImages;
   const { kept, dropped } = allocateAttachments(attachments, max);
   const guard = scene ? sceneGuardDirectives({
@@ -3720,7 +3811,7 @@ function compileBrief(brief, ctx) {
   const brandLines = brandRuleDirectives(ctx.brand);
   const preservation = ctx.mode === "edit" ? [
     ...ctx.editReshape === "extend" ? [] : [editPreservationDirective(ctx.editScope ?? "global", { removal: ctx.editRemoval })],
-    ...ctx.inheritedIdentity ? [inheritedIdentityDirective()] : [],
+    ...ctx.inheritedIdentity ? [inheritedIdentityDirective(ctx.inheritedIdentity === true ? void 0 : ctx.inheritedIdentity)] : [],
     ...ctx.inheritedDirectives ?? []
   ] : [];
   const apparelUnworn = ctx.mode !== "edit" && !hasPerson && attachments.some((a) => {
@@ -3728,6 +3819,7 @@ function compileBrief(brief, ctx) {
     const rec = (ctx.brand?.products ?? []).find((x) => x?.id === a.id);
     return String(rec?.category ?? "").toLowerCase() === "apparel";
   }) ? [garmentDisplayDirective()] : [];
+  const refGuard = ctx.mode !== "edit" && hasPerson && kept.some((a) => a.role === "reference") ? [referenceIdentityGuard()] : [];
   const allDirectives = [
     ...productDirectives,
     ...personDirectives,
@@ -3739,15 +3831,21 @@ function compileBrief(brief, ctx) {
     ...apparelUnworn,
     ...brandLines,
     ...guard,
+    ...refGuard,
     ...preservation
   ];
   if (allDirectives.length) prompt = `${prompt}${prompt.endsWith(".") ? "" : "."} ${dedupe(allDirectives).join(" ")}`;
   if (dropped.some((d) => d.role !== "scene")) {
-    const names = [...new Set(dropped.filter((d) => d.role !== "scene").map((d) => d.label))];
-    const reads = max === 0 ? "reads no reference images" : `reads ${max} reference image${max === 1 ? "" : "s"}`;
-    warnings.push(
-      `${ctx.engineCaps.displayName} ${reads}, so ${names.join(" and ")} ${names.length === 1 ? "was" : "were"} left out.`
+    const keptLabels = new Set(kept.map((a) => a.label));
+    const names = [...new Set(dropped.filter((d) => d.role !== "scene").map((d) => d.label))].filter(
+      (l) => !keptLabels.has(l)
     );
+    if (names.length) {
+      const reads = max === 0 ? "reads no reference images" : `reads ${max} reference image${max === 1 ? "" : "s"}`;
+      warnings.push(
+        `${ctx.engineCaps.displayName} ${reads}, so ${names.join(" and ")} ${names.length === 1 ? "was" : "were"} left out.`
+      );
+    }
   }
   return {
     prompt: prompt.trim(),
@@ -5756,8 +5854,8 @@ async function runJob(deps, jobId, brandId, url, signal) {
             errors.push({ code: "image_empty", message: "Empty image", url: img.sourceUrl });
             return;
           }
-          const png = await sharp19(buf).rotate().png().toBuffer();
-          const meta = await sharp19(png).metadata();
+          const png = await sharp20(buf).rotate().png().toBuffer();
+          const meta = await sharp20(png).metadata();
           const hash = core.images.save(png);
           core.catalog.setImageAsset(img.productId, img.sourceUrl, `asset:${hash}`, {
             width: meta.width,
@@ -5939,7 +6037,8 @@ function presenterRecordFrom(input, base) {
   const has = (k) => input[k] !== void 0;
   const name = has("name") ? str3(input.name, 60) : base?.name ?? "";
   if (!name) return { ok: false, error: "a presenter needs a name" };
-  const shots = has("shotHashes") ? strList(input.shotHashes, 8, 64).map((h) => assetRef(h)).filter((f) => !!f).map((file) => ({ file, locked: true })) : base?.shots ?? [];
+  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 ?? [];
   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 = {
@@ -6077,6 +6176,26 @@ async function runBuild(deps, job, hashes, instruction, signal) {
   }
 }
 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",
@@ -6129,22 +6248,28 @@ async function runPresenterBuild(deps, job, hashes, instruction, signal) {
   }
   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.length) shotHashes = built2;
-    else warnings.push("The studio views could not be drawn, so the photos are being used directly.");
+    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 { previewHash, avatarHash } = await presenterCrops(core, shotHashes[0], generated ? "generated" : "upload");
+  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,
@@ -6167,16 +6292,16 @@ async function runPresenterBuild(deps, job, hashes, instruction, signal) {
     stage: "done",
     step: job.steps,
     assetId: built.presenter.id,
-    previewHash: previewHash ?? shotHashes[0] ?? null,
+    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 [];
+  if (!engine) return { hashes: [], angles: [] };
   const caps = engine.capabilities();
-  if (!caps.maxReferenceImages) return [];
+  if (!caps.maxReferenceImages) return { hashes: [], angles: [] };
   const byAngle = /* @__PURE__ */ new Map();
   for (const frame of STUDIO_FRAMES) {
     if (signal.aborted) throw new Error("cancelled");
@@ -6203,10 +6328,11 @@ async function generateStudioSet(deps, job, who, sourcePaths, signal) {
       patch(job, { warnings: [...job.warnings, `The ${frame.angle} view could not be drawn.`] });
     }
   }
-  return STUDIO_FRAMES.map((f) => byAngle.get(f.angle)).filter((h) => !!h);
+  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 sharp19(buf).greyscale().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp20(buf).greyscale().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const scan = (len, cross, at) => {
@@ -6260,7 +6386,7 @@ async function trimEdgeBars(core, hash) {
     const width = g.right - g.left + 1;
     const height = g.bottom - g.top + 1;
     if (width < g.W * 0.6 || height < g.H * 0.6) return hash;
-    const png = await sharp19(buf).extract({ left: g.left, top: g.top, width, height }).png().toBuffer();
+    const png = await sharp20(buf).extract({ left: g.left, top: g.top, width, height }).png().toBuffer();
     return core.images.save(png);
   } catch {
     return hash;
@@ -6301,13 +6427,71 @@ async function avatarCrop(core, hash) {
     AVATAR_MAX_PX
   );
 }
+var IDENTITY_FIGURE_FRACTION = 0.26;
+var IDENTITY_HEADROOM = 0.08;
+var IDENTITY_ASPECT = 0.66;
+var IDENTITY_TARGET_HEIGHT = 1280;
+var IDENTITY_MAX_UPSCALE = 3;
+var STANDING_FIGURE_RATIO = 2.2;
+async function identityCrop(core, hash) {
+  if (!hash || !core.images.has(hash)) return void 0;
+  const hit = identityCrops.get(hash);
+  if (hit && core.images.has(hit)) return hit;
+  let box = null;
+  try {
+    box = await figureBox(core.images.read(hash));
+  } catch {
+    box = null;
+  }
+  if (!box) return void 0;
+  if (box.height / Math.max(1, box.width) < STANDING_FIGURE_RATIO) return void 0;
+  let nativeHeight = 0;
+  const out = await crop(core, hash, (w, h) => {
+    const height = Math.min(h, Math.max(16, Math.round(box.height * IDENTITY_FIGURE_FRACTION)));
+    const width = Math.min(w, Math.max(16, Math.round(height * IDENTITY_ASPECT)));
+    nativeHeight = height;
+    const top = Math.min(Math.max(0, Math.round(box.top - height * IDENTITY_HEADROOM)), h - height);
+    const left = Math.min(Math.max(0, Math.round(box.left + box.width / 2 - width / 2)), w - width);
+    return { left, top, width, height };
+  });
+  if (!out) return void 0;
+  try {
+    const height = Math.min(IDENTITY_TARGET_HEIGHT, Math.round(nativeHeight * IDENTITY_MAX_UPSCALE)) || IDENTITY_TARGET_HEIGHT;
+    const png = await sharp20(core.images.read(out)).resize({ height, fit: "inside", kernel: "lanczos3", withoutEnlargement: false }).png().toBuffer();
+    const scaled = core.images.save(png);
+    identityCrops.set(hash, scaled);
+    return scaled;
+  } catch {
+    identityCrops.set(hash, out);
+    return out;
+  }
+}
+var identityCrops = /* @__PURE__ */ new Map();
+async function brandJsonWithIdentityCrops(core, json, characterIds) {
+  const wanted = new Set(characterIds);
+  const roster = json?.characters ?? [];
+  if (!wanted.size || !roster.length) return json;
+  let changed = false;
+  const characters = await Promise.all(
+    roster.map(async (c) => {
+      if (!wanted.has(c?.id) || !c?.shots?.length) return c;
+      if (c.shots[0]?.angle === "portrait") return c;
+      const front = String(c.shots[0]?.file ?? "").replace(/^asset:/, "") || null;
+      const cropped = await identityCrop(core, front ?? void 0);
+      if (!cropped) return c;
+      changed = true;
+      return { ...c, shots: [{ file: `asset:${cropped}`, angle: "identity", locked: true }, ...c.shots] };
+    })
+  );
+  return changed ? { ...json, characters } : json;
+}
 async function figureBox(buf) {
-  const meta = await sharp19(buf).metadata();
+  const meta = await sharp20(buf).metadata();
   const W = meta.width ?? 0;
   const H = meta.height ?? 0;
   if (!W || !H) return null;
   for (const threshold of FIGURE_TRIM_THRESHOLDS) {
-    const { info } = await sharp19(buf).trim({ threshold }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp20(buf).trim({ threshold }).toBuffer({ resolveWithObject: true });
     const left = Math.abs(info.trimOffsetLeft ?? 0);
     const top = Math.abs(info.trimOffsetTop ?? 0);
     const width = info.width ?? 0;
@@ -6340,13 +6524,13 @@ async function smartCover(core, hash, box) {
   if (!hash || !core.images.has(hash)) return void 0;
   try {
     const buf = core.images.read(hash);
-    const meta = await sharp19(buf).metadata();
+    const meta = await sharp20(buf).metadata();
     const w = meta.width ?? 0;
     const h = meta.height ?? 0;
     if (!w || !h) return void 0;
     const raw = box(w, h);
     const target = { width: Math.max(1, raw.width), height: Math.max(1, raw.height) };
-    const png = await sharp19(buf).resize(target.width, target.height, { fit: "cover", position: "attention" }).png().toBuffer();
+    const png = await sharp20(buf).resize(target.width, target.height, { fit: "cover", position: "attention" }).png().toBuffer();
     return core.images.save(png);
   } catch {
     return void 0;
@@ -6355,11 +6539,11 @@ async function smartCover(core, hash, box) {
 async function crop(core, hash, region, cap2) {
   if (!hash || !core.images.has(hash)) return void 0;
   try {
-    const meta = await sharp19(core.images.read(hash)).metadata();
+    const meta = await sharp20(core.images.read(hash)).metadata();
     const w = meta.width ?? 0;
     const h = meta.height ?? 0;
     if (!w || !h) return void 0;
-    let pipeline = sharp19(core.images.read(hash)).extract(region(w, h));
+    let pipeline = sharp20(core.images.read(hash)).extract(region(w, h));
     if (cap2) pipeline = pipeline.resize(cap2, cap2, { fit: "inside", withoutEnlargement: true });
     const png = await pipeline.png().toBuffer();
     return core.images.save(png);
@@ -6450,7 +6634,7 @@ async function runSceneBuild(deps, job, hashes, instruction, signal) {
   });
 }
 function scenePreviewPrompt(scene) {
-  const body = scene.figure ? `A figure is in this photograph: ${scene.figure.replace(/[.\s]+$/, "")}. ` + (scene.figureTreatment ? `The art direction is what has been done to them: ${scene.figureTreatment.replace(/[.\s]+$/, "")}, rendered as a real physical treatment that follows the shape it sits on. ` : "") + "They are nobody in particular: do not reproduce any person from the attached reference images, and give them no recognisable identity. No product, no logos, no watermarks, and no readable words anywhere in the frame." : "The set is empty: no product, no person, no hands, no text, no logos, no watermarks anywhere in the frame.";
+  const body = scene.figure ? `A figure is in this photograph: ${scene.figure.replace(/[.\s]+$/, "")}. ` + (scene.figureTreatment ? `The art direction is what has been done to them: ${scene.figureTreatment.replace(/[.\s]+$/, "")}, rendered as a real physical treatment that follows the shape it sits on. ` : "") + "They are nobody in particular: do not reproduce any person from the attached reference images, and give them no recognisable identity. " + (scene.figureTreatment ? "No product and no watermarks. Where the treatment itself carries printing, render it as genuinely designed print - real letterforms, readable words, numerals and label-quality artwork - belonging to companies that are plausible but fictional, resembling no existing brand, and borrowing, extending or re-spelling no name that appears in any attached reference. Everywhere outside the treatment, no logos and no readable words." : "No product, no logos, no watermarks, and no readable words anywhere in the frame.") : "The set is empty: no product, no person, no hands, no text, no logos, no watermarks anywhere in the frame.";
   return `Full-bleed photograph filling the entire frame edge to edge with no border, frame, letterbox band or matte of any kind. ${scene.prompt} ${scene.lighting ? `${scene.lighting}. ` : ""}` + body;
 }
 async function draw(deps, req) {
@@ -6571,6 +6755,49 @@ function inheritedIdentityTokens(parentId, getNode) {
   return { tokens: [], truncated: id !== null };
 }
 
+// src/variationPlan.ts
+var OPEN_LADDER = [
+  "Frame this one as the direction describes it, the straight read of the brief.",
+  "Step the camera to one side of where the direction places it, and let the pose settle with the move.",
+  "Frame tighter on the subject than the straight read, same lens character.",
+  "Drop the eye line a little and leave more air in the frame.",
+  "Step back for a wider read of the same setup.",
+  "Come round to a three-quarter view of the same arrangement.",
+  "Take it from slightly above, the same distance.",
+  "Hold the same framing and let the subject carry a different beat of the same moment."
+];
+var FIXED_LADDER = [
+  "Frame this one as the direction describes it, the straight read of the brief.",
+  "Keep the camera the direction asks for and shift it a little laterally.",
+  "Keep the camera the direction asks for and let the weight and hands settle differently.",
+  "Keep the camera the direction asks for and change the head angle slightly.",
+  "Keep the camera the direction asks for and let the light fall a touch differently across the same setup.",
+  "Keep the camera the direction asks for and give the expression a different beat of the same moment.",
+  "Keep the camera the direction asks for and rearrange the near foreground slightly.",
+  "Keep the camera the direction asks for and let the pose breathe a little wider."
+];
+function locks(ctx) {
+  const parts = [
+    "Every frame in this run belongs to one continuous shoot: the same location, the same light, and the same wardrobe garment for garment, changing only as the pose moves the cloth."
+  ];
+  if (ctx.hasPresenter)
+    parts.push(
+      "The person is the one in the character references and nobody else, unchanged in face, hair, build and skin."
+    );
+  if (ctx.hasProduct)
+    parts.push(
+      "The product is the one in the product references and no other, unchanged in geometry, packaging, label and colour."
+    );
+  if (ctx.hasMark) parts.push("The brand mark stays exactly as drawn.");
+  return parts.join(" ");
+}
+function variationPlan(count, ctx) {
+  if (!Number.isFinite(count) || count <= 1) return [];
+  const ladder = ctx.cameraFixed ? FIXED_LADDER : OPEN_LADDER;
+  const shared = locks(ctx);
+  return Array.from({ length: Math.floor(count) }, (_, i) => `${ladder[i % ladder.length]} ${shared}`);
+}
+
 // src/editScopeRules.ts
 var GLOBAL_CUES = [
   ["light", /\b(light|lighting|lit|relight|exposure|white ?balance|backlit|shadows everywhere)\b/i],
@@ -6621,6 +6848,119 @@ function scopeOfInstruction(text) {
   if (!matched.length) return { scope: "global", matched: ["no local cue"] };
   return { scope: "local", matched, removal: REMOVAL_VERB.test(s) };
 }
+var FIT_EDGE = 160;
+var GATE_EDGE = 32;
+var GRADE_GATE_MEAN_DELTA = 40;
+var SLOPE_CLAMP = 1.8;
+var TONAL_WORD = /^(warm(er)?|cool(er)?|bright(er)?|dark(er)?|deep(er)?|soft(er)?|hard(er)?|punch(ier|y)?|rich(er)?|flat(ter)?|mood(y|ier)?|golden|overcast|sun(ny|lit)?|cloudy|dusk|dawn|evening|morning|night|daylight|light|lighting|lit|glow(ing)?|exposure|contrast|saturation|desaturat(e|ed)|muted|vivid|tone[sd]?|tint(ed)?|grade[d]?|grading|temperature|white|balance|shadows?|highlights?|blacks?|whites?|filmic|cinematic|dramatic|airy|hazy|misty|crisp)$/i;
+var NEUTRAL_WORD = /^(a|an|the|it|its|this|that|make|makes|keep|slightly|slight|touch|bit|little|more|less|much|very|again|overall|whole|image|frame|shot|picture|photo|look|feel|and|of|in|with|to|too|just|please|now|even)$/i;
+function isGradeOnlyInstruction(text) {
+  const words = String(text ?? "").toLowerCase().replace(/[^a-z\s-]/g, " ").split(/\s+/).filter(Boolean);
+  if (!words.length) return false;
+  let tonal = 0;
+  for (const w of words) {
+    if (TONAL_WORD.test(w)) tonal++;
+    else if (!NEUTRAL_WORD.test(w)) return false;
+  }
+  return tonal > 0;
+}
+var srgbToLinear = (c) => c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+var linearToSrgb = (c) => c <= 31308e-7 ? c * 12.92 : 1.055 * c ** (1 / 2.4) - 0.055;
+var EPS = 1e-6;
+var toLab = (r, g, b) => {
+  const R = srgbToLinear(r / 255);
+  const G = srgbToLinear(g / 255);
+  const B = srgbToLinear(b / 255);
+  const L = Math.log10(Math.max(EPS, 0.3811 * R + 0.5783 * G + 0.0402 * B));
+  const M = Math.log10(Math.max(EPS, 0.1967 * R + 0.7244 * G + 0.0782 * B));
+  const S = Math.log10(Math.max(EPS, 0.0241 * R + 0.1288 * G + 0.8444 * B));
+  return [(L + M + S) / Math.sqrt(3), (L + M - 2 * S) / Math.sqrt(6), (L - M) / Math.sqrt(2)];
+};
+var fromLab = (l, a, bb) => {
+  const L = l / Math.sqrt(3) + a / Math.sqrt(6) + bb / Math.sqrt(2);
+  const M = l / Math.sqrt(3) + a / Math.sqrt(6) - bb / Math.sqrt(2);
+  const S = l / Math.sqrt(3) - 2 * a / Math.sqrt(6);
+  const Rl = 10 ** L;
+  const Ml = 10 ** M;
+  const Sl = 10 ** S;
+  const R = 4.4679 * Rl - 3.5873 * Ml + 0.1193 * Sl;
+  const G = -1.2186 * Rl + 2.3809 * Ml - 0.1624 * Sl;
+  const B = 0.0497 * Rl - 0.2439 * Ml + 1.2045 * Sl;
+  const clamp = (x) => Math.max(0, Math.min(255, Math.round(linearToSrgb(Math.max(0, Math.min(1, x))) * 255)));
+  return [clamp(R), clamp(G), clamp(B)];
+};
+var rawAt = async (png, edge) => {
+  let img = sharp20(png);
+  if (edge) img = img.resize(edge, edge, { fit: "fill" });
+  const { data, info } = await img.removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  return { data, width: info.width, height: info.height };
+};
+var labStats = (raw) => {
+  const n = raw.data.length / 3;
+  const mu = [0, 0, 0];
+  const sq = [0, 0, 0];
+  for (let i = 0; i < raw.data.length; i += 3) {
+    const lab = toLab(raw.data[i], raw.data[i + 1], raw.data[i + 2]);
+    for (let c = 0; c < 3; c++) {
+      mu[c] += lab[c];
+      sq[c] += lab[c] * lab[c];
+    }
+  }
+  for (let c = 0; c < 3; c++) {
+    mu[c] /= n;
+    sq[c] = Math.sqrt(Math.max(1e-9, sq[c] / n - mu[c] * mu[c]));
+  }
+  return { mu, sd: sq };
+};
+var fitAffine = (input, output) => {
+  const a = labStats(input);
+  const b = labStats(output);
+  return [0, 1, 2].map((c) => ({
+    k: Math.max(1 / SLOPE_CLAMP, Math.min(SLOPE_CLAMP, b.sd[c] / a.sd[c])),
+    mi: a.mu[c],
+    mo: b.mu[c]
+  }));
+};
+var applyAffine = (raw, T) => {
+  const d = raw.data;
+  for (let i = 0; i < d.length; i += 3) {
+    const peak = Math.max(d[i], d[i + 1], d[i + 2]);
+    const w = peak <= 225 ? 1 : Math.max(0, (255 - peak) / 30);
+    const lab = toLab(d[i], d[i + 1], d[i + 2]);
+    const out = fromLab(
+      (lab[0] - T[0].mi) * T[0].k + T[0].mo,
+      (lab[1] - T[1].mi) * T[1].k + T[1].mo,
+      (lab[2] - T[2].mi) * T[2].k + T[2].mo
+    );
+    d[i] = Math.round(d[i] * (1 - w) + out[0] * w);
+    d[i + 1] = Math.round(d[i + 1] * (1 - w) + out[1] * w);
+    d[i + 2] = Math.round(d[i + 2] * (1 - w) + out[2] * w);
+  }
+};
+var meanDelta = (a, b) => {
+  const n = Math.min(a.data.length, b.data.length);
+  let sum = 0;
+  for (let i = 0; i < n; i++) sum += Math.abs(a.data[i] - b.data[i]);
+  return n ? sum / n : 255;
+};
+async function gradeComposite(originalPng, modelInputPng, modelOutputPng) {
+  try {
+    const T = fitAffine(await rawAt(modelInputPng, FIT_EDGE), await rawAt(modelOutputPng, FIT_EDGE));
+    const gateIn = await rawAt(modelInputPng, GATE_EDGE);
+    const gateOut = await rawAt(modelOutputPng, GATE_EDGE);
+    applyAffine(gateIn, T);
+    const residual = meanDelta(gateIn, gateOut);
+    if (residual > GRADE_GATE_MEAN_DELTA) return null;
+    const full = await rawAt(originalPng);
+    applyAffine(full, T);
+    const image = await sharp20(full.data, {
+      raw: { width: full.width, height: full.height, channels: 3 }
+    }).png().toBuffer();
+    return { image, residual };
+  } catch {
+    return null;
+  }
+}
 
 // src/expandRules.ts
 var round8 = (n) => Math.max(8, Math.round(n / 8) * 8);
@@ -6687,13 +7027,20 @@ Avoid: new objects, products, people, text or watermarks; do not recompose, rece
 // src/editSizeRules.ts
 var SAME_SHAPE_TOL = 0.01;
 var SHRINK_FLOOR = 0.8;
-function judgeEditSize(src, got) {
+var BUDGET_TOL = 0.1;
+function judgeEditSize(src, got, opts) {
   if (!(src.width > 0 && src.height > 0 && got.width > 0 && got.height > 0)) return { action: "keep" };
   if (got.width === src.width && got.height === src.height) return { action: "keep" };
   const want = src.width / src.height;
   const have = got.width / got.height;
   if (Math.abs(have - want) / want > SAME_SHAPE_TOL) return { action: "keep" };
   const scale = Math.max(got.width, got.height) / Math.max(src.width, src.height);
+  const budget = opts?.pixelBudget;
+  if (budget && src.width * src.height > budget) {
+    const gotPx = got.width * got.height;
+    if (gotPx <= src.width * src.height && Math.abs(gotPx - budget) / budget <= BUDGET_TOL)
+      return { action: "accept", scale };
+  }
   if (scale < SHRINK_FLOOR) return { action: "reject", scale };
   return { action: "resize", scale };
 }
@@ -6712,7 +7059,7 @@ function planCrop(source, targetRatio) {
 }
 async function attentionCropOrigin(srcBuf, source, plan) {
   try {
-    const { info } = await sharp19(srcBuf).resize(plan.width, plan.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp20(srcBuf).resize(plan.width, plan.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
     const attnLeft = typeof info.cropOffsetLeft === "number" ? Math.abs(info.cropOffsetLeft) : plan.left;
     const attnTop = typeof info.cropOffsetTop === "number" ? Math.abs(info.cropOffsetTop) : plan.top;
     const left = Math.round((attnLeft + plan.left) / 2);
@@ -6865,23 +7212,23 @@ function relax(grid, seam, fixedSweeps) {
 
 // src/expand.ts
 async function expandCanvas(source, plan) {
-  const bed = await sharp19(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
-  return sharp19(bed).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
+  const bed = await sharp20(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
+  return sharp20(bed).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
 }
 async function compositeExpand(engineImage, source, plan) {
-  const meta = await sharp19(engineImage).metadata();
+  const meta = await sharp20(engineImage).metadata();
   const want = plan.width / plan.height;
   const got = meta.width && meta.height ? meta.width / meta.height : 0;
   const sameOrientation = got > 0 && got >= 1 === want >= 1;
   const aligned = sameOrientation;
   const exact = meta.width === plan.width && meta.height === plan.height;
-  const surround = aligned ? exact ? engineImage : await sharp19(engineImage).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).toBuffer() : await expandCanvasBedOnly(source, plan);
+  const surround = aligned ? exact ? engineImage : await sharp20(engineImage).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).toBuffer() : await expandCanvasBedOnly(source, plan);
   const matched = aligned ? await matchMarginsToSeam(surround, source, plan) : surround;
-  const image = await sharp19(matched).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
+  const image = await sharp20(matched).composite([{ input: source, left: plan.left, top: plan.top }]).png().toBuffer();
   return { image, aligned };
 }
 async function matchMarginsToSeam(surround, source, plan) {
-  const src = await sharp19(source).metadata();
+  const src = await sharp20(source).metadata();
   if (!src.width || !src.height) return surround;
   const SW = src.width;
   const SH = src.height;
@@ -6928,8 +7275,8 @@ var MAX_CORRECTION = 60;
 async function reconcile(surround, source, side, axis) {
   const { margin } = side;
   if (margin.width < 1 || margin.height < 1) return surround;
-  const marginRaw = await sharp19(surround).extract(margin).removeAlpha().raw().toBuffer();
-  const edgeRaw = await sharp19(source).extract(side.srcEdge).removeAlpha().raw().toBuffer();
+  const marginRaw = await sharp20(surround).extract(margin).removeAlpha().raw().toBuffer();
+  const edgeRaw = await sharp20(source).extract(side.srcEdge).removeAlpha().raw().toBuffer();
   const W = margin.width;
   const H = margin.height;
   const along = axis === "width" ? H : W;
@@ -6983,11 +7330,11 @@ async function reconcile(surround, source, side, axis) {
       }
     }
   }
-  const patch2 = await sharp19(corrected, { raw: { width: W, height: H, channels: 3 } }).png().toBuffer();
-  return sharp19(surround).composite([{ input: patch2, left: margin.left, top: margin.top }]).toBuffer();
+  const patch2 = await sharp20(corrected, { raw: { width: W, height: H, channels: 3 } }).png().toBuffer();
+  return sharp20(surround).composite([{ input: patch2, left: margin.left, top: margin.top }]).toBuffer();
 }
 async function expandCanvasBedOnly(source, plan) {
-  return sharp19(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
+  return sharp20(source).resize(plan.width, plan.height, { fit: "cover", position: "centre" }).blur(Math.max(8, Math.round(Math.max(plan.width, plan.height) / 40))).toBuffer();
 }
 function medianOf(rgb, channel, from, to) {
   const n = to - from;
@@ -6998,17 +7345,17 @@ function medianOf(rgb, channel, from, to) {
   return n % 2 ? values[(n - 1) / 2] : (values[n / 2 - 1] + values[n / 2]) / 2;
 }
 async function reframeExpand(engineImage, plan) {
-  const meta = await sharp19(engineImage).metadata();
+  const meta = await sharp20(engineImage).metadata();
   if (!(meta.width && meta.height)) return null;
   const want = plan.width / plan.height;
   const got = meta.width / meta.height;
   if (got >= 1 !== want >= 1) return null;
   if (meta.width === plan.width && meta.height === plan.height) return engineImage;
   const straight = Math.abs(got - want) / want <= 0.02;
-  return sharp19(engineImage).resize(plan.width, plan.height, { fit: straight ? "fill" : "cover", position: "centre" }).png().toBuffer();
+  return sharp20(engineImage).resize(plan.width, plan.height, { fit: straight ? "fill" : "cover", position: "centre" }).png().toBuffer();
 }
 async function seamScore(image, plan, source) {
-  const { data, info } = await sharp19(image).removeAlpha().greyscale().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp20(image).removeAlpha().greyscale().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const horizontal = plan.axis === "width";
@@ -7041,7 +7388,7 @@ var SEAM_VISIBLE = 2.2;
 var OFFSET = 4;
 var RESIDUAL_VISIBLE = 15;
 async function seamResidual(image, plan, source) {
-  const { data, info } = await sharp19(image).removeAlpha().raw().toBuffer({ resolveWithObject: true });
+  const { data, info } = await sharp20(image).removeAlpha().raw().toBuffer({ resolveWithObject: true });
   const W = info.width;
   const H = info.height;
   const ch = info.channels;
@@ -7076,7 +7423,7 @@ var MAX_SHARE = 0.8;
 async function subjectFraction(src, source, axis) {
   try {
     const window = axis === "width" ? { width: Math.max(8, Math.round(source.width * 0.5)), height: source.height } : { width: source.width, height: Math.max(8, Math.round(source.height * 0.5)) };
-    const { info } = await sharp19(src).resize(window.width, window.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
+    const { info } = await sharp20(src).resize(window.width, window.height, { fit: "cover", position: "attention" }).toBuffer({ resolveWithObject: true });
     const offset = axis === "width" ? Math.abs(typeof info.cropOffsetLeft === "number" ? info.cropOffsetLeft : 0) : Math.abs(typeof info.cropOffsetTop === "number" ? info.cropOffsetTop : 0);
     const span = axis === "width" ? source.width : source.height;
     const extent = axis === "width" ? window.width : window.height;
@@ -7099,14 +7446,14 @@ function placeExpand(plan, source, fraction) {
 }
 var NEUTRAL = { r: 128, g: 128, b: 128 };
 async function conditioningCanvas(source, plan, fill = "edge") {
-  const meta = await sharp19(source).metadata();
+  const meta = await sharp20(source).metadata();
   const sw = meta.width ?? 0;
   const sh = meta.height ?? 0;
   if (!(sw > 0 && sh > 0)) throw new Error("conditioningCanvas: source has no dimensions");
   const layers = [];
   if (fill === "edge") layers.push(...await edgeMargins(source, plan, { width: sw, height: sh }));
   layers.push({ input: source, left: plan.left, top: plan.top });
-  const canvas = sharp19({
+  const canvas = sharp20({
     create: {
       width: plan.width,
       height: plan.height,
@@ -7118,7 +7465,7 @@ async function conditioningCanvas(source, plan, fill = "edge") {
 }
 async function edgeMargins(source, plan, size) {
   const out = [];
-  const strip = async (extract, width, height) => sharp19(source).extract(extract).resize(width, height, { fit: "fill" }).png().toBuffer();
+  const strip = async (extract, width, height) => sharp20(source).extract(extract).resize(width, height, { fit: "fill" }).png().toBuffer();
   if (plan.axis === "width") {
     const before = plan.left;
     const after = plan.width - plan.left - size.width;
@@ -7209,12 +7556,12 @@ async function resolveOutpaintRoute(all, shot) {
   return { engine: shot, method: "reframe", crossed: false };
 }
 async function driftDiff(a, b) {
-  const metaA = await sharp19(a).metadata();
-  const metaB = await sharp19(b).metadata();
+  const metaA = await sharp20(a).metadata();
+  const metaB = await sharp20(b).metadata();
   const width = Math.min(metaA.width ?? 1, metaB.width ?? 1, 1024);
   const height = Math.min(metaA.height ?? 1, metaB.height ?? 1, 1024);
   const [rawA, rawB] = await Promise.all(
-    [a, b].map((buf) => sharp19(buf).resize(width, height, { fit: "cover" }).ensureAlpha().raw().toBuffer())
+    [a, b].map((buf) => sharp20(buf).resize(width, height, { fit: "cover" }).ensureAlpha().raw().toBuffer())
   );
   const out = new PNG({ width, height });
   const changed = pixelmatch(rawA, rawB, out.data, width, height, { threshold: 0.1, diffColor: [255, 64, 64] });
@@ -7226,11 +7573,11 @@ async function driftDiff(a, b) {
   };
 }
 async function changeMask(a, b, cap2 = 1024) {
-  const metaA = await sharp19(a).metadata();
+  const metaA = await sharp20(a).metadata();
   const width = Math.min(metaA.width ?? 1, cap2);
   const height = Math.min(metaA.height ?? 1, cap2);
   const [rawA, rawB] = await Promise.all(
-    [a, b].map((buf) => sharp19(buf).resize(width, height, { fit: "fill" }).ensureAlpha().raw().toBuffer())
+    [a, b].map((buf) => sharp20(buf).resize(width, height, { fit: "fill" }).ensureAlpha().raw().toBuffer())
   );
   const out = new PNG({ width, height });
   pixelmatch(rawA, rawB, out.data, width, height, { threshold: 0.1, includeAA: true, diffMask: true });
@@ -7279,8 +7626,8 @@ function dilationFor(longEdge) {
 // src/localEdit.ts
 async function preserveOutsideChange(source, edited) {
   try {
-    const srcMeta = await sharp19(source).metadata();
-    const outMeta = await sharp19(edited).metadata();
+    const srcMeta = await sharp20(source).metadata();
+    const outMeta = await sharp20(edited).metadata();
     if (!srcMeta.width || !srcMeta.height || !outMeta.width || !outMeta.height)
       return { image: edited, outcome: "error", changed: 0 };
     const sameShape = Math.abs(outMeta.width / outMeta.height - srcMeta.width / srcMeta.height) / (srcMeta.width / srcMeta.height) <= 0.01;
@@ -7290,15 +7637,15 @@ async function preserveOutsideChange(source, edited) {
     if (outcome !== "composited") return { image: edited, outcome, changed: shape.changed };
     const r = dilationFor(Math.max(shape.width, shape.height));
     const rawShape = { raw: { width: shape.width, height: shape.height, channels: 1 } };
-    const spread = await sharp19(shape.mask, rawShape).blur(r).toColourspace("b-w").raw().toBuffer();
-    const dilated = await sharp19(spread, rawShape).threshold(8).toColourspace("b-w").raw().toBuffer();
-    const feathered = await sharp19(dilated, rawShape).blur(Math.max(2, r / 3)).toColourspace("b-w").raw().toBuffer();
-    const grown = await sharp19(feathered, rawShape).resize(srcMeta.width, srcMeta.height, { fit: "fill", kernel: "cubic" }).toColourspace("b-w").raw().toBuffer();
-    const editedRgb = await sharp19(edited).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).removeAlpha().raw().toBuffer();
-    const masked = await sharp19(editedRgb, {
+    const spread = await sharp20(shape.mask, rawShape).blur(r).toColourspace("b-w").raw().toBuffer();
+    const dilated = await sharp20(spread, rawShape).threshold(8).toColourspace("b-w").raw().toBuffer();
+    const feathered = await sharp20(dilated, rawShape).blur(Math.max(2, r / 3)).toColourspace("b-w").raw().toBuffer();
+    const grown = await sharp20(feathered, rawShape).resize(srcMeta.width, srcMeta.height, { fit: "fill", kernel: "cubic" }).toColourspace("b-w").raw().toBuffer();
+    const editedRgb = await sharp20(edited).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).removeAlpha().raw().toBuffer();
+    const masked = await sharp20(editedRgb, {
       raw: { width: srcMeta.width, height: srcMeta.height, channels: 3 }
     }).joinChannel(grown, { raw: { width: srcMeta.width, height: srcMeta.height, channels: 1 } }).png().toBuffer();
-    const image = await sharp19(source).removeAlpha().composite([{ input: masked }]).png().toBuffer();
+    const image = await sharp20(source).removeAlpha().composite([{ input: masked }]).png().toBuffer();
     return { image, outcome: "composited", changed: shape.changed };
   } catch {
     return { image: edited, outcome: "error", changed: 0 };
@@ -7336,7 +7683,7 @@ function registerLogoRoutes(app, deps) {
     const v = validateBrand(json);
     if (!v.valid) return reply.status(400).send({ error: "brand became invalid", details: v.errors });
     const row = core.store.updateBrand(brand.id, json);
-    const meta = await sharp19(core.images.read(part.hash)).metadata().catch(() => null);
+    const meta = await sharp20(core.images.read(part.hash)).metadata().catch(() => null);
     const logoEdge = meta ? Math.max(meta.width ?? 0, meta.height ?? 0) || null : null;
     return { ...row, logoHash: part.hash, logoEdge };
   });
@@ -7463,7 +7810,7 @@ async function vibrantColor(input) {
   let data;
   let channels;
   try {
-    const out = await sharp19(input).resize(48, 48, { fit: "inside" }).raw().toBuffer({ resolveWithObject: true });
+    const out = await sharp20(input).resize(48, 48, { fit: "inside" }).raw().toBuffer({ resolveWithObject: true });
     data = out.data;
     channels = out.info.channels;
   } catch {
@@ -7486,7 +7833,7 @@ async function vibrantColor(input) {
   const best = buckets.reduce((a, b) => b.score > a.score ? b : a, buckets[0]);
   if (best.score <= 0) {
     try {
-      const { dominant } = await sharp19(input).stats();
+      const { dominant } = await sharp20(input).stats();
       return toHex(dominant.r, dominant.g, dominant.b);
     } catch {
       return null;
@@ -7870,10 +8217,11 @@ function registerAssetBuildRoutes(app, deps) {
     core.ledger.recordCost(engineId, null, result.costUsd);
     const hash = result.images[0];
     if (!hash) return reply.status(500).send({ error: "the engine returned no image" });
+    const trimmed = await trimEdgeBars(core, hash);
     commit(core, brand.id, (json) => {
-      json.scenes = brandScenes(json).map((s) => s.id === id ? { ...s, preview: `asset:${hash}` } : s);
+      json.scenes = brandScenes(json).map((s) => s.id === id ? { ...s, preview: `asset:${trimmed}` } : s);
     });
-    return { preview: `asset:${hash}`, brand: core.store.getBrand(brand.id) };
+    return { preview: `asset:${trimmed}`, brand: core.store.getBrand(brand.id) };
   });
 }
 async function withDerivedCrops(core, body, base) {
@@ -8104,7 +8452,7 @@ async function buildExportZip(image, baseName, presetIds) {
   const chosen = EXPORT_PRESETS.filter((p) => presetIds.includes(p.id));
   if (chosen.length === 0) throw new Error("No valid export presets selected");
   for (const p of chosen) {
-    const buf = p.width && p.height ? await sharp19(image).resize(p.width, p.height, { fit: "cover", position: "attention" }).png().toBuffer() : image;
+    const buf = p.width && p.height ? await sharp20(image).resize(p.width, p.height, { fit: "cover", position: "attention" }).png().toBuffer() : image;
     zip.file(`${baseName}-${p.id}.png`, buf);
   }
   return zip.generateAsync({ type: "nodebuffer" });
@@ -8265,8 +8613,8 @@ function registerImageRoutes(app, deps) {
     if (!part) return reply.status(400).send({ error: "multipart file field required" });
     const buf = await part.toBuffer();
     if (buf.length === 0) return reply.status(400).send({ error: "empty file" });
-    const fmt = (await sharp19(buf).metadata().catch(() => null))?.format;
-    const png = fmt === "svg" ? await toMarkPng(buf) : await sharp19(buf).rotate().png().toBuffer();
+    const fmt = (await sharp20(buf).metadata().catch(() => null))?.format;
+    const png = fmt === "svg" ? await toMarkPng(buf) : await sharp20(buf).rotate().png().toBuffer();
     return { hash: core.images.save(png) };
   });
   app.post("/api/diff", async (req, reply) => {
@@ -8301,6 +8649,44 @@ function registerImageRoutes(app, deps) {
 
 // src/release/notes.data.ts
 var RELEASES = [
+  {
+    version: "0.7.1",
+    date: "2026-08-30",
+    title: "Four images from one brief are one set.",
+    sections: [
+      {
+        heading: "Create",
+        body: "Asking for two, three or four images returns variations of one shot rather than four readings of it. The presenter, the product, the scene and the brand hold across the set, and so does the wardrobe. What changes is the photography: each frame explores a different camera position, crop or pose within the brief you wrote."
+      },
+      {
+        heading: "Presenters",
+        body: "A selected presenter now reaches generation as a portrait, not only as full-length views, so their face carries into every image of a run instead of being rebuilt each time. Presenters built in Scenri gain a head-and-shoulders reference of their own, and their casting notes reach the shot."
+      },
+      {
+        heading: "Fixes",
+        body: "A run that takes too long keeps the images that already finished instead of throwing them away with the rest. Refining a shot conditions on the same presenter portrait the generation used."
+      }
+    ]
+  },
+  {
+    version: "0.7.0",
+    date: "2026-08-30",
+    title: "Your presenter stays your presenter.",
+    sections: [
+      {
+        heading: "Scenes",
+        body: "A scene lends its world, its light and its treatment, never a face. Generation now conditions on the scene\u2019s own drawn card instead of your raw upload, so the person you selected is the person in the shot. Scenes made before this release render printed treatments best after a one-tap redraw from the scene\u2019s page."
+      },
+      {
+        heading: "Refine",
+        body: "Refining light and mood no longer wears a shot down: a tonal refinement keeps the photograph\u2019s own pixels and changes only the grade, so the tenth adjustment is as sharp as the first. High-resolution refinements state their working size honestly instead of inflating it, and refining an extended shot works again."
+      },
+      {
+        heading: "Presenters",
+        body: "A presenter\u2019s identity rides with three of their views. A reference you attach cannot lend anyone its face while a presenter is selected, and a mood image carried into a refinement is never mistaken for the person in the picture."
+      }
+    ]
+  },
   {
     version: "0.6.13",
     date: "2026-08-30",
@@ -9099,7 +9485,7 @@ function buildServer(opts) {
       // Measured as stored (post-toMarkPng), so the scrape judges the same
       // pixels the compiler will one day attach.
       probeLongEdge: async (buf) => {
-        const m = await sharp19(await toMarkPng(buf)).metadata();
+        const m = await sharp20(await toMarkPng(buf)).metadata();
         return Math.max(m.width ?? 0, m.height ?? 0) || null;
       },
       createdWith: `${meta.name}/${meta.version}`
@@ -9188,7 +9574,7 @@ function buildServer(opts) {
       fetchImpl: opts.fetchImpl,
       saveAsset: async (buf) => `asset:${core.images.save(await toMarkPng(buf))}`,
       probeLongEdge: async (buf) => {
-        const m = await sharp19(await toMarkPng(buf)).metadata();
+        const m = await sharp20(await toMarkPng(buf)).metadata();
         return Math.max(m.width ?? 0, m.height ?? 0) || null;
       },
       createdWith: `${meta.name}/${meta.version}`
@@ -9294,7 +9680,19 @@ function buildServer(opts) {
   registerShowcaseRoutes(app, { templatesRoot });
   app.get("/api/formats", async () => FORMATS);
   function briefInputsOnly(brief) {
-    const { inherited, rendered, croppedFrom, resizedFrom, resampledHops, expand, crop: crop2, sourceImage, ...inputs } = brief;
+    const {
+      inherited,
+      rendered,
+      croppedFrom,
+      resizedFrom,
+      resampledHops,
+      steppedDown,
+      gradeComposited,
+      expand,
+      crop: crop2,
+      sourceImage,
+      ...inputs
+    } = brief;
     return inputs;
   }
   async function compileEditBrief(brandId, parentId, brief, engineCaps, opts2) {
@@ -9305,18 +9703,22 @@ function buildServer(opts) {
     );
     const inheritedTokens = borrowed.filter((t) => !already.has(identityTokenKey(t)));
     const combined = [...brief.tokens, ...inheritedTokens];
-    const brandJson = await brandJsonWithResolvedPresenters(
+    const brandJson = await brandJsonWithIdentityCrops(
       core,
-      templatesRoot,
-      presenters,
-      await brandJsonWithResolvedDemoProducts(
+      await brandJsonWithResolvedPresenters(
         core,
         templatesRoot,
-        demoProducts,
-        brandJsonWithCatalogProducts(core, brandId),
+        presenters,
+        await brandJsonWithResolvedDemoProducts(
+          core,
+          templatesRoot,
+          demoProducts,
+          brandJsonWithCatalogProducts(core, brandId),
+          combined
+        ),
         combined
       ),
-      combined
+      combined.filter((t) => t.t === "character").map((t) => t.id)
     );
     const sceneById = sceneFor(brandJson);
     const uncapped = { ...engineCaps, maxReferenceImages: 32 };
@@ -9325,6 +9727,9 @@ function buildServer(opts) {
     );
     const inheritedDirectives = [];
     let inheritedMark = false;
+    let inheritedRef = false;
+    const inheritedProduct = inheritedTokens.some((t) => t.t === "product");
+    const inheritedPerson = inheritedTokens.some((t) => t.t === "character");
     for (const tok of inheritedTokens) {
       if (tok.t === "product") {
         const rec = (brandJson?.products ?? []).find((x) => x?.id === tok.id);
@@ -9343,8 +9748,12 @@ function buildServer(opts) {
       } else if (tok.t === "mark" && !inheritedMark) {
         inheritedMark = true;
         inheritedDirectives.push(markEditDirective());
+      } else if (tok.t === "ref" && !inheritedRef) {
+        inheritedRef = true;
+        inheritedDirectives.push(inheritedRefDirective());
       }
     }
+    if (inheritedPerson) inheritedDirectives.push(personSkinDirective());
     const compiled2 = compileBrief(brief, {
       brand: brandJson,
       images: core.images,
@@ -9354,7 +9763,11 @@ function buildServer(opts) {
       mode: "edit",
       editScope: verdict.scope,
       editRemoval: verdict.removal ?? false,
-      inheritedIdentity: inheritedTokens.length > 0,
+      // Kinds, not a count: the identity claim speaks only about the kinds
+      // that actually ride. A mark-only or ref-only inheritance emits no
+      // generic claim - markEditDirective and inheritedRefDirective speak
+      // for themselves.
+      inheritedIdentity: inheritedProduct || inheritedPerson ? { product: inheritedProduct, person: inheritedPerson } : false,
       inheritedDirectives,
       // Only the explicit op drops the dimension promise: an implicit legacy
       // expansion keeps its historical prompt byte for byte.
@@ -9365,7 +9778,7 @@ function buildServer(opts) {
     if (inheritedTokens.length) {
       const identity = compileBrief(
         { tokens: inheritedTokens },
-        { brand: brandJson, images: core.images, engineCaps: uncapped, templateById: sceneById }
+        { brand: brandJson, images: core.images, engineCaps: uncapped, templateById: sceneById, mode: "edit" }
       );
       identityWarnings = identity.warnings;
       const productAngles = /* @__PURE__ */ new Map();
@@ -9432,18 +9845,22 @@ function buildServer(opts) {
         referenceCount: edit.merged.kept.length
       };
     }
-    const brandJson = await brandJsonWithResolvedPresenters(
+    const brandJson = await brandJsonWithIdentityCrops(
       core,
-      templatesRoot,
-      presenters,
-      await brandJsonWithResolvedDemoProducts(
+      await brandJsonWithResolvedPresenters(
         core,
         templatesRoot,
-        demoProducts,
-        brandJsonWithCatalogProducts(core, brand.id),
+        presenters,
+        await brandJsonWithResolvedDemoProducts(
+          core,
+          templatesRoot,
+          demoProducts,
+          brandJsonWithCatalogProducts(core, brand.id),
+          brief.tokens
+        ),
         brief.tokens
       ),
-      brief.tokens
+      (brief.tokens ?? []).filter((t) => t.t === "character").map((t) => t.id)
     );
     const sceneById = sceneFor(brandJson);
     const compiled2 = compileBrief(brief, {
@@ -9520,11 +9937,11 @@ function buildServer(opts) {
     const out = [];
     for (const h of images) {
       const buf = core.images.read(h);
-      const meta2 = await sharp19(buf).metadata().catch(() => null);
+      const meta2 = await sharp20(buf).metadata().catch(() => null);
       if (!meta2?.width || !meta2.height) throw new Error("engine returned an undecodable image");
       const oriented = (meta2.orientation ?? 1) !== 1;
       out.push(
-        buf.subarray(0, 8).equals(PNG_SIG) && !oriented ? h : core.images.save(await sharp19(buf).rotate().png().toBuffer())
+        buf.subarray(0, 8).equals(PNG_SIG) && !oriented ? h : core.images.save(await sharp20(buf).rotate().png().toBuffer())
       );
     }
     return out;
@@ -9536,7 +9953,7 @@ function buildServer(opts) {
       const out = [];
       for (const h of images) {
         const buf = core.images.read(h);
-        const meta2 = await sharp19(buf).metadata();
+        const meta2 = await sharp20(buf).metadata();
         if (!meta2.width || !meta2.height) {
           out.push(h);
           continue;
@@ -9549,7 +9966,7 @@ function buildServer(opts) {
         }
         const w = got > target ? Math.round(meta2.height * target) : meta2.width;
         const hpx = got > target ? meta2.height : Math.round(meta2.width / target);
-        const cropped = await sharp19(buf).resize(w, hpx, { fit: "cover", position: "attention" }).png().toBuffer();
+        const cropped = await sharp20(buf).resize(w, hpx, { fit: "cover", position: "attention" }).png().toBuffer();
         app.log.info(
           { nodeId, got: `${meta2.width}x${meta2.height}`, want: `${w}x${hpx}` },
           "canvas: cropped a drifted frame to the asked ratio"
@@ -9568,7 +9985,7 @@ function buildServer(opts) {
   async function assertAspect(images, expect) {
     const want = expect.width / expect.height;
     for (const h of images) {
-      const meta2 = await sharp19(core.images.read(h)).metadata();
+      const meta2 = await sharp20(core.images.read(h)).metadata();
       if (!meta2.width || !meta2.height) continue;
       const got = meta2.width / meta2.height;
       if (Math.abs(got - want) / want > ASPECT_TOLERANCE)
@@ -9587,7 +10004,7 @@ function buildServer(opts) {
     let watchdogFired = false;
     const watchdog = setTimeout(() => {
       watchdogFired = true;
-      ctrl.abort();
+      ctrl.abort(BUDGET_EXHAUSTED);
     }, bound);
     const startedAt = Date.now();
     try {
@@ -9600,7 +10017,7 @@ function buildServer(opts) {
       try {
         const sizes = [];
         for (const h of result.images) {
-          const meta2 = await sharp19(core.images.read(h)).metadata();
+          const meta2 = await sharp20(core.images.read(h)).metadata();
           if (meta2.width && meta2.height) sizes.push([meta2.width, meta2.height]);
         }
         const node = core.store.getNode(nodeId);
@@ -9667,7 +10084,7 @@ function buildServer(opts) {
       if (!srcHash || !core.images.has(String(srcHash)))
         return reply.status(400).send({ error: "edit needs a parent node with an image (sourceImage)" });
       const srcBuf = core.images.read(String(srcHash));
-      const srcMeta = await sharp19(srcBuf).metadata();
+      const srcMeta = await sharp20(srcBuf).metadata();
       if (!srcMeta.width || !srcMeta.height) return reply.status(400).send({ error: "source image unreadable" });
       const plan2 = planCrop({ width: srcMeta.width, height: srcMeta.height }, Number(fmt.w) / Number(fmt.h));
       if (!plan2) return reply.status(400).send({ error: "the picture is already this shape" });
@@ -9690,7 +10107,7 @@ function buildServer(opts) {
         crop: window
       });
       const work2 = async () => ({
-        images: [core.images.save(await sharp19(srcBuf).extract(window).png().toBuffer())],
+        images: [core.images.save(await sharp20(srcBuf).extract(window).png().toBuffer())],
         costUsd: 0
       });
       void runNode(node2.id, null, 0, work2, { width: plan2.width, height: plan2.height }).catch(
@@ -9712,6 +10129,9 @@ function buildServer(opts) {
     let inheritedTokens = [];
     let mergedEdit = null;
     let editScope = "global";
+    let gradeOnlyAsk = false;
+    let budgetSourceHash;
+    let sentSize;
     const extraWarnings = [];
     let expandPlan = null;
     let expandSourceHash = null;
@@ -9726,22 +10146,29 @@ function buildServer(opts) {
         inheritedTokens = edit.inheritedTokens;
         mergedEdit = edit.merged;
         editScope = edit.editScope;
+        gradeOnlyAsk = editScope === "global" && isGradeOnlyInstruction(
+          (brief?.tokens ?? []).filter((t) => t.t === "text").map((t) => t.v).join(" ")
+        );
         extraWarnings.push(...edit.warnings.filter((w) => !compiled2?.warnings.includes(w)));
         if (!compiled2.prompt.trim() && reshape !== "extend")
           return reply.status(400).send({ error: "the brief is empty" });
       } else {
-        const brandJson = await brandJsonWithResolvedPresenters(
+        const brandJson = await brandJsonWithIdentityCrops(
           core,
-          templatesRoot,
-          presenters,
-          await brandJsonWithResolvedDemoProducts(
+          await brandJsonWithResolvedPresenters(
             core,
             templatesRoot,
-            demoProducts,
-            brandJsonWithCatalogProducts(core, project.brandId),
+            presenters,
+            await brandJsonWithResolvedDemoProducts(
+              core,
+              templatesRoot,
+              demoProducts,
+              brandJsonWithCatalogProducts(core, project.brandId),
+              brief.tokens
+            ),
             brief.tokens
           ),
-          brief.tokens
+          (brief.tokens ?? []).filter((t) => t.t === "character").map((t) => t.id)
         );
         const sceneById = sceneFor(brandJson);
         compiled2 = compileBrief(brief, {
@@ -9807,6 +10234,7 @@ function buildServer(opts) {
     }
     if (kind === "generation") {
       const cap2 = engine.capabilities().maxReferenceImages;
+      const wantedCount = Math.min(Math.max(1, Number(count)), 8);
       const lostIdentity = engine.capabilities().placeholder ? [] : (compiled2?.dropped ?? []).filter((d) => d.essential);
       if (lostIdentity.length) {
         const names = joinNames(lostIdentity.map((d) => d.label));
@@ -9818,14 +10246,23 @@ function buildServer(opts) {
       const maxEdge = engine.capabilities().maxReferenceEdge;
       const keptRefs = referenceImages && cap2 > 0 ? referenceImages.slice(0, cap2) : void 0;
       const sentRefs = keptRefs && maxEdge ? await Promise.all(keptRefs.map((p) => capReferenceEdge(core, p, maxEdge))) : keptRefs;
+      const sentRoles = referenceRoles && cap2 > 0 ? referenceRoles.slice(0, cap2) : referenceRoles ?? [];
+      const briefText = Array.isArray(brief?.tokens) ? brief.tokens.filter((t) => t?.t === "text").map((t) => String(t?.v ?? "")).join(" ") : String(prompt ?? "");
+      const variations = variationPlan(wantedCount, {
+        hasPresenter: sentRoles.includes("character"),
+        hasProduct: sentRoles.includes("product"),
+        hasMark: sentRoles.includes("brand"),
+        cameraFixed: shotSpecifiesCamera(briefText)
+      });
       const genReq = {
         prompt: finalPrompt,
         brand: ctx,
         width: Number(width),
         height: Number(height),
-        count: Math.min(Math.max(1, Number(count)), 8),
+        count: wantedCount,
         ...sentRefs ? { referenceImages: sentRefs } : {},
-        ...referenceRoles && cap2 > 0 ? { referenceRoles: referenceRoles.slice(0, cap2) } : {}
+        ...sentRoles.length && cap2 > 0 ? { referenceRoles: sentRoles } : {},
+        ...variations.length ? { variations } : {}
       };
       estimate = await engine.costEstimate(genReq);
       work = (signal) => engine.generate(genReq, signal);
@@ -9842,11 +10279,12 @@ function buildServer(opts) {
       const editEdge = engine.capabilities().maxReferenceEdge;
       if (editEdge) for (const r of editRefs) r.path = await capReferenceEdge(core, r.path, editEdge);
       const srcBuf = core.images.read(String(srcHash));
-      const srcMeta = await sharp19(srcBuf).metadata();
+      const srcMeta = await sharp20(srcBuf).metadata();
       if (srcMeta.width && srcMeta.height) expectShape = { width: srcMeta.width, height: srcMeta.height };
       const parentFormat = parent?.brief?.tokens?.find((t) => t?.t === "format");
       const parentNominal = parentFormat && Number(parentFormat.w) > 0 && Number(parentFormat.h) > 0 ? { width: Number(parentFormat.w), height: Number(parentFormat.h) } : null;
-      const reshapeIntended = reshape === "extend" || reshape === void 0 && !!srcMeta.width && !!srcMeta.height && !!compiled2?.width && !!compiled2?.height && wantsImplicitReshape({ width: compiled2.width, height: compiled2.height }, parentNominal, {
+      const briefNamesShape = (brief?.tokens ?? []).some((t) => t?.t === "format");
+      const reshapeIntended = reshape === "extend" || reshape === void 0 && briefNamesShape && !!srcMeta.width && !!srcMeta.height && !!compiled2?.width && !!compiled2?.height && wantsImplicitReshape({ width: compiled2.width, height: compiled2.height }, parentNominal, {
         width: srcMeta.width,
         height: srcMeta.height
       });
@@ -9873,9 +10311,20 @@ function buildServer(opts) {
         }
         expectShape = { width: expandPlan.width, height: expandPlan.height };
       }
+      const editPixelBudget = runEngine.capabilities().editPixelBudget;
+      if (!expandPlan && editPixelBudget && srcMeta.width && srcMeta.height && srcMeta.width * srcMeta.height > editPixelBudget) {
+        sentSize = budgetSize(srcMeta.width, srcMeta.height, editPixelBudget);
+        budgetSourceHash = core.images.save(
+          await sharp20(srcBuf).resize(sentSize.width, sentSize.height, { fit: "fill", kernel: "lanczos3" }).png().toBuffer()
+        );
+        if (!gradeOnlyAsk)
+          extraWarnings.push(
+            `${runEngine.capabilities().displayName} refines at about ${(editPixelBudget / 1e6).toFixed(1)} megapixels, so this ${srcMeta.width}x${srcMeta.height} frame continues at ${sentSize.width}x${sentSize.height} from here on. The picture is unchanged; the stored size is now the size the engine truly drew.`
+          );
+      }
       const editReq = {
         instruction: expandPlan ? expandInstruction(expandPlan, finalPrompt) : finalPrompt,
-        sourceImage: core.images.pathFor(String(expandSourceHash ?? srcHash)),
+        sourceImage: core.images.pathFor(String(expandSourceHash ?? budgetSourceHash ?? srcHash)),
         brand: ctx,
         ...editRefs.length ? { referenceImages: editRefs.map((r) => r.path) } : {},
         ...editRefs.length ? { referenceRoles: editRefs.map((r) => r.role ?? "reference") } : {},
@@ -9885,7 +10334,7 @@ function buildServer(opts) {
         // engines given no size answered at whatever size they liked, the
         // shrunken answer was stored, and the next refinement inherited it —
         // the chain that walked shots down to thumbnails.
-        ...expandPlan ? { width: expandPlan.width, height: expandPlan.height } : srcMeta.width && srcMeta.height ? { width: srcMeta.width, height: srcMeta.height } : {},
+        ...expandPlan ? { width: expandPlan.width, height: expandPlan.height } : sentSize ? sentSize : srcMeta.width && srcMeta.height ? { width: srcMeta.width, height: srcMeta.height } : {},
         // Only an engine that can genuinely paint a margin is told where the
         // picture sits; the rest would ignore it anyway.
         ...expandPlan && canOutpaint2 ? {
@@ -9987,13 +10436,29 @@ function buildServer(opts) {
     const original = editedFrom ? core.images.read(editedFrom) : null;
     const localScope = kind === "edit" && !plan && editScope === "local" && original;
     const enforceEditCanvas = async (images) => {
-      const srcMeta = await sharp19(original).metadata();
+      const srcMeta = await sharp20(original).metadata();
       if (!srcMeta.width || !srcMeta.height) return images;
       const out = [];
       for (const h of images) {
-        const meta2 = await sharp19(core.images.read(h)).metadata();
+        const meta2 = await sharp20(core.images.read(h)).metadata();
         const got = { width: meta2.width ?? 0, height: meta2.height ?? 0 };
-        const verdict = judgeEditSize({ width: srcMeta.width, height: srcMeta.height }, got);
+        const verdict = judgeEditSize({ width: srcMeta.width, height: srcMeta.height }, got, {
+          pixelBudget: runEngine.capabilities().editPixelBudget
+        });
+        if (verdict.action === "accept") {
+          app.log.info(
+            { nodeId: node.id, got: `${got.width}x${got.height}`, src: `${srcMeta.width}x${srcMeta.height}` },
+            "edit: kept the engine-native answer (pixel-budget step-down)"
+          );
+          try {
+            const fresh = core.store.getNode(node.id);
+            const b = fresh?.brief ?? {};
+            core.store.setBrief(node.id, { ...b, steppedDown: [srcMeta.width, srcMeta.height] });
+          } catch {
+          }
+          out.push(h);
+          continue;
+        }
         if (verdict.action === "reject")
           throw new Error(
             `engine returned ${got.width}x${got.height} for a ${srcMeta.width}x${srcMeta.height} frame: too little of the picture came back to keep at this resolution`
@@ -10005,7 +10470,7 @@ function buildServer(opts) {
           );
           out.push(
             core.images.save(
-              await sharp19(core.images.read(h)).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).png().toBuffer()
+              await sharp20(core.images.read(h)).resize(srcMeta.width, srcMeta.height, { fit: "fill" }).png().toBuffer()
             )
           );
           try {
@@ -10027,7 +10492,7 @@ function buildServer(opts) {
       const out = [];
       for (const h of images) {
         const answer = core.images.read(h);
-        const got = await sharp19(answer).metadata();
+        const got = await sharp20(answer).metadata();
         if (got.width !== plan.width || got.height !== plan.height)
           app.log.info(
             { nodeId: node.id, got: `${got.width}x${got.height}`, want: `${plan.width}x${plan.height}` },
@@ -10053,6 +10518,26 @@ function buildServer(opts) {
       return images;
     } : kind === "edit" && original ? async (images) => {
       let staged = images;
+      if (gradeOnlyAsk && !expandPlan) {
+        const sent = budgetSourceHash ? core.images.read(budgetSourceHash) : original;
+        const out = [];
+        for (const h of staged) {
+          const g = await gradeComposite(original, sent, core.images.read(h));
+          if (g) {
+            app.log.info(
+              { nodeId: node.id, residual: Number(g.residual.toFixed(2)) },
+              "edit: shipped the original pixels wearing the grade"
+            );
+            out.push(core.images.save(g.image));
+            try {
+              const fresh = core.store.getNode(node.id);
+              core.store.setBrief(node.id, { ...fresh?.brief ?? {}, gradeComposited: true });
+            } catch {
+            }
+          } else out.push(h);
+        }
+        staged = out;
+      }
       if (localScope) {
         const out = [];
         for (const h of staged) {
@@ -10066,7 +10551,8 @@ function buildServer(opts) {
       }
       return enforceEditCanvas(staged);
     } : kind === "generation" && compiled2?.width && compiled2?.height ? conformToCanvas(node.id, { width: compiled2.width, height: compiled2.height }) : void 0;
-    const nodeBudgetMs = kind === "generation" && runEngine.capabilities().id === "codex-cli" ? codexNodeBudgetMs(Math.min(Math.max(1, Number(count)), 8)) : void 0;
+    const runCaps = runEngine.capabilities();
+    const nodeBudgetMs = kind === "generation" && runCaps.perImageTimeoutMs ? Math.ceil(Math.min(Math.max(1, Number(count)), 8) / Math.max(1, runCaps.imageConcurrency ?? 1)) * runCaps.perImageTimeoutMs + 6e4 : void 0;
     void runNode(node.id, runEngine, estimate, work, expectShape, post, nodeBudgetMs).catch(
       (err) => app.log.error({ err }, "node run failed")
     );
@@ -10328,8 +10814,8 @@ async function verify() {
     const db = new Database2(":memory:");
     db.pragma("user_version");
     db.close();
-    const { default: sharp20 } = await import('sharp');
-    await sharp20({ create: { width: 1, height: 1, channels: 3, background: "#000" } }).png().toBuffer();
+    const { default: sharp21 } = await import('sharp');
+    await sharp21({ create: { width: 1, height: 1, channels: 3, background: "#000" } }).png().toBuffer();
     console.log(JSON.stringify({ ok: true, version: readMeta().version }));
   } catch (err) {
     console.log(JSON.stringify({ ok: false, error: String(err?.message ?? err) }));