hyperframes 0.9.11 → 0.9.13

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 (261) hide show
  1. package/dist/{add-IAFJH5RC.js → add-PXF5OGLI.js} +13 -12
  2. package/dist/{agentPromptGenerator-S3GWYMVC.js → agentPromptGenerator-DWNK722M.js} +5 -5
  3. package/dist/{animatedGifPrep-YU7IOD5D.js → animatedGifPrep-FFBCFFIY.js} +5 -5
  4. package/dist/api.js +29 -27
  5. package/dist/{asset-UR4PH6KJ.js → asset-FZVMLDSY.js} +5 -5
  6. package/dist/{assetCataloger-VKJIQCYP.js → assetCataloger-FXBZK55R.js} +6 -6
  7. package/dist/{audio-HZJ7QZQR.js → audio-QYNPBNZQ.js} +23 -21
  8. package/dist/{auth-UBNAW62X.js → auth-2FBS4QC4.js} +6 -6
  9. package/dist/{autoUpdate-DDFTFHRP.js → autoUpdate-VFGRGQTO.js} +4 -4
  10. package/dist/avatars-UVZFK2JR.js +168 -0
  11. package/dist/{backgroundChecks-H3TNVYJV.js → backgroundChecks-FN53YXTW.js} +5 -5
  12. package/dist/backgroundChecksWorker.js +5 -5
  13. package/dist/{batchRender-ZDL65J7N.js → batchRender-JB3D6X7U.js} +10 -7
  14. package/dist/{beats-HOIQSFFP.js → beats-5BJMEGGA.js} +11 -11
  15. package/dist/{benchmark-ZYOQV7DK.js → benchmark-MP4JGPYM.js} +11 -11
  16. package/dist/{billing-5YSYJJ2V.js → billing-XSPWEAYT.js} +6 -5
  17. package/dist/{browser-PLFK53IZ.js → browser-V4EB7UNU.js} +8 -8
  18. package/dist/{bundleWithLocalizedFonts-TH5SLG6O.js → bundleWithLocalizedFonts-Z23O7MZ3.js} +4 -4
  19. package/dist/{capture-MICLAF6V.js → capture-L5TGT4SW.js} +18 -18
  20. package/dist/{capture-R77HOGLQ.js → capture-SQHH4HBC.js} +5 -5
  21. package/dist/{captureCompositionFrame-WBMFZHEF.js → captureCompositionFrame-BAYKFJMM.js} +12 -12
  22. package/dist/{catalog-CGT32566.js → catalog-OLP2O5W6.js} +14 -13
  23. package/dist/{catch-up-TMYPXRKC.js → catch-up-LJWHENVV.js} +8 -8
  24. package/dist/{check-4O5J4OWS.js → check-KGAKP3H5.js} +38 -37
  25. package/dist/{checkAudio-AAVDZFIQ.js → checkAudio-QWBAUBJ2.js} +10 -10
  26. package/dist/{checkBrowser-3OCZBJC7.js → checkBrowser-J5UUWIPK.js} +31 -30
  27. package/dist/{chunk-R7EKEIAK.js → chunk-2ASPXS4U.js} +1 -1
  28. package/dist/{chunk-Q3IT7I2K.js → chunk-2IATDUYU.js} +1 -1
  29. package/dist/{chunk-WJ7E5J77.js → chunk-2IB3XVAR.js} +12 -12
  30. package/dist/{chunk-EPCVE3OX.js → chunk-2WGAXAM7.js} +2 -2
  31. package/dist/{chunk-H7H7XNYY.js → chunk-2YVIA2BX.js} +4 -4
  32. package/dist/{chunk-6KV3CMY2.js → chunk-3BLPPIJA.js} +3 -15
  33. package/dist/chunk-3S27CPV7.js +17 -0
  34. package/dist/{chunk-ZUACTOAB.js → chunk-3SZZLHHM.js} +1 -1
  35. package/dist/{chunk-7W5ZDOLW.js → chunk-472XCBCV.js} +14 -3
  36. package/dist/{chunk-YTNHZT47.js → chunk-4HGTJHKB.js} +3 -3
  37. package/dist/{chunk-4ILKN2MX.js → chunk-5Z7YSZRF.js} +10 -10
  38. package/dist/{chunk-7RM3TB62.js → chunk-6PGTJG3M.js} +1 -1
  39. package/dist/{chunk-V6HV2IDT.js → chunk-6U6KMYIV.js} +1 -1
  40. package/dist/{chunk-LR5NVYZT.js → chunk-7AMCGJDM.js} +1 -1
  41. package/dist/{chunk-4J4EGANW.js → chunk-7S2LS53F.js} +6 -6
  42. package/dist/{chunk-PKLZ5PV2.js → chunk-7WSL3PT3.js} +2 -2
  43. package/dist/{chunk-OJTXXFYO.js → chunk-7X3UDKJK.js} +1 -1
  44. package/dist/{chunk-QOF7XZEI.js → chunk-7Z7SREEU.js} +2 -2
  45. package/dist/{chunk-N6FGHJ7X.js → chunk-AB6DKVKC.js} +13 -2
  46. package/dist/{chunk-6DHC3MVK.js → chunk-AIK4ETUZ.js} +2 -2
  47. package/dist/{chunk-SRVAYGTN.js → chunk-AKE744C5.js} +6 -5
  48. package/dist/{chunk-MZHCA5KY.js → chunk-AR6IO4RY.js} +5 -5
  49. package/dist/{chunk-LNTUFRZD.js → chunk-AWV4F5TS.js} +3 -3
  50. package/dist/{chunk-X5EOH44V.js → chunk-B2RMMRJB.js} +1 -1
  51. package/dist/{chunk-MWHTLXG4.js → chunk-B3CSMKM7.js} +1 -1
  52. package/dist/{chunk-SUM3VFPQ.js → chunk-BE7Y3PJZ.js} +3 -3
  53. package/dist/{chunk-TSQZ3DSC.js → chunk-BY7PZB6H.js} +1 -1
  54. package/dist/{chunk-OQHC5YIB.js → chunk-BYWQQMTB.js} +2 -2
  55. package/dist/{chunk-6Y7WZTHJ.js → chunk-C5VZTKW2.js} +26 -26
  56. package/dist/{chunk-BONBJJ35.js → chunk-CKEOCCMK.js} +1 -1
  57. package/dist/{chunk-XX77LLFJ.js → chunk-CKZVLS3K.js} +70 -5
  58. package/dist/{chunk-BBMMVLA3.js → chunk-CLT3CJKG.js} +2 -2
  59. package/dist/chunk-D3UCUI7G.js +68 -0
  60. package/dist/{chunk-XTYNW745.js → chunk-EP6GCDZ6.js} +1 -1
  61. package/dist/{chunk-2VZVMCV6.js → chunk-EQSUX64Q.js} +1 -1
  62. package/dist/{chunk-JT2ZGKKB.js → chunk-EZCMP7NJ.js} +3 -3
  63. package/dist/{chunk-C3NC67BB.js → chunk-F6PFZMQU.js} +3 -3
  64. package/dist/{chunk-VWUUNGSV.js → chunk-FJIN5OWZ.js} +3 -3
  65. package/dist/{chunk-J3RXEDR2.js → chunk-FYZFURBN.js} +2 -2
  66. package/dist/{chunk-LV5SL4YW.js → chunk-GPHY5R35.js} +1 -1
  67. package/dist/{chunk-OQGA4QBD.js → chunk-H4VII7WN.js} +7 -7
  68. package/dist/{chunk-42TYQPES.js → chunk-H6FRRSHM.js} +1 -1
  69. package/dist/{chunk-2GICKZ3I.js → chunk-HOCC4J5C.js} +1 -1
  70. package/dist/{chunk-SSZTRWKQ.js → chunk-HTSVFS4G.js} +2 -2
  71. package/dist/{chunk-4H4DR36N.js → chunk-IOPE4LJ2.js} +1 -1
  72. package/dist/{chunk-NQYW4IYN.js → chunk-ITDHT7AO.js} +4 -4
  73. package/dist/{chunk-QRCORKYC.js → chunk-JGTJEQ5X.js} +2 -2
  74. package/dist/{chunk-ZD3MK4H5.js → chunk-KHF5WT6E.js} +1 -1
  75. package/dist/{chunk-CUYVIDGF.js → chunk-KWGOABKQ.js} +2 -2
  76. package/dist/{chunk-AUYRWWFL.js → chunk-LGVUQ4GC.js} +3 -3
  77. package/dist/{chunk-WJD3GVAA.js → chunk-LISUH6KH.js} +1 -1
  78. package/dist/{chunk-5LOZWO2M.js → chunk-M3JU24AI.js} +1 -1
  79. package/dist/{chunk-OAFGA2FR.js → chunk-MBX3BHW3.js} +1 -1
  80. package/dist/{chunk-4YCNVKJX.js → chunk-MGAGDEBC.js} +3 -3
  81. package/dist/{chunk-IQ5OMRLK.js → chunk-MJEE2WSS.js} +5 -5
  82. package/dist/{chunk-JS6ZTPYC.js → chunk-N2SXD5EG.js} +1 -1
  83. package/dist/{chunk-KNOIX2U5.js → chunk-N43XGFAZ.js} +279 -231
  84. package/dist/{chunk-N74N2I2K.js → chunk-N7EA7GWU.js} +1 -1
  85. package/dist/{chunk-T4ELNOK6.js → chunk-NMYRVKIL.js} +4 -4
  86. package/dist/{chunk-A33GFLPY.js → chunk-NR2W7HUH.js} +1 -1
  87. package/dist/{chunk-6JDNEQV5.js → chunk-NW5QHUZO.js} +2 -2
  88. package/dist/{chunk-EL2DMHA5.js → chunk-NXQMN7YC.js} +1 -1
  89. package/dist/{chunk-2P5DTXUN.js → chunk-NZTYGWRK.js} +1 -1
  90. package/dist/{chunk-HY64QA63.js → chunk-O4Q44I77.js} +18 -6
  91. package/dist/{chunk-FLXZ4GZI.js → chunk-OHN3OJQQ.js} +1 -1
  92. package/dist/{chunk-ZLN3AJKT.js → chunk-OPOYDJEW.js} +1 -1
  93. package/dist/{chunk-DI3ZFBZ3.js → chunk-QVW57TUW.js} +6 -4
  94. package/dist/{chunk-SG4YBQPY.js → chunk-RADODJYB.js} +2 -2
  95. package/dist/{chunk-2VYAX3ZD.js → chunk-RBF3AF7R.js} +4 -4
  96. package/dist/{chunk-ABI256T5.js → chunk-RL52TNCM.js} +2 -2
  97. package/dist/{chunk-AVNF52HR.js → chunk-RWQEWEOV.js} +1 -1
  98. package/dist/{chunk-CD65TPHT.js → chunk-SFO4FLUG.js} +1 -1
  99. package/dist/{chunk-7ZBMUKHY.js → chunk-SGLX72IQ.js} +7 -7
  100. package/dist/{chunk-LWFXO732.js → chunk-SM4F4H3T.js} +1 -1
  101. package/dist/{chunk-FC4WF2VQ.js → chunk-SXAZR7M4.js} +2 -2
  102. package/dist/{chunk-EBUA6NWH.js → chunk-T5ZEMZ3K.js} +2 -2
  103. package/dist/{chunk-IMK55N3Z.js → chunk-TBXV7O3Z.js} +10 -10
  104. package/dist/{chunk-G3ERWPNV.js → chunk-TNTQ7H24.js} +15 -1
  105. package/dist/{chunk-OKD2LP73.js → chunk-TSCUYZ4B.js} +1 -1
  106. package/dist/{chunk-VM6T3Z6B.js → chunk-TX3JT67F.js} +1 -1
  107. package/dist/{chunk-37537KOL.js → chunk-U7AB4D6T.js} +5 -5
  108. package/dist/{chunk-3DWH6Z5U.js → chunk-UPI2MZ5L.js} +1 -1
  109. package/dist/{chunk-WWBEAKTO.js → chunk-UXS7VE75.js} +1 -1
  110. package/dist/{chunk-YJZYUXHQ.js → chunk-VIEMTLSI.js} +7 -7
  111. package/dist/{chunk-6R2PED3X.js → chunk-WCNUB6WU.js} +9 -9
  112. package/dist/{chunk-FPR57WRR.js → chunk-WEWXIQPN.js} +1 -1
  113. package/dist/{chunk-CN3Q4CDK.js → chunk-WGQW65DO.js} +12 -17
  114. package/dist/{chunk-I4XTKG2B.js → chunk-WSZWPYRG.js} +2 -2
  115. package/dist/{chunk-33K2UZBX.js → chunk-XHY36WZF.js} +2 -2
  116. package/dist/{chunk-AHLDGEH5.js → chunk-YHID4CM3.js} +1 -1
  117. package/dist/{chunk-QM4OL5MZ.js → chunk-YMP5FTA3.js} +11 -11
  118. package/dist/{chunk-NO6F7CLR.js → chunk-Z4GE5BXC.js} +5 -2
  119. package/dist/{chunk-ETYQYG6Q.js → chunk-ZFZXGZTX.js} +27 -18
  120. package/dist/{chunk-S2UKSI3C.js → chunk-ZMRRTWKP.js} +1 -1
  121. package/dist/{chunk-E2YXF2EP.js → chunk-ZPJVKYDL.js} +3 -3
  122. package/dist/{clean-2FWZPS4J.js → clean-NNYMY7FD.js} +17 -17
  123. package/dist/cli.js +69 -68
  124. package/dist/{cloud-2UFI7NLD.js → cloud-6FBCPI3B.js} +6 -6
  125. package/dist/{cloud-Z3FNCC4T.js → cloud-RFM3PYTR.js} +8 -6
  126. package/dist/{cloudrun-N737TJRC.js → cloudrun-D4V4TV6S.js} +6 -6
  127. package/dist/{colors-HRL7QSVG.js → colors-CRTWLZ5S.js} +2 -2
  128. package/dist/{compare-HKRLSFTU.js → compare-J3JV4AZ3.js} +32 -28
  129. package/dist/{compiler-KKIYPREA.js → compiler-5ANBCHB7.js} +3 -3
  130. package/dist/{component-F43F3363.js → component-QFREWBT5.js} +6 -6
  131. package/dist/{compositions-FFXCISLD.js → compositions-NUTRZGAZ.js} +15 -15
  132. package/dist/{curve-RHSJUG5P.js → curve-LR4THVRF.js} +12 -12
  133. package/dist/{cuts-KVFY3U6C.js → cuts-5WPLSRM2.js} +13 -13
  134. package/dist/{delete-O7IZKKUN.js → delete-KLIVMSTG.js} +14 -12
  135. package/dist/{deploy-PZAAUW75.js → deploy-CDWKRTWY.js} +6 -6
  136. package/dist/{describeProject-E44RWBJL.js → describeProject-YJEOPIW7.js} +8 -8
  137. package/dist/{destroy-IQLGADZM.js → destroy-6XY4WQWY.js} +2 -2
  138. package/dist/{diff-OMNILRNN.js → diff-KY6T2E32.js} +35 -33
  139. package/dist/{dist-PUHEYGA5.js → dist-GVCHAZJU.js} +6 -6
  140. package/dist/{dist-PCVNVAVC.js → dist-TQKOMXXI.js} +4 -2
  141. package/dist/{docs-D22SOQEZ.js → docs-WYJSJGSF.js} +2 -2
  142. package/dist/{doctor-4HZN7ZVI.js → doctor-HLG4AP3Q.js} +12 -12
  143. package/dist/{energy-N3ZIPHTP.js → energy-3T3DDIEN.js} +13 -13
  144. package/dist/{events-VAJ4Y6XF.js → events-HZG5BWCQ.js} +5 -5
  145. package/dist/{events-56A5D6DK.js → events-LB2RDZX3.js} +6 -6
  146. package/dist/{events-TUTAERAN.js → events-ZZNUYUCY.js} +15 -15
  147. package/dist/{extract-NJMZEOLG.js → extract-7STXIEDI.js} +18 -15
  148. package/dist/{face-KLV4W6CP.js → face-3DWRLSWO.js} +15 -14
  149. package/dist/{feedback-4VEKGVLN.js → feedback-4V2HGHTZ.js} +13 -12
  150. package/dist/{ffmpeg-A2O4HSRD.js → ffmpeg-5BWHEWVW.js} +5 -5
  151. package/dist/{figma-6XDKKOA6.js → figma-4SSCW6YU.js} +5 -5
  152. package/dist/fontLocalizeCli.js +8 -8
  153. package/dist/{frames-IAMGMNCA.js → frames-V3OUCXX6.js} +14 -14
  154. package/dist/{generate-FMATRA3L.js → generate-W4HW4MJQ.js} +20 -18
  155. package/dist/{get-JKA3APWR.js → get-FXFV3VDQ.js} +14 -12
  156. package/dist/{gpuPolicy-TKHFDEH2.js → gpuPolicy-X4BOE2HD.js} +5 -5
  157. package/dist/{grade-compare-TCLCDUG5.js → grade-compare-PV62LISL.js} +33 -30
  158. package/dist/{heifImagePrep-L2EY67F2.js → heifImagePrep-2K2I4SCP.js} +6 -6
  159. package/dist/{help-TWDOQJDN.js → help-R2ASMVJB.js} +3 -3
  160. package/dist/{history-SOWVZUAB.js → history-X24EZSOO.js} +10 -10
  161. package/dist/hyperframes-player.global.js +1 -1
  162. package/dist/{info-JDINBZLH.js → info-DJ6TZSEF.js} +9 -9
  163. package/dist/{init-ACNL6AFC.js → init-GQ2GRVQS.js} +34 -31
  164. package/dist/{ink-WNEJROFH.js → ink-L4VRIFJ7.js} +13 -13
  165. package/dist/{inspect-37AMWUW3.js → inspect-5IXDDOJN.js} +29 -28
  166. package/dist/{installer-PUQYKLXZ.js → installer-ZIBXFENP.js} +3 -2
  167. package/dist/{keyframes-LMUFQW4Z.js → keyframes-ASFH5XYJ.js} +10 -10
  168. package/dist/{lambda-DRGDNEW6.js → lambda-ELYE5XIZ.js} +17 -17
  169. package/dist/{layout-E63HPSXW.js → layout-NNGVQWY4.js} +29 -28
  170. package/dist/{lint-HNZPRCXH.js → lint-GYJFRDI2.js} +13 -13
  171. package/dist/{lintProject-EV3EEBY3.js → lintProject-NGMRZDNT.js} +2 -2
  172. package/dist/{list-UMR5VN2M.js → list-UBFDCTVO.js} +15 -13
  173. package/dist/{localPage-KIFKMB2B.js → localPage-DHAVU3EM.js} +5 -5
  174. package/dist/{login-OXOPCSUY.js → login-OKJT7QWG.js} +10 -9
  175. package/dist/{logout-UMDA3HDE.js → logout-YACQMRZN.js} +5 -4
  176. package/dist/{look-DFQJP2LY.js → look-4GINLBBO.js} +13 -13
  177. package/dist/{manager-T633Z2L4.js → manager-Q5X74T5D.js} +6 -6
  178. package/dist/{measure-Y2VXF6LJ.js → measure-LICRA4FH.js} +11 -11
  179. package/dist/{media-treatment-U2PDH4P3.js → media-treatment-PM3WLJZ4.js} +15 -15
  180. package/dist/{media-use-KGNGAQQP.js → media-use-NUORYIBQ.js} +7 -5
  181. package/dist/{models-HATSG3VK.js → models-V2XJYFY5.js} +13 -13
  182. package/dist/{motionShot-45M7MSFQ.js → motionShot-YBJB6L3C.js} +20 -17
  183. package/dist/{normalize-audio-SOXEVIKM.js → normalize-audio-LUAEDEUM.js} +8 -8
  184. package/dist/{open-LRPNBFRW.js → open-RTL2AU5C.js} +14 -13
  185. package/dist/{parakeetRunner-A7Z6CQOT.js → parakeetRunner-FBEL64JM.js} +12 -11
  186. package/dist/{pipeline-N3M6VXBC.js → pipeline-2VN2FDAL.js} +8 -8
  187. package/dist/{play-HTHDFMOU.js → play-U3EXVEC7.js} +22 -21
  188. package/dist/{policies-EERREOZJ.js → policies-EV7XPSQC.js} +2 -2
  189. package/dist/{preflight-XZZXHV42.js → preflight-Z3U5OGW3.js} +6 -6
  190. package/dist/{present-LQ4PJTP4.js → present-NXEDFMC4.js} +17 -17
  191. package/dist/{preview-CTEDNFN3.js → preview-AUDJW3KE.js} +23 -22
  192. package/dist/{probe-6IZD5TPR.js → probe-QQXAWDZG.js} +14 -13
  193. package/dist/{producer-4CR46ON4.js → producer-DNWWPGFA.js} +1 -1
  194. package/dist/{progress-STSH2JRY.js → progress-FWJJMPIQ.js} +2 -2
  195. package/dist/{projectConfig-PUAOWUNS.js → projectConfig-FMXOJBJY.js} +5 -4
  196. package/dist/{prompts-ZEVFT7US.js → prompts-27EPTM64.js} +2 -2
  197. package/dist/{publish-7W46NJFT.js → publish-7HSXMQEF.js} +15 -14
  198. package/dist/{refresh-4FQFQ2SW.js → refresh-L5C2HPMC.js} +5 -4
  199. package/dist/{remove-background-SYHNGASQ.js → remove-background-AIYMKXZW.js} +12 -12
  200. package/dist/{render-EF7Y6YYC.js → render-FD7LHCCC.js} +4 -4
  201. package/dist/{render-VZLEKSHR.js → render-RMPWJTY4.js} +44 -40
  202. package/dist/{render-JHSMAWED.js → render-SAAQKFHE.js} +129 -64
  203. package/dist/{render-batch-JYYP4RXA.js → render-batch-WPHP27VT.js} +4 -4
  204. package/dist/renderSetupWorker.js +2 -2
  205. package/dist/{resolver-BKFLETMU.js → resolver-E7IHSWCQ.js} +3 -2
  206. package/dist/{reverse-SCXEQVRH.js → reverse-GHX5LUSV.js} +1 -1
  207. package/dist/{run-GRCZ6JO5.js → run-65M6ECM2.js} +7 -6
  208. package/dist/{sherpa-EENLR3RM.js → sherpa-QQZMXXO5.js} +11 -10
  209. package/dist/{sites-EAGXQOKI.js → sites-O7A7G3ZQ.js} +2 -2
  210. package/dist/skills/hyperframes/SKILL.md +2 -2
  211. package/dist/skills/hyperframes/references/plugin-installation.md +5 -6
  212. package/dist/skills/hyperframes/references/skill-lifecycle.md +15 -10
  213. package/dist/skills/hyperframes/scripts/plugin-cli.mjs +2 -2
  214. package/dist/skills/hyperframes-cli/SKILL.md +3 -3
  215. package/dist/skills/hyperframes-cli/references/cloud.md +10 -10
  216. package/dist/skills/hyperframes-cli/references/init-and-scaffold.md +10 -14
  217. package/dist/skills/hyperframes-cli/references/lint-validate-inspect.md +1 -1
  218. package/dist/skills/media-use/SKILL.md +1 -1
  219. package/dist/skills/media-use/audio/scripts/lib/sfx.mjs +2 -2
  220. package/dist/skills/media-use/references/resolve.md +2 -0
  221. package/dist/skills/media-use/scripts/lib/bundled-sfx-provider.mjs +1 -1
  222. package/dist/skills/media-use/scripts/lib/heygen-search.mjs +4 -2
  223. package/dist/skills/media-use/scripts/lib/match.mjs +17 -0
  224. package/dist/skills/media-use/scripts/lib/sfx-provider.mjs +20 -2
  225. package/dist/skills/media-use/scripts/resolve.mjs +52 -9
  226. package/dist/{skills-4TSYBAGW.js → skills-WCXVUM6C.js} +10 -10
  227. package/dist/{skillsUpdateCheck-MGXL5VXL.js → skillsUpdateCheck-PEVW2JO6.js} +5 -5
  228. package/dist/{snapshot-P27Y3NJE.js → snapshot-2ACZXDLZ.js} +36 -35
  229. package/dist/{src-L7UBHHKB.js → src-DA2HOM3K.js} +4 -4
  230. package/dist/{src-MWO2XBSA.js → src-WISBTYBV.js} +7 -7
  231. package/dist/{start-L5M26YD5.js → start-DDOWW7K5.js} +22 -20
  232. package/dist/{staticProjectServer-2JYB7RLI.js → staticProjectServer-MQ7H4MGQ.js} +14 -13
  233. package/dist/{status-SUK4I7TS.js → status-74IZXJKQ.js} +24 -8
  234. package/dist/studio/assets/{hyperframes-player-BbRz52ui.js → hyperframes-player-B2_9tPTr.js} +1 -1
  235. package/dist/studio/assets/{index-CCSgOq2L.js → index-BHe_y2lu.js} +1 -1
  236. package/dist/studio/assets/{index-D3y5mWmH.js → index-DToBQdGg.js} +4 -4
  237. package/dist/studio/index.html +1 -1
  238. package/dist/{studio-api-MEZKFJBY.js → studio-api-UABUZ3PZ.js} +6 -6
  239. package/dist/{studioServer-J5RPUMHP.js → studioServer-FGXZA75B.js} +54 -47
  240. package/dist/{sync-FHT2CHKU.js → sync-AVGYYG4D.js} +13 -13
  241. package/dist/{synthesize-YYT7UON6.js → synthesize-S3FF5KXC.js} +4 -1
  242. package/dist/{telemetry-WGNNQUSF.js → telemetry-5WZGQCKA.js} +3 -3
  243. package/dist/{telemetry-JWEOBK3Q.js → telemetry-7IM2NV22.js} +6 -6
  244. package/dist/templates/_shared/AGENTS.md +7 -6
  245. package/dist/templates/_shared/CLAUDE.md +7 -6
  246. package/dist/{templates-7DIQ52Y4.js → templates-5CWKOSBX.js} +106 -27
  247. package/dist/{timeline-ZO3PNIET.js → timeline-A7R54T7C.js} +19 -19
  248. package/dist/{tokens-X6OTCQCV.js → tokens-W6RQVKWV.js} +5 -5
  249. package/dist/{transcribe-KNO3BK5S.js → transcribe-GPOMREHS.js} +26 -24
  250. package/dist/{transcribe-QIZGXMR5.js → transcribe-N2C2MYCG.js} +8 -8
  251. package/dist/{tts-JHGGL7GL.js → tts-QRQEYR3Q.js} +5 -5
  252. package/dist/{update-WXGSPMEG.js → update-X643YOPS.js} +15 -13
  253. package/dist/{updateCheck-OBYSCTWV.js → updateCheck-O7IUSOXN.js} +4 -4
  254. package/dist/{upgrade-YCCIVSI6.js → upgrade-6NWYJUFT.js} +7 -7
  255. package/dist/{upload-L5TSWWIU.js → upload-HMRWGZIO.js} +1 -1
  256. package/dist/{urlDownloader-FOXK4FYP.js → urlDownloader-PFHIVGDF.js} +4 -4
  257. package/dist/{validate-TDVQ2B6Y.js → validate-IIFU6OEG.js} +22 -22
  258. package/dist/{video-AVEGMBDM.js → video-R6TSXZMN.js} +8 -8
  259. package/dist/{voices-2LIY4CYK.js → voices-Y572PKNN.js} +17 -16
  260. package/dist/warmCheck.js +38 -37
  261. package/package.json +1 -1
