@qvac/sdk 0.11.0 → 0.12.1

package/dist/server/utils/tools/parsers/qwen35.js

@@ -22,12 +22,16 @@ function coerceParamValue(raw, schema) {
                 throw new Error(`invalid integer value: "${trimmed}"`);
             return n;
         }
-        case "boolean":
-            if (trimmed === "true")
+        case "boolean": {
+            // Qwen3.5/3.6 intermittently emit Python-style capitalised booleans
+            // (`True`/`False`); accept any casing so a valid call isn't dropped.
+            const v = trimmed.toLowerCase();
+            if (v === "true")
                 return true;
-            if (trimmed === "false")
+            if (v === "false")
                 return false;
             throw new Error(`invalid boolean value: "${trimmed}"`);
+        }
         case "array":
         case "object":
             return JSON.parse(trimmed);

package/dist/server/worker.js

@@ -2,21 +2,24 @@
  * Default worker entry point that registers ALL built-in plugins.
  */
 import { initializeWorkerCore, ensureRPCSetup } from "./worker-core.js";
-import { registerPlugin } from "./plugins/index.js";
+import { registerPlugins } from "./plugins/index.js";
 import { getServerLogger } from "../logging/index.js";
-import { llmPlugin, embeddingsPlugin, whisperPlugin, parakeetPlugin, nmtPlugin, ttsPlugin, ocrPlugin, diffusionPlugin, } from "./bare/plugins/index.js";
+import { llmPlugin, embeddingsPlugin, whisperPlugin, parakeetPlugin, nmtPlugin, ttsPlugin, ocrPlugin, diffusionPlugin, vlaPlugin, classificationPlugin, } from "./bare/plugins/index.js";
 const { hasRPCConfig } = initializeWorkerCore();
 const logger = getServerLogger();
 logger.info("🐻 Hello from Bare");
-// Register all built-in plugins
-registerPlugin(llmPlugin);
-registerPlugin(embeddingsPlugin);
-registerPlugin(whisperPlugin);
-registerPlugin(parakeetPlugin);
-registerPlugin(nmtPlugin);
-registerPlugin(ttsPlugin);
-registerPlugin(ocrPlugin);
-registerPlugin(diffusionPlugin);
+registerPlugins([
+    llmPlugin,
+    embeddingsPlugin,
+    whisperPlugin,
+    parakeetPlugin,
+    nmtPlugin,
+    ttsPlugin,
+    ocrPlugin,
+    diffusionPlugin,
+    vlaPlugin,
+    classificationPlugin,
+]);
 logger.info(hasRPCConfig
     ? "Parsed RPC configuration from arguments"
     : "Using default configuration (direct mode)");

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

@@ -41,6 +41,14 @@ export declare class RPCConnectionFailedError extends QvacErrorBase {
 export declare class RPCInitTimeoutError extends QvacErrorBase {
     constructor(timeoutMs: number, cause?: unknown);
 }
+export declare class WorkerCrashedError extends QvacErrorBase {
+    readonly exitCode: number | null;
+    readonly exitSignal: NodeJS.Signals | null;
+    constructor(exitCode: number | null, exitSignal: NodeJS.Signals | null, cause?: unknown);
+}
+export declare class WorkerShutdownError extends QvacErrorBase {
+    constructor(cause?: unknown);
+}
 export declare class ProviderStartFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
@@ -68,9 +76,24 @@ export declare class WorkerFileNotFoundError extends QvacErrorBase {
 export declare class PearWorkerEntryRequiredError extends QvacErrorBase {
     constructor(workerEntry: string, cause?: unknown);
 }
+export declare class WorkerPluginsNotRegisteredError extends QvacErrorBase {
+    constructor(cause?: unknown);
+}
 export declare class BundleVerificationFailedError extends QvacErrorBase {
     constructor(bundlePath: string, cause?: unknown);
 }
+export declare class BarePackNotInstalledError extends QvacErrorBase {
+    constructor(cause?: unknown);
+}
+export declare class BarePackError extends QvacErrorBase {
+    constructor(exitCode: number, entryPath: string, outputPath: string, cause?: unknown);
+}
+export declare class InvalidPluginSpecifierError extends QvacErrorBase {
+    constructor(specifiers: string[], cause?: unknown);
+}
+export declare class BareImportsMapNotFoundError extends QvacErrorBase {
+    constructor(sdkName: string, expectedPath: string, cause?: unknown);
+}
 export declare class ConfigFileNotFoundError extends QvacErrorBase {
     constructor(searchPaths: string, cause?: unknown);
 }

package/dist/utils/errors-client.js

@@ -74,6 +74,20 @@ export class RPCInitTimeoutError extends QvacErrorBase {
         super(createErrorOptions(SDK_CLIENT_ERROR_CODES.RPC_INIT_TIMEOUT, [timeoutMs], cause));
     }
 }
+export class WorkerCrashedError extends QvacErrorBase {
+    exitCode;
+    exitSignal;
+    constructor(exitCode, exitSignal, cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.WORKER_CRASHED, [String(exitCode), String(exitSignal)], cause));
+        this.exitCode = exitCode;
+        this.exitSignal = exitSignal;
+    }
+}
+export class WorkerShutdownError extends QvacErrorBase {
+    constructor(cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.WORKER_SHUTDOWN, undefined, cause));
+    }
+}
 // ============== Provider/Delegation Errors ==============
 export class ProviderStartFailedError extends QvacErrorBase {
     constructor(details, cause) {
@@ -121,11 +135,37 @@ export class PearWorkerEntryRequiredError extends QvacErrorBase {
         super(createErrorOptions(SDK_CLIENT_ERROR_CODES.PEAR_WORKER_ENTRY_REQUIRED, [workerEntry], cause));
     }
 }
+export class WorkerPluginsNotRegisteredError extends QvacErrorBase {
+    constructor(cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.WORKER_PLUGINS_NOT_REGISTERED, [], cause));
+    }
+}
 export class BundleVerificationFailedError extends QvacErrorBase {
     constructor(bundlePath, cause) {
         super(createErrorOptions(SDK_CLIENT_ERROR_CODES.BUNDLE_VERIFICATION_FAILED, [bundlePath], cause));
     }
 }
