@koda-sl/baker-cli 0.434.0-dev.42b55fa66 → 0.434.0-dev.4dbd56be6

package/dist/{chunk-MMTPMFFH.js → chunk-7NKAKF3K.js}

@@ -1,7 +1,7 @@
 import {
   debugLogHttp,
   readBodyForLog
-} from "./chunk-GCTR4MDE.js";
+} from "./chunk-EURJVJQY.js";
 import {
   API_KEY_FORMAT_MESSAGE,
   DIRECT_ROUTE,
@@ -22,7 +22,7 @@ import {
   refuseNonPublicUrl,
   requireConnection,
   shouldEscalate
-} from "./chunk-FQOKJYKN.js";
+} from "./chunk-F7LXMR73.js";
 
 // ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/766ad107c42df28eeadaf0ac2f9089c8a9e200f6ba0b2b1a817b8d536cbdcc49/node_modules/safe-stable-stringify/index.js
 var require_safe_stable_stringify = __commonJS({
@@ -3594,23 +3594,6 @@ function resolveConcurrency(...candidates) {
   }
   return DEFAULT_CONCURRENCY;
 }
-async function mapWithConcurrency(items, limit, fn) {
-  const results = new Array(items.length);
-  let next = 0;
-  const worker = async () => {
-    while (next < items.length) {
-      const index = next++;
-      try {
-        results[index] = { status: "fulfilled", value: await fn(items[index], index) };
-      } catch (reason) {
-        results[index] = { status: "rejected", reason };
-      }
-    }
-  };
-  const workers = Array.from({ length: Math.min(limit, items.length) }, worker);
-  await Promise.all(workers);
-  return results;
-}
 
 // src/engine/lib/json-walk.ts
 function isContainerObject(value) {
@@ -4415,7 +4398,18 @@ var CanvasMetadata = z4.object({
   // `scaffold-video`) so the editable checklist travels inside the canvas
   // instead of only printing to stdout. Ignored by the engine.
   todo: z4.unknown().optional(),
-  video: VideoMeta
+  video: VideoMeta,
+  // A static ad of a series (`seriesMemberAd`): the lead ad its picture is an edit of, the
+  // lead's version, and the lead's words as that version drew them, which this ad's replace.
+  // Ignored by the engine; the brief projection reads it.
+  series: z4.object({
+    lead: z4.string().min(1),
+    run_id: z4.string().min(1),
+    copy: z4.array(z4.object({ text: z4.string(), role: z4.string().optional() }).strict()),
+    design: z4.string().optional(),
+    // A translation of the lead: the language (BCP-47) its words are in.
+    language: z4.string().min(2).optional()
+  }).strict().optional()
 }).strict().optional();
 var CanvasSchema = z4.object({
   schema: z4.literal("baker-canvas/1"),
@@ -6706,6 +6700,7 @@ function textFidelityDirective(strings2, hasFont) {
   return [
     exact,
     "Render NO other words anywhere in the image \u2014 no invented labels, captions, sub-headers, or filler text.",
+    "Any bill, quote, receipt, screen or price tag in the scene shows no readable prices or amounts beyond these strings: its figures are blurred or out of focus.",
     "For any brand name or uncommon word, lock its letters exactly as written (spell it out letter-by-letter if that helps the characters render correctly).",
     "Keep all type crisp, legible, and large enough to read cleanly; no garbled, warped, or duplicated characters, and no unreadable microtext."
   ].join("\n");
@@ -6770,22 +6765,32 @@ var Viewer = z7.object({
   /** Who will see the ad, in the words a marketer would use. */
   who: z7.string().trim().min(1),
   market: Market.optional(),
-  /** What they already know about the brand and the offer. */
-  knows: z7.string().optional(),
+  /** What they already know about the brand and the offer; a list (as _definition.md keeps it) reads as one line. */
+  knows: z7.preprocess((v) => Array.isArray(v) ? v.map(String).join("; ") || void 0 : v, z7.string().optional()),
   temperature: z7.enum(["cold", "warm", "hot"]).optional(),
   /** Where they meet it (feed, Stories, Reels). */
   placement: z7.string().optional()
 }).strict();
-var Scene = z7.object({
+var withoutFormatName = (v) => {
+  if (!v || typeof v !== "object" || Array.isArray(v) || typeof v.concept !== "string")
+    return v;
+  const { concept: _format, ...scene } = v;
+  return scene;
+};
+var SceneFields = z7.object({
   description: z7.string().trim().min(1),
-  /** A photograph, a designed graphic, or an illustration. */
-  look: z7.enum(["photo", "designed", "illustration"]),
+  /** A photograph, a designed graphic, or an illustration; plain synonyms ("photography") read as them. */
+  look: z7.preprocess(
+    (v) => typeof v !== "string" ? v : /^photo/i.test(v.trim()) ? "photo" : /^illustrat/i.test(v.trim()) ? "illustration" : /^(design|graphic)/i.test(v.trim()) ? "designed" : v,
+    z7.enum(["photo", "designed", "illustration"])
+  ),
   /** How a photo was taken, in plain words (handheld at standing height, window light, faint glare). */
   capture: z7.string().optional(),
   mood: z7.string().optional(),
   /** How the frame is arranged, by what fills each part of it. */
   layout: z7.string().optional()
 }).strict();
+var Scene = z7.preprocess(withoutFormatName, SceneFields);
 var Brand = z7.object({
   name: z7.string().optional(),
   /** The words the brand's logo prints (its wordmark), so a check reads them as the logo, never as copy. */
@@ -6857,13 +6862,19 @@ var AdSpecSchema = z7.object({
    * editor's line numbers, a product's own label, a platform's badge. The render may draw them
    * and the review never calls them extra words.
    */
-  scene_text: z7.array(z7.string().trim().min(1)).default([]),
+  scene_text: z7.preprocess(
+    (v) => Array.isArray(v) ? v.map((w) => w && typeof w === "object" && "text" in w ? w.text : w) : v,
+    z7.array(z7.string().trim().min(1)).default([])
+  ),
   /** The formats the ad is made for; the canvas delivers them. */
   formats: z7.array(z7.string()).optional(),
   /** An optional note on direction for this concept. */
   direction: z7.string().optional(),
   /** The device the ad is built on, and why it works on a stranger. Judged, never drawn. */
-  mechanism: z7.array(Mechanism).default([]),
+  mechanism: z7.preprocess((v) => {
+    const list = v && typeof v === "object" && !Array.isArray(v) ? [v] : v;
+    return Array.isArray(list) ? list.map((m) => typeof m === "string" ? { device: m } : m) : list;
+  }, z7.array(Mechanism).default([])),
   /** Why the reference won and what this ad keeps of it (schema /3). */
   concept: Concept.optional(),
   /**
@@ -6931,6 +6942,49 @@ function unwrittenProblems(spec) {
   }
   return problems;
 }
+var QUOTED = /"([^"]{2,})"|“([^”]{2,})”|(?<![\p{L}\p{N}])['‘]([^'’]{2,}?)['’](?![\p{L}\p{N}])/gu;
+var FIGURE = /[£$€]\s?\d[\d.,]*|\d+(?:[.,]\d+)?\s?%/g;
+var comparable = (text2) => text2.normalize("NFD").replace(new RegExp("\\p{M}", "gu"), "").toLowerCase().replace(/[^\p{L}\p{N}£$€%]+/gu, " ").trim();
+function sceneWordProblems(spec) {
+  const held = [...spec.copy.map((l) => l.text), ...spec.scene_text].map(comparable);
+  const holds = (text2) => {
+    const want = comparable(text2);
+    return want.length === 0 || held.some((h) => h.includes(want));
+  };
+  const scene = [spec.scene.description, spec.scene.layout ?? ""].join(" ");
+  const quoted = [...scene.matchAll(QUOTED)].map((m) => (m[1] ?? m[2] ?? m[3] ?? "").trim()).filter((q) => !holds(q));
+  const figures = (scene.match(FIGURE) ?? []).map((f) => f.trim()).filter((f) => !holds(f));
+  const unheld = [.../* @__PURE__ */ new Set([...quoted, ...figures])];
+  if (unheld.length === 0) return [];
+  return [
+    `The scene asks the picture to show ${unheld.map((w) => `"${w}"`).join(", ")}, which the copy does not hold: the picture would print it and the run would then spend a round erasing it. Put each one the ad needs in \`copy\` as an \`in_scene\` line with \`on\` (the bill, the phone), or describe that surface without words (blank, blurred, face-down).`
+  ];
+}
+var FIELD_SHAPES = {
+  copy: '"copy": [{"text": "Book your free survey", "lettering": "designed", "role": "cta"}]',
+  scene: '"scene": {"description": "a family on a sunny roof terrace", "look": "photo"}',
+  colors: '"colors": [{"object": "the button", "name": "deep green", "hex": "#1F5C3A"}]',
+  references: '"references": [{"id": "PRODUCT_1", "role": "product", "what": "the solar panel kit"}]',
+  third_party_brands: '"third_party_brands": [{"name": "Trustpilot", "role": "proof", "logo": "BADGE_1"}]',
+  mechanism: '"mechanism": [{"device": "a before and after", "why_it_works": "the change is seen, not told"}]',
+  viewer: '"viewer": {"who": "homeowners with high energy bills", "knows": "nothing about us yet"}'
+};
+var SPEC_SHAPES_HINT = `prompt.json shapes: ${["copy", "colors", "viewer"].map((f) => FIELD_SHAPES[f]).join("; ")}.`;
+function adSpecErrorText(e) {
+  if (!(e instanceof z7.ZodError)) return e instanceof Error ? e.message : String(e);
+  const items = /* @__PURE__ */ new Map();
+  for (const issue of e.issues) {
+    const [field2, index, key] = issue.path;
+    const at2 = typeof index === "number" ? `${String(field2)}[${index}]` : issue.path.map(String).join(".") || "the spec";
+    const what = issue.code === "unrecognized_keys" ? `no field ${issue.keys.map((k) => `"${k}"`).join(", ")}` : key !== void 0 && typeof index === "number" ? `"${String(key)}" ${issue.message.replace(/^Invalid input: /, "")}` : issue.message.replace(/^Invalid input: /, "");
+    items.set(at2, [...items.get(at2) ?? [], what]);
+  }
+  const fields = [...new Set(e.issues.map((i) => String(i.path[0] ?? "")))].filter((f) => FIELD_SHAPES[f]);
+  return [
+    ...[...items].map(([at2, whats]) => `${at2}: ${[...new Set(whats)].join("; ")}`),
+    ...fields.map((f) => `Shape: ${FIELD_SHAPES[f]}`)
+  ].join("\n");
+}
 function readAdSpec(raw) {
   if (isAdSpec(raw)) return AdSpecSchema.parse(raw);
   const advertiser = raw?.reference?.advertiser;
@@ -7421,7 +7475,7 @@ function pictureInstruction(p, ctx) {
   const keep = p.spec?.keep ? ` Keep ${plain(p.spec.keep, ctx.clean)}.` : "";
   switch (p.role) {
     case "base":
-      return ctx.job === "fix" ? "the current version of this ad, to edit." : "the finished ad, to re-lay for this shape.";
+      return ctx.job === "fix" ? "the current version of this ad, to edit." : ctx.job === "series" ? "the finished ad this series repeats, to copy exactly with new words." : "the finished ad, to re-lay for this shape.";
     case "identity":
       return identityInstruction(p, what, keep, ctx.flowing);
     // The user saw one label come back two ways (E4 gallery, BENCH.md § "E1 v2"): the label is the product's.
@@ -7800,6 +7854,10 @@ function deliverableSection(c) {
     const change = sentence(c.opts.instruction?.trim() || "correct what is wrong");
     return c.flowing ? `Image 1 is the current version of this ad. ${capitalize(change)} Keep everything else in Image 1 exactly the same, preserving its picture, layout, colours, lettering and every word.` : `Edit: Image 1 is the current version of this ad. ${capitalize(change)} Keep everything else exactly as it is in Image 1: the picture, the layout, the colours, the lettering and every word.`;
   }
+  if (c.job === "series") {
+    const change = sentence(c.opts.instruction?.trim() || "set the new words");
+    return c.flowing ? `Image 1 is a finished ad of this series. Make the next ad of the same series${forBrand}: ${change} Keep everything else in Image 1 exactly the same, preserving its picture, layout, background, shapes, colours, lettering style and logo, each word in the place and style of the one it replaces.` : `Edit: Image 1 is a finished ad of this series. Make the next ad of the same series${forBrand}. ${capitalize(change)} Keep everything else exactly as it is in Image 1: the picture, the layout, the background, the shapes, the colours, the lettering style and the logo, each new line in the place, size and style of the line it replaces.`;
+  }
   if (c.job === "relay") {
     return c.flowing ? `Image 1 is a finished ad. Recompose this same ad as a ${noun}${forBrand}: the same picture, colours, lettering and every word, rearranged for the new shape, with more of the scene revealed at the edges.` : `Deliverable: the same ad as Image 1, re-laid as a finished ${noun}${forBrand}. Keep the same picture, colours, lettering and every word, rearranged for the new shape; show more of the scene rather than cropping it.`;
   }
@@ -8383,14 +8441,16 @@ function scaleText(plan, spec, flowing, zoned, short) {
   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;
+var COVERED_HEADROOM = { top: 0.06, bottom: 0.08, side: 0.02 };
+var NO_HEADROOM = { top: 0, bottom: 0, side: 0 };
 var pct = (share) => `${Math.round(share * 100)}%`;
 function zonesText(plan, flowing, ground, short) {
-  const top = plan.safe.top + ZONE_HEADROOM;
-  const bottom = plan.safe.bottom + 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 room = isTall(plan) && covered ? COVERED_HEADROOM : NO_HEADROOM;
+  const top = plan.safe.top + room.top;
+  const bottom = plan.safe.bottom + room.bottom;
+  const side = Math.max(plan.safe.left, plan.safe.right) + room.side;
+  const band = `from ${pct(top)} to ${pct(1 - bottom)} of the height, at least ${pct(side)} in from each side`;
   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}.`;
@@ -8399,7 +8459,7 @@ function zonesText(plan, flowing, ground, short) {
     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.`;
+  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 app's buttons and captions cover the top and the bottom of this frame, hiding any word there. The logo, every line and the button sit in one band, ${band}: the headline starts below the top fifth, and the button ends directly under the last line, never at the bottom edge where a feed ad puts it. 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.`;
 }
 function adaptBrief(spec, profile, opts) {
   const { plan, images } = opts;
@@ -8468,6 +8528,7 @@ var STATIC_ADAPT_ROLE = "static_adapt";
 var STATIC_SAFE_FIT_ROLE = "static_safe_fit";
 var STATIC_PLACE_ROLE = "static_place";
 var LOGO_COMPOSITE_ROLE = "logo_composite";
+var SERIES_LEAD_ROLE = "series_lead";
 var STATIC_FIX_ROLE = "static_fix";
 var LOGO_COMPOSITE_DEFAULT = false;
 var ADAPT_IMAGE_SIZE = "2K";
@@ -8487,6 +8548,19 @@ function rolesById(canvas) {
   }
   return out;
 }
+function relaidPictureRole(canvas) {
+  const roles = rolesById(canvas);
+  const final = nodesOf(canvas).find((n) => n.id === "final" && n.type === "collect");
+  const labels = final?.params?.labels;
+  const images = final?.inputs?.images;
+  if (!Array.isArray(labels) || !Array.isArray(images)) return {};
+  const at2 = images.findIndex((ref) => {
+    const from = typeof ref === "string" ? /^\$ref:([^.]+)\./.exec(ref)?.[1] : void 0;
+    return from !== void 0 && roles[from] === STATIC_MASTER_ROLE;
+  });
+  const format = labels[at2];
+  return typeof format === "string" ? { [`last_${formatSlug(format)}`]: STATIC_MASTER_ROLE } : {};
+}
 function formatSlug(format) {
   return format.replace(":", "x").replace(".", "_");
 }
@@ -10136,7 +10210,7 @@ function checkOrphanNodes(ctx) {
       path: `nodes[${ctx.idToIndex.get(n.id)}]`,
       code: STAGE_CODES.ORPHAN_NODE,
       severity: "warning",
-      message: `node "${n.id}" (${n.type}) is not reachable from output "${out.node}" \u2014 it will still execute (and bill, if billable) but nothing consumes its result; wire it in or remove it`
+      message: `node "${n.id}" (${n.type}) is not reachable from output "${out.node}": a run skips it, so nothing it would make is used; wire it in or remove it`
     });
   }
 }
@@ -10207,6 +10281,17 @@ function unwrap(schema) {
 }
 
 // src/engine/engine/executor.ts
+function throwRunOutcome(signal, failures, held) {
+  if (signal?.aborted) throw new RunAbortedError("signal", "run aborted by signal");
+  if (failures.length === 1 && failures[0]) throw failures[0].reason;
+  if (failures.length > 1) throw new LayerExecutionError([...failures]);
+  if (held.length > 0) {
+    throw new RunAbortedError(
+      "checkpoint",
+      `stopped before ${held.join(", ")} \u2014 everything up to here is done and cached, so continuing this run id pays for none of it again`
+    );
+  }
+}
 function heldByCheckpoint(canvas, layer, kinds) {
   if (!kinds?.size) return [];
   return layer.filter((id) => {
@@ -10295,45 +10380,63 @@ var Engine = class {
     return { run_id: runId, output, outputs_by_node: outputs, stats, outputs_dir: writer.runDir, node_runs: nodeRuns };
   }
   async runLayers(canvas, graph, outputs, runId, writer, opts, counters, nodeRuns, needsBytes) {
-    const layers = topologicalLayers(graph);
+    const order = topologicalLayers(graph).flat();
     const limit = resolveConcurrency(opts.concurrency);
-    for (const layer of layers) {
-      this.assertLayerMayRun(canvas, layer, opts);
-      const settled = await mapWithConcurrency(layer, limit, (nodeId) => {
-        if (opts.signal?.aborted) {
-          return Promise.reject(new RunAbortedError("signal", "run aborted before node dispatch"));
-        }
-        this.emitProgress(opts, { kind: "node_start", node_id: nodeId });
-        return this.executeOne(canvas, nodeId, outputs, runId, writer, opts, needsBytes.has(nodeId)).then((r) => {
-          if (r.cached) counters.cachedNodes++;
-          counters.totalCredits += r.credits;
-          const node = canvas.nodes.find((n) => n.id === nodeId);
-          if (node) {
-            const run = {
-              node_id: nodeId,
-              node_type: node.type,
-              cached: r.cached,
-              duration_ms: r.durationMs,
-              credits: r.credits
-            };
-            nodeRuns.push(run);
-            this.emitProgress(opts, { kind: "node_settled", run, outputs: outputs[nodeId] ?? {} });
-          }
-        });
-      });
-      const failures = [];
-      settled.forEach((result, i) => {
-        const nodeId = layer[i];
-        if (result.status === "rejected" && nodeId) {
-          if (result.reason instanceof RunAbortedError) return;
-          failures.push({ nodeId, reason: result.reason });
-          this.emitProgress(opts, { kind: "node_failed", node_id: nodeId, error: failureDetail(result.reason) });
+    if (opts.signal?.aborted) throw new RunAbortedError("signal", "run aborted before dispatch");
+    const waitingOn = new Map(order.map((id) => [id, new Set(graph.get(id) ?? [])]));
+    const running = /* @__PURE__ */ new Map();
+    const failures = [];
+    const held = [];
+    const dispatch = (nodeId) => {
+      waitingOn.delete(nodeId);
+      this.emitProgress(opts, { kind: "node_start", node_id: nodeId });
+      const settled = this.executeOne(canvas, nodeId, outputs, runId, writer, opts, needsBytes.has(nodeId)).then(
+        (r) => {
+          this.recordRun(canvas, nodeId, r, counters, nodeRuns, outputs, opts);
+          for (const deps of waitingOn.values()) deps.delete(nodeId);
+        },
+        (reason) => {
+          failures.push({ nodeId, reason });
+          this.emitProgress(opts, { kind: "node_failed", node_id: nodeId, error: failureDetail(reason) });
         }
-      });
-      if (opts.signal?.aborted) throw new RunAbortedError("signal", "run aborted by signal");
-      if (failures.length === 1 && failures[0]) throw failures[0].reason;
-      if (failures.length > 1) throw new LayerExecutionError(failures);
+      );
+      running.set(
+        nodeId,
+        settled.finally(() => running.delete(nodeId))
+      );
+    };
+    const isHeld = (nodeId) => heldByCheckpoint(canvas, [nodeId], opts.stop_before_kinds).length > 0;
+    for (; ; ) {
+      const ready = opts.signal?.aborted ? [] : order.filter((id) => waitingOn.get(id)?.size === 0);
+      for (const nodeId of ready) {
+        if (running.size >= limit) break;
+        if (isHeld(nodeId)) {
+          waitingOn.delete(nodeId);
+          held.push(nodeId);
+        } else dispatch(nodeId);
+      }
+      if (running.size === 0) break;
+      await Promise.race(running.values());
     }
+    const rank = new Map(order.map((id, i) => [id, i]));
+    failures.sort((a, b) => (rank.get(a.nodeId) ?? 0) - (rank.get(b.nodeId) ?? 0));
+    throwRunOutcome(opts.signal, failures, held);
+  }
+  /** A settled node counted, recorded and announced. */
+  recordRun(canvas, nodeId, r, counters, nodeRuns, outputs, opts) {
+    if (r.cached) counters.cachedNodes++;
+    counters.totalCredits += r.credits;
+    const node = canvas.nodes.find((n) => n.id === nodeId);
+    if (!node) return;
+    const run = {
+      node_id: nodeId,
+      node_type: node.type,
+      cached: r.cached,
+      duration_ms: r.durationMs,
+      credits: r.credits
+    };
+    nodeRuns.push(run);
+    this.emitProgress(opts, { kind: "node_settled", run, outputs: outputs[nodeId] ?? {} });
   }
   /** Progress consumers are observers only — an exception there must never fail the run. */
   emitProgress(opts, event) {
@@ -10425,20 +10528,6 @@ var Engine = class {
     this.logOutputWarnings(node.id, outputsObj);
     return { cached: false, credits, durationMs: elapsed };
   }
-  /**
-   * Every reason a layer must not dispatch, checked before any of its nodes starts, so a stop
-   * never leaves a layer half billed: a signal, the cost cap and a checkpoint.
-   */
-  assertLayerMayRun(canvas, layer, opts) {
-    if (opts.signal?.aborted) throw new RunAbortedError("signal", "run aborted before layer dispatch");
-    const held = heldByCheckpoint(canvas, layer, opts.stop_before_kinds);
-    if (held.length > 0) {
-      throw new RunAbortedError(
-        "checkpoint",
-        `stopped before ${held.join(", ")} \u2014 everything up to here is done and cached, so continuing this run id pays for none of it again`
-      );
-    }
-  }
   /** A cache hit replayed as this node's result: its outputs written, and free. */
   async replayCached(node, cacheKey, outputs, writer) {
     const cacheT0 = Date.now();
@@ -14603,6 +14692,18 @@ function boxesOfLine(line, boxes) {
     return b.kind === "text" && read.length > 0 && words.includes(` ${read} `);
   });
 }
+var BUTTON_PAD = 0.7;
+var isButtonLine = (line) => /^(cta|button|call_to_action)$/.test(roleKey2(line.role));
+function buttonShape(box) {
+  const pad = BUTTON_PAD * (box.y1 - box.y0);
+  return {
+    ...box,
+    x0: Math.max(0, box.x0 - pad),
+    y0: Math.max(0, box.y0 - pad),
+    x1: Math.min(1, box.x1 + pad),
+    y1: Math.min(1, box.y1 + pad)
+  };
+}
 function shownBoxes(boxes, lines, clear) {
   const linesOfBox = /* @__PURE__ */ new Map();
   for (const line of lines) {
@@ -14986,7 +15087,7 @@ async function videoDuration(video) {
     return null;
   }
 }
-async function askGateway(model, parts, timeoutMs, spent) {
+async function askGateway(model, parts, timeoutMs, spent, reasoning) {
   const key = openRouterKey();
   if (!key) return null;
   try {
@@ -14996,7 +15097,8 @@ async function askGateway(model, parts, timeoutMs, spent) {
       body: JSON.stringify({
         model,
         messages: [{ role: "user", content: parts }],
-        usage: { include: true }
+        usage: { include: true },
+        ...reasoning ? { reasoning } : {}
       }),
       signal: AbortSignal.timeout(timeoutMs)
     });
@@ -15045,7 +15147,7 @@ async function askAboutStills(images, prompt, onSpend) {
   if (!hasOpenRouterKey()) return null;
   return await ask(images, prompt, (usage) => onSpend?.(usage));
 }
-async function askAboutImages(model, images, prompt, onSpend, timeoutMs = 6e4) {
+async function askAboutImages(model, images, prompt, onSpend, timeoutMs = 6e4, reasoning) {
   if (!hasOpenRouterKey()) return null;
   return await askGateway(
     model,
@@ -15056,7 +15158,8 @@ async function askAboutImages(model, images, prompt, onSpend, timeoutMs = 6e4) {
       )
     ],
     timeoutMs,
-    (usage) => onSpend?.(usage)
+    (usage) => onSpend?.(usage),
+    reasoning
   );
 }
 async function askAboutText(model, prompt, onSpend) {
@@ -15220,7 +15323,9 @@ async function readTextBoxes(image, opts = {}) {
     return { status: "not_checked" };
   }
   for (let attempt = 0; attempt < 2; attempt++) {
-    const answer = await askAboutImages(TEXT_BOX_READER_MODEL, [jpeg], TEXT_BOX_PROMPT, opts.onSpend);
+    const answer = await askAboutImages(TEXT_BOX_READER_MODEL, [jpeg], TEXT_BOX_PROMPT, opts.onSpend, 6e4, {
+      effort: "minimal"
+    });
     const boxes = textBoxesFromReader(answer);
     if (boxes) return { status: "read", boxes };
   }
@@ -15310,6 +15415,8 @@ var StaticFinding = z21.object({
 });
 var ABSENCE_NEVER_A_FINDING = /\b(?:missing|no|lacks?|without)\s+(?:an?\s+|any\s+|clear\s+|visible\s+)?(?:call to action|cta)\b|\b(?:does not|doesn't) (?:show|tell) the viewer what to do/i;
 var ALWAYS_BLOCKING = /^(?:SUBJECT|PERSON):/i;
+var ABOUT_OWN_COPY = /^COPY:|["“«]|\b(?:headline|subhead\w*|button|cta|tagline|copy)\b/i;
+var BLURRED_FIGURES = /\b(?:blur\w*|obscur\w*|unreadable|illegible|smudg\w*)\b(?=[^.]*\b(?:figures?|numbers?|digits?|amounts?|prices?|savings?|values?)\b)|\b(?:figures?|numbers?|digits?|amounts?|prices?|savings?|values?)\b(?=[^.]*\b(?:blur\w*|obscur\w*|unreadable|illegible|smudg\w*)\b)/i;
 function classifyStaticFindings(json) {
   const findings = json?.findings;
   if (!Array.isArray(findings)) return [];
@@ -15318,7 +15425,7 @@ function classifyStaticFindings(json) {
     if (!parsed.success) return [];
     const { severity, format, what } = parsed.data;
     if (ABSENCE_NEVER_A_FINDING.test(what)) return [];
-    const graded = ALWAYS_BLOCKING.test(what) ? "blocking" : severity;
+    const graded = ALWAYS_BLOCKING.test(what) ? "blocking" : BLURRED_FIGURES.test(what) && !ABOUT_OWN_COPY.test(what) ? "warning" : severity;
     return [{ severity: graded, what: format?.trim() ? `${format.trim()}: ${what}` : what }];
   });
 }
@@ -15329,7 +15436,7 @@ var CopyRead = z21.object({
   seen: z21.string().nullable()
 });
 function comparableCopy(text2) {
-  return text2.replace(/[‘’‚′]/g, "'").replace(/[“”„″]/g, '"').replace(/[‐-―−]/g, "-").replace(/…/g, "...").replace(/\s+/g, " ").trim().toLowerCase();
+  return text2.replace(/[‘’‚′]/g, "'").replace(/[“”„″]/g, '"').replace(/[‐-―−]/g, "-").replace(/…/g, "...").replace(/[«»]/g, '"').replace(/\s+/g, " ").trim().replace(/^"([^"]*)"$/, "$1").trim().toLowerCase();
 }
 function copyFindings(json, copy, formats, scrolled = {}) {
   if (copy.length === 0) return [];
@@ -15704,7 +15811,7 @@ function contextItems(opts) {
       opts.thumbnails ? "7. THUMBNAIL: at thumbnail size the lead line (the largest words) cannot be read. Judge only whether those words can be read, nothing else. That is blocking: most people only ever see the ad that small." : "7. THUMBNAIL: the lead line (the largest words) would be unreadable on a phone feed. That is blocking."
     ],
     sizes: opts.formats.length > 1 ? [
-      "12. SIZES: one size loses what the others are built on: the letter sheet, the email or chat window, the post card, the comic's panels and their order, the product the ad is about (blocking). Rearranged for its shape is fine."
+      `12. SIZES: one size loses what the others are built on: the letter sheet, the email or chat window, the post card, the comic's panels and their order, the product the ad is about, or a size that shows something the others do not (blocking; start the finding with "SIZES:" and report it on the size that differs). Rearranged for its shape is fine.`
     ] : []
   };
 }
@@ -15757,6 +15864,7 @@ function mostOfALine(chunk, copy) {
   });
 }
 var CLAIM = /[%€$£]|\b(?:free|gratis|gratuit[oa]?s?|off|sale|oferta|descuento|rebajas?|promo)\b/i;
+var PRICE = /[€$£]\s?\d|\d\s?[€$£]/;
 var COPY_SIZE_SHARE = 0.8;
 function extraWordFindings(format, extra, boxes, copyBoxes) {
   if (extra.length === 0) return [];
@@ -15774,7 +15882,8 @@ function extraWordFindings(format, extra, boxes, copyBoxes) {
   const printed = (chunk) => usual > 0 && underCopy.includes(chunk) && (!CLAIM.test(chunk) || scenery(chunk));
   const quote = (chunks) => chunks.map((e) => `"${e}"`).join(", ");
   const asCopy = extra.filter((chunk) => !printed(chunk));
-  const inScene = extra.filter(printed);
+  const prices = extra.filter((chunk) => printed(chunk) && PRICE.test(chunk));
+  const inScene = extra.filter((chunk) => printed(chunk) && !prices.includes(chunk));
   return [
     ...asCopy.length > 0 ? [
       {
@@ -15783,6 +15892,13 @@ function extraWordFindings(format, extra, boxes, copyBoxes) {
         what: `${format}: the picture adds words that aren't in the copy: ${quote(asCopy)}. Remove them, or add them to the copy.`
       }
     ] : [],
+    ...prices.length > 0 ? [
+      {
+        severity: "blocking",
+        // `static-autofix.ts` SCENE_PRICES reads this sentence to blur them.
+        what: `${format}: the picture shows prices the copy does not hold: ${quote(prices)}. Make them unreadable.`
+      }
+    ] : [],
     ...inScene.length > 0 ? [
       {
         severity: "warning",
@@ -15847,7 +15963,8 @@ function corroborateEdgeClaims(findings, boxesByFormat, lines) {
     const element = claimedBoxes(f.what, boxes, buttons);
     if (element.length === 0) return f;
     const named = claimedEdges(f.what);
-    const atEdge = element.some((b) => named.some((edge) => clearanceTo(b, edge) <= AT_EDGE));
+    const pad = BUTTON.test(f.what) && !LOGO_CLAIM.test(f.what) ? BUTTON_PAD : 0;
+    const atEdge = element.some((b) => named.some((edge) => clearanceTo(b, edge) - pad * (b.y1 - b.y0) <= AT_EDGE));
     return atEdge ? f : { ...f, severity: "warning" };
   });
 }
@@ -15855,9 +15972,11 @@ function claimedEdges(what) {
   const edges = EDGE_WORD.filter(([, word]) => word.test(what)).map(([edge]) => edge);
   return edges.length > 0 ? edges : ["top", "bottom", "left", "right"];
 }
+var LOGO_CLAIM = /\b(?:logos?|wordmark|mark)\b/i;
+var BUTTON = /\b(button|cta|call[- ]to[- ]action)\b/i;
 function claimedBoxes(what, boxes, buttons) {
-  if (/\b(?:logos?|wordmark|mark)\b/i.test(what)) return boxes.filter((b) => b.kind === "logo");
-  if (/\b(button|cta|call[- ]to[- ]action)\b/i.test(what)) return buttons.flatMap((l) => boxesOfLine(l, boxes));
+  if (LOGO_CLAIM.test(what)) return boxes.filter((b) => b.kind === "logo");
+  if (BUTTON.test(what)) return buttons.flatMap((l) => boxesOfLine(l, boxes));
   return ABOUT_COPY.test(what) ? boxes.filter((b) => b.kind === "text") : [];
 }
 async function bytesOf(source) {
@@ -15987,6 +16106,22 @@ function everySizeChecks(opts) {
     onSpend: opts.onSpend
   };
 }
+async function confirmBlocking(findings, stills, formats, ask2) {
+  const claims = findings.filter((f) => f.severity === "blocking" && !CLIPPED.test(f.what));
+  if (claims.length === 0 || stills.length === 0) return [...findings];
+  const prompt = [
+    `These are the finished sizes of one ad, in order: ${formats.map((f, i) => `Image ${i + 1} is the ${f}`).join("; ")}.`,
+    "A reviewer reported each claim below. Look again at the size each one names (and, for a claim comparing sizes, at the others) and answer true only when the defect is plainly there for someone looking at it on a phone.",
+    "Answer false when the thing is not there, when it is an ordinary part of the scene (a second house, a neighbour's roof, a reflection), or when the sizes it compares show the same thing.",
+    ...claims.map((c, i) => `${i + 1}. ${c.what}`),
+    `Reply with only this JSON: {"answers":[true|false, ...]}, one answer per claim, in order.`
+  ].join("\n");
+  const answer = await ask2([...stills], prompt).catch(() => null);
+  const answers = answer?.answers;
+  if (!Array.isArray(answers) || answers.length !== claims.length) return [...findings];
+  const unconfirmed = new Set(claims.filter((_, i) => answers[i] === false));
+  return findings.map((f) => unconfirmed.has(f) ? { ...f, severity: "warning" } : f);
+}
 async function reviewRenderedStatic(opts) {
   const { measured, originals, stills, thumbs } = await loadDelivered(opts.images);
   if (measured.length === 0) return null;
@@ -15995,6 +16130,12 @@ async function reviewRenderedStatic(opts) {
   const formats = measured.map((m) => m.format);
   const lines = opts.lines ?? opts.copy.map((text3) => ({ text: text3, lettering: "designed" }));
   const every = { lines, ...everySizeChecks(opts) };
+  const ask2 = (measuredRead) => {
+    const prompt = buildStaticReviewPrompt(reviewPromptOpts(opts, formats, measuredRead, reference !== null));
+    const shown = [...measuredRead ? stills : [...stills, ...thumbs], ...reference ? [reference] : []];
+    return askAboutStills(shown, prompt, opts.onSpend);
+  };
+  const asking = ask2(true);
   const checks = await Promise.all(
     originals.map(
       (bytes, i) => checkStaticImage(bytes, {
@@ -16006,13 +16147,19 @@ async function reviewRenderedStatic(opts) {
   );
   const read = checks.every((c) => c.status === "checked");
   const measuredText = read ? checks.flatMap((c) => c.status === "checked" ? c.findings : []) : [];
-  const prompt = buildStaticReviewPrompt(reviewPromptOpts(opts, formats, read, reference !== null));
-  const shown = [...read ? stills : [...stills, ...thumbs], ...reference ? [reference] : []];
-  const answer = await askAboutStills(shown, prompt, opts.onSpend) ?? await askAboutStills(shown, prompt, opts.onSpend);
+  const first = read ? await asking : (void asking.catch(() => null), null);
+  const answer = first ?? await ask2(read);
   if (answer === null) return unreviewed(shape, measuredText);
   const text2 = read ? measuredText : copyFindings(answer, opts.copy, formats, opts.scrolled);
   const boxesByFormat = read ? Object.fromEntries(checks.flatMap((c, i) => c.status === "checked" ? [[formats[i] ?? "", c.boxes]] : [])) : {};
-  return [...shape, ...text2, ...corroborateEdgeClaims(classifyStaticFindings(answer), boxesByFormat, lines)];
+  const judged = corroborateEdgeClaims(classifyStaticFindings(answer), boxesByFormat, lines);
+  const confirmed = await confirmBlocking(
+    judged,
+    stills,
+    formats,
+    (images, prompt) => askAboutStills(images, prompt, opts.onSpend)
+  );
+  return [...shape, ...text2, ...confirmed];
 }
 
 // src/engine/nodes/local/staticNative.ts
@@ -16256,7 +16403,9 @@ function boxesToPlace(boxes, format, opts = {}) {
   const past = (box) => bandViolations([box], format, { placements })[0];
   const cut = (box) => (past(box)?.clearance ?? 1) <= FRAME_CUT;
   const logoWords = opts.copy.filter((l) => roleKey2(l.role) === "logo").map((l) => l.text);
-  return shownBoxes(withWordmark(boxes, logoWords), opts.copy, (box) => !past(box)).filter((shown) => !shown.supporting || cut(shown.box)).map((shown) => shown.box);
+  const read = withWordmark(boxes, logoWords);
+  const buttons = new Set(opts.copy.filter(isButtonLine).flatMap((line) => boxesOfLine(line, read)));
+  return shownBoxes(read, opts.copy, (box) => !past(box)).filter((shown) => !shown.supporting || cut(shown.box)).map((shown) => buttons.has(shown.box) ? buttonShape(shown.box) : shown.box);
 }
 function planSafeFit(boxes, format, opts = {}) {
   const area = blockingArea(format, opts.placements);
@@ -16360,6 +16509,9 @@ var MIN_EXTEND_SCALE = 0.6;
 var GREY_LEVEL = 128;
 var GREY = { r: GREY_LEVEL, g: GREY_LEVEL, b: GREY_LEVEL };
 var FEATHER = 0.012;
+var KEEP_PAD = 0.3;
+var KEEP_FEATHER = 0.03;
+var MOVED = 120;
 function ratioOf2(ratio) {
   const [w = 1, h = 1] = ratio.split(":").map(Number);
   return w / h;
@@ -16422,14 +16574,16 @@ function clearBusyMargins(rgba, frame, keep) {
   }
   return shown;
 }
-async function mergeExtended(extended, placed, ratio) {
+async function mergeExtended(extended, placed, ratio, keep = []) {
   const ad = await sharp7(placed).ensureAlpha().raw().toBuffer({ resolveWithObject: true });
   const { width, height } = ad.info;
   const bounds = placedBounds(ad.data, width, height);
   if (!bounds) return sharp7(placed).removeAlpha().png().toBuffer();
   const canvas = renderCanvas({ width, height }, ratio);
   const paint = await sharp7(extended).removeAlpha().resize(canvas.width, canvas.height, { fit: "fill" }).extract({ left: canvas.left, top: canvas.top, width, height }).raw().toBuffer();
-  const weight = edgeWeight(bounds, width, height, Math.max(1, Math.round(FEATHER * width)));
+  const edge = edgeWeight(bounds, width, height, Math.max(1, Math.round(FEATHER * width)));
+  const boxes = keep.length > 0 && keptInPlace(keep, ad.data, paint, width, height) ? keptWeights(keep, width, height) : null;
+  const weight = boxes ? (x, y) => Math.min(edge(x, y), boxes[y * width + x] ?? 0) : edge;
   const out = Buffer.alloc(width * height * 3);
   for (let y = 0; y < height; y++) {
     for (let x = 0; x < width; x++) {
@@ -16468,18 +16622,65 @@ function edgeWeight(b, width, height, feather) {
     ramp(b.y1 - y, b.y1 === height - 1)
   );
 }
+function keptWeights(keep, width, height) {
+  const out = new Float32Array(width * height);
+  const feather = Math.max(1, KEEP_FEATHER * width);
+  for (const box of keep) {
+    const pad = KEEP_PAD * (box.y1 - box.y0) * height;
+    const x0 = box.x0 * width - pad;
+    const x1 = box.x1 * width + pad;
+    const y0 = box.y0 * height - pad;
+    const y1 = box.y1 * height + pad;
+    const ys = Math.max(0, Math.floor(y0 - feather));
+    const ye = Math.min(height - 1, Math.ceil(y1 + feather));
+    const xs = Math.max(0, Math.floor(x0 - feather));
+    const xe = Math.min(width - 1, Math.ceil(x1 + feather));
+    for (let y = ys; y <= ye; y++) {
+      const dy = Math.max(0, y0 - y, y - y1);
+      for (let x = xs; x <= xe; x++) {
+        const dx = Math.max(0, x0 - x, x - x1);
+        const t = Math.max(0, 1 - Math.hypot(dx, dy) / feather);
+        const w = t * t * (3 - 2 * t);
+        const i = y * width + x;
+        if (w > (out[i] ?? 0)) out[i] = w;
+      }
+    }
+  }
+  return out;
+}
+function keptInPlace(keep, ad, paint, width, height) {
+  const diffs = keep.map((box) => boxDiff(box, ad, paint, width, height)).filter((d) => d !== null).sort((a, b) => a - b);
+  return (diffs[Math.floor(diffs.length / 2)] ?? Number.POSITIVE_INFINITY) <= MOVED;
+}
+function boxDiff(box, ad, paint, width, height) {
+  let sum = 0;
+  let n = 0;
+  const xs = Math.floor(box.x0 * width);
+  const xe = Math.min(width - 1, Math.ceil(box.x1 * width));
+  for (let y = Math.floor(box.y0 * height); y <= Math.min(height - 1, Math.ceil(box.y1 * height)); y++) {
+    for (let x = xs; x <= xe; x++) {
+      const i = y * width + x;
+      if ((ad[i * 4 + 3] ?? 0) === 0) continue;
+      for (let c = 0; c < 3; c++) sum += Math.abs((ad[i * 4 + c] ?? 0) - (paint[i * 3 + c] ?? 0));
+      n++;
+    }
+  }
+  return n > 0 ? sum / n : null;
+}
 
 // src/engine/nodes/local/staticPlace.ts
 var Usage = z25.object({ model: z25.string(), inputTokens: z25.number(), outputTokens: z25.number(), costUsd: z25.number() }).strict();
 var Fit = z25.object({ scale: z25.number(), x: z25.number(), y: z25.number() }).strict();
+var Unit = z25.number().min(0).max(1);
+var Span = z25.object({ x0: Unit, y0: Unit, x1: Unit, y1: Unit }).strict();
 var RenderRatio = z25.string().regex(/^\d+(?:\.\d+)?:\d+(?:\.\d+)?$/);
 var Copy = z25.array(z25.object({ text: z25.string().min(1), role: z25.string().optional() }).strict());
 var staticPlaceNode = defineNode({
   id: "static_place",
-  version: "1.0.0",
+  version: "1.1.0",
   category: "image",
   location: "local",
-  summary: "Place a finished static ad's words and logo where no interface covers them and nothing runs off the frame, for an image model to paint the margins: reads where every line and the logo sit, shrinks the ad (to 60% at most) and sets it inside the size's safe area. `placed` keeps the margins clear (for `static_extend_merge`); `shown` is the same inside the model's render shape with grey margins, to paint. `fit` is null, and both are the ad unchanged, when nothing sits outside.",
+  summary: "Place a finished static ad's words and logo where no interface covers them and nothing runs off the frame, for an image model to paint the margins: reads where every line and the logo sit, shrinks the ad (to 60% at most) and sets it inside the size's safe area. `placed` keeps the margins clear (for `static_extend_merge`); `shown` is the same inside the model's render shape with grey margins, to paint; `keep` is where every line, the logo and the buttons read sit in `placed`, all the merge lays back of the ad's own pixels. `fit` is null, and both are the ad unchanged, when nothing sits outside.",
   when_to_use: "Added by a static ad's autofix round (place-and-extend) before an `image_generate` that paints the margins and a `static_extend_merge`; never scaffolded. One box-reader call (about $0.005).",
   inputs: z25.object({ image: ImageRef }).strict(),
   params: z25.object({
@@ -16492,6 +16693,8 @@ var staticPlaceNode = defineNode({
     placed: ImageRef,
     shown: ImageRef,
     fit: Fit.nullable(),
+    /** Where the words, logo and buttons read sit in `placed`: all the merge lays back of the ad's own pixels. */
+    keep: z25.array(Span).optional(),
     reason: z25.enum(["not_read", "inside_band", "too_far"]).optional(),
     usage: z25.array(Usage).optional()
   }).strict(),
@@ -16534,18 +16737,28 @@ var staticPlaceNode = defineNode({
       placed: placedRef,
       shown: shownRef,
       fit,
+      keep: keptBoxes([...reading.boxes, ...boxes.filter((b) => !reading.boxes.includes(b))], fit),
       ...spend
     };
   }
 });
+function keptBoxes(boxes, fit) {
+  const at2 = (offset2, v) => Math.min(1, Math.max(0, offset2 + fit.scale * v));
+  return boxes.map((b) => ({ x0: at2(fit.x, b.x0), y0: at2(fit.y, b.y0), x1: at2(fit.x, b.x1), y1: at2(fit.y, b.y1) }));
+}
 var staticExtendMergeNode = defineNode({
   id: "static_extend_merge",
-  version: "1.1.0",
+  version: "1.2.0",
   category: "image",
   location: "local",
-  summary: "Have the image model paint a placed static ad's margins (`static_place`'s `shown`, with `paint`, an `image_generate`'s params) and lay the ad (`placed`) back over the painting: the ad's own pixels where it sits, the painting only in the margins, blended at their seam. Same pixel size as the ad. An ad that was never placed (`shown` is `placed`) passes on as it is, and nothing is painted or billed. A painting already made can be wired as `image` instead of `paint`.",
+  summary: "Have the image model paint a placed static ad's margins (`static_place`'s `shown`, with `paint`, an `image_generate`'s params) and lay the ad's own pixels back over the painting only in `keep` (`static_place`'s boxes of the words, logo and buttons, padded and feathered): the painting is the rest of the frame, one picture with no edge where the shrunk ad was. Without `keep`, or when the painting moved the words, the whole ad (`placed`) is laid back, the painting only in the margins, blended at their seam. Same pixel size as the ad. An ad that was never placed (`shown` is `placed`) passes on as it is, and nothing is painted or billed. A painting already made can be wired as `image` instead of `paint`.",
   when_to_use: "Added by a static ad's autofix round after a `static_place`; never scaffolded. One picture at the painter's price, only for a size that was placed.",
-  inputs: z25.object({ placed: ImageRef, shown: ImageRef.optional(), image: ImageRef.optional() }).strict(),
+  inputs: z25.object({
+    placed: ImageRef,
+    shown: ImageRef.optional(),
+    image: ImageRef.optional(),
+    keep: z25.array(Span).optional()
+  }).strict(),
   params: z25.object({ render_ratio: RenderRatio, paint: z25.record(z25.string(), z25.unknown()).optional() }).strict(),
   outputs: z25.object({ image: ImageRef }).strict(),
   outputKinds: { image: "image" },
@@ -16555,7 +16768,7 @@ var staticExtendMergeNode = defineNode({
     const painted = painting?.path ?? painting?.url;
     const placed = inputs.placed.path ?? inputs.placed.url;
     if (!painted || !placed) return { image: inputs.placed };
-    const merged = await mergeExtended(await bytesOf(painted), await bytesOf(placed), params.render_ratio);
+    const merged = await mergeExtended(await bytesOf(painted), await bytesOf(placed), params.render_ratio, inputs.keep);
     const image = await ctx.assets.ingestBytes({ bytes: merged, kind: "image", mime: "image/png" });
     return { image };
   }
@@ -16584,12 +16797,64 @@ import { z as z26 } from "zod";
 // src/engine/nodes/local/lib/variant-prefilter.ts
 import { createHash as createHash3 } from "crypto";
 import sharp8 from "sharp";
-function coverFitBoxes(boxes, from, to) {
+function coverOf(from, to) {
   const scale = Math.max(to.width / from.width, to.height / from.height);
-  const offX = (from.width * scale - to.width) / 2;
-  const offY = (from.height * scale - to.height) / 2;
-  const x = (f) => (f * from.width * scale - offX) / to.width;
-  const y = (f) => (f * from.height * scale - offY) / to.height;
+  const width = from.width * scale;
+  const height = from.height * scale;
+  return { scale, width, height, centre: { left: (width - to.width) / 2, top: (height - to.height) / 2 } };
+}
+function framingOf(from, to) {
+  let frame;
+  return {
+    place: (boxes) => {
+      frame = frameKeeping(boxes, from, to);
+      return coverFitBoxes(boxes, from, to, frame);
+    },
+    moved: () => {
+      const { centre } = coverOf(from, to);
+      return frame && (Math.abs(frame.left - centre.left) >= 1 || Math.abs(frame.top - centre.top) >= 1) ? frame : void 0;
+    }
+  };
+}
+async function cutToFrame(bytes, frame, to) {
+  const { width = 0, height = 0 } = await sharp8(bytes).metadata();
+  const { scale } = coverOf({ width, height }, to);
+  const w = Math.min(width, Math.round(to.width / scale));
+  const h = Math.min(height, Math.round(to.height / scale));
+  const left = Math.min(width - w, Math.max(0, Math.round(frame.left / scale)));
+  const top = Math.min(height - h, Math.max(0, Math.round(frame.top / scale)));
+  return sharp8(bytes).extract({ left, top, width: w, height: h }).png().toBuffer();
+}
+var FRAME_MARGIN = 0.02;
+function frameKeeping(boxes, from, to) {
+  const cover = coverOf(from, to);
+  if (boxes.length === 0) return cover.centre;
+  const along = (offset2, extent, frame, lo, hi) => {
+    const low = lo * extent;
+    const high = hi * extent;
+    const room = extent - frame;
+    const margin = FRAME_MARGIN * frame;
+    for (const m of [margin, 0]) {
+      const min = Math.max(0, high + m - frame);
+      const max = Math.min(room, low - m);
+      if (min <= max) return Math.min(max, Math.max(min, offset2));
+    }
+    return offset2;
+  };
+  const x0 = Math.min(...boxes.map((b) => b.x0));
+  const x1 = Math.max(...boxes.map((b) => b.x1));
+  const y0 = Math.min(...boxes.map((b) => b.y0));
+  const y1 = Math.max(...boxes.map((b) => b.y1));
+  return {
+    left: along(cover.centre.left, cover.width, to.width, x0, x1),
+    top: along(cover.centre.top, cover.height, to.height, y0, y1)
+  };
+}
+function coverFitBoxes(boxes, from, to, frame) {
+  const cover = coverOf(from, to);
+  const { left: offX, top: offY } = frame ?? cover.centre;
+  const x = (f) => (f * cover.width - offX) / to.width;
+  const y = (f) => (f * cover.height - offY) / to.height;
   return boxes.map((b) => ({ ...b, x0: x(b.x0), y0: y(b.y0), x1: x(b.x1), y1: y(b.y1) }));
 }
 var NO_LOGO = "The brand's logo was not found on it.";
@@ -16643,34 +16908,45 @@ async function prefilterVariants(variants, spec, formats, opts = {}) {
   });
   const format = plan.master.format;
   const grade = plan.masterShape === "relayout" ? plan.placements ? { placements: plan.placements } : {} : { band: plan.band };
+  const want = { lines, buttons, ...brand ? { brand } : {}, logo, format, grade };
   const checked = await Promise.all(
-    variants.map(async (variant) => {
-      const source = variant.path ?? variant.url;
-      if (!source) return { index: variant.index, blocking: null };
-      try {
-        const bytes = await bytesOf(source);
-        const { width = 0, height = 0 } = await sharp8(bytes).metadata();
-        const check = await checkStaticImage(bytes, {
-          format,
-          lines,
-          allowed: brand ? [brand] : [],
-          ...grade,
-          toFrame: (boxes) => coverFitBoxes(boxes, { width, height }, plan.master.size),
-          ...opts.read ? { read: opts.read } : {},
-          ...opts.onSpend ? { onSpend: opts.onSpend } : {}
-        });
-        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, grade };
-        return { index: variant.index, blocking, ...rankOf(check.boxes, blocking, want) };
-      } catch {
-        return { index: variant.index, blocking: null };
-      }
-    })
+    variants.map(
+      (variant) => checkVariant(variant, { format, size: plan.master.size, lines, brand, grade, want, opts })
+    )
   );
   const outcome = prefilterOutcome(checked);
-  return { ...outcome, kept: seededOrder(outcome.kept, variants) };
+  const frames = Object.fromEntries(checked.flatMap((c) => "frame" in c && c.frame ? [[c.index, c.frame]] : []));
+  return {
+    ...outcome,
+    kept: seededOrder(outcome.kept, variants),
+    ...Object.keys(frames).length > 0 ? { frames, masterSize: plan.master.size } : {}
+  };
+}
+async function checkVariant(variant, c) {
+  const { format, lines, brand, grade, want, opts } = c;
+  const source = variant.path ?? variant.url;
+  if (!source) return { index: variant.index, blocking: null };
+  try {
+    const bytes = await bytesOf(source);
+    const { width = 0, height = 0 } = await sharp8(bytes).metadata();
+    const framing = framingOf({ width, height }, c.size);
+    const check = await checkStaticImage(bytes, {
+      format,
+      lines,
+      allowed: brand ? [brand] : [],
+      ...grade,
+      toFrame: framing.place,
+      ...opts.read ? { read: opts.read } : {},
+      ...opts.onSpend ? { onSpend: opts.onSpend } : {}
+    });
+    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 frame = framing.moved();
+    return { index: variant.index, blocking, ...rankOf(check.boxes, blocking, want), ...frame ? { frame } : {} };
+  } catch {
+    return { index: variant.index, blocking: null };
+  }
 }
 function seededOrder(indexes, variants) {
   const shaOf = new Map(variants.map((v) => [v.index, v.sha256]));
@@ -16746,7 +17022,7 @@ async function readSpec(ref) {
 }
 var staticPrefilterNode = defineNode({
   id: "static_prefilter",
-  version: "1.0.0",
+  version: "1.1.0",
   category: "image",
   location: "local",
   // Reads each variant's pixels itself, from its file or its durable URL, so the variants
@@ -16779,7 +17055,8 @@ var staticPrefilterNode = defineNode({
     images: z26.array(ImageRef).min(1),
     // Which variant (its place among the inputs) each of `images` is, so the judge's "Image k" maps back.
     order: z26.array(z26.number().int().min(0)).optional(),
-    // The picture every size is made from: the checks' first, or on a tie the judge's.
+    // The picture every size is made from: the checks' first, or on a tie the judge's. Cut to the
+    // master's frame where every word stays whole when its centre would cut one, else as rendered.
     image: ImageRef.optional(),
     // Which variant it is (its place among the inputs).
     chosen: z26.number().int().min(0).optional(),
@@ -16792,12 +17069,12 @@ var staticPrefilterNode = defineNode({
   }).strict(),
   outputKinds: { images: "image", image: "image" },
   cost: () => ({ credits: 0, seconds_estimate: 1 }),
-  async execute({ inputs, params }) {
-    const variants = inputs.images.map((image, index) => ({
+  async execute({ inputs, params, ctx }) {
+    const variants = inputs.images.map((image2, index) => ({
       index,
-      sha256: image.sha256,
-      ...image.path ? { path: image.path } : {},
-      ...image.url ? { url: image.url } : {}
+      sha256: image2.sha256,
+      ...image2.path ? { path: image2.path } : {},
+      ...image2.url ? { url: image2.url } : {}
     }));
     const usage = [];
     const result = await prefilterVariants(variants, params.checks ?? await readSpec(inputs.spec), params.formats, {
@@ -16813,10 +17090,11 @@ var staticPrefilterNode = defineNode({
       { model: params.judge_model, prompt: params.judge_prompt, onSpend: (u) => usage.push(u) }
     ) : null;
     const chosen = tie?.chosen ?? shown[0] ?? 0;
+    const image = await framed(inputs.images[chosen], result.frames?.[chosen], result.masterSize, ctx);
     return {
       images: kept.length > 0 ? kept : inputs.images,
       order: shown,
-      ...inputs.images[chosen] ? { image: inputs.images[chosen] } : {},
+      ...image ? { image } : {},
       chosen,
       ...tie ? { reasoning: tie.reasoning } : {},
       dropped: result.dropped,
@@ -16825,6 +17103,12 @@ var staticPrefilterNode = defineNode({
     };
   }
 });
+async function framed(picture, frame, size2, ctx) {
+  const source = picture?.path ?? picture?.url;
+  if (!picture || !frame || !size2 || !source) return picture;
+  const bytes = await cutToFrame(await bytesOf(source), frame, size2);
+  return await ctx.assets.ingestBytes({ bytes, kind: "image", mime: "image/png" });
+}
 
 // src/engine/nodes/local/staticSafeFit.ts
 import { z as z27 } from "zod";
@@ -18477,6 +18761,9 @@ export {
   conceptSummary,
   conceptProblems,
   unwrittenProblems,
+  sceneWordProblems,
+  SPEC_SHAPES_HINT,
+  adSpecErrorText,
   readAdSpec,
   withRenderedLettering,
   conceptClassOf,
@@ -18503,10 +18790,12 @@ export {
   STATIC_SAFE_FIT_ROLE,
   STATIC_PLACE_ROLE,
   LOGO_COMPOSITE_ROLE,
+  SERIES_LEAD_ROLE,
   STATIC_FIX_ROLE,
   LOGO_COMPOSITE_DEFAULT,
   nodesWithRole,
   rolesById,
+  relaidPictureRole,
   formatSlug,
   staticMasterFormat,
   staticRenderNodes,
@@ -18564,4 +18853,4 @@ export {
   defaultRegistry,
   createEngineFromEnv
 };
-//# sourceMappingURL=chunk-MMTPMFFH.js.map
+//# sourceMappingURL=chunk-7NKAKF3K.js.map