hyperframes 0.9.12 → 0.9.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (277) hide show
  1. package/dist/{add-NLR4EVAF.js → add-JNKCTPWJ.js} +19 -18
  2. package/dist/{agentPromptGenerator-S3GWYMVC.js → agentPromptGenerator-DSF7AEVE.js} +9 -9
  3. package/dist/{animatedGifPrep-YU7IOD5D.js → animatedGifPrep-BIEUMGB3.js} +9 -9
  4. package/dist/api.js +53 -30
  5. package/dist/{asset-7NPBAXDA.js → asset-V6JAJRCF.js} +5 -5
  6. package/dist/{assetCataloger-VKJIQCYP.js → assetCataloger-SCLH2WAC.js} +10 -10
  7. package/dist/{audio-ZNVUZH44.js → audio-JX76VDCY.js} +25 -24
  8. package/dist/{auth-PTVZNLE6.js → auth-TRE4ASYT.js} +6 -6
  9. package/dist/{autoUpdate-QJPCV7FB.js → autoUpdate-D5UUCIOR.js} +4 -4
  10. package/dist/avatars-26EUVWXR.js +168 -0
  11. package/dist/{backgroundChecks-UA6LCZAG.js → backgroundChecks-RM5GWZIW.js} +5 -5
  12. package/dist/backgroundChecksWorker.js +5 -5
  13. package/dist/{batchRender-W4RXBUNE.js → batchRender-5ZEQ6U4N.js} +8 -8
  14. package/dist/{beats-IG7C72YF.js → beats-3YW7MGZY.js} +27 -19
  15. package/dist/{benchmark-YUD3XIT2.js → benchmark-MYQTWUO3.js} +15 -15
  16. package/dist/{billing-5YSYJJ2V.js → billing-2X3JNNM4.js} +100 -23
  17. package/dist/{browser-TZILXH5J.js → browser-CQSY36GL.js} +8 -8
  18. package/dist/bundleWithLocalizedFonts-Z6KCDBP2.js +23 -0
  19. package/dist/{capture-MICLAF6V.js → capture-IK5GIWOS.js} +29 -32
  20. package/dist/{capture-R77HOGLQ.js → capture-NWBNWBIX.js} +5 -5
  21. package/dist/{captureCompositionFrame-WBMFZHEF.js → captureCompositionFrame-KR3PELMO.js} +17 -17
  22. package/dist/{catalog-AMPL57XF.js → catalog-2Q73F42B.js} +20 -19
  23. package/dist/{catch-up-WQ7ZRRFT.js → catch-up-JP3FL3FX.js} +8 -8
  24. package/dist/{check-ZPBF3X5D.js → check-UIMXDUPK.js} +51 -50
  25. package/dist/{checkAudio-IG3BOW2G.js → checkAudio-CSX4G35O.js} +15 -15
  26. package/dist/{checkBrowser-AIUIKFMJ.js → checkBrowser-MTCJVJYJ.js} +43 -42
  27. package/dist/{chunk-B3IE7CN2.js → chunk-2BDSLTEG.js} +10 -10
  28. package/dist/{chunk-URJ7T6T6.js → chunk-2L4HQ5K4.js} +1 -1
  29. package/dist/{chunk-RFTLWXEX.js → chunk-2NHPNI42.js} +11 -11
  30. package/dist/{chunk-EPCVE3OX.js → chunk-2OIONPKY.js} +3 -3
  31. package/dist/{chunk-WTGG734B.js → chunk-2SYOEZ2Z.js} +5 -5
  32. package/dist/{chunk-HY64QA63.js → chunk-2YT656R2.js} +22 -10
  33. package/dist/{chunk-NTHJJ6JT.js → chunk-35RZMUTX.js} +7 -7
  34. package/dist/{chunk-LIN633KG.js → chunk-3B7TDQEW.js} +5 -5
  35. package/dist/{bundleWithLocalizedFonts-BOIW3CIU.js → chunk-3BHDAXDA.js} +5 -9
  36. package/dist/{chunk-VWQY3A64.js → chunk-3CXUZSLE.js} +2 -2
  37. package/dist/{chunk-5WHGO5XU.js → chunk-4MY6FPX4.js} +1 -1
  38. package/dist/{chunk-V6HV2IDT.js → chunk-4NE6CBMW.js} +1 -1
  39. package/dist/{chunk-JS6ZTPYC.js → chunk-53UV2EUT.js} +3 -3
  40. package/dist/{chunk-6IFY3ZQC.js → chunk-5ENBFVPD.js} +5 -5
  41. package/dist/{chunk-AW3XJY4S.js → chunk-6FDVPIOO.js} +1 -1
  42. package/dist/{chunk-VECINIPA.js → chunk-6FOO4QTU.js} +2 -2
  43. package/dist/{chunk-6R2PED3X.js → chunk-6OSVMSGV.js} +10 -10
  44. package/dist/{chunk-JKSASCBT.js → chunk-6UM5C4R6.js} +2 -2
  45. package/dist/{chunk-SFS5BTQ3.js → chunk-6YPQSVVR.js} +1 -1
  46. package/dist/{chunk-N6FGHJ7X.js → chunk-6ZRGEVAM.js} +97 -26
  47. package/dist/{chunk-2QMEP4LR.js → chunk-7AVR3VZE.js} +1 -1
  48. package/dist/{chunk-6KV3CMY2.js → chunk-7LQVFIO4.js} +4 -16
  49. package/dist/{chunk-3IKLV3D4.js → chunk-7NPHPQH5.js} +2 -2
  50. package/dist/{chunk-OJTXXFYO.js → chunk-7X3UDKJK.js} +1 -1
  51. package/dist/{chunk-XZP5OW5V.js → chunk-AKE744C5.js} +1 -1
  52. package/dist/{chunk-64ZWPFAX.js → chunk-AOJBIFKU.js} +2 -2
  53. package/dist/{chunk-OQKAP6X4.js → chunk-AWV4F5TS.js} +2 -2
  54. package/dist/{chunk-X5EOH44V.js → chunk-B2RMMRJB.js} +1 -1
  55. package/dist/{chunk-MWHTLXG4.js → chunk-B3CSMKM7.js} +1 -1
  56. package/dist/{chunk-MDMQD6BV.js → chunk-B6C33MNL.js} +41 -17
  57. package/dist/{chunk-7XKWBMBL.js → chunk-BNUN7KXZ.js} +2 -2
  58. package/dist/{chunk-H7H7XNYY.js → chunk-BXCPOMS3.js} +11 -9
  59. package/dist/{chunk-TSQZ3DSC.js → chunk-BY7PZB6H.js} +1 -1
  60. package/dist/{chunk-BONBJJ35.js → chunk-CKEOCCMK.js} +1 -1
  61. package/dist/{chunk-42TYQPES.js → chunk-CMPHS5E6.js} +2 -2
  62. package/dist/{chunk-JHILL4BN.js → chunk-CUCP7FKH.js} +461 -1
  63. package/dist/{chunk-XX77LLFJ.js → chunk-CZ5NNJ6H.js} +120 -25
  64. package/dist/{chunk-C3NC67BB.js → chunk-D3FZQL5R.js} +8 -8
  65. package/dist/chunk-D3UCUI7G.js +68 -0
  66. package/dist/{chunk-VM6T3Z6B.js → chunk-DD47NQJZ.js} +1 -1
  67. package/dist/{chunk-2VZVMCV6.js → chunk-DSIGJUNY.js} +1 -1
  68. package/dist/{chunk-E2YXF2EP.js → chunk-DTU4XJNP.js} +4 -4
  69. package/dist/{chunk-4XGASFTP.js → chunk-DTZSKJV5.js} +3 -3
  70. package/dist/{chunk-7RM3TB62.js → chunk-DVJUBMS7.js} +1 -1
  71. package/dist/{chunk-KUXOAS4Z.js → chunk-DX4OFRBN.js} +41 -37
  72. package/dist/{chunk-Y3ICFPFK.js → chunk-EAO46VPT.js} +3 -3
  73. package/dist/{chunk-M6JFR7KF.js → chunk-EOCFNE53.js} +21 -32
  74. package/dist/{chunk-LTBBFLOM.js → chunk-FC2OXEBQ.js} +1 -1
  75. package/dist/{chunk-BW2RIJKV.js → chunk-FF3VKFCN.js} +163 -98
  76. package/dist/{chunk-WQ4SMZDF.js → chunk-FQFWGAON.js} +2 -2
  77. package/dist/{chunk-J3RXEDR2.js → chunk-FYZFURBN.js} +2 -2
  78. package/dist/{chunk-ZLN3AJKT.js → chunk-FZRTCVU6.js} +1 -1
  79. package/dist/{chunk-YEBIOQRI.js → chunk-GY7D2OEQ.js} +3 -3
  80. package/dist/chunk-HNZ2FZIB.js +45 -0
  81. package/dist/{chunk-2GICKZ3I.js → chunk-HOCC4J5C.js} +1 -1
  82. package/dist/{chunk-4J4EGANW.js → chunk-HVIQQCLM.js} +16 -16
  83. package/dist/{chunk-PKLZ5PV2.js → chunk-HZSAOL5O.js} +2 -2
  84. package/dist/{chunk-3DWH6Z5U.js → chunk-I5PI43EI.js} +1 -1
  85. package/dist/{chunk-KT4KPBI7.js → chunk-IO3BC2ZK.js} +3 -3
  86. package/dist/{chunk-4H4DR36N.js → chunk-IOPE4LJ2.js} +1 -1
  87. package/dist/{chunk-QRCORKYC.js → chunk-IPZ3QGDO.js} +2 -2
  88. package/dist/{chunk-LV5SL4YW.js → chunk-K5CK4G75.js} +3 -3
  89. package/dist/{chunk-2VYAX3ZD.js → chunk-L24GJQNZ.js} +16 -12
  90. package/dist/{chunk-WJD3GVAA.js → chunk-LISUH6KH.js} +1 -1
  91. package/dist/chunk-LSUM6RTW.js +20 -0
  92. package/dist/{chunk-ZD3MK4H5.js → chunk-LZYXYJMX.js} +1 -1
  93. package/dist/{chunk-LO3EX3YP.js → chunk-M34AOUVK.js} +7 -7
  94. package/dist/{chunk-5LOZWO2M.js → chunk-M3JU24AI.js} +1 -1
  95. package/dist/{chunk-NQYW4IYN.js → chunk-MWPPZOY5.js} +4 -4
  96. package/dist/{chunk-KDOJX2HU.js → chunk-MY2W7VWC.js} +15 -15
  97. package/dist/{chunk-W5AUD5OL.js → chunk-N7ZKI2CE.js} +5 -5
  98. package/dist/{chunk-73EXHUMD.js → chunk-NBUPR3ZF.js} +1 -1
  99. package/dist/{chunk-AHLDGEH5.js → chunk-NLEIM52W.js} +84 -22
  100. package/dist/{chunk-XJG65BB2.js → chunk-NWFIYKEI.js} +10 -10
  101. package/dist/{chunk-2P5DTXUN.js → chunk-NZTYGWRK.js} +1 -1
  102. package/dist/{chunk-N74N2I2K.js → chunk-O4ONYFY3.js} +1 -1
  103. package/dist/{chunk-QFZ3ZSXI.js → chunk-O4ZD7TVR.js} +18 -2
  104. package/dist/{chunk-FLXZ4GZI.js → chunk-OHN3OJQQ.js} +1 -1
  105. package/dist/{chunk-C2KEGBR3.js → chunk-OHQRQE7F.js} +1 -394
  106. package/dist/{chunk-S2UKSI3C.js → chunk-PA27AW3Y.js} +1 -1
  107. package/dist/{chunk-X6XIY4JY.js → chunk-PCY67JUL.js} +303 -29
  108. package/dist/{chunk-SG4YBQPY.js → chunk-PYPW33ET.js} +2 -2
  109. package/dist/{chunk-Z2DJSEQC.js → chunk-QSEHVJFA.js} +75 -219
  110. package/dist/{chunk-CPMTEWQM.js → chunk-RX2PFZ5W.js} +4 -4
  111. package/dist/{chunk-OAFGA2FR.js → chunk-SAAJ2O7A.js} +1 -1
  112. package/dist/{chunk-GAKRZZHQ.js → chunk-SQC4CTD2.js} +2 -2
  113. package/dist/{chunk-6NKEEHFR.js → chunk-SSBAETRX.js} +6 -6
  114. package/dist/{chunk-AUYRWWFL.js → chunk-T32JKZX3.js} +3 -3
  115. package/dist/{chunk-A33GFLPY.js → chunk-T4FLVFQE.js} +1 -1
  116. package/dist/{chunk-P7Y2YCOF.js → chunk-TESXTEV5.js} +1 -1
  117. package/dist/{chunk-Q3IT7I2K.js → chunk-TRK77R5G.js} +1 -1
  118. package/dist/{chunk-EBUA6NWH.js → chunk-TTBCQFRY.js} +2 -2
  119. package/dist/{chunk-LR5NVYZT.js → chunk-U22NZEQV.js} +2 -2
  120. package/dist/{chunk-WWBEAKTO.js → chunk-UXS7VE75.js} +1 -1
  121. package/dist/{chunk-R7EKEIAK.js → chunk-VD5G4Y6U.js} +1 -1
  122. package/dist/{chunk-ABI256T5.js → chunk-W7ITBVJE.js} +4 -4
  123. package/dist/{chunk-FC4WF2VQ.js → chunk-WAH2X7FF.js} +2 -2
  124. package/dist/{chunk-FPR57WRR.js → chunk-WEWXIQPN.js} +1 -1
  125. package/dist/{chunk-SSZTRWKQ.js → chunk-WXYV47JX.js} +4 -4
  126. package/dist/{chunk-NWQFOHXF.js → chunk-WYXBJVM2.js} +1 -1
  127. package/dist/{chunk-FFUBISTD.js → chunk-X46MRJYK.js} +1 -1
  128. package/dist/{chunk-UH62KSYV.js → chunk-XMOWL46H.js} +3 -3
  129. package/dist/{chunk-VUMGJLRB.js → chunk-YBR4L5JA.js} +1 -1
  130. package/dist/{chunk-7FMUTGOH.js → chunk-ZB2XGJSP.js} +152 -5
  131. package/dist/{chunk-QOF7XZEI.js → chunk-ZE2QZHUH.js} +2 -2
  132. package/dist/{chunk-ETYQYG6Q.js → chunk-ZFZXGZTX.js} +27 -18
  133. package/dist/{chunk-AVNF52HR.js → chunk-ZNHWAGMH.js} +1 -1
  134. package/dist/{chunk-Q225NLQL.js → chunk-ZSAKJRZB.js} +6 -6
  135. package/dist/{chunk-7W5ZDOLW.js → chunk-ZZBO3GF5.js} +15 -4
  136. package/dist/{clean-343XOJT3.js → clean-P3SZCIFU.js} +25 -25
  137. package/dist/cli.js +69 -68
  138. package/dist/{cloud-2YS272KD.js → cloud-G7YQIVI7.js} +6 -6
  139. package/dist/{cloud-B6SGMECY.js → cloud-RFM3PYTR.js} +6 -5
  140. package/dist/{cloudrun-N737TJRC.js → cloudrun-LXZT5UDK.js} +11 -11
  141. package/dist/{colors-HRL7QSVG.js → colors-CRTWLZ5S.js} +2 -2
  142. package/dist/{compare-KXCTMXFX.js → compare-BHQHEOMX.js} +39 -38
  143. package/dist/{compiler-KKIYPREA.js → compiler-V72QWKGC.js} +6 -6
  144. package/dist/{component-ZUDCIGGD.js → component-6GDCT3GK.js} +6 -6
  145. package/dist/{compositions-FNFI2QOA.js → compositions-JM6HKCRF.js} +19 -19
  146. package/dist/{curve-5BMBBCSZ.js → curve-Y7JRXLIJ.js} +16 -16
  147. package/dist/{cuts-OKUA6BWH.js → cuts-LDVDQTRL.js} +17 -17
  148. package/dist/{delete-FYMFNSED.js → delete-NCZIKWHU.js} +12 -11
  149. package/dist/{deploy-YZU2YITA.js → deploy-R4OEJEB6.js} +10 -7
  150. package/dist/{describeProject-E44RWBJL.js → describeProject-4GKZTYHA.js} +13 -13
  151. package/dist/{destroy-IQLGADZM.js → destroy-6XY4WQWY.js} +2 -2
  152. package/dist/{deterministicFonts-GQMT52JQ.js → deterministicFonts-HY5GWGQQ.js} +3 -3
  153. package/dist/{diff-5X6I6EG5.js → diff-C53GPSNU.js} +55 -36
  154. package/dist/{dist-GUX66F7V.js → dist-R7SPMKEZ.js} +4 -4
  155. package/dist/{dist-PCVNVAVC.js → dist-TI44VPHO.js} +6 -4
  156. package/dist/{dist-PUHEYGA5.js → dist-TJZSSDR2.js} +14 -14
  157. package/dist/{docs-D22SOQEZ.js → docs-WYJSJGSF.js} +2 -2
  158. package/dist/{doctor-3DXWW63F.js → doctor-V4RICWU2.js} +16 -16
  159. package/dist/{energy-4HY7COXH.js → energy-S5Z7CGSB.js} +17 -17
  160. package/dist/{events-JAGPGK7R.js → events-6HROTYLC.js} +14 -6
  161. package/dist/{events-TFVE7AUR.js → events-QKJE5XRN.js} +5 -5
  162. package/dist/{events-ULVZ7V2C.js → events-RAJGQK7Y.js} +19 -19
  163. package/dist/{extract-5KTFRIH2.js → extract-RYGWEC5V.js} +17 -17
  164. package/dist/{face-T6D34LR7.js → face-IWRDW2QO.js} +17 -17
  165. package/dist/{feedback-QQQYENCU.js → feedback-HQTDLLPE.js} +17 -16
  166. package/dist/{ffmpeg-A2O4HSRD.js → ffmpeg-BX334YEK.js} +9 -9
  167. package/dist/{figma-4RODZMCT.js → figma-P6U76KGI.js} +5 -5
  168. package/dist/fontLocalizeCli.js +14 -14
  169. package/dist/{frames-L43TSSAY.js → frames-G2WYTVWV.js} +18 -18
  170. package/dist/{generate-7HZKBLPZ.js → generate-ZUE2AVOB.js} +42 -22
  171. package/dist/{get-MXKV4NUL.js → get-7C3UC46A.js} +12 -11
  172. package/dist/{gpuPolicy-TKHFDEH2.js → gpuPolicy-5ZVYYWXN.js} +9 -9
  173. package/dist/{grade-compare-KNXFKMFI.js → grade-compare-IS3OVI7R.js} +43 -42
  174. package/dist/{heifImagePrep-L2EY67F2.js → heifImagePrep-FBLLKI3P.js} +10 -10
  175. package/dist/{help-YN43ORVX.js → help-2MPB27YU.js} +3 -3
  176. package/dist/{history-VAMN53LT.js → history-Q5EBBFPW.js} +10 -10
  177. package/dist/hyperframe.manifest.json +1 -1
  178. package/dist/hyperframe.runtime.iife.js +7 -7
  179. package/dist/hyperframes-player.global.js +1 -1
  180. package/dist/{info-QKEEGK2R.js → info-TNG5QGFC.js} +13 -13
  181. package/dist/{init-AAA44PYH.js → init-UFPBBWC7.js} +46 -38
  182. package/dist/{ink-V6CEFYB6.js → ink-UTPJHGZR.js} +17 -17
  183. package/dist/{inspect-5JGTWCYO.js → inspect-KXKKPWKX.js} +41 -40
  184. package/dist/{installer-PUQYKLXZ.js → installer-UTFXM6KP.js} +7 -6
  185. package/dist/{keyframes-FJNUSXAF.js → keyframes-S6V36BW6.js} +10 -10
  186. package/dist/{lambda-RYCG67CX.js → lambda-XWHALRKM.js} +22 -22
  187. package/dist/{layout-DXIPVY3W.js → layout-SSVKZKCZ.js} +41 -40
  188. package/dist/{lint-JZADWIMR.js → lint-OQWGRKG5.js} +15 -15
  189. package/dist/{lintProject-EV3EEBY3.js → lintProject-Z2TEXMY4.js} +4 -4
  190. package/dist/{list-YRLUJMP6.js → list-FYLBMEL7.js} +13 -12
  191. package/dist/{localPage-KIFKMB2B.js → localPage-4GSU6N3J.js} +9 -9
  192. package/dist/{login-H74JDEJ2.js → login-JKFCYHRS.js} +10 -9
  193. package/dist/{logout-UMDA3HDE.js → logout-YACQMRZN.js} +5 -4
  194. package/dist/{look-WVGBBYFE.js → look-WQ2DOKXH.js} +17 -17
  195. package/dist/{manager-T633Z2L4.js → manager-F4F4A734.js} +10 -10
  196. package/dist/{measure-DWQHHY3H.js → measure-XIFLTAMC.js} +11 -11
  197. package/dist/{media-treatment-JHDDWRFU.js → media-treatment-S3LHQSQQ.js} +21 -21
  198. package/dist/{media-use-5SDC3MCE.js → media-use-NFM3ZXCF.js} +7 -5
  199. package/dist/{models-6SOW23N6.js → models-G4KNLV66.js} +17 -17
  200. package/dist/{motionShot-B4K6LEU3.js → motionShot-IJGA5CBH.js} +20 -20
  201. package/dist/{normalize-audio-O6STMACD.js → normalize-audio-UP54N6J4.js} +15 -15
  202. package/dist/{open-VRCTXBD3.js → open-TAEKCYDB.js} +19 -18
  203. package/dist/{parakeetRunner-MNOIBRZZ.js → parakeetRunner-WFA4K7BH.js} +14 -14
  204. package/dist/{pipeline-N3M6VXBC.js → pipeline-SNENB5MZ.js} +12 -12
  205. package/dist/{play-5WUZGJ4B.js → play-QTYMY453.js} +32 -31
  206. package/dist/{policies-EERREOZJ.js → policies-EV7XPSQC.js} +2 -2
  207. package/dist/{preflight-XZZXHV42.js → preflight-CZUKW3CW.js} +10 -10
  208. package/dist/{present-W7OODR7J.js → present-KVHQECWG.js} +25 -25
  209. package/dist/{preview-NOQSYZAD.js → preview-6U62DM4P.js} +30 -29
  210. package/dist/{probe-WFIYEXM5.js → probe-UCVL3JDC.js} +17 -17
  211. package/dist/{producer-HI6M6755.js → producer-A4RPG3XL.js} +1 -1
  212. package/dist/{progress-STSH2JRY.js → progress-FWJJMPIQ.js} +2 -2
  213. package/dist/{projectConfig-PUAOWUNS.js → projectConfig-FIW6FPZW.js} +10 -9
  214. package/dist/{prompts-ZEVFT7US.js → prompts-27EPTM64.js} +2 -2
  215. package/dist/{publication-K4XAMUI6.js → publication-CCIGDK2X.js} +4 -4
  216. package/dist/{publish-7W46NJFT.js → publish-VKSABRA4.js} +26 -22
  217. package/dist/{refresh-4FQFQ2SW.js → refresh-L5C2HPMC.js} +5 -4
  218. package/dist/{remove-background-SYHNGASQ.js → remove-background-CJJ54SHA.js} +16 -16
  219. package/dist/{render-GYQZQB2O.js → render-2YY64XPU.js} +354 -71
  220. package/dist/{render-74JIGKTN.js → render-G54RA46B.js} +307 -76
  221. package/dist/{render-EF7Y6YYC.js → render-I2MWX5GH.js} +10 -10
  222. package/dist/{render-batch-JYYP4RXA.js → render-batch-X562GNRH.js} +13 -13
  223. package/dist/renderSetupWorker.js +4 -4
  224. package/dist/{resolver-BKFLETMU.js → resolver-GC4ZLQPV.js} +7 -6
  225. package/dist/{reverse-NEC42AID.js → reverse-2KZQ65Y7.js} +1 -1
  226. package/dist/{run-Z6AW753F.js → run-65M6ECM2.js} +6 -5
  227. package/dist/{sherpa-2ROE6TLC.js → sherpa-SLRKS4SR.js} +13 -13
  228. package/dist/{sites-EAGXQOKI.js → sites-O7A7G3ZQ.js} +2 -2
  229. package/dist/skills/hyperframes/SKILL.md +3 -1
  230. package/dist/skills/hyperframes/references/format.md +1 -1
  231. package/dist/skills/hyperframes-cli/SKILL.md +2 -0
  232. package/dist/skills/hyperframes-cli/references/cloud.md +10 -10
  233. package/dist/skills/hyperframes-cli/references/lint-validate-inspect.md +1 -1
  234. package/dist/skills/media-use/SKILL.md +2 -0
  235. package/dist/skills/media-use/audio/scripts/lib/heygen.mjs +2 -2
  236. package/dist/skills/media-use/audio/scripts/lib/heygen.test.mjs +2 -2
  237. package/dist/skills/media-use/references/resolve.md +2 -0
  238. package/dist/skills/media-use/scripts/lib/bundled-sfx-provider.mjs +1 -1
  239. package/dist/skills/media-use/scripts/lib/heygen-search.mjs +4 -2
  240. package/dist/skills/media-use/scripts/lib/match.mjs +17 -0
  241. package/dist/skills/media-use/scripts/lib/sfx-provider.mjs +20 -2
  242. package/dist/skills/media-use/scripts/resolve.mjs +52 -9
  243. package/dist/{skills-R56MSU2Y.js → skills-SOXKW42T.js} +10 -10
  244. package/dist/{skillsUpdateCheck-I6G3MQWO.js → skillsUpdateCheck-4RUEBT6B.js} +5 -5
  245. package/dist/{snapshot-J2NU7WTJ.js → snapshot-KIWJWZGW.js} +53 -52
  246. package/dist/{src-5XQ6A3VE.js → src-ABVBEVVK.js} +13 -13
  247. package/dist/{src-L7UBHHKB.js → src-DYWF24IK.js} +8 -8
  248. package/dist/{start-VUMSNLKC.js → start-EADJCDST.js} +55 -32
  249. package/dist/{staticProjectServer-2JYB7RLI.js → staticProjectServer-UCHJYCR6.js} +25 -24
  250. package/dist/{status-SUK4I7TS.js → status-E4OUQSHN.js} +68 -9
  251. package/dist/studio/assets/{hyperframes-player-Dw-0BWQW.js → hyperframes-player-CfYFgHV8.js} +1 -1
  252. package/dist/studio/assets/{index-BNZeN67E.js → index-COfhX0Gz.js} +4 -4
  253. package/dist/studio/assets/{index-NwWb1W86.js → index-Cj5x3rVD.js} +1 -1
  254. package/dist/studio/index.html +1 -1
  255. package/dist/{studio-api-MEZKFJBY.js → studio-api-RGOTUJXP.js} +14 -14
  256. package/dist/{studioServer-XGR4YPXX.js → studioServer-72COILB5.js} +76 -69
  257. package/dist/{sync-ZIMGTQEN.js → sync-5Z5OQFB3.js} +17 -17
  258. package/dist/{telemetry-WGNNQUSF.js → telemetry-5WZGQCKA.js} +3 -3
  259. package/dist/{telemetry-PT5KSL5T.js → telemetry-OQ2JM37Y.js} +6 -6
  260. package/dist/templates/_shared/AGENTS.md +7 -6
  261. package/dist/templates/_shared/CLAUDE.md +7 -6
  262. package/dist/{templates-7AT45DZI.js → templates-YH5CUHHN.js} +146 -27
  263. package/dist/{timeline-IH422KGC.js → timeline-IWU2T2BX.js} +27 -27
  264. package/dist/{tokens-ZVJMHDTM.js → tokens-F7IBDWGE.js} +5 -5
  265. package/dist/{transcribe-QIZGXMR5.js → transcribe-GL3J3JB3.js} +12 -12
  266. package/dist/{transcribe-FRRXA77O.js → transcribe-YXDOCF32.js} +40 -27
  267. package/dist/{tts-IMW74GBX.js → tts-QRQEYR3Q.js} +4 -4
  268. package/dist/{update-E2RIAV5T.js → update-MR5NL567.js} +15 -13
  269. package/dist/{updateCheck-EII7XDIR.js → updateCheck-ONT2ZVAF.js} +4 -4
  270. package/dist/{upgrade-BKGP2TM7.js → upgrade-BJEGLKQS.js} +7 -7
  271. package/dist/{urlDownloader-FOXK4FYP.js → urlDownloader-3PV5WURP.js} +8 -8
  272. package/dist/{validate-M4FZVBRP.js → validate-GTTWJYCS.js} +31 -31
  273. package/dist/{video-AVEGMBDM.js → video-VP6X6YL5.js} +12 -12
  274. package/dist/{voices-E5RUGLJK.js → voices-3EO2NQ5Q.js} +40 -20
  275. package/dist/warmCheck.js +51 -50
  276. package/package.json +1 -1
  277. package/dist/chunk-P3KBDUNS.js +0 -29
