@koda-sl/baker-cli 0.421.0-dev.8ef74f67e → 0.421.0

package/dist/{chunk-PFN3A4VQ.js → chunk-GLPQQP5C.js}

@@ -1,7 +1,7 @@
 import {
   debugLogHttp,
   readBodyForLog
-} from "./chunk-6YAPMFMC.js";
+} from "./chunk-FKFJKE75.js";
 import {
   API_KEY_FORMAT_MESSAGE,
   DIRECT_ROUTE,
@@ -15,16 +15,17 @@ import {
   isChallengeBody,
   isPrivateAddress,
   isProxyFailure,
+  nextPlannedRoute,
   openRouterKey,
   plannedRoutes,
   refuseNonPublicUrl,
   requireConnection,
   shouldEscalate
-} from "./chunk-QUFIEBEP.js";
+} from "./chunk-YZLLC7DL.js";
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js
+// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
-  "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js"(exports, module) {
+  "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
     "use strict";
     var { hasOwnProperty } = Object.prototype;
     var stringify = configure2();
@@ -5173,6 +5174,8 @@ var chatChangeTypeSchema = z14.enum([
   // A review site listing feeding the testimonials library, keyed on the
   // source's id. Immediate — see convex/testimonials/mutations.ts.
   "testimonial-source",
+  // A Credential stored or removed, keyed on its name. Immediate — see convex/credentials/mutations.ts.
+  "credential",
   // A Google spreadsheet created for a Form's leads. Immediate — see
   // convex/flows/destinations/mutations.ts.
   "spreadsheet",
@@ -10145,7 +10148,7 @@ function resolveAdaptFormats(params) {
   return params.formats ?? [];
 }
 
-// ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/esm/wrapper.js
+// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
 var import__ = __toESM(require_safe_stable_stringify(), 1);
 var configure = import__.default.configure;
 var wrapper_default = import__.default;
@@ -10389,6 +10392,22 @@ var IMAGE_GENERATE_MODELS = [
   "google/gemini-3-pro-image-preview"
 ];
 var DEFAULT_IMAGE_GENERATE_MODEL = "google/gemini-3.1-flash-image";
+var IMAGE_PRICE_TIER = {
+  "openai/gpt-image-2.5-sunburst": "standard",
+  "openai/gpt-image-2": "standard",
+  "openai/gpt-5.4-image-2": "standard",
+  "google/gemini-3.1-flash-image": "standard",
+  "google/gemini-3.1-flash-lite-image": "standard",
+  "google/gemini-3-pro-image": "pro",
+  "recraft/recraft-v4.1-pro-vector": "standard",
+  "google/gemini-3.1-flash-image-preview": "standard",
+  "google/gemini-3-pro-image-preview": "pro"
+};
+var IMAGE_TIER_CREDITS = { pro: 20, standard: 5 };
+function imagePictureCredits(model) {
+  const tier = IMAGE_PRICE_TIER[model] ?? "standard";
+  return IMAGE_TIER_CREDITS[tier];
+}
 var VIDEO_GENERATE_MODELS = [
   "bytedance/seedance-2.0",
   "bytedance/seedance-2.5",
@@ -11947,6 +11966,22 @@ function estimateNodeCredits(input) {
   return usd === null ? null : usdToCredits(usd);
 }
 
+// ../canvas-contract/src/personRealism.ts
+var PHONE_CAMERA = "Shot on a phone, an iPhone or a Samsung Galaxy, with the main camera in the default photo mode (not portrait mode): slightly wide angle, held by a friend about a metre away or at arm's length, the background mostly in focus the way phone photos are, the phone's own processing \u2014 HDR evening out a bright window, a touch of over-sharpening, smoothed noise in the shadows, punchy everyday colour. Slightly imperfect framing. Not a professional camera: no bokeh or creamy background blur, no lens compression, no studio or flash lighting, no colour grade.";
+var REAL_SKIN = "Real skin and a real face: visible pores, fine lines, uneven tone, small marks, stray hairs, slight asymmetry. Clothes with real creases.";
+var NOT_A_MODEL = "Not stock photography, not a model or an influencer: no beauty retouching, no glowing or plastic skin, no perfectly symmetrical features.";
+function candidPersonPortraitPrompt(p) {
+  return [
+    `An unretouched candid phone photo of one ordinary, real person: ${p.subject}`,
+    p.wardrobe?.trim() ? `Wearing: ${p.wardrobe.trim()}` : null,
+    `Where: ${p.setting?.trim() || "an everyday place that fits who they are, in daylight"}, available light only. They look toward the lens mid-conversation with a relaxed, unposed expression. Framed from the head to mid-torso, face clearly visible.`,
+    PHONE_CAMERA,
+    REAL_SKIN,
+    NOT_A_MODEL,
+    "No text, logos or watermarks. One person only."
+  ].filter((line) => line !== null).join("\n");
+}
+
 // ../canvas-contract/src/validateParams.ts
 function isManagedNodeKind(nodeType) {
   return Object.keys(MODEL_REGISTRY).includes(nodeType);
@@ -13647,8 +13682,10 @@ var GPT_IMAGE_BRIEF = {
       texture: "real textures, true-to-life light and colour",
       purpose: ""
     },
-    // The user: people look "too AI", faces too dark; wants natural, real-looking people (BENCH.md § "E1 v2").
-    people: "people look real: natural skin texture, well-lit faces, relaxed everyday expressions"
+    // The user: people look "too AI", faces too dark; wants natural, real-looking people (BENCH.md § "E1 v2"),
+    // and again on the final sets, "more natural please" (§ "Fix round"); and real people's photos are
+    // taken on a phone, not a professional camera (AV2, scripts/creative-evals/avatar-realism.mjs).
+    people: "candid people shot on a phone: real skin, natural light, relaxed expressions"
   },
   // n 1: the variants are one call per direction, not one n=3 call. Same cost (n is billed per
   // image, E0) and returns 3/3 either way, but one n=3 call gave >=2 distinct options in 25% of
@@ -13683,7 +13720,7 @@ var GEMINI_IMAGE_BRIEF = {
       purpose: "because a polished picture reads as an ad and this one has to read as a real post"
     },
     produced: { photo: "a real photograph", texture: "real textures and true-to-life light and colour", purpose: "" },
-    people: "the people look real, with natural skin texture, well-lit faces and relaxed everyday expressions"
+    people: "the people look real and candid, shot on a phone, with natural skin, natural light and relaxed expressions"
   },
   // No `n` on Gemini image (gemini §0.4); Pro 2K costs the same as 1K and small text blurs
   // at 1K (gemini §0.3).
@@ -13769,14 +13806,15 @@ function imageRenderParams(model, want) {
 var STORIES = { top: 0.16, bottom: 0.22, left: 0.06, right: 0.06 };
 var REELS_SAFE_BOTTOM = 0.37;
 var FEED = { top: 0.06, bottom: 0.06, left: 0.07, right: 0.07 };
+var FEED_IMAGE = { top: 0.04, bottom: 0.04, left: 0.04, right: 0.04 };
 var EVERY_SURFACE = /* @__PURE__ */ new Set(["automatic", "facebook", "instagram"]);
 function staticSafeArea(format, placements) {
-  if (format !== "9:16") return { ...FEED, placement: "feed" };
+  if (format !== "9:16") return { ...FEED_IMAGE, placement: "feed" };
   const named = (placements ?? []).map((p) => p.toLowerCase());
   const reels = named.length === 0 || named.some((p) => p.includes("reels") || EVERY_SURFACE.has(p));
   if (reels) return { ...STORIES, bottom: REELS_SAFE_BOTTOM, placement: "reels" };
   if (named.some((p) => p.includes("stor"))) return { ...STORIES, placement: "stories" };
-  return { ...FEED, placement: "feed" };
+  return { ...FEED_IMAGE, placement: "feed" };
 }
 function videoSafeArea(format) {
   return format === "9:16" ? { ...STORIES, bottom: REELS_SAFE_BOTTOM } : FEED;
@@ -14057,18 +14095,17 @@ function readAdSpec(raw) {
   const advertiser = raw?.reference?.advertiser;
   return adSpecFromBlueprint(raw, { scrub: typeof advertiser === "string" ? [advertiser] : [] });
 }
-var IN_SCENE_MAX_WORDS = 3;
-var wordsIn = (text) => text.split(/\s+/).filter(Boolean).length;
-function withShortInSceneLettering(spec) {
-  const surface = (line, i) => line.on ? line.on.trim().toLowerCase() : `#${i}`;
-  const words = /* @__PURE__ */ new Map();
-  spec.copy.forEach((line, i) => {
-    if (line.lettering !== "in_scene") return;
-    words.set(surface(line, i), (words.get(surface(line, i)) ?? 0) + wordsIn(line.text));
-  });
-  if (![...words.values()].some((n) => n > IN_SCENE_MAX_WORDS)) return spec;
-  const copy = spec.copy.map((line, i) => {
-    if (line.lettering !== "in_scene" || (words.get(surface(line, i)) ?? 0) <= IN_SCENE_MAX_WORDS) return line;
+var HAND_LETTERED = /\b(?:hand[- ]?(?:written|writing|lettered|lettering|drawn)|handwrit\w*|scrawl\w*|scribbl\w*|markers?|felt[- ]?(?:tip|pen)s?|chalked|(?:written|drawn|lettered|painted) by hand)\b/i;
+var HANDWRITING = new RegExp(
+  `${HAND_LETTERED.source}|\\b(?:chalk\\w*|whiteboards?|blackboards?|sticky[- ]notes?|post[- ]?its?|notepads?|notebooks?|napkins?)\\b`,
+  "i"
+);
+var handwritten = (line) => !line.on?.trim() || HANDWRITING.test(`${line.on} ${line.look ?? ""} ${line.position ?? ""}`);
+function withRenderedLettering(spec) {
+  const designed = (line) => line.lettering === "in_scene" && handwritten(line);
+  if (!spec.copy.some(designed)) return spec;
+  const copy = spec.copy.map((line) => {
+    if (!designed(line)) return line;
     const { on, look: _look, position, ...rest } = line;
     const over = position ?? (on ? `over ${on}` : void 0);
     return { ...rest, lettering: "designed", ...over ? { position: over } : {} };
@@ -14169,14 +14206,22 @@ function referencesFromBlueprint(bp, scrub) {
     ({ collection, entry }) => str(entry.reference_image) && !(collection === "brands_logos" && str(entry.function_in_image) === "advertiser_brand")
   );
   const counters = /* @__PURE__ */ new Map();
-  return labelled.map(({ collection, entry }) => {
+  const pictured = labelled.map(({ collection, entry }) => {
     const { role, prefix } = referenceRoleOf(collection, entry);
     const n = (counters.get(prefix) ?? 0) + 1;
     counters.set(prefix, n);
-    const described = entry.description ?? entry.apparent_identity_or_role ?? entry.what_it_represents;
-    const what = plainText(described, scrub) || `the ${role === "identity" ? "subject" : role} in this picture`;
+    const described2 = entry.description ?? entry.apparent_identity_or_role ?? entry.what_it_represents;
+    const what = plainText(described2, scrub) || `the ${role === "identity" ? "subject" : role} in this picture`;
     return { id: `${prefix}_${n}`, role, slot: sanitizeId(`el_${str(entry.reference_image)}`, "el"), what };
   });
+  const described = entries(bp.subjects).flatMap((entry) => {
+    const what = plainText(entry.description, scrub);
+    if (str(entry.reference_image) || !what || referenceRoleOf("subjects", entry).role !== "product") return [];
+    const n = (counters.get("PRODUCT") ?? 0) + 1;
+    counters.set("PRODUCT", n);
+    return [{ id: `PRODUCT_${n}`, role: "product", what }];
+  });
+  return [...pictured, ...described];
 }
 function logoPositionOf(bp, scrub) {
   const own = entries(bp.brands_logos).find((e) => str(e.function_in_image) === "advertiser_brand");
@@ -14354,6 +14399,7 @@ function copyAsLineRefs(text, copy) {
 }
 function unwanted(clause, k) {
   if (k.logo && /\bno (logos?|wordmarks?|branding)\b/i.test(clause)) return true;
+  if (HAND_LETTERED.test(clause)) return true;
   if (/\bsource (ad|composition)\b|\bORIGINAL\b|\bcompetitor|\breference ad\b/.test(clause)) return true;
   return k.positive && NEGATION.test(clause.replace(/"[^"\n]*"/g, ""));
 }
@@ -14376,7 +14422,10 @@ function clip(text, max) {
     if (wordCount(out + s) > max) break;
     out += s;
   }
-  return sentence((out.trim() || text.split(/\s+/).slice(0, max).join(" ")).replace(/[\s,;:]+$/, ""));
+  if (out.trim()) return sentence(out.trim().replace(/[\s,;:]+$/, ""));
+  const head = text.split(/\s+/).slice(0, max).join(" ");
+  const clause = head.match(/^(.*?)[,;:—–](?:\s[^,;:—–]*)?$/)?.[1];
+  return sentence((clause?.trim() || head).replace(/[\s,;:]+$/, ""));
 }
 function neutralName(l) {
   if (l > 0.95) return "white";
@@ -14500,7 +14549,9 @@ function logoInstruction(p, ctx) {
   const at2 = position ? `, ${position.replace(/[\s,;:.!?]+$/, "")}` : "";
   const plate = ctx.plates.length > 0 ? ctx.plates.map((u) => `${u.name} (${u.hex})`).join(" or ") : "white or black";
   const where = `at least a fifth of the frame wide, on an area it contrasts with or a small ${plate} plate`;
-  return ctx.flowing ? `the brand's real logo. Reproduce it once${at2}, exactly as drawn in Image ${p.index}, ${where}.` : `the brand's real logo. Reproduce it once${at2}, exactly as drawn, ${where}; never tiny.`;
+  if (ctx.short)
+    return "the brand's real logo. Reproduce it once, exactly as drawn, at least a fifth of the frame wide.";
+  return ctx.flowing ? `the brand's real logo. Reproduce it once, apart from the product${at2}, exactly as drawn in Image ${p.index}, ${where}.` : `the brand's real logo. Reproduce it once, never on the product${at2}, exactly as drawn, ${where}.`;
 }
 function identityInstruction(p, what, keep, flowing) {
   if (p.spec && personOrAnimal(p.spec) === "person") {
@@ -14600,6 +14651,7 @@ var ROLE_WORDS = {
   discount: "the discount",
   cta: "the button",
   button: "the button",
+  call_to_action: "the button",
   caption: "a caption",
   fine_print: "the fine print",
   legal: "the fine print",
@@ -14640,7 +14692,8 @@ function textNotes(copy, profile) {
     notes.push(`Keep every accent and mark exactly: ${marks.join(" ")}.`);
   return notes;
 }
-var isButton = (l) => l.role?.toLowerCase() === "cta" || /button/i.test(l.look ?? "");
+var BUTTON_ROLES = /* @__PURE__ */ new Set(["cta", "button", "call_to_action"]);
+var isButton = (l) => BUTTON_ROLES.has(roleKey(l.role)) || /button/i.test(l.look ?? "");
 var FIGURE_ROLES = /* @__PURE__ */ new Set(["price", "stat", "figure", "number", "discount"]);
 var HEADLINE_ROLES = /* @__PURE__ */ new Set(["headline", "title"]);
 var FINE_PRINT_ROLES = /* @__PURE__ */ new Set(["fine_print", "legal", "disclaimer", "footnote"]);
@@ -14651,7 +14704,7 @@ function fullHierarchy(ranked, lead) {
   const { designed, figure, headline, button } = ranked;
   const size = lead === figure ? "very large" : "at least half the frame wide";
   return [
-    ...lead ? [`line ${lead.n} largest (${size}), read first on a phone`] : [],
+    ...lead ? [`line ${lead.n} largest (${size}), read first`] : [],
     ...lead && figure && headline ? [`then line ${headline.n}`] : [],
     ...button ? [`line ${button.n} ${BUTTON_SIZE}`] : [],
     ...designed.length > 1 ? ["every line readable at a glance"] : [],
@@ -14699,11 +14752,11 @@ function brandRoleColours(spec, brand) {
   return roles.flatMap(([applies, object, hex]) => applies && hex ? [{ object, name: colourName(hex), hex }] : []);
 }
 var NATIVE_CAPTURE = /\b(selfie|phone[- ]camera|phone photo|shot on (?:a )?phone|taken on (?:a )?phone|smartphone photo|ugc|user[- ]generated|webcam|front[- ]camera|snapshot|native caption)\b/i;
-var PHONE_CAMERA = /\b(phone|smartphone|iphone)\b/i;
+var PHONE_CAMERA2 = /\b(phone|smartphone|iphone)\b/i;
 function isNativeCapture(spec) {
   if (spec.scene.look !== "photo") return false;
   const capture = spec.scene.capture ?? "";
-  return NATIVE_CAPTURE.test(`${spec.scene.description} ${capture}`) || PHONE_CAMERA.test(capture);
+  return NATIVE_CAPTURE.test(`${spec.scene.description} ${capture}`) || PHONE_CAMERA2.test(capture);
 }
 function colourUses(spec, brand, k) {
   const allowed = brand ? new Set(
@@ -14747,10 +14800,10 @@ function variantDirection(c) {
 }
 var DEPARTS = "It leads where it differs from the scene and line notes above.";
 var DEPARTS_SHORT = "It leads over the notes above.";
-var SUPPORT_ROLE = /\b(?:cta|fine[_ ]?print|legal|footnote|attribution|disclaimer)\b/i;
+var isSupport = (l) => isButton(l) || FINE_PRINT_ROLES.has(roleKey(l.role)) || roleKey(l.role) === "attribution";
 function hookDirection(c) {
   const hooks = c.spec.copy.flatMap(
-    (l, i) => l.lettering === "designed" && !isButton(l) && !SUPPORT_ROLE.test(l.role ?? "") ? [{ n: i + 1, text: l.text }] : []
+    (l, i) => l.lettering === "designed" && !isSupport(l) ? [{ n: i + 1, text: l.text }] : []
   );
   const [first, ...rest] = hooks;
   const lead = rest.find((l) => /\d/.test(l.text)) ?? rest[0];
@@ -14806,7 +14859,7 @@ function pictureDirection(c) {
   ];
 }
 function compileStaticBrief(written, brandOverride, format, viewerOverride, profile, opts = {}) {
-  const spec = withShortInSceneLettering(written);
+  const spec = withRenderedLettering(written);
   const job = opts.job ?? "generate";
   const designedLines2 = spec.copy.flatMap((l, i) => l.lettering === "designed" ? [i + 1] : []);
   const pics = pictures(spec, opts, job, profile, designedLines2.length > 0);
@@ -14844,7 +14897,9 @@ function compileStaticBrief(written, brandOverride, format, viewerOverride, prof
     words: wordCount(prompt)
   };
 }
-var MAX_TRIM = 15;
+var MAX_TRIM = 16;
+var LAST_RESORT_LEVEL = 16;
+var PRODUCT_NOTE_WORDS = 10;
 var EXTRAS_SHORT_LEVEL = 15;
 var CAPTURE_LEVEL = 9;
 var SHORT_DIRECTION_LEVEL = 10;
@@ -14919,6 +14974,7 @@ function picturesSection(c) {
     plates: plateColours(c.spec, c.brand, c.clean),
     thirdParty: c.spec.third_party_brands,
     flowing: c.flowing,
+    short: c.level >= LAST_RESORT_LEVEL,
     ...c.spec.logo_position ? { logoPosition: c.spec.logo_position } : {}
   };
   const lines = c.pics.map((p) => {
@@ -14945,8 +15001,12 @@ function photoLook(c) {
   const purpose = r.purpose ? `, ${r.purpose}` : "";
   return `It is ${r.photo}${capture ? `, ${capture}` : ""}, with ${r.texture}${purpose}.`;
 }
+function animalsText(c) {
+  if (!showsAnimals(c.spec) || c.level >= EXTRAS_SHORT_LEVEL) return "";
+  return c.flowing ? " The animals look real, with real fur, natural light and a candid moment." : " Animals look real: real fur, natural light, a candid moment.";
+}
 function lookText(c) {
-  const people = showsPeople(c.spec) ? peopleText(c) : "";
+  const people = `${showsPeople(c.spec) ? peopleText(c) : ""}${animalsText(c)}`;
   if (c.spec.scene.look === "photo") return `${photoLook(c)}${people}`;
   const look = c.spec.scene.look === "illustration" ? ILLUSTRATION_LOOK : DESIGNED_LOOK;
   return `${c.flowing ? look.flowing : look.labelled}${people}`;
@@ -14965,27 +15025,66 @@ function peopleText(c) {
   const said = c.level >= EXTRAS_SHORT_LEVEL ? "People look real, faces well lit." : sentence(capitalize(cue));
   return ` ${said}${target2 ? ` Their gaze or pose leads toward line ${target2.n}.` : ""}`;
 }
+var looksRendered = (spec) => showsPeople(spec) || showsAnimals(spec) || showsScreen(spec);
+var ANIMALS = /\b(dogs?|puppy|puppies|cats?|kittens?|pets?|horses?|birds?|rabbits?|animals?)\b/i;
+function showsAnimals(spec) {
+  if (spec.scene.look === "illustration") return false;
+  if (spec.references.some((r) => r.id.startsWith("ANIMAL_"))) return true;
+  return spec.scene.look === "photo" && ANIMALS.test(`${spec.scene.description} ${spec.scene.layout ?? ""}`);
+}
 var SCREEN = /\b(apps?|screens?|lock[- ]screen|dashboard|interface|mockup|notification|laptop|tablet|browser|website|chat bubbles?|ui)\b/i;
 function showsScreen(spec) {
   const ons = spec.copy.map((l) => l.on ?? "").join(" ");
   return SCREEN.test(`${spec.scene.description} ${spec.scene.layout ?? ""} ${ons}`);
 }
 var SCREENS = {
-  labelled: "Screens: crisp, realistic device interfaces, sharp and true to proportion; any words on them from the quoted lines.",
-  flowing: "Every phone or app screen is a crisp, realistic device interface, sharp and true to proportion, any words on it from the quoted lines."
+  labelled: "Screens: a real phone photographed, or a real screenshot: real app density, a real status bar, flat true-to-life colours; any words on them from the quoted lines.",
+  flowing: "Every phone or app screen looks like a real phone photographed or a real screenshot, with real app density, a real status bar and flat true-to-life colours, any words on it from the quoted lines."
 };
+var SCREENSHOT = /\b(screenshots?|screen ?grabs?|screens?)\b/i;
+var screenshotOf = (pics) => pics.find((p) => p.spec && p.role !== "identity" && SCREENSHOT.test(p.spec.what));
 function screensText(c) {
+  const shot = screenshotOf(c.pics);
+  if (shot) {
+    return c.flowing ? ` Every screen shows Image ${shot.index} exactly as it is, on a real phone, photographed.` : `
+Screens: every screen shows Image ${shot.index} exactly as it is, on a real phone, photographed.`;
+  }
   if (!showsScreen(c.spec) || c.level >= EXTRAS_SHORT_LEVEL) return "";
   return c.flowing ? ` ${SCREENS.flowing}` : `
 ${SCREENS.labelled}`;
 }
+function unwiredProductsText(c) {
+  const wired = new Set(c.pics.map((p) => p.label));
+  return c.spec.references.filter((r) => r.role === "product" && !wired.has(r.id)).map((r) => {
+    const what = plain(r.what, c.clean).replace(/[.!?]+$/, "");
+    const told = c.level >= LAST_RESORT_LEVEL ? clipNote(what.split(/[,;]/)[0] ?? what, PRODUCT_NOTE_WORDS) : what;
+    return ` The product, ${told}, is in the frame, whole and clearly visible.`;
+  }).join("");
+}
+function unwiredPeopleText(c) {
+  const wired = new Set(c.pics.map((p) => p.label));
+  return c.spec.references.filter((r) => r.role === "identity" && r.id.startsWith("PERSON_") && !wired.has(r.id)).map((r) => {
+    const what = plain(r.what, c.clean).replace(/[.!?]+$/, "");
+    const told = c.level >= LAST_RESORT_LEVEL ? clipNote(what.split(/[,;]/)[0] ?? what, PRODUCT_NOTE_WORDS) : what;
+    return ` The person, ${told}, is an invented, ordinary real person \u2014 real skin, unposed, never a model.`;
+  }).join("");
+}
+var BEFORE_AFTER = /\bbefore\b[^.]{0,40}\bafter\b|\bantes\b[^.]{0,30}\bdespu[eé]s\b|\bavant\b[^.]{0,30}\bapr[eè]s\b|\bvorher\b[^.]{0,30}\bnachher\b|\bprima\b[^.]{0,30}\bdopo\b/i;
+function isBeforeAfter(spec) {
+  const told = [spec.scene.description, spec.scene.layout, spec.direction, ...spec.mechanism.map((m) => m.device)];
+  return BEFORE_AFTER.test(told.filter(Boolean).join(" \n "));
+}
+var BEFORE_AFTER_TEXT = " The two states it compares differ clearly at a glance, even as a thumbnail; only the result changes between them.";
 function sceneSection(c) {
   if (c.job !== "generate") return [];
   const scene = c.spec.scene;
-  const description = capitalize(clip(sentence(plain(scene.description, c.clean)), SCENE_CAP[c.level] ?? 15));
+  const products = `${unwiredProductsText(c)}${unwiredPeopleText(c)}${isBeforeAfter(c.spec) ? BEFORE_AFTER_TEXT : ""}`;
+  const told = normalized(products);
+  const own = (sentence(plain(scene.description, c.clean)).match(/[^.!?]+[.!?]*/g) ?? []).filter((s) => !products || !told.includes(normalized(s.replace(/^\s*in the frame:?/i, "")))).join("").trim();
+  const description = capitalize(clip(own || sentence(plain(scene.description, c.clean)), SCENE_CAP[c.level] ?? 15));
   const mood = scene.mood && c.level < 1 ? ` The mood is ${sentence(plain(scene.mood, c.clean))}` : "";
   const out = [
-    c.flowing ? `${description}${mood} ${lookText(c)}${screensText(c)}${otherBrandsText(c)}` : `Scene: ${description}${mood}
+    c.flowing ? `${description}${products}${mood} ${lookText(c)}${screensText(c)}${otherBrandsText(c)}` : `Scene: ${description}${products}${mood}
 ${lookText(c)}${screensText(c)}${otherBrandsText(c)}`
   ];
   const layout = scene.layout && c.level < 2 ? unsaid(plain(scene.layout, c.clean), plain(scene.description, c.clean)) : "";
@@ -15009,7 +15108,11 @@ function textSection(c) {
     ...textNotes(copy, c.profile)
   ].join("\n");
 }
-var productLabel = (c) => c.pics.some((p) => p.role === "product") ? " besides the product's own label" : "";
+function productLabel(c) {
+  const shot = screenshotOf(c.pics);
+  if (shot) return ` besides the words on Image ${shot.index}'s screen`;
+  return c.pics.some((p) => p.role === "product") ? " besides the product's own label" : "";
+}
 function colourSection(c) {
   if (c.job !== "generate") return [];
   const uses = colourUses(c.spec, c.brand, c.clean);
@@ -15022,7 +15125,7 @@ function layoutSection(c) {
     c.pics.some((p) => p.role === "logo"),
     c.spec.copy.some(isButton)
   );
-  const safe = c.opts.band?.margin ? marginText(c.opts.band, items, c.profile.brief.structure) : c.opts.band ? bandText(c.opts.band, items, c.flowing, staticSafeArea(c.format, c.opts.placements).placement !== "feed") : safeAreaText(c.format, c.opts.placements, items, c.profile.brief.structure);
+  const safe = c.opts.zoned ? "" : c.opts.band?.margin ? marginText(c.opts.band, items, c.profile.brief.structure) : c.opts.band ? bandText(c.opts.band, items, c.flowing, staticSafeArea(c.format, c.opts.placements).placement !== "feed") : safeAreaText(c.format, c.opts.placements, items, c.profile.brief.structure);
   const out = [safe, legibilityText(c), fillText(c)].filter(Boolean).join(" ");
   return c.flowing ? out : `Layout: ${out}`;
 }
@@ -15052,8 +15155,8 @@ function positiveConstraints(c) {
   const others = thirdPartyNames(c.spec);
   if (n === 0)
     return `The only words in the finished image are none at all: it is picture only${logo ? `, with the one logo from Image ${logo.index}` : ""}.`;
-  const label = productLabel(c) ? ", besides the product's own label" : "";
-  const onlyLogo = !logo ? "" : others ? `, and the logos are the one in Image ${logo.index} and ${others}` : `, and the one logo is the one in Image ${logo.index}`;
+  const label = productLabel(c) ? `,${productLabel(c)}` : "";
+  const onlyLogo = !logo ? "" : others ? `, and the logos are the one in Image ${logo.index} and ${others}, the only brand marks anywhere, vehicles, packaging and clothing included` : `, and the one logo is the one in Image ${logo.index}, the only brand mark anywhere, vehicles, packaging and clothing included`;
   return `The only words in the finished image are the ${n} quoted lines above, each exactly once; every other surface carries picture only${label}${onlyLogo}.`;
 }
 function constraintsSection(c) {
@@ -15066,12 +15169,13 @@ function constraintsSection(c) {
   ];
   const avoid = [
     n > 0 ? `any words other than the ${n} quoted lines` : "any words or letters",
-    logos.length > 0 ? `any logo other than ${logos.join(" and ")}` : "any logo or wordmark",
+    // A Toyota badge appeared on a car-loan ad's SUV (BENCH.md § "Final"): the allow-list covers the scene's things too.
     // The words and the identity's "show them once" are said above; brief v2 spends the words on the logo and the button.
-    "badges, icons, seals or stickers not named here",
+    `${logos.length > 0 ? `any logo, badge, icon, seal or sticker other than ${logos.join(" and ")}` : "any logo or wordmark, badge, icon, seal or sticker"}, on vehicles, packaging and clothing too`,
     "watermarks",
     ...c.job === "generate" && isNativeCapture(c.spec) ? ["a staged, retouched or studio-lit look"] : [],
-    ...c.job === "generate" && showsPeople(c.spec) ? ["glossy, airbrushed skin or faces in shadow"] : []
+    // The user found the people, a dog and a phone screen "very AI" (BENCH.md § "Fix round").
+    ...c.job !== "generate" ? [] : showsPeople(c.spec) ? ["glossy, CGI or airbrushed skin; faces in shadow"] : looksRendered(c.spec) ? ["a glossy CGI look"] : []
   ];
   return `Avoid: ${avoid.join("; ")}.`;
 }
@@ -15108,6 +15212,9 @@ function judgeBrief(brief, opts = {}) {
     brief
   ].join("\n");
 }
+var NUMBERED_COPY = /^(\d+\. )"(.*)"( — )/gm;
+var withoutCopy = (prompt) => prompt.replace(NUMBERED_COPY, '$1""$3');
+var briefWords = (prompt) => wordCount(withoutCopy(prompt));
 
 // src/engine/scaffold/static-sizes.ts
 function ratioValue2(ratio) {
@@ -15271,24 +15378,26 @@ function logoSlot(frame, safe, opts = {}) {
 var STATIC_ADAPT_FORMAT_ROLE = "static_adapt_format";
 function adaptPlan(model, format, placements) {
   const renderRatio = nearestSupportedAspectRatio("image_generate", model, format);
+  return {
+    format,
+    ...placements && placements.length > 0 ? { placements: [...placements] } : {},
+    renderRatio,
+    size: deliveredSize(format),
+    safe: safeAreaOnFrame(renderRatio, format, placements)
+  };
+}
+function safeAreaOnFrame(frame, format, placements) {
   const own = staticSafeArea(format, placements);
-  const rendered = ratioValue2(renderRatio);
+  const rendered = ratioValue2(frame);
   const delivered = ratioValue2(format);
   const keepH = rendered < delivered ? rendered / delivered : 1;
   const keepW = rendered > delivered ? delivered / rendered : 1;
-  const safe = {
+  return {
     top: (1 - keepH) / 2 + own.top * keepH,
     bottom: (1 - keepH) / 2 + own.bottom * keepH,
     left: (1 - keepW) / 2 + own.left * keepW,
     right: (1 - keepW) / 2 + own.right * keepW
   };
-  return {
-    format,
-    ...placements && placements.length > 0 ? { placements: [...placements] } : {},
-    renderRatio,
-    size: deliveredSize(format),
-    safe
-  };
 }
 function trimmedRenderBand(plan) {
   const own = staticSafeArea(plan.format, plan.placements);
@@ -15322,65 +15431,119 @@ function adaptNoun(plan) {
   if (r === 1) return "square feed ad";
   return r < 1 ? "vertical feed ad" : "landscape ad";
 }
-function adaptDeliverable(plan, brand, flowing, wordsOnly2) {
+function adaptDeliverable(plan, spec, flowing, ground, short) {
+  const brand = spec.brand?.name;
   const noun = `${adaptNoun(plan)}${brand ? ` for ${brand}` : ""}`;
-  const cast = wordsOnly2 ? `${SAME_CAST} ${GROUND_ONLY}` : SAME_CAST;
-  return flowing ? `Image 1 is a finished ad. Re-lay out this exact ad as a ${noun}: its message, every word, its people, product, logo, colours and typeface, in a new layout built for this frame, with the text, the logo, the button and the picture moved and re-scaled to fit the shape and the scene filling the whole frame edge to edge, rather than Image 1 shrunk onto a background or set as a card or panel. Every person, product and line appears whole and once. ${cast}` : `Deliverable: the ad in Image 1, re-laid out as a finished ${noun}. Keep its message, every word, its people, product, logo, colours and typeface; build a new layout for this frame: move and re-scale the text, the logo, the button and the picture to fit the shape. Do not shrink Image 1 onto a background or set it as a card, panel or framed picture: the scene fills the whole frame, edge to edge. Nothing is cropped: every person, product and line appears whole, and once. ${cast}`;
-}
-var SAME_CAST = "The people, products and objects are exactly the ones in Image 1, the same individuals; add no person, animal, product or object that Image 1 does not show.";
+  if (short && !flowing) {
+    const keep = [
+      ...showsPeople2(spec) ? ["each person the same face and clothes"] : [],
+      ...isBeforeAfter(spec) ? ["the two states as different"] : []
+    ];
+    return `Deliverable: the ad in Image 1, re-laid out as a finished ${noun}: the same message, words, people, product, logo, colours and typeface, the scene filling the frame edge to edge, never Image 1 shrunk onto a background. Every person, product and line appears whole and once, as in Image 1${keep.length > 0 ? `, ${keep.join(", ")}` : ""}; add nothing new.`;
+  }
+  const cast = [
+    SAME_CAST,
+    ...showsPeople2(spec) ? [SAME_PERSON] : [],
+    ...isBeforeAfter(spec) ? [SAME_CHANGE] : [],
+    ...ground ? [GROUND_ONLY] : []
+  ].join(" ");
+  return flowing ? `Image 1 is a finished ad. Re-lay out this exact ad as a ${noun}: the same message, words, people, product, logo, colours and typeface in a new layout for this frame, the scene filling it edge to edge rather than Image 1 set on a background as a card, panel or square. ${cast}` : `Deliverable: the ad in Image 1, re-laid out as a finished ${noun}: the same message, words, people, product, logo, colours and typeface in a new layout for this frame, the scene filling it edge to edge, never Image 1 shrunk onto a background or set as a card, panel or square. ${cast}`;
+}
+var SAME_CAST = "Every person, product and line appears whole and once, the same individuals as in Image 1; add no person, animal, product or object that Image 1 does not show.";
+var SAME_PERSON = "Each person is the same person as in Image 1: same face, same hair, same clothes.";
+var SAME_CHANGE = "The two states it compares stay as clearly different as in Image 1.";
+var showsPeople2 = (spec) => spec.references.some((r) => r.id.startsWith("PERSON_")) || spec.scene.look !== "illustration" && PEOPLE.test(`${spec.scene.description} ${spec.scene.layout ?? ""}`);
 var GROUND_ONLY = "Image 1 shows no people and no product, so the room this frame adds carries more of Image 1's own background and the brand's colours, never a new scene.";
 function wordsOnly(spec) {
   return spec.references.length === 0 && spec.scene.look !== "photo" && !PEOPLE.test(`${spec.scene.description} ${spec.scene.layout ?? ""}`);
 }
-function scaleText(plan, button, flowing) {
-  const share = ratioValue2(plan.format) < 0.7 ? "half" : "two fifths of";
-  const buttonClause = button ? flowing ? `, the button is a solid shape at least ${share} the frame wide with large bold words` : `; the button is a solid shape at least ${share} the frame wide, its words large and bold` : "";
-  return flowing ? `Every line is set at the size this frame needs rather than at its size in Image 1: the largest line spans most of the width between the margins${buttonClause}, and no small text floats in a large empty area.` : `Scale: set every line for this frame, not at its size in Image 1: the largest line spans most of the width between the margins${buttonClause}; no small text in a large empty area.`;
+var isTall = (plan) => ratioValue2(plan.format) < 0.7;
+var LIST_ROLES = /^(list_item|bullet|row|item)$/i;
+var TABLE = /\b(tables?|columns?|rows?|checklists?|lists?)\b/i;
+var hasRows = (spec) => spec.copy.some((l) => LIST_ROLES.test(l.role ?? "")) || TABLE.test(`${spec.scene.description} ${spec.scene.layout ?? ""}`);
+function scaleText(plan, spec, flowing, zoned, short) {
+  if (short && !flowing) {
+    return isTall(plan) && zoned ? "Scale: larger than in Image 1, the headline across most of the band's width, the words spread through the band." : "Scale: larger than in Image 1, the largest line across most of the width.";
+  }
+  if (!(isTall(plan) && zoned)) {
+    return flowing ? "Every line is set at the size this frame needs rather than at its size in Image 1: the largest line spans most of the width between the margins, and the words fill their space." : "Scale: set every line for this frame, not at its size in Image 1: the largest line spans most of the width between the margins; no small text in a large empty area.";
+  }
+  const rows = hasRows(spec) ? flowing ? " Rows, columns and lists are restacked for the tall frame, one item per line, each larger." : " Rows, columns and lists are restacked for the tall frame, one item per line, each larger, rather than shrunk." : "";
+  return flowing ? `The words are set for this frame, larger than in Image 1: the headline large enough to fill most of the band's width, and every line, the logo and the button spread through the band's height, inside its edges.${rows}` : `Scale: larger than in Image 1: the headline set large enough to fill most of the band's width; every line, the logo and the button spread through the band's height, inside its edges, never a small block in its middle.${rows}`;
 }
 var ZONE_HEADROOM = 0.02;
 var pct = (share) => `${Math.round(share * 100)}%`;
-function zonesText(plan, flowing, groundOnly) {
+function zonesText(plan, flowing, ground, short) {
   const top = plan.safe.top + ZONE_HEADROOM;
   const bottom = plan.safe.bottom + ZONE_HEADROOM;
-  const left = Math.max(plan.safe.left, plan.safe.right) + ZONE_HEADROOM;
+  const side = Math.max(plan.safe.left, plan.safe.right) + ZONE_HEADROOM;
+  const band = `from ${pct(top)} to ${pct(1 - bottom)} of the height, at least ${pct(side)} in from each side`;
   const covered = staticSafeArea(plan.format, plan.placements).placement !== "feed";
-  const why = covered ? ", because the app's interface covers it" : "";
-  const below = groundOnly ? `the bottom ${pct(bottom)} continues Image 1's own background in the brand's colours, with no words, no button and no person or object` : `the bottom ${pct(bottom)} shows only the scene (Image 1's own people, product and the surface they are on), with no words and no button`;
-  const zones = `the top ${pct(top)} of the frame shows only the scene (background, sky, wall), with no logo and no words; from ${pct(top)} down to ${pct(1 - bottom)} of the height sit the logo, every line and the button, large, at least ${pct(left)} in from each side; ${below}${why}`;
-  return flowing ? `The frame is built in zones: ${zones}.` : `Zones, top to bottom: ${zones}.`;
+  if (short && !flowing) {
+    const around = isTall(plan) && covered ? "only the ad's own picture, larger, never a flat colour, a panel or a square" : "only the ad's own picture";
+    return `Zones: every word, the logo and the button sit ${band}; around them, ${around}.`;
+  }
+  if (!(isTall(plan) && covered)) {
+    return flowing ? `The logo, every line and the button sit ${band}; around them the frame shows only the ad's own picture.` : `Zones: the logo, every line and the button sit ${band}; around them, only the ad's own picture.`;
+  }
+  const picture = ground ? "Image 1's background with its shapes and graphics enlarged in the brand's colours" : "Image 1's people, product and setting extended";
+  return flowing ? `The words' band runs ${band}, holding the logo, every line and the button. Above and below it the app's interface covers the frame, so there it shows only the ad's own picture, larger: ${picture}, edge to edge.` : `Zones: the logo, every line and the button sit in one band, ${band}; the top ${pct(top)} and the bottom ${pct(bottom)} carry neither words, the logo nor the button. Above and below it, where the app's interface covers the frame, only the ad's own picture, larger: ${picture}, never a flat empty colour, a panel or a square on a background.`;
 }
-var isButton2 = (line) => /cta|button/i.test(`${line.role ?? ""} ${line.look ?? ""}`);
 function adaptBrief(spec, profile, opts) {
   const { plan, images } = opts;
   const flowing = profile.brief.structure === "flowing_sentences";
   const { logo_position: _logoPosition, ...rest } = spec;
   const unplaced = { ...rest, copy: spec.copy.map(({ position: _position, ...line }) => line) };
   const band = trimmedRenderBand(plan);
-  const compiled = compileStaticBrief(unplaced, void 0, plan.format, void 0, profile, {
-    job: "relay",
-    images: {
-      base: images.base,
-      ...images.logo ? { logo: images.logo } : {},
-      ...images.type ? { type: images.type } : {}
-    },
-    ...plan.placements ? { placements: plan.placements } : {},
-    ...band ? { band } : {}
-  });
-  const paragraphs = compiled.prompt.split("\n\n");
+  const zoned = opts.zones !== false;
   const ground = wordsOnly(spec);
-  paragraphs[0] = adaptDeliverable(plan, spec.brand?.name, flowing, ground);
-  const first = spec.copy[0]?.text;
-  const textAt = first ? paragraphs.findIndex((p) => p.includes(first)) : -1;
-  if (textAt >= 0) {
-    const added = [
-      scaleText(plan, spec.copy.some(isButton2), flowing),
-      ...opts.zones === false ? [] : [zonesText(plan, flowing, ground)]
-    ];
-    paragraphs.splice(textAt + 1, 0, ...added);
+  const compile = (wordBudget) => compileStaticBrief(
+    unplaced,
+    void 0,
+    plan.format,
+    void 0,
+    { ...profile, brief: { ...profile.brief, wordBudget } },
+    {
+      job: "relay",
+      images: {
+        base: images.base,
+        ...images.logo ? { logo: images.logo } : {},
+        ...images.type ? { type: images.type } : {},
+        refs: images.refs ?? {}
+      },
+      ...plan.placements ? { placements: plan.placements } : {},
+      ...band ? { band } : {},
+      ...zoned ? { zoned } : {}
+    }
+  );
+  const relaid = (compiled2, short = false) => {
+    const paragraphs = compiled2.prompt.split("\n\n");
+    paragraphs[0] = adaptDeliverable(plan, spec, flowing, ground && !zoned, short);
+    const first = spec.copy[0] ? quotedCopy(spec.copy[0].text) : void 0;
+    const textAt = first ? paragraphs.findIndex((p) => p.includes(first)) : -1;
+    if (textAt >= 0) {
+      const added = [
+        ...zoned ? [zonesText(plan, flowing, ground, short)] : [],
+        scaleText(plan, spec, flowing, zoned, short)
+      ];
+      paragraphs.splice(textAt + 1, 0, ...added);
+    } else if (zoned) {
+      const layoutAt = paragraphs.findIndex((p) => p.startsWith("Layout:"));
+      paragraphs.splice(layoutAt > 0 ? layoutAt : 1, 0, zonesText(plan, flowing, ground, short));
+    }
+    return paragraphs.join("\n\n");
+  };
+  const budget = profile.brief.wordBudget;
+  let compiled = compile(budget);
+  let prompt = relaid(compiled);
+  for (let pass = 0; pass < 3 && briefWords(prompt) > budget; pass++) {
+    compiled = compile(compiled.words - (briefWords(prompt) - budget));
+    prompt = relaid(compiled);
   }
-  const prompt = paragraphs.join("\n\n");
-  return { ...compiled, prompt, words: prompt.split(/\s+/).filter(Boolean).length };
+  if (briefWords(prompt) > budget) prompt = relaid(compiled, true);
+  return { ...compiled, prompt, words: wordsIn(prompt) };
 }
+var wordsIn = (text) => text.split(/\s+/).filter(Boolean).length;
 
 // src/engine/scaffold/static-topology.ts
 var STATIC_VARIANTS_ROLE = "static_variants";
@@ -15390,6 +15553,7 @@ var STATIC_PICK_ROLE = "pick";
 var STATIC_MASTER_ROLE = "static_master";
 var STATIC_SIZE_ROLE = "static_size";
 var STATIC_ADAPT_ROLE = "static_adapt";
+var STATIC_SAFE_FIT_ROLE = "static_safe_fit";
 var LOGO_COMPOSITE_ROLE = "logo_composite";
 var STATIC_FIX_ROLE = "static_fix";
 var LOGO_COMPOSITE_DEFAULT = false;
@@ -15423,8 +15587,9 @@ function staticMasterFormat(canvas) {
   if (at2 < 0 || !match) return null;
   return formatOfSize({ width: Number(match[1]), height: Number(match[2]) });
 }
+var KNOWN_FORMATS = ["9:16", "4:5", "1:1", "16:9", "1.91:1", ...ASPECT_ADAPT_FORMATS];
 function formatOfSize(size) {
-  for (const format of ["9:16", "4:5", "1:1", "16:9", "1.91:1"]) {
+  for (const format of KNOWN_FORMATS) {
     const d = deliveredSize(format);
     if (d.width === size.width && d.height === size.height) return format;
   }
@@ -15432,9 +15597,17 @@ function formatOfSize(size) {
   const g = gcd(size.width, size.height);
   return `${size.width / g}:${size.height / g}`;
 }
-function safeAreaOf(format) {
-  const { top, bottom, left, right } = staticSafeArea(format);
-  return { top, bottom, left, right };
+function safeAreaOf(adaptFormat, delivered) {
+  const { top, bottom, left, right } = staticSafeArea(adaptFormat);
+  return delivered.map((f) => safeAreaOnFrame(adaptFormat, f)).reduce(
+    (a, b) => ({
+      top: Math.max(a.top, b.top),
+      bottom: Math.max(a.bottom, b.bottom),
+      left: Math.max(a.left, b.left),
+      right: Math.max(a.right, b.right)
+    }),
+    { top, bottom, left, right }
+  );
 }
 function magick(id, role, image, args, extra = {}) {
   return {
@@ -15503,7 +15676,15 @@ function staticRenderNodes(g) {
         model: g.adaptModel,
         formats: adaptFormats,
         image_size: ADAPT_IMAGE_SIZE,
-        safe_areas: Object.fromEntries(adaptFormats.map((f) => [f, safeAreaOf(f)]))
+        safe_areas: Object.fromEntries(
+          adaptFormats.map((f) => [
+            f,
+            safeAreaOf(
+              f,
+              adapted.filter((s) => (s.adaptFormat ?? s.format) === f).map((s) => s.format)
+            )
+          ])
+        )
       },
       tags: { role: STATIC_ADAPT_ROLE }
     });
@@ -15513,7 +15694,9 @@ function staticRenderNodes(g) {
     const slug = formatSlug(s.format);
     const size = sizeNode(s, adaptFormats);
     if (size) nodes.push(size);
-    const ref = size ? `$ref:${size.id}.image` : "$ref:master.image";
+    const fit = safeFitNode(s.format, size ? `$ref:${size.id}.image` : "$ref:master.image", plan.placements);
+    if (fit) nodes.push(fit);
+    const ref = fit ? `$ref:${fit.id}.image` : size ? `$ref:${size.id}.image` : "$ref:master.image";
     if (!g.compositeLogo) return ref;
     const slot = logoSlot(s.size, staticSafeArea(s.format)).rect;
     nodes.push(
@@ -15548,6 +15731,16 @@ function staticRenderNodes(g) {
   });
   return nodes;
 }
+function safeFitNode(format, image, placements) {
+  if (staticSafeArea(format, placements).placement === "feed") return null;
+  return {
+    id: `safe_${formatSlug(format)}`,
+    type: "static_safe_fit",
+    inputs: { image },
+    params: { format, ...placements ? { placements: [...placements] } : {} },
+    tags: { role: STATIC_SAFE_FIT_ROLE }
+  };
+}
 function sizeNode(s, adaptFormats) {
   const id = `size_${formatSlug(s.format)}`;
   if (s.from === "crop" && s.crop) {
@@ -15898,9 +16091,13 @@ function checkReferenceCompleteness(ctx, meta) {
   const elements = (meta.elements ?? []).filter((el) => CHECKED_ELEMENT_TYPES.has(el.type.toLowerCase()));
   const keyworded = elements.map((el) => ({ el, keywords: keywordsForElement(el) })).filter((e) => e.keywords.length > 0);
   if (keyworded.length === 0) return;
+  const sheetSources = JSON.stringify(
+    ctx.canvas.nodes.filter((n) => n.type === "image_reference_sheet").map((n) => n.inputs ?? {})
+  );
   for (let i = 0; i < ctx.canvas.nodes.length; i++) {
     const n = ctx.canvas.nodes[i];
-    if (n?.type === "image_generate") checkFrameReferences(ctx, n, i, keyworded);
+    if (n?.type !== "image_generate" || sheetSources.includes(`"$ref:${n.id}.`)) continue;
+    checkFrameReferences(ctx, n, i, keyworded);
   }
 }
 function checkUnusableLastFrame(ctx) {
@@ -17799,9 +17996,12 @@ async function fetchWithEscalation(url, init, options) {
   let originResponse = null;
   let originTier = "direct";
   let lastError;
-  for (const route of plannedRoutes(url, options.credentials, options.routeOptions)) {
+  const routes = plannedRoutes(url, options.credentials, options.routeOptions);
+  const tried = [];
+  for (let route = routes[0] ?? null; route !== null; route = nextPlannedRoute(routes, tried)) {
     const rung = await attemptRoute(url, init, route, options);
     attempts.push(rung.attempt);
+    tried.push({ tier: rung.attempt.tier, proxyFailure: rung.attempt.outcome === "proxy_unavailable" });
     if (rung.response !== null) {
       originResponse = rung.response;
       originTier = rung.attempt.tier;
@@ -18585,22 +18785,22 @@ function inferMimeFromPath(absPath, sniffBytes) {
   return "application/octet-stream";
 }
 async function rasterizeSvgToPng(bytes) {
-  const { default: sharp5 } = await import("sharp");
-  const base = await sharp5(bytes).metadata();
+  const { default: sharp6 } = await import("sharp");
+  const base = await sharp6(bytes).metadata();
   const longest = Math.max(base.width ?? 0, base.height ?? 0);
   let density = SVG_BASE_DENSITY;
   if (longest > 0) {
     const scaled = Math.round(SVG_BASE_DENSITY * SVG_TARGET_LONGEST_PX / longest);
     density = Math.min(SVG_MAX_DENSITY, Math.max(SVG_BASE_DENSITY, scaled));
   }
-  return await sharp5(bytes, { density }).png({ force: true, palette: false }).toBuffer();
+  return await sharp6(bytes, { density }).png({ force: true, palette: false }).toBuffer();
 }
 var MODEL_SAFE_IMAGE_MIMES = /* @__PURE__ */ new Set(["image/jpeg", "image/png", "image/gif", "image/webp"]);
 var MAX_MODEL_REFERENCE_BYTES = 30 * 1024 * 1024;
 async function fitWithinReferenceLimit(bytes, mime, maxBytes) {
   if (bytes.byteLength <= maxBytes) return { bytes, mime };
-  const { default: sharp5 } = await import("sharp");
-  const read = () => sharp5(bytes, { animated: true });
+  const { default: sharp6 } = await import("sharp");
+  const read = () => sharp6(bytes, { animated: true });
   const meta = await read().metadata();
   const animated = (meta.pages ?? 1) > 1;
   const keepAlpha = meta.hasAlpha === true;
@@ -18638,11 +18838,11 @@ async function toModelSafeImage(bytes, opts) {
   if (sniffSvg(bytes)) {
     return await fit(await rasterizeSvgToPng(bytes), "image/png", "svg");
   }
-  const { default: sharp5 } = await import("sharp");
+  const { default: sharp6 } = await import("sharp");
   let png;
   let format;
   try {
-    const img = sharp5(bytes);
+    const img = sharp6(bytes);
     format = (await img.metadata()).format ?? "unknown";
     png = await img.png({ force: true }).toBuffer();
   } catch (e) {
@@ -18660,8 +18860,8 @@ function normalizationNote(image) {
   }
   return parts.length > 0 ? parts.join("; ") : null;
 }
-function hasAscii(buf, offset, sig) {
-  return buf.length >= offset + sig.length && buf.toString("ascii", offset, offset + sig.length) === sig;
+function hasAscii(buf, offset2, sig) {
+  return buf.length >= offset2 + sig.length && buf.toString("ascii", offset2, offset2 + sig.length) === sig;
 }
 var HEIC_BRANDS = /* @__PURE__ */ new Set(["heic", "heix", "heim", "heis", "hevc", "hevx", "mif1", "msf1", "heif"]);
 function sniffIsoBmff(buf) {
@@ -18682,21 +18882,21 @@ function sniffImageMime(buf) {
   return sniffIsoBmff(buf);
 }
 function findBoxPayload(buf, start, end, type) {
-  let offset = start;
-  while (offset + 8 <= end) {
-    let size = buf.readUInt32BE(offset);
-    const boxType = buf.toString("ascii", offset + 4, offset + 8);
+  let offset2 = start;
+  while (offset2 + 8 <= end) {
+    let size = buf.readUInt32BE(offset2);
+    const boxType = buf.toString("ascii", offset2 + 4, offset2 + 8);
     let headerLen = 8;
     if (size === 1) {
-      if (offset + 16 > end) return null;
-      size = Number(buf.readBigUInt64BE(offset + 8));
+      if (offset2 + 16 > end) return null;
+      size = Number(buf.readBigUInt64BE(offset2 + 8));
       headerLen = 16;
     } else if (size === 0) {
-      size = end - offset;
+      size = end - offset2;
     }
-    if (size < headerLen || offset + size > end) return null;
-    if (boxType === type) return { start: offset + headerLen, end: offset + size };
-    offset += size;
+    if (size < headerLen || offset2 + size > end) return null;
+    if (boxType === type) return { start: offset2 + headerLen, end: offset2 + size };
+    offset2 += size;
   }
   return null;
 }
@@ -20972,6 +21172,7 @@ import sharp4 from "sharp";
 
 // src/engine/nodes/local/lib/band-check.ts
 var BOX_TOLERANCE = 0.01;
+var FRAME_CUT = 5e-3;
 function bandViolations(boxes, format, opts = {}) {
   const band = opts.band ?? staticSafeArea(format, opts.placements);
   const tolerance = opts.tolerance ?? BOX_TOLERANCE;
@@ -20984,7 +21185,16 @@ function bandViolations(boxes, format, opts = {}) {
     };
     const edges = Object.keys(reach).filter((edge) => reach[edge] > tolerance);
     if (edges.length === 0) return [];
-    return [{ text: box.text, kind: box.kind, edges, overshoot: Math.max(...edges.map((edge) => reach[edge])) }];
+    const toFrame = { top: box.y0, bottom: 1 - box.y1, left: box.x0, right: 1 - box.x1 };
+    return [
+      {
+        text: box.text,
+        kind: box.kind,
+        edges,
+        overshoot: Math.max(...edges.map((edge) => reach[edge])),
+        clearance: Math.max(0, Math.min(...edges.map((edge) => toFrame[edge])))
+      }
+    ];
   });
 }
 
@@ -21030,11 +21240,25 @@ function assign(targets, words, claimed, threshold) {
   }
   return matches;
 }
-function joinHyphenBreaks(texts) {
+function hyphenatedCompounds(texts) {
+  const out = /* @__PURE__ */ new Set();
+  for (const text of texts) {
+    for (const [compound] of text.normalize("NFKC").toLowerCase().matchAll(new RegExp("\\p{L}+(?:[-\u2010\u2011]\\p{L}+)+", "gu"))) {
+      const words = compound.split(/[-‐‑]/u);
+      for (let i = 1; i < words.length; i++) out.add(`${words[i - 1]}-${words[i]}`);
+    }
+  }
+  return out;
+}
+function joinHyphenBreaks(texts, compounds) {
   const out = [];
   let carry = "";
   for (const text of texts) {
-    const line = carry + text.trim();
+    const next = text.trim();
+    const before = carry.match(new RegExp("\\p{L}+$", "u"))?.[0] ?? "";
+    const after = next.match(new RegExp("^\\p{L}+", "u"))?.[0] ?? "";
+    const own = carry !== "" && compounds.has(`${before}-${after}`.normalize("NFKC").toLowerCase());
+    const line = carry + (own ? "-" : "") + next;
     const broken = line.match(new RegExp("^(.*\\p{L})[-\u2010\u2011]$", "u"));
     if (broken) carry = broken[1] ?? "";
     else {
@@ -21045,23 +21269,36 @@ function joinHyphenBreaks(texts) {
   if (carry) out.push(`${carry}-`);
   return out;
 }
+function lineParts(text) {
+  const parts = text.split(/\r?\n/).filter((part) => part.trim().length > 0);
+  return parts.length > 0 ? parts : [text];
+}
 function textMismatch(expected, boxes, opts = {}) {
-  const words = joinHyphenBreaks(boxes.filter((b) => b.kind === "text").map((b) => b.text)).flatMap(
+  const compounds = hyphenatedCompounds(expected.map((line) => line.text));
+  const texts = boxes.filter((b) => b.kind === "text").map((b) => b.text);
+  const words = joinHyphenBreaks(texts, compounds).flatMap(
     (text, box) => normalizeCopy(text).split(" ").filter((word) => word.length > 0).map((word) => ({ word, box }))
   );
   const claimed = /* @__PURE__ */ new Set();
+  const parts = expected.flatMap(
+    (line, lineIndex) => lineParts(line.text).map((text) => ({ lineIndex, text: normalizeCopy(text) }))
+  );
   const matches = assign(
-    expected.map((l) => normalizeCopy(l.text)),
+    parts.map((part) => part.text),
     words,
     claimed,
     MIN_MATCH
   );
   assign((opts.allowed ?? []).map(normalizeCopy), words, claimed, ALLOWED_MATCH);
   const lines = expected.flatMap((line, index) => {
-    const match = matches.get(index);
-    const score = match?.similarity ?? 0;
+    const lineMatches = parts.flatMap(
+      (part, partIndex) => part.lineIndex === index && part.text.length > 0 ? [matches.get(partIndex)] : []
+    );
+    if (lineMatches.length === 0) return [];
+    const score = Math.min(...lineMatches.map((match) => match?.similarity ?? 0));
     if (score >= 1 - MAX_LINE_DISTANCE) return [];
-    return [{ ...line, read: match?.span.text ?? null, similarity: score }];
+    const read = lineMatches.flatMap((match) => match ? [match.span.text] : []).join(" ");
+    return [{ ...line, read: read.length > 0 ? read : null, similarity: score }];
   });
   const extra = [];
   words.forEach(({ word, box }, index) => {
@@ -21873,14 +22110,24 @@ function outsideBand(v, placement) {
   if (placement === "reels") return `${what} sits where Reels covers it (${edges}).`;
   if (placement === "stories") return `${what} sits where Stories covers it (${edges}).`;
   if (placement === "master") return `${what} sits outside the space every size keeps clear (${edges}).`;
-  return `${what} sits too close to the edge; the feed can cut it off (${edges}).`;
+  if (v.clearance <= FRAME_CUT) return `${what} runs off the edge of the picture (${edges}).`;
+  return `${what} sits close to the edge (${edges}).`;
+}
+function bandSeverity(v, placement) {
+  return placement !== "feed" || v.clearance <= FRAME_CUT ? "blocking" : "warning";
 }
 var EDGE_ORDER = ["top", "bottom", "left", "right"];
 function oneLogo(violations) {
   const logo = violations.filter((v) => v.kind === "logo");
   if (logo.length <= 1) return [...violations];
   const edges = EDGE_ORDER.filter((e) => logo.some((v) => v.edges.includes(e)));
-  const merged = { text: "", kind: "logo", edges, overshoot: Math.max(...logo.map((v) => v.overshoot)) };
+  const merged = {
+    text: "",
+    kind: "logo",
+    edges,
+    overshoot: Math.max(...logo.map((v) => v.overshoot)),
+    clearance: Math.min(...logo.map((v) => v.clearance))
+  };
   const first = violations.indexOf(logo[0]);
   const rest = violations.filter((v) => v.kind !== "logo");
   return [...rest.slice(0, first), merged, ...rest.slice(first)];
@@ -21901,7 +22148,9 @@ function measuredFindings(input) {
       (l) => blocking(l.read === null ? `Text: "${l.text}" is missing.` : `Text: "${l.text}" reads "${l.read}".`)
     ),
     ...text.extra.length > 0 ? [blocking(`Text: extra words nobody asked for: ${text.extra.map((e) => `"${e}"`).join(", ")}.`)] : [],
-    ...oneLogo(band).map((v) => blocking(outsideBand(v, placement))),
+    ...oneLogo(band).map(
+      (v) => ({ severity: bandSeverity(v, placement), what: `${format}: ${outsideBand(v, placement)}` })
+    ),
     ...(input.offBrand ?? []).map(
       (ink) => ({
         severity: "warning",
@@ -21916,8 +22165,10 @@ function staticVerdict(findings) {
   return findings.length > 0 ? "ready_with_notes" : "ready";
 }
 function textInstructions(copy, measured) {
+  const wordless = "This ad has no words on purpose: the picture is the ad. Do not report missing copy, a missing headline or a missing call to action.";
   if (measured) {
     return [
+      ...copy.length === 0 ? [wordless] : [],
       "The words were already read back and measured by another check: do not transcribe them or report their spelling, extra words or position.",
       "1. TEXT: garbled or malformed letters, or letters that do not read as words (a brand name inside a drawn logo is fine)."
     ];
@@ -21929,10 +22180,7 @@ function textInstructions(copy, measured) {
       "1. TEXT: extra words that are not in the list, a string shown twice, or garbled letters (a brand name inside a drawn logo is fine)."
     ];
   }
-  return [
-    "This ad has no words on purpose: the picture is the ad. Do not report missing copy, a missing headline or a missing call to action.",
-    "1. TEXT: any letters or words that appear anyway (invented or garbled text is blocking)."
-  ];
+  return [wordless, "1. TEXT: any letters or words that appear anyway (invented or garbled text is blocking)."];
 }
 function buildStaticReviewPrompt(opts) {
   const brand = opts.brand ? ` for ${opts.brand}` : "";
@@ -22091,13 +22339,13 @@ function rankOf(boxes, blocking, want) {
   const logoFound = boxes.some((b) => b.kind === "logo" || brand !== null && normalizeCopy(b.text) === brand);
   const noLogo = want.logo && !logoFound ? 1 : 0;
   const noButton = off.some((l) => want.buttons.has(l.text)) ? 1 : 0;
-  const outOfBand = bandViolations(boxes, want.format, { band: want.band }).length;
+  const outOfBand = bandViolations(boxes, want.format, want.grade).length;
   return {
     rank: [blocking.length, off.length, noLogo, noButton, outOfBand],
     shortfalls: noLogo ? [NO_LOGO] : []
   };
 }
-var isButton3 = (line) => /cta|button/i.test(`${line.role ?? ""} ${line.look ?? ""}`);
+var isButton2 = (line) => /cta|button/i.test(`${line.role ?? ""} ${line.look ?? ""}`);
 async function prefilterVariants(variants, spec, formats, opts = {}) {
   const everything = {
     kept: seededOrder(
@@ -22114,7 +22362,7 @@ async function prefilterVariants(variants, spec, formats, opts = {}) {
   try {
     const parsed = readAdSpec(spec);
     lines = parsed.copy.map((l) => ({ text: l.text, lettering: l.lettering }));
-    buttons = new Set(parsed.copy.filter(isButton3).map((l) => l.text));
+    buttons = new Set(parsed.copy.filter(isButton2).map((l) => l.text));
     brand = parsed.brand?.name;
     logo = parsed.logo === true;
   } catch {
@@ -22126,6 +22374,7 @@ async function prefilterVariants(variants, spec, formats, opts = {}) {
     ...opts.placements ? { placements: opts.placements } : {}
   });
   const format = plan.master.format;
+  const grade = plan.masterShape === "relayout" ? plan.placements ? { placements: plan.placements } : {} : { band: plan.band };
   const checked = await Promise.all(
     variants.map(async (variant) => {
       const source = variant.path ?? variant.url;
@@ -22137,7 +22386,7 @@ async function prefilterVariants(variants, spec, formats, opts = {}) {
           format,
           lines,
           allowed: brand ? [brand] : [],
-          band: plan.band,
+          ...grade,
           toFrame: (boxes) => coverFitBoxes(boxes, { width, height }, plan.master.size),
           ...opts.read ? { read: opts.read } : {},
           ...opts.onSpend ? { onSpend: opts.onSpend } : {}
@@ -22145,7 +22394,7 @@ async function prefilterVariants(variants, spec, formats, opts = {}) {
         if (check.status === "not_checked") return { index: variant.index, blocking: null };
         const prefix = `${format}: `;
         const blocking = check.findings.filter((f) => f.severity === "blocking").map((f) => f.what.startsWith(prefix) ? f.what.slice(prefix.length) : f.what);
-        const want = { lines, buttons, ...brand ? { brand } : {}, logo, format, band: plan.band };
+        const want = { lines, buttons, ...brand ? { brand } : {}, logo, format, grade };
         return { index: variant.index, blocking, ...rankOf(check.boxes, blocking, want) };
       } catch {
         return { index: variant.index, blocking: null };
@@ -22250,61 +22499,191 @@ var staticPrefilterNode = defineNode({
   }
 });
 
-// src/engine/nodes/local/text.ts
+// src/engine/nodes/local/staticSafeFit.ts
 import { z as z58 } from "zod";
+
+// src/engine/nodes/local/lib/safe-fit.ts
+import sharp5 from "sharp";
+var FIT_HEADROOM = 0.01;
+var MIN_FIT_SCALE = 0.85;
+function planSafeFit(boxes, format, opts = {}) {
+  if (bandViolations(boxes, format, opts).length === 0) return null;
+  const area = staticSafeArea(format, opts.placements);
+  const union = {
+    x0: Math.min(...boxes.map((b) => b.x0)),
+    y0: Math.min(...boxes.map((b) => b.y0)),
+    x1: Math.max(...boxes.map((b) => b.x1)),
+    y1: Math.max(...boxes.map((b) => b.y1))
+  };
+  const band = {
+    x0: area.left + FIT_HEADROOM,
+    y0: area.top + FIT_HEADROOM,
+    x1: 1 - area.right - FIT_HEADROOM,
+    y1: 1 - area.bottom - FIT_HEADROOM
+  };
+  const scale = Math.min(1, (band.y1 - band.y0) / (union.y1 - union.y0), (band.x1 - band.x0) / (union.x1 - union.x0));
+  if (scale < MIN_FIT_SCALE) return null;
+  return {
+    scale,
+    x: offset(scale, union.x0, union.x1, band.x0, band.x1),
+    y: offset(scale, union.y0, union.y1, band.y0, band.y1)
+  };
+}
+function offset(scale, from, to, bandFrom, bandTo) {
+  const lo = bandFrom - scale * from;
+  const hi = bandTo - scale * to;
+  if (lo > hi) return (lo + hi) / 2;
+  return Math.min(hi, Math.max(lo, (1 - scale) / 2));
+}
+var MARGIN_BLUR = 0.012;
+var SEAM_FEATHER = 0.015;
+async function fitPicture(image, fit) {
+  const { width = 0, height = 0 } = await sharp5(image).metadata();
+  const sw = Math.max(1, Math.round(width * fit.scale));
+  const sh = Math.max(1, Math.round(height * fit.scale));
+  const px = Math.round(fit.x * width);
+  const py = Math.round(fit.y * height);
+  const left = Math.max(0, -px);
+  const top = Math.max(0, -py);
+  const w = Math.min(sw, width - px) - left;
+  const h = Math.min(sh, height - py) - top;
+  const shrunk = await sharp5(image).removeAlpha().resize(sw, sh, { fit: "fill", kernel: "lanczos3" }).extract({ left, top, width: w, height: h }).toBuffer();
+  const pad = { left: Math.max(0, px), top: Math.max(0, py) };
+  const extend = { ...pad, right: width - pad.left - w, bottom: height - pad.top - h };
+  const extended = await sharp5(shrunk).extend({ ...extend, extendWith: "mirror" }).raw().toBuffer({ resolveWithObject: true });
+  const frame = extended.data;
+  const channels = extended.info.channels;
+  const blurred = await sharp5(frame, { raw: { width, height, channels } }).blur(Math.max(0.3, MARGIN_BLUR * width)).raw().toBuffer();
+  const feather = Math.max(1, SEAM_FEATHER * width);
+  const keep = (at2, from, to, padFrom, padTo) => {
+    const inFrom = padFrom ? (at2 - from) / feather + 0.5 : 1;
+    const inTo = padTo ? (to - at2) / feather + 0.5 : 1;
+    return Math.min(1, Math.max(0, Math.min(inFrom, inTo)));
+  };
+  const out = Buffer.alloc(frame.length);
+  const x0 = pad.left;
+  const x1 = pad.left + w;
+  const y0 = pad.top;
+  const y1 = pad.top + h;
+  for (let y = 0; y < height; y++) {
+    const ky = keep(y + 0.5, y0, y1, extend.top > 0, extend.bottom > 0);
+    for (let x = 0; x < width; x++) {
+      const k = Math.min(ky, keep(x + 0.5, x0, x1, extend.left > 0, extend.right > 0));
+      const at2 = (y * width + x) * channels;
+      for (let c = 0; c < channels; c++) {
+        out[at2 + c] = Math.round(k * (frame[at2 + c] ?? 0) + (1 - k) * (blurred[at2 + c] ?? 0));
+      }
+    }
+  }
+  return sharp5(out, { raw: { width, height, channels } }).png().toBuffer();
+}
+
+// src/engine/nodes/local/staticSafeFit.ts
+var Usage2 = z58.object({ model: z58.string(), inputTokens: z58.number(), outputTokens: z58.number(), costUsd: z58.number() }).strict();
+var Fit = z58.object({ scale: z58.number(), x: z58.number(), y: z58.number() }).strict();
+var staticSafeFitNode = defineNode({
+  id: "static_safe_fit",
+  version: "1.0.0",
+  category: "image",
+  location: "local",
+  summary: "Bring a finished static ad's words and logo inside the band its placement leaves clear (the Stories header, the Reels footer) without rendering again: reads where every line and the logo sit, then shrinks the picture a little (to 85% at most) and shifts it, filling the uncovered margin by mirroring the picture beside it. Outputs the same pixel size; `fit` is the scale and position used, or null with `reason` when the picture is passed on unchanged.",
+  when_to_use: "Scaffolded by `baker canvas scaffold-static-ad` after every 9:16 size (`safe_<size>`, role `static_safe_fit`). Free, besides one box-reader call (about $0.005, carried on the run record's review spend). A layout too tall or wide for the band at 85% is passed on unchanged: the review still names what Reels or Stories covers, and the layout itself has to change (shorter copy, fewer lines).",
+  inputs: z58.object({ image: ImageRef }).strict(),
+  // `placements` are the ones the canvas's sizes were planned with (the ad set's), so the band
+  // the fit clears is the one the review holds the size to.
+  params: z58.object({ format: z58.string().min(1), placements: z58.array(z58.string().min(1)).optional() }).strict(),
+  outputs: z58.object({
+    image: ImageRef,
+    fit: Fit.nullable(),
+    // Why the picture passed unchanged: the reader could not read it, nothing was outside the
+    // band, or clearing it needed more than the smallest shrink that still looks native.
+    reason: z58.enum(["not_read", "inside_band", "too_far"]).optional(),
+    // What the reader's call cost, as the gateway reported it (the run record carries it home).
+    usage: z58.array(Usage2).optional()
+  }).strict(),
+  outputKinds: { image: "image" },
+  cost: () => ({ credits: 0, seconds_estimate: 5 }),
+  async execute({ inputs, params, ctx }) {
+    const source = inputs.image.path ?? inputs.image.url;
+    if (!source) return { image: inputs.image, fit: null, reason: "not_read" };
+    const bytes = await bytesOf(source);
+    const usage = [];
+    const reading = await readTextBoxes(bytes, { onSpend: (u) => usage.push(u) });
+    const spend = usage.length > 0 ? { usage } : {};
+    if (reading.status !== "read") return { image: inputs.image, fit: null, reason: "not_read", ...spend };
+    const placements = params.placements ? { placements: params.placements } : {};
+    const fit = planSafeFit(reading.boxes, params.format, placements);
+    if (!fit) {
+      const outside = bandViolations(reading.boxes, params.format, placements).length > 0;
+      return {
+        image: inputs.image,
+        fit: null,
+        reason: outside ? "too_far" : "inside_band",
+        ...spend
+      };
+    }
+    const fitted = await fitPicture(bytes, fit);
+    ctx.log(`fit ${params.format} at scale ${fit.scale.toFixed(3)}, offset ${fit.x.toFixed(3)}, ${fit.y.toFixed(3)}`);
+    const image = await ctx.assets.ingestBytes({ bytes: fitted, kind: "image", mime: "image/png" });
+    return { image, fit, ...spend };
+  }
+});
+
+// src/engine/nodes/local/text.ts
+import { z as z59 } from "zod";
 var textNode = defineNode({
   id: "text",
   version: "1.0.0",
   category: "data",
   location: "local",
   summary: "A literal text value. Use for prompts, descriptions, copy.",
-  inputs: z58.object({}).strict(),
-  params: z58.object({ value: z58.string() }).strict(),
-  outputs: z58.object({ text: z58.string() }).strict(),
+  inputs: z59.object({}).strict(),
+  params: z59.object({ value: z59.string() }).strict(),
+  outputs: z59.object({ text: z59.string() }).strict(),
   cost: () => ({ credits: 0, seconds_estimate: 0 }),
   execute: ({ params }) => Promise.resolve({ text: params.value })
 });
 
 // src/engine/nodes/local/videoConcat.ts
-import { z as z59 } from "zod";
+import { z as z60 } from "zod";
 var FFMPEG_BIN4 = "ffmpeg";
-var evenPixels = (axis) => z59.number().int().positive().refine((n) => n % 2 === 0, `${axis} must be even: libx264 yuv420p rejects odd sizes`);
-var Transition = z59.object({
-  type: z59.string().regex(/^[a-z]+$/, "an ffmpeg xfade transition name, e.g. fade, dissolve, zoomin, slideleft").describe("ffmpeg xfade transition name: fade, dissolve, zoomin, wipeleft, slideleft, \u2026"),
-  duration_s: z59.number().positive().describe("Overlap length in seconds (0.4 is the scaffold default).")
+var evenPixels = (axis) => z60.number().int().positive().refine((n) => n % 2 === 0, `${axis} must be even: libx264 yuv420p rejects odd sizes`);
+var Transition = z60.object({
+  type: z60.string().regex(/^[a-z]+$/, "an ffmpeg xfade transition name, e.g. fade, dissolve, zoomin, slideleft").describe("ffmpeg xfade transition name: fade, dissolve, zoomin, wipeleft, slideleft, \u2026"),
+  duration_s: z60.number().positive().describe("Overlap length in seconds (0.4 is the scaffold default).")
 }).strict();
-var ConcatClip = z59.object({
-  duration_s: z59.number().positive().describe(
+var ConcatClip = z60.object({
+  duration_s: z60.number().positive().describe(
     "Seconds this clip occupies on the timeline. A clip with a `transition` must carry that much EXTRA footage past it (the overlap eats it), so the joined length is the sum of the clip durations."
   ),
-  length: z59.enum(["source", "trim", "still"]).default("source").describe(
+  length: z60.enum(["source", "trim", "still"]).default("source").describe(
     "How the clip gets its length. `source`: play the input as rendered (it must already be duration_s long, plus the transition tail). `trim`: cut duration_s (+ tail) out of a longer input, starting at `offset_s`. `still`: the input is an IMAGE held on screen for duration_s (+ tail)."
   ),
-  offset_s: z59.number().min(0).optional().describe("`trim` only: where the window starts in the input, seconds."),
-  fit: z59.enum(["fill", "pad"]).default("fill").describe(
+  offset_s: z60.number().min(0).optional().describe("`trim` only: where the window starts in the input, seconds."),
+  fit: z60.enum(["fill", "pad"]).default("fill").describe(
     "`fill` scales to cover the frame and center-crops (footage). `pad` fits inside and letterboxes in black (a real screenshot or designed graphic, whose edges must never be cropped)."
   ),
   transition: Transition.optional().describe(
     "The transition OUT of this clip into the next one. Absent = a hard cut."
   ),
-  continues_frame: z59.boolean().optional().describe(
+  continues_frame: z60.boolean().optional().describe(
     "True when this clip's first frame repeats the previous clip's last frame (a long shot split in two). `seam_dedup` drops the duplicate without shortening the timeline."
   )
 }).strict().refine((c) => c.offset_s === void 0 || c.length === "trim", {
   message: "offset_s only applies to a `trim` clip",
   path: ["offset_s"]
 });
-var VideoConcatParams = z59.object({
+var VideoConcatParams = z60.object({
   width: evenPixels("width").describe("Output width in pixels (even). Every clip is normalized onto it."),
   height: evenPixels("height").describe("Output height in pixels (even)."),
-  fps: z59.number().int().min(1).max(120).default(30).describe("Output frame rate every clip is resampled to."),
-  seam_dedup: z59.enum(["head", "tail", "off"]).default("head").describe(
+  fps: z60.number().int().min(1).max(120).default(30).describe("Output frame rate every clip is resampled to."),
+  seam_dedup: z60.enum(["head", "tail", "off"]).default("head").describe(
     "Which copy of a repeated splice frame survives on a `continues_frame` clip: `head` drops the continuing clip's first frame, `tail` drops the previous clip's last frame, `off` keeps both."
   ),
-  clips: z59.array(ConcatClip).min(1).describe("The clips in timeline order; clip i is wired as `inputs.c<i>`.")
+  clips: z60.array(ConcatClip).min(1).describe("The clips in timeline order; clip i is wired as `inputs.c<i>`.")
 }).strict();
-var VideoConcatInputs = z59.record(z59.string(), z59.custom());
-var VideoConcatOutputs = z59.object({ video: z59.custom() }).strict();
+var VideoConcatInputs = z60.record(z60.string(), z60.custom());
+var VideoConcatOutputs = z60.object({ video: z60.custom() }).strict();
 function inputLengthS(clip2) {
   return clip2.duration_s + (clip2.transition?.duration_s ?? 0);
 }
@@ -22317,8 +22696,8 @@ function clipOps(clip2, params) {
   const normalize3 = `${scale},format=yuv420p,fps=${fps},setsar=1,settb=AVTB`;
   const len = inputLengthS(clip2).toFixed(3);
   if (clip2.length === "trim") {
-    const offset = clip2.offset_s ?? 0;
-    const start = offset > 0 ? `start=${offset.toFixed(3)}:` : "";
+    const offset2 = clip2.offset_s ?? 0;
+    const start = offset2 > 0 ? `start=${offset2.toFixed(3)}:` : "";
     return `${normalize3},trim=${start}duration=${len},setpts=PTS-STARTPTS`;
   }
   if (clip2.length === "still") return `${normalize3},trim=duration=${len}`;
@@ -22350,9 +22729,9 @@ function blendedJoins(params) {
     const out = k === clips.length - 2 ? "v" : `j${k + 1}`;
     const nextLen = inputLengthS(clips[k + 1]);
     if (transition) {
-      const offset = Math.max(0, accLen - transition.duration_s);
+      const offset2 = Math.max(0, accLen - transition.duration_s);
       joins.push(
-        `[${cur}][${next}]xfade=transition=${transition.type}:duration=${transition.duration_s.toFixed(3)}:offset=${offset.toFixed(3)}[${out}]`
+        `[${cur}][${next}]xfade=transition=${transition.type}:duration=${transition.duration_s.toFixed(3)}:offset=${offset2.toFixed(3)}[${out}]`
       );
       accLen = accLen - transition.duration_s + nextLen;
     } else {
@@ -22447,14 +22826,14 @@ var videoConcatNode = defineNode({
 });
 
 // src/engine/nodes/remote/audioVoiceConvert.ts
-import { z as z60 } from "zod";
-var AudioVoiceConvertParams = z60.object({
-  model: z60.literal("elevenlabs/eleven_multilingual_sts_v2"),
+import { z as z61 } from "zod";
+var AudioVoiceConvertParams = z61.object({
+  model: z61.literal("elevenlabs/eleven_multilingual_sts_v2"),
   /** Target voice id. Splice an upstream `voice_select` via `"{{voice_ref}}"`. */
-  voice: z60.string().min(1),
-  output_format: z60.string().optional(),
+  voice: z61.string().min(1),
+  output_format: z61.string().optional(),
   /** Strip the source clip's background noise before re-voicing. */
-  remove_background_noise: z60.boolean().optional()
+  remove_background_noise: z61.boolean().optional()
 }).strict();
 var audioVoiceConvertNode = delegated({
   id: "audio_voice_convert",
@@ -22462,12 +22841,12 @@ var audioVoiceConvertNode = delegated({
   category: "audio",
   summary: "Voice Changer / speech-to-speech via ElevenLabs (eleven_multilingual_sts_v2). Re-voices an existing audio clip in a TARGET voice while preserving timing/prosody.",
   when_to_use: 'Use to normalize a generator-chosen voice (e.g. a Seedance talking-head clip\'s native audio) into ONE consistent brand voice across every scene \u2014 the cadence is preserved so any lip-sync stays valid. Wire `inputs.voice_ref: $ref:<voice_select>.voice_id` and set `params.voice: "{{voice_ref}}"`.',
-  inputs: z60.object({
+  inputs: z61.object({
     audio: AudioRef,
     voice_ref: TextRef.optional()
   }).strict(),
   params: AudioVoiceConvertParams,
-  outputs: z60.object({ audio: AudioRef }).strict(),
+  outputs: z61.object({ audio: AudioRef }).strict(),
   outputKinds: { audio: "audio" },
   // Priced by the shared contract per minute of source audio. The quote cannot see
   // the clip's length, so it assumes one minute; the charge uses the real length.
@@ -22478,33 +22857,33 @@ var audioVoiceConvertNode = delegated({
 });
 
 // src/engine/nodes/remote/dialogue.ts
-import { z as z61 } from "zod";
-var DialogueInput = z61.object({
-  text: z61.string().min(1),
-  voice_id: z61.string().min(1)
+import { z as z62 } from "zod";
+var DialogueInput = z62.object({
+  text: z62.string().min(1),
+  voice_id: z62.string().min(1)
 });
 var DIALOGUE_MODELS = ["elevenlabs/eleven_v3"];
-var DialogueParams = z61.object({
-  model: z61.enum(DIALOGUE_MODELS),
+var DialogueParams = z62.object({
+  model: z62.enum(DIALOGUE_MODELS),
   /**
    * Ordered list of lines, each tagged with the voice that should speak it.
    * Up to 10 unique voice_ids; total text across all lines should stay under
    * ~2000 characters for best quality (ElevenLabs guidance).
    */
-  inputs: z61.array(DialogueInput).min(1).max(50),
-  language_code: z61.string().optional(),
+  inputs: z62.array(DialogueInput).min(1).max(50),
+  language_code: z62.string().optional(),
   /** ElevenLabs voice/model settings passthrough (e.g. `{ stability: 0.5 }`). */
-  settings: z61.record(z61.string(), z61.unknown()).optional(),
-  seed: z61.number().int().min(0).max(4294967295).optional(),
-  apply_text_normalization: z61.enum(["auto", "on", "off"]).optional(),
+  settings: z62.record(z62.string(), z62.unknown()).optional(),
+  seed: z62.number().int().min(0).max(4294967295).optional(),
+  apply_text_normalization: z62.enum(["auto", "on", "off"]).optional(),
   /**
    * When true, hits `/v1/text-to-dialogue/with-timestamps` and emits a
    * separate `timestamps` output — character-level alignment plus
    * per-voice segment markers usable for captions, lipsync, or
    * beat-matched cuts in ad creatives.
    */
-  with_timestamps: z61.boolean().optional(),
-  output_format: z61.enum(ELEVENLABS_OUTPUT_FORMATS).optional()
+  with_timestamps: z62.boolean().optional(),
+  output_format: z62.enum(ELEVENLABS_OUTPUT_FORMATS).optional()
 }).strict().refine((p) => p.inputs.reduce((sum, line) => sum + line.text.length, 0) <= ELEVENLABS_MAX_TEXT_CHARS, {
   message: `total dialogue text exceeds ${ELEVENLABS_MAX_TEXT_CHARS} characters`,
   path: ["inputs"]
@@ -22515,19 +22894,19 @@ var dialogueNode = delegated({
   category: "audio",
   summary: "Multi-voice dialogue / VO with ElevenLabs Eleven v3. Each line is tagged with a `voice_id`, so you can render two-character scripts (e.g. ad VO + customer testimonial reaction) in a single call. Setting `with_timestamps: true` adds character-level alignment for caption rendering and lipsync-friendly cuts.",
   when_to_use: "Use for any ad creative or website video VO that needs more than narration \u2014 interviews, two-actor scripts, character ads, testimonial reads. For single-voice flat reads the existing `tts` node is cheaper and simpler; reach for `dialogue` when you need multiple speakers in one stitched track or word-level timing for downstream lipsync / captions.",
-  inputs: z61.object({}).loose(),
+  inputs: z62.object({}).loose(),
   params: DialogueParams,
-  outputs: z61.object({ audio: AudioRef, timestamps: JsonRef.optional() }).strict(),
+  outputs: z62.object({ audio: AudioRef, timestamps: JsonRef.optional() }).strict(),
   outputKinds: { audio: "audio", timestamps: "json" },
   // Priced by the shared contract, the same per-character rate the backend charges.
   cost: ({ params }) => ({ credits: estimateNodeCredits({ nodeType: "dialogue", params }) ?? 1, seconds_estimate: 8 })
 });
 
 // src/engine/nodes/remote/image.ts
-import { z as z63 } from "zod";
+import { z as z64 } from "zod";
 
 // src/engine/nodes/remote/registry-params.ts
-import { z as z62 } from "zod";
+import { z as z63 } from "zod";
 function registryParamShape(kind, overrides = {}) {
   const specs = Object.values(MODEL_REGISTRY[kind]);
   const byParam = /* @__PURE__ */ new Map();
@@ -22548,7 +22927,7 @@ function unionOf(schemas) {
   const kinds = [...new Set(schemas.map((schema) => schema.kind))];
   if (kinds.length > 1) {
     const [first, second, ...rest] = kinds.map((k) => unionOf(schemas.filter((s) => s.kind === k)));
-    return z62.union([first, second, ...rest]);
+    return z63.union([first, second, ...rest]);
   }
   switch (kinds[0]) {
     case "string":
@@ -22556,41 +22935,37 @@ function unionOf(schemas) {
     case "number":
       return numberUnion(schemas);
     case "boolean":
-      return z62.boolean();
+      return z63.boolean();
     default:
-      return z62.unknown();
+      return z63.unknown();
   }
 }
 function stringUnion(schemas) {
-  if (schemas.some((schema) => !schema.enum)) return z62.string();
+  if (schemas.some((schema) => !schema.enum)) return z63.string();
   const values = [...new Set(schemas.flatMap((schema) => schema.enum ?? []))];
-  return z62.enum(values);
+  return z63.enum(values);
 }
 function numberUnion(schemas) {
-  if (schemas.some((schema) => !schema.enum)) return z62.number();
+  if (schemas.some((schema) => !schema.enum)) return z63.number();
   const values = [...new Set(schemas.flatMap((schema) => schema.enum ?? []))].sort((a, b) => a - b);
-  return z62.literal(values);
+  return z63.literal(values);
 }
 
 // src/engine/nodes/remote/image.ts
-var imageModelEnum = z63.enum(IMAGE_GENERATE_MODELS);
-var ImageGenerateParams = z63.object({
+var imageModelEnum = z64.enum(IMAGE_GENERATE_MODELS);
+var ImageGenerateParams = z64.object({
   model: imageModelEnum,
   ...registryParamShape("image_generate", {
-    prompt: z63.string().min(1),
+    prompt: z64.string().min(1),
     // Recraft v4 vector controls, sent as the provider's own `controls` block. The
     // registry types them as JSON; this is their shape.
-    rgb_colors: z63.array(z63.array(z63.number().int().min(0).max(255))),
-    background_rgb_color: z63.array(z63.number().int().min(0).max(255))
+    rgb_colors: z64.array(z64.array(z64.number().int().min(0).max(255))),
+    background_rgb_color: z64.array(z64.number().int().min(0).max(255))
   })
 }).strict();
-var PRO_IMAGE_MODELS = /* @__PURE__ */ new Set([
-  "google/gemini-3-pro-image",
-  "google/gemini-3-pro-image-preview"
-]);
 var PRO_QUALITY = "max";
 function creditsPerImage(params) {
-  return PRO_IMAGE_MODELS.has(String(params.model)) || params.quality === PRO_QUALITY ? 20 : 5;
+  return params.quality === PRO_QUALITY ? IMAGE_TIER_CREDITS.pro : imagePictureCredits(String(params.model));
 }
 function imagesPerCall(params) {
   return "n" in params && typeof params.n === "number" ? params.n : 1;
@@ -22603,9 +22978,9 @@ var imageGenerateNode = delegated({
   when_to_use: "Use for hero shots, product photography, illustrations, and vector logos. `recraft/recraft-v4.1-pro-vector` for crisp vector / logo work; `openai/gpt-image-2` for photorealistic and in-image text (NOTE: it has no `image_size`, and no 4:5 / 5:4 \u2014 route portrait ad formats through Gemini or `image_aspect_adapt`); Gemini variants for fast iteration, extreme ratios, and editing via the `reference` input. `reference` accepts ONE image or an ARRAY of images \u2014 wire several to combine references in a single generation (e.g. a subject sheet + a font specimen + the original ad). Every reference is forwarded to the model in array order. `n` (only on models that declare it, e.g. `openai/gpt-image-2.5-sunburst`) returns several candidates of the same brief from one call, billed per image like separate calls; wire the whole `images` array into `image_select` to keep the best.",
   // `reference` is one image or an ordered array of images. The backend forwards
   // each as a separate `image_url` to the provider (OpenRouter accepts many).
-  inputs: z63.object({ reference: z63.union([ImageRef, z63.array(ImageRef).min(1)]).optional() }).loose(),
+  inputs: z64.object({ reference: z64.union([ImageRef, z64.array(ImageRef).min(1)]).optional() }).loose(),
   params: ImageGenerateParams,
-  outputs: z63.object({ images: z63.array(ImageRef).min(1) }).strict(),
+  outputs: z64.object({ images: z64.array(ImageRef).min(1) }).strict(),
   outputKinds: { images: "image" },
   // Per image: `n` asks one call for several, and the provider bills each (measured: n=3
   // cost exactly 3x n=1, prompt tokens included). Usage-billed, so this is only the pre-run
@@ -22617,31 +22992,27 @@ var imageGenerateNode = delegated({
 });
 
 // src/engine/nodes/remote/imageAspectAdapt.ts
-import { z as z64 } from "zod";
+import { z as z65 } from "zod";
 var ASPECT_ADAPT_MODELS = [
   "google/gemini-3-pro-image",
   "google/gemini-3.1-flash-image",
   "google/gemini-3-pro-image-preview",
   "google/gemini-3.1-flash-image-preview"
 ];
-var PRO_ADAPT_MODELS = /* @__PURE__ */ new Set([
-  "google/gemini-3-pro-image",
-  "google/gemini-3-pro-image-preview"
-]);
-var ImageAspectAdaptParams = z64.object({
-  model: z64.enum(ASPECT_ADAPT_MODELS),
-  formats: z64.array(z64.enum(ASPECT_ADAPT_FORMATS)).min(1).max(6).refine((formats) => new Set(formats).size === formats.length, { message: "formats must be unique" }).optional(),
-  platform: z64.enum(AD_FORMAT_PLATFORMS).optional(),
-  guidance: z64.string().min(1).optional(),
+var ImageAspectAdaptParams = z65.object({
+  model: z65.enum(ASPECT_ADAPT_MODELS),
+  formats: z65.array(z65.enum(ASPECT_ADAPT_FORMATS)).min(1).max(6).refine((formats) => new Set(formats).size === formats.length, { message: "formats must be unique" }).optional(),
+  platform: z65.enum(AD_FORMAT_PLATFORMS).optional(),
+  guidance: z65.string().min(1).optional(),
   // The exact lines the ad carries: the reframe keeps each, spelled as given, once.
-  copy: z64.array(z64.string().min(1)).min(1).max(20).optional(),
+  copy: z65.array(z65.string().min(1)).min(1).max(20).optional(),
   // Per target format, the fractions of each edge the platform's interface covers: words,
   // logo and button stay inside. The static scaffold sets both from prompt.json and `staticSafeArea`.
-  safe_areas: z64.record(
-    z64.string(),
-    z64.object({ top: z64.number(), bottom: z64.number(), left: z64.number(), right: z64.number() }).strict()
+  safe_areas: z65.record(
+    z65.string(),
+    z65.object({ top: z65.number(), bottom: z65.number(), left: z65.number(), right: z65.number() }).strict()
   ).optional(),
-  image_size: z64.enum(OPENROUTER_IMAGE_SIZES).optional()
+  image_size: z65.enum(OPENROUTER_IMAGE_SIZES).optional()
 }).strict().refine((p) => p.formats === void 0 !== (p.platform === void 0), {
   message: "provide exactly one of `formats` (explicit ratios) or `platform` (a placement preset)",
   path: ["formats"]
@@ -22652,33 +23023,33 @@ var imageAspectAdaptNode = delegated({
   category: "image",
   summary: "Adapt ONE creative into multiple aspect ratios (Meta: 9:16 stories, 1:1 feed, 4:5, 16:9\u2026) in a single step. Give it either an explicit `formats` list OR a `platform` preset (meta_feed, meta_feed_stories, meta_all, linkedin, google_demandgen, tiktok, youtube) that expands to that platform's canonical set. AI recomposes the layout per format \u2014 identical subject, text, logos, colors, and style; the scene is extended/restructured, never stretched or cropped. Formats that already match the source ratio pass through unchanged at zero cost. Outputs are ordered exactly as the resolved format list.",
   when_to_use: "Use after a hero creative exists (image_generate, ingest, image_search) to fan it out to every placement format \u2014 wire the creative into `source` and set EITHER `formats` (exact ratios) OR `platform` (e.g. `meta_feed_stories`). Cost is estimated per format; formats matching the source ratio are free pass-throughs. Off-grid platform targets (e.g. Google 1.91:1) are not rendered here \u2014 crop them from the nearest ratio with `baker images crop`. Pick `google/gemini-3.1-flash-image` (Nano Banana 2) while iterating, `google/gemini-3-pro-image` (Nano Banana Pro) for final-quality adaptation.",
-  inputs: z64.object({ source: ImageRef }).loose(),
+  inputs: z65.object({ source: ImageRef }).loose(),
   params: ImageAspectAdaptParams,
-  outputs: z64.object({ images: z64.array(ImageRef).min(1) }).strict(),
+  outputs: z65.object({ images: z65.array(ImageRef).min(1) }).strict(),
   outputKinds: { images: "image" },
   cost: ({ params }) => {
     const p = params;
     const count = Math.max(1, resolveAdaptFormats(p ?? {}).length);
     return {
-      credits: count * (PRO_ADAPT_MODELS.has(String(p?.model)) ? 20 : 5),
+      credits: count * imagePictureCredits(String(p?.model)),
       seconds_estimate: 30 + 30 * count
     };
   }
 });
 
 // src/engine/nodes/remote/imageBackgroundRemove.ts
-import { z as z65 } from "zod";
-var ImageBackgroundRemoveParams = z65.object({
+import { z as z66 } from "zod";
+var ImageBackgroundRemoveParams = z66.object({
   // `fal/birefnet-v2` is the legacy id stored canvases carry. It stays the default for one
   // release: every backend accepts it, while `replicate/birefnet` needs the backend that ships with
   // this CLI, and the two deploy independently.
-  model: z65.enum(modelIdsAccepted("replicate/birefnet")).optional().default("fal/birefnet-v2"),
-  operating_resolution: z65.enum(["1024x1024", "2048x2048", "2304x2304"]).optional(),
+  model: z66.enum(modelIdsAccepted("replicate/birefnet")).optional().default("fal/birefnet-v2"),
+  operating_resolution: z66.enum(["1024x1024", "2048x2048", "2304x2304"]).optional(),
   // DEPRECATED, accepted so stored canvases still parse, and ignored: the model this
   // node runs (`men1scus/birefnet`) takes only an image and a resolution, has no
   // variant and returns no mask. `mask_only: true` still returns the cutout.
-  model_variant: z65.enum(["General Use (Light)", "General Use (Heavy)", "Matting", "Portrait", "DIS", "HRSOD", "COD"]).optional().meta({ deprecated: true, description: "Ignored: the model has no variants." }),
-  mask_only: z65.boolean().optional().meta({ deprecated: true, description: "Ignored: the model returns the cutout only, never a mask." })
+  model_variant: z66.enum(["General Use (Light)", "General Use (Heavy)", "Matting", "Portrait", "DIS", "HRSOD", "COD"]).optional().meta({ deprecated: true, description: "Ignored: the model has no variants." }),
+  mask_only: z66.boolean().optional().meta({ deprecated: true, description: "Ignored: the model returns the cutout only, never a mask." })
 }).strict();
 var imageBackgroundRemoveNode = delegated({
   id: "image_background_remove",
@@ -22686,11 +23057,11 @@ var imageBackgroundRemoveNode = delegated({
   category: "image",
   summary: "Remove the background from an image and return a transparent PNG. Powered by BiRefNet (`men1scus/birefnet` on Replicate).",
   when_to_use: "Use to extract subjects from photos for use as overlays in hyperframe compositions, product shots, or compositing pipelines. It returns the alpha-cut image only; there is no mask output and no model variant to pick.",
-  inputs: z65.object({
+  inputs: z66.object({
     image: ImageRef
   }).strict(),
   params: ImageBackgroundRemoveParams,
-  outputs: z65.object({ image: ImageRef }).strict(),
+  outputs: z66.object({ image: ImageRef }).strict(),
   outputKinds: { image: "image" },
   cost: ({ params }) => ({
     credits: estimateNodeCredits({ nodeType: "image_background_remove", params }) ?? 1,
@@ -22699,7 +23070,7 @@ var imageBackgroundRemoveNode = delegated({
 });
 
 // src/engine/nodes/remote/imageDescribe.ts
-import { z as z66 } from "zod";
+import { z as z67 } from "zod";
 var IMAGE_DESCRIBE_MODELS = ["~google/gemini-pro-latest", "~google/gemini-flash-latest"];
 var imageDescribeNode = delegated({
   id: "image_describe",
@@ -22707,27 +23078,27 @@ var imageDescribeNode = delegated({
   category: "vision",
   summary: "Reverse-engineer an image into an exhaustive, replication-grade JSON description: who the advertiser is and what they sell (source_context), composition, non-person subjects with expression/treatment, deeply detailed people, brand-identified logos (named by brand, not appearance), camera optics, lighting, color palette WITH per-color brand-ownership (brand vs borrowed-functional) and purpose, materials, visible text, ad signals (proof badges/CTA/price), the persuasion engine (ad_intent), style, post-processing.",
   when_to_use: 'Use to turn a reference image into a structured blueprint you can inject into downstream prompts via `{{slot}}` \u2014 e.g. restyle a competitor ad onto your own product, lock a look across a series, or feed exact palette/lighting into image_generate. Purpose-built for market adaptation: logos are identified by brand ("Trustpilot", never "green star"), people and animals carry expression/emotion/intent detail, and each color is tagged brand vs borrowed-functional so a recolor can keep the reds/yellows that do a job. The extraction prompt is baked in; use `focus` to emphasise aspects and `context` to pass known provenance (advertiser, category, market) so source_context and color ownership are grounded. Pick `~google/gemini-pro-latest` for the densest extraction (recommended for ad / market-adaptation passes), `~google/gemini-flash-latest` for cheap/fast passes. The output is rich \u2014 raise `max_tokens` (e.g. 8000+) for dense ads so the JSON isn\'t truncated.',
-  inputs: z66.object({ image: ImageRef }).loose(),
-  params: z66.object({
-    model: z66.enum(IMAGE_DESCRIBE_MODELS),
-    focus: z66.string().optional(),
-    context: z66.string().optional(),
-    temperature: z66.number().min(0).max(2).optional(),
-    max_tokens: z66.number().int().positive().optional()
+  inputs: z67.object({ image: ImageRef }).loose(),
+  params: z67.object({
+    model: z67.enum(IMAGE_DESCRIBE_MODELS),
+    focus: z67.string().optional(),
+    context: z67.string().optional(),
+    temperature: z67.number().min(0).max(2).optional(),
+    max_tokens: z67.number().int().positive().optional()
   }).strict(),
-  outputs: z66.object({ description: JsonRef }).strict(),
+  outputs: z67.object({ description: JsonRef }).strict(),
   outputKinds: { description: "json" },
   cost: () => ({ credits: 2, seconds_estimate: 10 })
 });
 
 // src/engine/nodes/remote/imageLayerize.ts
-import { z as z67 } from "zod";
-var ImageLayerizeParams = z67.object({
+import { z as z68 } from "zod";
+var ImageLayerizeParams = z68.object({
   /**
    * What to separate. Read as extraction instructions, not as a generation
    * prompt — "keep the bottle and its shadow as one layer", not "make it blue".
    */
-  instructions: z67.string().max(600).optional()
+  instructions: z68.string().max(600).optional()
 }).strict();
 var imageLayerizeNode = delegated({
   id: "image_layerize",
@@ -22735,12 +23106,12 @@ var imageLayerizeNode = delegated({
   category: "image",
   summary: "Split an image into editable layers: a transparent PNG per element, plus any copy baked into the picture recovered as real text with its typography. Powered by Seedream 5.0 Pro Layerize, with Ideogram lifting the text off first.",
   when_to_use: "Use when you need ONE element of a picture on its own (a product with no background, a logo lockup), or when a shot is right but its copy is wrong and regenerating would change the picture too. The manifest gives you each layer's box and, for text, its exact wording, font, size and colour \u2014 enough to re-set a headline in the original's type. For a plain subject cutout with no text involved, `image_background_remove` is cheaper and one call.",
-  inputs: z67.object({
+  inputs: z68.object({
     image: ImageRef
   }).strict(),
   params: ImageLayerizeParams,
-  outputs: z67.object({
-    layers: z67.array(ImageRef),
+  outputs: z68.object({
+    layers: z68.array(ImageRef),
     base: ImageRef,
     manifest: JsonRef
   }).strict(),
@@ -22751,28 +23122,24 @@ var imageLayerizeNode = delegated({
 });
 
 // src/engine/nodes/remote/imageReferenceSheet.ts
-import { z as z68 } from "zod";
+import { z as z69 } from "zod";
 var REFERENCE_SHEET_MODELS = [
   "google/gemini-3-pro-image",
   "google/gemini-3.1-flash-image",
   "google/gemini-3-pro-image-preview",
   "google/gemini-3.1-flash-image-preview"
 ];
-var PRO_SHEET_MODELS = /* @__PURE__ */ new Set([
-  "google/gemini-3-pro-image",
-  "google/gemini-3-pro-image-preview"
-]);
-var ImageReferenceSheetParams = z68.object({
-  model: z68.enum(REFERENCE_SHEET_MODELS),
-  subject_description: z68.string().min(1),
+var ImageReferenceSheetParams = z69.object({
+  model: z69.enum(REFERENCE_SHEET_MODELS),
+  subject_description: z69.string().min(1),
   // `location` = a set/room shown from several camera ANGLES (not a rotated subject),
   // so a multi-scene shoot keeps one consistent set.
-  subject_type: z68.enum(["character", "person", "product", "location"]),
-  views: z68.array(z68.string().min(1)).min(2).max(8).optional(),
-  style: z68.string().optional(),
-  prompt_override: z68.string().min(1).optional(),
-  aspect_ratio: z68.enum(["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9", "1:4", "4:1", "1:8", "8:1"]).optional(),
-  image_size: z68.enum(OPENROUTER_IMAGE_SIZES).optional()
+  subject_type: z69.enum(["character", "person", "product", "location"]),
+  views: z69.array(z69.string().min(1)).min(2).max(8).optional(),
+  style: z69.string().optional(),
+  prompt_override: z69.string().min(1).optional(),
+  aspect_ratio: z69.enum(["1:1", "16:9", "9:16", "4:3", "3:4", "3:2", "2:3", "4:5", "5:4", "21:9", "1:4", "4:1", "1:8", "8:1"]).optional(),
+  image_size: z69.enum(OPENROUTER_IMAGE_SIZES).optional()
 }).strict();
 var imageReferenceSheetNode = delegated({
   id: "image_reference_sheet",
@@ -22780,21 +23147,21 @@ var imageReferenceSheetNode = delegated({
   category: "image",
   summary: "Fuse 1\u20136 images of a single subject (person, character, product, or location/set) into ONE multi-view reference sheet \u2014 a labeled grid in consistent style and lighting: a turnaround (FRONT / SIDE / BACK\u2026) for a person/character/product, or several camera angles of the same room (WIDE / REVERSE / DETAIL\u2026) for a location. Curated models: Gemini 3 Pro Image (best fusion + labels), Gemini 3.1 Flash Image (cheap iteration).",
   when_to_use: "Use before image_generate / video_generate when a subject must stay consistent across many creatives \u2014 wire the `sheet` output into their `reference` input instead of re-describing the subject per prompt. `subject_description` should be the exact wording you reuse downstream. Pick `google/gemini-3-pro-image` for final 6-view sheets at 2K+, `google/gemini-3.1-flash-image` while iterating.",
-  inputs: z68.object({ references: z68.array(ImageRef).min(1).max(6) }).loose(),
+  inputs: z69.object({ references: z69.array(ImageRef).min(1).max(6) }).loose(),
   params: ImageReferenceSheetParams,
-  outputs: z68.object({ sheet: ImageRef }).strict(),
+  outputs: z69.object({ sheet: ImageRef }).strict(),
   outputKinds: { sheet: "image" },
   cost: ({ params }) => ({
-    credits: PRO_SHEET_MODELS.has(String(params?.model)) ? 20 : 5,
+    credits: imagePictureCredits(String(params?.model)),
     seconds_estimate: 30
   })
 });
 
 // src/engine/nodes/remote/imageSearch.ts
-import { z as z69 } from "zod";
-var ImageSearchParams = z69.object({
-  prompt: z69.string().min(1),
-  count: z69.number().int().min(1).max(20).default(5)
+import { z as z70 } from "zod";
+var ImageSearchParams = z70.object({
+  prompt: z70.string().min(1),
+  count: z70.number().int().min(1).max(20).default(5)
 }).strict();
 var imageSearchNode = delegated({
   id: "image_search",
@@ -22802,15 +23169,15 @@ var imageSearchNode = delegated({
   category: "image",
   summary: "Agentic image search across Google Images, free stock photography (Pexels and Pixabay), and Pinterest. An LLM agent picks the search tools and queries, selects the best matches, and the results are downloaded into canvas assets.",
   when_to_use: "Use to gather real-world reference or inspiration images for a prompt (e.g. several photos of an australian shepherd) so a later step or the user can pick the best one. Not for creating new imagery \u2014 use image_generate for that.",
-  inputs: z69.object({}).loose(),
+  inputs: z70.object({}).loose(),
   params: ImageSearchParams,
-  outputs: z69.object({ images: z69.array(ImageRef).min(1) }).strict(),
+  outputs: z70.object({ images: z70.array(ImageRef).min(1) }).strict(),
   outputKinds: { images: "image" },
   cost: ({ params }) => ({ credits: Math.ceil(2 + params.count / 2), seconds_estimate: 30 })
 });
 
 // src/engine/nodes/remote/imageSelect.ts
-import { z as z70 } from "zod";
+import { z as z71 } from "zod";
 var IMAGE_SELECT_MODELS = ["~google/gemini-flash-latest", "~google/gemini-pro-latest"];
 var imageSelectNode = delegated({
   id: "image_select",
@@ -22818,16 +23185,16 @@ var imageSelectNode = delegated({
   category: "vision",
   summary: "Pick the best `count` images out of the candidates with a vision LLM, judged against a prompt. Outputs a passthrough subset of the input refs (no new pixels) plus the model's comparative reasoning. A single candidate passes through unjudged, free and without reasoning.",
   when_to_use: "Use after an image_generate run with `n` > 1 (wire its whole `images` array), several image_generate variants, or any pool of images, to keep only the strongest before expensive downstream steps \u2014 video generation, reference sheets, final delivery. `count` fixes the output size, so `images#0`\u2026`images#count-1` are always safe to wire. Pick `~google/gemini-flash-latest` for cheap/fast picks and `~google/gemini-pro-latest` for harder aesthetic judgement.",
-  inputs: z70.object({ images: z70.array(ImageRef).min(1) }).loose(),
-  params: z70.object({
-    model: z70.enum(IMAGE_SELECT_MODELS),
-    prompt: z70.string().min(1),
-    count: z70.number().int().min(1).default(1),
-    temperature: z70.number().min(0).max(2).optional(),
-    max_tokens: z70.number().int().positive().optional()
+  inputs: z71.object({ images: z71.array(ImageRef).min(1) }).loose(),
+  params: z71.object({
+    model: z71.enum(IMAGE_SELECT_MODELS),
+    prompt: z71.string().min(1),
+    count: z71.number().int().min(1).default(1),
+    temperature: z71.number().min(0).max(2).optional(),
+    max_tokens: z71.number().int().positive().optional()
   }).strict(),
   // No `reasoning` when a lone candidate passed through: there was no judgement to explain.
-  outputs: z70.object({ images: z70.array(ImageRef).min(1), reasoning: TextRef.optional() }).strict(),
+  outputs: z71.object({ images: z71.array(ImageRef).min(1), reasoning: TextRef.optional() }).strict(),
   outputKinds: { images: "image", reasoning: "text" },
   cost: () => ({ credits: 1, seconds_estimate: 5 }),
   // Arity is only knowable at validate time when `images` is a literal array
@@ -22852,26 +23219,26 @@ var imageSelectNode = delegated({
 });
 
 // src/engine/nodes/remote/music.ts
-import { z as z71 } from "zod";
+import { z as z72 } from "zod";
 var MUSIC_MODELS = ["elevenlabs/music-v1", "elevenlabs/video-background-music-v1"];
-var MusicParams = z71.object({
-  model: z71.enum(MUSIC_MODELS),
+var MusicParams = z72.object({
+  model: z72.enum(MUSIC_MODELS),
   /** Free-form prompt. Used by `elevenlabs/music-v1` (compose-detailed). */
-  prompt: z71.string().optional(),
+  prompt: z72.string().optional(),
   /**
    * Structured composition plan (intro / hook / verse / outro sections with
    * per-section styles + durations). Mutually exclusive with `prompt`.
    */
-  composition_plan: z71.record(z71.string(), z71.unknown()).optional(),
+  composition_plan: z72.record(z72.string(), z72.unknown()).optional(),
   /** Target length when using `prompt`. 3000–454545ms (capped by the $10 per-node cost limit). */
-  music_length_ms: z71.number().int().min(3e3).max(ELEVENLABS_MAX_MUSIC_LENGTH_MS).optional(),
-  seed: z71.number().int().optional(),
+  music_length_ms: z72.number().int().min(3e3).max(ELEVENLABS_MAX_MUSIC_LENGTH_MS).optional(),
+  seed: z72.number().int().optional(),
   /** Prompt mode only — forces an instrumental (no vocals) track. */
-  force_instrumental: z71.boolean().optional(),
+  force_instrumental: z72.boolean().optional(),
   /** composition_plan only — honor exact section durations. */
-  respect_sections_durations: z71.boolean().optional(),
+  respect_sections_durations: z72.boolean().optional(),
   /** Emit word-level timestamps alongside the audio. */
-  with_timestamps: z71.boolean().optional(),
+  with_timestamps: z72.boolean().optional(),
   /**
    * video-to-music only — short description of the desired score
    * ("upbeat synth, fast cuts, 80s") used to bias the model.
@@ -22883,14 +23250,14 @@ var MusicParams = z71.object({
    * confident") came back as a film score and the client's verdict was "la
    * musica que has elegido es muy dramática".
    */
-  description: z71.string().max(1e3).optional().describe(
+  description: z72.string().max(1e3).optional().describe(
     "The score you want, in sound (instruments, tempo, texture) \u2014 not in feelings. Under speech, name ONE steady character and forbid movement: no build, no drop, no climax, no key change, nothing that 'follows the arc'. This model WATCHES the cut, so it will score the footage's emotion unless told not to \u2014 asking it to track a speaker's emotional arc is how a testimonial bed comes back dramatic. A bed is furniture; the voice carries the story."
   ),
   /** video-to-music only — up to 10 style tags. */
-  tags: z71.array(z71.string()).max(10).optional().describe(
+  tags: z72.array(z72.string()).max(10).optional().describe(
     "Style tags. Under speech, prefer tags that hold it still (instrumental, understated, steady, no drums) over tags that move it (cinematic, epic, building, resolving, trailer)."
   ),
-  output_format: z71.enum(ELEVENLABS_OUTPUT_FORMATS).optional()
+  output_format: z72.enum(ELEVENLABS_OUTPUT_FORMATS).optional()
 }).strict();
 var musicNode = delegated({
   id: "music",
@@ -22901,9 +23268,9 @@ var musicNode = delegated({
   category: "audio",
   summary: "Generate music for ad creatives and website video content. `elevenlabs/music-v1` composes from a text prompt or structured composition plan; `elevenlabs/video-background-music-v1` scores an existing video clip provided via `inputs.video`.",
   when_to_use: "Use to produce background music or a full score for video ads, hero-section reels, or any motion content. Prefer the video-to-music model when you already have a cut and want music timed to it; use compose-detailed when you have only a brief or want section-level control (intro / hook / outro). Pair the resulting audio with `video_generate` or `video_lipsync` at compose time.",
-  inputs: z71.object({ video: VideoRef.optional() }).loose(),
+  inputs: z72.object({ video: VideoRef.optional() }).loose(),
   params: MusicParams,
-  outputs: z71.object({ audio: AudioRef, timestamps: JsonRef.optional() }).strict(),
+  outputs: z72.object({ audio: AudioRef, timestamps: JsonRef.optional() }).strict(),
   outputKinds: { audio: "audio", timestamps: "json" },
   // Priced by the shared contract: per second of audio, 30s when no length is pinned.
   cost: ({ params }) => {
@@ -22935,25 +23302,25 @@ var musicNode = delegated({
 });
 
 // src/engine/nodes/remote/soundEffect.ts
-import { z as z72 } from "zod";
+import { z as z73 } from "zod";
 var SOUND_EFFECT_MODELS = ["elevenlabs/eleven_text_to_sound_v2"];
-var SoundEffectParams = z72.object({
-  model: z72.enum(SOUND_EFFECT_MODELS),
+var SoundEffectParams = z73.object({
+  model: z73.enum(SOUND_EFFECT_MODELS),
   /** Prompt describing the SFX ("metal door slam", "soft UI tap", "ocean waves"). */
-  text: z72.string().min(1),
+  text: z73.string().min(1),
   /**
    * Target length in seconds. 0.5–30. Leave unset to let the model pick the
    * natural length for the described effect.
    */
-  duration_seconds: z72.number().min(0.5).max(30).optional(),
+  duration_seconds: z73.number().min(0.5).max(30).optional(),
   /**
    * 0–1. Higher = stick closer to the prompt at the cost of variety; lower
    * = let the model interpret more freely. Defaults to 0.3 on the provider.
    */
-  prompt_influence: z72.number().min(0).max(1).optional(),
+  prompt_influence: z73.number().min(0).max(1).optional(),
   /** Only valid on `eleven_text_to_sound_v2` — produce a seamless loop. */
-  loop: z72.boolean().optional(),
-  output_format: z72.enum(ELEVENLABS_OUTPUT_FORMATS).optional()
+  loop: z73.boolean().optional(),
+  output_format: z73.enum(ELEVENLABS_OUTPUT_FORMATS).optional()
 }).strict();
 var soundEffectNode = delegated({
   id: "sound_effect",
@@ -22961,9 +23328,9 @@ var soundEffectNode = delegated({
   category: "audio",
   summary: "Generate short sound effects from a text prompt via ElevenLabs Text-to-Sound. Use for whooshes, impacts, UI clicks, ambient beds, or signature stingers in ad creatives and product videos.",
   when_to_use: "Reach for this when you need a punch-in SFX layered against `video_generate` or `hyperframe_render` output \u2014 e.g. a logo whoosh on a hero shot, a click on a CTA cut, a swelling ambient bed under VO. Set `loop: true` for atmospheric beds that need to tile under longer footage; leave `duration_seconds` unset and the model picks a natural length.",
-  inputs: z72.object({}).loose(),
+  inputs: z73.object({}).loose(),
   params: SoundEffectParams,
-  outputs: z72.object({ audio: AudioRef }).strict(),
+  outputs: z73.object({ audio: AudioRef }).strict(),
   outputKinds: { audio: "audio" },
   // Priced by the shared contract: per second of audio, 5s when the model picks the length.
   cost: ({ params }) => {
@@ -22973,7 +23340,7 @@ var soundEffectNode = delegated({
 });
 
 // src/engine/nodes/remote/textGenerate.ts
-import { z as z73 } from "zod";
+import { z as z74 } from "zod";
 var TEXT_GENERATE_MODELS = ["~google/gemini-flash-latest", "~google/gemini-pro-latest"];
 var textGenerateNode = delegated({
   id: "text_generate",
@@ -22981,58 +23348,58 @@ var textGenerateNode = delegated({
   category: "language",
   summary: "Single-turn LLM text generation via OpenRouter. Returns a text response.",
   when_to_use: 'Use for any short text generation step in a canvas \u2014 ad copy, hooks, headlines, JSON outputs for downstream nodes. Pick `~google/gemini-flash-latest` for cheap/fast work and `~google/gemini-pro-latest` for harder reasoning. When the output must be JSON for a downstream `{{slot}}` (e.g. the ad-blueprint transform), set `response_format: "json_object"` so the model returns clean JSON with no markdown fences or prose. Set `web_search: true` to let the model search the live web first (OpenRouter `:online`) \u2014 useful when the transform must adapt copy to the target brand\'s real facts (current pricing, the trust signals it actually has) rather than guess.',
-  inputs: z73.object({}).loose(),
-  params: z73.object({
-    model: z73.enum(TEXT_GENERATE_MODELS),
-    prompt: z73.string().min(1),
-    system: z73.string().optional(),
-    response_format: z73.enum(["text", "json_object"]).optional(),
-    web_search: z73.boolean().optional(),
-    temperature: z73.number().min(0).max(2).optional(),
-    max_tokens: z73.number().int().positive().optional()
+  inputs: z74.object({}).loose(),
+  params: z74.object({
+    model: z74.enum(TEXT_GENERATE_MODELS),
+    prompt: z74.string().min(1),
+    system: z74.string().optional(),
+    response_format: z74.enum(["text", "json_object"]).optional(),
+    web_search: z74.boolean().optional(),
+    temperature: z74.number().min(0).max(2).optional(),
+    max_tokens: z74.number().int().positive().optional()
   }).strict(),
-  outputs: z73.object({ text: TextRef }).strict(),
+  outputs: z74.object({ text: TextRef }).strict(),
   outputKinds: { text: "text" },
   cost: () => ({ credits: 1, seconds_estimate: 3 })
 });
 
 // src/engine/nodes/remote/tts.ts
-import { z as z74 } from "zod";
+import { z as z75 } from "zod";
 var TTS_MODELS = ["elevenlabs/eleven_v3"];
-var TtsVoiceSettings = z74.object({
-  stability: z74.number().min(0).max(1).optional(),
-  similarity_boost: z74.number().min(0).max(1).optional(),
-  style: z74.number().min(0).max(1).optional(),
-  use_speaker_boost: z74.boolean().optional(),
-  speed: z74.number().min(0.25).max(4).optional()
+var TtsVoiceSettings = z75.object({
+  stability: z75.number().min(0).max(1).optional(),
+  similarity_boost: z75.number().min(0).max(1).optional(),
+  style: z75.number().min(0).max(1).optional(),
+  use_speaker_boost: z75.boolean().optional(),
+  speed: z75.number().min(0.25).max(4).optional()
 }).strict();
-var TtsPronunciationLocator = z74.object({
-  pronunciation_dictionary_id: z74.string().min(1),
-  version_id: z74.string().nullable().optional()
+var TtsPronunciationLocator = z75.object({
+  pronunciation_dictionary_id: z75.string().min(1),
+  version_id: z75.string().nullable().optional()
 }).strict();
-var TtsParams = z74.object({
-  model: z74.enum(TTS_MODELS),
-  text: z74.string().min(1).max(ELEVENLABS_MAX_TEXT_CHARS),
-  voice: z74.string().min(1),
+var TtsParams = z75.object({
+  model: z75.enum(TTS_MODELS),
+  text: z75.string().min(1).max(ELEVENLABS_MAX_TEXT_CHARS),
+  voice: z75.string().min(1),
   /** Provider output_format (mp3 family only — assets are stored as audio/mpeg). */
-  output_format: z74.enum(ELEVENLABS_OUTPUT_FORMATS).optional(),
-  seed: z74.number().int().min(0).max(4294967295).optional(),
+  output_format: z75.enum(ELEVENLABS_OUTPUT_FORMATS).optional(),
+  seed: z75.number().int().min(0).max(4294967295).optional(),
   // Top-level shortcuts; structured form is `voice_settings`.
-  stability: z74.number().min(0).max(1).optional(),
-  similarity_boost: z74.number().min(0).max(1).optional(),
+  stability: z75.number().min(0).max(1).optional(),
+  similarity_boost: z75.number().min(0).max(1).optional(),
   voice_settings: TtsVoiceSettings.optional(),
   /** ISO 639-1 language code. eleven_v3 supports language hints. */
-  language_code: z74.string().optional(),
-  pronunciation_dictionary_locators: z74.array(TtsPronunciationLocator).max(3).optional(),
-  apply_text_normalization: z74.enum(["auto", "on", "off"]).optional(),
+  language_code: z75.string().optional(),
+  pronunciation_dictionary_locators: z75.array(TtsPronunciationLocator).max(3).optional(),
+  apply_text_normalization: z75.enum(["auto", "on", "off"]).optional(),
   /** Currently Japanese-only. Adds latency. */
-  apply_language_text_normalization: z74.boolean().optional(),
+  apply_language_text_normalization: z75.boolean().optional(),
   /**
    * When true, hits `/v1/text-to-speech/{voice_id}/with-timestamps` and
    * adds a `timestamps` output (character-level alignment) for caption
    * rendering, lipsync, and beat-matched cuts.
    */
-  with_timestamps: z74.boolean().optional()
+  with_timestamps: z75.boolean().optional()
 }).strict();
 var ttsNode = delegated({
   id: "tts",
@@ -23040,9 +23407,9 @@ var ttsNode = delegated({
   category: "audio",
   summary: "Single-voice text-to-speech via ElevenLabs Eleven v3. Optional character-level timestamps for caption rendering and beat-matched cuts.",
   when_to_use: "Use for single-speaker VO \u2014 ad reads, hero-section narration, product walkthroughs. Reach for `dialogue` when you need multiple voices in one stitched track. Set `with_timestamps: true` when downstream needs character-level alignment (captions, lipsync).",
-  inputs: z74.object({}).loose(),
+  inputs: z75.object({}).loose(),
   params: TtsParams,
-  outputs: z74.object({ audio: AudioRef, timestamps: JsonRef.optional() }).strict(),
+  outputs: z75.object({ audio: AudioRef, timestamps: JsonRef.optional() }).strict(),
   outputKinds: { audio: "audio", timestamps: "json" },
   // Priced by the shared contract, the same per-character rate the backend charges.
   cost: ({ params }) => ({
@@ -23052,11 +23419,11 @@ var ttsNode = delegated({
 });
 
 // src/engine/nodes/remote/video.ts
-import { z as z75 } from "zod";
-var videoModelEnum = z75.enum(VIDEO_GENERATE_MODELS);
-var VideoGenerateParams = z75.object({
+import { z as z76 } from "zod";
+var videoModelEnum = z76.enum(VIDEO_GENERATE_MODELS);
+var VideoGenerateParams = z76.object({
   model: videoModelEnum,
-  ...registryParamShape("video_generate", { prompt: z75.string().min(1) })
+  ...registryParamShape("video_generate", { prompt: z76.string().min(1) })
 }).strict();
 var videoGenerateNode = delegated({
   id: "video_generate",
@@ -23064,7 +23431,7 @@ var videoGenerateNode = delegated({
   category: "video",
   summary: "Generate video for ad creatives. Curated roster: `google/gemini-omni-1.1-flash` (DEFAULT \u2014 native audio + reference images in one call, 360p-4k, 3-10s), `bytedance/seedance-2.0` (identity/product workhorse, NO photoreal human faces), `google/veo-3.1` (photoreal cine ceiling + the human-face model), `google/veo-3.1-fast` (cheap Veo iteration), `kwaivgi/kling-v3.0-pro` (motion-transfer/dynamic). Async with polling.",
   when_to_use: "`google/gemini-omni-1.1-flash` is the DEFAULT: it renders picture and synchronized audio in one call, and is the only model here that takes reference images alongside a prompt. SET `duration` (3-10s) to the length the beat actually needs \u2014 it bills PER SECOND, so leaving it out renders the 10s default and charges for ten seconds of a beat that may need three. SET `resolution` too: `360p` bills a THIRD of `720p` ($0.034 vs $0.101 per second) and is the right tier while you are still choosing between takes \u2014 render the drafts at 360p, then re-render the keeper at `720p` (default), `1080p` ($0.152/s) or `4k` ($0.304/s). It accepts only `16:9` or `9:16`, and takes NO `seed`, `negative_prompt` or `generate_audio` param \u2014 sending one fails validation, and it always renders audio. Keep the default for ordinary beats; move off it only when a beat needs a length outside 3-10s or a 1:1 frame. Use `bytedance/seedance-2.0` for identity/product output WITHOUT a photoreal human face on camera. Any clip whose frame shows a photoreal human face \u2014 a UGC creator, presenter, or testimonial speaker, REAL OR AI-GENERATED \u2014 must use `google/veo-3.1`: ByteDance's filter rejects photoreal human faces on Seedance (content_policy_blocked/E005), and a synthetic AI face does NOT clear it. Use `google/veo-3.1-fast` while iterating to keep cost low; `kwaivgi/kling-v3.0-pro` for motion-transfer/hyper-dynamic beats. `baker canvas scaffold-video` auto-routes a photoreal cast to Veo. A Seedance clip that is refused for a face at runtime is NOT moved to another model: one guided only by reference images is re-rendered on the same model through a second route that accepts faces (about twice the price), and one that starts from a frame comes back as content_policy_blocked \u2014 re-run that clip on `google/veo-3.1`. Each model gates its own durations, resolutions and aspect ratios in the registry: `baker studio models --kind video --model <id>` shows them.",
-  inputs: z75.object({
+  inputs: z76.object({
     first_frame: ImageRef.optional(),
     last_frame: ImageRef.optional(),
     reference: ImageRef.optional(),
@@ -23074,10 +23441,10 @@ var videoGenerateNode = delegated({
      * exclusive with `first_frame` — OpenRouter treats a request carrying both
      * as image-to-video and ignores these, so wire one or the other.
      */
-    references: z75.array(ImageRef).optional()
+    references: z76.array(ImageRef).optional()
   }).loose(),
   params: VideoGenerateParams,
-  outputs: z75.object({ video: VideoRef }).strict(),
+  outputs: z76.object({ video: VideoRef }).strict(),
   outputKinds: { video: "video" },
   // Priced from the shared contract, so `validate`'s quote and the charge the
   // backend applies come from ONE table. A flat number here under-quoted a
@@ -23092,15 +23459,15 @@ var videoGenerateNode = delegated({
 });
 
 // src/engine/nodes/remote/videoBackgroundRemove.ts
-import { z as z76 } from "zod";
-var VideoBackgroundRemoveParams = z76.object({
+import { z as z77 } from "zod";
+var VideoBackgroundRemoveParams = z77.object({
   // `fal/veed-video-background-removal` is the legacy id stored canvases carry. It stays the default for one
   // release: every backend accepts it, while `replicate/birefnet-video` needs the backend that ships with
   // this CLI, and the two deploy independently.
-  model: z76.enum(modelIdsAccepted("replicate/birefnet-video")).optional().default("fal/veed-video-background-removal"),
+  model: z77.enum(modelIdsAccepted("replicate/birefnet-video")).optional().default("fal/veed-video-background-removal"),
   // Refines the matte's soft edges against background bleed (the model's `refine_fg`).
-  edge_refinement: z76.boolean().optional().default(true),
-  output_codec: z76.enum(["vp9", "h264"]).optional().default("vp9")
+  edge_refinement: z77.boolean().optional().default(true),
+  output_codec: z77.enum(["vp9", "h264"]).optional().default("vp9")
 }).strict();
 var videoBackgroundRemoveNode = delegated({
   id: "video_background_remove",
@@ -23108,11 +23475,11 @@ var videoBackgroundRemoveNode = delegated({
   category: "video",
   summary: "Remove the background from a video and return a transparent VP9-with-alpha WebM (or H264 RGB+alpha pair). Drops directly into a hyperframe composition as `<video src='...'>` for chroma-keyed picture-in-picture overlays. Powered by BiRefNet Video (`sprited/birefnet-video` on Replicate).",
   when_to_use: "Use when you need a talking-head or subject to float over a custom background in a hyperframe composition. Pair with hyperframe_render(composition: screencast-with-talker) for screencast-with-narrator videos. Output is `video/webm` with alpha \u2014 feed straight into `<video src>` in a composition.",
-  inputs: z76.object({
+  inputs: z77.object({
     video: VideoRef
   }).strict(),
   params: VideoBackgroundRemoveParams,
-  outputs: z76.object({ video: VideoRef }).strict(),
+  outputs: z77.object({ video: VideoRef }).strict(),
   outputKinds: { video: "video" },
   // Priced by the shared contract per 30 frames; the quote assumes the same 30s of
   // footage the charge falls back to when the clip carries no duration.
@@ -23123,7 +23490,7 @@ var videoBackgroundRemoveNode = delegated({
 });
 
 // src/engine/nodes/remote/videoDeconstruct.ts
-import { z as z77 } from "zod";
+import { z as z78 } from "zod";
 var VIDEO_DECONSTRUCT_MODELS = ["~google/gemini-flash-latest", "~google/gemini-pro-latest"];
 var videoDeconstructNode = delegated({
   id: "video_deconstruct",
@@ -23131,34 +23498,34 @@ var videoDeconstructNode = delegated({
   category: "video",
   summary: 'Deconstruct a video into a replication-grade blueprint: scene boundaries, the real start/end frame of every scene (extracted from the video as images), and an exhaustive JSON analysis \u2014 per-scene action detail, camera motion, generation-ready frame/motion prompts, overlay text with full typographic style, floating elements, deeply detailed cast (perceived demographics, ethnicity/skin-tone, styling, market-recasting notes), brand-identified logos (named by brand and what they signal, not by appearance, with on-screen timestamps), dialogue with voice descriptions, music spec, SFX list, plus a word-level transcript. `mode:"index"` is the cheap structure-first pass: scene boundaries + global blueprint only (one LLM call, no frames).',
   when_to_use: 'Use to reverse-engineer a reference video (e.g. a competitor ad) so a new canvas can reproduce or remix it scene by scene. Agent loop: (1) optionally run `mode:"index"` to see the structure cheaply (scene count, boundaries, transcript) before planning; (2) run the full deconstruct; (3) read `analysis` and author the reproduction canvas. The blueprint maps 1:1 onto generation nodes: `analysis.scenes[i]` aligns positionally with `start_frames#i`/`end_frames#i`; per scene, `start_frame_prompt`/`end_frame_prompt` feed image_generate (overlay text is excluded from them by contract \u2014 recomposite it from `overlays`), `motion_prompt` + the two frames feed video_generate (first_frame/last_frame), `dialogue[].voice_description` casts tts/dialogue voices, `global.music.music_prompt` feeds music, `sfx[].sound_effect_prompt` feeds sound_effect, and `overlays`/`floating_elements` drive an ffmpeg/hyperframe overlay pass. Long videos (over ~8 min single-shot): run `mode:"index"` first, then several full nodes IN PARALLEL each with a `start_s`/`end_s` window (\u2264480s, snap edges to index scene boundaries), and merge by concatenating `analysis.scenes`; over-length errors include suggested windows. Inject fields into downstream prompts via `{{slot}}`. Pick `~google/gemini-pro-latest` for the densest extraction, `~google/gemini-flash-latest` for cheap/fast passes.',
-  inputs: z77.object({ video: VideoRef }).loose(),
-  params: z77.object({
-    model: z77.enum(VIDEO_DECONSTRUCT_MODELS),
-    mode: z77.enum(["full", "index"]).optional(),
-    language: z77.string().min(2).max(8).optional(),
-    max_scenes: z77.number().int().min(1).max(60).optional(),
-    focus: z77.string().optional(),
-    start_s: z77.number().min(0).optional(),
-    end_s: z77.number().positive().optional(),
+  inputs: z78.object({ video: VideoRef }).loose(),
+  params: z78.object({
+    model: z78.enum(VIDEO_DECONSTRUCT_MODELS),
+    mode: z78.enum(["full", "index"]).optional(),
+    language: z78.string().min(2).max(8).optional(),
+    max_scenes: z78.number().int().min(1).max(60).optional(),
+    focus: z78.string().optional(),
+    start_s: z78.number().min(0).optional(),
+    end_s: z78.number().positive().optional(),
     // Real visual shot-cut timestamps (absolute seconds), detected locally with
     // ffmpeg before the deconstruct. The backend SNAPS its LLM scene boundaries
     // onto these and SPLITS any scene that spans one, so a scene's frames never
     // straddle a hard cut. `scaffold-video` populates this; omit for LLM-only cuts.
-    shot_cuts: z77.array(z77.number().min(0)).max(200).optional(),
+    shot_cuts: z78.array(z78.number().min(0)).max(200).optional(),
     // The video model's per-clip ceiling (seconds). A shot longer than this is
     // split into seamless continuation sub-scenes (shared splice frame), so long
     // shots reproduce in full instead of being truncated. `scaffold-video` sets
     // the Seedance ceiling (15); omit to disable length splitting.
-    max_clip_s: z77.number().positive().max(60).optional(),
+    max_clip_s: z78.number().positive().max(60).optional(),
     // Transcript provider for the blueprint's dialogue/transcript. Default
     // Groq Whisper; "deepgram" routes to Nova-3 so words carry punctuation.
-    transcriber: z77.enum(["groq", "deepgram"]).optional()
+    transcriber: z78.enum(["groq", "deepgram"]).optional()
   }).strict(),
-  outputs: z77.object({
+  outputs: z78.object({
     analysis: JsonRef,
     // Absent in mode:"index" (structure only, no Mux frame extraction).
-    start_frames: z77.array(ImageRef).min(1).optional(),
-    end_frames: z77.array(ImageRef).min(1).optional(),
+    start_frames: z78.array(ImageRef).min(1).optional(),
+    end_frames: z78.array(ImageRef).min(1).optional(),
     transcript: JsonRef
   }).strict(),
   outputKinds: { analysis: "json", start_frames: "image", end_frames: "image", transcript: "json" },
@@ -23166,21 +23533,21 @@ var videoDeconstructNode = delegated({
 });
 
 // src/engine/nodes/remote/videoLipsync.ts
-import { z as z78 } from "zod";
-var VideoLipsyncParams = z78.object({
-  model: z78.enum(modelIdsAccepted("replicate/sync-lipsync-2"))
+import { z as z79 } from "zod";
+var VideoLipsyncParams = z79.object({
+  model: z79.enum(modelIdsAccepted("replicate/sync-lipsync-2"))
 }).strict();
 var videoLipsyncNode = delegated({
   id: "video_lipsync",
   version: "1.0.0",
   category: "video",
   summary: "Lip-sync a video to an audio track (`replicate/sync-lipsync-2`: Sync Labs lipsync-2 on Replicate; the legacy id `fal/veed-lipsync` still runs). Billed at $0.40 per minute of the longer input. Runs as a background job.",
-  inputs: z78.object({
+  inputs: z79.object({
     video: VideoRef,
     audio: AudioRef
   }).strict(),
   params: VideoLipsyncParams,
-  outputs: z78.object({ video: VideoRef }).strict(),
+  outputs: z79.object({ video: VideoRef }).strict(),
   outputKinds: { video: "video" },
   // Priced by the shared contract per minute of output; the quote cannot see the
   // clips' lengths, so it assumes the same one minute the charge falls back to.
@@ -23194,7 +23561,7 @@ var videoLipsyncNode = delegated({
 import { mkdtemp as mkdtemp8, readFile as readFile17, rm as rm8 } from "fs/promises";
 import { tmpdir as tmpdir8 } from "os";
 import path21 from "path";
-import { z as z79 } from "zod";
+import { z as z80 } from "zod";
 
 // src/engine/nodes/local/lib/ffmpeg.ts
 import { execFile as execFile8 } from "child_process";
@@ -23432,30 +23799,30 @@ function timeScriptWords(script, transcript, language) {
 }
 
 // src/engine/nodes/remote/videoTranscribe.ts
-var VideoTranscribeParams = z79.object({
-  language: z79.string().min(2).max(8).optional(),
+var VideoTranscribeParams = z80.object({
+  language: z80.string().min(2).max(8).optional(),
   // Provider choice is explicit (no env-based silent branching). Default Groq
   // Whisper; "deepgram" routes to Deepgram Nova-3, which additionally emits a
   // `rich` JSON output with punctuated words + paragraph/sentence grouping.
-  transcriber: z79.enum(["groq", "deepgram"]).optional(),
-  keyterms: z79.array(z79.string().min(2).max(60)).max(30).optional().describe(
+  transcriber: z80.enum(["groq", "deepgram"]).optional(),
+  keyterms: z80.array(z80.string().min(2).max(60)).max(30).optional().describe(
     "Names the recogniser must not mangle \u2014 a product, a person, a phrase the script coins. The COMPANY'S OWN NAME is always applied server-side, so you never list it: this is for the rest. Every term is biased into the request AND its spelling enforced on the way out, because a caption prints a mishearing at full size over the ad (a real cut shipped with the brand name spelled wrong). Never patch a misspelling inside a caption composition \u2014 that fix dies with that one creative."
   ),
-  script: z79.string().min(1).optional().describe(
+  script: z80.string().min(1).optional().describe(
     "The words the track was asked to say, when there is a script: the transcript's words are then the script's, spelled as written, at the times the recogniser heard them. A misheard word stops being a typo on screen, and a word the recogniser added (a filler) is never printed. Aligned locally, never sent."
   )
 }).strict();
-var VideoTranscribeInputs = z79.object({
+var VideoTranscribeInputs = z80.object({
   // A video (audio auto-extracted locally) OR a bare audio track. The key stays
   // `video` for back-compat; the backend already accepts audio-kind refs on it —
   // the local extraction path has been shipping one for every video input.
-  video: z79.union([VideoRef, AudioRef])
+  video: z80.union([VideoRef, AudioRef])
 }).strict();
-var VideoTranscribeOutputs = z79.object({
-  transcript: z79.custom(),
+var VideoTranscribeOutputs = z80.object({
+  transcript: z80.custom(),
   // Only emitted by the Deepgram path: full punctuated words + paragraph /
   // sentence grouping with speaker indices. Absent for the default Groq path.
-  rich: z79.custom().optional()
+  rich: z80.custom().optional()
 }).strict();
 var AUDIO_EXTRACT_TIMEOUT_MS = 6e4;
 var videoTranscribeNode = defineNode({
@@ -23568,7 +23935,7 @@ async function tryExtractAudio(inputs, ctx) {
 }
 
 // src/engine/nodes/remote/voiceSelect.ts
-import { z as z80 } from "zod";
+import { z as z81 } from "zod";
 var voiceSelectNode = delegated({
   id: "voice_select",
   // 1.1.0: a pinned voice used to come back as an inline `{ kind, text }` with no sha256
@@ -23586,27 +23953,27 @@ var voiceSelectNode = delegated({
   category: "audio",
   summary: 'Cast an ElevenLabs voice from a natural-language description (e.g. "warm, authoritative female narrator, American accent"). Lists the account\'s voices and ranks them against the brief, emitting the best `voice_id` as a bare-string text asset plus a ranked `candidates` JSON.',
   when_to_use: 'Use to turn a voice description (e.g. from a `video_deconstruct` blueprint\'s `voice_description`) into a usable ElevenLabs voice id, then feed it into a `tts` node by wiring `inputs.voice_ref: $ref:<this>.voice_id` and setting `params.voice: "{{voice_ref}}"` \u2014 the engine splices the id in at run time. Review `candidates` (json) to pick a different voice. Optional `gender`/`age`/`accent`/`language` hints sharpen the ranking. `language` is strict: when no voice on the account speaks it the node fails before anything is voiced (add a voice in that language, or pass its `voice_id`). A `gender` nobody in that language has is dropped and `baker canvas run` prints a `[warn]` naming the voice cast instead.',
-  inputs: z80.object({}).loose(),
-  params: z80.object({
-    description: z80.string().min(1),
-    gender: z80.string().optional(),
-    age: z80.string().optional(),
-    accent: z80.string().optional(),
-    language: z80.string().optional(),
+  inputs: z81.object({}).loose(),
+  params: z81.object({
+    description: z81.string().min(1),
+    gender: z81.string().optional(),
+    age: z81.string().optional(),
+    accent: z81.string().optional(),
+    language: z81.string().optional(),
     /**
      * A voice already chosen — an Avatar's pinned one. Given, nothing is cast: the
      * ranking is skipped and this id is emitted as-is.
      */
-    voice_id: z80.string().min(1).max(120).optional(),
-    limit: z80.number().int().min(1).max(20).optional()
+    voice_id: z81.string().min(1).max(120).optional(),
+    limit: z81.number().int().min(1).max(20).optional()
   }).strict(),
-  outputs: z80.object({ voice_id: TextRef, candidates: JsonRef }).strict(),
+  outputs: z81.object({ voice_id: TextRef, candidates: JsonRef }).strict(),
   outputKinds: { voice_id: "text", candidates: "json" },
   cost: () => ({ credits: 0, seconds_estimate: 5 })
 });
 
 // src/engine/schema/catalog.ts
-import { z as z81 } from "zod";
+import { z as z82 } from "zod";
 function generateCatalog(registry, opts = {}) {
   const entries2 = registry.all().map((def) => {
     const cost = catalogCost(def);
@@ -23617,9 +23984,9 @@ function generateCatalog(registry, opts = {}) {
       summary: def.summary,
       when_to_use: def.when_to_use,
       location: def.location,
-      inputs: z81.toJSONSchema(def.inputs, { unrepresentable: "any" }),
-      params: z81.toJSONSchema(def.params, { unrepresentable: "any" }),
-      outputs: z81.toJSONSchema(def.outputs, { unrepresentable: "any" }),
+      inputs: z82.toJSONSchema(def.inputs, { unrepresentable: "any" }),
+      params: z82.toJSONSchema(def.params, { unrepresentable: "any" }),
+      outputs: z82.toJSONSchema(def.outputs, { unrepresentable: "any" }),
       cost_estimate_credits: cost?.credits,
       runtime_estimate_seconds: cost?.seconds_estimate
     };
@@ -23768,7 +24135,8 @@ var LOCAL_NODES = [
   videoConcatNode,
   avMuxNode,
   collectNode,
-  staticPrefilterNode
+  staticPrefilterNode,
+  staticSafeFitNode
 ];
 var REMOTE_NODES = [
   textGenerateNode,
@@ -23926,6 +24294,7 @@ export {
   testimonialSourcesRemoveRequestSchema,
   testimonialSourcesScheduleRequestSchema,
   videosIngestRequestSchema,
+  HttpClient,
   BackendClient,
   requireCredentialsFromEnv,
   RunAbortedError,
@@ -23977,6 +24346,7 @@ export {
   supportedAspectRatios,
   nearestSupportedAspectRatio,
   estimateVideoCredits,
+  candidPersonPortraitPrompt,
   VideoBlueprintSchema,
   BlueprintOverlaySchema,
   BlueprintFloatingElementSchema,
@@ -24014,7 +24384,7 @@ export {
   AD_SPEC_SCHEMA,
   AdSpecSchema,
   readAdSpec,
-  withShortInSceneLettering,
+  withRenderedLettering,
   conceptClassOf,
   plainText,
   adSpecFromBlueprint,
@@ -24035,6 +24405,7 @@ export {
   STATIC_MASTER_ROLE,
   STATIC_SIZE_ROLE,
   STATIC_ADAPT_ROLE,
+  STATIC_SAFE_FIT_ROLE,
   LOGO_COMPOSITE_ROLE,
   STATIC_FIX_ROLE,
   LOGO_COMPOSITE_DEFAULT,
@@ -24043,6 +24414,7 @@ export {
   formatSlug,
   staticMasterFormat,
   staticRenderNodes,
+  safeFitNode,
   RENDER_GRAPH_IDS,
   regenerateTargets,
   elementMentionKeywords,
@@ -24087,4 +24459,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-PFN3A4VQ.js.map
+//# sourceMappingURL=chunk-GLPQQP5C.js.map