@nodaro/prompts 1.39.0 → 1.40.0

package/dist/{chunk-Z3SZXWRU.js → chunk-YS6HOWMW.js}

@@ -1,4 +1,4 @@
-import { computeNodePrompt, computeScriptTopic, computeLlmChatFields } from './chunk-7XMTVYS5.js';
+import { computeNodePrompt, computeScriptTopic, computeLlmChatFields } from './chunk-N6VMPG5S.js';
 import { resolveNodeRefs } from '@nodaro/shared/workflow';
 import { SOCIAL_POST_NODE_TYPES } from '@nodaro/shared/social';
 
@@ -76,5 +76,5 @@ function computeNodeSendText(nodeType, data, args) {
 }
 
 export { TEXT_REQUIRED_NODE_TYPES, WIRED_OUTPUT_NODE_TYPES, computeAiWriterInput, computeNodeSendText, stripAudioTags };
-//# sourceMappingURL=chunk-Z3SZXWRU.js.map
-//# sourceMappingURL=chunk-Z3SZXWRU.js.map
+//# sourceMappingURL=chunk-YS6HOWMW.js.map
+//# sourceMappingURL=chunk-YS6HOWMW.js.map

package/dist/{chunk-Z3SZXWRU.js.map → chunk-YS6HOWMW.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/audio-tags.ts","../src/node-send-text.ts"],"names":[],"mappings":"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","file":"chunk-Z3SZXWRU.js","sourcesContent":["/**\n * Remove inline `[audio tags]` from speech text, for a model that does not\n * perform them (it would read them aloud). Pure, dependency-free: the\n * backend's credit counter (lib/speech-credits.ts), its payload builder and\n * the editor's estimate (frontend/src/lib/speech-estimate.ts) all read it, so\n * the two engines count exactly the same characters.\n *\n * A tag is `[`, one or more characters that are not `]`, then `]` — what\n * `/\\[[^\\]]+\\]/g` matches. That pattern is quadratic on an unclosed run of `[`\n * (every `[` rescans to the end of the text), and the credit counter runs this\n * on raw request text on the API and orchestrator event loops, so the scan is\n * written by hand: one `indexOf` per `[`, and when no `]` is left no later `[`\n * can match either, so the rest of the text is kept in one slice.\n */\nfunction removeBracketTags(text: string): string {\n  let out = \"\"\n  let from = 0\n  let open = text.indexOf(\"[\")\n  while (open !== -1) {\n    const close = text.indexOf(\"]\", open + 1)\n    if (close === -1) break\n    if (close === open + 1) {\n      // \"[]\" is not a tag (needs 1+ characters); the \"[\" stays and the scan moves on.\n      open = text.indexOf(\"[\", open + 1)\n      continue\n    }\n    out += text.slice(from, open)\n    from = close + 1\n    open = text.indexOf(\"[\", from)\n  }\n  return out + text.slice(from)\n}\n\nexport function stripAudioTags(text: string): string {\n  return removeBracketTags(text).replace(/\\s{2,}/g, \" \").trim()\n}\n","import { resolveNodeRefs } from \"@nodaro/shared/workflow\"\nimport { SOCIAL_POST_NODE_TYPES } from \"@nodaro/shared/social\"\nimport { computeLlmChatFields, computeNodePrompt, computeScriptTopic } from \"./resolve-prompt.js\"\n\n/**\n * Output nodes that send exactly what is WIRED into them — a webhook's\n * parameters, a social post's caption and media. When every wire produced\n * nothing in this run (a Filter List that kept no row, a node that was itself\n * skipped), there is nothing to send: the node is skipped with\n * `skipReason: \"empty_input\"` instead of posting an empty payload (a site that\n * validates its input answers 400 and alerts its owner) or failing the run\n * (a publish route refuses a post with no text and no media). A typed caption\n * with no wire at all is the author's choice and still runs, as before. ONE\n * list, read by the orchestrator's skip rule (`empty-input-skips.ts`).\n */\nexport const WIRED_OUTPUT_NODE_TYPES: ReadonlySet<string> = new Set([\"webhook-output\", ...SOCIAL_POST_NODE_TYPES])\n\n/**\n * Node types that send TEXT to a model or a voice and fail on an empty one —\n * `userInput: Too small` (llm-chat), \"no text found\" (text-to-speech) — so a\n * run with nothing upstream can skip them instead of failing. Never an image\n * or video node (an empty prompt is a legal request there) and never a social\n * post (an empty caption is the author's choice). ONE list, read by the\n * orchestrator's skip rule (`empty-input-skips.ts`); the engine never names a\n * type on its own.\n */\nexport const TEXT_REQUIRED_NODE_TYPES: ReadonlySet<string> = new Set([\n  \"llm-chat\",\n  \"ai-writer\",\n  \"generate-script\",\n  \"text-to-speech\",\n  \"generate-music\",\n  \"text-to-audio\",\n  // Save to Collection refuses an empty record (\"nothing to save\"): a feed\n  // with nothing new wired straight into it must skip it, not fail the run.\n  \"collection-write\",\n  // Generate Image: an empty prompt is a legal request in general (references\n  // alone), but when the text it was WIRED produced nothing this run — the skip\n  // rule's precondition — an empty prompt is a paid picture of nothing.\n  \"generate-image\",\n])\n\n/**\n * The node's data without its prompt pre/post text: the skip decision is about\n * the CORE text. A prefix alone (\"Write a news item about:\") is not something\n * to send — with the affixes applied, an empty core read as non-empty and an\n * idle tick paid for a model call on the prefix.\n */\nconst withoutAffixes = (data: Record<string, unknown>): Record<string, unknown> => ({ ...data, promptPrefix: undefined, promptSuffix: undefined })\n\nexport interface NodeSendTextArgs {\n  /** A list fan-out item (highest precedence). */\n  override?: string\n  /** The text wired into the node's main text input. */\n  wired?: string\n  /** llm-chat only: the text wired into `system-prompt`. */\n  wiredSystemPrompt?: string\n  refMap: ReadonlyMap<string, string>\n}\n\nconst present = (s?: string): s is string => typeof s === \"string\" && s.trim().length > 0\n\n/**\n * ai-writer's user input — the rule its sync-HTTP body applies: a fan-out\n * item, else the wired text, else the typed `userInput`, else the legacy\n * `prompt`. (ai-writer is renamed to llm-chat on load; saved graphs that\n * never reloaded still run it.)\n */\nexport function computeAiWriterInput(\n  data: Record<string, unknown>,\n  { override, wired }: Pick<NodeSendTextArgs, \"override\" | \"wired\">,\n): string {\n  return [override, wired, data.userInput as string | undefined, data.prompt as string | undefined].find(present) ?? \"\"\n}\n\n/**\n * The text a text-requiring node would send, by the SAME rule its executor\n * uses (`computeLlmChatFields`, `computeScriptTopic`, `computeNodePrompt`,\n * `computeAiWriterInput`) — so \"would this node run on nothing?\" is answered\n * by the function that decides what it sends, not by a second reading of it.\n * Undefined for any other node type.\n */\nexport function computeNodeSendText(\n  nodeType: string,\n  data: Record<string, unknown>,\n  args: NodeSendTextArgs,\n): string | undefined {\n  const bare = withoutAffixes(data)\n  switch (nodeType) {\n    case \"llm-chat\":\n      return computeLlmChatFields(bare, {\n        override: args.override,\n        wiredUserInput: args.wired,\n        wiredSystemPrompt: args.wiredSystemPrompt,\n        refMap: args.refMap,\n      }).userInput\n    case \"ai-writer\":\n      return computeAiWriterInput(bare, args)\n    case \"generate-script\":\n      return computeScriptTopic(bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n    case \"generate-music\": {\n      // A music node sings typed lyrics with no prompt; only both empty is nothing to send.\n      const prompt = computeNodePrompt(nodeType, bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n      return present(prompt) ? prompt : present(data.lyrics as string | undefined) ? (data.lyrics as string) : \"\"\n    }\n    case \"text-to-speech\":\n    case \"text-to-audio\":\n    case \"generate-image\":\n      return computeNodePrompt(nodeType, bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n    case \"collection-write\": {\n      // The record's content: the item (a fan-out row, else what reached `in`),\n      // else a title, text or link typed on the node. A picture alone is a\n      // record too, but it never starves the node: only a wired TEXT input that\n      // produced nothing can (the skip rule's precondition).\n      // A typed field counts as the engines send it, its `{Node}` references\n      // resolved: `{Feed || }` over a feed with nothing new is empty, so the\n      // node skips instead of failing with an empty record (#1890).\n      const typed = [data.title, data.text, data.link]\n        .map((v) => (typeof v === \"string\" ? resolveNodeRefs(v, args.refMap) : v))\n        .find((v): v is string => present(v as string | undefined))\n      return [args.override, args.wired, typed].find(present) ?? \"\"\n    }\n    default:\n      return undefined\n  }\n}\n"]}
+{"version":3,"sources":["../src/audio-tags.ts","../src/node-send-text.ts"],"names":[],"mappings":"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","file":"chunk-YS6HOWMW.js","sourcesContent":["/**\n * Remove inline `[audio tags]` from speech text, for a model that does not\n * perform them (it would read them aloud). Pure, dependency-free: the\n * backend's credit counter (lib/speech-credits.ts), its payload builder and\n * the editor's estimate (frontend/src/lib/speech-estimate.ts) all read it, so\n * the two engines count exactly the same characters.\n *\n * A tag is `[`, one or more characters that are not `]`, then `]` — what\n * `/\\[[^\\]]+\\]/g` matches. That pattern is quadratic on an unclosed run of `[`\n * (every `[` rescans to the end of the text), and the credit counter runs this\n * on raw request text on the API and orchestrator event loops, so the scan is\n * written by hand: one `indexOf` per `[`, and when no `]` is left no later `[`\n * can match either, so the rest of the text is kept in one slice.\n */\nfunction removeBracketTags(text: string): string {\n  let out = \"\"\n  let from = 0\n  let open = text.indexOf(\"[\")\n  while (open !== -1) {\n    const close = text.indexOf(\"]\", open + 1)\n    if (close === -1) break\n    if (close === open + 1) {\n      // \"[]\" is not a tag (needs 1+ characters); the \"[\" stays and the scan moves on.\n      open = text.indexOf(\"[\", open + 1)\n      continue\n    }\n    out += text.slice(from, open)\n    from = close + 1\n    open = text.indexOf(\"[\", from)\n  }\n  return out + text.slice(from)\n}\n\nexport function stripAudioTags(text: string): string {\n  return removeBracketTags(text).replace(/\\s{2,}/g, \" \").trim()\n}\n","import { resolveNodeRefs } from \"@nodaro/shared/workflow\"\nimport { SOCIAL_POST_NODE_TYPES } from \"@nodaro/shared/social\"\nimport { computeLlmChatFields, computeNodePrompt, computeScriptTopic } from \"./resolve-prompt.js\"\n\n/**\n * Output nodes that send exactly what is WIRED into them — a webhook's\n * parameters, a social post's caption and media. When every wire produced\n * nothing in this run (a Filter List that kept no row, a node that was itself\n * skipped), there is nothing to send: the node is skipped with\n * `skipReason: \"empty_input\"` instead of posting an empty payload (a site that\n * validates its input answers 400 and alerts its owner) or failing the run\n * (a publish route refuses a post with no text and no media). A typed caption\n * with no wire at all is the author's choice and still runs, as before. ONE\n * list, read by the orchestrator's skip rule (`empty-input-skips.ts`).\n */\nexport const WIRED_OUTPUT_NODE_TYPES: ReadonlySet<string> = new Set([\"webhook-output\", ...SOCIAL_POST_NODE_TYPES])\n\n/**\n * Node types that send TEXT to a model or a voice and fail on an empty one —\n * `userInput: Too small` (llm-chat), \"no text found\" (text-to-speech) — so a\n * run with nothing upstream can skip them instead of failing. Never an image\n * or video node (an empty prompt is a legal request there) and never a social\n * post (an empty caption is the author's choice). ONE list, read by the\n * orchestrator's skip rule (`empty-input-skips.ts`); the engine never names a\n * type on its own.\n */\nexport const TEXT_REQUIRED_NODE_TYPES: ReadonlySet<string> = new Set([\n  \"llm-chat\",\n  \"ai-writer\",\n  \"generate-script\",\n  \"text-to-speech\",\n  \"generate-music\",\n  \"text-to-audio\",\n  // Save to Collection refuses an empty record (\"nothing to save\"): a feed\n  // with nothing new wired straight into it must skip it, not fail the run.\n  \"collection-write\",\n  // Generate Image: an empty prompt is a legal request in general (references\n  // alone), but when the text it was WIRED produced nothing this run — the skip\n  // rule's precondition — an empty prompt is a paid picture of nothing.\n  \"generate-image\",\n])\n\n/**\n * The node's data without its prompt pre/post text: the skip decision is about\n * the CORE text. A prefix alone (\"Write a news item about:\") is not something\n * to send — with the affixes applied, an empty core read as non-empty and an\n * idle tick paid for a model call on the prefix.\n */\nconst withoutAffixes = (data: Record<string, unknown>): Record<string, unknown> => ({ ...data, promptPrefix: undefined, promptSuffix: undefined })\n\nexport interface NodeSendTextArgs {\n  /** A list fan-out item (highest precedence). */\n  override?: string\n  /** The text wired into the node's main text input. */\n  wired?: string\n  /** llm-chat only: the text wired into `system-prompt`. */\n  wiredSystemPrompt?: string\n  refMap: ReadonlyMap<string, string>\n}\n\nconst present = (s?: string): s is string => typeof s === \"string\" && s.trim().length > 0\n\n/**\n * ai-writer's user input — the rule its sync-HTTP body applies: a fan-out\n * item, else the wired text, else the typed `userInput`, else the legacy\n * `prompt`. (ai-writer is renamed to llm-chat on load; saved graphs that\n * never reloaded still run it.)\n */\nexport function computeAiWriterInput(\n  data: Record<string, unknown>,\n  { override, wired }: Pick<NodeSendTextArgs, \"override\" | \"wired\">,\n): string {\n  return [override, wired, data.userInput as string | undefined, data.prompt as string | undefined].find(present) ?? \"\"\n}\n\n/**\n * The text a text-requiring node would send, by the SAME rule its executor\n * uses (`computeLlmChatFields`, `computeScriptTopic`, `computeNodePrompt`,\n * `computeAiWriterInput`) — so \"would this node run on nothing?\" is answered\n * by the function that decides what it sends, not by a second reading of it.\n * Undefined for any other node type.\n */\nexport function computeNodeSendText(\n  nodeType: string,\n  data: Record<string, unknown>,\n  args: NodeSendTextArgs,\n): string | undefined {\n  const bare = withoutAffixes(data)\n  switch (nodeType) {\n    case \"llm-chat\":\n      return computeLlmChatFields(bare, {\n        override: args.override,\n        wiredUserInput: args.wired,\n        wiredSystemPrompt: args.wiredSystemPrompt,\n        refMap: args.refMap,\n      }).userInput\n    case \"ai-writer\":\n      return computeAiWriterInput(bare, args)\n    case \"generate-script\":\n      return computeScriptTopic(bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n    case \"generate-music\": {\n      // A music node sings typed lyrics with no prompt; only both empty is nothing to send.\n      const prompt = computeNodePrompt(nodeType, bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n      return present(prompt) ? prompt : present(data.lyrics as string | undefined) ? (data.lyrics as string) : \"\"\n    }\n    case \"text-to-speech\":\n    case \"text-to-audio\":\n    case \"generate-image\":\n      return computeNodePrompt(nodeType, bare, { override: args.override, wired: args.wired, refMap: args.refMap })\n    case \"collection-write\": {\n      // The record's content: the item (a fan-out row, else what reached `in`),\n      // else a title, text or link typed on the node. A picture alone is a\n      // record too, but it never starves the node: only a wired TEXT input that\n      // produced nothing can (the skip rule's precondition).\n      // A typed field counts as the engines send it, its `{Node}` references\n      // resolved: `{Feed || }` over a feed with nothing new is empty, so the\n      // node skips instead of failing with an empty record (#1890).\n      const typed = [data.title, data.text, data.link]\n        .map((v) => (typeof v === \"string\" ? resolveNodeRefs(v, args.refMap) : v))\n        .find((v): v is string => present(v as string | undefined))\n      return [args.override, args.wired, typed].find(present) ?? \"\"\n    }\n    default:\n      return undefined\n  }\n}\n"]}

