@qvac/sdk 0.10.2 → 0.12.0

package/dist/examples/vla-smolvla.js

@@ -0,0 +1,75 @@
+/**
+ * SmolVLA (vision-language-action) example using the QVAC SDK.
+ *
+ * Loads the SmolVLA-LIBERO GGUF model, runs a single inference pass with
+ * synthetic inputs (zero-filled gray images + BOS-only tokens + zero state +
+ * zero noise), and prints the produced action chunk + per-stage timings.
+ *
+ * Usage:
+ *   bun examples/vla-smolvla.ts [path-to-smolvla.gguf]
+ *
+ * By default the example pulls the registry-baked SmolVLA-LIBERO GGUF
+ * (~1.9 GB) on first run and caches it locally. Pass an absolute path on
+ * the command line to override and load a local GGUF instead.
+ */
+import { close, loadModel, SMOLVLA_LIBERO_VISION_Q8, unloadModel, vla, vlaHparams, vlaPadState, vlaPreprocessImage, } from "@qvac/sdk";
+const modelSrcOverride = process.argv[2];
+const modelSrc = modelSrcOverride ?? SMOLVLA_LIBERO_VISION_Q8;
+try {
+    console.log("Loading SmolVLA model...");
+    const modelId = await loadModel({
+        modelSrc,
+        modelType: "vla",
+        modelConfig: { backend: "cpu" },
+        onProgress: (p) => typeof modelSrc === "string"
+            ? undefined
+            : process.stdout.write(`\rDownloading: ${p.percentage.toFixed(1)}%`),
+    });
+    if (typeof modelSrc !== "string")
+        process.stdout.write("\n");
+    console.log(`Model loaded: ${modelId}`);
+    const { hparams, backendName } = await vlaHparams({ modelId });
+    console.log(`Backend: ${backendName ?? "(unknown)"}`);
+    console.log("Hparams:", hparams);
+    // Build synthetic inputs sized to the model's expectations. A real
+    // consumer would: read camera frames, tokenize the instruction with the
+    // SmolVLM2 tokenizer, and read the robot's current end-effector pose.
+    const size = hparams.visionImageSize;
+    const dummyPixels = new Uint8Array(size * size * 3).fill(128);
+    const front = vlaPreprocessImage(dummyPixels, size, size, { size });
+    const wrist = vlaPreprocessImage(dummyPixels, size, size, { size });
+    const tokens = new Int32Array(hparams.tokenizerMaxLength);
+    const mask = new Uint8Array(hparams.tokenizerMaxLength);
+    // BOS-only "instruction" for the smoke test.
+    tokens[0] = 1;
+    mask[0] = 1;
+    const state = vlaPadState([0, 0, 0, 0, 0, 0], hparams.maxStateDim);
+    const noise = new Float32Array(hparams.chunkSize * hparams.maxActionDim);
+    console.log("Running VLA inference...");
+    const { actions, actionDim, chunkSize, stats } = await vla({
+        modelId,
+        images: [front, wrist],
+        imgWidth: size,
+        imgHeight: size,
+        state,
+        tokens,
+        mask,
+        noise,
+    });
+    console.log(`Got ${chunkSize} action steps of dim ${actionDim}.`);
+    console.log("First step:", Array.from(actions.subarray(0, actionDim)));
+    if (stats) {
+        console.log(`Timing: vision=${stats.vision_ms?.toFixed(0)}ms ` +
+            `smollm2=${stats.smollm2_total_ms?.toFixed(0)}ms ` +
+            `ode=${stats.ode_ms?.toFixed(0)}ms ` +
+            `total=${stats.total_ms?.toFixed(0)}ms`);
+    }
+    await unloadModel({ modelId, clearStorage: false });
+    console.log("Model unloaded.");
+    process.exit(0);
+}
+catch (error) {
+    console.error("VLA example failed:", error);
+    await close();
+    process.exit(1);
+}

package/dist/examples/voice-assistant/voice-assistant.js

@@ -10,7 +10,7 @@
  *
  * Requirements: FFmpeg installed, microphone access, speakers.
  */
