@qvac/sdk 0.17.0 → 0.18.0

package/NOTICE

@@ -63,14 +63,24 @@ Third-Party Model Licenses
 
   abot-world-0-5b-lf-dit-q8_0
     https://huggingface.co/acvlab/ABot-World-0-5B-LF
+  audio8-codec-decoder-f16
+    https://huggingface.co/Audio8/Audio8-TTS-Preview-0.6b
+  audio8-codec-encoder-f16
+    https://huggingface.co/Audio8/Audio8-TTS-Preview-0.6b
+  audio8-lm-f16
+    https://huggingface.co/Audio8/Audio8-TTS-Preview-0.6b
   bci-embedder
     https://github.com/tetherto/qvac/releases/download/bci-test-assets-v0.1.0/bci-embedder.bin
+  cosyvoice3-campplus-f32
+    https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
   cosyvoice3-flow-f32
     https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
   cosyvoice3-hift-f32
     https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
   cosyvoice3-llm-q8_0
     https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
+  cosyvoice3-s3tok-f16
+    https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
   craft_mlt_25k
     https://www.jaided.ai/easyocr/modelhub/
   crnn_mobilenet_v3_small
@@ -179,6 +189,8 @@ Third-Party Model Licenses
     https://huggingface.co/unsloth/Qwen3.6-27B-GGUF
   Qwen3.6-35B-A3B-GGUF
     https://huggingface.co/unsloth/Qwen3.6-35B-A3B-GGUF
+  Qwen3.8-27B-GGUF
+    https://huggingface.co/unsloth/Qwen3.8-27B-GGUF
   ru-base-ggml-model-f16
     https://huggingface.co/CheeLi03/whisper-base-rus-8
   ru-tiny-ggml-model-f16
@@ -199,6 +211,10 @@ Third-Party Model Licenses
     https://huggingface.co/Comfy-Org/Wan_2.1_ComfyUI_repackaged
   unlimited-ocr-gguf
     https://huggingface.co/vimalnakrani/unlimited-ocr-gguf
+  VisionPsy-Nano-460M-Flash-GGUFs
+    https://huggingface.co/qvac/VisionPsy-Nano-460M-Flash-GGUFs
+  VisionPsy-Nano-460M-GGUFs
+    https://huggingface.co/qvac/VisionPsy-Nano-460M-GGUFs
   voice-en
     https://huggingface.co/FunAudioLLM/Fun-CosyVoice3-0.5B-2512
   voice-zh-2
@@ -348,6 +364,12 @@ Third-Party Model Licenses
     https://huggingface.co/ChristianAzinn/gte-large-gguf
   gte-large-gguf
     https://huggingface.co/ChristianAzinn/gte-large-gguf
+  indic-conformer-ctc.f16
+    https://huggingface.co/ai4bharat/indic-conformer
+  indic-conformer-ctc.q4_0
+    https://huggingface.co/ai4bharat/indic-conformer
+  indic-conformer-ctc.q8_0
+    https://huggingface.co/ai4bharat/indic-conformer
   lavasr-denoiser-f16
     https://huggingface.co/spaces/YatharthS
   lavasr-enhancer-f16
@@ -632,13 +654,13 @@ JavaScript Dependencies
 
   @hyperswarm/secret-stream@6.9.1
     https://github.com/holepunchto/hyperswarm-secret-stream
-  @qvac/asr-ggml@0.1.1
+  @qvac/asr-ggml@0.3.2
     https://github.com/tetherto/qvac
-  @qvac/audiogen-ggml@0.1.1
+  @qvac/audiogen-ggml@0.2.3
     https://github.com/tetherto/qvac
-  @qvac/bci-whispercpp@0.6.0
+  @qvac/bci-whispercpp@0.7.2
     https://github.com/tetherto/qvac
-  @qvac/classification-ggml@0.15.1
+  @qvac/classification-ggml@0.20.0
     https://github.com/tetherto/qvac
   @qvac/decoder-audio@0.5.0
     https://github.com/tetherto/qvac
@@ -646,23 +668,21 @@ JavaScript Dependencies
     https://github.com/tetherto/qvac
   @qvac/diffusion-cpp@0.17.0
     https://github.com/tetherto/qvac
-  @qvac/embed-llamacpp@0.30.1
+  @qvac/embed-llamacpp@0.34.0
     https://github.com/tetherto/qvac
   @qvac/error@0.1.1