package/dist/entries/assembly.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunk22KZOAGL_cjs = require('../chunk-22KZOAGL.cjs');
+var chunkC3NHNECH_cjs = require('../chunk-C3NHNECH.cjs');
 require('../chunk-WRM52ZBN.cjs');
 require('../chunk-4GKTOVFM.cjs');
 require('../chunk-XUZXBY75.cjs');
@@ -19,87 +19,95 @@ require('../chunk-Q7SFCCGT.cjs');
 
 Object.defineProperty(exports, "REF_BINDING", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.REF_BINDING; }
+  get: function () { return chunkC3NHNECH_cjs.REF_BINDING; }
 });
 Object.defineProperty(exports, "SEEDANCE_VIDEO_EDIT_PREFIX", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.SEEDANCE_VIDEO_EDIT_PREFIX; }
+  get: function () { return chunkC3NHNECH_cjs.SEEDANCE_VIDEO_EDIT_PREFIX; }
 });
 Object.defineProperty(exports, "appendField", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.appendField; }
+  get: function () { return chunkC3NHNECH_cjs.appendField; }
 });
 Object.defineProperty(exports, "appendMusicMeta", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.appendMusicMeta; }
+  get: function () { return chunkC3NHNECH_cjs.appendMusicMeta; }
 });
 Object.defineProperty(exports, "assembleImageInput", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.assembleImageInput; }