-import { loadModel, unloadModel, transcribeStream, completion, textToSpeech, WHISPER_TINY, VAD_SILERO_5_1_2, LLAMA_3_2_1B_INST_Q4_0, TTS_SUPERTONIC2_OFFICIAL_TEXT_ENCODER_SUPERTONE_FP32, TTS_SUPERTONIC2_OFFICIAL_DURATION_PREDICTOR_SUPERTONE_FP32, TTS_SUPERTONIC2_OFFICIAL_VECTOR_ESTIMATOR_SUPERTONE_FP32, TTS_SUPERTONIC2_OFFICIAL_VOCODER_SUPERTONE_FP32, TTS_SUPERTONIC2_OFFICIAL_UNICODE_INDEXER_SUPERTONE_FP32, TTS_SUPERTONIC2_OFFICIAL_TTS_CONFIG_SUPERTONE, TTS_SUPERTONIC2_OFFICIAL_VOICE_STYLE_SUPERTONE, } from "@qvac/sdk";
+import { loadModel, unloadModel, transcribeStream, completion, textToSpeech, WHISPER_TINY, VAD_SILERO_5_1_2, LLAMA_3_2_1B_INST_Q4_0, TTS_EN_SUPERTONIC_Q8_0, } from "@qvac/sdk";
 import { spawnSync } from "child_process";
 import { startMicrophone } from "../audio/mic-input";
 import { createWavHeader, int16ArrayToBuffer, playAudio } from "../tts/utils";
@@ -100,21 +100,14 @@ const llmModelId = await loadModel({
 });
 console.log("Loading Supertonic TTS...");
 const ttsModelId = await loadModel({
-    modelSrc: TTS_SUPERTONIC2_OFFICIAL_TEXT_ENCODER_SUPERTONE_FP32.src,
+    modelSrc: TTS_EN_SUPERTONIC_Q8_0.src,
     modelType: "tts",
     modelConfig: {
         ttsEngine: "supertonic",
         language: "en",
+        voice: "F1",
         ttsSpeed: 1.05,
         ttsNumInferenceSteps: 5,
-        ttsSupertonicMultilingual: false,
-        ttsTextEncoderSrc: TTS_SUPERTONIC2_OFFICIAL_TEXT_ENCODER_SUPERTONE_FP32.src,
-        ttsDurationPredictorSrc: TTS_SUPERTONIC2_OFFICIAL_DURATION_PREDICTOR_SUPERTONE_FP32.src,
-        ttsVectorEstimatorSrc: TTS_SUPERTONIC2_OFFICIAL_VECTOR_ESTIMATOR_SUPERTONE_FP32.src,
-        ttsVocoderSrc: TTS_SUPERTONIC2_OFFICIAL_VOCODER_SUPERTONE_FP32.src,
-        ttsUnicodeIndexerSrc: TTS_SUPERTONIC2_OFFICIAL_UNICODE_INDEXER_SUPERTONE_FP32.src,
-        ttsTtsConfigSrc: TTS_SUPERTONIC2_OFFICIAL_TTS_CONFIG_SUPERTONE.src,
-        ttsVoiceStyleSrc: TTS_SUPERTONIC2_OFFICIAL_VOICE_STYLE_SUPERTONE.src,
     },
 });
 console.log("All models loaded.\n");

package/dist/expo/plugins/find-in-ancestor-node-modules.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Walks from `startDir` up to the filesystem root, returning the first
+ * `<dir>/node_modules/<name>` that exists, or `null`. Matches Node's own
+ * module resolution so packages hoisted to a monorepo root (e.g. by bun or
+ * yarn workspaces) are found from a nested project directory.
+ *
+ * Use this as the building block for any plugin lookup that historically
+ * checked only `<projectRoot>/node_modules`. For SDK resolution specifically
+ * use `resolveSDKPackageDir`, which layers multi-package disambiguation and
+ * shadowed-copy warnings on top of this.
+ */
+declare function findInAncestorNodeModules(startDir: string, name: string): string | null;
+export { findInAncestorNodeModules };
+//# sourceMappingURL=find-in-ancestor-node-modules.d.ts.map

package/dist/expo/plugins/find-in-ancestor-node-modules.js