+export class BarePackNotInstalledError extends QvacErrorBase {
+    constructor(cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.BARE_PACK_NOT_INSTALLED, undefined, cause));
+    }
+}
+export class BarePackError extends QvacErrorBase {
+    constructor(exitCode, entryPath, outputPath, cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.BARE_PACK_ERROR, [exitCode, entryPath, outputPath], cause));
+    }
+}
+export class InvalidPluginSpecifierError extends QvacErrorBase {
+    constructor(specifiers, cause) {
+        const list = specifiers.map((s) => `  - ${s}`).join("\n");
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.INVALID_PLUGIN_SPECIFIER, [list], cause));
+    }
+}
+export class BareImportsMapNotFoundError extends QvacErrorBase {
+    constructor(sdkName, expectedPath, cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.BARE_IMPORTS_MAP_NOT_FOUND, [sdkName, expectedPath], cause));
+    }
+}
 export class ConfigFileNotFoundError extends QvacErrorBase {
     constructor(searchPaths, cause) {
         super(createErrorOptions(SDK_CLIENT_ERROR_CODES.CONFIG_FILE_NOT_FOUND, [searchPaths], cause));

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

@@ -52,8 +52,11 @@ export declare class TtsArtifactsRequiredError extends QvacErrorBase {
 export declare class TtsReferenceAudioRequiredError extends QvacErrorBase {
     constructor(cause?: unknown);
 }
-export declare class ParakeetArtifactsRequiredError extends QvacErrorBase {
-    constructor(details?: string, cause?: unknown);
+export declare class LegacyParakeetModelDeprecatedError extends QvacErrorBase {
+    constructor(legacyFields: readonly string[], cause?: unknown);
+}
+export declare class LegacyTtsModelDeprecatedError extends QvacErrorBase {
+    constructor(legacyFields: readonly string[], cause?: unknown);
 }
 export declare class ModelUnloadFailedError extends QvacErrorBase {
     constructor(modelId?: string, cause?: unknown);
@@ -76,6 +79,31 @@ export declare class TranslationFailedError extends QvacErrorBase {
 export declare class CompletionFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
+/**
+ * Thrown when the prompt exceeds the loaded model's configured context
+ * window — distinct from a generic `CompletionFailedError` so consumers
+ * can drive UX (truncate, summarize, or surface a "increase ctx_size /
+ * start a new thread" CTA) instead of treating it as an opaque failure.
+ *
+ * Carries the addon-reported prompt size and the model's context window
+ * when the addon's error message includes them (the C++ overflow paths
+ * in `TextLlmContext.cpp` and `MtmdLlmContext.cpp` format both numbers
+ * into the message; the bare `processPromptImpl: context overflow`
+ * fallback in `LlamaModel.cpp` carries neither — both fields are
+ * therefore optional). `modelId` is supplied by the server-side handler
+ * that wraps the addon error.
+ *
+ * Round-trips the RPC boundary via the typed-error reconstructor in
+ * `client/rpc/rpc-error.ts`, so `err instanceof ContextOverflowError`
+ * works on the consumer side.
+ */
+export declare class ContextOverflowError extends QvacErrorBase {
+    readonly promptTokens?: number;
+    readonly ctxSize?: number;
+    readonly modelId?: string;
+    constructor(promptTokens?: number, ctxSize?: number, modelId?: string, cause?: unknown);
+    toErrorResponseFields(): Record<string, unknown>;
+}
 export declare class AttachmentNotFoundError extends QvacErrorBase {
     constructor(path: string, cause?: unknown);
 }

package/dist/utils/errors-server.js

@@ -63,9 +63,14 @@ export class TtsReferenceAudioRequiredError extends QvacErrorBase {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.TTS_REFERENCE_AUDIO_REQUIRED, undefined, cause));
     }
 }
-export class ParakeetArtifactsRequiredError extends QvacErrorBase {
-    constructor(details, cause) {
-        super(createErrorOptions(SDK_SERVER_ERROR_CODES.PARAKEET_ARTIFACTS_REQUIRED, details ? [details] : undefined, cause));
+export class LegacyParakeetModelDeprecatedError extends QvacErrorBase {
+    constructor(legacyFields, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.LEGACY_PARAKEET_MODEL_DEPRECATED, [legacyFields.join(", ")], cause));
+    }
+}
+export class LegacyTtsModelDeprecatedError extends QvacErrorBase {
+    constructor(legacyFields, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.LEGACY_TTS_MODEL_DEPRECATED, [legacyFields.join(", ")], cause));
     }
 }
 // ============== Model Unloading Errors ==============
@@ -105,6 +110,49 @@ export class CompletionFailedError extends QvacErrorBase {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.COMPLETION_FAILED, details ? [details] : undefined, cause));
     }
 }
