hyperframes 0.9.32 → 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 (303) hide show
  1. package/bin/hyperframes.mjs +10 -0
  2. package/dist/{add-HYI4YJC5.js → add-NBOJ2UA3.js} +18 -17
  3. package/dist/{agentPromptGenerator-JAQNBEUZ.js → agentPromptGenerator-3JOLQXTX.js} +11 -11
  4. package/dist/{animatedGifPrep-DVYRCZVR.js → animatedGifPrep-VI5CFYCR.js} +10 -10
  5. package/dist/api.js +49 -48
  6. package/dist/{appHistory-WZIHFCPK.js → appHistory-535MKSWI.js} +2 -2
  7. package/dist/{asset-7FG3M3FQ.js → asset-NYULKN5A.js} +2 -2
  8. package/dist/{assetCataloger-QDQZYHUC.js → assetCataloger-AWJMEMX7.js} +12 -12
  9. package/dist/{audio-R6ZG62DU.js → audio-QN5YYFOA.js} +31 -30
  10. package/dist/{auth-IPDYZXOG.js → auth-LHUBRGIH.js} +4 -4
  11. package/dist/{autoUpdate-GAEDDZRN.js → autoUpdate-5M3JGEFS.js} +3 -3
  12. package/dist/{avatars-A45VFUZ4.js → avatars-DAB2KILV.js} +19 -18
  13. package/dist/{backgroundChecks-US74BS6V.js → backgroundChecks-3NQOCEDM.js} +4 -4
  14. package/dist/backgroundChecksWorker.js +4 -4
  15. package/dist/{batchRender-VBSYVQA7.js → batchRender-EPRIJZVT.js} +4 -4
  16. package/dist/{beats-UPJ3KANG.js → beats-ZCPQEIFG.js} +14 -14
  17. package/dist/{benchmark-2RWYJGL2.js → benchmark-7OVOBGQX.js} +11 -11
  18. package/dist/{billing-MD66MJTA.js → billing-7K6S23FP.js} +19 -18
  19. package/dist/{browser-JXCS62NX.js → browser-CP76THCA.js} +10 -9
  20. package/dist/{bundleWithLocalizedFonts-RAD7BNJF.js → bundleWithLocalizedFonts-MRCRI676.js} +1 -1
  21. package/dist/{capture-M6DT5WZT.js → capture-B4B72PIK.js} +4 -4
  22. package/dist/{capture-DJ4WRP62.js → capture-VAE27MNW.js} +51 -31
  23. package/dist/{captureCompositionFrame-IRXG7ZFU.js → captureCompositionFrame-YAOQTG6R.js} +18 -18
  24. package/dist/{captureFile-Y2ZMB7HK.js → captureFile-P4BDKVJH.js} +2 -2
  25. package/dist/{catalog-GW45OWKU.js → catalog-TUZGNHN6.js} +18 -17
  26. package/dist/{catch-up-YKJQ4IYC.js → catch-up-GMUF3JXI.js} +11 -11
  27. package/dist/{check-7QTKMPGA.js → check-CHCV573Z.js} +51 -51
  28. package/dist/{checkAudio-7WHUYGUZ.js → checkAudio-JJZN37WT.js} +19 -19
  29. package/dist/{checkBrowser-USAOWTAF.js → checkBrowser-SK7GFN7U.js} +44 -44
  30. package/dist/{chunk-X6DWLN55.js → chunk-2HDVXVUA.js} +8 -4
  31. package/dist/{chunk-JMV63CNH.js → chunk-2JXJQ3ZQ.js} +2 -2
  32. package/dist/{chunk-6BI6URO2.js → chunk-2JZU6DYH.js} +5 -4
  33. package/dist/{chunk-SXOIG6VG.js → chunk-2OP5HU5S.js} +284 -192
  34. package/dist/{chunk-KRWPTZBY.js → chunk-3FQYFVWA.js} +99 -25
  35. package/dist/{chunk-G7NKYELQ.js → chunk-3K4THQHY.js} +4 -4
  36. package/dist/{chunk-SIRYW7SY.js → chunk-3P4OYIBA.js} +2 -2
  37. package/dist/{chunk-WTO4DHBH.js → chunk-3XJ42WUG.js} +1 -1
  38. package/dist/{chunk-XPT4GC6X.js → chunk-45IPAGED.js} +7 -7
  39. package/dist/{chunk-HWMNSWEA.js → chunk-4MVWA7NJ.js} +6 -6
  40. package/dist/{chunk-WAXPM7TK.js → chunk-4RPIEGL3.js} +2 -2
  41. package/dist/{chunk-6MTSP2XE.js → chunk-4TQS6ZSL.js} +7 -7
  42. package/dist/{chunk-5GXMZIQZ.js → chunk-4WXLBRT5.js} +31 -22
  43. package/dist/{chunk-YIE5FU73.js → chunk-4Y4VYZRO.js} +37 -3
  44. package/dist/{chunk-K72X2YXR.js → chunk-52CUHVEA.js} +4 -4
  45. package/dist/{chunk-TLUDJLBN.js → chunk-55I56MXF.js} +1 -1
  46. package/dist/{chunk-2T7EDEKE.js → chunk-5QPYUTV3.js} +8 -8
  47. package/dist/{chunk-WLNQAJQC.js → chunk-5SXAEHZT.js} +2 -2
  48. package/dist/{chunk-77UB5EHM.js → chunk-5WK76INI.js} +1 -1
  49. package/dist/{chunk-5VN7ZXJR.js → chunk-5ZTB6QIJ.js} +3 -3
  50. package/dist/{chunk-ZIYXPDKY.js → chunk-65PFUPLX.js} +1 -1
  51. package/dist/{chunk-LHFBKUVY.js → chunk-6FP6HBG4.js} +2 -2
  52. package/dist/{chunk-YCTWMO3G.js → chunk-6HG3XABE.js} +1 -1
  53. package/dist/{chunk-LJMTEZOP.js → chunk-6K5KVYOQ.js} +16 -16
  54. package/dist/{chunk-34S7GYVK.js → chunk-6OYPVALW.js} +15 -8
  55. package/dist/{chunk-G2XAFJ2B.js → chunk-74PKHC3W.js} +1 -1
  56. package/dist/{chunk-N6Y645MX.js → chunk-7C6K5WFB.js} +1 -1
  57. package/dist/{chunk-M6FNCANA.js → chunk-7E5HPNMD.js} +1 -1
  58. package/dist/{chunk-CHJGVW5W.js → chunk-7YBRRU5W.js} +4 -11
  59. package/dist/{chunk-2NMBD5AH.js → chunk-7YOJPNDT.js} +1 -1
  60. package/dist/{chunk-GCJRV7LU.js → chunk-A2YCAF35.js} +23 -37
  61. package/dist/{chunk-E5S4QMX7.js → chunk-AG6L5CUE.js} +2 -2
  62. package/dist/{chunk-SVI2CJ6R.js → chunk-AOTAYP5E.js} +1 -1
  63. package/dist/{chunk-VB3JZKMN.js → chunk-ASORF7UJ.js} +31 -10
  64. package/dist/{chunk-XB7HE2R5.js → chunk-AUM475MS.js} +3 -3
  65. package/dist/{chunk-7NDF2MO3.js → chunk-BAWGEGKD.js} +216 -344
  66. package/dist/{chunk-I3QXWJ7V.js → chunk-BDFD3C3V.js} +7 -7
  67. package/dist/{chunk-YAS347ZS.js → chunk-BLII22FU.js} +1 -1
  68. package/dist/{chunk-CMYUPVMI.js → chunk-BX4GM3IV.js} +2 -2
  69. package/dist/{chunk-D7NNNL2K.js → chunk-BZPRG5N5.js} +18 -18
  70. package/dist/{chunk-H4C3P2KV.js → chunk-C3TYMGWE.js} +3 -3
  71. package/dist/{chunk-6NNLDCX4.js → chunk-C62LSZVJ.js} +1 -1
  72. package/dist/{chunk-C5JKRCSG.js → chunk-CHCMXYER.js} +1 -1
  73. package/dist/{chunk-CKJDY6EK.js → chunk-DC7AOIHN.js} +1 -1
  74. package/dist/{chunk-GBIASKIH.js → chunk-DH34XRVW.js} +1 -1
  75. package/dist/{chunk-6SNGKC6B.js → chunk-DLBFLOEU.js} +1 -1
  76. package/dist/{chunk-LP7B3JLC.js → chunk-DMW5SSUN.js} +2 -1
  77. package/dist/{chunk-Z6X64P6C.js → chunk-DTM7HGP4.js} +6 -6
  78. package/dist/{chunk-2W4VQ3YZ.js → chunk-E53F4CP6.js} +2 -2
  79. package/dist/{chunk-3R2X2VKB.js → chunk-ECKXTBRB.js} +6 -4
  80. package/dist/{chunk-RCRUWNQ4.js → chunk-EDQF36I7.js} +3 -3
  81. package/dist/{chunk-GWSCUFGL.js → chunk-EWBLIDHD.js} +11 -9
  82. package/dist/{chunk-BMDABBHG.js → chunk-FEWHHDFA.js} +5 -17
  83. package/dist/{chunk-EBG5RCPM.js → chunk-FILLRGVO.js} +4 -4
  84. package/dist/{chunk-3HT3UGF2.js → chunk-FRY73NRV.js} +1 -1
  85. package/dist/{chunk-KAG5KXNO.js → chunk-FS4XHCSU.js} +1 -1
  86. package/dist/{chunk-GOMTMQRT.js → chunk-G6ME77PU.js} +1 -1
  87. package/dist/{chunk-GTHRXU37.js → chunk-GJB5VR44.js} +18 -18
  88. package/dist/{chunk-G6JLFSII.js → chunk-GXGGPZXD.js} +4 -4
  89. package/dist/chunk-H6323NVP.js +453 -0
  90. package/dist/chunk-HYTD4CIO.js +57 -0
  91. package/dist/{chunk-P7TCIUP2.js → chunk-I2GYLBJJ.js} +4 -4
  92. package/dist/{chunk-BA3EQ2KL.js → chunk-IVMYWHFE.js} +3 -3
  93. package/dist/{chunk-HDCVU64B.js → chunk-IX6BFRED.js} +3 -2
  94. package/dist/{chunk-W3HNLDK6.js → chunk-JJUVQYXL.js} +2 -2
  95. package/dist/{chunk-HXQDDCGY.js → chunk-JQATOGQQ.js} +2 -2
  96. package/dist/{chunk-2Z42EUHG.js → chunk-JVDYIUFD.js} +2 -2
  97. package/dist/{chunk-WVRAFHJU.js → chunk-K2Z6OXEI.js} +33 -5
  98. package/dist/{chunk-SFPIVVUE.js → chunk-K4TEEYGN.js} +2 -2
  99. package/dist/{chunk-KFXHBP2E.js → chunk-K5BPLZOP.js} +2 -2
  100. package/dist/{chunk-H7AJLEBR.js → chunk-K6EOKQ6J.js} +8 -8
  101. package/dist/{chunk-Y3YHDU7T.js → chunk-KCL77FXI.js} +1 -1
  102. package/dist/{chunk-PXDRW3QN.js → chunk-LB6VJTM4.js} +1 -1
  103. package/dist/{chunk-EXW2LV4K.js → chunk-LCQT4S43.js} +248 -62
  104. package/dist/chunk-M3BJEZ7E.js +152 -0
  105. package/dist/{chunk-N7C7U3ZR.js → chunk-M425BL2U.js} +22 -11
  106. package/dist/{chunk-3YNJAXA5.js → chunk-MOR3H5FK.js} +1 -1
  107. package/dist/{chunk-M6LAGO6O.js → chunk-NAKQS3EJ.js} +3 -3
  108. package/dist/{chunk-TTSLKH63.js → chunk-NMMPHHN7.js} +3 -3
  109. package/dist/{chunk-UWMOMAYI.js → chunk-O2S5HR7Y.js} +49 -12
  110. package/dist/{chunk-D6BV6TTI.js → chunk-OKN7E77Z.js} +1 -1
  111. package/dist/{chunk-XH6LGDIB.js → chunk-PDE6XAIJ.js} +4 -4
  112. package/dist/{chunk-4FTJE22M.js → chunk-PNBWAA3E.js} +2 -2
  113. package/dist/{chunk-AOQRVS63.js → chunk-PVHNBJCI.js} +9 -7
  114. package/dist/{chunk-3PHCFSPD.js → chunk-PWSTB75B.js} +2 -2
  115. package/dist/{chunk-PVSRPNIV.js → chunk-PXWPBLEN.js} +2 -2
  116. package/dist/{chunk-IEEIPTDW.js → chunk-PYZVKGW5.js} +1 -1
  117. package/dist/{chunk-5FFYMVRD.js → chunk-Q2G4ERQU.js} +2 -2
  118. package/dist/{chunk-YMIEJZB6.js → chunk-QDSALYDV.js} +4 -4
  119. package/dist/{chunk-ZLDYDO64.js → chunk-QUUZ2BGC.js} +6 -4
  120. package/dist/{chunk-XDRSEU2I.js → chunk-R3C62AP3.js} +4 -4
  121. package/dist/{chunk-L72MPEM2.js → chunk-RJJ5NVSQ.js} +1 -1
  122. package/dist/{chunk-KXOKZJBZ.js → chunk-RSQTFDMS.js} +13 -13
  123. package/dist/{chunk-6RFCS4IU.js → chunk-RYJXT2AS.js} +9 -7
  124. package/dist/{chunk-GJUL3PRV.js → chunk-S3HTROSO.js} +3 -3
  125. package/dist/{chunk-AZ2QJETV.js → chunk-SAIPA3QY.js} +1 -1
  126. package/dist/{chunk-4CSZZXL6.js → chunk-SDBFTY6V.js} +3 -3
  127. package/dist/{chunk-TZH6HNZH.js → chunk-SG4OW2HV.js} +2 -2
  128. package/dist/{chunk-AWT5FHTN.js → chunk-T4YI2YLF.js} +1 -1
  129. package/dist/{chunk-TVQNABOI.js → chunk-T7O62YTY.js} +1 -1
  130. package/dist/chunk-TDOJW7Z2.js +5053 -0
  131. package/dist/{chunk-3367VNGK.js → chunk-TGGYHFTP.js} +2 -2
  132. package/dist/{chunk-NNOAOQLT.js → chunk-TGK7LUEV.js} +2 -2
  133. package/dist/chunk-TLU5DPES.js +560 -0
  134. package/dist/{chunk-LXIEKLAC.js → chunk-TOLY2QK2.js} +6 -6
  135. package/dist/chunk-UFKWSLJ5.js +392 -0
  136. package/dist/{chunk-PXY3JZP2.js → chunk-UGWY7PFQ.js} +2 -2
  137. package/dist/{chunk-REJ4NIBY.js → chunk-VJSKNQTM.js} +1 -1
  138. package/dist/{chunk-NXSKZE3C.js → chunk-VW35U2LJ.js} +2 -2
  139. package/dist/{chunk-JZIEZCQM.js → chunk-VZO3BUTW.js} +5 -12
  140. package/dist/{chunk-TFBPCJPG.js → chunk-W6AXNWGE.js} +1 -1
  141. package/dist/{chunk-262ADJJN.js → chunk-WC2XQ4NR.js} +1 -1
  142. package/dist/{chunk-WXOOAAT4.js → chunk-WLB2D2OJ.js} +36 -4
  143. package/dist/{chunk-P5E3RHW3.js → chunk-WWT32C2M.js} +3 -3
  144. package/dist/{chunk-ADP2GIBS.js → chunk-XEUTASNL.js} +2 -2
  145. package/dist/{chunk-MYFAVVA6.js → chunk-YCXNWQ3B.js} +32 -32
  146. package/dist/{chunk-JHX76QFC.js → chunk-YMTLKSXO.js} +1 -1
  147. package/dist/{chunk-KG3TONXU.js → chunk-Z222HDGC.js} +9 -9
  148. package/dist/chunk-Z3ZLN5VR.js +3890 -0
  149. package/dist/{chunk-EJPWGGPK.js → chunk-Z64I7KJZ.js} +5340 -5087
  150. package/dist/{chunk-LBQQNNRC.js → chunk-ZWLFWYHR.js} +1 -1
  151. package/dist/{clean-MJBET4EN.js → clean-N7RLS5LN.js} +29 -29
  152. package/dist/cli.js +70 -68
  153. package/dist/{cloud-Z4Q76MLS.js → cloud-4PO7BA26.js} +8 -7
  154. package/dist/{cloud-WEDQYHZE.js → cloud-W3DHH6EB.js} +4 -4
  155. package/dist/{cloudrun-2KGSRAKA.js → cloudrun-YIAPIPOG.js} +7 -7
  156. package/dist/{compare-MJKWQOD7.js → compare-GCWIIUGY.js} +43 -43
  157. package/dist/{compiler-ETXRTUQC.js → compiler-L3BJI43E.js} +8 -6
  158. package/dist/{component-PZGKEJ6L.js → component-C4VYDMZ4.js} +3 -3
  159. package/dist/{compositions-N3FEEWH7.js → compositions-5P4BZQJA.js} +16 -16
  160. package/dist/{contactSheet-HZMP42FZ.js → contactSheet-ROMTQQ6Y.js} +3 -3
  161. package/dist/contract/LICENSE-Unicode.txt +39 -0
  162. package/dist/contract/path-policy.json +311 -0
  163. package/dist/contract/unicode-15.1.0.json +6179 -0
  164. package/dist/{curve-MWABBM7Q.js → curve-IMXKUBAO.js} +15 -15
  165. package/dist/{cuts-BQFSSNY7.js → cuts-PRBLX5HH.js} +16 -16
  166. package/dist/{delete-HPHGJABK.js → delete-QYWDRFO3.js} +11 -10
  167. package/dist/{deploy-JY2QOB5F.js → deploy-DGEPSTOJ.js} +7 -7
  168. package/dist/{describeProject-S6AGYZWL.js → describeProject-WS4TR7VF.js} +11 -11
  169. package/dist/{destroy-AZK7J4IR.js → destroy-2KSDD4KU.js} +6 -6
  170. package/dist/{deterministicFonts-2ZPRAI3C.js → deterministicFonts-D3HTAAN2.js} +3 -3
  171. package/dist/{diff-XDNFCAU4.js → diff-AAWRGZLX.js} +47 -46
  172. package/dist/{dist-6EE3Y4M7.js → dist-DJQRHSKZ.js} +4 -4
  173. package/dist/{dist-EYEYDD4F.js → dist-GJSMSEEL.js} +22 -18
  174. package/dist/{dist-TYGDYK56.js → dist-V2TLDLQL.js} +3 -3
  175. package/dist/{doctor-6IRSMKZD.js → doctor-CARXZUFN.js} +18 -18
  176. package/dist/{energy-VCJ2FJEF.js → energy-VMNGG2ND.js} +16 -16
  177. package/dist/{events-DNTIMCUM.js → events-4XIJRQIJ.js} +18 -18
  178. package/dist/{events-QQYBD7JM.js → events-LOPLHMOT.js} +4 -4
  179. package/dist/{events-M6A7BT3V.js → events-XX3DYSU4.js} +8 -8
  180. package/dist/execute-U7JKJERV.js +109 -0
  181. package/dist/{extract-X3IVXYHX.js → extract-KYFUTYDD.js} +19 -19
  182. package/dist/{face-MZHXKBDB.js → face-VQGUHRQL.js} +18 -18
  183. package/dist/{feedback-TAMGYFUO.js → feedback-UPWYWOQ3.js} +19 -18
  184. package/dist/{ffmpeg-XWPYYYB6.js → ffmpeg-RUOPT3JH.js} +10 -10
  185. package/dist/{figma-WMD7AR2S.js → figma-TO57RICW.js} +3 -3
  186. package/dist/fontLocalizeCli.js +16 -16
  187. package/dist/{frames-OU2UOLBU.js → frames-4Y3X474I.js} +18 -18
  188. package/dist/{generate-6F6QEFXW.js → generate-BPID6U7D.js} +32 -31
  189. package/dist/{get-VVDO7DXG.js → get-JIJ46VI5.js} +11 -10
  190. package/dist/{gpuPolicy-CVNSHXHJ.js → gpuPolicy-5ZJNSR7D.js} +10 -10
  191. package/dist/{grade-compare-O6LY2U73.js → grade-compare-YTBW7C65.js} +44 -44
  192. package/dist/{heifImagePrep-J6TILZTM.js → heifImagePrep-OL7KF7SH.js} +11 -11
  193. package/dist/{help-XLSTTDHR.js → help-QPV26QI5.js} +2 -1
  194. package/dist/{history-DBCCWBDG.js → history-7UVGTZT3.js} +14 -14
  195. package/dist/hyperframe.manifest.json +1 -1
  196. package/dist/hyperframe.runtime.iife.js +61 -61
  197. package/dist/hyperframes-player.global.js +1 -1
  198. package/dist/{info-E46BWAQ7.js → info-2VFXR7LJ.js} +18 -18
  199. package/dist/{init-23TG5W7S.js → init-JZ7CJQJE.js} +35 -35
  200. package/dist/{ink-6UFSNJRW.js → ink-SS7XOD7Y.js} +16 -16
  201. package/dist/{inspect-RKI6XACH.js → inspect-D5MBKDZZ.js} +41 -41
  202. package/dist/{installer-JWPK75BR.js → installer-UNC4BAFO.js} +7 -7
  203. package/dist/{keyframes-J65V5A2G.js → keyframes-7T2CVOM6.js} +14 -12
  204. package/dist/{lambda-RZSXXBJU.js → lambda-QVJFVSXL.js} +16 -16
  205. package/dist/{layout-RJQUOYWB.js → layout-5DF7VFWS.js} +41 -41
  206. package/dist/{lint-4TUHKKA2.js → lint-EWJHJKAI.js} +14 -14
  207. package/dist/{lintProject-R6RTBSCZ.js → lintProject-KBJU3L4C.js} +4 -4
  208. package/dist/{list-HOD2N4VS.js → list-DDLH5ZG5.js} +13 -12
  209. package/dist/{localPage-TC4NC3VL.js → localPage-MHAXFUGI.js} +11 -11
  210. package/dist/{login-NTOS3HKD.js → login-BJ4QUZT4.js} +8 -7
  211. package/dist/{logout-7SMEH7JL.js → logout-QGNBUJKS.js} +14 -5
  212. package/dist/{look-GC63E2I7.js → look-HNK2K33N.js} +16 -16
  213. package/dist/{manager-FICBET24.js → manager-FFLFDJZ6.js} +11 -11
  214. package/dist/{manager-IAXYSRG5.js → manager-VLO3FZC4.js} +2 -1
  215. package/dist/{measure-WTQCSQ55.js → measure-SE346MGF.js} +11 -11
  216. package/dist/{media-treatment-KTZ6X2P2.js → media-treatment-KYPDRIBT.js} +18 -18
  217. package/dist/{media-use-K75FDXJ3.js → media-use-OJZHSNTK.js} +21 -10
  218. package/dist/{models-JKOA542M.js → models-KWSHPDZ5.js} +15 -15
  219. package/dist/{motionShot-A3TYKTQU.js → motionShot-HEROABIE.js} +24 -24
  220. package/dist/{normalize-audio-7JUM42YB.js → normalize-audio-ZD5W37ZO.js} +14 -14
  221. package/dist/oauth-SAVP2YM4.js +40 -0
  222. package/dist/{open-F6GI4TRA.js → open-7B6HT4EX.js} +19 -19
  223. package/dist/{parakeetRunner-6XIAKJLS.js → parakeetRunner-5AKE7TBH.js} +19 -19
  224. package/dist/{pipeline-7P7LGGQG.js → pipeline-UTVSWC4X.js} +13 -13
  225. package/dist/plan-SQ63IXQC.js +88 -0
  226. package/dist/{play-DYOZLKWX.js → play-NYBFE3GW.js} +32 -32
  227. package/dist/{preflight-VM4HSRBY.js → preflight-T23WHZP3.js} +12 -12
  228. package/dist/{present-IINIEZJC.js → present-FX22552Q.js} +26 -26
  229. package/dist/{preview-NJO2UXWJ.js → preview-ULBNMDXD.js} +63 -39
  230. package/dist/{probe-LQQHFX5Q.js → probe-62Z5C6VC.js} +16 -16
  231. package/dist/{producer-LH2SZHJ2.js → producer-X3KFL4QM.js} +1 -1
  232. package/dist/{projectConfig-BLACFLUW.js → projectConfig-JQ4IDYTU.js} +10 -10
  233. package/dist/{publication-NFF2BXIE.js → publication-YNIJIR6O.js} +5 -5
  234. package/dist/{publish-JST5Y4UR.js → publish-7TIGC7RV.js} +91 -31
  235. package/dist/{refresh-47T6Z2PK.js → refresh-6ONVQ3WV.js} +4 -3
  236. package/dist/{remove-background-WUBESLWN.js → remove-background-F3BD6WXD.js} +14 -14
  237. package/dist/{render-DA4V7CEE.js → render-BL6CAORF.js} +6 -6
  238. package/dist/{render-4KWUUC5H.js → render-CDWBVWJP.js} +91 -957
  239. package/dist/{render-R4VNR4E2.js → render-EOQOD2TJ.js} +54 -53
  240. package/dist/{render-batch-JMPG4RLT.js → render-batch-PDY2PXUZ.js} +6 -6
  241. package/dist/renderSetupWorker.js +5 -5
  242. package/dist/{resolver-PNIFIDIE.js → resolver-VBAVCFEP.js} +7 -7
  243. package/dist/{reverse-4NI7D2C3.js → reverse-3E6HUX5S.js} +1 -1
  244. package/dist/{run-FWBIBLYE.js → run-77Z3DLIP.js} +8 -7
  245. package/dist/{screenshotCapture-KOLNFU7W.js → screenshotCapture-XWWCRLGM.js} +13 -13
  246. package/dist/service-LJZQKQT6.js +68 -0
  247. package/dist/share-2CNP22KN.js +274 -0
  248. package/dist/{sherpa-W3BMN67E.js → sherpa-NPTMMQHQ.js} +18 -18
  249. package/dist/sherpaWorker.js +2 -1
  250. package/dist/skills/hyperframes/references/plugin-installation.md +5 -2
  251. package/dist/skills/hyperframes/scripts/plugin-cli.mjs +20 -3
  252. package/dist/skills/hyperframes/scripts/plugin-cli.test.mjs +61 -3
  253. package/dist/skills/hyperframes-cli/SKILL.md +3 -3
  254. package/dist/skills/hyperframes-cli/references/doctor-browser.md +1 -1
  255. package/dist/skills/hyperframes-cli/references/preview-render.md +20 -0
  256. package/dist/skills/media-use/audio/scripts/gemini-pipeline.test.mjs +6 -6
  257. package/dist/skills/media-use/audio/scripts/lib/tts.cleanup.test.mjs +12 -6
  258. package/dist/skills/media-use/audio/scripts/lib/tts.mjs +25 -6
  259. package/dist/skills/media-use/audio/scripts/lib/tts.spawn.test.mjs +37 -12
  260. package/dist/skills/media-use/audio/scripts/lib/tts.test.mjs +54 -18
  261. package/dist/skills/media-use/references/audio.md +2 -0
  262. package/dist/skills/media-use/references/operations.md +2 -1
  263. package/dist/skills/media-use/scripts/lib/npx-sync.test.mjs +22 -31
  264. package/dist/skills/media-use/scripts/lib/tts-local-provider.mjs +16 -11
  265. package/dist/skills/media-use/scripts/lib/tts-local-provider.test.mjs +34 -78
  266. package/dist/skills/media-use/scripts/resolve-plugin.test.mjs +42 -18
  267. package/dist/skills/media-use/scripts/transcribe.test.mjs +60 -17
  268. package/dist/{skills-KQQVUFGO.js → skills-7MQBUOOX.js} +11 -11
  269. package/dist/{skillsUpdateCheck-VY5PS46S.js → skillsUpdateCheck-JAUXRXRH.js} +4 -4
  270. package/dist/{snapshot-VIEJQAUB.js → snapshot-D7DROQPF.js} +61 -61
  271. package/dist/{src-HHPRCLEW.js → src-26DWEOAT.js} +11 -9
  272. package/dist/{src-MQU5F7GJ.js → src-LJIVCW6M.js} +15 -15
  273. package/dist/{start-ZBNNVFMU.js → start-DF3U2VIG.js} +30 -29
  274. package/dist/{staticProjectServer-VPGZWJF4.js → staticProjectServer-NYH6MQHZ.js} +25 -25
  275. package/dist/{status-RBZJYT7T.js → status-5Q43GUYF.js} +26 -23
  276. package/dist/studio/assets/{codec-Bz1jsLs8.js → codec-OdIlx7W3.js} +1 -1
  277. package/dist/studio/assets/{hyperframes-player-cdH5Sz_t.js → hyperframes-player-XtPxZL3k.js} +1 -1
  278. package/dist/studio/assets/{index-dsfjBidg.css → index-BJTCbv8z.css} +1 -1
  279. package/dist/studio/assets/{index-D1l7izdf.js → index-DTU1D-zj.js} +166 -166
  280. package/dist/studio/assets/{index-DFRbcd5J.js → index-DWZWPFkU.js} +1 -1
  281. package/dist/studio/assets/{pausedVideoDecoder-CgV8YB6S.js → pausedVideoDecoder-NVr8gRm5.js} +1 -1
  282. package/dist/studio/index.html +2 -2
  283. package/dist/{studio-api-EPZGLIWW.js → studio-api-ZYCEQPX2.js} +22 -18
  284. package/dist/{studioServer-YFQQ2ESJ.js → studioServer-W4RX3B7S.js} +451 -71
  285. package/dist/{sync-FRT55PVW.js → sync-LLH2GSSC.js} +16 -16
  286. package/dist/{synthesize-FR5KPBRP.js → synthesize-4A5ENXNO.js} +4 -3
  287. package/dist/{telemetry-HAPPFR7P.js → telemetry-RIQIM2PH.js} +8 -8
  288. package/dist/{templates-2IHYIWMA.js → templates-4HVTWNKO.js} +22 -21
  289. package/dist/{timeline-AY2F7BJF.js → timeline-ITIMTT27.js} +25 -25
  290. package/dist/{tokens-B3G257V3.js → tokens-ABTBM6UA.js} +2 -2
  291. package/dist/{transcribe-RJCILGPA.js → transcribe-6BA2MP2Y.js} +37 -36
  292. package/dist/{transcribe-EGQD32PT.js → transcribe-6LDBHZCZ.js} +14 -14
  293. package/dist/{tts-ZE776B4I.js → tts-P77F523Z.js} +1 -1
  294. package/dist/{update-XTFIGQKW.js → update-ODXFCK36.js} +13 -13
  295. package/dist/{updateCheck-M6YC52A4.js → updateCheck-E4U776B4.js} +5 -3
  296. package/dist/{upgrade-AKLIZKAO.js → upgrade-LSHVYMLH.js} +5 -5
  297. package/dist/{urlDownloader-57A7Q7FC.js → urlDownloader-PWQ2LDLE.js} +9 -9
  298. package/dist/{validate-YWSXJL54.js → validate-JHETNNBN.js} +33 -33
  299. package/dist/{video-I5DDNK3Y.js → video-D2D5YCDU.js} +12 -12
  300. package/dist/{voices-IBMJU73H.js → voices-34FMTOIX.js} +29 -28
  301. package/dist/warmCheck.js +51 -51
  302. package/package.json +2 -1
  303. package/dist/chunk-YAZQBB2S.js +0 -5049
