@qvac/sdk 0.6.1 → 0.7.1

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

@@ -5,17 +5,15 @@ export const SDK_CLIENT_ERROR_CODES = {
     INVALID_RESPONSE_TYPE: 50001,
     INVALID_OPERATION_IN_RESPONSE: 50002,
     STREAM_ENDED_WITHOUT_RESPONSE: 50003,
-    NO_DATA_RECEIVED: 50004,
-    INVALID_AUDIO_CHUNK_TYPE: 50005,
-    INVALID_TOOLS_ARRAY: 50006,
-    INVALID_TOOL_SCHEMA: 50007,
-    OCR_FAILED: 50008,
+    INVALID_AUDIO_CHUNK_TYPE: 50004,
+    INVALID_TOOLS_ARRAY: 50005,
+    INVALID_TOOL_SCHEMA: 50006,
+    OCR_FAILED: 50007,
     // RPC Communication Errors (50,200-50,399)
     RPC_NO_HANDLER: 50200,
     RPC_REQUEST_NOT_SENT: 50201,
     RPC_RESPONSE_STREAM_NOT_CREATED: 50202,
     RPC_CONNECTION_FAILED: 50203,
-    UNKNOWN_REQUEST_TYPE: 50204,
     // Provider/Delegation Errors (50,400-50,599)
     PROVIDER_START_FAILED: 50400,
     PROVIDER_STOP_FAILED: 50401,
@@ -29,6 +27,8 @@ export const SDK_CLIENT_ERROR_CODES = {
     CONFIG_FILE_INVALID: 50603,
     CONFIG_FILE_PARSE_FAILED: 50604,
     CONFIG_VALIDATION_FAILED: 50605,
+    PEAR_WORKER_ENTRY_REQUIRED: 50606,
+    MULTIPLE_SDK_INSTALLATIONS: 50607,
 };
 const clientErrorDefinitions = {
     // Response Validation Errors (50,001-50,199)
@@ -44,10 +44,6 @@ const clientErrorDefinitions = {
         name: "STREAM_ENDED_WITHOUT_RESPONSE",
         message: "Stream ended without receiving final response",
     },
-    [SDK_CLIENT_ERROR_CODES.NO_DATA_RECEIVED]: {
-        name: "NO_DATA_RECEIVED",
-        message: "No data received from request",
-    },
     [SDK_CLIENT_ERROR_CODES.INVALID_AUDIO_CHUNK_TYPE]: {
         name: "INVALID_AUDIO_CHUNK_TYPE",
         message: "Invalid audio chunk type received",
@@ -81,10 +77,6 @@ const clientErrorDefinitions = {
         name: "RPC_CONNECTION_FAILED",
         message: (details) => `RPC connection failed: ${details}`,
     },
-    [SDK_CLIENT_ERROR_CODES.UNKNOWN_REQUEST_TYPE]: {
-        name: "UNKNOWN_REQUEST_TYPE",
-        message: "Unknown request type received",
-    },
     // Provider/Delegation Errors (50,400-50,599)
     [SDK_CLIENT_ERROR_CODES.PROVIDER_START_FAILED]: {
         name: "PROVIDER_START_FAILED",
@@ -109,7 +101,7 @@ const clientErrorDefinitions = {
     // Build/Bundle Errors (50,600-50,799)
     [SDK_CLIENT_ERROR_CODES.SDK_NOT_FOUND_IN_NODE_MODULES]: {
         name: "SDK_NOT_FOUND_IN_NODE_MODULES",
-        message: "@qvac/sdk not found in node_modules",
+        message: "QVAC SDK not found in node_modules. Checked: @qvac/sdk, @tetherto/sdk-mono, @tetherto/sdk-dev",
     },
     [SDK_CLIENT_ERROR_CODES.WORKER_FILE_NOT_FOUND]: {
         name: "WORKER_FILE_NOT_FOUND",
@@ -131,6 +123,14 @@ const clientErrorDefinitions = {
         name: "CONFIG_VALIDATION_FAILED",
         message: (errors) => `Config validation failed: ${errors}`,
     },
+    [SDK_CLIENT_ERROR_CODES.MULTIPLE_SDK_INSTALLATIONS]: {
+        name: "MULTIPLE_SDK_INSTALLATIONS",
+        message: (packages) => `Multiple QVAC SDK installations found: ${packages}. Remove all but one to avoid conflicts.`,
+    },
+    [SDK_CLIENT_ERROR_CODES.PEAR_WORKER_ENTRY_REQUIRED]: {
+        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.`,
+    },
 };
 addCodes(clientErrorDefinitions, { name: "qvac-sdk-client", version: "1.1.0" });
 export { clientErrorDefinitions as SDK_CLIENT_ERROR_DEFINITIONS };

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

@@ -0,0 +1,6 @@
+export declare const REGISTRY_ERROR_CODES: {
+    readonly FAILED_TO_CONNECT: 19001;
+    readonly FAILED_TO_CLOSE: 19002;
+    readonly MODEL_NOT_FOUND: 19003;
+};
+//# sourceMappingURL=sdk-errors-registry.d.ts.map

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

@@ -0,0 +1,8 @@
+// Registry client error codes (19,001-20,000 range)
+// These match the codes from @qvac/registry-client/utils/error.js
+// Used for checking error types - the actual error definitions are in the registry client
+export const REGISTRY_ERROR_CODES = {
+    FAILED_TO_CONNECT: 19001,
+    FAILED_TO_CLOSE: 19002,
+    MODEL_NOT_FOUND: 19003,
+};

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

@@ -11,8 +11,8 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly MODEL_FILE_LOCATE_FAILED: 52203;
     readonly PROJECTION_MODEL_REQUIRED: 52204;
     readonly VAD_MODEL_REQUIRED: 52205;
-    readonly TTS_CONFIG_MODEL_REQUIRED: 52206;
-    readonly ESPEAK_DATA_PATH_REQUIRED: 52207;
+    readonly TTS_ARTIFACTS_REQUIRED: 52208;
+    readonly TTS_REFERENCE_AUDIO_REQUIRED: 52209;
     readonly MODEL_UNLOAD_FAILED: 52400;
     readonly EMBED_FAILED: 52401;
     readonly EMBED_NO_EMBEDDINGS: 52402;
@@ -55,6 +55,7 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly ARCHIVE_UNSUPPORTED_TYPE: 53012;
     readonly ARCHIVE_MISSING_SHARDS: 53013;
     readonly PARTIAL_DOWNLOAD_OFFLINE: 53014;
+    readonly REGISTRY_DOWNLOAD_FAILED: 53015;
     readonly DELETE_CACHE_FAILED: 53200;
     readonly INVALID_DELETE_CACHE_PARAMS: 53201;
     readonly CACHE_DIR_NOT_ABSOLUTE: 53202;
@@ -66,6 +67,19 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly INVALID_AUDIO_CHUNK_TYPE: 53502;
     readonly DELEGATE_NO_FINAL_RESPONSE: 53700;
     readonly DELEGATE_CONNECTION_FAILED: 53701;
+    readonly DELEGATE_PROVIDER_ERROR: 53702;
+    readonly RPC_NO_DATA_RECEIVED: 53703;
+    readonly RPC_UNKNOWN_REQUEST_TYPE: 53704;
+    readonly PLUGIN_NOT_FOUND: 53850;
+    readonly PLUGIN_HANDLER_NOT_FOUND: 53851;
+    readonly PLUGIN_REQUEST_VALIDATION_FAILED: 53852;
+    readonly PLUGIN_RESPONSE_VALIDATION_FAILED: 53853;
+    readonly PLUGIN_ALREADY_REGISTERED: 53854;
+    readonly PLUGIN_HANDLER_TYPE_MISMATCH: 53855;
+    readonly PLUGIN_LOGGING_INVALID: 53856;
+    readonly PLUGIN_DEFINITION_INVALID: 53857;
+    readonly PATH_TRAVERSAL: 53900;
+    readonly QVAC_MODEL_REGISTRY_QUERY_FAILED: 53950;
 };
 declare const serverErrorDefinitions: ErrorCodesMap;
 export { serverErrorDefinitions as SDK_SERVER_ERROR_DEFINITIONS };

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

@@ -14,8 +14,8 @@ export const SDK_SERVER_ERROR_CODES = {
     MODEL_FILE_LOCATE_FAILED: 52203,
     PROJECTION_MODEL_REQUIRED: 52204,
     VAD_MODEL_REQUIRED: 52205,
-    TTS_CONFIG_MODEL_REQUIRED: 52206,
-    ESPEAK_DATA_PATH_REQUIRED: 52207,
+    TTS_ARTIFACTS_REQUIRED: 52208,
+    TTS_REFERENCE_AUDIO_REQUIRED: 52209,
     // Model Operations (52,400-52,799)
     MODEL_UNLOAD_FAILED: 52400,
     EMBED_FAILED: 52401,
@@ -61,6 +61,7 @@ export const SDK_SERVER_ERROR_CODES = {
     ARCHIVE_UNSUPPORTED_TYPE: 53012,
     ARCHIVE_MISSING_SHARDS: 53013,
     PARTIAL_DOWNLOAD_OFFLINE: 53014,
+    REGISTRY_DOWNLOAD_FAILED: 53015,
     // Cache Operations (53,200-53,349)
     DELETE_CACHE_FAILED: 53200,
     INVALID_DELETE_CACHE_PARAMS: 53201,
@@ -73,9 +74,26 @@ export const SDK_SERVER_ERROR_CODES = {
     FFMPEG_NOT_AVAILABLE: 53500,
     AUDIO_PLAYER_FAILED: 53501,
     INVALID_AUDIO_CHUNK_TYPE: 53502,
-    // RPC/Delegation (Server-side) (53,700-53,899)
+    // RPC/Delegation (Server-side) (53,700-53,849)
     DELEGATE_NO_FINAL_RESPONSE: 53700,
     DELEGATE_CONNECTION_FAILED: 53701,
+    DELEGATE_PROVIDER_ERROR: 53702,
+    RPC_NO_DATA_RECEIVED: 53703,
+    RPC_UNKNOWN_REQUEST_TYPE: 53704,
+    // Plugin Errors (53,850-53,899)
+    PLUGIN_NOT_FOUND: 53850,
+    PLUGIN_HANDLER_NOT_FOUND: 53851,
+    PLUGIN_REQUEST_VALIDATION_FAILED: 53852,
+    PLUGIN_RESPONSE_VALIDATION_FAILED: 53853,
+    PLUGIN_ALREADY_REGISTERED: 53854,
+    PLUGIN_HANDLER_TYPE_MISMATCH: 53855,
+    PLUGIN_LOGGING_INVALID: 53856,
+    PLUGIN_DEFINITION_INVALID: 53857,
+    // Security (53,900-53,949)
+    PATH_TRAVERSAL: 53900,
+    // QVAC Model Registry Operations (53,950-54,000)
+    // Note: Registry client errors (19,001-20,000) are re-thrown directly
+    QVAC_MODEL_REGISTRY_QUERY_FAILED: 53950,
 };
 const serverErrorDefinitions = {
     // Model Registry Errors (52,001-52,199)
@@ -97,7 +115,7 @@ const serverErrorDefinitions = {
     },
     [SDK_SERVER_ERROR_CODES.UNKNOWN_MODEL_TYPE]: {
         name: "UNKNOWN_MODEL_TYPE",
-        message: (modelType) => `Unknown model type: ${modelType}`,
+        message: (modelType) => `Unknown model type: ${modelType}. If using a custom worker bundle, ensure the plugin for "${modelType}" is included in your qvac.config plugins array and rebuild with "npx qvac bundle sdk".`,
     },
     // Model Loading Errors (52,200-52,399)
     [SDK_SERVER_ERROR_CODES.MODEL_LOAD_FAILED]: {
@@ -124,13 +142,13 @@ const serverErrorDefinitions = {
         name: "VAD_MODEL_REQUIRED",
         message: "VAD model source is required for this configuration",
     },
-    [SDK_SERVER_ERROR_CODES.TTS_CONFIG_MODEL_REQUIRED]: {
-        name: "TTS_CONFIG_MODEL_REQUIRED",
-        message: "ttsConfigModelPath is required for TTS models",
+    [SDK_SERVER_ERROR_CODES.TTS_ARTIFACTS_REQUIRED]: {
+        name: "TTS_ARTIFACTS_REQUIRED",
+        message: "TTS (Chatterbox) requires ttsTokenizerSrc, ttsSpeechEncoderSrc, ttsEmbedTokensSrc, ttsConditionalDecoderSrc, and ttsLanguageModelSrc",
     },
-    [SDK_SERVER_ERROR_CODES.ESPEAK_DATA_PATH_REQUIRED]: {
-        name: "ESPEAK_DATA_PATH_REQUIRED",
-        message: "eSpeakDataPath is required for TTS models",
+    [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)",
     },
     // Model Operations (52,400-52,799)
     [SDK_SERVER_ERROR_CODES.MODEL_UNLOAD_FAILED]: {
@@ -283,6 +301,10 @@ const serverErrorDefinitions = {
         name: "HYPERDRIVE_DOWNLOAD_FAILED",
         message: (details) => `Hyperdrive download failed: ${details}`,
     },
+    [SDK_SERVER_ERROR_CODES.REGISTRY_DOWNLOAD_FAILED]: {
+        name: "REGISTRY_DOWNLOAD_FAILED",
+        message: (details) => `Registry download failed: ${details}`,
+    },
     [SDK_SERVER_ERROR_CODES.INVALID_SHARD_URL_PATTERN]: {
         name: "INVALID_SHARD_URL_PATTERN",
         message: (url) => `URL does not contain a valid sharded model pattern: ${url}`,
@@ -351,6 +373,64 @@ const serverErrorDefinitions = {
         name: "DELEGATE_CONNECTION_FAILED",
         message: (details) => `Failed to connect to delegated provider: ${details}`,
     },
+    [SDK_SERVER_ERROR_CODES.DELEGATE_PROVIDER_ERROR]: {
+        name: "DELEGATE_PROVIDER_ERROR",
+        message: (details, providerCode) => `Delegated provider error: ${details}` +
+            (providerCode ? ` (code: ${providerCode})` : ""),
+    },
+    [SDK_SERVER_ERROR_CODES.RPC_NO_DATA_RECEIVED]: {
+        name: "RPC_NO_DATA_RECEIVED",
+        message: "No data received from request",
+    },
+    [SDK_SERVER_ERROR_CODES.RPC_UNKNOWN_REQUEST_TYPE]: {
+        name: "RPC_UNKNOWN_REQUEST_TYPE",
+        message: (requestType) => `Unknown request type received: ${requestType}`,
+    },
+    // Plugin Errors (53,850-53,899)
+    [SDK_SERVER_ERROR_CODES.PLUGIN_NOT_FOUND]: {
+        name: "PLUGIN_NOT_FOUND",
+        message: (modelType) => `Plugin not found for model type "${modelType}". If using a custom worker bundle, ensure the plugin is included in your qvac.config plugins array and rebuild with "npx qvac bundle sdk".`,
+    },
+    [SDK_SERVER_ERROR_CODES.PLUGIN_HANDLER_NOT_FOUND]: {
+        name: "PLUGIN_HANDLER_NOT_FOUND",
+        message: (modelType, handler, availableHandlers) => `Handler "${handler}" not found in plugin "${modelType}"` +
+            (availableHandlers ? `. Available handlers: ${availableHandlers}` : ""),
+    },
+    [SDK_SERVER_ERROR_CODES.PLUGIN_REQUEST_VALIDATION_FAILED]: {
+        name: "PLUGIN_REQUEST_VALIDATION_FAILED",
+        message: (handler, details) => `Request validation failed for handler "${handler}"${details ? `: ${details}` : ""}`,
+    },
+    [SDK_SERVER_ERROR_CODES.PLUGIN_RESPONSE_VALIDATION_FAILED]: {
+        name: "PLUGIN_RESPONSE_VALIDATION_FAILED",
+        message: (handler, details) => `Response validation failed for handler "${handler}"${details ? `: ${details}` : ""}`,
+    },
+    [SDK_SERVER_ERROR_CODES.PLUGIN_ALREADY_REGISTERED]: {
+        name: "PLUGIN_ALREADY_REGISTERED",
+        message: (modelType) => `Plugin already registered for modelType: ${modelType}`,
+    },
+    [SDK_SERVER_ERROR_CODES.PLUGIN_HANDLER_TYPE_MISMATCH]: {
+        name: "PLUGIN_HANDLER_TYPE_MISMATCH",
+        message: (handlerName, expected, actual) => `Handler "${handlerName}" is ${actual}, but was called as ${expected}. Use invokePlugin() for reply handlers and invokePluginStream() for streaming handlers.`,
+    },
+    [SDK_SERVER_ERROR_CODES.PLUGIN_LOGGING_INVALID]: {
+        name: "PLUGIN_LOGGING_INVALID",
+        message: (modelType, reason) => `Plugin "${modelType}" has invalid logging configuration: ${reason}`,
+    },
+    [SDK_SERVER_ERROR_CODES.PLUGIN_DEFINITION_INVALID]: {
+        name: "PLUGIN_DEFINITION_INVALID",
+        message: (modelType, details) => `Plugin definition invalid for "${modelType}": ${details}`,
+    },
+    // Security (53,900-53,949)
+    [SDK_SERVER_ERROR_CODES.PATH_TRAVERSAL]: {
+        name: "PATH_TRAVERSAL",
+        message: (component, basePath) => `Path traversal detected: "${component}" escapes base directory "${basePath}"`,
+    },
+    // QVAC Model Registry Operations (53,950-54,000)
+    // Note: Registry client errors (19,001-20,000) are re-thrown directly
+    [SDK_SERVER_ERROR_CODES.QVAC_MODEL_REGISTRY_QUERY_FAILED]: {
+        name: "QVAC_MODEL_REGISTRY_QUERY_FAILED",
+        message: (details) => `QVAC model registry query failed${details ? `: ${details}` : ""}`,
+    },
 };
 addCodes(serverErrorDefinitions, { name: "qvac-sdk-server", version: "1.1.0" });
 export { serverErrorDefinitions as SDK_SERVER_ERROR_DEFINITIONS };