@qvac/sdk 0.10.2 → 0.12.0

package/dist/schemas/sdk-config.js

@@ -5,6 +5,7 @@ import { llmConfigBaseSchema, embedConfigBaseSchema } from "./llamacpp-config.js
 import { whisperConfigSchema, parakeetConfigSchema, } from "./transcription-config.js";
 import { ocrConfigSchema } from "./ocr.js";
 import { sdcppConfigSchema } from "./sdcpp-config.js";
+import { vlaConfigSchema } from "./vla.js";
 import { runtimeContextSchema } from "./runtime-context.js";
 // Alias keys for user convenience (maps to canonical types)
 const AliasKeys = {
@@ -16,6 +17,7 @@ const AliasKeys = {
     tts: "tts",
     ocr: "ocr",
     diffusion: "diffusion",
+    vla: "vla",
 };
 /**
  * Device match criteria for device-specific config defaults.
@@ -48,9 +50,10 @@ export const deviceConfigDefaultsSchema = z
         .partial()
         .optional(),
     [ModelType.nmtcppTranslation]: z.record(z.string(), z.unknown()).optional(),
-    [ModelType.onnxTts]: z.record(z.string(), z.unknown()).optional(),
+    [ModelType.ttsGgml]: z.record(z.string(), z.unknown()).optional(),
     [ModelType.onnxOcr]: ocrConfigSchema.partial().optional(),
     [ModelType.sdcppGeneration]: sdcppConfigSchema.partial().optional(),
+    [ModelType.ggmlVla]: vlaConfigSchema.partial().optional(),
     // Alias keys (user-friendly)
     [AliasKeys.llm]: llmConfigBaseSchema.optional(),
     [AliasKeys.embeddings]: embedConfigBaseSchema.optional(),
@@ -60,6 +63,7 @@ export const deviceConfigDefaultsSchema = z
     [AliasKeys.tts]: z.record(z.string(), z.unknown()).optional(),
     [AliasKeys.ocr]: ocrConfigSchema.partial().optional(),
     [AliasKeys.diffusion]: sdcppConfigSchema.partial().optional(),
+    [AliasKeys.vla]: vlaConfigSchema.partial().optional(),
 })
     .partial();
 /**
@@ -153,4 +157,15 @@ export const qvacConfigSchema = z.object({
      * ```
      */
     deviceDefaults: z.array(devicePatternSchema).optional(),
+    /**
+     * List of plugin specifiers to include in the worker bundle.
+     * Each entry must end with /plugin (e.g. "@qvac/sdk/llamacpp-completion/plugin").
+     * When omitted, all built-in plugins are included.
+     */
+    plugins: z.array(z.string()).optional(),
+    /**
+     * Bare runtime version for native addon ABI verification during bundling.
+     * When omitted, verify auto-detects from node_modules (bare-runtime, then bare).
+     */
+    bareRuntimeVersion: z.string().optional(),
 });

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

@@ -27,6 +27,12 @@ export declare const SDK_CLIENT_ERROR_CODES: {
     readonly CONFIG_VALIDATION_FAILED: 50605;
     readonly PEAR_WORKER_ENTRY_REQUIRED: 50606;
     readonly MULTIPLE_SDK_INSTALLATIONS: 50607;
+    readonly WORKER_PLUGINS_NOT_REGISTERED: 50608;
+    readonly BUNDLE_VERIFICATION_FAILED: 50609;
+    readonly BARE_PACK_NOT_INSTALLED: 50610;
+    readonly BARE_PACK_ERROR: 50611;
+    readonly INVALID_PLUGIN_SPECIFIER: 50612;
+    readonly BARE_IMPORTS_MAP_NOT_FOUND: 50613;
     readonly PROFILER_INVALID_CAPACITY: 50800;
 };
 declare const clientErrorDefinitions: ErrorCodesMap;

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

@@ -32,6 +32,12 @@ export const SDK_CLIENT_ERROR_CODES = {
     CONFIG_VALIDATION_FAILED: 50605,
     PEAR_WORKER_ENTRY_REQUIRED: 50606,
     MULTIPLE_SDK_INSTALLATIONS: 50607,
+    WORKER_PLUGINS_NOT_REGISTERED: 50608,
+    BUNDLE_VERIFICATION_FAILED: 50609,
+    BARE_PACK_NOT_INSTALLED: 50610,
+    BARE_PACK_ERROR: 50611,
+    INVALID_PLUGIN_SPECIFIER: 50612,
+    BARE_IMPORTS_MAP_NOT_FOUND: 50613,
     // Profiler Errors (50,800-50,899)
     PROFILER_INVALID_CAPACITY: 50800,
 };