@@ -25,12 +25,12 @@ import "./chunk-K4MJX7SR.js";
25
25
  import "./chunk-WE42NVH7.js";
26
26
  import {
27
27
  lintProject
28
- } from "./chunk-XX77LLFJ.js";
29
- import "./chunk-CZGHFATT.js";
28
+ } from "./chunk-CZ5NNJ6H.js";
30
29
  import "./chunk-WVRAFHJU.js";
30
+ import "./chunk-CZGHFATT.js";
31
31
  import "./chunk-HYRPH6LL.js";
32
- import "./chunk-C2KEGBR3.js";
33
- import "./chunk-JHILL4BN.js";
32
+ import "./chunk-OHQRQE7F.js";
33
+ import "./chunk-CUCP7FKH.js";
34
34
  import "./chunk-FR7YBU3H.js";
35
35
  import "./chunk-DPVXBVLL.js";
36
36
  import "./chunk-GWTIFRF5.js";
@@ -11,24 +11,25 @@ import {
11
11
  resolveItemWithDependencies,
12
12
  resolveItemsByTag,
13
13
  unreachableRegistryMessage
14
- } from "./chunk-R7EKEIAK.js";
14
+ } from "./chunk-VD5G4Y6U.js";
15
15
  import "./chunk-JHOCK3DG.js";
