@qvac/sdk 0.17.1 → 0.18.1

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 (156) hide show
  1. package/NOTICE +124 -64
  2. package/README.md +19 -0
  3. package/dist/client/api/audio-gen.d.ts +17 -0
  4. package/dist/client/api/audio-gen.js +17 -0
  5. package/dist/client/api/finetune.d.ts +2 -0
  6. package/dist/client/api/finetune.js +7 -1
  7. package/dist/client/api/index.d.ts +1 -1
  8. package/dist/client/api/index.js +1 -1
  9. package/dist/client/api/load-model.d.ts +8 -0
  10. package/dist/client/api/transcribe.d.ts +19 -2
  11. package/dist/client/api/transcribe.js +66 -27
  12. package/dist/client/api/translate.d.ts +1 -0
  13. package/dist/client/api/translate.js +40 -19
  14. package/dist/client/api/vla.d.ts +42 -1
  15. package/dist/client/api/vla.js +50 -1
  16. package/dist/commands/bundle/entry-gen.d.ts +4 -0
  17. package/dist/commands/bundle/entry-gen.js +6 -0
  18. package/dist/commands/bundle/index.js +19 -12
  19. package/dist/examples/asr/parakeet-indic-conformer-filesystem.d.ts +2 -0
  20. package/dist/examples/asr/parakeet-indic-conformer-filesystem.js +52 -0
  21. package/dist/examples/audiogen/generate-cover.d.ts +2 -0
  22. package/dist/examples/audiogen/generate-cover.js +100 -0
  23. package/dist/examples/llamacpp-fallback.d.ts +2 -0
  24. package/dist/examples/llamacpp-fallback.js +34 -0
  25. package/dist/examples/multi-job-completion.d.ts +28 -0
  26. package/dist/examples/multi-job-completion.js +128 -0
  27. package/dist/examples/profiling/basic.js +32 -1
  28. package/dist/examples/system-resources.d.ts +2 -0
  29. package/dist/examples/system-resources.js +86 -0
  30. package/dist/examples/tts/audio8.d.ts +2 -0
  31. package/dist/examples/tts/audio8.js +54 -0
  32. package/dist/examples/tts/cosyvoice3.d.ts +2 -0
  33. package/dist/examples/tts/cosyvoice3.js +52 -0
  34. package/dist/examples/vla-groot.js +92 -49
  35. package/dist/index.d.ts +2 -2
  36. package/dist/index.js +2 -2
  37. package/dist/models/registry/models.d.ts +782 -6
  38. package/dist/models/registry/models.js +2664 -1859
  39. package/dist/schemas/audio-gen.d.ts +103 -0
  40. package/dist/schemas/audio-gen.js +135 -4
  41. package/dist/schemas/common.d.ts +550 -11
  42. package/dist/schemas/constants-registry.d.ts +18 -4
  43. package/dist/schemas/constants-registry.js +16 -3
  44. package/dist/schemas/index.d.ts +1 -1
  45. package/dist/schemas/index.js +1 -1
  46. package/dist/schemas/llamacpp-config.d.ts +10 -10
  47. package/dist/schemas/llamacpp-config.js +168 -82
  48. package/dist/schemas/load-model.d.ts +3678 -323
  49. package/dist/schemas/load-model.js +21 -3
  50. package/dist/schemas/public.d.ts +3 -0
  51. package/dist/schemas/public.js +6 -0
  52. package/dist/schemas/sdk-config.d.ts +60 -24
  53. package/dist/schemas/sdk-errors-server.d.ts +1 -0
  54. package/dist/schemas/sdk-errors-server.js +5 -0
  55. package/dist/schemas/text-to-speech.d.ts +1086 -110
  56. package/dist/schemas/text-to-speech.js +194 -4
  57. package/dist/schemas/tools.d.ts +0 -16
  58. package/dist/schemas/tools.js +0 -15
  59. package/dist/schemas/transcription-config.d.ts +2 -0
  60. package/dist/schemas/transcription-config.js +10 -4
  61. package/dist/schemas/transcription.d.ts +3 -0
  62. package/dist/schemas/vla.d.ts +83 -0
  63. package/dist/schemas/vla.js +105 -2
  64. package/dist/scripts/link-workspace-inference.d.ts +2 -0
  65. package/dist/scripts/link-workspace-inference.js +31 -0
  66. package/dist/server/bare/ops/cancel.d.ts +1 -1
  67. package/dist/server/bare/ops/cancel.js +1 -1
  68. package/dist/server/bare/ops/kv-cache-retention.js +11 -0
  69. package/dist/server/bare/ops/kv-cache-utils.d.ts +1 -1
  70. package/dist/server/bare/ops/kv-cache-utils.js +40 -12
  71. package/dist/server/bare/ops/transcribe.d.ts +2 -2
  72. package/dist/server/bare/ops/transcribe.js +54 -48
  73. package/dist/server/bare/ops/translate-stats.d.ts +5 -0
  74. package/dist/server/bare/ops/translate-stats.js +11 -0
  75. package/dist/server/bare/ops/translate.js +66 -38
  76. package/dist/server/bare/ops/unload-model.js +30 -24
  77. package/dist/server/bare/plugins/audiogen-ggml/ops/audio-gen-input.d.ts +20 -0
  78. package/dist/server/bare/plugins/audiogen-ggml/ops/audio-gen-input.js +153 -0
  79. package/dist/server/bare/plugins/audiogen-ggml/ops/audio-gen-stream.js +52 -1
  80. package/dist/server/bare/plugins/audiogen-ggml/plugin.d.ts +28 -0
  81. package/dist/server/bare/plugins/ggml-ocr/plugin.js +3 -1
  82. package/dist/server/bare/plugins/ggml-vla/ops/vla-set-embodiment.d.ts +3 -0
  83. package/dist/server/bare/plugins/ggml-vla/ops/vla-set-embodiment.js +9 -0
  84. package/dist/server/bare/plugins/ggml-vla/plugin.d.ts +37 -0
  85. package/dist/server/bare/plugins/ggml-vla/plugin.js +21 -4
  86. package/dist/server/bare/plugins/llamacpp-completion/ops/batch-completion-stream.js +16 -15
  87. package/dist/server/bare/plugins/llamacpp-completion/ops/cache-logger.d.ts +1 -1
  88. package/dist/server/bare/plugins/llamacpp-completion/ops/cache-logger.js +2 -2
  89. package/dist/server/bare/plugins/llamacpp-completion/ops/completion-stats.d.ts +6 -0
  90. package/dist/server/bare/plugins/llamacpp-completion/ops/completion-stats.js +10 -0
  91. package/dist/server/bare/plugins/llamacpp-completion/ops/completion-stream.d.ts +1 -0
  92. package/dist/server/bare/plugins/llamacpp-completion/ops/completion-stream.js +131 -123
  93. package/dist/server/bare/plugins/llamacpp-completion/ops/finetune.js +110 -20
  94. package/dist/server/bare/plugins/llamacpp-completion/ops/kv-cache-session.d.ts +49 -23
  95. package/dist/server/bare/plugins/llamacpp-completion/ops/kv-cache-session.js +308 -143
  96. package/dist/server/bare/plugins/llamacpp-completion/ops/kv-cache-state.d.ts +1 -0
  97. package/dist/server/bare/plugins/llamacpp-completion/ops/kv-cache-state.js +2 -2
  98. package/dist/server/bare/plugins/llamacpp-completion/plugin.d.ts +6 -6
  99. package/dist/server/bare/plugins/llamacpp-completion/plugin.js +55 -36
  100. package/dist/server/bare/plugins/llamacpp-completion/transform.js +1 -7
  101. package/dist/server/bare/plugins/llamacpp-embedding/plugin.js +2 -3
  102. package/dist/server/bare/plugins/nmtcpp-translation/plugin.js +6 -5
  103. package/dist/server/bare/plugins/parakeet-transcription/plugin.js +27 -16
  104. package/dist/server/bare/plugins/tts-ggml/ops/parler-options.js +23 -3
  105. package/dist/server/bare/plugins/tts-ggml/plugin.d.ts +302 -4
  106. package/dist/server/bare/plugins/tts-ggml/plugin.js +131 -0
  107. package/dist/server/bare/plugins/whispercpp-transcription/plugin.js +48 -39
  108. package/dist/server/bare/registry/model-registry.d.ts +1 -0
  109. package/dist/server/bare/runtime/request-registry-singleton.js +29 -15
  110. package/dist/server/bare/runtime/request-registry.d.ts +27 -0
  111. package/dist/server/bare/runtime/request-registry.js +246 -76
  112. package/dist/server/bare/types/addon-responses.d.ts +4 -12
  113. package/dist/server/rpc/handlers/load-model/handler.js +2 -2
  114. package/dist/server/rpc/handlers/load-model/resolve-session.d.ts +1 -1
  115. package/dist/server/rpc/handlers/load-model/resolve-session.js +3 -3
  116. package/dist/server/rpc/handlers/load-model/resolve.d.ts +12 -2
  117. package/dist/server/rpc/handlers/load-model/resolve.js +90 -12
  118. package/dist/server/utils/audio/decoder.d.ts +37 -1
  119. package/dist/server/utils/audio/decoder.js +81 -51
  120. package/dist/server/utils/config-transform.d.ts +3 -0
  121. package/dist/server/utils/config-transform.js +6 -0
  122. package/dist/server/utils/index.d.ts +0 -1
  123. package/dist/server/utils/index.js +0 -1
  124. package/dist/server/utils/shard-utils.d.ts +1 -0
  125. package/dist/server/utils/shard-utils.js +14 -0
  126. package/dist/server/utils/tool-integration.d.ts +3 -10
  127. package/dist/server/utils/tool-integration.js +3 -12
  128. package/dist/utils/errors-server.d.ts +3 -0
  129. package/dist/utils/errors-server.js +5 -0
  130. package/package.json +17 -14
  131. package/dist/examples/llamacpp-dynamic-tools.d.ts +0 -2
  132. package/dist/examples/llamacpp-dynamic-tools.js +0 -152
  133. package/dist/models/update-models/codegen.d.ts +0 -3
  134. package/dist/models/update-models/codegen.js +0 -196
  135. package/dist/models/update-models/companions.d.ts +0 -30
  136. package/dist/models/update-models/companions.js +0 -296
  137. package/dist/models/update-models/history.d.ts +0 -24
  138. package/dist/models/update-models/history.js +0 -107
  139. package/dist/models/update-models/index.d.ts +0 -2
  140. package/dist/models/update-models/index.js +0 -123
  141. package/dist/models/update-models/naming.d.ts +0 -4
  142. package/dist/models/update-models/naming.js +0 -396
  143. package/dist/models/update-models/processing.d.ts +0 -8
  144. package/dist/models/update-models/processing.js +0 -65
  145. package/dist/models/update-models/registry.d.ts +0 -5
  146. package/dist/models/update-models/registry.js +0 -87
  147. package/dist/models/update-models/shards.d.ts +0 -4
  148. package/dist/models/update-models/shards.js +0 -57
  149. package/dist/models/update-models/types.d.ts +0 -88
  150. package/dist/models/update-models/types.js +0 -1
  151. package/dist/models/update-models/utils.d.ts +0 -3
  152. package/dist/models/update-models/utils.js +0 -21
  153. package/dist/server/bare/plugins/llamacpp-completion/ops/batch-cancelled.d.ts +0 -23
  154. package/dist/server/bare/plugins/llamacpp-completion/ops/batch-cancelled.js +0 -30
  155. package/dist/server/utils/expand-gguf-shards.d.ts +0 -3
  156. package/dist/server/utils/expand-gguf-shards.js +0 -22
