@nodaro/prompts 1.38.0 → 1.40.0

package/dist/entries/assembly.d.ts

@@ -1,6 +1,6 @@
 import { UsageMode, SurroundDirection } from '@nodaro/shared/entities';
 import { ConnectedReference, DescribedReference, HintNodeLike, HintGraphContext, IdentityMeta, CharacterDef } from '@nodaro/shared/types';
-import { k as DirectionFields, N as SubjectFields, J as StructuredPromptFields, c as BuildImagePromptResult, m as DirectionHintMode, Q as SubjectHintMode } from '../subject-registry-D7V8PEG-.js';
+import { k as DirectionFields, L as StyleReferenceInput, Q as SubjectFields, K as StructuredPromptFields, c as BuildImagePromptResult, m as DirectionHintMode, U as SubjectHintMode } from '../subject-registry-DFiGx49v.js';
 import { FrameDelivery } from '@nodaro/shared/video';
 import '../term-C01_g6s1.js';
 import '../transitions-BgwWM37i.js';
@@ -34,7 +34,7 @@ import '../transitions-BgwWM37i.js';
  * says the two things a multimodal model needs to hear — match exactly, and
  * these are not frames. One spelling; both resolvers ride it.
  */
-declare function identityRefsSentence(firstOrdinal: number, lastOrdinal: number): string;
+declare function identityRefsSentence(firstOrdinal: number, lastOrdinal: number, ordinal?: (n: number) => string): string;
 declare const REF_BINDING: {
     readonly image: (label: string, n: number) => string;
     readonly video: (label: string, n: number) => string;
@@ -43,6 +43,18 @@ declare const REF_BINDING: {
     readonly ordinal: (n: number) => string;
     readonly frame: (n: number, role: "opening" | "closing") => string;
 };
+/** A binding sentence's ordinal + frame directive in one provider syntax. */
+interface ImageBinding {
+    ordinal: (n: number) => string;
+    frame: (n: number, role: "opening" | "closing") => string;
+}
+/**
+ * The image binding in a provider's OWN reference syntax
+ * (`videoProviderReferenceSyntax` in @nodaro/shared). `@image_N` IS
+ * {@link REF_BINDING} — the platform swap point, byte for byte; the other two
+ * spell the same sentence in the form the provider documents.
+ */
+declare function imageBindingFor(syntax: "@image_N" | "@image(n)" | "[Image N]"): ImageBinding;
 /**
  * The instruction that makes Seedance EDIT a wired clip rather than use it as a
  * style reference — the Video to Video node's Seedance lane prepends it to the
@@ -553,6 +565,23 @@ interface AssembleImageInput {
      * is a no-op for it and the result is byte-identical to today).
      */
     direction?: DirectionFields;
+    /**
+     * Rendered clauses for the caller's OWN saved resources named in `direction`
+     * (`colorLook: "palette:<id>"`, `style: "moodboard:<id>"`), keyed by the
+     * direction value. Resolving them is a database read, so the platform does it
+     * BEFORE this pure assembly and hands the clauses in; each one folds in its
+     * row's slot exactly like a catalog clause (the `[style]` film line), sheds
+     * like one, and a reference missing from the map folds nothing.
+     */
+    directionRefs?: ReadonlyMap<string, string>;
+    /**
+     * Style reference images (a moodboard's images). They only FILL the
+     * reference seats the caller's own references leave free — after them, never
+     * displacing, renumbering or evicting one — up to the model's reference
+     * limit; the rest are not sent. `styleReferencesSent` on the result says how
+     * many went. Each carries a short style line (`styleReferenceDescription`).
+     */
+    styleReferences?: readonly StyleReferenceInput[];
     /**
      * Flat subject ids (Person / Styling / props) → folded into the prompt AHEAD
      * of the direction clauses: the subject is the noun phrase the cinematography
@@ -622,7 +651,9 @@ interface AssembleImageInput {
  * Order: (1) compose the prompt text (no-op when no subject/direction/structured),
  * (2) `buildImagePrompt(...)` — exactly the call the three sites make today,
  * (3) shed hint clauses and re-assemble while the provider cap overflows,
- * (4) optional post-assembly empty-prompt throw (gated by `throwOnEmpty`).
+ * (4) with `styleReferences`, fill the free reference seats with them
+ *     (`fillStyleReferences`; absent = this step does not run at all),
+ * (5) optional post-assembly empty-prompt throw (gated by `throwOnEmpty`).
  *
  * TRUNCATION ORDERING (step 3): `buildImagePrompt`'s cap clamp cuts the TAIL,
  * which is ORDER-BLIND — on a low-cap provider (seedream = 3000) a maximal
@@ -638,7 +669,16 @@ interface AssembleImageInput {
  * UNDER-CAP PARITY: the first pass folds every hint, so a prompt that fits is
  * byte-identical to before — the retry only ever runs on an over-cap assembly.
  */
-declare function assembleImageInput(input: AssembleImageInput): BuildImagePromptResult;
+declare function assembleImageInput(input: AssembleImageInput): AssembleImageResult;
+/** `assembleImageInput`'s result: the builder's, plus the style-reference count. */
+interface AssembleImageResult extends BuildImagePromptResult {
+    /**
+     * How many of `styleReferences` were sent (they follow the caller's own
+     * references at the end of `referenceImageUrls`). Present only when
+     * `styleReferences` were given, so every other result is unchanged.
+     */
+    styleReferencesSent?: number;
+}
 
 /**
  * `composeVideoPromptText` — the video twin of `assemble-image-input.ts`'s
@@ -818,6 +858,59 @@ declare function composeVideoPromptText(userPrompt: string | undefined, directio
     readonly subjectHintMode?: SubjectHintMode;
 } & VideoPromptCapOptions): string | undefined;
 
+/**
+ * WHERE A START / END FRAME GOES WHEN IT SHARES A MODEL'S REFERENCE LIST — the
+ * one platform convention (2026-10-18), for every video model whose frames and
+ * reference images travel in a single image array (`videoProviderAppendsFrames`
+ * in @nodaro/shared):
+ *
+ *   - the caller's own reference images come FIRST, in their order, so the
+ *     caller's image token N (`{image:N}`, `{ref:<id>}`, a typed ordinal)
+ *     always means their Nth reference;
+ *   - the frames are appended AFTER them (start, then end) and named in the
+ *     prompt as the opening / closing frame, in the provider's own syntax;
+ *   - at the image cap the frames are KEPT — they are explicit intent — and
+ *     trailing caller references are dropped and reported.
+ *
+ * `bindIdentities` adds the identity sentence the flat-image-list models carry
+ * (Gemini Omni, VEO, Grok, HappyHorse: nothing in their payload says which
+ * entries are identities, so the prompt says it). The Seedance-family resolver
+ * calls this without it — byte for byte what it always emitted.
+ */
+interface FrameReferenceSlotsArgs {
+    /** Consulted only to skip a duplicate opening-frame sentence. */
+    prompt?: string;
+    firstFrameUrl?: string;
+    lastFrameUrl?: string;
+    /** The caller's own reference images, in priority order. */
+    refImageUrls?: readonly (string | undefined)[];
+    /** The provider's image cap — frames and references together. */
+    imageCap: number;
+    /** The provider's reference syntax (`videoProviderReferenceSyntax`). */
+    syntax?: "@image_N" | "@image(n)" | "[Image N]";
+    bindIdentities?: boolean;
+}
+interface FrameReferenceSlotsResult {
+    /** `[...keptRefs, start?, end?]` — never longer than `imageCap` (bar the frames themselves). */
+    imageUrls: string[];
+    promptSuffix: string;
+    /** Trailing caller references dropped to keep the frames. */
+    droppedRefImages: number;
+    /** 1-based seats of the frames in `imageUrls`; 0 when absent. */
+    firstFrameOrdinal: number;
+    lastFrameOrdinal: number;
+}
+declare function placeFramesAfterReferences(args: FrameReferenceSlotsArgs): FrameReferenceSlotsResult;
+/** True when the prompt ALREADY binds an image as the first/opening frame —
+ *  e.g. the gvp overlap transport's colon-position directive ("use @image_1
+ *  as the first frame, it is the last keyframe of @video_1"). Field finding
+ *  (2026-07-20): the first-frame directive only works adjacent to the extend
+ *  colon; a duplicate sentence at the END of the prompt (this resolver's
+ *  default position) dilutes it back into coin-flip behavior — so when the
+ *  prompt carries its own binding, the suffix is suppressed (the frame image
+ *  itself still rides the reference list). */
+declare function promptBindsFirstFrame(prompt: string | undefined): boolean;
+
 type Seedance2Mode = "first-frame" | "first-last-frame" | "reference";
 interface Seedance2InputsArgs {
     /** The generation prompt — used ONLY to detect an existing first-frame
@@ -849,23 +942,7 @@ interface Seedance2InputsResult {
     promptSuffix: string;
     droppedRefImages: number;
 }
-/**
- * Single source of truth for how Seedance 2's three mutually-exclusive KIE input
- * modes are selected from connected inputs. Strict first/last-frame mode is used
- * only when nothing but frames is connected; any reference (image, video, OR
- * audio) switches to multimodal Reference mode, where the frames are appended to
- * reference_image_urls (after the user's own images, so their @Image ordinals do
- * not shift) and named in a doctrine-compliant prompt suffix.
- */
-/** True when the prompt ALREADY binds an image as the first/opening frame —
- *  e.g. the gvp overlap transport's colon-position directive ("use @image_1
- *  as the first frame, it is the last keyframe of @video_1"). Field finding
- *  (2026-07-20): the first-frame directive only works adjacent to the extend
- *  colon; a duplicate sentence at the END of the prompt (this resolver's
- *  default position) dilutes it back into coin-flip behavior — so when the
- *  prompt carries its own binding, the suffix is suppressed (the frame image
- *  itself still rides the reference list). */
-declare function promptBindsFirstFrame(prompt: string | undefined): boolean;
+
 declare function resolveSeedance2Inputs(args: Seedance2InputsArgs): Seedance2InputsResult;
 
 /**
@@ -873,23 +950,27 @@ declare function resolveSeedance2Inputs(args: Seedance2InputsArgs): Seedance2Inp
  * `resolveSeedance2Inputs` for a model whose multimodal channel is ONE flat
  * `image_urls` list.
  *
+ * THE PLATFORM CONVENTION (2026-10-18, `placeFramesAfterReferences`): the
+ * caller's identity references come first, so their image token N is their Nth
+ * reference, and the start frame is appended after them. Until then the frame
+ * led the list, so a caller's `@image_1` landed on the frame.
+ *
  * WHY BINDING IS LOAD-BEARING: Gemini Omni receives the start frame and the
  * identity references in the same array, with nothing in the payload marking
  * which is which. A multimodal model treats unbound images as loose context —
  * field finding (recast keyframes run, 2026-08-14): the identity references
  * rode every call and the cast still drifted part to part, because the prompt
  * never said the images WERE identities to keep. So the resolver names the
- * roles in a prompt suffix, through the same `REF_BINDING` swap-point every
- * other video binding uses: image 1 is the opening frame; the rest are
- * identity references, explicitly not frames.
+ * roles in a prompt suffix: the references are identity references, explicitly
+ * not frames, and the last image is the opening frame.
  *
  * BUDGETED, NEVER REJECTED, for the list this resolver assembles: KIE's quota
  * is `images + 2×videos ≤ 7`, and `runGeminiOmni` hard-rejects overflow. That
  * reject is right for a caller-assembled list (the user's own images should
  * not silently thin out) and wrong for THIS merge, where the overflow is our
  * own construction — so trailing references are dropped to fit, the start
- * frame always kept, mirroring `resolveSeedance2Inputs`' drop-trailing
- * convention, and the drop count is reported for the caller to log.
+ * frame always kept (the convention's tie-break), and the drop count is
+ * reported for the caller to log.
  *
  * BYTE-IDENTICAL when there is nothing to bind: no references ⇒ no suffix and
  * a single-image list — exactly what every plain gemini-omni i2v call has
@@ -898,7 +979,7 @@ declare function resolveSeedance2Inputs(args: Seedance2InputsArgs): Seedance2Inp
 interface GeminiOmniI2vInputsArgs {
     /** The composed prompt, used only to detect an existing first-frame binding. */
     prompt?: string;
-    /** The start frame — always kept, always first in the list. */
+    /** The start frame — always kept, appended after the references. */
     firstFrameUrl: string;
     /** Identity references, in priority order (trailing ones drop first). */
     refImageUrls?: Array<string | undefined>;
@@ -911,7 +992,7 @@ interface GeminiOmniI2vInputsArgs {
     provider?: string;
 }
 interface GeminiOmniI2vInputsResult {
-    /** `[firstFrameUrl, ...keptRefs]` — the `image_urls` payload, quota-fitted. */
+    /** `[...keptRefs, firstFrameUrl]` — the `image_urls` payload, quota-fitted. */
     imageUrls: string[];
     /** The role-binding sentences; empty when no reference survived the budget. */
     promptSuffix: string;
@@ -927,13 +1008,15 @@ declare function resolveGeminiOmniI2vInputs(args: GeminiOmniI2vInputsArgs): Gemi
  * [first(, last)] frames; REFERENCE_2_VIDEO reads every entry as a
  * reference ingredient. Frames and identities cannot ride separate
  * channels, so an anchored call that must carry identity references moves
- * to REFERENCE_2_VIDEO with the anchor in seat 1, bound in prose as the
- * opening frame (requested, not pixel-guaranteed — the accepted trade,
- * same as seedance-2's reference mode).
+ * to REFERENCE_2_VIDEO with the frames bound in prose (requested, not
+ * pixel-guaranteed — the accepted trade, same as seedance-2's reference mode).
  *
- * REFERENCES WIN THE SEATS (the 2026-08-14 standing rule: refs are a must,
- * frames additional): the end anchor is dropped in reference mode rather
- * than spending one of three seats on a closing guess. The caller logs it.
+ * THE PLATFORM CONVENTION (2026-10-18, `placeFramesAfterReferences`): the
+ * caller's references take the first seats, so their image token N is their
+ * Nth reference; the start frame — and the end frame, VEO takes one — follow
+ * them, bound as the opening / closing frame. At the 3-ingredient cap the
+ * frames are kept (explicit intent) and trailing references drop, reported.
+ * (Until then the anchor took seat 1 and an end frame was surrendered.)
  *
  * BYTE-IDENTICAL with no references: plain frame mode, frames kept, no
  * generationType, no suffix — exactly what every veo i2v call has always
@@ -947,14 +1030,15 @@ interface VeoI2vInputsArgs {
     refImageUrls?: Array<string | undefined>;
 }
 interface VeoI2vInputsResult {
-    /** The `imageUrls` payload: frames in plain mode, [anchor, ...refs] in
+    /** The `imageUrls` payload: frames in plain mode, [...refs, start, end?] in
      *  reference mode — never more than VEO's 3-ingredient cap. */
     imageUrls: string[];
     /** Present (REFERENCE_2_VIDEO) exactly when references ride. */
     generationType?: "REFERENCE_2_VIDEO";
     promptSuffix: string;
     droppedRefImages: number;
-    /** True when an end anchor was surrendered to reference mode. */
+    /** Always false since the frames-after-references convention: an end frame
+     *  is kept in reference mode. Kept for callers that log it. */
     droppedEndFrame: boolean;
 }
 declare function resolveVeoI2vInputs(args: VeoI2vInputsArgs): VeoI2vInputsResult;
@@ -1020,4 +1104,4 @@ interface FrameDeliveryPlan {
  */
 declare function planFrameDelivery(args: FrameDeliveryPlanArgs): FrameDeliveryPlan;
 
-export { type AssembleImageInput, type AssembleSunoInput, type AssembleSunoResult, type CharacterMeta, DirectionFields, type FrameDeliveryPlan, type FrameDeliveryPlanArgs, type GeminiOmniI2vInputsArgs, type GeminiOmniI2vInputsResult, REF_BINDING, type RefIdTokenContext, type ReferenceCounts, type ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, SubjectFields, type VeoI2vInputsArgs, type VeoI2vInputsResult, type VideoExtraRef, type VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField };
+export { type AssembleImageInput, type AssembleImageResult, type AssembleSunoInput, type AssembleSunoResult, type CharacterMeta, DirectionFields, type FrameDeliveryPlan, type FrameDeliveryPlanArgs, type FrameReferenceSlotsArgs, type FrameReferenceSlotsResult, type GeminiOmniI2vInputsArgs, type GeminiOmniI2vInputsResult, type ImageBinding, REF_BINDING, type RefIdTokenContext, type ReferenceCounts, type ResolveVideoReferenceCoreArgs, SEEDANCE_VIDEO_EDIT_PREFIX, type Seedance2InputsArgs, type Seedance2InputsResult, type Seedance2Mode, type SoundComposition, type SoundCompositionFields, type SoundConsumerType, SubjectFields, type VeoI2vInputsArgs, type VeoI2vInputsResult, type VideoExtraRef, type VideoPromptCapOptions, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField };

package/dist/entries/assembly.js

@@ -1,10 +1,11 @@
-export { REF_BINDING, SEEDANCE_VIDEO_EDIT_PREFIX, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField } from '../chunk-QBEZMR2F.js';
-import '../chunk-QDEWBBUR.js';
+export { REF_BINDING, SEEDANCE_VIDEO_EDIT_PREFIX, appendField, appendMusicMeta, assembleImageInput, assembleSunoInput, buildSeedanceVideoEditPrompt, buildSurroundFillPrompt, composeSoundHintFromConnections, composeVideoPromptText, getEffectiveSunoCustomMode, identityRefsSentence, imageBindingFor, placeFramesAfterReferences, planFrameDelivery, promptBindsFirstFrame, resolveGeminiOmniI2vInputs, resolveRefIdTokens, resolveReferenceTokens, resolveSeedance2Inputs, resolveVeoI2vInputs, resolveVideoReferenceCore, truncateForField } from '../chunk-HQTHDTHN.js';
+import '../chunk-DUXX6CBX.js';
+import '../chunk-GILUVQQJ.js';
 import '../chunk-JZOPMVGY.js';
 import '../chunk-35UHMDGS.js';
 import '../chunk-BQWIPLLR.js';
-import '../chunk-N7TOWXDJ.js';
-import '../chunk-UJKFHPZ7.js';
+import '../chunk-QDUTMOF4.js';
+import '../chunk-EAYEZXWT.js';
 import '../chunk-SXXW4LCR.js';
 import '../chunk-DVP6ILDR.js';
 import '../chunk-TDZFXOTE.js';

package/dist/entries/doctrine.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkJKCR6WRZ_cjs = require('../chunk-JKCR6WRZ.cjs');
+var chunkDQFQJECU_cjs = require('../chunk-DQFQJECU.cjs');
 var chunkNAFD6MGH_cjs = require('../chunk-NAFD6MGH.cjs');
 var chunk2NJTFCKQ_cjs = require('../chunk-2NJTFCKQ.cjs');
 require('../chunk-Q7SFCCGT.cjs');
@@ -9,183 +9,183 @@ require('../chunk-Q7SFCCGT.cjs');
 
 Object.defineProperty(exports, "AD_CREATIVE_ANALYSIS_FIELDS", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.AD_CREATIVE_ANALYSIS_FIELDS; }
+  get: function () { return chunkDQFQJECU_cjs.AD_CREATIVE_ANALYSIS_FIELDS; }
 });
 Object.defineProperty(exports, "AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT; }
+  get: function () { return chunkDQFQJECU_cjs.AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT; }
 });
 Object.defineProperty(exports, "AUDIO_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.AUDIO_WIZARD_CATEGORIES; }
+  get: function () { return chunkDQFQJECU_cjs.AUDIO_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "DEFAULT_OWN_MOTION", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.DEFAULT_OWN_MOTION; }
+  get: function () { return chunkDQFQJECU_cjs.DEFAULT_OWN_MOTION; }
 });
 Object.defineProperty(exports, "IMAGE_REFERENCE_PROMPT_DOCTRINE", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.IMAGE_REFERENCE_PROMPT_DOCTRINE; }
+  get: function () { return chunkDQFQJECU_cjs.IMAGE_REFERENCE_PROMPT_DOCTRINE; }
 });
 Object.defineProperty(exports, "IMAGE_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.IMAGE_WIZARD_CATEGORIES; }
+  get: function () { return chunkDQFQJECU_cjs.IMAGE_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "LLM_CHAT_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.LLM_CHAT_WIZARD_CATEGORIES; }
+  get: function () { return chunkDQFQJECU_cjs.LLM_CHAT_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "MUSIC_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.MUSIC_WIZARD_CATEGORIES; }
+  get: function () { return chunkDQFQJECU_cjs.MUSIC_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "OWN_MOTION_NODE_TYPES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.OWN_MOTION_NODE_TYPES; }
+  get: function () { return chunkDQFQJECU_cjs.OWN_MOTION_NODE_TYPES; }
 });
 Object.defineProperty(exports, "POST_CONTENT_ANALYSIS_SYSTEM_PROMPT", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.POST_CONTENT_ANALYSIS_SYSTEM_PROMPT; }
+  get: function () { return chunkDQFQJECU_cjs.POST_CONTENT_ANALYSIS_SYSTEM_PROMPT; }
 });
 Object.defineProperty(exports, "PROVIDER_CAPABILITIES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.PROVIDER_CAPABILITIES; }
+  get: function () { return chunkDQFQJECU_cjs.PROVIDER_CAPABILITIES; }
 });
 Object.defineProperty(exports, "PROVIDER_PROMPT_DOCTRINES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.PROVIDER_PROMPT_DOCTRINES; }
+  get: function () { return chunkDQFQJECU_cjs.PROVIDER_PROMPT_DOCTRINES; }
 });
 Object.defineProperty(exports, "REFERENCE_IMAGE_ROLES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.REFERENCE_IMAGE_ROLES; }
+  get: function () { return chunkDQFQJECU_cjs.REFERENCE_IMAGE_ROLES; }
 });
 Object.defineProperty(exports, "SCENE3D_FIGURE_REFERENCE_RULE", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_FIGURE_REFERENCE_RULE; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_FIGURE_REFERENCE_RULE; }
 });
 Object.defineProperty(exports, "SCENE3D_FREE_PLATE_SLOTS", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_FREE_PLATE_SLOTS; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_FREE_PLATE_SLOTS; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_SCOPING_FOR", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_LAYOUT_SCOPING_FOR; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_SCOPING_FOR; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_SCOPING_IGNORE", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_LAYOUT_SCOPING_IGNORE; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_SCOPING_IGNORE; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE; }
 });
 Object.defineProperty(exports, "SCENE3D_LAYOUT_SCOPING_MARKER", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_LAYOUT_SCOPING_MARKER; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_LAYOUT_SCOPING_MARKER; }
 });
 Object.defineProperty(exports, "SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE; }
+  get: function () { return chunkDQFQJECU_cjs.SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE; }
 });
 Object.defineProperty(exports, "TEXT_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.TEXT_WIZARD_CATEGORIES; }
+  get: function () { return chunkDQFQJECU_cjs.TEXT_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "VIDEO_WIZARD_CATEGORIES", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.VIDEO_WIZARD_CATEGORIES; }
+  get: function () { return chunkDQFQJECU_cjs.VIDEO_WIZARD_CATEGORIES; }
 });
 Object.defineProperty(exports, "appendScene3DStillScopingLines", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.appendScene3DStillScopingLines; }
