hyperframes 0.9.10 → 0.9.12

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 (194) hide show
  1. package/README.md +9 -0
  2. package/dist/{add-AFD3HNXB.js → add-NLR4EVAF.js} +6 -6
  3. package/dist/{agentPromptGenerator-XNGPKVEX.js → agentPromptGenerator-S3GWYMVC.js} +1 -1
  4. package/dist/{animatedGifPrep-E3PYKFJ3.js → animatedGifPrep-YU7IOD5D.js} +1 -1
  5. package/dist/api.js +13 -12
  6. package/dist/{asset-P6SF46UX.js → asset-7NPBAXDA.js} +2 -2
  7. package/dist/{assetCataloger-SDFP4DWL.js → assetCataloger-VKJIQCYP.js} +1 -1
  8. package/dist/{audio-DFQXEAEE.js → audio-ZNVUZH44.js} +12 -11
  9. package/dist/{auth-T62ANGDQ.js → auth-PTVZNLE6.js} +1 -1
  10. package/dist/{autoUpdate-3IT56KGL.js → autoUpdate-QJPCV7FB.js} +3 -3
  11. package/dist/{backgroundChecks-UKBVUYML.js → backgroundChecks-UA6LCZAG.js} +4 -4
  12. package/dist/backgroundChecksWorker.js +4 -4
  13. package/dist/{batchRender-ZDL65J7N.js → batchRender-W4RXBUNE.js} +6 -3
  14. package/dist/{beats-7UFMDXBY.js → beats-IG7C72YF.js} +6 -6
  15. package/dist/{benchmark-LCSHBJJF.js → benchmark-YUD3XIT2.js} +7 -7
  16. package/dist/{browser-5DZHA4EW.js → browser-TZILXH5J.js} +4 -4
  17. package/dist/{bundleWithLocalizedFonts-TJL2JWRD.js → bundleWithLocalizedFonts-BOIW3CIU.js} +2 -2
  18. package/dist/{capture-UKWY3SZQ.js → capture-MICLAF6V.js} +13 -13
  19. package/dist/{capture-HLC6I4RE.js → capture-R77HOGLQ.js} +3 -3
  20. package/dist/{captureCompositionFrame-YMB3CKSP.js → captureCompositionFrame-WBMFZHEF.js} +4 -4
  21. package/dist/{catalog-F2XB4VPP.js → catalog-AMPL57XF.js} +6 -6
  22. package/dist/{catch-up-HCBA3MIP.js → catch-up-WQ7ZRRFT.js} +5 -5
  23. package/dist/{check-E2RQCELF.js → check-ZPBF3X5D.js} +23 -23
  24. package/dist/{checkAudio-R4DRK3VG.js → checkAudio-IG3BOW2G.js} +3 -3
  25. package/dist/{checkBrowser-NGY225IO.js → checkBrowser-AIUIKFMJ.js} +17 -17
  26. package/dist/{chunk-BYC4C4YY.js → chunk-2VYAX3ZD.js} +2 -2
  27. package/dist/{chunk-GIYZMGYT.js → chunk-2VZVMCV6.js} +1 -1
  28. package/dist/{chunk-YTNHZT47.js → chunk-3IKLV3D4.js} +1 -1
  29. package/dist/chunk-3S27CPV7.js +17 -0
  30. package/dist/{chunk-NCP3JQ6S.js → chunk-4J4EGANW.js} +2 -2
  31. package/dist/{chunk-2CKL2FUJ.js → chunk-4XGASFTP.js} +2 -2
  32. package/dist/{chunk-XTYNW745.js → chunk-5WHGO5XU.js} +1 -1
  33. package/dist/{chunk-7VOLQUA2.js → chunk-64ZWPFAX.js} +1 -1
  34. package/dist/{upgrade-2FS4AMCA.js → chunk-6IFY3ZQC.js} +65 -27
  35. package/dist/{chunk-ZMXFRRQR.js → chunk-6NKEEHFR.js} +10 -15
  36. package/dist/{chunk-6HO6QKYG.js → chunk-6R2PED3X.js} +6 -6
  37. package/dist/{chunk-WWPOGMNX.js → chunk-73EXHUMD.js} +1 -1
  38. package/dist/{chunk-QPEDM2ZR.js → chunk-7XKWBMBL.js} +5 -3
  39. package/dist/{chunk-CDSTLOB7.js → chunk-B3IE7CN2.js} +8 -8
  40. package/dist/{chunk-BLBMPEBX.js → chunk-BONBJJ35.js} +1 -0
  41. package/dist/{chunk-Q3W7TDQX.js → chunk-BW2RIJKV.js} +238 -195
  42. package/dist/{chunk-B5GWDPUO.js → chunk-EPCVE3OX.js} +2 -2
  43. package/dist/{chunk-6UZLHLFP.js → chunk-FC4WF2VQ.js} +1 -1
  44. package/dist/{chunk-P4WYY52Y.js → chunk-FFUBISTD.js} +1 -1
  45. package/dist/{chunk-DKROJ3GJ.js → chunk-H7H7XNYY.js} +80 -20
  46. package/dist/{chunk-JZPUXDQE.js → chunk-HY64QA63.js} +1 -1
  47. package/dist/{chunk-RZFW7FBA.js → chunk-JKSASCBT.js} +2 -2
  48. package/dist/{chunk-PPMCILED.js → chunk-JS6ZTPYC.js} +4 -4
  49. package/dist/{chunk-7VU4RBHC.js → chunk-KDOJX2HU.js} +9 -9
  50. package/dist/{chunk-NBWYATVA.js → chunk-KT4KPBI7.js} +194 -17
  51. package/dist/{chunk-CBTBVRXB.js → chunk-LIN633KG.js} +4 -4
  52. package/dist/{chunk-WP5QHNXN.js → chunk-LO3EX3YP.js} +17 -5
  53. package/dist/{chunk-EN6MPNZT.js → chunk-NQYW4IYN.js} +2 -2
  54. package/dist/{chunk-NVYVI4FR.js → chunk-NTHJJ6JT.js} +3 -3
  55. package/dist/{chunk-QUBVGS27.js → chunk-OQKAP6X4.js} +4 -4
  56. package/dist/{chunk-QBPZHOEJ.js → chunk-P3KBDUNS.js} +1 -1
  57. package/dist/{chunk-CUYVIDGF.js → chunk-P7Y2YCOF.js} +1 -1
  58. package/dist/{chunk-BHL4KN3H.js → chunk-PKLZ5PV2.js} +1 -1
  59. package/dist/{chunk-6VKYITOR.js → chunk-Q225NLQL.js} +1 -1
  60. package/dist/{chunk-5CDTGHED.js → chunk-QFZ3ZSXI.js} +2 -2
  61. package/dist/{chunk-W4Q6VYPZ.js → chunk-RFTLWXEX.js} +2 -2
  62. package/dist/{chunk-G3ERWPNV.js → chunk-TNTQ7H24.js} +15 -1
  63. package/dist/{chunk-PO7LSMN5.js → chunk-UH62KSYV.js} +2 -2
  64. package/dist/{chunk-UDBNPVUR.js → chunk-URJ7T6T6.js} +1 -1
  65. package/dist/{chunk-MHZ7NSL5.js → chunk-VECINIPA.js} +1 -1
  66. package/dist/{chunk-2WNIF4YT.js → chunk-VUMGJLRB.js} +1 -1
  67. package/dist/{chunk-PYUS627M.js → chunk-VWQY3A64.js} +2 -2
  68. package/dist/{chunk-7VGM5TLZ.js → chunk-WQ4SMZDF.js} +2 -2
  69. package/dist/{chunk-WCETVN3N.js → chunk-WTGG734B.js} +24 -38
  70. package/dist/{chunk-YXSM33UC.js → chunk-X6XIY4JY.js} +9 -9
  71. package/dist/{skills-T5XCP3RC.js → chunk-XJG65BB2.js} +25 -32
  72. package/dist/{chunk-SRVAYGTN.js → chunk-XZP5OW5V.js} +5 -4
  73. package/dist/{chunk-GRUI2S2F.js → chunk-YEBIOQRI.js} +1 -1
  74. package/dist/{chunk-3XHWHH5A.js → chunk-Z2DJSEQC.js} +23 -23
  75. package/dist/{chunk-NO6F7CLR.js → chunk-Z4GE5BXC.js} +5 -2
  76. package/dist/{clean-BXHJEVVO.js → clean-343XOJT3.js} +8 -8
  77. package/dist/cli.js +60 -59
  78. package/dist/{cloud-ISWLTHGP.js → cloud-2YS272KD.js} +4 -4
  79. package/dist/{cloud-Z3FNCC4T.js → cloud-B6SGMECY.js} +3 -2
  80. package/dist/{compare-MLZYDSZD.js → compare-KXCTMXFX.js} +19 -16
  81. package/dist/{compiler-NAIDMQFU.js → compiler-KKIYPREA.js} +1 -1
  82. package/dist/{component-MMBTCMY3.js → component-ZUDCIGGD.js} +3 -3
  83. package/dist/{compositions-WT2577NJ.js → compositions-FNFI2QOA.js} +7 -7
  84. package/dist/{curve-HHKVZ6LX.js → curve-5BMBBCSZ.js} +5 -5
  85. package/dist/{cuts-66GBRT5P.js → cuts-OKUA6BWH.js} +5 -5
  86. package/dist/{delete-P3WYOC7I.js → delete-FYMFNSED.js} +7 -6
  87. package/dist/{deploy-OJ3M7QJQ.js → deploy-YZU2YITA.js} +8 -8
  88. package/dist/{describeProject-DN6YQU3X.js → describeProject-E44RWBJL.js} +1 -1
  89. package/dist/{diff-R74KQXXN.js → diff-5X6I6EG5.js} +20 -19
  90. package/dist/{dist-CCPYPKOC.js → dist-PUHEYGA5.js} +3 -3
  91. package/dist/{doctor-DT52W4UE.js → doctor-3DXWW63F.js} +9 -5
  92. package/dist/{energy-WOMDOOLC.js → energy-4HY7COXH.js} +5 -5
  93. package/dist/{events-YVQJLQWG.js → events-JAGPGK7R.js} +4 -4
  94. package/dist/{events-PCK4AIN5.js → events-TFVE7AUR.js} +3 -3
  95. package/dist/{events-WEVZ2ELP.js → events-ULVZ7V2C.js} +6 -6
  96. package/dist/{extract-CNXA3DWB.js → extract-5KTFRIH2.js} +11 -8
  97. package/dist/{face-2WNBW74C.js → face-T6D34LR7.js} +8 -7
  98. package/dist/{feedback-ADMM2XDS.js → feedback-QQQYENCU.js} +5 -5
  99. package/dist/{ffmpeg-PERZ6YHQ.js → ffmpeg-A2O4HSRD.js} +1 -1
  100. package/dist/{figma-5MMN5JUU.js → figma-4RODZMCT.js} +3 -3
  101. package/dist/fontLocalizeCli.js +3 -3
  102. package/dist/{frames-7CQGHRWT.js → frames-L43TSSAY.js} +5 -5
  103. package/dist/{generate-XOR4UJDW.js → generate-7HZKBLPZ.js} +9 -8
  104. package/dist/{get-5K6ALHBS.js → get-MXKV4NUL.js} +7 -6
  105. package/dist/{gpuPolicy-DUNSQM6M.js → gpuPolicy-TKHFDEH2.js} +2 -2
  106. package/dist/{grade-compare-DK63C776.js → grade-compare-KNXFKMFI.js} +18 -16
  107. package/dist/{heifImagePrep-YNPHFR6W.js → heifImagePrep-L2EY67F2.js} +1 -1
  108. package/dist/{help-AUF2KA6D.js → help-YN43ORVX.js} +3 -2
  109. package/dist/{history-G3FXVX4A.js → history-VAMN53LT.js} +7 -7
  110. package/dist/hyperframes-player.global.js +1 -1
  111. package/dist/{info-DGU3CIU5.js → info-QKEEGK2R.js} +6 -6
  112. package/dist/{init-LYZI2WCS.js → init-AAA44PYH.js} +15 -15
  113. package/dist/{ink-DYZG4BST.js → ink-V6CEFYB6.js} +5 -5
  114. package/dist/{inspect-BYQSCRKT.js → inspect-5JGTWCYO.js} +15 -15
  115. package/dist/{keyframes-XX2DIYPI.js → keyframes-FJNUSXAF.js} +7 -7
  116. package/dist/{lambda-RKI7KKWW.js → lambda-RYCG67CX.js} +3 -3
  117. package/dist/{layout-RQFOMQRO.js → layout-DXIPVY3W.js} +15 -15
  118. package/dist/{lint-LFCMCDEG.js → lint-JZADWIMR.js} +7 -7
  119. package/dist/{list-V4TGMQ3Y.js → list-YRLUJMP6.js} +7 -6
  120. package/dist/{localPage-6MQ6YFER.js → localPage-KIFKMB2B.js} +1 -1
  121. package/dist/{login-EXCG7PEH.js → login-H74JDEJ2.js} +4 -4
  122. package/dist/{look-RBHKHGMF.js → look-WVGBBYFE.js} +5 -5
  123. package/dist/{manager-ARXEX6OP.js → manager-T633Z2L4.js} +1 -1
  124. package/dist/{measure-SAV5K4WT.js → measure-DWQHHY3H.js} +11 -11
  125. package/dist/{media-treatment-2BVHRXJS.js → media-treatment-JHDDWRFU.js} +8 -8
  126. package/dist/{media-use-YEBYLITF.js → media-use-5SDC3MCE.js} +2 -1
  127. package/dist/{models-GMJODMZ5.js → models-6SOW23N6.js} +5 -5
  128. package/dist/{motionShot-Z63I3GO7.js → motionShot-B4K6LEU3.js} +12 -9
  129. package/dist/{normalize-audio-ILLUZPTO.js → normalize-audio-O6STMACD.js} +5 -5
  130. package/dist/{open-GTNLU7UF.js → open-VRCTXBD3.js} +5 -5
  131. package/dist/{parakeetRunner-K4EGDDVH.js → parakeetRunner-MNOIBRZZ.js} +5 -4
  132. package/dist/{pipeline-EKLTELWF.js → pipeline-N3M6VXBC.js} +4 -4
  133. package/dist/{play-F2HIXJKH.js → play-5WUZGJ4B.js} +10 -10
  134. package/dist/{preflight-QMXCKE5P.js → preflight-XZZXHV42.js} +1 -1
  135. package/dist/{present-GDR6LCKE.js → present-W7OODR7J.js} +10 -10
  136. package/dist/{preview-4TV5426Q.js → preview-NOQSYZAD.js} +9 -9
  137. package/dist/{probe-TYM7WKX2.js → probe-WFIYEXM5.js} +7 -6
  138. package/dist/{producer-NHQXKH7Y.js → producer-HI6M6755.js} +1 -1
  139. package/dist/{remove-background-LURZDSDJ.js → remove-background-SYHNGASQ.js} +5 -5
  140. package/dist/{render-GEAO2HAV.js → render-74JIGKTN.js} +13 -12
  141. package/dist/{render-YLAS7GVD.js → render-GYQZQB2O.js} +24 -21
  142. package/dist/{reverse-3KAZZXB2.js → reverse-NEC42AID.js} +1 -1
  143. package/dist/{run-XER4YJY5.js → run-Z6AW753F.js} +3 -3
  144. package/dist/{sherpa-D6FQ3CHN.js → sherpa-2ROE6TLC.js} +4 -3
  145. package/dist/skills/hyperframes/SKILL.md +2 -2
  146. package/dist/skills/hyperframes/references/plugin-installation.md +5 -6
  147. package/dist/skills/hyperframes/references/skill-lifecycle.md +15 -10
  148. package/dist/skills/hyperframes/scripts/plugin-cli.mjs +2 -2
  149. package/dist/skills/hyperframes-cli/SKILL.md +5 -3
  150. package/dist/skills/hyperframes-cli/references/init-and-scaffold.md +10 -14
  151. package/dist/skills/media-use/SKILL.md +2 -2
  152. package/dist/skills/media-use/audio/scripts/lib/sfx.mjs +2 -2
  153. package/dist/skills/media-use/audio/scripts/lib/tts.mjs +2 -0
  154. package/dist/skills/media-use/audio/scripts/lib/tts.test.mjs +14 -0
  155. package/dist/skills/media-use/references/heygen.md +1 -1
  156. package/dist/skills/media-use/scripts/lib/credit-limit.d.mts +3 -0
  157. package/dist/skills/media-use/scripts/lib/credit-limit.mjs +41 -0
  158. package/dist/skills/media-use/scripts/lib/credit-limit.test.mjs +39 -0
  159. package/dist/skills/media-use/scripts/lib/heygen-video-provider.mjs +2 -0
  160. package/dist/skills/media-use/scripts/lib/voice-provider.mjs +2 -0
  161. package/dist/skills-R56MSU2Y.js +49 -0
  162. package/dist/{skillsUpdateCheck-IG7KLWIA.js → skillsUpdateCheck-I6G3MQWO.js} +6 -4
  163. package/dist/{snapshot-RULSIRM6.js → snapshot-J2NU7WTJ.js} +18 -18
  164. package/dist/{src-DHBRQZFZ.js → src-5XQ6A3VE.js} +2 -2
  165. package/dist/{src-RL6YEPTD.js → src-L7UBHHKB.js} +1 -1
  166. package/dist/{start-GF3JCTGF.js → start-VUMSNLKC.js} +7 -6
  167. package/dist/{staticProjectServer-BX4RWEY5.js → staticProjectServer-2JYB7RLI.js} +5 -5
  168. package/dist/studio/assets/{hyperframes-player-BcELSci_.js → hyperframes-player-Dw-0BWQW.js} +1 -1
  169. package/dist/studio/assets/{index-DR2eua-L.js → index-BNZeN67E.js} +4 -4
  170. package/dist/studio/assets/{index-2SLNyxZG.js → index-NwWb1W86.js} +1 -1
  171. package/dist/studio/index.html +1 -1
  172. package/dist/{studio-api-PEUXVD7P.js → studio-api-MEZKFJBY.js} +3 -3
  173. package/dist/{studioServer-DOTRPHS3.js → studioServer-XGR4YPXX.js} +24 -24
  174. package/dist/{sync-XQPBXGGX.js → sync-ZIMGTQEN.js} +5 -5
  175. package/dist/{synthesize-YK3WLOEQ.js → synthesize-S3FF5KXC.js} +9 -6
  176. package/dist/{telemetry-7TIIOBVB.js → telemetry-PT5KSL5T.js} +4 -4
  177. package/dist/{telemetry-T73TKZOL.js → telemetry-WGNNQUSF.js} +1 -1
  178. package/dist/{templates-7DIQ52Y4.js → templates-7AT45DZI.js} +4 -1
  179. package/dist/{timeline-4JIUAUIP.js → timeline-IH422KGC.js} +9 -9
  180. package/dist/{tokens-4PQU4LVQ.js → tokens-ZVJMHDTM.js} +2 -2
  181. package/dist/{transcribe-IKUPC2R3.js → transcribe-FRRXA77O.js} +12 -11
  182. package/dist/{transcribe-N66QUYCS.js → transcribe-QIZGXMR5.js} +1 -1
  183. package/dist/{tts-HIQMJU6O.js → tts-IMW74GBX.js} +1 -1
  184. package/dist/update-E2RIAV5T.js +280 -0
  185. package/dist/{updateCheck-LBPTWEZV.js → updateCheck-EII7XDIR.js} +7 -3
  186. package/dist/upgrade-BKGP2TM7.js +40 -0
  187. package/dist/{upload-L5TSWWIU.js → upload-HMRWGZIO.js} +1 -1
  188. package/dist/{urlDownloader-YNI3Y3IE.js → urlDownloader-FOXK4FYP.js} +1 -1
  189. package/dist/{validate-MLVDUEK7.js → validate-M4FZVBRP.js} +13 -13
  190. package/dist/{video-2OEOTSPQ.js → video-AVEGMBDM.js} +1 -1
  191. package/dist/voices-E5RUGLJK.js +97 -0
  192. package/dist/warmCheck.js +23 -23
  193. package/package.json +1 -1
  194. package/dist/{destroy-C5GQLZVZ.js → destroy-IQLGADZM.js} +4 -4