@@ -0,0 +1,24 @@
+import * as fs from "fs";
+import * as path from "path";
+/**
+ * Walks from `startDir` up to the filesystem root, returning the first
+ * `<dir>/node_modules/<name>` that exists, or `null`. Matches Node's own
+ * module resolution so packages hoisted to a monorepo root (e.g. by bun or
+ * yarn workspaces) are found from a nested project directory.
+ *
+ * Use this as the building block for any plugin lookup that historically
+ * checked only `<projectRoot>/node_modules`. For SDK resolution specifically
+ * use `resolveSDKPackageDir`, which layers multi-package disambiguation and
+ * shadowed-copy warnings on top of this.
+ */
+function findInAncestorNodeModules(startDir, name) {
+    let dir = startDir;
+    let parent = path.dirname(dir);
+    for (; dir !== parent; dir = parent, parent = path.dirname(dir)) {
+        const candidate = path.join(dir, "node_modules", name);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+export { findInAncestorNodeModules };

package/dist/expo/plugins/get-project-root.d.ts

@@ -0,0 +1,22 @@
+import type { ExportedConfigWithProps } from "@expo/config-plugins";
+import type { ExpoConfig } from "expo/config";
+/**
+ * `projectRoot` resolution in Expo plugins depends on plugin type:
+ *
+ * - **Mod plugins** (callbacks passed to `withDangerousMod` etc.) receive an
+ *   `ExportedConfigWithProps<...>` whose `modRequest.projectRoot` is the
+ *   documented public API for the consumer's project directory.
+ * - **Base plugins** (called with the bare `ExpoConfig`) run before any mod
+ *   cycle and have no `modRequest`. The only way to recover the project root
+ *   is the (undocumented but stable) `_internal.projectRoot` escape hatch
+ *   Expo's config-plugins runtime attaches to the config it hands plugins.
+ *
+ * Both helpers exist so the two access patterns are picked deliberately —
+ * call the one that matches the plugin shape you're in. Don't reach into the
+ * raw fields directly; that's how `withMobileBundle` and `withDeviceInfo`
+ * silently disagreed on which directory they were resolving against.
+ */
+declare function getProjectRootFromMod(config: ExportedConfigWithProps<unknown>): string;
+declare function getProjectRootFromBaseConfig(config: ExpoConfig): string | undefined;
+export { getProjectRootFromMod, getProjectRootFromBaseConfig };
+//# sourceMappingURL=get-project-root.d.ts.map

package/dist/expo/plugins/get-project-root.js

@@ -0,0 +1,23 @@
+/**
+ * `projectRoot` resolution in Expo plugins depends on plugin type:
+ *
+ * - **Mod plugins** (callbacks passed to `withDangerousMod` etc.) receive an
+ *   `ExportedConfigWithProps<...>` whose `modRequest.projectRoot` is the
+ *   documented public API for the consumer's project directory.
+ * - **Base plugins** (called with the bare `ExpoConfig`) run before any mod
+ *   cycle and have no `modRequest`. The only way to recover the project root
+ *   is the (undocumented but stable) `_internal.projectRoot` escape hatch
+ *   Expo's config-plugins runtime attaches to the config it hands plugins.
+ *
+ * Both helpers exist so the two access patterns are picked deliberately —
+ * call the one that matches the plugin shape you're in. Don't reach into the
+ * raw fields directly; that's how `withMobileBundle` and `withDeviceInfo`
+ * silently disagreed on which directory they were resolving against.
+ */
+function getProjectRootFromMod(config) {
+    return config.modRequest.projectRoot;
+}
+function getProjectRootFromBaseConfig(config) {
+    return config._internal?.["projectRoot"];
+}
+export { getProjectRootFromMod, getProjectRootFromBaseConfig };

package/dist/expo/plugins/index.d.ts

@@ -4,5 +4,9 @@ export { default as withDeviceInfo } from "./withDeviceInfo";
 export { default as withMobileBundle } from "./withMobileBundle";
 export { default as withOpenCL } from "./withOpenCL";
 export { default as withQvacSDK } from "./withQvacSDK";
+export { getProjectRootFromMod, getProjectRootFromBaseConfig, } from "./get-project-root";
+export { resolveSDKPackageDir, SDK_PACKAGE_NAMES, } from "./resolve-sdk-package-dir";
+export type { SDKPackageInfo } from "./resolve-sdk-package-dir";
+export { findInAncestorNodeModules } from "./find-in-ancestor-node-modules";
 export { default } from "./withQvacSDK";
 //# sourceMappingURL=index.d.ts.map

package/dist/expo/plugins/index.js

@@ -4,5 +4,9 @@ export { default as withDeviceInfo } from "./withDeviceInfo.js";
 export { default as withMobileBundle } from "./withMobileBundle.js";
 export { default as withOpenCL } from "./withOpenCL.js";
 export { default as withQvacSDK } from "./withQvacSDK.js";
+// Helpers for downstream plugin authors composing on top of these plugins.
+export { getProjectRootFromMod, getProjectRootFromBaseConfig, } from "./get-project-root.js";
+export { resolveSDKPackageDir, SDK_PACKAGE_NAMES, } from "./resolve-sdk-package-dir.js";
+export { findInAncestorNodeModules } from "./find-in-ancestor-node-modules.js";
 // Export the main plugin as default for easy usage
 export { default } from "./withQvacSDK.js";

package/dist/expo/plugins/resolve-sdk-package-dir.d.ts

@@ -6,8 +6,15 @@ type SDKPackageInfo = {
 /**
  * Resolves the installed SDK package directory from node_modules.
  *
- * Checks all known published package names and returns the one that exists.
- * Throws if none found or if multiple are found (ambiguous installation).
+ * Walks from `projectRoot` up to the filesystem root, checking each
+ * `node_modules` directory along the way. This matches Node's own module
+ * resolution so packages hoisted to a monorepo root (e.g. by bun or yarn
+ * workspaces) are found correctly.
+ *
+ * When multiple SDK installs are found across the tree, the one closest to
+ * `projectRoot` wins and a warning lists the others. Only throws
+ * `MultipleSDKInstallationsError` when two *different* SDK package names
+ * coexist at the same nesting level (a real ambiguity in package selection).
  */
 declare function resolveSDKPackageDir(projectRoot: string): SDKPackageInfo;
 export { resolveSDKPackageDir, SDK_PACKAGE_NAMES };

package/dist/expo/plugins/resolve-sdk-package-dir.js

@@ -6,26 +6,53 @@ const SDK_PACKAGE_NAMES = [
     "@tetherto/sdk-mono",
     "@tetherto/sdk-dev",
 ];
+function findAllInAncestorNodeModules(startDir, name) {
+    const matches = [];
+    let dir = startDir;
+    let parent = path.dirname(dir);
+    let depth = 0;
+    for (; dir !== parent; dir = parent, parent = path.dirname(dir), depth++) {
+        const candidate = path.join(dir, "node_modules", name);
+        if (fs.existsSync(candidate)) {
+            matches.push({ name, dir: candidate, depth });
+        }
+    }
+    return matches;
+}
 /**
  * Resolves the installed SDK package directory from node_modules.
  *
- * Checks all known published package names and returns the one that exists.
- * Throws if none found or if multiple are found (ambiguous installation).
+ * Walks from `projectRoot` up to the filesystem root, checking each
+ * `node_modules` directory along the way. This matches Node's own module
+ * resolution so packages hoisted to a monorepo root (e.g. by bun or yarn
+ * workspaces) are found correctly.
+ *
+ * When multiple SDK installs are found across the tree, the one closest to
+ * `projectRoot` wins and a warning lists the others. Only throws
+ * `MultipleSDKInstallationsError` when two *different* SDK package names
+ * coexist at the same nesting level (a real ambiguity in package selection).
  */
 function resolveSDKPackageDir(projectRoot) {
-    const found = [];
+    const allMatches = [];
     for (const name of SDK_PACKAGE_NAMES) {
-        const dir = path.join(projectRoot, "node_modules", name);
-        if (fs.existsSync(dir)) {
-            found.push({ name, dir });
-        }
+        allMatches.push(...findAllInAncestorNodeModules(projectRoot, name));
     }
-    if (found.length === 0) {
+    if (allMatches.length === 0) {
         throw new SDKNotFoundInNodeModulesError();
     }
-    if (found.length > 1) {
-        throw new MultipleSDKInstallationsError(found.map((f) => f.name).join(", "));
+    const minDepth = Math.min(...allMatches.map((m) => m.depth));
+    const closest = allMatches.filter((m) => m.depth === minDepth);
+    if (closest.length > 1) {
+        throw new MultipleSDKInstallationsError(closest.map((m) => m.name).join(", "));
+    }
+    const winner = closest[0];
+    const shadowed = allMatches.filter((m) => m !== winner);
+    if (shadowed.length > 0) {
+        const others = shadowed.map((m) => `"${m.name}" at "${m.dir}"`).join(", ");
+        console.warn(`[resolveSDKPackageDir] Multiple SDK installations found; using ` +
+            `"${winner.name}" at "${winner.dir}" (closest to projectRoot). ` +
+            `Ignoring: ${others}.`);
     }
-    return found[0];
+    return { name: winner.name, dir: winner.dir };
 }
 export { resolveSDKPackageDir, SDK_PACKAGE_NAMES };

package/dist/expo/plugins/withDeviceInfo.js

@@ -1,6 +1,7 @@
 import * as fs from "fs";
 import * as path from "path";
 import { resolveSDKPackageDir } from "./resolve-sdk-package-dir.js";
+import { getProjectRootFromBaseConfig } from "./get-project-root.js";
 let didRun = false;
 /**
  * Expo plugin that stubs expo-device-info when expo-device is not a declared
@@ -13,7 +14,7 @@ function withDeviceInfo(config) {
         return config;
     }
     didRun = true;
-    const projectRoot = config._internal?.["projectRoot"];
+    const projectRoot = getProjectRootFromBaseConfig(config);
     if (!projectRoot) {
         return config;
     }

package/dist/expo/plugins/withMobileBundle.d.ts

@@ -1,11 +1,12 @@
 import type { ExpoConfig } from "expo/config";
+declare const MOBILE_HOSTS: string[];
 /**
- * Expo plugin that automatically generates the mobile worker bundle during build.
+ * Expo plugin: bundle, verify, then copy the mobile worker bundle.
  *
- * Runs qvac CLI (prefers local @qvac/cli, falls back to npx).
- * Uses qvac.config.* if exists, else includes all built-in plugins.
- * Output: node_modules/<sdk-package>/dist/worker.mobile.bundle.js
+ * Flow: bundleSdk -> verifyBundle -> copy to `<sdkPackageDir>/dist/worker.mobile.bundle.js`.
+ * Uses `qvac.config.*` if present.
  */
 declare function withMobileBundle(config: ExpoConfig): ExpoConfig;
+export { MOBILE_HOSTS };
 export default withMobileBundle;
 //# sourceMappingURL=withMobileBundle.d.ts.map

package/dist/expo/plugins/withMobileBundle.js

@@ -1,14 +1,13 @@
 import configPlugins from "@expo/config-plugins";
-import { execSync } from "child_process";
 import * as fs from "fs";
 import * as path from "path";
+import { bundleSdk, verifyBundle, hasErrors, formatVerifyBundleResult } from "../../commands/index.js";
+import { CONFIG_CANDIDATES } from "../../client/config-loader/resolve-config.node.js";
 import { resolveSDKPackageDir } from "./resolve-sdk-package-dir.js";
+import { getProjectRootFromMod } from "./get-project-root.js";
+import { findInAncestorNodeModules } from "./find-in-ancestor-node-modules.js";
+import { BundleVerificationFailedError } from "../../utils/errors-client.js";
 const { withDangerousMod } = configPlugins;
-const CONFIG_CANDIDATES = [
-    "qvac.config.json",
-    "qvac.config.js",
-    "qvac.config.mjs",
-];
 /** Modules to defer from mobile bundles (not available at bundle time) */
 const DEFERRED_MODULES = ["expo-file-system", "react-native-bare-kit"];
 const MOBILE_HOSTS = [
@@ -18,19 +17,16 @@ const MOBILE_HOSTS = [
     "ios-x64-simulator",
 ];
 /**
- * Expo plugin that automatically generates the mobile worker bundle during build.
+ * Expo plugin: bundle, verify, then copy the mobile worker bundle.
  *
- * Runs qvac CLI (prefers local @qvac/cli, falls back to npx).
- * Uses qvac.config.* if exists, else includes all built-in plugins.
- * Output: node_modules/<sdk-package>/dist/worker.mobile.bundle.js
+ * Flow: bundleSdk -> verifyBundle -> copy to `<sdkPackageDir>/dist/worker.mobile.bundle.js`.
+ * Uses `qvac.config.*` if present.
  */
 function withMobileBundle(config) {
-    function buildMobileBundle(config) {
-        const projectRoot = config.modRequest.projectRoot;
+    async function buildMobileBundle(config) {
+        const projectRoot = getProjectRootFromMod(config);
         const sdkPackage = resolveSDKPackageDir(projectRoot);
         const outputPath = path.join(sdkPackage.dir, "dist", "worker.mobile.bundle.js");
-        // Generate bundle via qvac CLI
-        // (uses qvac.config.* if exists, else includes all built-in plugins)
         const configPath = findConfigFile(projectRoot);
         if (configPath) {
             console.log(`🕚 QVAC: Found ${path.basename(configPath)}, generating tree-shaken bundle...`);
@@ -42,15 +38,11 @@ function withMobileBundle(config) {
             ...DEFERRED_MODULES,
             `${sdkPackage.name}/worker.mobile.bundle`,
         ];
-        runBundler(projectRoot, sdkPackage.dir, configPath, deferredModules);
-        // Copy the generated bundle to SDK location
+        await runBundler(projectRoot, sdkPackage.dir, configPath, deferredModules);
         const generatedBundle = path.join(projectRoot, "qvac", "worker.bundle.js");
-        if (!fs.existsSync(generatedBundle)) {
-            throw new Error(`QVAC: Bundle generation failed — ${generatedBundle} not found. ` +
-                `Check qvac CLI output above for errors.`);
-        }
+        await runVerifier(projectRoot, generatedBundle, configPath);
         fs.copyFileSync(generatedBundle, outputPath);
-        console.log("🫡 QVAC: Mobile bundle generated");
+        console.log("🫡 QVAC: Mobile bundle generated and verified");
         return config;
     }
     config = withDangerousMod(config, ["android", buildMobileBundle]);
@@ -67,49 +59,42 @@ function findConfigFile(projectRoot) {
     }
     return null;
 }
-/**
- * Resolves the qvac CLI command.
- *
- * Prefers local @qvac/cli installation for version consistency,
- * falls back to npx for convenience when CLI is not installed.
- */
-function resolveCliCommand(projectRoot) {
-    const cliPath = path.join(projectRoot, "node_modules", "@qvac", "cli", "dist", "index.js");
-    if (fs.existsSync(cliPath)) {
-        return `node "${cliPath}"`;
+async function runVerifier(projectRoot, generatedBundle, configPath) {
+    if (!configPath) {
+        console.log("⚠️ QVAC: no qvac.config.* found — Bare runtime will be auto-detected " +
+            "from node_modules (bare-runtime, then bare). Add qvac.config.json " +
+            "with `bareRuntimeVersion` to pin ABI checks deterministically.");
+    }
+    const result = await verifyBundle({
+        projectRoot,
+        addonsSource: generatedBundle,
+        hosts: MOBILE_HOSTS,
+        ...(configPath ? { configPath } : {}),
+    });
+    if (hasErrors(result)) {
+        throw new BundleVerificationFailedError(generatedBundle, new Error(formatVerifyBundleResult(result)));
     }
-    console.log("⚠️ QVAC: @qvac/cli not found in node_modules, falling back to npx");
-    console.log("   Tip: Add @qvac/cli as a dependency for consistent versioning");
-    return "npx --package=@qvac/cli qvac";
 }
-/** Runs qvac CLI with mobile-specific options */
-function runBundler(projectRoot, qvacSdkPath, configPath, deferredModules) {
-    // Patch bare-kit linkers to use addons manifest
+async function runBundler(projectRoot, qvacSdkPath, configPath, deferredModules) {
     patchBareKitLinkers(projectRoot, qvacSdkPath);
-    const hostFlags = MOBILE_HOSTS.map((h) => `--host ${h}`).join(" ");
-    const deferFlags = deferredModules.map((m) => `--defer "${m}"`).join(" ");
-    const configFlag = configPath ? `--config "${configPath}"` : "";
-    const sdkPathFlag = `--sdk-path "${qvacSdkPath}"`;
-    const cliCommand = resolveCliCommand(projectRoot);
-    try {
-        execSync(`${cliCommand} bundle sdk ${sdkPathFlag} ${configFlag} ${hostFlags} ${deferFlags} --quiet`, { stdio: "inherit", cwd: projectRoot });
-    }
-    catch (error) {
-        console.error("❌ QVAC: Failed to generate bundle:", error);
-        throw error;
-    }
+    await bundleSdk({
+        projectRoot,
+        sdkPath: qvacSdkPath,
+        ...(configPath ? { configPath } : {}),
+        hosts: MOBILE_HOSTS,
+        defer: deferredModules,
+        quiet: true,
+    });
 }
 /**
  * Patches react-native-bare-kit linkers to use the addons manifest.
- *
- * Copies the manifest-aware link.mjs files over the originals so that
- * bare-link only links the native addons actually required by the bundle.
- * This reduces app size by excluding unused native addon binaries.
  */
 function patchBareKitLinkers(projectRoot, qvacSdkPath) {
-    const bareKitPath = path.join(projectRoot, "node_modules", "react-native-bare-kit");
-    if (!fs.existsSync(bareKitPath)) {
-        console.log("⚠️ QVAC: react-native-bare-kit not found, skipping linker patch");
+    const bareKitPath = findInAncestorNodeModules(projectRoot, "react-native-bare-kit");
+    if (bareKitPath === null) {
+        console.warn("⚠️ QVAC: react-native-bare-kit not found in any ancestor node_modules, " +
+            "skipping linker patch. The bundle will link all native addons " +
+            "rather than only those required by your bundle.");
         return;
     }
     const patchesDir = path.join(qvacSdkPath, "expo", "plugins", "patches");
@@ -117,7 +102,6 @@ function patchBareKitLinkers(projectRoot, qvacSdkPath) {
         console.log(`⚠️ QVAC: patches directory not found (${patchesDir}), skipping linker patch`);
         return;
     }
-    // Patch Android linker
     const androidPatch = path.join(patchesDir, "android-link.mjs");
     const androidTarget = path.join(bareKitPath, "android", "link.mjs");
     if (fs.existsSync(androidPatch)) {
@@ -127,7 +111,6 @@ function patchBareKitLinkers(projectRoot, qvacSdkPath) {
     else {
         console.log(`⚠️ QVAC: Android linker patch not found (${androidPatch})`);
     }
-    // Patch iOS linker
     const iosPatch = path.join(patchesDir, "ios-link.mjs");
     const iosTarget = path.join(bareKitPath, "ios", "link.mjs");
     if (fs.existsSync(iosPatch)) {
@@ -138,4 +121,5 @@ function patchBareKitLinkers(projectRoot, qvacSdkPath) {
         console.log(`⚠️ QVAC: iOS linker patch not found (${iosPatch})`);
     }
 }
+export { MOBILE_HOSTS };
 export default withMobileBundle;

package/dist/index.d.ts

@@ -1,11 +1,15 @@
 import "#polyfill-bare-globals";
-export { completion, deleteCache, loadModel, downloadAsset, heartbeat, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, finetune, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, textToSpeechStream, getModelInfo, getLoadedModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, diffusion, type DiffusionProgressTick, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams, suspend, resume, state, type FinetuneHandle, } from "./client/api/index";
+export { completion, deleteCache, loadModel, downloadAsset, heartbeat, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, finetune, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, textToSpeechStream, getModelInfo, getLoadedModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, diffusion, type DiffusionProgressTick, classify, video, type VideoProgressTick, upscale, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams, suspend, resume, state, vla, vlaHparams, vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE, type FinetuneHandle, } from "./client/api/index";
 export { close } from "./client/index";
-export { type LifecycleState, type ModelProgressUpdate, type LoadModelOptions, type LoadCustomPluginModelOptions, type DownloadAssetOptions, type Tool, type ToolCall, type ToolCallWithCall, type ToolCallError, type ToolCallEvent, type CompletionEvent, type CompletionFinal, type CompletionRun, type CompletionStats, type EmbedStats, VERBOSITY, type Attachment, type TranscribeStreamSession, type TranscribeStreamMetadataSession, type TranscribeSegment, type TextToSpeechStreamSession, type TextToSpeechStreamResponse, type TextToSpeechStreamClientParams, type CompletionParams, type ToolDialect, type RagSearchResult, type RagSaveEmbeddingsResult, type RagReindexResult, type RagEmbeddedDoc, type RagDoc, type RagWorkspaceInfo, type RagCloseWorkspaceParams, type RagDeleteWorkspaceParams, type RagIngestStage, type RagReindexStage, type RagSaveStage, SDK_CLIENT_ERROR_CODES, SDK_SERVER_ERROR_CODES, type QvacConfig, type ModelInfo, type GetModelInfoParams, type GetLoadedModelInfoParams, type LoadedModelInfo, type LoadedInstance, type CacheFileInfo, toolSchema, TOOLS_MODE, type ToolsMode, type McpClient, type McpClientInput, type OCRClientParams, type OCRTextBlock, type OCROptions, type DiffusionClientParams, type DiffusionStreamResponse, type DiffusionStats, definePlugin, defineHandler, defineDuplexHandler, type QvacPlugin, type CreateModelParams, type PluginModelResult, type ModelRegistryEntry, type ModelRegistryEntryAddon, PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, PLUGIN_DIFFUSION, SDK_DEFAULT_PLUGINS, type BuiltinPlugin, type ProfilerMode, type FinetuneValidation, type FinetuneRunParams, type FinetuneGetStateParams, type FinetuneStopParams, type FinetuneParams, type FinetuneStatus, type FinetuneProgress, type FinetuneStats, type FinetuneResult, } from "./schemas/index";
+export { plugins } from "./client/plugins-factory";
+export { type LifecycleState, type ModelProgressUpdate, type LoadModelOptions, type LoadCustomPluginModelOptions, type DownloadAssetOptions, type Tool, type ToolCall, type ToolCallWithCall, type ToolCallError, type ToolCallEvent, type CompletionEvent, type CompletionFinal, type CompletionRun, type CompletionStats, type EmbedStats, VERBOSITY, type Attachment, type TranscribeStreamSession, type TranscribeStreamMetadataSession, type TranscribeStreamConversationSession, type TranscribeStreamEvent, type VadStateEvent, type EndOfTurnEvent, type TranscribeSegment, type TextToSpeechStreamSession, type TextToSpeechStreamResponse, type TextToSpeechStreamClientParams, type CompletionParams, type ToolDialect, type RagSearchResult, type RagSaveEmbeddingsResult, type RagReindexResult, type RagEmbeddedDoc, type RagDoc, type RagWorkspaceInfo, type RagCloseWorkspaceParams, type RagDeleteWorkspaceParams, type RagIngestStage, type RagReindexStage, type RagSaveStage, SDK_CLIENT_ERROR_CODES, SDK_SERVER_ERROR_CODES, RAG_ERROR_CODES, type QvacConfig, type ModelInfo, type GetModelInfoParams, type GetLoadedModelInfoParams, type LoadedModelInfo, type LoadedInstance, type CacheFileInfo, toolSchema, TOOLS_MODE, type ToolsMode, type McpClient, type McpClientInput, type OCRClientParams, type OCRTextBlock, type OCROptions, type ClassifyClientParams, type ClassificationResult, type DiffusionClientParams, type DiffusionStreamResponse, type DiffusionStats, type VideoClientParams, type VideoStreamResponse, type VideoStats, type UpscaleClientParams, type UpscaleStreamResponse, type UpscaleStats, type VlaConfig, type VlaClientRunParams, type VlaClientRunResult, type VlaHparams, type VlaStats, definePlugin, defineHandler, defineDuplexHandler, type QvacPlugin, type CreateModelParams, type PluginModelResult, type ModelRegistryEntry, type ModelRegistryEntryAddon, PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, PLUGIN_DIFFUSION, PLUGIN_VLA, PLUGIN_CLASSIFICATION, SDK_DEFAULT_PLUGINS, type BuiltinPlugin, type ProfilerMode, type FinetuneValidation, type FinetuneRunParams, type FinetuneGetStateParams, type FinetuneStopParams, type FinetuneParams, type FinetuneStatus, type FinetuneProgress, type FinetuneStats, type FinetuneResult, } from "./schemas/index";
 export { type ToolInput, type ToolHandler } from "./utils/tool-helpers";
 export { MODEL_TYPES, ModelType } from "./schemas/index";
 export * from "./models/registry/index";
 export { SUPPORTED_AUDIO_FORMATS } from "./constants/audio";
+export { InferenceCancelledError } from "./utils/errors-server";
+export type { InferenceCancelledPartial } from "./utils/errors-server";
+export { ContextOverflowError, RequestIdConflictError, RequestNotFoundError, RequestRejectedByPolicyError, } from "./utils/errors-server";
 export { getLogger, SDK_LOG_ID } from "./logging/index";
 export type { Logger, LogTransport, LoggerOptions } from "./logging/index";
 export { profiler } from "./profiling/index";

package/dist/index.js

@@ -1,14 +1,35 @@
 import "#polyfill-bare-globals";
 // Public API exports only
-export { completion, deleteCache, loadModel, downloadAsset, heartbeat, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, finetune, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, textToSpeechStream, getModelInfo, getLoadedModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, diffusion, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, suspend, resume, state, } from "./client/api/index.js";
+export { completion, deleteCache, loadModel, downloadAsset, heartbeat, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, finetune, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, textToSpeechStream, getModelInfo, getLoadedModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, diffusion, classify, video, upscale, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, suspend, resume, state, vla, vlaHparams, vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE, } from "./client/api/index.js";
 export { close } from "./client/index.js";
-export { VERBOSITY, SDK_CLIENT_ERROR_CODES, SDK_SERVER_ERROR_CODES, toolSchema, TOOLS_MODE, definePlugin, defineHandler, defineDuplexHandler, PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, PLUGIN_DIFFUSION, SDK_DEFAULT_PLUGINS, } from "./schemas/index.js";
+export { plugins } from "./client/plugins-factory.js";
+export { VERBOSITY, SDK_CLIENT_ERROR_CODES, SDK_SERVER_ERROR_CODES, RAG_ERROR_CODES, toolSchema, TOOLS_MODE, definePlugin, defineHandler, defineDuplexHandler, PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, PLUGIN_DIFFUSION, PLUGIN_VLA, PLUGIN_CLASSIFICATION, SDK_DEFAULT_PLUGINS, } from "./schemas/index.js";
 export {} from "./utils/tool-helpers.js";
 // Model types - canonical naming with backward-compatible aliases
 export { MODEL_TYPES, ModelType } from "./schemas/index.js";
 // Model registry constants
 export * from "./models/registry/index.js";
 export { SUPPORTED_AUDIO_FORMATS } from "./constants/audio.js";
+// Error classes that clients need for `instanceof` checks on rejected
+// promises. `InferenceCancelledError` rides the standard `QvacError`
+// envelope, but consumers reach for it through `instanceof` on
+// `await run.final` / `run.text` / `run.toolCalls` / `run.stats`
+// rejections. `RequestRejectedByPolicyError` is thrown by
+// `RequestRegistry.begin(...)` when a registered concurrency policy
+// (e.g. `oneAtATimePerModel` on `completion`) rejects a new request;
+// it propagates out through the worker so the client can distinguish
+// "the request collided with another one" from "the request failed".
+//
+// `RequestIdConflictError` and `RequestNotFoundError` are thrown by
+// `RequestRegistry.begin(...)` / `.end(...)` on UUID collisions and
+// missing-target cancels. They're surfaced here so consumers using
+// the decorated-promise `requestId` can pattern-match on rejected
+// cancel paths. All three classes round-trip the RPC boundary via
+// the typed-error reconstructor in `client/rpc/rpc-error.ts` so
+// `err instanceof <Class>` works on the consumer side, not just on
+// the worker side.
+export { InferenceCancelledError } from "./utils/errors-server.js";
+export { ContextOverflowError, RequestIdConflictError, RequestNotFoundError, RequestRejectedByPolicyError, } from "./utils/errors-server.js";
 // Logging exports
 export { getLogger, SDK_LOG_ID } from "./logging/index.js";
 // Profiler exports