hyperframes 0.9.33 → 0.9.34

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 (286) hide show
  1. package/bin/hyperframes.mjs +10 -0
  2. package/dist/{add-GDXM36YQ.js → add-NBOJ2UA3.js} +16 -15
  3. package/dist/{agentPromptGenerator-KPNDH2EI.js → agentPromptGenerator-3JOLQXTX.js} +10 -10
  4. package/dist/{animatedGifPrep-SAKETEZ2.js → animatedGifPrep-VI5CFYCR.js} +9 -9
  5. package/dist/api.js +38 -38
  6. package/dist/{appHistory-WZIHFCPK.js → appHistory-535MKSWI.js} +2 -2
  7. package/dist/{asset-KOJC72AQ.js → asset-NYULKN5A.js} +2 -2
  8. package/dist/{assetCataloger-Q4ZFUI6G.js → assetCataloger-AWJMEMX7.js} +11 -11
  9. package/dist/{audio-XZBBXKQC.js → audio-QN5YYFOA.js} +19 -19
  10. package/dist/{auth-X45YSZGE.js → auth-LHUBRGIH.js} +2 -2
  11. package/dist/{autoUpdate-77XWQ564.js → autoUpdate-5M3JGEFS.js} +2 -2
  12. package/dist/{avatars-D3D22TI2.js → avatars-DAB2KILV.js} +13 -13
  13. package/dist/{backgroundChecks-2L2RWFJ3.js → backgroundChecks-3NQOCEDM.js} +3 -3
  14. package/dist/backgroundChecksWorker.js +3 -3
  15. package/dist/{batchRender-O7J47H2Z.js → batchRender-EPRIJZVT.js} +4 -4
  16. package/dist/{beats-6RVVU56H.js → beats-ZCPQEIFG.js} +11 -11
  17. package/dist/{benchmark-D5JRNAVQ.js → benchmark-7OVOBGQX.js} +9 -9
  18. package/dist/{billing-WT4DGZII.js → billing-7K6S23FP.js} +14 -14
  19. package/dist/{browser-2OR737P4.js → browser-CP76THCA.js} +8 -7
  20. package/dist/{bundleWithLocalizedFonts-VBET4RVR.js → bundleWithLocalizedFonts-MRCRI676.js} +1 -1
  21. package/dist/{capture-B34FTO6G.js → capture-B4B72PIK.js} +4 -4
  22. package/dist/{capture-23X2CK56.js → capture-VAE27MNW.js} +21 -21
  23. package/dist/{captureCompositionFrame-TPZKEVKN.js → captureCompositionFrame-YAOQTG6R.js} +16 -16
  24. package/dist/{captureFile-Y2ZMB7HK.js → captureFile-P4BDKVJH.js} +2 -2
  25. package/dist/{catalog-ACHSYU5Z.js → catalog-TUZGNHN6.js} +16 -15
  26. package/dist/{catch-up-FGANS2BB.js → catch-up-GMUF3JXI.js} +9 -9
  27. package/dist/{check-DXK4L5WP.js → check-CHCV573Z.js} +46 -46
  28. package/dist/{checkAudio-4ISYJED3.js → checkAudio-JJZN37WT.js} +13 -13
  29. package/dist/{checkBrowser-5ECMULMP.js → checkBrowser-SK7GFN7U.js} +39 -39
  30. package/dist/{chunk-L6BFXQ6S.js → chunk-2HDVXVUA.js} +3 -3
  31. package/dist/{chunk-76KUCQXD.js → chunk-2JXJQ3ZQ.js} +2 -2
  32. package/dist/{chunk-A4VXOJZO.js → chunk-2JZU6DYH.js} +3 -3
  33. package/dist/{chunk-4US5QCXR.js → chunk-2OP5HU5S.js} +62 -25
  34. package/dist/{chunk-KRWPTZBY.js → chunk-3FQYFVWA.js} +99 -25
  35. package/dist/{chunk-4CHGNFCS.js → chunk-3K4THQHY.js} +4 -4
  36. package/dist/{chunk-BBL6STGK.js → chunk-3P4OYIBA.js} +2 -2
  37. package/dist/{chunk-2KYLVWLO.js → chunk-3XJ42WUG.js} +1 -1
  38. package/dist/{chunk-ERJBWDPM.js → chunk-45IPAGED.js} +6 -6
  39. package/dist/{chunk-XUDJ5XSQ.js → chunk-4MVWA7NJ.js} +6 -6
  40. package/dist/{chunk-SWPI27QV.js → chunk-4TQS6ZSL.js} +7 -7
  41. package/dist/{chunk-OD7PLYYX.js → chunk-4WXLBRT5.js} +31 -22
  42. package/dist/{chunk-KIAY63AB.js → chunk-4Y4VYZRO.js} +3 -3
  43. package/dist/{chunk-5RVPI6QL.js → chunk-52CUHVEA.js} +3 -3
  44. package/dist/{chunk-2RBQLV6B.js → chunk-55I56MXF.js} +1 -1
  45. package/dist/{chunk-O5CNNVRY.js → chunk-5QPYUTV3.js} +8 -8
  46. package/dist/{chunk-GHLLC6LJ.js → chunk-5SXAEHZT.js} +2 -2
  47. package/dist/{chunk-77UB5EHM.js → chunk-5WK76INI.js} +1 -1
  48. package/dist/{chunk-23354HMA.js → chunk-5ZTB6QIJ.js} +3 -3
  49. package/dist/{chunk-ZIYXPDKY.js → chunk-65PFUPLX.js} +1 -1
  50. package/dist/{chunk-45ZQI734.js → chunk-6FP6HBG4.js} +2 -2
  51. package/dist/{chunk-MVIUSNPZ.js → chunk-6HG3XABE.js} +1 -1
  52. package/dist/{chunk-SUXEL7G4.js → chunk-6K5KVYOQ.js} +11 -11
  53. package/dist/{chunk-4DLYTSWQ.js → chunk-6OYPVALW.js} +1 -1
  54. package/dist/{chunk-G2XAFJ2B.js → chunk-74PKHC3W.js} +1 -1
  55. package/dist/{chunk-N6Y645MX.js → chunk-7C6K5WFB.js} +1 -1
  56. package/dist/{chunk-6QEEF5RR.js → chunk-7E5HPNMD.js} +1 -1
  57. package/dist/{chunk-CHJGVW5W.js → chunk-7YBRRU5W.js} +4 -11
  58. package/dist/{chunk-I3PA54IU.js → chunk-7YOJPNDT.js} +1 -1
  59. package/dist/{chunk-2I4DQZLQ.js → chunk-A2YCAF35.js} +23 -37
  60. package/dist/{chunk-EX533ULK.js → chunk-AG6L5CUE.js} +2 -2
  61. package/dist/{chunk-SVI2CJ6R.js → chunk-AOTAYP5E.js} +1 -1
  62. package/dist/{chunk-CNJLBAKM.js → chunk-ASORF7UJ.js} +2 -2
  63. package/dist/{chunk-MDBEAWP2.js → chunk-AUM475MS.js} +3 -3
  64. package/dist/{chunk-CDI3CCAU.js → chunk-BDFD3C3V.js} +7 -7
  65. package/dist/{chunk-YAS347ZS.js → chunk-BLII22FU.js} +1 -1
  66. package/dist/{chunk-ROXILOZ6.js → chunk-BX4GM3IV.js} +2 -2
  67. package/dist/{chunk-W2FSQBUR.js → chunk-BZPRG5N5.js} +14 -14
  68. package/dist/{chunk-YNFHZ4RI.js → chunk-C3TYMGWE.js} +3 -3
  69. package/dist/{chunk-UE2WSWNA.js → chunk-C62LSZVJ.js} +1 -1
  70. package/dist/{chunk-CKJDY6EK.js → chunk-DC7AOIHN.js} +1 -1
  71. package/dist/{chunk-GBIASKIH.js → chunk-DH34XRVW.js} +1 -1
  72. package/dist/{chunk-N2C7WJDG.js → chunk-DLBFLOEU.js} +1 -1
  73. package/dist/{chunk-HPKW6UVW.js → chunk-DTM7HGP4.js} +3 -3
  74. package/dist/{chunk-ADYMQM7T.js → chunk-E53F4CP6.js} +2 -2
  75. package/dist/{chunk-2LMCARA5.js → chunk-ECKXTBRB.js} +6 -4
  76. package/dist/{chunk-T3GSTIBS.js → chunk-EDQF36I7.js} +3 -3
  77. package/dist/{chunk-7LTXT7ME.js → chunk-EWBLIDHD.js} +2 -2
  78. package/dist/{chunk-BMDABBHG.js → chunk-FEWHHDFA.js} +5 -17
  79. package/dist/{chunk-SIGASWB7.js → chunk-FILLRGVO.js} +4 -4
  80. package/dist/{chunk-MDGNQWFN.js → chunk-FRY73NRV.js} +1 -1
  81. package/dist/{chunk-WYPRTHXQ.js → chunk-FS4XHCSU.js} +1 -1
  82. package/dist/{chunk-GOMTMQRT.js → chunk-G6ME77PU.js} +1 -1
  83. package/dist/{chunk-C2VZ7UPE.js → chunk-GJB5VR44.js} +15 -15
  84. package/dist/{chunk-JSVCF4A6.js → chunk-GXGGPZXD.js} +2 -2
  85. package/dist/{chunk-VQJLTYEK.js → chunk-H6323NVP.js} +2 -2
  86. package/dist/{chunk-Y5DOT5NQ.js → chunk-HYTD4CIO.js} +1 -1
  87. package/dist/{chunk-QWM3NY2E.js → chunk-I2GYLBJJ.js} +4 -4
  88. package/dist/{chunk-I35B5RWZ.js → chunk-IVMYWHFE.js} +3 -3
  89. package/dist/{chunk-YDG3OXH3.js → chunk-IX6BFRED.js} +1 -1
  90. package/dist/{chunk-RGYOCAHC.js → chunk-JJUVQYXL.js} +2 -2
  91. package/dist/{chunk-DMZER7D5.js → chunk-JQATOGQQ.js} +2 -2
  92. package/dist/{chunk-XQWWFIBR.js → chunk-JVDYIUFD.js} +2 -2
  93. package/dist/{chunk-HEXTAQYG.js → chunk-K4TEEYGN.js} +2 -2
  94. package/dist/{chunk-SOAQ3XXB.js → chunk-K5BPLZOP.js} +2 -2
  95. package/dist/{chunk-XSHJ37U3.js → chunk-K6EOKQ6J.js} +7 -7
  96. package/dist/{chunk-R45WFVRA.js → chunk-KCL77FXI.js} +1 -1
  97. package/dist/{chunk-PXDRW3QN.js → chunk-LB6VJTM4.js} +1 -1
  98. package/dist/{chunk-G55YEL2L.js → chunk-LCQT4S43.js} +233 -47
  99. package/dist/{chunk-N7C7U3ZR.js → chunk-M425BL2U.js} +22 -11
  100. package/dist/{chunk-MA35E5OY.js → chunk-NAKQS3EJ.js} +2 -2
  101. package/dist/{chunk-VZQXHYEI.js → chunk-NMMPHHN7.js} +3 -3
  102. package/dist/{chunk-RCB4SGTB.js → chunk-O2S5HR7Y.js} +49 -12
  103. package/dist/{chunk-XVVPEWNX.js → chunk-OKN7E77Z.js} +1 -1
  104. package/dist/{chunk-4WZU4FYS.js → chunk-PDE6XAIJ.js} +4 -4
  105. package/dist/{chunk-4FTJE22M.js → chunk-PNBWAA3E.js} +2 -2
  106. package/dist/{chunk-IYLGUQFR.js → chunk-PVHNBJCI.js} +3 -3
  107. package/dist/{chunk-NQFIMBXS.js → chunk-PWSTB75B.js} +2 -2
  108. package/dist/{chunk-YSHUIQ3I.js → chunk-PXWPBLEN.js} +1 -1
  109. package/dist/{chunk-IEEIPTDW.js → chunk-PYZVKGW5.js} +1 -1
  110. package/dist/{chunk-MP36L7OJ.js → chunk-Q2G4ERQU.js} +2 -2
  111. package/dist/{chunk-VKZSAAXZ.js → chunk-QDSALYDV.js} +4 -4
  112. package/dist/{chunk-XDRSEU2I.js → chunk-R3C62AP3.js} +4 -4
  113. package/dist/{chunk-U77L3ZQZ.js → chunk-RJJ5NVSQ.js} +1 -1
  114. package/dist/{chunk-WIMVXPYG.js → chunk-RSQTFDMS.js} +11 -11
  115. package/dist/{chunk-XFXCI4IP.js → chunk-RYJXT2AS.js} +2 -2
  116. package/dist/{chunk-DGC2RIQE.js → chunk-S3HTROSO.js} +3 -3
  117. package/dist/{chunk-O2T6ZTLN.js → chunk-SAIPA3QY.js} +1 -1
  118. package/dist/{chunk-CHM3QYLF.js → chunk-SDBFTY6V.js} +3 -3
  119. package/dist/{chunk-PNP2BO3U.js → chunk-SG4OW2HV.js} +2 -2
  120. package/dist/{chunk-W5PW26KE.js → chunk-T4YI2YLF.js} +1 -1
  121. package/dist/{chunk-2QTGQGYA.js → chunk-T7O62YTY.js} +1 -1
  122. package/dist/chunk-TDOJW7Z2.js +5053 -0
  123. package/dist/{chunk-EX7WPDFA.js → chunk-TGGYHFTP.js} +2 -2
  124. package/dist/{chunk-5GYTBKZA.js → chunk-TGK7LUEV.js} +2 -2
  125. package/dist/{chunk-YTUPQTXA.js → chunk-TLU5DPES.js} +7 -7
  126. package/dist/{chunk-6ZVUTYNB.js → chunk-TOLY2QK2.js} +5 -5
  127. package/dist/{chunk-JCJJCYCP.js → chunk-UFKWSLJ5.js} +9 -9
  128. package/dist/{chunk-AIC7T7CC.js → chunk-UGWY7PFQ.js} +2 -2
  129. package/dist/{chunk-REJ4NIBY.js → chunk-VJSKNQTM.js} +1 -1
  130. package/dist/{chunk-ETWXZQN5.js → chunk-VW35U2LJ.js} +2 -2
  131. package/dist/{chunk-JZIEZCQM.js → chunk-VZO3BUTW.js} +5 -12
  132. package/dist/{chunk-TFBPCJPG.js → chunk-W6AXNWGE.js} +1 -1
  133. package/dist/{chunk-ZOAANTVI.js → chunk-WC2XQ4NR.js} +1 -1
  134. package/dist/{chunk-WXOOAAT4.js → chunk-WLB2D2OJ.js} +36 -4
  135. package/dist/{chunk-3J32XVJ6.js → chunk-WWT32C2M.js} +3 -3
  136. package/dist/{chunk-HMB3IAVP.js → chunk-XEUTASNL.js} +2 -2
  137. package/dist/{chunk-6RV2QY4K.js → chunk-YCXNWQ3B.js} +23 -23
  138. package/dist/{chunk-FRH3CPW5.js → chunk-YMTLKSXO.js} +1 -1
  139. package/dist/{chunk-B66UZ2YK.js → chunk-Z222HDGC.js} +6 -6
  140. package/dist/{chunk-DDDSTRHU.js → chunk-Z3ZLN5VR.js} +4 -4
  141. package/dist/{chunk-2TBW7UOF.js → chunk-Z64I7KJZ.js} +203 -115
  142. package/dist/{chunk-7UUUV4PN.js → chunk-ZWLFWYHR.js} +1 -1
  143. package/dist/{clean-3IN64RHM.js → clean-N7RLS5LN.js} +24 -24
  144. package/dist/cli.js +64 -64
  145. package/dist/{cloud-SVYXHFEG.js → cloud-4PO7BA26.js} +2 -2
  146. package/dist/{cloud-LBUZBUP6.js → cloud-W3DHH6EB.js} +4 -4
  147. package/dist/{cloudrun-PZOF2QGL.js → cloudrun-YIAPIPOG.js} +6 -6
  148. package/dist/{compare-UOJ3LXQQ.js → compare-GCWIIUGY.js} +38 -38
  149. package/dist/{compiler-5ZDHBKBQ.js → compiler-L3BJI43E.js} +5 -5
  150. package/dist/{component-EVIPLTTJ.js → component-C4VYDMZ4.js} +3 -3
  151. package/dist/{compositions-R4GG5FBO.js → compositions-5P4BZQJA.js} +13 -13
  152. package/dist/{contactSheet-HZMP42FZ.js → contactSheet-ROMTQQ6Y.js} +3 -3
  153. package/dist/{curve-LR3PSRW3.js → curve-IMXKUBAO.js} +13 -13
  154. package/dist/{cuts-DHCOBAFT.js → cuts-PRBLX5HH.js} +14 -14
  155. package/dist/{delete-MMGGU3QP.js → delete-QYWDRFO3.js} +4 -4
  156. package/dist/{deploy-SKIGUTM2.js → deploy-DGEPSTOJ.js} +2 -2
  157. package/dist/{describeProject-L7HNTBPV.js → describeProject-WS4TR7VF.js} +10 -10
  158. package/dist/{destroy-5HSMMDH7.js → destroy-2KSDD4KU.js} +2 -2
  159. package/dist/{deterministicFonts-2ZPRAI3C.js → deterministicFonts-D3HTAAN2.js} +3 -3
  160. package/dist/{diff-KR7VKPYL.js → diff-AAWRGZLX.js} +35 -35
  161. package/dist/{dist-3MFNUZSN.js → dist-DJQRHSKZ.js} +3 -3
  162. package/dist/{dist-HK3AZNNL.js → dist-GJSMSEEL.js} +18 -14
  163. package/dist/{dist-ZGYPFYOH.js → dist-V2TLDLQL.js} +3 -3
  164. package/dist/{doctor-G7VGNSA5.js → doctor-CARXZUFN.js} +16 -16
  165. package/dist/{energy-H7EEH6WO.js → energy-VMNGG2ND.js} +14 -14
  166. package/dist/{events-ASG27IXP.js → events-4XIJRQIJ.js} +16 -16
  167. package/dist/{events-5ATZCZTK.js → events-LOPLHMOT.js} +2 -2
  168. package/dist/{events-YD6N7OPQ.js → events-XX3DYSU4.js} +6 -6
  169. package/dist/{execute-OAS454OB.js → execute-U7JKJERV.js} +28 -28
  170. package/dist/{extract-645SENLA.js → extract-KYFUTYDD.js} +14 -14
  171. package/dist/{face-WRT5XH4I.js → face-VQGUHRQL.js} +15 -15
  172. package/dist/{feedback-3LKLR5MV.js → feedback-UPWYWOQ3.js} +12 -12
  173. package/dist/{ffmpeg-PXKIZL2X.js → ffmpeg-RUOPT3JH.js} +9 -9
  174. package/dist/{figma-RIEVJJBW.js → figma-TO57RICW.js} +3 -3
  175. package/dist/fontLocalizeCli.js +13 -13
  176. package/dist/{frames-OTB3J5W3.js → frames-4Y3X474I.js} +16 -16
  177. package/dist/{generate-IUKCZW2D.js → generate-BPID6U7D.js} +25 -25
  178. package/dist/{get-6WVQ7TBV.js → get-JIJ46VI5.js} +4 -4
  179. package/dist/{gpuPolicy-HXSVAEU4.js → gpuPolicy-5ZJNSR7D.js} +9 -9
  180. package/dist/{grade-compare-TCAYHDEF.js → grade-compare-YTBW7C65.js} +37 -37
  181. package/dist/{heifImagePrep-GXIMK4HK.js → heifImagePrep-OL7KF7SH.js} +10 -10
  182. package/dist/{help-RGOL5EJD.js → help-QPV26QI5.js} +1 -1
  183. package/dist/{history-XKPRGJGS.js → history-7UVGTZT3.js} +12 -12
  184. package/dist/hyperframe.manifest.json +1 -1
  185. package/dist/hyperframe.runtime.iife.js +61 -61
  186. package/dist/hyperframes-player.global.js +1 -1
  187. package/dist/{info-EYBBC42V.js → info-2VFXR7LJ.js} +15 -15
  188. package/dist/{init-F2FWPSMA.js → init-JZ7CJQJE.js} +32 -32
  189. package/dist/{ink-BWFERAAT.js → ink-SS7XOD7Y.js} +14 -14
  190. package/dist/{inspect-74N7L3BW.js → inspect-D5MBKDZZ.js} +37 -37
  191. package/dist/{installer-LOUR7G4R.js → installer-UNC4BAFO.js} +7 -7
  192. package/dist/{keyframes-WB5PTKFE.js → keyframes-7T2CVOM6.js} +9 -9
  193. package/dist/{lambda-JYCNXUKB.js → lambda-QVJFVSXL.js} +15 -15
  194. package/dist/{layout-P52EVR24.js → layout-5DF7VFWS.js} +37 -37
  195. package/dist/{lint-SL55KAS2.js → lint-EWJHJKAI.js} +11 -11
  196. package/dist/{lintProject-46WU53VC.js → lintProject-KBJU3L4C.js} +3 -3
  197. package/dist/{list-LN6CQH52.js → list-DDLH5ZG5.js} +4 -4
  198. package/dist/{localPage-L6OJU3UH.js → localPage-MHAXFUGI.js} +10 -10
  199. package/dist/{login-WTOAMDID.js → login-BJ4QUZT4.js} +4 -4
  200. package/dist/{look-O6ESLJRP.js → look-HNK2K33N.js} +14 -14
  201. package/dist/{manager-CMEZWENF.js → manager-FFLFDJZ6.js} +10 -10
  202. package/dist/{manager-IAXYSRG5.js → manager-VLO3FZC4.js} +2 -1
  203. package/dist/{measure-NEIXU53P.js → measure-SE346MGF.js} +11 -11
  204. package/dist/{media-treatment-6CAQG7MU.js → media-treatment-KYPDRIBT.js} +15 -15
  205. package/dist/{media-use-IXJFMKU7.js → media-use-OJZHSNTK.js} +15 -6
  206. package/dist/{models-TZALWUEY.js → models-KWSHPDZ5.js} +14 -14
  207. package/dist/{motionShot-OQYK6G6M.js → motionShot-HEROABIE.js} +20 -20
  208. package/dist/{normalize-audio-43PJLOBY.js → normalize-audio-ZD5W37ZO.js} +11 -11
  209. package/dist/{open-EOX6QY4M.js → open-7B6HT4EX.js} +17 -17
  210. package/dist/{parakeetRunner-STHAXQAF.js → parakeetRunner-5AKE7TBH.js} +17 -17
  211. package/dist/{pipeline-RRWZHFBQ.js → pipeline-UTVSWC4X.js} +12 -12
  212. package/dist/{plan-JWUSMF4W.js → plan-SQ63IXQC.js} +22 -22
  213. package/dist/{play-TUKTST32.js → play-NYBFE3GW.js} +27 -27
  214. package/dist/{preflight-L42JKT6F.js → preflight-T23WHZP3.js} +11 -11
  215. package/dist/{present-Z7HRDXPV.js → present-FX22552Q.js} +21 -21
  216. package/dist/{preview-HGTIRAV3.js → preview-ULBNMDXD.js} +57 -33
  217. package/dist/{probe-RXK44FY7.js → probe-62Z5C6VC.js} +14 -14
  218. package/dist/{producer-KJ2RZDJ3.js → producer-X3KFL4QM.js} +1 -1
  219. package/dist/{projectConfig-K36NTJXP.js → projectConfig-JQ4IDYTU.js} +10 -10
  220. package/dist/{publication-OZWLT6K6.js → publication-YNIJIR6O.js} +5 -5
  221. package/dist/{publish-CRUTXNYM.js → publish-7TIGC7RV.js} +17 -17
  222. package/dist/{remove-background-R37HZPCG.js → remove-background-F3BD6WXD.js} +13 -13
  223. package/dist/{render-SU2XTMJL.js → render-BL6CAORF.js} +6 -6
  224. package/dist/{render-ZHCPCISN.js → render-CDWBVWJP.js} +43 -43
  225. package/dist/{render-EZMKBT7V.js → render-EOQOD2TJ.js} +31 -31
  226. package/dist/{render-batch-YIUOEAAL.js → render-batch-PDY2PXUZ.js} +6 -6
  227. package/dist/renderSetupWorker.js +4 -4
  228. package/dist/{resolver-DLCKRKQR.js → resolver-VBAVCFEP.js} +7 -7
  229. package/dist/{reverse-4FAVXIER.js → reverse-3E6HUX5S.js} +1 -1
  230. package/dist/{run-H4GVEJVS.js → run-77Z3DLIP.js} +4 -4
  231. package/dist/{screenshotCapture-CQF5FYVI.js → screenshotCapture-XWWCRLGM.js} +12 -12
  232. package/dist/{service-XDQOULGD.js → service-LJZQKQT6.js} +13 -13
  233. package/dist/{share-CUCQALE7.js → share-2CNP22KN.js} +16 -16
  234. package/dist/{sherpa-WZNRQUVC.js → sherpa-NPTMMQHQ.js} +16 -16
  235. package/dist/sherpaWorker.js +2 -1
  236. package/dist/skills/hyperframes/references/plugin-installation.md +5 -2
  237. package/dist/skills/hyperframes/scripts/plugin-cli.mjs +20 -3
  238. package/dist/skills/hyperframes/scripts/plugin-cli.test.mjs +61 -3
  239. package/dist/skills/hyperframes-cli/references/doctor-browser.md +1 -1
  240. package/dist/skills/media-use/audio/scripts/gemini-pipeline.test.mjs +6 -6
  241. package/dist/skills/media-use/audio/scripts/lib/tts.cleanup.test.mjs +12 -6
  242. package/dist/skills/media-use/audio/scripts/lib/tts.mjs +25 -6
  243. package/dist/skills/media-use/audio/scripts/lib/tts.spawn.test.mjs +37 -12
  244. package/dist/skills/media-use/audio/scripts/lib/tts.test.mjs +54 -18
  245. package/dist/skills/media-use/references/audio.md +2 -0
  246. package/dist/skills/media-use/references/operations.md +2 -1
  247. package/dist/skills/media-use/scripts/lib/npx-sync.test.mjs +22 -31
  248. package/dist/skills/media-use/scripts/lib/tts-local-provider.mjs +16 -11
  249. package/dist/skills/media-use/scripts/lib/tts-local-provider.test.mjs +34 -78
  250. package/dist/skills/media-use/scripts/resolve-plugin.test.mjs +42 -18
  251. package/dist/skills/media-use/scripts/transcribe.test.mjs +60 -17
  252. package/dist/{skills-J52DBZAK.js → skills-7MQBUOOX.js} +9 -9
  253. package/dist/{skillsUpdateCheck-26DJHBTC.js → skillsUpdateCheck-JAUXRXRH.js} +3 -3
  254. package/dist/{snapshot-ZIRQFDA7.js → snapshot-D7DROQPF.js} +49 -49
  255. package/dist/{src-C3XYMTF4.js → src-26DWEOAT.js} +10 -8
  256. package/dist/{src-7BGBN6SS.js → src-LJIVCW6M.js} +12 -12
  257. package/dist/{start-QG2XNMYN.js → start-DF3U2VIG.js} +23 -23
  258. package/dist/{staticProjectServer-TWMEFK3T.js → staticProjectServer-NYH6MQHZ.js} +24 -24
  259. package/dist/{status-3UPA5WPI.js → status-5Q43GUYF.js} +17 -16
  260. package/dist/studio/assets/{codec-qz1-OXLj.js → codec-OdIlx7W3.js} +1 -1
  261. package/dist/studio/assets/{hyperframes-player-2eG1zFX5.js → hyperframes-player-XtPxZL3k.js} +1 -1
  262. package/dist/studio/assets/{index-DDmhnfrS.js → index-DTU1D-zj.js} +83 -83
  263. package/dist/studio/assets/{index-DUveJ_YP.js → index-DWZWPFkU.js} +1 -1
  264. package/dist/studio/assets/{pausedVideoDecoder-CoHTKUjM.js → pausedVideoDecoder-NVr8gRm5.js} +1 -1
  265. package/dist/studio/index.html +1 -1
  266. package/dist/{studio-api-Z42OO4JJ.js → studio-api-ZYCEQPX2.js} +18 -14
  267. package/dist/{studioServer-SMN3RMVL.js → studioServer-W4RX3B7S.js} +67 -65
  268. package/dist/{sync-ONTI2WSI.js → sync-LLH2GSSC.js} +14 -14
  269. package/dist/{synthesize-FR5KPBRP.js → synthesize-4A5ENXNO.js} +4 -3
  270. package/dist/{telemetry-RRXALB5D.js → telemetry-RIQIM2PH.js} +6 -6
  271. package/dist/{templates-BHFOSD6F.js → templates-4HVTWNKO.js} +14 -14
  272. package/dist/{timeline-Z5IHY5TN.js → timeline-ITIMTT27.js} +22 -22
  273. package/dist/{tokens-MZVEPARM.js → tokens-ABTBM6UA.js} +2 -2
  274. package/dist/{transcribe-5IZS4BGW.js → transcribe-6BA2MP2Y.js} +30 -30
  275. package/dist/{transcribe-M5N3YZZU.js → transcribe-6LDBHZCZ.js} +13 -13
  276. package/dist/{tts-ZE776B4I.js → tts-P77F523Z.js} +1 -1
  277. package/dist/{update-EVPWBIKY.js → update-ODXFCK36.js} +11 -11
  278. package/dist/{updateCheck-2UUEF6TC.js → updateCheck-E4U776B4.js} +2 -2
  279. package/dist/{upgrade-DK45FD4K.js → upgrade-LSHVYMLH.js} +4 -4
  280. package/dist/{urlDownloader-3MPHIDSA.js → urlDownloader-PWQ2LDLE.js} +8 -8
  281. package/dist/{validate-W27TQ367.js → validate-JHETNNBN.js} +29 -29
  282. package/dist/{video-TI372QGV.js → video-D2D5YCDU.js} +11 -11
  283. package/dist/{voices-FZV4PGT6.js → voices-34FMTOIX.js} +23 -23
  284. package/dist/warmCheck.js +46 -46
  285. package/package.json +1 -1
  286. package/dist/chunk-XDDBSGBD.js +0 -5049
