@qvac/sdk 0.20.1 → 0.21.0

package/dist/src/commands/verify/prebuilds.js

@@ -2,6 +2,11 @@ import { promises as fsp } from 'node:fs';
 import path from 'node:path';
 import { formatAddonId } from './addon-source.js';
 import { HOST_ADDON_IMPORT, resolveAddonPlatformPackage } from '../../expo/plugins/patches/qvac-platform-addons.js';
+/** Platforms no install host reports, so their platform packages must be declared. */
+const MOBILE_PLATFORMS = new Set(['android', 'ios']);
+export function isMobileHost(host) {
+    return MOBILE_PLATFORMS.has(host.split('-')[0] ?? '');
+}
 const PREBUILDS_DIR = 'prebuilds';
 const PLATFORM_ADDON_DIR = 'addon';
 /**
@@ -26,10 +31,17 @@ export async function resolvePrebuildLocations(addon, host) {
         return locations;
     const platformRoot = await findInstalledPackage(await realPackageRoot(addon.packageRoot), platformPackage);
     if (platformRoot !== null) {
-        locations.push({
+        const location = {
             hostDir: path.join(platformRoot, PLATFORM_ADDON_DIR, PREBUILDS_DIR, host),
             platformPackage
-        });
+        };
+        const installedVersion = await readPackageVersion(platformRoot);
+        if (addon.version !== undefined &&
+            installedVersion !== undefined &&
+            installedVersion !== addon.version) {
+            location.mismatchedVersion = installedVersion;
+        }
+        locations.push(location);
     }
     return locations;
 }
@@ -60,42 +72,69 @@ export async function checkPrebuilds(options) {
         const locations = await resolvePrebuildLocations(addon, host);
         if (await anyLocationHasPrebuild(locations))
             continue;
-        issues.push({
+        const platformPackage = await platformPackageForHost(addon, host);
+        const platformLocation = locations.find((location) => location.platformPackage !== undefined);
+        const issue = {
             code: 'missing-prebuild',
             level: 'error',
             addon: formatAddonId(addon),
             host,
             packageRoot: addon.packageRoot,
-            message: await describeMissingPrebuild(addon, host, locations)
-        });
+            message: describeMissingPrebuild(addon, host, locations, platformPackage, platformLocation)
+        };
+        const needsPin = isMobileHost(host) &&
+            (platformLocation === undefined || platformLocation.mismatchedVersion !== undefined);
+        if (platformPackage !== null && addon.version !== undefined && needsPin) {
+            issue.platformPackage = { name: platformPackage, version: addon.version };
+        }
+        issues.push(issue);
     }
     return issues;
 }
 async function anyLocationHasPrebuild(locations) {
     for (const location of locations) {
+        if (location.mismatchedVersion !== undefined)
+            continue;
         if ((await listBarePrebuildFiles(location.hostDir)).length > 0)
             return true;
     }
     return false;
 }
-async function describeMissingPrebuild(addon, host, locations) {
+function describeMissingPrebuild(addon, host, locations, platformPackage, platformLocation) {
     const expected = locations.map((location) => path.join(location.hostDir, '*.bare'));
-    const platformPackage = await platformPackageForHost(addon, host);
-    const searchedPlatformPackage = locations.some((location) => location.platformPackage === platformPackage);
     return (`${formatAddonId(addon)} is missing a prebuild for ${host} ` +
         `(expected ${expected.join(' or ')}).` +
-        missingPlatformPackageHint(addon, platformPackage, searchedPlatformPackage));
+        missingPlatformPackageHint(addon, platformPackage, platformLocation));
 }
-function missingPlatformPackageHint(addon, platformPackage, searchedPlatformPackage) {
-    if (platformPackage === null || searchedPlatformPackage)
+function missingPlatformPackageHint(addon, platformPackage, platformLocation) {
+    if (platformPackage === null)
         return '';
     const pin = addon.version === undefined ? platformPackage : `"${platformPackage}": "${addon.version}"`;
-    return (` Add this exact dependency to package.json (same version as ${addon.name})` +
-        ` and reinstall: ${pin}`);
+    if (platformLocation === undefined) {
+        return (` Add this exact dependency to package.json (same version as ${addon.name})` +
+            ` and reinstall: ${pin}`);
+    }
+    if (platformLocation.mismatchedVersion !== undefined) {
+        return (` ${platformPackage} ${platformLocation.mismatchedVersion} is installed, but it must be` +
+            ` the same version as ${addon.name}. Pin it in package.json and reinstall: ${pin}`);
+    }
+    return '';
 }
 async function platformPackageForHost(addon, host) {
     return resolveAddonPlatformPackage(addon.name, await readHostAddonMap(addon), host);
 }
+async function readPackageVersion(packageRoot) {
+    try {
+        const parsed = JSON.parse(await fsp.readFile(path.join(packageRoot, 'package.json'), 'utf8'));
+        if (typeof parsed !== 'object' || parsed === null)
+            return undefined;
+        const version = parsed.version;
+        return typeof version === 'string' ? version : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 async function readHostAddonMap(addon) {
     try {
         const raw = await fsp.readFile(path.join(addon.packageRoot, 'package.json'), 'utf8');

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

@@ -4,6 +4,8 @@ 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';
+export type { QvacSDKPluginOptions } from './withQvacSDK.js';
+export type { MobileBundleOptions } from './withMobileBundle.js';
 export { getProjectRootFromMod, getProjectRootFromBaseConfig } from './get-project-root.js';
 export { resolveSDKPackageDir, SDK_PACKAGE_NAMES } from './resolve-sdk-package-dir.js';
 export type { SDKPackageInfo } from './resolve-sdk-package-dir.js';

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

@@ -1,8 +1,9 @@
+import configPlugins from '@expo/config-plugins';
 import type { ExpoConfig } from 'expo/config';
 /**
  * Desktop-only spawn path, deferred so bare-pack does not walk `bare-process`
- * -> `bare-posix` (no `android-arm64` prebuild). Mobile advisory uses
- * in-process `@qvac/model-fit` (`fitParams`), not this subprocess.
+ * -> `bare-posix` (no `android-arm64` prebuild). Mobile runs the engine fitter
+ * in process instead, so it never reaches this.
  */
 declare const MOBILE_UNSUPPORTED_MODULES: string[];
 type MobilePlatform = 'android' | 'ios';