package/NOTICE CHANGED
@@ -63,14 +63,24 @@ Third-Party Model Licenses
63
63
 
64
64
  abot-world-0-5b-lf-dit-q8_0
65
65
  https://huggingface.co/acvlab/ABot-World-0-5B-LF
66
+ audio8-codec-decoder-f16
67
+ https://huggingface.co/Audio8/Audio8-TTS-Preview-0.6b
68
+ audio8-codec-encoder-f16
69
+ https://huggingface.co/Audio8/Audio8-TTS-Preview-0.6b
70
+ audio8-lm-f16
71
+ https://huggingface.co/Audio8/Audio8-TTS-Preview-0.6b
66
72
  bci-embedder
67
73
  https://github.com/tetherto/qvac/releases/download/bci-test-assets-v0.1.0/bci-embedder.bin
74
+ cosyvoice3-campplus-f32
75
+ https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
68
76
  cosyvoice3-flow-f32
69
77
  https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
70
78
  cosyvoice3-hift-f32
71
79
  https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
72
80
  cosyvoice3-llm-q8_0
73
81
  https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
82
+ cosyvoice3-s3tok-f16
83
+ https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
74
84
  craft_mlt_25k
75
85
  https://www.jaided.ai/easyocr/modelhub/
76
86
  crnn_mobilenet_v3_small
