hyperframes 0.9.33 → 0.9.35

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 (316) hide show
  1. package/bin/hyperframes.mjs +10 -0
  2. package/dist/{add-GDXM36YQ.js → add-T5XBJN7F.js} +17 -16
  3. package/dist/{agentPromptGenerator-KPNDH2EI.js → agentPromptGenerator-KYLYM7IC.js} +11 -11
  4. package/dist/{animatedGifPrep-SAKETEZ2.js → animatedGifPrep-FLIPCLVQ.js} +10 -10
  5. package/dist/api.js +41 -41
  6. package/dist/{appHistory-WZIHFCPK.js → appHistory-VOZOEPVK.js} +3 -3
  7. package/dist/{asset-KOJC72AQ.js → asset-PJLMPMBK.js} +3 -3
  8. package/dist/{assetCataloger-Q4ZFUI6G.js → assetCataloger-ZQ2PWA47.js} +12 -12
  9. package/dist/{audio-XZBBXKQC.js → audio-EBICH5EQ.js} +21 -21
  10. package/dist/{auth-X45YSZGE.js → auth-OTDAEZYD.js} +2 -2
  11. package/dist/{autoUpdate-77XWQ564.js → autoUpdate-TQWOBFKJ.js} +2 -2
  12. package/dist/{avatars-D3D22TI2.js → avatars-WRUDCHTJ.js} +14 -14
  13. package/dist/{backgroundChecks-2L2RWFJ3.js → backgroundChecks-AMPTVQY5.js} +3 -3
  14. package/dist/backgroundChecksWorker.js +5 -4
  15. package/dist/{batchRender-O7J47H2Z.js → batchRender-SGTA6JAT.js} +6 -6
  16. package/dist/{beats-6RVVU56H.js → beats-TLHZXD7W.js} +13 -13
  17. package/dist/{benchmark-D5JRNAVQ.js → benchmark-TAXHNW33.js} +11 -11
  18. package/dist/{billing-WT4DGZII.js → billing-GOHX7W6X.js} +15 -15
  19. package/dist/{browser-2OR737P4.js → browser-H7K5L7WE.js} +10 -9
  20. package/dist/{bundleWithLocalizedFonts-VBET4RVR.js → bundleWithLocalizedFonts-6VWRV726.js} +1 -1
  21. package/dist/{capture-23X2CK56.js → capture-WJAV7DPT.js} +22 -22
  22. package/dist/{capture-B34FTO6G.js → capture-WVJK3FNU.js} +4 -4
  23. package/dist/{captureCompositionFrame-TPZKEVKN.js → captureCompositionFrame-R2OQ5A4S.js} +18 -18
  24. package/dist/{captureFile-Y2ZMB7HK.js → captureFile-MRDRPMNA.js} +3 -3
  25. package/dist/{catalog-ACHSYU5Z.js → catalog-JKDKE3QA.js} +17 -16
  26. package/dist/{catch-up-FGANS2BB.js → catch-up-65YBZQSC.js} +11 -11
  27. package/dist/{check-DXK4L5WP.js → check-XMNNDKNC.js} +50 -50
  28. package/dist/{checkAudio-4ISYJED3.js → checkAudio-ITIWPYET.js} +14 -14
  29. package/dist/{checkBrowser-5ECMULMP.js → checkBrowser-MQHZWWLA.js} +43 -43
  30. package/dist/{chunk-2I4DQZLQ.js → chunk-2QM6JA3F.js} +23 -37
  31. package/dist/{chunk-UC4X6I35.js → chunk-3F2DTPBD.js} +0 -6
  32. package/dist/chunk-42KTBKL4.js +5053 -0
  33. package/dist/{chunk-DMZER7D5.js → chunk-46ZLBZPE.js} +2 -2
  34. package/dist/{chunk-7UUUV4PN.js → chunk-47JK3BOK.js} +1 -1
  35. package/dist/{chunk-I3PA54IU.js → chunk-4IPKEJPW.js} +1 -1
  36. package/dist/{chunk-MDGNQWFN.js → chunk-5M43Z25X.js} +1 -1
  37. package/dist/{chunk-CHM3QYLF.js → chunk-5OHPI5OR.js} +3 -3
  38. package/dist/{chunk-SOAQ3XXB.js → chunk-5TAFQEKH.js} +2 -2
  39. package/dist/{chunk-XDRSEU2I.js → chunk-6AJG7TMS.js} +6 -6
  40. package/dist/{chunk-G7PITEUH.js → chunk-6MYO2IHD.js} +1 -1
  41. package/dist/{chunk-BMDABBHG.js → chunk-7IVPSA4K.js} +5 -17
  42. package/dist/{chunk-HPKW6UVW.js → chunk-7JCATDO6.js} +3 -3
  43. package/dist/{chunk-JZIEZCQM.js → chunk-7PBJR7WI.js} +5 -12
  44. package/dist/{chunk-O2T6ZTLN.js → chunk-7SUMXO6L.js} +1 -1
  45. package/dist/{chunk-UE2WSWNA.js → chunk-7ZYTAHZ2.js} +1 -1
  46. package/dist/{chunk-YTUPQTXA.js → chunk-A2MYAIM3.js} +10 -10
  47. package/dist/{chunk-A4VXOJZO.js → chunk-A2OQGUBL.js} +3 -3
  48. package/dist/{chunk-YNFHZ4RI.js → chunk-A3CUI2S2.js} +3 -3
  49. package/dist/{chunk-JCJJCYCP.js → chunk-A3MH6DGU.js} +10 -10
  50. package/dist/{chunk-VZQXHYEI.js → chunk-A3UI2LNA.js} +3 -3
  51. package/dist/{chunk-DDDSTRHU.js → chunk-ADAXA5XD.js} +26 -8
  52. package/dist/{chunk-2TBW7UOF.js → chunk-AOZKUVTY.js} +203 -115
  53. package/dist/{chunk-T3GSTIBS.js → chunk-AU6UGZZ4.js} +3 -3
  54. package/dist/{chunk-N6Y645MX.js → chunk-B7GOS2BL.js} +1 -1
  55. package/dist/{chunk-2QTGQGYA.js → chunk-BFXSMYNY.js} +1 -1
  56. package/dist/{chunk-IYLGUQFR.js → chunk-BHOEEMCW.js} +3 -3
  57. package/dist/{chunk-XUDJ5XSQ.js → chunk-BHPPJMXP.js} +6 -6
  58. package/dist/{chunk-REJ4NIBY.js → chunk-BHSQSWN6.js} +1 -1
  59. package/dist/{chunk-MA35E5OY.js → chunk-BTYCPOPD.js} +2 -2
  60. package/dist/{chunk-GHLLC6LJ.js → chunk-CEBLQRYG.js} +2 -2
  61. package/dist/{chunk-2LMCARA5.js → chunk-CI34E4VF.js} +6 -4
  62. package/dist/{chunk-CKJDY6EK.js → chunk-DC7AOIHN.js} +1 -1
  63. package/dist/{chunk-6ZVUTYNB.js → chunk-DLJ6ESP7.js} +6 -6
  64. package/dist/{chunk-23354HMA.js → chunk-DVAKYHZN.js} +3 -3
  65. package/dist/{chunk-B66UZ2YK.js → chunk-DYNIPOEN.js} +6 -6
  66. package/dist/{chunk-R45WFVRA.js → chunk-ECYVLHZZ.js} +2 -2
  67. package/dist/{chunk-W2FSQBUR.js → chunk-EIBERSJ2.js} +14 -14
  68. package/dist/{chunk-EX533ULK.js → chunk-EVMSNLUQ.js} +2 -2
  69. package/dist/{chunk-WYPRTHXQ.js → chunk-EXMJ7JS5.js} +2 -2
  70. package/dist/{chunk-I35B5RWZ.js → chunk-F645WHPZ.js} +4 -4
  71. package/dist/{chunk-ZIYXPDKY.js → chunk-FF6T5VPF.js} +2 -2
  72. package/dist/{chunk-G55YEL2L.js → chunk-FJ4PIVGB.js} +436 -57
  73. package/dist/{chunk-YAS347ZS.js → chunk-FLVHLNQN.js} +1 -1
  74. package/dist/{chunk-HEXTAQYG.js → chunk-FYCI7NEH.js} +2 -2
  75. package/dist/{chunk-6RV2QY4K.js → chunk-G4CQIZZC.js} +23 -23
  76. package/dist/{chunk-BBL6STGK.js → chunk-GHCG2KZD.js} +2 -2
  77. package/dist/{chunk-XVVPEWNX.js → chunk-GPERPLAQ.js} +1 -1
  78. package/dist/{chunk-VQJLTYEK.js → chunk-GT5REDGY.js} +2 -2
  79. package/dist/{chunk-CDI3CCAU.js → chunk-GUYH2XH2.js} +12 -14
  80. package/dist/{chunk-4DLYTSWQ.js → chunk-H3DP5ELI.js} +1 -1
  81. package/dist/chunk-HOIEN7O4.js +31 -0
  82. package/dist/{chunk-4CHGNFCS.js → chunk-I5VIATAH.js} +4 -4
  83. package/dist/{chunk-2B2IMLUQ.js → chunk-I6V25IXG.js} +1 -1
  84. package/dist/{chunk-76KUCQXD.js → chunk-IARWDMY7.js} +3 -3
  85. package/dist/{chunk-KRWPTZBY.js → chunk-IU5DC4HP.js} +94 -42
  86. package/dist/{chunk-PXDRW3QN.js → chunk-J466WOMZ.js} +1 -1
  87. package/dist/{chunk-6QEEF5RR.js → chunk-J54ZPEWO.js} +1 -1
  88. package/dist/{chunk-DGC2RIQE.js → chunk-JN3N335Z.js} +4 -4
  89. package/dist/{chunk-N2C7WJDG.js → chunk-KCIZBYAS.js} +1 -1
  90. package/dist/{chunk-SVI2CJ6R.js → chunk-KCPIENND.js} +1 -1
  91. package/dist/{chunk-W5PW26KE.js → chunk-KEUDODWJ.js} +1 -1
  92. package/dist/{chunk-QWM3NY2E.js → chunk-KKIAPWVZ.js} +4 -4
  93. package/dist/{chunk-ROXILOZ6.js → chunk-KLXPYLNA.js} +2 -2
  94. package/dist/{chunk-3J32XVJ6.js → chunk-LCK6C46G.js} +3 -3
  95. package/dist/{chunk-EVMY7IPL.js → chunk-LD6JONPV.js} +155 -22
  96. package/dist/{chunk-YSHUIQ3I.js → chunk-LO74I6MZ.js} +1 -1
  97. package/dist/{chunk-CNJLBAKM.js → chunk-LQV2PMKI.js} +2 -2
  98. package/dist/{chunk-N7C7U3ZR.js → chunk-M425BL2U.js} +22 -11
  99. package/dist/{chunk-MP36L7OJ.js → chunk-MG6GU4FF.js} +2 -2
  100. package/dist/{chunk-AIC7T7CC.js → chunk-MM5URNHE.js} +2 -2
  101. package/dist/{chunk-PIEVAPKP.js → chunk-MYETYFDI.js} +1 -1
  102. package/dist/{chunk-CHJGVW5W.js → chunk-N36NHUGP.js} +4 -11
  103. package/dist/{chunk-EX7WPDFA.js → chunk-NABIUZRZ.js} +2 -2
  104. package/dist/{chunk-4US5QCXR.js → chunk-NJF566HN.js} +77 -31
  105. package/dist/{chunk-XQWWFIBR.js → chunk-NMQ26YZX.js} +2 -2
  106. package/dist/{chunk-MVIUSNPZ.js → chunk-NQAXN2B2.js} +1 -1
  107. package/dist/{chunk-YDG3OXH3.js → chunk-NQE4NKVE.js} +2 -2
  108. package/dist/{chunk-ETWXZQN5.js → chunk-NTVSXJHQ.js} +2 -2
  109. package/dist/{chunk-U77L3ZQZ.js → chunk-OW5BBEVE.js} +1 -1
  110. package/dist/{chunk-SUXEL7G4.js → chunk-OYCKZZDC.js} +11 -11
  111. package/dist/{chunk-Y5DOT5NQ.js → chunk-PHDEKHEN.js} +1 -1
  112. package/dist/{chunk-KIAY63AB.js → chunk-PIA7JBWF.js} +26 -14
  113. package/dist/{chunk-RGYOCAHC.js → chunk-PP6XMZXN.js} +2 -2
  114. package/dist/{chunk-XFXCI4IP.js → chunk-Q4RX6D2H.js} +2 -2
  115. package/dist/{chunk-4WZU4FYS.js → chunk-QZFKLORI.js} +4 -4
  116. package/dist/{chunk-ADYMQM7T.js → chunk-R43U3RJ3.js} +2 -2
  117. package/dist/{chunk-C2VZ7UPE.js → chunk-RES7SNFU.js} +15 -15
  118. package/dist/{chunk-2RBQLV6B.js → chunk-RK3KWEOM.js} +1 -1
  119. package/dist/{chunk-ZOAANTVI.js → chunk-RZBPK4LO.js} +1 -1
  120. package/dist/{chunk-5GYTBKZA.js → chunk-S5FHA2NX.js} +2 -2
  121. package/dist/{chunk-SWPI27QV.js → chunk-SG4DOSAE.js} +8 -8
  122. package/dist/{chunk-L6BFXQ6S.js → chunk-SJGYWLHO.js} +3 -3
  123. package/dist/{chunk-JSVCF4A6.js → chunk-SM36NR25.js} +2 -2
  124. package/dist/{chunk-WIMVXPYG.js → chunk-SODOJ4CP.js} +11 -11
  125. package/dist/{chunk-ERJBWDPM.js → chunk-SWOE4NH4.js} +6 -6
  126. package/dist/{chunk-4FTJE22M.js → chunk-SZUO4O74.js} +2 -2
  127. package/dist/{chunk-O5CNNVRY.js → chunk-TORIKOIX.js} +8 -8
  128. package/dist/{chunk-TFBPCJPG.js → chunk-U47ZNIUB.js} +1 -1
  129. package/dist/{chunk-NQFIMBXS.js → chunk-UFWTTQ72.js} +2 -2
  130. package/dist/{chunk-FRH3CPW5.js → chunk-V4XLGSUL.js} +1 -1
  131. package/dist/{chunk-XSHJ37U3.js → chunk-VQVA4FRS.js} +8 -8
  132. package/dist/{chunk-HMB3IAVP.js → chunk-VX5JYR6N.js} +2 -2
  133. package/dist/{chunk-GOMTMQRT.js → chunk-VXVDZFZL.js} +1 -1
  134. package/dist/{chunk-MDBEAWP2.js → chunk-VYARX4SV.js} +3 -3
  135. package/dist/{chunk-77UB5EHM.js → chunk-WCSGSWKA.js} +1 -1
  136. package/dist/{chunk-2KYLVWLO.js → chunk-WWKU5VK7.js} +1 -1
  137. package/dist/{chunk-45ZQI734.js → chunk-X47GMPT2.js} +2 -2
  138. package/dist/{chunk-IEEIPTDW.js → chunk-X5BRDEOM.js} +2 -2
  139. package/dist/{chunk-G2XAFJ2B.js → chunk-X73RI4GQ.js} +2 -2
  140. package/dist/{chunk-7LTXT7ME.js → chunk-XAPVWRO5.js} +2 -2
  141. package/dist/{chunk-PNP2BO3U.js → chunk-XKL3WQI2.js} +3 -3
  142. package/dist/{chunk-RCB4SGTB.js → chunk-XODMUHGW.js} +50 -13
  143. package/dist/{chunk-HZTRKUKE.js → chunk-XWK2RSD5.js} +37 -0
  144. package/dist/{chunk-SIGASWB7.js → chunk-Y6U6DDBC.js} +4 -4
  145. package/dist/chunk-YFC5II7G.js +143 -0
  146. package/dist/chunk-YHJOTCTV.js +16 -0
  147. package/dist/{chunk-VKZSAAXZ.js → chunk-YUG4GVRH.js} +4 -4
  148. package/dist/{chunk-GBIASKIH.js → chunk-Z7VKBKC3.js} +1 -1
  149. package/dist/{chunk-OD7PLYYX.js → chunk-ZKGDIPMD.js} +32 -23
  150. package/dist/{chunk-LIWK3MFR.js → chunk-ZLTB7ZCQ.js} +6 -6
  151. package/dist/{chunk-5RVPI6QL.js → chunk-ZOL6363C.js} +3 -3
  152. package/dist/{clean-3IN64RHM.js → clean-MTIRQX5P.js} +28 -28
  153. package/dist/cli.js +66 -65
  154. package/dist/{cloud-LBUZBUP6.js → cloud-MWZ3SO3Z.js} +4 -4
  155. package/dist/{cloud-SVYXHFEG.js → cloud-SXXNSICW.js} +3 -3
  156. package/dist/{cloudrun-PZOF2QGL.js → cloudrun-7ZLJG5K7.js} +8 -8
  157. package/dist/{compare-UOJ3LXQQ.js → compare-336QVVJC.js} +42 -42
  158. package/dist/{compiler-5ZDHBKBQ.js → compiler-HYZUBDAD.js} +6 -6
  159. package/dist/{component-EVIPLTTJ.js → component-NEPVQVDF.js} +4 -4
  160. package/dist/{compositions-R4GG5FBO.js → compositions-5UXCOLME.js} +15 -15
  161. package/dist/{contactSheet-HZMP42FZ.js → contactSheet-3YTXO7U5.js} +4 -4
  162. package/dist/{curve-LR3PSRW3.js → curve-GDAFPSYA.js} +14 -14
  163. package/dist/{cuts-DHCOBAFT.js → cuts-U5XZJLGG.js} +15 -15
  164. package/dist/{delete-MMGGU3QP.js → delete-G4U723IG.js} +7 -7
  165. package/dist/{deploy-SKIGUTM2.js → deploy-ZJ6GBOAW.js} +2 -2
  166. package/dist/{describeProject-L7HNTBPV.js → describeProject-NOXO6HJS.js} +11 -11
  167. package/dist/{destroy-5HSMMDH7.js → destroy-ZYOIJW7D.js} +2 -2
  168. package/dist/{deterministicFonts-2ZPRAI3C.js → deterministicFonts-UDNPRDYM.js} +4 -4
  169. package/dist/{diff-KR7VKPYL.js → diff-NZ7IBYWS.js} +36 -36
  170. package/dist/{dist-3MFNUZSN.js → dist-CF7A6UPR.js} +3 -3
  171. package/dist/{dist-ZGYPFYOH.js → dist-I3WOJFIM.js} +4 -4
  172. package/dist/{dist-HK3AZNNL.js → dist-YSFMNDNF.js} +26 -23
  173. package/dist/{doctor-G7VGNSA5.js → doctor-OAEXYBD5.js} +17 -17
  174. package/dist/{energy-H7EEH6WO.js → energy-36Y2RVKN.js} +15 -15
  175. package/dist/{events-YD6N7OPQ.js → events-7MO6VYY5.js} +7 -7
  176. package/dist/{events-ASG27IXP.js → events-BN5A4QSC.js} +17 -17
  177. package/dist/{events-5ATZCZTK.js → events-OY5PAL44.js} +2 -2
  178. package/dist/{execute-OAS454OB.js → execute-6QR32QHM.js} +34 -34
  179. package/dist/{extract-645SENLA.js → extract-GS4GFBJ4.js} +15 -15
  180. package/dist/{face-WRT5XH4I.js → face-DXIURLMN.js} +16 -16
  181. package/dist/{feedback-3LKLR5MV.js → feedback-L5B5D2H4.js} +14 -14
  182. package/dist/{ffmpeg-PXKIZL2X.js → ffmpeg-RO3TC7DT.js} +10 -10
  183. package/dist/{figma-RIEVJJBW.js → figma-YSLP3NDJ.js} +3 -3
  184. package/dist/fontLocalizeCli.js +18 -17
  185. package/dist/{frames-OTB3J5W3.js → frames-NNGPW5Q5.js} +17 -17
  186. package/dist/{generate-IUKCZW2D.js → generate-IYY5CQKF.js} +26 -26
  187. package/dist/{get-6WVQ7TBV.js → get-GHTMJWAX.js} +7 -7
  188. package/dist/{gpuPolicy-HXSVAEU4.js → gpuPolicy-UGUQTJXT.js} +10 -10
  189. package/dist/{grade-compare-TCAYHDEF.js → grade-compare-HMQIS6CO.js} +41 -41
  190. package/dist/hangReport.js +2 -1
  191. package/dist/{heifImagePrep-GXIMK4HK.js → heifImagePrep-6CHEBOTB.js} +11 -11
  192. package/dist/{help-RGOL5EJD.js → help-M6V73NMA.js} +1 -1
  193. package/dist/{history-XKPRGJGS.js → history-JLNS7C6E.js} +15 -15
  194. package/dist/hyperframe.manifest.json +1 -1
  195. package/dist/hyperframe.runtime.iife.js +64 -64
  196. package/dist/hyperframes-player.global.js +1 -1
  197. package/dist/{info-EYBBC42V.js → info-VHVWJBZ5.js} +17 -17
  198. package/dist/{init-F2FWPSMA.js → init-RAWSPX3T.js} +33 -33
  199. package/dist/{ink-BWFERAAT.js → ink-R2VCYLF3.js} +15 -15
  200. package/dist/{inspect-74N7L3BW.js → inspect-ODGFUWRM.js} +41 -41
  201. package/dist/{installer-LOUR7G4R.js → installer-YAJDSTNZ.js} +8 -8
  202. package/dist/{keyframes-WB5PTKFE.js → keyframes-MWS46OMG.js} +11 -11
  203. package/dist/{lambda-JYCNXUKB.js → lambda-EPIPZ62Q.js} +17 -17
  204. package/dist/{layout-P52EVR24.js → layout-IVOS3PHW.js} +41 -41
  205. package/dist/{lint-SL55KAS2.js → lint-G3XW5PVR.js} +13 -13
  206. package/dist/{lintProject-46WU53VC.js → lintProject-L42FF7XI.js} +3 -3
  207. package/dist/{list-LN6CQH52.js → list-25OWFBNT.js} +8 -8
  208. package/dist/{localPage-L6OJU3UH.js → localPage-PAUE6E6K.js} +11 -11
  209. package/dist/{login-WTOAMDID.js → login-EHL5EH3E.js} +4 -4
  210. package/dist/{look-O6ESLJRP.js → look-H2AAYHQC.js} +15 -15
  211. package/dist/{manager-IAXYSRG5.js → manager-DLEEPJVW.js} +2 -1
  212. package/dist/{manager-CMEZWENF.js → manager-T3FIJKIL.js} +11 -11
  213. package/dist/{measure-NEIXU53P.js → measure-IAGLDGL2.js} +11 -11
  214. package/dist/{media-treatment-6CAQG7MU.js → media-treatment-F53Y4K2K.js} +17 -17
  215. package/dist/{media-use-IXJFMKU7.js → media-use-7XRQIXDO.js} +22 -7
  216. package/dist/{models-TZALWUEY.js → models-UA72SFBG.js} +16 -16
  217. package/dist/{motionShot-OQYK6G6M.js → motionShot-WRHPBYSX.js} +22 -22
  218. package/dist/{normalize-audio-43PJLOBY.js → normalize-audio-6UO7T2NP.js} +14 -14
  219. package/dist/{open-EOX6QY4M.js → open-DVABOI2D.js} +19 -19
  220. package/dist/{parakeetRunner-STHAXQAF.js → parakeetRunner-IHEW335J.js} +18 -18
  221. package/dist/{pipeline-RRWZHFBQ.js → pipeline-SGJTBYFI.js} +13 -13
  222. package/dist/{plan-JWUSMF4W.js → plan-IB2LZKFH.js} +26 -26
  223. package/dist/{play-TUKTST32.js → play-OSJU47PB.js} +31 -31
  224. package/dist/{preflight-L42JKT6F.js → preflight-4UVA2SF4.js} +12 -12
  225. package/dist/{present-Z7HRDXPV.js → present-6HRJ67G2.js} +25 -25
  226. package/dist/{preview-HGTIRAV3.js → preview-ILIRTOIL.js} +59 -35
  227. package/dist/{probe-RXK44FY7.js → probe-QJIEY5RM.js} +15 -15
  228. package/dist/{producer-KJ2RZDJ3.js → producer-LUARVB5B.js} +1 -1
  229. package/dist/{projectConfig-K36NTJXP.js → projectConfig-CS4PKLO5.js} +11 -11
  230. package/dist/{publication-OZWLT6K6.js → publication-DQMOW7B4.js} +6 -6
  231. package/dist/{publish-CRUTXNYM.js → publish-TSZA3TYC.js} +19 -19
  232. package/dist/{remove-background-R37HZPCG.js → remove-background-URZDLZJ4.js} +14 -14
  233. package/dist/{render-ZHCPCISN.js → render-3HONOYZE.js} +49 -49
  234. package/dist/{render-SU2XTMJL.js → render-OHACUI7J.js} +8 -8
  235. package/dist/{render-EZMKBT7V.js → render-RDFQDDZA.js} +37 -37
  236. package/dist/{render-batch-YIUOEAAL.js → render-batch-EUKAQFHN.js} +8 -8
  237. package/dist/renderSetupWorker.js +6 -5
  238. package/dist/{resolver-DLCKRKQR.js → resolver-BTUTJ26S.js} +8 -8
  239. package/dist/{reverse-4FAVXIER.js → reverse-LTPJ6QRV.js} +1 -1
  240. package/dist/{run-H4GVEJVS.js → run-SIBZZM3T.js} +4 -4
  241. package/dist/{screenshotCapture-CQF5FYVI.js → screenshotCapture-2VXR5FHK.js} +13 -13
  242. package/dist/{service-XDQOULGD.js → service-47AZQ6EN.js} +14 -14
  243. package/dist/{share-CUCQALE7.js → share-4JJK6QM6.js} +19 -19
  244. package/dist/{sherpa-WZNRQUVC.js → sherpa-WDGLCJMP.js} +17 -17
  245. package/dist/sherpaWorker.js +4 -2
  246. package/dist/skills/hyperframes/references/plugin-installation.md +5 -2
  247. package/dist/skills/hyperframes/scripts/bake-basemap.mjs +1 -0
  248. package/dist/skills/hyperframes/scripts/lib/windows-exe-search.mjs +11 -0
  249. package/dist/skills/hyperframes/scripts/lib/windows-exe-search.test.mjs +149 -0
  250. package/dist/skills/hyperframes/scripts/locate.mjs +1 -0
  251. package/dist/skills/hyperframes/scripts/plugin-cli.mjs +21 -3
  252. package/dist/skills/hyperframes/scripts/plugin-cli.test.mjs +93 -7
  253. package/dist/skills/hyperframes-cli/references/doctor-browser.md +1 -1
  254. package/dist/skills/media-use/audio/scripts/carve.mjs +1 -0
  255. package/dist/skills/media-use/audio/scripts/extract-audio-data.py +3 -1
  256. package/dist/skills/media-use/audio/scripts/gemini-pipeline.test.mjs +6 -6
  257. package/dist/skills/media-use/audio/scripts/lib/bgm.mjs +1 -0
  258. package/dist/skills/media-use/audio/scripts/lib/gemini-auth.mjs +1 -0
  259. package/dist/skills/media-use/audio/scripts/lib/python.mjs +1 -0
  260. package/dist/skills/media-use/audio/scripts/lib/recording.mjs +1 -0
  261. package/dist/skills/media-use/audio/scripts/lib/tts.cleanup.test.mjs +12 -6
  262. package/dist/skills/media-use/audio/scripts/lib/tts.mjs +26 -6
  263. package/dist/skills/media-use/audio/scripts/lib/tts.spawn.test.mjs +37 -12
  264. package/dist/skills/media-use/audio/scripts/lib/tts.test.mjs +54 -18
  265. package/dist/skills/media-use/audio/scripts/trusted-program.test.mjs +106 -0
  266. package/dist/skills/media-use/audio/scripts/trusted_program.py +76 -0
  267. package/dist/skills/media-use/references/audio.md +2 -0
  268. package/dist/skills/media-use/references/operations.md +2 -1
  269. package/dist/skills/media-use/scripts/dither.mjs +1 -0
  270. package/dist/skills/media-use/scripts/eval.mjs +1 -0
  271. package/dist/skills/media-use/scripts/lib/npx-sync.test.mjs +22 -31
  272. package/dist/skills/media-use/scripts/lib/tts-local-provider.mjs +16 -11
  273. package/dist/skills/media-use/scripts/lib/tts-local-provider.test.mjs +34 -78
  274. package/dist/skills/media-use/scripts/lib/windows-exe-search.mjs +11 -0
  275. package/dist/skills/media-use/scripts/resolve-plugin.test.mjs +43 -19
  276. package/dist/skills/media-use/scripts/transcribe.mjs +1 -0
  277. package/dist/skills/media-use/scripts/transcribe.test.mjs +60 -17
  278. package/dist/skills/media-use/scripts/transcript-cut.mjs +1 -0
  279. package/dist/{skills-J52DBZAK.js → skills-32PFTMRC.js} +10 -10
  280. package/dist/{skillsUpdateCheck-26DJHBTC.js → skillsUpdateCheck-4YNSO2QT.js} +3 -3
  281. package/dist/{snapshot-ZIRQFDA7.js → snapshot-L26W46YP.js} +53 -53
  282. package/dist/{src-C3XYMTF4.js → src-KJ7FMIH7.js} +11 -9
  283. package/dist/{src-7BGBN6SS.js → src-SGZPUKDL.js} +15 -15
  284. package/dist/{start-QG2XNMYN.js → start-77AN6NW5.js} +24 -24
  285. package/dist/{staticProjectServer-TWMEFK3T.js → staticProjectServer-RDXGUNKX.js} +27 -27
  286. package/dist/{status-3UPA5WPI.js → status-BRVZZRTC.js} +18 -17
  287. package/dist/studio/assets/{codec-qz1-OXLj.js → codec-GKrIfefq.js} +1 -1
  288. package/dist/studio/assets/{hyperframes-player-2eG1zFX5.js → hyperframes-player-BUFkdSG-.js} +1 -1
  289. package/dist/studio/assets/{index-DDmhnfrS.js → index-BzrZjoXW.js} +159 -159
  290. package/dist/studio/assets/{index-DUveJ_YP.js → index-oGGylite.js} +1 -1
  291. package/dist/studio/assets/{pausedVideoDecoder-CoHTKUjM.js → pausedVideoDecoder-VUkpOCb9.js} +1 -1
  292. package/dist/studio/index.html +1 -1
  293. package/dist/{studio-api-Z42OO4JJ.js → studio-api-UZHSY6PR.js} +26 -23
  294. package/dist/{studioServer-SMN3RMVL.js → studioServer-UOVV7CDW.js} +126 -79
  295. package/dist/{sync-ONTI2WSI.js → sync-74O4W75V.js} +15 -15
  296. package/dist/{synthesize-FR5KPBRP.js → synthesize-7DD5JV36.js} +5 -4
  297. package/dist/{telemetry-RRXALB5D.js → telemetry-NB5MWICG.js} +7 -7
  298. package/dist/{templates-BHFOSD6F.js → templates-HOIYYCM2.js} +15 -15
  299. package/dist/{timeline-Z5IHY5TN.js → timeline-NUG347GZ.js} +26 -26
  300. package/dist/{tokens-MZVEPARM.js → tokens-TVAYON5K.js} +3 -3
  301. package/dist/{transcribe-M5N3YZZU.js → transcribe-3RN5NRX6.js} +14 -14
  302. package/dist/{transcribe-5IZS4BGW.js → transcribe-67A5YVQD.js} +31 -31
  303. package/dist/{tts-ZE776B4I.js → tts-SOSATBP4.js} +2 -2
  304. package/dist/{update-EVPWBIKY.js → update-QEVNP7XN.js} +12 -12
  305. package/dist/{updateCheck-2UUEF6TC.js → updateCheck-SZ6BPLHI.js} +2 -2
  306. package/dist/{upgrade-DK45FD4K.js → upgrade-NFDDBX2T.js} +5 -5
  307. package/dist/{urlDownloader-3MPHIDSA.js → urlDownloader-Q7225DS7.js} +9 -9
  308. package/dist/{validate-W27TQ367.js → validate-IMI6OBMO.js} +33 -33
  309. package/dist/{video-TI372QGV.js → video-K7UAJJLP.js} +12 -12
  310. package/dist/{voices-FZV4PGT6.js → voices-K2GLTRAS.js} +24 -24
  311. package/dist/warmCheck.js +52 -51
  312. package/dist/warmCheckClient.js +2 -1
  313. package/package.json +1 -1
  314. package/dist/chunk-64F653HO.js +0 -164
  315. package/dist/chunk-WXOOAAT4.js +0 -314
  316. package/dist/chunk-XDDBSGBD.js +0 -5049
