@qvac/sdk 0.9.2 → 0.10.1

package/dist/utils/cache-normalize.js

@@ -0,0 +1,23 @@
+// Shared by the auto-cache writer and reader on the server, and surfaced to
+// clients as `final.cacheableAssistantContent` so the next turn's `history`
+// produces a stable cache key.
+// Case-insensitive in case a model variant emits `<Think>`; the addon uses
+// lowercase today but we don't want a casing change to regress hit-rate.
+const THINK_BLOCK_RE = /<think>[\s\S]*?<\/think>/gi;
+// Trailing unclosed `<think>...` when a stop token interrupts mid-thought.
+// Must run after THINK_BLOCK_RE so only a genuinely unclosed tail matches.
+const UNCLOSED_TRAILING_THINK_RE = /<think>[\s\S]*$/i;
+/**
+ * Canonicalize assistant message text for the auto-cache key.
+ *
+ * The server saves raw stream text (with think tags when `captureThinking` is
+ * on), while `final.contentText` only aggregates `contentDelta` events.
+ * Stripping think blocks (paired and unclosed-trailing) and trimming lets
+ * callers push back either shape and still hit the cache.
+ */
+export function normalizeAssistantCacheContent(content) {
+    return content
+        .replace(THINK_BLOCK_RE, "")
+        .replace(UNCLOSED_TRAILING_THINK_RE, "")
+        .trim();
+}

package/dist/utils/encoding.d.ts

@@ -6,4 +6,12 @@
  * provides a cross-platform alternative to Buffer.from(str, "base64").
  */
 export declare function decodeBase64(base64: string): Uint8Array;
+/**
+ * Encodes a Uint8Array to a base64 string.
+ *
+ * Uses btoa which is available across all runtimes (Node, Bare, React Native).
+ * Buffer is not globally available in React Native (Hermes engine), so this
+ * provides a cross-platform alternative to Buffer.from(bytes).toString("base64").
+ */
+export declare function encodeBase64(bytes: Uint8Array): string;
 //# sourceMappingURL=encoding.d.ts.map

package/dist/utils/encoding.js

@@ -12,3 +12,16 @@ export function decodeBase64(base64) {
         bytes[i] = binary.charCodeAt(i);
     return bytes;
 }
+/**
+ * Encodes a Uint8Array to a base64 string.
+ *
+ * Uses btoa which is available across all runtimes (Node, Bare, React Native).
+ * Buffer is not globally available in React Native (Hermes engine), so this
+ * provides a cross-platform alternative to Buffer.from(bytes).toString("base64").
+ */
+export function encodeBase64(bytes) {
+    let binary = "";
+    for (let i = 0; i < bytes.length; i++)
+        binary += String.fromCharCode(bytes[i]);
+    return btoa(binary);
+}

package/dist/utils/errors-client.d.ts

@@ -20,6 +20,12 @@ export declare class InvalidToolSchemaError extends QvacErrorBase {
 export declare class OCRFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
+export declare class ModelTypeRequiredError extends QvacErrorBase {
+    constructor(cause?: unknown);
+}
+export declare class ModelSrcTypeMismatchError extends QvacErrorBase {
+    constructor(inferred: string, resolved: string, cause?: unknown);
+}
 export declare class RPCNoHandlerError extends QvacErrorBase {
     constructor(requestType: string, cause?: unknown);
 }
@@ -32,6 +38,9 @@ export declare class RPCResponseStreamNotCreatedError extends QvacErrorBase {
 export declare class RPCConnectionFailedError extends QvacErrorBase {
     constructor(details: string, cause?: unknown);
 }
+export declare class RPCInitTimeoutError extends QvacErrorBase {
+    constructor(timeoutMs: number, cause?: unknown);
+}
 export declare class ProviderStartFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
@@ -80,6 +89,9 @@ export declare class EmbedFailedError extends QvacErrorBase {
 export declare class TranscriptionFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
+export declare class TextToSpeechStreamFailedError extends QvacErrorBase {
+    constructor(details?: string, cause?: unknown);
+}
 export declare class TranslationFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }

package/dist/utils/errors-client.js

@@ -38,6 +38,16 @@ export class OCRFailedError extends QvacErrorBase {
         super(createErrorOptions(SDK_CLIENT_ERROR_CODES.OCR_FAILED, details ? [details] : undefined, cause));
     }
 }
+export class ModelTypeRequiredError extends QvacErrorBase {
+    constructor(cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.MODEL_TYPE_REQUIRED, undefined, cause));
+    }
+}
+export class ModelSrcTypeMismatchError extends QvacErrorBase {
+    constructor(inferred, resolved, cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.MODEL_SRC_TYPE_MISMATCH, [inferred, resolved], cause));
+    }
+}
 // ============== RPC Communication Errors ==============
 export class RPCNoHandlerError extends QvacErrorBase {
     constructor(requestType, cause) {
@@ -59,6 +69,11 @@ export class RPCConnectionFailedError extends QvacErrorBase {
         super(createErrorOptions(SDK_CLIENT_ERROR_CODES.RPC_CONNECTION_FAILED, [details], cause));
     }
 }
+export class RPCInitTimeoutError extends QvacErrorBase {
+    constructor(timeoutMs, cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.RPC_INIT_TIMEOUT, [timeoutMs], cause));
+    }
+}
 // ============== Provider/Delegation Errors ==============
 export class ProviderStartFailedError extends QvacErrorBase {
     constructor(details, cause) {
@@ -144,6 +159,11 @@ export class TranscriptionFailedError extends QvacErrorBase {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.TRANSCRIPTION_FAILED, details ? [details] : undefined, cause));
     }
 }
