@qvac/sdk 0.19.1 → 0.20.1

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

@@ -13,13 +13,19 @@ const { withDangerousMod } = configPlugins;
 /** Modules to defer from mobile bundles (not available at bundle time) */
 const DEFERRED_MODULES = ['expo-file-system', 'react-native-bare-kit'];
 /**
- * Desktop-only modules deferred so bare-pack stops walking into them. They back
- * the advisory fit check, which mobile refuses at runtime, but the imports are
- * static and pull in `bare-process` -> `bare-posix`, which ships no
- * `android-arm64` prebuild and fails bundle verification.
+ * 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 = ['android-arm64', 'ios-arm64', 'ios-arm64-simulator', 'ios-x64-simulator'];
+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.
  *
@@ -43,9 +49,13 @@ function withMobileBundle(config) {
             ...MOBILE_UNSUPPORTED_MODULES,
             `${sdkPackage.name}/worker.mobile.bundle`
         ];
-        const linkerPaths = await runBundler(projectRoot, sdkPackage.dir, configPath, deferredModules);
+        // 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);
@@ -57,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) {
@@ -67,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 ' +
@@ -76,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
     });
@@ -131,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, MOBILE_UNSUPPORTED_MODULES, 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/sdk",
-  "version": "0.19.1",
+  "version": "0.20.1",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -212,23 +212,22 @@
     "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.1",
+    "@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/registry-client": "^0.6.1",
-    "@qvac/translation-nmtcpp": "^0.13.0",
-    "@qvac/tts-ggml": "^0.8.0",
-    "@qvac/vla-ggml": "^0.24.0",
+    "@qvac/ocr-ggml": "^0.24.1",
+    "@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 +251,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",
@@ -281,7 +283,7 @@
     "pear-pipe": "^1.0.6",
     "prettier": "^3.9.4",
     "prettier-config-holepunch": "^2.0.0",
-    "react-native-bare-kit": "^0.14.0",
+    "react-native-bare-kit": "^0.15.5",
     "tsc-alias": "^1.8.17",
     "tsx": "4.23.1",
     "typescript": "^5.9.3",
@@ -293,6 +295,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 +316,9 @@
     "expo-file-system": {
       "optional": true
     },
+    "expo-modules-core": {
+      "optional": true
+    },
     "pear-pipe": {
       "optional": true
     },

package/src/electron-forge/index.cjs

@@ -2,8 +2,8 @@
  * @qvac/sdk/electron-forge
  *
  * Electron Forge plugin: bundles the QVAC worker, verifies its native addons,
- * then configures Electron Packager to tree-shake unused @qvac/* addons and
- * non-target prebuilds.
+ * then configures Electron Packager to tree-shake unused @qvac/* addons (along
+ * with their per-platform prebuild packages) and non-target prebuilds.
  *
  * macOS universal (`arch: "universal"`) is not supported — native addon
  * prebuilds are arch-specific. Build darwin-arm64 and darwin-x64 separately.
@@ -146,16 +146,45 @@ function findQvacScopeDir(startDir) {
 }
 
 /**
- * Discovers installed @qvac addon packages by scanning node_modules/@qvac
- * for packages that have `addon: true` in package.json.
+ * Reads the addon a per-platform prebuild package ships binaries for.
+ *
+ * Addons that split their prebuilds (`@qvac/tts-ggml` since 0.9.0, along with
+ * `@qvac/asr-ggml` 0.5.0 and `@qvac/audiogen-ggml` 0.4.0) publish the host's
+ * `.bare` in `@qvac/<addon>-<host>` (iOS flavours grouped as
+ * `@qvac/<addon>-ios`). Those packages carry no top-level `addon: true`;
+ * instead they embed an inner `addon/` package named after the meta addon.
+ * Returns that addon name, or null when `pkgDir` is not a platform package.
+ * Exposed for unit testing.
+ */
+function readPlatformPackageAddon(pkgDir) {
+  const addonPkgJsonPath = path.join(pkgDir, 'addon', 'package.json')
+  if (!fs.existsSync(addonPkgJsonPath)) return null
+
+  try {
+    const pkg = JSON.parse(fs.readFileSync(addonPkgJsonPath, 'utf8'))
+    if (pkg.addon === true && typeof pkg.name === 'string' && pkg.name.length > 0) {
+      return pkg.name
+    }
+  } catch (err) {
+    logger.warn(`Failed to parse ${addonPkgJsonPath}: ${err.message}`)
+  }
+  return null
+}
+
+/**
+ * Discovers installed @qvac packages by scanning node_modules/@qvac: the
+ * addons (`addon: true` in package.json) and the per-platform prebuild
+ * packages, each mapped to the addon it belongs to.
  */
 function discoverQvacAddonPackages(projectDir) {
+  const nothing = { addons: [], platformPackages: [] }
+
   let scopeDir
   try {
     scopeDir = findQvacScopeDir(projectDir)
   } catch (err) {
     logger.warn(err.message)
-    return []
+    return nothing
   }
 
   let entries
@@ -163,10 +192,11 @@ function discoverQvacAddonPackages(projectDir) {
     entries = fs.readdirSync(scopeDir)
   } catch (err) {
     logger.fsError('discoverQvacAddonPackages', err)
-    return []
+    return nothing
   }
 
-  const discovered = []
+  const addons = []
+  const platformPackages = []
 
   for (const name of entries) {
     const pkgDir = path.join(scopeDir, name)
@@ -175,18 +205,25 @@ function discoverQvacAddonPackages(projectDir) {
     const pkgJsonPath = path.join(pkgDir, 'package.json')
     if (!fs.existsSync(pkgJsonPath)) continue
 
+    const packageName = `@qvac/${name}`
     try {
       const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf8'))
       if (pkg.addon === true) {
-        discovered.push(`@qvac/${name}`)
+        addons.push(packageName)
+        continue
       }
     } catch (err) {
       logger.warn(`Failed to parse ${pkgJsonPath}: ${err.message}`)
+      continue
     }
+
+    const addon = readPlatformPackageAddon(pkgDir)
+    if (addon !== null) platformPackages.push({ name: packageName, addon })
   }
 
-  discovered.sort()
-  return discovered
+  addons.sort()
+  platformPackages.sort((a, b) => a.name.localeCompare(b.name))
+  return { addons, platformPackages }
 }
 
 /**
@@ -203,20 +240,36 @@ function diffAddons(installed, required) {
 }
 
 /**
- * Computes the list of installed @qvac addons that aren't in `required`.
+ * Pure diff: per-platform prebuild packages whose addon is not in the
+ * required set. A platform package ships only its addon's binaries, so it
+ * follows that addon's include/exclude decision.
+ * Exposed for unit testing.
+ */
+function diffPlatformPackages(platformPackages, required) {
+  const requiredSet = new Set(required)
+  const exclusions = []
+  for (const { name, addon } of platformPackages) {
+    if (!requiredSet.has(addon)) exclusions.push(name)
+  }
+  return exclusions
+}
+
+/**
+ * Computes the list of installed @qvac addons that aren't in `required`,
+ * plus the per-platform prebuild packages of those excluded addons.
  * Logs include/exclude decisions for each discovered package.
  */
 function computeExclusions(required, projectDir) {
-  const installed = discoverQvacAddonPackages(projectDir)
+  const { addons, platformPackages } = discoverQvacAddonPackages(projectDir)
 
-  if (installed.length === 0) {
+  if (addons.length === 0) {
     logger.warn('No @qvac addon packages discovered. Skipping addon exclusions.')
     return []
   }
 
   const requiredSet = new Set(required)
   const exclusions = []
-  for (const pkg of installed) {
+  for (const pkg of addons) {
     if (requiredSet.has(pkg)) {
       logger.info(`Including required addon: ${pkg}`)
     } else {
@@ -224,6 +277,14 @@ function computeExclusions(required, projectDir) {
       exclusions.push(pkg)
     }
   }
+  for (const { name, addon } of platformPackages) {
+    if (requiredSet.has(addon)) {
+      logger.info(`Including platform package ${name} (prebuilds for ${addon})`)
+    } else {
+      logger.info(`Excluding platform package ${name} (prebuilds for unused addon ${addon})`)
+      exclusions.push(name)
+    }
+  }
   return exclusions
 }
 
@@ -594,6 +655,15 @@ async function runBundleAndVerify(commands, projectDir, options) {
     )
   }
 
+  // Narrowed prebuild checks are otherwise invisible in the log.
+  const narrowed = verifyResult.addons.filter(
+    (addon) => Array.isArray(addon.linkedHosts) && addon.linkedHosts.length < hosts.length
+  )
+  for (const addon of narrowed) {
+    const where = addon.linkedHosts.length === 0 ? 'no host' : addon.linkedHosts.join(', ')
+    logger.info(`verifyBundle: ${addon.name}@${addon.version} is linked on ${where}`)
+  }
+
   return bundleResult
 }
 
@@ -772,6 +842,8 @@ module.exports.QvacForgePluginError = QvacForgePluginError
 // Internal helpers exposed for unit tests. Not part of the stable API.
 module.exports.createIgnore = createIgnore
 module.exports.diffAddons = diffAddons
+module.exports.diffPlatformPackages = diffPlatformPackages
+module.exports.readPlatformPackageAddon = readPlatformPackageAddon
 module.exports.detectTargetHosts = detectTargetHosts
 module.exports.resolveHosts = resolveHosts
 module.exports.runBundleAndVerify = runBundleAndVerify