@@ -56,7 +56,7 @@ npx hyperframes doctor --json
56
56
 
57
57
  Set both variables in the environment that launches HyperFrames. On Windows, point them at `ffmpeg.exe` and `ffprobe.exe` using your shell's environment-variable syntax. A configured path takes precedence over automatic discovery; a missing configured file is reported as missing.
58
58
 
59
- Alternatively, put the binaries in `.hyperframes/bin/ffmpeg` and `.hyperframes/bin/ffprobe` (`.exe` on Windows), then run HyperFrames from that project's directory. Discovery checks `PATH` before this project-local directory, so use the environment variables when you need a particular build.
59
+ Automatic discovery never runs an FFmpeg or FFprobe that sits inside the project folder or the working directory, such as `.hyperframes/bin` or a project's `@ffmpeg-installer` package, since a project can come from anyone. Keep the binaries outside the project and either set the variables above or add their folder to `PATH` as an absolute path.
60
60
 
61
61
  Verify the **FFmpeg** and **FFprobe** entries in `doctor --json` report `ok: true` and the expected paths. To gate only these encoding dependencies with `jq`:
62
62
 
@@ -24,6 +24,7 @@
24
24
  * there.
25
25
  */
26
26
 
27
+ import "../../scripts/lib/windows-exe-search.mjs";
27
28
  import { execFileSync } from "node:child_process";