+export class TextToSpeechStreamFailedError extends QvacErrorBase {
+    constructor(details, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.TEXT_TO_SPEECH_STREAM_FAILED, details ? [details] : undefined, cause));
+    }
+}
 export class TranslationFailedError extends QvacErrorBase {
     constructor(details, cause) {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.TRANSLATION_FAILED, details ? [details] : undefined, cause));

package/dist/utils/errors-server.d.ts

@@ -68,12 +68,23 @@ export declare class CancelFailedError extends QvacErrorBase {
 export declare class TextToSpeechFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
+export declare class TextToSpeechStreamFailedError extends QvacErrorBase {
+    constructor(details?: string, cause?: unknown);
+}
 export declare class ConfigReloadNotSupportedError extends QvacErrorBase {
     constructor(modelId: string, cause?: unknown);
 }
 export declare class ModelTypeMismatchError extends QvacErrorBase {
     constructor(expectedType: string, providedType: string, cause?: unknown);
 }
+export declare class ModelOperationNotSupportedError extends QvacErrorBase {
+    readonly modelId: string;
+    readonly modelType: string;
+    readonly operation: string;
+    readonly supportedOperations: readonly string[];
+    readonly suggestedModelTypes: readonly string[];
+    constructor(modelId: string, modelType: string, operation: string, supportedOperations: readonly string[], suggestedModelTypes: readonly string[], cause?: unknown);
+}
 export declare class OCRFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
@@ -233,6 +244,9 @@ export declare class LifecycleSuspendFailedError extends QvacErrorBase {
 export declare class LifecycleResumeFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
+export declare class LifecycleOperationBlockedError extends QvacErrorBase {
+    constructor(requestType: string, lifecycleState: string);
+}
 export declare class PathTraversalError extends QvacErrorBase {
     constructor(component: string, basePath: string, cause?: unknown);
 }

package/dist/utils/errors-server.js

@@ -120,6 +120,11 @@ export class TextToSpeechFailedError extends QvacErrorBase {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.TEXT_TO_SPEECH_FAILED, details ? [details] : undefined, cause));
     }
 }
+export class TextToSpeechStreamFailedError extends QvacErrorBase {
+    constructor(details, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.TEXT_TO_SPEECH_STREAM_FAILED, details ? [details] : undefined, cause));
+    }
+}
 export class ConfigReloadNotSupportedError extends QvacErrorBase {
     constructor(modelId, cause) {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.CONFIG_RELOAD_NOT_SUPPORTED, [modelId], cause));
@@ -130,6 +135,27 @@ export class ModelTypeMismatchError extends QvacErrorBase {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.MODEL_TYPE_MISMATCH, [expectedType, providedType], cause));
     }
 }
+export class ModelOperationNotSupportedError extends QvacErrorBase {
+    modelId;
+    modelType;
+    operation;
+    supportedOperations;
+    suggestedModelTypes;
+    constructor(modelId, modelType, operation, supportedOperations, suggestedModelTypes, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.MODEL_OPERATION_NOT_SUPPORTED, [
+            modelId,
+            modelType,
+            operation,
+            supportedOperations.join(", "),
+            suggestedModelTypes.join(", "),
+        ], cause));
+        this.modelId = modelId;
+        this.modelType = modelType;
+        this.operation = operation;
+        this.supportedOperations = supportedOperations;
+        this.suggestedModelTypes = suggestedModelTypes;
+    }
+}
 export class OCRFailedError extends QvacErrorBase {
     constructor(details, cause) {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.OCR_FAILED, details ? [details] : undefined, cause));
@@ -407,6 +433,11 @@ export class LifecycleResumeFailedError extends QvacErrorBase {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.LIFECYCLE_RESUME_FAILED, details ? [details] : undefined, cause));
     }
 }
