@nodaro/prompts 1.16.0 → 1.17.1

package/dist/index.js

@@ -10342,32 +10342,6 @@ function resolveBrandInput(brand) {
   return brand;
 }
 
-// src/prompt-templates.ts
-var DEFAULT_TEMPLATES = {
-  "character-description": "Include character '{name}': {description}.",
-  "object-description": "Include object '{name}': {description}.",
-  "location-description": "Include location '{name}': {description}.",
-  "face-description": "Include the exact face and facial features of '{name}' from the reference image. Maintain perfect likeness and facial identity.",
-  // `-generation` templates drive standalone entity generation routes
-  // (`/v1/generate-character`, `/v1/generate-face`, etc.). Duplicated between
-  // frontend and backend historically; consolidated here so the backend DAG
-  // orchestrator produces the same prompt as a single-node HTTP call.
-  "character-generation": "Create a full-body character portrait: {description}. Style: {style}. Gender: {gender}. High quality, detailed, consistent lighting, neutral background.",
-  "object-generation": "Create a product photo of: {description}. Category: {category}. Clean background, professional studio lighting, high detail.",
-  "location-generation": "Create a cinematic scene of: {description}. Category: {category}. Atmospheric lighting, high detail, wide angle.",
-  "face-generation": "Create a professional close-up face portrait headshot: {description}. Style: {style}. Looking directly at camera, sharp focus on facial features, clean background, studio lighting, high resolution. Maintain exact facial identity and features from the reference image.",
-  "generate-image-wrapper": "{userPrompt}\n{assetDescriptions}"
-};
-function resolveTemplate(key, userTemplates, flowTemplates) {
-  return flowTemplates?.[key] ?? userTemplates?.[key] ?? DEFAULT_TEMPLATES[key] ?? "";
-}
-function applyTemplate(template, vars) {
-  return Object.entries(vars).reduce(
-    (result, [key, value]) => result.replaceAll(`{${key}}`, value || ""),
-    template
-  );
-}
-
 // src/prompt-hint-join.ts
 var PROMPT_HINT_SEPARATOR = ". ";
 function joinPromptHints(userPrompt, hints) {
@@ -10579,6 +10553,87 @@ function sectionedClauseCosts(userPrompt, clauses, structuredFragment) {
   }
   return costs;
 }