28
29
  import { createRequire } from "node:module";
29
30
  import { readFileSync, writeFileSync } from "node:fs";
@@ -22,6 +22,8 @@ import sys
22
22
 
23
23
  import numpy as np
24
24
 
25
+ from trusted_program import find_program
26
+
25
27
  # Windows sizes stdio to the ANSI code page (cp1252). These scripts emit UTF-8 on
26
28
  # every platform; say so rather than depending on the console's code page. Carry
27
29
  # `errors` across: reconfigure() resets it to "strict", and CPython deliberately gives
@@ -51,7 +53,7 @@ MAX_FREQ = 16000.0
51
53
  def decode_audio(path: str) -> np.ndarray:
52
54
  """Decode audio to mono float32 samples via ffmpeg."""
53
55
  cmd = [
54
- "ffmpeg", "-i", path,
56
+ find_program("ffmpeg"), "-i", path,
55
57
  "-vn", "-ac", "1", "-ar", str(SAMPLE_RATE),
56
58
  "-f", "s16le", "-acodec", "pcm_s16le",
57
59
  "-loglevel", "error",
@@ -47,21 +47,20 @@ globalThis.fetch = async (url, options) => {
47
47
  };
48
48
  `,
49
49
  );
50
+ const cli = join(bin, "cli.cjs");
50
51
  writeFileSync(
51
- join(bin, "npx"),
52
- `#!${process.execPath}
53
- const assert = require('node:assert/strict');
52
+ cli,
53
+ `const assert = require('node:assert/strict');
54
54
  const fs = require('node:fs');
55
55
  const path = require('node:path');
56
56
  const args = process.argv.slice(2);
57
- assert.deepEqual(args.slice(0, 3), ['hyperframes', 'transcribe', '${voicePath}']);
58
- assert.ok(fs.existsSync(args[2]));
57
+ assert.deepEqual(args.slice(0, 2), ['transcribe', '${voicePath}']);
58
+ assert.ok(fs.existsSync(args[1]));
59
59
  assert.equal(args[args.indexOf('--model')+1], 'small.en');
60
60
  fs.writeFileSync(path.join(args[args.indexOf('--dir')+1], 'transcript.json'), JSON.stringify([
61
61
  {text:'Hello',start:0.1,end:0.4}, {text:'there.',start:0.5,end:0.9}
62
62
  ]));
63
63
  `,
64
- { mode: 0o755 },
65
64
  );