+  get: function () { return chunkDQFQJECU_cjs.appendScene3DStillScopingLines; }
 });
 Object.defineProperty(exports, "buildAdCreativeAnalysisUserText", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildAdCreativeAnalysisUserText; }
+  get: function () { return chunkDQFQJECU_cjs.buildAdCreativeAnalysisUserText; }
 });
 Object.defineProperty(exports, "buildCharacterPrompt", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildCharacterPrompt; }
+  get: function () { return chunkDQFQJECU_cjs.buildCharacterPrompt; }
 });
 Object.defineProperty(exports, "buildCreaturePrompt", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildCreaturePrompt; }
+  get: function () { return chunkDQFQJECU_cjs.buildCreaturePrompt; }
 });
 Object.defineProperty(exports, "buildFaceTemplateInputs", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildFaceTemplateInputs; }
+  get: function () { return chunkDQFQJECU_cjs.buildFaceTemplateInputs; }
 });
 Object.defineProperty(exports, "buildLocationMotionPrompt", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildLocationMotionPrompt; }
+  get: function () { return chunkDQFQJECU_cjs.buildLocationMotionPrompt; }
 });
 Object.defineProperty(exports, "buildLocationPrompt", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildLocationPrompt; }
+  get: function () { return chunkDQFQJECU_cjs.buildLocationPrompt; }
 });
 Object.defineProperty(exports, "buildLocationRefinePrompt", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildLocationRefinePrompt; }
