@qvac/sdk 0.21.1 → 0.22.0

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 (167) hide show
  1. package/NOTICE +84 -55
  2. package/README.md +167 -24
  3. package/dist/examples/abot-world.js +1 -1
  4. package/dist/examples/advisory-model-fit.d.ts +0 -58
  5. package/dist/examples/advisory-model-fit.js +23 -150
  6. package/dist/examples/asr/moss-transcribe-filesystem.d.ts +2 -0
  7. package/dist/examples/asr/moss-transcribe-filesystem.js +84 -0
  8. package/dist/examples/asr/moss-transcribe-fit.d.ts +2 -0
  9. package/dist/examples/asr/moss-transcribe-fit.js +40 -0
  10. package/dist/examples/asr/nemotron-diarization-filesystem.d.ts +2 -0
  11. package/dist/examples/asr/nemotron-diarization-filesystem.js +64 -0
  12. package/dist/examples/asr/parakeet-ctc-filesystem.js +2 -2
  13. package/dist/examples/asr/parakeet-indic-conformer-filesystem.js +2 -2
  14. package/dist/examples/asr/parakeet-microphone-record.js +1 -1
  15. package/dist/examples/asr/parakeet-microphone-stream.js +1 -1
  16. package/dist/examples/asr/parakeet-nemotron-filesystem.js +3 -3
  17. package/dist/examples/asr/parakeet-sortformer-streaming.js +2 -2
  18. package/dist/examples/asr/parakeet-sortformer.js +1 -1
  19. package/dist/examples/asr/parakeet-tdt-filesystem-chunked.js +2 -2
  20. package/dist/examples/asr/parakeet-tdt-filesystem.js +2 -2
  21. package/dist/examples/asr/parakeet-unified-coreml.js +2 -2
  22. package/dist/examples/asr/parakeet-unified-filesystem.js +2 -2
  23. package/dist/examples/asr/whispercpp-filesystem-streaming.js +1 -1
  24. package/dist/examples/asr/whispercpp-filesystem.js +1 -1
  25. package/dist/examples/asr/whispercpp-microphone-record.js +1 -1
  26. package/dist/examples/asr/whispercpp-prompt.js +1 -1
  27. package/dist/examples/assess-model-fit.js +3 -6
  28. package/dist/examples/audiogen/edit-music.js +2 -2
  29. package/dist/examples/audiogen/generate-cover.js +2 -2
  30. package/dist/examples/audiogen/generate-music-minimax.js +1 -1
  31. package/dist/examples/audiogen/generate-music.js +1 -1
  32. package/dist/examples/audiogen/understand-music.js +2 -2
  33. package/dist/examples/batch-completion.d.ts +1 -1
  34. package/dist/examples/batch-completion.js +1 -1
  35. package/dist/examples/bci/bci-filesystem-streaming.js +2 -2
  36. package/dist/examples/bci/bci-filesystem.js +2 -2
  37. package/dist/examples/concurrent-completion-collision.js +1 -1
  38. package/dist/examples/config-reload.js +1 -1
  39. package/dist/examples/decisions.d.ts +2 -0
  40. package/dist/examples/decisions.js +38 -0
  41. package/dist/examples/diffusion-esrgan-upscale.js +1 -1
  42. package/dist/examples/diffusion-flux2-klein-img2img.js +1 -1
  43. package/dist/examples/diffusion-img2img.js +1 -1
  44. package/dist/examples/diffusion-img2vid-ltx.js +1 -1
  45. package/dist/examples/diffusion-img2vid-minimax-h3.d.ts +2 -0
  46. package/dist/examples/diffusion-img2vid-minimax-h3.js +72 -0
  47. package/dist/examples/diffusion-img2vid.js +1 -1
  48. package/dist/examples/llamacpp-filesystem.js +1 -1
  49. package/dist/examples/llamacpp-multi-gpu.js +2 -2
  50. package/dist/examples/llamacpp-structured-output.js +1 -1
  51. package/dist/examples/mcp-websearch.d.ts +2 -2
  52. package/dist/examples/mcp-websearch.js +3 -3
  53. package/dist/examples/model-fit-ui/server.d.ts +1 -1
  54. package/dist/examples/model-fit-ui/server.js +1 -1
  55. package/dist/examples/multi-job-completion.d.ts +1 -1
  56. package/dist/examples/multi-job-completion.js +1 -1
  57. package/dist/examples/ocr-fasttext.js +1 -1
  58. package/dist/examples/tools/llamacpp-tools-auto-dialect.js +1 -1
  59. package/dist/examples/tools/llamacpp-tools-gemma4.js +1 -1
  60. package/dist/examples/tools/llamacpp-tools-qwen35.js +1 -1
  61. package/dist/examples/tts/llm-to-tts-streaming.d.ts +2 -2
  62. package/dist/examples/tts/llm-to-tts-streaming.js +2 -2
  63. package/dist/examples/tts/moss-sound-effect-controls.d.ts +2 -0
  64. package/dist/examples/tts/moss-sound-effect-controls.js +88 -0
  65. package/dist/examples/tts/moss-sound-effect.d.ts +2 -0
  66. package/dist/examples/tts/moss-sound-effect.js +86 -0
  67. package/dist/examples/tts/moss-speech-audio.d.ts +2 -0
  68. package/dist/examples/tts/moss-speech-audio.js +159 -0
  69. package/dist/examples/tts/moss-speech.d.ts +2 -0
  70. package/dist/examples/tts/moss-speech.js +70 -0
  71. package/dist/examples/vla-groot.js +2 -2
  72. package/dist/examples/vla-pi05.js +2 -2
  73. package/dist/examples/vla-smolvla.js +2 -2
  74. package/dist/examples/voice-assistant/voice-assistant.js +1 -1
  75. package/dist/scripts/contract/build-contract.d.ts +3 -1
  76. package/dist/scripts/contract/build-contract.js +40 -2
  77. package/dist/scripts/contract/build-model-type-maps.d.ts +6 -1
  78. package/dist/scripts/contract/build-model-type-maps.js +3 -2
  79. package/dist/scripts/contract/constants-registry.d.ts +4 -0
  80. package/dist/scripts/contract/constants-registry.js +3 -1
  81. package/dist/scripts/contract/method-shapes.d.ts +1 -0
  82. package/dist/scripts/contract/method-shapes.js +1 -0
  83. package/dist/scripts/export-contract.js +20 -7
  84. package/dist/scripts/run-unit-tests.js +10 -5
  85. package/dist/src/client/api/assess-model-fit.d.ts +5 -5
  86. package/dist/src/client/api/assess-model-fit.js +5 -6
  87. package/dist/src/client/api/audio-edit.d.ts +14 -2
  88. package/dist/src/client/api/audio-edit.js +14 -2
  89. package/dist/src/client/api/audio-gen.d.ts +10 -2
  90. package/dist/src/client/api/audio-gen.js +10 -2
  91. package/dist/src/client/api/audio-understand.d.ts +1 -1
  92. package/dist/src/client/api/audio-understand.js +1 -1
  93. package/dist/src/client/api/batch-completion.js +1 -1
  94. package/dist/src/client/api/completion-stream.js +1 -1
  95. package/dist/src/client/api/decide.d.ts +31 -0
  96. package/dist/src/client/api/decide.js +29 -0
  97. package/dist/src/client/api/index.d.ts +1 -0
  98. package/dist/src/client/api/index.js +1 -0
  99. package/dist/src/client/api/load-model.d.ts +1 -0
  100. package/dist/src/client/api/text-to-speech.d.ts +1 -0
  101. package/dist/src/client/api/text-to-speech.js +15 -22
  102. package/dist/src/client/api/transcribe.js +5 -2
  103. package/dist/src/client/api/video-request.d.ts +5 -5
  104. package/dist/src/client/api/video.d.ts +23 -3
  105. package/dist/src/client/api/video.js +23 -3
  106. package/dist/src/commands/bundle/bare-pack.d.ts +8 -0
  107. package/dist/src/commands/bundle/bare-pack.js +28 -5
  108. package/dist/src/commands/bundle/constants.js +2 -0
  109. package/dist/src/commands/bundle/index.d.ts +7 -6
  110. package/dist/src/commands/bundle/index.js +126 -43
  111. package/dist/src/commands/bundle/manifest.d.ts +2 -0
  112. package/dist/src/commands/bundle/manifest.js +3 -2
  113. package/dist/src/commands/host-prebuilds/index.d.ts +15 -7
  114. package/dist/src/commands/host-prebuilds/index.js +35 -16
  115. package/dist/src/commands/index.d.ts +1 -1
  116. package/dist/src/commands/index.js +1 -1
  117. package/dist/src/commands/verify/addon-source.d.ts +12 -0
  118. package/dist/src/commands/verify/addon-source.js +36 -3
  119. package/dist/src/commands/verify/bare-kit-runtimes.js +2 -1
  120. package/dist/src/commands/verify/node-modules-source.js +10 -1
  121. package/dist/src/{expo/plugins/patches/qvac-platform-addons.d.ts → commands/verify/platform-addons.d.ts} +6 -10
  122. package/dist/src/{expo/plugins/patches/qvac-platform-addons.js → commands/verify/platform-addons.js} +2 -45
  123. package/dist/src/commands/verify/prebuilds.d.ts +7 -10
  124. package/dist/src/commands/verify/prebuilds.js +43 -34
  125. package/dist/src/expo/plugins/get-project-root.d.ts +1 -1
  126. package/dist/src/expo/plugins/link-addons.d.ts +18 -0
  127. package/dist/src/expo/plugins/link-addons.js +65 -0
  128. package/dist/src/expo/plugins/withAndroidArchitecture.d.ts +1 -1
  129. package/dist/src/expo/plugins/withAndroidNdkVersion.d.ts +1 -1
  130. package/dist/src/expo/plugins/withDeviceInfo.d.ts +1 -1
  131. package/dist/src/expo/plugins/withMobileBundle.d.ts +11 -21
  132. package/dist/src/expo/plugins/withMobileBundle.js +22 -112
  133. package/dist/src/expo/plugins/withOpenCL.d.ts +1 -1
  134. package/dist/src/expo/plugins/withQvacSDK.d.ts +1 -1
  135. package/dist/src/index.d.ts +3 -3
  136. package/dist/src/index.js +2 -2
  137. package/dist/src/logging/base-logger.js +1 -1
  138. package/dist/src/logging/utils.js +1 -1
  139. package/dist/src/pear/pre.js +2 -0
  140. package/dist/src/plugin-ids.d.ts +3 -1
  141. package/dist/src/plugin-ids.js +4 -0
  142. package/dist/src/schemas/public.d.ts +2 -1
  143. package/dist/src/schemas/public.js +2 -1
  144. package/dist/src/schemas/sdk-errors-client.d.ts +3 -0
  145. package/dist/src/schemas/sdk-errors-client.js +16 -0
  146. package/dist/src/schemas/sdk-errors-server.d.ts +1 -0
  147. package/dist/src/schemas/sdk-errors-server.js +5 -0
  148. package/dist/src/utils/errors-client.d.ts +10 -0
  149. package/dist/src/utils/errors-client.js +18 -0
  150. package/dist/src/utils/mcp-adapter.js +12 -8
  151. package/dist/src/utils/tool-helpers.d.ts +1 -1
  152. package/dist/src/utils/tool-helpers.js +20 -52
  153. package/dist/src/worker/create-server.d.ts +1 -0
  154. package/dist/src/worker/create-server.js +5 -0
  155. package/dist/src/worker/index.js +4 -0
  156. package/dist/src/worker/lifecycle.js +9 -1
  157. package/dist/src/worker/plugins/llamacpp-decision.d.ts +2 -0
  158. package/dist/src/worker/plugins/llamacpp-decision.js +1 -0
  159. package/dist/src/worker/plugins/moss-transcribe.d.ts +2 -0
  160. package/dist/src/worker/plugins/moss-transcribe.js +1 -0
  161. package/package.json +39 -35
  162. package/src/electron-forge/index.cjs +12 -71
  163. package/dist/scripts/link-workspace-inference.d.ts +0 -2
  164. package/dist/scripts/link-workspace-inference.js +0 -31
  165. package/src/expo/plugins/patches/android-link.mjs +0 -67
  166. package/src/expo/plugins/patches/ios-link.mjs +0 -67
  167. package/src/expo/plugins/patches/qvac-platform-addons.ts +0 -124
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Microphone → Whisper streaming transcription with native VAD.
3
3
  *