66
65
  writeFileSync(join(bin, "ffprobe"), "#!/bin/sh\necho 1.25\n", { mode: 0o755 });
67
66
  writeFileSync(join(dir, ".env"), "");
@@ -95,6 +94,7 @@ fs.writeFileSync(path.join(args[args.indexOf('--dir')+1], 'transcript.json'), JS
95
94
  HYPERFRAMES_API_KEY: "",
96
95
  GEMINI_API_KEY: "fixture-key",
97
96
  PATH: `${bin}:${process.env.PATH}`,
97
+ HYPERFRAMES_CLI_ENTRY: cli,
98
98
  },
99
99
  },
100
100
  );
@@ -11,6 +11,7 @@
11
11
  //
12
12
  // Missing/failed BGM never blocks a render.
13
13
 
14
+ import "../../../scripts/lib/windows-exe-search.mjs";
14
15
  import { spawn, spawnSync } from "node:child_process";
15
16
  import { existsSync, mkdirSync, openSync, closeSync, rmSync } from "node:fs";
16
17
  import { join } from "node:path";
@@ -1,3 +1,4 @@
1
+ import "../../../scripts/lib/windows-exe-search.mjs";
1
2
  import { spawnSync } from "node:child_process";
2
3
  import { fileURLToPath } from "node:url";