+/**
+ * Thrown when the prompt exceeds the loaded model's configured context
+ * window — distinct from a generic `CompletionFailedError` so consumers
+ * can drive UX (truncate, summarize, or surface a "increase ctx_size /
+ * start a new thread" CTA) instead of treating it as an opaque failure.
+ *
+ * Carries the addon-reported prompt size and the model's context window
+ * when the addon's error message includes them (the C++ overflow paths
+ * in `TextLlmContext.cpp` and `MtmdLlmContext.cpp` format both numbers
+ * into the message; the bare `processPromptImpl: context overflow`
+ * fallback in `LlamaModel.cpp` carries neither — both fields are
+ * therefore optional). `modelId` is supplied by the server-side handler
+ * that wraps the addon error.
+ *
+ * Round-trips the RPC boundary via the typed-error reconstructor in
+ * `client/rpc/rpc-error.ts`, so `err instanceof ContextOverflowError`
+ * works on the consumer side.
+ */
+export class ContextOverflowError extends QvacErrorBase {
+    promptTokens;
+    ctxSize;
+    modelId;
+    constructor(promptTokens, ctxSize, modelId, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.CONTEXT_OVERFLOW, [
+            promptTokens !== undefined ? String(promptTokens) : "",
+            ctxSize !== undefined ? String(ctxSize) : "",
+            modelId ?? "",
+        ], cause));
+        if (promptTokens !== undefined)
+            this.promptTokens = promptTokens;
+        if (ctxSize !== undefined)
+            this.ctxSize = ctxSize;
+        if (modelId !== undefined)
+            this.modelId = modelId;
+    }
+    toErrorResponseFields() {
+        return {
+            ...(this.promptTokens !== undefined && { promptTokens: this.promptTokens }),
+            ...(this.ctxSize !== undefined && { ctxSize: this.ctxSize }),
+            ...(this.modelId !== undefined && { modelId: this.modelId }),
+        };
+    }
+}
 export class AttachmentNotFoundError extends QvacErrorBase {
     constructor(path, cause) {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.ATTACHMENT_NOT_FOUND, [path], cause));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/sdk",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -88,9 +88,13 @@
       "types": "./dist/server/bare/plugins/nmtcpp-translation/plugin.d.ts",
       "import": "./dist/server/bare/plugins/nmtcpp-translation/plugin.js"
     },
+    "./tts-ggml/plugin": {
+      "types": "./dist/server/bare/plugins/tts-ggml/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/tts-ggml/plugin.js"
+    },
     "./onnx-tts/plugin": {
-      "types": "./dist/server/bare/plugins/onnx-tts/plugin.d.ts",
-      "import": "./dist/server/bare/plugins/onnx-tts/plugin.js"
+      "types": "./dist/server/bare/plugins/tts-ggml/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/tts-ggml/plugin.js"
     },
     "./onnx-ocr/plugin": {
       "types": "./dist/server/bare/plugins/onnx-ocr/plugin.d.ts",
@@ -100,6 +104,14 @@
       "types": "./dist/server/bare/plugins/sdcpp-generation/plugin.d.ts",
       "import": "./dist/server/bare/plugins/sdcpp-generation/plugin.js"
     },