@@ -179,6 +189,8 @@ Third-Party Model Licenses
179
189
  https://huggingface.co/unsloth/Qwen3.6-27B-GGUF
180
190
  Qwen3.6-35B-A3B-GGUF
181
191
  https://huggingface.co/unsloth/Qwen3.6-35B-A3B-GGUF
192
+ Qwen3.8-27B-GGUF
193
+ https://huggingface.co/unsloth/Qwen3.8-27B-GGUF
182
194
  ru-base-ggml-model-f16
183
195
  https://huggingface.co/CheeLi03/whisper-base-rus-8
184
196
  ru-tiny-ggml-model-f16
@@ -199,6 +211,10 @@ Third-Party Model Licenses
199
211
  https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged
200
212
  unlimited-ocr-gguf
201
213
  https://huggingface.co/vimalnakrani/unlimited-ocr-gguf
214
+ VisionPsy-Nano-460M-Flash-GGUFs
215
+ https://huggingface.co/qvac/VisionPsy-Nano-460M-Flash-GGUFs
216
+ VisionPsy-Nano-460M-GGUFs
217
+ https://huggingface.co/qvac/VisionPsy-Nano-460M-GGUFs
202
218
  voice-en
203
219
  https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
204
220
  voice-zh-2
@@ -348,6 +364,12 @@ Third-Party Model Licenses
348
364
  https://huggingface.co/ChristianAzinn/gte-large-gguf
349
365
  gte-large-gguf
350
366
  https://huggingface.co/ChristianAzinn/gte-large-gguf
367
+ indic-conformer-ctc.f16
368
+ https://huggingface.co/ai4bharat/indic-conformer
369
+ indic-conformer-ctc.q4_0
370
+ https://huggingface.co/ai4bharat/indic-conformer
371
+ indic-conformer-ctc.q8_0
372
+ https://huggingface.co/ai4bharat/indic-conformer
351
373
  lavasr-denoiser-f16
352
374
  https://huggingface.co/spaces/YatharthS
353
375
  lavasr-enhancer-f16
@@ -632,13 +654,13 @@ JavaScript Dependencies
632
654
 
633
655
  @hyperswarm/secret-stream@6.9.1
634
656
  https://github.com/holepunchto/hyperswarm-secret-stream
635
- @qvac/asr-ggml@0.1.1
657
+ @qvac/asr-ggml@0.3.2
636
658
  https://github.com/tetherto/qvac
637
- @qvac/audiogen-ggml@0.1.1
659
+ @qvac/audiogen-ggml@0.2.3
638
660
  https://github.com/tetherto/qvac
639
- @qvac/bci-whispercpp@0.6.0
661
+ @qvac/bci-whispercpp@0.7.2
640
662
  https://github.com/tetherto/qvac
641
- @qvac/classification-ggml@0.15.1
663
+ @qvac/classification-ggml@0.20.0
642
664
  https://github.com/tetherto/qvac
643
665
  @qvac/decoder-audio@0.5.0
644
666
  https://github.com/tetherto/qvac
@@ -646,10 +668,10 @@ JavaScript Dependencies
646
668
  https://github.com/tetherto/qvac
647
669
  @qvac/diffusion-cpp@0.17.0
648
670
  https://github.com/tetherto/qvac
649
- @qvac/embed-llamacpp@0.30.1
671
+ @qvac/embed-llamacpp@0.34.0
650
672
  https://github.com/tetherto/qvac
651
673
  @qvac/error@0.1.1
652
- @qvac/fabric@0.3.1
674
+ @qvac/fabric@0.6.0
653
675
  https://github.com/tetherto/qvac
654
676
  @qvac/infer-base@0.4.2
655
677
  https://github.com/tetherto/qvac
@@ -657,11 +679,10 @@ JavaScript Dependencies
657
679
  https://github.com/tetherto/qvac
658
680
  @qvac/langdetect-text@0.1.2
659
681
  https://github.com/tetherto/qvac
660
- @qvac/llm-llamacpp@0.39.4
661
- https://github.com/tetherto/qvac
662
- @qvac/logging@0.1.1
682
+ @qvac/llm-llamacpp@0.45.0
663
683
  https://github.com/tetherto/qvac
664
- @qvac/ocr-ggml@0.13.1
684
+ @qvac/logging@0.1.0
685
+ @qvac/ocr-ggml@0.18.0
665
686
  https://github.com/tetherto/qvac
666
687
  @qvac/rag@0.6.4
667
688
  https://github.com/tetherto/qvac
@@ -669,11 +690,11 @@ JavaScript Dependencies
669
690
  https://github.com/tetherto/qvac
670
691
  @qvac/registry-schema@0.3.0
671
692
  https://github.com/tetherto/qvac
672
- @qvac/translation-nmtcpp@8.3.1
693
+ @qvac/translation-nmtcpp@0.10.0
673
694
  https://github.com/tetherto/qvac
674
- @qvac/tts-ggml@0.6.3
695
+ @qvac/tts-ggml@0.7.4
675
696
  https://github.com/tetherto/qvac