@@ -9,10 +9,10 @@ import {
9
9
  rmSync,
10
10
  writeFileSync,
11
11
  } from "node:fs";
12
- import { join } from "node:path";
12
+ import { delimiter, join } from "node:path";
13
13
  import { tmpdir } from "node:os";
14
14
  import { test } from "node:test";
15
- import { invocation, pluginVersion } from "./plugin-cli.mjs";
15
+ import { invocation, npmFolder, pluginVersion } from "./plugin-cli.mjs";
16
16
 
17
17
  function fixture(t, manifest = "plugin.json", version = "1.2.3") {
18
18
  const root = mkdtempSync(join(tmpdir(), "hf-plugin-"));
@@ -54,8 +54,11 @@ test("pins CLI, suppresses standalone refresh, preserves unrelated environment",
54
54
  version: "1.2.3",
55
55
  platform: "darwin",
56
56
  env: { PATH: "/bin", HYPERFRAMES_SKIP_SKILLS: "0" },
57
+ cwd: "/work/project",
58
+ npmCwd: "/home/person",
57
59
  });
58
60
  assert.equal(result.command, "npx");
61
+ assert.equal(result.cwd, "/home/person");
59
62
  assert.deepEqual(result.args, [
60
63
  "--yes",
61
64
  "hyperframes@1.2.3",
@@ -69,6 +72,7 @@ test("pins CLI, suppresses standalone refresh, preserves unrelated environment",
69
72
  HYPERFRAMES_SKILL_PKG_VERSION: "1.2.3",
70
73
  HYPERFRAMES_PLUGIN_VERSION: "1.2.3",
71
74
  HYPERFRAMES_NO_UPDATE_CHECK: "1",
75
+ HYPERFRAMES_PLUGIN_CWD: "/work/project",
72
76
  });
73
77
  assert.throws(() => invocation(["skills", "update"], { version: "1.2.3" }), /plugin manager/);
74
78
  });