+    "./ggml-vla/plugin": {
+      "types": "./dist/server/bare/plugins/ggml-vla/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/ggml-vla/plugin.js"
+    },
+    "./ggml-classification/plugin": {
+      "types": "./dist/server/bare/plugins/ggml-classification/plugin.d.ts",
+      "import": "./dist/server/bare/plugins/ggml-classification/plugin.js"
+    },
     "./plugin-utils": {
       "types": "./dist/schemas/plugin.d.ts",
       "import": "./dist/schemas/plugin.js"
@@ -115,6 +127,10 @@
     "./logging": {
       "import": "./dist/logging/index.js"
     },
+    "./commands": {
+      "types": "./dist/commands/index.d.ts",
+      "import": "./dist/commands/index.js"
+    },
     "./pear-pre": "./dist/pear/pre.js"
   },
   "imports": {
@@ -151,13 +167,13 @@
     "test:unit": "bun run scripts/run-unit-tests.ts",
     "test:security": "bun run scripts/run-security-tests.ts",
     "test:security:bare": "bun run scripts/run-security-tests-bare.ts",
-    "lint": "eslint . --max-warnings=0 && bun run typecheck",
+    "lint": "eslint . --max-warnings=0 && npm run typecheck",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "lint:fix": "eslint . --fix",
     "format": "prettier --check .",
     "format:fix": "prettier --write .",
     "postcompile:aliases": "node ./scripts/resolve-aliases.mjs",
-    "build": "rm -rf dist && bun run lint && tsc --project tsconfig.json && bun run postcompile:aliases",
+    "build": "rm -rf dist && npm run lint && tsc --project tsconfig.json && npm run postcompile:aliases",
     "build:pack": "bun run build && bun pm pack --destination dist/",
     "watch": "nodemon --watch server --ext ts --exec 'bun run build'",
     "bare:ensureprebuilds:llamacpp": "cp -r node_modules/@qvac/llm-llamacpp/prebuilds/android-arm64 node_modules/@qvac/llm-llamacpp/prebuilds/android-ia32 && cp -r node_modules/@qvac/llm-llamacpp/prebuilds/android-arm64 node_modules/@qvac/llm-llamacpp/prebuilds/android-arm && cp -r node_modules/@qvac/llm-llamacpp/prebuilds/android-arm64 node_modules/@qvac/llm-llamacpp/prebuilds/android-x64",
@@ -172,21 +188,43 @@
     "changelog:generate": "node ../../scripts/sdk/generate-changelog-sdk-pod.cjs --package=sdk && prettier --write changelog"
   },
   "dependencies": {
+    "@qvac/classification-ggml": "^0.2.0",
     "@qvac/decoder-audio": "^0.3.7",
-    "@qvac/diffusion-cpp": "^0.7.0",
-    "@qvac/embed-llamacpp": "^0.16.0",
+    "@qvac/diffusion-cpp": "^0.10.0",
+    "@qvac/embed-llamacpp": "^0.17.0",
     "@qvac/error": "^0.1.1",
     "@qvac/langdetect-text": "^0.1.2",
-    "@qvac/llm-llamacpp": "^0.20.0",
+    "@qvac/llm-llamacpp": "^0.22.0",
     "@qvac/logging": "^0.1.0",
     "@qvac/ocr-onnx": "^0.5.0",
-    "@qvac/rag": "^0.5.0",
-    "@qvac/registry-client": "^0.5.0",
-    "@qvac/transcription-parakeet": "^0.5.0",
+    "@qvac/rag": "^0.6.2",
+    "@qvac/registry-client": "^0.6.0",
+    "@qvac/transcription-parakeet": "^0.6.0",
     "@qvac/transcription-whispercpp": "^0.7.0",
-    "@qvac/translation-nmtcpp": "^3.0.0",
-    "@qvac/tts-onnx": "^0.9.0",
+    "@qvac/translation-nmtcpp": "^4.0.0",
+    "@qvac/tts-ggml": "^0.1.4",
+    "@qvac/vla-ggml": "^0.2.0",
+    "bare-abort-controller": "^1.0.0",
+    "bare-crypto": "^1.13.4",
+    "bare-events": "^2.8.0",
+    "bare-fetch": "^2.5.1",
+    "bare-fs": "^4.5.1",
+    "bare-net": "^2.2.0",
+    "bare-os": "^3.6.2",
+    "bare-pack": "^2.0.1",
+    "bare-path": "^3.0.0",
+    "bare-process": "^4.2.2",
+    "bare-rpc": "^1.3.2",
+    "bare-runtime": "^1.24.2",
+    "bare-stream": "^2.7.0",
+    "bare-zlib": "^1.3.1",
+    "corestore": "^7.4.5",
     "fast-safe-stringify": "2.1.1",
+    "hyperdrive": "^13.0.1",
+    "hyperswarm": "^4.14.0",
+    "llm-splitter": "~0.2.0",
+    "semver": "^7.8.0",
+    "tar-stream": "^3.1.8",
     "which-runtime": "^1.3.2",
     "zod": "^4.3.0"
   },