676
- @qvac/vla-ggml@0.16.2
697
+ @qvac/vla-ggml@0.21.1
677
698
  https://github.com/tetherto/qvac
678
699
  adaptive-timeout@1.0.1
679
700
  https://github.com/holepunchto/adaptive-timeout
@@ -683,35 +704,43 @@ JavaScript Dependencies
683
704
  https://github.com/holepunchto/bare-abort
684
705
  bare-abort-controller@1.1.2
685
706
  https://github.com/holepunchto/bare-abort-controller
686
- bare-addon-resolve@1.10.1
707
+ bare-addon-resolve@1.10.0
687
708
  https://github.com/holepunchto/bare-addon-resolve
688
709
  bare-ansi-escapes@2.2.3
689
710
  https://github.com/holepunchto/bare-ansi-escapes
690
711
  bare-assert@1.2.0
691
712
  https://github.com/holepunchto/bare-assert
692
- bare-buffer@3.7.0
713
+ bare-buffer@3.6.1
693
714
  https://github.com/holepunchto/bare-buffer
694
715
  bare-bundle@1.10.0
695
716
  https://github.com/holepunchto/bare-bundle
696
717
  bare-bundle-id@1.0.2
697
718
  https://github.com/holepunchto/bare-bundle-id
719
+ bare-cov@1.2.2
720
+ https://github.com/holepunchto/bare-cov
698
721
  bare-cpu-info@0.1.1
699
722
  https://github.com/holepunchto/bare-cpu-info
700
723
  bare-crypto@1.15.3
701
724
  https://github.com/holepunchto/bare-crypto
725
+ bare-debug-log@2.0.0
726
+ https://github.com/holepunchto/bare-debug-log
702
727
  bare-dns@2.1.4
703
728
  https://github.com/holepunchto/bare-dns
704
- bare-env@3.0.1
729
+ bare-encoding@1.0.3
730
+ https://github.com/holepunchto/bare-encoding
731
+ bare-env@3.0.0
705
732
  https://github.com/holepunchto/bare-env
706
733
  bare-events@2.9.1
707
734
  https://github.com/holepunchto/bare-events
708
- bare-fetch@3.2.0
735
+ bare-fetch@3.0.1
709
736
  https://github.com/holepunchto/bare-fetch
710
737
  bare-ffmpeg@1.5.0
711
738
  https://github.com/holepunchto/bare-ffmpeg
712
739
  bare-form-data@1.2.2
713
740
  https://github.com/holepunchto/bare-form-data
714
- bare-fs@4.8.0
741
+ bare-format@1.0.2
742
+ https://github.com/holepunchto/bare-format
743
+ bare-fs@4.7.2
715
744
  https://github.com/holepunchto/bare-fs
716
745
  bare-gpu-info@0.1.1
717
746
  https://github.com/holepunchto/bare-gpu-info
@@ -719,75 +748,80 @@ JavaScript Dependencies
719
748
  https://github.com/holepunchto/bare-hrtime
720
749
  bare-http-parser@1.1.5
721
750
  https://github.com/holepunchto/bare-http-parser
722
- bare-http1@4.5.8
751
+ bare-http1@4.5.7
723
752
  https://github.com/holepunchto/bare-http1
724
753
  bare-https@3.0.0
725
754
  https://github.com/holepunchto/bare-https
726
- bare-inspect@3.1.5
755
+ bare-inspect@3.1.4
727
756
  https://github.com/holepunchto/bare-inspect
728
- bare-lief@0.2.6
729
- https://github.com/holepunchto/bare-lief
730
- bare-link@3.3.0
731
- https://github.com/holepunchto/bare-link
757
+ bare-inspector@6.0.2
758
+ https://github.com/holepunchto/bare-inspector
732
759
  bare-mime@1.0.0
733
760
  https://github.com/holepunchto/bare-mime
734
- bare-module-lexer@1.6.3
761
+ bare-module@6.2.1
762
+ https://github.com/holepunchto/bare-module
763
+ bare-module-lexer@1.5.2
735
764
  https://github.com/holepunchto/bare-module-lexer
736
- bare-module-resolve@1.12.4
765
+ bare-module-resolve@1.12.2
737
766
  https://github.com/holepunchto/bare-module-resolve
738
- bare-module-traverse@2.4.4
767
+ bare-module-traverse@2.1.2
739
768
  https://github.com/holepunchto/bare-module-traverse
740
- bare-net@2.3.3
769
+ bare-net@2.3.2
741
770
  https://github.com/holepunchto/bare-net
742
771
  bare-os@3.9.3
743
772
  https://github.com/holepunchto/bare-os
744
- bare-pack@2.2.1
773
+ bare-pack@2.1.3
745
774
  https://github.com/holepunchto/bare-pack
746
- bare-path@3.1.1
775
+ bare-path@3.0.1
747
776
  https://github.com/holepunchto/bare-path
748
- bare-performance@2.1.1
749
- https://github.com/holepunchto/bare-performance
750
- bare-pipe@4.2.3
777
+ bare-pipe@4.2.2
751
778
  https://github.com/holepunchto/bare-pipe
752
- bare-posix@1.0.1
753
- https://github.com/holepunchto/bare-posix
754
- bare-process@4.5.1
779
+ bare-process@4.4.1
755
780
  https://github.com/holepunchto/bare-process
756
- bare-rpc@1.3.8
781
+ bare-rpc@1.3.3
757
782
  https://github.com/holepunchto/bare-rpc
758
- bare-runtime@1.31.0
783
+ bare-runtime@1.28.7
759
784
  https://github.com/holepunchto/bare-runtime
760
- bare-runtime-darwin-arm64@1.31.0
785
+ bare-runtime-darwin-arm64@1.28.7
761
786
  https://github.com/holepunchto/bare-runtime
762
- bare-semver@1.1.0
787
+ bare-semver@1.0.3
763
788
  https://github.com/holepunchto/bare-semver
764
789
  bare-signals@4.2.0
