@qvac/sdk 0.2.7-dev.1761295911.0436ccb → 0.3.0

package/README.md

@@ -79,7 +79,7 @@ npm i expo-file-system react-native-bare-kit
 ```js
 export default {
   expo: {
-    plugins: ["qvac-sdk/expo-plugin"],
+    plugins: ["@qvac/sdk/expo-plugin"],
   },
 };
 ```
@@ -141,6 +141,7 @@ const cachedResponse = completion({
 
 // Unload model to free up system resources
 await unloadModel({ modelId });
+process.exit();
 ```
 
 **For more on how to use QVAC SDK, see [SDK at QVAC documentation](https://tether-2.gitbook.io/qvac-by-tether-or-reference/y2AsIh94H9DJ1pIBCNj9/sdk)**.
@@ -161,10 +162,10 @@ bun run build  # or `watch` for hotreload
 bun run build:pack
 ```
 
-This outputs a tarball under `dist/tetherto-qvac-sdk-{version}.tgz` that you can install in your project, e.g.:
+This outputs a tarball under `dist/qvac-sdk-{version}.tgz` that you can install in your project, e.g.:
 
 ```bash
-npm i path/to/tetherto-qvac-sdk-0.0.1.tgz
+npm i path/to/qvac-sdk-0.3.0.tgz
 ```
 
 ## Examples

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

@@ -10,5 +10,6 @@ export { embed } from "./embed";
 export { translate } from "./translate";
 export { cancel } from "./cancel";
 export { startQVACProvider } from "./provide";
+export { stopQVACProvider } from "./stop-provider";
 export { ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings } from "./rag";
 //# sourceMappingURL=index.d.ts.map

package/dist/client/api/index.js

@@ -10,4 +10,5 @@ export { embed } from "./embed.js";
 export { translate } from "./translate.js";
 export { cancel } from "./cancel.js";
 export { startQVACProvider } from "./provide.js";
+export { stopQVACProvider } from "./stop-provider.js";
 export { ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings } from "./rag.js";

package/dist/client/api/stop-provider.d.ts

@@ -0,0 +1,15 @@
+import { type StopProvideParams } from "../../schemas/index";
+/**
+ * Stops a running provider service and leaves the specified topic.
+ *
+ * @param options - Options object with required topic
+ * @param options.topic - Topic hex string to leave
+ * @returns A promise that resolves to the stop provide response containing success status
+ * @throws {Error} When the response type is not "stopProvide" or the request fails
+ */
+export declare function stopQVACProvider(params: StopProvideParams): Promise<{
+    type: "stopProvide";
+    success: boolean;
+    error?: string | undefined;
+}>;
+//# sourceMappingURL=stop-provider.d.ts.map

package/dist/client/api/stop-provider.js

@@ -0,0 +1,24 @@
+import {} from "../../schemas/index.js";
+import { send } from "../rpc/rpc-client.js";
+/**
+ * Stops a running provider service and leaves the specified topic.
+ *
+ * @param options - Options object with required topic
+ * @param options.topic - Topic hex string to leave
+ * @returns A promise that resolves to the stop provide response containing success status
+ * @throws {Error} When the response type is not "stopProvide" or the request fails
+ */
+export async function stopQVACProvider(params) {
+    const request = {
+        type: "stopProvide",
+        topic: params.topic,
+    };
+    const response = await send(request);
+    if (response.type !== "stopProvide") {
+        throw new Error("Invalid response type");
+    }
+    if (response.error) {
+        throw new Error(response.error);
+    }
+    return response;
+}

package/dist/client/rpc/bare-client.d.ts

@@ -51,6 +51,10 @@ export declare function stream<T extends Request>(request: T): AsyncGenerator<{
     success: boolean;
     error?: string | undefined;
     publicKey?: string | undefined;
+} | {
+    type: "stopProvide";
+    success: boolean;
+    error?: string | undefined;
 } | {
     type: "unloadModel";
     success: boolean;

package/dist/client/rpc/rpc-client.js

@@ -2,6 +2,11 @@ import { requestSchema, responseSchema, } from "../../schemas/index.js";
 import { RPCError } from "./rpc-error.js";
 import { withTimeout, withTimeoutStream } from "../../utils/withTimeout.js";
 let rpcInstance = null;
+let commandCounter = 0;
+function getNextCommandId() {
+    commandCounter = (commandCounter + 1) % Number.MAX_SAFE_INTEGER;
+    return commandCounter;
+}
 function checkAndThrowError(response) {
     if (response.type === "error") {
         throw new RPCError(response);
@@ -41,7 +46,7 @@ async function getRPC() {
 export async function send(request, rpc, options) {
     const parsedRequest = requestSchema.parse(request);
     const rpcInstance = rpc || (await getRPC());
-    const req = rpcInstance.request(1);
+    const req = rpcInstance.request(getNextCommandId());
     // TODO temp for debugging, find a better solution to exclude large payloads
     // Log request type and basic info, avoid logging large payloads
     if (request.type === "transcribeStream") {
@@ -65,7 +70,7 @@ export async function send(request, rpc, options) {
 export async function* stream(request, rpc, options = {}) {
     const parsedRequest = requestSchema.parse(request);
     const rpcInstance = rpc || (await getRPC());
-    const req = rpcInstance.request(1);
+    const req = rpcInstance.request(getNextCommandId());
     req.send(JSON.stringify(parsedRequest), "utf-8");
     const responseStream = req.createResponseStream({ encoding: "utf-8" });
     let buffer = "";

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, } from "./client/api/index";
+export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, } from "./client/api/index";
 export { type ModelProgressUpdate, type LoadModelOptions, type DownloadAssetOptions, type Tool, VERBOSITY, type Attachment, type CompletionParams, type RagSearchResult, type RagSaveEmbeddingsResult, } from "./schemas/index";
 export * from "./models/hyperdrive/index";
 export { SUPPORTED_AUDIO_FORMATS } from "./constants/audio";

package/dist/index.js

@@ -1,5 +1,5 @@
 // Public API exports only
-export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, } from "./client/api/index.js";
+export { completion, deleteCache, loadModel, downloadAsset, ping, startQVACProvider, stopQVACProvider, unloadModel, transcribe, transcribeStream, embed, translate, cancel, ragSaveEmbeddings, ragSearch, ragDeleteEmbeddings, } from "./client/api/index.js";
 export { VERBOSITY, } from "./schemas/index.js";
 // Hyperdrive model constants
 export * from "./models/hyperdrive/index.js";

package/dist/models/hyperdrive/models.d.ts

@@ -426,6 +426,13 @@ export declare const models: readonly [{
     readonly addon: "vad";
     readonly expectedSize: 885098;
     readonly sha256Checksum: "29940d98d42b91fbd05ce489f3ecf7c72f0a42f027e4875919a28fb4c04ea2cf";
+}, {
+    readonly hyperdriveKey: "19aaf2bc2685d2be2e001af0abf2a5d07d13b78f1a234fb75bf9fc2d07ee7f1d";
+    readonly hyperbeeKey: "transcription:whisper-norwegian:tiny-ggml::::1.0.0:norwegian";
+    readonly modelId: "nb-tiny-ggml-model.bin";
+    readonly addon: "whisper";
+    readonly expectedSize: 77691730;
+    readonly sha256Checksum: "2f9dd799ee36b6a9c8d642e9b1df8ecf2135efdd5a91b1d9ca0b3c0decda535f";
 }, {
     readonly hyperdriveKey: "76fb36d7f16a430618962d3e78b0e22e61aa527a9e937335188d08858aaa9075";
     readonly hyperbeeKey: "transcription:whisper:large:3:::1.0.0:silero";
@@ -515,9 +522,10 @@ export declare const MARIAN_OPUS_RU_EN_Q4_0: "pear://47b2ec9c205a8624bb7460d9a7d
 export declare const MARIAN_OPUS_EN_JA_Q4F16_1: "pear://2e6e274e9bb86774a64880ccd89660d3d5d5901f0bf39116d460350b06adb3a3/ggml-opus-en-ja.bin";
 export declare const MARIAN_OPUS_JA_EN_Q4F16_1: "pear://0e795244ad5cf38dac6fe28deec8f97b37c95907d734a50f620670dc9d0a8e5b/ggml-opus-ja-en.bin";
 export declare const VAD_SILERO_5_1_2: "pear://60a19f1065c355df49c753b16cea075863ebbfdd330caca8b3ea6a337026fc7d/ggml-silero-v5.1.2.bin";
+export declare const WHISPER_NORWEGIAN_TINY: "pear://19aaf2bc2685d2be2e001af0abf2a5d07d13b78f1a234fb75bf9fc2d07ee7f1d/nb-tiny-ggml-model.bin";
 export declare const WHISPER_LARGE_3: "pear://76fb36d7f16a430618962d3e78b0e22e61aa527a9e937335188d08858aaa9075/ggml-large-v3-turbo.bin";
 export declare const WHISPER_SMALL: "pear://c6a987fbb4ad8fba1526e446501f88ee45dfafbf1685410a7aeadb589fe18608/ggml-small.en-q8_0.bin";
 export declare const WHISPER_TINY: "pear://9281d61503593fdf3eaa9d5e5d44746c271ef930aed3b7f8ee9ce153c76399d6/ggml-tiny.bin";
 export declare const WHISPER_TINY_SILERO: "pear://ebfb94b378276da139554668f1ff737644eadff529c2ea0f2662d7df61fd86ca/ggml-tiny.bin";
-export declare function getModelBySrc(modelId: string, hyperdriveKey?: string): HyperdriveItem | undefined;
+export declare function getModelBySrc(modelId: string, hyperdriveKey: string): HyperdriveItem | undefined;
 //# sourceMappingURL=models.d.ts.map

package/dist/models/hyperdrive/models.js

@@ -481,6 +481,14 @@ export const models = [
         expectedSize: 885098,
         sha256Checksum: "29940d98d42b91fbd05ce489f3ecf7c72f0a42f027e4875919a28fb4c04ea2cf",
     },
+    {
+        hyperdriveKey: "19aaf2bc2685d2be2e001af0abf2a5d07d13b78f1a234fb75bf9fc2d07ee7f1d",
+        hyperbeeKey: "transcription:whisper-norwegian:tiny-ggml::::1.0.0:norwegian",
+        modelId: "nb-tiny-ggml-model.bin",
+        addon: "whisper",
+        expectedSize: 77691730,
+        sha256Checksum: "2f9dd799ee36b6a9c8d642e9b1df8ecf2135efdd5a91b1d9ca0b3c0decda535f",
+    },
     {
         hyperdriveKey: "76fb36d7f16a430618962d3e78b0e22e61aa527a9e937335188d08858aaa9075",
         hyperbeeKey: "transcription:whisper:large:3:::1.0.0:silero",
@@ -575,14 +583,12 @@ export const MARIAN_OPUS_RU_EN_Q4_0 = `pear://${models[56].hyperdriveKey}/${mode
 export const MARIAN_OPUS_EN_JA_Q4F16_1 = `pear://${models[57].hyperdriveKey}/${models[57].modelId}`;
 export const MARIAN_OPUS_JA_EN_Q4F16_1 = `pear://${models[58].hyperdriveKey}/${models[58].modelId}`;
 export const VAD_SILERO_5_1_2 = `pear://${models[59].hyperdriveKey}/${models[59].modelId}`;
-export const WHISPER_LARGE_3 = `pear://${models[60].hyperdriveKey}/${models[60].modelId}`;
-export const WHISPER_SMALL = `pear://${models[61].hyperdriveKey}/${models[61].modelId}`;
-export const WHISPER_TINY = `pear://${models[62].hyperdriveKey}/${models[62].modelId}`;
-export const WHISPER_TINY_SILERO = `pear://${models[63].hyperdriveKey}/${models[63].modelId}`;
+export const WHISPER_NORWEGIAN_TINY = `pear://${models[60].hyperdriveKey}/${models[60].modelId}`;
+export const WHISPER_LARGE_3 = `pear://${models[61].hyperdriveKey}/${models[61].modelId}`;
+export const WHISPER_SMALL = `pear://${models[62].hyperdriveKey}/${models[62].modelId}`;
+export const WHISPER_TINY = `pear://${models[63].hyperdriveKey}/${models[63].modelId}`;
+export const WHISPER_TINY_SILERO = `pear://${models[64].hyperdriveKey}/${models[64].modelId}`;
 // Helper function for our curated model list
 export function getModelBySrc(modelId, hyperdriveKey) {
-    if (hyperdriveKey) {
-        return models.find((model) => model.modelId === modelId && model.hyperdriveKey === hyperdriveKey);
-    }
-    return models.find((model) => model.modelId === modelId);
+    return models.find((model) => model.modelId === modelId && model.hyperdriveKey === hyperdriveKey);
 }

package/dist/schemas/common.d.ts

@@ -473,6 +473,9 @@ export declare const requestSchema: z.ZodUnion<readonly [z.ZodObject<{
         }>>;
         publicKeys: z.ZodDefault<z.ZodArray<z.ZodString>>;
     }, z.core.$strip>>;
+}, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"stopProvide">;
+    topic: z.ZodString;
 }, z.core.$strict>, z.ZodDiscriminatedUnion<[z.ZodObject<{
     modelId: z.ZodString;
     workspace: z.ZodOptional<z.ZodString>;
@@ -591,6 +594,10 @@ export declare const responseSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     success: z.ZodBoolean;
     error: z.ZodOptional<z.ZodString>;
     publicKey: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"stopProvide">;
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
     type: z.ZodLiteral<"error">;
     message: z.ZodString;

package/dist/schemas/common.js

@@ -8,6 +8,7 @@ import { transcribeStreamRequestSchema, transcribeStreamResponseSchema, } from "
 import { embedRequestSchema, embedResponseSchema } from "./embed.js";
 import { cancelRequestSchema, cancelResponseSchema } from "./cancel.js";
 import { provideRequestSchema, provideResponseSchema } from "./provide.js";
+import { stopProvideRequestSchema, stopProvideResponseSchema, } from "./stop-provide.js";
 import { translateRequestSchema, translateResponseSchema } from "./translate.js";
 import { loggingStreamRequestSchema, loggingStreamResponseSchema, } from "./logging-stream.js";
 import { errorResponseSchema } from "./error.js";
@@ -25,6 +26,7 @@ export const requestSchema = z.union([
     translateRequestSchema,
     cancelRequestSchema,
     provideRequestSchema,
+    stopProvideRequestSchema,
     ragRequestSchema,
     deleteCacheRequestSchema,
 ]);
@@ -41,6 +43,7 @@ export const responseSchema = z.discriminatedUnion("type", [
     translateResponseSchema,
     cancelResponseSchema,
     provideResponseSchema,
+    stopProvideResponseSchema,
     errorResponseSchema,
     ragResponseSchema,
     deleteCacheResponseSchema,

package/dist/schemas/index.d.ts

@@ -7,6 +7,7 @@ export * from "./embed";
 export * from "./load-model";
 export * from "./logging-stream";
 export * from "./provide";
+export * from "./stop-provide";
 export * from "./unload-model";
 export * from "./ping";
 export * from "./common";

package/dist/schemas/index.js

@@ -8,6 +8,7 @@ export * from "./embed.js";
 export * from "./load-model.js";
 export * from "./logging-stream.js";
 export * from "./provide.js";
+export * from "./stop-provide.js";
 export * from "./unload-model.js";
 export * from "./ping.js";
 export * from "./common.js";

package/dist/schemas/stop-provide.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+export declare const stopProvideParamsSchema: z.ZodObject<{
+    topic: z.ZodString;
+}, z.core.$strict>;
+export declare const stopProvideRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"stopProvide">;
+    topic: z.ZodString;
+}, z.core.$strict>;
+export declare const stopProvideResponseSchema: z.ZodObject<{
+    type: z.ZodLiteral<"stopProvide">;
+    success: z.ZodBoolean;
+    error: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type StopProvideParams = z.infer<typeof stopProvideParamsSchema>;
+export type StopProvideRequest = z.infer<typeof stopProvideRequestSchema>;
+export type StopProvideResponse = z.infer<typeof stopProvideResponseSchema>;
+//# sourceMappingURL=stop-provide.d.ts.map

package/dist/schemas/stop-provide.js

@@ -0,0 +1,15 @@
+import { z } from "zod";
+export const stopProvideParamsSchema = z
+    .object({
+    topic: z.string(),
+})
+    .strict();
+export const stopProvideRequestSchema = stopProvideParamsSchema.extend({
+    type: z.literal("stopProvide"),
+    topic: z.string(),
+});
+export const stopProvideResponseSchema = z.object({
+    type: z.literal("stopProvide"),
+    success: z.boolean(),
+    error: z.string().optional(),
+});

package/dist/server/bare/rag-hyperdb/rag-manager.js

@@ -1,7 +1,6 @@
 import { RAG, HyperDBAdapter } from "@qvac/rag";
 import Corestore from "corestore";
 import path from "bare-path";
-import process from "bare-process";
 import { getEnv } from "../../worker.js";
 const ragInstances = new Map();
 const defaultWorkspace = "default";
@@ -48,14 +47,19 @@ export const closeRagInstance = async (workspace) => {
         ragInstances.delete(key);
     }
 };
+let isCleaningUp = false;
 export const closeAllRagInstances = async () => {
-    const closures = Array.from(ragInstances.entries()).map(async ([key, entry]) => {
-        await entry.rag.close();
-        ragInstances.delete(key);
-    });
-    await Promise.all(closures);
+    if (isCleaningUp)
+        return;
+    isCleaningUp = true;
+    try {
+        const closures = Array.from(ragInstances.entries()).map(async ([key, entry]) => {
+            await entry.rag.close();
+            ragInstances.delete(key);
+        });
+        await Promise.all(closures);
+    }
+    catch (error) {
+        console.error("❌ Error during RAG cleanup:", error);
+    }
 };
-// Ensure cleanup on process exit
-process.on("SIGINT", () => {
-    void closeAllRagInstances();
-});

package/dist/server/bare/registry/logging-stream-registry.d.ts

@@ -9,4 +9,5 @@ export declare function getLoggingStreamStats(): {
     modelIds: string[];
     totalStreams: number;
 };
+export declare function clearAllLoggingStreams(): void;
 //# sourceMappingURL=logging-stream-registry.d.ts.map

package/dist/server/bare/registry/logging-stream-registry.js

@@ -44,3 +44,10 @@ export function getLoggingStreamStats() {
         totalStreams: Array.from(loggingStreams.values()).reduce((sum, streams) => sum + streams.size, 0),
     };
 }
+export function clearAllLoggingStreams() {
+    const count = loggingStreams.size;
+    loggingStreams.clear();
+    if (count > 0) {
+        console.log(`🧹 Cleared logging streams for ${count} model(s)`);
+    }
+}

package/dist/server/rpc/handle-request.js

@@ -12,6 +12,7 @@ import { handleTranslate } from "./handlers/translate.js";
 import { handleLoggingStream } from "./handlers/logging-stream.js";
 import { cancelHandler } from "./handlers/cancelHandler.js";
 import { provideHandler } from "./handlers/provideHandler.js";
+import { stopProvideHandler } from "./handlers/stopProvideHandler.js";
 import { handleRag } from "./handlers/rag.js";
 import { handleDeleteCache } from "./handlers/delete-cache.js";
 import { sendErrorResponse, sendStreamErrorResponse } from "../error-handlers";
@@ -200,6 +201,11 @@ export async function handleRequest(req) {
                 req.reply(JSON.stringify(responseSchema.parse(response)), "utf-8");
                 break;
             }
+            case "stopProvide": {
+                const response = stopProvideHandler(request);
+                req.reply(JSON.stringify(responseSchema.parse(response)), "utf-8");
+                break;
+            }
             case "rag": {
                 try {
                     const response = await handleRag(request);

package/dist/server/rpc/handlers/index.d.ts

@@ -5,6 +5,7 @@ import { handleUnloadModel } from "./unload-model";
 import { handleEmbed } from "./embed";
 import { handleTranscribeStream } from "./transcribe-stream";
 import { provideHandler } from "./provideHandler";
+import { stopProvideHandler } from "./stopProvideHandler";
 import { handleTranslate } from "./translate";
 import { handleLoggingStream } from "./logging-stream";
 import { handleRag } from "./rag";
@@ -19,6 +20,7 @@ export declare const handlers: {
     embed: typeof handleEmbed;
     transcribeStream: typeof handleTranscribeStream;
     provide: typeof provideHandler;
+    stopProvide: typeof stopProvideHandler;
     translate: typeof handleTranslate;
     loggingStream: typeof handleLoggingStream;
     rag: typeof handleRag;

package/dist/server/rpc/handlers/index.js

@@ -5,6 +5,7 @@ import { handleUnloadModel } from "./unload-model.js";
 import { handleEmbed } from "./embed.js";
 import { handleTranscribeStream } from "./transcribe-stream.js";
 import { provideHandler } from "./provideHandler.js";
+import { stopProvideHandler } from "./stopProvideHandler.js";
 import { handleTranslate } from "./translate.js";
 import { handleLoggingStream } from "./logging-stream.js";
 import { handleRag } from "./rag.js";
@@ -19,6 +20,7 @@ export const handlers = {
     embed: handleEmbed,
     transcribeStream: handleTranscribeStream,
     provide: provideHandler,
+    stopProvide: stopProvideHandler,
     translate: handleTranslate,
     loggingStream: handleLoggingStream,
     rag: handleRag,

package/dist/server/rpc/handlers/load-model/download-manager.d.ts

@@ -9,4 +9,5 @@ export declare const shouldClearCache: (downloadKey: string) => boolean;
 export declare const clearClearCacheFlag: (downloadKey: string) => void;
 export declare const createCancelFunction: (downloadKey: string, clearCache?: boolean) => () => void;
 export declare const cancelAllDownloads: () => void;
+export declare const cleanupDownloads: () => Promise<void>;
 //# sourceMappingURL=download-manager.d.ts.map

package/dist/server/rpc/handlers/load-model/download-manager.js

@@ -1,11 +1,9 @@
 import {} from "../../../../schemas/index.js";
-import process from "bare-process";
 const activeDownloads = new Map();
 const clearCacheFlags = new Map();
 export const getActiveDownload = (key) => activeDownloads.get(key);
 export const registerDownload = (key, entry) => {
     activeDownloads.set(key, entry);
-    registerCleanupHandlers();
 };
 export const unregisterDownload = (key) => {
     activeDownloads.delete(key);
@@ -38,36 +36,19 @@ export const cancelAllDownloads = () => {
     console.log(`🧹 Cancelling ${activeDownloads.size} active downloads`);
     Array.from(activeDownloads.keys()).forEach((key) => createCancelFunction(key)());
 };
-// Register cleanup handlers for graceful shutdown
-let cleanupRegistered = false;
 let isCleaningUp = false;
-const registerCleanupHandlers = () => {
-    if (cleanupRegistered)
+export const cleanupDownloads = async () => {
+    if (isCleaningUp)
         return;
-    cleanupRegistered = true;
-    const cleanup = async () => {
-        if (isCleaningUp)
-            return;
-        isCleaningUp = true;
-        try {
-            const downloadPromises = Array.from(activeDownloads.values()).map((entry) => entry.promise.catch(() => { }));
-            cancelAllDownloads();
-            if (downloadPromises.length > 0) {
-                await Promise.allSettled(downloadPromises);
-            }
+    isCleaningUp = true;
+    try {
+        const downloadPromises = Array.from(activeDownloads.values()).map((entry) => entry.promise.catch(() => { }));
+        cancelAllDownloads();
+        if (downloadPromises.length > 0) {
+            await Promise.allSettled(downloadPromises);
         }
-        catch (error) {
-            console.error("❌ Error during download cleanup:", error);
-        }
-    };
-    let handlingExit = false;
-    const exitHandler = async () => {
-        if (handlingExit)
-            return;
-        handlingExit = true;
-        await cleanup();
-        process.exit(0);
-    };
-    process.once("SIGTERM", () => void exitHandler());
-    process.once("SIGINT", () => void exitHandler());
+    }
+    catch (error) {
+        console.error("❌ Error during download cleanup:", error);
+    }
 };

package/dist/server/rpc/handlers/load-model/hyperdrive.js

@@ -34,14 +34,13 @@ async function setupHyperdrive(hyperdriveKey, corestoreDir) {
     const drive = new Hyperdrive(corestore, Buffer.from(hyperdriveKey, "hex"));
     await drive.ready();
     const swarm = new Hyperswarm();
-    swarm.join(drive.discoveryKey, { server: false, client: true });
+    const doneFindingPeers = drive.findingPeers();
     swarm.on("connection", (connection) => {
         console.log(`🤝 Connected to peer for hyperdrive download`);
         drive.replicate(connection);
     });
-    const doneFindingPeers = drive.findingPeers();
-    await swarm.flush();
-    doneFindingPeers();
+    swarm.join(drive.discoveryKey, { server: false, client: true });
+    swarm.flush().then(doneFindingPeers, doneFindingPeers);
     return { corestore, drive, swarm, corestoreDir };
 }
 async function cleanupHyperdrive(setup) {
@@ -68,10 +67,15 @@ export async function deleteCorestoreDirectory(corestoreDir) {
     }
 }
 async function findFileInHyperdrive(drive, modelFileName) {
+    if (drive.core.length === 0) {
+        // this method will update the length of the core using the first peer it finds
+        // this will ensure that the hyperdrive is usable
+        await drive.core.update();
+    }
     const paths = [modelFileName, `/${modelFileName}`, `./${modelFileName}`];
     for (const pathVariation of paths) {
         try {
-            const entry = await drive.entry(pathVariation);
+            const entry = await drive.entry(pathVariation, { wait: true });
             if (entry) {
                 return { entry, targetPath: pathVariation };
             }
@@ -85,7 +89,7 @@ async function findFileInHyperdrive(drive, modelFileName) {
     try {
         // Try both with and without leading slash
         for (const prefix of ["/", ""]) {
-            const files = drive.list(prefix, false);
+            const files = drive.list(prefix, { recursive: true, wait: true });
             for await (const file of files) {
                 availableFiles.push(file.key);
             }

package/dist/server/rpc/handlers/load-model/resolve.js

@@ -1,46 +1,10 @@
-import { getModelBySrc, models } from "../../../../models/hyperdrive/models.js";
+import { models } from "../../../../models/hyperdrive/models.js";
 import { hyperdriveUrlSchema } from "../../../../schemas/index.js";
 import { getModelsCacheDir } from "../../../utils/index.js";
 import { promises as fsPromises } from "bare-fs";
 import path from "bare-path";
 import { downloadModelFromHttp } from "./http.js";
 import { downloadModelFromHyperdrive } from "./hyperdrive.js";
-/**
- * Attempts to resolve a model from cache (without validation)
- * Validation will be handled by the hyperdrive download logic
- */
-async function tryResolveCachedModel(modelId) {
-    const cacheDir = getModelsCacheDir();
-    const cachedPath = path.join(cacheDir, modelId);
-    try {
-        await fsPromises.access(cachedPath);
-        // File exists - return null to let hyperdrive validation handle size/checksum
-        // This ensures partial downloads are properly resumed instead of being
-        // incorrectly validated and deleted
-        return null;
-    }
-    catch {
-        // File doesn't exist
-        return null;
-    }
-}
-/**
- * Resolves a known model by ID from hyperdrive, checking cache first
- */
-async function resolveKnownModel(model, modelIdOrPath, progressCallback, seed) {
-    if (!model) {
-        throw new Error("Model is null");
-    }
-    console.log(`Loading model ID '${modelIdOrPath}' from hyperdrive`);
-    // Try to resolve from cache first
-    const cachedPath = await tryResolveCachedModel(model.modelId);
-    if (cachedPath) {
-        return cachedPath;
-    }
-    // Not cached or invalid, download from hyperdrive
-    const downloadedPath = await downloadModelFromHyperdrive(model.hyperdriveKey, model.modelId, seed, progressCallback, model.sha256Checksum);
-    return downloadedPath;
-}
 /**
  * Resolves a local file path or cached file
  */
@@ -84,10 +48,7 @@ export async function resolveModelPath(modelSrc, progressCallback, seed) {
     let actualPath;
     // Validate seeding is only used with hyperdrive models
     if (seed && !hyperdriveKey) {
-        const model = getModelBySrc(actualModelSrc);
-        if (!model) {
-            throw new Error("Seeding is only supported for hyperdrive models");
-        }
+        throw new Error("Seeding is only supported for hyperdrive models");
     }
     // Check if it's an HTTP/HTTPS URL
     if (actualModelSrc.startsWith("http://") ||
@@ -101,21 +62,13 @@ export async function resolveModelPath(modelSrc, progressCallback, seed) {
         console.log(`Loading from hyperdrive: ${hyperdriveKey}`);
         actualPath = await downloadModelFromHyperdrive(hyperdriveKey, actualModelSrc, seed, progressCallback);
     }
+    else if (actualModelSrc.includes("/") || actualModelSrc.includes("\\")) {
+        // Handle file paths (absolute or relative with slashes)
+        actualPath = actualModelSrc;
+    }
     else {
-        // Try to resolve as a known model ID
-        const model = getModelBySrc(actualModelSrc);
-        if (model) {
-            actualPath = await resolveKnownModel(model, actualModelSrc, progressCallback, seed);
-        }
-        else if (actualModelSrc.includes("/") || actualModelSrc.includes("\\")) {
-            // Handle file paths (absolute or relative with slashes)
-            console.log(`Loading from file: ${actualModelSrc}`);
-            actualPath = actualModelSrc;
-        }
-        else {
-            // Handle local files and cached files
-            actualPath = await resolveLocalOrCachedFile(actualModelSrc);
-        }
+        // Handle local files and cached files
+        actualPath = await resolveLocalOrCachedFile(actualModelSrc);
     }
     return actualPath;
 }

package/dist/server/rpc/handlers/stopProvideHandler.d.ts

@@ -0,0 +1,3 @@
+import type { StopProvideRequest, StopProvideResponse } from "../../../schemas/stop-provide";
+export declare function stopProvideHandler(request: StopProvideRequest): StopProvideResponse;
+//# sourceMappingURL=stopProvideHandler.d.ts.map

package/dist/server/rpc/handlers/stopProvideHandler.js

@@ -0,0 +1,20 @@
+import { getSwarm } from "../../bare/hyperswarm.js";
+export function stopProvideHandler(request) {
+    const swarm = getSwarm();
+    try {
+        const topic = Buffer.from(request.topic, "hex");
+        swarm.leave(topic);
+        return {
+            type: "stopProvide",
+            success: true,
+        };
+    }
+    catch (error) {
+        console.error("❌ Error in stop provide handler:", error);
+        return {
+            type: "stopProvide",
+            success: false,
+            error: error instanceof Error ? error.message : "Unknown error",
+        };
+    }
+}

package/dist/server/worker.js

@@ -2,6 +2,10 @@ import process from "bare-process";
 import { createBareKitRPCServer, createIPCClient, } from "./rpc/create-server.js";
 import { z } from "zod";
 import { destroySwarm } from "./bare/hyperswarm.js";
+import { closeAllRagInstances } from "./bare/rag-hyperdb/rag-manager.js";
+import { cleanupDownloads } from "./rpc/handlers/load-model/download-manager.js";
+import { unloadAllModels } from "./bare/registry/model-registry.js";
+import { clearAllLoggingStreams } from "./bare/registry/logging-stream-registry.js";
 console.log("🐻 Hello from Bare");
 console.log("Arguments to worker:", process.argv);
 const defaultHomeDir = process.env["HOME"] || process.env["USERPROFILE"] || "/tmp";
@@ -65,13 +69,27 @@ if (hasRPCConfig) {
 else {
     console.log("Running in direct mode - RPC setup will be lazy");
 }
-process.on("SIGTERM", () => {
-    console.log("🐻 Bare worker SIGTERM received, cleaning up...");
-    destroySwarm()
-        .then(() => {
-        process.exit(0);
-    })
-        .catch((err) => {
-        throw err;
-    });
-});
+// Centralized cleanup for graceful shutdown
+let isShuttingDown = false;
+const shutdownHandler = async () => {
+    if (isShuttingDown)
+        return;
+    isShuttingDown = true;
+    console.log("🐻 Bare worker shutdown signal received, cleaning up...");
+    try {
+        clearAllLoggingStreams();
+        await Promise.allSettled([
+            destroySwarm(),
+            closeAllRagInstances(),
+            cleanupDownloads(),
+            unloadAllModels(),
+        ]);
+        console.log("✅ Cleanup completed successfully");
+    }
+    catch (error) {
+        console.error("❌ Error during shutdown cleanup:", error);
+    }
+    process.exit(0);
+};
+process.once("SIGTERM", () => void shutdownHandler());
+process.once("SIGINT", () => void shutdownHandler());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qvac/sdk",
-  "version": "0.2.7-dev.1761295911.0436ccb",
+  "version": "0.3.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -45,7 +45,7 @@
     "bare:ensureprebuilds:whispercpp": "cp -r node_modules/@qvac/transcription-whispercpp/prebuilds/android-arm64 node_modules/@qvac/transcription-whispercpp/prebuilds/android-ia32 && cp -r node_modules/@qvac/transcription-whispercpp/prebuilds/android-arm64 node_modules/@qvac/transcription-whispercpp/prebuilds/android-arm && cp -r node_modules/@qvac/transcription-whispercpp/prebuilds/android-arm64 node_modules/@qvac/transcription-whispercpp/prebuilds/android-x64",
     "bare:ensureprebuilds:embeddings": "cp -r node_modules/@qvac/embed-llamacpp/prebuilds/android-arm64 node_modules/@qvac/embed-llamacpp/prebuilds/android-ia32 && cp -r node_modules/@qvac/embed-llamacpp/prebuilds/android-arm64 node_modules/@qvac/embed-llamacpp/prebuilds/android-arm && cp -r node_modules/@qvac/embed-llamacpp/prebuilds/android-arm64 node_modules/@qvac/embed-llamacpp/prebuilds/android-x64",
     "bare:ensureprebuilds": "bun run bare:ensureprebuilds:llamacpp && bun run bare:ensureprebuilds:whispercpp && bun run bare:ensureprebuilds:embeddings",
-    "prepare": "bun run husky",
+    "prepare:husky": "bun run husky",
     "bare:example": "./scripts/run-with-bare.sh",
     "docs_api:website": "typedoc --out ./docs/api/website --entryPoints index.ts --entryPointStrategy expand --readme none",
     "docs_api:markdown": "typedoc --plugin typedoc-plugin-markdown --out ./docs/api/markdown --entryPoints index.ts --entryPointStrategy expand --readme none && sed -i '1,4d' ./docs/api/markdown/README.md",
@@ -53,15 +53,15 @@
     "update-models": "node ./scripts/update-models.js"
   },
   "dependencies": {
-    "@qvac/embed-llamacpp": "^0.3.1",
+    "@qvac/embed-llamacpp": "^0.4.0",
     "@qvac/llm-llamacpp": "^0.3.2",
     "@qvac/decoder-audio": "^0.1.0",
     "@qvac/error": "^0.1.0",
     "@qvac/langdetect-text": "^0.1.0",
     "@qvac/logging": "^0.1.0",
     "@qvac/rag": "^0.2.1",
-    "@qvac/transcription-whispercpp": "^0.1.4",
-    "@qvac/translation-nmtcpp": "^0.1.0",
+    "@qvac/transcription-whispercpp": "^0.1.8",
+    "@qvac/translation-nmtcpp": "^0.1.2",
     "fast-safe-stringify": "2.1.1",
     "zod": "^4.0.17"
   },
@@ -103,7 +103,7 @@
     "bare-path": "^3.0.0",
     "bare-process": "^4.2.1",
     "bare-rpc": "^0.2.11",
-    "bare-runtime": "^1.22.1-0",
+    "bare-runtime": "^1.24.1",
     "bare-stream": "^2.6.5",
     "bare-subprocess": "^5.1.1",
     "corestore": "^7.4.5",
@@ -126,4 +126,4 @@
   "patchedDependencies": {
     "bare-rpc@0.2.11": "patches/bare-rpc@0.2.11.patch"
   }
-}
+}