@@ -7,20 +7,21 @@ var __dirname = __hf_dirname(__filename);
7
7
  import {
8
8
  analyzeTargets,
9
9
  previewTarget
10
- } from "./chunk-LNTUFRZD.js";
10
+ } from "./chunk-AWV4F5TS.js";
11
11
  import "./chunk-HBAUU3IK.js";
12
- import "./chunk-G3ERWPNV.js";
13
- import "./chunk-TSQZ3DSC.js";
14
- import "./chunk-ETYQYG6Q.js";
12
+ import "./chunk-TNTQ7H24.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,27 +17,28 @@ import {
17
17
  sherpaRuntimeLoadError,
18
18
  sherpaUnsupportedReason,
19
19
  transcribeWithSherpa
20
- } from "./chunk-YTNHZT47.js";
21
- import "./chunk-NO6F7CLR.js";
20
+ } from "./chunk-4HGTJHKB.js";
21
+ import "./chunk-Z4GE5BXC.js";
22
+ import "./chunk-3S27CPV7.js";
22
23
  import "./chunk-5UT3R43E.js";
23
24
  import "./chunk-6BEFEWFB.js";
24
- import "./chunk-AUYRWWFL.js";
25
+ import "./chunk-LGVUQ4GC.js";
25
26
  import "./chunk-SWC3QIEH.js";