-  @qvac/fabric@0.3.1
+  @qvac/fabric@0.6.0
     https://github.com/tetherto/qvac
   @qvac/infer-base@0.4.2
     https://github.com/tetherto/qvac
-  @qvac/infer-base@0.6.1
-    https://github.com/tetherto/qvac
   @qvac/infer-base@0.6.2
     https://github.com/tetherto/qvac
   @qvac/langdetect-text@0.1.2
     https://github.com/tetherto/qvac
-  @qvac/llm-llamacpp@0.39.4
+  @qvac/llm-llamacpp@0.45.0
     https://github.com/tetherto/qvac
   @qvac/logging@0.1.0
-  @qvac/ocr-ggml@0.13.1
+  @qvac/ocr-ggml@0.18.0
     https://github.com/tetherto/qvac
   @qvac/rag@0.6.4
     https://github.com/tetherto/qvac
@@ -670,11 +690,11 @@ JavaScript Dependencies
     https://github.com/tetherto/qvac
   @qvac/registry-schema@0.3.0
     https://github.com/tetherto/qvac
-  @qvac/translation-nmtcpp@8.3.1
+  @qvac/translation-nmtcpp@0.10.0
     https://github.com/tetherto/qvac
-  @qvac/tts-ggml@0.6.3
+  @qvac/tts-ggml@0.7.4
     https://github.com/tetherto/qvac
-  @qvac/vla-ggml@0.16.2
+  @qvac/vla-ggml@0.21.1
     https://github.com/tetherto/qvac
   adaptive-timeout@1.0.1
     https://github.com/holepunchto/adaptive-timeout
@@ -696,12 +716,18 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-bundle
   bare-bundle-id@1.0.2
     https://github.com/holepunchto/bare-bundle-id
+  bare-cov@1.2.2
+    https://github.com/holepunchto/bare-cov
   bare-cpu-info@0.1.1
     https://github.com/holepunchto/bare-cpu-info
   bare-crypto@1.15.3
     https://github.com/holepunchto/bare-crypto
+  bare-debug-log@2.0.0
+    https://github.com/holepunchto/bare-debug-log
   bare-dns@2.1.4
     https://github.com/holepunchto/bare-dns
+  bare-encoding@1.0.3
+    https://github.com/holepunchto/bare-encoding
   bare-env@3.0.0
     https://github.com/holepunchto/bare-env
   bare-events@2.9.1
@@ -712,6 +738,8 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-ffmpeg
   bare-form-data@1.2.2
     https://github.com/holepunchto/bare-form-data
+  bare-format@1.0.2
+    https://github.com/holepunchto/bare-format
   bare-fs@4.7.2
     https://github.com/holepunchto/bare-fs
   bare-gpu-info@0.1.1
@@ -726,12 +754,12 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-https
   bare-inspect@3.1.4
     https://github.com/holepunchto/bare-inspect
-  bare-lief@0.2.4
-    https://github.com/holepunchto/bare-lief
-  bare-link@3.2.2
-    https://github.com/holepunchto/bare-link
+  bare-inspector@6.0.2
+    https://github.com/holepunchto/bare-inspector
   bare-mime@1.0.0
     https://github.com/holepunchto/bare-mime
+  bare-module@6.2.1
+    https://github.com/holepunchto/bare-module
   bare-module-lexer@1.5.2
     https://github.com/holepunchto/bare-module-lexer
   bare-module-resolve@1.12.2
@@ -740,7 +768,7 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-module-traverse
   bare-net@2.3.2
     https://github.com/holepunchto/bare-net
-  bare-os@3.9.1
+  bare-os@3.9.3
     https://github.com/holepunchto/bare-os
   bare-pack@2.1.3
     https://github.com/holepunchto/bare-pack
@@ -766,6 +794,10 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-stream
   bare-structured-clone@1.5.5
     https://github.com/holepunchto/bare-structured-clone
+  bare-stylize@0.0.1
+    https://github.com/holepunchto/bare-stylize
+  bare-subprocess@5.2.3
+    https://github.com/holepunchto/bare-subprocess
   bare-subprocess@6.1.0
     https://github.com/holepunchto/bare-subprocess
   bare-tcp@2.5.1
@@ -778,10 +810,17 @@ JavaScript Dependencies
     https://github.com/holepunchto/bare-type
   bare-url@2.4.5
     https://github.com/holepunchto/bare-url