@@ -80,8 +84,10 @@ test("Windows launches npx through Node without shell argument interpretation",
80
84
  node: String.raw`C:\Program Files\nodejs\node.exe`,
81
85
  env: { npm_execpath: String.raw`C:\Program Files\nodejs\node_modules\npm\bin\npm-cli.js` },
82
86
  pathExists: (p) => p === String.raw`C:\Program Files\nodejs\node_modules\npm\bin\npx-cli.js`,
87
+ npmCwd: String.raw`C:\Users\person`,
83
88
  });
84
89
  assert.equal(result.command, String.raw`C:\Program Files\nodejs\node.exe`);
90
+ assert.equal(result.cwd, String.raw`C:\Users\person`);
85
91
  assert.deepEqual(result.args, [
86
92
  String.raw`C:\Program Files\nodejs\node_modules\npm\bin\npx-cli.js`,
87
93
  "--yes",
@@ -102,7 +108,7 @@ test("installed helper keeps cwd, arguments, release environment and exit code",
102
108
  const helper = join(root, "helper.mjs");
103
109
  writeFileSync(
104
110
  helper,
105
- "console.log(JSON.stringify({ cwd: process.cwd(), args: process.argv.slice(2), skip: process.env.HYPERFRAMES_SKIP_SKILLS, version: process.env.HYPERFRAMES_SKILL_PKG_VERSION })); process.exit(7);",
111
+ "console.log(JSON.stringify({ cwd: process.cwd(), args: process.argv.slice(2), skip: process.env.HYPERFRAMES_SKIP_SKILLS, version: process.env.HYPERFRAMES_SKILL_PKG_VERSION, cli: process.env.HYPERFRAMES_CLI_ENTRY })); process.exit(7);",
106
112
  );
107
113
  const before = readFileSync(join(root, "plugin.json"), "utf8");
108
114
  const result = spawnSync(
@@ -116,6 +122,58 @@ test("installed helper keeps cwd, arguments, release environment and exit code",
116
122
  args: ["literal $value & spaces"],
117
123
  skip: "1",
118
124
  version: "1.2.3",
125
+ cli: realpathSync(launcher),
119
126
  });
120
127
  assert.equal(readFileSync(join(root, "plugin.json"), "utf8"), before);
121
128
  });
129
+
130
+ test(
131
+ "npx starts outside the project, so its packages, bin links and .npmrc cannot pick the CLI",
132
+ { skip: process.platform === "win32" },
133
+ (t) => {
134
+ const { root, launcher } = fixture(t);
135
+ const home = join(root, "home");
136
+ const bin = join(root, "bin");
137
+ const project = join(root, "user project");
138
+ mkdirSync(home);
139
+ mkdirSync(bin);
140
+ mkdirSync(join(project, "node_modules/.bin"), { recursive: true });
141
+ writeFileSync(
142
+ join(project, ".npmrc"),
143
+ "registry=http://127.0.0.1:9/\nscript-shell=/bin/false\n",
144
+ );
145
+ writeFileSync(join(project, "package.json"), '{"name":"hyperframes","bin":"x.js"}');
146
+ writeFileSync(join(project, "node_modules/.bin/hyperframes"), "#!/bin/sh\n", { mode: 0o755 });
147
+ writeFileSync(
148
+ join(bin, "npx"),
149
+ `#!${process.execPath}\nconsole.log(JSON.stringify({cwd:process.cwd(),args:process.argv.slice(2),project:process.env.HYPERFRAMES_PLUGIN_CWD}));`,
150
+ { mode: 0o755 },
151
+ );
152
+ const result = spawnSync(process.execPath, [launcher, "--version"], {
153
+ cwd: project,
154
+ encoding: "utf8",
155
+ env: { ...process.env, HOME: home, PATH: `${bin}${delimiter}${process.env.PATH}` },
156
+ });
157
+ assert.equal(result.status, 0, result.stderr);
158
+ assert.deepEqual(JSON.parse(result.stdout), {
159
+ cwd: realpathSync(home),
160
+ args: ["--yes", "hyperframes@1.2.3", "--version"],
161
+ project: realpathSync(project),
162
+ });
163
+ },
164
+ );
165
+
166
+ test("starts npx in the home folder and never falls back to a shared folder", () => {
167
+ assert.equal(
168
+ npmFolder("/home/person", () => true),
169
+ "/home/person",
170
+ );
171
+ assert.throws(() => npmFolder("", () => true), /Cannot find your home folder/);
172
+ assert.throws(() => npmFolder("/home/gone", () => false), /Cannot find your home folder/);
173
+ // Helper scripts never start npx, so they run without a home folder.
174
+ const script = invocation(["--script", "helper.mjs"], {
175
+ version: "1.2.3",
176
+ cwd: "/project",
177
+ });
178
+ assert.equal(script.cwd, "/project");
179
+ });
@@ -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
 
@@ -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
  );
