@nodaro/prompts 1.38.0 → 1.40.0

package/dist/{chunk-LVSH7K7R.cjs → chunk-C3NHNECH.cjs}

@@ -1,17 +1,18 @@
 'use strict';
 
-var chunkMENBHEAY_cjs = require('./chunk-MENBHEAY.cjs');
+var chunkWRM52ZBN_cjs = require('./chunk-WRM52ZBN.cjs');
 var chunkXUZXBY75_cjs = require('./chunk-XUZXBY75.cjs');
 var chunk2NJTFCKQ_cjs = require('./chunk-2NJTFCKQ.cjs');
-var chunkLK2CZK5U_cjs = require('./chunk-LK2CZK5U.cjs');
+var chunkPWWM7Q3T_cjs = require('./chunk-PWWM7Q3T.cjs');
+var chunk2P26SZX5_cjs = require('./chunk-2P26SZX5.cjs');
 var chunkMQEXFCNU_cjs = require('./chunk-MQEXFCNU.cjs');
 var entities = require('@nodaro/shared/entities');
 var models = require('@nodaro/shared/models');
 var video = require('@nodaro/shared/video');
 
 // src/ref-binding.ts
-function identityRefsSentence(firstOrdinal, lastOrdinal) {
-  return firstOrdinal === lastOrdinal ? `${REF_BINDING.ordinal(firstOrdinal)} is an identity reference for this shot's subjects \u2014 match its subject's exact appearance; it is not a frame.` : `${REF_BINDING.ordinal(firstOrdinal)} through ${REF_BINDING.ordinal(lastOrdinal)} are identity references for this shot's subjects \u2014 match each subject's exact appearance; they are not frames.`;
+function identityRefsSentence(firstOrdinal, lastOrdinal, ordinal = REF_BINDING.ordinal) {
+  return firstOrdinal === lastOrdinal ? `${ordinal(firstOrdinal)} is an identity reference for this shot's subjects \u2014 match its subject's exact appearance; it is not a frame.` : `${ordinal(firstOrdinal)} through ${ordinal(lastOrdinal)} are identity references for this shot's subjects \u2014 match each subject's exact appearance; they are not frames.`;
 }
 var REF_BINDING = {
   image: (label, n) => `the ${label} from @image_${n}`,
@@ -21,6 +22,14 @@ var REF_BINDING = {
   ordinal: (n) => `@image_${n}`,
   frame: (n, role) => `Use @image_${n} as the ${role} (${role === "opening" ? "first" : "last"}) frame of the video.`
 };
+function imageBindingFor(syntax) {
+  if (syntax === "@image_N") return { ordinal: REF_BINDING.ordinal, frame: REF_BINDING.frame };
+  const ordinal = syntax === "@image(n)" ? (n) => `@image(${n})` : (n) => `[Image ${n}]`;
+  return {
+    ordinal,
+    frame: (n, role) => `Use ${ordinal(n)} as the ${role} (${role === "opening" ? "first" : "last"}) frame of the video.`
+  };
+}
 var SEEDANCE_VIDEO_EDIT_PREFIX = "edit {video:1} as follows:\n";
 function buildSeedanceVideoEditPrompt(prompt) {
   const body = (prompt ?? "").trim();
@@ -62,11 +71,11 @@ function resolveRefIdTokens(prompt, ctx) {
 var REFERENCE_TOKEN_RE = /\{(image|video|audio):(\d+)(?::([a-zA-Z0-9_ -]+))?\}/gi;
 function resolveReferenceTokens(prompt, counts) {
   if (!prompt) return prompt;
-  return chunkMENBHEAY_cjs.tidyReferenceTokenGaps(
+  return chunkWRM52ZBN_cjs.tidyReferenceTokenGaps(
     prompt.replace(REFERENCE_TOKEN_RE, (_match, rawKind, nStr, label) => {
       const kind = rawKind.toLowerCase();
       const n = parseInt(nStr, 10);
-      if (n < 1 || n > counts[kind]) return chunkMENBHEAY_cjs.unboundReferenceTokenText(label);
+      if (n < 1 || n > counts[kind]) return chunkWRM52ZBN_cjs.unboundReferenceTokenText(label);
       if (label) return REF_BINDING[kind](label, n);
       return `@${kind}_${n}`;
     })
@@ -125,7 +134,7 @@ function resolveVideoCharacterMentionsHybrid(prompt, tokens, refs, offset) {
     const binding = bindingFor(m.url);
     const lock = chunk2NJTFCKQ_cjs.buildIdentityLockLine(chunk2NJTFCKQ_cjs.withForcedIdentityLock(ref, lockOverrideByUrl.get(m.url)), binding);
     if (lock) lockLines.push(lock);
-    const overrideLine = chunkMENBHEAY_cjs.referenceDescriptionLine(binding, ref.descriptionOverride);
+    const overrideLine = chunkWRM52ZBN_cjs.referenceDescriptionLine(binding, ref.descriptionOverride);
     if (overrideLine) elementDirectives.push(overrideLine);
     const inject = ref.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
@@ -153,8 +162,8 @@ function resolveVideoReferenceCore(args) {
     audio: args.audioRefCount ?? 0
   });
   const describedAndCaptionLines = [
-    ...chunkMENBHEAY_cjs.renderDescribedReferenceLines(args.describedReferences),
-    ...chunkMENBHEAY_cjs.renderReferenceCaptionLines(args.videoCaptions, args.audioCaptions, {
+    ...chunkWRM52ZBN_cjs.renderDescribedReferenceLines(args.describedReferences),
+    ...chunkWRM52ZBN_cjs.renderReferenceCaptionLines(args.videoCaptions, args.audioCaptions, {
       video: args.videoRefCount ?? 0,
       audio: args.audioRefCount ?? 0
     })
@@ -191,7 +200,7 @@ function resolveVideoReferenceCore(args) {
       // Described references and rail captions are the ONE thing this branch can
       // still contribute: they need no seat, so a request that carries only them
       // (a story landing before any entity exists) reaches the model here.
-      prompt: describedAndCaptionLines.length > 0 ? chunkMENBHEAY_cjs.appendReferenceLines(resolved2 ?? "", describedAndCaptionLines, args.hybridRoles === true ? "hybrid" : "legacy") : resolved2,
+      prompt: describedAndCaptionLines.length > 0 ? chunkWRM52ZBN_cjs.appendReferenceLines(resolved2 ?? "", describedAndCaptionLines, args.hybridRoles === true ? "hybrid" : "legacy") : resolved2,
       additionalUrls: [...leadingRefUrls]
     };
   }
@@ -212,7 +221,7 @@ function resolveVideoReferenceCore(args) {
     mentionLockLines = h.lockLines;
     mentionElementDirectives = h.elementDirectives;
   } else {
-    resolved = mentionTokens.length > 0 ? chunkMENBHEAY_cjs.resolveCharacterMentions(promptForResolution, mentionTokens, wiredCharRefs) : { prompt: promptForResolution, additionalUrls: [], mentionedCharacterSlugs: /* @__PURE__ */ new Set() };
+    resolved = mentionTokens.length > 0 ? chunkWRM52ZBN_cjs.resolveCharacterMentions(promptForResolution, mentionTokens, wiredCharRefs) : { prompt: promptForResolution, additionalUrls: [], mentionedCharacterSlugs: /* @__PURE__ */ new Set() };
   }
   const fallbackUrls = [];
   const fallbackDirectiveLines = [];
@@ -249,7 +258,7 @@ function resolveVideoReferenceCore(args) {
       canonicalPhrases.push(entities.roleToPhrase(entities.resolveDefaultRole(r.defaultRole, r.defaultUsageMode, r.source), binding));
       const lock = chunk2NJTFCKQ_cjs.buildIdentityLockLine(r, binding);
       if (lock) canonicalLockLines.push(lock);
-      const overrideLine = chunkMENBHEAY_cjs.referenceDescriptionLine(binding, r.descriptionOverride);
+      const overrideLine = chunkWRM52ZBN_cjs.referenceDescriptionLine(binding, r.descriptionOverride);
       if (overrideLine) canonicalElementDirectives.push(overrideLine);
       const inject = r.elementInjection?.trim();
       if (inject) canonicalElementDirectives.push(inject);
@@ -381,7 +390,7 @@ function resolveVideoReferenceCore(args) {
     const lockBlock = lockLines.length > 0 ? `${lockLines.join("\n")}
 
 ` : "";
-    finalPrompt = `${lockBlock}${chunkMENBHEAY_cjs.insertBeforeStyleSection(finalPrompt, trailingLines)}`;
+    finalPrompt = `${lockBlock}${chunkWRM52ZBN_cjs.insertBeforeStyleSection(finalPrompt, trailingLines)}`;
   } else {
     const allFallbackLines = [...fallbackDirectiveLines, ...extraDirectiveLines];
     if (allFallbackLines.length > 0) {
@@ -431,7 +440,7 @@ ${finalPrompt}` : block;
       merged.push(u);
     }
   }
-  finalPrompt = chunkMENBHEAY_cjs.appendReferenceLines(
+  finalPrompt = chunkWRM52ZBN_cjs.appendReferenceLines(
     finalPrompt,
     describedAndCaptionLines,
     hybrid ? "hybrid" : "legacy"
@@ -459,7 +468,7 @@ ${finalPrompt}` : block;
         });
       }
     }
-    const reordered = chunkMENBHEAY_cjs.applyReferenceOrderToVideo(assetUrls, finalPrompt, refsForOrdering, referenceOrder, void 0, offset);
+    const reordered = chunkWRM52ZBN_cjs.applyReferenceOrderToVideo(assetUrls, finalPrompt, refsForOrdering, referenceOrder, void 0, offset);
     return {
       prompt: resolveReferenceTokens(reordered.prompt, tokenCounts(merged.length)),
       additionalUrls: [...leadingRefUrls, ...reordered.urls]
@@ -513,7 +522,7 @@ function composeSoundHintFromConnections(consumer, consumerType, ctx) {
         continue;
       }
     }
-    const hint = chunkLK2CZK5U_cjs.getParameterPromptHint(src);
+    const hint = chunkPWWM7Q3T_cjs.getParameterPromptHint(src);
     if (hint) acceptedHints.push(hint);
     if ((consumerType === "suno-generate" || consumerType === "generate-music") && t === "voice-character" && src.data) {
       const gender = src.data.gender;
@@ -618,35 +627,78 @@ function assembleSunoInput(input) {
     ...input.persona ?? {}
   };
 }
-
-// src/assemble-image-input.ts
-function renderImageHintPieces(subject, direction, structured) {
+function renderImageHintPieces(subject, direction, structured, directionRefs) {
   return {
     hintClauses: [
-      ...chunkMENBHEAY_cjs.asBodyClauses(
-        chunkMENBHEAY_cjs.renderSubjectHints(subject, {
+      ...chunkWRM52ZBN_cjs.asBodyClauses(
+        chunkWRM52ZBN_cjs.renderSubjectHints(subject, {
           surface: "image",
-          mode: chunkMENBHEAY_cjs.SUBJECT_IMAGE_HINT_MODE_DEFAULT
+          mode: chunkWRM52ZBN_cjs.SUBJECT_IMAGE_HINT_MODE_DEFAULT
         })
       ),
-      ...chunkMENBHEAY_cjs.partitionStyleClauses(direction, {
+      ...chunkWRM52ZBN_cjs.partitionStyleClauses(direction, {
         surface: "image",
-        mode: chunkMENBHEAY_cjs.IMAGE_HINT_MODE_DEFAULT
+        mode: chunk2P26SZX5_cjs.IMAGE_HINT_MODE_DEFAULT,
+        ...directionRefs !== void 0 ? { refs: directionRefs } : {}
       })
     ].filter((c) => c.text.length > 0),
-    structuredFragment: structured ? chunkMENBHEAY_cjs.renderStructuredFields(structured) : ""
+    structuredFragment: structured ? chunkWRM52ZBN_cjs.renderStructuredFields(structured) : ""
   };
 }
 function composePromptText(userPrompt, pieces, keptHintClauses) {
-  return chunkMENBHEAY_cjs.composeSectionedPrompt(
+  return chunkWRM52ZBN_cjs.composeSectionedPrompt(
     userPrompt,
     pieces.hintClauses.slice(0, keptHintClauses),
     pieces.structuredFragment
   );
 }
 function assembleImageInput(input) {
-  const pieces = renderImageHintPieces(input.subject, input.direction, input.structured);
-  const assembleWith = (keptHintClauses) => chunkMENBHEAY_cjs.buildImagePromptWithOverflow({
+  const style = input.styleReferences;
+  const result = style !== void 0 && style.length > 0 ? fillStyleReferences(input, style) : assembleOnce(input);
+  if (input.throwOnEmpty && !result.prompt.trim()) {
+    throw new Error(
+      "No prompt \u2014 type one, bind a character, or pick a cinematography direction"
+    );
+  }
+  return result;
+}
+function fillStyleReferences(input, style) {
+  const base = assembleOnce(input);
+  const own = base.referenceImageUrls ?? [];
+  const seats = models.imageReferenceLimit(input.provider) - own.length;
+  const seen = new Set(own);
+  const candidates = [];
+  for (const s of style) {
+    if (typeof s.url !== "string" || s.url.length === 0 || seen.has(s.url)) continue;
+    seen.add(s.url);
+    candidates.push(s);
+  }
+  for (let k = Math.min(seats, candidates.length); k > 0; k--) {
+    const extras = candidates.slice(0, k).map(styleConnectedReference);
+    const filled = assembleOnce({
+      ...input,
+      connectedReferences: [...input.connectedReferences ?? [], ...extras]
+    });
+    const urls = filled.referenceImageUrls ?? [];
+    const keepsOwn = urls.length === own.length + k && own.every((url, i) => urls[i] === url) && extras.every((ref, j) => urls[own.length + j] === ref.url);
+    if (keepsOwn) return { ...filled, styleReferencesSent: k };
+  }
+  return { ...base, styleReferencesSent: 0 };
+}
+function styleConnectedReference(s, index) {
+  return {
+    id: `style-reference-${index + 1}`,
+    defaultName: `Style reference ${index + 1}`,
+    source: "manual",
+    url: s.url,
+    isExtraRef: true,
+    defaultRole: "style",
+    description: chunk2P26SZX5_cjs.styleReferenceDescription(index, s.caption)
+  };
+}
+function assembleOnce(input) {
+  const pieces = renderImageHintPieces(input.subject, input.direction, input.structured, input.directionRefs);
+  const assembleWith = (keptHintClauses) => chunkWRM52ZBN_cjs.buildImagePromptWithOverflow({
     prompt: composePromptText(input.userPrompt, pieces, keptHintClauses),
     provider: input.provider,
     ...input.connectedReferences !== void 0 ? { connectedReferences: input.connectedReferences } : {},
@@ -674,7 +726,7 @@ function assembleImageInput(input) {
   let kept = pieces.hintClauses.length;
   let fitted = assembleWith(kept);
   if (fitted.overflowChars > 0) {
-    const costs = chunkMENBHEAY_cjs.sectionedClauseCosts(
+    const costs = chunkWRM52ZBN_cjs.sectionedClauseCosts(
       input.userPrompt,
       pieces.hintClauses,
       pieces.structuredFragment
@@ -686,30 +738,25 @@ function assembleImageInput(input) {
     }
   }
   const { overflowChars, ...result } = fitted;
-  if (input.throwOnEmpty && !result.prompt.trim()) {
-    throw new Error(
-      "No prompt \u2014 type one, bind a character, or pick a cinematography direction"
-    );
-  }
   return result;
 }
 
 // src/assemble-video-input.ts
 function composeVideoPromptText(userPrompt, direction, structured, opts) {
   const hintClauses = [
-    ...chunkMENBHEAY_cjs.asBodyClauses(
-      chunkMENBHEAY_cjs.renderSubjectHints(opts?.subject, {
+    ...chunkWRM52ZBN_cjs.asBodyClauses(
+      chunkWRM52ZBN_cjs.renderSubjectHints(opts?.subject, {
         surface: "video",
-        mode: opts?.subjectHintMode ?? chunkMENBHEAY_cjs.SUBJECT_VIDEO_HINT_MODE_DEFAULT
+        mode: opts?.subjectHintMode ?? chunkWRM52ZBN_cjs.SUBJECT_VIDEO_HINT_MODE_DEFAULT
       })
     ),
-    ...chunkMENBHEAY_cjs.partitionStyleClauses(direction, {
+    ...chunkWRM52ZBN_cjs.partitionStyleClauses(direction, {
       surface: "video",
-      mode: opts?.hintMode ?? chunkMENBHEAY_cjs.VIDEO_HINT_MODE_DEFAULT
+      mode: opts?.hintMode ?? chunk2P26SZX5_cjs.VIDEO_HINT_MODE_DEFAULT
     })
   ].filter((c) => c.text.length > 0);
-  const structuredFragment = structured ? chunkMENBHEAY_cjs.renderStructuredFields(structured) : "";
-  const composeWith = (kept2) => chunkMENBHEAY_cjs.composeSectionedPrompt(userPrompt, hintClauses.slice(0, kept2), structuredFragment);
+  const structuredFragment = structured ? chunkWRM52ZBN_cjs.renderStructuredFields(structured) : "";
+  const composeWith = (kept2) => chunkWRM52ZBN_cjs.composeSectionedPrompt(userPrompt, hintClauses.slice(0, kept2), structuredFragment);
   const cap = opts?.cap;
   if (cap === void 0) return composeWith(hintClauses.length);
   const frame = opts?.frame ?? ((body2) => body2);
@@ -717,7 +764,7 @@ function composeVideoPromptText(userPrompt, direction, structured, opts) {
   let body = composeWith(kept);
   let framedLength = frame(body)?.length ?? 0;
   if (framedLength <= cap) return body;
-  const costs = chunkMENBHEAY_cjs.sectionedClauseCosts(userPrompt, hintClauses, structuredFragment);
+  const costs = chunkWRM52ZBN_cjs.sectionedClauseCosts(userPrompt, hintClauses, structuredFragment);
   const texts = hintClauses.map((c) => c.text);
   while (framedLength > cap && kept > 0) {
     kept = chunkXUZXBY75_cjs.keepableDirectionHints(texts, kept, framedLength - cap, costs);
@@ -726,15 +773,50 @@ function composeVideoPromptText(userPrompt, direction, structured, opts) {
   }
   return body;
 }
+
+// src/frame-reference-slots.ts
+function placeFramesAfterReferences(args) {
+  const refs = (args.refImageUrls ?? []).filter((u) => typeof u === "string" && u.trim().length > 0);
+  const frameCount = (args.firstFrameUrl ? 1 : 0) + (args.lastFrameUrl ? 1 : 0);
+  const kept = refs.slice(0, Math.max(0, args.imageCap - frameCount));
+  const droppedRefImages = refs.length - kept.length;
+  const imageUrls = [...kept];
+  let firstFrameOrdinal = 0;
+  let lastFrameOrdinal = 0;
+  if (args.firstFrameUrl) {
+    imageUrls.push(args.firstFrameUrl);
+    firstFrameOrdinal = imageUrls.length;
+  }
+  if (args.lastFrameUrl) {
+    imageUrls.push(args.lastFrameUrl);
+    lastFrameOrdinal = imageUrls.length;
+  }
+  const syntax = args.syntax ?? "@image_N";
+  const binding = imageBindingFor(syntax);
+  const promptBindsStart = syntax === "@image_N" && promptBindsFirstFrame(args.prompt);
+  let frameSentence = "";
+  if (promptBindsStart && firstFrameOrdinal > 0 && lastFrameOrdinal === 0) ; else if (firstFrameOrdinal > 0 && lastFrameOrdinal > 0) {
+    frameSentence = `Use ${binding.ordinal(firstFrameOrdinal)} as the opening (first) frame and ${binding.ordinal(lastFrameOrdinal)} as the closing (last) frame of the video.`;
+  } else if (firstFrameOrdinal > 0) {
+    frameSentence = binding.frame(firstFrameOrdinal, "opening");
+  } else if (lastFrameOrdinal > 0) {
+    frameSentence = binding.frame(lastFrameOrdinal, "closing");
+  }
+  const identitySentence = args.bindIdentities && kept.length > 0 && frameCount > 0 ? identityRefsSentence(1, kept.length, binding.ordinal) : "";
+  const promptSuffix = [frameSentence, identitySentence].filter(Boolean).join(" ");
+  return { imageUrls, promptSuffix, droppedRefImages, firstFrameOrdinal, lastFrameOrdinal };
+}
+function promptBindsFirstFrame(prompt) {
+  if (!prompt) return false;
+  return /@image_\d+\s+as\s+the\s+(first|opening)\s*(\(first\))?\s*frame/i.test(prompt);
+}
+
+// src/seedance-2-inputs.ts
 var clean = (u) => {
   const t = u?.trim();
   return t && t.length > 0 ? t : void 0;
 };
 var cleanList = (xs) => (xs ?? []).map(clean).filter((x) => x !== void 0);
-function promptBindsFirstFrame(prompt) {
-  if (!prompt) return false;
-  return /@image_\d+\s+as\s+the\s+(first|opening)\s*(\(first\))?\s*frame/i.test(prompt);
-}
 function resolveSeedance2Inputs(args) {
   const limits = args.limits ?? models.SEEDANCE_2_REF_LIMITS;
   const firstFrameUrl = clean(args.firstFrameUrl);
@@ -750,30 +832,16 @@ function resolveSeedance2Inputs(args) {
     }
     return { mode: "first-frame", firstFrameUrl, lastFrameUrl: void 0, referenceImageUrls: [], referenceVideoUrls: [], referenceAudioUrls: [], promptSuffix: "", droppedRefImages: 0 };
   }
-  const frameCount = (firstFrameUrl ? 1 : 0) + (lastFrameUrl ? 1 : 0);
-  const userImageSlots = Math.max(0, limits.images - frameCount);
-  const keptUserImages = refImages.slice(0, userImageSlots);
-  const droppedRefImages = refImages.length - keptUserImages.length;
-  const referenceImageUrls = [...keptUserImages];
-  let firstOrdinal = 0;
-  let lastOrdinal = 0;
-  if (firstFrameUrl) {
-    referenceImageUrls.push(firstFrameUrl);
-    firstOrdinal = referenceImageUrls.length;
-  }
-  if (lastFrameUrl) {
-    referenceImageUrls.push(lastFrameUrl);
-    lastOrdinal = referenceImageUrls.length;
-  }
-  let promptSuffix = "";
-  const suppressFrameSentence = promptBindsFirstFrame(args.prompt);
-  if (suppressFrameSentence && firstOrdinal > 0 && lastOrdinal === 0) ; else if (firstOrdinal > 0 && lastOrdinal > 0) {
-    promptSuffix = `Use ${REF_BINDING.ordinal(firstOrdinal)} as the opening (first) frame and ${REF_BINDING.ordinal(lastOrdinal)} as the closing (last) frame of the video.`;
-  } else if (firstOrdinal > 0) {
-    promptSuffix = REF_BINDING.frame(firstOrdinal, "opening");
-  } else if (lastOrdinal > 0) {
-    promptSuffix = REF_BINDING.frame(lastOrdinal, "closing");
-  }
+  const placed = placeFramesAfterReferences({
+    prompt: args.prompt,
+    firstFrameUrl,
+    lastFrameUrl,
+    refImageUrls: refImages,
+    imageCap: limits.images
+  });
+  const referenceImageUrls = placed.imageUrls;
+  const promptSuffix = placed.promptSuffix;
+  const droppedRefImages = placed.droppedRefImages;
   return {
     mode: "reference",
     firstFrameUrl: void 0,
@@ -790,16 +858,18 @@ function geminiOmniInputSlots(provider) {
   return models.VIDEO_REF_LIMITS_BY_PROVIDER[provider ?? DEFAULT_GEMINI_OMNI_PROVIDER]?.images ?? 7;
 }
 function resolveGeminiOmniI2vInputs(args) {
-  const refs = (args.refImageUrls ?? []).filter((u) => typeof u === "string" && u.length > 0);
   const slots = geminiOmniInputSlots(args.provider) - (args.videoConnected ? 2 : 0);
-  const refSlots = Math.max(0, slots - 1);
-  const kept = refs.slice(0, refSlots);
-  const droppedRefImages = refs.length - kept.length;
-  const imageUrls = [args.firstFrameUrl, ...kept];
-  if (kept.length === 0) return { imageUrls, promptSuffix: "", droppedRefImages };
-  const frameSentence = promptBindsFirstFrame(args.prompt) ? "" : REF_BINDING.frame(1, "opening");
-  const promptSuffix = [frameSentence, identityRefsSentence(2, kept.length + 1)].filter(Boolean).join(" ");
-  return { imageUrls, promptSuffix, droppedRefImages };
+  const placed = placeFramesAfterReferences({
+    prompt: args.prompt,
+    firstFrameUrl: args.firstFrameUrl,
+    refImageUrls: args.refImageUrls,
+    imageCap: Math.max(1, slots),
+    bindIdentities: true
+  });
+  if (placed.imageUrls.length === 1) {
+    return { imageUrls: placed.imageUrls, promptSuffix: "", droppedRefImages: placed.droppedRefImages };
+  }
+  return { imageUrls: placed.imageUrls, promptSuffix: placed.promptSuffix, droppedRefImages: placed.droppedRefImages };
 }
 
 // src/veo-i2v-inputs.ts
@@ -814,15 +884,20 @@ function resolveVeoI2vInputs(args) {
       droppedEndFrame: false
     };
   }
-  const kept = refs.slice(0, VEO_INGREDIENT_SLOTS - 1);
-  const droppedRefImages = refs.length - kept.length;
-  const frameSentence = promptBindsFirstFrame(args.prompt) ? "" : REF_BINDING.frame(1, "opening");
+  const placed = placeFramesAfterReferences({
+    prompt: args.prompt,
+    firstFrameUrl: args.firstFrameUrl,
+    lastFrameUrl: args.endFrameUrl,
+    refImageUrls: refs,
+    imageCap: VEO_INGREDIENT_SLOTS,
+    bindIdentities: true
+  });
   return {
-    imageUrls: [args.firstFrameUrl, ...kept],
+    imageUrls: placed.imageUrls,
     generationType: "REFERENCE_2_VIDEO",
-    promptSuffix: [frameSentence, identityRefsSentence(2, kept.length + 1)].filter(Boolean).join(" "),
-    droppedRefImages,
-    droppedEndFrame: Boolean(args.endFrameUrl)
+    promptSuffix: placed.promptSuffix,
+    droppedRefImages: placed.droppedRefImages,
+    droppedEndFrame: false
   };
 }
 
@@ -902,6 +977,8 @@ exports.composeSoundHintFromConnections = composeSoundHintFromConnections;
 exports.composeVideoPromptText = composeVideoPromptText;
 exports.getEffectiveSunoCustomMode = getEffectiveSunoCustomMode;
 exports.identityRefsSentence = identityRefsSentence;
+exports.imageBindingFor = imageBindingFor;
+exports.placeFramesAfterReferences = placeFramesAfterReferences;
 exports.planFrameDelivery = planFrameDelivery;
 exports.promptBindsFirstFrame = promptBindsFirstFrame;
 exports.resolveGeminiOmniI2vInputs = resolveGeminiOmniI2vInputs;
@@ -911,5 +988,5 @@ exports.resolveSeedance2Inputs = resolveSeedance2Inputs;
 exports.resolveVeoI2vInputs = resolveVeoI2vInputs;
 exports.resolveVideoReferenceCore = resolveVideoReferenceCore;
 exports.truncateForField = truncateForField;
-//# sourceMappingURL=chunk-LVSH7K7R.cjs.map
-//# sourceMappingURL=chunk-LVSH7K7R.cjs.map
+//# sourceMappingURL=chunk-C3NHNECH.cjs.map
+//# sourceMappingURL=chunk-C3NHNECH.cjs.map