@qvac/sdk 0.6.1 → 0.7.0

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

@@ -1,7 +1,10 @@
 import type { ExpoConfig } from "expo/config";
 /**
- * Expo plugin that automatically generates the mobile worker bundle during build
- * using the user's installed bare library versions.
+ * Expo plugin that automatically generates the mobile worker bundle during build.
+ *
+ * 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
  */
 declare function withMobileBundle(config: ExpoConfig): ExpoConfig;
 export default withMobileBundle;

package/dist/expo/plugins/withMobileBundle.js

@@ -2,84 +2,140 @@ import configPlugins from "@expo/config-plugins";
 import { execSync } from "child_process";
 import * as fs from "fs";
 import * as path from "path";
-import { SDKNotFoundInNodeModulesError, WorkerFileNotFoundError, } from "../../utils/errors-client.js";
+import { resolveSDKPackageDir } from "./resolve-sdk-package-dir.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 = [
+    "android-arm64",
+    "ios-arm64",
+    "ios-arm64-simulator",
+    "ios-x64-simulator",
+];
 /**
- * Expo plugin that automatically generates the mobile worker bundle during build
- * using the user's installed bare library versions.
+ * Expo plugin that automatically generates the mobile worker bundle during build.
+ *
+ * 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
  */
 function withMobileBundle(config) {
     function buildMobileBundle(config) {
-        console.log("🕚 QVAC: Generating mobile worker bundle with current dependencies...");
         const projectRoot = config.modRequest.projectRoot;
-        const qvacSdkPath = path.join(projectRoot, "node_modules", "@qvac/sdk");
-        // Ensure package exists
-        if (!fs.existsSync(qvacSdkPath)) {
-            throw new SDKNotFoundInNodeModulesError();
+        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...`);
         }
-        const workerPath = path.join(qvacSdkPath, "dist", "server", "worker.js");
-        const outputPath = path.join(qvacSdkPath, "dist/worker.mobile.bundle.js");
-        // Check if worker.js exists
-        if (!fs.existsSync(workerPath)) {
-            throw new WorkerFileNotFoundError(workerPath);
+        else {
+            console.log("🕚 QVAC: No config found, generating default bundle (all plugins)...");
         }
-        try {
-            // Truncate incompatible RPC clients for mobile
-            // Keep: rpc-client.js, expo-rpc-client.js, bare-client.js (needed for worker bundle)
-            const rpcClientsToTruncate = ["node-rpc-client.js"];
-            const truncatedContent = "// This RPC client is not available in mobile environments";
-            for (const clientFile of rpcClientsToTruncate) {
-                const clientPath = path.join(qvacSdkPath, "dist", "client", "rpc", clientFile);
-                if (fs.existsSync(clientPath)) {
-                    fs.writeFileSync(clientPath, truncatedContent);
-                    console.log(`🔧 QVAC: Truncated ${clientFile} for mobile compatibility`);
-                }
-            }
-            // Copy bare imports configuration for bare-pack
-            const bareImportsSource = path.join(qvacSdkPath, "bare-imports.json");
-            const importsMapPath = path.join(qvacSdkPath, "dist", "imports.json");
-            if (fs.existsSync(bareImportsSource)) {
-                fs.copyFileSync(bareImportsSource, importsMapPath);
-                console.log("🔧 QVAC: Copied bare-imports.json for mobile bundle");
-            }
-            // Remove optional modules from the bundle
-            const optionalModules = [
-                "expo-file-system",
-                "react-native-bare-kit",
-                "@qvac/sdk/worker.mobile.bundle",
-            ];
-            const deferFlags = optionalModules
-                .map((mod) => `--defer "${mod}"`)
-                .join(" ");
-            // Detect bare-pack version (v1.x uses --target, v2.x uses --host)
-            let platformFlag = "--host";
-            try {
-                const versionOutput = execSync(`npx bare-pack --version "${workerPath}"`, { cwd: projectRoot, encoding: "utf-8" }).trim();
-                const versionMatch = versionOutput.match(/v?(\d+)\./);
-                const majorVersion = versionMatch && versionMatch[1] ? parseInt(versionMatch[1], 10) : 2;
-                if (majorVersion < 2) {
-                    platformFlag = "--target";
-                }
-            }
-            catch (error) {
-                throw new Error(`Failed to detect bare-pack version. Ensure bare-pack is installed: npm install bare-pack`, { cause: error });
-            }
-            const platforms = ["android-arm64", "ios-arm64", "ios-arm64-simulator"];
-            const platformFlags = platforms
-                .map((p) => `${platformFlag} ${p}`)
-                .join(" ");
-            // Generate the bundle using bare-pack with the current project's dependencies
-            execSync(`cd "${projectRoot}" && npx bare-pack ${platformFlags} --linked --imports "${importsMapPath}" ${deferFlags} --out "${outputPath}" "${workerPath}"`, { stdio: "inherit", cwd: projectRoot });
-            console.log("🫡 QVAC: Mobile worker bundle generated successfully");
-        }
-        catch (error) {
-            console.error("❌ QVAC: Failed to generate mobile worker bundle:", error);
-            throw error;
+        const deferredModules = [
+            ...DEFERRED_MODULES,
+            `${sdkPackage.name}/worker.mobile.bundle`,
+        ];
+        runBundler(projectRoot, sdkPackage.dir, configPath, deferredModules);
+        // Copy the generated bundle to SDK location
+        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.`);
         }
+        fs.copyFileSync(generatedBundle, outputPath);
+        console.log("🫡 QVAC: Mobile bundle generated");
         return config;
     }
     config = withDangerousMod(config, ["android", buildMobileBundle]);
     config = withDangerousMod(config, ["ios", buildMobileBundle]);
     return config;
 }
