hyperframes 0.8.87 → 0.8.89

package/dist/{keyframes-L4PTFVRB.js → keyframes-AXHMLOSU.js}

@@ -6,13 +6,13 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   resolveProject
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import "./chunk-IHFUKJOR.js";
 import {
   ensureDOMParser
 } from "./chunk-PFCFR3KZ.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -47,12 +47,12 @@ import {
 } from "./chunk-2PSPARWP.js";
 import {
   withMeta
-} from "./chunk-RXHJRTDQ.js";
+} from "./chunk-SAYNFMCN.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-RQVDTPGD.js";

package/dist/{layout-RCQKNYDP.js → layout-ZV23GQU6.js}

@@ -10,7 +10,7 @@ import {
   layout_default,
   loadBrowserScript,
   parseAt
-} from "./chunk-V5643PWM.js";
+} from "./chunk-ROFOQAPQ.js";
 import "./chunk-6BPWGLCF.js";
 import "./chunk-XUHOIDKG.js";
 import "./chunk-I7MD2PC7.js";
@@ -23,7 +23,7 @@ import "./chunk-YEIFI443.js";
 import "./chunk-MIYTJ6RX.js";
 import "./chunk-HMQ27CEJ.js";
 import "./chunk-JVYVKXTA.js";
-import "./chunk-BQ4N7ECC.js";
+import "./chunk-C22UJWNH.js";
 import "./chunk-IHFUKJOR.js";
 import "./chunk-PFCFR3KZ.js";
 import "./chunk-MEIIOQNR.js";
@@ -37,8 +37,8 @@ import "./chunk-PWAWHXTQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-VBXD76KN.js";
 import "./chunk-XMNWWURD.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-ZTZA4UWZ.js";
 import "./chunk-AP2WIRY6.js";
@@ -62,12 +62,12 @@ import "./chunk-PJ3HDUCY.js";
 import "./chunk-TQFG7HTI.js";
 import "./chunk-GK4AIFIH.js";
 import "./chunk-2PSPARWP.js";
-import "./chunk-RXHJRTDQ.js";
+import "./chunk-SAYNFMCN.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-RQVDTPGD.js";

package/dist/{lint-FDUB6APN.js → lint-HZIRYUSA.js}

@@ -6,16 +6,16 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   trackLintRun
-} from "./chunk-4GPB7TYV.js";
+} from "./chunk-TQNLHVZB.js";
 import {
   resolveProject
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import {
   formatLintFindings
 } from "./chunk-6CSYCFQV.js";
 import "./chunk-IHFUKJOR.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -50,12 +50,12 @@ import "./chunk-GK4AIFIH.js";
 import "./chunk-2PSPARWP.js";
 import {
   withMeta
-} from "./chunk-RXHJRTDQ.js";
+} from "./chunk-SAYNFMCN.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-RQVDTPGD.js";

package/dist/{list-D6NIQOEY.js → list-DLBDHWZ2.js}

@@ -30,12 +30,12 @@ import {
 } from "./chunk-PBN6GBJE.js";
 import {
   withMeta
-} from "./chunk-RXHJRTDQ.js";
+} from "./chunk-SAYNFMCN.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-M2WBOQ2Q.js";
 

package/dist/{login-M6AWHM6U.js → login-3PLQRQEP.js}

