hyperframes 0.8.168 → 0.8.170

package/dist/{preview-EYQG7L6X.js → preview-CZENYIGN.js}

@@ -18,7 +18,7 @@ import {
 import {
   resolveProject,
   resolveProjectOrThrow
-} from "./chunk-LGCHE2F4.js";
+} from "./chunk-EJYBYR4C.js";
 import "./chunk-K2FLNJVB.js";
 import "./chunk-DCAI5DBR.js";
 import {
@@ -31,21 +31,21 @@ import {
 } from "./chunk-DQBY7FRR.js";
 import {
   resolveLocalBrowserGpuMode
-} from "./chunk-DO3UPPO4.js";
+} from "./chunk-PXA4S6OE.js";
 import {
   resolveAutoProxy
-} from "./chunk-C3WPYYGK.js";
+} from "./chunk-PCX3YF2U.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-QKJ4KGNR.js";
-import "./chunk-54MI3SGP.js";
-import "./chunk-ID7B7NGN.js";
+import "./chunk-44GV6ZMC.js";
+import "./chunk-QO3JEPEW.js";
+import "./chunk-2E7NDKTN.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-YTZA25TZ.js";
-import "./chunk-YULVV525.js";
+import "./chunk-4B6PUT4R.js";
+import "./chunk-FSP2JNAP.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-QWQ6GQTI.js";
 import {
@@ -70,19 +70,19 @@ import "./chunk-WERLJGIC.js";
 import {
   isDevMode
 } from "./chunk-ISN5GRYI.js";
-import "./chunk-BC2XZL6O.js";
+import "./chunk-UQPH3Y45.js";
 import "./chunk-EOVYQ3IG.js";
 import {
   buildNpxCommand
 } from "./chunk-6BEFEWFB.js";
 import "./chunk-XT6MXC7A.js";
-import "./chunk-CAHSX6IW.js";
-import "./chunk-KDC5D5VM.js";
+import "./chunk-VKFYI7AQ.js";
+import "./chunk-FAORS3UR.js";
 import "./chunk-KCF6GHJP.js";
 import "./chunk-JYVGYKXG.js";
 import "./chunk-7KDQAD2W.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";
@@ -1701,7 +1701,7 @@ async function runLocalStudioMode(dir, options) {
   return waitForStudioChildClose(child);
 }
 async function runEmbeddedMode(dir, startPort, options) {
-  const { createStudioServer, loadPreviewServerBuildSignature, resolveStudioBundle } = await import("./studioServer-DMDE7IZU.js");
+  const { createStudioServer, loadPreviewServerBuildSignature, resolveStudioBundle } = await import("./studioServer-7HWDCLKT.js");
   const pName = options?.projectName ?? basename(dir);
   const studioBundle = resolveStudioBundle();
   if (!options?.json) ge(c.bold("hyperframes preview"));
@@ -1831,7 +1831,7 @@ async function runEmbeddedMode(dir, startPort, options) {
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
-    import("./src-5XO7KBBL.js").then(({ killTrackedProcesses }) => {
+    import("./src-VFTQPSQD.js").then(({ killTrackedProcesses }) => {
       process.once("exit", () => {
         if (!shuttingDown) killTrackedProcesses();
       });

package/dist/{producer-FKOEAHJW.js → producer-23NJEJRO.js}

@@ -6,7 +6,7 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   loadProducer
-} from "./chunk-4WPRJ7ID.js";
+} from "./chunk-NSJLCWLG.js";
 import "./chunk-M2WBOQ2Q.js";
 export {
   loadProducer

package/dist/{projectConfig-SXW3QMZE.js → projectConfig-R3FCIARW.js}

@@ -17,18 +17,18 @@ import {
   resolveAutoProxy,
   seedProjectAuthoringSkill,
   writeProjectConfig
-} from "./chunk-C3WPYYGK.js";
+} from "./chunk-PCX3YF2U.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-QKJ4KGNR.js";
-import "./chunk-54MI3SGP.js";
-import "./chunk-ID7B7NGN.js";
+import "./chunk-44GV6ZMC.js";
+import "./chunk-QO3JEPEW.js";
+import "./chunk-2E7NDKTN.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/{publication-ZC4LDEXQ.js → publication-GY3OJ6VH.js}

@@ -8,8 +8,8 @@ import {
   publishRegistryFile,
   registryTargetPath
 } from "./chunk-GMECXFAN.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/{publish-4ZCLHA5W.js → publish-XBW4NVFY.js}

@@ -29,17 +29,17 @@ import {
   proxyVariantFor,
   resolveProxies,
   scanProjectMediaCodecMap
-} from "./chunk-AQZZZTFL.js";
+} from "./chunk-AGHHZIZN.js";
 import "./chunk-FFDC5OWV.js";
 import {
   resolveAutoProxy
-} from "./chunk-C3WPYYGK.js";
+} from "./chunk-PCX3YF2U.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import "./chunk-HVW7ABXD.js";
-import "./chunk-QKJ4KGNR.js";
-import "./chunk-54MI3SGP.js";
-import "./chunk-ID7B7NGN.js";
+import "./chunk-44GV6ZMC.js";
+import "./chunk-QO3JEPEW.js";
+import "./chunk-2E7NDKTN.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
@@ -64,8 +64,8 @@ import {
   definitiveEntryMismatchComposition,
   hasDefinitiveEntryMismatch
 } from "./chunk-Q5X2B5WT.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/{remove-background-IGDRS2QV.js → remove-background-Q7CQ3PJF.js}

@@ -19,7 +19,7 @@ import {
 import {
   RemoveBackgroundError,
   removeBackground
-} from "./chunk-NYIKKCMC.js";
+} from "./chunk-X3U6KEID.js";
 import {
   DEFAULT_MODEL,
   DEFAULT_QUALITY,
@@ -31,19 +31,19 @@ import {
   listAvailableProviders,
   modelPath,
   selectProviders
-} from "./chunk-LUSWL6OJ.js";
+} from "./chunk-ERJHLFPD.js";
 import "./chunk-3DKN5WKL.js";
 import "./chunk-6BEFEWFB.js";
 import "./chunk-PO2SDVQA.js";
 import "./chunk-IK3SOMZ4.js";
 import "./chunk-XT6MXC7A.js";
-import "./chunk-CAHSX6IW.js";
-import "./chunk-KDC5D5VM.js";
+import "./chunk-VKFYI7AQ.js";
+import "./chunk-FAORS3UR.js";
 import "./chunk-KCF6GHJP.js";
 import "./chunk-JYVGYKXG.js";
 import "./chunk-7KDQAD2W.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/{render-ZN777RDD.js → render-24JWWXMA.js}

@@ -15,7 +15,7 @@ import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-BOT7PGM5.js";
+} from "./chunk-T5LGOTQR.js";
 import "./chunk-FH7WODJH.js";
 import "./chunk-K2FLNJVB.js";
 import "./chunk-442JNXRM.js";
@@ -25,8 +25,8 @@ import {
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/{render-TA3DG3LZ.js → render-DOHHCT2G.js}

@@ -35,18 +35,18 @@ import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-BOT7PGM5.js";
+} from "./chunk-T5LGOTQR.js";
 import {
   resolveProject
-} from "./chunk-LGCHE2F4.js";
+} from "./chunk-EJYBYR4C.js";
 import {
   errorBox,
   formatBytes,
   formatDuration
 } from "./chunk-K2FLNJVB.js";
 import "./chunk-442JNXRM.js";
-import "./chunk-YTZA25TZ.js";
-import "./chunk-YULVV525.js";
+import "./chunk-4B6PUT4R.js";
+import "./chunk-FSP2JNAP.js";
 import "./chunk-VWG7OQKU.js";
 import "./chunk-QWQ6GQTI.js";
 import {
@@ -61,12 +61,12 @@ import {
 } from "./chunk-ZTZA4UWZ.js";
 import {
   withMeta
-} from "./chunk-O7BABHM4.js";
+} from "./chunk-GG3V5BHG.js";
 import "./chunk-K4WIOZFP.js";
 import "./chunk-XUXGIA7H.js";
 import "./chunk-WERLJGIC.js";
 import "./chunk-ISN5GRYI.js";
-import "./chunk-BC2XZL6O.js";
+import "./chunk-UQPH3Y45.js";
 import {
   downloadToFile
 } from "./chunk-BXCMXMJQ.js";
@@ -74,8 +74,8 @@ import "./chunk-EOVYQ3IG.js";
 import "./chunk-XT6MXC7A.js";
 import "./chunk-JYVGYKXG.js";
 import "./chunk-7KDQAD2W.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/{render-QJCBJQOM.js → render-WWAXTKYR.js}

@@ -6,24 +6,24 @@ var __filename = __hf_fileURLToPath(import.meta.url);
 var __dirname = __hf_dirname(__filename);
 import {
   maybePromptRenderFeedback
-} from "./chunk-EXMTTXKQ.js";
+} from "./chunk-T56MM7RC.js";
 import {
   captureArtifactRevision
-} from "./chunk-BWFUUGIZ.js";
-import "./chunk-2GSGFDEP.js";
+} from "./chunk-YFGJVADL.js";
+import "./chunk-KUFEPCR3.js";
 import "./chunk-X7MTZ4T2.js";
 import {
   reportVariableIssues,
   resolveVariablesArg,
   validateVariablesAgainstProject
-} from "./chunk-BOT7PGM5.js";
+} from "./chunk-T5LGOTQR.js";
 import {
   loadProducer
-} from "./chunk-4WPRJ7ID.js";
+} from "./chunk-NSJLCWLG.js";
 import {
   renderJobObservabilityTelemetryPayload,
   startRenderCpuSampler
-} from "./chunk-VTBME36F.js";
+} from "./chunk-ZINH7YA2.js";
 import {
   hasExplicitCompositionArg,
   parseGifLoopArg,
@@ -32,11 +32,11 @@ import {
   resolveCompositionEntryArg,
   resolveDefaultFpsArg,
   windowsChromeCrashRemediation
-} from "./chunk-BTCUP5ZY.js";
+} from "./chunk-LMMFO5UV.js";
 import {
   sandboxDeniedRemediation
-} from "./chunk-2F7S7OK2.js";
-import "./chunk-XR3XDG7V.js";
+} from "./chunk-WICIV6R3.js";
+import "./chunk-JAERN4RH.js";
 import {
   formatLintStartupMessage
 } from "./chunk-6CSYCFQV.js";