26
- import "./chunk-VM6T3Z6B.js";
27
- import "./chunk-ZLN3AJKT.js";
27
+ import "./chunk-TX3JT67F.js";
28
+ import "./chunk-OPOYDJEW.js";
28
29
  import "./chunk-RZ6CXJ56.js";
29
30
  import "./chunk-R4EWRIDL.js";
30
- import "./chunk-AVNF52HR.js";
31
+ import "./chunk-RWQEWEOV.js";
31
32
  import "./chunk-JZIEZCQM.js";
32
33
  import "./chunk-UOFAE5RF.js";
33
34
  import "./chunk-IR35BCLK.js";
34
35
  import "./chunk-HU2SPFNG.js";
35
36
  import "./chunk-A4ZTSQLW.js";
36
- import "./chunk-N6FGHJ7X.js";
37
+ import "./chunk-AB6DKVKC.js";
37
38
  import "./chunk-Z5J67X44.js";
38
39
  import "./chunk-5S7W3TUO.js";
39
40
  import "./chunk-D3MUHMFG.js";
40
- import "./chunk-JS6ZTPYC.js";
41
+ import "./chunk-N2SXD5EG.js";
41
42
  import "./chunk-YWRUQ7XZ.js";
42
43
  import "./chunk-W5AUD5OL.js";