+  get: function () { return chunkDQFQJECU_cjs.buildLocationRefinePrompt; }
 });
 Object.defineProperty(exports, "buildMotionPrompt", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildMotionPrompt; }
+  get: function () { return chunkDQFQJECU_cjs.buildMotionPrompt; }
 });
 Object.defineProperty(exports, "buildObjectMotionPrompt", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildObjectMotionPrompt; }
+  get: function () { return chunkDQFQJECU_cjs.buildObjectMotionPrompt; }
 });
 Object.defineProperty(exports, "buildObjectPrompt", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildObjectPrompt; }
+  get: function () { return chunkDQFQJECU_cjs.buildObjectPrompt; }
 });
 Object.defineProperty(exports, "buildScene3DLayoutScopingLine", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildScene3DLayoutScopingLine; }
+  get: function () { return chunkDQFQJECU_cjs.buildScene3DLayoutScopingLine; }
 });
 Object.defineProperty(exports, "buildScene3DUnreferencedFiguresWarning", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.buildScene3DUnreferencedFiguresWarning; }
+  get: function () { return chunkDQFQJECU_cjs.buildScene3DUnreferencedFiguresWarning; }
 });
 Object.defineProperty(exports, "getCategoriesForNodeType", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.getCategoriesForNodeType; }