@@ -4,6 +4,10 @@ import { dirname as __hf_dirname } from "node:path";
4
4
  var require = __hf_createRequire(import.meta.url);
5
5
  var __filename = __hf_fileURLToPath(import.meta.url);
6
6
  var __dirname = __hf_dirname(__filename);
7
+ import {
8
+ deliveryFlagArgs,
9
+ parseDeliveryFlags
10
+ } from "./chunk-QOF7XZEI.js";
7
11
  import {
8
12
  hasExplicitCompositionArg,
9
13
  resolveCompositionEntryArg
@@ -11,13 +15,9 @@ import {
11
15
  import {
12
16
  parseEnumFlag
13
17
  } from "./chunk-FPR57WRR.js";
14
- import {
15
- deliveryFlagArgs,
16
- parseDeliveryFlags
17
- } from "./chunk-QOF7XZEI.js";
18
18
  import {
19
19
  maybePromptRenderFeedback
20
- } from "./chunk-CBTBVRXB.js";
20
+ } from "./chunk-LIN633KG.js";
21
21
  import {
22
22
  reportVariableIssues,
23
23
  resolveVariablesArg,
@@ -27,7 +27,7 @@ import "./chunk-ZBAF6L74.js";
27
27
  import {
28
28
  renderJobObservabilityTelemetryPayload,
29
29
  startRenderCpuSampler
30
- } from "./chunk-P4WYY52Y.js";
30
+ } from "./chunk-FFUBISTD.js";
31
31
  import {
32
32
  formatLintStartupMessage
33
33
  } from "./chunk-X5EOH44V.js";
@@ -38,6 +38,9 @@ import {
38
38
  runEnvironmentChecks
39
39
  } from "./chunk-V6HV2IDT.js";
40
40
  import "./chunk-XQ26I3PL.js";
41
+ import {
42
+ makeOutputFolder
43
+ } from "./chunk-3S27CPV7.js";
41
44
  import {
42
45
  createRenderCancellationScope
43
46
  } from "./chunk-VM6T3Z6B.js";
@@ -57,7 +60,7 @@ import {
57
60
  import {
58
61
  RenderQualityError,
59
62
  extractSafeRenderErrorCode
60
- } from "./chunk-Q3W7TDQX.js";
63
+ } from "./chunk-BW2RIJKV.js";
61
64
  import "./chunk-M6JFR7KF.js";
62
65
  import "./chunk-EBUA6NWH.js";
63
66
  import "./chunk-42TYQPES.js";
@@ -66,15 +69,15 @@ import "./chunk-BZ56MTDX.js";
66
69
  import "./chunk-FI4I7CME.js";
67
70
  import {
68
71
  captureArtifactRevision
69
- } from "./chunk-QBPZHOEJ.js";
70
- import "./chunk-2WNIF4YT.js";
72
+ } from "./chunk-P3KBDUNS.js";
73
+ import "./chunk-VUMGJLRB.js";
74
+ import "./chunk-X7MTZ4T2.js";
71
75
  import {
72
76
  loadProducer
73
- } from "./chunk-WWPOGMNX.js";
74
- import "./chunk-X7MTZ4T2.js";
77
+ } from "./chunk-73EXHUMD.js";
75
78
  import {
76
79
  resolveProject
77
- } from "./chunk-7VOLQUA2.js";
80
+ } from "./chunk-64ZWPFAX.js";
78
81
  import {
79
82
  windowsChromeCrashRemediation
80
83
  } from "./chunk-262C25DQ.js";