+  bare-utils@1.6.0
+    https://github.com/holepunchto/bare-utils
+  bare-v8-to-istanbul@1.0.2
+  bare-ws@3.0.0
+    https://github.com/holepunchto/bare-ws
   bare-zlib@1.4.0
     https://github.com/holepunchto/bare-zlib
   blind-relay@1.6.1
     https://github.com/holepunchto/blind-relay
+  brittle@3.19.1
+    https://github.com/holepunchto/brittle
   compact-encoding@3.2.0
     https://github.com/holepunchto/compact-encoding
   compact-encoding-bitfield@1.1.0
@@ -796,6 +835,8 @@ JavaScript Dependencies
     https://github.com/holepunchto/fd-lock
   fs-native-extensions@1.5.0
     https://github.com/holepunchto/fs-native-extensions
+  globbie@1.0.3
+    https://github.com/holepunchto/globbie
   hyperblobs@2.12.1
     https://github.com/holepunchto/hyperblobs
   hypercore-errors@1.5.0
@@ -877,9 +918,21 @@ JavaScript Dependencies
     https://github.com/npm/node-semver
   simdle-universal@1.1.2
     https://github.com/holepunchto/simdle-universal
+  tmatch@5.0.0
+    https://github.com/isaacs/tmatch
+  v8-to-istanbul@9.3.0
+    https://github.com/istanbuljs/v8-to-istanbul
 
 --- mit (MIT License) ---
 
+  @jridgewell/resolve-uri@3.1.2
+    https://github.com/jridgewell/resolve-uri
+  @jridgewell/sourcemap-codec@1.5.5
+    https://github.com/jridgewell/sourcemaps
+  @jridgewell/trace-mapping@0.3.31
+    https://github.com/jridgewell/sourcemaps
+  @types/istanbul-lib-coverage@2.0.6
+    https://github.com/DefinitelyTyped/DefinitelyTyped
   big-sparse-array@1.0.3
     https://github.com/mafintosh/big-sparse-array
   binary-stream-equals@1.0.0
@@ -888,12 +941,16 @@ JavaScript Dependencies
     https://github.com/mafintosh/bogon
   codecs@3.1.0
     https://github.com/mafintosh/codecs
+  convert-source-map@2.0.0
+    https://github.com/thlorenz/convert-source-map
   corestore@7.10.1
     https://github.com/holepunchto/corestore
   debounceify@1.1.0
     https://github.com/mafintosh/debounceify
   dht-rpc@6.27.0
     https://github.com/holepunchto/dht-rpc
+  error-stack-parser@2.1.4
+    https://github.com/stacktracejs/error-stack-parser
   fast-fifo@1.3.2
     https://github.com/mafintosh/fast-fifo
   fast-safe-stringify@2.1.1
@@ -926,6 +983,8 @@ JavaScript Dependencies
     https://github.com/mafintosh/mutexify
   nat-sampler@1.0.1
     https://github.com/mafintosh/nat-sampler
+  picomatch@4.0.4
+    https://github.com/micromatch/picomatch
   promaphore@1.0.0
     https://github.com/mafintosh/promaphore
   protocol-buffers-encodings@1.2.0
@@ -946,6 +1005,8 @@ JavaScript Dependencies
     https://github.com/mafintosh/safety-catch
   same-data@1.0.0
     https://github.com/mafintosh/same-data
+  same-object@1.0.2
+    https://github.com/holepunchto/same-object
   shuffled-priority-queue@2.1.0
     https://github.com/mafintosh/shuffled-priority-queue
   signal-promise@1.0.3
@@ -960,12 +1021,16 @@ JavaScript Dependencies
     https://github.com/holepunchto/sodium-universal
   speedometer@1.1.0
     https://github.com/mafintosh/speedometer
+  stackframe@1.3.4
+    https://github.com/stacktracejs/stackframe
   streamx@2.28.0
     https://github.com/mafintosh/streamx
   tar-stream@3.2.0
     https://github.com/mafintosh/tar-stream
   teex@1.0.1
     https://github.com/mafintosh/teex
+  test-tmp@1.4.0
+    https://github.com/mafintosh/test-tmp
   time-ordered-set@2.0.1
     https://github.com/mafintosh/time-ordered-set
   timeout-refresh@2.0.1

package/README.md