@@ -113,7 +113,7 @@ function assertAttendedDeviceFlow() {
 async function runDeviceLogin() {
   assertAttendedDeviceFlow();
   assertOAuthConfiguredOrExit();
-  const { trackAuthLoginStarted, trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-ZJ6VMRWN.js");
+  const { trackAuthLoginStarted, trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-6P5WHWYI.js");
   trackAuthLoginStarted("device");
   let tokens;
   try {
@@ -178,7 +178,7 @@ async function revokeDeviceTokens(tokens) {
 }
 async function runOAuthLogin() {
   assertOAuthConfiguredOrExit();
-  const { trackAuthLoginStarted, trackAuthLoginFailed } = await import("./telemetry-ZJ6VMRWN.js");
+  const { trackAuthLoginStarted, trackAuthLoginFailed } = await import("./telemetry-6P5WHWYI.js");
   trackAuthLoginStarted("oauth");
   try {
     await startAuthorizationCodeFlow();
@@ -191,7 +191,7 @@ async function runOAuthLogin() {
   await reportIdentity();
 }
 async function reportIdentity() {
-  const { trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-ZJ6VMRWN.js");
+  const { trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-6P5WHWYI.js");
   const credential = await tryResolveCredential();
   if (!credential) {
     trackAuthLoginFailed("oauth", "no_credential");
@@ -248,7 +248,7 @@ async function clearUserInfoBestEffort() {
   }
 }
 async function runApiKeyLogin(inlineKey) {
-  const { trackAuthLoginStarted, trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-ZJ6VMRWN.js");
+  const { trackAuthLoginStarted, trackAuthLoginCompleted, trackAuthLoginFailed, identifyUser } = await import("./telemetry-6P5WHWYI.js");
   trackAuthLoginStarted("api_key");
   let key;
   try {

package/dist/{media-treatment-MRNN2DOS.js → media-treatment-7TZ7L7NU.js}

@@ -12,15 +12,15 @@ import {
 } from "./chunk-HMQ27CEJ.js";
 import {
   resolveProject
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import "./chunk-IHFUKJOR.js";
 import {
   findFFmpeg,
   findFFprobe,
   getFFmpegInstallHint
 } from "./chunk-TVCRUG2S.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -68,12 +68,12 @@ import {
 import "./chunk-2PSPARWP.js";
 import {
   withMeta
-} from "./chunk-RXHJRTDQ.js";
+} from "./chunk-SAYNFMCN.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/{normalize-audio-WB76C7OQ.js → normalize-audio-SX64JNLW.js}

@@ -6,10 +6,10 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   resolveProject
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import "./chunk-IHFUKJOR.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -46,7 +46,7 @@ import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-RQVDTPGD.js";

package/dist/{play-N5FZSNGF.js → play-VX2LSHXR.js}

@@ -37,7 +37,7 @@ import {
 } from "./chunk-LFGJWOVA.js";
 import {
   resolveProject
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import "./chunk-IHFUKJOR.js";
 import {
   resolveAutoProxy
@@ -56,8 +56,8 @@ import "./chunk-PWAWHXTQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-VBXD76KN.js";
 import "./chunk-XMNWWURD.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -91,7 +91,7 @@ import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-RQVDTPGD.js";

package/dist/{present-N24VMIWP.js → present-F2DPEKZU.js}

@@ -22,7 +22,7 @@ import {
 } from "./chunk-LFGJWOVA.js";
 import {
   resolveProject
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import "./chunk-IHFUKJOR.js";
 import {
   R,
@@ -30,8 +30,8 @@ import {
   ge
 } from "./chunk-WMQNIQDJ.js";
 import "./chunk-XMNWWURD.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -65,7 +65,7 @@ import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import "./chunk-KNU5COPB.js";
 import "./chunk-3GXQPCJC.js";
 import "./chunk-RQVDTPGD.js";

package/dist/{preview-RO3INI3V.js → preview-ARITZNNL.js}

@@ -12,7 +12,7 @@ import {
 import {
   resolveProject,
   resolveProjectOrThrow
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
@@ -42,8 +42,8 @@ import "./chunk-FWDM3N34.js";
 import "./chunk-PWAWHXTQ.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-VBXD76KN.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -88,7 +88,7 @@ import "./chunk-WERLJGIC.js";
 import {
   isDevMode
 } from "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";
@@ -1578,7 +1578,7 @@ async function runLocalStudioMode(dir, options) {
   return waitForStudioChildClose(child);
 }
 async function runEmbeddedMode(dir, startPort, options) {
-  const { createStudioServer, loadPreviewServerBuildSignature, resolveStudioBundle } = await import("./studioServer-HIKBLJCQ.js");
+  const { createStudioServer, loadPreviewServerBuildSignature, resolveStudioBundle } = await import("./studioServer-2IK5LLRR.js");
   const pName = options?.projectName ?? basename(dir);
   const studioBundle = resolveStudioBundle();
   if (!options?.json) ge(c.bold("hyperframes preview"));

package/dist/{render-FQ7VV2TU.js → render-2VWTXUCT.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   maybePromptRenderFeedback
-} from "./chunk-C4LRCQ7O.js";
+} from "./chunk-RLKPZQKI.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
@@ -32,7 +32,7 @@ import {
 import "./chunk-YEIFI443.js";
 import {
   resolveProject
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
@@ -79,8 +79,8 @@ import {
   trackRenderError,
   trackRenderObservation,
   trackRenderPreflightRejected
-} from "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+} from "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -160,7 +160,7 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-OAT3NROY.js";
+} from "./chunk-Z4LBLZ3I.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/{render-FULEBKUN.js → render-FT4NTFKZ.js}

@@ -37,15 +37,15 @@ import "./chunk-RZAXPDIT.js";
 import "./chunk-DNXD7TOA.js";
 import {
   resolveProject
-} from "./chunk-BQ4N7ECC.js";
+} from "./chunk-C22UJWNH.js";
 import {
   errorBox,
   formatBytes,
   formatDuration
 } from "./chunk-IHFUKJOR.js";
 import "./chunk-PFCFR3KZ.js";
-import "./chunk-O24S2D45.js";
-import "./chunk-V3RCZR7L.js";
+import "./chunk-S2F6QM6J.js";
+import "./chunk-EAJNP7C7.js";
 import "./chunk-VWG7OQKU.js";
 import {
   c
@@ -75,12 +75,12 @@ import "./chunk-GK4AIFIH.js";
 import "./chunk-2PSPARWP.js";
 import {
   withMeta
-} from "./chunk-RXHJRTDQ.js";
+} from "./chunk-SAYNFMCN.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-OAT3NROY.js";
+import "./chunk-Z4LBLZ3I.js";
 import {
   normalizeErrorMessage
 } from "./chunk-KNU5COPB.js";

package/dist/skills/media-use/audio/references/bgm.md

@@ -15,6 +15,8 @@ One music bed per composition, produced by the shared audio engine (`scripts/aud
 - **`query`** — the mood, used for retrieval and as a fallback prompt seed (e.g. a storyboard's `music:` field, falling back to `message` → `arc` → `"calm cinematic underscore"`).
 - **`prompt`** — an explicit full prompt for generation; omit and the engine infers one (see Mood inference). Optional `blob` / `archetype` / `arc` feed that inference.
 
+Both routes keep a file of yours already at the output name: the engine writes the next free name (`track-2.mp3`), reports it as an anomaly, and `bgm.path` carries the real path.
+
 ## HeyGen retrieval (default)
 
 `searchSounds(query, "music", { limit: 5 })` → `GET /audio/sounds?query=<mood>&type=music&limit=5`. Take the top result (ranked by `score`), download its presigned `audio_url` → `assets/bgm/track.mp3`. Synchronous. No match → skip (BGM is optional; never fail the render over it). Cue written to `audio_meta.json`:

package/dist/skills/media-use/audio/references/sfx.md

@@ -16,15 +16,14 @@ Each line names the effects it wants: `lines[].sfx: ["whoosh", "ui click"]`. The
   "id": "3",                       // joins the cue to the caller's model (frame / scene / segment)
   "name": "whoosh",
   "file": "assets/sfx/whoosh.mp3", // downloaded or copied, relative to project root
-  "source": "heygen" | "local" | "project", // which route resolved it; "project": a file already
-                                   // in assets/sfx under that name that is not the library's copy
+  "source": "heygen" | "local",    // which route resolved it
   "offset_s": 0,                   // delay from the line's start
   "duration_s": 0.57,
   "volume": 0.35                   // SFX sit UNDER voice + BGM
 }
 ```
 
-A cue that matches nothing is **skipped** (recorded as an anomaly); SFX never blocks a render.
+A cue that matches nothing is **skipped** (recorded as an anomaly); SFX never blocks a render. Neither route replaces a file of yours already at the output name: the cue gets the next free name (`whoosh-2.mp3`), reported as an anomaly, and `file` carries the real path.
 
 ## HeyGen retrieval (credentialed)
 

package/dist/skills/media-use/audio/references/tts.md

@@ -135,7 +135,7 @@ node <SKILL_DIR>/audio/scripts/audio.mjs \
   --request ./audio_request.json --hyperframes . --out ./audio_meta.json --only tts
 ```
 
-The engine saves `assets/voice/intro.wav`, measures its duration, and transcribes
+The engine saves `assets/voice/intro.wav` (or `intro-2.wav` when a file of yours already has that name; `voices[].path` says which), measures its duration, and transcribes
 it into `voices[].words` in `audio_meta.json`. Check that every requested line
 has audio and nonempty word timings before building a captioned video. Review
 the timings against the actual audio; transcription is estimated alignment,

package/dist/skills/media-use/audio/scripts/audio.mjs

@@ -55,7 +55,7 @@ import { generateBgmDetached, inferBgmPrompt, retrieveBgm } from "./lib/bgm.mjs"
 import { resolveSfx } from "./lib/sfx.mjs";
 import { mapWithConcurrency } from "./lib/concurrency.mjs";
 import { openAudioMeta } from "./lib/audio-meta.mjs";
-import { recordInManifest, writtenAssets } from "./lib/media-record.mjs";
+import { recordInManifest, voicePaths, writtenAssets } from "./lib/media-record.mjs";
 
 const HERE = dirname(fileURLToPath(import.meta.url));
 const argv = process.argv.slice(2);
@@ -138,6 +138,7 @@ if (only.has("tts") && lines.length) {
     lang,
   });
   console.error(`· tts: ${ttsProvider} · voice ${voiceId} · ${lines.length} line(s)`);
+  const paths = voicePaths(hyperframesDir, lines, anomalies);
   const synthLine = async (line) => {
     const id = String(line.id);
     const text = String(line.text ?? "").trim();
@@ -145,7 +146,7 @@ if (only.has("tts") && lines.length) {
       anomalies.push(`line ${id}: empty text — skipped`);
       return null;
     }
-    const rel = `assets/voice/${id}.wav`;
+    const rel = paths.get(id);
     const abs = join(hyperframesDir, rel);
     const { ok, words, error } = await synthesizeOne({
       provider: ttsProvider,
@@ -217,6 +218,7 @@ if (only.has("bgm")) {
         headers: heygenAuthHeaders(),
         hyperframesDir,
         hasVoice,
+        anomalies,
       });
       if (bgm) {
         bgmFields.bgm_provider = "heygen";
@@ -243,6 +245,7 @@ if (only.has("bgm")) {
       lyriaRecipe: existsSync(lyriaRecipe) ? lyriaRecipe : null,
       seedSeconds,
       hasVoice,
+      anomalies,
     });
     if (gen.disabled) {
       anomalies.push(`bgm: ${gen.reason}`);

package/dist/skills/media-use/audio/scripts/audio.test.mjs

@@ -1,9 +1,10 @@
 import { strict as assert } from "node:assert";
 import { test } from "node:test";
-import { mkdtempSync, rmSync, existsSync, writeFileSync } from "node:fs";
+import { mkdtempSync, mkdirSync, readFileSync, rmSync, existsSync, writeFileSync } from "node:fs";
 import { join, dirname } from "node:path";
 import { tmpdir } from "node:os";
 import { fileURLToPath } from "node:url";
+import { recordInManifest } from "./lib/media-record.mjs";
 import { resolveSfx } from "./lib/sfx.mjs";
 
 // Proves the relocated engine (skills/media-use/audio/) still resolves its
@@ -48,9 +49,12 @@ test("an unknown cue is reported, not fatal", async () => {
   }
 });
 
-test("a person's own file under a bundled name is not labelled as the library's", async () => {
+test("a person's own file under a bundled name survives, and the cue gets the next free name", async () => {
   const dir = mkdtempSync(join(tmpdir(), "mu-audio-"));
   try {
+    const own = join(dir, "assets", "sfx", "whoosh.mp3");
+    mkdirSync(dirname(own), { recursive: true });
+    writeFileSync(own, "the person's own whoosh");
     const resolve = () =>
       resolveSfx({
         cues: [{ id: "1", name: "whoosh" }],
@@ -58,16 +62,65 @@ test("a person's own file under a bundled name is not labelled as the library's"
         hyperframesDir: dir,
         sfxLibDir,
       });
-    const copied = await resolve();
-    const reused = await resolve();
-    writeFileSync(join(dir, copied.sfx[0].file), "the person's own whoosh");
-    const own = await resolve();
 
+    const first = await resolve();
+    const second = await resolve();
+
+    assert.equal(readFileSync(own, "utf8"), "the person's own whoosh");
+    assert.deepEqual(
+      [first, second].map(({ sfx }) => [sfx[0].file, sfx[0].source]),
+      [
+        ["assets/sfx/whoosh-2.mp3", "local"],
+        ["assets/sfx/whoosh-2.mp3", "local"],
+      ],
+    );
     assert.deepEqual(
-      [copied, reused, own].map(({ sfx }) => sfx[0].source),
-      ["local", "local", "project"],
+      readFileSync(join(dir, "assets/sfx/whoosh-2.mp3")),
+      readFileSync(join(sfxLibDir, "whoosh.mp3")),
     );
   } finally {
     rmSync(dir, { recursive: true, force: true });
   }
 });
+
+test("two effects never share a file when one's name is taken by the person, run after run", async () => {
+  const dir = mkdtempSync(join(tmpdir(), "mu-audio-"));
+  try {
+    mkdirSync(join(dir, "assets", "sfx"), { recursive: true });
+    writeFileSync(join(dir, "assets", "sfx", "glitch.mp3"), "the person's own glitch");
+    const realFetch = globalThis.fetch;
+    globalThis.fetch = async (url) => {
+      const query = new URL(url).searchParams.get("query");
+      if (query)
+        return Response.json({ data: [{ audio_url: `https://sound.test/${query}`, score: 0.6 }] });
+      return new Response(`bytes of ${new URL(url).pathname}`);
+    };
+    const run = async (names) => {
+      const { sfx } = await resolveSfx({
+        cues: names.map((name, index) => ({ id: String(index), name })),
+        heygenOK: true,
+        headers: {},
+        hyperframesDir: dir,
+        sfxLibDir,
+      });
+      const files = sfx.map(({ file }) => file);
+      recordInManifest(
+        dir,
+        [...new Set(files)].map((path) => ({ path, type: "sfx", source: "search" })),
+      );
+      return files;
+    };
+    try {
+      assert.deepEqual(await run(["glitch"]), ["assets/sfx/glitch-2.mp3"]);
+      assert.deepEqual(await run(["glitch", "glitch 2", "glitch"]), [
+        "assets/sfx/glitch-2.mp3",
+        "assets/sfx/glitch-2-2.mp3",
+        "assets/sfx/glitch-2.mp3",
+      ]);
+    } finally {
+      globalThis.fetch = realFetch;
+    }
+  } finally {
+    rmSync(dir, { recursive: true, force: true });
+  }
+});

package/dist/skills/media-use/audio/scripts/gemini-pipeline.test.mjs

@@ -9,9 +9,15 @@ import { spawnSync } from "node:child_process";
 // external audio tools are fixtures. This is not a live synthesis/render test.
 for (const expired of [false, true]) {
   for (const only of ["tts", "tts,bgm,sfx"]) {
+    // With expired credentials the person already has an assets/voice/intro.wav, which the engine must keep.
+    const voicePath = expired ? "assets/voice/intro-2.wav" : "assets/voice/intro.wav";
     test(`Gemini engine returns caption metadata with ${expired ? "expired" : "absent"} HeyGen credentials (${only})`, (t) => {
       const dir = mkdtempSync(join(tmpdir(), "hf-gemini-pipeline-"));
       t.after(() => rmSync(dir, { recursive: true, force: true }));
+      if (expired) {
+        mkdirSync(join(dir, "assets/voice"), { recursive: true });
+        writeFileSync(join(dir, "assets/voice/intro.wav"), "the person's own intro");
+      }
       const config = join(dir, "heygen");
       mkdirSync(config);
       if (expired)
@@ -48,7 +54,7 @@ const assert = require('node:assert/strict');
 const fs = require('node:fs');
 const path = require('node:path');
 const args = process.argv.slice(2);
-assert.deepEqual(args.slice(0, 3), ['hyperframes', 'transcribe', 'assets/voice/intro.wav']);
+assert.deepEqual(args.slice(0, 3), ['hyperframes', 'transcribe', '${voicePath}']);
 assert.ok(fs.existsSync(args[2]));
 assert.equal(args[args.indexOf('--model')+1], 'small.en');
 fs.writeFileSync(path.join(args[args.indexOf('--dir')+1], 'transcript.json'), JSON.stringify([
@@ -99,7 +105,7 @@ fs.writeFileSync(path.join(args[args.indexOf('--dir')+1], 'transcript.json'), JS
       assert.deepEqual(meta.voices, [
         {
           id: "intro",
-          path: "assets/voice/intro.wav",
+          path: voicePath,
           duration_s: 1.25,
           words: [
             { id: "w0", text: "Hello", start: 0.1, end: 0.4 },
@@ -113,8 +119,13 @@ fs.writeFileSync(path.join(args[args.indexOf('--dir')+1], 'transcript.json'), JS
         manifest
           .map((line) => JSON.parse(line))
           .map(({ path, type, source }) => [path, type, source]),
-        [["assets/voice/intro.wav", "voice", "generated"]],
+        [[voicePath, "voice", "generated"]],
       );
+      if (expired)
+        assert.equal(
+          readFileSync(join(dir, "assets/voice/intro.wav"), "utf8"),
+          "the person's own intro",
+        );
     });
   }
 }