@qvac/sdk 0.19.0 → 0.20.0

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

@@ -12,7 +12,20 @@ import { BundleVerificationFailedError } from '../../utils/errors-client.js';
 const { withDangerousMod } = configPlugins;
 /** 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'];
+/**
+ * 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.
+ */
+const MOBILE_UNSUPPORTED_MODULES = ['bare-runtime/spawn', '@qvac/model-fit/process'];
+const MOBILE_HOSTS_BY_PLATFORM = {
+    android: ['android-arm64'],
+    ios: ['ios-arm64', 'ios-arm64-simulator', 'ios-x64-simulator']
+};
+/** Compiled resolver copied beside each patched linker as this filename. */
+const PLATFORM_ADDON_RESOLVER = 'qvac-platform-addons.mjs';
+/** Every mobile host, in platform order. The bundle covers all of them. */
+const MOBILE_HOSTS = [...MOBILE_HOSTS_BY_PLATFORM.android, ...MOBILE_HOSTS_BY_PLATFORM.ios];
 /**
  * Expo plugin: bundle, verify, then copy the mobile worker bundle.
  *
@@ -31,10 +44,18 @@ function withMobileBundle(config) {
         else {
             console.log('🕚 QVAC: No config found, generating default bundle (all plugins)...');
         }
-        const deferredModules = [...DEFERRED_MODULES, `${sdkPackage.name}/worker.mobile.bundle`];
-        const linkerPaths = await runBundler(projectRoot, sdkPackage.dir, configPath, deferredModules);
+        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);
+        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);
@@ -46,6 +67,12 @@ function withMobileBundle(config) {
     config = withDangerousMod(config, ['ios', buildMobileBundle]);
     return config;
 }
+function mobileHostsForPlatform(platform) {
+    if (platform !== 'android' && platform !== 'ios') {
+        throw new Error(`QVAC: withMobileBundle only supports android and ios builds, got "${platform}"`);
+    }
+    return MOBILE_HOSTS_BY_PLATFORM[platform];
+}
 /** Finds qvac.config.* file in project root */
 function findConfigFile(projectRoot) {
     for (const candidate of CONFIG_CANDIDATES) {
@@ -56,7 +83,7 @@ function findConfigFile(projectRoot) {
     }
     return null;
 }
-async function runVerifier(projectRoot, generatedBundle, configPath) {
+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 ' +
@@ -65,20 +92,20 @@ async function runVerifier(projectRoot, generatedBundle, configPath) {
     const result = await verifyBundle({
         projectRoot,
         addonsSource: generatedBundle,
-        hosts: MOBILE_HOSTS,
+        hosts,
         ...(configPath ? { configPath } : {})
     });
     if (hasErrors(result)) {
         throw new BundleVerificationFailedError(generatedBundle, new Error(formatVerifyBundleResult(result)));
     }
 }
-async function runBundler(projectRoot, qvacSdkPath, configPath, deferredModules) {
+async function runBundler(projectRoot, qvacSdkPath, configPath, deferredModules, hosts) {
     const linkerPaths = patchBareKitLinkers(projectRoot, qvacSdkPath);
     await bundleSdk({
         projectRoot,
         sdkPath: qvacSdkPath,
         ...(configPath ? { configPath } : {}),
-        hosts: MOBILE_HOSTS,
+        hosts,
         defer: deferredModules,
         quiet: true
     });
@@ -120,33 +147,37 @@ function patchBareKitLinkers(projectRoot, qvacSdkPath) {
         return { android: null, ios: null };
     }
     const patchesDir = path.join(qvacSdkPath, 'src', 'expo', 'plugins', 'patches');
+    const resolver = compiledPlatformAddonResolver(qvacSdkPath);
     if (!fs.existsSync(patchesDir)) {
         console.log(`⚠️ QVAC: patches directory not found (${patchesDir}), skipping linker patch`);
         return { android: null, ios: null };
     }
-    const androidPatch = path.join(patchesDir, 'android-link.mjs');
-    const androidTarget = path.join(bareKitPath, 'android', 'link.mjs');
-    let androidLinkerPath = null;
-    if (fs.existsSync(androidPatch)) {
-        fs.copyFileSync(androidPatch, androidTarget);
-        console.log('✅ QVAC: Patched android/link.mjs for manifest-aware linking');
-        androidLinkerPath = androidTarget;
-    }
-    else {
-        console.log(`⚠️ QVAC: Android linker patch not found (${androidPatch})`);
-    }
-    const iosPatch = path.join(patchesDir, 'ios-link.mjs');
-    const iosTarget = path.join(bareKitPath, 'ios', 'link.mjs');
-    let iosLinkerPath = null;
-    if (fs.existsSync(iosPatch)) {
-        fs.copyFileSync(iosPatch, iosTarget);
-        console.log('✅ QVAC: Patched ios/link.mjs for manifest-aware linking');
-        iosLinkerPath = iosTarget;
-    }
-    else {
-        console.log(`⚠️ QVAC: iOS linker patch not found (${iosPatch})`);
+    return {
+        android: copyLinkerPatch(patchesDir, resolver, path.join(bareKitPath, 'android'), 'android-link.mjs'),
+        ios: copyLinkerPatch(patchesDir, resolver, path.join(bareKitPath, 'ios'), 'ios-link.mjs')
+    };
+}
+/**
+ * Copies one linker patch and the split-addon resolver it imports, returning the
+ * installed linker path. The resolver has to sit beside the linker: the patch is
+ * installed into react-native-bare-kit and imports it relatively.
+ */
+function copyLinkerPatch(patchesDir, resolver, targetDir, patchName) {
+    const patch = path.join(patchesDir, patchName);
+    if (!fs.existsSync(patch) || !fs.existsSync(resolver)) {
+        // Installing the patch without the resolver it imports would break linking
+        // outright, so leave the stock linker in place instead.
+        console.log(`⚠️ QVAC: linker patch incomplete (${patch}), leaving the stock linker`);
+        return null;
     }
-    return { android: androidLinkerPath, ios: iosLinkerPath };
+    const target = path.join(targetDir, 'link.mjs');
+    fs.copyFileSync(patch, target);
+    fs.copyFileSync(resolver, path.join(targetDir, PLATFORM_ADDON_RESOLVER));
+    console.log(`✅ QVAC: Patched ${path.basename(targetDir)}/link.mjs for manifest-aware linking`);
+    return target;
+}
+function compiledPlatformAddonResolver(qvacSdkPath) {
+    return path.join(qvacSdkPath, 'dist', 'src', 'expo', 'plugins', 'patches', 'qvac-platform-addons.js');
 }
-export { MOBILE_HOSTS, patchBareKitLinkers, runIOSAddonLinker };
+export { MOBILE_HOSTS, MOBILE_HOSTS_BY_PLATFORM, MOBILE_UNSUPPORTED_MODULES, mobileHostsForPlatform, patchBareKitLinkers, runIOSAddonLinker };
 export default withMobileBundle;

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, 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, 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, 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 TtsParlerEmotion, type TtsParlerLoadConfig, type TtsParlerRuntimeConfig, TTS_PACES, 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, 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_INPUT_SAMPLE_RATE, AUDIOGEN_INPUT_CHANNELS, AUDIOGEN_INPUT_MAX_SECONDS, type AudioGenEngine, type AudioGenTaskType, type AudioGenAudioInput, type AudioGenClientParams, type AudioGenConfig, type AudioGenRuntimeConfig, type AudioGenProgress, type AudioGenAudio, type AudioGenStats, type AudioGenResult, type AudioGenStreamResponse, 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, 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 { 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';
@@ -12,7 +12,7 @@ export { SUPPORTED_AUDIO_FORMATS } from '@qvac/inference/surface';
 export { InferenceCancelledError } from './utils/errors-server.js';
 export type { InferenceCancelledPartial } from './utils/errors-server.js';
 export { ContextOverflowError, type ContextOverflowErrorSizes, RequestIdConflictError, RequestNotFoundError, RequestRejectedByPolicyError, TranslationFailedError } from './utils/errors-server.js';
-export { BareRuntimeBinaryNotFoundError, WorkerCrashedError, WorkerShutdownError, WorkerStartupError, RequestValidationFailedError, StreamEndedError } from './utils/errors-client.js';
+export { BareRuntimeBinaryNotFoundError, WorkerCrashedError, WorkerShutdownError, WorkerStartupError, RequestValidationFailedError, StreamEndedError, TextToSpeechStreamFailedError } from './utils/errors-client.js';
 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';

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, 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 } 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, 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_PACES, TTS_COSYVOICE3_EMOTIONS, TTS_COSYVOICE3_INSTRUCT_DIALECTS, TTS_COSYVOICE3_INSTRUCT_VOLUMES, TTS_COSYVOICE3_INSTRUCT_STYLES, RAG_ERROR_CODES, toolSchema, AUDIOGEN_ENGINES, AUDIOGEN_TASK_TYPES, AUDIOGEN_INPUT_SAMPLE_RATE, AUDIOGEN_INPUT_CHANNELS, AUDIOGEN_INPUT_MAX_SECONDS, definePlugin, defineHandler, defineDuplexHandler, PluginDefinitionInvalidError } from '@qvac/inference/surface';
+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';
 // 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
@@ -52,7 +52,11 @@ export { ContextOverflowError, RequestIdConflictError, RequestNotFoundError, Req
 // `StreamEndedError` is raised by the streaming result helpers (upscale, world)
 // when the RPC stream closes without a terminal `done` frame. Exported for the
 // same reason as the rest of this block: matching on it requires the class.
-export { BareRuntimeBinaryNotFoundError, WorkerCrashedError, WorkerShutdownError, WorkerStartupError, RequestValidationFailedError, StreamEndedError } from './utils/errors-client.js';
+// `TextToSpeechStreamFailedError` is what `textToSpeech()` throws for an
+// invalid stream/sentenceStream combination, and what the duplex TTS session
+// throws on a write after end — its own JSDoc named it long before it was
+// exported.
+export { BareRuntimeBinaryNotFoundError, WorkerCrashedError, WorkerShutdownError, WorkerStartupError, RequestValidationFailedError, StreamEndedError, TextToSpeechStreamFailedError } from './utils/errors-client.js';
 // Logging exports
 export { getLogger, SDK_LOG_ID, SDK_ALL_LOG_ID } from './logging/index.js';
 // Profiler exports

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

@@ -50,6 +50,10 @@ export declare const SDK_SERVER_ERROR_CODES: {
     readonly RAG_LIST_WORKSPACES_FAILED: 52809;
     readonly RAG_CHUNK_FAILED: 52810;
     readonly RAG_WORKSPACE_NOT_OPEN: 52811;
+    readonly VECTOR_INDEX_PROVIDER_UNAVAILABLE: 52850;
+    readonly VECTOR_INDEX_NOT_FOUND: 52851;
+    readonly VECTOR_INDEX_INVALID_VECTORS: 52852;
+    readonly VECTOR_INDEX_FAILED: 52853;
     readonly FILE_NOT_FOUND: 53000;
     readonly DOWNLOAD_CANCELLED: 53001;
     readonly CHECKSUM_VALIDATION_FAILED: 53002;

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

@@ -57,6 +57,11 @@ export const SDK_SERVER_ERROR_CODES = {
     RAG_LIST_WORKSPACES_FAILED: 52809,
     RAG_CHUNK_FAILED: 52810,
     RAG_WORKSPACE_NOT_OPEN: 52811,
+    // Vector index (52,850-52,899)
+    VECTOR_INDEX_PROVIDER_UNAVAILABLE: 52850,
+    VECTOR_INDEX_NOT_FOUND: 52851,
+    VECTOR_INDEX_INVALID_VECTORS: 52852,
+    VECTOR_INDEX_FAILED: 52853,
     // Download/Resource Errors (53,000-53,199)
     FILE_NOT_FOUND: 53000,
     DOWNLOAD_CANCELLED: 53001,
@@ -340,6 +345,23 @@ const serverErrorDefinitions = {
         name: 'RAG_WORKSPACE_NOT_OPEN',
         message: (workspace) => `RAG workspace '${workspace}' is not open`
     },
+    // Vector index (52,850-52,899)
+    [SDK_SERVER_ERROR_CODES.VECTOR_INDEX_PROVIDER_UNAVAILABLE]: {
+        name: 'VECTOR_INDEX_PROVIDER_UNAVAILABLE',
+        message: () => 'No vector index provider is registered. Register a plugin that exposes the turbovecIndexProvider capability, such as the built-in llamacpp-embedding plugin'
+    },
+    [SDK_SERVER_ERROR_CODES.VECTOR_INDEX_NOT_FOUND]: {
+        name: 'VECTOR_INDEX_NOT_FOUND',
+        message: (indexId) => `Vector index '${indexId}' is not open. It was disposed or the worker restarted; create a new index or load a snapshot`
+    },
+    [SDK_SERVER_ERROR_CODES.VECTOR_INDEX_INVALID_VECTORS]: {
+        name: 'VECTOR_INDEX_INVALID_VECTORS',
+        message: (details) => `Invalid vector input: ${details}`
+    },
+    [SDK_SERVER_ERROR_CODES.VECTOR_INDEX_FAILED]: {
+        name: 'VECTOR_INDEX_FAILED',
+        message: (details) => `Vector index operation failed: ${details}`
+    },
     // Download/Resource Errors (53,000-53,199)
     [SDK_SERVER_ERROR_CODES.FILE_NOT_FOUND]: {
         name: 'FILE_NOT_FOUND',

package/dist/src/utils/aggregate-events.d.ts

@@ -1,10 +1,12 @@
-import type { CompletionError, CompletionEvent, CompletionFinal, CompletionStats, StopReason, ToolCall } from '@qvac/inference/surface';
+import type { CompletionError, CompletionEvent, CompletionFinal, CompletionStats, StopReason, ToolCall, ToolCallError } from '@qvac/inference/surface';
 import { type ToolHandlerMap } from './tool-helpers.js';
 export type AggregatedEvents = {
     contentText: string;
     thinkingText: string;
     stats: CompletionStats | undefined;
     toolCalls: ToolCall[];
+    /** Tool-call regions that failed to parse or validate; see `CompletionFinal.toolErrors`. */
+    toolErrors: ToolCallError[];
     rawFullText: string | undefined;
     error: CompletionError | undefined;
     stopReason: StopReason | undefined;

package/dist/src/utils/aggregate-events.js

@@ -9,6 +9,7 @@ export function aggregateEvents(events) {
     let stopReason;
     let cancelled = false;
     const toolCalls = [];
+    const toolErrors = [];
     for (const event of events) {
         if (event.type === 'contentDelta') {
             contentText += event.text;
@@ -22,6 +23,9 @@ export function aggregateEvents(events) {
         else if (event.type === 'toolCall') {
             toolCalls.push(event.call);
         }
+        else if (event.type === 'toolError') {
+            toolErrors.push(event.error);
+        }
         else if (event.type === 'completionDone') {
             if ('raw' in event && event.raw) {
                 rawFullText = event.raw.fullText;
@@ -47,6 +51,7 @@ export function aggregateEvents(events) {
         thinkingText,
         stats,
         toolCalls,
+        toolErrors,
         rawFullText,
         error,
         stopReason,
@@ -54,7 +59,7 @@ export function aggregateEvents(events) {
     };
 }
 export function buildFinalFromEvents(events, handlers) {
-    const { contentText, thinkingText, stats, toolCalls, rawFullText, error, stopReason, cancelled } = aggregateEvents(events);
+    const { contentText, thinkingText, stats, toolCalls, toolErrors, rawFullText, error, stopReason, cancelled } = aggregateEvents(events);
     const attachedToolCalls = attachHandlersToToolCalls(toolCalls, handlers);
     const fullText = rawFullText ?? contentText;
     const cacheableAssistantContent = attachedToolCalls.length === 0 ? normalizeAssistantCacheContent(fullText) : undefined;
@@ -62,6 +67,7 @@ export function buildFinalFromEvents(events, handlers) {
         contentText,
         ...(thinkingText && { thinkingText }),
         toolCalls: attachedToolCalls,
+        ...(toolErrors.length > 0 && { toolErrors }),
         ...(stats && { stats }),
         raw: { fullText },
         ...(cacheableAssistantContent !== undefined && {

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

@@ -240,6 +240,18 @@ export declare class RAGUnknownOperationError extends QvacErrorBase {
 export declare class RAGHyperDBFailedError extends QvacErrorBase {
     constructor(details: string, cause?: unknown);
 }
+export declare class VectorIndexProviderUnavailableError extends QvacErrorBase {
+    constructor(cause?: unknown);
+}
+export declare class VectorIndexNotFoundError extends QvacErrorBase {
+    constructor(indexId: string, cause?: unknown);
+}
+export declare class VectorIndexInvalidVectorsError extends QvacErrorBase {
+    constructor(details: string, cause?: unknown);
+}
+export declare class VectorIndexFailedError extends QvacErrorBase {
+    constructor(details: string, cause?: unknown);
+}
 export declare class FileNotFoundError extends QvacErrorBase {
     constructor(path: string, cause?: unknown);
 }

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

@@ -375,6 +375,27 @@ export class RAGHyperDBFailedError extends QvacErrorBase {
         super(createErrorOptions(SDK_SERVER_ERROR_CODES.RAG_HYPERDB_FAILED, [details], cause));
     }
 }
+// ============== Vector Index Errors ==============
+export class VectorIndexProviderUnavailableError extends QvacErrorBase {
+    constructor(cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.VECTOR_INDEX_PROVIDER_UNAVAILABLE, undefined, cause));
+    }
+}
+export class VectorIndexNotFoundError extends QvacErrorBase {
+    constructor(indexId, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.VECTOR_INDEX_NOT_FOUND, [indexId], cause));
+    }
+}
+export class VectorIndexInvalidVectorsError extends QvacErrorBase {
+    constructor(details, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.VECTOR_INDEX_INVALID_VECTORS, [details], cause));
+    }
+}
+export class VectorIndexFailedError extends QvacErrorBase {
+    constructor(details, cause) {
+        super(createErrorOptions(SDK_SERVER_ERROR_CODES.VECTOR_INDEX_FAILED, [details], cause));
+    }
+}
 // ============== Download/Resource Errors ==============
 export class FileNotFoundError extends QvacErrorBase {
     constructor(path, cause) {

package/docs/system-resources-support-matrix.md

@@ -59,25 +59,25 @@ native value does not establish one, rather than inventing a scope.
 
 ## Metric behavior
 
-| Public metric                                | Accepted value                              | Source and scope when `supported`                                          | Current runtime evidence                                                                                    |
-| -------------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
-| `capabilities.cpu.value.logicalCores`        | Positive integer                            | `bare-cpu-info`; scope omitted                                             | `supported` on `darwin-arm64`                                                                               |
-| `sample.cpu`                                 | Number from 0 through 1                     | `bare-cpu-info`; `system`                                                  | `supported` on `darwin-arm64`                                                                               |
-| `capabilities.memory.totalBytes`             | Positive integer                            | `bare-cpu-info`; `system`                                                  | `supported` on `darwin-arm64`                                                                               |
-| `sample.memory.usedBytes`                    | Non-negative integer                        | `bare-cpu-info`; `system`                                                  | `supported` on `darwin-arm64`                                                                               |
-| `sample.memory.totalBytes`                   | Positive integer                            | `bare-cpu-info`; `system`                                                  | `supported` on `darwin-arm64`                                                                               |
-| `sample.memory.processUsedBytes`             | Non-negative integer                        | `bare-os`; `process`                                                       | `supported` where `bare-os` reports RSS                                                                     |
-| `sample.memory.processAvailableBytes`        | Non-negative integer                        | `bare-os`; `process`                                                       | `unavailable` everywhere — iOS needs a native `os_proc_available_memory` source before this reports a value |
-| `capabilities.gpus`                          | Array, including an empty array             | `bare-gpu-info`; scope omitted                                             | `supported` with one GPU on `darwin-arm64`                                                                  |
-| `capabilities.gpus.value[].memoryTotalBytes` | Non-negative number                         | `bare-gpu-info`; `device`, when not unified memory                         | `unverified` on `darwin-arm64` (unified)                                                                    |
-| `sample.gpus`                                | Array aligned with the cached GPU inventory | `bare-gpu-info`; scope omitted                                             | `supported` with one GPU sample on `darwin-arm64`                                                           |
-| `sample.gpus.value[].compute`                | Number from 0 through 1                     | `bare-gpu-info`; `device`                                                  | `supported` on `darwin-arm64`                                                                               |
-| `sample.gpus.value[].encode`                 | Number from 0 through 1                     | `bare-gpu-info`; `device`                                                  | `unavailable` on `darwin-arm64`                                                                             |
-| `sample.gpus.value[].decode`                 | Number from 0 through 1                     | `bare-gpu-info`; `device`                                                  | `unavailable` on `darwin-arm64`                                                                             |
-| `sample.gpus.value[].memoryUsedBytes`        | Non-negative number                         | `bare-gpu-info`; `device`, when the sample agrees with the declared memory | `unverified` on `darwin-arm64` (unified)                                                                    |
-| `sample.gpus.value[].memoryTotalBytes`       | Non-negative number                         | `bare-gpu-info`; `device`, when the sample agrees with the declared memory | `unverified` on `darwin-arm64` (unified)                                                                    |
-| `sample.gpus.value[].powerWatts`             | Non-negative number                         | `bare-gpu-info`; `device`                                                  | `unavailable` on `darwin-arm64`                                                                             |
-| `sample.gpus.value[].temperatureCelsius`     | Non-negative number                         | `bare-gpu-info`; `device`                                                  | `unavailable` on `darwin-arm64`                                                                             |
+| Public metric                                | Accepted value                              | Source and scope when `supported`                                          | Current runtime evidence                            |
+| -------------------------------------------- | ------------------------------------------- | -------------------------------------------------------------------------- | --------------------------------------------------- |
+| `capabilities.cpu.value.logicalCores`        | Positive integer                            | `bare-cpu-info`; scope omitted                                             | `supported` on `darwin-arm64`                       |
+| `sample.cpu`                                 | Number from 0 through 1                     | `bare-cpu-info`; `system`                                                  | `supported` on `darwin-arm64`                       |
+| `capabilities.memory.totalBytes`             | Positive integer                            | `bare-cpu-info`; `system`                                                  | `supported` on `darwin-arm64`                       |
+| `sample.memory.usedBytes`                    | Non-negative integer                        | `bare-cpu-info`; `system`                                                  | `supported` on `darwin-arm64`                       |
+| `sample.memory.totalBytes`                   | Positive integer                            | `bare-cpu-info`; `system`                                                  | `supported` on `darwin-arm64`                       |
+| `sample.memory.processUsedBytes`             | Non-negative integer                        | `bare-os`; `process`                                                       | `supported` where `bare-os` reports RSS             |
+| `sample.memory.processAvailableBytes`        | Non-negative integer                        | `bare-os`; `process`                                                       | `supported` on `ios-arm64`; `unavailable` elsewhere |
+| `capabilities.gpus`                          | Array, including an empty array             | `bare-gpu-info`; scope omitted                                             | `supported` with one GPU on `darwin-arm64`          |
+| `capabilities.gpus.value[].memoryTotalBytes` | Non-negative number                         | `bare-gpu-info`; `device`, when not unified memory                         | `unverified` on `darwin-arm64` (unified)            |
+| `sample.gpus`                                | Array aligned with the cached GPU inventory | `bare-gpu-info`; scope omitted                                             | `supported` with one GPU sample on `darwin-arm64`   |
+| `sample.gpus.value[].compute`                | Number from 0 through 1                     | `bare-gpu-info`; `device`                                                  | `supported` on `darwin-arm64`                       |
+| `sample.gpus.value[].encode`                 | Number from 0 through 1                     | `bare-gpu-info`; `device`                                                  | `unavailable` on `darwin-arm64`                     |
+| `sample.gpus.value[].decode`                 | Number from 0 through 1                     | `bare-gpu-info`; `device`                                                  | `unavailable` on `darwin-arm64`                     |
+| `sample.gpus.value[].memoryUsedBytes`        | Non-negative number                         | `bare-gpu-info`; `device`, when the sample agrees with the declared memory | `unverified` on `darwin-arm64` (unified)            |
+| `sample.gpus.value[].memoryTotalBytes`       | Non-negative number                         | `bare-gpu-info`; `device`, when the sample agrees with the declared memory | `unverified` on `darwin-arm64` (unified)            |
+| `sample.gpus.value[].powerWatts`             | Non-negative number                         | `bare-gpu-info`; `device`                                                  | `unavailable` on `darwin-arm64`                     |
+| `sample.gpus.value[].temperatureCelsius`     | Non-negative number                         | `bare-gpu-info`; `device`                                                  | `unavailable` on `darwin-arm64`                     |
 
 For GPU memory, a missing native value becomes `unavailable`. The native API
 does not identify the scope of a present value, so the SDK establishes it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/sdk",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -212,23 +212,23 @@
     "changelog:generate": "node ../../scripts/sdk/generate-changelog-sdk-pod.cjs --package=sdk && prettier --write changelog"
   },
   "dependencies": {
-    "@qvac/audiogen-ggml": "^0.3.2",
-    "@qvac/asr-ggml": "^0.3.1",
-    "@qvac/bci-whispercpp": "^0.8.0",
-    "@qvac/classification-ggml": "^0.23.0",
-    "@qvac/decoder-audio": "^0.5.0",
-    "@qvac/diffusion-cpp": "^0.21.0",
-    "@qvac/embed-llamacpp": "^0.37.0",
+    "@qvac/asr-ggml": "^0.5.3",
+    "@qvac/audiogen-ggml": "^0.4.0",
+    "@qvac/bci-whispercpp": "^0.9.1",
+    "@qvac/classification-ggml": "^0.26.1",
+    "@qvac/decoder-audio": "^0.6.0",
+    "@qvac/diffusion-cpp": "^0.24.0",
+    "@qvac/embed-llamacpp": "^0.41.1",
     "@qvac/error": "^0.1.1",
-    "@qvac/inference": "^0.19.0",
+    "@qvac/inference": "^0.20.0",
     "@qvac/langdetect-text": "^0.1.2",
-    "@qvac/llm-llamacpp": "^0.49.1",
+    "@qvac/llm-llamacpp": "^0.53.0",
     "@qvac/logging": "^0.1.0",
-    "@qvac/ocr-ggml": "^0.21.0",
+    "@qvac/ocr-ggml": "^0.24.1",
     "@qvac/registry-client": "^0.6.1",
-    "@qvac/translation-nmtcpp": "^0.13.0",
-    "@qvac/tts-ggml": "^0.8.0",
-    "@qvac/vla-ggml": "^0.24.0",
+    "@qvac/translation-nmtcpp": "^0.16.1",
+    "@qvac/tts-ggml": "^0.9.1",
+    "@qvac/vla-ggml": "^0.27.1",
     "bare-abort-controller": "^1.0.0",
     "bare-cpu-info": "0.1.1",
     "bare-crypto": "^1.15.0",
@@ -252,13 +252,16 @@
     "semver": "^7.8.0",
     "tar-stream": "^3.1.8",
     "which-runtime": "^1.3.2",
-    "zod": "^4.3.0"
+    "zod": "^4.3.0",
+    "bare-buffer": "^3.4.2"
   },
   "devDependencies": {
     "@electron-forge/plugin-base": "^7.11.1",
     "@expo/config-plugins": "^54.0.4",
+    "bare-module": "^6.2.0",
     "@lancedb/lancedb": "^0.21.3",
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "apache-arrow": "^18.1.0",
     "@sqliteai/sqlite-wasm": "3.50.4-sync.0.8.30-vector.0.9.23",
     "@types/brittle": "^3.5.0",
     "@types/node": "^24.2.1",
@@ -293,6 +296,7 @@
     "expo-build-properties": ">=0.12.0",
     "expo-device": ">=8.0.0",
     "expo-file-system": ">=19.0.0",
+    "expo-modules-core": ">=3.0.0",
     "pear-pipe": ">=1.0.0",
     "react-native-bare-kit": "*",
     "tsx": "*"
@@ -313,6 +317,9 @@
     "expo-file-system": {
       "optional": true
     },
+    "expo-modules-core": {
+      "optional": true
+    },
     "pear-pipe": {
       "optional": true
     },