@@ -140,6 +140,25 @@ sampling. Enabling gauges adds one CPU query and one query per GPU to each
 profiled operation's response path. If the worker resource collector is not
 initialized, the event omits the resource block.
 
+## Streaming transcription statistics
+
+Whisper and Parakeet duplex transcription sessions expose terminal engine
+statistics after their event iterator completes:
+
+```ts
+const session = await transcribeStream({ modelId })
+
+for await (const text of session) {
+  process.stdout.write(text)
+}
+
+const stats = await session.stats
+console.log(stats?.audioDuration, stats?.realTimeFactor)
+```
+
+`session.stats` resolves to `undefined` when the engine does not report
+statistics.
+
 ## Examples
 
 In the `./examples` subdirectory, you will find scripts demonstrating how to use all SDK functionalities. To try any of them:

package/dist/client/api/audio-gen.d.ts

@@ -3,6 +3,13 @@ import type { AudioGenClientParams, AudioGenResult } from '../../schemas/audio-g
  * Generates PCM audio using a loaded AudioGen model.
  *
  * @param params - Loaded model ID, required caption, and optional lyrics, musical controls, duration, and seed.
+ * @param params.referenceAudio - Optional timbre reference: a file path (decoded server-side)
+ *   or raw interleaved stereo 48 kHz Float32 LE PCM bytes.
+ * @param params.sourceAudio - Source audio to re-render (same forms as `referenceAudio`);
+ *   required when `taskType` is `"cover-nofsq"`.
+ * @param params.taskType - `"text2music"` (default) or `"cover-nofsq"`.
+ * @param params.audioCoverStrength - Source-context strength for cover tasks (0..1).
+ * @param params.coverNoiseStrength - Initial source/noise blend for cover tasks (0..1).
  * @returns A run with a synchronous request ID, generation progress stream, PCM audio promise, and stats promise.
  *
  * @example
@@ -23,6 +30,16 @@ import type { AudioGenClientParams, AudioGenResult } from '../../schemas/audio-g
  * }
  * const { pcm, sampleRate, channels, bitsPerSample } = await run.audio;
  * const stats = await run.stats;