@@ -123,8 +126,8 @@ import {
123
126
  trackRenderError,
124
127
  trackRenderObservation,
125
128
  trackRenderPreflightRejected
126
- } from "./chunk-5CDTGHED.js";
127
- import "./chunk-PO7LSMN5.js";
129
+ } from "./chunk-QFZ3ZSXI.js";
130
+ import "./chunk-UH62KSYV.js";
128
131
  import "./chunk-PXVQOMKL.js";
129
132
  import "./chunk-MCDNAIFF.js";
130
133
  import "./chunk-BVAPHHMQ.js";
@@ -153,7 +156,7 @@ import {
153
156
  import "./chunk-Z5J67X44.js";
154
157
  import "./chunk-5S7W3TUO.js";
155
158
  import "./chunk-D3MUHMFG.js";
156
- import "./chunk-PPMCILED.js";
159
+ import "./chunk-JS6ZTPYC.js";
157
160
  import "./chunk-YWRUQ7XZ.js";
158
161
  import {
159
162
  DISTRIBUTED_FPS,
@@ -220,7 +223,7 @@ import {
220
223
  releaseDeParallelRouterLatch,
221
224
  writeConfig,
222
225
  writeConfigWithResult
223
- } from "./chunk-BLBMPEBX.js";
226
+ } from "./chunk-BONBJJ35.js";
224
227
  import {
225
228
  isDevMode
226
229
  } from "./chunk-ISN5GRYI.js";
@@ -236,7 +239,7 @@ import "./chunk-J3RXEDR2.js";
236
239
  import "./chunk-QBXDU24O.js";
237
240
  import {
238
241
  VERSION
239
- } from "./chunk-7VGM5TLZ.js";
242
+ } from "./chunk-WQ4SMZDF.js";
240
243
  import {
241
244
  normalizeErrorMessage
242
245
  } from "./chunk-E63BDV4Z.js";