+/** Finds qvac.config.* file in project root */
+function findConfigFile(projectRoot) {
+    for (const candidate of CONFIG_CANDIDATES) {
+        const configPath = path.join(projectRoot, candidate);
+        if (fs.existsSync(configPath)) {
+            return configPath;
+        }
+    }
+    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", "src", "index.js");
+    if (fs.existsSync(cliPath)) {
+        return `node "${cliPath}"`;
+    }
+    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
+    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;
+    }
+}
+/**
+ * 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");
+        return;
+    }
+    const patchesDir = path.join(qvacSdkPath, "expo", "plugins", "patches");
+    if (!fs.existsSync(patchesDir)) {
+        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)) {
+        fs.copyFileSync(androidPatch, androidTarget);
+        console.log("✅ QVAC: Patched android/link.mjs for manifest-aware linking");
+    }
+    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)) {
+        fs.copyFileSync(iosPatch, iosTarget);
+        console.log("✅ QVAC: Patched ios/link.mjs for manifest-aware linking");
+    }
+    else {
+        console.log(`⚠️ QVAC: iOS linker patch not found (${iosPatch})`);
+    }
+}
 export default withMobileBundle;

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

@@ -2,6 +2,10 @@ import type { ExpoConfig } from "expo/config";
 /**
  * Main Qvac SDK Expo plugin that combines all necessary mobile configurations:
  * - Mobile worker bundle generation
+ * - Device info stubbing when expo-device is not installed
+ * - Android build properties (minSdkVersion, NDK, proguard)
+ * - Android NDK version pinning in build.gradle
+ * - Android architecture filtering (arm64-v8a only)
  * - OpenCL native library support for Android
  */
 declare function withQvacSDK(config: ExpoConfig): ExpoConfig;

package/dist/expo/plugins/withQvacSDK.js

@@ -1,13 +1,38 @@
 import configPlugins from "@expo/config-plugins";