+  get: function () { return chunkC3NHNECH_cjs.assembleImageInput; }
 });
 Object.defineProperty(exports, "assembleSunoInput", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.assembleSunoInput; }
+  get: function () { return chunkC3NHNECH_cjs.assembleSunoInput; }
 });
 Object.defineProperty(exports, "buildSeedanceVideoEditPrompt", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.buildSeedanceVideoEditPrompt; }
+  get: function () { return chunkC3NHNECH_cjs.buildSeedanceVideoEditPrompt; }
 });
 Object.defineProperty(exports, "buildSurroundFillPrompt", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.buildSurroundFillPrompt; }
+  get: function () { return chunkC3NHNECH_cjs.buildSurroundFillPrompt; }
 });
 Object.defineProperty(exports, "composeSoundHintFromConnections", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.composeSoundHintFromConnections; }
+  get: function () { return chunkC3NHNECH_cjs.composeSoundHintFromConnections; }
 });
 Object.defineProperty(exports, "composeVideoPromptText", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.composeVideoPromptText; }
+  get: function () { return chunkC3NHNECH_cjs.composeVideoPromptText; }
 });
 Object.defineProperty(exports, "getEffectiveSunoCustomMode", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.getEffectiveSunoCustomMode; }
+  get: function () { return chunkC3NHNECH_cjs.getEffectiveSunoCustomMode; }
 });
 Object.defineProperty(exports, "identityRefsSentence", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.identityRefsSentence; }