+  get: function () { return chunkDQFQJECU_cjs.getCategoriesForNodeType; }
 });
 Object.defineProperty(exports, "getPromptDoctrine", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.getPromptDoctrine; }
+  get: function () { return chunkDQFQJECU_cjs.getPromptDoctrine; }
 });
 Object.defineProperty(exports, "getPromptTips", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.getPromptTips; }
+  get: function () { return chunkDQFQJECU_cjs.getPromptTips; }
 });
 Object.defineProperty(exports, "hasScene3DLayoutScopingLine", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.hasScene3DLayoutScopingLine; }
+  get: function () { return chunkDQFQJECU_cjs.hasScene3DLayoutScopingLine; }
 });
 Object.defineProperty(exports, "isWizardSupported", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.isWizardSupported; }
+  get: function () { return chunkDQFQJECU_cjs.isWizardSupported; }
 });
 Object.defineProperty(exports, "ownMotionHint", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.ownMotionHint; }
+  get: function () { return chunkDQFQJECU_cjs.ownMotionHint; }
 });
 Object.defineProperty(exports, "renderScene3DLayoutScopingLine", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.renderScene3DLayoutScopingLine; }
+  get: function () { return chunkDQFQJECU_cjs.renderScene3DLayoutScopingLine; }
 });
 Object.defineProperty(exports, "scene3DLayoutVideoCaptions", {
   enumerable: true,
-  get: function () { return chunkJKCR6WRZ_cjs.scene3DLayoutVideoCaptions; }
+  get: function () { return chunkDQFQJECU_cjs.scene3DLayoutVideoCaptions; }
 });
 Object.defineProperty(exports, "CINEMATIC_LOOK_TAIL", {
   enumerable: true,

package/dist/entries/doctrine.d.cts

@@ -529,9 +529,9 @@ declare function getPromptTips(providerId: string): readonly string[];
  * the video node skills.
  *
  * Unlike the per-provider video doctrines, this is a PLATFORM mechanism: the
- * token grammar and expansion are Nodaro's own (`prompt-builder.ts` —
- * `IMAGE_TOKEN_PATTERN`, `expandImageRefTokens`), so there is one doctrine,
- * not one per model family.
+ * token grammar and expansion are Nodaro's own (`image-token-pattern.ts` —
+ * `IMAGE_TOKEN_PATTERN`; `prompt-builder.ts` — `expandImageRefTokens`), so
+ * there is one doctrine, not one per model family.
  *
  * Source of truth for the semantics documented here (verified 2026-08-25):
  * - `IMAGE_TOKEN_PATTERN` = `/\{image:(\d+)(?::([^}\n]+))?\}/gi`