+import withAndroidArchitecture from "./withAndroidArchitecture.js";
+import withAndroidNdkVersion from "./withAndroidNdkVersion.js";
+import withDeviceInfo from "./withDeviceInfo.js";
 import withMobileBundle from "./withMobileBundle.js";
 import withOpenCL from "./withOpenCL.js";
 const { withPlugins } = configPlugins;
 /**
  * Main Qvac SDK Expo plugin that combines all necessary mobile configurations:
  * - Mobile worker bundle generation
+ * - Device info stubbing when expo-device is not installed
+ * - Android build properties (minSdkVersion, NDK, proguard)
+ * - Android NDK version pinning in build.gradle
+ * - Android architecture filtering (arm64-v8a only)
  * - OpenCL native library support for Android
  */
 function withQvacSDK(config) {
-    return withPlugins(config, [withMobileBundle, withOpenCL]);
+    return withPlugins(config, [
+        withMobileBundle,
+        withDeviceInfo,
+        [
+            "expo-build-properties",
+            {
+                android: {
+                    minSdkVersion: 29,
+                    ndkVersion: "29.0.14206865",
+                    enableProguardInReleaseBuilds: true,
+                    enableShrinkResourcesInReleaseBuilds: true,
+                    enableMinifyInReleaseBuilds: true,
+                },
+            },
+        ],
+        withAndroidNdkVersion,
+        withAndroidArchitecture,
+        withOpenCL,
+    ]);
 }
 export default withQvacSDK;

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, getModelInfo, loggingStream, ocr, } from "./client/api/index";
+export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, getModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams, } from "./client/api/index";
 export { close } from "./client/index";
-export { type ModelProgressUpdate, type LoadModelOptions, type DownloadAssetOptions, type Tool, type ToolCall, type ToolCallWithCall, type ToolCallError, type ToolCallEvent, type CompletionStats, VERBOSITY, type Attachment, type CompletionParams, 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 LoadedInstance, type CacheFileInfo, toolSchema, type McpClient, type McpClientInput, type OCRClientParams, type OCRTextBlock, type OCROptions, } from "./schemas/index";
+export { type ModelProgressUpdate, type LoadModelOptions, type DownloadAssetOptions, type Tool, type ToolCall, type ToolCallWithCall, type ToolCallError, type ToolCallEvent, type CompletionStats, VERBOSITY, type Attachment, type CompletionParams, 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 LoadedInstance, type CacheFileInfo, toolSchema, type McpClient, type McpClientInput, type OCRClientParams, type OCRTextBlock, type OCROptions, definePlugin, defineHandler, type QvacPlugin, type CreateModelParams, type PluginModelResult, type ModelRegistryEntry, type ModelRegistryEntryAddon, PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, SDK_DEFAULT_PLUGINS, type BuiltinPlugin, } from "./schemas/index";
 export { type ToolInput, type ToolHandler } from "./utils/tool-helpers";
-export { PUBLIC_MODEL_TYPES as MODEL_TYPES } from "./schemas/index";
-export * from "./models/hyperdrive/index";
+export { MODEL_TYPES, ModelType } from "./schemas/index";
+export * from "./models/registry/index";
 export { SUPPORTED_AUDIO_FORMATS } from "./constants/audio";
 export { getLogger, SDK_LOG_ID } from "./logging/index";
 export type { Logger, LogTransport, LoggerOptions } from "./logging/index";

package/dist/index.js

@@ -1,12 +1,12 @@
 // Public API exports only
-export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, getModelInfo, loggingStream, ocr, } from "./client/api/index.js";
+export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, getModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, } from "./client/api/index.js";
 export { close } from "./client/index.js";
-export { VERBOSITY, SDK_CLIENT_ERROR_CODES, SDK_SERVER_ERROR_CODES, toolSchema, } from "./schemas/index.js";
+export { VERBOSITY, SDK_CLIENT_ERROR_CODES, SDK_SERVER_ERROR_CODES, toolSchema, definePlugin, defineHandler, PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, SDK_DEFAULT_PLUGINS, } from "./schemas/index.js";
 export {} from "./utils/tool-helpers.js";
 // Model types - canonical naming with backward-compatible aliases
-export { PUBLIC_MODEL_TYPES as MODEL_TYPES } from "./schemas/index.js";
-// Hyperdrive model constants
-export * from "./models/hyperdrive/index.js";
+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";
 // Logging exports
 export { getLogger, SDK_LOG_ID } from "./logging/index.js";

package/dist/models/{hyperdrive → registry}/index.js

@@ -1,2 +1,2 @@
-// Simplified re-exports
+// Re-export all models
 export * from "./models.js";