+  get: function () { return chunkC3NHNECH_cjs.identityRefsSentence; }
+});
+Object.defineProperty(exports, "imageBindingFor", {
+  enumerable: true,
+  get: function () { return chunkC3NHNECH_cjs.imageBindingFor; }
+});
+Object.defineProperty(exports, "placeFramesAfterReferences", {
+  enumerable: true,
+  get: function () { return chunkC3NHNECH_cjs.placeFramesAfterReferences; }
 });
 Object.defineProperty(exports, "planFrameDelivery", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.planFrameDelivery; }
+  get: function () { return chunkC3NHNECH_cjs.planFrameDelivery; }
 });
 Object.defineProperty(exports, "promptBindsFirstFrame", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.promptBindsFirstFrame; }
+  get: function () { return chunkC3NHNECH_cjs.promptBindsFirstFrame; }
 });
 Object.defineProperty(exports, "resolveGeminiOmniI2vInputs", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.resolveGeminiOmniI2vInputs; }
+  get: function () { return chunkC3NHNECH_cjs.resolveGeminiOmniI2vInputs; }
 });
 Object.defineProperty(exports, "resolveRefIdTokens", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.resolveRefIdTokens; }
+  get: function () { return chunkC3NHNECH_cjs.resolveRefIdTokens; }
 });
 Object.defineProperty(exports, "resolveReferenceTokens", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.resolveReferenceTokens; }