3
4
  import { pythonInvocation } from "./python.mjs";
@@ -15,6 +15,7 @@
15
15
  // `HYPERFRAMES_PYTHON` (the documented PEP 668 venv setup) wins over the PATH probe, matching
16
16
  // the CLI's `findPython()`; ignoring it made BGM silently disable itself (#4614).
17
17
 
18
+ import "../../../scripts/lib/windows-exe-search.mjs";
18
19
  import { spawnSync } from "node:child_process";
19
20
 
20
21
  // Accept only an interpreter whose `--version` reports Python 3, as the CLI's
@@ -1,5 +1,6 @@
1
1
  // recording.mjs — the person's own voice recording as a voice line: converted to the engine's wav,
2
2
  // time-stretched by `speed` with the pitch kept, with word timings scaled to match.
3
+ import "../../../scripts/lib/windows-exe-search.mjs";
3
4
  import { spawnSync } from "node:child_process";
4
5
  import { existsSync, mkdirSync } from "node:fs";
5
6
  import { dirname } from "node:path";
@@ -95,8 +95,10 @@ if (["allocation", "write", "spawn-throw"].includes(mode)) {
95
95
  const result = await request();
96
96
  const label = provider === "elevenlabs" ? "elevenlabs (python)" : "kokoro (npx hyperframes tts)";
97
97
  if (["nonzero", "enoent", "no-output"].includes(mode)) {
98
+ // Kokoro runs the handed-over CLI with this Node, so a missing CLI file exits 1, not ENOENT.
99
+ const missing = provider === "kokoro" ? 1 : -1;
98
100
  const error = mode === "no-output" ? label + " produced no wav file" :
99
- label + " exited with status " + (mode === "enoent" ? -1 : 7);
101
+ label + " exited with status " + (mode === "enoent" ? missing : 7);
100
102
  assert.deepEqual(result, { ok: false, words: null, error });
101
103
  assert.equal(fs.existsSync(wavAbs), false);
102
104
  } else {
@@ -120,11 +122,14 @@ function runCase(provider, mode) {
120
122
  try {
121
123
  for (const dir of ["home", "tmp", "bin", "project"]) mkdirSync(join(root, dir));
122
124
  if (mode !== "enoent") {
123
- for (const name of ["npx", "python3"]) {
124
- const executable = join(root, "bin", name);
125
- writeFileSync(executable, stub);
126
- chmodSync(executable, 0o755);
127
- }
125
+ const python = join(root, "bin", "python3");
126
+ writeFileSync(python, stub);
127
+ chmodSync(python, 0o755);
128
+ // The handed-over CLI sees `tts <text file> ...`; the shared stub reads npx-style argv.
129
+ writeFileSync(
130
+ join(root, "bin", "cli.cjs"),
131
+ 'process.argv.splice(2, 0, "hyperframes");\nrequire("./python3");\n',
132
+ );
128
133
  }
129
134
  const result = spawnSync(process.execPath, ["--input-type=module", "-e", exercise], {
130
135
  encoding: "utf8",
@@ -136,6 +141,7 @@ function runCase(provider, mode) {
136
141
  TMP: join(root, "tmp"),
137
142
  TEMP: join(root, "tmp"),
138
143
  PATH: join(root, "bin"),
144
+ HYPERFRAMES_CLI_ENTRY: join(root, "bin", "cli.cjs"),
139
145
  CASE_ROOT: root,
140
146
  CASE_PROVIDER: provider,
141
147
  CASE_MODE: mode,
@@ -1,3 +1,4 @@
1
+ import "../../../scripts/lib/windows-exe-search.mjs";
1
2
  import { fetchMedia } from "../../../scripts/lib/media-fetch.mjs";
2
3
  import { refuseUnderLimit } from "../../../scripts/lib/credit-limit.mjs";
3
4
  // tts.mjs — multi-provider TTS for the media audio engine. The provider chain,
@@ -146,11 +147,18 @@ export function resolveNpxCliPath(
146
147
  return pathExists(besideNode) ? besideNode : null;
147
148
  }
148
149
 
149
- // A HyperFrames CLI that launches this code hands over its own entry file, so `npx hyperframes`
150
- // runs that same build with the same Node instead of whatever npx resolves from the project.
150
+ export const MISSING_CLI_MESSAGE =
151
+ "No HyperFrames CLI was handed to this helper, and it does not look one up in the project. " +
152
+ "Run the helper through the plugin launcher (`plugin-cli.mjs --script <helper> ...`), or set " +
153
+ "HYPERFRAMES_CLI_ENTRY to the absolute path of your installed CLI's bin/hyperframes.mjs.";
154
+
155
+ // The HyperFrames CLI or plugin launcher that starts this code hands over its own entry file, so
156
+ // `npx hyperframes` runs that same CLI with the same Node. Without one it fails rather than
157
+ // letting npx resolve `hyperframes` from the project.
151
158
  function launchingCliCommand(cmd, args, env = process.env) {
159
+ if (cmd !== "npx" || args[0] !== "hyperframes") return null;
152
160
  const entry = env.HYPERFRAMES_CLI_ENTRY;
153
- if (cmd !== "npx" || args[0] !== "hyperframes" || !entry || !isAbsolute(entry)) return null;
161
+ if (!entry || !isAbsolute(entry)) throw new Error(MISSING_CLI_MESSAGE);
154
162
  return { cmd: process.execPath, args: [entry, ...args.slice(1).map((arg) => String(arg))] };
155
163
  }
156
164
 
@@ -186,9 +194,11 @@ export function resolveSpawnCommand(
186
194
  // (its ESM exports are non-configurable, so mock.method can't patch it).
187
195
  // One-shot so a whole batch of TTS lines doesn't repeat the same diagnostic.
188
196
  let _warnedNpxResolution = false;
189
- /** Test-only: reset the one-shot npx-resolution warning latch. */
197
+ let _warnedMissingCli = false;
198
+ /** Test-only: reset the one-shot npx-resolution warning latches. */
190
199
  export function _resetNpxResolutionWarnForTests() {
191
200
  _warnedNpxResolution = false;
201
+ _warnedMissingCli = false;
192
202
  }
193
203
 
194
204
  export function spawnP(
@@ -200,7 +210,16 @@ export function spawnP(
200
210
  env = process.env,
201
211
  pathExists = existsSync,
202
212
  ) {
203
- const resolved = resolveSpawnCommand(cmd, args, opts, platform, env, pathExists);
213
+ let resolved;
214
+ try {
215
+ resolved = resolveSpawnCommand(cmd, args, opts, platform, env, pathExists);
216
+ } catch (error) {
217
+ if (!_warnedMissingCli) {
218
+ _warnedMissingCli = true;
219
+ console.error(`[media-use] ${error.message}`);
220
+ }
221
+ return Promise.resolve({ status: -1, error: error.message });
222
+ }
204
223
  if (!resolved) {
205
224
  // resolveSpawnCommand only returns null for the npx-on-win32 case where
206
225
  // neither npm's configured CLI nor the beside-node fallback exists. Without
@@ -307,7 +326,8 @@ export async function synthesizeOne({
307
326
  export function synthResult(r, wavAbs, label) {
308
327
  if (r.status === 0 && existsSync(wavAbs)) return { ok: true, words: null };
309
328
  const why =
310
- r.status !== 0 ? `${label} exited with status ${r.status}` : `${label} produced no wav file`;
329
+ r.error ??
330
+ (r.status !== 0 ? `${label} exited with status ${r.status}` : `${label} produced no wav file`);
311
331
  return { ok: false, words: null, error: why };
312
332
  }
313
333
 
@@ -46,7 +46,7 @@ test("resolveNpxCliPath finds npx-cli beside node when npm_execpath is unset", (
46
46
  test("resolveSpawnCommand routes npx through node+npx-cli on win32 without shell:true", () => {
47
47
  const resolved = resolveSpawnCommand(
48
48
  "npx",
49
- ["hyperframes", "tts", "C:\\Users\\Test User\\line.txt", "--voice", "am_michael"],
49
+ ["example-tool", "tts", "C:\\Users\\Test User\\line.txt", "--voice", "am_michael"],
50
50
  {},
51
51
  "win32",
52
52
  envWithNpxCli,
@@ -56,7 +56,7 @@ test("resolveSpawnCommand routes npx through node+npx-cli on win32 without shell
56
56
  assert.equal(resolved.cmd, envWithNpxCli.npm_node_execpath);
57
57
  assert.deepEqual(resolved.args, [
58
58
  npxCliPath,
59
- "hyperframes",
59
+ "example-tool",
60
60
  "tts",
61
61
  "C:\\Users\\Test User\\line.txt",
62
62
  "--voice",
@@ -68,21 +68,21 @@ test("resolveSpawnCommand routes npx through node+npx-cli on win32 without shell
68
68
  test("resolveSpawnCommand preserves Windows npx shell metacharacters as argv data", () => {
69
69
  const resolved = resolveSpawnCommand(
70
70
  "npx",
71
- ["hyperframes", "tts", "hello & calc"],
71
+ ["example-tool", "tts", "hello & calc"],
72
72
  {},
73
73
  "win32",
74
74
  envWithNpxCli,
75
75
  pathExists,
76
76
  );
77
77
  assert.ok(resolved);
78
- assert.deepEqual(resolved.args, [npxCliPath, "hyperframes", "tts", "hello & calc"]);
78
+ assert.deepEqual(resolved.args, [npxCliPath, "example-tool", "tts", "hello & calc"]);
79
79
  });
80
80
 
81
81
  test("spawnP uses the resolved node+npx-cli command for npx on win32", async () => {
82
82
  const captured = [];
83
83
  await spawnP(
84
84
  "npx",
85
- ["hyperframes", "tts"],
85
+ ["example-tool", "tts"],
86
86
  {},
87
87
  "win32",
88
88
  fakeSpawn(captured),
@@ -91,15 +91,15 @@ test("spawnP uses the resolved node+npx-cli command for npx on win32", async ()
91
91
  );
92
92
  assert.equal(captured.length, 1);
93
93
  assert.equal(captured[0].cmd, envWithNpxCli.npm_node_execpath);
94
- assert.deepEqual(captured[0].args, [npxCliPath, "hyperframes", "tts"]);
94
+ assert.deepEqual(captured[0].args, [npxCliPath, "example-tool", "tts"]);
95
95
  assert.equal(captured[0].opts.shell, undefined);
96
96
  });
97
97
 
98
98
  test("spawnP does not enable shell for npx on darwin/linux", async () => {
99
99
  const captured = [];
100
- await spawnP("npx", ["hyperframes", "tts"], {}, "darwin", fakeSpawn(captured));
100
+ await spawnP("npx", ["example-tool", "tts"], {}, "darwin", fakeSpawn(captured));
101
101
  assert.equal(captured[0].cmd, "npx");
102
- assert.deepEqual(captured[0].args, ["hyperframes", "tts"]);
102
+ assert.deepEqual(captured[0].args, ["example-tool", "tts"]);
103
103
  assert.equal(captured[0].opts.shell, undefined);
104
104
  });
105
105
 
@@ -118,7 +118,7 @@ test("spawnP resolves npx beside node when npm_execpath is unset on win32", asyn
118
118
  const npxCli = "C:/Program Files/nodejs/node_modules/npm/bin/npx-cli.js";
119
119
  const result = await spawnP(
120
120
  "npx",
121
- ["hyperframes", "tts"],
121
+ ["example-tool", "tts"],
122
122
  {},
123
123
  "win32",
124
124
  fakeSpawn(captured),
@@ -128,7 +128,7 @@ test("spawnP resolves npx beside node when npm_execpath is unset on win32", asyn
128
128
  assert.equal(result.status, 0);
129
129
  assert.equal(captured.length, 1);
130
130
  assert.equal(captured[0].cmd, node);
131
- assert.deepEqual(captured[0].args, [npxCli, "hyperframes", "tts"]);
131
+ assert.deepEqual(captured[0].args, [npxCli, "example-tool", "tts"]);
132
132
  });
133
133
 
134
134
  test("spawnP warns once with an accurate diagnostic when neither npx path exists", async () => {
@@ -140,12 +140,12 @@ test("spawnP warns once with an accurate diagnostic when neither npx path exists
140
140
  const env = { npm_execpath: "C:/missing/npm-cli.js", npm_node_execpath: "C:/node/node.exe" };
141
141
  const missing = () => false;
142
142
  assert.equal(
143
- (await spawnP("npx", ["hyperframes", "tts"], {}, "win32", fakeSpawn([]), env, missing))
143
+ (await spawnP("npx", ["example-tool", "tts"], {}, "win32", fakeSpawn([]), env, missing))
144
144
  .status,
145
145
  -1,
146
146
  );
147
147
  assert.equal(
148
- (await spawnP("npx", ["hyperframes", "tts"], {}, "win32", fakeSpawn([]), env, missing))
148
+ (await spawnP("npx", ["example-tool", "tts"], {}, "win32", fakeSpawn([]), env, missing))
149
149
  .status,
150
150
  -1,
151
151
  );
@@ -156,3 +156,28 @@ test("spawnP warns once with an accurate diagnostic when neither npx path exists
156
156
  assert.match(errors[0], /npm_execpath \(C:\/missing\/npm-cli\.js\)/);
157
157
  assert.doesNotMatch(errors[0], /npm_execpath is not set/);
158
158
  });
159
+
160
+ test("npx hyperframes runs the CLI handed over in HYPERFRAMES_CLI_ENTRY on every platform", () => {
161
+ for (const platform of ["darwin", "linux", "win32"]) {
162
+ const env = { ...envWithNpxCli, HYPERFRAMES_CLI_ENTRY: "/opt/hf/bin/hyperframes.mjs" };
163
+ const resolved = resolveSpawnCommand(
164
+ "npx",
165
+ ["hyperframes", "tts", "a & b"],
166
+ {},
167
+ platform,
168
+ env,
169
+ pathExists,
170
+ );
171
+ assert.equal(resolved.cmd, process.execPath);
172
+ assert.deepEqual(resolved.args, ["/opt/hf/bin/hyperframes.mjs", "tts", "a & b"]);
173
+ }
174
+ });
175
+
176
+ test("npx hyperframes without a handed-over CLI throws the fix instead of resolving it", () => {
177
+ for (const env of [{}, { HYPERFRAMES_CLI_ENTRY: "bin/hyperframes.mjs" }]) {
178
+ assert.throws(
179
+ () => resolveSpawnCommand("npx", ["hyperframes", "tts"], {}, "darwin", env, pathExists),
180
+ /HYPERFRAMES_CLI_ENTRY/,
181
+ );
182
+ }
183
+ });
@@ -18,6 +18,8 @@ import {
18
18
  synthesizeHeygen,
19
19
  synthResult,
20
20
  pickProvider,
21
+ transcribeWav,
22
+ _resetNpxResolutionWarnForTests,
21
23
  } from "./tts.mjs";
22
24
 
23
25
  test("parseFfmpegDurationBanner reads ffmpeg's stderr Duration line", () => {
@@ -165,17 +167,20 @@ test("synthResult names a non-zero subprocess exit", () => {
165
167
  assert.match(res.error, /kokoro .* exited with status 2/);
166
168
  });
167
169
 
168
- // Kokoro shells out to `npx hyperframes tts`; a fake npx on PATH records the argv
169
- // synthesizeOne really builds, so a dropped flag fails here. Windows runs npx via
170
- // node directly, so the stub never resolves there.
170
+ // Kokoro runs `hyperframes tts` through the CLI its caller hands over in HYPERFRAMES_CLI_ENTRY; a
171
+ // fake entry records the argv synthesizeOne really builds, so a dropped flag fails here.
171
172
  async function kokoroArgv(options) {
172
173
  const dir = mkdtempSync(join(tmpdir(), "tts-kokoro-argv-"));
173
174
  const argvLog = join(dir, "argv.txt");
174
- writeFileSync(join(dir, "npx"), `#!/bin/sh\nprintf '%s\\n' "$@" > "${argvLog}"\n`);
175
- chmodSync(join(dir, "npx"), 0o755);
176
- const originalPath = process.env.PATH;
175
+ const cli = join(dir, "cli.mjs");
176
+ writeFileSync(
177
+ cli,
178
+ `import { writeFileSync } from "node:fs";\n` +
179
+ `writeFileSync(${JSON.stringify(argvLog)}, process.argv.slice(2).join("\\n"));\n`,
180
+ );
181
+ const originalEntry = process.env.HYPERFRAMES_CLI_ENTRY;
177
182
  try {
178
- process.env.PATH = dir;
183
+ process.env.HYPERFRAMES_CLI_ENTRY = cli;
179
184
  await synthesizeOne({
180
185
  provider: "kokoro",
181
186
  text: "hi",
@@ -186,25 +191,56 @@ async function kokoroArgv(options) {
186
191
  });
187
192
  return readFileSync(argvLog, "utf8").trim().split("\n");
188
193
  } finally {
189
- process.env.PATH = originalPath;
194
+ if (originalEntry === undefined) delete process.env.HYPERFRAMES_CLI_ENTRY;
195
+ else process.env.HYPERFRAMES_CLI_ENTRY = originalEntry;
190
196
  rmSync(dir, { recursive: true, force: true });
191
197
  }
192
198
  }
193
199
 
194
- test(
195
- "synthesizeOne(kokoro) forwards a non-default speed to the CLI",
196
- { skip: process.platform === "win32" },
197
- async () => {
198
- const argv = await kokoroArgv({ speed: 0.8, lang: "es" });
199
- assert.deepEqual(argv.slice(-4), ["--lang", "es", "--speed", "0.8"]);
200
- },
201
- );
200
+ test("synthesizeOne(kokoro) forwards a non-default speed to the CLI", async () => {
201
+ const argv = await kokoroArgv({ speed: 0.8, lang: "es" });
202
+ assert.equal(argv[0], "tts");
203
+ assert.deepEqual(argv.slice(-4), ["--lang", "es", "--speed", "0.8"]);
204
+ });
205
+
206
+ test("synthesizeOne(kokoro) leaves --speed off at the default", async () => {
207
+ assert.ok(!(await kokoroArgv({})).includes("--speed"));
208
+ });
202
209
 
203
210
  test(
204
- "synthesizeOne(kokoro) leaves --speed off at the default",
211
+ "kokoro and transcription without a handed-over CLI fail with the fix, never npx",
205
212
  { skip: process.platform === "win32" },
206
213
  async () => {
207
- assert.ok(!(await kokoroArgv({})).includes("--speed"));
214
+ const dir = mkdtempSync(join(tmpdir(), "tts-kokoro-no-cli-"));
215
+ const marker = join(dir, "npx-ran");
216
+ writeFileSync(join(dir, "npx"), `#!/bin/sh\ntouch "${marker}"\n`);
217
+ chmodSync(join(dir, "npx"), 0o755);
218
+ const saved = { PATH: process.env.PATH, entry: process.env.HYPERFRAMES_CLI_ENTRY };
219
+ const originalError = console.error;
220
+ const errors = [];
221
+ try {
222
+ process.env.PATH = dir;
223
+ delete process.env.HYPERFRAMES_CLI_ENTRY;
224
+ console.error = (message) => errors.push(String(message));
225
+ _resetNpxResolutionWarnForTests();
226
+ const res = await synthesizeOne({
227
+ provider: "kokoro",
228
+ text: "hi",
229
+ voiceId: "am_michael",
230
+ wavAbs: join(dir, "line-0.wav"),
231
+ hyperframesDir: dir,
232
+ });
233
+ assert.equal(res.ok, false);
234
+ assert.match(res.error, /HYPERFRAMES_CLI_ENTRY/);
235
+ assert.equal(await transcribeWav({ wavRel: "line-0.wav", hyperframesDir: dir }), null);
236
+ assert.equal(existsSync(marker), false);
237
+ assert.equal(errors.length, 1);
238
+ } finally {
239
+ console.error = originalError;
240
+ process.env.PATH = saved.PATH;
241
+ if (saved.entry !== undefined) process.env.HYPERFRAMES_CLI_ENTRY = saved.entry;
242
+ rmSync(dir, { recursive: true, force: true });
243
+ }
208
244
  },
209
245
  );
210
246
 
@@ -0,0 +1,106 @@
1
+ import assert from "node:assert/strict";
2
+ import { spawnSync } from "node:child_process";
3
+ import {
4
+ chmodSync,
5
+ existsSync,
6
+ mkdirSync,
7
+ mkdtempSync,
8
+ realpathSync,
9
+ rmSync,
10
+ writeFileSync,
11
+ } from "node:fs";
12
+ import { tmpdir } from "node:os";
13
+ import { delimiter, join } from "node:path";
14
+ import { fileURLToPath } from "node:url";
15
+ import { test } from "node:test";
16
+
17
+ const scripts = fileURLToPath(new URL(".", import.meta.url));
18
+ // Absolute, because the tests below run it with a PATH that has no Python on it.
19
+ const python = ["python3", "python"]
20
+ .map((name) =>
21
+ spawnSync(
22
+ name,
23
+ ["-c", "import sys; assert sys.version_info >= (3, 9); print(sys.executable)"],
24
+ {
25
+ encoding: "utf8",
26
+ },
27
+ ),
28
+ )
29
+ .find((result) => result.status === 0)
30
+ ?.stdout.trim();
31
+ const hasNumpy = python && spawnSync(python, ["-c", "import numpy"]).status === 0;
32
+ const exe = process.platform === "win32" ? ".exe" : "";
33
+
34
+ function program(dir, name, marker) {
35
+ mkdirSync(dir, { recursive: true });
36
+ const file = join(dir, `${name}${exe}`);
37
+ writeFileSync(file, `#!/bin/sh\ntouch "${marker}"\nexit 1\n`);
38
+ chmodSync(file, 0o755);
39
+ return file;
40
+ }
41
+
42
+ function fixture(t) {
43
+ const root = realpathSync(mkdtempSync(join(tmpdir(), "hf-trusted-program-")));
44
+ t.after(() => rmSync(root, { recursive: true, force: true }));
45
+ const project = join(root, "project");
46
+ const plantedRan = join(root, "planted-ran");
47
+ for (const dir of [project, join(project, "bin"), join(project, "node_modules", ".bin")]) {
48
+ program(dir, "ffmpeg", plantedRan);
49
+ }
50
+ const trusted = program(join(root, "tools"), "ffmpeg", join(root, "trusted-ran"));
51
+ const projectOnly = ["", ".", "bin", "node_modules/.bin", join(project, "bin")].join(delimiter);
52
+ return { project, plantedRan, trusted, projectOnly, tools: join(root, "tools") };
53
+ }
54
+
55
+ function find(cwd, path) {
56
+ const code = `import sys; sys.path.insert(0, ${JSON.stringify(scripts)})
57
+ from trusted_program import find_program
58
+ try:
59
+ print(find_program("ffmpeg"))
60
+ except FileNotFoundError as error:
61
+ print("missing:", error)`;
62
+ const result = spawnSync(python, ["-c", code], {
63
+ cwd,
64
+ encoding: "utf8",
65
+ env: { ...process.env, PATH: path },
66
+ });
67
+ assert.equal(result.status, 0, result.stderr);
68
+ return result.stdout.trim();
69
+ }
70
+
71
+ test(
72
+ "find_program skips every project folder on PATH and returns the trusted one",
73
+ { skip: !python },
74
+ (t) => {
75
+ const { project, trusted, projectOnly, tools } = fixture(t);
76
+ assert.equal(find(project, `${projectOnly}${delimiter}${tools}`), trusted);
77
+ },
78
+ );
79
+
80
+ test(
81
+ "find_program reports a miss like running a missing program by name",
82
+ { skip: !python },
83
+ (t) => {
84
+ const { project, projectOnly } = fixture(t);
85
+ assert.equal(
86
+ find(project, projectOnly),
87
+ "missing: [Errno 2] No such file or directory: 'ffmpeg'",
88
+ );
89
+ },
90
+ );
91
+
92
+ test(
93
+ "extract-audio-data never runs an ffmpeg planted in the project",
94
+ { skip: !hasNumpy || process.platform === "win32" },
95
+ (t) => {
96
+ const { project, plantedRan, projectOnly } = fixture(t);
97
+ const result = spawnSync(
98
+ python,
99
+ [join(scripts, "extract-audio-data.py"), "in.mp3", "-o", "out.json"],
100
+ { cwd: project, encoding: "utf8", env: { ...process.env, PATH: projectOnly } },
101
+ );
102
+ assert.notEqual(result.status, 0);
103
+ assert.match(result.stderr, /No such file or directory: 'ffmpeg'/);
104
+ assert.equal(existsSync(plantedRan), false);
105
+ },
106
+ );
@@ -0,0 +1,76 @@
1
+ """Find a helper program on PATH without taking one from the project folder.
2
+
3
+ A program started by bare name can come from the working directory: Windows searches it
4
+ before PATH, and a relative or empty PATH entry points into it everywhere. Scripts run
5
+ inside project folders, so only absolute PATH folders outside the working directory count,
6
+ the same rule as the CLI's trustedExecutable.ts. From the home folder (or above it) only
7
+ the folder itself is skipped, since every per-user install folder sits inside it.
8
+ """
9
+
10
+ import errno
11
+ import os
12
+ import sys
13
+
14
+ # Same UTF-8 stdio pin as the scripts that import this module, so it holds on its own too.
15
+ for _stream in (sys.stdout, sys.stderr):
16
+ if hasattr(_stream, "reconfigure"):
17
+ _stream.reconfigure(encoding="utf-8", errors=_stream.errors)
18
+
19
+
20
+ def _comparable(path):
21
+ return os.path.normcase(os.path.realpath(os.path.abspath(path)))
22
+
23
+
24
+ def _contains(parent, child):
25
+ try:
26
+ rel = os.path.relpath(child, parent)
27
+ except ValueError: # on different Windows drives
28
+ return False
29
+ if rel == os.curdir:
30
+ return True
31
+ return not (rel == os.pardir or rel.startswith(os.pardir + os.sep) or os.path.isabs(rel))
32
+
33
+
34
+ def _expand_home(entry):
35
+ if sys.platform == "win32" or not (entry == "~" or entry.startswith("~/")):
36
+ return entry
37
+ return os.path.expanduser(entry)
38
+
39
+
40
+ def trusted_path_dirs(path_value=None):
41
+ """The PATH folders a helper program may come from, in PATH order."""
42
+ if path_value is None:
43
+ path_value = os.environ.get("PATH", "")
44
+ cwd = _comparable(os.getcwd())
45
+ from_home_or_above = _contains(cwd, _comparable(os.path.expanduser("~")))
46
+ dirs = []
47
+ for raw in path_value.split(os.pathsep):
48
+ entry = _expand_home(raw.strip('"') if sys.platform == "win32" else raw)
49
+ if not entry or not os.path.isabs(entry):
50
+ continue
51
+ target = _comparable(entry)
52
+ if target == cwd or (not from_home_or_above and _contains(cwd, target)):
53
+ continue
54
+ if entry not in dirs:
55
+ dirs.append(entry)
56
+ return dirs
57
+
58
+
59
+ def _extensions():
60
+ if sys.platform != "win32":
61
+ return [""]
62
+ listed = os.environ.get("PATHEXT", ".COM;.EXE;.BAT;.CMD").split(";")
63
+ return list(dict.fromkeys([".exe"] + [ext.strip().lower() for ext in listed if ext.strip()]))
64
+
65
+
66
+ def find_program(name):
67
+ """Absolute path of `name` from a trusted PATH folder.
68
+
69
+ A miss raises the same FileNotFoundError that running a missing program by name raises.
70
+ """
71
+ for folder in trusted_path_dirs():
72
+ for ext in _extensions():
73
+ candidate = os.path.join(folder, name + ext)
74
+ if os.path.isfile(candidate) and os.access(candidate, os.X_OK):
75
+ return candidate
76
+ raise FileNotFoundError(errno.ENOENT, os.strerror(errno.ENOENT), name)
@@ -9,6 +9,8 @@ shot), use the shared engine at `audio/scripts/audio.mjs`. It takes a neutral
9
9
  node <SKILL_DIR>/audio/scripts/audio.mjs --request ./audio_request.json --out ./audio_meta.json
10
10
  ```
11
11
 
12
+ Kokoro voices and word timings by transcription run the HyperFrames CLI. Helpers never look it up in the project: run them through the plugin launcher's `--script`, or set `HYPERFRAMES_CLI_ENTRY` to the absolute path of your installed CLI's `bin/hyperframes.mjs`. Without one, those steps stop and say so.
13
+
12
14
  - **Request** `{ provider?, voice?, lang?, speed?, tts_model?, style?, lines: [{ id, text, style?, sfx?: [names] }], bgm: { mode?, query?, prompt? } }`: `id` joins each line back to your model; `bgm.mode` = `retrieve | generate | none` (omit for auto). `--only tts,bgm,sfx` runs a subset and merges into an existing `--out`.
13
15
  - **Your own recording**: a line with `audio` (a path in the project) instead of `text` is used as the voice: `{ id, audio: "take.m4a", words?: [{ text, start, end }] }`. It is converted to `assets/voice/<id>.wav`, `speed` stretches it with the pitch kept and scales `words` the same (without `words` the recording is transcribed). Its `audio_meta.json` voice has `source: "recording"`; with only recording lines `tts_provider` is `"recording"` and no provider or HeyGen sign-in is needed.
14
16
  - **Gemini narration** is opt-in with `provider: "gemini"` and an API key or service-account credentials. `tts_model` defaults to `gemini-3.8-flash-tts`; 3.8 Flash-Lite, 3.1 Flash Preview, and 2.5 Pro/Flash Preview TTS are also supported. `style` directs delivery; a line's style overrides the request's style. CLI overrides: `--tts-model`, `--style`. See `audio/references/tts.md` for a complete request. The existing automatic provider order is unchanged.
@@ -126,7 +126,8 @@ npx hyperframes transcribe talk.mp4 --engine parakeet # or --engine auto (defa
126
126
 
127
127
  VERIFIED on 24GB: accurate, ~3s (cached) for 8s audio. Parakeet covers 25
128
128
  European languages, English included. For other languages, or when parakeet-mlx is not
129
- installed, transcribe.mjs falls back to `hyperframes transcribe`, which uses the
129
+ installed, transcribe.mjs falls back to `hyperframes transcribe` (the CLI handed over as
130
+ `HYPERFRAMES_CLI_ENTRY`, see `references/audio.md`), which uses the
130
131
  CLI's Parakeet when `models install parakeet` has run and whisper.cpp (99
131
132
  languages) otherwise. `--engine parakeet|whisper` forces one, except that a
132
133
  `--language` other than English runs whisper whenever it is installed, since