43
44
  import "./chunk-MEJH7VEA.js";
@@ -53,9 +54,9 @@ import "./chunk-X6JUUQCM.js";
53
54
  import "./chunk-KGPLIH7B.js";
54
55
  import "./chunk-K4MJX7SR.js";
55
56
  import "./chunk-WE42NVH7.js";
56
- import "./chunk-XX77LLFJ.js";
57
- import "./chunk-CZGHFATT.js";
57
+ import "./chunk-CKZVLS3K.js";
58
58
  import "./chunk-WVRAFHJU.js";
59
+ import "./chunk-CZGHFATT.js";
59
60
  import "./chunk-HYRPH6LL.js";
60
61
  import "./chunk-C2KEGBR3.js";
61
62
  import "./chunk-JHILL4BN.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";
@@ -3,13 +3,13 @@ name: hyperframes
3
3
  description: Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
4
4
  ---
5
5
 
6
- **Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+ **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](references/plugin-installation.md).
7
7
 
8
8
  # HyperFrames
9
9
 
10
10
  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
11
 
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>`. A website as the subject: `npx hyperframes capture <url> --json`.
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`.
13
13
 
14
14
  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
15
 
@@ -3,11 +3,10 @@
3
3
  Check the directory two levels above the loaded `SKILL.md` for `plugin.json`,