@@ -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,
@@ -146,11 +146,18 @@ export function resolveNpxCliPath(
146
146
  return pathExists(besideNode) ? besideNode : null;
147
147
  }
148
148
 
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.
149
+ export const MISSING_CLI_MESSAGE =
150
+ "No HyperFrames CLI was handed to this helper, and it does not look one up in the project. " +
151
+ "Run the helper through the plugin launcher (`plugin-cli.mjs --script <helper> ...`), or set " +
152
+ "HYPERFRAMES_CLI_ENTRY to the absolute path of your installed CLI's bin/hyperframes.mjs.";
153
+
154
+ // The HyperFrames CLI or plugin launcher that starts this code hands over its own entry file, so
155
+ // `npx hyperframes` runs that same CLI with the same Node. Without one it fails rather than
156
+ // letting npx resolve `hyperframes` from the project.
151
157
  function launchingCliCommand(cmd, args, env = process.env) {
158
+ if (cmd !== "npx" || args[0] !== "hyperframes") return null;
152
159
  const entry = env.HYPERFRAMES_CLI_ENTRY;
153
- if (cmd !== "npx" || args[0] !== "hyperframes" || !entry || !isAbsolute(entry)) return null;
160
+ if (!entry || !isAbsolute(entry)) throw new Error(MISSING_CLI_MESSAGE);
154
161
  return { cmd: process.execPath, args: [entry, ...args.slice(1).map((arg) => String(arg))] };
155
162
  }