16
- import "./chunk-6KV3CMY2.js";
16
+ import "./chunk-7LQVFIO4.js";
17
17
  import "./chunk-AWDFDFI3.js";
18
18
  import "./chunk-P6LJ4Y32.js";
19
+ import "./chunk-D3UCUI7G.js";
19
20
  import "./chunk-T2WJO4XM.js";
20
21
  import "./chunk-TABWG4IT.js";
21
22
  import "./chunk-YWRUQ7XZ.js";
22
- import "./chunk-W5AUD5OL.js";
23
+ import "./chunk-N7ZKI2CE.js";
23
24
  import "./chunk-MEJH7VEA.js";
24
- import "./chunk-Y3ICFPFK.js";
25
+ import "./chunk-EAO46VPT.js";
25
26
  import "./chunk-VC76R6W2.js";
26
27
  import "./chunk-OFQWTKPW.js";
27
28
  import "./chunk-RQVDTPGD.js";
28
29
  import "./chunk-TK7THLRO.js";
29
30
  import "./chunk-FXMKHHPO.js";
30
- import "./chunk-C2KEGBR3.js";
31
- import "./chunk-JHILL4BN.js";
31
+ import "./chunk-OHQRQE7F.js";
32
+ import "./chunk-CUCP7FKH.js";
32
33
  import "./chunk-FR7YBU3H.js";