+
+// src/described-references.ts
+var CHARACTER_BLOCK_HEADER = "Use these characters:";
+function referenceDescriptionLine(subject, description) {
+  const s = subject.trim();
+  const d = description?.trim();
+  if (!s || !d) return "";
+  return `${s} \u2014 ${d}.`;
+}
+function renderDescribedReferenceLines(refs) {
+  if (!refs || refs.length === 0) return [];
+  const lines = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const r of refs) {
+    const key = r.name?.trim().toLowerCase();
+    if (!key || seen.has(key)) continue;
+    const line = referenceDescriptionLine(r.name, r.description);
+    if (!line) continue;
+    seen.add(key);
+    lines.push(line);
+  }
+  return lines;
+}
+function renderReferenceCaptionLines(videoCaptions, audioCaptions, counts) {
+  const lines = [];
+  const render = (captions, kind, cap) => {
+    if (!captions) return;
+    for (let i = 0; i < captions.length && i < cap; i++) {
+      const text = captions[i]?.trim();
+      if (!text) continue;
+      lines.push(`@${kind}_${i + 1}: ${text}.`);
+    }
+  };
+  render(videoCaptions, "video", counts.video);
+  render(audioCaptions, "audio", counts.audio);
+  return lines;
+}
+function appendReferenceLines(prompt, lines, format) {
+  if (lines.length === 0) return prompt;
+  if (format === "hybrid") return insertBeforeStyleSection(prompt, lines);
+  const bullets = lines.map((l) => `- ${l}`).join("\n");
+  if (prompt.startsWith(`${CHARACTER_BLOCK_HEADER}
+`)) {
+    const splitIdx = prompt.indexOf("\n\n");
+    if (splitIdx === -1) return `${prompt}
+${bullets}`;
+    return `${prompt.slice(0, splitIdx)}
+${bullets}${prompt.slice(splitIdx)}`;
+  }
+  const block = `${CHARACTER_BLOCK_HEADER}
+${bullets}`;
+  return prompt ? `${block}
+
+${prompt}` : block;
+}
+
+// src/prompt-templates.ts
+var DEFAULT_TEMPLATES = {
+  "character-description": "Include character '{name}': {description}.",
+  "object-description": "Include object '{name}': {description}.",
+  "location-description": "Include location '{name}': {description}.",
+  "face-description": "Include the exact face and facial features of '{name}' from the reference image. Maintain perfect likeness and facial identity.",
+  // `-generation` templates drive standalone entity generation routes
+  // (`/v1/generate-character`, `/v1/generate-face`, etc.). Duplicated between
+  // frontend and backend historically; consolidated here so the backend DAG
+  // orchestrator produces the same prompt as a single-node HTTP call.
+  "character-generation": "Create a full-body character portrait: {description}. Style: {style}. Gender: {gender}. High quality, detailed, consistent lighting, neutral background.",
+  "object-generation": "Create a product photo of: {description}. Category: {category}. Clean background, professional studio lighting, high detail.",
+  "location-generation": "Create a cinematic scene of: {description}. Category: {category}. Atmospheric lighting, high detail, wide angle.",
+  "face-generation": "Create a professional close-up face portrait headshot: {description}. Style: {style}. Looking directly at camera, sharp focus on facial features, clean background, studio lighting, high resolution. Maintain exact facial identity and features from the reference image.",
+  "generate-image-wrapper": "{userPrompt}\n{assetDescriptions}"
+};
+function resolveTemplate(key, userTemplates, flowTemplates) {
+  return flowTemplates?.[key] ?? userTemplates?.[key] ?? DEFAULT_TEMPLATES[key] ?? "";
+}
+function applyTemplate(template, vars) {
+  return Object.entries(vars).reduce(
+    (result, [key, value]) => result.replaceAll(`{${key}}`, value || ""),
+    template
+  );
+}
 function composeIdentityDescPart(subject, canonicalDesc, elementInjection) {
   const parts = [];
   const c = canonicalDesc?.trim();
@@ -10587,6 +10642,10 @@ function composeIdentityDescPart(subject, canonicalDesc, elementInjection) {
   if (e) parts.push(e);
   return parts.length > 0 ? `${subject} \u2014 ${parts.join(". ")}` : subject;
 }
+function pushOverrideDirective(out, ref, binding) {
+  const line = referenceDescriptionLine(binding, ref.descriptionOverride);
+  if (line) out.push(line);
+}
 function resolveCharacterMentions(prompt, tokens, refs) {
   const bySlug = /* @__PURE__ */ new Map();
   const byVariant = /* @__PURE__ */ new Map();
@@ -10627,7 +10686,7 @@ function resolveCharacterMentions(prompt, tokens, refs) {
       const includeCanonicalDesc = effectiveMode === "identical" || effectiveMode === "face-pose";
       const descPart = composeIdentityDescPart(
         subject,
-        includeCanonicalDesc ? match.characterCanonicalDescription : void 0,
+        match.descriptionOverride?.trim() || (includeCanonicalDesc ? match.characterCanonicalDescription : void 0),
         match.elementInjection
       );
       directiveLines.push(`- ${descPart}.${directive ? ` ${directive}` : ""}`);
@@ -10705,6 +10764,7 @@ function resolveCharacterMentionsHybrid(prompt, tokens, refs, existingUrls) {
     const binding = bindingFor(m.url);
     const lock = buildIdentityLockLine(withForcedIdentityLock(ref, lockOverrideByUrl.get(m.url)), binding);
     if (lock) lockLines.push(lock);
+    pushOverrideDirective(elementDirectives, ref, binding);
     const inject = ref.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
   }
@@ -10778,7 +10838,8 @@ function resolveLocationMentions(prompt, tokens, refs) {
     const subject = `Image ${t.imageIndex} (${displayName})`;
     const includeCanonicalDesc = effectiveMode === "identical";
     const canonicalDesc = match.locationCanonicalDescription?.trim();
-    const descPart = includeCanonicalDesc && canonicalDesc ? `${subject} \u2014 ${canonicalDesc}` : subject;
+    const shownDesc = match.descriptionOverride?.trim() || (includeCanonicalDesc ? canonicalDesc : void 0);
+    const descPart = shownDesc ? `${subject} \u2014 ${shownDesc}` : subject;
     directiveLines.push(`- ${descPart}.${directive ? ` ${directive}` : ""}`);
     if (t.bucket && t.variant && match.locationVariantDisplayName && match.locationVariantDisplayName !== "canonical") {
       directiveLines.push(`  (in this image: ${match.locationVariantDisplayName})`);
@@ -10846,6 +10907,7 @@ function resolveLocationMentionsHybrid(prompt, tokens, refs, existingUrls) {
     const binding = bindingFor(m.url);
     const lock = buildIdentityLockLine(withForcedIdentityLock(ref, lockOverrideByUrl.get(m.url)), binding);
     if (lock) lockLines.push(lock);
+    pushOverrideDirective(elementDirectives, ref, binding);
     const inject = ref.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
   }
@@ -10895,10 +10957,11 @@ function resolveImageMentionsHybrid(prompt, tokens, refs, existingUrls) {
     const binding = bindingFor(m.url);
     const lock = buildIdentityLockLine(withForcedIdentityLock(ref, lockOverrideByUrl.get(m.url)), binding);
     if (lock) lockLines.push(lock);
+    pushOverrideDirective(elementDirectives, ref, binding);
     const inject = ref.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
   }
-  return { prompt: resolvedPrompt, additionalUrls, lockLines, elementDirectives };
+  return { prompt: resolvedPrompt, additionalUrls, mentionedUrls: seenUrls, lockLines, elementDirectives };
 }
 function resolveEntityMentionsHybrid(prompt, tokens, refs, existingUrls) {
   const bySlug = /* @__PURE__ */ new Map();
@@ -10949,6 +11012,7 @@ function resolveEntityMentionsHybrid(prompt, tokens, refs, existingUrls) {
     const binding = bindingFor(m.url);
     const lock = buildIdentityLockLine(withForcedIdentityLock(ref, lockOverrideByUrl.get(m.url)), binding);
     if (lock) lockLines.push(lock);
+    pushOverrideDirective(elementDirectives, ref, binding);
     const inject = ref.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
   }
@@ -10984,7 +11048,7 @@ function buildCanonicalFallback(refs, mentionedSlugs, startIndex) {
     const subject = `Image ${cursor} (${displayName})`;
     const descPart = composeIdentityDescPart(
       subject,
-      includeCanonicalDesc ? r.characterCanonicalDescription : void 0,
+      r.descriptionOverride?.trim() || (includeCanonicalDesc ? r.characterCanonicalDescription : void 0),
       r.elementInjection
     );
     directiveLines.push(`- ${descPart}.${directive ? ` ${directive}` : ""}`);
@@ -11000,7 +11064,7 @@ function buildExtraRefDirectives(refs, emittedCharacterPositions, startIndex) {
   for (const r of refs) {
     if (!r.isExtraRef) continue;
     if (!r.url) continue;
-    const description = (r.description ?? r.variantDescription ?? "").trim();
+    const description = (r.descriptionOverride ?? "").trim() || (r.description ?? r.variantDescription ?? "").trim();
     if (r.source === "wired-character" && r.characterSlug) {
       const effectiveMode = r.defaultUsageMode ?? DEFAULT_USAGE_MODE;
       const earlierPos = positionsByChar.get(r.characterSlug);
@@ -11064,6 +11128,7 @@ function renderCanonicalFallbackHybrid(refs, letterForUrl) {
     phrases.push(roleToPhrase(resolveDefaultRole(r.defaultRole, r.defaultUsageMode, r.source), binding));
     const lock = buildIdentityLockLine(r, binding);
     if (lock) lockLines.push(lock);
+    pushOverrideDirective(elementDirectives, r, binding);
     const inject = r.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
   }
@@ -11078,7 +11143,7 @@ function renderExtraRefsHybrid(extraRefs, letterForUrl, seedLetterByChar) {
     if (!r.url) continue;
     const letter = letterForUrl(r.url);
     const binding = `reference image ${letter}`;
-    const description = (r.description ?? r.variantDescription ?? "").trim();
+    const description = (r.descriptionOverride ?? "").trim() || (r.description ?? r.variantDescription ?? "").trim();
     if (r.source === "wired-character" && r.characterSlug) {
       const earlier = firstLetterByChar.get(r.characterSlug);
       if (earlier !== void 0 && earlier !== letter) {
@@ -11115,10 +11180,11 @@ function renderLocationCanonicalHybrid(nonCharacterRefs, finalIndexByUrl, covere
     phrases.push(roleToPhrase(resolveLocationRole(null, null, r), binding));
     const lock = buildIdentityLockLine(r, binding);
     if (lock) lockLines.push(lock);
+    pushOverrideDirective(elementDirectives, r, binding);
     const inject = r.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
   }
-  return { phrases, lockLines, elementDirectives };
+  return { phrases, lockLines, elementDirectives, renderedUrls: seenUrls };
 }
 function renderObjectCreatureCanonicalHybrid(nonCharacterRefs, finalIndexByUrl, coveredUrls) {
   const phrases = [];
@@ -11135,10 +11201,24 @@ function renderObjectCreatureCanonicalHybrid(nonCharacterRefs, finalIndexByUrl,
     phrases.push(roleToPhrase(defaultRoleForSource(r.source), binding));
     const lock = buildIdentityLockLine(r, binding);
     if (lock) lockLines.push(lock);
+    pushOverrideDirective(elementDirectives, r, binding);
     const inject = r.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
   }
-  return { phrases, lockLines, elementDirectives };
+  return { phrases, lockLines, elementDirectives, renderedUrls: seenUrls };
+}
+function renderUntoldOverridesHybrid(nonCharacterRefs, finalIndexByUrl, toldUrls) {
+  const lines = [];
+  const sweptUrls = /* @__PURE__ */ new Set();
+  for (const r of nonCharacterRefs) {
+    if (!r.url || toldUrls.has(r.url) || sweptUrls.has(r.url)) continue;
+    const slot = finalIndexByUrl.get(r.url);
+    if (!slot) continue;
+    const before = lines.length;
+    pushOverrideDirective(lines, r, `reference image ${slotToLetter(slot)}`);
+    if (lines.length > before) sweptUrls.add(r.url);
+  }
+  return lines;
 }
 function buildTileIdForUrl(urls, refs, prompt, sourceNodeIdById) {
   const knownSlugs = Array.from(
@@ -11311,8 +11391,10 @@ function buildImagePromptInternal(config2, marks) {
   );
   const suppressedCanonicalLocationIds = config2.suppressedCanonicalLocationIds ?? [];
   const isHybrid = config2.referenceFormat === "hybrid";
+  const describedLines = renderDescribedReferenceLines(config2.describedReferences);
   let hybridBodyConverged = false;
   const mentionedEntityUrls = /* @__PURE__ */ new Set();
+  const mentionedImageUrls = /* @__PURE__ */ new Set();
   if (config2.skipCharacterMentions) {
     config2 = {
       ...config2,
@@ -11430,6 +11512,7 @@ function buildImagePromptInternal(config2, marks) {
           resolved.additionalUrls = [...resolved.additionalUrls, ...hi.additionalUrls];
           hybridImageLockLines = hi.lockLines;
           hybridImageElementDirectives = hi.elementDirectives;
+          for (const u of hi.mentionedUrls) mentionedImageUrls.add(u);
           if (hi.additionalUrls.length > 0) hybridBodyConverged = true;
         }
       }
@@ -11560,9 +11643,13 @@ ${promptForNext}`;
       referenceImageUrls = config2.referenceImageUrls || [];
     }
   }
-  if (connectedReferences) {
+  if (connectedReferences || describedLines.length > 0) {
+    const structuredRefs = connectedReferences ?? [];
     let prompt2 = config2.prompt;
-    const nonCharacterRefs = connectedReferences.filter(
+    if (!isHybrid && describedLines.length > 0) {
+      prompt2 = appendReferenceLines(prompt2, describedLines, "legacy");
+    }
+    const nonCharacterRefs = structuredRefs.filter(
       (r) => r.source !== "wired-character" && r.isExtraRef !== true
     );
     const nonCharacterUrls = nonCharacterRefs.map((r) => r.url).filter((u) => Boolean(u));
@@ -11592,11 +11679,23 @@ ${promptForNext}`;
       const canonLockBlock = canonLockLines.length > 0 ? `${canonLockLines.join("\n")}
 
 ` : "";
+      const toldOverrideUrls = /* @__PURE__ */ new Set([
+        ...locCanon.renderedUrls,
+        ...objCanon.renderedUrls,
+        ...mentionedEntityUrls,
+        ...mentionedImageUrls
+      ]);
+      const untoldOverrides = renderUntoldOverridesHybrid(
+        nonCharacterRefs,
+        finalIndexByUrl,
+        toldOverrideUrls
+      );
       const canonTrailingLines = [
         ...locCanon.phrases,
         ...objCanon.phrases,
         ...locCanon.elementDirectives,
-        ...objCanon.elementDirectives
+        ...objCanon.elementDirectives,
+        ...untoldOverrides
       ];
       const composedScene = `${canonLockBlock}${insertBeforeStyleSection(scene, canonTrailingLines)}`;
       prompt2 = config2.referenceLockSnippet ? `${config2.referenceLockSnippet}
@@ -11623,6 +11722,9 @@ ${directives}`;
         }
       }
     }
+    if (isHybrid && describedLines.length > 0) {
+      prompt2 = appendReferenceLines(prompt2, describedLines, "hybrid");
+    }
     const styleText2 = style?.trim();
     const styleLine2 = styleText2 && !isDeniedStyleId(styleText2) ? `Style: ${getStylePromptHint(styleText2) || styleText2}` : "";
     const negPrompt2 = negativePrompt?.trim();
@@ -11663,7 +11765,7 @@ ${directives}`;
       const reordered = applyReferenceOrder(
         assembledUrls,
         prompt2,
-        connectedReferences,
+        structuredRefs,
         referenceOrder,
         sourceNodeIdById
       );
@@ -11788,7 +11890,10 @@ function collectIdentities(prompt, refs, meta3) {
       label,
       fidelity: m?.fidelity ?? defaultFidelityForSource(ref?.source),
       customText: m?.customText?.trim() || void 0,
-      description: ref?.description,
+      // Per-use override ahead of the ref's own description; the directive
+      // builder's location-canonical fallback only fires when BOTH are absent,
+      // so an override outranks the stored location wording too.
+      description: ref?.descriptionOverride?.trim() || ref?.description,
       source: ref?.source,
       locationCanonicalDescription: ref?.locationCanonicalDescription,
       locationSlug: ref?.locationSlug,
@@ -11896,7 +12001,7 @@ function buildNonCharacterDirectives(prompt, nonCharacterRefs, identityMeta, fin
         // wired-object falls through to the strict "match exactly" verb.
         label: ref.source === "wired-location" ? "location" : ref.source === "wired-creature" ? "creature" : "object",
         fidelity: defaultFidelityForSource(ref.source),
-        description: ref.description?.trim() || void 0,
+        description: ref.descriptionOverride?.trim() || ref.description?.trim() || void 0,
         source: ref.source,
         locationCanonicalDescription: ref.locationCanonicalDescription,
         locationSlug: ref.locationSlug,
@@ -12423,6 +12528,8 @@ function resolveVideoCharacterMentionsHybrid(prompt, tokens, refs, offset) {
     const binding = bindingFor(m.url);
     const lock = buildIdentityLockLine(withForcedIdentityLock(ref, lockOverrideByUrl.get(m.url)), binding);
     if (lock) lockLines.push(lock);
+    const overrideLine = referenceDescriptionLine(binding, ref.descriptionOverride);
+    if (overrideLine) elementDirectives.push(overrideLine);
     const inject = ref.elementInjection?.trim();
     if (inject) elementDirectives.push(inject);
   }
@@ -12448,6 +12555,13 @@ function resolveVideoReferenceCore(args) {
     video: args.videoRefCount ?? 0,
     audio: args.audioRefCount ?? 0
   });
+  const describedAndCaptionLines = [
+    ...renderDescribedReferenceLines(args.describedReferences),
+    ...renderReferenceCaptionLines(args.videoCaptions, args.audioCaptions, {
+      video: args.videoRefCount ?? 0,
+      audio: args.audioRefCount ?? 0
+    })
+  ];
   let wiredCharRefs = [...args.wiredCharRefs];
   const suppressedSlugs = new Set(args.suppressedCanonicalCharacterIds ?? []);
   if (suppressedSlugs.size > 0) {
@@ -12472,14 +12586,15 @@ function resolveVideoReferenceCore(args) {
   const slotByRefId = /* @__PURE__ */ new Map();
   if (wiredCharRefs.length === 0 && !hasExtras) {
     const counts = tokenCounts(leadingRefUrls.length);
+    const resolved2 = resolveReferenceTokens(
+      resolveRefIdTokens(args.prompt, { slotById: slotByRefId, nameById: nameByRefId, imageCount: counts.image }),
+      counts
+    );
     return {
-      // tokenCounts(leadingRefUrls.length) → image count == offset (no assets here):
-      // leadingRefUrls mode counts the leading refs; ordinalOffset mode counts the
-      // caller-owned leading refs the offset stands in for.
-      prompt: resolveReferenceTokens(
-        resolveRefIdTokens(args.prompt, { slotById: slotByRefId, nameById: nameByRefId, imageCount: counts.image }),
-        counts
-      ),
+      // 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 ? appendReferenceLines(resolved2 ?? "", describedAndCaptionLines, args.hybridRoles === true ? "hybrid" : "legacy") : resolved2,
       additionalUrls: [...leadingRefUrls]
     };
   }
@@ -12537,6 +12652,8 @@ function resolveVideoReferenceCore(args) {
       canonicalPhrases.push(roleToPhrase(resolveDefaultRole(r.defaultRole, r.defaultUsageMode, r.source), binding));
       const lock = buildIdentityLockLine(r, binding);
       if (lock) canonicalLockLines.push(lock);
+      const overrideLine = referenceDescriptionLine(binding, r.descriptionOverride);
+      if (overrideLine) canonicalElementDirectives.push(overrideLine);
       const inject = r.elementInjection?.trim();
       if (inject) canonicalElementDirectives.push(inject);
       continue;
@@ -12553,7 +12670,10 @@ function resolveVideoReferenceCore(args) {
     const directive = usageModeDirective(effectiveMode);
     const includeCanonicalDesc = effectiveMode === "identical" || effectiveMode === "face-pose";
     const descBodyParts = [];
-    if (includeCanonicalDesc && r.characterCanonicalDescription?.trim()) {
+    const canonicalOverride = r.descriptionOverride?.trim();
+    if (canonicalOverride) {
+      descBodyParts.push(canonicalOverride);
+    } else if (includeCanonicalDesc && r.characterCanonicalDescription?.trim()) {
       descBodyParts.push(r.characterCanonicalDescription.trim());
     }
     if (r.elementInjection?.trim()) descBodyParts.push(r.elementInjection.trim());
@@ -12570,7 +12690,7 @@ function resolveVideoReferenceCore(args) {
       if (!ex.url) continue;
       position += 1;
       if (ex.id && !slotByRefId.has(ex.id)) slotByRefId.set(ex.id, position);
-      const desc = (ex.description ?? "").trim();
+      const desc = (ex.descriptionOverride ?? "").trim() || (ex.description ?? "").trim();
       if (ex.characterSlug) {
         const meta3 = args.lookupCharacterBySlug?.(ex.characterSlug);
         const charDefaultMode = meta3?.defaultUsageMode;
@@ -12714,6 +12834,11 @@ ${finalPrompt}` : block;
       merged.push(u);
     }
   }
+  finalPrompt = appendReferenceLines(
+    finalPrompt,
+    describedAndCaptionLines,
+    hybrid ? "hybrid" : "legacy"
+  );
   finalPrompt = resolveRefIdTokens(finalPrompt, {
     slotById: slotByRefId,
     nameById: nameByRefId,
@@ -12928,6 +13053,7 @@ function assembleImageInput(input) {
     prompt: composePromptText(input.userPrompt, pieces, keptHintClauses),
     provider: input.provider,
     ...input.connectedReferences !== void 0 ? { connectedReferences: input.connectedReferences } : {},
+    ...input.describedReferences !== void 0 ? { describedReferences: input.describedReferences } : {},
     // Manual uploads / direct refs ride the builder's reference-URL channel so
     // the per-provider reference gate filters them alongside bound entities.
     // Omit the field entirely when absent so the builder's default ([]) kicks
@@ -29353,6 +29479,8 @@ var NODE_PROMPT_FIELDS = {
   // ── Composition / FX (compact, no media-result preview → no inline editor) ──
   "image-critic": { prompt: "prompt", promptLabel: "Criteria", media: "image", inline: false },
   "motion-graphics": { prompt: "motionPrompt", promptLabel: "Motion prompt", media: "video", inline: false },
+  "generate-3d-scene": { prompt: "scenePrompt", promptLabel: "Scene", media: "text", inline: false },
+  "edit-3d-scene": { prompt: "editPrompt", promptLabel: "Edit instruction", media: "text", inline: false },
   "3d-title": { prompt: "titlePrompt", promptLabel: "Title", media: "text", inline: false },
   // ── Script / alignment (their primary text field) ──
   "generate-script": { prompt: "styleGuide", promptLabel: "Style guide", media: "text", inline: false },
@@ -34636,6 +34764,6 @@ function buildSurroundFillPrompt(direction, userPrompt) {
   return `${scene}This is a partial frame: the ${carried} portion contains real, finished pixels and the ${painted} portion is flat gray that MUST be painted in. Paint ONLY the ${painted} gray region as a natural, seamless continuation of the ${carried} portion \u2014 same scene, same perspective, continuing the horizon, geometry, and content across the boundary with no break. Keep the ${carried} portion completely unchanged. CRITICAL: do NOT change the lighting, exposure, white balance, or time of day. Match the ${carried} portion's EXACT light, color temperature, and contrast across the whole frame \u2014 if it is flat overcast daylight, keep flat overcast daylight. No golden hour, no sunset, no warm relight, no cinematic regrade. The seam between the ${carried} and ${painted} portions must be invisible. No people, no text, no labels, no watermarks.`;
 }
 
-export { ACTION_FX, ACTION_FX_CATEGORY_LABELS, ACTION_FX_CATEGORY_ORDER, ACTION_FX_IDS, ADULT_AGE_IDS, ADULT_ONLY_FLAG, ADULT_SWEPT_CATALOG_IDS, AESTHETICS, AESTHETIC_CATEGORY_LABELS, AESTHETIC_CATEGORY_ORDER, AESTHETIC_IDS, ALL_PICKER_WIRING, ANALYZABLE_PICKER_TYPES, ANGLE_LABELS, ASPECT_RATIO_LABELS, ATMOSPHERES, ATMOSPHERE_IDS, AUDIO_WIZARD_CATEGORIES, BACKDROPS, BACKDROP_CATEGORY_LABELS, BACKDROP_CATEGORY_ORDER, BACKDROP_IDS, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_META, CAMERA_FORMATS, CAMERA_FORMAT_IDS, CAMERA_MOTIONS, CAMERA_MOTION_CATEGORY_LABELS, CAMERA_MOTION_CATEGORY_ORDER, CAMERA_MOTION_IDS, CHARACTER_FX, CHARACTER_FX_CATEGORY_LABELS, CHARACTER_FX_CATEGORY_ORDER, CHARACTER_FX_DURATIONS, CHARACTER_FX_IDS, CHARACTER_FX_INTENSITIES, CHARACTER_FX_POSITIONS, CINEMATIC_LOOK_TAIL, COLOR_LOOKS, COLOR_LOOK_CATEGORY_LABELS, COLOR_LOOK_CATEGORY_ORDER, COLOR_LOOK_IDS, COMPOSITION_EFFECTS, COMPOSITION_EFFECT_IDS, DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, DIRECTION_ARRAY_CEILING, DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_KEYS, ERAS, ERA_CATEGORY_LABELS, ERA_CATEGORY_ORDER, ERA_IDS, EXPOSURE_CATEGORY_LABELS, EXPOSURE_CATEGORY_ORDER, EXPOSURE_FIELD_BY_CATEGORY, EXPOSURE_IDS, EXPOSURE_SETTINGS, FACTORY_PRESETS, FACTORY_SNIPPETS, FILM_STILL_PREFIX, FILM_STYLE_KEYS, FLOORED_PICKER_KEYS, FRAMINGS, FRAMING_CATEGORY_LABELS, FRAMING_CATEGORY_ORDER, FRAMING_FIELD_BY_CATEGORY, FRAMING_IDS, GAPS_SCHEMA, HELD_PROPS, HELD_PROP_CATEGORY_LABELS, HELD_PROP_CATEGORY_ORDER, HELD_PROP_IDS, IMAGE_HINT_MODE_DEFAULT, IMAGE_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, INSTRUMENTATION_DEFAULT_DATA, INSTRUMENTS, INSTRUMENT_CATEGORY_LABELS, INSTRUMENT_CATEGORY_ORDER, LENSES, LENS_IDS, LIGHTINGS, LIGHTING_CATEGORY_LABELS, LIGHTING_CATEGORY_ORDER, LIGHTING_FIELD_BY_CATEGORY, LIGHTING_IDS, LLM_CHAT_WIZARD_CATEGORIES, LOOP_SUBJECTS, LOOP_SUBJECT_CATEGORY_LABELS, LOOP_SUBJECT_CATEGORY_ORDER, MATERIALS, MATERIAL_CATEGORY_LABELS, MATERIAL_CATEGORY_ORDER, MATERIAL_IDS, MAX_SELECTED_BY_DIMENSION, MAX_SELECTED_BY_FRAMING_CATEGORY, MAX_SELECTED_BY_STYLING_DIMENSION, MAX_SUBJECT_KEYS, MINOR_IMPLYING_TYPE_IDS, MOODS, MOOD_CATEGORY_LABELS, MOOD_CATEGORY_ORDER, MOOD_IDS, MOVEMENT_LABELS, MULTI_PICKER_WIRING, MUSIC_EMOTIONS, MUSIC_ENERGIES, MUSIC_ERAS, MUSIC_GENRES, MUSIC_GENRE_CATEGORY_LABELS, MUSIC_GENRE_CATEGORY_ORDER, MUSIC_GENRE_DEFAULT_DATA, MUSIC_MOOD_DEFAULT_DATA, MUSIC_VIBES, MUSIC_WIZARD_CATEGORIES, NODE_PROMPT_CANDIDATE_FIELDS, NODE_PROMPT_FIELDS, OBJECT_ANGLE_PRESETS, OBJECT_ANGLE_PROMPTS, OBJECT_ASSET_PRESETS, OBJECT_ASSET_PROMPTS, OBJECT_MATERIAL_PRESETS, OBJECT_MATERIAL_PROMPTS, OBJECT_VARIATION_PRESETS, OBJECT_VARIATION_PROMPTS, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PERSON_DIMENSION_SECTIONS, PERSON_FIELD_BY_DIMENSION, PERSON_IDS, PHOTOGRAPHERS, PHOTOGRAPHER_CATEGORY_LABELS, PHOTOGRAPHER_CATEGORY_ORDER, PHOTOGRAPHER_IDS, PHOTO_GENRES, PHOTO_GENRE_CATEGORY_LABELS, PHOTO_GENRE_CATEGORY_ORDER, PHOTO_GENRE_IDS, PICKER_ANALYZER_FAMILIES, PICKER_ANALYZER_REGISTRY, PICKER_CATALOGS, PICKER_TYPES, POSES, POSE_CATEGORY_LABELS, POSE_CATEGORY_ORDER, POSE_IDS, POST_PROCESS_EFFECTS, POST_PROCESS_EFFECT_IDS, PRODUCTION_STYLES, PROMPT_AFFIX_CORE_FIELD_OVERRIDES, PROMPT_AFFIX_NODE_TYPES, PROMPT_HINT_SEPARATOR, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, REFERENCE_IMAGE_ROLES, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, REF_BINDING, RENDER_QUALITIES, RENDER_QUALITY_IDS, RETIRED_ADULT_ONLY_HINT_STRINGS, SCENE_FRAME_RULE, SCENE_PROMPT_MAX_LENGTH, SETTINGS, SETTING_CATEGORY_LABELS, SETTING_IDS, SHOT_LABELS, SINGING_STYLES, SINGLE_PICKER_WIRING, SNIPPET_MEDIA_VALUES, STYLES, STYLE_IDS, STYLE_PRESETS, STYLE_SECTION_GAP, STYLE_SECTION_HEADER, STYLINGS, STYLING_DIMENSION_LABELS, STYLING_DIMENSION_ORDER, STYLING_FIELD_BY_DIMENSION, STYLING_IDS, SUBJECT_ARRAY_CEILING, SUBJECT_CUSTOM_AGE_KEY, SUBJECT_FIELDS, SUBJECT_FOLD_KEYS, SUBJECT_ID_MAX_CHARS, SUBJECT_IMAGE_HINT_MODE_DEFAULT, SUBJECT_KEYS, SUBJECT_KEY_MAX_CHARS, SUBJECT_VIDEO_HINT_MODE_DEFAULT, TEMPORALS, TEMPORAL_CATEGORY_LABELS, TEMPORAL_CATEGORY_ORDER, TEMPORAL_FIELD_BY_CATEGORY, TEMPORAL_IDS, TERM_MAX_CHARS, TEXT_WIZARD_CATEGORIES, TRANSITIONS, TRANSITION_CATEGORY_LABELS, TRANSITION_CATEGORY_ORDER, TRANSITION_DURATIONS, TRANSITION_IDS, TRANSITION_INTENSITIES, TRANSITION_POSITIONS, VIDEO_HINT_MODE_DEFAULT, VIDEO_WIZARD_CATEGORIES, VOCAL_PRESENCE, VOCAL_PRESENCE_INSTRUMENTAL_ID, VOICE_ACCENTS, VOICE_AGES, VOICE_ARCHETYPES, VOICE_CHARACTER_DEFAULT_DATA, VOICE_DELIVERY_DEFAULT_DATA, VOICE_EMOTIONS, VOICE_GENDERS, VOICE_LANGUAGES, VOICE_PACES, VOICE_TIMBRES, WARDROBE, WARDROBE_CATEGORY_LABELS, WARDROBE_DIMENSION_ORDER, WARDROBE_FIELD_BY_DIMENSION, __resetCatalogIdGuardForTests, appendField, appendMusicMeta, applyMinorAgeFloorToPickerValues, applyPickerJson, applyPromptAffixes, applyReferenceOrderToVideo, applyTemplate, asBodyClauses, assembleImageInput, assembleSunoInput, buildActionFxHints, buildActionFxTerms, buildAestheticHints, buildAestheticTerms, buildAgeHint, buildAtmosphereHints, buildAtmosphereTerms, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildExposureTerms, buildFaceTemplateInputs, buildFramingHints, buildFramingTerms, buildHeldPropHints, buildHeldPropTerms, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildImagePromptWithOverflow, buildInstrumentationHints, buildInstrumentationTerms, buildLightingHints, buildLightingTerms, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMaterialTerms, buildMoodHints, buildMoodTerms, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicGenreTerms, buildMusicMoodHints, buildMusicMoodTerms, buildNeedleAlternationSource, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPersonTerms, buildPhotographerHints, buildPhotographerTerms, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPoseTerms, buildPostProcessHints, buildPostProcessTerms, buildReferenceBlocks, buildScenePrompt, buildStylingHints, buildStylingTerms, buildSurroundFillPrompt, buildTemporalHints, buildTemporalTerms, buildVoiceCharacterHints, buildVoiceCharacterTerms, buildVoiceDeliveryHints, buildVoiceDeliveryTerms, buildWardrobeHints, catalogGuardActive, catalogPacksVersion, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCameraMotionTermFromConnections, composeCharacterFxHintFromConnections, composeNegative, composePickerCatalogs, composeSectionedPrompt, composeSoundHintFromConnections, composeTransitionHintFromConnections, composeVideoPromptText, composedHas, composedOption, composedOptionIndex, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, containsMinorAgeHint, curateEntries, curatedAnimalPromptHint, curatedAnimalTerm, curatedFurnitureText, curatedVehicleText, curatedWeaponText, deriveTerm, directionFieldsForSurface, endsInsideStyleSection, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, findForeignCatalogIds, findForeignCatalogIdsInBody, foreignCatalogIdMessage, getActionFx, getActionFxLabel, getActionFxPromptHint, getActionFxTerm, getAdultOnlyEntries, getAdultOnlyHintStrings, getAdultOnlyIds, getAesthetic, getAestheticLabel, getAestheticPromptHint, getAestheticTerm, getAtmosphere, getAtmosphereLabel, getAtmospherePromptHint, getAtmosphereTerm, getBackdrop, getBackdropLabel, getBackdropPromptHint, getBackdropTerm, getCameraFormat, getCameraFormatLabel, getCameraFormatPromptHint, getCameraFormatTerm, getCameraMotion, getCameraMotionLabel, getCameraMotionPromptHint, getCameraMotionTerm, getCategoriesForNodeType, getCharacterFx, getCharacterFxLabel, getCharacterFxPromptHint, getCharacterFxTerm, getColorLook, getColorLookLabel, getColorLookPromptHint, getColorLookTerm, getCompositionEffect, getCompositionEffectLabel, getCompositionEffectPromptHint, getCompositionEffectTerm, getEffectiveSunoCustomMode, getEra, getEraLabel, getEraPromptHint, getEraTerm, getExposure, getExposureLabel, getExposurePromptHint, getExposureTerm, getFactoryPresets, getFactorySnippets, getFraming, getFramingCategoryLimit, getFramingLabel, getFramingPromptHint, getFramingTerm, getHeldProp, getHeldPropLabel, getHeldPropPromptHint, getHeldPropTerm, getIdentityLockClause, getInstrument, getInstrumentTerm, getLens, getLensLabel, getLensPromptHint, getLensTerm, getLighting, getLightingLabel, getLightingPromptHint, getLightingTerm, getLoopSubject, getLoopSubjectLabel, getLoopSubjectPromptHint, getLoopSubjectTerm, getMaterial, getMaterialLabel, getMaterialPromptHint, getMaterialTerm, getMinorAgeHintStrings, getMood, getMoodLabel, getMoodPromptHint, getMoodTerm, getMusicEmotion, getMusicEmotionTerm, getMusicEnergy, getMusicEnergyTerm, getMusicEra, getMusicEraTerm, getMusicGenre, getMusicGenreLabel, getMusicGenreTerm, getMusicSubgenre, getMusicSubgenreTerm, getMusicVibe, getMusicVibeTerm, getParameterPromptHint, getPerson, getPersonDimensionLimit, getPersonLabel, getPersonPromptHint, getPersonTerm, getPhotoGenre, getPhotoGenreLabel, getPhotoGenrePromptHint, getPhotoGenreTerm, getPhotographer, getPhotographerLabel, getPhotographerPromptHint, getPhotographerTerm, getPickerAnalyzer, getPickerCatalog, getPickerWiring, getPose, getPoseLabel, getPosePromptHint, getPoseTerm, getPostProcessEffect, getPostProcessEffectLabel, getPostProcessEffectPromptHint, getPostProcessEffectTerm, getProductionStyle, getProductionStyleTerm, getPromptDoctrine, getPromptFields, getPromptTips, getRegisteredCatalogPacks, getRegisteredPeople, getRegisteredPersonDimensionLabels, getRegisteredPersonDimensionOrder, getRegisteredPersonFieldByDimension, getRegisteredPickerCatalogs, getRegisteredSubjectKeys, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getRenderQualityTerm, getSetting, getSettingLabel, getSettingPromptHint, getSettingTerm, getSingingStyle, getSingingStyleTerm, getSnippetMedia, getStyle, getStyleLabel, getStylePreset, getStylePromptHint, getStyleTerm, getStyling, getStylingDimensionLimit, getStylingLabel, getStylingPromptHint, getStylingTerm, getTemporal, getTemporalLabel, getTemporalPromptHint, getTemporalTerm, getTransition, getTransitionLabel, getTransitionPromptHint, getTransitionTerm, getVocalPresence, getVocalPresenceTerm, getVoiceAccent, getVoiceAccentTerm, getVoiceAge, getVoiceAgeTerm, getVoiceArchetype, getVoiceArchetypeTerm, getVoiceEmotion, getVoiceEmotionTerm, getVoiceGender, getVoiceGenderTerm, getVoiceLanguage, getVoiceLanguageTerm, getVoicePace, getVoicePaceTerm, getVoiceTimbre, getVoiceTimbreTerm, getWardrobeEntriesByDimension, getWardrobeEntry, getWardrobePromptHint, groupFactoryPresets, hasCatalogPacksFor, hasUpstreamCharacter, identityRefsSentence, insertBeforeStyleSection, isAnalyzablePicker, isDeniedStyleId, isInstrumentalVocal, isMinorAge, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, joinPromptHints, joinPromptParts, keepableDirectionHints, listPickerCatalogs, migratePersonValue, modeForFamily, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, normalizeSubjectFields, overlayEntry, partitionStyleClauses, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, readDirectionFields, readStructuredFields, readSubjectFields, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderDirectionHintClauses, renderDirectionHints, renderStructuredFields, renderStyleSection, renderSubjectHints, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, sectionedClauseCosts, setComposedCatalogResolver, splitStyleSection, styleSectionFromClauses, styleSlotFor, subjectFieldsForSurface, subscribeCatalogPacks, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };
+export { ACTION_FX, ACTION_FX_CATEGORY_LABELS, ACTION_FX_CATEGORY_ORDER, ACTION_FX_IDS, ADULT_AGE_IDS, ADULT_ONLY_FLAG, ADULT_SWEPT_CATALOG_IDS, AESTHETICS, AESTHETIC_CATEGORY_LABELS, AESTHETIC_CATEGORY_ORDER, AESTHETIC_IDS, ALL_PICKER_WIRING, ANALYZABLE_PICKER_TYPES, ANGLE_LABELS, ASPECT_RATIO_LABELS, ATMOSPHERES, ATMOSPHERE_IDS, AUDIO_WIZARD_CATEGORIES, BACKDROPS, BACKDROP_CATEGORY_LABELS, BACKDROP_CATEGORY_ORDER, BACKDROP_IDS, BRAND_PRESETS, BRAND_PRESET_IDS, BRAND_PRESET_META, CAMERA_FORMATS, CAMERA_FORMAT_IDS, CAMERA_MOTIONS, CAMERA_MOTION_CATEGORY_LABELS, CAMERA_MOTION_CATEGORY_ORDER, CAMERA_MOTION_IDS, CHARACTER_FX, CHARACTER_FX_CATEGORY_LABELS, CHARACTER_FX_CATEGORY_ORDER, CHARACTER_FX_DURATIONS, CHARACTER_FX_IDS, CHARACTER_FX_INTENSITIES, CHARACTER_FX_POSITIONS, CINEMATIC_LOOK_TAIL, COLOR_LOOKS, COLOR_LOOK_CATEGORY_LABELS, COLOR_LOOK_CATEGORY_ORDER, COLOR_LOOK_IDS, COMPOSITION_EFFECTS, COMPOSITION_EFFECT_IDS, DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, DIRECTION_ARRAY_CEILING, DIRECTION_FIELDS, DIRECTION_ID_MAX_CHARS, DIRECTION_KEYS, ERAS, ERA_CATEGORY_LABELS, ERA_CATEGORY_ORDER, ERA_IDS, EXPOSURE_CATEGORY_LABELS, EXPOSURE_CATEGORY_ORDER, EXPOSURE_FIELD_BY_CATEGORY, EXPOSURE_IDS, EXPOSURE_SETTINGS, FACTORY_PRESETS, FACTORY_SNIPPETS, FILM_STILL_PREFIX, FILM_STYLE_KEYS, FLOORED_PICKER_KEYS, FRAMINGS, FRAMING_CATEGORY_LABELS, FRAMING_CATEGORY_ORDER, FRAMING_FIELD_BY_CATEGORY, FRAMING_IDS, GAPS_SCHEMA, HELD_PROPS, HELD_PROP_CATEGORY_LABELS, HELD_PROP_CATEGORY_ORDER, HELD_PROP_IDS, IMAGE_HINT_MODE_DEFAULT, IMAGE_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, INSTRUMENTATION_DEFAULT_DATA, INSTRUMENTS, INSTRUMENT_CATEGORY_LABELS, INSTRUMENT_CATEGORY_ORDER, LENSES, LENS_IDS, LIGHTINGS, LIGHTING_CATEGORY_LABELS, LIGHTING_CATEGORY_ORDER, LIGHTING_FIELD_BY_CATEGORY, LIGHTING_IDS, LLM_CHAT_WIZARD_CATEGORIES, LOOP_SUBJECTS, LOOP_SUBJECT_CATEGORY_LABELS, LOOP_SUBJECT_CATEGORY_ORDER, MATERIALS, MATERIAL_CATEGORY_LABELS, MATERIAL_CATEGORY_ORDER, MATERIAL_IDS, MAX_SELECTED_BY_DIMENSION, MAX_SELECTED_BY_FRAMING_CATEGORY, MAX_SELECTED_BY_STYLING_DIMENSION, MAX_SUBJECT_KEYS, MINOR_IMPLYING_TYPE_IDS, MOODS, MOOD_CATEGORY_LABELS, MOOD_CATEGORY_ORDER, MOOD_IDS, MOVEMENT_LABELS, MULTI_PICKER_WIRING, MUSIC_EMOTIONS, MUSIC_ENERGIES, MUSIC_ERAS, MUSIC_GENRES, MUSIC_GENRE_CATEGORY_LABELS, MUSIC_GENRE_CATEGORY_ORDER, MUSIC_GENRE_DEFAULT_DATA, MUSIC_MOOD_DEFAULT_DATA, MUSIC_VIBES, MUSIC_WIZARD_CATEGORIES, NODE_PROMPT_CANDIDATE_FIELDS, NODE_PROMPT_FIELDS, OBJECT_ANGLE_PRESETS, OBJECT_ANGLE_PROMPTS, OBJECT_ASSET_PRESETS, OBJECT_ASSET_PROMPTS, OBJECT_MATERIAL_PRESETS, OBJECT_MATERIAL_PROMPTS, OBJECT_VARIATION_PRESETS, OBJECT_VARIATION_PROMPTS, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PERSON_DIMENSION_SECTIONS, PERSON_FIELD_BY_DIMENSION, PERSON_IDS, PHOTOGRAPHERS, PHOTOGRAPHER_CATEGORY_LABELS, PHOTOGRAPHER_CATEGORY_ORDER, PHOTOGRAPHER_IDS, PHOTO_GENRES, PHOTO_GENRE_CATEGORY_LABELS, PHOTO_GENRE_CATEGORY_ORDER, PHOTO_GENRE_IDS, PICKER_ANALYZER_FAMILIES, PICKER_ANALYZER_REGISTRY, PICKER_CATALOGS, PICKER_TYPES, POSES, POSE_CATEGORY_LABELS, POSE_CATEGORY_ORDER, POSE_IDS, POST_PROCESS_EFFECTS, POST_PROCESS_EFFECT_IDS, PRODUCTION_STYLES, PROMPT_AFFIX_CORE_FIELD_OVERRIDES, PROMPT_AFFIX_NODE_TYPES, PROMPT_HINT_SEPARATOR, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, REFERENCE_IMAGE_ROLES, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, REF_BINDING, RENDER_QUALITIES, RENDER_QUALITY_IDS, RETIRED_ADULT_ONLY_HINT_STRINGS, SCENE_FRAME_RULE, SCENE_PROMPT_MAX_LENGTH, SETTINGS, SETTING_CATEGORY_LABELS, SETTING_IDS, SHOT_LABELS, SINGING_STYLES, SINGLE_PICKER_WIRING, SNIPPET_MEDIA_VALUES, STYLES, STYLE_IDS, STYLE_PRESETS, STYLE_SECTION_GAP, STYLE_SECTION_HEADER, STYLINGS, STYLING_DIMENSION_LABELS, STYLING_DIMENSION_ORDER, STYLING_FIELD_BY_DIMENSION, STYLING_IDS, SUBJECT_ARRAY_CEILING, SUBJECT_CUSTOM_AGE_KEY, SUBJECT_FIELDS, SUBJECT_FOLD_KEYS, SUBJECT_ID_MAX_CHARS, SUBJECT_IMAGE_HINT_MODE_DEFAULT, SUBJECT_KEYS, SUBJECT_KEY_MAX_CHARS, SUBJECT_VIDEO_HINT_MODE_DEFAULT, TEMPORALS, TEMPORAL_CATEGORY_LABELS, TEMPORAL_CATEGORY_ORDER, TEMPORAL_FIELD_BY_CATEGORY, TEMPORAL_IDS, TERM_MAX_CHARS, TEXT_WIZARD_CATEGORIES, TRANSITIONS, TRANSITION_CATEGORY_LABELS, TRANSITION_CATEGORY_ORDER, TRANSITION_DURATIONS, TRANSITION_IDS, TRANSITION_INTENSITIES, TRANSITION_POSITIONS, VIDEO_HINT_MODE_DEFAULT, VIDEO_WIZARD_CATEGORIES, VOCAL_PRESENCE, VOCAL_PRESENCE_INSTRUMENTAL_ID, VOICE_ACCENTS, VOICE_AGES, VOICE_ARCHETYPES, VOICE_CHARACTER_DEFAULT_DATA, VOICE_DELIVERY_DEFAULT_DATA, VOICE_EMOTIONS, VOICE_GENDERS, VOICE_LANGUAGES, VOICE_PACES, VOICE_TIMBRES, WARDROBE, WARDROBE_CATEGORY_LABELS, WARDROBE_DIMENSION_ORDER, WARDROBE_FIELD_BY_DIMENSION, __resetCatalogIdGuardForTests, appendField, appendMusicMeta, appendReferenceLines, applyMinorAgeFloorToPickerValues, applyPickerJson, applyPromptAffixes, applyReferenceOrderToVideo, applyTemplate, asBodyClauses, assembleImageInput, assembleSunoInput, buildActionFxHints, buildActionFxTerms, buildAestheticHints, buildAestheticTerms, buildAgeHint, buildAtmosphereHints, buildAtmosphereTerms, buildCharacterPrompt, buildCreaturePrompt, buildExposureHints, buildExposureTerms, buildFaceTemplateInputs, buildFramingHints, buildFramingTerms, buildHeldPropHints, buildHeldPropTerms, buildIdentityDirectives, buildIdentityLockLine, buildImagePrompt, buildImagePromptSegments, buildImagePromptWithOverflow, buildInstrumentationHints, buildInstrumentationTerms, buildLightingHints, buildLightingTerms, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMaterialHints, buildMaterialTerms, buildMoodHints, buildMoodTerms, buildMotionPrompt, buildMultiPickerAnalyzerSpec, buildMusicGenreHints, buildMusicGenreTerms, buildMusicMoodHints, buildMusicMoodTerms, buildNeedleAlternationSource, buildObjectMotionPrompt, buildObjectPrompt, buildPersonHints, buildPersonTerms, buildPhotographerHints, buildPhotographerTerms, buildPickerAnalyzerSpec, buildPickerLegend, buildPickerZodSchema, buildPoseHints, buildPoseTerms, buildPostProcessHints, buildPostProcessTerms, buildReferenceBlocks, buildScenePrompt, buildStylingHints, buildStylingTerms, buildSurroundFillPrompt, buildTemporalHints, buildTemporalTerms, buildVoiceCharacterHints, buildVoiceCharacterTerms, buildVoiceDeliveryHints, buildVoiceDeliveryTerms, buildWardrobeHints, catalogGuardActive, catalogPacksVersion, characterLockToRefLock, collectIdentityLockClause, composeCameraMotionHintFromConnections, composeCameraMotionTermFromConnections, composeCharacterFxHintFromConnections, composeNegative, composePickerCatalogs, composeSectionedPrompt, composeSoundHintFromConnections, composeTransitionHintFromConnections, composeVideoPromptText, composedHas, composedOption, composedOptionIndex, computeLlmChatFields, computeNodePrompt, computePackSidecarCoverage, containsMinorAgeHint, curateEntries, curatedAnimalPromptHint, curatedAnimalTerm, curatedFurnitureText, curatedVehicleText, curatedWeaponText, deriveTerm, directionFieldsForSurface, endsInsideStyleSection, expandImagePositionRefs, expandImageRefTokens, filmStillPrefix, findForeignCatalogIds, findForeignCatalogIdsInBody, foreignCatalogIdMessage, getActionFx, getActionFxLabel, getActionFxPromptHint, getActionFxTerm, getAdultOnlyEntries, getAdultOnlyHintStrings, getAdultOnlyIds, getAesthetic, getAestheticLabel, getAestheticPromptHint, getAestheticTerm, getAtmosphere, getAtmosphereLabel, getAtmospherePromptHint, getAtmosphereTerm, getBackdrop, getBackdropLabel, getBackdropPromptHint, getBackdropTerm, getCameraFormat, getCameraFormatLabel, getCameraFormatPromptHint, getCameraFormatTerm, getCameraMotion, getCameraMotionLabel, getCameraMotionPromptHint, getCameraMotionTerm, getCategoriesForNodeType, getCharacterFx, getCharacterFxLabel, getCharacterFxPromptHint, getCharacterFxTerm, getColorLook, getColorLookLabel, getColorLookPromptHint, getColorLookTerm, getCompositionEffect, getCompositionEffectLabel, getCompositionEffectPromptHint, getCompositionEffectTerm, getEffectiveSunoCustomMode, getEra, getEraLabel, getEraPromptHint, getEraTerm, getExposure, getExposureLabel, getExposurePromptHint, getExposureTerm, getFactoryPresets, getFactorySnippets, getFraming, getFramingCategoryLimit, getFramingLabel, getFramingPromptHint, getFramingTerm, getHeldProp, getHeldPropLabel, getHeldPropPromptHint, getHeldPropTerm, getIdentityLockClause, getInstrument, getInstrumentTerm, getLens, getLensLabel, getLensPromptHint, getLensTerm, getLighting, getLightingLabel, getLightingPromptHint, getLightingTerm, getLoopSubject, getLoopSubjectLabel, getLoopSubjectPromptHint, getLoopSubjectTerm, getMaterial, getMaterialLabel, getMaterialPromptHint, getMaterialTerm, getMinorAgeHintStrings, getMood, getMoodLabel, getMoodPromptHint, getMoodTerm, getMusicEmotion, getMusicEmotionTerm, getMusicEnergy, getMusicEnergyTerm, getMusicEra, getMusicEraTerm, getMusicGenre, getMusicGenreLabel, getMusicGenreTerm, getMusicSubgenre, getMusicSubgenreTerm, getMusicVibe, getMusicVibeTerm, getParameterPromptHint, getPerson, getPersonDimensionLimit, getPersonLabel, getPersonPromptHint, getPersonTerm, getPhotoGenre, getPhotoGenreLabel, getPhotoGenrePromptHint, getPhotoGenreTerm, getPhotographer, getPhotographerLabel, getPhotographerPromptHint, getPhotographerTerm, getPickerAnalyzer, getPickerCatalog, getPickerWiring, getPose, getPoseLabel, getPosePromptHint, getPoseTerm, getPostProcessEffect, getPostProcessEffectLabel, getPostProcessEffectPromptHint, getPostProcessEffectTerm, getProductionStyle, getProductionStyleTerm, getPromptDoctrine, getPromptFields, getPromptTips, getRegisteredCatalogPacks, getRegisteredPeople, getRegisteredPersonDimensionLabels, getRegisteredPersonDimensionOrder, getRegisteredPersonFieldByDimension, getRegisteredPickerCatalogs, getRegisteredSubjectKeys, getRenderQuality, getRenderQualityLabel, getRenderQualityPromptHint, getRenderQualityTerm, getSetting, getSettingLabel, getSettingPromptHint, getSettingTerm, getSingingStyle, getSingingStyleTerm, getSnippetMedia, getStyle, getStyleLabel, getStylePreset, getStylePromptHint, getStyleTerm, getStyling, getStylingDimensionLimit, getStylingLabel, getStylingPromptHint, getStylingTerm, getTemporal, getTemporalLabel, getTemporalPromptHint, getTemporalTerm, getTransition, getTransitionLabel, getTransitionPromptHint, getTransitionTerm, getVocalPresence, getVocalPresenceTerm, getVoiceAccent, getVoiceAccentTerm, getVoiceAge, getVoiceAgeTerm, getVoiceArchetype, getVoiceArchetypeTerm, getVoiceEmotion, getVoiceEmotionTerm, getVoiceGender, getVoiceGenderTerm, getVoiceLanguage, getVoiceLanguageTerm, getVoicePace, getVoicePaceTerm, getVoiceTimbre, getVoiceTimbreTerm, getWardrobeEntriesByDimension, getWardrobeEntry, getWardrobePromptHint, groupFactoryPresets, hasCatalogPacksFor, hasUpstreamCharacter, identityRefsSentence, insertBeforeStyleSection, isAnalyzablePicker, isDeniedStyleId, isInstrumentalVocal, isMinorAge, isSuspiciousDerivedTerm, isVantageFraming, isWizardSupported, joinPromptHints, joinPromptParts, keepableDirectionHints, listPickerCatalogs, migratePersonValue, modeForFamily, nodeHasInlinePrompt, nodeHasPromptField, nodeSupportsPromptAffixes, normalizeSubjectFields, overlayEntry, partitionStyleClauses, personPacksVersion, pickerFanoutTargets, projectAllCatalogs, projectPickerCatalog, promptAffixCoreField, promptBindsFirstFrame, promptFieldCarriesAffixes, promptPartSeparator, readDirectionFields, readStructuredFields, readSubjectFields, referenceDescriptionLine, referenceRulesBlock, registerCatalogPack, registerPersonPack, renderDescribedReferenceLines, renderDirectionHintClauses, renderDirectionHints, renderReferenceCaptionLines, renderStructuredFields, renderStyleSection, renderSubjectHints, resetCatalogPacks, resetPersonPacks, resolveBrandInput, resolveCharacterMentions, resolveGeminiOmniI2vInputs, resolveLocationMentions, resolvePrompt, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveTemplate, resolveTerm, resolveVeoI2vInputs, resolveVideoReferenceCore, sectionedClauseCosts, setComposedCatalogResolver, splitStyleSection, styleSectionFromClauses, styleSlotFor, subjectFieldsForSurface, subscribeCatalogPacks, summarizePickerCatalogs, toIdentityLockMode, truncateForField, truncateText, withForcedIdentityLock };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map