shotops-mcp 0.9.5 → 0.9.7

package/dist/local.js

@@ -24,7 +24,7 @@
   }
   await visit('')
   return hash.digest('hex')
-})(sourceDirectory) !== "05d27ff2f672ea1fb99121eb514c734ec24b952b84ee842baa15d9cf8a0e9e89") {
+})(sourceDirectory) !== "1b56a11440edcc23083bfa4a283fe2d972acfb3a17820247bc951bcd5cc3810d") {
           console.error('shotops-mcp: dist/local.js is stale; run npm run build in shotops-mcp.');
         }
       } catch { /* An unreadable checkout must not break an otherwise working CLI. */ }
@@ -1892,6 +1892,12 @@ var init_fonts = __esm({
 });
 
 // ../mockup-engine/appstore/refineIntent.ts
+function requestsBroaderDeviceScope(instruction) {
+  return BROADER_DEVICE_SCOPE.test(instruction) || NUMBERED_SIBLING_SCOPE.test(instruction);
+}
+function canRepairLayoutForFocus(focus, instruction) {
+  return focus?.kind !== "device" || requestsBroaderDeviceScope(instruction);
+}
 function structuralOperationTargets(operation) {
   switch (operation.op) {
     case "frame.add":
@@ -1931,7 +1937,7 @@ function resolveAiNumber(input, current, range) {
   if (raw === void 0 || !Number.isFinite(raw)) return void 0;
   return Math.min(Math.max(raw, range.min), range.max);
 }
-var MAX_REFINE_PROMPT_LENGTH, AI_COLORWAY_IDS, AI_CLAY_TONES, AI_SHOT_RANGES, AI_SCALE_RANGE, AI_CAPTION_FONT_IDS, AI_CAPTION_RANGES, AI_GRADIENT_STOPS;
+var MAX_REFINE_PROMPT_LENGTH, AI_COLORWAY_IDS, AI_CLAY_TONES, AI_SHOT_RANGES, AI_SCALE_RANGE, AI_CAPTION_FONT_IDS, AI_CAPTION_RANGES, AI_GRADIENT_STOPS, BROADER_DEVICE_SCOPE, NUMBERED_SIBLING_SCOPE;
 var init_refineIntent = __esm({
   "../mockup-engine/appstore/refineIntent.ts"() {
     "use strict";
@@ -1949,6 +1955,8 @@ var init_refineIntent = __esm({
     AI_CAPTION_FONT_IDS = CAPTION_FONT_IDS;
     AI_CAPTION_RANGES = CAPTION_STYLE_BOUNDS;
     AI_GRADIENT_STOPS = { min: 1, max: 6 };
+    BROADER_DEVICE_SCOPE = /\b(?:all|every|each|both|entire|whole|across|throughout|other|others|rest|remaining|project|strip|frames|screenshots|screens|devices|phones|captions)\b/i;
+    NUMBERED_SIBLING_SCOPE = /\b(?:frame|device|phone)\s+\d+\b/i;
   }
 });
 
@@ -2200,7 +2208,7 @@ var init_screenVariants = __esm({
 });
 
 // ../mockup-engine/appstore/catalog/layouts.ts
-var LAYOUT_TEMPLATE_CATALOG, LAYOUT_TEMPLATES, TEMPLATE_IDS, LAYOUT_TEMPLATE_IDS, LAYOUT_POSE_FIELDS, LAYOUT_CAMERA_FIELDS, LAYOUT_CAPTION_FIELDS;
+var LAYOUT_TEMPLATE_CATALOG, LAYOUT_TEMPLATES, TEMPLATE_IDS, LAYOUT_TEMPLATE_IDS, LAYOUT_CAPTION_ABSENT_DEFAULTS, LAYOUT_POSE_FIELDS, LAYOUT_CAMERA_FIELDS, LAYOUT_CAPTION_FIELDS;
 var init_layouts = __esm({
   "../mockup-engine/appstore/catalog/layouts.ts"() {
     "use strict";
@@ -2210,28 +2218,78 @@ var init_layouts = __esm({
         label: "Standard",
         blurb: "Headline on top, whole device below it, nothing cropped. The safe default.",
         character: "safe",
+        bleedEdge: "none",
         shotLook: { phoneHeight: "82", hOffset: "0", vOffset: "18", angle: "front", cameraPos: null, roll: "0" },
-        caption: { sizePt: 32, maxWidth: 0.86, reserveLines: 2 }
+        caption: { sizePt: 32, maxWidth: 0.86, reserveLines: 2, align: "center", bandCenter: 0.5 }
       },
       {
         id: "bleed",
         label: "Bleed",
         blurb: "Room for a longer headline, device running off the bottom edge. What the market looks like.",
         character: "conventional",
+        bleedEdge: "bottom",
         shotLook: { phoneHeight: "82", hOffset: "0", vOffset: "38", angle: "front", cameraPos: null, roll: "0" },
-        caption: { sizePt: 32, maxWidth: 0.86, reserveLines: 4 }
+        caption: { sizePt: 32, maxWidth: 0.86, reserveLines: 4, align: "center", bandCenter: 0.5 }
       },
       {
         id: "top-bleed",
         label: "Top bleed",
         blurb: "Device running off the TOP edge, headline underneath it. Inverts the usual reading order.",
         character: "expressive",
+        bleedEdge: "top",
         shotLook: { phoneHeight: "82", hOffset: "0", vOffset: "-38", angle: "front", cameraPos: null, roll: "0" },
         // The only entry that moves the band. Its caption sits BELOW the device, which the engine
         // could not express at all until #218 gave placeCaptions a bottom-anchored band — before that
         // the only way down was pinning an anchor, which silently costs reflow, stacking and the
         // legibility advisory. `band: 'bottom'` keeps the anchor ABSENT, so it stays genuinely auto.
-        caption: { sizePt: 32, maxWidth: 0.86, reserveLines: 4, band: "bottom" }
+        caption: { sizePt: 32, maxWidth: 0.86, reserveLines: 4, band: "bottom", align: "center", bandCenter: 0.5 }
+      },
+      // ── The side bleeds. Facts 5–7 in the essay above own every number here. ────────────────────
+      //
+      // What they buy that the vertical three cannot: the headline gets a COLUMN instead of a band the
+      // device sits under. Narrowing `maxWidth` to 0.61 and moving `bandCenter` off centre is what
+      // makes that column, and it is why the catalog owns `align`/`bandCenter` at all — see the note
+      // on LayoutCaptionField below for what that costs every other template.
+      {
+        id: "lean-right",
+        label: "Lean right",
+        blurb: "Device pushed off the RIGHT edge, headline in a column down the left. Reads as one continuous swipe.",
+        character: "expressive",
+        bleedEdge: "right",
+        shotLook: { phoneHeight: "82", hOffset: "46", vOffset: "18", angle: "front", cameraPos: null, roll: "0" },
+        caption: { sizePt: 32, maxWidth: 0.61, reserveLines: 2, align: "left", bandCenter: 0.375 }
+      },
+      {
+        id: "lean-left",
+        label: "Lean left",
+        blurb: "Device pushed off the LEFT edge, headline in a column down the right. The mirror of Lean right.",
+        character: "expressive",
+        bleedEdge: "left",
+        shotLook: { phoneHeight: "82", hOffset: "-46", vOffset: "18", angle: "front", cameraPos: null, roll: "0" },
+        caption: { sizePt: 32, maxWidth: 0.61, reserveLines: 2, align: "right", bandCenter: 0.625 }
+      },
+      {
+        id: "swipe",
+        label: "Swipe",
+        blurb: "A third of the device carried into the next panel, headline full width above it. Only honest applied to every frame.",
+        character: "expressive",
+        bleedEdge: "right",
+        // Standard's vertical, and that is not a free choice: a 4-line reservation over vOffset 18 puts
+        // the device's top edge through the fourth line, and Bleed's vOffset 38 would crop the bottom
+        // too — which makes this template claim `bottom-right` and collide with Corner bleed, the only
+        // other entry on that edge. The horizontal push is the whole idea here; the vertical stays out
+        // of its way. Both halves are guarded (clearance, and the declared-edge check).
+        shotLook: { phoneHeight: "82", hOffset: "78", vOffset: "18", angle: "front", cameraPos: null, roll: "0" },
+        caption: { sizePt: 32, maxWidth: 0.86, reserveLines: 2, align: "center", bandCenter: 0.5 }
+      },
+      {
+        id: "corner-bleed",
+        label: "Corner bleed",
+        blurb: "Off the bottom AND the right at once, headline in a column down the left. The most opinionated panel here.",
+        character: "expressive",
+        bleedEdge: "bottom-right",
+        shotLook: { phoneHeight: "82", hOffset: "46", vOffset: "38", angle: "front", cameraPos: null, roll: "0" },
+        caption: { sizePt: 32, maxWidth: 0.61, reserveLines: 4, align: "left", bandCenter: 0.375 }
       }
     ];
     LAYOUT_TEMPLATES = LAYOUT_TEMPLATE_CATALOG;
@@ -2240,6 +2298,10 @@ var init_layouts = __esm({
       TEMPLATE_IDS[0],
       ...TEMPLATE_IDS.slice(1)
     ];
+    LAYOUT_CAPTION_ABSENT_DEFAULTS = {
+      align: "center",
+      bandCenter: 0.5
+    };
     LAYOUT_POSE_FIELDS = ["phoneHeight", "hOffset", "vOffset"];
     LAYOUT_CAMERA_FIELDS = ["angle", "cameraPos", "roll"];
     LAYOUT_CAPTION_FIELDS = Array.from(
@@ -2251,8 +2313,8 @@ var init_layouts = __esm({
 // ../mockup-engine/appstore/layoutTemplates.ts
 function layoutTemplateAgentSummary(template) {
   const reserveLines = template.caption.reserveLines;
-  const capacity = typeof reserveLines === "number" ? ` Reserves ${reserveLines} headline lines (~${reserveLines * 18} characters).` : "";
-  return `${template.blurb}${capacity} Character: [${template.character}].`;
+  const capacity = typeof reserveLines === "number" ? ` Reserves ${reserveLines} headline lines (~${Math.round(reserveLines * 18 * (template.caption.maxWidth ?? 0.86) / 0.86)} characters).` : "";
+  return `${template.blurb}${capacity} Character: [${template.character}]. Bleeds: [${template.bleedEdge}].`;
 }
 function layoutTemplateById(id) {
   return LAYOUT_TEMPLATES.find((t) => t.id === id);
@@ -2272,8 +2334,9 @@ function differencesFrom(template, shotLook2, captionStyle) {
   }
   if (captionStyle) {
     for (const field of LAYOUT_CAPTION_FIELDS) {
-      const actual = captionStyle[field] ?? void 0;
-      const wanted = template.caption[field] ?? void 0;
+      const fallback = LAYOUT_CAPTION_ABSENT_DEFAULTS[field];
+      const actual = captionStyle[field] ?? fallback;
+      const wanted = template.caption[field] ?? fallback;
       if (actual !== wanted) differs.push({ field, actual, template: wanted });
     }
   }
@@ -2318,7 +2381,7 @@ function layoutTemplateToLook(template) {
   }
   return { shotLook: { ...template.shotLook }, caption };
 }
-var LAYOUT_CHARACTER_ANSWERS, LAYOUT_CHARACTER_IDS, LAYOUT_SELECTION_CAVEATS, valuesEqual;
+var LAYOUT_CHARACTER_ANSWERS, LAYOUT_CHARACTER_IDS, LAYOUT_BLEED_EDGE_WORDS, LAYOUT_BLEED_EDGE_IDS, LAYOUT_SELECTION_CAVEATS, valuesEqual;
 var init_layoutTemplates = __esm({
   "../mockup-engine/appstore/layoutTemplates.ts"() {
     "use strict";
@@ -2330,9 +2393,20 @@ var init_layoutTemplates = __esm({
       expressive: "the request explicitly asks to stand out \u2014 unique, creative, bold, striking, different, surprising"
     };
     LAYOUT_CHARACTER_IDS = Object.keys(LAYOUT_CHARACTER_ANSWERS);
+    LAYOUT_BLEED_EDGE_WORDS = {
+      none: "nothing about cropping or edges was asked for",
+      top: "the phone should run off the TOP, or the headline should sit underneath it",
+      bottom: "the phone should run off the BOTTOM \u2014 the ordinary store crop",
+      left: "the phone should sit to the LEFT, or run off the left edge",
+      right: "the phone should sit to the RIGHT, run off the right edge, or carry into the next screenshot",
+      "bottom-right": "the phone should run off TWO edges at once, or the request asks for the boldest possible crop"
+    };
+    LAYOUT_BLEED_EDGE_IDS = Object.keys(LAYOUT_BLEED_EDGE_WORDS);
     LAYOUT_SELECTION_CAVEATS = [
       'A request that names a composition outright ("device running off the bottom edge", "headline under the phone") beats the character.',
-      "When several templates share the right character, take the one whose reserved headline lines fit the LONGEST caption in the set. Under-reserving truncates; over-reserving leaves a visible empty band."
+      "The EDGE beats the character too, and is checked first: a request that says which way the phone should go has already chosen, whatever quality words sit around it.",
+      "When several templates share the right character AND the right edge, take the one whose reserved headline lines fit the LONGEST caption in the set. Under-reserving truncates; over-reserving leaves a visible empty band.",
+      "A side bleed is chosen for the WHOLE set or not at all. Every panel leaning the same way reads as one swipe; mirrored neighbours (lean-right beside lean-left) overlap and read as a mistake."
     ];
     valuesEqual = (a, b) => JSON.stringify(a) === JSON.stringify(b);
   }
@@ -3259,7 +3333,7 @@ function presetCaptionStyle(preset) {
   return { ...preset.caption };
 }
 function presetShotLook(preset) {
-  return { ...preset.shotLook };
+  return { ...preset.shotLook, ...preset.shotLook.angle !== void 0 ? { cameraPos: null } : {} };
 }
 function expandLookChoice(designPreset, layout) {
   const preset = designPreset === void 0 ? void 0 : designPresetById(designPreset);
@@ -6154,6 +6228,17 @@ function matchAuthoredLocale(locales, requested) {
   });
   return matches.length === 1 ? matches[0] : null;
 }
+function localesWithoutCaptions(captionText, locales, baseLocale = DEFAULT_LOCALE) {
+  return locales.filter((locale2) => {
+    if (locale2 === baseLocale) return false;
+    const inner = captionText[locale2];
+    if (!inner) return true;
+    for (const layers of Object.values(inner)) {
+      if (layers && layers.some((l) => l.text.trim().length > 0)) return false;
+    }
+    return true;
+  });
+}
 function normalizeLegacyLocales(captionText, locales) {
   const hasLegacy = Object.keys(captionText).some((c) => c in LEGACY_LOCALE_ALIASES) || (locales?.some((c) => c in LEGACY_LOCALE_ALIASES) ?? false);
   if (!hasLegacy) return { captionText, locales };
@@ -7117,8 +7202,8 @@ var init_agentCapabilities = __esm({
         studioCommands: ["addPanel"],
         wire: "structuralOperations: frame.add",
         targets: ["project"],
-        requiredInputs: ["afterFrameId (optional)"],
-        limits: ["A frame created this cycle can only be addressed in the next one, after Studio reports its id."],
+        requiredInputs: ["afterFrameId (optional)", "frameRef (optional, patch-local alias)"],
+        limits: ["Declare frameRef to address the new frame in later ordered operations of the same patch. Without frameRef, wait until the next cycle reports its id."],
         evaluationCases: ["structure-add-closing-frame"]
       },
       {
@@ -7131,7 +7216,7 @@ var init_agentCapabilities = __esm({
         targets: ["frame"],
         requiredInputs: ["frameId"],
         limits: ["The last remaining frame cannot be removed."],
-        evaluationCases: ["structure-remove-empty-frame"]
+        evaluationCases: ["structure-remove-empty-frame", "structure-remove-populated-frame"]
       },
       {
         id: "frame.reorder",
@@ -7278,7 +7363,7 @@ var init_agentCapabilities = __esm({
         domain: "caption",
         status: "supported",
         summary: "Restyle captions: font, size, colour, alignment, width and band placement.",
-        studioCommands: [],
+        studioCommands: ["patchAllCaptionStyles"],
         wire: "patch.captionStyle (strip-wide) or patch.frames[i].captionStyle (one frame)",
         targets: ["project", "frame"],
         requiredInputs: ["the style fields to change"],
@@ -7322,7 +7407,7 @@ var init_agentCapabilities = __esm({
         domain: "caption",
         status: "supported",
         summary: "Move a caption layer to another frame.",
-        studioCommands: ["moveCaptionLayerToFrame"],
+        studioCommands: ["moveCaptionLayer", "moveCaptionLayerToFrame"],
         wire: "structuralOperations: caption.move across frames",
         targets: ["caption", "frame"],
         requiredInputs: ["frameId", "the caption position", "toFrameId"],
@@ -7337,19 +7422,19 @@ var init_agentCapabilities = __esm({
         wire: null,
         targets: ["project"],
         requiredInputs: [],
-        reason: "Translation is its own metered Studio pass over the whole strip, not a refinement edit.",
+        reason: "Agent refinement cannot translate captions. Open Translate in Studio to create German or other language versions while retaining the base words.",
         evaluationCases: ["unsupported-translate-captions"]
       },
       {
         id: "caption.output-override",
         domain: "caption",
         status: "intentionally_excluded",
-        summary: "Give one output size its own caption wording.",
+        summary: "Give an output family its own caption wording.",
         studioCommands: ["patchOutputCaption", "clearOutputCaption"],
         wire: null,
         targets: ["caption"],
         requiredInputs: [],
-        reason: "Per-output wording is a manual override of the shared caption; the Agent edits the shared one.",
+        reason: "Agent refinement edits shared captions. Studio has manual output-family caption wording; both iPhone sizes share one family and cannot have separate words.",
         evaluationCases: ["unsupported-per-output-caption"]
       },
       // ── Look and backdrop ─────────────────────────────────────────────────────────────────────────
@@ -7377,18 +7462,18 @@ var init_agentCapabilities = __esm({
         wire: "patch.frames[i].background",
         targets: ["frame"],
         requiredInputs: ["the frame", "the backdrop fields"],
-        evaluationCases: ["background-frame-one-amber", "inspection-correct-frame-two-background"]
+        evaluationCases: ["background-frame-one-amber", "background-frame-three-flat-teal", "inspection-correct-frame-two-background"]
       },
       {
         id: "frame.background-reset",
         domain: "look",
         status: "intentionally_excluded",
-        summary: "Drop a frame\u2019s own backdrop so it inherits the strip again.",
-        studioCommands: ["clearPanelBackground"],
+        summary: "Drop one or all frame backdrops so they inherit the strip again.",
+        studioCommands: ["clearPanelBackground", "clearAllPanelBackgrounds"],
         wire: null,
         targets: ["frame"],
         requiredInputs: [],
-        reason: "The Agent sets backdrops; returning one frame to the strip default is a Studio control.",
+        reason: "Agent refinement cannot reset backdrop inheritance. Use the frame background reset control in Studio to return it to the strip default.",
         evaluationCases: ["unsupported-frame-background-reset"]
       },
       {
@@ -7407,13 +7492,13 @@ var init_agentCapabilities = __esm({
         id: "frame.color",
         domain: "look",
         status: "intentionally_excluded",
-        summary: "Set a frame\u2019s flat panel colour.",
+        summary: "Set the legacy per-panel colour that sits under a frame\u2019s backdrop.",
         studioCommands: ["setPanelColor"],
         wire: null,
         targets: ["frame"],
         requiredInputs: [],
-        reason: "No Studio surface dispatches it; the frame backdrop is the live control for the same result.",
-        evaluationCases: ["unsupported-frame-flat-color"]
+        reason: "No Studio surface dispatches it. A flat colour is a one-stop frame backdrop (`frame.background`), so a request for one is carried out there, never refused.",
+        evaluationCases: ["background-frame-three-flat-teal"]
       },
       {
         id: "look.design-preset",
@@ -7447,7 +7532,7 @@ var init_agentCapabilities = __esm({
         wire: null,
         targets: ["project"],
         requiredInputs: [],
-        reason: "Saved Looks are versioned styling the user owns; restoring one is a Studio control, not an edit.",
+        reason: "Agent refinement cannot restore a saved Look. Restore the saved version through Look version history in Studio.",
         evaluationCases: ["unsupported-restore-saved-look"]
       },
       // ── Output and locale axes ────────────────────────────────────────────────────────────────────
@@ -7476,29 +7561,42 @@ var init_agentCapabilities = __esm({
         evaluationCases: ["project-add-german-locale", "geometry-clear-while-adding-a-language"]
       },
       // ── Assets ────────────────────────────────────────────────────────────────────────────────────
+      // The whole-strip versions of the two asset capabilities (#880). No wire of their own: a whole-strip
+      // request is carried out as the per-device operations above, one per supplied screenshot, so the
+      // styling, captions and Output membership that hang off each device survive exactly as they do
+      // for a single swap. Asset-gated the same way — with no screenshots on the turn they ask for them.
       {
         id: "strip.add-screens",
         domain: "asset",
-        status: "requires_asset",
+        status: "supported",
         summary: "Add new screenshots to the project, each in its own frame.",
         studioCommands: ["addShots"],
-        wire: null,
+        wire: "structuralOperations: frame.add with a frameRef, then device.add into it, once per screenshot from AVAILABLE SCREENSHOTS",
         targets: ["project"],
         requiredInputs: ["one or more authorized screenshot references"],
-        reason: "New frames need new pixels. Supply the screenshots and the Agent will place them.",
-        evaluationCases: ["asset-add-screens-needs-pixels"]
+        withoutAssetReason: "New frames need new pixels. Send the screenshots with the instruction and the Agent will place them.",
+        limits: [
+          "Only screenshots listed in AVAILABLE SCREENSHOTS; the Agent never invents or generates pixels.",
+          "Each new frame starts without a caption and its device on the default look, exactly as adding screenshots in Studio does."
+        ],
+        evaluationCases: ["asset-add-screens-supplied", "asset-add-screens-needs-pixels"]
       },
       {
         id: "strip.replace-screens",
         domain: "asset",
-        status: "requires_asset",
+        status: "supported",
         summary: "Replace every screenshot in the project, keeping the styling.",
         studioCommands: ["loadScreens"],
-        wire: null,
+        wire: "structuralOperations: device.replace on every device in strip order, each naming its own assetId from AVAILABLE SCREENSHOTS",
         targets: ["project"],
         requiredInputs: ["a complete authorized screenshot set"],
-        reason: "Replacing the whole strip needs the whole new set of pixels.",
-        evaluationCases: ["asset-replace-all-screens-needs-pixels"]
+        withoutAssetReason: "Replacing the whole strip needs the whole new set of pixels. This instruction carried none.",
+        limits: [
+          "Only screenshots listed in AVAILABLE SCREENSHOTS; the Agent never invents or generates pixels.",
+          "Every device keeps its look, placement, captions, translated screens and Output membership \u2014 only the pixels change.",
+          "When the supplied screenshots do not match the devices one to one, the Agent asks which goes where instead of swapping some of them."
+        ],
+        evaluationCases: ["asset-replace-all-screens-supplied", "asset-replace-all-screens-needs-pixels", "asset-replace-all-screens-count-mismatch"]
       },
       {
         id: "locale.load-screens",
@@ -7566,8 +7664,8 @@ function validateAgentOutcome(outcome) {
   if (outcome.status === "applied_with_remaining" && !outcome.remaining) {
     problems.push("applied_with_remaining must name what is still outstanding.");
   }
-  if (outcome.question !== void 0 && outcome.status !== "needs_clarification") {
-    problems.push(`Only needs_clarification carries a question, not ${outcome.status}.`);
+  if (outcome.question !== void 0 && outcome.status !== "needs_clarification" && outcome.status !== "needs_asset") {
+    problems.push(`Only needs_clarification and needs_asset carry a question, not ${outcome.status}.`);
   }
   if (outcome.status === "needs_clarification" && !outcome.question) {
     problems.push("needs_clarification must ask exactly one focused question.");
@@ -7575,6 +7673,16 @@ function validateAgentOutcome(outcome) {
   if (outcome.capabilityId !== void 0 && !capabilityById(outcome.capabilityId)) {
     problems.push(`Outcome names capability ${JSON.stringify(outcome.capabilityId)}, which the catalog does not list.`);
   }
+  if (outcome.capabilityIds !== void 0) {
+    if (!Array.isArray(outcome.capabilityIds) || outcome.capabilityIds.length > MAX_OUTCOME_CAPABILITY_IDS) {
+      problems.push(`capabilityIds must be a list of at most ${MAX_OUTCOME_CAPABILITY_IDS} catalog ids.`);
+    } else {
+      for (const id of outcome.capabilityIds) {
+        if (typeof id !== "string" || !capabilityById(id)) problems.push(`Outcome lists capability ${JSON.stringify(id)}, which the catalog does not list.`);
+      }
+      if (new Set(outcome.capabilityIds).size !== outcome.capabilityIds.length) problems.push("capabilityIds repeats an id.");
+    }
+  }
   problems.push(...boundProblems("headline", outcome.headline, AGENT_OUTCOME_BOUNDS.headline, true));
   problems.push(...boundProblems("detail", outcome.detail, AGENT_OUTCOME_BOUNDS.detail, false));
   problems.push(...boundProblems("remaining", outcome.remaining, AGENT_OUTCOME_BOUNDS.remaining, false));
@@ -7591,6 +7699,77 @@ function boundProblems(field, value, maximum, required) {
   if (value.length > maximum) return [`${field} is ${value.length} characters, over its ${maximum} bound.`];
   return [];
 }
+function capabilitiesForPatch(patch) {
+  const ids = [];
+  if (!patch) return ids;
+  const add = (id) => {
+    if (ids.indexOf(id) < 0) ids.push(id);
+  };
+  if (patch.captions) add("caption.text");
+  if (patch.screenOrder) add("frame.reorder");
+  if (patch.designPreset) add("look.design-preset");
+  if (patch.layout) add("look.layout-template");
+  if (patch.outputs) add("output.membership");
+  if (patch.locales) add("locale.membership");
+  if (patch.shots?.some((shot) => Object.keys(shot).length > 0)) add("device.look");
+  if (patch.devices?.some((device) => Object.keys(device.patch).length > 0)) add("device.look");
+  if (patch.captionStyle && Object.keys(patch.captionStyle).length > 0) add("caption.style");
+  if (patch.background && Object.keys(patch.background).length > 0) add("strip.background");
+  patch.frames?.forEach((frame) => {
+    if (frame.captionStyle && Object.keys(frame.captionStyle).length > 0) add("caption.style");
+    if (frame.background && Object.keys(frame.background).length > 0) add("frame.background");
+  });
+  patch.captionOperations?.forEach((operation) => {
+    if (operation.operation === "add") add("caption.add");
+    else if (operation.operation === "remove") add("caption.remove");
+    else add(operation.frameId === operation.toFrameId ? "caption.reorder" : "caption.move-to-frame");
+  });
+  patch.frameOperations?.forEach((operation) => {
+    if (operation.operation === "add") add("frame.add");
+    else if (operation.operation === "remove") add("frame.remove");
+    else if (operation.operation === "move") add("frame.reorder");
+    else add("frame.split");
+  });
+  patch.structuralOperations?.forEach((operation) => add(capabilityForStructuralOperation(operation)));
+  return ids;
+}
+function capabilityForStructuralOperation(operation) {
+  switch (operation.op) {
+    case "frame.add":
+      return "frame.add";
+    case "frame.remove":
+      return "frame.remove";
+    case "frame.move":
+      return "frame.reorder";
+    case "frame.split":
+      return "frame.split";
+    case "frame.combine":
+      return "frame.combine";
+    case "frame.template-reset":
+      return "look.layout-template";
+    case "caption.add":
+      return "caption.add";
+    case "caption.remove":
+      return "caption.remove";
+    // One `caption.move` covers both Studio controls: staying inside a frame is a reorder, crossing
+    // to another is a move. The catalog names them separately because the user experiences them
+    // separately.
+    case "caption.move":
+      return operation.frameId === operation.toFrameId ? "caption.reorder" : "caption.move-to-frame";
+    case "device.move":
+      return "device.move-to-frame";
+    case "device.reorder":
+      return "device.reorder";
+    case "device.remove":
+      return "device.remove";
+    case "device.add":
+      return "device.add";
+    // The catalog names this one for what the user experiences — the pixels change, the device does
+    // not — so the id deliberately does not match the wire's `device.replace`.
+    case "device.replace":
+      return "device.replace-pixels";
+  }
+}
 function applicationOutcome(facts) {
   if (facts.conflicted) {
     return {
@@ -7620,7 +7799,13 @@ function applicationOutcome(facts) {
   }
   const gap = (facts.gaps ?? []).find((entry) => entry.kind === "asset") ?? (facts.gaps ?? []).find((entry) => entry.kind === "excluded") ?? (facts.gaps ?? []).find((entry) => entry.kind === "clarification");
   if (!gap) {
-    return { status: "applied", headline: headlineForChanges(changed), changed };
+    const layout = facts.unresolvedLayout?.trim();
+    return layout ? {
+      status: "applied_with_remaining",
+      headline: headlineForChanges(changed),
+      changed,
+      remaining: boundOutcomeText(layout, AGENT_OUTCOME_BOUNDS.remaining)
+    } : { status: "applied", headline: headlineForChanges(changed), changed };
   }
   return {
     status: "applied_with_remaining",
@@ -7654,7 +7839,14 @@ function cancelledOutcome() {
     changed: []
   };
 }
-var AGENT_OUTCOME_STATUSES, AGENT_MUTATING_STATUSES, AGENT_OUTCOME_REASONS, AGENT_OUTCOME_BOUNDS;
+function withTouchedCapabilities(outcome, touched) {
+  const ids = [];
+  for (const id of touched) if (capabilityById(id) && ids.indexOf(id) < 0) ids.push(id);
+  if (outcome.capabilityId && capabilityById(outcome.capabilityId) && ids.indexOf(outcome.capabilityId) < 0) ids.push(outcome.capabilityId);
+  if (ids.length === 0) return outcome;
+  return { ...outcome, capabilityIds: ids.slice(0, MAX_OUTCOME_CAPABILITY_IDS) };
+}
+var AGENT_OUTCOME_STATUSES, AGENT_MUTATING_STATUSES, AGENT_OUTCOME_REASONS, AGENT_OUTCOME_BOUNDS, MAX_OUTCOME_CAPABILITY_IDS;
 var init_agentOutcome = __esm({
   "../mockup-engine/appstore/agentOutcome.ts"() {
     "use strict";
@@ -7693,9 +7885,39 @@ var init_agentOutcome = __esm({
       remaining: 300,
       /** The label on the single next step. */
       nextStep: 120,
-      /** The focused question on `needs_clarification`. */
-      question: 240
+      /** Transport ceiling for a complete assistant question or screenshot request; never clip it. */
+      question: 32e3
     };
+    MAX_OUTCOME_CAPABILITY_IDS = 16;
+  }
+});
+
+// ../mockup-engine/appstore/agentUnmetActions.ts
+function normalizeIds(ids) {
+  return Array.from(new Set(ids)).sort().slice(0, MAX_UNMET_ACTIONS_PER_TURN);
+}
+function classifiedDemand(ids) {
+  return { classification: "classified", actionIds: normalizeIds(ids) };
+}
+var AGENT_UNMET_ACTION_UNKNOWN, MAX_UNMET_ACTIONS_PER_TURN, AGENT_UNMET_ACTIONS, CAPABILITY_IDS, AGENT_UNMET_ACTION_VOCABULARY, NOT_MEASURED_DEMAND;
+var init_agentUnmetActions = __esm({
+  "../mockup-engine/appstore/agentUnmetActions.ts"() {
+    "use strict";
+    init_agentCapabilities();
+    AGENT_UNMET_ACTION_UNKNOWN = "unknown";
+    MAX_UNMET_ACTIONS_PER_TURN = 8;
+    AGENT_UNMET_ACTIONS = [
+      { id: "image.generate", summary: "Generate or paint new imagery rather than arranging supplied screenshots." },
+      { id: "animation.create", summary: "Animate a screen, produce a video, or export motion instead of stills." },
+      { id: "device.unsupported-model", summary: "Use a device model ShotOps does not offer." }
+    ];
+    CAPABILITY_IDS = AGENT_CAPABILITIES.map((capability) => capability.id);
+    AGENT_UNMET_ACTION_VOCABULARY = [
+      ...CAPABILITY_IDS,
+      ...AGENT_UNMET_ACTIONS.map((action) => action.id),
+      AGENT_UNMET_ACTION_UNKNOWN
+    ];
+    NOT_MEASURED_DEMAND = { classification: "not_measured", actionIds: [] };
   }
 });
 
@@ -8164,7 +8386,7 @@ function applyFrameOperation(state, operation) {
   if (operation.operation === "add") {
     if (operation.afterFrameId !== void 0 && panelIndex(state, operation.afterFrameId) < 0) return null;
     const frameId = nextAgentPanelId(state);
-    const added = addPanel(state, frameId);
+    const added = inheritFrameTemplate(addPanel(state, frameId), frameId, operation.afterFrameId ?? state.panels[state.panels.length - 1]?.id);
     return operation.afterFrameId === void 0 ? added : movePanelAfter(added, frameId, operation.afterFrameId);
   }
   if (operation.operation === "remove") {
@@ -8187,7 +8409,17 @@ function applyFrameOperation(state, operation) {
     if (!moved) return null;
     next = moved;
   }
-  return next;
+  return inheritFrameTemplate(next, newFrameId, operation.frameId);
+}
+function inheritFrameTemplate(state, panelId, fromPanelId) {
+  const source = fromPanelId === void 0 ? void 0 : state.frameTemplates?.[fromPanelId];
+  if (!source) return state;
+  const baseline = captureFrameTemplateBaseline(
+    { shots: state.shots, captionText: state.captionText, captionSlotIds: captionSlotIds(state), baseLocale: state.baseLocale },
+    panelId,
+    source.templateId
+  );
+  return { ...state, frameTemplates: { ...state.frameTemplates ?? {}, [panelId]: baseline } };
 }
 function addCaptionLayer(state, panelId, text3, style2) {
   const source = state.captionText[state.baseLocale] ?? {};
@@ -8493,19 +8725,67 @@ function applyStructuralOperation(state, operation, assets = [], bindings) {
     }
   }
 }
+function applyMergedCaptionMove(state, merge, index, toIndex) {
+  const slot2 = merge.pending[index];
+  if (slot2 === void 0 || panelIndex(state, merge.into) < 0) return null;
+  const ids = captionSlotIds(state)[merge.into] ?? [];
+  const settled = ids.length - merge.pending.length;
+  if (settled < 0 || ids.slice(settled).some((id, offset) => id !== merge.pending[offset])) return null;
+  const to = toIndex ?? settled;
+  if (to < 0 || to > settled) return null;
+  const moved = applyCaptionOperation(state, {
+    operation: "move",
+    frameId: merge.into,
+    index: ids.indexOf(slot2),
+    toFrameId: merge.into,
+    toIndex: to
+  });
+  if (moved) merge.pending.splice(index, 1);
+  return moved;
+}
 function applyStructuralOperations(state, patch, assets = []) {
   let next = state;
   const assetBindings = [];
-  for (const operation of normalizeStructuralOperations(patch)) {
-    const applied = applyStructuralOperation(next, operation, assets, assetBindings);
+  const frameRefs = /* @__PURE__ */ new Map();
+  const retiredRefs = /* @__PURE__ */ new Set();
+  const merged = /* @__PURE__ */ new Map();
+  for (const raw of normalizeStructuralOperations(patch)) {
+    const ref = raw.op === "frame.add" ? raw.frameRef : void 0;
+    if (ref !== void 0 && (!/^[A-Za-z][A-Za-z0-9_-]{0,63}$/.test(ref) || frameRefs.has(ref) || state.panels.some((panel) => panel.id === ref) || state.shots.some((shot) => shot.id === ref))) return null;
+    if (structuralOperationTargets(raw).frameIds.some((id) => retiredRefs.has(id))) return null;
+    const resolve14 = (id) => frameRefs.get(id) ?? id;
+    const operation = {
+      ...raw,
+      ..."frameId" in raw ? { frameId: resolve14(raw.frameId) } : {},
+      ..."toFrameId" in raw ? { toFrameId: resolve14(raw.toFrameId) } : {},
+      ..."fromFrameId" in raw ? { fromFrameId: resolve14(raw.fromFrameId) } : {},
+      ..."afterFrameId" in raw && raw.afterFrameId !== void 0 ? { afterFrameId: resolve14(raw.afterFrameId) } : {}
+    };
+    const merge = operation.op === "caption.move" && panelIndex(next, operation.frameId) < 0 ? merged.get(operation.frameId) : void 0;
+    const applied = operation.op === "caption.move" && merge?.into === operation.toFrameId ? applyMergedCaptionMove(next, merge, operation.index, operation.toIndex) : applyStructuralOperation(next, operation, assets, assetBindings);
     if (!applied) return null;
+    if (operation.op === "frame.combine") {
+      const carried = captionSlotIds(next)[operation.fromFrameId]?.length ?? 0;
+      const survivor = captionSlotIds(applied)[operation.frameId] ?? [];
+      merged.set(operation.fromFrameId, { into: operation.frameId, pending: carried > 0 ? survivor.slice(-carried) : [] });
+    }
+    if (ref !== void 0) {
+      const created = applied.panels.find((panel) => !next.panels.some((previous) => previous.id === panel.id));
+      if (!created) return null;
+      frameRefs.set(ref, created.id);
+    }
+    frameRefs.forEach((id, alias) => {
+      if (!applied.panels.some((panel) => panel.id === id)) retiredRefs.add(alias);
+    });
     next = applied;
   }
-  return { state: next, assetBindings };
+  const survivingRefs = Array.from(frameRefs.entries()).filter(([alias]) => !retiredRefs.has(alias));
+  return { state: next, assetBindings, ...survivingRefs.length > 0 ? { frameRefs: Object.fromEntries(survivingRefs) } : {} };
 }
 var init_refinementStructure = __esm({
   "../mockup-engine/appstore/refinementStructure.ts"() {
     "use strict";
+    init_refineIntent();
     init_defaults();
     init_recordTransforms();
     init_shot();
@@ -8514,6 +8794,57 @@ var init_refinementStructure = __esm({
   }
 });
 
+// ../mockup-engine/appstore/templatePoseGuard.ts
+function withoutPose(entry) {
+  if (!TEMPLATE_OWNED_SHOT_FIELDS.some((field) => entry[field] !== void 0)) return null;
+  const kept = { ...entry };
+  for (const field of TEMPLATE_OWNED_SHOT_FIELDS) delete kept[field];
+  return kept;
+}
+function dropTemplatePoses(patch, templated, panelIds, panelOfDevice) {
+  if (templated.size === 0 || !patch.shots && !patch.devices) return { patch, dropped: false };
+  let dropped = false;
+  let next = patch;
+  if (patch.shots) {
+    const shots = patch.shots.map((entry, index) => {
+      const panelId = panelIds[index];
+      const kept = panelId !== void 0 && templated.has(panelId) ? withoutPose(entry) : null;
+      if (!kept) return entry;
+      dropped = true;
+      return kept;
+    });
+    if (dropped) next = { ...next, shots };
+  }
+  if (patch.devices) {
+    let devicesDropped = false;
+    const devices = [];
+    for (const entry of patch.devices) {
+      const panelId = panelOfDevice(entry.deviceId);
+      const kept = panelId !== void 0 && templated.has(panelId) ? withoutPose(entry.patch) : null;
+      if (!kept) {
+        devices.push(entry);
+        continue;
+      }
+      devicesDropped = true;
+      if (Object.keys(kept).length > 0) devices.push({ ...entry, patch: kept });
+    }
+    if (devicesDropped) {
+      dropped = true;
+      const { devices: _replaced, ...rest } = next;
+      void _replaced;
+      next = devices.length > 0 ? { ...rest, devices } : rest;
+    }
+  }
+  return { patch: next, dropped };
+}
+var TEMPLATE_OWNED_SHOT_FIELDS;
+var init_templatePoseGuard = __esm({
+  "../mockup-engine/appstore/templatePoseGuard.ts"() {
+    "use strict";
+    TEMPLATE_OWNED_SHOT_FIELDS = ["orbit", "roll", "angle", "phoneHeight", "hOffset", "vOffset"];
+  }
+});
+
 // ../mockup-engine/appstore/refinementEffect.ts
 function describeRefinementEffect(before, after) {
   const changes = [];
@@ -8525,6 +8856,17 @@ function describeRefinementEffect(before, after) {
   if (framesRemoved > 0) changes.push(`Removed ${framesRemoved} frame${framesRemoved === 1 ? "" : "s"}`);
   const beforeCaptions = before.captionText[before.baseLocale] ?? {};
   const afterCaptions = after.captionText[after.baseLocale] ?? {};
+  const beforeSlots = normalizeCaptionSlotIds(before.captionSlotIds, before.captionText, before.panels.map((panel) => panel.id));
+  const afterSlots = normalizeCaptionSlotIds(after.captionSlotIds, after.captionText, after.panels.map((panel) => panel.id));
+  const reorderOf = (panelId) => {
+    const was = beforeSlots[panelId] ?? [];
+    const now = afterSlots[panelId] ?? [];
+    if (was.length !== now.length || was.join("\0") === now.join("\0")) return null;
+    const source = now.map((id) => was.indexOf(id));
+    return source.every((index, position) => index >= 0 && source.indexOf(index) === position) ? source : null;
+  };
+  const sourceIndex = (panelId, index) => reorderOf(panelId)?.[index] ?? index;
+  let captionFramesReordered = 0;
   let rewritten = 0;
   let captionSlotsAdded = 0;
   let captionSlotsRemoved = 0;
@@ -8535,8 +8877,9 @@ function describeRefinementEffect(before, after) {
     captionSlotsAdded += Math.max(0, newLayers.length - oldLayers.length);
     captionSlotsRemoved += Math.max(0, oldLayers.length - newLayers.length);
     if (oldLayers.length !== newLayers.length) continue;
+    if (reorderOf(panelId)) captionFramesReordered += 1;
     for (let index = 0; index < oldLayers.length; index++) {
-      if (oldLayers[index].text !== newLayers[index].text) rewritten += 1;
+      if (oldLayers[sourceIndex(panelId, index)]?.text !== newLayers[index].text) rewritten += 1;
     }
   }
   const captionWordsIn = (source) => Object.entries(source).flatMap(([panelId, layers]) => layers.map((layer) => `${panelId}\0${layer.text}`));
@@ -8553,6 +8896,9 @@ function describeRefinementEffect(before, after) {
   captionSlotsAdded -= movedCaptions;
   captionSlotsRemoved -= movedCaptions;
   if (rewritten > 0) changes.push(`Rewrote ${rewritten} caption${rewritten === 1 ? "" : "s"}`);
+  if (captionFramesReordered > 0) {
+    changes.push(`Reordered the captions in ${captionFramesReordered} frame${captionFramesReordered === 1 ? "" : "s"}`);
+  }
   if (movedCaptions > 0) {
     changes.push(`Moved ${movedCaptions} caption${movedCaptions === 1 ? "" : "s"} to another frame`);
   }
@@ -8585,7 +8931,10 @@ function describeRefinementEffect(before, after) {
       const oldLayers = oldByPanel[panelId] ?? [];
       const newLayers = newByPanel[panelId] ?? [];
       if (oldLayers.length !== newLayers.length) return false;
-      return oldLayers.some((layer, index) => styleOf(layer) !== styleOf(newLayers[index]));
+      return newLayers.some((layer, index) => {
+        const prior = oldLayers[sourceIndex(panelId, index)];
+        return !prior || styleOf(prior) !== styleOf(layer);
+      });
     });
   });
   const styleByText = (source) => {
@@ -8652,6 +9001,7 @@ var init_refinementEffect = __esm({
   "../mockup-engine/appstore/refinementEffect.ts"() {
     "use strict";
     init_gradient();
+    init_frameTemplates();
     init_refinementValues();
   }
 });
@@ -8755,7 +9105,18 @@ function applyProjectRefinementWithAssets(state, patch, panelIds, assets = []) {
       next = { ...next, shots, captionText, ...overlay.background };
     }
   }
-  if (patch.layout) next = applyLayout(next, patch.layout, sourcePanelIds);
+  if (patch.layout) {
+    next = applyLayout(next, patch.layout, sourcePanelIds);
+    if (layoutTemplateById(patch.layout)) {
+      const shots = next.shots;
+      patch = dropTemplatePoses(
+        patch,
+        new Set(sourcePanelIds),
+        requestedPanelIds,
+        (deviceId) => shots.find((shot) => shot.id === deviceId)?.panelId
+      ).patch;
+    }
+  }
   if (patch.shots?.length === positionalCount) {
     const entries = new Map(requestedPanelIds.map((panelId, index) => [panelId, patch.shots[index]]));
     const shared = new Set(
@@ -8877,7 +9238,7 @@ function applyProjectRefinementWithAssets(state, patch, panelIds, assets = []) {
       next = { ...next, panels, shots: shotsInPanelOrder(next.shots, panels) };
     }
   }
-  return { state: next, assetBindings: structured.assetBindings };
+  return { state: next, assetBindings: structured.assetBindings, ...structured.frameRefs ? { frameRefs: structured.frameRefs } : {} };
 }
 var init_refinement = __esm({
   "../mockup-engine/appstore/refinement.ts"() {
@@ -8892,6 +9253,7 @@ var init_refinement = __esm({
     init_refinementStructure();
     init_refinementValues();
     init_gradient();
+    init_templatePoseGuard();
     init_refinementEffect();
     init_refinementStructure();
   }
@@ -8964,6 +9326,80 @@ var init_appStoreLocales = __esm({
   }
 });
 
+// ../mockup-engine/appstore/agentTurnRepetition.ts
+function appliedOperationOf(operation) {
+  if (!NON_REPEATABLE_OPS.has(operation.op)) return null;
+  if (operation.op === "caption.remove") return { op: operation.op, target: `${operation.frameId}#${operation.index}` };
+  if (operation.op === "device.remove") return { op: operation.op, target: operation.deviceId };
+  const target = "frameId" in operation ? operation.frameId : "toFrameId" in operation ? operation.toFrameId : "afterFrameId" in operation && operation.afterFrameId ? `after:${operation.afterFrameId}` : "strip";
+  return { op: operation.op, target };
+}
+function normalizeTarget(target, refs) {
+  if (target.startsWith("after:")) {
+    const id = target.slice(6);
+    return `after:${refs.get(id) ?? id}`;
+  }
+  const ordinal = target.indexOf("#");
+  if (ordinal >= 0) {
+    const id = target.slice(0, ordinal);
+    return `${refs.get(id) ?? id}${target.slice(ordinal)}`;
+  }
+  return refs.get(target) ?? target;
+}
+function contextualOperations(operations, resolved = {}) {
+  const refs = /* @__PURE__ */ new Map();
+  return operations.map((operation) => {
+    const applied = appliedOperationOf(operation);
+    const normalized = applied ? { ...applied, target: normalizeTarget(applied.target, refs) } : null;
+    if (operation.op === "frame.add" && operation.frameRef && normalized) {
+      refs.set(operation.frameRef, Object.prototype.hasOwnProperty.call(resolved, operation.frameRef) ? resolved[operation.frameRef] : `created-frame:${normalized.target}`);
+    }
+    return normalized;
+  });
+}
+function appliedOperationsIn(patch, frameRefs) {
+  const operations = patch.structuralOperations ?? [];
+  const symbolic = contextualOperations(operations).flatMap((applied) => applied ? [applied] : []);
+  const durable = frameRefs ? contextualOperations(operations, frameRefs).flatMap((applied) => applied ? [applied] : []) : [];
+  return symbolic.concat(durable.filter((applied) => !symbolic.some((entry) => entry.op === applied.op && entry.target === applied.target)));
+}
+function dropRepeatedOperations(patch, already) {
+  const operations = patch.structuralOperations;
+  if (!operations || operations.length === 0 || already.length === 0) return { patch, dropped: [] };
+  const seen = new Set(already.map((applied2) => `${applied2.op} ${applied2.target}`));
+  const dropped = [];
+  const applied = contextualOperations(operations);
+  const unavailableRefs = /* @__PURE__ */ new Set();
+  const kept = operations.filter((operation, index) => {
+    const entry = applied[index];
+    const dependent = structuralOperationTargets(operation).frameIds.some((id) => unavailableRefs.has(id));
+    if (!dependent && (!entry || !seen.has(`${entry.op} ${entry.target}`))) return true;
+    if (operation.op === "frame.add" && operation.frameRef) unavailableRefs.add(operation.frameRef);
+    if (entry) dropped.push(entry);
+    return false;
+  });
+  if (dropped.length === 0) return { patch, dropped };
+  const { structuralOperations: _dropped, ...rest } = patch;
+  void _dropped;
+  return { patch: kept.length > 0 ? { ...rest, structuralOperations: kept } : rest, dropped };
+}
+var NON_REPEATABLE_OPS;
+var init_agentTurnRepetition = __esm({
+  "../mockup-engine/appstore/agentTurnRepetition.ts"() {
+    "use strict";
+    init_refineIntent();
+    NON_REPEATABLE_OPS = /* @__PURE__ */ new Set([
+      "frame.add",
+      "frame.split",
+      "caption.add",
+      "device.add",
+      "frame.remove",
+      "caption.remove",
+      "device.remove"
+    ]);
+  }
+});
+
 // ../mockup-engine/appstore/agentTurnCoordinator.ts
 function phaseFor(cycle) {
   return cycle === 1 ? "applying" : cycle === 2 ? "inspecting" : "adjusting";
@@ -9008,25 +9444,38 @@ async function runAgentTurn(input, ports) {
   if (!turnId) throw new Error("Agent turn id must not be empty");
   const emit = (event) => ports.emit({ ...event, turnId });
   const now = input.now ?? (() => (/* @__PURE__ */ new Date()).toISOString());
+  const layoutRepairable = canRepairLayoutForFocus(input.focus, instruction);
   const loaded = await ports.loadProject();
   const before = loaded.state;
+  const sourceCaptions = before.panels.map((panel) => ({
+    frameId: panel.id,
+    captions: (before.captionText[before.baseLocale]?.[panel.id] ?? []).map((layer) => layer.text)
+  }));
   let working = before;
   let rendered;
+  let renderedState = null;
+  let measuredLayout = null;
   const passes = [];
   const broaderChanges = /* @__PURE__ */ new Set();
   let checkpointId = 0;
   let best = null;
   let selected = null;
   let workingAssetBindings = [];
+  const unmetActions = /* @__PURE__ */ new Set();
+  let demandClassified = false;
   let interpretation = "";
   let inspection = "";
   let remainingMismatch = null;
+  const appliedOperations = [];
+  const touchedCapabilities = /* @__PURE__ */ new Set();
+  const templatedPanels = /* @__PURE__ */ new Set();
   let terminalOutcome = null;
   let invalid2 = false;
   let cancelled = false;
   await emit({ type: "turn_started" });
   try {
     rendered = await ports.renderComposed(working, 0);
+    renderedState = working;
   } catch {
     terminalOutcome = failureOutcome(
       "service_unavailable",
@@ -9049,15 +9498,27 @@ async function runAgentTurn(input, ports) {
         focus: input.focus,
         state: working,
         rendered,
-        ...cycle > 1 ? { previous: { actualDiff: selected?.changed ?? [], inspection, cycle: cycle - 1 } } : {}
+        ...cycle > 1 ? {
+          previous: {
+            actualDiff: selected?.changed ?? [],
+            inspection,
+            cycle: cycle - 1,
+            appliedOperations: [...appliedOperations],
+            sourceCaptions: sourceCaptions.map((frame) => ({ ...frame, captions: [...frame.captions] }))
+          }
+        } : {}
       });
-    } catch {
-      terminalOutcome = failureOutcome(
+    } catch (error) {
+      terminalOutcome = error instanceof AgentTurnAuthorizationError ? error.outcome : failureOutcome(
         "service_unavailable",
         "The Agent could not complete this turn. Nothing changed."
       );
       break;
     }
+    if (authorization.demand?.classification === "classified") {
+      demandClassified = true;
+      for (const actionId of authorization.demand.actionIds) unmetActions.add(actionId);
+    }
     interpretation ||= authorization.interpretation?.trim() || instruction;
     inspection = authorization.inspection?.trim() || "Inspected the current composed result.";
     const pass = {
@@ -9085,7 +9546,22 @@ async function runAgentTurn(input, ports) {
     }
     remainingMismatch = authorization.remainingMismatch?.trim() || authorization.followUp?.trim() || null;
     for (const change of authorization.broaderChanges ?? []) broaderChanges.add(change);
+    if (authorization.patch && cycle > 1) {
+      const guarded = dropRepeatedOperations(authorization.patch, appliedOperations);
+      if (guarded.dropped.length > 0) authorization = { ...authorization, patch: guarded.patch };
+    }
+    if (authorization.patch && templatedPanels.size > 0) {
+      const shots = working.shots;
+      const guarded = dropTemplatePoses(
+        authorization.patch,
+        templatedPanels,
+        authorization.panelIds,
+        (deviceId) => shots.find((shot) => shot.id === deviceId)?.panelId
+      );
+      if (guarded.dropped) authorization = { ...authorization, patch: guarded.patch };
+    }
     if (authorization.patch) {
+      for (const id of capabilitiesForPatch(authorization.patch)) touchedCapabilities.add(id);
       const application = applyProjectRefinementWithAssets(
         working,
         authorization.patch,
@@ -9097,6 +9573,12 @@ async function runAgentTurn(input, ports) {
         break;
       }
       working = application.state;
+      if (authorization.patch.layout && layoutTemplateById(authorization.patch.layout)) {
+        for (const panelId of authorization.panelIds) {
+          if (working.panels.some((panel) => panel.id === panelId)) templatedPanels.add(panelId);
+        }
+      }
+      appliedOperations.push(...appliedOperationsIn(authorization.patch, application.frameRefs));
       workingAssetBindings = [...workingAssetBindings, ...application.assetBindings];
       checkpointId += 1;
       const checkpoint = {
@@ -9123,15 +9605,35 @@ async function runAgentTurn(input, ports) {
       });
     }
     const requiresRenderedInspection = cycle === 1 && authorization.patch != null;
-    if (authorization.complete === true && !requiresRenderedInspection) {
+    let renderedThisCycle = false;
+    let unresolvedLayout = null;
+    if (layoutRepairable && authorization.complete === true && !requiresRenderedInspection && ports.unresolvedLayout) {
+      let measurable = true;
+      if (authorization.patch != null) {
+        try {
+          rendered = await ports.renderComposed(working, cycle);
+          renderedState = working;
+          renderedThisCycle = true;
+        } catch {
+          measurable = false;
+        }
+      }
+      if (measurable) {
+        unresolvedLayout = ports.unresolvedLayout(rendered)?.trim() || null;
+        if (renderedState) measuredLayout = { state: renderedState, collision: unresolvedLayout };
+      }
+    }
+    if (authorization.complete === true && !requiresRenderedInspection && !(unresolvedLayout && cycle < AGENT_TURN_PASS_CAP)) {
       if (selected?.changed.length) best = selected;
-      remainingMismatch = null;
+      remainingMismatch = unresolvedLayout;
       break;
     }
-    if (authorization.followUp && !authorization.patch) break;
-    if (cycle < AGENT_TURN_PASS_CAP) {
+    if (unresolvedLayout) remainingMismatch = unresolvedLayout;
+    else if (authorization.followUp && !authorization.patch) break;
+    if (cycle < AGENT_TURN_PASS_CAP && !renderedThisCycle) {
       try {
         rendered = await ports.renderComposed(working, cycle);
+        renderedState = working;
       } catch {
         terminalOutcome = failureOutcome(
           "service_unavailable",
@@ -9145,11 +9647,17 @@ async function runAgentTurn(input, ports) {
   selected = best;
   const selectedState = selected?.state ?? before;
   await emit({ type: "draft_selected", checkpointId: selected?.id ?? 0, state: selectedState });
-  let outcome = terminalOutcome ?? applicationOutcome({
-    changed: selected?.changed ?? [],
-    invalid: invalid2,
-    gaps: selected?.gaps ?? []
-  });
+  let outcome = withTouchedCapabilities(
+    terminalOutcome ?? applicationOutcome({
+      changed: selected?.changed ?? [],
+      invalid: invalid2,
+      gaps: selected?.gaps ?? [],
+      // Only a measurement of the very state being committed. A collision seen on an earlier draft,
+      // or on a strip the last pass then changed without it being rendered, says nothing about this one.
+      unresolvedLayout: selected && measuredLayout?.state === selected.state ? measuredLayout.collision : null
+    }),
+    Array.from(touchedCapabilities)
+  );
   let committed = false;
   let commitData;
   if (outcome.status === "applied" || outcome.status === "applied_with_remaining") {
@@ -9166,7 +9674,10 @@ async function runAgentTurn(input, ports) {
       commitData = commit.data;
       await emit({ type: "commit_succeeded", data: commit.data, outcome });
     } else {
-      outcome = commit.reason === "stale_version" ? applicationOutcome({ changed: [], conflicted: true }) : failureOutcome("service_unavailable", "The Agent could not save this change. Nothing changed.");
+      outcome = withTouchedCapabilities(
+        commit.reason === "stale_version" ? applicationOutcome({ changed: [], conflicted: true }) : failureOutcome("service_unavailable", "The Agent could not save this change. Nothing changed."),
+        Array.from(touchedCapabilities)
+      );
       await emit({ type: "draft_rolled_back", outcome });
     }
   } else {
@@ -9200,23 +9711,37 @@ async function runAgentTurn(input, ports) {
     state: committed ? selectedState : before,
     expectedVersion: loaded.expectedVersion,
     committed,
-    ...commitData === void 0 ? {} : { commitData }
+    ...commitData === void 0 ? {} : { commitData },
+    demand: demandClassified ? classifiedDemand(unmetActions) : NOT_MEASURED_DEMAND
   };
   assertOutcome(outcome);
   await emit({ type: "turn_completed", result });
   void input.requestedCycle;
   return result;
 }
-var AGENT_TURN_PASS_CAP, EMPTY_USAGE, NO_CHANGE_SUMMARY, NEEDS_INPUT_SUMMARY, FAILED_PASS_SUMMARY;
+var AGENT_TURN_PASS_CAP, AgentTurnAuthorizationError, EMPTY_USAGE, NO_CHANGE_SUMMARY, NEEDS_INPUT_SUMMARY, FAILED_PASS_SUMMARY;
 var init_agentTurnCoordinator = __esm({
   "../mockup-engine/appstore/agentTurnCoordinator.ts"() {
     "use strict";
     init_agentOutcome();
+    init_refineIntent();
     init_refinement();
+    init_agentUnmetActions();
     init_recordTransforms();
     init_appStoreLocales();
     init_agentAssetCustody();
+    init_agentTurnRepetition();
+    init_templatePoseGuard();
+    init_layoutTemplates();
     AGENT_TURN_PASS_CAP = 3;
+    AgentTurnAuthorizationError = class extends Error {
+      constructor(outcome) {
+        super(outcome.headline);
+        this.outcome = outcome;
+        this.name = "AgentTurnAuthorizationError";
+      }
+      outcome;
+    };
     EMPTY_USAGE = {
       inputTokens: 0,
       cacheReadTokens: 0,
@@ -9263,7 +9788,9 @@ var init_agentTurnConformance = __esm({
             panelId: "p1",
             frameNodeId: "frame-1",
             frameName: "home.png",
-            bytes: new Uint8Array(),
+            // Real pixels, because a surface derives its vision list from THIS state: a shot with no
+            // bytes is a blank frame, which every door drops from the turn (#829).
+            bytes: new Uint8Array([1, 2, 3]),
             look: { ...DEFAULT_LOOK },
             thumb: null,
             thumbStale: false
@@ -9331,6 +9858,8 @@ var init_agentTurnConformance = __esm({
         outcome: {
           status: "applied",
           headline: "Restyled 1 device",
+          // #840 — every capability the drafts touched, derived from the patch, travels on the outcome.
+          capabilityIds: ["device.look"],
           changed: ["Restyled 1 device"]
         },
         stateDiff: {
@@ -9399,6 +9928,7 @@ var init_agentTurnConformance = __esm({
         outcome: {
           status: "applied",
           headline: "Replaced the screenshot on 1 device",
+          capabilityIds: ["device.replace-pixels"],
           changed: ["Replaced the screenshot on 1 device"]
         },
         stateDiff: {
@@ -9461,6 +9991,7 @@ var init_appstore = __esm({
     init_agentAssetCustody();
     init_agentCapabilities();
     init_agentOutcome();
+    init_agentUnmetActions();
     init_agentTurnCoordinator();
     init_agentTurnConformance();
     init_refinement();
@@ -10990,6 +11521,84 @@ var init_renderCredits = __esm({
   }
 });
 
+// src/render/browserInstall.ts
+import { spawn as spawnProcess } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join as join2 } from "node:path";
+function isMissingBrowserError(message) {
+  return /Executable doesn't exist at /.test(message);
+}
+function classifyInstallFailure(output2) {
+  const lines = output2.split(/\r?\n/).map((line) => line.trim()).filter((line) => line.length > 0 && !/^at /.test(line));
+  const detail = (lines[lines.length - 1] ?? "the installer exited without output").slice(0, 300);
+  return { offline: NETWORK_FAILURE.test(output2), detail };
+}
+function rendererSetupRefusal(err) {
+  if (!(err instanceof RendererSetupError)) return null;
+  if (err.offline) return errorResult(RENDERER_DOWNLOAD_OFFLINE_MESSAGE, "upstream_unavailable");
+  return errorResult(`The one-time download of the renderer (Chromium) failed: ${err.detail}`, "internal_error");
+}
+async function refuseOnRendererSetupFailure(run) {
+  try {
+    return await run();
+  } catch (err) {
+    const refusal = rendererSetupRefusal(err);
+    if (refusal) return refusal;
+    throw err;
+  }
+}
+function playwrightCliPath() {
+  const require2 = createRequire(import.meta.url);
+  return join2(dirname(require2.resolve("playwright/package.json")), "cli.js");
+}
+function installChromium(options = {}) {
+  const spawn2 = options.spawn ?? spawnProcess;
+  const log = options.log ?? ((chunk) => void process.stderr.write(chunk));
+  const execPath = options.execPath ?? process.execPath;
+  const cliPath = options.cliPath ?? playwrightCliPath();
+  return new Promise((resolve14, reject) => {
+    let output2 = "";
+    const collect = (data) => {
+      const text3 = String(data);
+      log(text3);
+      output2 = (output2 + text3).slice(-OUTPUT_TAIL_BYTES);
+    };
+    const child = spawn2(execPath, [cliPath, "install", "chromium"], {
+      env: options.env ?? process.env,
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: true
+    });
+    child.stdout?.on("data", collect);
+    child.stderr?.on("data", collect);
+    child.on("error", (err) => reject(new RendererSetupError(classifyInstallFailure(err.message))));
+    child.on("close", (code) => {
+      if (code === 0) resolve14();
+      else reject(new RendererSetupError(classifyInstallFailure(output2)));
+    });
+  });
+}
+var RENDERER_DOWNLOADED_NOTE, RENDERER_DOWNLOAD_OFFLINE_MESSAGE, NETWORK_FAILURE, RendererSetupError, OUTPUT_TAIL_BYTES;
+var init_browserInstall = __esm({
+  "src/render/browserInstall.ts"() {
+    "use strict";
+    init_toolResults();
+    RENDERER_DOWNLOADED_NOTE = "This was the first render on this machine, so ShotOps downloaded its renderer (Chromium) once before rendering; later renders skip that step.";
+    RENDERER_DOWNLOAD_OFFLINE_MESSAGE = "The first render on this machine needs a one-time download of the renderer (Chromium), and the download server could not be reached, so connect to the internet and try again.";
+    NETWORK_FAILURE = /\b(?:ENOTFOUND|EAI_AGAIN|ECONNREFUSED|ECONNRESET|ETIMEDOUT|ENETUNREACH|EHOSTUNREACH|ENETDOWN)\b|getaddrinfo|socket hang up|server closed connection|timed out after \d+ms/;
+    RendererSetupError = class extends Error {
+      offline;
+      detail;
+      constructor(failure2) {
+        super(failure2.offline ? RENDERER_DOWNLOAD_OFFLINE_MESSAGE : `renderer download failed: ${failure2.detail}`);
+        this.name = "RendererSetupError";
+        this.offline = failure2.offline;
+        this.detail = failure2.detail;
+      }
+    };
+    OUTPUT_TAIL_BYTES = 16e3;
+  }
+});
+
 // ../api/_lib/billingStore.ts
 var SUBSCRIPTION_COLUMNS;
 var init_billingStore = __esm({
@@ -11136,6 +11745,33 @@ var init_production = __esm({
   }
 });
 
+// ../product/accountRights.ts
+var ACCOUNT_TRAFFIC_CLASSES, RECORDED_TRAFFIC_CLASSES;
+var init_accountRights = __esm({
+  "../product/accountRights.ts"() {
+    "use strict";
+    ACCOUNT_TRAFFIC_CLASSES = ["customer", "owner", "benchmark"];
+    RECORDED_TRAFFIC_CLASSES = [...ACCOUNT_TRAFFIC_CLASSES, "unclassified"];
+  }
+});
+
+// ../api/_lib/authorization/accountAccess.ts
+var init_accountAccess = __esm({
+  "../api/_lib/authorization/accountAccess.ts"() {
+    "use strict";
+    init_accountRights();
+    init_supabaseRest();
+  }
+});
+
+// ../api/_lib/authorization/operatorAudit.ts
+var init_operatorAudit = __esm({
+  "../api/_lib/authorization/operatorAudit.ts"() {
+    "use strict";
+    init_supabaseRest();
+  }
+});
+
 // ../api/_lib/log.ts
 import { AsyncLocalStorage } from "node:async_hooks";
 function currentRequestId() {
@@ -11168,6 +11804,7 @@ var JWKS_TTL_MS;
 var init_supabaseAuth = __esm({
   "../api/_lib/supabaseAuth.ts"() {
     "use strict";
+    init_accountAccess();
     JWKS_TTL_MS = 10 * 60 * 1e3;
   }
 });
@@ -11214,6 +11851,8 @@ var init_polarWebhook = __esm({
 var init_billingReconcile = __esm({
   "../api/_lib/billingReconcile.ts"() {
     "use strict";
+    init_accountAccess();
+    init_operatorAudit();
     init_log();
     init_supabaseAuth();
     init_entitlement();
@@ -11224,10 +11863,62 @@ var init_billingReconcile = __esm({
   }
 });
 
+// ../api/_lib/providerUsage.ts
+var init_providerUsage = __esm({
+  "../api/_lib/providerUsage.ts"() {
+    "use strict";
+  }
+});
+
+// ../api/_lib/providerCost.ts
+var init_providerCost = __esm({
+  "../api/_lib/providerCost.ts"() {
+    "use strict";
+  }
+});
+
+// ../api/_lib/providerSpendStore.ts
+import { z as z8 } from "zod";
+var nullableCount, decimalMoney, evidenceSchema;
+var init_providerSpendStore = __esm({
+  "../api/_lib/providerSpendStore.ts"() {
+    "use strict";
+    init_providerCost();
+    init_providerUsage();
+    init_supabaseRest();
+    nullableCount = z8.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER).nullable();
+    decimalMoney = z8.string().regex(/^\d{1,19}$/).refine((n) => BigInt(n) <= 9223372036854775807n);
+    evidenceSchema = z8.object({
+      state: z8.enum(["estimated", "partial", "unknown", "not_incurred"]),
+      amountNanoUsd: decimalMoney.nullable(),
+      missing: z8.array(z8.enum(["rate", "usage", "input", "input_breakdown", "inconsistent_input", "cache_read", "cache_write", "cache_write_ttl", "output", "multiple_provider_attempts", "provider_attempts_unknown", "gateway_bill", "amount_overflow"])),
+      usage: z8.object({ inputTokens: nullableCount, cacheReadTokens: nullableCount, cacheWriteTokens: nullableCount, outputTokens: nullableCount, cacheWriteTtl: z8.enum(["5m", "1h"]).nullable() }).strict().nullable(),
+      rate: z8.object({
+        version: z8.string().regex(/^[a-zA-Z0-9._-]{1,100}$/),
+        effectiveAt: z8.string().datetime(),
+        currency: z8.literal("USD"),
+        model: z8.literal("anthropic/claude-sonnet-4.6"),
+        basis: z8.literal("gateway-list-standard"),
+        region: z8.enum(["global", "us", "eu"]),
+        nanoUsdPerMillion: z8.object({ input: decimalMoney, output: decimalMoney, cacheRead: decimalMoney, cacheWrite5m: decimalMoney, cacheWrite1h: decimalMoney }).strict(),
+        sources: z8.array(z8.enum(["https://platform.claude.com/docs/en/about-claude/pricing", "https://ai-gateway.vercel.sh/v1/models"]))
+      }).strict().nullable(),
+      gateway: z8.object({ generationId: z8.string().regex(/^gen_[a-zA-Z0-9_-]{1,100}$/).nullable(), costUsd: z8.string().regex(/^\d{1,12}(\.\d{1,18})?$/).nullable(), marketCostUsd: z8.string().regex(/^\d{1,12}(\.\d{1,18})?$/).nullable(), attempts: nullableCount, route: z8.string().regex(/^[a-zA-Z0-9_-]{1,40}$/).nullable() }).strict().nullable(),
+      noAttempt: z8.literal(true).optional()
+    }).strict().superRefine((e, context) => {
+      if ((e.state === "estimated" || e.state === "partial") && e.amountNanoUsd === null || e.state === "unknown" && e.amountNanoUsd !== null || e.state === "not_incurred" && (e.amountNanoUsd !== "0" || e.noAttempt !== true)) {
+        context.addIssue({ code: "custom", message: "inconsistent spend state" });
+      }
+    });
+  }
+});
+
 // ../api/_lib/aiGenerationStore.ts
 var init_aiGenerationStore = __esm({
   "../api/_lib/aiGenerationStore.ts"() {
     "use strict";
+    init_providerUsage();
+    init_providerSpendStore();
     init_supabaseRest();
   }
 });
@@ -11716,7 +12407,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "shotops-mcp",
-      version: "0.9.5",
+      version: "0.9.7",
       private: false,
       type: "module",
       description: "The bundle-emitting MCP server over the @engine/@sync spine. Exposes ShotOps tools to ChatGPT, Claude Code, Cursor, and CI over Streamable HTTP with OAuth or personal API tokens. Hosted and MCP tool paths never accept, store, or forward a store-signing credential; the explicit local release CLI validates the user's existing key directly with Apple and records only its path. Renders via headless Playwright Chromium, the engine's native non-browser habitat (same path as mockup-mcp). Also ships as a free LOCAL stdio server (`npx shotops-mcp`) \u2014 same render, on your own machine, no account needed.",
@@ -11753,7 +12444,8 @@ var init_package = __esm({
         prepack: "node ../scripts/third-party-notices.mjs --check",
         prepublishOnly: "npm run build",
         typecheck: "tsc --noEmit",
-        "build:widget": "node build.widget.mjs"
+        "build:widget": "node build.widget.mjs",
+        "build:mcpb": "tsx build.mcpb.ts"
       },
       dependencies: {
         "@modelcontextprotocol/sdk": "^1.29.0",
@@ -11767,7 +12459,9 @@ var init_package = __esm({
         zod: "^3.25.76"
       },
       devDependencies: {
+        "@anthropic-ai/mcpb": "2.1.2",
         "@types/express": "^5.0.6",
+        "@vercel/blob": "2.8.0",
         ai: "^7.0.48",
         esbuild: "^0.28.1",
         nitro: "3.0.260610-beta",
@@ -11917,6 +12611,15 @@ function projectCopyLocales(projectFile, locales, family = BASE_SCREEN_FAMILY) {
   }
   return out;
 }
+function projectCopyGaps(projectFile, locales, family = BASE_SCREEN_FAMILY) {
+  const file = projectFile;
+  const baseLocale = typeof file?.baseLocale === "string" && file.baseLocale ? file.baseLocale : "en-US";
+  const captionText = normalizeCaptionText(file?.captionText, file?.captionStyles, baseLocale);
+  const outputCaptions = normalizeOutputCaptionText(file?.outputCaptions);
+  const base = resolveOutputCaptionText(captionText, outputCaptions, family, baseLocale, baseLocale);
+  if (!Object.values(base).some((layers) => layers.some((layer) => layer.text.trim().length > 0))) return [];
+  return localesWithoutCaptions(captionText, [...locales], baseLocale).filter((locale2) => !Object.values(outputCaptions[family]?.[locale2] ?? {}).some((words) => words.some((word) => word.trim().length > 0))).map((locale2) => ({ code: "copy_locale_missing", subject: locale2 }));
+}
 function directCopyLocales(style2, locales) {
   const captions = style2?.captions;
   const words = [];
@@ -12132,7 +12835,7 @@ var init_productionReadiness2 = __esm({
 // src/tools/toolsRender.ts
 function handleRenderStrip(deps, args, signal) {
   const scope = openChargeScope(deps);
-  return runCharged(scope, () => renderStrip(deps, args, scope, signal));
+  return refuseOnRendererSetupFailure(() => runCharged(scope, () => renderStrip(deps, args, scope, signal)));
 }
 async function renderStrip(deps, args, scope, signal) {
   const operationId = newOperationId("render_strip");
@@ -12250,7 +12953,7 @@ async function renderStrip(deps, args, scope, signal) {
   }
   const totalBytes = result.panels.reduce((sum, p) => sum + estimateDecodedBytes(p), 0);
   const { mode: outputMode, note: outputNote } = resolveOutputMode(args.output, totalBytes, deps.forceOutput);
-  const noteWithOutput = [note, outputNote, result.layoutNote, resolutionGapNote(snapshot)].filter(Boolean).join(" ") || void 0;
+  const noteWithOutput = [note, outputNote, result.layoutNote, result.setupNote, resolutionGapNote(snapshot)].filter(Boolean).join(" ") || void 0;
   const measuredReady = requireReadiness({
     snapshot,
     surface: "render",
@@ -12747,7 +13450,7 @@ async function handleRenderProject(deps, args, signal) {
   const scope = openChargeScope(deps);
   const attempt = {};
   try {
-    return await runCharged(scope, () => renderProject(deps, args, scope, attempt, signal));
+    return await refuseOnRendererSetupFailure(() => runCharged(scope, () => renderProject(deps, args, scope, attempt, signal)));
   } finally {
     finishProductionRender(attempt.access);
   }
@@ -12975,6 +13678,7 @@ async function renderProject(deps, args, scope, attempt, signal) {
   if (outputNote) notes.push(outputNote);
   if (droppedNote) notes.push(droppedNote);
   if (result.layoutNote) notes.push(result.layoutNote);
+  if (result.setupNote) notes.push(result.setupNote);
   if (multi) {
     notes.push(
       `Rendered ${outputBlocks.length} output devices (${outputBlocks.map((o) => o.label).join(", ")}) \u2014 see \`outputs\`. The top-level panels are the active device (${active?.label}).`
@@ -13070,6 +13774,7 @@ var init_toolsRender = __esm({
     init_studioUrl();
     init_renderCredits();
     init_panelDelivery();
+    init_browserInstall();
     init_toolContract();
     init_schemas();
     init_productionOperationStart();
@@ -13388,12 +14093,12 @@ var init_recordFromStrip = __esm({
 // src/render/staticServer.ts
 import { createServer } from "node:http";
 import { readFile as readFile2 } from "node:fs/promises";
-import { extname, join as join3, relative, isAbsolute } from "node:path";
+import { extname, join as join4, relative, isAbsolute } from "node:path";
 async function startStaticServer(rootDir) {
   const server = createServer((req, res) => {
     const reqPath = decodeURIComponent((req.url ?? "/").split("?")[0]);
     const rel = reqPath === "/" ? "index.html" : reqPath.replace(/^\/+/, "");
-    const filePath = join3(rootDir, rel);
+    const filePath = join4(rootDir, rel);
     const within = relative(rootDir, filePath);
     if (within.startsWith("..") || isAbsolute(within)) {
       res.statusCode = 403;
@@ -13457,6 +14162,7 @@ var init_renderer = __esm({
     init_recordFromStrip();
     init_log();
     init_staticServer();
+    init_browserInstall();
     StripRenderer = class {
       serveMode;
       vite = null;
@@ -13472,9 +14178,14 @@ var init_renderer = __esm({
       // The harness server's URL, cached so a Chromium re-boot (#336) re-launches the browser
       // against the SAME server instead of starting a second Vite/static server per boot.
       harnessUrl = null;
+      installBrowser;
+      // #889 — the note owed to the first SUCCESSFUL render after a browser install. Kept until one
+      // succeeds, so a render that fails for an unrelated reason does not swallow it.
+      pendingSetupNote;
       // Default 'vite' so `new StripRenderer()` (server.ts) keeps the hosted path byte-for-byte.
       constructor(options = {}) {
         this.serveMode = options.serve ?? "vite";
+        this.installBrowser = options.installBrowser;
       }
       boot() {
         if (!this.booting) {
@@ -13487,8 +14198,7 @@ var init_renderer = __esm({
       }
       async doBoot() {
         if (!this.harnessUrl) this.harnessUrl = await this.startHarnessServer();
-        const { chromium } = await import("playwright");
-        this.browser = await chromium.launch({ headless: true });
+        this.browser = await this.launchBrowser();
         const page2 = await this.browser.newPage();
         page2.on("console", (m) => {
           if (/CONTEXT_LOST|Context Lost/i.test(m.text())) this.sawContextLost = true;
@@ -13497,6 +14207,24 @@ var init_renderer = __esm({
         await page2.waitForFunction(() => window.__RENDER_READY === true, { timeout: 9e4 });
         this.page = page2;
       }
+      // #889 — the install decision. Only a launch that failed because the browser binary is missing,
+      // and only on a renderer that was given an installer, downloads anything; the install's own
+      // failure (offline, most often) propagates as a RendererSetupError, which the render tools'
+      // `refuseOnRendererSetupFailure` turns into a coded refusal. `boot()` is memoized, so concurrent
+      // first renders share one download.
+      async launchBrowser() {
+        const { chromium } = await import("playwright");
+        try {
+          return await chromium.launch({ headless: true });
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          if (!this.installBrowser || !isMissingBrowserError(message)) throw err;
+          console.error("[shotops-mcp-local] Chromium is not installed \u2014 downloading the renderer once (playwright install chromium)\u2026");
+          await this.installBrowser();
+          this.pendingSetupNote = RENDERER_DOWNLOADED_NOTE;
+          return await chromium.launch({ headless: true });
+        }
+      }
       // The one line that forks between hosted and local. Everything downstream (browser launch,
       // the __RENDER_READY handshake, window.renderStrip, boot-retry, CONTEXT_LOST) is identical
       // — the page is the same harness, only its bytes come from a different server.
@@ -13573,6 +14301,11 @@ var init_renderer = __esm({
               panels: result.count ?? void 0
             });
           }
+          if (result.ok && this.pendingSetupNote) {
+            const setupNote = this.pendingSetupNote;
+            this.pendingSetupNote = void 0;
+            return { ...result, setupNote };
+          }
           return result;
         } catch (err) {
           return { ok: false, error: err instanceof Error ? err.message : String(err) };
@@ -13686,6 +14419,9 @@ function parseControlPlaneResponse(op, value) {
     case "read_project_screens":
       if (!Array.isArray(body.screens)) throw new Error("control plane response is missing screens");
       break;
+    case "read_attachment_screens":
+      if (!Array.isArray(body.screens)) throw new Error("control plane response is missing screens");
+      break;
     case "refine_project":
       if (typeof body.ok !== "boolean") throw new Error("control plane response is missing refine_project result");
       if (body.ok) {
@@ -13923,17 +14659,28 @@ function connectHostedBridge(token2) {
         ...repairFindings && repairFindings.length > 0 ? { repairFindings } : {}
       };
     },
+    async readAttachmentScreens(projectId, refs) {
+      const res = await callOp(token2, "read_attachment_screens", { project: projectId, refs: [...refs] });
+      return res.screens;
+    },
     async refineProject(input) {
       return callOp(token2, "refine_project", input);
     },
-    async refinePass(projectId, pass, turnKey) {
-      const body = JSON.stringify({ op: "refine_pass", project: projectId, turnKey, pass });
+    async refinePass(projectId, pass, turnKey, benchmark, attachments) {
+      const args = {
+        project: projectId,
+        turnKey,
+        pass,
+        ...benchmark === void 0 ? {} : { benchmark },
+        ...attachments === void 0 ? {} : { attachments }
+      };
+      const body = JSON.stringify({ op: "refine_pass", ...args });
       if (body.length > MAX_PASS_BODY_BYTES) {
         throw new Error(
           "This project has too many screenshots for one Agent pass. Refine a smaller selection, or run the Agent from ShotOps in the browser."
         );
       }
-      return callOp(token2, "refine_pass", { project: projectId, turnKey, pass });
+      return callOp(token2, "refine_pass", args);
     },
     async settleRefineTurn(projectId, settlement) {
       const res = await callOp(token2, "refine_finalize", {
@@ -14004,6 +14751,23 @@ var init_hostedBridge = __esm({
   }
 });
 
+// ../mockup-engine/layoutFindings.ts
+function describeUnresolvedLayout(findings) {
+  if (!findings || findings.length === 0) return null;
+  const frames = Array.from(new Set(findings.flatMap((finding) => finding.frames))).sort((left, right) => left - right).map((index) => `Frame ${index + 1}`);
+  const where = frames.length === 0 ? "" : frames.length === 1 ? ` in ${frames[0]}` : ` in ${frames.slice(0, -1).join(", ")} and ${frames[frames.length - 1]}`;
+  if (findings.length === 1) {
+    const what = findings[0].kind === "caption-device" ? "A caption still overlaps a device" : findings[0].kind === "caption-caption" ? "Two captions still overlap" : "Two devices still collide";
+    return `${what}${where}.`;
+  }
+  return `${findings.length} layout overlaps still remain${where}.`;
+}
+var init_layoutFindings = __esm({
+  "../mockup-engine/layoutFindings.ts"() {
+    "use strict";
+  }
+});
+
 // ../api/_lib/invalidRequest.ts
 function safeFailureDiagnostic(error) {
   const errorTypes = [];
@@ -14038,57 +14802,57 @@ var init_invalidRequest = __esm({
 });
 
 // ../api/_lib/aiShotProjection.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 var deviceHexSchema, API_AI_SHOT_PROJECTION, API_AI_SHOT_INCLUDED_ENTRIES, API_AI_SHOT_PATCH_SHAPE, apiAiShotPatchSchema, API_AI_SHOT_PROMPT_INVENTORY;
 var init_aiShotProjection = __esm({
   "../api/_lib/aiShotProjection.ts"() {
     "use strict";
     init_refineIntent();
-    deviceHexSchema = z8.string().trim().regex(/^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/);
+    deviceHexSchema = z9.string().trim().regex(/^#?([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/);
     API_AI_SHOT_PROJECTION = {
       orbit: {
         exposure: "included",
-        schema: z8.number().min(AI_SHOT_RANGES.orbit.min).max(AI_SHOT_RANGES.orbit.max).optional(),
+        schema: z9.number().min(AI_SHOT_RANGES.orbit.min).max(AI_SHOT_RANGES.orbit.max).optional(),
         prompt: `orbit: camera azimuth in degrees, ${AI_SHOT_RANGES.orbit.min} to ${AI_SHOT_RANGES.orbit.max}. 0 is straight on, negative swings the device left, positive right. Subtle is \xB15\u201320.`
       },
       roll: {
         exposure: "included",
-        schema: z8.number().min(AI_SHOT_RANGES.roll.min).max(AI_SHOT_RANGES.roll.max).optional(),
+        schema: z9.number().min(AI_SHOT_RANGES.roll.min).max(AI_SHOT_RANGES.roll.max).optional(),
         prompt: `roll: clock-hand tilt, ${AI_SHOT_RANGES.roll.min} to ${AI_SHOT_RANGES.roll.max} degrees. 0 is upright. Subtle is \xB12\u20138.`
       },
       angle: {
         exposure: "included",
-        schema: z8.enum(["front", "left", "right"]).optional(),
+        schema: z9.enum(["front", "left", "right"]).optional(),
         prompt: "angle: front | left | right \u2014 a camera PRESET. Setting it discards any orbit value on that frame, so send orbit OR angle, never both."
       },
       phoneHeight: {
         exposure: "included",
-        schema: z8.number().min(AI_SHOT_RANGES.phoneHeight.min).max(AI_SHOT_RANGES.phoneHeight.max).optional(),
+        schema: z9.number().min(AI_SHOT_RANGES.phoneHeight.min).max(AI_SHOT_RANGES.phoneHeight.max).optional(),
         prompt: `phoneHeight: ${AI_SHOT_RANGES.phoneHeight.min}\u2013${AI_SHOT_RANGES.phoneHeight.max} (% of panel height; over 100 bleeds off an edge)`
       },
       hOffset: {
         exposure: "included",
-        schema: z8.number().min(AI_SHOT_RANGES.hOffset.min).max(AI_SHOT_RANGES.hOffset.max).optional(),
+        schema: z9.number().min(AI_SHOT_RANGES.hOffset.min).max(AI_SHOT_RANGES.hOffset.max).optional(),
         prompt: `hOffset: ${AI_SHOT_RANGES.hOffset.min}\u2013${AI_SHOT_RANGES.hOffset.max} horizontal position, 0 is centred`
       },
       vOffset: {
         exposure: "included",
-        schema: z8.number().min(AI_SHOT_RANGES.vOffset.min).max(AI_SHOT_RANGES.vOffset.max).optional(),
+        schema: z9.number().min(AI_SHOT_RANGES.vOffset.min).max(AI_SHOT_RANGES.vOffset.max).optional(),
         prompt: `vOffset: ${AI_SHOT_RANGES.vOffset.min}\u2013${AI_SHOT_RANGES.vOffset.max} vertical position, 0 is centred`
       },
       material: {
         exposure: "included",
-        schema: z8.enum(["real", "clay"]).optional(),
+        schema: z9.enum(["real", "clay"]).optional(),
         prompt: `material: real | clay. colorway (real only): ${AI_COLORWAY_IDS.join(" | ")}. clayTone (clay only): ${AI_CLAY_TONES.join(" | ")}.`
       },
       colorway: {
         exposure: "included",
-        schema: z8.enum(AI_COLORWAY_IDS).optional(),
+        schema: z9.enum(AI_COLORWAY_IDS).optional(),
         prompt: `material: real | clay. colorway (real only): ${AI_COLORWAY_IDS.join(" | ")}. clayTone (clay only): ${AI_CLAY_TONES.join(" | ")}.`
       },
       clayTone: {
         exposure: "included",
-        schema: z8.enum(AI_CLAY_TONES).optional(),
+        schema: z9.enum(AI_CLAY_TONES).optional(),
         prompt: `material: real | clay. colorway (real only): ${AI_COLORWAY_IDS.join(" | ")}. clayTone (clay only): ${AI_CLAY_TONES.join(" | ")}.`
       },
       customColor: {
@@ -14103,37 +14867,37 @@ var init_aiShotProjection = __esm({
       },
       finish: {
         exposure: "included",
-        schema: z8.number().min(AI_SHOT_RANGES.finish.min).max(AI_SHOT_RANGES.finish.max).optional(),
+        schema: z9.number().min(AI_SHOT_RANGES.finish.min).max(AI_SHOT_RANGES.finish.max).optional(),
         prompt: `finish: ${AI_SHOT_RANGES.finish.min}\u2013${AI_SHOT_RANGES.finish.max} (0 matte, 1 glossy). clearcoat: ${AI_SHOT_RANGES.clearcoat.min}\u2013${AI_SHOT_RANGES.clearcoat.max} lacquer sheen on top.`
       },
       clearcoat: {
         exposure: "included",
-        schema: z8.number().min(AI_SHOT_RANGES.clearcoat.min).max(AI_SHOT_RANGES.clearcoat.max).optional(),
+        schema: z9.number().min(AI_SHOT_RANGES.clearcoat.min).max(AI_SHOT_RANGES.clearcoat.max).optional(),
         prompt: `finish: ${AI_SHOT_RANGES.finish.min}\u2013${AI_SHOT_RANGES.finish.max} (0 matte, 1 glossy). clearcoat: ${AI_SHOT_RANGES.clearcoat.min}\u2013${AI_SHOT_RANGES.clearcoat.max} lacquer sheen on top.`
       },
       flatScreen: {
         exposure: "included",
-        schema: z8.boolean().optional(),
+        schema: z9.boolean().optional(),
         prompt: "flatScreen, glare, lighting, reflections, clipToFrame: true | false."
       },
       glare: {
         exposure: "included",
-        schema: z8.boolean().optional(),
+        schema: z9.boolean().optional(),
         prompt: "flatScreen, glare, lighting, reflections, clipToFrame: true | false."
       },
       lighting: {
         exposure: "included",
-        schema: z8.boolean().optional(),
+        schema: z9.boolean().optional(),
         prompt: "flatScreen, glare, lighting, reflections, clipToFrame: true | false."
       },
       reflections: {
         exposure: "included",
-        schema: z8.boolean().optional(),
+        schema: z9.boolean().optional(),
         prompt: "flatScreen, glare, lighting, reflections, clipToFrame: true | false."
       },
       clipToFrame: {
         exposure: "included",
-        schema: z8.boolean().optional(),
+        schema: z9.boolean().optional(),
         prompt: "flatScreen, glare, lighting, reflections, clipToFrame: true | false."
       }
     };
@@ -14141,7 +14905,7 @@ var init_aiShotProjection = __esm({
     API_AI_SHOT_PATCH_SHAPE = Object.fromEntries(
       API_AI_SHOT_INCLUDED_ENTRIES.map(([field, projection]) => [field, projection.schema])
     );
-    apiAiShotPatchSchema = z8.object(API_AI_SHOT_PATCH_SHAPE);
+    apiAiShotPatchSchema = z9.object(API_AI_SHOT_PATCH_SHAPE);
     API_AI_SHOT_PROMPT_INVENTORY = [
       ...new Set(API_AI_SHOT_INCLUDED_ENTRIES.map(([, projection]) => projection.prompt))
     ];
@@ -14163,7 +14927,9 @@ var init_visionGeneration = __esm({
     LAYOUT_SELECTION_RULE = [
       "LAYOUT SELECTION",
       "- Choose the layout from the user's WORDS, not from the screenshots. A composition is a styling decision; pixels do not vote on it.",
-      "- Every layout above ends with a [character]. Pick the one whose character matches what was asked:",
+      "- Every layout above ends with a [character] and a [bleeds] edge. Read the EDGE first: if the request says which way the device should go, that settles it.",
+      ...LAYOUT_BLEED_EDGE_IDS.map((edge) => `  - bleeds [${edge}] when ${LAYOUT_BLEED_EDGE_WORDS[edge]}.`),
+      "- Otherwise pick the one whose character matches what was asked:",
       ...LAYOUT_CHARACTER_IDS.map((character) => `  - [${character}] when ${LAYOUT_CHARACTER_ANSWERS[character]}.`),
       ...LAYOUT_SELECTION_CAVEATS.map((line) => `- ${line}`)
     ].join("\n");
@@ -14171,8 +14937,8 @@ var init_visionGeneration = __esm({
 });
 
 // ../api/_lib/refineProjectContracts.ts
-import { z as z9 } from "zod";
-var localeIds, MAX_DURABLE_MODEL_PROSE, hexSchema, currentColorSchema, shotPatchSchema, aiNumberSchema, captionStylePatchSchema, MAX_WIRE_GRADIENT_STOPS, gradientStopSchema, backgroundPatchSchema, stripBackgroundPatchSchema, framePatchSchema, currentCaptionStyleSchema, currentGradientStopSchema, currentStops, currentBackgroundSchema, currentStripBackgroundSchema, currentShotSchema, currentFramePatchSchema, localeCodeSchema, focusSchema, currentFrameSchema, captionOperationSchema, frameOperationSchema, frameIdSchema, assetIdSchema, structuralOperationSchema, attachmentSchema, visionScreenshotSchema, requestSchema, legacyFinalizeSchema, durableUsageSchema, durablePassSchema, durableStateDiffSchema, agentOutcomeSchema, durableFinalizeSchema, revertSchema, finalizeSchema, createSessionSchema, historySchema, REFINE_FIELD_LABELS;
+import { z as z10 } from "zod";
+var MAX_STRIP_FRAMES, localeIds, MAX_DURABLE_MODEL_PROSE, hexSchema, currentColorSchema, shotPatchSchema, aiNumberSchema, captionStylePatchSchema, MAX_WIRE_GRADIENT_STOPS, gradientStopSchema, backgroundPatchSchema, stripBackgroundPatchSchema, framePatchSchema, currentCaptionStyleSchema, currentGradientStopSchema, currentStops, currentBackgroundSchema, currentStripBackgroundSchema, currentShotSchema, currentFramePatchSchema, localeCodeSchema, focusSchema, currentFrameSchema, captionOperationSchema, frameOperationSchema, frameIdSchema, assetIdSchema, structuralOperationSchema, attachmentSchema, refinementAttachmentsSchema, visionScreenshotSchema, requestSchema, legacyFinalizeSchema, durableUsageSchema, durablePassSchema, durableStateDiffSchema, agentOutcomeSchema, durableFinalizeSchema, revertSchema, finalizeSchema, createSessionSchema, historySchema, REFINE_FIELD_LABELS;
 var init_refineProjectContracts = __esm({
   "../api/_lib/refineProjectContracts.ts"() {
     "use strict";
@@ -14182,231 +14948,241 @@ var init_refineProjectContracts = __esm({
     init_startIntent();
     init_visionGeneration();
     init_aiShotProjection();
+    MAX_STRIP_FRAMES = 20;
     localeIds = APP_STORE_LOCALES;
     MAX_DURABLE_MODEL_PROSE = 32e3;
-    hexSchema = z9.string().trim().regex(/^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/);
-    currentColorSchema = z9.string().trim().max(64);
+    hexSchema = z10.string().trim().regex(/^#?([0-9a-fA-F]{3,4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/);
+    currentColorSchema = z10.string().trim().max(64);
     shotPatchSchema = apiAiShotPatchSchema;
-    aiNumberSchema = z9.union([z9.number().finite(), z9.object({ scale: z9.number().finite() })]);
-    captionStylePatchSchema = z9.object({
-      fontId: z9.enum(AI_CAPTION_FONT_IDS).optional(),
+    aiNumberSchema = z10.union([z10.number().finite(), z10.object({ scale: z10.number().finite() })]);
+    captionStylePatchSchema = z10.object({
+      fontId: z10.enum(AI_CAPTION_FONT_IDS).optional(),
       sizePt: aiNumberSchema.optional(),
       color: hexSchema.optional(),
-      align: z9.enum(["left", "center", "right"]).optional(),
+      align: z10.enum(["left", "center", "right"]).optional(),
       maxWidth: aiNumberSchema.optional(),
       lineHeight: aiNumberSchema.optional(),
-      band: z9.enum(["top", "bottom"]).optional(),
+      band: z10.enum(["top", "bottom"]).optional(),
       bandInset: aiNumberSchema.optional(),
       bandCenter: aiNumberSchema.optional(),
       reserveLines: aiNumberSchema.optional()
     });
     MAX_WIRE_GRADIENT_STOPS = 32;
-    gradientStopSchema = z9.object({ color: hexSchema, at: z9.number().finite() });
-    backgroundPatchSchema = z9.object({
-      stops: z9.array(gradientStopSchema).max(MAX_WIRE_GRADIENT_STOPS).optional(),
-      angle: z9.number().finite().optional()
+    gradientStopSchema = z10.object({ color: hexSchema, at: z10.number().finite() });
+    backgroundPatchSchema = z10.object({
+      stops: z10.array(gradientStopSchema).max(MAX_WIRE_GRADIENT_STOPS).optional(),
+      angle: z10.number().finite().optional()
     });
     stripBackgroundPatchSchema = backgroundPatchSchema.extend({
-      shadow: z9.boolean().optional(),
-      floorReflection: z9.boolean().optional()
+      shadow: z10.boolean().optional(),
+      floorReflection: z10.boolean().optional()
     });
-    framePatchSchema = z9.object({
+    framePatchSchema = z10.object({
       captionStyle: captionStylePatchSchema.optional(),
       background: backgroundPatchSchema.optional()
     });
     currentCaptionStyleSchema = captionStylePatchSchema.extend({
       color: currentColorSchema.optional()
     });
-    currentGradientStopSchema = z9.object({ color: currentColorSchema, at: z9.number().finite() });
-    currentStops = z9.array(currentGradientStopSchema).max(MAX_WIRE_GRADIENT_STOPS).optional();
+    currentGradientStopSchema = z10.object({ color: currentColorSchema, at: z10.number().finite() });
+    currentStops = z10.array(currentGradientStopSchema).max(MAX_WIRE_GRADIENT_STOPS).optional();
     currentBackgroundSchema = backgroundPatchSchema.extend({ stops: currentStops });
     currentStripBackgroundSchema = stripBackgroundPatchSchema.extend({ stops: currentStops });
     currentShotSchema = shotPatchSchema.extend({
       customColor: currentColorSchema.optional(),
       clayCustom: currentColorSchema.optional()
     });
-    currentFramePatchSchema = z9.object({
+    currentFramePatchSchema = z10.object({
       captionStyle: currentCaptionStyleSchema.optional(),
       background: currentBackgroundSchema.optional()
     });
-    localeCodeSchema = z9.string().trim().regex(/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$/);
-    focusSchema = z9.discriminatedUnion("kind", [
-      z9.object({ kind: z9.literal("project"), label: z9.string().trim().min(1).max(180) }),
-      z9.object({
-        kind: z9.literal("frame"),
-        frameId: z9.string().trim().min(1).max(180),
-        label: z9.string().trim().min(1).max(180)
+    localeCodeSchema = z10.string().trim().regex(/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$/);
+    focusSchema = z10.discriminatedUnion("kind", [
+      z10.object({ kind: z10.literal("project"), label: z10.string().trim().min(1).max(180) }),
+      z10.object({
+        kind: z10.literal("frame"),
+        frameId: z10.string().trim().min(1).max(180),
+        label: z10.string().trim().min(1).max(180)
       }),
-      z9.object({
-        kind: z9.literal("device"),
-        frameId: z9.string().trim().min(1).max(180),
-        deviceId: z9.string().trim().min(1).max(180),
-        label: z9.string().trim().min(1).max(180)
+      z10.object({
+        kind: z10.literal("device"),
+        frameId: z10.string().trim().min(1).max(180),
+        deviceId: z10.string().trim().min(1).max(180),
+        label: z10.string().trim().min(1).max(180)
       }),
-      z9.object({
-        kind: z9.literal("caption"),
-        frameId: z9.string().trim().min(1).max(180),
-        captionIndex: z9.number().int().min(0).max(32),
-        label: z9.string().trim().min(1).max(240)
+      z10.object({
+        kind: z10.literal("caption"),
+        frameId: z10.string().trim().min(1).max(180),
+        captionIndex: z10.number().int().min(0).max(32),
+        label: z10.string().trim().min(1).max(240)
       })
     ]);
-    currentFrameSchema = z9.object({
-      id: z9.string().trim().min(1).max(180),
-      label: z9.string().trim().min(1).max(180),
-      sourceName: z9.string().trim().min(1).max(180).nullable(),
-      devices: z9.array(z9.object({
-        id: z9.string().trim().min(1).max(180),
-        label: z9.string().trim().min(1).max(180),
+    currentFrameSchema = z10.object({
+      id: z10.string().trim().min(1).max(180),
+      label: z10.string().trim().min(1).max(180),
+      sourceName: z10.string().trim().min(1).max(180).nullable(),
+      devices: z10.array(z10.object({
+        id: z10.string().trim().min(1).max(180),
+        label: z10.string().trim().min(1).max(180),
         look: currentShotSchema
       })).max(20),
-      captions: z9.array(z9.object({
-        index: z9.number().int().min(0).max(32),
-        label: z9.string().trim().min(1).max(180),
-        text: z9.string().max(240),
+      captions: z10.array(z10.object({
+        index: z10.number().int().min(0).max(32),
+        label: z10.string().trim().min(1).max(180),
+        text: z10.string().max(240),
         style: currentCaptionStyleSchema
       })).max(32),
-      background: currentBackgroundSchema.nullable()
+      background: currentBackgroundSchema.nullable(),
+      // The per-screenshot slot this frame's pixels occupy, or null for a frame with no screenshot yet.
+      // Optional so a client that predates it still parses; the prompt then numbers by position.
+      screenshotIndex: z10.number().int().min(0).max(31).nullable().optional()
     });
-    captionOperationSchema = z9.discriminatedUnion("operation", [
-      z9.object({
-        operation: z9.literal("add"),
-        frameId: z9.string().trim().min(1).max(180),
-        afterIndex: z9.number().int().min(-1).max(32).optional(),
-        text: z9.string().trim().max(240),
+    captionOperationSchema = z10.discriminatedUnion("operation", [
+      z10.object({
+        operation: z10.literal("add"),
+        frameId: z10.string().trim().min(1).max(180),
+        afterIndex: z10.number().int().min(-1).max(32).optional(),
+        text: z10.string().trim().max(240),
         style: captionStylePatchSchema.optional()
       }),
-      z9.object({
-        operation: z9.literal("remove"),
-        frameId: z9.string().trim().min(1).max(180),
-        index: z9.number().int().min(0).max(32)
+      z10.object({
+        operation: z10.literal("remove"),
+        frameId: z10.string().trim().min(1).max(180),
+        index: z10.number().int().min(0).max(32)
       }),
-      z9.object({
-        operation: z9.literal("move"),
-        frameId: z9.string().trim().min(1).max(180),
-        index: z9.number().int().min(0).max(32),
-        toFrameId: z9.string().trim().min(1).max(180),
-        toIndex: z9.number().int().min(0).max(32).optional()
+      z10.object({
+        operation: z10.literal("move"),
+        frameId: z10.string().trim().min(1).max(180),
+        index: z10.number().int().min(0).max(32),
+        toFrameId: z10.string().trim().min(1).max(180),
+        toIndex: z10.number().int().min(0).max(32).optional()
       })
     ]);
-    frameOperationSchema = z9.discriminatedUnion("operation", [
-      z9.object({
-        operation: z9.literal("add"),
-        afterFrameId: z9.string().trim().min(1).max(180).optional()
+    frameOperationSchema = z10.discriminatedUnion("operation", [
+      z10.object({
+        operation: z10.literal("add"),
+        afterFrameId: z10.string().trim().min(1).max(180).optional()
       }),
-      z9.object({
-        operation: z9.literal("remove"),
-        frameId: z9.string().trim().min(1).max(180)
+      z10.object({
+        operation: z10.literal("remove"),
+        frameId: z10.string().trim().min(1).max(180)
       }),
-      z9.object({
-        operation: z9.literal("move"),
-        frameId: z9.string().trim().min(1).max(180),
-        afterFrameId: z9.string().trim().min(1).max(180).optional()
+      z10.object({
+        operation: z10.literal("move"),
+        frameId: z10.string().trim().min(1).max(180),
+        afterFrameId: z10.string().trim().min(1).max(180).optional()
       }),
-      z9.object({
-        operation: z9.literal("split"),
-        frameId: z9.string().trim().min(1).max(180),
-        deviceIds: z9.array(z9.string().trim().min(1).max(180)).min(1).max(20)
+      z10.object({
+        operation: z10.literal("split"),
+        frameId: z10.string().trim().min(1).max(180),
+        deviceIds: z10.array(z10.string().trim().min(1).max(180)).min(1).max(20)
       })
     ]);
-    frameIdSchema = z9.string().trim().min(1).max(180);
-    assetIdSchema = z9.string().trim().min(1).max(64).regex(/^[A-Za-z0-9][A-Za-z0-9_-]*$/);
-    structuralOperationSchema = z9.discriminatedUnion("op", [
-      z9.object({ op: z9.literal("frame.add"), afterFrameId: frameIdSchema.optional() }),
-      z9.object({ op: z9.literal("frame.remove"), frameId: frameIdSchema }),
-      z9.object({ op: z9.literal("frame.move"), frameId: frameIdSchema, afterFrameId: frameIdSchema.optional() }),
-      z9.object({
-        op: z9.literal("frame.split"),
+    frameIdSchema = z10.string().trim().min(1).max(180);
+    assetIdSchema = z10.string().trim().min(1).max(64).regex(/^[A-Za-z0-9][A-Za-z0-9_-]*$/);
+    structuralOperationSchema = z10.discriminatedUnion("op", [
+      z10.object({
+        op: z10.literal("frame.add"),
+        afterFrameId: frameIdSchema.optional(),
+        frameRef: z10.string().min(1).max(64).regex(/^[A-Za-z][A-Za-z0-9_-]*$/).describe("Patch-local frame alias, unique and different from every existing frame/device id. Later ordered operations may use it as a frame target. Never persisted.").optional()
+      }),
+      z10.object({ op: z10.literal("frame.remove"), frameId: frameIdSchema }),
+      z10.object({ op: z10.literal("frame.move"), frameId: frameIdSchema, afterFrameId: frameIdSchema.optional() }),
+      z10.object({
+        op: z10.literal("frame.split"),
         frameId: frameIdSchema,
-        deviceIds: z9.array(frameIdSchema).min(1).max(20)
+        deviceIds: z10.array(frameIdSchema).min(1).max(20)
       }),
-      z9.object({ op: z9.literal("frame.combine"), frameId: frameIdSchema, fromFrameId: frameIdSchema }),
-      z9.object({ op: z9.literal("frame.template-reset"), frameId: frameIdSchema }),
-      z9.object({
-        op: z9.literal("caption.add"),
+      z10.object({ op: z10.literal("frame.combine"), frameId: frameIdSchema, fromFrameId: frameIdSchema }),
+      z10.object({ op: z10.literal("frame.template-reset"), frameId: frameIdSchema }),
+      z10.object({
+        op: z10.literal("caption.add"),
         frameId: frameIdSchema,
-        afterIndex: z9.number().int().min(-1).max(32).optional(),
-        text: z9.string().trim().max(240),
+        afterIndex: z10.number().int().min(-1).max(32).optional(),
+        text: z10.string().trim().max(240),
         style: captionStylePatchSchema.optional()
       }),
-      z9.object({ op: z9.literal("caption.remove"), frameId: frameIdSchema, index: z9.number().int().min(0).max(32) }),
-      z9.object({
-        op: z9.literal("caption.move"),
+      z10.object({ op: z10.literal("caption.remove"), frameId: frameIdSchema, index: z10.number().int().min(0).max(32) }),
+      z10.object({
+        op: z10.literal("caption.move"),
         frameId: frameIdSchema,
-        index: z9.number().int().min(0).max(32),
+        index: z10.number().int().min(0).max(32),
         toFrameId: frameIdSchema,
-        toIndex: z9.number().int().min(0).max(32).optional()
+        toIndex: z10.number().int().min(0).max(32).optional()
       }),
-      z9.object({
-        op: z9.literal("device.move"),
+      z10.object({
+        op: z10.literal("device.move"),
         deviceId: frameIdSchema,
         toFrameId: frameIdSchema,
-        toIndex: z9.number().int().min(0).max(20).optional()
+        toIndex: z10.number().int().min(0).max(20).optional()
       }),
-      z9.object({ op: z9.literal("device.reorder"), deviceId: frameIdSchema, toIndex: z9.number().int().min(0).max(20) }),
-      z9.object({ op: z9.literal("device.remove"), deviceId: frameIdSchema }),
+      z10.object({ op: z10.literal("device.reorder"), deviceId: frameIdSchema, toIndex: z10.number().int().min(0).max(20) }),
+      z10.object({ op: z10.literal("device.remove"), deviceId: frameIdSchema }),
       // The two asset operations (#573). `assetId` is an OPAQUE per-turn handle, so the wire bounds its
       // shape and nothing more: a path, a URL or an account id is never a legal value here because the
       // handle table is the only thing that resolves one, and it holds only handles this turn minted.
-      z9.object({
-        op: z9.literal("device.add"),
+      z10.object({
+        op: z10.literal("device.add"),
         toFrameId: frameIdSchema,
         assetId: assetIdSchema,
-        toIndex: z9.number().int().min(0).max(20).optional()
+        toIndex: z10.number().int().min(0).max(20).optional()
       }),
-      z9.object({ op: z9.literal("device.replace"), deviceId: frameIdSchema, assetId: assetIdSchema })
+      z10.object({ op: z10.literal("device.replace"), deviceId: frameIdSchema, assetId: assetIdSchema })
     ]);
-    attachmentSchema = z9.object({
-      ref: z9.string().trim().min(1).max(512),
-      label: z9.string().trim().min(1).max(180),
-      width: z9.number().int().min(1).max(2e4).optional(),
-      height: z9.number().int().min(1).max(2e4).optional()
+    attachmentSchema = z10.object({
+      ref: z10.string().trim().min(1).max(512),
+      label: z10.string().trim().min(1).max(180),
+      width: z10.number().int().min(1).max(2e4).optional(),
+      height: z10.number().int().min(1).max(2e4).optional()
     });
-    visionScreenshotSchema = z9.object({
-      name: z9.string().trim().min(1).max(180),
-      mediaType: z9.enum(["image/png", "image/jpeg", "image/webp"]),
-      data: z9.string().min(16).max(MAX_VISION_IMAGE_BASE64).regex(/^[A-Za-z0-9+/]+=*$/)
+    refinementAttachmentsSchema = z10.array(attachmentSchema).max(MAX_START_SCREENSHOTS);
+    visionScreenshotSchema = z10.object({
+      name: z10.string().trim().min(1).max(180),
+      mediaType: z10.enum(["image/png", "image/jpeg", "image/webp"]),
+      data: z10.string().min(16).max(MAX_VISION_IMAGE_BASE64).regex(/^[A-Za-z0-9+/]+=*$/)
     });
-    requestSchema = z9.object({
-      projectId: z9.string().uuid(),
-      sessionId: z9.string().uuid().optional(),
-      turnId: z9.string().uuid().optional(),
-      cycle: z9.number().int().min(1).max(3).optional(),
-      instruction: z9.string().trim().min(1).max(MAX_REFINE_PROMPT_LENGTH),
+    requestSchema = z10.object({
+      projectId: z10.string().uuid(),
+      sessionId: z10.string().uuid().optional(),
+      turnId: z10.string().uuid().optional(),
+      cycle: z10.number().int().min(1).max(3).optional(),
+      instruction: z10.string().trim().min(1).max(MAX_REFINE_PROMPT_LENGTH),
       focus: focusSchema.optional(),
       baseLocale: localeCodeSchema,
-      current: z9.object({
-        captions: z9.array(z9.string().max(240)).min(1).max(MAX_START_SCREENSHOTS),
-        outputs: z9.array(z9.enum(START_OUTPUT_IDS)).min(1).max(START_OUTPUT_IDS.length),
+      current: z10.object({
+        captions: z10.array(z10.string().max(240)).min(1).max(MAX_STRIP_FRAMES),
+        outputs: z10.array(z10.enum(START_OUTPUT_IDS)).min(1).max(START_OUTPUT_IDS.length),
         // Bounded by the CATALOG, not by six. Studio's Add-language dialog offers every catalog entry
         // with no ceiling and the reducer just appends, so a seventh language used to 400 every Agent
         // turn on that project forever. A count ceiling below what the product lets a user build is a
         // lockout; this one is only here to bound the prompt.
-        locales: z9.array(localeCodeSchema).min(1).max(localeIds.length),
-        designPreset: z9.enum(START_DESIGN_PRESET_IDS).nullable(),
-        layout: z9.enum(START_LAYOUT_IDS).nullable(),
-        frames: z9.array(currentShotSchema).min(1).max(MAX_START_SCREENSHOTS),
+        locales: z10.array(localeCodeSchema).min(1).max(localeIds.length),
+        designPreset: z10.enum(START_DESIGN_PRESET_IDS).nullable(),
+        layout: z10.enum(START_LAYOUT_IDS).nullable(),
+        frames: z10.array(currentShotSchema).min(1).max(MAX_STRIP_FRAMES),
         background: currentStripBackgroundSchema.optional(),
-        frameStyles: z9.array(currentFramePatchSchema).min(1).max(MAX_START_SCREENSHOTS).optional(),
-        // Structural editing can add blank frames without adding source screenshots. Keep the vision
-        // attachment ceiling at ten while allowing those real project frames back into correction
-        // cycles instead of rejecting the first successful `add` operation on a full strip.
-        structure: z9.array(currentFrameSchema).min(1).max(20).optional()
+        frameStyles: z10.array(currentFramePatchSchema).min(1).max(MAX_STRIP_FRAMES).optional(),
+        // Structural editing can add blank frames without adding source screenshots, so this and every
+        // other per-frame array on `current` share `MAX_STRIP_FRAMES` rather than the vision-upload
+        // ceiling — a real project frame belongs back in correction cycles instead of rejecting the
+        // first successful `add`/`split` operation on a full strip (#838).
+        structure: z10.array(currentFrameSchema).min(1).max(MAX_STRIP_FRAMES).optional()
       }),
-      screenshots: z9.array(visionScreenshotSchema).min(1).max(MAX_START_SCREENSHOTS),
+      screenshots: z10.array(visionScreenshotSchema).min(1).max(MAX_STRIP_FRAMES),
       // Private refs from Studio. Opaque asset handles are derived server-side, so a client cannot
       // plant its own handle table or smuggle a ref into model-visible data.
-      attachments: z9.array(attachmentSchema).max(MAX_START_SCREENSHOTS).optional(),
+      attachments: refinementAttachmentsSchema.optional(),
       // Opaque per-turn handles, on the wire because the MCP doors mint the table where the refs are
       // (the adapter) and buy the pass somewhere else — hosted in-process, local over the control
       // plane. Carrying a descriptor is not carrying authority: `{ id, label }` names nothing outside
       // the turn that minted it, binds nothing, and the Studio door overwrites this field with its own
       // table's descriptors regardless of what a client sent. The gate that matters is the
       // authoritative write, which re-checks every ref a record introduces.
-      assets: z9.array(z9.object({
-        id: z9.string().trim().min(1).max(64),
-        label: z9.string().trim().min(1).max(180),
-        width: z9.number().int().min(1).max(2e4).optional(),
-        height: z9.number().int().min(1).max(2e4).optional()
+      assets: z10.array(z10.object({
+        id: z10.string().trim().min(1).max(64),
+        label: z10.string().trim().min(1).max(180),
+        width: z10.number().int().min(1).max(2e4).optional(),
+        height: z10.number().int().min(1).max(2e4).optional()
       })).max(MAX_START_SCREENSHOTS).optional(),
       composedPreview: visionScreenshotSchema.optional(),
       // MEASURED, never authored (#550): the client derives these from the engine's own collision
@@ -14414,17 +15190,29 @@ var init_refineProjectContracts = __esm({
       // prompt renders into prose, never a value that reaches the reducer, and a strip with an unusual
       // number of overlaps must not 400 a turn that was not about layout. The client's own ceiling is
       // `MAX_REPORTED_FINDINGS` (mockup-engine/layoutFindings.ts), well inside this.
-      layoutFindings: z9.array(z9.object({
-        kind: z9.enum(["caption-caption", "caption-device", "device-device"]),
-        frames: z9.array(z9.number().int().min(0).max(31)).min(1).max(2),
-        depthPct: z9.number().int().min(0).max(100),
-        anchored: z9.boolean(),
-        clearAtScale: z9.number().min(0.05).max(1).optional()
+      layoutFindings: z10.array(z10.object({
+        kind: z10.enum(["caption-caption", "caption-device", "device-device"]),
+        frames: z10.array(z10.number().int().min(0).max(31)).min(1).max(2),
+        depthPct: z10.number().int().min(0).max(100),
+        anchored: z10.boolean(),
+        clearAtScale: z10.number().min(0.05).max(1).optional(),
+        clearAtMaxWidth: z10.number().min(0.1).max(1).optional()
       })).max(24).optional(),
-      previous: z9.object({
-        actualDiff: z9.array(z9.string().trim().min(1).max(300)).max(24),
-        inspection: z9.string().trim().min(1).max(MAX_DURABLE_MODEL_PROSE),
-        cycle: z9.number().int().min(1).max(2)
+      previous: z10.object({
+        actualDiff: z10.array(z10.string().trim().min(1).max(300)).max(24),
+        inspection: z10.string().trim().min(1).max(MAX_DURABLE_MODEL_PROSE),
+        cycle: z10.number().int().min(1).max(2),
+        // The creating and removing structural operations earlier cycles of this turn already
+        // performed, so the prompt can list them and the model stops re-doing what it did. Optional: an
+        // older client sends none, and the coordinator drops a repeat regardless.
+        appliedOperations: z10.array(z10.object({
+          op: z10.string().trim().min(1).max(40),
+          target: z10.string().trim().min(1).max(180)
+        })).max(32).optional(),
+        sourceCaptions: z10.array(z10.object({
+          frameId: frameIdSchema,
+          captions: z10.array(z10.string().max(240)).max(32)
+        })).max(MAX_STRIP_FRAMES).optional()
       }).optional()
     }).superRefine((value, context) => {
       if (value.sessionId == null !== (value.turnId == null)) {
@@ -14454,13 +15242,13 @@ var init_refineProjectContracts = __esm({
         });
       }
     });
-    legacyFinalizeSchema = z9.object({
-      generationId: z9.string().uuid(),
-      outcome: z9.enum(["completed", "cancelled", "failed"]),
-      projectId: z9.string().uuid(),
-      instruction: z9.string().trim().min(1).max(MAX_REFINE_PROMPT_LENGTH).optional(),
-      effectSummary: z9.string().trim().min(1).max(2e3).optional(),
-      turnStatus: z9.enum(["applied", "no_change", "failed", "cancelled"]).optional()
+    legacyFinalizeSchema = z10.object({
+      generationId: z10.string().uuid(),
+      outcome: z10.enum(["completed", "cancelled", "failed"]),
+      projectId: z10.string().uuid(),
+      instruction: z10.string().trim().min(1).max(MAX_REFINE_PROMPT_LENGTH).optional(),
+      effectSummary: z10.string().trim().min(1).max(2e3).optional(),
+      turnStatus: z10.enum(["applied", "no_change", "failed", "cancelled"]).optional()
     }).superRefine((value, context) => {
       const durableFields = [value.instruction, value.effectSummary, value.turnStatus];
       const present = durableFields.filter((field) => field !== void 0).length;
@@ -14472,52 +15260,57 @@ var init_refineProjectContracts = __esm({
         });
       }
     });
-    durableUsageSchema = z9.object({
-      inputTokens: z9.number().int().min(0),
-      cacheReadTokens: z9.number().int().min(0).default(0),
-      imageTokens: z9.number().int().min(0).nullable(),
-      outputTokens: z9.number().int().min(0),
-      totalTokens: z9.number().int().min(0)
+    durableUsageSchema = z10.object({
+      inputTokens: z10.number().int().min(0),
+      cacheReadTokens: z10.number().int().min(0).default(0),
+      imageTokens: z10.number().int().min(0).nullable(),
+      outputTokens: z10.number().int().min(0),
+      totalTokens: z10.number().int().min(0)
     });
-    durablePassSchema = z9.object({
-      phase: z9.enum(["applying", "inspecting", "adjusting"]),
-      generationId: z9.string().uuid(),
-      summary: z9.string().trim().min(1).max(MAX_DURABLE_MODEL_PROSE),
+    durablePassSchema = z10.object({
+      phase: z10.enum(["applying", "inspecting", "adjusting"]),
+      generationId: z10.string().uuid(),
+      summary: z10.string().trim().min(1).max(MAX_DURABLE_MODEL_PROSE),
       usage: durableUsageSchema,
-      createdAt: z9.string().datetime()
+      createdAt: z10.string().datetime()
     });
-    durableStateDiffSchema = z9.object({
-      summary: z9.string().trim().min(1).max(2e3),
-      broaderChanges: z9.array(z9.string().trim().min(1).max(500)).max(24),
-      remainingMismatch: z9.string().trim().min(1).max(MAX_DURABLE_MODEL_PROSE).nullable()
+    durableStateDiffSchema = z10.object({
+      summary: z10.string().trim().min(1).max(2e3),
+      broaderChanges: z10.array(z10.string().trim().min(1).max(500)).max(24),
+      remainingMismatch: z10.string().trim().min(1).max(MAX_DURABLE_MODEL_PROSE).nullable()
     });
-    agentOutcomeSchema = z9.custom((value) => {
+    agentOutcomeSchema = z10.custom((value) => {
       try {
         return !!value && typeof value === "object" && validateAgentOutcome(value).length === 0;
       } catch {
         return false;
       }
     }, { message: "The Agent outcome is invalid." });
-    durableFinalizeSchema = z9.object({
-      projectId: z9.string().uuid(),
-      sessionId: z9.string().uuid(),
-      turnId: z9.string().uuid(),
+    durableFinalizeSchema = z10.object({
+      projectId: z10.string().uuid(),
+      sessionId: z10.string().uuid(),
+      turnId: z10.string().uuid(),
       // #580 — the retry / clarification chain, and the ONLY receipt fact this door takes from the
       // browser. Every other figure on the receipt is re-read server-side from the ledger or derived
       // from the validated outcome; a parent id is a correlation the client alone knows.
-      parentTurnId: z9.string().uuid().optional(),
-      generationIds: z9.array(z9.string().uuid()).min(1).max(3),
-      outcome: z9.enum(["completed", "cancelled", "failed"]),
-      committed: z9.boolean(),
-      instruction: z9.string().trim().min(1).max(MAX_REFINE_PROMPT_LENGTH),
+      parentTurnId: z10.string().uuid().optional(),
+      generationIds: z10.array(z10.string().uuid()).min(1).max(3),
+      outcome: z10.enum(["completed", "cancelled", "failed"]),
+      committed: z10.boolean(),
+      instruction: z10.string().trim().min(1).max(MAX_REFINE_PROMPT_LENGTH),
       focus: focusSchema,
-      interpretation: z9.string().trim().min(1).max(MAX_DURABLE_MODEL_PROSE),
-      passes: z9.array(durablePassSchema).min(1).max(3),
+      interpretation: z10.string().trim().min(1).max(MAX_DURABLE_MODEL_PROSE),
+      passes: z10.array(durablePassSchema).min(1).max(3),
       finalStateDiff: durableStateDiffSchema,
       agentOutcome: agentOutcomeSchema,
-      turnStatus: z9.enum(["applied", "no_change", "capped", "needs_input", "failed", "cancelled"]),
-      startedAt: z9.string().datetime(),
-      completedAt: z9.string().datetime()
+      // #781 — the coordinator's unmet-demand classification for the whole turn. Optional and
+      // deliberately loose here: it is analytics, so a malformed value must never fail a finalize that
+      // settles real money. `parseAgentTurnDemand` closes it against the vocabulary downstream, and
+      // anything it rejects becomes `not_measured` rather than a 400.
+      agentDemand: z10.unknown().optional(),
+      turnStatus: z10.enum(["applied", "no_change", "capped", "needs_input", "failed", "cancelled"]),
+      startedAt: z10.string().datetime(),
+      completedAt: z10.string().datetime()
     }).superRefine((value, context) => {
       const passGenerationIds = value.passes.map((pass) => pass.generationId);
       if (new Set(value.generationIds).size !== value.generationIds.length) {
@@ -14550,23 +15343,23 @@ var init_refineProjectContracts = __esm({
         });
       }
     });
-    revertSchema = z9.object({
-      intent: z9.literal("revert"),
-      projectId: z9.string().uuid(),
+    revertSchema = z10.object({
+      intent: z10.literal("revert"),
+      projectId: z10.string().uuid(),
       /** The committed turn being undone. Becomes the new receipt's `parent_turn_id`. */
-      turnId: z9.string().uuid(),
+      turnId: z10.string().uuid(),
       /** The revert's own turn id, minted by the browser exactly as a turn id is. */
-      revertTurnId: z9.string().uuid()
+      revertTurnId: z10.string().uuid()
     });
-    finalizeSchema = z9.union([revertSchema, durableFinalizeSchema, legacyFinalizeSchema]);
-    createSessionSchema = z9.object({
-      projectId: z9.string().uuid(),
-      sessionId: z9.string().uuid(),
-      firstInstruction: z9.string().trim().min(1).max(MAX_REFINE_PROMPT_LENGTH).optional()
+    finalizeSchema = z10.union([revertSchema, durableFinalizeSchema, legacyFinalizeSchema]);
+    createSessionSchema = z10.object({
+      projectId: z10.string().uuid(),
+      sessionId: z10.string().uuid(),
+      firstInstruction: z10.string().trim().min(1).max(MAX_REFINE_PROMPT_LENGTH).optional()
     });
-    historySchema = z9.object({
-      projectId: z9.string().uuid(),
-      sessionId: z9.string().uuid().optional()
+    historySchema = z10.object({
+      projectId: z10.string().uuid(),
+      sessionId: z10.string().uuid().optional()
     });
     REFINE_FIELD_LABELS = {
       projectId: "the project id",
@@ -14578,21 +15371,21 @@ var init_refineProjectContracts = __esm({
       baseLocale: "the base language",
       // The frame ceiling rides on all four fields it can surface through: Zod reports in declaration
       // order, so any one of them can be the fault the user actually reads.
-      "current.captions": `the caption list, one per frame and at most ${MAX_START_SCREENSHOTS}`,
+      "current.captions": `the caption list, one per frame and at most ${MAX_STRIP_FRAMES}`,
       "current.outputs": "the output size list",
       "current.locales": "the language list on this project",
       "current.designPreset": "the design preset",
       "current.layout": "the layout template",
-      "current.frames": `the per-frame device styling, at most ${MAX_START_SCREENSHOTS} frames`,
+      "current.frames": `the per-frame device styling, at most ${MAX_STRIP_FRAMES} frames`,
       "current.frames.customColor": "a custom device colour",
       "current.frames.clayCustom": "a custom clay colour",
       "current.background": "the strip background",
-      "current.frameStyles": `the per-frame caption styling, at most ${MAX_START_SCREENSHOTS} frames`,
+      "current.frameStyles": `the per-frame caption styling, at most ${MAX_STRIP_FRAMES} frames`,
       "current.frameStyles.captionStyle.color": "a caption colour",
       "current.frameStyles.background": "a frame's own background",
-      "current.structure": "the frame structure of this project",
+      "current.structure": `the frame structure of this project, at most ${MAX_STRIP_FRAMES} frames`,
       current: "the current state of this project",
-      screenshots: `the screenshot list, at most ${MAX_START_SCREENSHOTS} per Agent turn`,
+      screenshots: `the screenshot list, at most ${MAX_STRIP_FRAMES} per Agent turn`,
       attachments: `the screenshots offered to this turn, at most ${MAX_START_SCREENSHOTS}`,
       assets: `the supplied-screenshot handles for this turn, at most ${MAX_START_SCREENSHOTS}`,
       composedPreview: "the composed preview of the current strip",
@@ -14715,6 +15508,36 @@ async function compactVisionImage(data, name) {
   }
   throw new Error("A project screenshot could not be reduced for analysis.");
 }
+async function withBoundAttachments(stored, state, variant, boundAssets, assetTable, readBytes) {
+  const bound = state.shots.flatMap((shot) => {
+    const assetId = boundAssets.get(shot.id);
+    const ref = assetId ? assetTable.sources[assetId]?.ref : void 0;
+    return ref ? [{ shot, ref }] : [];
+  });
+  if (bound.length === 0) return stored;
+  const bytesByRef = await readBytes();
+  if (!bytesByRef) return stored;
+  const overlaid = /* @__PURE__ */ new Map();
+  for (const { shot, ref } of bound) {
+    const bytes = bytesByRef.get(ref);
+    if (!bytes) continue;
+    overlaid.set(shot.id, {
+      shotId: shot.id,
+      frameName: shot.frameName,
+      variant,
+      bytes: Buffer.from(bytes.buffer, bytes.byteOffset, bytes.byteLength).toString("base64"),
+      source: "supplied"
+    });
+  }
+  if (overlaid.size === 0) return stored;
+  return {
+    screenManifest: [
+      ...stored.screenManifest.filter((entry) => !overlaid.has(entry.shotId)),
+      ...overlaid.values()
+    ],
+    missing: stored.missing
+  };
+}
 async function renderedTurn(deps, state, screens) {
   const projectFile = serializeProject(state);
   const variant = projectRenderVariant(projectFile, state.baseLocale);
@@ -14728,47 +15551,55 @@ async function renderedTurn(deps, state, screens) {
   if (!rendered.ok) throw new Error("The project could not be rendered for Agent inspection.");
   const bytesByShotId = new Map(screens.screenManifest.map((entry) => [entry.shotId, entry.bytes]));
   const baseCaptions = resolveCaptionText(state.captionText, state.baseLocale, state.baseLocale);
-  const retained = await Promise.all(state.panels.flatMap((panel, frameIndex) => {
+  const hasPixels = (shot) => bytesByShotId.has(shot.id);
+  const visionScreens = await Promise.all(state.panels.flatMap((panel) => {
     const devices = state.shots.filter((shot) => shot.panelId === panel.id);
-    const representative = devices.find((shot) => bytesByShotId.has(shot.id));
+    const representative = devices.find(hasPixels);
     if (!representative) return [];
     const bytes = bytesByShotId.get(representative.id);
     const captions = baseCaptions[panel.id] ?? [];
     const background2 = aiBackgroundFromPanel(state.panelBackgrounds[panel.id]);
     return [compactVisionImage(bytes, representative.frameName).then((vision) => ({
-      screen: {
-        ...vision,
-        panelId: panel.id,
-        caption: captions[0]?.text ?? "",
-        frame: aiShotPatchFromLook(representative.look),
-        captionStyle: aiCaptionStyleFromLayer(captions[0]),
-        background: background2
-      },
-      structure: {
-        id: panel.id,
-        label: `Frame ${frameIndex + 1}`,
-        sourceName: devices[0]?.frameName ?? null,
-        devices: devices.map((shot, deviceIndex) => ({
-          id: shot.id,
-          label: devices.length === 1 ? shot.frameName : `${shot.frameName} \xB7 Device ${deviceIndex + 1}`,
-          look: aiShotPatchFromLook(shot.look)
-        })),
-        captions: captions.map((caption, index) => ({
-          index,
-          label: caption.text.trim() || `Caption ${index + 1}`,
-          text: caption.text,
-          style: aiCaptionStyleFromLayer(caption)
-        })),
-        background: background2
-      }
+      ...vision,
+      panelId: panel.id,
+      caption: captions[0]?.text ?? "",
+      frame: aiShotPatchFromLook(representative.look),
+      captionStyle: aiCaptionStyleFromLayer(captions[0]),
+      background: background2
     }))];
   }));
-  if (retained.length === 0) throw new Error("The project has no readable screenshots for Agent inspection.");
+  let nextScreenshot = 0;
+  const structure = state.panels.map((panel, frameIndex) => {
+    const devices = state.shots.filter((shot) => shot.panelId === panel.id);
+    const captions = baseCaptions[panel.id] ?? [];
+    const background2 = aiBackgroundFromPanel(state.panelBackgrounds[panel.id]);
+    const screenshotIndex = devices.some(hasPixels) ? nextScreenshot++ : null;
+    return {
+      id: panel.id,
+      label: `Frame ${frameIndex + 1}`,
+      sourceName: devices[0]?.frameName ?? null,
+      devices: devices.map((shot, deviceIndex) => ({
+        id: shot.id,
+        label: devices.length === 1 ? shot.frameName : `${shot.frameName} \xB7 Device ${deviceIndex + 1}`,
+        look: aiShotPatchFromLook(shot.look)
+      })),
+      captions: captions.map((caption, index) => ({
+        index,
+        label: caption.text.trim() || `Caption ${index + 1}`,
+        text: caption.text,
+        style: aiCaptionStyleFromLayer(caption)
+      })),
+      background: background2,
+      screenshotIndex
+    };
+  });
+  if (visionScreens.length === 0) throw new Error("The project has no readable screenshots for Agent inspection.");
+  const layoutFindings = rendered.layout?.findings ?? (rendered.layoutMeasured ? [] : void 0);
   return {
-    screens: retained.map((item) => item.screen),
-    structure: retained.map((item) => item.structure),
+    screens: visionScreens,
+    structure,
     ...rendered.stripBase64 ? { composedPreview: await compactVisionImage(rendered.stripBase64, "shotops-composed-preview.png") } : {},
-    ...rendered.layout?.findings ? { layoutFindings: rendered.layout.findings } : {}
+    ...layoutFindings !== void 0 ? { layoutFindings } : {}
   };
 }
 function outsideFocus(patch, focus, rendered) {
@@ -14841,11 +15672,14 @@ function requestForPass(context, input) {
     // planner pass carries about a supplied screenshot has to be meaningless outside this turn.
     ...context.assets.length > 0 ? { assets: context.assets.map((asset) => ({ ...asset })) } : {},
     ...input.rendered.composedPreview ? { composedPreview: input.rendered.composedPreview } : {},
-    ...input.rendered.layoutFindings ? { layoutFindings: input.rendered.layoutFindings } : {},
+    // #827 — `!== undefined`, not truthiness: a measured-clean render's `layoutFindings` is `[]`,
+    // which must still reach the planner (it is what says "measured, nothing wrong").
+    ...input.rendered.layoutFindings !== void 0 ? { layoutFindings: input.rendered.layoutFindings } : {},
     ...input.previous ? {
       previous: {
         ...input.previous,
-        actualDiff: [...input.previous.actualDiff]
+        actualDiff: [...input.previous.actualDiff],
+        ...input.previous.appliedOperations ? { appliedOperations: [...input.previous.appliedOperations] } : {}
       }
     } : {}
   });
@@ -14866,7 +15700,9 @@ function generatedAuthorization(request, generated, generationId, panelIds, rend
     ...generated.followUp ? { followUp: generated.followUp } : {},
     ...patch ? { patch, broaderChanges: outsideFocus(patch, request.focus ?? contextFocus(), rendered) } : {},
     ...generated.outcome ? { terminalOutcome: generated.outcome } : {},
-    ...generated.gaps ? { gaps: generated.gaps } : {}
+    ...generated.gaps ? { gaps: generated.gaps } : {},
+    // #781 — the same intent that decided the outcome, reported as this pass's unmet demand.
+    ...generated.demand ? { demand: generated.demand } : {}
   };
 }
 function contextFocus() {
@@ -14877,7 +15713,7 @@ function applyAllowance(allowance, pass) {
 }
 async function authorizePass(context, request, panelIds, rendered) {
   context.screenshotCount = request.screenshots.length + (request.composedPreview ? 1 : 0);
-  const result = await context.runtime.plannerPass(context.userId, request, context.turnKey);
+  const result = await context.runtime.plannerPass(context.userId, request, context.turnKey, context.assetTable);
   applyAllowance(context.allowance, result.allowance);
   if (result.ok) {
     return generatedAuthorization(request, result.plan, result.generationId, panelIds, rendered);
@@ -14925,6 +15761,16 @@ async function runMcpProjectAgentTurn(deps, input, runtime) {
   const allowance = { remaining: null, refunded: 0, settled: false };
   let storedRecord;
   let screenSources = null;
+  let boundAssets = /* @__PURE__ */ new Map();
+  let attachmentBytes = null;
+  const readAttachmentBytes = () => {
+    if (!runtime.readAttachments) return Promise.resolve(null);
+    attachmentBytes ??= runtime.readAttachments(project2.id, attachments.map((attachment) => attachment.ref)).catch((error) => {
+      runtime.log("mcp_agent_turn_attachment_read_failed", { turnKey, ...safeFailureDiagnostic(error) });
+      return null;
+    });
+    return attachmentBytes;
+  };
   const context = {
     userId: deps.userId,
     projectId: project2.id,
@@ -14934,7 +15780,8 @@ async function runMcpProjectAgentTurn(deps, input, runtime) {
     focus: input.focus,
     allowance,
     runtime,
-    assets: assetTable.descriptors
+    assets: assetTable.descriptors,
+    assetTable
   };
   const result = await runAgentTurn({
     turnId,
@@ -14965,12 +15812,14 @@ async function runMcpProjectAgentTurn(deps, input, runtime) {
     renderComposed: async (state) => {
       if (!screenSources || "error" in screenSources) throw new Error("The project screenshots are unavailable.");
       const variant = projectRenderVariant(serializeProject(state), state.baseLocale);
-      const resolved = await screenSources.resolve(variant);
-      if (screenSources.expected.length > 0 && resolved.screenManifest.length === 0) {
+      const stored = await screenSources.resolve(variant);
+      if (screenSources.expected.length > 0 && stored.screenManifest.length === 0 && boundAssets.size === 0) {
         throw new Error("The project has no readable screenshots for Agent inspection.");
       }
+      const resolved = await withBoundAttachments(stored, state, variant, boundAssets, assetTable, readAttachmentBytes);
       return renderedTurn(deps, state, resolved);
     },
+    unresolvedLayout: (rendered) => describeUnresolvedLayout(rendered.layoutFindings),
     authorize: async ({ cycle, state, rendered, previous }) => {
       const request = requestForPass(context, { cycle, state, rendered, previous });
       const authorization = await authorizePass(
@@ -15006,6 +15855,9 @@ async function runMcpProjectAgentTurn(deps, input, runtime) {
       return write.error === "conflict" ? { ok: false, reason: "stale_version" } : { ok: false, reason: "write_failed" };
     },
     emit: async (event) => {
+      if (event.type === "draft_applied") {
+        boundAssets = new Map(event.assetBindings.map((binding) => [binding.deviceId, binding.assetId]));
+      }
       if (event.type === "turn_completed") {
         const generationIds = event.result.legacy.passes.map((pass) => pass.generationId);
         if (generationIds.length > 0) {
@@ -15023,7 +15875,8 @@ async function runMcpProjectAgentTurn(deps, input, runtime) {
                 startedAt,
                 completedAt: (/* @__PURE__ */ new Date()).toISOString(),
                 screenshotCount: context.screenshotCount,
-                instructionLength: input.instruction.length
+                instructionLength: input.instruction.length,
+                demand: event.result.demand
               }
             });
             allowance.remaining = settlement.balanceCredits;
@@ -15051,7 +15904,8 @@ async function runMcpProjectAgentTurn(deps, input, runtime) {
             startedAt,
             completedAt: (/* @__PURE__ */ new Date()).toISOString(),
             screenshotCount: context.screenshotCount,
-            instructionLength: input.instruction.length
+            instructionLength: input.instruction.length,
+            demand: event.result.demand
           });
         } catch (error) {
           runtime.log("mcp_agent_turn_receipt_failed", { turnKey, ...safeFailureDiagnostic(error) });
@@ -15070,6 +15924,7 @@ var init_agentTurnAdapter = __esm({
     init_agentOutcome();
     init_projectRecord();
     init_gradient();
+    init_layoutFindings();
     init_capabilities();
     init_invalidRequest();
     init_refineProjectContracts();
@@ -15102,7 +15957,16 @@ function writeErrorFrom(error) {
 }
 function localAgentTurnRuntime(bridge) {
   return {
-    plannerPass: (_userId, request, turnKey) => bridge.refinePass(request.projectId, request, turnKey),
+    plannerPass: (_userId, request, turnKey, assetTable) => bridge.refinePass(
+      request.projectId,
+      request,
+      turnKey,
+      void 0,
+      assetTable.descriptors.map(({ id }) => {
+        const { ref, label, width, height } = assetTable.sources[id];
+        return { ref, label, ...width ? { width } : {}, ...height ? { height } : {} };
+      })
+    ),
     // The receipt facts travel WITH settlement (#580): the server writes the one receipt for this
     // turn, keyed by the id the local coordinator ran under, and this machine — which holds no
     // Supabase credential — writes nothing durable at all.
@@ -15122,10 +15986,17 @@ function localAgentTurnRuntime(bridge) {
           startedAt: input.startedAt,
           completedAt: input.completedAt,
           screenshotCount: input.screenshotCount ?? 0,
-          instructionLength: input.instructionLength ?? 0
+          instructionLength: input.instructionLength ?? 0,
+          demand: input.demand ?? NOT_MEASURED_DEMAND
         }
       });
     },
+    // #882 — the inspection render's pixels for devices a draft added or re-pointed. The control
+    // plane authorizes and signs; the bytes come down here, where the render runs.
+    readAttachments: async (projectId, refs) => {
+      const screens = await bridge.readAttachmentScreens(projectId, refs);
+      return new Map(await Promise.all(screens.map(async ({ ref, url }) => [ref, new Uint8Array(await downloadPng(url, "Supplied screenshot"))])));
+    },
     writeProjectRecord: async (projectId, expectedVersion, record8) => {
       try {
         const written = await bridge.updateProjectRecord(projectId, record8, expectedVersion);
@@ -15138,7 +16009,7 @@ function localAgentTurnRuntime(bridge) {
     log: (event, fields2) => logEvent("error", event, fields2)
   };
 }
-async function runLocalRefineTurn(deps, bridge, input) {
+async function runLocalRefineTurn(deps, bridge, input, runtimeOverrides) {
   try {
     const turn = await runMcpProjectAgentTurn(
       deps,
@@ -15148,7 +16019,7 @@ async function runLocalRefineTurn(deps, bridge, input) {
         ...input.project ? { project: input.project } : {},
         ...input.attachments?.length ? { attachments: input.attachments } : {}
       },
-      localAgentTurnRuntime(bridge)
+      runtimeOverrides ? { ...localAgentTurnRuntime(bridge), ...runtimeOverrides } : localAgentTurnRuntime(bridge)
     );
     return refineProjectResult(turn);
   } catch {
@@ -15159,9 +16030,11 @@ var init_localRefineTurn = __esm({
   "src/project/localRefineTurn.ts"() {
     "use strict";
     init_log();
+    init_agentUnmetActions();
     init_agentTurnAdapter();
     init_hostedBridge();
     init_refineProjectReceipt();
+    init_uploads();
   }
 });
 
@@ -15307,9 +16180,10 @@ var init_projectClaimClient = __esm({
 
 // src/runtime/localDeps.ts
 import { readFile as readFile4 } from "node:fs/promises";
-function localToolDeps(token2) {
+function localToolDeps(token2, options = {}) {
   const base = {
-    renderer: new StripRenderer({ serve: "static" }),
+    // #889 — the first render on a machine with no Playwright Chromium downloads it once, here only.
+    renderer: new StripRenderer({ serve: "static", installBrowser: () => installChromium() }),
     // Token-backed cloud writes cross the same authority in the control plane. This local handler
     // stays permissive to avoid a second billing lookup; tokenless holds fail at persistence.
     authorizeCapability: async (request) => ({
@@ -15372,7 +16246,7 @@ function localToolDeps(token2) {
       }
     };
   }
-  const bridge = connectHostedBridge(token2);
+  const bridge = options.decorateBridge ? options.decorateBridge(connectHostedBridge(token2)) : connectHostedBridge(token2);
   const bridged = {
     ...base,
     resolveProject: (userId, projectId) => bridge.resolveProject(userId, projectId),
@@ -15413,7 +16287,7 @@ function localToolDeps(token2) {
       await bridge.close();
     }
   };
-  bridged.refineProject = (userId, input) => runLocalRefineTurn({ ...bridged, userId }, bridge, input);
+  bridged.refineProject = (userId, input) => runLocalRefineTurn({ ...bridged, userId }, bridge, input, options.emit ? { emit: options.emit } : void 0);
   return bridged;
 }
 async function pushScreens(bridge, projectId, record8, recordVersion, screenshots2) {
@@ -15499,6 +16373,7 @@ var init_localDeps = __esm({
     "use strict";
     init_env();
     init_renderer();
+    init_browserInstall();
     init_hostedBridge();
     init_localRefineTurn();
     init_projectClaimClient();
@@ -15524,10 +16399,10 @@ __export(localCredentials_exports, {
 });
 import { chmod, mkdir, readFile as readFile5, rename, unlink, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { dirname, join as join4 } from "node:path";
+import { dirname as dirname2, join as join5 } from "node:path";
 function credentialsPath() {
-  const dir = process.env.SHOTOPS_CONFIG_DIR || join4(homedir(), ".shotops");
-  return join4(dir, "credentials.json");
+  const dir = process.env.SHOTOPS_CONFIG_DIR || join5(homedir(), ".shotops");
+  return join5(dir, "credentials.json");
 }
 async function readFileJson() {
   let raw;
@@ -15546,7 +16421,7 @@ async function readFileJson() {
 }
 async function writeFileJson(next) {
   const target = credentialsPath();
-  await mkdir(dirname(target), { recursive: true, mode: 448 });
+  await mkdir(dirname2(target), { recursive: true, mode: 448 });
   const tmp = `${target}.${process.pid}.tmp`;
   await writeFile(tmp, `${JSON.stringify(next, null, 2)}
 `, { mode: 384 });
@@ -16041,7 +16916,7 @@ var init_releaseCommitments = __esm({
 import { execFile } from "node:child_process";
 import { mkdtemp, open, readFile as readFile6, readdir, rm, stat, writeFile as writeFile2 } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { extname as extname2, join as join5, resolve } from "node:path";
+import { extname as extname2, join as join6, resolve } from "node:path";
 import { inflateSync } from "fflate";
 async function readAt(path, offset, length) {
   const handle = await open(path, "r");
@@ -16122,8 +16997,8 @@ function plistStringArray(xml, key) {
 }
 async function parsePlist(bytes, source, runner) {
   if (bytes.subarray(0, 8).toString() === "bplist00") {
-    const scratch = await mkdtemp(join5(tmpdir(), "shotops-plist-"));
-    const path = join5(scratch, "Info.plist");
+    const scratch = await mkdtemp(join6(tmpdir(), "shotops-plist-"));
+    const path = join6(scratch, "Info.plist");
     try {
       await writeFile2(path, bytes, { mode: 384 });
       const json = await runner("plutil", ["-convert", "json", "-o", "-", path]);
@@ -16181,10 +17056,10 @@ async function findInfoPlists(root, path = root, found = []) {
   const entries = await readdir(path, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.isSymbolicLink()) continue;
-    const child = join5(path, entry.name);
+    const child = join6(path, entry.name);
     if (entry.isDirectory()) {
       if (entry.name.endsWith(".app")) {
-        const candidate = join5(child, "Contents", "Info.plist");
+        const candidate = join6(child, "Contents", "Info.plist");
         if ((await stat(candidate).catch(() => null))?.isFile()) found.push(candidate);
       }
       await findInfoPlists(root, child, found);
@@ -16199,8 +17074,8 @@ async function inspectPkg(path, runner) {
   if (!/status:\s*signed|signed by/i.test(signature.toString("utf8")) || /no signature|unsigned/i.test(signature.toString("utf8"))) {
     throw new Error("PKG is unsigned or pkgutil could not verify its signature");
   }
-  const scratch = await mkdtemp(join5(tmpdir(), "shotops-pkg-"));
-  const expanded = join5(scratch, "expanded");
+  const scratch = await mkdtemp(join6(tmpdir(), "shotops-pkg-"));
+  const expanded = join6(scratch, "expanded");
   try {
     await runner("pkgutil", ["--expand-full", path, expanded]).catch(() => {
       throw new Error("PKG is not a supported flat package (pkgutil --expand-full failed)");
@@ -16261,7 +17136,7 @@ var init_releaseBuild = __esm({
 
 // src/release/desiredReleaseSchema.ts
 import { readFile as readFile7 } from "node:fs/promises";
-import { join as join6 } from "node:path";
+import { join as join7 } from "node:path";
 function blobPath(digestValue) {
   if (!SHA256.test(digestValue)) throw new Error(`not a SHA-256 digest: ${digestValue}`);
   return `blobs/${digestValue.slice(0, 2)}/${digestValue}`;
@@ -16857,7 +17732,7 @@ function parseCanonicalJson(text3, path) {
   return value;
 }
 async function readDesiredReleaseManifest(workspace) {
-  const path = join6(workspace, DESIRED_RELEASE_FILENAME);
+  const path = join7(workspace, DESIRED_RELEASE_FILENAME);
   let text3;
   try {
     text3 = await readFile7(path, "utf8");
@@ -16890,7 +17765,7 @@ function inspectDesiredReleaseValue(value) {
   };
 }
 async function inspectDesiredReleaseWorkspace(workspace) {
-  const path = join6(workspace, DESIRED_RELEASE_FILENAME);
+  const path = join7(workspace, DESIRED_RELEASE_FILENAME);
   let text3;
   try {
     text3 = await readFile7(path, "utf8");
@@ -17015,7 +17890,7 @@ var init_desiredReleaseSchema = __esm({
 
 // src/release/releaseRepository.ts
 import { lstat as lstat2, readFile as readFile8, readdir as readdir2, stat as stat2 } from "node:fs/promises";
-import { basename as basename2, extname as extname3, isAbsolute as isAbsolute3, join as join7, resolve as resolve2 } from "node:path";
+import { basename as basename2, extname as extname3, isAbsolute as isAbsolute3, join as join8, resolve as resolve2 } from "node:path";
 async function readSmallText(path, label) {
   const { size } = await regularFile(path, label);
   if (size > MAX_TEXT_BYTES) throw new Error(`${label} exceeds ${MAX_TEXT_BYTES} bytes: ${path}`);
@@ -17038,11 +17913,11 @@ async function readFieldDirectory(root, path, allowed, label) {
   const entries = await readdir2(path, { withFileTypes: true });
   for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
     if (!entry.isFile() || entry.isSymbolicLink() || extname3(entry.name) !== ".txt") {
-      throw new Error(`unknown ${label} input: ${sourcePath(root, join7(path, entry.name))}`);
+      throw new Error(`unknown ${label} input: ${sourcePath(root, join8(path, entry.name))}`);
     }
     const key = basename2(entry.name, ".txt");
-    if (!allowed.has(key)) throw new Error(`unknown ${label} field: ${sourcePath(root, join7(path, entry.name))}`);
-    fields2[key] = await textValue(root, join7(path, entry.name), `${label} field`);
+    if (!allowed.has(key)) throw new Error(`unknown ${label} field: ${sourcePath(root, join8(path, entry.name))}`);
+    fields2[key] = await textValue(root, join8(path, entry.name), `${label} field`);
   }
   return fields2;
 }
@@ -17106,13 +17981,13 @@ async function readAppPreviews(root, previewRoot, allLocales, selectedLocales, a
   }
   for (const localeEntry of localeEntries.sort((a, b) => a.name.localeCompare(b.name))) {
     if (!localeEntry.isDirectory() || localeEntry.isSymbolicLink() || !allLocales.includes(localeEntry.name)) {
-      throw new Error(`unknown app preview locale/input: ${sourcePath(root, join7(previewRoot, localeEntry.name))}`);
+      throw new Error(`unknown app preview locale/input: ${sourcePath(root, join8(previewRoot, localeEntry.name))}`);
     }
     const locale2 = localeEntry.name;
-    const files = await readdir2(join7(previewRoot, locale2), { withFileTypes: true });
+    const files = await readdir2(join8(previewRoot, locale2), { withFileTypes: true });
     const positions = /* @__PURE__ */ new Map();
     for (const file of files.sort((a, b) => a.name.localeCompare(b.name))) {
-      const path = join7(previewRoot, locale2, file.name);
+      const path = join8(previewRoot, locale2, file.name);
       if (!file.isFile() || file.isSymbolicLink() || !PREVIEW_EXTENSIONS.has(extname3(file.name).toLowerCase())) {
         throw new Error(`unknown app preview input: ${sourcePath(root, path)}`);
       }
@@ -17136,7 +18011,7 @@ async function readAppPreviews(root, previewRoot, allLocales, selectedLocales, a
   return result;
 }
 async function readReviewAttachment(root, metadataRoot) {
-  const pointer = join7(metadataRoot, "app_review_attachment_file.txt");
+  const pointer = join8(metadataRoot, "app_review_attachment_file.txt");
   let value;
   try {
     value = await readSmallText(pointer, "app review attachment pointer");
@@ -17157,7 +18032,7 @@ async function normalizeRepositoryReleaseInputs(repository, allLocales, selected
   const root = resolve2(repository);
   const info = await stat2(root).catch(() => null);
   if (!info?.isDirectory()) throw new Error(`repository does not exist or is not a directory: ${repository}`);
-  const metadataRoot = join7(root, "fastlane", "metadata");
+  const metadataRoot = join8(root, "fastlane", "metadata");
   const localized = [];
   const app = {};
   let review = {};
@@ -17175,7 +18050,7 @@ async function normalizeRepositoryReleaseInputs(repository, allLocales, selected
     if (error.code !== "ENOENT") throw error;
   }
   for (const entry of entries.sort((a, b) => a.name.localeCompare(b.name))) {
-    const path = join7(metadataRoot, entry.name);
+    const path = join8(metadataRoot, entry.name);
     if (entry.isSymbolicLink()) throw new Error(`metadata input must not be a symbolic link: ${sourcePath(root, path)}`);
     if (entry.isDirectory()) {
       if (entry.name === "review_information") review = await readFieldDirectory(root, path, REVIEW_METADATA, "review information");
@@ -17209,7 +18084,7 @@ async function normalizeRepositoryReleaseInputs(repository, allLocales, selected
     compliance,
     appPreviews: await readAppPreviews(
       root,
-      join7(root, "fastlane", "app-previews"),
+      join8(root, "fastlane", "app-previews"),
       allLocales,
       new Set(selectedLocales),
       allOutputs,
@@ -17344,7 +18219,7 @@ var init_releaseRepository = __esm({
 import { createReadStream as createReadStream2, createWriteStream } from "node:fs";
 import { chmod as chmod2, lstat as lstat3, mkdir as mkdir2, mkdtemp as mkdtemp2, open as open2, readdir as readdir3, rename as rename2, rm as rm2, stat as stat3 } from "node:fs/promises";
 import { writeFile as writeFile3 } from "node:fs/promises";
-import { dirname as dirname2, join as join8, relative as relative3, resolve as resolve3, sep as sep2 } from "node:path";
+import { dirname as dirname3, join as join9, relative as relative3, resolve as resolve3, sep as sep2 } from "node:path";
 import { pipeline } from "node:stream/promises";
 async function secureDirectory(path) {
   await mkdir2(path, { recursive: true, mode: 448 });
@@ -17401,9 +18276,9 @@ async function sealReleaseWorkspace(destination, manifest, contents, hooks = {})
     await assertConverged(target, manifestText, existing.isDirectory() && !existing.isSymbolicLink());
     return { reused: true };
   }
-  const parent = dirname2(target);
+  const parent = dirname3(target);
   await secureDirectory(parent);
-  const temporary = await mkdtemp2(join8(parent, `${TEMPORARY_WORKSPACE_PREFIX}${process.pid}-`));
+  const temporary = await mkdtemp2(join9(parent, `${TEMPORARY_WORKSPACE_PREFIX}${process.pid}-`));
   if (process.platform !== "win32") await chmod2(temporary, 448);
   let renamed = false;
   try {
@@ -17411,9 +18286,9 @@ async function sealReleaseWorkspace(destination, manifest, contents, hooks = {})
     for (const [path, artifacts] of expectedBlobs(manifest)) {
       const content = contents.get(path);
       if (!content) throw new Error(`sealed ${describe(artifacts)} has no bytes to write: ${path}`);
-      const file = join8(temporary, ...path.split("/"));
-      await secureDirectory(dirname2(file));
-      directories.add(dirname2(file));
+      const file = join9(temporary, ...path.split("/"));
+      await secureDirectory(dirname3(file));
+      directories.add(dirname3(file));
       await copyBlob(content, file);
       if (process.platform !== "win32") await chmod2(file, 384);
       const written = await stat3(file);
@@ -17426,7 +18301,7 @@ async function sealReleaseWorkspace(destination, manifest, contents, hooks = {})
       await fsyncPath(file, false);
       await boundary("blob", path);
     }
-    const manifestPath = join8(temporary, DESIRED_RELEASE_FILENAME);
+    const manifestPath = join9(temporary, DESIRED_RELEASE_FILENAME);
     await writeFile3(manifestPath, manifestText, { mode: 384 });
     if (process.platform !== "win32") await chmod2(manifestPath, 384);
     await fsyncPath(manifestPath, false);
@@ -17463,7 +18338,7 @@ async function assertConverged(target, manifestText, isDirectory) {
 async function walkFiles(root, current, found) {
   const entries = await readdir3(current, { withFileTypes: true });
   for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
-    const path = join8(current, entry.name);
+    const path = join9(current, entry.name);
     if (entry.isSymbolicLink()) found.push(relative3(root, path).split(sep2).join("/"));
     else if (entry.isDirectory()) await walkFiles(root, path, found);
     else found.push(relative3(root, path).split(sep2).join("/"));
@@ -17474,7 +18349,7 @@ async function verifyReleaseWorkspace(path) {
   const { manifest, text: text3 } = await readDesiredReleaseManifest(root);
   const expected = expectedBlobs(manifest);
   for (const [blob, artifacts] of expected) {
-    const file = join8(root, ...blob.split("/"));
+    const file = join9(root, ...blob.split("/"));
     const stats = await lstat3(file).catch(() => null);
     if (!stats || stats.isSymbolicLink() || !stats.isFile()) {
       throw new Error(`sealed ${describe(artifacts)} is missing or unsafe: ${blob}`);
@@ -17490,7 +18365,7 @@ async function verifyReleaseWorkspace(path) {
   return { path: root, manifest, text: text3, unexpected };
 }
 function sealedBlobFile(workspace, digest4) {
-  return join8(resolve3(workspace), ...blobPath(digest4).split("/"));
+  return join9(resolve3(workspace), ...blobPath(digest4).split("/"));
 }
 async function collectReleaseWorkspaceGarbage(root, options = {}) {
   const base = resolve3(root);
@@ -17505,7 +18380,7 @@ async function collectReleaseWorkspaceGarbage(root, options = {}) {
     throw error;
   }
   for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
-    const path = join8(base, entry.name);
+    const path = join9(base, entry.name);
     if (!entry.name.startsWith(TEMPORARY_WORKSPACE_PREFIX)) {
       result.kept += 1;
       continue;
@@ -17515,7 +18390,7 @@ async function collectReleaseWorkspaceGarbage(root, options = {}) {
       result.skipped.push({ path, reason: "not a real directory" });
       continue;
     }
-    const complete = await lstat3(join8(path, DESIRED_RELEASE_FILENAME)).then((file) => file.isFile()).catch(() => false);
+    const complete = await lstat3(join9(path, DESIRED_RELEASE_FILENAME)).then((file) => file.isFile()).catch(() => false);
     if (complete) {
       result.skipped.push({ path, reason: "holds a complete desired release" });
       continue;
@@ -17548,7 +18423,7 @@ var init_releaseWorkspace = __esm({
 
 // src/release/releaseManifest.ts
 import { homedir as homedir2 } from "node:os";
-import { isAbsolute as isAbsolute4, join as join9, resolve as resolve4 } from "node:path";
+import { isAbsolute as isAbsolute4, join as join10, resolve as resolve4 } from "node:path";
 function chosenAxis(all, explicit, label) {
   const uniqueAll = Array.from(new Set(all.map((item) => item.trim()).filter(Boolean)));
   if (uniqueAll.length === 0) throw new Error(`project has no authored ${label}`);
@@ -17582,7 +18457,7 @@ function resolveBundleId(explicit, project2, build) {
   return expected;
 }
 function releaseWorkspaceRoot() {
-  return join9(process.env.SHOTOPS_CONFIG_DIR || join9(homedir2(), ".shotops"), "release-workspaces");
+  return join10(process.env.SHOTOPS_CONFIG_DIR || join10(homedir2(), ".shotops"), "release-workspaces");
 }
 function releaseCopyWords(inputs, locale2) {
   const entry = inputs.localized.find((candidate) => candidate.locale === locale2);
@@ -17604,7 +18479,7 @@ async function assembleDesiredRelease(input) {
   const localeScope = chosenAxis(project2.locales, input.locales, "locales");
   const outputScope = chosenAxis(project2.outputs.map((output2) => output2.id), input.outputs, "outputs");
   const selectedOutputs2 = outputScope.selected.map((id) => project2.outputs.find((output2) => output2.id === id));
-  const buildPath = input.build ? isAbsolute4(input.build) ? input.build : join9(repository, input.build) : null;
+  const buildPath = input.build ? isAbsolute4(input.build) ? input.build : join10(repository, input.build) : null;
   const build = buildPath ? await inspectBuildArtifact(buildPath, repository) : null;
   if (build && (isAbsolute4(build.source) || build.source.startsWith(".."))) {
     throw new Error(`build must live inside the repository so the desired release records no absolute path: ${build.source}`);
@@ -17716,7 +18591,7 @@ async function assembleDesiredRelease(input) {
     artifacts.push({
       role: "app_preview",
       custody: "sealed",
-      path: seal(preview2.sha256, { file: join9(repository, ...preview2.source.split("/")) }),
+      path: seal(preview2.sha256, { file: join10(repository, ...preview2.source.split("/")) }),
       sha256: preview2.sha256,
       bytes: preview2.bytes,
       mediaType: mediaTypeForPath(preview2.source),
@@ -17734,7 +18609,7 @@ async function assembleDesiredRelease(input) {
       role: "review_attachment",
       custody: "sealed",
       path: seal(repositoryInputs.reviewAttachment.sha256, {
-        file: join9(repository, ...repositoryInputs.reviewAttachment.source.split("/"))
+        file: join10(repository, ...repositoryInputs.reviewAttachment.source.split("/"))
       }),
       sha256: repositoryInputs.reviewAttachment.sha256,
       bytes: repositoryInputs.reviewAttachment.bytes,
@@ -17751,11 +18626,11 @@ async function assembleDesiredRelease(input) {
   const ccat = repositoryInputs.compliance?.export_compliance_ccat_file;
   if (typeof ccat === "string" && ccat.trim()) {
     if (isAbsolute4(ccat)) throw new Error("export_compliance_ccat_file must be repository-relative");
-    const document = await referencedFile(repository, join9(repository, ccat));
+    const document = await referencedFile(repository, join10(repository, ccat));
     artifacts.push({
       role: "compliance_file",
       custody: "sealed",
-      path: seal(document.sha256, { file: join9(repository, ...document.source.split("/")) }),
+      path: seal(document.sha256, { file: join10(repository, ...document.source.split("/")) }),
       sha256: document.sha256,
       bytes: document.bytes,
       mediaType: mediaTypeForPath(document.source),
@@ -17857,7 +18732,7 @@ async function assembleDesiredRelease(input) {
   };
   const desiredId = computeDesiredId(payload);
   const manifest = parseDesiredReleaseManifest({ ...payload, desiredId });
-  const destination = resolve4(input.destination || join9(releaseWorkspaceRoot(), desiredId));
+  const destination = resolve4(input.destination || join10(releaseWorkspaceRoot(), desiredId));
   const { reused } = await sealReleaseWorkspace(destination, manifest, sealed, input.seal ?? {});
   if (reused) await verifyReleaseWorkspace(destination);
   return { path: destination, manifest, reused };
@@ -18653,7 +19528,7 @@ var init_releaseOperations = __esm({
 // src/release/releaseReviewArtifact.ts
 import { randomBytes as randomBytes3 } from "node:crypto";
 import { lstat as lstat4, mkdir as mkdir3, readFile as readFile9, rename as rename3, unlink as unlink2, writeFile as writeFile4 } from "node:fs/promises";
-import { basename as basename3, dirname as dirname3, isAbsolute as isAbsolute5, join as join10, resolve as resolve5 } from "node:path";
+import { basename as basename3, dirname as dirname4, isAbsolute as isAbsolute5, join as join11, resolve as resolve5 } from "node:path";
 import { strFromU8, strToU8 as strToU82, unzipSync, zipSync as zipSync2 } from "fflate";
 function isRecord5(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
@@ -18752,7 +19627,7 @@ function screenshotReferences(plan) {
 }
 async function readScreenshot(root, reference) {
   if (isAbsolute5(reference.source)) throw new Error(`release screenshot path must be workspace-relative: ${reference.source}`);
-  const path = join10(root, ...blobPath(reference.sha256).split("/"));
+  const path = join11(root, ...blobPath(reference.sha256).split("/"));
   const info = await lstat4(path).catch(() => null);
   if (!info?.isFile() || info.isSymbolicLink() || info.size !== reference.bytes) {
     throw new Error(`release screenshot is missing or changed: ${reference.source}`);
@@ -18765,8 +19640,8 @@ async function readScreenshot(root, reference) {
   return bytes;
 }
 async function atomicPrivateWrite(path, bytes) {
-  await mkdir3(dirname3(path), { recursive: true, mode: 448 });
-  const temporary = join10(dirname3(path), `.${basename3(path)}.${process.pid}.${randomBytes3(6).toString("hex")}.tmp`);
+  await mkdir3(dirname4(path), { recursive: true, mode: 448 });
+  const temporary = join11(dirname4(path), `.${basename3(path)}.${process.pid}.${randomBytes3(6).toString("hex")}.tmp`);
   try {
     await writeFile4(temporary, bytes, { mode: 384 });
     await rename3(temporary, path);
@@ -18892,16 +19767,16 @@ async function loadArtifact(path, now) {
 async function loadPlan(path, now) {
   const plan = await readCanonicalPlan(path);
   const screenshots2 = /* @__PURE__ */ new Map();
-  for (const reference of screenshotReferences(plan)) screenshots2.set(reference.sha256, await readScreenshot(dirname3(path), reference));
+  for (const reference of screenshotReferences(plan)) screenshots2.set(reference.sha256, await readScreenshot(dirname4(path), reference));
   return { plan, screenshots: screenshots2, sourcePath: path, portable: false, approval: releasePlanApproval(plan, now) };
 }
 async function loadReleaseReviewSource(source, now = /* @__PURE__ */ new Date()) {
   let path = resolve5(source);
   const info = await lstat4(path).catch(() => null);
   if (info?.isDirectory()) {
-    const artifact = join10(path, "release-review.zip");
+    const artifact = join11(path, "release-review.zip");
     const directory = path;
-    path = await lstat4(artifact).then(() => artifact).catch(() => join10(directory, "release-plan.json"));
+    path = await lstat4(artifact).then(() => artifact).catch(() => join11(directory, "release-plan.json"));
     if (!await lstat4(path).catch(() => null)) {
       const inspected = await inspectDesiredReleaseWorkspace(directory).catch(() => null);
       if (inspected) {
@@ -18937,7 +19812,7 @@ var init_releaseReviewArtifact = __esm({
 // src/release/releaseJournal.ts
 import { chmod as chmod3, mkdir as mkdir4, open as open3, readdir as readdir4, readFile as readFile10, rename as rename4, unlink as unlink3, writeFile as writeFile5 } from "node:fs/promises";
 import { hostname } from "node:os";
-import { join as join11, resolve as resolve6 } from "node:path";
+import { join as join12, resolve as resolve6 } from "node:path";
 function assertDetail(detail) {
   if (typeof detail !== "object" || detail === null || Array.isArray(detail)) {
     throw new ReleaseJournalError("corrupt", "journal detail is not an object");
@@ -19118,8 +19993,8 @@ async function openReleaseAttemptJournal(options) {
   await mkdir4(directory, { recursive: true, mode: 448 });
   if (process.platform !== "win32") await chmod3(directory, 448).catch(() => {
   });
-  const path = join11(directory, journalFileName(options.attemptId));
-  const releaseLock = await acquireAttemptLock(join11(directory, lockFileName(options.attemptId)), now);
+  const path = join12(directory, journalFileName(options.attemptId));
+  const releaseLock = await acquireAttemptLock(join12(directory, lockFileName(options.attemptId)), now);
   let entries;
   let checksum;
   try {
@@ -19204,7 +20079,7 @@ async function readLiveAttemptJournals(directory) {
   for (const entry of entries.sort((left, right) => left.name.localeCompare(right.name))) {
     const match = entry.isFile() ? JOURNAL_FILE.exec(entry.name) : null;
     if (!match) continue;
-    const path = join11(directory, entry.name);
+    const path = join12(directory, entry.name);
     const text3 = await readFile10(path, "utf8").catch(() => null);
     if (text3 === null) continue;
     const header = safeJson(text3.split("\n", 1)[0]);
@@ -19218,7 +20093,7 @@ async function readLiveAttemptJournals(directory) {
   return found;
 }
 function attemptDirectoryOf(workspace) {
-  return join11(resolve6(workspace), ATTEMPT_DIRECTORY_NAME);
+  return join12(resolve6(workspace), ATTEMPT_DIRECTORY_NAME);
 }
 async function holdsLiveAttemptJournal(candidate) {
   const own = await readLiveAttemptJournals(attemptDirectoryOf(candidate));
@@ -19526,7 +20401,7 @@ var init_releaseReceipt = __esm({
 
 // src/release/releaseCommitBuild.ts
 import { chmod as chmod4, link, copyFile, mkdtemp as mkdtemp3, rm as rm3 } from "node:fs/promises";
-import { basename as basename4, dirname as dirname4, join as join12 } from "node:path";
+import { basename as basename4, dirname as dirname5, join as join13 } from "node:path";
 function buildEventsOf(entries, attemptId) {
   const events = [];
   for (const entry of entries) {
@@ -19680,10 +20555,10 @@ function journalVouchesFor(events, approved, evidence) {
   return namedRemoteIds.size === 0 || namedRemoteIds.size === 1 && namedRemoteIds.has(evidence.remoteBuildId);
 }
 async function stageApprovedBytes(approved, workspace) {
-  const dir = await mkdtemp3(join12(dirname4(workspace), TRANSFER_STAGING_PREFIX));
+  const dir = await mkdtemp3(join13(dirname5(workspace), TRANSFER_STAGING_PREFIX));
   if (process.platform !== "win32") await chmod4(dir, 448);
   const name = approved.fileName.toLowerCase().endsWith(`.${approved.format}`) ? approved.fileName : `${approved.fileName}.${approved.format}`;
-  const file = join12(dir, name);
+  const file = join13(dir, name);
   try {
     await link(approved.blobFile, file);
   } catch {
@@ -19841,7 +20716,7 @@ async function commitReleaseBuild(input, deps) {
     const output2 = await deps.runTransporter(
       input.transporterPath,
       ["-m", "upload", "-assetFile", staged.file, "-apiKey", input.setup.keyId, "-apiIssuer", input.setup.issuerId],
-      { ...process.env, API_PRIVATE_KEYS_DIR: dirname4(input.setup.keyPath) }
+      { ...process.env, API_PRIVATE_KEYS_DIR: dirname5(input.setup.keyPath) }
     );
     answer = readTransporterAnswer(output2);
   } catch {
@@ -20014,7 +20889,7 @@ __export(releaseRecovery_exports, {
 });
 import { readFile as readFile11, readdir as readdir5, rename as rename5, stat as stat4 } from "node:fs/promises";
 import { hostname as hostname2 } from "node:os";
-import { join as join13, relative as relative4, resolve as resolve7, sep as sep3 } from "node:path";
+import { join as join14, relative as relative4, resolve as resolve7, sep as sep3 } from "node:path";
 function normalizedNow(now) {
   const value = now().toISOString();
   if (new Date(value).toISOString() !== value) throw new ReleaseRecoveryError("recovery clock did not return a normalized timestamp");
@@ -20074,7 +20949,7 @@ function processIsAlive2(pid) {
   }
 }
 async function lockState(root, attemptId) {
-  const text3 = await readFile11(join13(root, `attempt-${attemptId}.lock`), "utf8").catch((error) => {
+  const text3 = await readFile11(join14(root, `attempt-${attemptId}.lock`), "utf8").catch((error) => {
     if (error.code === "ENOENT") return null;
     throw error;
   });
@@ -20098,7 +20973,7 @@ async function inspectLocalEvidence(input) {
   const workspacePath = resolve7(input.workspace);
   const info = await stat4(workspacePath).catch(() => null);
   if (!info?.isDirectory()) throw new ReleaseRecoveryError("the release workspace does not exist");
-  const planPath = resolve7(input.planPath ?? join13(workspacePath, PLAN_FILENAME));
+  const planPath = resolve7(input.planPath ?? join14(workspacePath, PLAN_FILENAME));
   const plan = await readPlan(planPath);
   const attemptRoot = resolve7(input.attemptRoot ?? attemptDirectoryOf(workspacePath));
   const diagnostics = [];
@@ -20117,8 +20992,8 @@ async function inspectLocalEvidence(input) {
   let finalReceipt = null;
   let partialReceipt = null;
   let receiptState = "none";
-  const finalPath = join13(attemptRoot, RECEIPT_FILENAME);
-  const partialPath = join13(attemptRoot, PARTIAL_RECEIPT_FILENAME);
+  const finalPath = join14(attemptRoot, RECEIPT_FILENAME);
+  const partialPath = join14(attemptRoot, PARTIAL_RECEIPT_FILENAME);
   const final = await readJsonEvidence(finalPath);
   if (final.exists) {
     const location = safeEvidenceLocation(workspacePath, finalPath);
@@ -20152,7 +21027,7 @@ async function inspectLocalEvidence(input) {
   for (const entry of directory.sort((left, right) => left.name.localeCompare(right.name))) {
     const match = entry.isFile() ? JOURNAL_FILE2.exec(entry.name) : null;
     if (!match) continue;
-    const path = join13(attemptRoot, entry.name);
+    const path = join14(attemptRoot, entry.name);
     const location = safeEvidenceLocation(workspacePath, path);
     if (location) evidenceLocations.push(location);
     const attemptId2 = match[1];
@@ -20189,7 +21064,7 @@ async function inspectLocalEvidence(input) {
       diagnostics.push("attempt_locked");
     }
   }
-  const backup = join13(attemptRoot, "screenshot-backup");
+  const backup = join14(attemptRoot, "screenshot-backup");
   if ((await stat4(backup).catch(() => null))?.isDirectory()) {
     const location = safeEvidenceLocation(workspacePath, backup);
     if (location) evidenceLocations.push(location);
@@ -20225,17 +21100,17 @@ function attemptIdOf(value) {
 }
 async function inspectForeignAttempt(attemptRoot, planId) {
   const foreign = (value) => value !== null && typeof value.planId === "string" && SHA2565.test(value.planId) && value.planId !== planId;
-  const final = await readLooseRecord(join13(attemptRoot, RECEIPT_FILENAME));
+  const final = await readLooseRecord(join14(attemptRoot, RECEIPT_FILENAME));
   if (foreign(final)) {
     return { attemptId: attemptIdOf(final.attemptId), planId: final.planId, finished: final.state === "completed" };
   }
-  const partial = await readLooseRecord(join13(attemptRoot, PARTIAL_RECEIPT_FILENAME));
+  const partial = await readLooseRecord(join14(attemptRoot, PARTIAL_RECEIPT_FILENAME));
   if (foreign(partial)) return { attemptId: attemptIdOf(partial.attemptId), planId: partial.planId, finished: false };
   const directory = await readdir5(attemptRoot, { withFileTypes: true }).catch(() => []);
   for (const entry of directory.sort((left, right) => left.name.localeCompare(right.name))) {
     const match = entry.isFile() ? JOURNAL_FILE2.exec(entry.name) : null;
     if (!match) continue;
-    const text3 = await readFile11(join13(attemptRoot, entry.name), "utf8").catch(() => "");
+    const text3 = await readFile11(join14(attemptRoot, entry.name), "utf8").catch(() => "");
     let header = null;
     try {
       header = JSON.parse(text3.split("\n")[0] ?? "");
@@ -22012,7 +22887,7 @@ var init_releaseCommitListing = __esm({
 // src/release/releaseCommitScreenshots.ts
 import { createHash as createHash6 } from "node:crypto";
 import { chmod as chmod5, lstat as lstat5, mkdir as mkdir5, mkdtemp as mkdtemp4, open as open4, readFile as readFile12, rename as rename6, rm as rm4, stat as stat5, writeFile as writeFile6 } from "node:fs/promises";
-import { dirname as dirname5, join as join14, resolve as resolve8 } from "node:path";
+import { dirname as dirname6, join as join15, resolve as resolve8 } from "node:path";
 function fail4(message) {
   throw new Error(message);
 }
@@ -22176,7 +23051,7 @@ function parseScreenshotBackup(value) {
 async function verifyBackup(root, manifest) {
   for (const set of manifest.sets) {
     for (const image of set.images) {
-      const file = join14(root, ...image.path.split("/"));
+      const file = join15(root, ...image.path.split("/"));
       const info = await lstat5(file).catch(() => null);
       if (!info?.isFile() || info.isSymbolicLink()) fail4(`the recovery backup is missing an image for ${set.locale}/${set.deviceSet}`);
       if (info.size !== image.bytes) fail4(`a recovery backup image for ${set.locale}/${set.deviceSet} changed size`);
@@ -22185,7 +23060,7 @@ async function verifyBackup(root, manifest) {
   }
 }
 async function readExistingBackup(root) {
-  const text3 = await readFile12(join14(root, BACKUP_FILENAME), "utf8").catch(() => null);
+  const text3 = await readFile12(join15(root, BACKUP_FILENAME), "utf8").catch(() => null);
   if (text3 === null) return null;
   let value;
   try {
@@ -22199,23 +23074,23 @@ async function readExistingBackup(root) {
 }
 async function sealBackup(destination, manifest, blobs) {
   const target = resolve8(destination);
-  const parent = dirname5(target);
+  const parent = dirname6(target);
   await secureDirectory2(parent);
-  const temporary = await mkdtemp4(join14(parent, `.shotops-screenshot-backup-${process.pid}-`));
+  const temporary = await mkdtemp4(join15(parent, `.shotops-screenshot-backup-${process.pid}-`));
   let renamed = false;
   try {
     const directories = /* @__PURE__ */ new Set();
     for (const [path, bytes] of blobs) {
-      const file = join14(temporary, ...path.split("/"));
-      await secureDirectory2(dirname5(file));
-      directories.add(dirname5(file));
+      const file = join15(temporary, ...path.split("/"));
+      await secureDirectory2(dirname6(file));
+      directories.add(dirname6(file));
       await writeFile6(file, bytes, { mode: 384 });
       const written = await stat5(file);
       if (written.size !== bytes.byteLength) fail4("a recovery backup image changed size while it was being written");
       if (await sha256File(file) !== sha256(bytes)) fail4("a recovery backup image changed content while it was being written");
       await fsyncPath2(file, false);
     }
-    const manifestPath = join14(temporary, BACKUP_FILENAME);
+    const manifestPath = join15(temporary, BACKUP_FILENAME);
     await writeFile6(manifestPath, canonicalJson(manifest), { mode: 384 });
     await fsyncPath2(manifestPath, false);
     for (const directory of [...directories].sort((left, right) => right.length - left.length)) {
@@ -22775,7 +23650,7 @@ __export(releasePlan_exports, {
 import { createHash as createHash7 } from "node:crypto";
 import { createReadStream as createReadStream3 } from "node:fs";
 import { chmod as chmod6, lstat as lstat6, rename as rename7, writeFile as writeFile7 } from "node:fs/promises";
-import { basename as basename5, dirname as dirname6, join as join15, resolve as resolve9 } from "node:path";
+import { basename as basename5, dirname as dirname7, join as join16, resolve as resolve9 } from "node:path";
 async function md5File(path) {
   const hash = createHash7("md5");
   await new Promise((resolvePromise, rejectPromise) => {
@@ -23412,7 +24287,7 @@ function envelopeFor2(plan) {
   };
 }
 async function atomicPrivateWrite2(path, value) {
-  const temporary = join15(dirname6(path), `.${basename5(path)}.${process.pid}.tmp`);
+  const temporary = join16(dirname7(path), `.${basename5(path)}.${process.pid}.tmp`);
   try {
     await writeFile7(temporary, canonicalJson(value), { mode: 384 });
     if (process.platform !== "win32") await chmod6(temporary, 384);
@@ -23424,9 +24299,9 @@ async function atomicPrivateWrite2(path, value) {
 }
 async function createReleasePlan(input, deps = {}) {
   const workspace = resolve9(input.workspace);
-  const output2 = resolve9(input.output ?? join15(workspace, "release-plan.json"));
-  const envelopePath = join15(dirname6(output2), "release-plan-envelope.json");
-  const artifactPath = join15(dirname6(output2), "release-review.zip");
+  const output2 = resolve9(input.output ?? join16(workspace, "release-plan.json"));
+  const envelopePath = join16(dirname7(output2), "release-plan-envelope.json");
+  const artifactPath = join16(dirname7(output2), "release-review.zip");
   const loaded = await verifyReleaseWorkspace(workspace);
   const assets = await desiredAssets(loaded.manifest, workspace);
   const setup = await (deps.readConfig ?? readReleaseConfig)();
@@ -23990,13 +24865,13 @@ __export(releaseCommit_exports, {
   validateReleaseCommitReceipt: () => validateReleaseCommitReceipt
 });
 import { readFile as readFile13 } from "node:fs/promises";
-import { join as join16, resolve as resolve10 } from "node:path";
+import { join as join17, resolve as resolve10 } from "node:path";
 async function commitApprovedRelease(input, deps = {}) {
   const now = deps.now ?? (() => /* @__PURE__ */ new Date());
   const startedAt = now().toISOString();
   const attemptRoot = resolve10(input.attemptRoot ?? attemptDirectoryOf(input.workspace));
-  const receiptPath = join16(attemptRoot, RECEIPT_FILENAME2);
-  const planId = await loosePlanIdAt(input.planPath ?? join16(resolve10(input.workspace), PLAN_FILENAME2));
+  const receiptPath = join17(attemptRoot, RECEIPT_FILENAME2);
+  const planId = await loosePlanIdAt(input.planPath ?? join17(resolve10(input.workspace), PLAN_FILENAME2));
   let foreign = planId ? await inspectForeignAttempt(attemptRoot, planId) : null;
   if (foreign?.finished) {
     const archived = await archiveForeignAttempt(attemptRoot, foreign, now);
@@ -24071,7 +24946,7 @@ async function commitApprovedRelease(input, deps = {}) {
       durable = isReceipt(persisted, plan) ? persisted : receipt;
       await authority.finalize(plan, attempt.attemptId, durable);
     } else {
-      await writePartialReceipt(join16(attemptRoot, PARTIAL_RECEIPT_FILENAME2), receipt);
+      await writePartialReceipt(join17(attemptRoot, PARTIAL_RECEIPT_FILENAME2), receipt);
     }
     await journal.record({
       stage: "receipt",
@@ -24157,7 +25032,7 @@ async function runPreflight(input, deps, recovery) {
   } catch (error) {
     refuse2("workspace_corrupt", error.message);
   }
-  const plan = await readApprovedPlan(input.planPath ?? join16(workspacePath, PLAN_FILENAME2));
+  const plan = await readApprovedPlan(input.planPath ?? join17(workspacePath, PLAN_FILENAME2));
   if (plan.desired.desiredId !== workspace.manifest.desiredId) {
     refuse2("plan_mismatch", "this plan was built from a different desired release than the workspace holds");
   }
@@ -24325,7 +25200,7 @@ async function runStages(preflight, attemptId, journal, signal, deps, now) {
           {
             plan,
             workspace: preflight.workspacePath,
-            backup: join16(preflight.attemptRoot, SCREENSHOT_BACKUP_DIRNAME)
+            backup: join17(preflight.attemptRoot, SCREENSHOT_BACKUP_DIRNAME)
           },
           {
             token: preflight.appleToken,
@@ -24379,7 +25254,7 @@ async function runStages(preflight, attemptId, journal, signal, deps, now) {
 }
 function readSealedPayload(workspacePath) {
   return async (reference) => {
-    const bytes = await readFile13(join16(workspacePath, ...reference.source.split("/")));
+    const bytes = await readFile13(join17(workspacePath, ...reference.source.split("/")));
     if (bytes.byteLength !== reference.bytes || sha256(bytes) !== reference.sha256) {
       throw new Error("a sealed payload changed since this plan was approved");
     }
@@ -24498,8 +25373,8 @@ ${receipt.remainingOwnerAction}` : ""
 }
 async function readReleaseCommitStatus(workspace, attemptRoot) {
   const root = resolve10(attemptRoot ?? attemptDirectoryOf(workspace));
-  const final = await readPersistedReceipt(join16(root, RECEIPT_FILENAME2));
-  const partial = isReceipt(final) ? null : await readPersistedReceipt(join16(root, PARTIAL_RECEIPT_FILENAME2));
+  const final = await readPersistedReceipt(join17(root, RECEIPT_FILENAME2));
+  const partial = isReceipt(final) ? null : await readPersistedReceipt(join17(root, PARTIAL_RECEIPT_FILENAME2));
   const journals = await readLiveAttemptJournals(root);
   return {
     attemptRoot: root,
@@ -24870,7 +25745,7 @@ __export(releasePrepare_exports, {
   runReleasePrepareCommand: () => runReleasePrepareCommand
 });
 import { readFile as readFile14 } from "node:fs/promises";
-import { isAbsolute as isAbsolute6, join as join17, resolve as resolve11 } from "node:path";
+import { isAbsolute as isAbsolute6, join as join18, resolve as resolve11 } from "node:path";
 function parseGcArgs(argv2) {
   const values = /* @__PURE__ */ new Map();
   let dryRun = false;
@@ -24978,7 +25853,7 @@ function parsePrepareArgs(argv2) {
     project: project2,
     repository,
     ...values.get("--bundle-id") ? { bundleId: values.get("--bundle-id").trim() } : {},
-    ...build ? { build: isAbsolute6(build) ? build : join17(repository, build) } : {},
+    ...build ? { build: isAbsolute6(build) ? build : join18(repository, build) } : {},
     ...values.get("--locales") ? { locales: csv(values.get("--locales"), "--locales") } : {},
     ...values.get("--outputs") ? { outputs: csv(values.get("--outputs"), "--outputs") } : {},
     ...values.get("--output") ? { destination: resolve11(values.get("--output")) } : {},
@@ -25985,7 +26860,7 @@ import {
   writeFile as writeFile8
 } from "node:fs/promises";
 import { homedir as homedir3 } from "node:os";
-import { delimiter, dirname as dirname7, extname as extname4, join as join18, resolve as resolve13 } from "node:path";
+import { delimiter, dirname as dirname8, extname as extname4, join as join19, resolve as resolve13 } from "node:path";
 import { stdin, stdout } from "node:process";
 import { createInterface } from "node:readline/promises";
 function cleanIdentifier(value, label) {
@@ -25996,7 +26871,7 @@ function cleanIdentifier(value, label) {
   return result;
 }
 function expandHome(path) {
-  return path === "~" ? homedir3() : path.startsWith("~/") ? join18(homedir3(), path.slice(2)) : path;
+  return path === "~" ? homedir3() : path.startsWith("~/") ? join19(homedir3(), path.slice(2)) : path;
 }
 async function validatePrivateKeyPath(keyPath) {
   const requested = resolve13(expandHome(keyPath.trim()));
@@ -26031,7 +26906,7 @@ async function findExecutable(name, env = process.env) {
   const extensions = process.platform === "win32" ? (env.PATHEXT || ".EXE;.CMD;.BAT;.COM").split(";") : [""];
   for (const dir of (env.PATH || "").split(delimiter).filter(Boolean)) {
     for (const extension of extensions) {
-      const candidate = join18(dir, `${name}${extension}`);
+      const candidate = join19(dir, `${name}${extension}`);
       try {
         const info = await stat6(candidate);
         if (!info.isFile()) continue;
@@ -26164,8 +27039,8 @@ async function probeAppleAccess(input, fetchImpl = fetch, apiOrigin = APP_STORE_
   return { teams: [{ id: input.issuerId, apps }] };
 }
 function releaseConfigPath() {
-  const dir = process.env.SHOTOPS_CONFIG_DIR || join18(homedir3(), ".shotops");
-  return join18(dir, "release.json");
+  const dir = process.env.SHOTOPS_CONFIG_DIR || join19(homedir3(), ".shotops");
+  return join19(dir, "release.json");
 }
 async function readReleaseConfig(target = releaseConfigPath()) {
   let parsed;
@@ -26194,7 +27069,7 @@ async function writeReleaseConfig(input, target = releaseConfigPath()) {
       keyPath: input.keyPath
     }
   };
-  const dir = dirname7(target);
+  const dir = dirname8(target);
   await mkdir6(dir, { recursive: true, mode: 448 });
   if (process.platform !== "win32") await chmod7(dir, 448);
   const temporary = `${target}.${process.pid}.tmp`;
@@ -26537,6 +27412,7 @@ wait, cancelled and cloud-only results.
 });
 
 // src/local.ts
+import { Console } from "node:console";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
@@ -26563,6 +27439,7 @@ init_screenshotInput();
 init_uploads();
 init_resultContract();
 init_renderCredits();
+init_browserInstall();
 init_appstore();
 init_productionOperationStart();
 function dedupeLocales(list) {
@@ -26675,7 +27552,13 @@ function bundleProductionSnapshot(input) {
   const locale2 = input.locales[0] ?? "en-US";
   const projectFile = input.loaded?.projectFile;
   const variant = projectFile ? projectRenderVariant(projectFile, locale2, input.panelPresetId ?? void 0) : void 0;
-  const sources = input.screens ? plannedSourceCells(input.screens.plan(variant ?? { locale: locale2 })) : input.panelEntries && input.panelEntries.length > 0 ? input.panelSourceEntries ? input.locales.flatMap(
+  const variants = projectFile ? Array.from(new Map(
+    (input.outputs.length > 0 ? input.outputs.map((id) => deviceById(id)?.panelPresetId) : [input.panelPresetId ?? void 0]).flatMap((preset) => input.locales.map((targetLocale) => {
+      const target = projectRenderVariant(projectFile, targetLocale, preset);
+      return [variantKey(target), target];
+    }))
+  ).values()) : [];
+  const sources = input.screens ? variants.flatMap((target) => plannedSourceCells(input.screens.plan(target))) : input.panelEntries && input.panelEntries.length > 0 ? input.panelSourceEntries ? input.locales.flatMap(
     (targetLocale) => panelSourceCells(
       input.panelSourceEntries.map(
         (entry) => resolveLocaleVariant(entry, targetLocale)
@@ -26718,7 +27601,10 @@ function bundleProductionSnapshot(input) {
       panelPresetId: input.panelPresetId
     },
     baseLocale: projectFile ? projectBaseLocale2(projectFile) : "en-US",
-    ...input.screens ? { gaps: repairGaps(input.screens.repairFindings) } : {}
+    ...input.screens ? { gaps: [
+      ...repairGaps(input.screens.repairFindings),
+      ...projectCopyGaps(projectFile, input.locales, variant?.family ?? BASE_SCREEN_FAMILY)
+    ] } : {}
   });
   if (!resolved.ok) return resolved;
   const readiness = requireReadiness({
@@ -26748,7 +27634,7 @@ async function handleEmitBundle(deps, args, signal) {
   const scope = openChargeScope(deps);
   const attempt = {};
   try {
-    return await runCharged(scope, () => emitBundle(deps, args, scope, attempt, signal));
+    return await refuseOnRendererSetupFailure(() => runCharged(scope, () => emitBundle(deps, args, scope, attempt, signal)));
   } finally {
     finishProductionRender(attempt.access);
   }
@@ -27223,7 +28109,8 @@ async function emitBundle(deps, args, scope, attempt, signal) {
       unexpandedSavedNote(projectSizeCovered),
       projectScreenUsageNote(result.shots ?? []),
       projectStylingIgnoredNote(args),
-      result.layoutNote
+      result.layoutNote,
+      result.setupNote
     );
   } else {
     if (!screenshotSlots || screenshotSlots.length === 0) {
@@ -27318,7 +28205,7 @@ async function emitBundle(deps, args, scope, attempt, signal) {
     previewPng = result.stripBase64 ? Buffer.from(result.stripBase64, "base64") : null;
     projectRecord = result.projectRecord;
     layout = result.layout;
-    note = joinNotes(note, result.layoutNote);
+    note = joinNotes(note, result.layoutNote, result.setupNote);
   }
   const declaredLocales = collectVariantLocales([...(screenshotSlots ?? []).flat(), ...args.panels ?? []]);
   if (declaredLocales.length > 0) {
@@ -27442,6 +28329,7 @@ async function emitMultiOutputBundle(deps, args, outputs, locales, projectName2,
   const projectShots = [];
   let layout;
   let layoutNote;
+  let setupNote;
   for (const output2 of outputs) {
     const localeSlots = [];
     for (const locale2 of locales) {
@@ -27466,6 +28354,7 @@ async function emitMultiOutputBundle(deps, args, outputs, locales, projectName2,
         }))
       });
       if (!previewPng && result.stripBase64) previewPng = Buffer.from(result.stripBase64, "base64");
+      setupNote ??= result.setupNote;
       if (!layout && result.layout) {
         layout = result.layout;
         const scope2 = outputs.length > 1 || locales.length > 1 ? ` (measured on ${output2.label} / ${locale2})` : "";
@@ -27537,6 +28426,7 @@ async function emitMultiOutputBundle(deps, args, outputs, locales, projectName2,
     projectScreenUsageNote(projectShots),
     outputNote,
     layoutNote,
+    setupNote,
     resolutionGapNote(plan.snapshot)
   );
   return textResult({
@@ -27598,7 +28488,9 @@ async function emitMultiLocaleBundle(deps, args, locales, projectName2, scope, p
   const projectShots = [];
   let layout;
   let layoutNote;
+  let setupNote;
   const noteLayout = (result, loc) => {
+    setupNote ??= result.setupNote;
     if (layout || !result.layout) return;
     layout = result.layout;
     const scope2 = locales.length > 1 ? ` (measured on ${loc})` : "";
@@ -27704,7 +28596,7 @@ async function emitMultiLocaleBundle(deps, args, locales, projectName2, scope, p
   });
   if (!measuredReady.ok) return measuredReady.result;
   const zip = buildMultiLocaleFastlaneBundleZip(localeSlots, { bundleId: args.bundleId, panelLabel });
-  note = joinNotes(note, projectScreenUsageNote(projectShots), layoutNote);
+  note = joinNotes(note, projectScreenUsageNote(projectShots), layoutNote, setupNote);
   const filename2 = bundleZipFilename(projectName2);
   const { mode: outputMode, note: outputNote } = resolveOutputMode(args.output, zip.byteLength, deps.forceOutput);
   const storedZip = outputMode === "urls" ? await storeAsset(
@@ -28557,7 +29449,7 @@ async function handleDeleteAssets(deps, args) {
 // src/runtime/widgets.ts
 init_packagePaths();
 import { readFileSync } from "node:fs";
-import { join as join2 } from "node:path";
+import { join as join3 } from "node:path";
 var WIDGET_MIME = "text/html;profile=mcp-app";
 var PANELS_WIDGET_URI = "ui://shotops/panels/v4.html";
 var PANELS_WIDGET_URIS = [
@@ -28584,7 +29476,7 @@ function readBundle(name) {
   if (cached !== void 0) return cached;
   let bundle;
   try {
-    bundle = readFileSync(join2(WIDGET_DIST, name), "utf8");
+    bundle = readFileSync(join3(WIDGET_DIST, name), "utf8");
   } catch {
     bundle = null;
   }
@@ -28715,7 +29607,7 @@ function registerTools(server, deps) {
     "render_strip",
     {
       title: "Render App Store screenshots",
-      description: 'Make the store screenshots: raw app screen captures in, finished marketing panels out. Each screenshot is composited into a styled 3D device mockup, laid out as an App Store screenshot strip with the headlines you pass, and returned as per-panel PNGs at the App Store panel size `panelPresetId` names. This is the tool for a strip built from screenshots you have in hand; to reproduce one a designer already saved, use render_project. In ChatGPT, call import_screenshot first and pass the returned refs in the preferred flat form: { "screenshots": [{ "ref": "\u2026" }] } \u2014 each flat entry is one panel, and nested slots only when ONE panel should hold several phones. Art-direct it with `style`/`look` or a project\'s saved look, iterate with a low-res `preview` at a quarter the render cost, and take results `inline` or as `urls` for large payloads. Screenshots can vary per store locale via { "locales": \u2026 } entries \u2014 `locale` picks which variant renders (missing variants fall back to en-US). For real, full-resolution screenshots call request_screenshot_upload first \u2014 inline base64 is for small payloads only. CALL describe_look FIRST when nobody has said how the strip should look \u2014 it returns the five palette presets, the three layout templates and every styling field with its default, and guessing a colour scheme out of 30 raw fields is how strips end up looking improvised. PICK `style.layout` FROM THE LONGEST HEADLINE IN THE SET, once, before anything else: "standard" reserves 2 lines (~36 characters) with the whole device under them, "bleed" reserves 4 (~72) with the device running off the bottom edge, "top-bleed" inverts that. The text region is RESERVED, NOT FITTED \u2014 held at full size whether or not the headline fills it, because a fixed reservation is the only thing that makes every device in a swiped SET land on the same line. Do not close a gap by shrinking vOffset on the short panels, and never assemble a composition out of raw phoneHeight/vOffset numbers: pick a layout, then override one field if you must (the template expands first, your field wins). Past the reservation the caption band grows down INTO the phone \u2014 the failure to avoid. THE RESPONSE ANSWERS BACK: an optional `layout` block names every caption sitting on a device, every caption collision and every device pair overlapping without reading as composed, by frame number and depth. When the repair is deterministic it also carries `layout.correctedLook` \u2014 pass that straight back as `look` to re-render clean. No `layout` key means the composition measured clean. Read it before you show the panels. This tool ONLY renders images: it never creates or updates a project, and the result says so \u2014 `contract.effects.projectMutation` is false on every render. A render with no `project` also carries a `nextStep` with action `offer_save_project`, which states that no project exists and names save_project as the door. That is an OFFER to put to the user, never consent already given: save only after they show they want this work preserved, shared, reused or kept editable, and if you cannot ask them, return the panels with the offer standing. No store credential is involved.',
+      description: 'Make the store screenshots: raw app screen captures in, finished marketing panels out. Each screenshot is composited into a styled 3D device mockup, laid out as an App Store screenshot strip with the headlines you pass, and returned as per-panel PNGs at the App Store panel size `panelPresetId` names. This is the tool for a strip built from screenshots you have in hand; to reproduce one a designer already saved, use render_project. In ChatGPT, call import_screenshot first and pass the returned refs in the preferred flat form: { "screenshots": [{ "ref": "\u2026" }] } \u2014 each flat entry is one panel, and nested slots only when ONE panel should hold several phones. Art-direct it with `style`/`look` or a project\'s saved look, iterate with a low-res `preview` at a quarter the render cost, and take results `inline` or as `urls` for large payloads. Screenshots can vary per store locale via { "locales": \u2026 } entries \u2014 `locale` picks which variant renders (missing variants fall back to en-US). For real, full-resolution screenshots call request_screenshot_upload first \u2014 inline base64 is for small payloads only. CALL describe_look FIRST when nobody has said how the strip should look \u2014 it returns the five palette presets, the seven layout templates and every styling field with its default, and guessing a colour scheme out of 30 raw fields is how strips end up looking improvised. PICK `style.layout` ONCE, BEFORE ANYTHING ELSE \u2014 off the EDGE the user asked for if they named one, otherwise off the LONGEST HEADLINE in the set: "standard" reserves 2 lines (~36 characters) with the whole device under them, "bleed" reserves 4 (~72) with the device running off the bottom edge, "top-bleed" inverts that. The side bleeds carry the device into the NEIGHBOURING screenshot so the set reads as one swipe \u2014 "lean-right" / "lean-left" put the headline in a narrow column beside it (~26 characters), "swipe" pushes a third of the device across and keeps the full-width headline, "corner-bleed" goes off the bottom and the right at once. A side bleed is for the WHOLE set: apply one to every panel or none, and never mirror it on neighbouring panels \u2014 two devices leaning toward each other overlap. The text region is RESERVED, NOT FITTED \u2014 held at full size whether or not the headline fills it, because a fixed reservation is the only thing that makes every device in a swiped SET land on the same line. Do not close a gap by shrinking vOffset on the short panels, and never assemble a composition out of raw phoneHeight/vOffset numbers: pick a layout, then override one field if you must (the template expands first, your field wins). Past the reservation the caption band grows down INTO the phone \u2014 the failure to avoid. THE RESPONSE ANSWERS BACK: an optional `layout` block names every caption sitting on a device, every caption collision and every device pair overlapping without reading as composed, by frame number and depth. When the repair is deterministic it also carries `layout.correctedLook` \u2014 pass that straight back as `look` to re-render clean. No `layout` key means the composition measured clean. Read it before you show the panels. This tool ONLY renders images: it never creates or updates a project, and the result says so \u2014 `contract.effects.projectMutation` is false on every render. A render with no `project` also carries a `nextStep` with action `offer_save_project`, which states that no project exists and names save_project as the door. That is an OFFER to put to the user, never consent already given: save only after they show they want this work preserved, shared, reused or kept editable, and if you cannot ask them, return the panels with the offer standing. No store credential is involved.',
       inputSchema: renderStripAdvertisedShape,
       outputSchema: renderStripToolOutputSchema,
       // ADDITIVE, not destructive: this can mint private generated assets but cannot change a
@@ -28864,7 +29756,7 @@ function registerTools(server, deps) {
     "describe_look",
     {
       title: "Design presets & style catalog",
-      description: "Decide what the strip should LOOK like before rendering it. Returns five named starting-point presets (each bundling a background, device body, caption colour and typeface that agree with each other), a short two-question intake script for asking the user their vibe and their headlines, and the full styling field catalog + defaults (device/camera, background, captions, App Store panel sizes). CALL THIS BEFORE the first render of a new strip whenever the user has not said how it should look \u2014 guessing a colour scheme out of 30 raw fields is how strips end up looking improvised. It is also the one complete copy of that material: the connect-time server instructions are truncated by most clients, so anything you need about PALETTE (presets: noir, daylight, pop, clay, studio \u2014 each bundling background + device body + caption colour + typeface so they agree) or COMPOSITION (layouts: standard, bleed, top-bleed \u2014 how many headline lines are reserved and where the device sits under them) is here and nowhere else in full. The two are independent axes and you usually want one of each: a preset never pins placement, a layout never pins colour. SKIP this call when the user already said what they want, when the project has a saved look (read_look / useSavedLook), or when you are iterating on a strip you already rendered.",
+      description: "Decide what the strip should LOOK like before rendering it. Returns five named starting-point presets (each bundling a background, device body, caption colour and typeface that agree with each other), a short two-question intake script for asking the user their vibe and their headlines, and the full styling field catalog + defaults (device/camera, background, captions, App Store panel sizes). CALL THIS BEFORE the first render of a new strip whenever the user has not said how it should look \u2014 guessing a colour scheme out of 30 raw fields is how strips end up looking improvised. It is also the one complete copy of that material: the connect-time server instructions are truncated by most clients, so anything you need about PALETTE (presets: noir, daylight, pop, clay, studio \u2014 each bundling background + device body + caption colour + typeface so they agree) or COMPOSITION (layouts: standard, bleed, top-bleed, lean-right, lean-left, swipe, corner-bleed \u2014 how many headline lines are reserved and where the device sits under them) is here and nowhere else in full. The two are independent axes and you usually want one of each: a preset never pins placement, a layout never pins colour. SKIP this call when the user already said what they want, when the project has a saved look (read_look / useSavedLook), or when you are iterating on a strip you already rendered.",
       inputSchema: describeLookShape,
       outputSchema: describeLookOutputSchema,
       annotations: READ_ONLY,
@@ -29290,7 +30182,11 @@ function tokenFromArgv(argv2) {
   return idx !== -1 ? argv2[idx + 1] : void 0;
 }
 var LOCAL_INTAKE = 'request_screenshot_upload is hosted-only; import_screenshot accepts { "path": "/abs/shot.png" } entries here (its { "url" } / { "file" } sources need a hosted account). Either way you can pass local files straight to render_strip / emit_bundle as { "path": "..." } screenshot entries.';
+function silenceStdoutConsole() {
+  globalThis.console = new Console({ stdout: process.stderr, stderr: process.stderr });
+}
 async function startStdioServer(token2) {
+  silenceStdoutConsole();
   const deps = localToolDeps(token2);
   const localInstructions = token2 ? `${SERVER_INSTRUCTIONS}