@@ -13,13 +14,22 @@ type BareKitLinkerPaths = {
     android: string | null;
     ios: string | null;
 };
+type MobileBundleOptions = {
+    /**
+     * Install the addon platform packages the bundle needs for the current
+     * build target with the app's package manager, pinned in package.json.
+     * Off by default: `expo prebuild` then fails and names each package to add.
+     */
+    installMissingPrebuilds?: boolean;
+};
 /**
  * Expo plugin: bundle, verify, then copy the mobile worker bundle.
  *
  * Flow: bundleSdk -> verifyBundle -> copy to `<sdkPackageDir>/dist/worker.mobile.bundle.js`.
  * Uses `qvac.config.*` if present.
  */
-declare function withMobileBundle(config: ExpoConfig): ExpoConfig;
+declare function withMobileBundle(config: ExpoConfig, options?: MobileBundleOptions): ExpoConfig;
+declare function buildMobileBundle<T extends configPlugins.ExportedConfigWithProps<unknown>>(config: T, options: MobileBundleOptions): Promise<T>;
 declare function mobileHostsForPlatform(platform: string): string[];
 /** Runs the patched iOS linker after bundleSdk has written the current addons manifest. */
 declare function runIOSAddonLinker(linkerPath: string): Promise<void>;
@@ -28,7 +38,7 @@ declare function runIOSAddonLinker(linkerPath: string): Promise<void>;
  * the paths for each platform that was successfully patched.
  */
 declare function patchBareKitLinkers(projectRoot: string, qvacSdkPath: string): BareKitLinkerPaths;
-export { MOBILE_HOSTS, MOBILE_HOSTS_BY_PLATFORM, MOBILE_UNSUPPORTED_MODULES, mobileHostsForPlatform, patchBareKitLinkers, runIOSAddonLinker };
-export type { BareKitLinkerPaths, MobilePlatform };
+export { MOBILE_HOSTS, MOBILE_HOSTS_BY_PLATFORM, MOBILE_UNSUPPORTED_MODULES, buildMobileBundle, mobileHostsForPlatform, patchBareKitLinkers, runIOSAddonLinker };
+export type { BareKitLinkerPaths, MobileBundleOptions, MobilePlatform };
 export default withMobileBundle;
 //# sourceMappingURL=withMobileBundle.d.ts.map

package/dist/src/expo/plugins/withMobileBundle.js

@@ -4,6 +4,9 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { execPath } from 'process';
 import { bundleSdk, verifyBundle, hasErrors, formatVerifyBundleResult } from '../../commands/index.js';
+import { createCommandLogger } from '../../commands/command-logger.js';
+import { installMissingHostPrebuilds } from '../../commands/host-prebuilds/index.js';
+import { collectAddonsFromBundle } from '../../commands/verify/bundle-source.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';
@@ -14,10 +17,10 @@ const { withDangerousMod } = configPlugins;
 const DEFERRED_MODULES = ['expo-file-system', 'react-native-bare-kit'];
 /**
  * Desktop-only spawn path, deferred so bare-pack does not walk `bare-process`
- * -> `bare-posix` (no `android-arm64` prebuild). Mobile advisory uses
- * in-process `@qvac/model-fit` (`fitParams`), not this subprocess.
+ * -> `bare-posix` (no `android-arm64` prebuild). Mobile runs the engine fitter
+ * in process instead, so it never reaches this.
  */