@@ -45,7 +45,7 @@ import {
 } from "./chunk-EDUBJPGL.js";
 import {
   resolveProject
-} from "./chunk-LGCHE2F4.js";
+} from "./chunk-EJYBYR4C.js";
 import {
   errorBox,
   formatBytes,
@@ -69,15 +69,15 @@ import {
   loadProjectConfig,
   readProjectConfigWithStatus,
   seedProjectAuthoringSkill
-} from "./chunk-C3WPYYGK.js";
+} from "./chunk-PCX3YF2U.js";
 import "./chunk-XT7X6QCP.js";
 import "./chunk-4YYJOFKS.js";
 import {
   normalizeSkillSlug
 } from "./chunk-HVW7ABXD.js";
-import "./chunk-QKJ4KGNR.js";
-import "./chunk-54MI3SGP.js";
-import "./chunk-ID7B7NGN.js";
+import "./chunk-44GV6ZMC.js";
+import "./chunk-QO3JEPEW.js";
+import "./chunk-2E7NDKTN.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
@@ -86,8 +86,8 @@ import {
   trackRenderError,
   trackRenderObservation,
   trackRenderPreflightRejected
-} from "./chunk-YTZA25TZ.js";
-import "./chunk-YULVV525.js";
+} from "./chunk-4B6PUT4R.js";
+import "./chunk-FSP2JNAP.js";
 import "./chunk-VWG7OQKU.js";
 import {
   bytesToMb
@@ -128,11 +128,11 @@ import {
 } from "./chunk-ISN5GRYI.js";
 import {
   VERSION
-} from "./chunk-BC2XZL6O.js";
+} from "./chunk-UQPH3Y45.js";
 import "./chunk-EOVYQ3IG.js";
 import {
   createRenderCancellationScope
-} from "./chunk-ATOXD5VV.js";
+} from "./chunk-AWSVUIWG.js";
 import {
   H264EncoderUnavailableError,
   chromeLaunchRemediation,
@@ -148,8 +148,8 @@ import {
   MIN_VP9_CPU_USED,
   audioFailureDiagnostics,
   isVideoFrameFormat
-} from "./chunk-CAHSX6IW.js";
-import "./chunk-KDC5D5VM.js";
+} from "./chunk-VKFYI7AQ.js";
+import "./chunk-FAORS3UR.js";
 import "./chunk-KCF6GHJP.js";
 import "./chunk-JYVGYKXG.js";
 import "./chunk-7KDQAD2W.js";
