@qvac/sdk 0.10.2 → 0.11.0

package/dist/expo/plugins/withMobileBundle.js

@@ -3,6 +3,7 @@ import { execSync } from "child_process";
 import * as fs from "fs";
 import * as path from "path";
 import { resolveSDKPackageDir } from "./resolve-sdk-package-dir.js";
+import { BundleVerificationFailedError } from "../../utils/errors-client.js";
 const { withDangerousMod } = configPlugins;
 const CONFIG_CANDIDATES = [
     "qvac.config.json",
@@ -18,11 +19,11 @@ const MOBILE_HOSTS = [
     "ios-x64-simulator",
 ];
 /**
- * Expo plugin that automatically generates the mobile worker bundle during build.
+ * Expo plugin: bundle, verify, then copy the mobile worker bundle.
  *
- * Runs qvac CLI (prefers local @qvac/cli, falls back to npx).
- * Uses qvac.config.* if exists, else includes all built-in plugins.
- * Output: node_modules/<sdk-package>/dist/worker.mobile.bundle.js
+ * Flow: `bundle sdk` -> assert `qvac/worker.bundle.js` exists ->
+ * `verify bundle` -> copy to `<sdkPackageDir>/dist/worker.mobile.bundle.js`.
+ * Requires a local `@qvac/cli` install. Uses `qvac.config.*` if present.
  */
 function withMobileBundle(config) {
     function buildMobileBundle(config) {
@@ -49,8 +50,10 @@ function withMobileBundle(config) {
             throw new Error(`QVAC: Bundle generation failed — ${generatedBundle} not found. ` +
                 `Check qvac CLI output above for errors.`);
         }
+        // Verify before copying so the dist artifact only updates on success.
+        runVerifier(projectRoot, generatedBundle, configPath);
         fs.copyFileSync(generatedBundle, outputPath);
-        console.log("🫡 QVAC: Mobile bundle generated");
+        console.log("🫡 QVAC: Mobile bundle generated and verified");
         return config;
     }
     config = withDangerousMod(config, ["android", buildMobileBundle]);
@@ -73,7 +76,7 @@ function findConfigFile(projectRoot) {
  * Prefers local @qvac/cli installation for version consistency,
  * falls back to npx for convenience when CLI is not installed.
  */
-function resolveCliCommand(projectRoot) {
+export function resolveCliCommand(projectRoot) {
     const cliPath = path.join(projectRoot, "node_modules", "@qvac", "cli", "dist", "index.js");
     if (fs.existsSync(cliPath)) {
         return `node "${cliPath}"`;
@@ -82,6 +85,40 @@ function resolveCliCommand(projectRoot) {
     console.log("   Tip: Add @qvac/cli as a dependency for consistent versioning");
     return "npx --package=@qvac/cli qvac";
 }
+/** Builds the `qvac verify bundle` command string (pure helper for tests). */
+export function buildVerifyBundleCommand(opts) {
+    const hostFlags = opts.hosts.map((h) => `--host ${h}`).join(" ");
+    const configFlag = opts.configPath ? ` --config "${opts.configPath}"` : "";
+    return `${opts.cliCommand} verify bundle --addons-source "${opts.bundlePath}" ${hostFlags}${configFlag}`;
+}
+/**
+ * Runs `qvac verify bundle` against the freshly generated worker bundle.
+ * Passes the discovered `qvac.config.*` so the CLI reads `bareRuntimeVersion`
+ * and pins ABI checks deterministically. Without a config, the CLI falls back
+ * to auto-detecting Bare runtime from `node_modules` (`bare-runtime`, then
+ * `bare`); ABI checks stay strict when that lookup succeeds, and only skip
+ * (with an `unknown-runtime-version` warning) when neither is installed.
+ */
+function runVerifier(projectRoot, generatedBundle, configPath) {
+    const cliCommand = resolveCliCommand(projectRoot);
+    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 verifyCommand = buildVerifyBundleCommand({
+        cliCommand,
+        bundlePath: generatedBundle,
+        hosts: MOBILE_HOSTS,
+        ...(configPath ? { configPath } : {}),
+    });
+    try {
+        execSync(verifyCommand, { stdio: "inherit", cwd: projectRoot });
+    }
+    catch (error) {
+        throw new BundleVerificationFailedError(generatedBundle, error);
+    }
+}
 /** Runs qvac CLI with mobile-specific options */
 function runBundler(projectRoot, qvacSdkPath, configPath, deferredModules) {
     // Patch bare-kit linkers to use addons manifest
@@ -138,4 +175,5 @@ function patchBareKitLinkers(projectRoot, qvacSdkPath) {
         console.log(`⚠️ QVAC: iOS linker patch not found (${iosPatch})`);
     }
 }
+export { MOBILE_HOSTS };
 export default withMobileBundle;

package/dist/index.d.ts

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

package/dist/index.js

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