33
34
  import "./chunk-DPVXBVLL.js";
34
35
  import "./chunk-GWTIFRF5.js";
@@ -23,7 +23,7 @@ var reverse_default = defineCommand({
23
23
  description: "Open a reverse-any-video run (start)"
24
24
  },
25
25
  subCommands: {
26
- start: () => import("./start-VUMSNLKC.js").then((m) => m.default)
26
+ start: () => import("./start-EADJCDST.js").then((m) => m.default)
27
27
  }
28
28
  });
29
29
  export {
@@ -7,20 +7,21 @@ var __dirname = __hf_dirname(__filename);
7
7
  import {
8
8
  analyzeTargets,
9
9
  previewTarget
10
- } from "./chunk-OQKAP6X4.js";
10
+ } from "./chunk-AWV4F5TS.js";
11
11
  import "./chunk-HBAUU3IK.js";
12
12
  import "./chunk-TNTQ7H24.js";
13
- import "./chunk-TSQZ3DSC.js";
14
- import "./chunk-ETYQYG6Q.js";
13
+ import "./chunk-BY7PZB6H.js";
14
+ import "./chunk-ZFZXGZTX.js";
15
15
  import "./chunk-3XJM7XZN.js";
16
16
  import "./chunk-SWC3QIEH.js";