+ *
+ * // Re-render an existing song with a new caption (cover) and a timbre reference:
+ * const cover = audioGen({
+ *   modelId,
+ *   caption: "orchestral arrangement with dramatic strings",
+ *   taskType: "cover-nofsq",
+ *   sourceAudio: "/path/to/source.wav",
+ *   referenceAudio: "/path/to/reference.mp3",
+ *   coverNoiseStrength: 0.75,
+ * });
  * ```
  */
 export declare function audioGen(params: AudioGenClientParams): AudioGenResult;

package/dist/client/api/audio-gen.js

@@ -4,6 +4,13 @@ import { createAudioGenResult } from '../../client/api/audio-gen-result.js';
  * Generates PCM audio using a loaded AudioGen model.
  *
  * @param params - Loaded model ID, required caption, and optional lyrics, musical controls, duration, and seed.
+ * @param params.referenceAudio - Optional timbre reference: a file path (decoded server-side)
+ *   or raw interleaved stereo 48 kHz Float32 LE PCM bytes.
+ * @param params.sourceAudio - Source audio to re-render (same forms as `referenceAudio`);
+ *   required when `taskType` is `"cover-nofsq"`.
+ * @param params.taskType - `"text2music"` (default) or `"cover-nofsq"`.
+ * @param params.audioCoverStrength - Source-context strength for cover tasks (0..1).
+ * @param params.coverNoiseStrength - Initial source/noise blend for cover tasks (0..1).
  * @returns A run with a synchronous request ID, generation progress stream, PCM audio promise, and stats promise.
  *
  * @example
@@ -24,6 +31,16 @@ import { createAudioGenResult } from '../../client/api/audio-gen-result.js';
  * }
  * const { pcm, sampleRate, channels, bitsPerSample } = await run.audio;
  * const stats = await run.stats;
+ *
+ * // Re-render an existing song with a new caption (cover) and a timbre reference:
+ * const cover = audioGen({
+ *   modelId,
+ *   caption: "orchestral arrangement with dramatic strings",
+ *   taskType: "cover-nofsq",
+ *   sourceAudio: "/path/to/source.wav",
+ *   referenceAudio: "/path/to/reference.mp3",
+ *   coverNoiseStrength: 0.75,
+ * });
  * ```
  */
 export function audioGen(params) {

package/dist/client/api/finetune.d.ts

@@ -2,6 +2,8 @@ import { type FinetuneGetStateParams, type FinetuneProgress, type FinetuneResult
 export interface FinetuneHandle {
     progressStream: AsyncGenerator<FinetuneProgress>;
     result: Promise<FinetuneResult>;
+    /** Stable id for this run; pass to `cancel({ requestId })` to stop it. */
+    requestId: string;
 }
 type FinetuneReplyParams = FinetuneStopParams | FinetuneGetStateParams;
 /**

package/dist/client/api/finetune.js

@@ -2,6 +2,7 @@ import { send, stream as streamRpc } from '../../client/rpc/rpc-client.js';
 import { finetuneRunParamsSchema, finetuneRunRequestSchema, finetuneStopRequestSchema, finetuneGetStateParamsSchema, finetuneGetStateRequestSchema, finetuneProgressResponseSchema, finetuneResponseSchema } from '../../schemas/index.js';
 import { InvalidResponseError, StreamEndedError } from '../../utils/errors-client.js';
 import { parseClientInput } from '../../client/parse-input.js';
+import { generateClientRequestId } from '../../client/api/client-request-id.js';
 function isFinetuneReplyParams(params) {
     return (params.operation === 'pause' || params.operation === 'cancel' || params.operation === 'getState');
 }
@@ -36,6 +37,9 @@ export function finetune(params, rpcOptions) {
         return resultPromise;
     }
     const runParams = parseClientInput(finetuneRunParamsSchema, params);
+    // Client-side id so the run is cancellable via cancel({ requestId }) the
+    // moment the handle is returned. Surfaced on the handle below.
+    const requestId = generateClientRequestId();
     let resultResolver = () => { };
     let resultRejecter = () => { };
     const resultPromise = new Promise((resolve, reject) => {
@@ -53,6 +57,7 @@ export function finetune(params, rpcOptions) {
             const request = parseClientInput(finetuneRunRequestSchema, {
                 type: 'finetune',
                 ...runParams,
+                requestId,
                 withProgress: true
             });
             const responses = streamRpc(request, rpcOptions);
@@ -133,6 +138,7 @@ export function finetune(params, rpcOptions) {
     })();
     return {
         progressStream,
-        result: resultPromise
+        result: resultPromise,
+        requestId
     };
 }

package/dist/client/api/index.d.ts

@@ -30,7 +30,7 @@ export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type Mod
 export { suspend } from './suspend.js';
 export { resume } from './resume.js';
 export { state } from './state.js';
-export { vla, vlaHparams } from './vla.js';
+export { vla, vlaHparams, vlaSetEmbodiment } from './vla.js';
 export { vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE } from './vla-helpers.js';
 export { audioGen } from '../../client/api/audio-gen.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/api/index.js

@@ -30,6 +30,6 @@ export { modelRegistryList, modelRegistrySearch, modelRegistryGetModel } from '.
 export { suspend } from './suspend.js';
 export { resume } from './resume.js';
 export { state } from './state.js';
-export { vla, vlaHparams } from './vla.js';
+export { vla, vlaHparams, vlaSetEmbodiment } from './vla.js';
 export { vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE } from './vla-helpers.js';
 export { audioGen } from '../../client/api/audio-gen.js';

package/dist/client/api/load-model.d.ts

@@ -37,6 +37,7 @@ export declare function loadModel<S extends ModelDescriptor>(options: LoadModelD
  *     "tts-ggml", ...). May be omitted when `modelSrc` is a registry descriptor
  *     that already carries the engine.
  *   - modelConfig: Model-specific configuration options (companion sources, model parameters, etc.)
+ *   - 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)
  *   - onProgress: Callback for download progress updates
  *   - logger: Logger instance for model operation logs
  * @param rpcOptions - Optional RPC options including per-call profiling configuration
@@ -113,6 +114,13 @@ export declare function loadModel<S extends ModelDescriptor>(options: LoadModelD
  *   modelType: "llamacpp-completion",
  *   logger // Pass logger in options
  * });
+ *
+ * // Catalog model with an alternate source used when the registry is unreachable
+ * import { LLAMA_3_2_1B_INST_Q4_0 } from "@qvac/sdk";
+ * const resilientId = await loadModel({
+ *   modelSrc: LLAMA_3_2_1B_INST_Q4_0,
+ *   fallbackSrc: "https://mirror.example.com/llama-3.2-1b-instruct-q4_0.gguf"
+ * });
  * ```
  */
 export declare function loadModel(options: LoadModelOptions, rpcOptions?: RPCOptions): Promise<string> & {

package/dist/client/api/transcribe.d.ts

@@ -1,4 +1,6 @@
-import { type TranscribeClientParams, type RPCOptions, type TranscribeSegment, type TranscribeStreamClientParams, type TranscribeStreamSession, type TranscribeStreamMetadataSession, type TranscribeStreamConversationSession } from '../../schemas/index.js';
+import { type TranscribeClientParams, type RPCOptions, type TranscribeSegment, type TranscribeStreamRequest, type TranscribeStreamClientParams, type TranscribeStreamSession, type TranscribeStreamMetadataSession, type TranscribeStreamConversationSession, type TranscribeStats } from '../../schemas/index.js';
+import { duplex } from '../../client/rpc/rpc-client.js';
+type TranscribeDuplexFactory = (request: TranscribeStreamRequest, options?: RPCOptions) => ReturnType<typeof duplex>;
 /**
  * Transcribe audio and return the complete text. Accepts either a file
  * path or an audio buffer.
@@ -61,7 +63,8 @@ export declare function transcribeStream(params: TranscribeClientParams, options
  * @returns A session object: call `write(audioChunk)` with a `Uint8Array`
  *          (Node `Buffer` is a `Uint8Array` subtype) to feed audio,
  *          iterate with `for await (...)` to receive transcription, and
- *          `end()` to signal end of audio.
+ *          `end()` to signal end of audio. After consuming the iterator,
+ *          await `session.stats` for terminal engine statistics.
  */
 export declare function transcribeStream(params: TranscribeStreamClientParams & {
     emitVadEvents: true;
@@ -73,4 +76,18 @@ export declare function transcribeStream(params: TranscribeStreamClientParams &
     metadata: true;
 }, options?: RPCOptions): Promise<TranscribeStreamMetadataSession>;
 export declare function transcribeStream(params: TranscribeStreamClientParams, options?: RPCOptions): Promise<TranscribeStreamSession>;
+/**
+ * Shared duplex session factory. The per-call line processor decides whether
+ * to surface strings or segments; `sessionName` is only used to label the
+ * "already iterated" error so callers see the correct session type.
+ */
+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<{
+    stats: Promise<TranscribeStats | undefined>;
+    write(audioChunk: Uint8Array): void;
+    end(): void;
+    destroy(): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}>;
+export declare function processLine(line: string, onStats: (stats: TranscribeStats | undefined) => void): string | undefined | null;
+export {};
 //# sourceMappingURL=transcribe.d.ts.map

package/dist/client/api/transcribe.js

@@ -121,12 +121,39 @@ function buildTranscribeStreamRequest(params) {
  * to surface strings or segments; `sessionName` is only used to label the
  * "already iterated" error so callers see the correct session type.
  */
-async function createTranscribeStreamSession(params, options, process, sessionName) {
+export async function createTranscribeStreamSession(params, options, process, sessionName, duplexFactory = duplex) {
     const request = buildTranscribeStreamRequest(params);
-    const { requestStream, responseStream } = await duplex(request, options);
-    const responses = parseLines(responseStream, process);
+    const { requestStream, responseStream } = await duplexFactory(request, options);
+    let statsSettled = false;
+    let resolveStatsPromise = () => { };
+    let rejectStatsPromise = () => { };
+    const stats = new Promise((resolve, reject) => {
+        resolveStatsPromise = resolve;
+        rejectStatsPromise = reject;
+    });
+    stats.catch(() => { });
+    function resolveStats(value) {
+        if (statsSettled)
+            return;
+        statsSettled = true;
+        resolveStatsPromise(value);
+    }
+    function rejectStats(error) {
+        if (statsSettled)
+            return;
+        statsSettled = true;
+        rejectStatsPromise(error);
+    }
+    function resolveEmptyStats() {
+        resolveStats(undefined);
+    }
+    function processResponse(line) {
+        return process(line, resolveStats);
+    }
+    const responses = parseLines(responseStream, processResponse, resolveEmptyStats, rejectStats);
     let consumed = false;
     return {
+        stats,
         write(audioChunk) {
             requestStream.write(audioChunk);
         },
@@ -134,6 +161,7 @@ async function createTranscribeStreamSession(params, options, process, sessionNa
             requestStream.end();
         },
         destroy() {
+            resolveStats(undefined);
             requestStream.destroy();
             responseStream.destroy();
         },
@@ -154,32 +182,41 @@ function transcribeStreamDuplexMetadata(params, options) {
 }
 function transcribeStreamDuplexConversation(params, options) {
     const wantsMetadata = params.metadata === true;
-    return createTranscribeStreamSession(params, options, (line) => processLineConversation(line, wantsMetadata), 'TranscribeStreamConversationSession');
+    return createTranscribeStreamSession(params, options, (line, onStats) => processLineConversation(line, wantsMetadata, onStats), 'TranscribeStreamConversationSession');
 }
 /**
  * Line-delimited parser: reads newline-separated frames from a duplex
  * response stream, passes each non-empty line through `process`, and yields
  * whatever values it returns. `null` from `process` terminates the stream.
  */
-async function* parseLines(responseStream, process) {
+async function* parseLines(responseStream, process, onClose, onError) {
     let buf = '';
-    for await (const chunk of responseStream) {
-        buf += chunk.toString();
-        const lines = buf.split('\n');
-        buf = lines.pop() || '';
-        for (const line of lines) {
-            const result = process(line);
-            if (result === null)
-                return;
-            if (result !== undefined)
+    try {
+        for await (const chunk of responseStream) {
+            buf += chunk.toString();
+            const lines = buf.split('\n');
+            buf = lines.pop() || '';
+            for (const line of lines) {
+                const result = process(line);
+                if (result === null)
+                    return;
+                if (result !== undefined)
+                    yield result;
+            }
+        }
+        // Process any residual data after stream ends
+        if (buf.trim()) {
+            const result = process(buf);
+            if (result !== null && result !== undefined)
                 yield result;
         }
     }
-    // Process any residual data after stream ends
-    if (buf.trim()) {
-        const result = process(buf);
-        if (result !== null && result !== undefined)
-            yield result;
+    catch (error) {
+        onError(error);
+        throw error;
+    }
+    finally {
+        onClose();
     }
 }
 function parseResponseLine(line) {
@@ -204,23 +241,25 @@ function parseResponseLine(line) {
  * `undefined` for frames the caller should skip, or the value extracted from
  * the frame.
  */
-function processWith(line, extract) {
+function processWith(line, extract, onStats) {
     const response = parseResponseLine(line);
     if (response === null)
         return undefined;
     if (response.error)
         throw new TranscriptionFailedError(response.error);
-    if (response.done)
+    if (response.done) {
+        onStats(response.stats);
         return null;
+    }
     return extract(response);
 }
-function processLine(line) {
-    return processWith(line, (response) => (response.text?.trim() ? response.text : undefined));
+export function processLine(line, onStats) {
+    return processWith(line, (response) => (response.text?.trim() ? response.text : undefined), onStats);
 }
-function processLineMetadata(line) {
-    return processWith(line, (response) => response.segment);
+function processLineMetadata(line, onStats) {
+    return processWith(line, (response) => response.segment, onStats);
 }
-function processLineConversation(line, wantsMetadata) {
+function processLineConversation(line, wantsMetadata, onStats) {
     return processWith(line, (response) => {
         if (response.vad) {
             return {
@@ -252,5 +291,5 @@ function processLineConversation(line, wantsMetadata) {
             return { type: 'text', text: response.text };
         }
         return undefined;
-    });
+    }, onStats);
 }

package/dist/client/api/translate.d.ts

@@ -19,7 +19,7 @@ import { type TranslateClientParams, type TranslationStats, type RPCOptions } fr
  *   modelId: "modelId",
  *   text: "Hello world",
  *   from: "en",
- *   to: "es"
+ *   to: "es",
  *   modelType: "llm",
  * });
  *
@@ -32,7 +32,7 @@ import { type TranslateClientParams, type TranslationStats, type RPCOptions } fr
  *   modelId: "modelId",
  *   text: "Hello world",
  *   from: "en",
- *   to: "es"
+ *   to: "es",
  *   modelType: "llm",
  *   stream: false,
  * });
@@ -44,5 +44,6 @@ export declare function translate(params: TranslateClientParams, options?: RPCOp
     tokenStream: AsyncGenerator<string>;
     stats: Promise<TranslationStats | undefined>;
     text: Promise<string>;
+    requestId: string;
 };
 //# sourceMappingURL=translate.d.ts.map