765
790
  https://github.com/holepunchto/bare-signals
766
- bare-signals@5.0.0
767
- https://github.com/holepunchto/bare-signals
768
- bare-stdio@1.0.3
791
+ bare-stdio@1.0.2
769
792
  https://github.com/holepunchto/bare-stdio
770
793
  bare-stream@2.13.3
771
794
  https://github.com/holepunchto/bare-stream
772
- bare-structured-clone@1.6.0
795
+ bare-structured-clone@1.5.5
773
796
  https://github.com/holepunchto/bare-structured-clone
797
+ bare-stylize@0.0.1
798
+ https://github.com/holepunchto/bare-stylize
799
+ bare-subprocess@5.2.3
800
+ https://github.com/holepunchto/bare-subprocess
774
801
  bare-subprocess@6.1.0
775
802
  https://github.com/holepunchto/bare-subprocess
776
- bare-tcp@2.5.4
803
+ bare-tcp@2.5.1
777
804
  https://github.com/holepunchto/bare-tcp
778
- bare-tls@3.1.8
805
+ bare-tls@3.1.7
779
806
  https://github.com/holepunchto/bare-tls
780
- bare-tty@5.1.2
807
+ bare-tty@5.1.1
781
808
  https://github.com/holepunchto/bare-tty
782
809
  bare-type@1.1.0
783
810
  https://github.com/holepunchto/bare-type
784
- bare-url@2.5.2
811
+ bare-url@2.4.5
785
812
  https://github.com/holepunchto/bare-url
786
- bare-zlib@1.4.1
813
+ bare-utils@1.6.0
814
+ https://github.com/holepunchto/bare-utils
815
+ bare-v8-to-istanbul@1.0.2
816
+ bare-ws@3.0.0
817
+ https://github.com/holepunchto/bare-ws
818
+ bare-zlib@1.4.0
787
819
  https://github.com/holepunchto/bare-zlib
788
820
  blind-relay@1.6.1
789
821
  https://github.com/holepunchto/blind-relay
790
- compact-encoding@3.3.0
822
+ brittle@3.19.1
823
+ https://github.com/holepunchto/brittle
824
+ compact-encoding@3.2.0
791
825
  https://github.com/holepunchto/compact-encoding
792
826
  compact-encoding-bitfield@1.1.0
793
827
  https://github.com/compact-encoding/compact-encoding-bitfield
@@ -797,21 +831,23 @@ JavaScript Dependencies
797
831
  https://github.com/holepunchto/device-file
798
832
  events-universal@1.0.1
799
833
  https://github.com/holepunchto/events-universal
800
- fd-lock@2.2.0
834
+ fd-lock@2.1.1
801
835
  https://github.com/holepunchto/fd-lock
802
836
  fs-native-extensions@1.5.0
803
837
  https://github.com/holepunchto/fs-native-extensions
838
+ globbie@1.0.3
839
+ https://github.com/holepunchto/globbie
804
840
  hyperblobs@2.12.1
805
841
  https://github.com/holepunchto/hyperblobs
806
842
  hypercore-errors@1.5.0
807
843
  https://github.com/holepunchto/hypercore-errors
808
844
  hypercore-id-encoding@1.3.0
809
845
  https://github.com/holepunchto/hypercore-id-encoding
810
- hypercore-stats@2.5.1
846
+ hypercore-stats@2.4.0
811
847
  https://github.com/holepunchto/hypercore-stats
812
- hypercore-storage@3.2.1
848
+ hypercore-storage@3.1.1
813
849
  https://github.com/holepunchto/hypercore-storage
814
- hyperdb@6.8.0
850
+ hyperdb@6.7.0
815
851
  https://github.com/holepunchto/hyperdb
816
852
  hyperdht-address@1.1.1
817
853
  https://github.com/holepunchto/hyperdht-address
@@ -819,9 +855,9 @@ JavaScript Dependencies
819
855
  https://github.com/holepunchto/hyperdht-stats
820
856
  hyperdispatch@1.6.0
821
857
  https://github.com/holepunchto/hyperdispatch
822
- hyperdrive@13.3.3
858
+ hyperdrive@13.3.2
823
859
  https://github.com/holepunchto/hyperdrive
824
- hyperschema@1.22.0
860
+ hyperschema@1.21.0
825
861
  https://github.com/holepunchto/hyperschema
826
862
  hyperswarm-stats@1.3.1
827
863
  https://github.com/holepunchto/hyperswarm-stats
@@ -831,7 +867,7 @@ JavaScript Dependencies
831
867
  https://github.com/holepunchto/mirror-drive
832
868
  noise-handshake@4.2.0
833
869
  https://github.com/holepunchto/noise-handshake
834
- paparam@1.12.0
870
+ paparam@1.10.1
835
871
  https://github.com/holepunchto/paparam
836
872
  passive-core-watcher@1.0.1
837
873
  https://github.com/holepunchto/passive-core-watcher
@@ -851,7 +887,7 @@ JavaScript Dependencies
851
887
  https://github.com/holepunchto/require-asset
852
888
  resource-on-exit@1.0.0
853
889
  https://github.com/holepunchto/bare-teardown
854
- rocksdb-native@3.17.4
890
+ rocksdb-native@3.16.0
855
891
  https://github.com/holepunchto/rocksdb-native
856
892
  scope-lock@1.2.4
857
893
  https://github.com/holepunchto/scope-lock
@@ -861,7 +897,7 @@ JavaScript Dependencies
861
897
  https://github.com/holepunchto/sub-encoder
862
898
  text-decoder@1.2.7
863
899
  https://github.com/holepunchto/text-decoder
864
- udx-native@1.21.0
900
+ udx-native@1.20.7
865
901
  https://github.com/holepunchto/udx-native
866
902
  unslab@1.3.0
867
903
  https://github.com/holepunchto/unslab
@@ -878,13 +914,25 @@ JavaScript Dependencies
878
914
  https://github.com/chm-diederichs/noise-curve-ed
879
915
  quickbit-universal@2.2.0