4
4
  `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`, or
5
5
  `.cursor-plugin/plugin.json` identifying `hyperframes`, or a Gemini extension manifest.
6
- That directory is `<PLUGIN_ROOT>`. If none exists, this is a standalone skill;
7
- follow the normal installation and freshness instructions.
6
+ That directory is `<PLUGIN_ROOT>`. If none exists, this is a standalone skill
7
+ install; run `npx hyperframes` directly.
8
8
 
9
- For a plugin installation, these rules replace the standalone update commands
10
- in every skill and reference:
9
+ For a plugin installation, these rules apply in every skill and reference:
11
10
 
12
11
  - Do not run `hyperframes skills update`, `skills check`, or `npx skills add`.
13
12
  The agent's plugin manager owns installation and updates. Read the skill at
@@ -37,7 +36,7 @@ in every skill and reference:
37
36
  project or a temporary directory. Pass this plugin root and launcher convention
38
37
  to any delegated agent so it does not fall back to global skills.
39
38
 
40
- To get newer skills, use the client's plugin update flow and reload the session.
41
- Do not silently update an installed plugin during a video task.
39
+ Newer skills come through the client's plugin update flow and a session reload,
40
+ which the person runs. Do not update an installed plugin yourself.
42
41
 
43
42
  The launcher suppresses CLI update notices as well as standalone skill refreshes, including when running an older CLI with a stale notice cache. It passes the release as `HYPERFRAMES_PLUGIN_VERSION` for plugin-aware helpers and as `HYPERFRAMES_SKILL_PKG_VERSION` for the existing helper-package bootstrap. Our release process versions those packages together.