@@ -780,7 +783,7 @@ async function warnForSlideshow(plan) {
780
783
  }
781
784
 
782
785
  // src/commands/render/execute.ts
783
- import { mkdirSync, readFileSync as readFileSync3 } from "fs";
786
+ import { readFileSync as readFileSync3 } from "fs";
784
787
  import { tmpdir } from "os";
785
788
  function renderLintContinuationHint(strictErrors) {
786
789
  return strictErrors ? " Continuing render despite lint warnings. Use --strict-all to block warnings." : " Continuing render despite lint issues. Use --strict to block errors.";
@@ -791,11 +794,11 @@ function renderLintShouldAbort(strictErrors, strictAll, lintResult, definitiveEn
791
794
  async function executeRenderPlan(plan, dependencies, cancellation) {
792
795
  assertRenderActive(cancellation);
793
796
  applyRenderEnvironment(plan);
794
- if (!plan.batchPath) mkdirSync(renderOutputDirectory(plan), { recursive: true });
797
+ if (!plan.batchPath) makeOutputFolder(renderOutputDirectory(plan));
795
798
  let batchModule;
796
799
  let preparedBatch;
797
800
  if (plan.batchPath) {
798
- batchModule = await import("./batchRender-ZDL65J7N.js");
801
+ batchModule = await import("./batchRender-W4RXBUNE.js");
799
802
  try {
800
803
  preparedBatch = batchModule.prepareBatchRender({
801
804
  batchPath: plan.batchPath,
@@ -896,7 +899,7 @@ function assertRenderActive(cancellation) {
896
899
  cancellation?.signal.throwIfAborted();
897
900
  }
898
901
  async function refuseLowDiskBeforeBrowserDownload(plan) {
899
- const { checkDisk } = await import("./preflight-QMXCKE5P.js");
902
+ const { checkDisk } = await import("./preflight-XZZXHV42.js");
900
903
  await (await import("./manager-SAXHANEY.js")).sweepKilledInstalls();
901
904
  const paths = /* @__PURE__ */ new Set([tmpdir(), renderOutputDirectory(plan)]);
902
905
  const low = [...paths].map((path) => checkDisk(path)).filter((outcome) => !outcome.ok);
@@ -23,7 +23,7 @@ var reverse_default = defineCommand({
23
23
  description: "Open a reverse-any-video run (start)"
24
24
  },
25
25
  subCommands: {
26
- start: () => import("./start-GF3JCTGF.js").then((m) => m.default)
26
+ start: () => import("./start-VUMSNLKC.js").then((m) => m.default)
27
27
  }
28
28
  });
29
29
  export {
@@ -7,12 +7,12 @@ var __dirname = __hf_dirname(__filename);
7
7
  import {
8
8
  analyzeTargets,
9
9
  previewTarget
10
- } from "./chunk-QUBVGS27.js";
10
+ } from "./chunk-OQKAP6X4.js";
11
11
  import "./chunk-HBAUU3IK.js";
12
- import "./chunk-G3ERWPNV.js";
12
+ import "./chunk-TNTQ7H24.js";
13
13
  import "./chunk-TSQZ3DSC.js";
14
- import "./chunk-3XJM7XZN.js";
15
14
  import "./chunk-ETYQYG6Q.js";
15
+ import "./chunk-3XJM7XZN.js";
16
16
  import "./chunk-SWC3QIEH.js";
17
17
  import "./chunk-BVAPHHMQ.js";
18
18
  import "./chunk-2GICKZ3I.js";
@@ -17,8 +17,9 @@ import {
17
17
  sherpaRuntimeLoadError,
18
18
  sherpaUnsupportedReason,
19
19
  transcribeWithSherpa
20
- } from "./chunk-YTNHZT47.js";
21
- import "./chunk-NO6F7CLR.js";
20
+ } from "./chunk-3IKLV3D4.js";
21
+ import "./chunk-Z4GE5BXC.js";
22
+ import "./chunk-3S27CPV7.js";
22
23
  import "./chunk-5UT3R43E.js";
23
24
  import "./chunk-6BEFEWFB.js";
24
25
  import "./chunk-AUYRWWFL.js";
@@ -37,7 +38,7 @@ import "./chunk-N6FGHJ7X.js";
37
38
  import "./chunk-Z5J67X44.js";
38
39
  import "./chunk-5S7W3TUO.js";
39
40
  import "./chunk-D3MUHMFG.js";
40
- import "./chunk-PPMCILED.js";
41
+ import "./chunk-JS6ZTPYC.js";
41
42
  import "./chunk-YWRUQ7XZ.js";
42
43
  import "./chunk-W5AUD5OL.js";
43
44
  import "./chunk-MEJH7VEA.js";
@@ -3,13 +3,13 @@ name: hyperframes
3
3
  description: Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.
4
4
  ---
5
5
 
6
- **Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+ **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](references/plugin-installation.md).
7
7
 
8
8
  # HyperFrames
9
9
 
10
10
  HyperFrames renders HTML to video by seeking a paused timeline frame by frame, so every render is identical; the person edits the same files in the Studio preview. Use it unless another framework or a plain browser recording is asked for. Run the CLI as `npx hyperframes <command>` (`/hyperframes-cli`); at the start of a new video, `npx hyperframes usage --json` reports the person's remaining plan usage (say "unknown" when it is).
11
11
 
12
- `index.html` is the root composition: it declares the video's variables and mounts one scene per sub-composition from `compositions/`. Media and fonts live in `assets/`. A new project: `npx hyperframes init <dir>`. A website as the subject: `npx hyperframes capture <url> --json`.
12
+ `index.html` is the root composition: it declares the video's variables and mounts one scene per sub-composition from `compositions/`. Media and fonts live in `assets/`. A new project: `npx hyperframes init <dir> --skip-skills`. A website as the subject: `npx hyperframes capture <url> --json`.
13
13
 
14
14
  Build what was asked: no voiceover or captions and no new aspect ratio unless the request or the source calls for them; a film over ~15 s that tells something gets music and sound on its visible actions unless the person asked for silence (`references/sound.md`). A new video is 1920×1080 at 30 fps. A question, a hold or a loose idea gets an answer or a proposal, not an edit. Before hand-writing a named effect, transition, caption style, chart or card, search the registry (`/hyperframes-registry`). Any media (a presenter or avatar, footage, voice, music): `/media-use`, which says when HeyGen is needed and what is free. Show real things from their source (the product's screens, the brand's logo, a real place's imagery); draw only what has none.
15
15
 
@@ -3,11 +3,10 @@
3
3
  Check the directory two levels above the loaded `SKILL.md` for `plugin.json`,
4
4
  `.claude-plugin/plugin.json`, `.codex-plugin/plugin.json`, or
5
5
  `.cursor-plugin/plugin.json` identifying `hyperframes`, or a Gemini extension manifest.
6
- That directory is `<PLUGIN_ROOT>`. If none exists, this is a standalone skill;
7
- follow the normal installation and freshness instructions.
6
+ That directory is `<PLUGIN_ROOT>`. If none exists, this is a standalone skill
7
+ install; run `npx hyperframes` directly.
8
8
 
9
- For a plugin installation, these rules replace the standalone update commands
10
- in every skill and reference:
9
+ For a plugin installation, these rules apply in every skill and reference:
11
10
 
12
11
  - Do not run `hyperframes skills update`, `skills check`, or `npx skills add`.
13
12
  The agent's plugin manager owns installation and updates. Read the skill at
@@ -37,7 +36,7 @@ in every skill and reference:
37
36
  project or a temporary directory. Pass this plugin root and launcher convention
38
37
  to any delegated agent so it does not fall back to global skills.
39
38
 
40
- To get newer skills, use the client's plugin update flow and reload the session.
41
- Do not silently update an installed plugin during a video task.
39
+ Newer skills come through the client's plugin update flow and a session reload,
40
+ which the person runs. Do not update an installed plugin yourself.
42
41
 
43
42
  The launcher suppresses CLI update notices as well as standalone skill refreshes, including when running an older CLI with a stale notice cache. It passes the release as `HYPERFRAMES_PLUGIN_VERSION` for plugin-aware helpers and as `HYPERFRAMES_SKILL_PKG_VERSION` for the existing helper-package bootstrap. Our release process versions those packages together.
@@ -1,15 +1,15 @@
1
1
  # Skill installation and freshness
2
2
 
3
- Read this reference when installing or updating skills, diagnosing unexpected skill behavior, or running HyperFrames setup in CI.
3
+ Read this reference when the person asks about installing or updating skills, when diagnosing unexpected skill behavior, or when setting up HyperFrames in CI (see `HYPERFRAMES_SKIP_SKILLS` below). Skills are versioned with the CLI. Installing, updating and removing them is the person's step: tell them what is out of date and which command fits, and do not run it yourself.
4
4
 
5
5
  For a plugin installation, follow [plugin execution rules](plugin-installation.md); the plugin manager owns updates and every skill is bundled. The commands below apply only to standalone skills.
6
6
 
7
- - **Core set, installed eagerly:** `/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry` and `/media-use`.
8
- - **On demand:** `/figma`, `/slideshow`, `/remotion-to-hyperframes` and `/reverse-any-video`, installed with `npx hyperframes skills update <name>`.
7
+ - **Core set:** `/hyperframes`, `/hyperframes-cli`, `/hyperframes-registry` and `/media-use`.
8
+ - **On demand:** `/figma`, `/slideshow`, `/remotion-to-hyperframes`, `/reverse-any-video` and `/style-sampling`, which the person installs with `npx hyperframes skills update <name>`.
9
9
 
10
10
  ## What `init` does
11
11
 
12
- `npx hyperframes init` installs the core set when it is missing and leaves every skill that is already installed as it is: it never refreshes, replaces or removes one. Updating is `npx hyperframes skills update`, run by you. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.
12
+ Without `--skip-skills`, `npx hyperframes init` installs the core set when it is missing and leaves every skill that is already installed as it is: it never refreshes, replaces or removes one. Installing the core set is the person's step, so pass `--skip-skills` whenever you run `init`. When a core skill is missing, tell the person to run `npx hyperframes skills update`, which also updates the skills already installed. Offline or rate-limited checks degrade gracefully and do not fail project scaffolding.
13
13
 
14
14
  `--skip-skills` makes `init` leave skills alone. `HYPERFRAMES_SKIP_SKILLS=1` does the same for CI and tests.
15
15
 
@@ -19,14 +19,19 @@ For a plugin installation, follow [plugin execution rules](plugin-installation.m
19
19
 
20
20
  After `render`, `lint` and `validate`, the CLI prints `N HyperFrames skills out of date or missing` to stderr when the cached check finds stale skills, so an agent run without a terminal sees it too. It is off in CI, in dev, with `HYPERFRAMES_NO_UPDATE_CHECK=1` and with `HYPERFRAMES_SKIP_SKILLS=1`, and runs with `--json` too, since it only writes stderr and leaves `--json` stdout untouched.
21
21
 
22
- ## Diagnose and update
22
+ ## Diagnose, and what the person can run
23
23
 
24
24
  ```bash
25
25
  npx hyperframes skills check
26
26
  npx hyperframes skills check --json
27
- npx hyperframes skills update
28
- npx hyperframes skills update <name>
29
- npx hyperframes skills
27
+ ```
28
+
29
+ The person's install and update commands, to name when you relay a stale result:
30
+
31
+ ```bash
32
+ npx hyperframes skills update # the person runs this
33
+ npx hyperframes skills update <name> # the person runs this
34
+ npx hyperframes skills # the person runs this
30
35
  ```
31
36
 
32
37
  - `skills check` exits non-zero when an installed skill is stale or the core set is incomplete. Skills available on demand but not installed are not failures.
@@ -34,9 +39,9 @@ npx hyperframes skills
34
39
  - Named `skills update <name...>` also installs those named skills.
35
40
  - Bare `skills` installs the full published set explicitly.
36
41
 
37
- If the HyperFrames CLI is unavailable, use `npx skills add heygen-com/hyperframes --skill <name>` for one skill or `npx skills add heygen-com/hyperframes --all` for the full published set.
42
+ If the HyperFrames CLI is unavailable, the person can install with `npx skills add heygen-com/hyperframes --skill <name>` for one skill or `npx skills add heygen-com/hyperframes --all` for the full published set.
38
43
 
39
- The CLI may print a one-line stale-skill reminder during `render`, `lint`, or `check`. Treat a failed update as a visible tool failure; do not continue from a remembered skill.
44
+ The CLI may print a one-line stale-skill reminder during `render`, `lint`, or `check`. Relay it to the person and keep working from the installed skills; do not continue from a remembered skill.
40
45
 
41
46
  ## Keep the project's CLI current
42
47
 
@@ -29,7 +29,7 @@ export function pluginVersion(pluginRoot = root) {
29
29
  return manifest.version;
30
30
  }
31
31
  throw new Error(
32
- "No HyperFrames plugin manifest found. Use the standalone skills installation instructions.",
32
+ "No HyperFrames plugin manifest found. This is a standalone skill install; run `npx hyperframes` directly.",
33
33
  );
34
34
  }
35
35
 
@@ -45,7 +45,7 @@ export function invocation(
45
45
  ) {
46
46
  if (args[0] === "skills")
47
47
  throw new Error(
48
- "Update HyperFrames through your agent's plugin manager; bundled skills are release-managed.",
48
+ "Bundled skills are release-managed; the person updates HyperFrames through their agent's plugin manager.",
49
49
  );
50
50
  const childEnv = {
51
51
  ...env,
@@ -3,17 +3,19 @@ name: hyperframes-cli
3
3
  description: The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
4
4
  ---
5
5
 
6
- **Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+ **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
7
7
 
8
8
  # HyperFrames CLI
9
9
 
10
10
  Run `npx hyperframes <command>` unless the project gives a wrapper; then use the wrapper. It needs Node.js 22+ and FFmpeg. Every command has `--help`; most take `--json`, and a failure prints `✗ …`, a `Fix:` line and exits non-zero.
11
11
 
12
+ A `--json` result may carry `_meta.updateNotice`: a newer HyperFrames release is out. Pass it to the person once per conversation, in your own words, at a natural pause; updating is theirs to decide.
13
+
12
14
  ## Commands by job
13
15
 
14
16
  | Job | Commands |
15
17
  | --- | --- |
16
- | Start | `init <dir>` (blank; `--example <name>` only when asked), `capture <url>` |
18
+ | Start | `init <dir> --skip-skills` (blank; `--example <name>` only when asked), `capture <url>` |
17
19
  | Read a project | `info`, `compositions`, `timeline --json`, `docs <topic>` |
18
20
  | Check it | `lint` while writing; `check --json` as the gate (lint, runtime, layout, contrast) |
19
21
  | Look at it | `snapshot` (`--at <t,…>`, `--range START,END`, `--composition <id>`, `--zoom`, `--angle`, `--against <video>`), `keyframes`, `compare`, `audio` |
@@ -22,7 +24,7 @@ Run `npx hyperframes <command>` unless the project gives a wrapper; then use the
22
24
  | Media and sound | `media-treatment`, `grade-compare`, `remove-background`, `tts`, `transcribe`, `beats`, `normalize-audio` (`/media-use`) |
23
25
  | Show and ship | `preview`, `present` (`/slideshow`), `render`, `publish`, `cloud`, `lambda`, `cloudrun` |
24
26
  | Desktop app | `open`, `catch-up` |
25
- | Upkeep | `doctor`, `browser`, `upgrade`, `skills`, `usage`, `clean`, `feedback` |
27
+ | Upkeep | `doctor`, `browser`, `upgrade`, `usage`, `clean`, `feedback` |
26
28
 
27
29
  `validate`, `inspect` and `layout` are deprecated aliases of `check`; `events` is telemetry for skills' own scripts. Don't run them.
28
30
 
@@ -2,18 +2,18 @@
2
2
 
3
3
  <!-- registry-items: allow=blank,landscape-4k,portrait-4k,square-4k,media-use -->
4
4
 
5
- Scaffolding commands. Use these instead of creating files by hand — they set up the right file structure, copy media, run transcription, and install AI coding skills.
5
+ Scaffolding commands. Use these instead of creating files by hand — they set up the right file structure, copy media, and run transcription.
6
6
 
7
7
  ## init
8
8
 
9
9
  ```bash
10
- npx hyperframes init my-video # centered blank (TTY: wizard)
11
- npx hyperframes init my-video --example warm-grain # pick an example
12
- npx hyperframes init my-video --resolution portrait
13
- npx hyperframes init my-video --video clip.mp4 # with video file
14
- npx hyperframes init my-video --audio track.mp3 # with audio file
15
- npx hyperframes init my-video --tailwind # Tailwind v4 browser runtime
16
- npx hyperframes init my-video --non-interactive # CI — flag-only, same blank
10
+ npx hyperframes init my-video --skip-skills # centered blank (TTY: wizard)
11
+ npx hyperframes init my-video --skip-skills --example warm-grain # pick an example
12
+ npx hyperframes init my-video --skip-skills --resolution portrait
13
+ npx hyperframes init my-video --skip-skills --video clip.mp4 # with video file
14
+ npx hyperframes init my-video --skip-skills --audio track.mp3 # with audio file
15
+ npx hyperframes init my-video --skip-skills --tailwind # Tailwind v4 browser runtime
16
+ npx hyperframes init my-video --skip-skills --non-interactive # CI — flag-only, same blank
17
17
  ```
18
18
 
19
19
  **Default depends on TTY**: in a terminal, the CLI prompts for example/options (default: centered blank). Outside a TTY (CI, agents, piped output) it auto-switches to non-interactive and scaffolds that blank. Pass `--example` only to start from a named example. Pass `--non-interactive` to force flag-only mode on a TTY.
@@ -24,7 +24,7 @@ Other useful flags:
24
24
 
25
25
  - `--resolution` — preset: `landscape` (1920×1080), `portrait` (1080×1920), `landscape-4k`, `portrait-4k`, `square` (1080×1080), `square-4k`. Aliases: `1080p`, `4k`, `uhd`, `1080p-square`, `4k-square`.
26
26
  - `--skill=<slug>` — record the owning skill (e.g. `hyperframes`) in `hyperframes.json`, so every later render of this project — re-renders, `npm run render`, `--batch` — is attributed to it on usage telemetry without re-passing the flag. You rarely pass it by hand.
27
- - `--skip-skills` — leave AI coding skills alone: `init` does not install the core set. `HYPERFRAMES_SKIP_SKILLS=1` does the same.
27
+ - `--skip-skills` — leave AI coding skills alone: `init` does not install the core set. `HYPERFRAMES_SKIP_SKILLS=1` does the same. Always pass it: without it `init` installs any missing core skill, and installing skills is the person's step. When a core skill is missing, tell the person they can install it with `npx hyperframes skills update`.
28
28
  - `--skip-transcribe` — don't auto-transcribe `--audio` / `--video` with Whisper.
29
29
  - `--model`, `--language` — Whisper model / language for the auto-transcription.
30
30
 
@@ -72,8 +72,4 @@ into a fresh output directory; never merge or reuse a blocked attempt's partial
72
72
 
73
73
  ## skills
74
74
 
75
- ```bash
76
- npx hyperframes skills # install HyperFrames skills for AI coding tools
77
- ```
78
-
79
- One-time setup that adds the HyperFrames skill pack (/hyperframes with its references, /hyperframes-cli, /hyperframes-registry, /media-use, /figma, /slideshow, /remotion-to-hyperframes, /reverse-any-video) to the local AI coding environment so agents follow the framework conventions. Re-run after major HyperFrames upgrades.
75
+ `npx hyperframes skills` is the person's one-time setup: it adds the HyperFrames skill pack (/hyperframes with its references, /hyperframes-cli, /hyperframes-registry, /media-use, /figma, /slideshow, /remotion-to-hyperframes, /reverse-any-video, /style-sampling) to the local AI coding environment so agents follow the framework conventions. Skills are versioned with the CLI; after a HyperFrames upgrade the person can refresh them with `npx hyperframes skills update`. Tell them when that applies; do not run it yourself.
@@ -3,7 +3,7 @@ name: media-use
3
3
  description: Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.
4
4
  ---
5
5
 
6
- **Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin.
6
+ **Plugin installs:** Inside a HyperFrames plugin, follow [plugin execution rules](../hyperframes/references/plugin-installation.md).
7
7
 
8
8
  # Media in HyperFrames
9
9
 
@@ -35,7 +35,7 @@ It prints one line, `resolved <id> → <path> (<type>, <metadata>)`. List reusab
35
35
 
36
36
  **HeyGen.** `npx hyperframes media-use generate` makes images, shots, talking photos, voices and music on the sign-in alone. Helpers and direct recipes need the [`heygen` CLI](https://developers.heygen.com/cli); if it is missing, give the link and wait until they say it is installed. Direct `heygen` recipes bill that CLI's own login: use them only when that payer is selected.
37
37
 
38
- **Credits.** Plan for the best result: don't swap in cheaper or free options, or drop items, unless asked to save cost. Never tell the person prices, estimates or what a run used; `--plan` is for you. A credit limit the person sets: pass what is left of it as `--max-credits` on every `generate`, minus each call's `credits`, and never go past it. When a step won't fit (a `--plan` over what is left, or a refused call), say what doesn't fit and ask before dropping or shrinking it. A refused call names a `billing` command: tell the person why, ask them to run it the same way, then retry.
38
+ **Credits.** Plan for the best result: no cheaper or free swaps, no dropped items, unless asked to save cost. Never tell the person prices, estimates or usage; `--plan` is for you. A credit limit the person sets: write it once to `.hyperframes/credit-limit.json` as `{"credits": N}`; every paid call then refuses what would go past it (`--max-credits` only tightens). A step that won't fit (a `--plan` over what is left, or a refused call): say what doesn't, ask before dropping or shrinking it. A refused call names a `billing` command: say why, ask them to run it, then retry.
39
39
 
40
40
  ## Looks on real footage
41
41
 
@@ -146,8 +146,8 @@ export async function resolveSfx({ cues, hyperframesDir, sfxLibDir = BUNDLED_SFX
146
146
  } else if (!existsSync(dest)) {
147
147
  anomalies.push(
148
148
  `sfx "${name}" (id ${id}): bundled file ${hit.file} missing from the offline ` +
149
- `library (${sfxLibDir}) — skipped. Reinstall the media-use skill to ` +
150
- `restore assets/sfx/*.mp3.`,
149
+ `library (${sfxLibDir}) — skipped. Ask the person to reinstall the media-use ` +
150
+ `skill to restore assets/sfx/*.mp3.`,
151
151
  );
152
152
  return null;
153
153
  } // else the engine's earlier copy at dest stands in for the file this install lacks
@@ -1,4 +1,5 @@
1
1
  import { fetchMedia } from "../../../scripts/lib/media-fetch.mjs";
2
+ import { refuseUnderLimit } from "../../../scripts/lib/credit-limit.mjs";
2
3
  // tts.mjs — multi-provider TTS for the media audio engine. The provider chain,
3
4
  // auto-detected from env, is the one documented in ../SKILL.md:
4
5
  //
@@ -310,6 +311,7 @@ export async function synthesizeHeygen({ text, voiceId, lang, speed, wavAbs }, d
310
311
  const fetchImpl = deps.fetch ?? fetch;
311
312
  const transcode = deps.transcodeToWav ?? transcodeToWav;
312
313
  try {
314
+ refuseUnderLimit(deps.projectDir ?? process.cwd(), "a HeyGen voice", "voice");
313
315
  const body = { text, voice_id: voiceId, speed };
314
316
  if (lang !== "en") body.language = lang;
315
317
  const payload = await requestJSON(`/voices/speech`, {
@@ -228,3 +228,17 @@ test("pickProvider heygen with an unreadable credentials path says to fix that p
228
228
  rmSync(dir, { recursive: true, force: true });
229
229
  }
230
230
  });
231
+
232
+ test("synthesizeHeygen refuses under a credit limit before any request", async () => {
233
+ const dir = mkdtempSync(join(tmpdir(), "hf-tts-limit-"));
234
+ mkdirSync(join(dir, ".hyperframes"));
235
+ writeFileSync(join(dir, ".hyperframes", "credit-limit.json"), '{"credits": 5}');
236
+ let asked = false;
237
+ const r = await synthesizeHeygen(
238
+ { text: "hi", voiceId: "v", lang: "en", speed: 1, wavAbs: join(dir, "a.wav") },
239
+ { projectDir: dir, heygenJSON: async () => ((asked = true), {}) },
240
+ );
241
+ assert.equal(r.ok, false);
242
+ assert.match(r.error, /credit limit of 5/);
243
+ assert.equal(asked, false);
244
+ });
@@ -16,7 +16,7 @@ A refusal names its fix: `api_key_required` needs an API key, `402` or `insuffic
16
16
 
17
17
  ## Making media: `media-use generate`
18
18
 
19
- Make it without quoting a price or asking for a budget; `--plan` only prints what a call would cost (`credits` is an estimate in HyperFrames credits), for your own planning; never pass it on. When the person names a credit limit, keep under it with `--max-credits` (SKILL.md, Credits). Make a piece again only for a fault you can name (a cut inside it, text in it, the wrong framing), once, never to chase a motion or look score; a `content_policy_violation` gets one reworded try. A failed or refused job also gets one more try, test calls included; then stop and ask the person, without saying what was spent or what another try costs.
19
+ Make it without quoting a price or asking for a budget; `--plan` only prints what a call would cost (`credits` is an estimate in HyperFrames credits), for your own planning; never pass it on. When the person names a credit limit, record it in the project's credit-limit file (SKILL.md, Credits). Make a piece again only for a fault you can name (a cut inside it, text in it, the wrong framing), once, never to chase a motion or look score; a `content_policy_violation` gets one reworded try. A failed or refused job also gets one more try, test calls included; then stop and ask the person, without saying what was spent or what another try costs.
20
20
 
21
21
  ```bash
22
22
  # a still, edited from a reference picture: a clean plate with the words removed
@@ -0,0 +1,3 @@
1
+ export function creditLimit(projectDir: string): number | undefined;
2
+ export function creditsSpent(projectDir: string): { total: number; keys: Set<string> };
3
+ export function refuseUnderLimit(projectDir: string, what: string, generateType: string): void;
@@ -0,0 +1,41 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { join } from "node:path";
3
+
4
+ // A run's credit limit: the person's named total, in `.hyperframes/credit-limit.json` as {"credits": N}.
5
+ // What is spent is read back from the job log (`.hyperframes/heygen-jobs.jsonl`): the last credits a job key logged.
6
+
7
+ const read = (file) => (existsSync(file) ? readFileSync(file, "utf8") : "");
8
+
9
+ /** The limit set for this project, or undefined when the person named none. Unreadable is an error, never "none". */
10
+ export function creditLimit(projectDir) {
11
+ const text = read(join(projectDir, ".hyperframes", "credit-limit.json"));
12
+ if (!text) return undefined;
13
+ const credits = Number(JSON.parse(text)?.credits);
14
+ if (!Number.isFinite(credits) || credits < 0)
15
+ throw new Error(`${projectDir}/.hyperframes/credit-limit.json needs {"credits": <number>}`);
16
+ return credits;
17
+ }
18
+
19
+ /** Credits already committed by jobs in this project, and the job keys behind them. */
20
+ export function creditsSpent(projectDir) {
21
+ const charged = new Map();
22
+ for (const row of read(join(projectDir, ".hyperframes", "heygen-jobs.jsonl")).split("\n")) {
23
+ if (!row) continue;
24
+ const { key, credits } = JSON.parse(row);
25
+ if (key && typeof credits === "number") charged.set(key, credits);
26
+ }
27
+ return {
28
+ total: [...charged.values()].reduce((a, b) => a + b, 0),
29
+ keys: new Set([...charged].filter(([, c]) => c > 0).map(([k]) => k)),
30
+ };
31
+ }
32
+
33
+ /** The engine shells out to `heygen`, which prices nothing here: under a limit those calls are refused, and
34
+ * `media-use generate` (priced, counted against the limit) is the way to make the same piece. */
35
+ export function refuseUnderLimit(projectDir, what, generateType) {
36
+ const limit = creditLimit(projectDir);
37
+ if (limit === undefined) return;
38
+ throw new Error(
39
+ `media-use: ${what} cannot be priced here, so it cannot be kept under the run's credit limit of ${limit}; nothing was made. Make it with \`npx hyperframes media-use generate --type ${generateType}\`, which counts against the limit`,
40
+ );
41
+ }
@@ -0,0 +1,39 @@
1
+ import { strict as assert } from "node:assert";
2
+ import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
3
+ import { tmpdir } from "node:os";
4
+ import { join } from "node:path";
5
+ import { test } from "node:test";
6
+ import { heygenTtsGenerate } from "./voice-provider.mjs";
7
+ import { creditLimit, creditsSpent } from "./credit-limit.mjs";
8
+
9
+ function project(files) {
10
+ const dir = mkdtempSync(join(tmpdir(), "hf-limit-"));
11
+ mkdirSync(join(dir, ".hyperframes"));
12
+ for (const [name, text] of Object.entries(files))
13
+ writeFileSync(join(dir, ".hyperframes", name), text);
14
+ return dir;
15
+ }
16
+
17
+ test("no limit file means no limit; a malformed one is an error, not no limit", () => {
18
+ assert.equal(creditLimit(project({})), undefined);
19
+ assert.equal(creditLimit(project({ "credit-limit.json": '{"credits": 500}' })), 500);
20
+ assert.throws(() => creditLimit(project({ "credit-limit.json": '{"credits": "lots"}' })));
21
+ });
22
+
23
+ test("spent is the last credits each job key logged", () => {
24
+ const rows = [
25
+ { key: "a", credits: 50 },
26
+ { key: "a", credits: 0 },
27
+ { key: "b", credits: 30 },
28
+ { key: "b", status: "completed" },
29
+ ];
30
+ const dir = project({ "heygen-jobs.jsonl": rows.map((r) => JSON.stringify(r)).join("\n") });
31
+ const spent = creditsSpent(dir);
32
+ assert.equal(spent.total, 30);
33
+ assert.deepEqual([...spent.keys], ["b"]);
34
+ });
35
+
36
+ test("resolve's HeyGen voice is refused under a limit before the heygen CLI runs", async () => {
37
+ const dir = project({ "credit-limit.json": '{"credits": 10}' });
38
+ await assert.rejects(heygenTtsGenerate("hello", { projectDir: dir }), /credit limit of 10/);
39
+ });
@@ -2,6 +2,7 @@ import { execFileSync } from "node:child_process";
2
2
  import { mkdtempSync, rmSync } from "node:fs";
3
3
  import { tmpdir } from "node:os";
4
4
  import { join } from "node:path";
5
+ import { refuseUnderLimit } from "./credit-limit.mjs";
5
6
  import { freezeUrl } from "./freeze.mjs";
6
7
  import {
7
8
  classifyHeygenErrorCode,
@@ -44,6 +45,7 @@ function defaultStarfishVoiceId(onError) {
44
45
  }
45
46
 
46
47
  export async function heygenVideoGenerate(intent, ctx) {
48
+ refuseUnderLimit(ctx?.projectDir ?? process.cwd(), "a HeyGen avatar video", "avatar");
47
49
  let discoveryFailureReason = null;
48
50
  const captureReason = (reason) => {
49
51
  discoveryFailureReason ??= reason;
@@ -1,3 +1,4 @@
1
+ import { refuseUnderLimit } from "./credit-limit.mjs";
1
2
  import { HEYGEN_CLIENT_SOURCE_ARGV, runHeygenJson } from "./heygen-cli.mjs";
2
3
 
3
4
  // Voice / TTS generation via the HeyGen CLI — the only external CLI media-use
@@ -37,6 +38,7 @@ function defaultVoiceId() {
37
38
  }
38
39
 
39
40
  export async function heygenTtsGenerate(intent, ctx) {
41
+ refuseUnderLimit(ctx?.projectDir ?? process.cwd(), "a HeyGen voice", "voice");
40
42
  const voiceId = ctx?.voiceId || defaultVoiceId();
41
43
  if (!voiceId) return null;
42
44
  const p = runHeygenJson(
@@ -0,0 +1,49 @@
1
+ import { createRequire as __hf_createRequire } from "node:module";
2
+ import { fileURLToPath as __hf_fileURLToPath } from "node:url";
3
+ import { dirname as __hf_dirname } from "node:path";
4
+ var require = __hf_createRequire(import.meta.url);
5
+ var __filename = __hf_fileURLToPath(import.meta.url);
6
+ var __dirname = __hf_dirname(__filename);
7
+ import {
8
+ examples,
9
+ skillsManagedExternally,
10
+ skills_default,
11
+ updateSkills
12
+ } from "./chunk-XJG65BB2.js";
13
+ import "./chunk-CIWX5UKC.js";
14
+ import "./chunk-WJD3GVAA.js";
15
+ import "./chunk-6BEFEWFB.js";
16
+ import "./chunk-QFZ3ZSXI.js";
17
+ import "./chunk-UH62KSYV.js";
18
+ import "./chunk-PXVQOMKL.js";
19
+ import "./chunk-MCDNAIFF.js";
20
+ import "./chunk-BVAPHHMQ.js";
21
+ import "./chunk-DL4OD7IA.js";
22
+ import "./chunk-S3S4TGEH.js";
23
+ import "./chunk-54HJ63Q2.js";
24
+ import "./chunk-2GICKZ3I.js";
25
+ import "./chunk-TK7THLRO.js";
26
+ import "./chunk-FXMKHHPO.js";
27
+ import "./chunk-LAGZGKKN.js";
28
+ import "./chunk-FBN2M2HK.js";
29
+ import "./chunk-WTGG734B.js";
30
+ import "./chunk-KT4KPBI7.js";
31
+ import "./chunk-BR2JQQC5.js";
32
+ import "./chunk-BONBJJ35.js";
33
+ import "./chunk-ISN5GRYI.js";
34
+ import "./chunk-ADVVQX4I.js";
35
+ import "./chunk-66W5IWLO.js";
36
+ import "./chunk-J3RXEDR2.js";
37
+ import "./chunk-QBXDU24O.js";
38
+ import "./chunk-WQ4SMZDF.js";
39
+ import "./chunk-E63BDV4Z.js";
40
+ import "./chunk-G7VEYUZ2.js";
41
+ import "./chunk-XT6MXC7A.js";
42
+ import "./chunk-7KDQAD2W.js";
43
+ import "./chunk-M2WBOQ2Q.js";
44
+ export {
45
+ skills_default as default,
46
+ examples,
47
+ skillsManagedExternally,
48
+ updateSkills
49
+ };