@slatesvideo/shared 0.6.1 → 0.6.2

package/dist/prompts/reference-composer.js

@@ -170,12 +170,23 @@ export function composeReferences(rawPrompt, groups, opts = {}) {
             topKeys.push(`${noun} ${joinNums(g.videoNums)} ${tail}`);
         }
     }
-    // Reference audio ("Audio 1 is a provided reference.").
+    // Reference audio ("Audio 1 is a provided reference."), plus THE WORDS when
+    // the user has typed them — see ReferenceGroup.spokenText for why the words
+    // have to travel as text as well as audio.
     for (const g of numbered) {
         if (g.kind === 'audio-ref' && g.audioNums.length > 0) {
             const noun = g.audioNums.length === 1 ? 'Audio' : 'Audios';
             const tail = g.audioNums.length === 1 ? 'is a provided reference.' : 'are provided references.';
             topKeys.push(`${noun} ${joinNums(g.audioNums)} ${tail}`);
+            // Trimmed, never rewritten: the words between the quotes are the user's
+            // exactly as typed. The delimiters are CURLY on purpose — a straight
+            // quote inside the user's own line then sits beside them without
+            // colliding, so nothing has to be escaped and nothing is edited.
+            const spoken = (g.spokenText ?? '').trim();
+            if (spoken) {
+                const lower = g.audioNums.length === 1 ? 'audio' : 'audios';
+                topKeys.push(`The words spoken in ${lower} ${joinNums(g.audioNums)} are exactly: “${spoken}”`);
+            }
         }
     }
     // 🚨 A PINNED REFERENCE IMAGE GETS NO KEY LINE, DELIBERATELY (2026-08-10).
@@ -241,6 +252,64 @@ export function composeReferences(rawPrompt, groups, opts = {}) {
         unresolvedTokens,
     };
 }
+/**
+ * Translate `@character` mentions into Seed Audio's OWN `@AudioN` notation.
+ *
+ * 🚨 AN ADAPTER, NOT A SECOND COMPOSER — the same relationship
+ * `composeKlingEdit` has to `composeReferences`. Seed Audio does not read
+ * "audio 1"; it reads `@Audio1`-`@Audio3`, and a clip the prompt never cites is
+ * a clip the model ignores. Attaching a voice without citing it would be the
+ * silent-drop failure this repo catalogues by name: attach the reference, get
+ * no error, get no warning, and get a request that does nothing with it.
+ *
+ * It emits the SAME grammar the image composer uses — the first mention
+ * becomes `Sarah (@Audio1)`, later ones stay `Sarah` — so the NAME still
+ * carries the identity and the citation carries the slot. A voice that is
+ * attached but never mentioned gets one short key line instead, exactly as an
+ * unmentioned character's image does.
+ *
+ * Everything else is left as authored: an `@token` that is not one of these
+ * voices is not ours to touch.
+ *
+ * A `null` slot means "this position is a clip the caller cites itself" — it
+ * holds its @AudioN number and is otherwise ignored.
+ */
+export function composeVoiceCitations(rawPrompt, voices) {
+    if (voices.length === 0)
+        return rawPrompt;
+    const byNorm = new Map();
+    voices.forEach((v, i) => {
+        if (v?.token)
+            byNorm.set(normToken(v.token), { n: i + 1, name: v.name });
+    });
+    const seen = new Set();
+    const body = rawPrompt.replace(/@([\w-]+)/g, (full, tok) => {
+        const key = normToken(`@${tok}`);
+        const v = byNorm.get(key);
+        if (!v)
+            return full;
+        if (seen.has(key))
+            return v.name;
+        seen.add(key);
+        return `${v.name} (@Audio${v.n})`;
+    });
+    const keys = [];
+    voices.forEach((v, i) => {
+        // A null slot is a clip the CALLER already cited itself (the agent route
+        // passes its own `audioReferenceAssetIds` this way). It still occupies its
+        // @AudioN position — renumbering would repoint every citation a published
+        // CLI build wrote — but it is not ours to name.
+        if (!v)
+            return;
+        if (v.token && seen.has(normToken(v.token)))
+            return;
+        keys.push(`${v.name} is @Audio${i + 1}.`);
+    });
+    if (keys.length === 0)
+        return body;
+    const trimmed = body.trim();
+    return trimmed ? `${keys.join(' ')}\n\n${trimmed}` : keys.join(' ');
+}
 /** fal cap: max 4 combined element + style-image references per edit request. */
 export const KLING_EDIT_MAX_REFS = 4;
 /**