@qvac/sdk 0.13.5 → 0.14.0

package/dist/schemas/load-model.js

@@ -3,11 +3,11 @@ import { llmConfigBaseSchema, embedConfigBaseSchema, } from "./llamacpp-config.j
 import { whisperConfigSchema, parakeetLoadConfigSchema, } from "./transcription-config.js";
 import { bciConfigSchema } from "./bci-config.js";
 import { delegateSchema } from "./delegate.js";
-import { nmtConfigSchema } from "./translation-config.js";
-import { ttsConfigSchema } from "./text-to-speech.js";
+import { nmtConfigBaseSchema, nmtConfigSchema } from "./translation-config.js";
+import { LEGACY_TTS_ONNX_MODEL_CONFIG_FIELDS, ttsChatterboxLoadConfigSchema, ttsConfigSchema, ttsSupertonicLoadConfigSchema, } from "./text-to-speech.js";
 import { ocrConfigSchema } from "./ocr.js";
 import { modelSrcInputSchema, modelInputToSrcSchema, modelInputToNameSchema, } from "./model-src-utils.js";
-import { llmModelTypeSchema, whisperModelTypeSchema, bciModelTypeSchema, parakeetModelTypeSchema, embeddingsModelTypeSchema, nmtModelTypeSchema, ttsModelTypeSchema, ocrModelTypeSchema, diffusionModelTypeSchema, vlaModelTypeSchema, classificationModelTypeSchema, ModelType, ModelTypeAliases, } from "./model-types.js";
+import { llmModelTypeSchema, whisperModelTypeSchema, bciModelTypeSchema, parakeetModelTypeSchema, embeddingsModelTypeSchema, nmtModelTypeSchema, ttsModelTypeSchema, ocrModelTypeSchema, diffusionModelTypeSchema, vlaModelTypeSchema, classificationModelTypeSchema, ModelType, ModelTypeAliases, normalizeModelType, } from "./model-types.js";
 import { sdcppConfigSchema } from "./sdcpp-config.js";
 import { vlaConfigSchema } from "./vla.js";
 import { classificationConfigSchema } from "./classification.js";
@@ -16,6 +16,9 @@ const builtInModelTypes = new Set([
     ...Object.values(ModelType),
     ...Object.keys(ModelTypeAliases),
 ]);