17
+ import "./chunk-D3UCUI7G.js";
17
18
  import "./chunk-BVAPHHMQ.js";
18
- import "./chunk-2GICKZ3I.js";
19
+ import "./chunk-HOCC4J5C.js";
19
20
  import "./chunk-D3MUHMFG.js";
20
21
  import "./chunk-HYRPH6LL.js";
21
22
  import "./chunk-766MOTIZ.js";
22
23
  import "./chunk-66W5IWLO.js";
23
- import "./chunk-J3RXEDR2.js";
24
+ import "./chunk-FYZFURBN.js";
24
25
  import "./chunk-E63BDV4Z.js";
25
26
  import "./chunk-G7VEYUZ2.js";
26
27
  import "./chunk-XT6MXC7A.js";
@@ -17,32 +17,32 @@ import {
17
17
  sherpaRuntimeLoadError,
18
18
  sherpaUnsupportedReason,
19
19
  transcribeWithSherpa
20
- } from "./chunk-3IKLV3D4.js";
20
+ } from "./chunk-7NPHPQH5.js";
21
21
  import "./chunk-Z4GE5BXC.js";
22
22
  import "./chunk-3S27CPV7.js";
23
23
  import "./chunk-5UT3R43E.js";
24
24
  import "./chunk-6BEFEWFB.js";
25
- import "./chunk-AUYRWWFL.js";
25
+ import "./chunk-T32JKZX3.js";
26
26
  import "./chunk-SWC3QIEH.js";
27
- import "./chunk-VM6T3Z6B.js";
28
- import "./chunk-ZLN3AJKT.js";
27
+ import "./chunk-DD47NQJZ.js";
28
+ import "./chunk-FZRTCVU6.js";
29
29
  import "./chunk-RZ6CXJ56.js";
30
30
  import "./chunk-R4EWRIDL.js";
31
- import "./chunk-AVNF52HR.js";
31
+ import "./chunk-ZNHWAGMH.js";
32
32
  import "./chunk-JZIEZCQM.js";
33
33
  import "./chunk-UOFAE5RF.js";
34
34
  import "./chunk-IR35BCLK.js";
35
35
  import "./chunk-HU2SPFNG.js";
36
36
  import "./chunk-A4ZTSQLW.js";
37
- import "./chunk-N6FGHJ7X.js";
37
+ import "./chunk-6ZRGEVAM.js";
38
38
  import "./chunk-Z5J67X44.js";
39
39
  import "./chunk-5S7W3TUO.js";
40
40
  import "./chunk-D3MUHMFG.js";
41
- import "./chunk-JS6ZTPYC.js";
41
+ import "./chunk-53UV2EUT.js";
42
42
  import "./chunk-YWRUQ7XZ.js";
43
- import "./chunk-W5AUD5OL.js";
43
+ import "./chunk-N7ZKI2CE.js";
44
44
  import "./chunk-MEJH7VEA.js";
45
- import "./chunk-Y3ICFPFK.js";
45
+ import "./chunk-EAO46VPT.js";
46
46
  import "./chunk-VC76R6W2.js";
47
47
  import "./chunk-OFQWTKPW.js";
48
48
  import "./chunk-RQVDTPGD.js";
@@ -54,12 +54,12 @@ import "./chunk-X6JUUQCM.js";
54
54
  import "./chunk-KGPLIH7B.js";
55
55
  import "./chunk-K4MJX7SR.js";
56
56
  import "./chunk-WE42NVH7.js";
57
- import "./chunk-XX77LLFJ.js";
58
- import "./chunk-CZGHFATT.js";
57
+ import "./chunk-CZ5NNJ6H.js";
59
58
  import "./chunk-WVRAFHJU.js";
59
+ import "./chunk-CZGHFATT.js";
60
60
  import "./chunk-HYRPH6LL.js";
61
- import "./chunk-C2KEGBR3.js";
62
- import "./chunk-JHILL4BN.js";
61
+ import "./chunk-OHQRQE7F.js";
62
+ import "./chunk-CUCP7FKH.js";
63
63
  import "./chunk-FR7YBU3H.js";
64
64
  import "./chunk-DPVXBVLL.js";
65
65
  import "./chunk-GWTIFRF5.js";
@@ -10,9 +10,9 @@ import {
10
10
  } from "./chunk-JHOPRAJN.js";
11
11
  import {
12
12
  c
13
- } from "./chunk-2GICKZ3I.js";
13
+ } from "./chunk-HOCC4J5C.js";
14
14
  import "./chunk-66W5IWLO.js";
15
- import "./chunk-J3RXEDR2.js";
15
+ import "./chunk-FYZFURBN.js";
16
16
  import "./chunk-G7VEYUZ2.js";
17
17
  import "./chunk-XT6MXC7A.js";
18
18
  import "./chunk-7KDQAD2W.js";
@@ -5,11 +5,13 @@ description: Read first to make, edit, animate or render any video with HyperFra
5
5
 
6
6
  **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](references/plugin-installation.md).
7
7
 
8
+ **Usage beacon:** run `npx hyperframes events --skill=hyperframes` once as this skill starts. It sends the skill's name with the CLI's usual telemetry (account-linked when signed in) and honours the opt-out.
9
+
8
10
  # HyperFrames
9
11
 
10
12
  HyperFrames renders HTML to video by seeking a paused timeline frame by frame, so every render is identical; the person edits the same files in the Studio preview. Use it unless another framework or a plain browser recording is asked for. Run the CLI as `npx hyperframes <command>` (`/hyperframes-cli`); at the start of a new video, `npx hyperframes usage --json` reports the person's remaining plan usage (say "unknown" when it is).
11
13
 
12
- `index.html` is the root composition: it declares the video's variables and mounts one scene per sub-composition from `compositions/`. Media and fonts live in `assets/`. A new project: `npx hyperframes init <dir> --skip-skills`. A website as the subject: `npx hyperframes capture <url> --json`.
14
+ `index.html` is the root composition: it declares the video's variables and mounts one scene per sub-composition from `compositions/`. Media and fonts live in `assets/`. A new project: `npx hyperframes init <dir> --skip-skills --skill=hyperframes`. A website as the subject: `npx hyperframes capture <url> --json`.
13
15
 
