@qvac/sdk 0.8.0 → 0.8.2

package/README.md

@@ -1,9 +1,3 @@
-[![QVAC logo](docs/logo.avif)](https://qvac.tether.dev)
-
----
-
-**QVAC** is an open-source, cross-platform **ecosystem** for local-first, peer-to-peer **AI**. QVAC runs on [**Bare**](https://bare.pears.com) by [Holepunch](https://holepunch.to), a lightweight, cross-platform JavaScript runtime.
-
 # QVAC SDK
 
 **QVAC SDK** is the canonical entry point to develop AI applications with QVAC.
@@ -11,140 +5,73 @@
 > _Part of **QVAC** ecosystem_
 > <br>
 > <sup>
-> <a href="https://qvac.tether.dev" >Home</a> &nbsp;•&nbsp;
-> <a href="https://qvac.tether.dev/docs" >Docs</a> &nbsp;•&nbsp;
-> <a href="https://qvacbytether.featurebase.app" >Support</a> &nbsp;•&nbsp;
+> <a href="https://qvac.tether.io/" >Home</a> &nbsp;•&nbsp;
+> <a href="https://docs.qvac.tether.io/" >Docs</a> &nbsp;•&nbsp;
+> <a href="https://discord.com/channels/1425125849346216029/1445400675189264516" >Support</a> &nbsp;•&nbsp;
 > <a href="https://discord.com/invite/tetherdev" >Discord</a>
-> </sup>
-
-Written in TypeScript, it provides all QVAC capabilities through a unified interface while also abstracting away the complexity of running your application in a JS environment other than Bare.
 
-For the comprehensive reference, [see official QVAC documentation](https://qvac.tether.dev/docs).
+**QVAC SDK** is the main entry point for developing applications with QVAC. It is type-safe and exposes all QVAC capabilities through a unified interface. It runs on Node.js, [Bare runtime](https://bare.pears.com), and [Expo](https://expo.dev).
 
-## Requirements
+See [https://docs.qvac.tether.io/sdk/getting-started](https://docs.qvac.tether.io/sdk/getting-started) for the comprehensive QVAC documentation.
 
-Supported JS environments: Bare, Node.js, Expo and Bun.
+## Supported environments and installation
 
-## Installation
-
-```bash
-npm install @qvac/sdk
-```
+See https://docs.qvac.tether.io/sdk/getting-started/installation
 
-### Linux
+## Quickstart
 
-OS peer dependency:
+1. Create the examples workspace:
 
 ```bash
-apt install vulkan-sdk
+mkdir qvac-examples
+cd qvac-examples
+npm init -y && npm pkg set type=module
 ```
 
-### Expo
-
-1. Peer dependencies:
+2. Install the SDK:
 
 ```bash
-npm i expo-file-system react-native-bare-kit
-```
-
-2. On Android, bump `minSdkVersion` to 29, by adding `ext { minSdkVersion=29 }` to `android/build.gradle` or using `expo-build-properties`.
-
-3. Add the QVAC Expo plugin to `app.json`:
-
-```js
-export default {
-  expo: {
-    plugins: ["@qvac/sdk/expo-plugin"],
-  },
-};
-```
-
-4. Prebuild your project to generate the native files:
-
-```bash
-npx expo prebuild
-```
-
-5. Build and run it on a **physical device**:
-
-```bash
-npx expo run:ios --device
-# or
-npx expo run:android --device
+npm install @qvac/sdk
 ```
 
-> [!IMPORTANT]  
-> Due to limitations with `llamacpp`, QVAC currently does not run on emulators. You **must** use a physical device.
-
-## Usage
+3. Create the quickstart script:
 
 ```js
-import {
-  completion,
-  LLAMA_3_2_1B_INST_Q4_0,
-  loadModel,
-  downloadAsset,
-  unloadModel,
-  VERBOSITY,
-} from "@qvac/sdk";
+import { loadModel, LLAMA_3_2_1B_INST_Q4_0, completion, unloadModel, } from "@qvac/sdk";
 try {
-  // First just cache the model
-  await downloadAsset({
-    assetSrc: LLAMA_3_2_1B_INST_Q4_0,
-    onProgress: (progress) => {
-      console.log(progress);
-    },
-  });
-  // Then load it in memory from cache
-  const modelId = await loadModel({
-    modelSrc: LLAMA_3_2_1B_INST_Q4_0,
-    modelType: "llm",
-    modelConfig: {
-      device: "gpu",
-      ctx_size: 2048,
-      verbosity: VERBOSITY.ERROR,
-    },
-  });
-  const history = [
-    {
-      role: "user",
-      content: "Explain quantum computing in one sentence, use lots of emojis",
-    },
-  ];
-  const result = completion({ modelId, history, stream: true });
-  for await (const token of result.tokenStream) {
-    process.stdout.write(token);
-  }
-  const stats = await result.stats;
-  console.log("\n📊 Performance Stats:", stats);
-  // Change `clearStorage: true` to delete cached model files
-  await unloadModel({ modelId, clearStorage: false });
-} catch (error) {
-  console.error("❌ Error:", error);
-  process.exit(1);
+    // Load a model into memory
+    const modelId = await loadModel({
+        modelSrc: LLAMA_3_2_1B_INST_Q4_0,
+        modelType: "llm",
+        onProgress: (progress) => {
+            console.log(progress);
+        },
+    });
+    // You can use the loaded model multiple times
+    const history = [
+        {
+            role: "user",
+            content: "Explain quantum computing in one sentence",
+        },
+    ];
+    const result = completion({ modelId, history, stream: true });
+    for await (const token of result.tokenStream) {
+        process.stdout.write(token);
+    }
+    // Unload model to free up system resources
+    await unloadModel({ modelId });
+}
+catch (error) {
+    console.error("❌ Error:", error);
+    process.exit(1);
 }
 ```
 
-## Functionalities
-
-### AI tasks
+4. Run the quickstart script:
 
-- Completion: LLM inference via [`llama.cpp`](https://github.com/ggml-org/llama.cpp).
-- Transcription: speech-to-text (ASR) via [`whisper.cpp`](https://github.com/ggml-org/whisper.cpp).
-- Text embeddings: via `llama.cpp`, for RAG.
-- Translation: between different languages.
-- Text-to-Speech: TTS via ONNX.
-- Multimodal: via [`llama.cpp`] — i.e., process and understand multiple types of media within the same conversation context.
-- RAG: retrieval-augmented generation with progress streaming, cancellation, and workspace management.
-- Delegated inference: perform peer-to-peer edge inference via Holepunch stack.
-
-### Utilities
-
-- Configuration: customize SDK behavior via config files (`qvac.config.json`, `.js`, or `.ts`).
-- Logging: visibility into what's happening inside your models during loading, inference, and other operations.
-- Download Lifecycle: pause and resume model downloads.
-- Blind Relays: establish peer connections through NAT/firewalls by routing traffic through relay nodes.
-- Sharded models: download a model that is sharded into multiple parts.
+```bash
+node quickstart.js
+```
 
 ## Examples
 
@@ -164,161 +91,27 @@ node dist/examples/path/to/example.js
 bun run examples/path/to/example.ts
 ```
 
-### Completion
-
-- `llama.cpp` with local files: [`examples/llamacpp-filesystem.ts`](examples/llamacpp-filesystem.ts)
-- `llama.cpp` with Hyperdrive: [`examples/llamacpp-hyperdrive.ts`](examples/llamacpp-hyperdrive.ts)
-- `llama.cpp` with HTTP: [`examples/llamacpp-http.ts`](examples/llamacpp-http.ts)
-- `llama.cpp` with tools/function calls: [`examples/llamacpp-native-tools.ts`](examples/llamacpp-native-tools.ts)
-- `llama.cpp` with multimodal inference: [`examples/llamacpp-multimodal.ts`](examples/llamacpp-multimodal.ts)
-- `llama.cpp` with KV cache: [`examples/kv-cache-example.ts`](examples/kv-cache-example.ts)
-
-### Transcription
-
-- `whisper.cpp` transcription: [`examples/whispercpp-filesystem.ts`](examples/whispercpp-filesystem.ts)
-- Microphone recording: [`examples/whispercpp-microphone-record.ts`](examples/whispercpp-microphone-record.ts)
-
-### Embeddings
-
-- Single and batch embeddings: [`examples/embed-hyperdrive.ts`](examples/embed-hyperdrive.ts)
-
-**RAG with HyperDB** (cross-platform):
-
-- Ingest (full pipeline): [`examples/rag/rag-hyperdb/ingest.ts`](examples/rag/rag-hyperdb/ingest.ts)
-- Segregated pipeline: [`examples/rag/rag-hyperdb/pipeline.ts`](examples/rag/rag-hyperdb/pipeline.ts) _(Segregated flow: chunk → embed → save)_
-- Workspaces: [`examples/rag/rag-hyperdb/workspaces.ts`](examples/rag/rag-hyperdb/workspaces.ts) _(Workspace lifecycle: list, close, delete)_
-- Cancellation: [`examples/rag/rag-hyperdb/cancellation.ts`](examples/rag/rag-hyperdb/cancellation.ts) _(progress + cancel)_
-
-**RAG with other backends** (desktop only):
-
-- LanceDB: [`examples/rag/rag-lancedb.ts`](examples/rag/rag-lancedb.ts)
-- ChromaDB: [`examples/rag/rag-chromadb.ts`](examples/rag/rag-chromadb.ts) _(requires ChromaDB server)_
-- SQLite-Vector: [`examples/rag/rag-sqlite.ts`](examples/rag/rag-sqlite.ts) _(SQLite-Vector WASM)_
-
-### Translation
-
-- Marian OPUS translation: [`examples/translation/translation-opus.ts`](examples/translation/translation-opus.ts)
-- Indic language translation: [`examples/translation/translation-indic.ts`](examples/translation/translation-indic.ts)
-- LLM-based translation: [`examples/translation/translation-llm.ts`](examples/translation/translation-llm.ts)
-
-### Text-to-Speech
-
-- TTS (Chatterbox): [`examples/tts/chatterbox.ts`](examples/tts/chatterbox.ts) _(voice cloning with reference audio)_
-- TTS (Supertonic): [`examples/tts/supertonic.ts`](examples/tts/supertonic.ts) _(general-purpose, no voice cloning)_
-
-### Multimodel
-
-- Load multiple models simultaneously: [`examples/multi-model-demo.ts`](examples/multi-model-demo.ts)
-
-### Delegated inference
-
-- Provider: [`examples/delegated-inference/provider.ts`](examples/delegated-inference/provider.ts)
-- Consumer: [`examples/delegated-inference/consumer.ts`](examples/delegated-inference/consumer.ts)
-
-> [!TIP]
-> Set `QVAC_HYPERSWARM_SEED` env var to ensure that the provider uses the same keypair (i.e., public key doesn't change on every run).
-
-> [!NOTE]
-> Consumer does not handle reconnection yet.
-
-### Logging
-
-Stream real-time logs from the SDK server and native addons:
-
-```ts
-import { loggingStream, SDK_LOG_ID } from "@qvac/sdk";
+## Build
 
-// SDK server logs (general operations)
-for await (const log of loggingStream({ id: SDK_LOG_ID })) {
-  console.log(`[${log.level}] ${log.namespace}: ${log.message}`);
-}
+Use the [Bun](https://bun.sh/) package manager:
 
-// Addon logs per model (llamacpp, whispercpp, etc.)
-for await (const log of loggingStream({ id: modelId })) {
-  console.log(`[${log.level}] ${log.namespace}: ${log.message}`);
-}
+```bash
+bun i
 ```
 
-- Log streaming: [`examples/logging-streaming.ts`](examples/logging-streaming.ts)
-- Log with custom file transport: [`examples/logging-file-transport.ts`](examples/logging-file-transport.ts)
-
-### Configuration
-
-Customize SDK behavior using a config file. The SDK auto-discovers `qvac.config.{json,js,ts}` in your project root, or you can specify a path via `QVAC_CONFIG_PATH` environment variable.
-
-**Supported formats:**
-
-- `qvac.config.json` - JSON format
-- `qvac.config.js` - JavaScript with `export default`
-- `qvac.config.ts` - TypeScript with `export default`
-
-**Available options:**
-
-| Option                    | Type       | Default          | Description                                         |
-| ------------------------- | ---------- | ---------------- | --------------------------------------------------- |
-| `cacheDirectory`          | `string`   | `~/.qvac/models` | Where models and assets are stored                  |
-| `swarmRelays`             | `string[]` | `[]`             | Hyperswarm relay public keys for P2P                |
-| `loggerLevel`             | `string`   | `"info"`         | Log level: `"error"`, `"warn"`, `"info"`, `"debug"` |
-| `loggerConsoleOutput`     | `boolean`  | `true`           | Enable/disable console output                       |
-| `httpDownloadConcurrency` | `number`   | `3`              | Max concurrent HTTP downloads for sharded models    |
-| `httpConnectionTimeoutMs` | `number`   | `10000`          | HTTP connection timeout in milliseconds             |
-
-- Config usage example: [`examples/default-config-usage.ts`](examples/default-config-usage.ts)
-
-### Download Lifecycle
-
-- Pause and resume download: [`examples/download-with-cancel.ts`](examples/download-with-cancel.ts)
-
-### Blind Relays
-
-Blind relays help establish peer connections through NAT/firewalls by routing traffic through relay nodes.
-
-- Model downloads via Hyperdrive: [`examples/download-with-blind-relays.ts`](./examples/download-with-blind-relays.ts)
-- Delegated inference: You can reuse the same pattern for delegated inference by adding `swarmRelays` to your config file before starting your provider/consumer.
-
-> [!NOTE]
-> The examples use mock relay keys. For real deployments, you **must** use your own relay servers or trusted public relays.
-
-### Sharded Models
-
-Sharded models are split into multiple files following the pattern: `<name>-00001-of-0000X.<ext>`. The SDK automatically downloads and loads all parts with detailed progress tracking.
-
-**Supported formats:**
-
-- Archives (`.tar`, `.tar.gz`, `.tgz`): HTTP or local with automatic extraction
-- HTTP sharded URL: pass the download URL of any shard and the SDK will fetch the remaining shards
-- Hyperdrive: use any sharded Hyperdrive model source
-- Local shards: pass the path to any shard file. _(Note: All shards must be in the same directory)_
-
-See: [`examples/llamacpp-sharded.ts`](examples/llamacpp-sharded.ts)
-
-## Basic flow
-
-```mermaid
-sequenceDiagram
-    participant User as User
-    participant SDK as QVAC SDK
-    participant RPC as RPC Client (singleton)
-    participant Worker as Bare Worker (singleton)
-
-    User->>SDK: Call loadModel("llama-3", options)
-    SDK->>RPC: Create runtime-specific RPC client
-    RPC->>Worker: Spawn worker (if needed) and send loadModel request
-    Worker->>Worker: Download and load model into memory
-    Worker->>RPC: Return success response
-    RPC->>SDK: Model loaded successfully
-    SDK->>User: loadModel() resolves with modelId
+```bash
+bun run build  # or `watch` for hotreload
 ```
 
-**Note**: The example uses mock relay keys. In real deployments, you **must** use your own relay servers or trusted public relays.
-
-### Hot Config Reload
-
-Hot config reload allows you to update model configurations on-the-fly without unloading the model. Pass `modelId` (instead of `modelSrc`) to `loadModel` with the `modelType` and new `modelConfig` to apply changes instantly.
+```bash
+bun run build:pack
+```
 
-- Config reload using whisper: [`examples/config-reload.ts`](examples/config-reload.ts)
+This outputs a tarball under `dist/sdk-{version}.tgz` that you can install in your project, e.g.:
 
-**Note**: Config reload is currently supported for Whisper models. All config parameters except `contextParams` (GPU settings, flash attention) can be hot reloaded. `contextParams` are load-time only and require full model reload. More model types coming soon.
+```bash
+npm i path/to/sdk-0.3.0.tgz
+```
 
 ## Contributing
 
@@ -459,32 +252,3 @@ This will:
 4. Generate `changelog/<version>/CHANGELOG.md`
 5. Generate `changelog/<version>/breaking.md` for BC changes (with code examples)
 6. Generate `changelog/<version>/api.md` for API changes (with code examples)
-
-**Note:** Requires a GitHub token (`GITHUB_TOKEN` or `GH_TOKEN` environment variable) to fetch PR metadata.
-
-## Build
-
-Use the [Bun](https://bun.sh/) package manager:
-
-```bash
-bun i
-```
-
-```bash
-bun run build  # or `watch` for hotreload
-```
-
-```bash
-bun run build:pack
-```
-
-This outputs a tarball under `dist/sdk-{version}.tgz` that you can install in your project, e.g.:
-
-```bash
-npm i path/to/sdk-0.3.0.tgz
-```
-
-## More Resources
-
-- [Comprehensive documentation of this SDK](https://qvac.tether.dev/docs/sdk)
-- [Package at NPM](https://www.npmjs.com/package/@qvac/sdk)

package/dist/client/api/cancel.d.ts

@@ -7,6 +7,7 @@ import { type CancelParams } from "../../schemas/index";
  * @param params.modelId - The model ID (required for inference cancellation)
  * @param params.downloadKey - The download key (required for download cancellation)
  * @param params.clearCache - If true, deletes the partial download file (default: false)
+ * @param params.delegate - Delegation target for remote download cancellation (optional)
  * @param params.workspace - The RAG workspace to cancel (optional, defaults to "default")
  * @throws {QvacErrorBase} When the response type is invalid or when the cancellation fails
  *
@@ -23,6 +24,14 @@ import { type CancelParams } from "../../schemas/index";
  * await cancel({ operation: "downloadAsset", downloadKey: "download-key", clearCache: true });
  *
  * @example
+ * // Cancel delegated remote download
+ * await cancel({
+ *   operation: "downloadAsset",
+ *   downloadKey: "download-key",
+ *   delegate: { topic: "topicHex", providerPublicKey: "peerHex" },
+ * });
+ *
+ * @example
  * // Cancel RAG operation on default workspace
  * await cancel({ operation: "rag" });
  *

package/dist/client/api/cancel.js

@@ -9,6 +9,7 @@ import { InvalidResponseError, CancelFailedError } from "../../utils/errors-clie
  * @param params.modelId - The model ID (required for inference cancellation)
  * @param params.downloadKey - The download key (required for download cancellation)
  * @param params.clearCache - If true, deletes the partial download file (default: false)
+ * @param params.delegate - Delegation target for remote download cancellation (optional)
  * @param params.workspace - The RAG workspace to cancel (optional, defaults to "default")
  * @throws {QvacErrorBase} When the response type is invalid or when the cancellation fails
  *
@@ -25,6 +26,14 @@ import { InvalidResponseError, CancelFailedError } from "../../utils/errors-clie
  * await cancel({ operation: "downloadAsset", downloadKey: "download-key", clearCache: true });
  *
  * @example
+ * // Cancel delegated remote download
+ * await cancel({
+ *   operation: "downloadAsset",
+ *   downloadKey: "download-key",
+ *   delegate: { topic: "topicHex", providerPublicKey: "peerHex" },
+ * });
+ *
+ * @example
  * // Cancel RAG operation on default workspace
  * await cancel({ operation: "rag" });
  *

package/dist/client/api/heartbeat.d.ts

@@ -0,0 +1,30 @@
+import { type HeartbeatResponse } from "../../schemas/index";
+import type { DelegateBase } from "../../schemas/delegate";
+/**
+ * Checks if a delegated provider is online by sending a heartbeat round-trip.
+ * Can also be used to check if the local SDK worker is responsive.
+ *
+ * @param params - Delegation target to check
+ * @param params.delegate - The provider to check (topic + publicKey + optional timeout)
+ * @returns A promise that resolves to a heartbeat response if the provider is reachable.
+ * @throws {QvacErrorBase} When the provider is unreachable or the response is invalid.
+ *
+ * @example
+ * // Check if a delegated provider is online
+ * try {
+ *   await heartbeat({
+ *     delegate: { topic: "topicHex", providerPublicKey: "peerHex", timeout: 3000 },
+ *   });
+ *   console.log("Provider is online");
+ * } catch {
+ *   console.log("Provider is offline");
+ * }
+ *
+ * @example
+ * // Check if the local SDK worker is responsive
+ * await heartbeat();
+ */
+export declare function heartbeat(params?: {
+    delegate?: DelegateBase;
+}): Promise<HeartbeatResponse>;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/client/api/heartbeat.js

@@ -0,0 +1,38 @@
+import {} from "../../schemas/index.js";
+import { send } from "../rpc/rpc-client.js";
+import { InvalidResponseError } from "../../utils/errors-client.js";
+/**
+ * Checks if a delegated provider is online by sending a heartbeat round-trip.
+ * Can also be used to check if the local SDK worker is responsive.
+ *
+ * @param params - Delegation target to check
+ * @param params.delegate - The provider to check (topic + publicKey + optional timeout)
+ * @returns A promise that resolves to a heartbeat response if the provider is reachable.
+ * @throws {QvacErrorBase} When the provider is unreachable or the response is invalid.
+ *
+ * @example
+ * // Check if a delegated provider is online
+ * try {
+ *   await heartbeat({
+ *     delegate: { topic: "topicHex", providerPublicKey: "peerHex", timeout: 3000 },
+ *   });
+ *   console.log("Provider is online");
+ * } catch {
+ *   console.log("Provider is offline");
+ * }
+ *
+ * @example
+ * // Check if the local SDK worker is responsive
+ * await heartbeat();
+ */
+export async function heartbeat(params) {
+    const request = {
+        type: "heartbeat",
+        ...(params?.delegate && { delegate: params.delegate }),
+    };
+    const response = await send(request);
+    if (response.type !== "heartbeat") {
+        throw new InvalidResponseError("heartbeat");
+    }
+    return response;
+}

package/dist/client/api/index.d.ts

@@ -4,7 +4,7 @@ export { completion } from "./completion-stream";
 export { deleteCache } from "./delete-cache";
 export { unloadModel } from "./unload-model";
 export { loggingStream } from "./logging-stream";
-export { ping } from "./ping";
+export { heartbeat } from "./heartbeat";
 export { transcribe, transcribeStream } from "./transcribe";
 export { embed } from "./embed";
 export { translate } from "./translate";

package/dist/client/api/index.js

@@ -4,7 +4,7 @@ export { completion } from "./completion-stream.js";
 export { deleteCache } from "./delete-cache.js";
 export { unloadModel } from "./unload-model.js";
 export { loggingStream } from "./logging-stream.js";
-export { ping } from "./ping.js";
+export { heartbeat } from "./heartbeat.js";
 export { transcribe, transcribeStream } from "./transcribe.js";
 export { embed } from "./embed.js";
 export { translate } from "./translate.js";

package/dist/examples/embed-p2p.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embed-p2p.d.ts.map

package/dist/examples/llamacpp-p2p.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=llamacpp-p2p.d.ts.map

package/dist/examples/seed-p2p.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=seed-p2p.d.ts.map

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, getModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams, } from "./client/api/index";
+export { completion, deleteCache, loadModel, downloadAsset, heartbeat, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, getModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, type ModelRegistrySearchParams, } from "./client/api/index";
 export { close } from "./client/index";
 export { type ModelProgressUpdate, type LoadModelOptions, type DownloadAssetOptions, type Tool, type ToolCall, type ToolCallWithCall, type ToolCallError, type ToolCallEvent, type CompletionStats, VERBOSITY, type Attachment, type CompletionParams, type RagSearchResult, type RagSaveEmbeddingsResult, type RagReindexResult, type RagEmbeddedDoc, type RagDoc, type RagWorkspaceInfo, type RagCloseWorkspaceParams, type RagDeleteWorkspaceParams, type RagIngestStage, type RagReindexStage, type RagSaveStage, SDK_CLIENT_ERROR_CODES, SDK_SERVER_ERROR_CODES, type QvacConfig, type ModelInfo, type GetModelInfoParams, type LoadedInstance, type CacheFileInfo, toolSchema, type McpClient, type McpClientInput, type OCRClientParams, type OCRTextBlock, type OCROptions, definePlugin, defineHandler, type QvacPlugin, type CreateModelParams, type PluginModelResult, type ModelRegistryEntry, type ModelRegistryEntryAddon, PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, SDK_DEFAULT_PLUGINS, type BuiltinPlugin, type ProfilerMode, } from "./schemas/index";
 export { type ToolInput, type ToolHandler } from "./utils/tool-helpers";

package/dist/index.js

@@ -1,5 +1,5 @@
 // Public API exports only
-export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, getModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, } from "./client/api/index.js";
+export { completion, deleteCache, loadModel, downloadAsset, heartbeat, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragChunk, ragIngest, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, ragReindex, ragListWorkspaces, ragCloseWorkspace, ragDeleteWorkspace, textToSpeech, getModelInfo, loggingStream, ocr, invokePlugin, invokePluginStream, modelRegistryList, modelRegistrySearch, modelRegistryGetModel, } from "./client/api/index.js";
 export { close } from "./client/index.js";
 export { VERBOSITY, SDK_CLIENT_ERROR_CODES, SDK_SERVER_ERROR_CODES, toolSchema, definePlugin, defineHandler, PLUGIN_LLM, PLUGIN_EMBEDDING, PLUGIN_WHISPER, PLUGIN_NMT, PLUGIN_TTS, PLUGIN_OCR, SDK_DEFAULT_PLUGINS, } from "./schemas/index.js";
 export {} from "./utils/tool-helpers.js";