@@ -1,15 +1,15 @@
1
1
  # Skill installation and freshness
2
2
 
3
- Read this reference when installing or updating skills, diagnosing unexpected skill behavior, or running HyperFrames setup in CI.
3
+ Read this reference when the person asks about installing or updating skills, when diagnosing unexpected skill behavior, or when setting up HyperFrames in CI (see `HYPERFRAMES_SKIP_SKILLS` below). Skills are versioned with the CLI. Installing, updating and removing them is the person's step: tell them what is out of date and which command fits, and do not run it yourself.
4
4
 
5
5
  For a plugin installation, follow [plugin execution rules](plugin-installation.md); the plugin manager owns updates and every skill is bundled. The commands below apply only to standalone skills.
6
6
 
7
- - **Core set, installed eagerly:** `/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry` and `/media-use`.
8
- - **On demand:** `/figma`, `/slideshow`, `/remotion-to-hyperframes` and `/reverse-any-video`, installed with `npx hyperframes skills update <name>`.
7
+ - **Core set:** `/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry` and `/media-use`.
8
+ - **On demand:** `/figma`, `/slideshow`, `/remotion-to-hyperframes`, `/reverse-any-video` and `/style-sampling`, which the person installs with `npx hyperframes skills update <name>`.
9
9
 
10
10
  ## What `init` does
11
11
 
12
- `npx hyperframes init` installs the core set when it is missing and leaves every skill that is already installed as it is: it never refreshes, replaces or removes one. Updating is `npx hyperframes skills update`, run by you. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.
12
+ Without `--skip-skills`, `npx hyperframes init` installs the core set when it is missing and leaves every skill that is already installed as it is: it never refreshes, replaces or removes one. Installing the core set is the person's step, so pass `--skip-skills` whenever you run `init`. When a core skill is missing, tell the person to run `npx hyperframes skills update`, which also updates the skills already installed. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.
13
13
 