156
163
 
@@ -186,9 +193,11 @@ export function resolveSpawnCommand(
186
193
  // (its ESM exports are non-configurable, so mock.method can't patch it).
187
194
  // One-shot so a whole batch of TTS lines doesn't repeat the same diagnostic.
188
195
  let _warnedNpxResolution = false;
189
- /** Test-only: reset the one-shot npx-resolution warning latch. */
196
+ let _warnedMissingCli = false;
197
+ /** Test-only: reset the one-shot npx-resolution warning latches. */
190
198
  export function _resetNpxResolutionWarnForTests() {
191
199
  _warnedNpxResolution = false;
200
+ _warnedMissingCli = false;
192
201
  }
193
202
 
194
203
  export function spawnP(
@@ -200,7 +209,16 @@ export function spawnP(
200
209
  env = process.env,
201
210
  pathExists = existsSync,
202
211
  ) {
203
- const resolved = resolveSpawnCommand(cmd, args, opts, platform, env, pathExists);
212
+ let resolved;
213
+ try {
214
+ resolved = resolveSpawnCommand(cmd, args, opts, platform, env, pathExists);
215
+ } catch (error) {
216
+ if (!_warnedMissingCli) {
217
+ _warnedMissingCli = true;
218
+ console.error(`[media-use] ${error.message}`);
219
+ }
220
+ return Promise.resolve({ status: -1, error: error.message });
221
+ }
204
222
  if (!resolved) {
205
223
  // resolveSpawnCommand only returns null for the npx-on-win32 case where
206
224
  // neither npm's configured CLI nor the beside-node fallback exists. Without
@@ -307,7 +325,8 @@ export async function synthesizeOne({
307
325
  export function synthResult(r, wavAbs, label) {
308
326
  if (r.status === 0 && existsSync(wavAbs)) return { ok: true, words: null };
309
327
  const why =
310
- r.status !== 0 ? `${label} exited with status ${r.status}` : `${label} produced no wav file`;
328
+ r.error ??
329
+ (r.status !== 0 ? `${label} exited with status ${r.status}` : `${label} produced no wav file`);
311
330
  return { ok: false, words: null, error: why };
312
331
  }
313
332
 
@@ -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
 
@@ -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
@@ -3,9 +3,9 @@ import assert from "node:assert/strict";
3
3
  import { resolveNpxInvocation } from "./npx-sync.mjs";
4
4
 
5
5
  // Coverage parity with tts-local-provider.test.mjs, for the whisper.cpp
6
- // fallback's call-site shape (transcribe.mjs runWhisper): the same three
7
- // branches, but with the hard-fail contract — no fallback provider exists,
8
- // so an unresolvable npx must throw actionably instead of returning null.
6
+ // fallback's call-site shape (transcribe.mjs runCli), with the hard-fail
7
+ // contract: no fallback provider exists, so a missing CLI hand-over throws
8
+ // actionably instead of resolving `hyperframes` through npx.
9
9
 
10
10
  const envWithNpxCli = {
11
11
  npm_execpath: "C:/Program Files/nodejs/node_modules/npm/bin/npm-cli.js",
@@ -17,34 +17,25 @@ const pathExists = (path) => path === npxCliPath;
17
17
  const WHISPER_ARGV = ["hyperframes", "transcribe", "C:\\media\\input.wav", "--dir", "C:\\work"];
18
18
  const WHISPER_OPTS = { stdio: ["ignore", "pipe", "pipe"], timeout: 1_800_000 };
19
19
 
20
- test("win32: routes the whisper fallback through node + npx-cli, never bare npx", () => {
21
- const resolved = resolveNpxInvocation(
22
- WHISPER_ARGV,
23
- WHISPER_OPTS,
24
- "win32",
25
- envWithNpxCli,
26
- pathExists,
27
- );
28
-
29
- assert.equal(resolved.cmd, envWithNpxCli.npm_node_execpath);
30
- assert.equal(resolved.args[0], npxCliPath);
31
- assert.deepEqual(resolved.args.slice(1, 3), ["hyperframes", "transcribe"]);
32
- // execFileSync options survive the rerouting (the timeout bounds the
33
- // whisper build/model download; the pipes surface its errors).
34
- assert.deepEqual(resolved.opts.stdio, ["ignore", "pipe", "pipe"]);
35
- assert.equal(resolved.opts.timeout, 1_800_000);
36
- });
37
-
38
- test("win32 without a resolvable npx-cli: throws the actionable install hint", () => {
39
- assert.throws(
40
- () => resolveNpxInvocation(WHISPER_ARGV, WHISPER_OPTS, "win32", {}, () => false),
41
- /npx-cli\.js was not found/,
42
- );
20
+ test("runs the handed-over CLI entry with the same Node, on every platform", () => {
21
+ for (const platform of ["darwin", "win32"]) {
22
+ const env = { ...envWithNpxCli, HYPERFRAMES_CLI_ENTRY: "/opt/hf/bin/hyperframes.mjs" };
23
+ const resolved = resolveNpxInvocation(WHISPER_ARGV, WHISPER_OPTS, platform, env, pathExists);
24
+
25
+ assert.equal(resolved.cmd, process.execPath);
26
+ assert.deepEqual(resolved.args, ["/opt/hf/bin/hyperframes.mjs", ...WHISPER_ARGV.slice(1)]);
27
+ // execFileSync options survive (the timeout bounds the whisper build/model
28
+ // download; the pipes surface its errors).
29
+ assert.deepEqual(resolved.opts.stdio, ["ignore", "pipe", "pipe"]);
30
+ assert.equal(resolved.opts.timeout, 1_800_000);
31
+ }
43
32
  });
44
33
 
45
- test("non-win32: spawns plain npx unchanged", () => {
46
- const resolved = resolveNpxInvocation(WHISPER_ARGV, WHISPER_OPTS, "darwin", {}, () => false);
47
-
48
- assert.equal(resolved.cmd, "npx");
49
- assert.deepEqual(resolved.args, WHISPER_ARGV);
34
+ test("without a handed-over CLI: throws the fix instead of running npx", () => {
35
+ for (const platform of ["darwin", "win32"]) {
36
+ assert.throws(
37
+ () => resolveNpxInvocation(WHISPER_ARGV, WHISPER_OPTS, platform, envWithNpxCli, pathExists),
38
+ /HYPERFRAMES_CLI_ENTRY/,
39
+ );
40
+ }
50
41
  });
@@ -45,17 +45,22 @@ export async function localTtsGenerate(
45
45
  const argv = ["hyperframes", "tts", intent, "--output", outPath];
46
46
  if (ctx?.voice) argv.push("--voice", ctx.voice);
47
47
  if (ctx?.lang && ctx.lang !== "en") argv.push("--lang", ctx.lang);
48
- // On Windows a bare "npx" is npx.cmd, which execFileSync cannot exec
49
- // (spawnSync npx ENOENT) — resolveSpawnCommand reroutes it through
50
- // node + npx-cli.js, same as the audio engine's TTS spawns.
51
- const resolved = resolveSpawnCommand(
52
- "npx",
53
- argv,
54
- { encoding: "utf8", timeout: 300000, stdio: ["ignore", "pipe", "pipe"] },
55
- platform,
56
- env,
57
- pathExists,
58
- );
48
+ // resolveSpawnCommand runs the CLI that started this engine (HYPERFRAMES_CLI_ENTRY) with the
49
+ // same Node, and throws when none was handed over rather than resolving npx from the project.
50
+ let resolved;
51
+ try {
52
+ resolved = resolveSpawnCommand(
53
+ "npx",
54
+ argv,
55
+ { encoding: "utf8", timeout: 300000, stdio: ["ignore", "pipe", "pipe"] },
56
+ platform,
57
+ env,
58
+ pathExists,
59
+ );
60
+ } catch (err) {
61
+ console.error(`media-use: local voice not enabled (kokoro). ${err.message}`);
62
+ return null;
63
+ }
59
64
  if (!resolved) {
60
65
  // npx-on-win32 with no resolvable npx-cli.js — same terminal condition
61
66
  // spawnP warns about. Fall through to the next provider rather than crash.