@@ -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.
@@ -2,11 +2,9 @@ import { test } from "node:test";
2
2
  import assert from "node:assert/strict";
3
3
  import { localTtsGenerate } from "./tts-local-provider.mjs";
4
4
 
5
- // Regression: on Windows, a bare "npx" is npx.cmd, which execFileSync cannot
6
- // exec — the Kokoro delegation failed with `spawnSync npx ENOENT` instead of
7
- // synthesizing (or cleanly falling through to the next provider). The spawn
8
- // must route through node + npx-cli.js on win32, same as the audio engine's
9
- // TTS spawns (see ../../audio/scripts/lib/tts.spawn.test.mjs).
5
+ // Kokoro runs `hyperframes tts` through the CLI that started the engine (HYPERFRAMES_CLI_ENTRY),
6
+ // with the same Node and no shell, on every platform. Without that hand-over it never resolves
7
+ // `hyperframes` through npx from the project; it falls through to the next provider.
10
8
 
11
9
  const envWithNpxCli = {
12
10
  npm_execpath: "C:/Program Files/nodejs/node_modules/npm/bin/npm-cli.js",
@@ -15,89 +13,47 @@ const envWithNpxCli = {
15
13
  const npxCliPath = "C:/Program Files/nodejs/node_modules/npm/bin/npx-cli.js";
16
14
  const pathExists = (path) => path === npxCliPath;
17
15
 
18
- test("win32: routes the hyperframes tts call through node + npx-cli, never bare npx", async () => {
19
- const captured = [];
20
- const fakeExec = (cmd, args, opts) => {
21
- captured.push({ cmd, args, opts });
22
- // Synthesize nothing — the provider then returns null via the
23
- // missing-output check, which is fine: we only assert the spawn shape.
24
- };
25
-
26
- await localTtsGenerate(
27
- "hello there",
28
- { voice: "am_michael" },
29
- "win32",
30
- fakeExec,
31
- envWithNpxCli,
32
- pathExists,
33
- );
34
-
35
- assert.equal(captured.length, 1);
36
- assert.equal(captured[0].cmd, envWithNpxCli.npm_node_execpath);
37
- assert.equal(captured[0].args[0], npxCliPath);
38
- assert.deepEqual(captured[0].args.slice(1, 4), ["hyperframes", "tts", "hello there"]);
39
- assert.ok(captured[0].args.includes("--voice"));
40
- // execFileSync options survive the rerouting (pipes are what let the caller
41
- // read the "kokoro-onnx not installed" hint back out).
42
- assert.deepEqual(captured[0].opts.stdio, ["ignore", "pipe", "pipe"]);
43
- });
44
-
45
- test("win32 without a resolvable npx-cli: falls through to the next provider (null), no spawn", async () => {
46
- const captured = [];
47
- const fakeExec = (...call) => captured.push(call);
48
-
49
- const result = await localTtsGenerate(
50
- "hello",
51
- {},
52
- "win32",
53
- fakeExec,
54
- {}, // no npm_execpath, and pathExists finds nothing
55
- () => false,
56
- );
57
-
58
- assert.equal(result, null);
59
- assert.equal(captured.length, 0);
60
- });
61
-
62
- test("non-win32: spawns plain npx unchanged", async () => {
63
- const captured = [];
64
- const fakeExec = (cmd, args) => captured.push({ cmd, args });
65
-
66
- await localTtsGenerate("hola", { lang: "es" }, "darwin", fakeExec, {}, () => false);
67
-
68
- assert.equal(captured.length, 1);
69
- assert.equal(captured[0].cmd, "npx");
70
- assert.deepEqual(captured[0].args.slice(0, 3), ["hyperframes", "tts", "hola"]);
71
- assert.ok(captured[0].args.includes("--lang"));
72
- });
73
-
74
16
  test("a launching CLI's entry file runs instead of npx, on every platform", async () => {
75
17
  for (const platform of ["darwin", "linux", "win32"]) {
76
18
  const captured = [];
77
- const fakeExec = (cmd, args) => captured.push({ cmd, args });
19
+ const fakeExec = (cmd, args, opts) => captured.push({ cmd, args, opts });
78
20
  const entry = "/opt/hf/dist/cli.js";
79
21
  const env = { ...envWithNpxCli, HYPERFRAMES_CLI_ENTRY: entry };
80
22
 
81
- await localTtsGenerate("hi", {}, platform, fakeExec, env, pathExists);
23
+ await localTtsGenerate(
24
+ "hello & there",
25
+ { voice: "am_michael" },
26
+ platform,
27
+ fakeExec,
28
+ env,
29
+ pathExists,
30
+ );
82
31
 
83
32
  assert.equal(captured.length, 1);
84
33
  assert.equal(captured[0].cmd, process.execPath);
85
- assert.deepEqual(captured[0].args.slice(0, 3), [entry, "tts", "hi"]);
34
+ assert.deepEqual(captured[0].args.slice(0, 3), [entry, "tts", "hello & there"]);
35
+ assert.ok(captured[0].args.includes("--voice"));
36
+ // execFileSync options survive (pipes are what let the caller read the
37
+ // "kokoro-onnx not installed" hint back out).
38
+ assert.deepEqual(captured[0].opts.stdio, ["ignore", "pipe", "pipe"]);
86
39
  }
87
40
  });
88
41
 
89
- test("a relative CLI entry is ignored and npx resolves as before", async () => {
90
- const captured = [];
91
- const fakeExec = (cmd, args) => captured.push({ cmd, args });
92
-
93
- await localTtsGenerate(
94
- "hi",
95
- {},
96
- "darwin",
97
- fakeExec,
98
- { HYPERFRAMES_CLI_ENTRY: "cli.js" },
99
- () => false,
100
- );
101
-
102
- assert.equal(captured[0].cmd, "npx");
42
+ test("without an absolute CLI entry: falls through to the next provider (null), no spawn", async () => {
43
+ for (const env of [envWithNpxCli, { ...envWithNpxCli, HYPERFRAMES_CLI_ENTRY: "cli.js" }]) {
44
+ for (const platform of ["darwin", "win32"]) {
45
+ const captured = [];
46
+ const errors = [];
47
+ const originalError = console.error;
48
+ console.error = (message) => errors.push(String(message));
49
+ try {
50
+ const fakeExec = (...call) => captured.push(call);
51
+ assert.equal(await localTtsGenerate("hi", {}, platform, fakeExec, env, pathExists), null);
52
+ } finally {
53
+ console.error = originalError;
54
+ }
55
+ assert.equal(captured.length, 0);
56
+ assert.match(errors.join("\n"), /HYPERFRAMES_CLI_ENTRY/);
57
+ }
58
+ }
103
59
  });