14
14
  `--skip-skills` makes `init` leave skills alone. `HYPERFRAMES_SKIP_SKILLS=1` does the same for CI and tests.
15
15
 
@@ -19,14 +19,19 @@ For a plugin installation, follow [plugin execution rules](plugin-installation.m
19
19
 
20
20
  After `render`, `lint` and `validate`, the CLI prints `N HyperFrames skills out of date or missing` to stderr when the cached check finds stale skills, so an agent run without a terminal sees it too. It is off in CI, in dev, with `HYPERFRAMES_NO_UPDATE_CHECK=1` and with `HYPERFRAMES_SKIP_SKILLS=1`, and runs with `--json` too, since it only writes stderr and leaves `--json` stdout untouched.
21
21
 
22
- ## Diagnose and update
22
+ ## Diagnose, and what the person can run
23
23
 
24
24
  ```bash
25
25
  npx hyperframes skills check
26
26
  npx hyperframes skills check --json
27
- npx hyperframes skills update
28
- npx hyperframes skills update <name>
29
- npx hyperframes skills
27
+ ```
28
+
29
+ The person's install and update commands, to name when you relay a stale result:
30
+
31
+ ```bash
32
+ npx hyperframes skills update # the person runs this
33
+ npx hyperframes skills update <name> # the person runs this
34
+ npx hyperframes skills # the person runs this
30
35
  ```
31
36
 
32
37
  - `skills check` exits non-zero when an installed skill is stale or the core set is incomplete. Skills available on demand but not installed are not failures.
@@ -34,9 +39,9 @@ npx hyperframes skills
34
39
  - Named `skills update <name...>` also installs those named skills.
35
40
  - Bare `skills` installs the full published set explicitly.
36
41
 
37
- If the HyperFrames CLI is unavailable, use `npx skills add heygen-com/hyperframes --skill <name>` for one skill or `npx skills add heygen-com/hyperframes --all` for the full published set.
42
+ If the HyperFrames CLI is unavailable, the person can install with `npx skills add heygen-com/hyperframes --skill <name>` for one skill or `npx skills add heygen-com/hyperframes --all` for the full published set.
38
43
 
39
- The CLI may print a one-line stale-skill reminder during `render`, `lint`, or `check`. Treat a failed update as a visible tool failure; do not continue from a remembered skill.
44
+ The CLI may print a one-line stale-skill reminder during `render`, `lint`, or `check`. Relay it to the person and keep working from the installed skills; do not continue from a remembered skill.
40
45
 
41
46
  ## Keep the project's CLI current
42
47
 
@@ -29,7 +29,7 @@ export function pluginVersion(pluginRoot = root) {
29
29
  return manifest.version;
30
30
  }
31
31
  throw new Error(
32
- "No HyperFrames plugin manifest found. Use the standalone skills installation instructions.",
32
+ "No HyperFrames plugin manifest found. This is a standalone skill install; run `npx hyperframes` directly.",
33
33
  );
34
34
  }
35
35
 