@@ -194,28 +232,24 @@
     "@eslint/js": "^9.33.0",
     "@expo/config-plugins": "^54.0.4",
     "@lancedb/lancedb": "^0.21.3",
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "@qvac/cli": "^0.4.0",
     "@sqliteai/sqlite-wasm": "3.50.4-sync.0.8.30-vector.0.9.23",
     "@types/node": "^24.2.1",
+    "@types/semver": "^7.7.1",
     "@types/tar-stream": "^3.1.4",
-    "bare-pack": "^2.0.1",
     "bare-readline": "^1.2.0",
+    "bare-subprocess": "^5.2.3",
+    "bare-url": "^2.4.3",
     "brittle": "^3.19.1",
     "chromadb": "^3.0.14",
     "eslint": "^9.33.0",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.30.0",
     "eslint-plugin-react": "^7.37.5",
+    "events": "^3.3.0",
     "expo": "^54.0.33",
-    "expo-device": "^8.0.10",
-    "expo-file-system": "^19.0.21",
     "globals": "^16.3.0",
     "husky": "^9.1.7",
-    "hyperdb": "^4.16.1",
-    "pear-pipe": "^1.0.6",
     "prettier": "^3.6.2",
-    "react-native-bare-kit": "0.12.3",
     "remark-cli": "^12.0.1",
     "remark-code-import": "^1.2.0",
     "remark-frontmatter": "^5.0.0",
@@ -224,69 +258,21 @@
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.39.0"
   },
-  "peerDependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "@qvac/cli": "^0.4.0",
-    "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.1",
-    "bare-http1": "^4.1.6",
-    "bare-https": "^2.1.3",
+  "optionalDependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
     "bare-link": "^3.2.1",
-    "bare-net": "^2.2.0",
-    "bare-os": "^3.6.2",
-    "bare-path": "^3.0.0",
-    "bare-process": "^4.2.2",
-    "bare-rpc": "^1.3.2",
-    "bare-runtime": "^1.24.2",
-    "bare-stream": "^2.7.0",
-    "bare-subprocess": "^5.2.3",
-    "bare-zlib": "^1.3.1",
-    "compact-encoding": "^2.19.0",
-    "corestore": "^7.4.5",
-    "events": "^3.3.0",
-    "expo-build-properties": ">=0.12.0",
-    "expo-device": "^8.0.0",
-    "expo-file-system": "^19.0.15",
-    "hyperblobs": "^2.8.0",
-    "hyperdb": "^4.19.0",
-    "hyperdht": "^6.23.0",
-    "hyperdrive": "^13.0.1",
-    "hyperswarm": "^4.14.0",
-    "llm-splitter": "~0.2.0",
+    "compact-encoding": "^3.0.0",
+    "expo-build-properties": "^0.12.0",
+    "expo-device": "^8.0.10",
+    "expo-file-system": "^19.0.21",
     "pear-pipe": "^1.0.6",
-    "react-native-bare-kit": "0.12.3",
-    "tar-stream": "^3.1.8"
+    "react-native-bare-kit": "^0.14.0"
+  },
+  "peerDependencies": {
+    "tsx": "*"
   },
   "peerDependenciesMeta": {
-    "@qvac/cli": {
-      "optional": true
-    },
-    "@modelcontextprotocol/sdk": {
-      "optional": true
-    },
-    "expo-build-properties": {
-      "optional": true
-    },
-    "expo-device": {
-      "optional": true
-    },
-    "expo-file-system": {
-      "optional": true
-    },
-    "react-native-bare-kit": {
-      "optional": true
-    },
-    "compact-encoding": {
-      "optional": true
-    },
-    "hyperdht": {
-      "optional": true
-    },
-    "pear-pipe": {
+    "tsx": {
       "optional": true
     }
   },