14
16
  Build what was asked: no voiceover or captions and no new aspect ratio unless the request or the source calls for them; a film over ~15 s that tells something gets music and sound on its visible actions unless the person asked for silence (`references/sound.md`). A new video is 1920×1080 at 30 fps. A question, a hold or a loose idea gets an answer or a proposal, not an edit. Before hand-writing a named effect, transition, caption style, chart or card, search the registry (`/hyperframes-registry`). Any media (a presenter or avatar, footage, voice, music): `/media-use`, which says when HeyGen is needed and what is free. Show real things from their source (the product's screens, the brand's logo, a real place's imagery); draw only what has none.
15
17
 
@@ -95,7 +95,7 @@ The detail behind the contract in `SKILL.md`. Full references: `npx hyperframes
95
95
 
96
96
  - Bundled, so they resolve by name: Inter, Montserrat, Outfit, Nunito, Oswald, League Gothic, Archivo Black, Space Mono, IBM Plex Mono, JetBrains Mono, EB Garamond, Playfair Display, Source Code Pro, Noto Sans JP, Roboto, Open Sans, Lato, Poppins. Common system fonts (Helvetica, Arial, Times, Menlo and the like) are swapped for the nearest of these.
97
97
  - The bundle only has Latin text at a few weights per family (Inter: 400, 700, 900). The compiler still fetches each of these families from Google Fonts for the other weights and scripts, and caches the result in `~/.cache/hyperframes/fonts`.
98
- - Any other family needs `@font-face` in the file that uses it, or lint fails `font_family_without_font_face`: `src: url('assets/fonts/x.woff2')` for a file in the project (a capture's own fonts, or one you download there), or `local('Exact Name')` for a font installed on this machine.
98
+ - Any other family needs `@font-face` in the file that uses it, or lint fails `font_family_without_font_face`: `src: url('assets/fonts/x.woff2')` for a file in the project (a capture's own fonts, or one you download there), A `local('Exact Name')`-only face draws the font installed on this machine; a cloud render has no copy of it (lint warns `font_face_local_only`), so ship the file instead when the video may render in the cloud.
99
99
 
100
100
  ## Timing and the timeline
101
101
 
@@ -5,6 +5,8 @@ description: The HyperFrames CLI by job - scaffold, check, look at frames, edit
5
5
 
6
6
  **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
7
7
 
8
+ **Usage beacon:** run `npx hyperframes events --skill=hyperframes-cli` once as this skill starts. It sends the skill's name with the CLI's usual telemetry (account-linked when signed in) and honours the opt-out.
9
+
8
10
  # HyperFrames CLI
9
11
 
10
12
  Run `npx hyperframes <command>` unless the project gives a wrapper; then use the wrapper. It needs Node.js 22+ and FFmpeg. Every command has `--help`; most take `--json`, and a failure prints `✗ …`, a `Fix:` line and exits non-zero.
@@ -82,16 +82,16 @@ Rules support comments, globs, and negation. A later rule can override a default
82
82
 
83
83
  ## Render options
84
84
 
85
- | Flag | Default | Meaning |
86
- | ---------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
87
- | `--fps` | `30` | Frames per second, 1–240. |
88
- | `--quality` | `standard` | `draft`, `standard`, or `high`. |
89
- | `--format` | `mp4` | `mp4`, `webm`, or `mov` (webm/mov carry alpha). |
90
- | `--resolution` | `1080p` | `1080p` or `4k` (4k billed at 1.5×). |
91
- | `--aspect-ratio` | auto | `16:9`, `9:16`, or `1:1`. Auto from a local project's `data-width`/`data-height`; defaults to `16:9` for `--asset-id`/`--url`. |
92
- | `--composition` / `-c` | `index.html` | Entry HTML file inside the zip. |
93
- | `--output` / `-o` | `renders/<render_id>.<ext>` | Local download destination. |
94
- | `--dry-run` | off | Build and inspect a local project zip without authenticating, uploading, or rendering. |
85
+ | Flag | Default | Meaning |
86
+ | ---------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
87
+ | `--fps` | `30` | Frames per second, 1–240. |
88
+ | `--quality` | `standard` | `draft`, `standard`, or `high`. |
89
+ | `--format` | `mp4` | `mp4`, `webm`, or `mov` (webm/mov carry alpha). |
90
+ | `--resolution` | `1080p` | `1080p` or `4k` (4k billed at 1.5×). |
91
+ | `--aspect-ratio` | auto | Any `W:H`, auto from a local project's `data-width`/`data-height`. At `1080p` the output keeps the composition's size at any ratio (2:1 stays 2:1); `4k` takes only `16:9`, `9:16`, `1:1`. |
92
+ | `--composition` / `-c` | `index.html` | Entry HTML file inside the zip. |
93
+ | `--output` / `-o` | `renders/<render_id>.<ext>` | Local download destination. |
94
+ | `--dry-run` | off | Build and inspect a local project zip without authenticating, uploading, or rendering. |
95
95
 
96
96
  ```bash
97
97
  npx hyperframes cloud render . \
@@ -41,7 +41,7 @@ npx hyperframes check --no-contrast # skip the WCAG audit while iterating
41
41
  npx hyperframes check --strict # exit non-zero on warnings too (default: only errors)
42
42
  ```
43
43
 
44
- One command, one Chrome boot. `check` runs the linter first and skips the browser entirely when lint reports errors. When the browser never ran (lint errors, a linter crash, or a browser launch failure), `browserSkipped` is `true` and the `layout`, `motion` and `contrast` sections are empty, not clean. Otherwise it loads the bundled composition once, wires runtime listeners before navigation, and sweeps one seek grid running every audit per sample:
44
+ One command, one Chrome boot. `check` runs the linter first. A lint error fails the check, but the browser audits still run and report alongside it, unless the error leaves no composition to load (a root with no `data-composition-id`). When the browser never ran (no composition to load, a linter crash, or a browser launch failure), `browserSkipped` is `true` and the `layout`, `motion` and `contrast` sections are empty, not clean. Otherwise it loads the bundled composition once, wires runtime listeners before navigation, and sweeps one seek grid running every audit per sample:
45
45
 
46
46
  - **Runtime**: JavaScript console errors, unhandled exceptions, failed network requests (media-file `ERR_ABORTED` filtered out), HTTP 4xx/5xx.
47
47
  - **Layout**: text extending outside its container or the canvas, text clipped by its own box, held text overlaps and occlusion (with an approximate covered fraction), an opaque element covering the canvas above every other clip for most of the film (`canvas_covered`, naming it), children escaping clipping containers. Text under a transparent `<video>` (a `remove-background` cutout) is measured per word against the frame's alpha: partial cover is info with the share hidden, a word 80% hidden or two neighbouring words each half hidden is an error, and a frame that cannot be read falls back to opaque with a `video_alpha_unread` note.
@@ -5,6 +5,8 @@ description: Get or make any media for a HyperFrames video - music, sound effect
5
5
 
6
6
  **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
7
7
 
8
+ **Usage beacon:** run `npx hyperframes events --skill=media-use` once as this skill starts. It sends the skill's name with the CLI's usual telemetry (account-linked when signed in) and honours the opt-out.
9
+
8
10
  # Media in HyperFrames
9
11
 
10
12
  Media lands as a local file in the project's `assets/` with a ledger record; renders never fetch. One verb finds or makes it:
@@ -228,9 +228,9 @@ function errorCode(body) {
228
228
  export function billingRefusal(e) {
229
229
  const code = e?.body ? errorCode(e.body) : null;
230
230
  if (code === "hf_subscription_required")
231
- return "This needs a HyperFrames plan. Run `npx hyperframes billing subscribe`: it opens the page and waits.";
231
+ return "This needs a HyperFrames plan. Run `npx hyperframes billing subscribe --skill media-use`: it opens the page and waits.";
232
232
  if (code === "hf_usage_exhausted")
233
- return "Out of HyperFrames credits. Run `npx hyperframes billing add-credits`: it opens the page and waits.";
233
+ return "Out of HyperFrames credits. Run `npx hyperframes billing add-credits --skill media-use`: it opens the page and waits.";
234
234
  if (code === "api_key_required")
235
235
  return "This HeyGen feature isn't available with this sign-in yet. Nothing was charged. Use a HeyGen API key, or wait for HyperFrames billing in the CLI.";
236
236
  return null;
@@ -392,11 +392,11 @@ test("a refused HyperFrames-plan call becomes one line with the billing command"
392
392
  });
393
393
  assert.equal(
394
394
  heygenMessage(refused("hf_subscription_required")),
395
- "This needs a HyperFrames plan. Run `npx hyperframes billing subscribe`: it opens the page and waits.",
395
+ "This needs a HyperFrames plan. Run `npx hyperframes billing subscribe --skill media-use`: it opens the page and waits.",
396
396
  );
397
397
  assert.equal(
398
398
  heygenMessage(refused("hf_usage_exhausted")),
399
- "Out of HyperFrames credits. Run `npx hyperframes billing add-credits`: it opens the page and waits.",
399
+ "Out of HyperFrames credits. Run `npx hyperframes billing add-credits --skill media-use`: it opens the page and waits.",
400
400
  );
401
401
  assert.match(
402
402
  heygenMessage({ status: 403, body: JSON.stringify({ error: { code: "api_key_required" } }) }),
@@ -6,6 +6,8 @@ npx hyperframes media-use resolve --type <type> --intent "<description>" --proje
6
6
 
7
7
  Returns one line: `resolved <id> → <path> (<type>, <metadata>)`
8
8
 
9
+ A weak match is still returned, with a `media-use: low-confidence match` line on stderr and a `match` object in `--json` output: `{score, min_score, low_confidence}` for a HeyGen sound under 0.5, or `{matched_words, intent_words, low_confidence, resolved_for?}` for a project file found by its name. Listen to a low-confidence sound before placing it, or resolve again with other words. A sound effect nothing matches fails with `no sound effect matched`, naming the min score the search used.
10
+
9
11
  ## Types
10
12
 
11
13
  | Type | What it finds | Provider / cascade |
@@ -27,7 +27,7 @@ export const BUNDLED_SFX_RECOVERY_COMMAND = "npx hyperframes skills update media
27
27
  export class BundledSfxAssetsError extends Error {
28
28
  constructor(health) {
29
29
  super(
30
- `bundled SFX assets are missing or incomplete (${health.detail}). Repair the installed media-use skill: ${health.fix}`,
30
+ `bundled SFX assets are missing or incomplete (${health.detail}). For the user: \`${health.fix}\` repairs the installed media-use skill.`,
31
31
  );