-const MOBILE_UNSUPPORTED_MODULES = ['bare-runtime/spawn', '@qvac/model-fit/process'];
+const MOBILE_UNSUPPORTED_MODULES = ['bare-runtime/spawn'];
 const MOBILE_HOSTS_BY_PLATFORM = {
     android: ['android-arm64'],
     ios: ['ios-arm64', 'ios-arm64-simulator', 'ios-x64-simulator']
@@ -32,39 +35,64 @@ const MOBILE_HOSTS = [...MOBILE_HOSTS_BY_PLATFORM.android, ...MOBILE_HOSTS_BY_PL
  * Flow: bundleSdk -> verifyBundle -> copy to `<sdkPackageDir>/dist/worker.mobile.bundle.js`.
  * Uses `qvac.config.*` if present.
  */
-function withMobileBundle(config) {
-    async function buildMobileBundle(config) {
-        const projectRoot = getProjectRootFromMod(config);
-        const sdkPackage = resolveSDKPackageDir(projectRoot);
-        const outputPath = path.join(sdkPackage.dir, 'dist', 'worker.mobile.bundle.js');
-        const configPath = findConfigFile(projectRoot);
-        if (configPath) {
-            console.log(`🕚 QVAC: Found ${path.basename(configPath)}, generating tree-shaken bundle...`);
-        }
-        else {
-            console.log('🕚 QVAC: No config found, generating default bundle (all plugins)...');
-        }
-        const deferredModules = [
-            ...DEFERRED_MODULES,
-            ...MOBILE_UNSUPPORTED_MODULES,
-            `${sdkPackage.name}/worker.mobile.bundle`
-        ];
-        // The bundle is one shared artifact both platforms import, so it is built
-        // for every mobile host: a dual-platform `expo prebuild` runs this mod twice
-        // and the second run would otherwise overwrite the first platform's bundle
-        // with one that resolved the other platform's conditions.
-        const linkerPaths = await runBundler(projectRoot, sdkPackage.dir, configPath, deferredModules, MOBILE_HOSTS);
-        const generatedBundle = path.join(projectRoot, 'qvac', 'worker.bundle.js');
-        await runVerifier(projectRoot, generatedBundle, configPath, mobileHostsForPlatform(config.modRequest.platform));
-        fs.copyFileSync(generatedBundle, outputPath);
-        if (config.modRequest.platform === 'ios' && linkerPaths.ios !== null) {
-            await runIOSAddonLinker(linkerPaths.ios);
+function withMobileBundle(config, options = {}) {
+    config = withDangerousMod(config, ['android', (mod) => buildMobileBundle(mod, options)]);
+    config = withDangerousMod(config, ['ios', (mod) => buildMobileBundle(mod, options)]);
+    return config;
+}
+async function buildMobileBundle(config, options) {
+    const projectRoot = getProjectRootFromMod(config);
+    const sdkPackage = resolveSDKPackageDir(projectRoot);
+    const outputPath = path.join(sdkPackage.dir, 'dist', 'worker.mobile.bundle.js');
+    const platformHosts = mobileHostsForPlatform(config.modRequest.platform);
+    const configPath = findConfigFile(projectRoot);
+    if (configPath) {
+        console.log(`🕚 QVAC: Found ${path.basename(configPath)}, generating tree-shaken bundle...`);
+    }
+    else {
+        console.log('🕚 QVAC: No config found, generating default bundle (all plugins)...');
+    }
+    const deferredModules = [
+        ...DEFERRED_MODULES,
+        ...MOBILE_UNSUPPORTED_MODULES,
+        `${sdkPackage.name}/worker.mobile.bundle`
+    ];
+    // The bundle is one shared artifact both platforms import, so it is built
+    // for every mobile host: a dual-platform `expo prebuild` runs this mod twice
+    // and the second run would otherwise overwrite the first platform's bundle
+    // with one that resolved the other platform's conditions.
+    const bundle = () => runBundler(projectRoot, sdkPackage.dir, configPath, deferredModules, MOBILE_HOSTS);
+    let linkerPaths = await bundle();
+    const generatedBundle = path.join(projectRoot, 'qvac', 'worker.bundle.js');
+    if (options.installMissingPrebuilds === true) {
+        // Take the addons from the bundle graph, which records where each linked
+        // addon really is; looking their names up in the project would miss the
+        // SDK's addons under pnpm or bun's isolated layout.
+        const { installed } = await installMissingHostPrebuilds({
+            projectRoot,
+            hosts: platformHosts,
+            addons: await collectAddonsFromBundle({
+                bundlePath: generatedBundle,
+                projectRoot,
+                hosts: platformHosts
+            }),
+            quiet: false,
+            logger: createCommandLogger({})
+        });
+        if (installed.length > 0) {
+            const names = installed.map((pkg) => `${pkg.name}@${pkg.version}`).join(', ');
+            console.log(`📦 QVAC: Installed addon platform packages: ${names}`);
+            // bare-pack resolved `#host-addon` to the addon's fallback module for
+            // hosts whose platform package was missing.
+            linkerPaths = await bundle();
         }
-        console.log('🫡 QVAC: Mobile bundle generated and verified');
-        return config;
     }
-    config = withDangerousMod(config, ['android', buildMobileBundle]);
-    config = withDangerousMod(config, ['ios', buildMobileBundle]);
+    await runVerifier(projectRoot, generatedBundle, configPath, platformHosts);
+    fs.copyFileSync(generatedBundle, outputPath);
+    if (config.modRequest.platform === 'ios' && linkerPaths.ios !== null) {
+        await runIOSAddonLinker(linkerPaths.ios);
+    }
+    console.log('🫡 QVAC: Mobile bundle generated and verified');
     return config;
 }
 function mobileHostsForPlatform(platform) {
@@ -84,16 +112,12 @@ function findConfigFile(projectRoot) {
     return null;
 }
 async function runVerifier(projectRoot, generatedBundle, configPath, hosts) {
-    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,
-        ...(configPath ? { configPath } : {})
+        ...(configPath ? { configPath } : {}),
+        onProgress: (message) => console.log(`🕚 QVAC: ${message}`)
     });
     if (hasErrors(result)) {
         throw new BundleVerificationFailedError(generatedBundle, new Error(formatVerifyBundleResult(result)));
@@ -107,7 +131,9 @@ async function runBundler(projectRoot, qvacSdkPath, configPath, deferredModules,
         ...(configPath ? { configPath } : {}),
         hosts,
         defer: deferredModules,
-        quiet: true
+        quiet: true,
+        // runVerifier checks engines.bare right after, with progress output.
+        checkEngines: false
     });
     return linkerPaths;
 }
@@ -179,5 +205,5 @@ function copyLinkerPatch(patchesDir, resolver, targetDir, patchName) {
 function compiledPlatformAddonResolver(qvacSdkPath) {
     return path.join(qvacSdkPath, 'dist', 'src', 'expo', 'plugins', 'patches', 'qvac-platform-addons.js');
 }
-export { MOBILE_HOSTS, MOBILE_HOSTS_BY_PLATFORM, MOBILE_UNSUPPORTED_MODULES, mobileHostsForPlatform, patchBareKitLinkers, runIOSAddonLinker };
+export { MOBILE_HOSTS, MOBILE_HOSTS_BY_PLATFORM, MOBILE_UNSUPPORTED_MODULES, buildMobileBundle, mobileHostsForPlatform, patchBareKitLinkers, runIOSAddonLinker };
 export default withMobileBundle;

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

@@ -1,4 +1,6 @@
 import type { ExpoConfig } from 'expo/config';
+import { type MobileBundleOptions } from './withMobileBundle.js';
+type QvacSDKPluginOptions = MobileBundleOptions;
 /**
  * Main Qvac SDK Expo plugin that combines all necessary mobile configurations:
  * - Mobile worker bundle generation
@@ -7,7 +9,11 @@ import type { ExpoConfig } from 'expo/config';
  * - Android NDK version pinning in build.gradle
  * - Android architecture filtering (arm64-v8a only)
  * - OpenCL native library support for Android
+ *
+ * Options (`["@qvac/sdk/expo-plugin", { ... }]` in app.json) go to
+ * `withMobileBundle`.
  */
-declare function withQvacSDK(config: ExpoConfig): ExpoConfig;
+declare function withQvacSDK(config: ExpoConfig, options?: QvacSDKPluginOptions): ExpoConfig;
+export type { QvacSDKPluginOptions };
 export default withQvacSDK;
 //# sourceMappingURL=withQvacSDK.d.ts.map

package/dist/src/expo/plugins/withQvacSDK.js

@@ -2,7 +2,7 @@ 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 withMobileBundle, {} from './withMobileBundle.js';
 import withOpenCL from './withOpenCL.js';
 const { withPlugins } = configPlugins;
 /**
@@ -13,10 +13,13 @@ const { withPlugins } = configPlugins;
  * - Android NDK version pinning in build.gradle
  * - Android architecture filtering (arm64-v8a only)
  * - OpenCL native library support for Android
+ *
+ * Options (`["@qvac/sdk/expo-plugin", { ... }]` in app.json) go to
+ * `withMobileBundle`.
  */
-function withQvacSDK(config) {
+function withQvacSDK(config, options = {}) {
     return withPlugins(config, [
-        withMobileBundle,
+        [withMobileBundle, options],
         withDeviceInfo,
         [
             'expo-build-properties',

package/dist/src/index.d.ts

@@ -1,7 +1,7 @@
-export { batchCompletion, completion, deleteCache, loadModel, downloadAsset, heartbeat, unloadModel, transcribe, transcribeStream, bciTranscribe, bciTranscribeStream, embed, finetune, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, createVectorIndex, loadVectorIndex, type VectorIndex, textToSpeech, textToSpeechStream, getModelInfo, getLoadedModelInfo, getSystemResources, assessModelFit, loggingStream, subscribeServerLogs, type ServerLogHandler, ocr, invokePlugin, invokePluginStream, diffusion, type DiffusionProgressTick, classify, video, type VideoProgressTick, upscale, worldCreateScene, worldStep, type WorldStepResult, type WorldStepProgressTick, type WorldSceneResult, type WorldSceneResultWithPack, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams, suspend, resume, state, vla, vlaHparams, vlaSetEmbodiment, vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE, audioGen, audioEdit, audioUnderstand, type FinetuneHandle } from './client/api/index.js';
+export { batchCompletion, completion, deleteCache, loadModel, downloadAsset, heartbeat, unloadModel, transcribe, transcribeStream, bciTranscribe, bciTranscribeStream, embed, finetune, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, createVectorIndex, loadVectorIndex, type VectorIndex, textToSpeech, textToSpeechStream, getModelInfo, getLoadedModelInfo, startRpcServer, stopRpcServer, discoverRpcServers, getSystemResources, assessModelFit, loggingStream, subscribeServerLogs, type ServerLogHandler, ocr, invokePlugin, invokePluginStream, diffusion, type DiffusionProgressTick, classify, video, type VideoProgressTick, upscale, worldCreateScene, worldStep, type WorldStepResult, type WorldStepProgressTick, type WorldSceneResult, type WorldSceneResultWithPack, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams, suspend, resume, state, vla, vlaHparams, vlaSetEmbodiment, vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE, audioGen, audioEdit, audioUnderstand, type FinetuneHandle } from './client/api/index.js';
 export { close } from './client/index.js';
 export { plugins } from './client/plugins-factory.js';
-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 BatchCompletionEvent, type BatchCompletionResult, type BatchCompletionRun, type BatchPrompt, type EmbedStats, type TranscribeStats, VERBOSITY, type Attachment, type TranscribeStreamSession, type TranscribeStreamMetadataSession, type TranscribeStreamConversationSession, type TranscribeStreamEvent, type VadStateEvent, type EndOfTurnEvent, type TranscribeSegment, type BciConfig, type BciTranscribeClientParams, type BciTranscribeStreamClientParams, type BciTranscribeStreamSession, type BciTranscribeStreamMetadataSession, type BciStreamOpts, type NeuralInput, type TextToSpeechStreamSession, type TextToSpeechStreamResponse, type TextToSpeechStreamClientParams, type TtsClientParamsInput, type TextToSpeechStreamResult, type TtsSentenceChunkUpdate, type TtsResponse, type TtsStats, TTS_ENGINES, type TtsEngine, TTS_PARLER_EMOTIONS, type TtsParlerEmotion, type TtsParlerLoadConfig, type TtsParlerRuntimeConfig, TTS_PACES, TTS_SENTENCE_DELIMITER_PRESETS, type TtsSentenceDelimiterPreset, TTS_CHATTERBOX_LANGUAGES, type TtsChatterboxLanguage, type TtsChatterboxLoadConfig, type TtsChatterboxRuntimeConfig, TTS_SUPERTONIC_LANGUAGES, type TtsSupertonicLanguage, type TtsSupertonicLoadConfig, type TtsSupertonicRuntimeConfig, TTS_COSYVOICE3_EMOTIONS, TTS_COSYVOICE3_INSTRUCT_DIALECTS, TTS_COSYVOICE3_INSTRUCT_VOLUMES, TTS_COSYVOICE3_INSTRUCT_STYLES, type TtsPace, type TtsCosyvoice3Emotion, type TtsCosyvoice3Instruct, type TtsCosyvoice3LoadConfig, type TtsCosyvoice3RuntimeConfig, type TtsAudio8LoadConfig, type TtsAudio8RuntimeConfig, 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, RAG_ERROR_CODES, VectorIndexStorage, DEFAULT_VECTOR_INDEX_STORAGE, type VectorId, type VectorIndexHit, type CreateVectorIndexParams, type LoadVectorIndexParams, type VectorIndexAddParams, type VectorIndexIdsParams, type VectorIndexSearchParams, type VectorIndexWriteParams, type QvacConfig, type ModelInfo, type GetModelInfoParams, type GetLoadedModelInfoParams, type LoadedModelInfo, type GetSystemResourcesInput, type ResourceScope, type ResourceProvenance, type ResourceMetric, type GraphicsDriver, type GraphicsDriverCapabilities, type BackendProbeResult, type BackendDevice, type BackendDriver, type BackendFallback, type InferenceBackendDiagnostics, type CPUResourceCapabilities, type GPUResourceCapabilities, type SystemResourceCapabilities, type GPUResourceSample, type SystemResourceSample, type SystemResources, type AssessModelFitInput, type AssessModelFitResult, type LoadedInstance, type CacheFileInfo, toolSchema, type McpClient, type McpClientInput, type OCRClientParams, type OCRTextBlock, type OCROptions, type ClassifyClientParams, type ClassificationResult, type DiffusionClientParams, type DiffusionStreamResponse, type DiffusionStats, AUDIOGEN_ENGINES, AUDIOGEN_TASK_TYPES, AUDIOGEN_TRACKS, AUDIOGEN_INPUT_SAMPLE_RATE, AUDIOGEN_INPUT_CHANNELS, AUDIOGEN_INPUT_MAX_SECONDS, AUDIOGEN_MAX_AUDIO_CODES, AUDIOGEN_EDIT_OPERATIONS, AUDIOGEN_REPAINT_MODES, type AudioGenEngine, type AudioGenTaskType, type AudioGenTrack, type AudioGenAudioInput, type AudioGenClientParams, type AudioGenConfig, type AudioGenRuntimeConfig, type AudioGenProgress, type AudioGenAudio, type AudioGenStats, type AudioGenResult, type AudioGenStreamResponse, type AudioGenEditOperationType, type AudioGenRepaintMode, type AudioEditPrompt, type AudioEditFlowEditOperation, type AudioEditRepaintOperation, type AudioEditOperation, type AudioEditClientParams, type AudioEditStreamResponse, type AudioUnderstandClientParams, type AudioUnderstandResponse, type AudioGenUnderstandResult, type AudioUnderstandResult, type VideoClientParams, type VideoStreamResponse, type VideoStats, type UpscaleClientParams, type UpscaleStreamResponse, type UpscaleStats, type WalkKey, type WalkKeysInput, type WorldStepClientParams, type WorldStepStreamResponse, type WorldStepStats, type WorldSceneClientParams, type WorldSceneStreamResponse, type WorldSceneStats, type VlaConfig, type VlaClientRunParams, type VlaClientRunResult, type VlaEmbodimentSelection, type VlaEmbodimentSelector, type VlaHparams, type VlaStats, definePlugin, defineHandler, defineDuplexHandler, PluginDefinitionInvalidError, type QvacPlugin, type CreateModelParams, type PluginModelResult, type ModelRegistryEntry, type ModelRegistryEntryAddon, type ProfilerMode, type FinetuneValidation, type FinetuneRunParams, type FinetuneGetStateParams, type FinetuneStopParams, type FinetuneParams, type FinetuneStatus, type FinetuneProgress, type FinetuneStats, type FinetuneResult } from '@qvac/inference/surface';
+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 BatchCompletionEvent, type BatchCompletionResult, type BatchCompletionRun, type BatchPrompt, type EmbedStats, type TranscribeStats, VERBOSITY, type Attachment, type TranscribeStreamSession, type TranscribeStreamMetadataSession, type TranscribeStreamConversationSession, type TranscribeStreamEvent, type VadStateEvent, type EndOfTurnEvent, type TranscribeSegment, ASR_BACKEND_IDS, type AsrBackendId, type BciConfig, type BciTranscribeClientParams, type BciTranscribeStreamClientParams, type BciTranscribeStreamSession, type BciTranscribeStreamMetadataSession, type BciStreamOpts, type NeuralInput, type TextToSpeechStreamSession, type TextToSpeechStreamResponse, type TextToSpeechStreamClientParams, type TtsClientParamsInput, type TextToSpeechStreamResult, type TtsSentenceChunkUpdate, type TtsResponse, type TtsStats, TTS_ENGINES, type TtsEngine, TTS_PARLER_EMOTIONS, type TtsParlerEmotion, type TtsParlerLoadConfig, type TtsParlerRuntimeConfig, TTS_PACES, TTS_SENTENCE_DELIMITER_PRESETS, type TtsSentenceDelimiterPreset, TTS_CHATTERBOX_LANGUAGES, type TtsChatterboxLanguage, type TtsChatterboxLoadConfig, type TtsChatterboxRuntimeConfig, TTS_SUPERTONIC_LANGUAGES, type TtsSupertonicLanguage, type TtsSupertonicLoadConfig, type TtsSupertonicRuntimeConfig, TTS_COSYVOICE3_EMOTIONS, TTS_COSYVOICE3_INSTRUCT_DIALECTS, TTS_COSYVOICE3_INSTRUCT_VOLUMES, TTS_COSYVOICE3_INSTRUCT_STYLES, type TtsPace, type TtsCosyvoice3Emotion, type TtsCosyvoice3Instruct, type TtsCosyvoice3LoadConfig, type TtsCosyvoice3RuntimeConfig, type TtsAudio8LoadConfig, type TtsAudio8RuntimeConfig, type TtsMossLoadConfig, type TtsMossRuntimeConfig, 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, RAG_ERROR_CODES, VectorIndexStorage, DEFAULT_VECTOR_INDEX_STORAGE, type VectorId, type VectorIndexHit, type CreateVectorIndexParams, type LoadVectorIndexParams, type VectorIndexAddParams, type VectorIndexIdsParams, type VectorIndexSearchParams, type VectorIndexWriteParams, type QvacConfig, type ModelInfo, type GetModelInfoParams, type GetLoadedModelInfoParams, type LoadedModelInfo, type GetSystemResourcesInput, type ResourceScope, type ResourceProvenance, type ResourceMetric, type GraphicsDriver, type GraphicsDriverCapabilities, type BackendProbeResult, type BackendDevice, type BackendDriver, type BackendFallback, type InferenceBackendDiagnostics, type CPUResourceCapabilities, type GPUResourceCapabilities, type SystemResourceCapabilities, type GPUResourceSample, type SystemResourceSample, type SystemResources, type AssessModelFitInput, type AssessModelFitResult, type LoadedInstance, type CacheFileInfo, toolSchema, TOOL_SEARCH_NAME, buildToolSearchTool, executeToolSearch, loadedToolNames, searchDeferredTools, type McpClient, type McpClientInput, type OCRClientParams, type OCRTextBlock, type OCROptions, type ClassifyClientParams, type ClassificationResult, type DiffusionClientParams, type DiffusionStreamResponse, type DiffusionStats, AUDIOGEN_ENGINES, AUDIOGEN_TASK_TYPES, AUDIOGEN_TRACKS, AUDIOGEN_INPUT_SAMPLE_RATE, AUDIOGEN_INPUT_CHANNELS, AUDIOGEN_INPUT_MAX_SECONDS, AUDIOGEN_MAX_AUDIO_CODES, AUDIOGEN_EDIT_OPERATIONS, AUDIOGEN_REPAINT_MODES, type AudioGenEngine, type AudioGenTaskType, type AudioGenTrack, type AudioGenAudioInput, type AudioGenClientParams, type AudioGenConfig, type AudioGenRuntimeConfig, type AudioGenProgress, type AudioGenAudio, type AudioGenStats, type AudioGenResult, type AudioGenStreamResponse, type AudioGenEditOperationType, type AudioGenRepaintMode, type AudioEditPrompt, type AudioEditFlowEditOperation, type AudioEditRepaintOperation, type AudioEditOperation, type AudioEditClientParams, type AudioEditStreamResponse, type AudioUnderstandClientParams, type AudioUnderstandResponse, type AudioGenUnderstandResult, type AudioUnderstandResult, type VideoClientParams, type VideoStreamResponse, type VideoStats, type UpscaleClientParams, type UpscaleStreamResponse, type UpscaleStats, type WalkKey, type WalkKeysInput, type WorldStepClientParams, type WorldStepStreamResponse, type WorldStepStats, type WorldSceneClientParams, type WorldSceneStreamResponse, type WorldSceneStats, type VlaConfig, type VlaClientRunParams, type VlaClientRunResult, type VlaEmbodimentSelection, type VlaEmbodimentSelector, type VlaHparams, type VlaStats, definePlugin, defineHandler, defineDuplexHandler, PluginDefinitionInvalidError, type QvacPlugin, type CreateModelParams, type PluginModelResult, type ModelRegistryEntry, type ModelRegistryEntryAddon, type ProfilerMode, type FinetuneValidation, type FinetuneRunParams, type FinetuneGetStateParams, type FinetuneStopParams, type FinetuneParams, type FinetuneStatus, type FinetuneProgress, type FinetuneStats, type FinetuneResult } from '@qvac/inference/surface';
 export { SDK_CLIENT_ERROR_CODES } from './schemas/sdk-errors-client.js';
 export { SDK_SERVER_ERROR_CODES } from './schemas/sdk-errors-server.js';
 export { PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_BCI, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, PLUGIN_DIFFUSION, PLUGIN_AUDIOGEN, PLUGIN_VLA, PLUGIN_CLASSIFICATION, SDK_DEFAULT_PLUGINS, type BuiltinPlugin } from './plugin-ids.js';
@@ -17,4 +17,7 @@ export { getLogger, SDK_LOG_ID, SDK_ALL_LOG_ID } from './logging/index.js';
 export type { Logger, LogTransport, LoggerOptions } from './logging/index.js';
 export { profiler, attachBackendDiagnostics } from '@qvac/inference/surface';
 export type { ProfilerRuntimeOptions, ProfilerExport, ProfilingEvent, ProfilerGPUResourceGauge, ProfilerResourceGauge } from '@qvac/inference/surface';
+export type { StartRpcServerOptions, StopRpcServerOptions, DiscoverRpcServersOptions, RpcServerInfo, RpcServerCandidate } from '@qvac/inference/surface';
+export { RpcServerOperationError } from './utils/errors-server.js';
+export { getRpcDeviceMap, type RpcDeviceMapping, type RpcDevice } from '@qvac/inference/surface';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.js

@@ -1,8 +1,8 @@
 // Public API exports only
-export { batchCompletion, completion, deleteCache, loadModel, downloadAsset, heartbeat, unloadModel, transcribe, transcribeStream, bciTranscribe, bciTranscribeStream, embed, finetune, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, createVectorIndex, loadVectorIndex, textToSpeech, textToSpeechStream, getModelInfo, getLoadedModelInfo, getSystemResources, assessModelFit, loggingStream, subscribeServerLogs, ocr, invokePlugin, invokePluginStream, diffusion, classify, video, upscale, worldCreateScene, worldStep, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, suspend, resume, state, vla, vlaHparams, vlaSetEmbodiment, vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE, audioGen, audioEdit, audioUnderstand } from './client/api/index.js';
+export { batchCompletion, completion, deleteCache, loadModel, downloadAsset, heartbeat, unloadModel, transcribe, transcribeStream, bciTranscribe, bciTranscribeStream, embed, finetune, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, createVectorIndex, loadVectorIndex, textToSpeech, textToSpeechStream, getModelInfo, getLoadedModelInfo, startRpcServer, stopRpcServer, discoverRpcServers, getSystemResources, assessModelFit, loggingStream, subscribeServerLogs, ocr, invokePlugin, invokePluginStream, diffusion, classify, video, upscale, worldCreateScene, worldStep, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, suspend, resume, state, vla, vlaHparams, vlaSetEmbodiment, vlaPreprocessImage, vlaPadState, VLA_DEFAULT_IMAGE_SIZE, audioGen, audioEdit, audioUnderstand } from './client/api/index.js';
 export { close } from './client/index.js';
 export { plugins } from './client/plugins-factory.js';
-export { VERBOSITY, TTS_ENGINES, TTS_PARLER_EMOTIONS, TTS_PACES, TTS_SENTENCE_DELIMITER_PRESETS, TTS_CHATTERBOX_LANGUAGES, TTS_SUPERTONIC_LANGUAGES, TTS_COSYVOICE3_EMOTIONS, TTS_COSYVOICE3_INSTRUCT_DIALECTS, TTS_COSYVOICE3_INSTRUCT_VOLUMES, TTS_COSYVOICE3_INSTRUCT_STYLES, RAG_ERROR_CODES, VectorIndexStorage, DEFAULT_VECTOR_INDEX_STORAGE, toolSchema, AUDIOGEN_ENGINES, AUDIOGEN_TASK_TYPES, AUDIOGEN_TRACKS, AUDIOGEN_INPUT_SAMPLE_RATE, AUDIOGEN_INPUT_CHANNELS, AUDIOGEN_INPUT_MAX_SECONDS, AUDIOGEN_MAX_AUDIO_CODES, AUDIOGEN_EDIT_OPERATIONS, AUDIOGEN_REPAINT_MODES, definePlugin, defineHandler, defineDuplexHandler, PluginDefinitionInvalidError } from '@qvac/inference/surface';
+export { VERBOSITY, ASR_BACKEND_IDS, TTS_ENGINES, TTS_PARLER_EMOTIONS, TTS_PACES, TTS_SENTENCE_DELIMITER_PRESETS, TTS_CHATTERBOX_LANGUAGES, TTS_SUPERTONIC_LANGUAGES, TTS_COSYVOICE3_EMOTIONS, TTS_COSYVOICE3_INSTRUCT_DIALECTS, TTS_COSYVOICE3_INSTRUCT_VOLUMES, TTS_COSYVOICE3_INSTRUCT_STYLES, RAG_ERROR_CODES, VectorIndexStorage, DEFAULT_VECTOR_INDEX_STORAGE, toolSchema, TOOL_SEARCH_NAME, buildToolSearchTool, executeToolSearch, loadedToolNames, searchDeferredTools, AUDIOGEN_ENGINES, AUDIOGEN_TASK_TYPES, AUDIOGEN_TRACKS, AUDIOGEN_INPUT_SAMPLE_RATE, AUDIOGEN_INPUT_CHANNELS, AUDIOGEN_INPUT_MAX_SECONDS, AUDIOGEN_MAX_AUDIO_CODES, AUDIOGEN_EDIT_OPERATIONS, AUDIOGEN_REPAINT_MODES, definePlugin, defineHandler, defineDuplexHandler, PluginDefinitionInvalidError } from '@qvac/inference/surface';
 // SDK-owned error-code objects: `SDK_CLIENT_ERROR_CODES` holds transport/client
 // codes absent from @qvac/inference, and `SDK_SERVER_ERROR_CODES` carries the
 // client-side error definitions (`addCodes` message registry) that
@@ -61,3 +61,5 @@ export { BareRuntimeBinaryNotFoundError, WorkerCrashedError, WorkerShutdownError
 export { getLogger, SDK_LOG_ID, SDK_ALL_LOG_ID } from './logging/index.js';
 // Profiler exports
 export { profiler, attachBackendDiagnostics } from '@qvac/inference/surface';
+export { RpcServerOperationError } from './utils/errors-server.js';
+export { getRpcDeviceMap } from '@qvac/inference/surface';

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

@@ -34,6 +34,8 @@ export declare const SDK_CLIENT_ERROR_CODES: {
     readonly INVALID_PLUGIN_SPECIFIER: 50612;
     readonly BARE_IMPORTS_MAP_NOT_FOUND: 50613;
     readonly BARE_RUNTIME_BINARY_NOT_FOUND: 50614;
+    readonly HOST_PREBUILDS_INSTALL_REFUSED: 50615;
+    readonly HOST_PREBUILDS_INSTALL_FAILED: 50616;
     readonly PROFILER_INVALID_CAPACITY: 50800;
 };
 declare const clientErrorDefinitions: ErrorCodesMap;

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

@@ -40,6 +40,8 @@ export const SDK_CLIENT_ERROR_CODES = {
     INVALID_PLUGIN_SPECIFIER: 50612,
     BARE_IMPORTS_MAP_NOT_FOUND: 50613,
     BARE_RUNTIME_BINARY_NOT_FOUND: 50614,
+    HOST_PREBUILDS_INSTALL_REFUSED: 50615,
+    HOST_PREBUILDS_INSTALL_FAILED: 50616,
     // Profiler Errors (50,800-50,899)
     PROFILER_INVALID_CAPACITY: 50800
 };
@@ -181,6 +183,20 @@ const clientErrorDefinitions = {
         name: 'BARE_RUNTIME_BINARY_NOT_FOUND',
         message: (platform, arch) => `Could not load the Bare runtime binary for ${platform}-${arch}. The platform package "bare-runtime-${platform}-${arch}" (or one of its dependencies) is missing from node_modules — commonly seen with pnpm, which does not always install nested optional dependencies. Fix it by installing the platform package directly (e.g. \`pnpm add bare-runtime-${platform}-${arch}\`) or by installing with npm or bun. See https://github.com/tetherto/qvac/issues/1492`
     },
+    [SDK_CLIENT_ERROR_CODES.HOST_PREBUILDS_INSTALL_REFUSED]: {
+        name: 'HOST_PREBUILDS_INSTALL_REFUSED',
+        message: (reason, dependencies) => `Cannot install the addon platform packages automatically: ${reason}.` +
+            (dependencies
+                ? `\n\n  Add them to the dependencies in package.json, pinned to these exact versions, and reinstall:\n${dependencies}`
+                : '')
+    },
+    [SDK_CLIENT_ERROR_CODES.HOST_PREBUILDS_INSTALL_FAILED]: {
+        name: 'HOST_PREBUILDS_INSTALL_FAILED',
+        message: (details, dependencies) => `Installing the addon platform packages failed: ${details}` +
+            (dependencies
+                ? `\n\n  Fix the error, or add them to the dependencies in package.json, pinned to these exact versions, and reinstall:\n${dependencies}`
+                : '')
+    },
     // Profiler Errors (50,800-50,899)
     [SDK_CLIENT_ERROR_CODES.PROFILER_INVALID_CAPACITY]: {
         name: 'PROFILER_INVALID_CAPACITY',

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

@@ -15,6 +15,7 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly TTS_REFERENCE_AUDIO_REQUIRED: 52209;
     readonly LEGACY_PARAKEET_MODEL_DEPRECATED: 52210;
     readonly LEGACY_TTS_MODEL_DEPRECATED: 52211;
+    readonly RPC_SERVER_OPERATION_FAILED: 52423;
     readonly MODEL_UNLOAD_FAILED: 52400;
     readonly EMBED_FAILED: 52401;
     readonly EMBED_NO_EMBEDDINGS: 52402;

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

@@ -21,6 +21,7 @@ export const SDK_SERVER_ERROR_CODES = {
     LEGACY_PARAKEET_MODEL_DEPRECATED: 52210,
     LEGACY_TTS_MODEL_DEPRECATED: 52211,
     // Model Operations (52,400-52,799)
+    RPC_SERVER_OPERATION_FAILED: 52423,
     MODEL_UNLOAD_FAILED: 52400,
     EMBED_FAILED: 52401,
     EMBED_NO_EMBEDDINGS: 52402,
@@ -178,6 +179,10 @@ const serverErrorDefinitions = {
         message: (legacyFields) => `Legacy ONNX TTS modelConfig fields are no longer supported (${legacyFields ?? 'unknown fields'}). As of @qvac/tts-ggml the addon uses GGUF bundles: supply the primary GGUF via modelSrc, set language in modelConfig, and for Chatterbox add s3genModelSrc (e.g. loadModel({ modelSrc: TTS_T3_TURBO_EN_CHATTERBOX_Q8_0, modelType: "tts", modelConfig: { ttsEngine: "chatterbox", language: "en", s3genModelSrc: TTS_S3GEN_EN_CHATTERBOX } })). Supertonic multilingual mode is selected by the GGUF (e.g. TTS_MULTILINGUAL_SUPERTONIC2_Q8_0) plus language — not ttsSupertonicMultilingual.`
     },
     // Model Operations (52,400-52,799)
+    [SDK_SERVER_ERROR_CODES.RPC_SERVER_OPERATION_FAILED]: {
+        name: 'RPC_SERVER_OPERATION_FAILED',
+        message: (operation, details) => `${operation}: ${details}`
+    },
     [SDK_SERVER_ERROR_CODES.MODEL_UNLOAD_FAILED]: {
         name: 'MODEL_UNLOAD_FAILED',
         message: (modelId) => `Failed to unload model${modelId ? ` "${modelId}"` : ''}`

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

@@ -100,6 +100,21 @@ export declare class BareImportsMapNotFoundError extends QvacErrorBase {
 export declare class BareRuntimeBinaryNotFoundError extends QvacErrorBase {
     constructor(platform: string, arch: string, cause?: unknown);
 }
+/**
+ * Addon platform packages are missing and cannot be installed automatically:
+ * no supported package manager was detected, two installed versions of one
+ * addon need the same package, or an addon names an invalid package.
+ * `dependencies` maps each missing package to the exact version to pin.
+ */
+export declare class HostPrebuildsInstallRefusedError extends QvacErrorBase {
+    readonly dependencies: Record<string, string>;
+    constructor(reason: string, dependencies: Record<string, string>, cause?: unknown);
+}
+/** The package manager ran but the missing addon platform packages are still not installed. */
+export declare class HostPrebuildsInstallFailedError extends QvacErrorBase {
+    readonly dependencies: Record<string, string>;
+    constructor(details: string, dependencies: Record<string, string>, cause?: unknown);
+}
 export declare class ConfigFileNotFoundError extends QvacErrorBase {
     constructor(searchPaths: string, cause?: unknown);
 }

package/dist/src/utils/errors-client.js

@@ -166,6 +166,32 @@ export class BareRuntimeBinaryNotFoundError extends QvacErrorBase {
         super(createErrorOptions(SDK_CLIENT_ERROR_CODES.BARE_RUNTIME_BINARY_NOT_FOUND, [platform, arch], cause));
     }
 }
+/**
+ * Addon platform packages are missing and cannot be installed automatically:
+ * no supported package manager was detected, two installed versions of one
+ * addon need the same package, or an addon names an invalid package.
+ * `dependencies` maps each missing package to the exact version to pin.
+ */
+export class HostPrebuildsInstallRefusedError extends QvacErrorBase {
+    dependencies;
+    constructor(reason, dependencies, cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.HOST_PREBUILDS_INSTALL_REFUSED, [reason, formatDependencyPins(dependencies)], cause));
+        this.dependencies = dependencies;
+    }
+}
+/** The package manager ran but the missing addon platform packages are still not installed. */
+export class HostPrebuildsInstallFailedError extends QvacErrorBase {
+    dependencies;
+    constructor(details, dependencies, cause) {
+        super(createErrorOptions(SDK_CLIENT_ERROR_CODES.HOST_PREBUILDS_INSTALL_FAILED, [details, formatDependencyPins(dependencies)], cause));
+        this.dependencies = dependencies;
+    }
+}
+function formatDependencyPins(dependencies) {
+    return Object.entries(dependencies)
+        .map(([name, version]) => `    "${name}": "${version}"`)
+        .join(',\n');
+}
 export class ConfigFileNotFoundError extends QvacErrorBase {
     constructor(searchPaths, cause) {
         super(createErrorOptions(SDK_CLIENT_ERROR_CODES.CONFIG_FILE_NOT_FOUND, [searchPaths], cause));

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

@@ -389,4 +389,5 @@ export declare class PathTraversalError extends QvacErrorBase {
 export declare class ModelRegistryQueryFailedError extends QvacErrorBase {
     constructor(details?: string, cause?: unknown);
 }
+export { RpcServerOperationError } from '@qvac/inference/surface';
 //# sourceMappingURL=errors-server.d.ts.map

package/dist/src/utils/errors-server.js

@@ -640,3 +640,4 @@ export class ModelRegistryQueryFailedError extends QvacErrorBase {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.QVAC_MODEL_REGISTRY_QUERY_FAILED, details ? [details] : undefined, cause));
     }
 }
+export { RpcServerOperationError } from '@qvac/inference/surface';

package/dist/src/utils/mcp-adapter.js

@@ -34,7 +34,8 @@ function createMcpToolHandler(client, toolName) {
 export async function getMcpToolsWithHandlers(clients) {
     const allTools = [];
     const handlers = new Map();
-    for (const { client, includeResources } of clients) {
+    for (const { client, includeResources, deferLoading, group } of clients) {
+        const start = allTools.length;
         const { tools: mcpTools } = await client.listTools();
         for (const mcpTool of mcpTools) {
             allTools.push(convertMcpToolToTool(mcpTool));
@@ -87,6 +88,11 @@ export async function getMcpToolsWithHandlers(clients) {
                 });
             }
         }
+        if (deferLoading === true) {
+            for (let i = start; i < allTools.length; i++) {
+                allTools[i] = { ...allTools[i], deferLoading: true, ...(group !== undefined && { group }) };
+            }
+        }
     }
     return { tools: allTools, handlers };
 }

package/dist/src/utils/tool-helpers.d.ts

@@ -7,6 +7,10 @@ export type ToolInput<T extends ZodObjectType = ZodObjectType> = {
     description: string;
     parameters: T;
     handler?: ToolHandler;
+    /** Keep this tool's parameter schema out of the initial prompt; see `Tool.deferLoading`. */
+    deferLoading?: boolean;
+    /** Heading this tool is listed under in the deferred catalog. */
+    group?: string;
 };
 export declare function convertToolInput(input: ToolInput): Tool;
 export declare function convertTools(inputs: ToolInput[]): Tool[];

package/dist/src/utils/tool-helpers.js

@@ -54,6 +54,8 @@ export function convertToolInput(input) {
         type: 'function',
         name: input.name,
         description: input.description,
+        ...(input.deferLoading !== undefined && { deferLoading: input.deferLoading }),
+        ...(input.group !== undefined && { group: input.group }),
         parameters: {
             type: 'object',
             properties,

package/dist/src/worker/ggml-rpc-server-provider.d.ts

@@ -0,0 +1,2 @@
+export { default, ggmlRpcServerProvider } from '@qvac/inference/ggml-rpc-server/provider';
+//# sourceMappingURL=ggml-rpc-server-provider.d.ts.map

package/dist/src/worker/ggml-rpc-server-provider.js

@@ -0,0 +1 @@
+export { default, ggmlRpcServerProvider } from '@qvac/inference/ggml-rpc-server/provider';