4
- * Usage: bun run examples/asr/whispercpp-microphone-record.ts
4
+ * Usage: npx tsx examples/asr/whispercpp-microphone-record.ts
5
5
  *
6
6
  * Speak into your mic; transcriptions appear automatically when you pause.
7
7
  * Press Ctrl+C to quit.
@@ -2,7 +2,7 @@
2
2
  * Whisper transcription with prompt example.
3
3
  *
4
4
  * Usage:
5
- * bun examples/asr/whispercpp-prompt.ts
5
+ * npx tsx examples/asr/whispercpp-prompt.ts
6
6
  *
7
7
  * This example requires a test audio file (default: examples/audio/sample-16khz.wav).
8
8
  * Sample audio files are available in the QVAC source repository, but not included in the published npm package.
@@ -58,12 +58,9 @@ try {
58
58
  for (const [index, model] of result.models.entries()) {
59
59
  const mark = VERDICT_MARK[model.verdict];
60
60
  const size = gib(CANDIDATES[index].expectedSize).padStart(9);
61
- // A calibrated row has a two-sided estimate; a computed-only row has the floor.
62
- const needs = model.estimate
63
- ? `needs ${gib(model.estimate.upperBoundBytes)}`
64
- : model.evidence === 'computed-only' && model.floorBytes
65
- ? `at least ${gib(model.floorBytes)}`
66
- : '';
61
+ const needs = model.evidence === 'computed-only' && model.floorBytes
62
+ ? `at least ${gib(model.floorBytes)}`
63
+ : '';
67
64
  console.log(` ${mark} ${model.name.padEnd(46)} ${size} on disk ${needs}`);
68
65
  // Present on every `unknown`, and worth surfacing: it names what is missing.
69
66
  if (model.verdict === 'unknown') {
@@ -5,7 +5,7 @@ import { AUDIOGEN_ACESTEP_5HZ_LM_0_6B_Q8_0, AUDIOGEN_ACESTEP_V15_TURBO_Q4_K_M, A
5
5
  // regenerates one time range against a new prompt. Operations run in order.
6
6
  //
7
7
  // Usage:
8
- // bun examples/audiogen/edit-music.ts <source.wav|mp3|...> "original pop song" "guitar pop-rock" [output.wav]
8
+ // npx tsx examples/audiogen/edit-music.ts <source.wav|mp3|...> "original pop song" "guitar pop-rock" [output.wav]
9
9
  //
10
10
  // The source must run at least REPAINT_END seconds: the Repaint below asks for
11
11
  // a fixed window, and a range past the end of the source is rejected with
@@ -24,7 +24,7 @@ const fromCaption = process.argv[3] ?? 'Original pop song';
24
24
  const toCaption = process.argv[4] ?? 'Guitar pop-rock';
25
25
  const outputPath = process.argv[5] ?? 'audiogen-edit.wav';
26
26
  if (!sourcePath) {
27
- console.error('Usage: bun examples/audiogen/edit-music.ts <source-audio> "<from caption>" "<to caption>" [output.wav]');
27
+ console.error('Usage: npx tsx examples/audiogen/edit-music.ts <source-audio> "<from caption>" "<to caption>" [output.wav]');
28
28
  process.exit(1);
29
29
  }
30
30
  let modelId;
@@ -4,7 +4,7 @@ import { AUDIOGEN_ACESTEP_5HZ_LM_0_6B_Q8_0, AUDIOGEN_ACESTEP_V15_TURBO_Q4_K_M, A
4
4
  // optionally conditioning the timbre on a second reference clip.
5
5
  //
6
6
  // Usage:
7
- // bun examples/audiogen/generate-cover.ts <source.wav|mp3|...> "orchestral arrangement" [reference.wav] [output.wav]
7
+ // npx tsx examples/audiogen/generate-cover.ts <source.wav|mp3|...> "orchestral arrangement" [reference.wav] [output.wav]
8
8
  //
9
9
  // Both audio inputs are file paths: the SDK decodes them (any FFmpeg-decodable
10
10
  // format) to the 48 kHz stereo float PCM the engine expects. Pass raw
@@ -15,7 +15,7 @@ const caption = process.argv[3] ?? 'Orchestral arrangement with dramatic strings
15
15
  const referencePath = process.argv[4];
16
16
  const outputPath = process.argv[5] ?? 'audiogen-cover.wav';
17
17
  if (!sourcePath) {
18
- console.error('Usage: bun examples/audiogen/generate-cover.ts <source-audio> "<caption>" [reference-audio] [output.wav]');
18
+ console.error('Usage: npx tsx examples/audiogen/generate-cover.ts <source-audio> "<caption>" [reference-audio] [output.wav]');
19
19
  process.exit(1);
20
20
  }
21
21
  let modelId;
@@ -3,7 +3,7 @@ import { audioGen, loadModel, unloadModel } from '@qvac/sdk';
3
3
  // Usage:
4
4
  // AUDIOGEN_MINIMAX_LM_MODEL=/models/mm3-lm-q8.gguf \
5
5
  // AUDIOGEN_MINIMAX_SYNTH_MODEL=/models/mm3-synth-q8.gguf \
6
- // bun run examples/audiogen/generate-music-minimax.ts "warm cinematic piano" output.wav
6
+ // npx tsx examples/audiogen/generate-music-minimax.ts "warm cinematic piano" output.wav
7
7
  const caption = process.argv[2] ?? 'Warm cinematic piano with gentle strings';
8
8
  const outputPath = process.argv[3] ?? 'minimax-music3-output.wav';
9
9
  let modelId;
@@ -1,7 +1,7 @@
1
1
  import { writeFileSync } from 'node:fs';
2
2
  import { AUDIOGEN_ACESTEP_5HZ_LM_0_6B_Q8_0, AUDIOGEN_ACESTEP_V15_TURBO_Q4_K_M, AUDIOGEN_QWEN3_EMBEDDING_0_6B_Q8_0, AUDIOGEN_VAE_BF16, audioGen, loadModel, unloadModel } from '@qvac/sdk';
3
3
  // Usage:
4
- // bun examples/audiogen/generate-music.ts "lo-fi hip hop, mellow piano" output.wav
4
+ // npx tsx examples/audiogen/generate-music.ts "lo-fi hip hop, mellow piano" output.wav
5
5
  const caption = process.argv[2] ?? 'Lo-fi hip hop with mellow piano, soft drums, and a warm bass line';
6
6
  const outputPath = process.argv[3] ?? 'audiogen-output.wav';
7
7
  let modelId;
@@ -4,7 +4,7 @@ import { AUDIOGEN_ACESTEP_5HZ_LM_0_6B_Q8_0, AUDIOGEN_ACESTEP_V15_TURBO_Q4_K_M, A
4
4
  // caption and the clip's musical metadata.
5
5
  //
6
6
  // Usage:
7
- // bun examples/audiogen/understand-music.ts <source.wav|mp3|...> [language hint]
7
+ // npx tsx examples/audiogen/understand-music.ts <source.wav|mp3|...> [language hint]
8
8
  //
9
9
  // The source is a file path: the SDK decodes it (any FFmpeg-decodable format)
10
10
  // to the 48 kHz stereo float PCM the engine expects. Pass raw interleaved
@@ -13,7 +13,7 @@ import { AUDIOGEN_ACESTEP_5HZ_LM_0_6B_Q8_0, AUDIOGEN_ACESTEP_V15_TURBO_Q4_K_M, A
13
13
  const sourcePath = process.argv[2];
14
14
  const vocalLanguage = process.argv[3];
15
15
  if (!sourcePath) {
16
- console.error('Usage: bun examples/audiogen/understand-music.ts <source-audio> [language]');
16
+ console.error('Usage: npx tsx examples/audiogen/understand-music.ts <source-audio> [language]');
17
17
  process.exit(1);
18
18
  }
19
19
  let modelId;
@@ -32,7 +32,7 @@
32
32
  * `tools` or `mcp`, which already constrain output).
33
33
  *
34
34
  * Run from packages/sdk:
35
- * bun run examples/batch-completion.ts
35
+ * npx tsx examples/batch-completion.ts
36
36
  */
37
37
  export {};
38
38
  //# sourceMappingURL=batch-completion.d.ts.map
@@ -32,7 +32,7 @@
32
32
  * `tools` or `mcp`, which already constrain output).
33
33
  *
34
34
  * Run from packages/sdk:
35
- * bun run examples/batch-completion.ts
35
+ * npx tsx examples/batch-completion.ts
36
36
  */
37
37
  import { batchCompletion, loadModel, unloadModel, LLAMA_3_2_1B_INST_Q4_0 } from '@qvac/sdk';
38
38
  try {
@@ -6,13 +6,13 @@
6
6
  * session, printing transcript text as the sliding window decodes
7
7
  * successive windows.
8
8
  *
9
- * Usage: bun run examples/bci/bci-filesystem-streaming.ts <neural-bin-file-path>
9
+ * Usage: npx tsx examples/bci/bci-filesystem-streaming.ts <neural-bin-file-path>
10
10
  */
11
11
  import { loadModel, unloadModel, bciTranscribeStream, BCI_WINDOWED } from '@qvac/sdk';
12
12
  import { readFileSync } from 'fs';
13
13
  const args = process.argv.slice(2);
14
14
  if (!args[0]) {
15
- console.error('Usage: bun run examples/bci/bci-filesystem-streaming.ts <neural-bin-file-path>');
15
+ console.error('Usage: npx tsx examples/bci/bci-filesystem-streaming.ts <neural-bin-file-path>');
16
16
  process.exit(1);
17
17
  }
18
18
  const neuralFilePath = args[0];
@@ -5,12 +5,12 @@
5
5
  * (whisper.cpp) addon in one shot via `bciTranscribe`, and prints the
6
6
  * decoded transcript.
7
7
  *
8
- * Usage: bun run examples/bci/bci-filesystem.ts <neural-bin-file-path>
8
+ * Usage: npx tsx examples/bci/bci-filesystem.ts <neural-bin-file-path>
9
9
  */
10
10
  import { loadModel, unloadModel, bciTranscribe, BCI_WINDOWED } from '@qvac/sdk';
11
11
  const args = process.argv.slice(2);
12
12
  if (!args[0]) {
13
- console.error('Usage: bun run examples/bci/bci-filesystem.ts <neural-bin-file-path>');
13
+ console.error('Usage: npx tsx examples/bci/bci-filesystem.ts <neural-bin-file-path>');
14
14
  process.exit(1);
15
15
  }
16
16
  const neuralFilePath = args[0];
@@ -19,7 +19,7 @@
19
19
  * distinct models never block each other).
20
20
  *
21
21
  * Run from packages/sdk:
22
- * bun run examples/concurrent-completion-collision.ts
22
+ * npx tsx examples/concurrent-completion-collision.ts
23
23
  */
24
24
  import { completion, loadModel, unloadModel, QWEN3_1_7B_INST_Q4, LLAMA_3_2_1B_INST_Q4_0, RequestRejectedByPolicyError } from '@qvac/sdk';
25
25
  async function runCompletion(label, modelId, prompt) {
@@ -2,7 +2,7 @@ import { WHISPER_TINY, loadModel, transcribe, unloadModel } from '@qvac/sdk';
2
2
  // Parse command line arguments
3
3
  const args = process.argv.slice(2);
4
4
  if (!args[0]) {
5
- console.error('✖ Usage: bun run examples/config-reload.ts <audio-file-path>');
5
+ console.error('✖ Usage: npx tsx examples/config-reload.ts <audio-file-path>');
6
6
  process.exit(1);
7
7
  }
8
8
  const audioFilePath = args[0];
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=decisions.d.ts.map
@@ -0,0 +1,38 @@
1
+ import { loadModel, decide, unloadModel, close, LAYA_MULTILINGUAL_322M_Q8_0 } from '@qvac/sdk';
2
+ const modelSrc = process.argv[2] ?? LAYA_MULTILINGUAL_322M_Q8_0;
3
+ let modelId;
4
+ try {
5
+ console.error('▸ Loading decision model');
6
+ modelId = await loadModel({
7
+ modelSrc,
8
+ modelType: 'llamacpp-decision',
9
+ modelConfig: { device: 'cpu' }
10
+ });
11
+ const result = await decide({
12
+ modelId,
13
+ state: 'My payment failed twice and I was charged both times. Please refund the duplicate.',
14
+ questions: {
15
+ department: {
16
+ type: 'choice',
17
+ instructions: 'Which team should handle this ticket?',
18
+ criteria: ['billing', 'technical']
19
+ },
20
+ urgency: {
21
+ type: 'score',
22
+ instructions: 'How urgent is this?',
23
+ criteria: ['not urgent', 'somewhat urgent', 'very urgent']
24
+ },
25
+ refund: { type: 'noul', instructions: 'The customer asks for a refund.' }
26
+ }
27
+ });
28
+ console.log(JSON.stringify(result, null, 2));
29
+ }
30
+ catch (error) {
31
+ console.error('✖', error);
32
+ process.exitCode = 1;
33
+ }
34
+ finally {
35
+ if (modelId)
36
+ await unloadModel({ modelId });
37
+ await close();
38
+ }
@@ -4,7 +4,7 @@ import path from 'path';
4
4
  // ESRGAN upscale example.
5
5
  //
6
6
  // Usage:
7
- // bun run examples/diffusion-esrgan-upscale.ts [esrganSrc] [prompt] [outputDir]
7
+ // npx tsx examples/diffusion-esrgan-upscale.ts [esrganSrc] [prompt] [outputDir]
8
8
  const esrganArg = process.argv[2];
9
9
  const promptArg = process.argv[3];
10
10
  const outputDirArg = process.argv[4];
@@ -10,7 +10,7 @@ const llmModelSrc = process.argv[6] || QWEN3_4B_Q4_K_M;
10
10
  const vaeModelSrc = process.argv[7] || FLUX_2_KLEIN_4B_VAE;
11
11
  if (!inputPath) {
12
12
  console.error('✖ input image path is required');
13
- console.error('Usage: bun run bare:example dist/examples/diffusion-flux2-klein-img2img.js <inputImage> [prompt] [outputDir] [diffusionModelSrc] [llmModelSrc] [vaeModelSrc]');
13
+ console.error('Usage: node dist/examples/diffusion-flux2-klein-img2img.js <inputImage> [prompt] [outputDir] [diffusionModelSrc] [llmModelSrc] [vaeModelSrc]');
14
14
  process.exit(1);
15
15
  }
16
16
  try {
@@ -8,7 +8,7 @@ const outputDir = process.argv[4] || '.';
8
8
  const modelSrc = process.argv[5] || SD_V2_1_1B_Q8_0;
9
9
  if (!inputPath) {
10
10
  console.error('✖ input image path is required');
11
- console.error('Usage: bun run bare:example dist/examples/diffusion-img2img.js <inputImage> [prompt] [outputDir] [modelSrc]');
11
+ console.error('Usage: node dist/examples/diffusion-img2img.js <inputImage> [prompt] [outputDir] [modelSrc]');
12
12
  process.exit(1);
13
13
  }
14
14
  try {
@@ -27,7 +27,7 @@ const embeddingsConnectorsModelSrc = process.argv[9] ||
27
27
  `${HF}/unsloth/LTX-2.3-GGUF/resolve/main/text_encoders/ltx-2.3-22b-distilled_embeddings_connectors.safetensors`;
28
28
  if (!initImagePath) {
29
29
  console.error('✖ init image path is required');
30
- console.error('Usage: bun run bare:example dist/examples/diffusion-img2vid-ltx.js ' +
30
+ console.error('Usage: node dist/examples/diffusion-img2vid-ltx.js ' +
31
31
  '<initImagePath> [prompt] [outputDir] ' +
32
32
  '[diffusionModelSrc] [llmModelSrc] [vaeModelSrc] [audioVaeModelSrc] [embeddingsConnectorsModelSrc]');
33
33
  process.exit(1);
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=diffusion-img2vid-minimax-h3.d.ts.map
@@ -0,0 +1,72 @@
1
+ import { loadModel, unloadModel, video } from '@qvac/sdk';
2
+ import fs from 'fs';
3
+ import path from 'path';
4
+ const modelsDir = process.argv[2];
5
+ const initImagePath = process.argv[3];
6
+ if (!modelsDir || !initImagePath) {
7
+ console.error('✖ models directory and init image path are required');
8
+ console.error('Usage: bun run bare:example dist/examples/diffusion-img2vid-minimax-h3.js ' +
9
+ '<modelsDirectory> <initImagePath> [output.avi]');
10
+ process.exit(1);
11
+ }
12
+ const outputPath = process.argv[4] || 'minimax-h3-img2vid.avi';
13
+ const modelSrc = path.resolve(modelsDir, process.env['H3_MODEL'] || 'minimax_h3_fl2va_pruned-Q4_K.gguf');
14
+ const llmModelSrc = path.resolve(modelsDir, process.env['H3_LLM'] || 'qwen3vl_32b_minimax_h3-Q4_K_M.gguf');
15
+ const vaeModelSrc = path.resolve(modelsDir, 'vae/minimax_h3_video_vae_fp16.safetensors');
16
+ let modelId;
17
+ try {
18
+ for (const file of [modelSrc, llmModelSrc, vaeModelSrc, initImagePath])
19
+ fs.accessSync(file);
20
+ console.log('▸ Loading MiniMax-H3 model (diffusion + Qwen3-VL + video VAE)...');
21
+ modelId = await loadModel({
22
+ modelType: 'sdcpp-generation',
23
+ modelSrc,
24
+ modelConfig: {
25
+ mode: 'video',
26
+ llmModelSrc,
27
+ vaeModelSrc,
28
+ device: 'gpu',
29
+ diffusion_fa: true,
30
+ offload_to_cpu: process.env['H3_OFFLOAD_TO_CPU'] !== '0',
31
+ stream_layers: process.env['H3_STREAM_LAYERS'] === '1',
32
+ ...(process.env['H3_BACKEND'] && { backend: process.env['H3_BACKEND'] }),
33
+ ...(process.env['H3_PARAMS_BACKEND'] && { params_backend: process.env['H3_PARAMS_BACKEND'] }),
34
+ ...(process.env['H3_MAX_VRAM'] && { max_vram: process.env['H3_MAX_VRAM'] })
35
+ }
36
+ });
37
+ console.log(`▸ Model loaded: ${modelId}`);
38
+ const init_image = new Uint8Array(fs.readFileSync(initImagePath));
39
+ const prompt = process.env['PROMPT'] ||
40
+ 'The boat glides forward through the mist while the camera slowly pulls back, cinematic natural motion.';
41
+ console.log(`▸ Generating video for: "${prompt}"`);
42
+ const { progressStream, outputs, stats } = video({
43
+ modelId,
44
+ mode: 'img2vid',
45
+ prompt,
46
+ init_image,
47
+ width: 864,
48
+ height: 480,
49
+ // H3 uses 17*k+5 frames and requires 24 FPS.
50
+ video_frames: Number(process.env['FRAMES'] || 124),
51
+ fps: 24,
52
+ steps: 8,
53
+ cfg_scale: 1,
54
+ seed: 11
55
+ });
56
+ for await (const { step, totalSteps } of progressStream) {
57
+ console.log(`▸ step ${step}/${totalSteps}`);
58
+ }
59
+ const buffers = await outputs;
60
+ if (!buffers[0])
61
+ throw new Error('Generation finished without an AVI result');
62
+ fs.writeFileSync(outputPath, buffers[0]);
63
+ console.log(`▸ Saved ${outputPath}`, await stats);
64
+ }
65
+ catch (error) {
66
+ console.error('✖', error);
67
+ process.exitCode = 1;
68
+ }
69
+ finally {
70
+ if (modelId)
71
+ await unloadModel({ modelId, clearStorage: false });
72
+ }
@@ -14,7 +14,7 @@ const vaeModelSrc = process.argv[7] || WAN_2_1_COMFYUI_REPACKAGED_VAE;
14
14
  const clipVisionModelSrc = process.argv[8] || CLIP_VISION_H;
15
15
  if (!initImagePath) {
16
16
  console.error('✖ init image path is required');
17
- console.error('Usage: bun run bare:example dist/examples/diffusion-img2vid.js ' +
17
+ console.error('Usage: node dist/examples/diffusion-img2vid.js ' +
18
18
  '<initImagePath> [prompt] [outputDir] ' +
19
19
  '[i2vModelSrc] [t5XxlModelSrc] [vaeModelSrc] [clipVisionModelSrc]');
20
20
  process.exit(1);
@@ -3,7 +3,7 @@ import { completion, loadModel, unloadModel } from '@qvac/sdk';
3
3
  const ggufPath = process.argv[2];
4
4
  if (!ggufPath) {
5
5
  console.error('✖ Please provide the path to a GGUF file as the first argument');
6
- console.error('✖ Usage: bun run examples/llamacpp-filesystem.ts <path-to-gguf-file>');
6
+ console.error('✖ Usage: npx tsx examples/llamacpp-filesystem.ts <path-to-gguf-file>');
7
7
  process.exit(1);
8
8
  }
9
9
  console.log(`▸ Loading GGUF model from: ${ggufPath}`);
@@ -10,8 +10,8 @@ import { completion, loadModel, unloadModel, VERBOSITY, LLAMA_3_2_1B_INST_Q4_0 }
10
10
  // "1,1" distributes evenly across two GPUs; "3,1" assigns 75% to GPU 0.
11
11
  //
12
12
  // Usage:
13
- // bun run bare:example dist/examples/llamacpp-multi-gpu.js
14
- // bun run bare:example dist/examples/llamacpp-multi-gpu.js '<model-url>'
13
+ // node dist/examples/llamacpp-multi-gpu.js
14
+ // node dist/examples/llamacpp-multi-gpu.js '<model-url>'
15
15
  const modelSrc = process.argv[2] ?? LLAMA_3_2_1B_INST_Q4_0;
16
16
  try {
17
17
  const modelId = await loadModel({
@@ -4,7 +4,7 @@ import { loadModel, completion, unloadModel, QWEN3_600M_INST_Q4 } from '@qvac/sd
4
4
  // difference between free-form text, free-form JSON, and a strict JSON Schema.
5
5
  //
6
6
  // Usage:
7
- // bun run examples/llamacpp-structured-output.ts
7
+ // npx tsx examples/llamacpp-structured-output.ts
8
8
  const PERSON_SCHEMA = {
9
9
  type: 'object',
10
10
  properties: {
@@ -5,9 +5,9 @@
5
5
  * The server provides tools to search the web and get answers.
6
6
  *
7
7
  * Prerequisites:
8
- * - Install MCP SDK: bun add @modelcontextprotocol/sdk
8
+ * - Install MCP SDK: npm install @modelcontextprotocol/sdk
9
9
  *
10
- * Run with: bun run examples/mcp-websearch.ts
10
+ * Run with: npx tsx examples/mcp-websearch.ts
11
11
  */
12
12
  export {};
13
13
  //# sourceMappingURL=mcp-websearch.d.ts.map
@@ -5,13 +5,13 @@
5
5
  * The server provides tools to search the web and get answers.
6
6
  *
7
7
  * Prerequisites:
8
- * - Install MCP SDK: bun add @modelcontextprotocol/sdk
8
+ * - Install MCP SDK: npm install @modelcontextprotocol/sdk
9
9
  *
10
- * Run with: bun run examples/mcp-websearch.ts
10
+ * Run with: npx tsx examples/mcp-websearch.ts
11
11
  */
12
12
  import { completion, loadModel, unloadModel, QWEN3_1_7B_INST_Q4 } from '../src/index.js';
13
13
  // MCP SDK is a user-installed optional dependency
14
- // Install with: bun add @modelcontextprotocol/sdk
14
+ // Install with: npm install @modelcontextprotocol/sdk
15
15
  import { Client } from '@modelcontextprotocol/sdk/client/index.js';
16
16
  import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
17
17
  function parseSearchResults(mcpResult) {
@@ -17,7 +17,7 @@
17
17
  * machine is doing — fine for a demo, not a measurement.
18
18
  *
19
19
  * Run (Node or Bun, not Bare — this uses node:http):
20
- * bun run examples/model-fit-ui/server.ts
20
+ * npx tsx examples/model-fit-ui/server.ts
21
21
  * node dist/examples/model-fit-ui/server.js
22
22
  */
23
23
  export {};
@@ -17,7 +17,7 @@
17
17
  * machine is doing — fine for a demo, not a measurement.
18
18
  *
19
19
  * Run (Node or Bun, not Bare — this uses node:http):
20
- * bun run examples/model-fit-ui/server.ts
20
+ * npx tsx examples/model-fit-ui/server.ts
21
21
  * node dist/examples/model-fit-ui/server.js
22
22
  */
23
23
  import { createServer } from 'node:http';
@@ -21,7 +21,7 @@
21
21
  * `parallel` in flight, admitting one more waits FIFO until a slot frees.
22
22
  *
23
23
  * Run from packages/sdk:
24
- * bun run examples/multi-job-completion.ts
24
+ * npx tsx examples/multi-job-completion.ts
25
25
  */
26
26
  export {};
27
27
  //# sourceMappingURL=multi-job-completion.d.ts.map
@@ -21,7 +21,7 @@
21
21
  * `parallel` in flight, admitting one more waits FIFO until a slot frees.
22
22
  *
23
23
  * Run from packages/sdk:
24
- * bun run examples/multi-job-completion.ts
24
+ * npx tsx examples/multi-job-completion.ts
25
25
  */
26
26
  import { completion, cancel, loadModel, unloadModel, InferenceCancelledError, LLAMA_3_2_1B_INST_Q4_0 } from '@qvac/sdk';
27
27
  const PROMPTS = [
@@ -2,7 +2,7 @@
2
2
  * OCR example using the QVAC SDK.
3
3
  *
4
4
  * Usage:
5
- * bun examples/ocr-fasttext.ts [path-to-image]
5
+ * npx tsx examples/ocr-fasttext.ts [path-to-image]
6
6
  *
7
7
  * This example requires a test image (default: examples/image/basic_test.bmp).
8
8
  * Sample images are available in the QVAC source repository, but not included in the published npm package.
@@ -6,7 +6,7 @@
6
6
  * LFM without requiring a toolDialect override.
7
7
  *
8
8
  * Usage:
9
- * bun run bare:example dist/examples/tools/llamacpp-tools-auto-dialect.js <model-src>
9
+ * node dist/examples/tools/llamacpp-tools-auto-dialect.js <model-src>
10
10
  */
11
11
  import { completion, loadModel, unloadModel } from '@qvac/sdk';
12
12
  import { tools, mockExecute } from './shared.js';
@@ -13,7 +13,7 @@
13
13
  * completion() if auto-detection does not pick it up for a given file name.
14
14
  *
15
15
  * Usage:
16
- * bun run bare:example dist/examples/tools/llamacpp-tools-gemma4.js <model-url>
16
+ * node dist/examples/tools/llamacpp-tools-gemma4.js <model-url>
17
17
  */
18
18
  import { completion, loadModel, unloadModel, GEMMA4_2B_MULTIMODAL_Q4_K_M } from '@qvac/sdk';
19
19
  import { tools, mockExecute } from './shared.js';
@@ -9,7 +9,7 @@
9
9
  * toolDialect: "qwen35" explicitly if auto-detection does not pick it up.
10
10
  *
11
11
  * Usage:
12
- * bun run bare:example dist/examples/tools/llamacpp-tools-qwen35.js <model-url>
12
+ * node dist/examples/tools/llamacpp-tools-qwen35.js <model-url>
13
13
  */
14
14
  import { completion, loadModel, unloadModel, QWEN3_5_0_8B_MULTIMODAL_Q8_0 } from '@qvac/sdk';
15
15
  import { tools, mockExecute } from './shared.js';
@@ -6,11 +6,11 @@
6
6
  * Each synthesized phrase is played as soon as PCM arrives (`playPcmInt16Chunk`). A combined WAV
7
7
  * is written at the end for inspection.
8
8
  *
9
- * Prerequisites: Bun, QVAC worker, registry access, macOS `afplay` / Linux `aplay` (or Windows
9
+ * Prerequisites: Node.js, QVAC worker, registry access, macOS `afplay` / Linux `aplay` (or Windows
10
10
  * PowerShell player) for chunk playback.
11
11
  *
12
12
  * Usage:
13
- * bun run examples/tts/llm-to-tts-streaming.ts
13
+ * npx tsx examples/tts/llm-to-tts-streaming.ts
14
14
  */
15
15
  export {};
16
16
  //# sourceMappingURL=llm-to-tts-streaming.d.ts.map
@@ -6,11 +6,11 @@
6
6
  * Each synthesized phrase is played as soon as PCM arrives (`playPcmInt16Chunk`). A combined WAV
7
7
  * is written at the end for inspection.
8
8
  *
9
- * Prerequisites: Bun, QVAC worker, registry access, macOS `afplay` / Linux `aplay` (or Windows
9
+ * Prerequisites: Node.js, QVAC worker, registry access, macOS `afplay` / Linux `aplay` (or Windows
10
10
  * PowerShell player) for chunk playback.
11
11
  *
12
12
  * Usage:
13
- * bun run examples/tts/llm-to-tts-streaming.ts
13
+ * npx tsx examples/tts/llm-to-tts-streaming.ts
14
14
  */
15
15
  import { completion, loadModel, textToSpeechStream, unloadModel, LLAMA_3_2_1B_INST_Q4_0, TTS_MULTILINGUAL_SUPERTONIC3_Q8_0 } from '@qvac/sdk';
16
16
  import { createWav, playPcmInt16Chunk } from './utils.js';
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=moss-sound-effect-controls.d.ts.map
@@ -0,0 +1,88 @@
1
+ import { writeFileSync } from 'node:fs';
2
+ import { loadModel, textToSpeech, unloadModel, close, AUDIOGEN_MOSS_SFX_V2_Q8_0 } from '@qvac/sdk';
3
+ // Desktop MOSS-SoundEffect-v2, 48 kHz mono output. A GPU is recommended.
4
+ // Run from packages/sdk: node --import tsx examples/tts/moss-sound-effect-controls.ts
5
+ // Optional: QVAC_MOSS_SFX_MODEL=/absolute/path/moss-sfx-v2-q8_0.gguf
6
+ // Use the catalog source URL: its full descriptor selects the audiogen plugin.
7
+ // Each clip denoises a 30-second latent, regardless of its requested output duration.
8
+ function saveWav(samples, sampleRate, filename) {
9
+ if (samples.length === 0 || samples.some((sample) => !Number.isFinite(sample))) {
10
+ throw new Error('The model returned no usable audio.');
11
+ }
12
+ const wav = Buffer.alloc(44 + samples.length * 2);
13
+ wav.write('RIFF', 0);
14
+ wav.writeUInt32LE(wav.length - 8, 4);
15
+ wav.write('WAVEfmt ', 8);
16
+ wav.writeUInt32LE(16, 16);
17
+ wav.writeUInt16LE(1, 20);
18
+ wav.writeUInt16LE(1, 22);
19
+ wav.writeUInt32LE(sampleRate, 24);
20
+ wav.writeUInt32LE(sampleRate * 2, 28);
21
+ wav.writeUInt16LE(2, 32);
22
+ wav.writeUInt16LE(16, 34);
23
+ wav.write('data', 36);
24
+ wav.writeUInt32LE(samples.length * 2, 40);
25
+ for (let i = 0; i < samples.length; i++) {
26
+ wav.writeInt16LE(Math.max(-32768, Math.min(32767, Math.round(samples[i]))), 44 + i * 2);
27
+ }
28
+ writeFileSync(filename, wav);
29
+ console.error(`▸ Saved ${filename}: ${sampleRate} Hz, ${(samples.length / sampleRate).toFixed(2)} seconds`);
30
+ }
31
+ let lastPercentage = -1;
32
+ function progress(p) {
33
+ const percentage = Math.floor(p.percentage);
34
+ if (percentage === lastPercentage)
35
+ return;
36
+ lastPercentage = percentage;
37
+ const line = `▸ Downloading ${p.percentage.toFixed(0)}% (${(p.downloaded / 1e6).toFixed(1)}/${(p.total / 1e6).toFixed(1)} MB)`;
38
+ process.stderr.write(process.stderr.isTTY ? `\r${line}` : `${line}\n`);
39
+ if (p.percentage >= 100)
40
+ process.stderr.write('\n');
41
+ }
42
+ async function main() {
43
+ const modelId = await loadModel({
44
+ modelSrc: process.env['QVAC_MOSS_SFX_MODEL'] ?? AUDIOGEN_MOSS_SFX_V2_Q8_0.src,
45
+ modelType: 'tts-ggml',
46
+ modelConfig: { ttsEngine: 'moss-sfx', useGPU: true, seed: 42 },
47
+ onProgress: progress
48
+ });
49
+ try {
50
+ console.error('▸ Generating a sound effect...');
51
+ const result = textToSpeech({
52
+ modelId,
53
+ text: 'A dog barking twice in a quiet room.',
54
+ stream: false,
55
+ seconds: 3,
56
+ negativePrompt: 'Speech, music, background voices.',
57
+ steps: 20,
58
+ guidance: 4,
59
+ shift: 5
60
+ });
61
+ const samples = await result.buffer;
62
+ if (!(await result.done))
63
+ throw new Error('Sound-effect generation did not complete.');
64
+ const sampleRate = await result.sampleRate;
65
+ if (sampleRate !== 48000)
66
+ throw new Error(`Unexpected sound-effect sample rate: ${sampleRate}`);
67
+ saveWav(samples, sampleRate, 'moss-sound-effect-controls-output.wav');
68
+ }
69
+ finally {
70
+ await unloadModel({ modelId });
71
+ }
72
+ }
73
+ try {
74
+ await main();
75
+ }
76
+ catch (error) {
77
+ console.error('✖', error);
78
+ process.exitCode = 1;
79
+ }
80
+ finally {
81
+ try {
82
+ await close();
83
+ }
84
+ catch (error) {
85
+ console.error('✖ Cleanup failed:', error);
86
+ process.exitCode = 1;
87
+ }
88
+ }
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=moss-sound-effect.d.ts.map