+export class LifecycleOperationBlockedError extends QvacErrorBase {
+    constructor(requestType, lifecycleState) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.LIFECYCLE_OPERATION_BLOCKED, [requestType, lifecycleState]));
+    }
+}
 // ============== Security Errors ==============
 export class PathTraversalError extends QvacErrorBase {
     constructor(component, basePath, cause) {

package/dist/utils/load-model-validation.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Throws {@link ModelSrcTypeMismatchError} when explicit
+ * `modelType` disagrees with the type inferred from `modelSrc`.
+ * No-op when nothing can be inferred.
+ */
+export declare function assertModelSrcMatchesModelType(modelSrc: unknown, explicitModelType: string): void;
+//# sourceMappingURL=load-model-validation.d.ts.map

package/dist/utils/load-model-validation.js

@@ -0,0 +1,18 @@
+import { inferModelTypeFromModelSrc } from "../schemas/model-src-utils.js";
+import { normalizeModelType } from "../schemas/model-types.js";
+import { ModelSrcTypeMismatchError } from "./errors-client.js";
+/**
+ * Throws {@link ModelSrcTypeMismatchError} when explicit
+ * `modelType` disagrees with the type inferred from `modelSrc`.
+ * No-op when nothing can be inferred.
+ */
+export function assertModelSrcMatchesModelType(modelSrc, explicitModelType) {
+    const inferred = inferModelTypeFromModelSrc(modelSrc);
+    if (!inferred)
+        return;
+    const normalizedInferred = normalizeModelType(inferred);
+    const normalizedExplicit = normalizeModelType(explicitModelType);
+    if (normalizedInferred !== normalizedExplicit) {
+        throw new ModelSrcTypeMismatchError(normalizedInferred, normalizedExplicit);
+    }
+}

package/expo/plugins/patches/android-link.mjs

@@ -54,7 +54,7 @@ if (fs.existsSync(manifestPath)) {
 for await (const resource of link(
   projectRoot,
   {
-    target: ["android-arm64", "android-arm", "android-ia32", "android-x64"],
+    hosts: ["android-arm64", "android-arm", "android-ia32", "android-x64"],
     out: addonsDir,
   },
   pkg,

package/expo/plugins/patches/ios-link.mjs

@@ -54,7 +54,7 @@ if (fs.existsSync(manifestPath)) {
 for await (const resource of link(
   projectRoot,
   {
-    target: ["ios-arm64", "ios-arm64-simulator", "ios-x64-simulator"],
+    hosts: ["ios-arm64", "ios-arm64-simulator", "ios-x64-simulator"],
     out: addonsDir,
   },
   pkg,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/sdk",
-  "version": "0.9.2",
+  "version": "0.10.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -173,20 +173,19 @@
   },
   "dependencies": {
     "@qvac/decoder-audio": "^0.3.7",
-    "@qvac/diffusion-cpp": "^0.1.3",
-    "@qvac/dl-filesystem": "^0.2.1",
-    "@qvac/embed-llamacpp": "^0.13.4",
+    "@qvac/diffusion-cpp": "^0.3.0",
+    "@qvac/embed-llamacpp": "^0.14.0",
     "@qvac/error": "^0.1.1",
     "@qvac/langdetect-text": "^0.1.2",
-    "@qvac/llm-llamacpp": "^0.14.4",
+    "@qvac/llm-llamacpp": "^0.17.1",
     "@qvac/logging": "^0.1.0",
     "@qvac/ocr-onnx": "^0.4.2",
     "@qvac/rag": "^0.4.4",
-    "@qvac/registry-client": "^0.4.0",
+    "@qvac/registry-client": "^0.4.1",
     "@qvac/transcription-parakeet": "^0.3.1",
     "@qvac/transcription-whispercpp": "^0.6.1",
-    "@qvac/translation-nmtcpp": "^0.6.10",
-    "@qvac/tts-onnx": "^0.8.2",
+    "@qvac/translation-nmtcpp": "^2.0.1",
+    "@qvac/tts-onnx": "^0.8.4",
     "fast-safe-stringify": "2.1.1",
     "which-runtime": "^1.3.2",
     "zod": "^4.3.0"
@@ -196,7 +195,7 @@
     "@expo/config-plugins": "^54.0.4",
     "@lancedb/lancedb": "^0.21.3",
     "@modelcontextprotocol/sdk": "^1.12.1",
-    "@qvac/cli": "^0.2.3",
+    "@qvac/cli": "^0.2.4",
     "@sqliteai/sqlite-wasm": "3.50.4-sync.0.8.30-vector.0.9.23",
     "@types/node": "^24.2.1",
     "@types/tar-stream": "^3.1.4",
@@ -216,7 +215,7 @@
     "hyperdb": "^4.16.1",
     "pear-pipe": "^1.0.6",
     "prettier": "^3.6.2",
-    "react-native-bare-kit": "^0.11.5",
+    "react-native-bare-kit": "0.12.3",
     "remark-cli": "^12.0.1",
     "remark-code-import": "^1.2.0",
     "remark-frontmatter": "^5.0.0",
@@ -227,16 +226,16 @@
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@qvac/cli": "^0.2.3",
+    "@qvac/cli": "^0.2.4",
     "bare-abort-controller": "^1.0.0",
     "bare-buffer": "^3.4.2",
     "bare-crypto": "^1.13.4",
     "bare-dns": "^2.1.4",
     "bare-fetch": "^2.5.1",
-    "bare-fs": "^4.5.2",
+    "bare-fs": "^4.5.1",
     "bare-http1": "^4.1.6",
     "bare-https": "^2.1.3",
-    "bare-link": "^2.1.10",
+    "bare-link": "^3.2.1",
     "bare-net": "^2.2.0",
     "bare-os": "^3.6.2",
     "bare-path": "^3.0.0",
@@ -257,7 +256,7 @@
     "hyperswarm": "^4.12.1",
     "llm-splitter": "~0.2.0",
     "pear-pipe": "^1.0.6",
-    "react-native-bare-kit": "^0.11.5",
+    "react-native-bare-kit": "0.12.3",
     "tar-stream": "^3.1.8"
   },
   "peerDependenciesMeta": {
@@ -286,8 +285,5 @@
       "optional": true
     }
   },
-  "patchedDependencies": {},
-  "overrides": {
-    "@qvac/dl-hyperdrive": "^0.2.0"
-  }
+  "patchedDependencies": {}
 }

package/dist/examples/translation/translation-opus.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=translation-opus.d.ts.map

package/dist/examples/translation/translation-opus.js

@@ -1,33 +0,0 @@
-import { loadModel, translate, unloadModel, MARIAN_OPUS_EN_IT_Q4_0, } from "@qvac/sdk";
-try {
-    const modelId = await loadModel({
-        modelSrc: MARIAN_OPUS_EN_IT_Q4_0,
-        modelType: "nmt",
-        modelConfig: {
-            engine: "Opus",
-            from: "en",
-            to: "it",
-            temperature: 0.2,
-            norepeatngramsize: 3,
-            lengthpenalty: 1.2,
-        },
-        onProgress: (progress) => {
-            console.log(progress);
-        },
-    });
-    console.log(`✅ Model loaded: ${modelId}`);
-    const text = "Hello, how are you today?";
-    const result = translate({
-        modelId,
-        text,
-        modelType: "nmt",
-        stream: false,
-    });
-    const translatedText = await result.text;
-    console.log(`Translated text EN -> IT: ${text} -> "${translatedText}"`);
-    await unloadModel({ modelId });
-}
-catch (error) {
-    console.error("❌ Error:", error);
-    process.exit(1);
-}

package/dist/server/bare/utils/loader-adapter.d.ts

@@ -1,7 +0,0 @@
-import type FilesystemDL from "@qvac/dl-filesystem";
-/**
- * Adapts FilesystemDL to addon Loader interface by adding download stub.
- * download() is never called when using filesystem loader.
- */
-export declare function asLoader<T>(loader: FilesystemDL): T;
-//# sourceMappingURL=loader-adapter.d.ts.map

package/dist/server/bare/utils/loader-adapter.js

@@ -1,9 +0,0 @@
-/**
- * Adapts FilesystemDL to addon Loader interface by adding download stub.
- * download() is never called when using filesystem loader.
- */
-export function asLoader(loader) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access
-    loader.download = () => Promise.reject(new Error("download not supported"));
-    return loader;
-}

package/dist/server/utils/model-path.d.ts

@@ -1,5 +0,0 @@
-export declare function parseModelPath(modelPath: string): {
-    dirPath: string;
-    basePath: string;
-};
-//# sourceMappingURL=model-path.d.ts.map

package/dist/server/utils/model-path.js

@@ -1,7 +0,0 @@
-import path from "bare-path";
-export function parseModelPath(modelPath) {
-    return {
-        dirPath: path.dirname(modelPath),
-        basePath: path.basename(modelPath),
-    };
-}

package/dist/server/utils/tool-parser.d.ts

@@ -1,7 +0,0 @@
-import type { Tool, ToolCall, ToolCallError } from "../../schemas/index";
-export declare function parseToolCalls(text: string, tools: Tool[]): {
-    toolCalls: ToolCall[];
-    errors: ToolCallError[];
-};
-export declare function convertToolsToGrammar(tools: Tool[]): string;
-//# sourceMappingURL=tool-parser.d.ts.map