@qvac/sdk 0.13.4 → 0.14.0

package/dist/schemas/sdk-config.js

@@ -51,7 +51,7 @@ export const deviceConfigDefaultsSchema = z
         .optional(),
     [ModelType.nmtcppTranslation]: z.record(z.string(), z.unknown()).optional(),
     [ModelType.ttsGgml]: z.record(z.string(), z.unknown()).optional(),
-    [ModelType.onnxOcr]: ocrConfigSchema.partial().optional(),
+    [ModelType.ggmlOcr]: ocrConfigSchema.partial().optional(),
     [ModelType.sdcppGeneration]: sdcppConfigSchema.partial().optional(),
     [ModelType.ggmlVla]: vlaConfigSchema.partial().optional(),
     // Alias keys (user-friendly)
@@ -98,14 +98,14 @@ export const qvacConfigSchema = z.object({
     swarmRelays: z.array(z.string()).optional(),
     /**
      * Global log level for all SDK loggers.
-     * Options: "error", "warn", "info", "debug"
+     * Options: "error", "warn", "info", "debug", "off".
      * Defaults to "info".
      */
     loggerLevel: logLevelSchema.optional(),
     /**
-     * Enable or disable console output for SDK loggers.
-     * When false, logs are only sent to streams/transports, not printed to console.
-     * Defaults to true.
+     * Print SDK logs to the console.
+     * When false, logs still reach streams and transports but are not printed.
+     * Defaults to false; set to true to see SDK logs on the console.
      */
     loggerConsoleOutput: z.boolean().optional(),
     /**

package/dist/schemas/sdk-errors-client.d.ts

@@ -9,6 +9,7 @@ export declare const SDK_CLIENT_ERROR_CODES: {
     readonly OCR_FAILED: 50007;
     readonly MODEL_TYPE_REQUIRED: 50008;
     readonly MODEL_SRC_TYPE_MISMATCH: 50009;
+    readonly REQUEST_VALIDATION_FAILED: 50010;
     readonly RPC_NO_HANDLER: 50200;
     readonly RPC_REQUEST_NOT_SENT: 50201;
     readonly RPC_RESPONSE_STREAM_NOT_CREATED: 50202;

package/dist/schemas/sdk-errors-client.js

@@ -11,6 +11,7 @@ export const SDK_CLIENT_ERROR_CODES = {
     OCR_FAILED: 50007,
     MODEL_TYPE_REQUIRED: 50008,
     MODEL_SRC_TYPE_MISMATCH: 50009,
+    REQUEST_VALIDATION_FAILED: 50010,
     // RPC Communication Errors (50,200-50,399)
     RPC_NO_HANDLER: 50200,
     RPC_REQUEST_NOT_SENT: 50201,
@@ -76,12 +77,16 @@ const clientErrorDefinitions = {
     },
     [SDK_CLIENT_ERROR_CODES.MODEL_TYPE_REQUIRED]: {
         name: "MODEL_TYPE_REQUIRED",
-        message: 'modelType is required: modelSrc is a plain string or lacks an engine/addon descriptor that can be inferred. Pass an explicit canonical modelType (e.g. "llamacpp-completion", "whispercpp-transcription", "nmtcpp-translation", "llamacpp-embedding", "tts-ggml", "onnx-ocr", "parakeet-transcription", "sdcpp-generation") or use a model constant that carries engine metadata.',
+        message: 'modelType is required: modelSrc is a plain string or lacks an engine/addon descriptor that can be inferred. Pass an explicit canonical modelType (e.g. "llamacpp-completion", "whispercpp-transcription", "nmtcpp-translation", "llamacpp-embedding", "tts-ggml", "ggml-ocr", "parakeet-transcription", "sdcpp-generation") or use a model constant that carries engine metadata.',
     },
     [SDK_CLIENT_ERROR_CODES.MODEL_SRC_TYPE_MISMATCH]: {
         name: "MODEL_SRC_TYPE_MISMATCH",
         message: (inferred, resolved) => `modelSrc describes "${inferred}", but modelType resolves to "${resolved}". Omit modelType to infer it automatically, or pass a matching modelType.`,
     },
+    [SDK_CLIENT_ERROR_CODES.REQUEST_VALIDATION_FAILED]: {
+        name: "REQUEST_VALIDATION_FAILED",
+        message: (errors) => `Invalid request:\n${errors}`,
+    },
     // RPC Communication Errors (50,200-50,399)
     [SDK_CLIENT_ERROR_CODES.RPC_NO_HANDLER]: {
         name: "RPC_NO_HANDLER",
@@ -167,7 +172,7 @@ const clientErrorDefinitions = {
     },
     [SDK_CLIENT_ERROR_CODES.WORKER_PLUGINS_NOT_REGISTERED]: {
         name: "WORKER_PLUGINS_NOT_REGISTERED",
-        message: () => "No plugins registered in the worker. Call `plugins([...])` (or `registerPlugin(...)`) before the first SDK call. Import default plugin manifests from `@qvac/sdk/server/bare/plugins` if you want the full built-in set.",
+        message: () => "No plugins registered in the worker. On Bare, register the plugins you need with `plugins([...])` (or `registerPlugin(...)`) before the first SDK call — import each from its subpath, e.g. `@qvac/sdk/llamacpp-completion/plugin`. For direct Bare usage we recommend the dedicated `@qvac/bare-sdk` package. See https://docs.qvac.tether.io/configuration/plugins#runtime-registration-on-bare",
     },
     [SDK_CLIENT_ERROR_CODES.BUNDLE_VERIFICATION_FAILED]: {
         name: "BUNDLE_VERIFICATION_FAILED",

package/dist/schemas/text-to-speech.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
-export declare const TTS_CHATTERBOX_LANGUAGES: readonly ["en", "es", "fr", "de", "it", "pt", "nl", "pl", "tr", "sv", "da", "fi", "no", "el", "ms", "sw", "ar", "ko"];
-export declare const TTS_SUPERTONIC_LANGUAGES: readonly ["en", "es", "fr", "pt", "ko"];
-export declare const TTS_LANGUAGES: readonly ["en", "es", "fr", "de", "it", "pt", "nl", "pl", "tr", "sv", "da", "fi", "no", "el", "ms", "sw", "ar", "ko"];
+export declare const TTS_CHATTERBOX_LANGUAGES: readonly ["en", "es", "fr", "de", "it", "pt", "nl", "pl", "tr", "sv", "da", "fi", "no", "el", "ms", "sw", "ar", "ko", "he", "ru", "zh", "hi"];
+export declare const TTS_SUPERTONIC_LANGUAGES: readonly ["en", "ko", "ja", "ar", "bg", "cs", "da", "de", "el", "es", "et", "fi", "fr", "hi", "hr", "hu", "id", "it", "lt", "lv", "nl", "pl", "pt", "ro", "ru", "sk", "sl", "sv", "tr", "uk", "vi"];
+export declare const TTS_LANGUAGES: readonly ["en", "es", "fr", "de", "it", "pt", "nl", "pl", "tr", "sv", "da", "fi", "no", "el", "ms", "sw", "ar", "ko", "he", "ru", "zh", "hi", "ja", "bg", "cs", "et", "hr", "hu", "id", "lt", "lv", "ro", "sk", "sl", "uk", "vi"];
 export declare const ttsChatterboxRuntimeConfigSchema: z.ZodObject<{
     ttsEngine: z.ZodLiteral<"chatterbox">;
     language: z.ZodEnum<{
@@ -16,8 +16,12 @@ export declare const ttsChatterboxRuntimeConfigSchema: z.ZodObject<{
         nl: "nl";
         pl: "pl";
         pt: "pt";
+        ru: "ru";
+        zh: "zh";
         da: "da";
         el: "el";
+        he: "he";
+        hi: "hi";
         ms: "ms";
         no: "no";
         sv: "sv";
@@ -26,22 +30,54 @@ export declare const ttsChatterboxRuntimeConfigSchema: z.ZodObject<{
     }>;
     voice: z.ZodOptional<z.ZodString>;
     useGPU: z.ZodOptional<z.ZodBoolean>;
+    streamChunkTokens: z.ZodOptional<z.ZodNumber>;
+    streamFirstChunkTokens: z.ZodOptional<z.ZodNumber>;
+    cfmSteps: z.ZodOptional<z.ZodNumber>;
+    threads: z.ZodOptional<z.ZodNumber>;
+    nGpuLayers: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
 export declare const ttsSupertonicRuntimeConfigSchema: z.ZodObject<{
     ttsEngine: z.ZodLiteral<"supertonic">;
     language: z.ZodEnum<{
+        id: "id";
         en: "en";
+        ar: "ar";
+        bg: "bg";
+        cs: "cs";
+        de: "de";
         es: "es";
+        et: "et";
+        fi: "fi";
         fr: "fr";
+        hu: "hu";
+        it: "it";
+        ja: "ja";
         ko: "ko";
+        lt: "lt";
+        lv: "lv";
+        nl: "nl";
+        pl: "pl";
         pt: "pt";
+        ru: "ru";
+        sk: "sk";
+        sl: "sl";
+        uk: "uk";
+        da: "da";
+        el: "el";
+        hi: "hi";
+        hr: "hr";
+        ro: "ro";
+        sv: "sv";
+        tr: "tr";
+        vi: "vi";
     }>;
     voice: z.ZodOptional<z.ZodString>;
     ttsSpeed: z.ZodOptional<z.ZodNumber>;
     ttsNumInferenceSteps: z.ZodOptional<z.ZodNumber>;
     useGPU: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
-export declare const ttsRuntimeConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
+export declare const ttsRuntimeConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     ttsEngine: z.ZodLiteral<"chatterbox">;
     language: z.ZodEnum<{
         en: "en";
@@ -55,8 +91,12 @@ export declare const ttsRuntimeConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
         nl: "nl";
         pl: "pl";
         pt: "pt";
+        ru: "ru";
+        zh: "zh";
         da: "da";
         el: "el";
+        he: "he";
+        hi: "hi";
         ms: "ms";
         no: "no";
         sv: "sv";
@@ -65,20 +105,52 @@ export declare const ttsRuntimeConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
     voice: z.ZodOptional<z.ZodString>;
     useGPU: z.ZodOptional<z.ZodBoolean>;
+    streamChunkTokens: z.ZodOptional<z.ZodNumber>;
+    streamFirstChunkTokens: z.ZodOptional<z.ZodNumber>;
+    cfmSteps: z.ZodOptional<z.ZodNumber>;
+    threads: z.ZodOptional<z.ZodNumber>;
+    nGpuLayers: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>, z.ZodObject<{
     ttsEngine: z.ZodLiteral<"supertonic">;
     language: z.ZodEnum<{
+        id: "id";
         en: "en";
+        ar: "ar";
+        bg: "bg";
+        cs: "cs";
+        de: "de";
         es: "es";
+        et: "et";
+        fi: "fi";
         fr: "fr";
+        hu: "hu";
+        it: "it";
+        ja: "ja";
         ko: "ko";
+        lt: "lt";
+        lv: "lv";
+        nl: "nl";
+        pl: "pl";
         pt: "pt";
+        ru: "ru";
+        sk: "sk";
+        sl: "sl";
+        uk: "uk";
+        da: "da";
+        el: "el";
+        hi: "hi";
+        hr: "hr";
+        ro: "ro";
+        sv: "sv";
+        tr: "tr";
+        vi: "vi";
     }>;
     voice: z.ZodOptional<z.ZodString>;
     ttsSpeed: z.ZodOptional<z.ZodNumber>;
     ttsNumInferenceSteps: z.ZodOptional<z.ZodNumber>;
     useGPU: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>]>;
+}, z.core.$strip>], "ttsEngine">;
 export declare const ttsChatterboxLoadConfigSchema: z.ZodObject<{
     ttsEngine: z.ZodLiteral<"chatterbox">;
     language: z.ZodEnum<{
@@ -93,8 +165,12 @@ export declare const ttsChatterboxLoadConfigSchema: z.ZodObject<{
         nl: "nl";
         pl: "pl";
         pt: "pt";
+        ru: "ru";
+        zh: "zh";
         da: "da";
         el: "el";
+        he: "he";
+        hi: "hi";
         ms: "ms";
         no: "no";
         sv: "sv";
@@ -103,6 +179,12 @@ export declare const ttsChatterboxLoadConfigSchema: z.ZodObject<{
     }>;
     voice: z.ZodOptional<z.ZodString>;
     useGPU: z.ZodOptional<z.ZodBoolean>;
+    streamChunkTokens: z.ZodOptional<z.ZodNumber>;
+    streamFirstChunkTokens: z.ZodOptional<z.ZodNumber>;
+    cfmSteps: z.ZodOptional<z.ZodNumber>;
+    threads: z.ZodOptional<z.ZodNumber>;
+    nGpuLayers: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
     s3genModelSrc: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         src: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -128,7 +210,7 @@ export declare const ttsChatterboxLoadConfigSchema: z.ZodObject<{
             "onnx-tts": "onnx-tts";
             "tts-ggml": "tts-ggml";
             "parakeet-transcription": "parakeet-transcription";
-            "onnx-ocr": "onnx-ocr";
+            "ggml-ocr": "ggml-ocr";
             "sdcpp-generation": "sdcpp-generation";
             "ggml-vla": "ggml-vla";
             "ggml-classification": "ggml-classification";
@@ -165,7 +247,7 @@ export declare const ttsChatterboxLoadConfigSchema: z.ZodObject<{
             "onnx-tts": "onnx-tts";
             "tts-ggml": "tts-ggml";
             "parakeet-transcription": "parakeet-transcription";
-            "onnx-ocr": "onnx-ocr";
+            "ggml-ocr": "ggml-ocr";
             "sdcpp-generation": "sdcpp-generation";
             "ggml-vla": "ggml-vla";
             "ggml-classification": "ggml-classification";
@@ -181,18 +263,44 @@ export declare const ttsChatterboxLoadConfigSchema: z.ZodObject<{
 export declare const ttsSupertonicLoadConfigSchema: z.ZodObject<{
     ttsEngine: z.ZodLiteral<"supertonic">;
     language: z.ZodEnum<{
+        id: "id";
         en: "en";
+        ar: "ar";
+        bg: "bg";
+        cs: "cs";
+        de: "de";
         es: "es";
+        et: "et";
+        fi: "fi";
         fr: "fr";
+        hu: "hu";
+        it: "it";
+        ja: "ja";
         ko: "ko";
+        lt: "lt";
+        lv: "lv";
+        nl: "nl";
+        pl: "pl";
         pt: "pt";
+        ru: "ru";
+        sk: "sk";
+        sl: "sl";
+        uk: "uk";
+        da: "da";
+        el: "el";
+        hi: "hi";
+        hr: "hr";
+        ro: "ro";
+        sv: "sv";
+        tr: "tr";
+        vi: "vi";
     }>;
     voice: z.ZodOptional<z.ZodString>;
     ttsSpeed: z.ZodOptional<z.ZodNumber>;
     ttsNumInferenceSteps: z.ZodOptional<z.ZodNumber>;
     useGPU: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
-export declare const ttsLoadConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
+export declare const ttsLoadConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     ttsEngine: z.ZodLiteral<"chatterbox">;
     language: z.ZodEnum<{
         en: "en";
@@ -206,8 +314,12 @@ export declare const ttsLoadConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
         nl: "nl";
         pl: "pl";
         pt: "pt";
+        ru: "ru";
+        zh: "zh";
         da: "da";
         el: "el";
+        he: "he";
+        hi: "hi";
         ms: "ms";
         no: "no";
         sv: "sv";
@@ -216,6 +328,12 @@ export declare const ttsLoadConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
     }>;
     voice: z.ZodOptional<z.ZodString>;
     useGPU: z.ZodOptional<z.ZodBoolean>;
+    streamChunkTokens: z.ZodOptional<z.ZodNumber>;
+    streamFirstChunkTokens: z.ZodOptional<z.ZodNumber>;
+    cfmSteps: z.ZodOptional<z.ZodNumber>;
+    threads: z.ZodOptional<z.ZodNumber>;
+    nGpuLayers: z.ZodOptional<z.ZodNumber>;
+    seed: z.ZodOptional<z.ZodNumber>;
     s3genModelSrc: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         src: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -241,7 +359,7 @@ export declare const ttsLoadConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
             "onnx-tts": "onnx-tts";
             "tts-ggml": "tts-ggml";
             "parakeet-transcription": "parakeet-transcription";
-            "onnx-ocr": "onnx-ocr";
+            "ggml-ocr": "ggml-ocr";
             "sdcpp-generation": "sdcpp-generation";
             "ggml-vla": "ggml-vla";
             "ggml-classification": "ggml-classification";
@@ -278,7 +396,7 @@ export declare const ttsLoadConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
             "onnx-tts": "onnx-tts";
             "tts-ggml": "tts-ggml";
             "parakeet-transcription": "parakeet-transcription";
-            "onnx-ocr": "onnx-ocr";
+            "ggml-ocr": "ggml-ocr";
             "sdcpp-generation": "sdcpp-generation";
             "ggml-vla": "ggml-vla";
             "ggml-classification": "ggml-classification";
@@ -293,23 +411,49 @@ export declare const ttsLoadConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
 }, z.core.$strip>, z.ZodObject<{
     ttsEngine: z.ZodLiteral<"supertonic">;
     language: z.ZodEnum<{
+        id: "id";
         en: "en";
+        ar: "ar";
+        bg: "bg";
+        cs: "cs";
+        de: "de";
         es: "es";
+        et: "et";
+        fi: "fi";
         fr: "fr";
+        hu: "hu";
+        it: "it";
+        ja: "ja";
         ko: "ko";
+        lt: "lt";
+        lv: "lv";
+        nl: "nl";
+        pl: "pl";
         pt: "pt";
+        ru: "ru";
+        sk: "sk";
+        sl: "sl";
+        uk: "uk";
+        da: "da";
+        el: "el";
+        hi: "hi";
+        hr: "hr";
+        ro: "ro";
+        sv: "sv";
+        tr: "tr";
+        vi: "vi";
     }>;
     voice: z.ZodOptional<z.ZodString>;
     ttsSpeed: z.ZodOptional<z.ZodNumber>;
     ttsNumInferenceSteps: z.ZodOptional<z.ZodNumber>;
     useGPU: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strip>]>;
+}, z.core.$strip>], "ttsEngine">;
 export declare const LEGACY_TTS_ONNX_MODEL_CONFIG_FIELDS: readonly ["ttsSupertonicMultilingual", "ttsTokenizerSrc", "ttsSpeechEncoderSrc", "ttsEmbedTokensSrc", "ttsConditionalDecoderSrc", "ttsLanguageModelSrc", "ttsTextEncoderSrc", "ttsDurationPredictorSrc", "ttsVectorEstimatorSrc", "ttsVocoderSrc", "ttsUnicodeIndexerSrc", "ttsTtsConfigSrc", "ttsVoiceStyleSrc"];
-export declare const ttsConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
+export declare const ttsConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     [x: string]: z.ZodOptional<z.ZodUnknown>;
 }, z.core.$strict>, z.ZodObject<{
     [x: string]: z.ZodOptional<z.ZodUnknown>;
-}, z.core.$strict>]>;
+}, z.core.$strict>], "ttsEngine">;
 export declare const ttsClientParamsSchema: z.ZodObject<{
     modelId: z.ZodString;
     inputType: z.ZodDefault<z.ZodString>;

package/dist/schemas/text-to-speech.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { modelSrcInputSchema } from "./model-src-utils.js";
-// Chatterbox multilingual supported languages (18). The engines support
+// Chatterbox multilingual supported languages (22). The engines support
 // different language sets, so the language enum is validated per engine.
 export const TTS_CHATTERBOX_LANGUAGES = [
     "en", // English
@@ -21,25 +21,88 @@ export const TTS_CHATTERBOX_LANGUAGES = [
     "sw", // Swahili
     "ar", // Arabic
     "ko", // Korean
+    "he", // Hebrew
+    "ru", // Russian
+    "zh", // Chinese
+    "hi", // Hindi
 ];
-// Supertonic supported languages (subset of the Chatterbox set).
+// Supertonic supported languages (31, as of Supertonic 3). Earlier Supertonic
+// releases (1/2) only cover a subset, but validation is per-engine, not
+// per-model, so the enum reflects the engine's current full capability.
 export const TTS_SUPERTONIC_LANGUAGES = [
     "en", // English
+    "ko", // Korean
+    "ja", // Japanese
+    "ar", // Arabic
+    "bg", // Bulgarian
+    "cs", // Czech
+    "da", // Danish
+    "de", // German
+    "el", // Greek
     "es", // Spanish
+    "et", // Estonian
+    "fi", // Finnish
     "fr", // French
+    "hi", // Hindi
+    "hr", // Croatian
+    "hu", // Hungarian
+    "id", // Indonesian
+    "it", // Italian
+    "lt", // Lithuanian
+    "lv", // Latvian
+    "nl", // Dutch
+    "pl", // Polish
     "pt", // Portuguese
-    "ko", // Korean
+    "ro", // Romanian
+    "ru", // Russian
+    "sk", // Slovak
+    "sl", // Slovenian
+    "sv", // Swedish
+    "tr", // Turkish
+    "uk", // Ukrainian
+    "vi", // Vietnamese
+];
+// Supertonic languages not already present in the Chatterbox set, used to keep
+// TTS_LANGUAGES a true union across engines without duplicates.
+const TTS_SUPERTONIC_ONLY_LANGUAGES = [
+    "ja", // Japanese
+    "bg", // Bulgarian
+    "cs", // Czech
+    "et", // Estonian
+    "hr", // Croatian
+    "hu", // Hungarian
+    "id", // Indonesian
+    "lt", // Lithuanian
+    "lv", // Latvian
+    "ro", // Romanian
+    "sk", // Slovak
+    "sl", // Slovenian
+    "uk", // Ukrainian
+    "vi", // Vietnamese
 ];
 // Union of all TTS-supported languages across engines. Kept for backwards
 // compatibility; prefer the engine-specific lists when validating a config.
-export const TTS_LANGUAGES = [...TTS_CHATTERBOX_LANGUAGES];
+export const TTS_LANGUAGES = [
+    ...TTS_CHATTERBOX_LANGUAGES,
+    ...TTS_SUPERTONIC_ONLY_LANGUAGES,
+];
 const ttsChatterboxLanguageSchema = z.enum(TTS_CHATTERBOX_LANGUAGES);
 const ttsSupertonicLanguageSchema = z.enum(TTS_SUPERTONIC_LANGUAGES);
+const ttsIntegerSchema = z.number().int();
+const ttsNonNegativeIntegerSchema = ttsIntegerSchema.nonnegative();
+const ttsPositiveIntegerSchema = ttsIntegerSchema.positive();
 export const ttsChatterboxRuntimeConfigSchema = z.object({
     ttsEngine: z.literal("chatterbox"),
     language: ttsChatterboxLanguageSchema,
     voice: z.string().optional(),
     useGPU: z.boolean().optional(),
+    // Chatterbox-only native streaming controls.
+    streamChunkTokens: ttsNonNegativeIntegerSchema.optional(),
+    streamFirstChunkTokens: ttsNonNegativeIntegerSchema.optional(),
+    cfmSteps: ttsNonNegativeIntegerSchema.optional(),
+    threads: ttsPositiveIntegerSchema.optional(),
+    nGpuLayers: ttsIntegerSchema.optional(),
+    seed: ttsIntegerSchema.optional(),
 });
 export const ttsSupertonicRuntimeConfigSchema = z.object({
     ttsEngine: z.literal("supertonic"),
@@ -49,7 +112,7 @@ export const ttsSupertonicRuntimeConfigSchema = z.object({
     ttsNumInferenceSteps: z.number().optional(),
     useGPU: z.boolean().optional(),
 });
-export const ttsRuntimeConfigSchema = z.union([
+export const ttsRuntimeConfigSchema = z.discriminatedUnion("ttsEngine", [
     ttsChatterboxRuntimeConfigSchema,
     ttsSupertonicRuntimeConfigSchema,
 ]);
@@ -60,7 +123,7 @@ export const ttsChatterboxLoadConfigSchema = ttsChatterboxRuntimeConfigSchema.ex
     referenceAudioSrc: modelSrcInputSchema.optional(),
 });
 export const ttsSupertonicLoadConfigSchema = ttsSupertonicRuntimeConfigSchema;
-export const ttsLoadConfigSchema = z.union([
+export const ttsLoadConfigSchema = z.discriminatedUnion("ttsEngine", [
     ttsChatterboxLoadConfigSchema,
     ttsSupertonicLoadConfigSchema,
 ]);
@@ -94,7 +157,7 @@ const legacyTtsOnnxFieldsShape = LEGACY_TTS_ONNX_MODEL_CONFIG_FIELDS.reduce((acc
 // `loadConfigSchema`. Permits deprecated ONNX field names so
 // `resolveConfig` can raise LegacyTtsModelDeprecatedError instead of a
 // generic Zod error; other unknown keys are still rejected by `.strict()`.
-export const ttsConfigSchema = z.union([
+export const ttsConfigSchema = z.discriminatedUnion("ttsEngine", [
     ttsChatterboxLoadConfigSchema.extend(legacyTtsOnnxFieldsShape).strict(),
     ttsSupertonicLoadConfigSchema.extend(legacyTtsOnnxFieldsShape).strict(),
 ]);

package/dist/schemas/transcription-config.d.ts

@@ -89,7 +89,7 @@ export declare const whisperConfigSchema: z.ZodObject<{
             "onnx-tts": "onnx-tts";
             "tts-ggml": "tts-ggml";
             "parakeet-transcription": "parakeet-transcription";
-            "onnx-ocr": "onnx-ocr";
+            "ggml-ocr": "ggml-ocr";
             "sdcpp-generation": "sdcpp-generation";
             "ggml-vla": "ggml-vla";
             "ggml-classification": "ggml-classification";
@@ -124,6 +124,8 @@ export declare const parakeetRuntimeConfigSchema: z.ZodObject<{
     streamingChunkLeftContextMs: z.ZodOptional<z.ZodNumber>;
     streamingChunkRightContextMs: z.ZodOptional<z.ZodNumber>;
     streamingSpkCacheUpdatePeriod: z.ZodOptional<z.ZodNumber>;
+    backendsDir: z.ZodOptional<z.ZodString>;
+    openclCacheDir: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const parakeetConfigSchema: z.ZodObject<{
     maxThreads: z.ZodOptional<z.ZodNumber>;
@@ -146,6 +148,8 @@ export declare const parakeetConfigSchema: z.ZodObject<{
     streamingChunkLeftContextMs: z.ZodOptional<z.ZodNumber>;
     streamingChunkRightContextMs: z.ZodOptional<z.ZodNumber>;
     streamingSpkCacheUpdatePeriod: z.ZodOptional<z.ZodNumber>;
+    backendsDir: z.ZodOptional<z.ZodString>;
+    openclCacheDir: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export type ParakeetRuntimeConfig = z.infer<typeof parakeetRuntimeConfigSchema>;
 export type ParakeetConfig = z.infer<typeof parakeetConfigSchema>;

package/dist/schemas/transcription-config.js

@@ -114,6 +114,8 @@ export const parakeetRuntimeConfigSchema = z.object({
     streamingChunkLeftContextMs: z.number().int().nonnegative().optional(),
     streamingChunkRightContextMs: z.number().int().nonnegative().optional(),
     streamingSpkCacheUpdatePeriod: z.number().int().positive().optional(),
+    backendsDir: z.string().optional(),
+    openclCacheDir: z.string().optional(),
 });
 // Parakeet's load-time config currently has no fields beyond the
 // runtime knobs (single GGUF model is supplied via the top-level

package/dist/schemas/transcription.d.ts

@@ -31,6 +31,7 @@ export declare const transcribeStatsSchema: z.ZodObject<{
     melSpecTime: z.ZodOptional<z.ZodNumber>;
     backendDevice: z.ZodOptional<z.ZodNumber>;
     backendId: z.ZodOptional<z.ZodNumber>;
+    gpuUnsupported: z.ZodOptional<z.ZodNumber>;
     gpuMemTotalMb: z.ZodOptional<z.ZodNumber>;
     gpuMemFreeMb: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
@@ -88,6 +89,7 @@ export declare const transcribeResponseSchema: z.ZodObject<{
         melSpecTime: z.ZodOptional<z.ZodNumber>;
         backendDevice: z.ZodOptional<z.ZodNumber>;
         backendId: z.ZodOptional<z.ZodNumber>;
+        gpuUnsupported: z.ZodOptional<z.ZodNumber>;
         gpuMemTotalMb: z.ZodOptional<z.ZodNumber>;
         gpuMemFreeMb: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
@@ -187,6 +189,7 @@ export declare const transcribeStreamResponseSchema: z.ZodObject<{
         melSpecTime: z.ZodOptional<z.ZodNumber>;
         backendDevice: z.ZodOptional<z.ZodNumber>;
         backendId: z.ZodOptional<z.ZodNumber>;
+        gpuUnsupported: z.ZodOptional<z.ZodNumber>;
         gpuMemTotalMb: z.ZodOptional<z.ZodNumber>;
         gpuMemFreeMb: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;

package/dist/schemas/transcription.js

@@ -33,12 +33,13 @@ export const transcribeStatsSchema = z.object({
     encoderTime: z.number().optional(),
     decoderTime: z.number().optional(),
     melSpecTime: z.number().optional(),
-    // Backend selection captured once at model load (whisper engine).
+    // Backend selection captured once at model load.
     // `0` CPU / `1` GPU; `backendId` codes the GPU family (see the addon's
     // BackendId enum). gpu memory fields are `-1` when the backend exposes
     // no accounting, and absent entirely for the parakeet engine.
     backendDevice: z.number().optional(),
     backendId: z.number().optional(),
+    gpuUnsupported: z.number().optional(),
     gpuMemTotalMb: z.number().optional(),
     gpuMemFreeMb: z.number().optional(),
 });

package/dist/schemas/translate.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 import type { NmtLanguage } from "./translation-config";
 import { type NmtModelTypeInput, type LlmModelTypeInput } from "./model-types";
-declare const translateParamsSchema: z.ZodUnion<readonly [z.ZodObject<{
+declare const translateParamsSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     modelId: z.ZodString;
     text: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
     stream: z.ZodBoolean;
@@ -20,7 +20,7 @@ declare const translateParamsSchema: z.ZodUnion<readonly [z.ZodObject<{
     from: z.ZodOptional<z.ZodString>;
     to: z.ZodString;
     context: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>]>;
+}, z.core.$strip>], "modelType">;
 export declare const translationStatsSchema: z.ZodObject<{
     totalTime: z.ZodOptional<z.ZodNumber>;
     totalTokens: z.ZodOptional<z.ZodNumber>;
@@ -30,7 +30,7 @@ export declare const translationStatsSchema: z.ZodObject<{
     encodeTime: z.ZodOptional<z.ZodNumber>;
     cacheTokens: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strip>;
-export declare const translateRequestSchema: z.ZodUnion<readonly [z.ZodObject<{
+export declare const translateRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     modelId: z.ZodString;
     text: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
     stream: z.ZodBoolean;
@@ -53,8 +53,8 @@ export declare const translateRequestSchema: z.ZodUnion<readonly [z.ZodObject<{
     context: z.ZodOptional<z.ZodString>;
     type: z.ZodLiteral<"translate">;
     requestId: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>]>;
-export declare const translateServerParamsSchema: z.ZodPipe<z.ZodUnion<readonly [z.ZodObject<{
+}, z.core.$strip>], "modelType">;
+export declare const translateServerParamsSchema: z.ZodPipe<z.ZodDiscriminatedUnion<[z.ZodObject<{
     modelId: z.ZodString;
     text: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
     stream: z.ZodBoolean;
@@ -73,7 +73,7 @@ export declare const translateServerParamsSchema: z.ZodPipe<z.ZodUnion<readonly
     from: z.ZodOptional<z.ZodString>;
     to: z.ZodString;
     context: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>]>, z.ZodTransform<{
+}, z.core.$strip>], "modelType">, z.ZodTransform<{
     modelType: string;
     modelId: string;
     text: string | string[];