+  get: function () { return chunkC3NHNECH_cjs.resolveReferenceTokens; }
 });
 Object.defineProperty(exports, "resolveSeedance2Inputs", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.resolveSeedance2Inputs; }
+  get: function () { return chunkC3NHNECH_cjs.resolveSeedance2Inputs; }
 });
 Object.defineProperty(exports, "resolveVeoI2vInputs", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.resolveVeoI2vInputs; }
+  get: function () { return chunkC3NHNECH_cjs.resolveVeoI2vInputs; }
 });
 Object.defineProperty(exports, "resolveVideoReferenceCore", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.resolveVideoReferenceCore; }
+  get: function () { return chunkC3NHNECH_cjs.resolveVideoReferenceCore; }
 });
 Object.defineProperty(exports, "truncateForField", {
   enumerable: true,
-  get: function () { return chunk22KZOAGL_cjs.truncateForField; }
+  get: function () { return chunkC3NHNECH_cjs.truncateForField; }
 });
 //# sourceMappingURL=assembly.cjs.map
 //# sourceMappingURL=assembly.cjs.map

package/dist/entries/assembly.d.cts

@@ -34,7 +34,7 @@ import '../transitions-BLFfAJUH.cjs';
  * 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
@@ -846,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
@@ -877,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;
 
 /**
@@ -901,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
@@ -926,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>;
@@ -939,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;
@@ -955,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
@@ -975,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;
@@ -1048,4 +1104,4 @@ interface FrameDeliveryPlan {
  */
 declare function planFrameDelivery(args: FrameDeliveryPlanArgs): FrameDeliveryPlan;
 
-export { type AssembleImageInput, type AssembleImageResult, 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.d.ts

@@ -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
@@ -846,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
@@ -877,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;
 
 /**
@@ -901,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
@@ -926,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>;
@@ -939,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;
@@ -955,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
@@ -975,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;
@@ -1048,4 +1104,4 @@ interface FrameDeliveryPlan {
  */
 declare function planFrameDelivery(args: FrameDeliveryPlanArgs): FrameDeliveryPlan;
 
-export { type AssembleImageInput, type AssembleImageResult, 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,4 +1,4 @@
-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-XU54YJXQ.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';