@@ -45,7 +45,7 @@ export function invocation(
45
45
  ) {
46
46
  if (args[0] === "skills")
47
47
  throw new Error(
48
- "Update HyperFrames through your agent's plugin manager; bundled skills are release-managed.",
48
+ "Bundled skills are release-managed; the person updates HyperFrames through their agent's plugin manager.",
49
49
  );
50
50
  const childEnv = {
51
51
  ...env,
@@ -3,7 +3,7 @@ name: hyperframes-cli
3
3
  description: The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
4
4
  ---
5
5
 
6
- **Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+ **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
7
7
 
8
8
  # HyperFrames CLI
9
9
 
@@ -15,7 +15,7 @@ A `--json` result may carry `_meta.updateNotice`: a newer HyperFrames release is
15
15
 
16
16
  | Job | Commands |
17
17
  | --- | --- |
18
- | Start | `init <dir>` (blank; `--example <name>` only when asked), `capture <url>` |
18
+ | Start | `init <dir> --skip-skills` (blank; `--example <name>` only when asked), `capture <url>` |
19
19
  | Read a project | `info`, `compositions`, `timeline --json`, `docs <topic>` |
20
20
  | Check it | `lint` while writing; `check --json` as the gate (lint, runtime, layout, contrast) |
21
21
  | Look at it | `snapshot` (`--at <t,…>`, `--range START,END`, `--composition <id>`, `--zoom`, `--angle`, `--against <video>`), `keyframes`, `compare`, `audio` |
@@ -24,7 +24,7 @@ A `--json` result may carry `_meta.updateNotice`: a newer HyperFrames release is
24
24
  | Media and sound | `media-treatment`, `grade-compare`, `remove-background`, `tts`, `transcribe`, `beats`, `normalize-audio` (`/media-use`) |
25
25
  | Show and ship | `preview`, `present` (`/slideshow`), `render`, `publish`, `cloud`, `lambda`, `cloudrun` |
26
26
  | Desktop app | `open`, `catch-up` |
27
- | Upkeep | `doctor`, `browser`, `upgrade`, `skills`, `usage`, `clean`, `feedback` |
27
+ | Upkeep | `doctor`, `browser`, `upgrade`, `usage`, `clean`, `feedback` |
28
28
 
29
29
  `validate`, `inspect` and `layout` are deprecated aliases of `check`; `events` is telemetry for skills' own scripts. Don't run them.
30
30
 
@@ -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 . \
@@ -2,18 +2,18 @@
2
2
 
3
3
  <!-- registry-items: allow=blank,landscape-4k,portrait-4k,square-4k,media-use -->
4
4
 
5
- Scaffolding commands. Use these instead of creating files by hand — they set up the right file structure, copy media, run transcription, and install AI coding skills.
5
+ Scaffolding commands. Use these instead of creating files by hand — they set up the right file structure, copy media, and run transcription.
6
6
 
7
7
  ## init
8
8
 
9
9
  ```bash
10
- npx hyperframes init my-video # centered blank (TTY: wizard)
11
- npx hyperframes init my-video --example warm-grain # pick an example
12
- npx hyperframes init my-video --resolution portrait
13
- npx hyperframes init my-video --video clip.mp4 # with video file
14
- npx hyperframes init my-video --audio track.mp3 # with audio file
15
- npx hyperframes init my-video --tailwind # Tailwind v4 browser runtime
16
- npx hyperframes init my-video --non-interactive # CI — flag-only, same blank
10
+ npx hyperframes init my-video --skip-skills # centered blank (TTY: wizard)
11
+ npx hyperframes init my-video --skip-skills --example warm-grain # pick an example
12
+ npx hyperframes init my-video --skip-skills --resolution portrait
13
+ npx hyperframes init my-video --skip-skills --video clip.mp4 # with video file
14
+ npx hyperframes init my-video --skip-skills --audio track.mp3 # with audio file
15
+ npx hyperframes init my-video --skip-skills --tailwind # Tailwind v4 browser runtime
16
+ npx hyperframes init my-video --skip-skills --non-interactive # CI — flag-only, same blank
17
17
  ```
18
18
 
19
19
  **Default depends on TTY**: in a terminal, the CLI prompts for example/options (default: centered blank). Outside a TTY (CI, agents, piped output) it auto-switches to non-interactive and scaffolds that blank. Pass `--example` only to start from a named example. Pass `--non-interactive` to force flag-only mode on a TTY.
@@ -24,7 +24,7 @@ Other useful flags:
24
24
 
25
25
  - `--resolution` — preset: `landscape` (1920×1080), `portrait` (1080×1920), `landscape-4k`, `portrait-4k`, `square` (1080×1080), `square-4k`. Aliases: `1080p`, `4k`, `uhd`, `1080p-square`, `4k-square`.
26
26
  - `--skill=<slug>` — record the owning skill (e.g. `hyperframes`) in `hyperframes.json`, so every later render of this project — re-renders, `npm run render`, `--batch` — is attributed to it on usage telemetry without re-passing the flag. You rarely pass it by hand.
27
- - `--skip-skills` — leave AI coding skills alone: `init` does not install the core set. `HYPERFRAMES_SKIP_SKILLS=1` does the same.
27
+ - `--skip-skills` — leave AI coding skills alone: `init` does not install the core set. `HYPERFRAMES_SKIP_SKILLS=1` does the same. Always pass it: without it `init` installs any missing core skill, and installing skills is the person's step. When a core skill is missing, tell the person they can install it with `npx hyperframes skills update`.
28
28
  - `--skip-transcribe` — don't auto-transcribe `--audio` / `--video` with Whisper.
29
29
  - `--model`, `--language` — Whisper model / language for the auto-transcription.
30
30
 
@@ -72,8 +72,4 @@ into a fresh output directory; never merge or reuse a blocked attempt's partial
72
72
 
73
73
  ## skills
74
74
 
75
- ```bash
76
- npx hyperframes skills # install HyperFrames skills for AI coding tools
77
- ```
78
-
79
- One-time setup that adds the HyperFrames skill pack (/hyperframes with its references, /hyperframes-cli, /hyperframes-registry, /media-use, /figma, /slideshow, /remotion-to-hyperframes, /reverse-any-video) to the local AI coding environment so agents follow the framework conventions. Re-run after major HyperFrames upgrades.
75
+ `npx hyperframes skills` is the person's one-time setup: it adds the HyperFrames skill pack (/hyperframes with its references, /hyperframes-cli, /hyperframes-registry, /media-use, /figma, /slideshow, /remotion-to-hyperframes, /reverse-any-video, /style-sampling) to the local AI coding environment so agents follow the framework conventions. Skills are versioned with the CLI; after a HyperFrames upgrade the person can refresh them with `npx hyperframes skills update`. Tell them when that applies; do not run it yourself.
@@ -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.
@@ -3,7 +3,7 @@ name: media-use
3
3
  description: Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
4
4
  ---
5
5
 
6
- **Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+ **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
7
7
 
8
8
  # Media in HyperFrames
9
9
 
@@ -146,8 +146,8 @@ export async function resolveSfx({ cues, hyperframesDir, sfxLibDir = BUNDLED_SFX
146
146
  } else if (!existsSync(dest)) {
147
147
  anomalies.push(
148
148
  `sfx "${name}" (id ${id}): bundled file ${hit.file} missing from the offline ` +
149
- `library (${sfxLibDir}) — skipped. Reinstall the media-use skill to ` +
150
- `restore assets/sfx/*.mp3.`,
149
+ `library (${sfxLibDir}) — skipped. Ask the person to reinstall the media-use ` +
150
+ `skill to restore assets/sfx/*.mp3.`,
151
151
  );
152
152
  return null;
153
153
  } // else the engine's earlier copy at dest stands in for the file this install lacks
@@ -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-IMK55N3Z.js";
12
+ } from "./chunk-TBXV7O3Z.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-6DHC3MVK.js";
17
- import "./chunk-JT2ZGKKB.js";
16
+ import "./chunk-AIK4ETUZ.js";
17
+ import "./chunk-EZCMP7NJ.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-IQ5OMRLK.js";
30
- import "./chunk-4YCNVKJX.js";
29
+ import "./chunk-MJEE2WSS.js";
30
+ import "./chunk-MGAGDEBC.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-I4XTKG2B.js";
38
+ import "./chunk-WSZWPYRG.js";
39
39
  import "./chunk-E63BDV4Z.js";
40
40
  import "./chunk-G7VEYUZ2.js";
41
41
  import "./chunk-XT6MXC7A.js";