@@ -67,7 +73,7 @@ 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", "onnx-tts", "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", "onnx-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",
@@ -148,6 +154,30 @@ const clientErrorDefinitions = {
         name: "PEAR_WORKER_ENTRY_REQUIRED",
         message: (workerEntry) => `No plugins registered. Pear apps must spawn ${workerEntry} as the worker entry. Run \`npx qvac bundle sdk\` to generate it, then spawn the generated file instead of your worker directly.`,
     },
+    [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.",
+    },
+    [SDK_CLIENT_ERROR_CODES.BUNDLE_VERIFICATION_FAILED]: {
+        name: "BUNDLE_VERIFICATION_FAILED",
+        message: (bundlePath) => `qvac verify bundle reported error-level issues for ${bundlePath}. See the CLI output above for the failing addons/hosts; resolve them before shipping.`,
+    },
+    [SDK_CLIENT_ERROR_CODES.BARE_PACK_NOT_INSTALLED]: {
+        name: "BARE_PACK_NOT_INSTALLED",
+        message: "bare-pack binary not found. Install bare-pack as a peer dependency: npm install bare-pack",
+    },
+    [SDK_CLIENT_ERROR_CODES.BARE_PACK_ERROR]: {
+        name: "BARE_PACK_ERROR",
+        message: (exitCode, entryPath, outputPath) => `bare-pack exited with code ${exitCode}\n\n  Entry file: ${entryPath}\n  Output file: ${outputPath}\n\n  Run bare-pack manually for more details.`,
+    },
+    [SDK_CLIENT_ERROR_CODES.INVALID_PLUGIN_SPECIFIER]: {
+        name: "INVALID_PLUGIN_SPECIFIER",
+        message: (specifiers) => `Invalid plugin specifiers (must end with /plugin):\n${specifiers}`,
+    },
+    [SDK_CLIENT_ERROR_CODES.BARE_IMPORTS_MAP_NOT_FOUND]: {
+        name: "BARE_IMPORTS_MAP_NOT_FOUND",
+        message: (sdkName, expectedPath) => `bare-imports.json not found.\n\n  Expected at: ${expectedPath}\n\n  Make sure ${sdkName} is installed in your project.`,
+    },
     // Profiler Errors (50,800-50,899)
     [SDK_CLIENT_ERROR_CODES.PROFILER_INVALID_CAPACITY]: {
         name: "PROFILER_INVALID_CAPACITY",

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

@@ -13,7 +13,8 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly VAD_MODEL_REQUIRED: 52205;
     readonly TTS_ARTIFACTS_REQUIRED: 52208;
     readonly TTS_REFERENCE_AUDIO_REQUIRED: 52209;
-    readonly PARAKEET_ARTIFACTS_REQUIRED: 52210;
+    readonly LEGACY_PARAKEET_MODEL_DEPRECATED: 52210;
+    readonly LEGACY_TTS_MODEL_DEPRECATED: 52211;
     readonly MODEL_UNLOAD_FAILED: 52400;
     readonly EMBED_FAILED: 52401;
     readonly EMBED_NO_EMBEDDINGS: 52402;
@@ -31,6 +32,11 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly INVALID_IMAGE_INPUT: 52414;
     readonly TEXT_TO_SPEECH_STREAM_FAILED: 52415;
     readonly MODEL_OPERATION_NOT_SUPPORTED: 52416;
+    readonly REQUEST_ID_CONFLICT: 52417;
+    readonly REQUEST_NOT_FOUND: 52418;
+    readonly INFERENCE_CANCELLED: 52419;
+    readonly REQUEST_REJECTED_BY_POLICY: 52420;
+    readonly CONTEXT_OVERFLOW: 52421;
     readonly RAG_SAVE_FAILED: 52800;
     readonly RAG_SEARCH_FAILED: 52801;
     readonly RAG_DELETE_FAILED: 52802;
@@ -68,6 +74,7 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly FFMPEG_NOT_AVAILABLE: 53500;
     readonly AUDIO_PLAYER_FAILED: 53501;
     readonly INVALID_AUDIO_CHUNK_TYPE: 53502;
+    readonly ASYNC_DISPOSE_UNAVAILABLE: 53503;
     readonly DELEGATE_NO_FINAL_RESPONSE: 53700;
     readonly DELEGATE_CONNECTION_FAILED: 53701;
     readonly DELEGATE_PROVIDER_ERROR: 53702;

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

@@ -16,7 +16,8 @@ export const SDK_SERVER_ERROR_CODES = {
     VAD_MODEL_REQUIRED: 52205,
     TTS_ARTIFACTS_REQUIRED: 52208,
     TTS_REFERENCE_AUDIO_REQUIRED: 52209,
-    PARAKEET_ARTIFACTS_REQUIRED: 52210,
+    LEGACY_PARAKEET_MODEL_DEPRECATED: 52210,
+    LEGACY_TTS_MODEL_DEPRECATED: 52211,
     // Model Operations (52,400-52,799)
     MODEL_UNLOAD_FAILED: 52400,
     EMBED_FAILED: 52401,
@@ -35,6 +36,11 @@ export const SDK_SERVER_ERROR_CODES = {
     INVALID_IMAGE_INPUT: 52414,
     TEXT_TO_SPEECH_STREAM_FAILED: 52415,
     MODEL_OPERATION_NOT_SUPPORTED: 52416,
+    REQUEST_ID_CONFLICT: 52417,
+    REQUEST_NOT_FOUND: 52418,
+    INFERENCE_CANCELLED: 52419,
+    REQUEST_REJECTED_BY_POLICY: 52420,
+    CONTEXT_OVERFLOW: 52421,
     // RAG Operations (52,800-52,999)
     RAG_SAVE_FAILED: 52800,
     RAG_SEARCH_FAILED: 52801,
@@ -77,6 +83,7 @@ export const SDK_SERVER_ERROR_CODES = {
     FFMPEG_NOT_AVAILABLE: 53500,
     AUDIO_PLAYER_FAILED: 53501,
     INVALID_AUDIO_CHUNK_TYPE: 53502,
+    ASYNC_DISPOSE_UNAVAILABLE: 53503,
     // RPC/Delegation (Server-side) (53,700-53,849)
     DELEGATE_NO_FINAL_RESPONSE: 53700,
     DELEGATE_CONNECTION_FAILED: 53701,
@@ -153,15 +160,19 @@ const serverErrorDefinitions = {
     },
     [SDK_SERVER_ERROR_CODES.TTS_ARTIFACTS_REQUIRED]: {
         name: "TTS_ARTIFACTS_REQUIRED",
-        message: "TTS (Chatterbox) requires ttsTokenizerSrc, ttsSpeechEncoderSrc, ttsEmbedTokensSrc, ttsConditionalDecoderSrc, and ttsLanguageModelSrc",
+        message: "TTS (Chatterbox) requires s3genModelSrc in modelConfig (companion S3Gen GGUF) and the primary T3 GGUF via modelSrc",
     },
     [SDK_SERVER_ERROR_CODES.TTS_REFERENCE_AUDIO_REQUIRED]: {
         name: "TTS_REFERENCE_AUDIO_REQUIRED",
         message: "TTS (Chatterbox) requires referenceAudioSrc (path or URL to a WAV file for voice cloning)",
     },
-    [SDK_SERVER_ERROR_CODES.PARAKEET_ARTIFACTS_REQUIRED]: {
-        name: "PARAKEET_ARTIFACTS_REQUIRED",
-        message: "Parakeet model sources are missing. TDT requires parakeetEncoderSrc, parakeetDecoderSrc, parakeetVocabSrc, parakeetPreprocessorSrc. CTC requires parakeetCtcModelSrc, parakeetTokenizerSrc. Sortformer requires parakeetSortformerSrc.",
+    [SDK_SERVER_ERROR_CODES.LEGACY_PARAKEET_MODEL_DEPRECATED]: {
+        name: "LEGACY_PARAKEET_MODEL_DEPRECATED",
+        message: (legacyFields) => `Legacy parakeet ONNX modelConfig fields are no longer supported (${legacyFields ?? "unknown fields"}). As of @qvac/transcription-parakeet 0.6.0 the addon ships as a single GGUF that auto-detects TDT / CTC / EOU / Sortformer from GGUF metadata. Supply the GGUF via the top-level modelSrc (e.g. loadModel({ modelSrc: PARAKEET_TDT_0_6B_V3_Q8_0, modelType: "parakeet" })).`,
+    },
+    [SDK_SERVER_ERROR_CODES.LEGACY_TTS_MODEL_DEPRECATED]: {
+        name: "LEGACY_TTS_MODEL_DEPRECATED",
+        message: (legacyFields) => `Legacy ONNX TTS modelConfig fields are no longer supported (${legacyFields ?? "unknown fields"}). As of @qvac/tts-ggml the addon uses GGUF bundles: supply the primary GGUF via modelSrc, set language in modelConfig, and for Chatterbox add s3genModelSrc (e.g. loadModel({ modelSrc: TTS_T3_TURBO_EN_CHATTERBOX_Q8_0, modelType: "tts", modelConfig: { ttsEngine: "chatterbox", language: "en", s3genModelSrc: TTS_S3GEN_EN_CHATTERBOX } })). Supertonic multilingual mode is selected by the GGUF (e.g. TTS_MULTILINGUAL_SUPERTONIC2_Q8_0) plus language — not ttsSupertonicMultilingual.`,
     },
     // Model Operations (52,400-52,799)
     [SDK_SERVER_ERROR_CODES.MODEL_UNLOAD_FAILED]: {
@@ -240,6 +251,31 @@ const serverErrorDefinitions = {
             return `Model "${modelId}" (type: ${modelType}) does not support ${operation}.${supportedClause}${suggestionClause}`;
         },
     },
+    [SDK_SERVER_ERROR_CODES.REQUEST_ID_CONFLICT]: {
+        name: "REQUEST_ID_CONFLICT",
+        message: (requestId) => `Request id "${requestId}" is already in flight; refusing to overwrite the existing context`,
+    },
+    [SDK_SERVER_ERROR_CODES.REQUEST_NOT_FOUND]: {
+        name: "REQUEST_NOT_FOUND",
+        message: (requestId) => `No in-flight request with id "${requestId}"`,
+    },
+    [SDK_SERVER_ERROR_CODES.INFERENCE_CANCELLED]: {
+        name: "INFERENCE_CANCELLED",
+        message: (requestId) => `Inference request "${requestId}" was cancelled before it could complete`,
+    },
+    [SDK_SERVER_ERROR_CODES.REQUEST_REJECTED_BY_POLICY]: {
+        name: "REQUEST_REJECTED_BY_POLICY",
+        message: (requestId, kind, modelId, reason) => `Request "${requestId}" (kind: ${kind}, modelId: ${modelId}) was rejected by registry concurrency policy: ${reason}`,
+    },
+    [SDK_SERVER_ERROR_CODES.CONTEXT_OVERFLOW]: {
+        name: "CONTEXT_OVERFLOW",
+        message: (promptTokens, ctxSize, modelId) => {
+            const prompt = promptTokens ? `${promptTokens} prompt tokens` : "prompt";
+            const ctx = ctxSize ? ` exceeds the ${ctxSize}-token context window` : " exceeds the model's context window";
+            const model = modelId ? ` for model "${modelId}"` : "";
+            return `${prompt}${ctx}${model}. Reduce the prompt size or start a new conversation.`;
+        },
+    },
     // RAG Operations (52,800-52,999)
     [SDK_SERVER_ERROR_CODES.RAG_SAVE_FAILED]: {
         name: "RAG_SAVE_FAILED",
@@ -393,6 +429,10 @@ const serverErrorDefinitions = {
         name: "INVALID_AUDIO_CHUNK_TYPE",
         message: "Invalid audio chunk type",
     },
+    [SDK_SERVER_ERROR_CODES.ASYNC_DISPOSE_UNAVAILABLE]: {
+        name: "ASYNC_DISPOSE_UNAVAILABLE",
+        message: "Host runtime does not expose Symbol.asyncDispose; the SDK request-lifecycle primitives require ES2024 `using`/`asyncDispose` support. Verify your runtime (Bare/Expo/Node ≥ 20.4) and any polyfill registration.",
+    },
     // RPC/Delegation (Server-side) (53,700-53,899)
     [SDK_SERVER_ERROR_CODES.DELEGATE_NO_FINAL_RESPONSE]: {
         name: "DELEGATE_NO_FINAL_RESPONSE",