package/dist/entries/doctrine.d.ts

@@ -529,9 +529,9 @@ declare function getPromptTips(providerId: string): readonly string[];
  * the video node skills.
  *
  * Unlike the per-provider video doctrines, this is a PLATFORM mechanism: the
- * token grammar and expansion are Nodaro's own (`prompt-builder.ts` —
- * `IMAGE_TOKEN_PATTERN`, `expandImageRefTokens`), so there is one doctrine,
- * not one per model family.
+ * token grammar and expansion are Nodaro's own (`image-token-pattern.ts` —
+ * `IMAGE_TOKEN_PATTERN`; `prompt-builder.ts` — `expandImageRefTokens`), so
+ * there is one doctrine, not one per model family.
  *
  * Source of truth for the semantics documented here (verified 2026-08-25):
  * - `IMAGE_TOKEN_PATTERN` = `/\{image:(\d+)(?::([^}\n]+))?\}/gi`

package/dist/entries/doctrine.js

@@ -1,4 +1,4 @@
-export { AD_CREATIVE_ANALYSIS_FIELDS, AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT, AUDIO_WIZARD_CATEGORIES, DEFAULT_OWN_MOTION, IMAGE_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, LLM_CHAT_WIZARD_CATEGORIES, MUSIC_WIZARD_CATEGORIES, OWN_MOTION_NODE_TYPES, POST_CONTENT_ANALYSIS_SYSTEM_PROMPT, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, REFERENCE_IMAGE_ROLES, SCENE3D_FIGURE_REFERENCE_RULE, SCENE3D_FREE_PLATE_SLOTS, SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE, SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE, SCENE3D_LAYOUT_SCOPING_FOR, SCENE3D_LAYOUT_SCOPING_IGNORE, SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE, SCENE3D_LAYOUT_SCOPING_MARKER, SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE, TEXT_WIZARD_CATEGORIES, VIDEO_WIZARD_CATEGORIES, appendScene3DStillScopingLines, buildAdCreativeAnalysisUserText, buildCharacterPrompt, buildCreaturePrompt, buildFaceTemplateInputs, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMotionPrompt, buildObjectMotionPrompt, buildObjectPrompt, buildScene3DLayoutScopingLine, buildScene3DUnreferencedFiguresWarning, getCategoriesForNodeType, getPromptDoctrine, getPromptTips, hasScene3DLayoutScopingLine, isWizardSupported, ownMotionHint, renderScene3DLayoutScopingLine, scene3DLayoutVideoCaptions } from '../chunk-CEPVQQVO.js';
+export { AD_CREATIVE_ANALYSIS_FIELDS, AD_CREATIVE_ANALYSIS_SYSTEM_PROMPT, AUDIO_WIZARD_CATEGORIES, DEFAULT_OWN_MOTION, IMAGE_REFERENCE_PROMPT_DOCTRINE, IMAGE_WIZARD_CATEGORIES, LLM_CHAT_WIZARD_CATEGORIES, MUSIC_WIZARD_CATEGORIES, OWN_MOTION_NODE_TYPES, POST_CONTENT_ANALYSIS_SYSTEM_PROMPT, PROVIDER_CAPABILITIES, PROVIDER_PROMPT_DOCTRINES, REFERENCE_IMAGE_ROLES, SCENE3D_FIGURE_REFERENCE_RULE, SCENE3D_FREE_PLATE_SLOTS, SCENE3D_LAYOUT_REFERENCE_SCOPING_FIXTURE, SCENE3D_LAYOUT_REFERENCE_SCOPING_LINE, SCENE3D_LAYOUT_SCOPING_FOR, SCENE3D_LAYOUT_SCOPING_IGNORE, SCENE3D_LAYOUT_SCOPING_LOOK_SOURCE, SCENE3D_LAYOUT_SCOPING_MARKER, SCENE3D_UNREFERENCED_FIGURES_WARNING_CODE, TEXT_WIZARD_CATEGORIES, VIDEO_WIZARD_CATEGORIES, appendScene3DStillScopingLines, buildAdCreativeAnalysisUserText, buildCharacterPrompt, buildCreaturePrompt, buildFaceTemplateInputs, buildLocationMotionPrompt, buildLocationPrompt, buildLocationRefinePrompt, buildMotionPrompt, buildObjectMotionPrompt, buildObjectPrompt, buildScene3DLayoutScopingLine, buildScene3DUnreferencedFiguresWarning, getCategoriesForNodeType, getPromptDoctrine, getPromptTips, hasScene3DLayoutScopingLine, isWizardSupported, ownMotionHint, renderScene3DLayoutScopingLine, scene3DLayoutVideoCaptions } from '../chunk-C46256GZ.js';
 export { CINEMATIC_LOOK_TAIL, FILM_STILL_PREFIX, NEUTRAL_PERSON, REALISM_FINISH, REALISM_PASS_INSTRUCTION, REALISM_SKIN, REFERENCE_RULES, REFERENCE_RULES_MULTI_PERSON, SCENE_FRAME_RULE, filmStillPrefix, realismEmptyHands, realismViewpoint, referenceRulesBlock } from '../chunk-T64D26P4.js';
 export { DEFAULT_IDENTITY_LOCK, DEFAULT_TEMPLATES, applyTemplate, buildIdentityLockLine, characterLockToRefLock, collectIdentityLockClause, getIdentityLockClause, hasUpstreamCharacter, resolveTemplate, toIdentityLockMode, withForcedIdentityLock } from '../chunk-BQWIPLLR.js';
 import '../chunk-PZ5AY32C.js';