880
916
  https://github.com/holepunchto/quickbit-universal
881
- semver@7.8.5
917
+ semver@7.8.4
882
918
  https://github.com/npm/node-semver
883
919
  simdle-universal@1.1.2
884
920
  https://github.com/holepunchto/simdle-universal
921
+ tmatch@5.0.0
922
+ https://github.com/isaacs/tmatch
923
+ v8-to-istanbul@9.3.0
924
+ https://github.com/istanbuljs/v8-to-istanbul
885
925
 
886
926
  --- mit (MIT License) ---
887
927
 
928
+ @jridgewell/resolve-uri@3.1.2
929
+ https://github.com/jridgewell/resolve-uri
930
+ @jridgewell/sourcemap-codec@1.5.5
931
+ https://github.com/jridgewell/sourcemaps
932
+ @jridgewell/trace-mapping@0.3.31
933
+ https://github.com/jridgewell/sourcemaps
934
+ @types/istanbul-lib-coverage@2.0.6
935
+ https://github.com/DefinitelyTyped/DefinitelyTyped
888
936
  big-sparse-array@1.0.3
889
937
  https://github.com/mafintosh/big-sparse-array
890
938
  binary-stream-equals@1.0.0
@@ -893,12 +941,16 @@ JavaScript Dependencies
893
941
  https://github.com/mafintosh/bogon
894
942
  codecs@3.1.0
895
943
  https://github.com/mafintosh/codecs
896
- corestore@7.12.0
944
+ convert-source-map@2.0.0
945
+ https://github.com/thlorenz/convert-source-map
946
+ corestore@7.10.1
897
947
  https://github.com/holepunchto/corestore
898
948
  debounceify@1.1.0
899
949
  https://github.com/mafintosh/debounceify
900
950
  dht-rpc@6.27.0
901
951
  https://github.com/holepunchto/dht-rpc
952
+ error-stack-parser@2.1.4
953
+ https://github.com/stacktracejs/error-stack-parser
902
954
  fast-fifo@1.3.2
903
955
  https://github.com/mafintosh/fast-fifo
904
956
  fast-safe-stringify@2.1.1
@@ -911,11 +963,11 @@ JavaScript Dependencies
911
963
  https://github.com/mafintosh/generate-string
912
964
  hyperbee@2.27.3
913
965
  https://github.com/holepunchto/hyperbee
914
- hypercore@11.35.1
966
+ hypercore@11.33.1
915
967
  https://github.com/holepunchto/hypercore
916
968
  hypercore-crypto@3.7.0
917
969
  https://github.com/mafintosh/hypercore-crypto
918
- hyperdht@6.33.1
970
+ hyperdht@6.32.0
919
971
  https://github.com/holepunchto/hyperdht
920
972
  hyperswarm@4.17.0
921
973
  https://github.com/holepunchto/hyperswarm
@@ -931,6 +983,8 @@ JavaScript Dependencies
931
983
  https://github.com/mafintosh/mutexify
932
984
  nat-sampler@1.0.1
933
985
  https://github.com/mafintosh/nat-sampler
986
+ picomatch@4.0.4
987
+ https://github.com/micromatch/picomatch
934
988
  promaphore@1.0.0
935
989
  https://github.com/mafintosh/promaphore
936
990
  protocol-buffers-encodings@1.2.0
@@ -951,6 +1005,8 @@ JavaScript Dependencies
951
1005
  https://github.com/mafintosh/safety-catch
952
1006
  same-data@1.0.0
953
1007
  https://github.com/mafintosh/same-data
1008
+ same-object@1.0.2
1009
+ https://github.com/holepunchto/same-object
954
1010
  shuffled-priority-queue@2.1.0
955
1011
  https://github.com/mafintosh/shuffled-priority-queue
956
1012
  signal-promise@1.0.3
@@ -965,12 +1021,16 @@ JavaScript Dependencies
965
1021
  https://github.com/holepunchto/sodium-universal
966
1022
  speedometer@1.1.0
967
1023
  https://github.com/mafintosh/speedometer
1024
+ stackframe@1.3.4
1025
+ https://github.com/stacktracejs/stackframe
968
1026
  streamx@2.28.0
969
1027
  https://github.com/mafintosh/streamx
970
1028
  tar-stream@3.2.0
971
1029
  https://github.com/mafintosh/tar-stream
972
1030
  teex@1.0.1
973
1031
  https://github.com/mafintosh/teex
1032
+ test-tmp@1.4.0
1033
+ https://github.com/mafintosh/test-tmp
974
1034
  time-ordered-set@2.0.1
975
1035
  https://github.com/mafintosh/time-ordered-set
976
1036
  timeout-refresh@2.0.1
@@ -985,7 +1045,7 @@ JavaScript Dependencies
985
1045
  https://github.com/mafintosh/unordered-set
986
1046
  varint@5.0.0
987
1047
  https://github.com/chrisdickinson/varint
988
- xache@1.3.0
1048
+ xache@1.2.1
989
1049
  https://github.com/mafintosh/xache
990
1050
  z32@1.1.0
991
1051
  https://github.com/mafintosh/z32
package/README.md CHANGED
@@ -140,6 +140,25 @@ sampling. Enabling gauges adds one CPU query and one query per GPU to each
140
140
  profiled operation's response path. If the worker resource collector is not
141
141
  initialized, the event omits the resource block.
142
142
 
143
+ ## Streaming transcription statistics
144
+
145
+ Whisper and Parakeet duplex transcription sessions expose terminal engine
146
+ statistics after their event iterator completes:
147
+
148
+ ```ts
149
+ const session = await transcribeStream({ modelId })
150
+
151
+ for await (const text of session) {
152
+ process.stdout.write(text)
153
+ }
154
+
155
+ const stats = await session.stats
156
+ console.log(stats?.audioDuration, stats?.realTimeFactor)
157
+ ```
158
+
159
+ `session.stats` resolves to `undefined` when the engine does not report
160
+ statistics.
161
+
143
162
  ## Examples
144
163
 