+export function isBuiltInModelType(modelType) {
+    return typeof modelType === "string" && builtInModelTypes.has(modelType);
+}
 import { reloadConfigRequestSchema } from "./reload-config.js";
 const loadModelCommonFields = {
     modelSrc: modelSrcInputSchema,
@@ -29,6 +32,58 @@ const loadModelRequestCommonFields = {
     withProgress: z.boolean().optional(),
     requestId: z.string().min(1).optional(),
 };
+const topLevelLoadModelOptionKeys = new Set([
+    ...Object.keys(loadModelRequestCommonFields),
+    "modelType",
+    "modelConfig",
+]);
+const modelConfigKeysByModelType = new Map([
+    [ModelType.llamacppCompletion, configKeys(llmConfigBaseSchema)],
+    [ModelType.whispercppTranscription, configKeys(whisperConfigSchema)],
+    [ModelType.bciWhispercppTranscription, configKeys(bciConfigSchema)],
+    [ModelType.parakeetTranscription, configKeys(parakeetLoadConfigSchema)],
+    [ModelType.llamacppEmbedding, configKeys(embedConfigBaseSchema)],
+    [
+        ModelType.nmtcppTranslation,
+        configKeys(...nmtConfigBaseSchema.options),
+    ],
+    [
+        ModelType.ttsGgml,
+        configKeys(ttsChatterboxLoadConfigSchema, ttsSupertonicLoadConfigSchema, LEGACY_TTS_ONNX_MODEL_CONFIG_FIELDS),
+    ],
+    [ModelType.ggmlOcr, configKeys(ocrConfigSchema)],
+    [ModelType.sdcppGeneration, configKeys(sdcppConfigSchema)],
+    [ModelType.ggmlVla, configKeys(vlaConfigSchema)],
+    [ModelType.ggmlClassification, configKeys(classificationConfigSchema)],
+]);
+const misplacedLoadModelConfigGuard = z.unknown().superRefine((value, ctx) => {
+    const keys = getMisplacedModelConfigKeys(value);
+    if (keys.length === 0)
+        return;
+    ctx.addIssue({
+        code: "custom",
+        message: `Model config field "${keys[0]}" must be passed inside modelConfig. ` +
+            `Did you mean ${keys.map((key) => `modelConfig.${key}`).join(", ")}?`,
+    });
+});
+function configKeys(...sources) {
+    const keys = sources.flatMap((source) => isStringArray(source) ? source : Object.keys(source.shape));
+    return new Set(keys.filter((key) => !topLevelLoadModelOptionKeys.has(key)));
+}
+function isStringArray(source) {
+    return Array.isArray(source);
+}
+function getMisplacedModelConfigKeys(value) {
+    if (!isRecord(value) || typeof value["modelType"] !== "string")
+        return [];
+    const configKeys = modelConfigKeysByModelType.get(normalizeModelType(value["modelType"]));
+    if (!configKeys)
+        return [];
+    return Object.keys(value).filter((key) => configKeys.has(key));
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 export const loadBuiltinModelOptionsBaseSchema = z.union([
     z
         .object({
@@ -125,7 +180,7 @@ export const loadModelOptionsSchema = loadModelOptionsBaseSchema.transform((data
     ...data,
     seed: data.seed ?? false,
 }));
-const loadModelOptionsToRequestBaseSchema = z.union([
+export const loadBuiltinToRequestSchema = z.discriminatedUnion("modelType", [
     z
         .object({
         ...loadModelRequestCommonFields,
@@ -269,7 +324,7 @@ const loadModelOptionsToRequestBaseSchema = z.union([
         .strict()
         .transform((data) => ({
         type: "loadModel",
-        modelType: ModelType.onnxOcr,
+        modelType: ModelType.ggmlOcr,
         modelSrc: modelInputToSrcSchema.parse(data.modelSrc),
         modelName: modelInputToNameSchema.parse(data.modelSrc),
         modelConfig: (data.modelConfig ?? {}),
@@ -333,27 +388,31 @@ const loadModelOptionsToRequestBaseSchema = z.union([
         delegate: data.delegate,
         ...(data.requestId !== undefined && { requestId: data.requestId }),
     })),
-    z
-        .object({
-        ...loadModelRequestCommonFields,
-        modelType: z.string().refine((val) => !builtInModelTypes.has(val), {
-            message: "Built-in model types must use their specific schema",
-        }),
-        modelConfig: z.record(z.string(), z.unknown()).optional(),
-    })
-        .transform((data) => ({
-        type: "loadModel",
-        modelType: data.modelType,
-        modelSrc: modelInputToSrcSchema.parse(data.modelSrc),
-        modelName: modelInputToNameSchema.parse(data.modelSrc),
-        modelConfig: data.modelConfig ?? {},
-        seed: data.seed ?? false,
-        withProgress: data.withProgress ?? !!data.onProgress,
-        delegate: data.delegate,
-        ...(data.requestId !== undefined && { requestId: data.requestId }),
-    })),
 ]);
-export const loadModelOptionsToRequestSchema = loadModelOptionsToRequestBaseSchema;
+export const loadCustomPluginToRequestSchema = z
+    .object({
+    ...loadModelRequestCommonFields,
+    modelType: z.string().refine((val) => !builtInModelTypes.has(val), {
+        message: "Built-in model types must use their specific schema",
+    }),
+    modelConfig: z.record(z.string(), z.unknown()).optional(),
+})
+    .transform((data) => ({
+    type: "loadModel",
+    modelType: data.modelType,
+    modelSrc: modelInputToSrcSchema.parse(data.modelSrc),
+    modelName: modelInputToNameSchema.parse(data.modelSrc),
+    modelConfig: data.modelConfig ?? {},
+    seed: data.seed ?? false,
+    withProgress: data.withProgress ?? !!data.onProgress,
+    delegate: data.delegate,
+    ...(data.requestId !== undefined && { requestId: data.requestId }),
+}));
+const loadModelOptionsToRequestBaseSchema = z.union([
+    loadBuiltinToRequestSchema,
+    loadCustomPluginToRequestSchema,
+]);
+export const loadModelOptionsToRequestSchema = misplacedLoadModelConfigGuard.pipe(loadModelOptionsToRequestBaseSchema);
 const commonModelConfigSchema = z.object({
     type: z.literal("loadModel"),
     modelSrc: z.string(),
@@ -414,7 +473,7 @@ export const loadTtsModelRequestSchema = commonModelConfigSchema
     .strict();
 export const loadOcrModelRequestSchema = commonModelConfigSchema
     .extend({
-    modelType: z.literal(ModelType.onnxOcr),
+    modelType: z.literal(ModelType.ggmlOcr),
     modelConfig: ocrConfigSchema,
 })
     .strict();

package/dist/schemas/logging-stream.js

@@ -1,5 +1,11 @@
 import { z } from "zod";
-const logLevelValues = ["error", "warn", "info", "debug"];
+const logLevelValues = [
+    "error",
+    "warn",
+    "info",
+    "debug",
+    "off",
+];
 export const logLevelSchema = z.enum(logLevelValues);
 const loggingParamsSchema = z.object({
     id: z.string(),

package/dist/schemas/model-src-utils.d.ts

@@ -24,7 +24,7 @@ export declare const modelDescriptorSchema: 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";
@@ -61,7 +61,7 @@ export declare const modelSrcInputSchema: z.ZodUnion<readonly [z.ZodString, z.Zo
         "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";
@@ -104,7 +104,7 @@ export declare const modelInputToSrcSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zod
         "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";
@@ -126,7 +126,7 @@ export declare const modelInputToSrcSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zod
     engine?: string | undefined;
     expectedSize?: number | undefined;
     sha256Checksum?: string | undefined;
-    addon?: "embeddings" | "diffusion" | "tts" | "ocr" | "vla" | "llamacpp-completion" | "whispercpp-transcription" | "bci-whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "tts-ggml" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "ggml-vla" | "ggml-classification" | "llm" | "whisper" | "bci" | "nmt" | "parakeet" | "classification" | "vad" | undefined;
+    addon?: "embeddings" | "diffusion" | "tts" | "ocr" | "vla" | "llamacpp-completion" | "whispercpp-transcription" | "bci-whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "tts-ggml" | "parakeet-transcription" | "ggml-ocr" | "sdcpp-generation" | "ggml-vla" | "ggml-classification" | "llm" | "whisper" | "bci" | "nmt" | "parakeet" | "classification" | "vad" | undefined;
 }>>;
 /**
  * Schema that transforms ModelSrc to its optional name
@@ -157,7 +157,7 @@ export declare const modelInputToNameSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zo
         "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";
@@ -179,7 +179,7 @@ export declare const modelInputToNameSchema: z.ZodPipe<z.ZodUnion<readonly [z.Zo
     engine?: string | undefined;
     expectedSize?: number | undefined;
     sha256Checksum?: string | undefined;
-    addon?: "embeddings" | "diffusion" | "tts" | "ocr" | "vla" | "llamacpp-completion" | "whispercpp-transcription" | "bci-whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "tts-ggml" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "ggml-vla" | "ggml-classification" | "llm" | "whisper" | "bci" | "nmt" | "parakeet" | "classification" | "vad" | undefined;
+    addon?: "embeddings" | "diffusion" | "tts" | "ocr" | "vla" | "llamacpp-completion" | "whispercpp-transcription" | "bci-whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "tts-ggml" | "parakeet-transcription" | "ggml-ocr" | "sdcpp-generation" | "ggml-vla" | "ggml-classification" | "llm" | "whisper" | "bci" | "nmt" | "parakeet" | "classification" | "vad" | undefined;
 }>>;
 export declare function inferModelTypeFromModelSrc(modelSrc: unknown): string | undefined;
 //# sourceMappingURL=model-src-utils.d.ts.map

package/dist/schemas/model-types.d.ts

@@ -13,7 +13,7 @@ export declare const ModelType: {
     readonly onnxTts: "onnx-tts";
     readonly ttsGgml: "tts-ggml";
     readonly parakeetTranscription: "parakeet-transcription";
-    readonly onnxOcr: "onnx-ocr";
+    readonly ggmlOcr: "ggml-ocr";
     readonly sdcppGeneration: "sdcpp-generation";
     readonly ggmlVla: "ggml-vla";
     readonly ggmlClassification: "ggml-classification";
@@ -30,7 +30,7 @@ export declare const ModelTypeAliases: {
     readonly nmt: "nmtcpp-translation";
     readonly parakeet: "parakeet-transcription";
     readonly tts: "tts-ggml";
-    readonly ocr: "onnx-ocr";
+    readonly ocr: "ggml-ocr";
     readonly diffusion: "sdcpp-generation";
     readonly vla: "ggml-vla";
     readonly classification: "ggml-classification";
@@ -46,12 +46,11 @@ export type ModelTypeInput = CanonicalModelType | AliasKey;
  *
  * @example
  * ```typescript
- * // Using alias (backward compatible)
- * loadModel({ modelSrc: "...", modelType: MODEL_TYPES.nmt });
- * // MODEL_TYPES.nmt resolves to "nmtcpp-translation"
- *
- * // Using canonical name directly
+ * // Preferred: canonical name
  * loadModel({ modelSrc: "...", modelType: MODEL_TYPES.nmtcppTranslation });
+ *
+ * // Deprecated: alias (still resolves to "nmtcpp-translation")
+ * loadModel({ modelSrc: "...", modelType: MODEL_TYPES.nmt });
  * ```
  */
 export declare const PUBLIC_MODEL_TYPES: {
@@ -62,7 +61,7 @@ export declare const PUBLIC_MODEL_TYPES: {
     readonly nmt: "nmtcpp-translation";
     readonly parakeet: "parakeet-transcription";
     readonly tts: "tts-ggml";
-    readonly ocr: "onnx-ocr";
+    readonly ocr: "ggml-ocr";
     readonly diffusion: "sdcpp-generation";
     readonly vla: "ggml-vla";
     readonly classification: "ggml-classification";
@@ -74,7 +73,7 @@ export declare const PUBLIC_MODEL_TYPES: {
     readonly onnxTts: "onnx-tts";
     readonly ttsGgml: "tts-ggml";
     readonly parakeetTranscription: "parakeet-transcription";
-    readonly onnxOcr: "onnx-ocr";
+    readonly ggmlOcr: "ggml-ocr";
     readonly sdcppGeneration: "sdcpp-generation";
     readonly ggmlVla: "ggml-vla";
     readonly ggmlClassification: "ggml-classification";
@@ -94,7 +93,7 @@ export declare const modelTypeInputSchema: z.ZodEnum<{
     "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";
@@ -120,7 +119,7 @@ export declare const modelTypeSchema: z.ZodPipe<z.ZodEnum<{
     "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";
@@ -130,7 +129,7 @@ export declare const modelTypeSchema: z.ZodPipe<z.ZodEnum<{
     nmt: "nmt";
     parakeet: "parakeet";
     classification: "classification";
-}>, z.ZodTransform<"llamacpp-completion" | "whispercpp-transcription" | "bci-whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "tts-ggml" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "ggml-vla" | "ggml-classification", "embeddings" | "diffusion" | "tts" | "ocr" | "vla" | "llamacpp-completion" | "whispercpp-transcription" | "bci-whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "tts-ggml" | "parakeet-transcription" | "onnx-ocr" | "sdcpp-generation" | "ggml-vla" | "ggml-classification" | "llm" | "whisper" | "bci" | "nmt" | "parakeet" | "classification">>;
+}>, z.ZodTransform<"llamacpp-completion" | "whispercpp-transcription" | "bci-whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "tts-ggml" | "parakeet-transcription" | "ggml-ocr" | "sdcpp-generation" | "ggml-vla" | "ggml-classification", "embeddings" | "diffusion" | "tts" | "ocr" | "vla" | "llamacpp-completion" | "whispercpp-transcription" | "bci-whispercpp-transcription" | "llamacpp-embedding" | "nmtcpp-translation" | "onnx-tts" | "tts-ggml" | "parakeet-transcription" | "ggml-ocr" | "sdcpp-generation" | "ggml-vla" | "ggml-classification" | "llm" | "whisper" | "bci" | "nmt" | "parakeet" | "classification">>;
 /**
  * Normalize model type input to canonical form.
  * Custom plugin types (not in built-ins) are returned as-is.
@@ -218,12 +217,12 @@ export declare const ttsModelTypeSchema: z.ZodEnum<{
 export type TtsModelTypeInput = z.infer<typeof ttsModelTypeSchema>;
 /**
  * OCR model type schema.
- * - Alias: `"ocr"` → resolves to `"onnx-ocr"`
- * - Canonical: `"onnx-ocr"`
+ * - Alias: `"ocr"` → resolves to `"ggml-ocr"`
+ * - Canonical: `"ggml-ocr"`
  */
 export declare const ocrModelTypeSchema: z.ZodEnum<{
     ocr: "ocr";
-    "onnx-ocr": "onnx-ocr";
+    "ggml-ocr": "ggml-ocr";
 }>;
 export type OcrModelTypeInput = z.infer<typeof ocrModelTypeSchema>;
 /**

package/dist/schemas/model-types.js

@@ -14,7 +14,7 @@ export const ModelType = {
     onnxTts: "onnx-tts",
     ttsGgml: "tts-ggml",
     parakeetTranscription: "parakeet-transcription",
-    onnxOcr: "onnx-ocr",
+    ggmlOcr: "ggml-ocr",
     sdcppGeneration: "sdcpp-generation",
     ggmlVla: "ggml-vla",
     ggmlClassification: "ggml-classification",
@@ -46,7 +46,7 @@ export const ModelTypeAliases = {
     [AliasKeys.nmt]: ModelType.nmtcppTranslation,
     [AliasKeys.parakeet]: ModelType.parakeetTranscription,
     [AliasKeys.tts]: ModelType.ttsGgml,
-    [AliasKeys.ocr]: ModelType.onnxOcr,
+    [AliasKeys.ocr]: ModelType.ggmlOcr,
     [AliasKeys.diffusion]: ModelType.sdcppGeneration,
     [AliasKeys.vla]: ModelType.ggmlVla,
     [AliasKeys.classification]: ModelType.ggmlClassification,
@@ -62,12 +62,11 @@ const canonicalValuesSet = new Set(Object.values(ModelType));
  *
  * @example
  * ```typescript
- * // Using alias (backward compatible)
- * loadModel({ modelSrc: "...", modelType: MODEL_TYPES.nmt });
- * // MODEL_TYPES.nmt resolves to "nmtcpp-translation"
- *
- * // Using canonical name directly
+ * // Preferred: canonical name
  * loadModel({ modelSrc: "...", modelType: MODEL_TYPES.nmtcppTranslation });
+ *
+ * // Deprecated: alias (still resolves to "nmtcpp-translation")
+ * loadModel({ modelSrc: "...", modelType: MODEL_TYPES.nmt });
  * ```
  */
 export const PUBLIC_MODEL_TYPES = {
@@ -181,12 +180,12 @@ export const ttsModelTypeSchema = modelTypeInputSchema
     .describe('TTS model type: "tts" (alias) or "tts-ggml" (canonical)');
 /**
  * OCR model type schema.
- * - Alias: `"ocr"` → resolves to `"onnx-ocr"`
- * - Canonical: `"onnx-ocr"`
+ * - Alias: `"ocr"` → resolves to `"ggml-ocr"`
+ * - Canonical: `"ggml-ocr"`
  */
 export const ocrModelTypeSchema = modelTypeInputSchema
-    .extract([AliasKeys.ocr, ModelType.onnxOcr])
-    .describe('OCR model type: "ocr" (alias) or "onnx-ocr" (canonical)');
+    .extract([AliasKeys.ocr, ModelType.ggmlOcr])
+    .describe('OCR model type: "ocr" (alias) or "ggml-ocr" (canonical)');
 /**
  * Diffusion/Image Generation model type schema.
  * - Alias: `"diffusion"` → resolves to `"sdcpp-generation"`

package/dist/schemas/ocr.d.ts

@@ -1,22 +1,24 @@
 import { z } from "zod";
 export declare const ocrConfigSchema: z.ZodObject<{
     langList: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    useGPU: z.ZodOptional<z.ZodBoolean>;
-    timeout: z.ZodOptional<z.ZodNumber>;
-    pipelineMode: z.ZodOptional<z.ZodEnum<{
+    pipelineType: z.ZodOptional<z.ZodEnum<{
         easyocr: "easyocr";
         doctr: "doctr";
     }>>;
     magRatio: z.ZodOptional<z.ZodNumber>;
+    canvasSize: z.ZodOptional<z.ZodNumber>;
     defaultRotationAngles: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
     contrastRetry: z.ZodOptional<z.ZodBoolean>;
     lowConfidenceThreshold: z.ZodOptional<z.ZodNumber>;
     recognizerBatchSize: z.ZodOptional<z.ZodNumber>;
-    decodingMethod: z.ZodOptional<z.ZodEnum<{
-        attention: "attention";
-        ctc: "ctc";
+    nThreads: z.ZodOptional<z.ZodNumber>;
+    backendDevice: z.ZodOptional<z.ZodEnum<{
+        cpu: "cpu";
+        vulkan: "vulkan";
+        metal: "metal";
+        opencl: "opencl";
     }>>;
-    straightenPages: z.ZodOptional<z.ZodBoolean>;
+    gpuDevice: z.ZodOptional<z.ZodNumber>;
     detectorModelSrc: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
         src: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -42,7 +44,7 @@ export declare const ocrConfigSchema: 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";

package/dist/schemas/ocr.js

@@ -1,18 +1,20 @@
 import { z } from "zod";
 import { modelSrcInputSchema } from "./model-src-utils.js";
-// Model config
+// Model config — maps to @qvac/ocr-ggml `OcrGgmlParams`. Legacy ONNX-only knobs
+// (useGPU, timeout, pipelineMode, decodingMethod, straightenPages) are dropped;
+// zod's default (non-strict) object strips them silently if still passed.
 export const ocrConfigSchema = z.object({
     langList: z.array(z.string()).optional(),
-    useGPU: z.boolean().optional(),
-    timeout: z.number().optional(),
-    pipelineMode: z.enum(["easyocr", "doctr"]).optional(),
+    pipelineType: z.enum(["easyocr", "doctr"]).optional(),
     magRatio: z.number().optional(),
+    canvasSize: z.number().optional(),
     defaultRotationAngles: z.array(z.number()).optional(),
     contrastRetry: z.boolean().optional(),
     lowConfidenceThreshold: z.number().optional(),
     recognizerBatchSize: z.number().optional(),
-    decodingMethod: z.enum(["ctc", "attention"]).optional(),
-    straightenPages: z.boolean().optional(),
+    nThreads: z.number().optional(),
+    backendDevice: z.enum(["cpu", "vulkan", "metal", "opencl"]).optional(),
+    gpuDevice: z.number().optional(),
     detectorModelSrc: modelSrcInputSchema.optional(),
 });
 // Image input types

package/dist/schemas/plugin.d.ts

@@ -61,6 +61,7 @@ export interface DuplexPluginHandlerDefinition<TRequest extends z.ZodType = z.Zo
  * - `voicePath` - TTS (Supertonic) path to voice .bin file (e.g. voices/M1.bin)
  * - `speed`, `numInferenceSteps` - TTS (Supertonic) options
  * - `detectorModelPath` - OCR detector model
+ * - `embedderPath` - BCI whisper.cpp embedder weights
  *
  * Custom plugins can define their own artifact keys.
  */
@@ -276,10 +277,10 @@ export declare const PLUGIN_NMT: "@qvac/sdk/nmtcpp-translation/plugin";
  */
 export declare const PLUGIN_TTS: "@qvac/sdk/tts-ggml/plugin";
 /**
- * Optical character recognition plugin (ONNX).
+ * Optical character recognition plugin (GGML).
  * Provides: text extraction from images.
  */
-export declare const PLUGIN_OCR: "@qvac/sdk/onnx-ocr/plugin";
+export declare const PLUGIN_OCR: "@qvac/sdk/ggml-ocr/plugin";
 /**
  * Image generation plugin (stable-diffusion.cpp).
  * Provides: text-to-image generation and standalone ESRGAN image upscaling.
@@ -306,7 +307,7 @@ export declare const PLUGIN_CLASSIFICATION: "@qvac/sdk/ggml-classification/plugi
  *   plugins: [...SDK_DEFAULT_PLUGINS, myCustomPlugin],
  * };
  */
-export declare const SDK_DEFAULT_PLUGINS: readonly ["@qvac/sdk/llamacpp-completion/plugin", "@qvac/sdk/llamacpp-embedding/plugin", "@qvac/sdk/whispercpp-transcription/plugin", "@qvac/sdk/bci-whispercpp-transcription/plugin", "@qvac/sdk/parakeet-transcription/plugin", "@qvac/sdk/nmtcpp-translation/plugin", "@qvac/sdk/tts-ggml/plugin", "@qvac/sdk/onnx-ocr/plugin", "@qvac/sdk/sdcpp-generation/plugin", "@qvac/sdk/ggml-vla/plugin", "@qvac/sdk/ggml-classification/plugin"];
+export declare const SDK_DEFAULT_PLUGINS: readonly ["@qvac/sdk/llamacpp-completion/plugin", "@qvac/sdk/llamacpp-embedding/plugin", "@qvac/sdk/whispercpp-transcription/plugin", "@qvac/sdk/bci-whispercpp-transcription/plugin", "@qvac/sdk/parakeet-transcription/plugin", "@qvac/sdk/nmtcpp-translation/plugin", "@qvac/sdk/tts-ggml/plugin", "@qvac/sdk/ggml-ocr/plugin", "@qvac/sdk/sdcpp-generation/plugin", "@qvac/sdk/ggml-vla/plugin", "@qvac/sdk/ggml-classification/plugin"];
 export type BuiltinPlugin = (typeof SDK_DEFAULT_PLUGINS)[number];
 /** Native addon package for LLM completion (llama.cpp) */
 export declare const ADDON_LLM: "@qvac/llm-llamacpp";
@@ -322,8 +323,8 @@ export declare const ADDON_PARAKEET: "@qvac/transcription-parakeet";
 export declare const ADDON_NMT: "@qvac/translation-nmtcpp";
 /** Native addon package for TTS (GGML) */
 export declare const ADDON_TTS: "@qvac/tts-ggml";
-/** Native addon package for OCR (ONNX) */
-export declare const ADDON_OCR: "@qvac/ocr-onnx";
+/** Native addon package for OCR (GGML) */
+export declare const ADDON_OCR: "@qvac/ocr-ggml";
 /** Native addon package for image generation (stable-diffusion.cpp) */
 export declare const ADDON_DIFFUSION: "@qvac/diffusion-cpp";
 /** Native addon package for vision-language-action inference (SmolVLA / π₀.₅ on ggml) */

package/dist/schemas/plugin.js

@@ -162,10 +162,10 @@ export const PLUGIN_NMT = "@qvac/sdk/nmtcpp-translation/plugin";
  */
 export const PLUGIN_TTS = "@qvac/sdk/tts-ggml/plugin";
 /**
- * Optical character recognition plugin (ONNX).
+ * Optical character recognition plugin (GGML).
  * Provides: text extraction from images.
  */
-export const PLUGIN_OCR = "@qvac/sdk/onnx-ocr/plugin";
+export const PLUGIN_OCR = "@qvac/sdk/ggml-ocr/plugin";
 /**
  * Image generation plugin (stable-diffusion.cpp).
  * Provides: text-to-image generation and standalone ESRGAN image upscaling.
@@ -222,8 +222,8 @@ export const ADDON_PARAKEET = "@qvac/transcription-parakeet";
 export const ADDON_NMT = "@qvac/translation-nmtcpp";
 /** Native addon package for TTS (GGML) */
 export const ADDON_TTS = "@qvac/tts-ggml";
-/** Native addon package for OCR (ONNX) */
-export const ADDON_OCR = "@qvac/ocr-onnx";
+/** Native addon package for OCR (GGML) */
+export const ADDON_OCR = "@qvac/ocr-ggml";
 /** Native addon package for image generation (stable-diffusion.cpp) */
 export const ADDON_DIFFUSION = "@qvac/diffusion-cpp";
 /** Native addon package for vision-language-action inference (SmolVLA / π₀.₅ on ggml) */

package/dist/schemas/rag.d.ts

@@ -9,8 +9,8 @@ export declare const ragIngestParamsSchema: z.ZodObject<{
         chunkSize: z.ZodOptional<z.ZodNumber>;
         chunkOverlap: z.ZodOptional<z.ZodNumber>;
         chunkStrategy: z.ZodOptional<z.ZodEnum<{
-            paragraph: "paragraph";
             character: "character";
+            paragraph: "paragraph";
         }>>;
         splitStrategy: z.ZodOptional<z.ZodEnum<{
             character: "character";
@@ -30,8 +30,8 @@ export declare const ragChunkParamsSchema: z.ZodObject<{
         chunkSize: z.ZodOptional<z.ZodNumber>;
         chunkOverlap: z.ZodOptional<z.ZodNumber>;
         chunkStrategy: z.ZodOptional<z.ZodEnum<{
-            paragraph: "paragraph";
             character: "character";
+            paragraph: "paragraph";
         }>>;
         splitStrategy: z.ZodOptional<z.ZodEnum<{
             character: "character";
@@ -87,8 +87,8 @@ export declare const ragRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         chunkSize: z.ZodOptional<z.ZodNumber>;
         chunkOverlap: z.ZodOptional<z.ZodNumber>;
         chunkStrategy: z.ZodOptional<z.ZodEnum<{
-            paragraph: "paragraph";
             character: "character";
+            paragraph: "paragraph";
         }>>;
         splitStrategy: z.ZodOptional<z.ZodEnum<{
             character: "character";
@@ -110,8 +110,8 @@ export declare const ragRequestSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         chunkSize: z.ZodOptional<z.ZodNumber>;
         chunkOverlap: z.ZodOptional<z.ZodNumber>;
         chunkStrategy: z.ZodOptional<z.ZodEnum<{
-            paragraph: "paragraph";
             character: "character";
+            paragraph: "paragraph";
         }>>;
         splitStrategy: z.ZodOptional<z.ZodEnum<{
             character: "character";

package/dist/schemas/registry.d.ts

@@ -23,7 +23,7 @@ export declare const modelRegistryEngineSchema: z.ZodEnum<{
     "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";
@@ -64,7 +64,7 @@ export declare const modelRegistryEntrySchema: 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";
@@ -117,7 +117,7 @@ export declare const modelRegistryListResponseSchema: 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";
@@ -189,7 +189,7 @@ export declare const modelRegistrySearchResponseSchema: 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";
@@ -245,7 +245,7 @@ export declare const modelRegistryGetModelResponseSchema: 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";
@@ -323,7 +323,7 @@ export declare const modelRegistryResponseSchema: z.ZodDiscriminatedUnion<[z.Zod
             "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";
@@ -371,7 +371,7 @@ export declare const modelRegistryResponseSchema: z.ZodDiscriminatedUnion<[z.Zod
             "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";
@@ -419,7 +419,7 @@ export declare const modelRegistryResponseSchema: z.ZodDiscriminatedUnion<[z.Zod
             "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";

package/dist/schemas/registry.js

@@ -29,7 +29,7 @@ export const modelRegistryEngineSchema = z.enum([
     ModelType.nmtcppTranslation,
     ModelType.onnxTts,
     ModelType.ttsGgml,
-    ModelType.onnxOcr,
+    ModelType.ggmlOcr,
     ModelType.parakeetTranscription,
     ModelType.sdcppGeneration,
     ModelType.ggmlVla,