@qvac/sdk 0.9.2 → 0.10.0

package/dist/schemas/sdk-config.js

@@ -117,6 +117,22 @@ export const qvacConfigSchema = z.object({
      * Defaults to 10000 (10 seconds).
      */
     httpConnectionTimeoutMs: z.number().int().positive().optional(),
+    /**
+     * Maximum number of retry attempts for registry (P2P) downloads on timeout.
+     * When a download times out due to a P2P connection stall, the SDK will
+     * automatically retry up to this many times before failing.
+     * Defaults to 3.
+     */
+    registryDownloadMaxRetries: z.number().int().min(0).optional(),
+    /**
+     * Timeout in milliseconds for registry (P2P) download streams.
+     * Controls how long the SDK will wait on a stalled Hypercore block before
+     * triggering a REQUEST_TIMEOUT and (optionally) retrying. Raise this on
+     * slow or high-latency connections where the default triggers spurious
+     * retries / failures.
+     * Defaults to 60000 (60 seconds).
+     */
+    registryStreamTimeoutMs: z.number().int().positive().optional(),
     /**
      * Device-specific config defaults.
      * Use this to override model config defaults for specific devices.

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

@@ -7,10 +7,13 @@ export declare const SDK_CLIENT_ERROR_CODES: {
     readonly INVALID_TOOLS_ARRAY: 50005;
     readonly INVALID_TOOL_SCHEMA: 50006;
     readonly OCR_FAILED: 50007;
+    readonly MODEL_TYPE_REQUIRED: 50008;
+    readonly MODEL_SRC_TYPE_MISMATCH: 50009;
     readonly RPC_NO_HANDLER: 50200;
     readonly RPC_REQUEST_NOT_SENT: 50201;
     readonly RPC_RESPONSE_STREAM_NOT_CREATED: 50202;
     readonly RPC_CONNECTION_FAILED: 50203;
+    readonly RPC_INIT_TIMEOUT: 50204;
     readonly PROVIDER_START_FAILED: 50400;
     readonly PROVIDER_STOP_FAILED: 50401;
     readonly DELEGATE_NO_FINAL_RESPONSE: 50402;

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

@@ -9,11 +9,14 @@ export const SDK_CLIENT_ERROR_CODES = {
     INVALID_TOOLS_ARRAY: 50005,
     INVALID_TOOL_SCHEMA: 50006,
     OCR_FAILED: 50007,
+    MODEL_TYPE_REQUIRED: 50008,
+    MODEL_SRC_TYPE_MISMATCH: 50009,
     // 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,
+    RPC_INIT_TIMEOUT: 50204,
     // Provider/Delegation Errors (50,400-50,599)
     PROVIDER_START_FAILED: 50400,
     PROVIDER_STOP_FAILED: 50401,
@@ -62,6 +65,14 @@ const clientErrorDefinitions = {
         name: "OCR_FAILED",
         message: (details) => `OCR operation failed${details ? `: ${details}` : ""}`,
     },
+    [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.',
+    },
+    [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.`,
+    },
     // RPC Communication Errors (50,200-50,399)
     [SDK_CLIENT_ERROR_CODES.RPC_NO_HANDLER]: {
         name: "RPC_NO_HANDLER",
@@ -79,6 +90,10 @@ const clientErrorDefinitions = {
         name: "RPC_CONNECTION_FAILED",
         message: (details) => `RPC connection failed: ${details}`,
     },
+    [SDK_CLIENT_ERROR_CODES.RPC_INIT_TIMEOUT]: {
+        name: "RPC_INIT_TIMEOUT",
+        message: (timeoutMs) => `RPC initialization timed out after ${timeoutMs}ms — the worker process may have failed to start`,
+    },
     // Provider/Delegation Errors (50,400-50,599)
     [SDK_CLIENT_ERROR_CODES.PROVIDER_START_FAILED]: {
         name: "PROVIDER_START_FAILED",
@@ -139,5 +154,5 @@ const clientErrorDefinitions = {
         message: (minCapacity) => `Ring buffer capacity must be at least ${minCapacity}`,
     },
 };
-addCodes(clientErrorDefinitions, { name: "qvac-sdk-client", version: "1.1.0" });
+addCodes(clientErrorDefinitions, { name: "qvac-sdk-client", version: "1.2.0" });
 export { clientErrorDefinitions as SDK_CLIENT_ERROR_DEFINITIONS };

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

@@ -29,6 +29,8 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly OCR_FAILED: 52412;
     readonly IMAGE_FILE_NOT_FOUND: 52413;
     readonly INVALID_IMAGE_INPUT: 52414;
+    readonly TEXT_TO_SPEECH_STREAM_FAILED: 52415;
+    readonly MODEL_OPERATION_NOT_SUPPORTED: 52416;
     readonly RAG_SAVE_FAILED: 52800;
     readonly RAG_SEARCH_FAILED: 52801;
     readonly RAG_DELETE_FAILED: 52802;
@@ -83,6 +85,7 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly PLUGIN_LOAD_CONFIG_VALIDATION_FAILED: 53859;
     readonly LIFECYCLE_SUSPEND_FAILED: 53600;
     readonly LIFECYCLE_RESUME_FAILED: 53601;
+    readonly LIFECYCLE_OPERATION_BLOCKED: 53602;
     readonly PATH_TRAVERSAL: 53900;
     readonly QVAC_MODEL_REGISTRY_QUERY_FAILED: 53950;
 };

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

@@ -33,6 +33,8 @@ export const SDK_SERVER_ERROR_CODES = {
     OCR_FAILED: 52412,
     IMAGE_FILE_NOT_FOUND: 52413,
     INVALID_IMAGE_INPUT: 52414,
+    TEXT_TO_SPEECH_STREAM_FAILED: 52415,
+    MODEL_OPERATION_NOT_SUPPORTED: 52416,
     // RAG Operations (52,800-52,999)
     RAG_SAVE_FAILED: 52800,
     RAG_SEARCH_FAILED: 52801,
@@ -95,6 +97,7 @@ export const SDK_SERVER_ERROR_CODES = {
     // Lifecycle (53,600-53,610)
     LIFECYCLE_SUSPEND_FAILED: 53600,
     LIFECYCLE_RESUME_FAILED: 53601,
+    LIFECYCLE_OPERATION_BLOCKED: 53602,
     // Security (53,900-53,949)
     PATH_TRAVERSAL: 53900,
     // QVAC Model Registry Operations (53,950-54,000)
@@ -201,6 +204,10 @@ const serverErrorDefinitions = {
         name: "TEXT_TO_SPEECH_FAILED",
         message: (details) => `Text-to-speech operation failed${details ? `: ${details}` : ""}`,
     },
+    [SDK_SERVER_ERROR_CODES.TEXT_TO_SPEECH_STREAM_FAILED]: {
+        name: "TEXT_TO_SPEECH_STREAM_FAILED",
+        message: (details) => `Text-to-speech stream operation failed${details ? `: ${details}` : ""}`,
+    },
     [SDK_SERVER_ERROR_CODES.CONFIG_RELOAD_NOT_SUPPORTED]: {
         name: "CONFIG_RELOAD_NOT_SUPPORTED",
         message: (modelId) => `Model "${modelId}" does not support hot config reload`,
@@ -221,6 +228,18 @@ const serverErrorDefinitions = {
         name: "INVALID_IMAGE_INPUT",
         message: "Invalid image input type provided",
     },
+    [SDK_SERVER_ERROR_CODES.MODEL_OPERATION_NOT_SUPPORTED]: {
+        name: "MODEL_OPERATION_NOT_SUPPORTED",
+        message: (modelId, modelType, operation, supportedOperations, suggestedModelTypes) => {
+            const supportedClause = supportedOperations
+                ? ` Supported operations on this model: ${supportedOperations}.`
+                : " This model does not expose any operations.";
+            const suggestionClause = suggestedModelTypes
+                ? ` To use ${operation}, load a model of type: ${suggestedModelTypes}.`
+                : ` No model registered in this worker bundle exposes ${operation}.`;
+            return `Model "${modelId}" (type: ${modelType}) does not support ${operation}.${supportedClause}${suggestionClause}`;
+        },
+    },
     // RAG Operations (52,800-52,999)
     [SDK_SERVER_ERROR_CODES.RAG_SAVE_FAILED]: {
         name: "RAG_SAVE_FAILED",
@@ -447,6 +466,10 @@ const serverErrorDefinitions = {
         name: "LIFECYCLE_RESUME_FAILED",
         message: (details) => `Runtime resume failed${details ? `: ${details}` : ""}`,
     },
+    [SDK_SERVER_ERROR_CODES.LIFECYCLE_OPERATION_BLOCKED]: {
+        name: "LIFECYCLE_OPERATION_BLOCKED",
+        message: (requestType, lifecycleState) => `Operation "${requestType}" is blocked while runtime state is "${lifecycleState}"`,
+    },
     // Security (53,900-53,949)
     [SDK_SERVER_ERROR_CODES.PATH_TRAVERSAL]: {
         name: "PATH_TRAVERSAL",

package/dist/schemas/state.d.ts

@@ -0,0 +1,23 @@
+import { z } from "zod";
+export declare const lifecycleStateSchema: z.ZodEnum<{
+    active: "active";
+    suspending: "suspending";
+    suspended: "suspended";
+    resuming: "resuming";
+}>;
+export declare const stateRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"state">;
+}, z.core.$strip>;
+export declare const stateResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"state">;
+    state: z.ZodEnum<{
+        active: "active";
+        suspending: "suspending";
+        suspended: "suspended";
+        resuming: "resuming";
+    }>;
+}, z.core.$strip>;
+export type LifecycleState = z.infer<typeof lifecycleStateSchema>;
+export type StateRequest = z.infer<typeof stateRequestSchema>;
+export type StateResponse = z.infer<typeof stateResponseSchema>;
+//# sourceMappingURL=state.d.ts.map

package/dist/schemas/state.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export const lifecycleStateSchema = z.enum([
+    "active",
+    "suspending",
+    "suspended",
+    "resuming",
+]);
+export const stateRequestSchema = z.object({
+    type: z.literal("state"),
+});
+export const stateResponseSchema = z.object({
+    type: z.literal("state"),
+    state: lifecycleStateSchema,
+});

package/dist/schemas/stop-provide.d.ts

@@ -1,17 +1,12 @@
 import { z } from "zod";
-export declare const stopProvideParamsSchema: z.ZodObject<{
-    topic: z.ZodString;
-}, z.core.$strict>;
 export declare const stopProvideRequestSchema: z.ZodObject<{
     type: z.ZodLiteral<"stopProvide">;
-    topic: z.ZodString;
 }, z.core.$strict>;
 export declare const stopProvideResponseSchema: z.ZodObject<{
     type: z.ZodLiteral<"stopProvide">;
     success: z.ZodBoolean;
     error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-export type StopProvideParams = z.infer<typeof stopProvideParamsSchema>;
 export type StopProvideRequest = z.infer<typeof stopProvideRequestSchema>;
 export type StopProvideResponse = z.infer<typeof stopProvideResponseSchema>;
 //# sourceMappingURL=stop-provide.d.ts.map

package/dist/schemas/stop-provide.js

@@ -1,13 +1,9 @@
 import { z } from "zod";
-export const stopProvideParamsSchema = z
+export const stopProvideRequestSchema = z
     .object({
-    topic: z.string(),
+    type: z.literal("stopProvide"),
 })
     .strict();
-export const stopProvideRequestSchema = stopProvideParamsSchema.extend({
-    type: z.literal("stopProvide"),
-    topic: z.string(),
-});
 export const stopProvideResponseSchema = z.object({
     type: z.literal("stopProvide"),
     success: z.boolean(),