@@ -158,8 +158,8 @@ import {
   fpsToFfmpegArg,
   fpsToNumber,
   parseFps
-} from "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+} from "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import {
@@ -690,7 +690,7 @@ async function executeRenderPlan(plan, dependencies, cancellation) {
   let batchModule;
   let preparedBatch;
   if (plan.batchPath) {
-    batchModule = await import("./batchRender-UDE7TOKY.js");
+    batchModule = await import("./batchRender-KWBVAUE3.js");
     try {
       preparedBatch = batchModule.prepareBatchRender({
         batchPath: plan.batchPath,

package/dist/{render-batch-2JQNFAL4.js → render-batch-EK4ZBQHH.js}

@@ -14,7 +14,7 @@ import {
   loadProjectVariableSchema,
   reportVariableIssues,
   validateVariablesAgainstSchema
-} from "./chunk-BOT7PGM5.js";
+} from "./chunk-T5LGOTQR.js";
 import "./chunk-FH7WODJH.js";
 import {
   errorBox
@@ -27,8 +27,8 @@ import {
 import {
   c
 } from "./chunk-ZTZA4UWZ.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/renderSetupWorker.js

@@ -43,10 +43,18 @@ var disposeSignalHandlers = installRenderSetupSignalHandlers(
   (signal) => process.kill(process.pid, signal),
   process.env.HYPERFRAMES_RENDER_DETACHED !== "1"
 );
+function lowerPriority() {
+  try {
+    setPriority(constants.priority.PRIORITY_LOW);
+  } catch (error) {
+    process.stderr.write(`Lint runs at normal priority: ${error.message}
+`);
+  }
+}
 async function runMode() {
   if (mode === "browser") return ensureBrowser(input);
   if (mode === "lint") {
-    setPriority(constants.priority.PRIORITY_LOW);
+    lowerPriority();
     return lintProject(
       input.projectDir,
       input.entryFile,

package/dist/{resolver-JZF5G6YC.js → resolver-5Y6VNMTC.js}

@@ -11,13 +11,13 @@ import {
   resolveItemWithDependencies,
   resolveItemsByTag,
   unreachableRegistryMessage
-} from "./chunk-QKJ4KGNR.js";
-import "./chunk-ID7B7NGN.js";
+} from "./chunk-44GV6ZMC.js";
+import "./chunk-2E7NDKTN.js";
 import "./chunk-AWDFDFI3.js";
 import "./chunk-P6LJ4Y32.js";
 import "./chunk-GMECXFAN.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/{sherpa-MDVSUF6Y.js → sherpa-VMADZBF7.js}

@@ -17,24 +17,24 @@ import {
   sherpaRuntimeLoadError,
   sherpaUnsupportedReason,
   transcribeWithSherpa
-} from "./chunk-5VGEWXJL.js";
+} from "./chunk-PECICVTJ.js";
 import "./chunk-BXCMXMJQ.js";
 import "./chunk-3DKN5WKL.js";
 import "./chunk-EOVYQ3IG.js";
-import "./chunk-BV2NH7ZA.js";
-import "./chunk-ATOXD5VV.js";
+import "./chunk-V2T7FFPB.js";
+import "./chunk-AWSVUIWG.js";
 import "./chunk-6BEFEWFB.js";
 import "./chunk-X3SCQP2A.js";
 import "./chunk-PO2SDVQA.js";
 import "./chunk-IK3SOMZ4.js";
 import "./chunk-XT6MXC7A.js";
-import "./chunk-CAHSX6IW.js";
-import "./chunk-KDC5D5VM.js";
+import "./chunk-VKFYI7AQ.js";
+import "./chunk-FAORS3UR.js";
 import "./chunk-KCF6GHJP.js";
 import "./chunk-JYVGYKXG.js";
 import "./chunk-7KDQAD2W.js";
-import "./chunk-SYKPCN32.js";
-import "./chunk-QE7XLLGT.js";
+import "./chunk-QZUVPWC4.js";
+import "./chunk-6M3IPJS6.js";
 import "./chunk-VC76R6W2.js";
 import "./chunk-UJKQWGFF.js";
 import "./chunk-YMS5FOMC.js";

package/dist/skills/media-use/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: media-use
-description: Agent Media OS for a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.
+description: Agent Media OS for a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm` needs the heygen CLI, while `--type sfx` needs no account (Openverse, then a bundled library). When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.
 ---
 
 **Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin. Standalone installs keep the update instructions below.
@@ -13,7 +13,7 @@ Only when `HEYGEN_API_BASE` is set in your environment (a host app set it and pa
 
 First run otherwise (no `HEYGEN_API_BASE`), when you will use HeyGen media (catalog search, TTS, avatar video): install and sign in to the `heygen` CLI (the free-usage path), then verify with `npx hyperframes media-use resolve --doctor`. Setup and providers: `references/setup-providers.md`.
 
-Music and sound effects inside a host app: when the app you run in gives you its own music or sound-effect tools, use those. Without `HEYGEN_API_BASE`, `resolve --type bgm` and `--type sfx` search the HeyGen catalog through the `heygen` CLI; without it they fail and say so (`sfx` still answers from its bundled library).
+Music and sound effects inside a host app: when the app you run in gives you its own music or sound-effect tools, use those. Without `HEYGEN_API_BASE`, `resolve --type bgm` searches the HeyGen catalog through the `heygen` CLI and fails without it, saying so. `resolve --type sfx` searches Openverse (CC0 and CC BY only, no account) and falls back to its bundled library offline; credit CC BY sounds as `audio/references/sfx.md` says.
 
 Without `HEYGEN_API_BASE`, before generating a voiceover or an avatar video, tell the person: signing in to the heygen CLI with OAuth (`heygen auth login --oauth`) gives a free allowance for TTS voiceover and avatar videos, while an API key bills API credits.
 
@@ -28,7 +28,7 @@ Returns one line: `resolved <id> → <path> (<type>, <metadata>)`. All search no
 | Type    | One-line intent                                                                  |
 | ------- | -------------------------------------------------------------------------------- |
 | `bgm`   | background music (HeyGen catalog via the `heygen` CLI, 10k+ tracks)              |
-| `sfx`   | sound effects (bundled 19-file library + catalog via the `heygen` CLI)           |
+| `sfx`   | sound effects (Openverse CC0 / CC BY, bundled 21-file library offline)           |
 | `image` | photos, backgrounds (HeyGen asset search, 75k+ vectors)                          |
 | `icon`  | icons, symbols (transparent)                                                     |
 | `logo`  | official brand marks (theSVG → GitHub avatar → favicon; never redrawn)           |

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

@@ -4,13 +4,13 @@
 
 Run `npx hyperframes auth status` to see what's configured and which engines a workflow will use (see the skill's **Preflight** section). Keys resolve in this order — **first match wins**:
 
-| Provider                             | Resolution order (first non-empty wins)                                                                                                                                    | Local deps when used                             |
-| ------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
-| **HeyGen** (TTS + BGM/SFX retrieval) | `$HEYGEN_API_KEY` → `$HYPERFRAMES_API_KEY` → `~/.heygen/credentials` (shared with heygen-cli; `$HEYGEN_CONFIG_DIR` overrides the dir; written by `hyperframes auth login`) | none (REST)                                      |
-| **ElevenLabs** (TTS fallback)        | `$ELEVENLABS_API_KEY`                                                                                                                                                      | `pip install elevenlabs`                         |
-| **Lyria** (BGM fallback)             | `$GEMINI_API_KEY` → `$GOOGLE_API_KEY`                                                                                                                                      | `pip install google-genai`                       |
-| **Kokoro** (TTS, no key)             | always — final voice fallback                                                                                                                                              | `pip install kokoro-onnx soundfile`              |
-| **MusicGen** (BGM, no key)           | always — final music fallback                                                                                                                                              | `pip install transformers torch soundfile numpy` |
+| Provider                         | Resolution order (first non-empty wins)                                                                                                                                    | Local deps when used                             |
+| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ |
+| **HeyGen** (TTS + BGM retrieval) | `$HEYGEN_API_KEY` → `$HYPERFRAMES_API_KEY` → `~/.heygen/credentials` (shared with heygen-cli; `$HEYGEN_CONFIG_DIR` overrides the dir; written by `hyperframes auth login`) | none (REST)                                      |
+| **ElevenLabs** (TTS fallback)    | `$ELEVENLABS_API_KEY`                                                                                                                                                      | `pip install elevenlabs`                         |
+| **Lyria** (BGM fallback)         | `$GEMINI_API_KEY` → `$GOOGLE_API_KEY`                                                                                                                                      | `pip install google-genai`                       |
+| **Kokoro** (TTS, no key)         | always — final voice fallback                                                                                                                                              | `pip install kokoro-onnx soundfile`              |
+| **MusicGen** (BGM, no key)       | always — final music fallback                                                                                                                                              | `pip install transformers torch soundfile numpy` |
 
 `hyperframes auth login` (browser OAuth) is the recommended setup: one sign-in, every project, no per-repo `.env`. An OAuth login is sent as `Authorization: Bearer`; an API key as `X-Api-Key`; both are tagged with `X-HeyGen-Source: cli`. OAuth CLI users can consume the web-plan free allowance for HeyGen TTS (10 min/month); API keys follow the normal API billing path. With no HeyGen credential, voice/BGM run fully locally (Kokoro / MusicGen) — `hyperframes auth status` and `hyperframes doctor` both report whether those local deps are installed.
 

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

@@ -1,35 +1,41 @@
 # Sound effects (SFX)
 
-Named sound effects, produced by the shared audio engine (`scripts/audio.mjs` → `scripts/lib/sfx.mjs`). **Provider-gated** by the engine's one switch — whether a HeyGen credential is present, decided once (not per cue):
+Named sound effects, produced by the shared audio engine (`scripts/audio.mjs` → `scripts/lib/sfx.mjs`). No account or key is needed:
 
-- **HeyGen credential present → retrieve every cue** from HeyGen's audio library (`/v3/audio/sounds`, `type=sound_effects`, `min_score=0.4`). Search-and-download, **not** generation. The bundled library is NOT consulted.
-- **No credential → the bundled 21-file library** (`assets/sfx/` + `manifest.json`): match each cue name, copy the matched file into the project. Offline, deterministic, free.
+- **Openverse first, per cue.** Each cue is searched on [Openverse](https://openverse.org)'s free audio API (most sound effects come from Freesound). Search-and-download, **not** generation.
+- **The bundled 21-file library is the fallback** (`assets/sfx/` + `manifest.json`): a cue Openverse has no usable match for, and every cue once Openverse is offline or rate limited, is matched against it and the file copied into the project.
 
-There is no `npx hyperframes sfx` command. SFX is never generated — it is retrieved (online) or taken from the bundled library (offline).
+There is no `npx hyperframes sfx` command. SFX is never generated — it is retrieved from Openverse (online) or taken from the bundled library (offline). `npx hyperframes media-use resolve --type sfx` follows the same order (`--local-only` skips Openverse).
+
+## Licences
+
+Only **CC0** and **CC BY** sounds are used: never NonCommercial, ShareAlike or NoDerivatives. Each CC BY sound is credited in the project's `assets/sfx/CREDITS.md` (title, creator, licence, source link; for `resolve`, in a `CREDITS.md` beside the sound files it saves) and its `audio_meta.sfx[]` entry carries `license` and `credit`. Tell the person to include those credits wherever the video is published.
 
 ## Cues — request → meta
 
-Each line names the effects it wants: `lines[].sfx: ["whoosh", "ui click"]`. The engine flattens these into cues, resolves them per the switch, dedupes identical `(id, name)` pairs (the same effect named twice downloads/copies once), and writes `audio_meta.sfx[]`:
+Each line names the effects it wants: `lines[].sfx: ["whoosh", "ui click"]`. The engine flattens these into cues, resolves each, dedupes identical `(id, name)` pairs (the same effect named twice downloads/copies once), and writes `audio_meta.sfx[]`:
 
 ```jsonc
 {
   "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",    // which route resolved it
+  "source": "openverse" | "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
+  "volume": 0.35,                  // SFX sit UNDER voice + BGM
+  "license": "by",                 // Openverse only: "cc0" or "by"
+  "credit": "\"Swoosh\" by Ana is licensed under CC BY 4.0. …" // Openverse only
 }
 ```
 
 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)
+## Openverse
 
-`searchSounds(name, "sound_effects", { limit: 3, minScore: 0.4 })` → top hit → `assets/sfx/<slug>.mp3`. Results are ranked by `score` (each carries a presigned `audio_url`, `duration`, `description`). The floor is **0.4** because good SFX hits score ~0.5–0.67 — below the API's default `0.7`, which would silently drop most named cues (only whoosh/swoosh-family clears 0.7). `duration_s` comes from the result (else 1.0). Name effects concretely (`glass shatter`, not `dramatic sound`); a vague query returns a poor match.
+One search per distinct effect name (20 results, `license=cc0,by`; each result's licence is checked again). The pick keeps Openverse's relevance order, prefers clips that fit a cue (15 s at most; past ~4 s ranks lower) and CC0 over CC BY when they are close. The file lands at `assets/sfx/<slug>.<ext>` and `duration_s` comes from the result. Name effects concretely (`glass shatter`, not `dramatic sound`); a vague query returns a poor match. Anonymous use allows 20 searches a minute and 200 a day: past that, the rest of the run uses the bundled library.
 
-## Bundled library (no credential)
+## Bundled library (fallback)
 
 21 curated files in `assets/sfx/`, indexed by `manifest.json` — `{ file, duration, description }` per key (e.g. `whoosh`, `pop`, `click`, `chime`, `riser`, `impact-bass-1`, `glitch-1`, `typing`, …). A cue name resolves by **manifest key, file basename, or slug**, so `whoosh`, `whoosh.mp3`, or `"ui click"` (→ slug) all match. Matched files are copied into the project's `assets/sfx/`; `duration_s` comes from the manifest, so timing is known **offline** — e.g. `riser` is 10.03s, so trigger it at `climax − 10.03s`. The manifest's `description` field carries placement hints per effect; read `assets/sfx/manifest.json` for the full set and usage.
 
@@ -37,6 +43,6 @@ A cue that matches nothing is **skipped** (recorded as an anomaly); SFX never bl
 
 - **Volume ~0.35.** SFX must sit under narration and BGM, not fight them.
 - **No match → skip, don't fail.** A missing effect logs an anomaly and moves on; never a render blocker.
-- **Retrieval (credentialed) or bundled library (offline) — never generation.** You search HeyGen by text, or match a name against the 21-file manifest.
-- **One asset per distinct name.** Reuse across lines is deduped to a single download/copy, many cues.
-- **The switch is global, not per cue.** With a credential, retrieval handles even the long tail (effects not in the 21); without one, only the 21 bundled names resolve.
+- **Retrieval (Openverse) or bundled library (offline) — never generation.**
+- **One asset per distinct name.** Reuse across lines is deduped to a single search and download, many cues.
+- **Credit CC BY sounds.** `CREDITS.md` lists them; keep it with the project.