32
32
  this.name = "BundledSfxAssetsError";
33
33
  this.code = health.code;
@@ -1,7 +1,7 @@
1
1
  import { execFileSync } from "node:child_process";
2
2
  import { HEYGEN_CLIENT_SOURCE_ARGV, reportHeygenFailure } from "./heygen-cli.mjs";
3
3
 
4
- export function heygenSearch(subcommand, query, { type, limit = 5, minScore } = {}) {
4
+ export function heygenSearch(subcommand, query, { type, limit = 5, minScore, onEmpty } = {}) {
5
5
  // execFileSync with an argv array (no shell), so query/type/etc. are passed as
6
6
  // literal arguments — no quoting tricks, no command injection. subcommand is a
7
7
  // hardcoded multi-word string (e.g. "audio sounds list"), split into tokens.
@@ -41,5 +41,7 @@ export function heygenSearch(subcommand, query, { type, limit = 5, minScore } =
41
41
  }
42
42
 
43
43
  const data = parsed?.data;
44
- return Array.isArray(data) && data.length > 0 ? data : null;
44
+ if (Array.isArray(data) && data.length > 0) return data;
45
+ onEmpty?.();
46
+ return null;
45
47
  }
@@ -45,3 +45,20 @@ export function typesMatch(a, b) {
45
45
  const visual = new Set(["icon", "image", "logo"]);
46
46
  return visual.has(a) && visual.has(b);
47
47
  }
48
+
49
+ // How well a file found by its name fits `intent`: low confidence unless every word of the intent is in the
50
+ // name and the file was not resolved for a different intent.
51
+ export function nameMatch(intent, stem, resolvedFor) {
52
+ const wanted = matchTokens(intent);
53
+ const named = matchTokens(stem);
54
+ const shared = [...wanted].filter((token) => named.has(token));
55
+ const otherIntent =
56
+ typeof resolvedFor === "string" &&
57
+ [...matchTokens(resolvedFor)].join(" ") !== [...wanted].join(" ");
58
+ return {
59
+ matched_words: shared,
60
+ intent_words: wanted.size,
61
+ low_confidence: shared.length < wanted.size || otherIntent,
62
+ ...(otherIntent && { resolved_for: resolvedFor }),
63
+ };
64
+ }
@@ -3,18 +3,36 @@ import { OpenverseUnavailableError, searchOpenverseSfx } from "./openverse.mjs";
3
3
 
4
4
  export const OPENVERSE_SFX_PROVIDER = "openverse.audio";
5
5
 
6
+ // Good effects score 0.5-0.67, under the server's default floor of 0.7, so the floor is lowered; a match under
7
+ // SFX_CONFIDENT_SCORE is still returned, flagged so the caller listens before placing it.
8
+ export const SFX_MIN_SCORE = 0.4;
9
+ export const SFX_CONFIDENT_SCORE = 0.5;
10
+
11
+ export function scoreMatch(score) {
12
+ const known = typeof score === "number" ? score : null;
13
+ return {
14
+ score: known,
15
+ min_score: SFX_MIN_SCORE,
16
+ low_confidence: known === null || known < SFX_CONFIDENT_SCORE,
17
+ };
18
+ }
19
+
6
20
  export const heygenSfxProvider = {
7
21
  async search(intent) {
8
- // Good effects score 0.5-0.67, under the server's default floor of 0.7.
9
22
  const results = heygenSearch("audio sounds list", intent, {
10
23
  type: "sound_effects",
11
- minScore: 0.4,
24
+ minScore: SFX_MIN_SCORE,
25
+ onEmpty: () =>
26
+ console.error(
27
+ `media-use: HeyGen sound search matched nothing for "${intent}" at min score ${SFX_MIN_SCORE}; trying the next source`,
28
+ ),
12
29
  });
13
30
  if (!results) return null;
14
31
  const best = results[0];
15
32
  return {
16
33
  url: best.audio_url,
17
34
  source: "search",
35
+ match: scoreMatch(best.score),
18
36
  metadata: {
19
37
  description: best.description || intent,
20
38
  duration: best.duration || null,
@@ -32,7 +32,7 @@ import { probe as probeMedia } from "./lib/probe.mjs";
32
32
  import { track } from "./lib/telemetry.mjs";
33
33
  import { recordMiss } from "./lib/misses.mjs";
34
34
  import { buildStats } from "./lib/stats.mjs";
35
- import { typesMatch } from "./lib/match.mjs";
35
+ import { nameMatch, typesMatch } from "./lib/match.mjs";
36
36
  import { listCandidates, formatCandidates, CANDIDATE_CAP } from "./lib/candidates.mjs";
37
37
  import { findGlobalBySha } from "./lib/cache.mjs";
38
38
  import { heygenAuthMethod } from "../audio/scripts/lib/heygen.mjs";
@@ -56,8 +56,17 @@ import {
56
56
  flushHeygenFailureTracking,
57
57
  versionLessThan,
58
58
  } from "./lib/heygen-cli.mjs";
59
- import { BundledSfxAssetsError, inspectBundledSfxAssets } from "./lib/bundled-sfx-provider.mjs";
60
- import { OPENVERSE_SFX_PROVIDER } from "./lib/sfx-provider.mjs";
59
+ import {
60
+ BUNDLED_SFX_RECOVERY_COMMAND,
61
+ BundledSfxAssetsError,
62
+ inspectBundledSfxAssets,
63
+ } from "./lib/bundled-sfx-provider.mjs";
64
+ import {
65
+ OPENVERSE_SFX_PROVIDER,
66
+ SFX_CONFIDENT_SCORE,
67
+ SFX_MIN_SCORE,
68
+ scoreMatch,
69
+ } from "./lib/sfx-provider.mjs";
61
70
  import { writeSfxCredit } from "./lib/openverse.mjs";
62
71
  import {
63
72
  fetchMediaVectors,
@@ -376,7 +385,8 @@ async function run() {
376
385
  : findExistingAsset(projectDir, intent, type);
377
386
  if (existingAsset) {
378
387
  const recorded = latestRecordFor(projectDir, existingAsset.relativePath);
379
- if (recorded) return result(recorded, "cached");
388
+ const match = nameMatch(intent, existingAsset.name, recorded?.provenance?.prompt);
389
+ if (recorded) return result(recorded, "cached", match);
380
390
  const id = nextId(projectDir, type);
381
391
  const record = {
382
392
  id,
@@ -388,7 +398,7 @@ async function run() {
388
398
  };
389
399
  appendRecord(projectDir, record);
390
400
  regenerateIndex(projectDir);
391
- return result(record, "existing");
401
+ return result(record, "existing", match);
392
402
  }
393
403
 
394
404
  // 2. global cache — exact-prompt or entity match
@@ -541,7 +551,9 @@ async function run() {
541
551
  ? "no brand spec found — add a frame.md or design.md (colors/font/logo) to this project. Run the HyperFrames design flow to create one; brand tokens are read locally for deterministic rendering."
542
552
  : args.provider
543
553
  ? `provider "${args.provider}" could not resolve ${type}: "${intent}"${localOnly ? " (--local-only skips network providers; drop it or the --provider override)" : ""}`
544
- : `no provider could resolve ${type}: "${intent}"`;
554
+ : type === "sfx" && !localOnly
555
+ ? `no sound effect matched "${intent}": HeyGen sound search (min score ${SFX_MIN_SCORE}), Openverse and the bundled library had nothing. Try other words for the sound.`
556
+ : `no provider could resolve ${type}: "${intent}"`;
545
557
  if (args.json) {
546
558
  console.log(
547
559
  JSON.stringify({
@@ -606,7 +618,7 @@ async function run() {
606
618
  } catch {
607
619
  // promotion is best-effort; a resolve still succeeds locally
608
620
  }
609
- return result(record, searchResult.source || "search");
621
+ return result(record, searchResult.source || "search", searchResult.match);
610
622
  }
611
623
 
612
624
  function mergeSmartAdjust(block) {
@@ -1150,7 +1162,13 @@ function printDoctor(checks) {
1150
1162
  const freePath = heygenChecks.has(check.name)
1151
1163
  ? " — free-usage path: bgm/image/voice/avatar-video"
1152
1164
  : "";
1153
- const fix = check.ok || !check.fix ? "" : ` — fix: ${check.fix}`;
1165
+ // Repairing a skill is the person's step, so that fix is addressed to them, not to the agent.
1166
+ const fix =
1167
+ check.ok || !check.fix
1168
+ ? ""
1169
+ : check.fix === BUNDLED_SFX_RECOVERY_COMMAND
1170
+ ? ` — For the user: \`${check.fix}\` repairs it`
1171
+ : ` — fix: ${check.fix}`;
1154
1172
  console.log(`${prefix} ${check.detail}${freePath}${fix}`);
1155
1173
  }
1156
1174
  }
@@ -1291,7 +1309,31 @@ async function reuseGlobal(shaArg) {
1291
1309
  await result(imported, "reused-explicit");
1292
1310
  }
1293
1311
 
1294
- async function result(record, source) {
1312
+ function warnLowConfidence(record, match) {
1313
+ if (!match?.low_confidence) return;
1314
+ const why =
1315
+ "min_score" in match
1316
+ ? `search score ${match.score ?? "missing"}, under the ${SFX_CONFIDENT_SCORE} a good match reaches`
1317
+ : match.resolved_for
1318
+ ? `found by its file name, resolved earlier for "${match.resolved_for}"`
1319
+ : `found by its file name, sharing ${match.matched_words.length} of ${match.intent_words} words`;
1320
+ console.error(
1321
+ `media-use: low-confidence match for "${intent}": ${record.description || record.path} (${why}). Listen before placing it, or resolve again with other words.`,
1322
+ );
1323
+ }
1324
+
1325
+ // A reused record gets back the advisory its first resolve gave, rebuilt from its provenance.
1326
+ function recordedMatch(record) {
1327
+ const kept = record.provenance ?? {};
1328
+ if (record.type === "sfx" && kept.provider === "heygen.audio.sounds")
1329
+ return scoreMatch(kept.score);
1330
+ if (kept.adopted && record.path)
1331
+ return nameMatch(intent, basename(record.path, extname(record.path)), kept.prompt);
1332
+ return undefined;
1333
+ }
1334
+
1335
+ async function result(record, source, match = recordedMatch(record)) {
1336
+ warnLowConfidence(record, match);
1295
1337
  const { provider, license, credit, source_url: sourceUrl } = record.provenance ?? {};
1296
1338
  // Under the media lock: two resolves at once each read, then rewrite, the whole credits file.
1297
1339
  if (provider === OPENVERSE_SFX_PROVIDER)
@@ -1329,6 +1371,7 @@ async function result(record, source) {
1329
1371
  ...record,
1330
1372
  ...(grading || {}),
1331
1373
  ...(grading && { grading }),
1374
+ ...(match && { match }),
1332
1375
  _source: source,
1333
1376
  }),
1334
1377
  );
@@ -9,33 +9,33 @@ import {
9
9
  skillsManagedExternally,
10
10
  skills_default,
11
11
  updateSkills
12
- } from "./chunk-XJG65BB2.js";
12
+ } from "./chunk-NWFIYKEI.js";
13
13
  import "./chunk-CIWX5UKC.js";
14
- import "./chunk-WJD3GVAA.js";
14
+ import "./chunk-LISUH6KH.js";
15
15
  import "./chunk-6BEFEWFB.js";
16
- import "./chunk-QFZ3ZSXI.js";
17
- import "./chunk-UH62KSYV.js";
16
+ import "./chunk-O4ZD7TVR.js";
17
+ import "./chunk-XMOWL46H.js";
18
18
  import "./chunk-PXVQOMKL.js";
19
19
  import "./chunk-MCDNAIFF.js";
20
20
  import "./chunk-BVAPHHMQ.js";
21
21
  import "./chunk-DL4OD7IA.js";
22
22
  import "./chunk-S3S4TGEH.js";
23
23
  import "./chunk-54HJ63Q2.js";
24
- import "./chunk-2GICKZ3I.js";
24
+ import "./chunk-HOCC4J5C.js";
25
25
  import "./chunk-TK7THLRO.js";
26
26
  import "./chunk-FXMKHHPO.js";
27
27
  import "./chunk-LAGZGKKN.js";
28
28
  import "./chunk-FBN2M2HK.js";
29
- import "./chunk-WTGG734B.js";
30
- import "./chunk-KT4KPBI7.js";
29
+ import "./chunk-2SYOEZ2Z.js";
30
+ import "./chunk-IO3BC2ZK.js";
31
31
  import "./chunk-BR2JQQC5.js";
32
- import "./chunk-BONBJJ35.js";
32
+ import "./chunk-CKEOCCMK.js";
33
33
  import "./chunk-ISN5GRYI.js";
34
34
  import "./chunk-ADVVQX4I.js";
35
35
  import "./chunk-66W5IWLO.js";
36
- import "./chunk-J3RXEDR2.js";
36
+ import "./chunk-FYZFURBN.js";
37
37
  import "./chunk-QBXDU24O.js";
38
- import "./chunk-WQ4SMZDF.js";
38
+ import "./chunk-FQFWGAON.js";
39
39
  import "./chunk-E63BDV4Z.js";
40
40
  import "./chunk-G7VEYUZ2.js";
41
41
  import "./chunk-XT6MXC7A.js";
@@ -10,16 +10,16 @@ import {
10
10
  recordSkillsCheck,
11
11
  refreshSkillsCache,
12
12
  skillsCheckDue
13
- } from "./chunk-WTGG734B.js";
14
- import "./chunk-KT4KPBI7.js";
13
+ } from "./chunk-2SYOEZ2Z.js";
14
+ import "./chunk-IO3BC2ZK.js";
15
15
  import "./chunk-BR2JQQC5.js";
16
- import "./chunk-BONBJJ35.js";
16
+ import "./chunk-CKEOCCMK.js";
17
17
  import "./chunk-ISN5GRYI.js";
18
18
  import "./chunk-ADVVQX4I.js";
19
19
  import "./chunk-66W5IWLO.js";
20
- import "./chunk-J3RXEDR2.js";
20
+ import "./chunk-FYZFURBN.js";
21
21
  import "./chunk-QBXDU24O.js";
22
- import "./chunk-WQ4SMZDF.js";
22
+ import "./chunk-FQFWGAON.js";
23
23
  import "./chunk-E63BDV4Z.js";
24
24
  import "./chunk-G7VEYUZ2.js";
25
25
  import "./chunk-XT6MXC7A.js";