145
164
  In the `./examples` subdirectory, you will find scripts demonstrating how to use all SDK functionalities. To try any of them:
@@ -3,6 +3,13 @@ import type { AudioGenClientParams, AudioGenResult } from '../../schemas/audio-g
3
3
  * Generates PCM audio using a loaded AudioGen model.
4
4
  *
5
5
  * @param params - Loaded model ID, required caption, and optional lyrics, musical controls, duration, and seed.
6
+ * @param params.referenceAudio - Optional timbre reference: a file path (decoded server-side)
7
+ * or raw interleaved stereo 48 kHz Float32 LE PCM bytes.
8
+ * @param params.sourceAudio - Source audio to re-render (same forms as `referenceAudio`);
9
+ * required when `taskType` is `"cover-nofsq"`.
10
+ * @param params.taskType - `"text2music"` (default) or `"cover-nofsq"`.
11
+ * @param params.audioCoverStrength - Source-context strength for cover tasks (0..1).
12
+ * @param params.coverNoiseStrength - Initial source/noise blend for cover tasks (0..1).
6
13
  * @returns A run with a synchronous request ID, generation progress stream, PCM audio promise, and stats promise.
7
14
  *
8
15
  * @example
@@ -23,6 +30,16 @@ import type { AudioGenClientParams, AudioGenResult } from '../../schemas/audio-g
23
30
  * }
24
31
  * const { pcm, sampleRate, channels, bitsPerSample } = await run.audio;
25
32
  * const stats = await run.stats;
33
+ *
34
+ * // Re-render an existing song with a new caption (cover) and a timbre reference:
35
+ * const cover = audioGen({
36
+ * modelId,
37
+ * caption: "orchestral arrangement with dramatic strings",
38
+ * taskType: "cover-nofsq",
39
+ * sourceAudio: "/path/to/source.wav",
40
+ * referenceAudio: "/path/to/reference.mp3",
41
+ * coverNoiseStrength: 0.75,
42
+ * });
26
43
  * ```
27
44
  */
28
45
  export declare function audioGen(params: AudioGenClientParams): AudioGenResult;
@@ -4,6 +4,13 @@ import { createAudioGenResult } from '../../client/api/audio-gen-result.js';
4
4
  * Generates PCM audio using a loaded AudioGen model.
5
5
  *
6
6
  * @param params - Loaded model ID, required caption, and optional lyrics, musical controls, duration, and seed.
7
+ * @param params.referenceAudio - Optional timbre reference: a file path (decoded server-side)
8
+ * or raw interleaved stereo 48 kHz Float32 LE PCM bytes.
9
+ * @param params.sourceAudio - Source audio to re-render (same forms as `referenceAudio`);
10
+ * required when `taskType` is `"cover-nofsq"`.
11
+ * @param params.taskType - `"text2music"` (default) or `"cover-nofsq"`.
12
+ * @param params.audioCoverStrength - Source-context strength for cover tasks (0..1).
13
+ * @param params.coverNoiseStrength - Initial source/noise blend for cover tasks (0..1).
7
14
  * @returns A run with a synchronous request ID, generation progress stream, PCM audio promise, and stats promise.
8
15
  *
9
16
  * @example
@@ -24,6 +31,16 @@ import { createAudioGenResult } from '../../client/api/audio-gen-result.js';
24
31
  * }
25
32
  * const { pcm, sampleRate, channels, bitsPerSample } = await run.audio;
26
33
  * const stats = await run.stats;
34
+ *
35
+ * // Re-render an existing song with a new caption (cover) and a timbre reference:
36
+ * const cover = audioGen({
37
+ * modelId,
38
+ * caption: "orchestral arrangement with dramatic strings",
39
+ * taskType: "cover-nofsq",
40
+ * sourceAudio: "/path/to/source.wav",
41
+ * referenceAudio: "/path/to/reference.mp3",
42
+ * coverNoiseStrength: 0.75,
43
+ * });
27
44
  * ```
28
45
  */
29
46
  export function audioGen(params) {
@@ -2,6 +2,8 @@ import { type FinetuneGetStateParams, type FinetuneProgress, type FinetuneResult
2
2
  export interface FinetuneHandle {
3
3
  progressStream: AsyncGenerator<FinetuneProgress>;
4
4
  result: Promise<FinetuneResult>;
5
+ /** Stable id for this run; pass to `cancel({ requestId })` to stop it. */
6
+ requestId: string;
5
7
  }
6
8
  type FinetuneReplyParams = FinetuneStopParams | FinetuneGetStateParams;
7
9
  /**
@@ -2,6 +2,7 @@ import { send, stream as streamRpc } from '../../client/rpc/rpc-client.js';
2
2
  import { finetuneRunParamsSchema, finetuneRunRequestSchema, finetuneStopRequestSchema, finetuneGetStateParamsSchema, finetuneGetStateRequestSchema, finetuneProgressResponseSchema, finetuneResponseSchema } from '../../schemas/index.js';
3
3
  import { InvalidResponseError, StreamEndedError } from '../../utils/errors-client.js';
4
4
  import { parseClientInput } from '../../client/parse-input.js';
5
+ import { generateClientRequestId } from '../../client/api/client-request-id.js';
5
6
  function isFinetuneReplyParams(params) {
6
7
  return (params.operation === 'pause' || params.operation === 'cancel' || params.operation === 'getState');
7
8
  }
@@ -36,6 +37,9 @@ export function finetune(params, rpcOptions) {
36
37
  return resultPromise;
37
38
  }
38
39
  const runParams = parseClientInput(finetuneRunParamsSchema, params);
40
+ // Client-side id so the run is cancellable via cancel({ requestId }) the
41
+ // moment the handle is returned. Surfaced on the handle below.
42
+ const requestId = generateClientRequestId();
39
43
  let resultResolver = () => { };
40
44
  let resultRejecter = () => { };
41
45
  const resultPromise = new Promise((resolve, reject) => {
@@ -53,6 +57,7 @@ export function finetune(params, rpcOptions) {
53
57
  const request = parseClientInput(finetuneRunRequestSchema, {
54
58
  type: 'finetune',
55
59
  ...runParams,
60
+ requestId,
56
61
  withProgress: true
57
62
  });
58
63
  const responses = streamRpc(request, rpcOptions);
@@ -133,6 +138,7 @@ export function finetune(params, rpcOptions) {
133
138
  })();
134
139
  return {
135
140
  progressStream,
136
- result: resultPromise
141
+ result: resultPromise,
142
+ requestId
137
143
  };
138
144
  }
@@ -30,7 +30,7 @@ export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type Mod
30
30
  export { suspend } from './suspend.js';
31
31
  export { resume } from './resume.js';
32
32
  export { state } from './state.js';
33
- export { vla, vlaHparams } from './vla.js';
33
+ export { vla, vlaHparams, vlaSetEmbodiment } from './vla.js';
34
34
  export { vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE } from './vla-helpers.js';
35
35
  export { audioGen } from '../../client/api/audio-gen.js';
36
36
  //# sourceMappingURL=index.d.ts.map
@@ -30,6 +30,6 @@ export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel } from '.
30
30
  export { suspend } from './suspend.js';
31
31
  export { resume } from './resume.js';
32
32
  export { state } from './state.js';
33
- export { vla, vlaHparams } from './vla.js';
33
+ export { vla, vlaHparams, vlaSetEmbodiment } from './vla.js';
34
34
  export { vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE } from './vla-helpers.js';
35
35
  export { audioGen } from '../../client/api/audio-gen.js';
@@ -37,6 +37,7 @@ export declare function loadModel<S extends ModelDescriptor>(options: LoadModelD
37
37
  * "tts-ggml", ...). May be omitted when `modelSrc` is a registry descriptor
38
38
  * that already carries the engine.
39
39
  * - modelConfig: Model-specific configuration options (companion sources, model parameters, etc.)
40
+ * - fallbackSrc: For a built-in catalog model, an HTTP URL or local file path to load from when the registry is unreachable (validated against the model checksum)
40
41
  * - onProgress: Callback for download progress updates
41
42
  * - logger: Logger instance for model operation logs
42
43
  * @param rpcOptions - Optional RPC options including per-call profiling configuration
@@ -113,6 +114,13 @@ export declare function loadModel<S extends ModelDescriptor>(options: LoadModelD
113
114
  * modelType: "llamacpp-completion",
114
115
  * logger // Pass logger in options
115
116
  * });
117
+ *
118
+ * // Catalog model with an alternate source used when the registry is unreachable
119
+ * import { LLAMA_3_2_1B_INST_Q4_0 } from "@qvac/sdk";
120
+ * const resilientId = await loadModel({
121
+ * modelSrc: LLAMA_3_2_1B_INST_Q4_0,
122
+ * fallbackSrc: "https://mirror.example.com/llama-3.2-1b-instruct-q4_0.gguf"
123
+ * });
116
124
  * ```
117
125
  */
118
126
  export declare function loadModel(options: LoadModelOptions, rpcOptions?: RPCOptions): Promise<string> & {
@@ -1,4 +1,6 @@
1
- import { type TranscribeClientParams, type RPCOptions, type TranscribeSegment, type TranscribeStreamClientParams, type TranscribeStreamSession, type TranscribeStreamMetadataSession, type TranscribeStreamConversationSession } from '../../schemas/index.js';
1
+ import { type TranscribeClientParams, type RPCOptions, type TranscribeSegment, type TranscribeStreamRequest, type TranscribeStreamClientParams, type TranscribeStreamSession, type TranscribeStreamMetadataSession, type TranscribeStreamConversationSession, type TranscribeStats } from '../../schemas/index.js';
2
+ import { duplex } from '../../client/rpc/rpc-client.js';
3
+ type TranscribeDuplexFactory = (request: TranscribeStreamRequest, options?: RPCOptions) => ReturnType<typeof duplex>;
2
4
  /**
3
5
  * Transcribe audio and return the complete text. Accepts either a file
4
6
  * path or an audio buffer.
@@ -61,7 +63,8 @@ export declare function transcribeStream(params: TranscribeClientParams, options
61
63
  * @returns A session object: call `write(audioChunk)` with a `Uint8Array`
62
64
  * (Node `Buffer` is a `Uint8Array` subtype) to feed audio,
63
65
  * iterate with `for await (...)` to receive transcription, and
64
- * `end()` to signal end of audio.
66
+ * `end()` to signal end of audio. After consuming the iterator,
67
+ * await `session.stats` for terminal engine statistics.
65
68
  */
66
69
  export declare function transcribeStream(params: TranscribeStreamClientParams & {
67
70
  emitVadEvents: true;
@@ -73,4 +76,18 @@ export declare function transcribeStream(params: TranscribeStreamClientParams &
73
76
  metadata: true;
74
77
  }, options?: RPCOptions): Promise<TranscribeStreamMetadataSession>;
75
78
  export declare function transcribeStream(params: TranscribeStreamClientParams, options?: RPCOptions): Promise<TranscribeStreamSession>;
79
+ /**
80
+ * Shared duplex session factory. The per-call line processor decides whether
81
+ * to surface strings or segments; `sessionName` is only used to label the
82
+ * "already iterated" error so callers see the correct session type.
83
+ */
84
+ export declare function createTranscribeStreamSession<T>(params: TranscribeStreamClientParams, options: RPCOptions | undefined, process: (line: string, onStats: (stats: TranscribeStats | undefined) => void) => T | undefined | null, sessionName: string, duplexFactory?: TranscribeDuplexFactory): Promise<{
85
+ stats: Promise<TranscribeStats | undefined>;
86
+ write(audioChunk: Uint8Array): void;
87
+ end(): void;
88
+ destroy(): void;
89
+ [Symbol.asyncIterator](): AsyncIterator<T>;
90
+ }>;
91
+ export declare function processLine(line: string, onStats: (stats: TranscribeStats | undefined) => void): string | undefined | null;
92
+ export {};
76
93
  //# sourceMappingURL=transcribe.d.ts.map