@qvac/sdk 0.14.1 → 0.16.0

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

@@ -1,26 +1,26 @@
-import fs, { promises as fsPromises } from "bare-fs";
-import path from "bare-path";
-import Corestore from "corestore";
-import Hyperswarm, {} from "hyperswarm";
-import Hyperdrive from "hyperdrive";
-import {} from "bare-stream";
-import { getQvacPath } from "../../../utils/qvac-paths.js";
-import { getModelsCacheDir, generateShortHash, detectShardedModel, getShardedModelCacheDir, getShardPath, checkShardCompleteness, measureChecksum, extractTensorsFromShards, calculatePercentage, } from "../../../utils/index.js";
-import { getModelBySrc } from "../../../../models/registry/index.js";
-import { createHyperdriveDownloadKey, startOrJoinDownload, applyJoinedDownloadStats, } from "./download-manager.js";
-import { getSDKConfig } from "../../../bare/registry/config-registry.js";
-import { FileNotFoundError, ChecksumValidationFailedError, DownloadCancelledError, HyperdriveDownloadFailedError, ModelLoadFailedError, NoBlobFoundError, } from "../../../../utils/errors-server.js";
-import { getServerLogger } from "../../../../logging/index.js";
-import { registerSwarm, unregisterSwarm, registerCorestore, unregisterCorestore, } from "../../../bare/runtime-lifecycle.js";
-import { Buffer } from "bare-buffer";
+import fs, { promises as fsPromises } from 'bare-fs';
+import path from 'bare-path';
+import Corestore from 'corestore';
+import Hyperswarm, {} from 'hyperswarm';
+import Hyperdrive from 'hyperdrive';
+import {} from 'bare-stream';
+import { getQvacPath } from '../../../utils/qvac-paths.js';
+import { getModelsCacheDir, generateShortHash, detectShardedModel, getShardedModelCacheDir, getShardPath, checkShardCompleteness, measureChecksum, extractTensorsFromShards, calculatePercentage } from '../../../utils/index.js';
+import { getModelBySrc } from '../../../../models/registry/index.js';
+import { createHyperdriveDownloadKey, startOrJoinDownload, applyJoinedDownloadStats } from './download-manager.js';
+import { getSDKConfig } from '../../../bare/registry/config-registry.js';
+import { FileNotFoundError, ChecksumValidationFailedError, DownloadCancelledError, HyperdriveDownloadFailedError, ModelLoadFailedError, NoBlobFoundError } from '../../../../utils/errors-server.js';
+import { getServerLogger } from '../../../../logging/index.js';
+import { registerSwarm, unregisterSwarm, registerCorestore, unregisterCorestore } from '../../../bare/runtime-lifecycle.js';
+import { Buffer } from 'bare-buffer';
 const logger = getServerLogger();
 function getCorestoreDir(hyperdriveKey) {
-    return getQvacPath("corestore", hyperdriveKey);
+    return getQvacPath('corestore', hyperdriveKey);
 }
 async function setupHyperdrive(hyperdriveKey, corestoreDir) {
     const corestore = new Corestore(corestoreDir);
     await corestore.ready();
-    const drive = new Hyperdrive(corestore, Buffer.from(hyperdriveKey, "hex"));
+    const drive = new Hyperdrive(corestore, Buffer.from(hyperdriveKey, 'hex'));
     await drive.ready();
     const getRelays = () => {
         const config = getSDKConfig();
@@ -28,14 +28,14 @@ async function setupHyperdrive(hyperdriveKey, corestoreDir) {
         if (!relayPublicKeys || relayPublicKeys.length === 0) {
             return null;
         }
-        return relayPublicKeys.map((key) => Buffer.from(key, "hex"));
+        return relayPublicKeys.map((key) => Buffer.from(key, 'hex'));
     };
     const swarmOptions = {
-        relayThrough: getRelays,
+        relayThrough: getRelays
     };
     const swarm = new Hyperswarm(swarmOptions);
     const doneFindingPeers = drive.findingPeers();
-    swarm.on("connection", (connection) => {
+    swarm.on('connection', (connection) => {
         logger.debug(`🤝 Connected to peer for hyperdrive download`);
         drive.replicate(connection);
     });
@@ -43,23 +43,23 @@ async function setupHyperdrive(hyperdriveKey, corestoreDir) {
     swarm.flush().then(doneFindingPeers, doneFindingPeers);
     registerCorestore(corestore, {
         label: `hyperdrive:${hyperdriveKey}`,
-        createdAt: Date.now(),
+        createdAt: Date.now()
     });
     registerSwarm(swarm, {
         label: `hyperdrive:${hyperdriveKey}`,
-        createdAt: Date.now(),
+        createdAt: Date.now()
     });
     return { corestore, drive, swarm, corestoreDir };
 }
 async function cleanupHyperdrive(setup) {
-    logger.debug("🧹 Cleaning up hyperdrive setup");
+    logger.debug('🧹 Cleaning up hyperdrive setup');
     try {
         if (!setup.swarm.suspended) {
             try {
                 await setup.swarm.suspend();
             }
             catch (error) {
-                logger.debug("⚠️ Swarm suspend failed during cleanup:", error instanceof Error ? error.message : String(error));
+                logger.debug('⚠️ Swarm suspend failed during cleanup:', error instanceof Error ? error.message : String(error));
             }
         }
         await setup.swarm.destroy();
@@ -102,7 +102,7 @@ async function findFileInHyperdrive(drive, modelFileName) {
     const availableFiles = [];
     try {
         // Try both with and without leading slash
-        for (const prefix of ["/", ""]) {
+        for (const prefix of ['/', '']) {
             const files = drive.list(prefix, { recursive: true, wait: true });
             for await (const file of files) {
                 availableFiles.push(file.key);
@@ -115,8 +115,8 @@ async function findFileInHyperdrive(drive, modelFileName) {
         // Ignore listing errors
     }
     const filesInfo = availableFiles.length > 0
-        ? `Available files: ${availableFiles.join(", ")}`
-        : "Could not list available files";
+        ? `Available files: ${availableFiles.join(', ')}`
+        : 'Could not list available files';
     throw new FileNotFoundError(`${modelFileName} in hyperdrive. ${filesInfo}`);
 }
 async function checkFileDownloaded(drive, entry) {
@@ -127,7 +127,7 @@ async function checkFileDownloaded(drive, entry) {
             blobs,
             blocksDownloaded: 0,
             totalBlocks: 0,
-            totalBytes: 0,
+            totalBytes: 0
         };
     }
     // Check how many blocks are already downloaded
@@ -142,7 +142,7 @@ async function checkFileDownloaded(drive, entry) {
         blobs,
         blocksDownloaded,
         totalBlocks: blob.blockLength,
-        totalBytes: blob.byteLength,
+        totalBytes: blob.byteLength
     };
 }
 async function validateFileExistence(drive, file) {
@@ -154,7 +154,7 @@ async function validateFileExistence(drive, file) {
         targetPath,
         blocksDownloaded,
         totalBlocks,
-        totalBytes,
+        totalBytes
     };
 }
 async function validateCachedFile(modelPath, modelFileName, expectedSize, expectedChecksum, hooks) {
@@ -193,19 +193,19 @@ async function downloadSingleFileToFilesystem(modelPath, modelFileName, hyperdri
     logger.info(`Downloading model from hyperdrive ${hyperdriveKey} to ${modelPath}`);
     const setup = await setupHyperdrive(hyperdriveKey, corestoreDir);
     const cleanup = () => {
-        logger.info("🛑 Aborting hyperdrive download...");
+        logger.info('🛑 Aborting hyperdrive download...');
         setup.swarm.suspended = true;
         setup.swarm.suspend().catch(() => {
             // Ignore errors during emergency suspend
         });
     };
-    signal?.addEventListener("abort", cleanup);
+    signal?.addEventListener('abort', cleanup);
     let downloadSucceeded = false;
     try {
         const progressContext = progressCallback
             ? {
                 downloadKey,
-                callback: progressCallback,
+                callback: progressCallback
             }
             : undefined;
         await downloadAndValidateFile(setup.drive, modelFileName, modelPath, 0, // Size will be determined from drive
@@ -216,11 +216,11 @@ async function downloadSingleFileToFilesystem(modelPath, modelFileName, hyperdri
             try {
                 const stats = await fsPromises.stat(modelPath);
                 progressCallback({
-                    type: "modelProgress",
+                    type: 'modelProgress',
                     downloaded: stats.size,
                     total: stats.size,
                     percentage: 100,
-                    downloadKey,
+                    downloadKey
                 });
             }
             catch {
@@ -230,14 +230,14 @@ async function downloadSingleFileToFilesystem(modelPath, modelFileName, hyperdri
         downloadSucceeded = true;
     }
     catch (error) {
-        logger.error("❌ Error during hyperdrive download:", error instanceof Error ? error.message : String(error));
+        logger.error('❌ Error during hyperdrive download:', error instanceof Error ? error.message : String(error));
         if (error instanceof DownloadCancelledError) {
             throw error;
         }
         throw new HyperdriveDownloadFailedError(`Download failed for ${modelFileName} from hyperdrive: ${hyperdriveKey}`, error);
     }
     finally {
-        signal?.removeEventListener("abort", cleanup);
+        signal?.removeEventListener('abort', cleanup);
         if (!seed) {
             await cleanupHyperdrive(setup);
             // Delete only after close - Windows EBUSY on LOCK if deleted before corestore.close()
@@ -251,9 +251,9 @@ async function downloadSingleFileToFilesystem(modelPath, modelFileName, hyperdri
                 await fsPromises.unlink(modelPath);
             }
             catch (cleanupError) {
-                logger.debug("Failed to delete partial model file during cleanup", {
+                logger.debug('Failed to delete partial model file during cleanup', {
                     path: modelPath,
-                    error: cleanupError,
+                    error: cleanupError
                 });
             }
             await deleteCorestoreDirectory(corestoreDir);
@@ -261,7 +261,7 @@ async function downloadSingleFileToFilesystem(modelPath, modelFileName, hyperdri
     }
 }
 async function downloadAndValidateFile(drive, sourceFileName, targetFilePath, expectedSize, expectedChecksum, progressContext, signal, hooks) {
-    const { entry, blobs, targetPath, blocksDownloaded, totalBlocks, totalBytes, } = await validateFileExistence(drive, sourceFileName);
+    const { entry, blobs, targetPath, blocksDownloaded, totalBlocks, totalBytes } = await validateFileExistence(drive, sourceFileName);
     const blob = entry?.value?.blob;
     if (!blob) {
         throw new NoBlobFoundError(sourceFileName);
@@ -274,17 +274,16 @@ async function downloadAndValidateFile(drive, sourceFileName, targetFilePath, ex
     const initialBytes = Math.floor(blocksDownloaded * bytesPerBlock);
     downloadedBytes = initialBytes;
     const progressHandler = (index, bytes) => {
-        if (index >= blob.blockOffset &&
-            index < blob.blockOffset + blob.blockLength) {
+        if (index >= blob.blockOffset && index < blob.blockOffset + blob.blockLength) {
             downloadedBytes += bytes;
             const cappedDownloaded = Math.min(downloadedBytes, totalBytes);
             if (progressContext) {
                 const baseProgress = {
-                    type: "modelProgress",
+                    type: 'modelProgress',
                     downloaded: cappedDownloaded,
                     total: totalBytes,
                     percentage: calculatePercentage(cappedDownloaded, totalBytes),
-                    downloadKey: progressContext.downloadKey,
+                    downloadKey: progressContext.downloadKey
                 };
                 if (progressContext.shardInfo) {
                     const currentOverall = progressContext.shardInfo.overallDownloaded + cappedDownloaded;
@@ -297,10 +296,9 @@ async function downloadAndValidateFile(drive, sourceFileName, targetFilePath, ex
                             overallDownloaded: currentOverall,
                             overallTotal: progressContext.shardInfo.overallTotal,
                             overallPercentage: progressContext.shardInfo.overallTotal > 0
-                                ? (currentOverall / progressContext.shardInfo.overallTotal) *
-                                    100
-                                : 0,
-                        },
+                                ? (currentOverall / progressContext.shardInfo.overallTotal) * 100
+                                : 0
+                        }
                     });
                 }
                 else {
@@ -309,7 +307,7 @@ async function downloadAndValidateFile(drive, sourceFileName, targetFilePath, ex
             }
         }
     };
-    blobs.core.on("download", progressHandler);
+    blobs.core.on('download', progressHandler);
     let readStream;
     let writeStream;
     try {
@@ -319,12 +317,12 @@ async function downloadAndValidateFile(drive, sourceFileName, targetFilePath, ex
         writeStream = fs.createWriteStream(targetFilePath);
         readStream.pipe(writeStream);
         await new Promise((resolve, reject) => {
-            writeStream.on("finish", resolve);
-            writeStream.on("error", reject);
-            readStream.on("error", reject);
-            signal?.addEventListener("abort", () => reject(new DownloadCancelledError()), { once: true });
+            writeStream.on('finish', resolve);
+            writeStream.on('error', reject);
+            readStream.on('error', reject);
+            signal?.addEventListener('abort', () => reject(new DownloadCancelledError()), { once: true });
         });
-        blobs.core.off("download", progressHandler);
+        blobs.core.off('download', progressHandler);
         // Validate file size
         const stats = await fsPromises.stat(targetFilePath);
         if (stats.size !== fileSizeToValidate) {
@@ -349,7 +347,7 @@ async function downloadAndValidateFile(drive, sourceFileName, targetFilePath, ex
         if (writeStream) {
             writeStream.destroy();
         }
-        blobs.core.off("download", progressHandler);
+        blobs.core.off('download', progressHandler);
         throw error;
     }
 }
@@ -374,7 +372,7 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
             const overallTotal = shardMetadata.reduce((sum, shard) => sum + shard.expectedSize, 0);
             const lastFile = allFiles[allFiles.length - 1];
             progressCallback({
-                type: "modelProgress",
+                type: 'modelProgress',
                 downloaded: overallTotal,
                 total: overallTotal,
                 percentage: 100,
@@ -385,8 +383,8 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
                     shardName: lastFile,
                     overallDownloaded: overallTotal,
                     overallTotal,
-                    overallPercentage: 100,
-                },
+                    overallPercentage: 100
+                }
             });
         }
         await extractTensorsFromShards(shardDir, firstShardFileName);
@@ -398,13 +396,13 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
     const corestoreDir = getCorestoreDir(hyperdriveKey);
     const setup = await setupHyperdrive(hyperdriveKey, corestoreDir);
     const cleanup = () => {
-        logger.info("🛑 Aborting sharded hyperdrive download...");
+        logger.info('🛑 Aborting sharded hyperdrive download...');
         setup.swarm.suspended = true;
         setup.swarm.suspend().catch(() => {
             // Ignore errors during emergency suspend
         });
     };
-    signal?.addEventListener("abort", cleanup);
+    signal?.addEventListener('abort', cleanup);
     let downloadSucceeded = false;
     try {
         // Calculate overall progress
@@ -425,7 +423,7 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
                 // Report progress for skipped files
                 if (progressCallback) {
                     progressCallback({
-                        type: "modelProgress",
+                        type: 'modelProgress',
                         downloaded: fileMeta.expectedSize,
                         total: fileMeta.expectedSize,
                         percentage: 100,
@@ -436,8 +434,8 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
                             shardName: file,
                             overallDownloaded,
                             overallTotal,
-                            overallPercentage: calculatePercentage(overallDownloaded, overallTotal),
-                        },
+                            overallPercentage: calculatePercentage(overallDownloaded, overallTotal)
+                        }
                     });
                 }
                 continue;
@@ -452,8 +450,8 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
                         totalShards: allFiles.length,
                         shardName: file,
                         overallDownloaded,
-                        overallTotal,
-                    },
+                        overallTotal
+                    }
                 }
                 : undefined;
             await downloadAndValidateFile(setup.drive, file, filePath, fileMeta.expectedSize, fileMeta.sha256Checksum, progressContext, signal, hooks);
@@ -466,7 +464,7 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
         if (progressCallback && overallDownloaded === overallTotal) {
             const lastFile = allFiles[allFiles.length - 1];
             progressCallback({
-                type: "modelProgress",
+                type: 'modelProgress',
                 downloaded: overallTotal,
                 total: overallTotal,
                 percentage: 100,
@@ -477,15 +475,15 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
                     shardName: lastFile,
                     overallDownloaded,
                     overallTotal,
-                    overallPercentage: 100,
-                },
+                    overallPercentage: 100
+                }
             });
         }
         await extractTensorsFromShards(shardDir, firstShardFileName);
         downloadSucceeded = true;
     }
     catch (error) {
-        logger.error("❌ Error during sharded hyperdrive download:", error instanceof Error ? error.message : String(error));
+        logger.error('❌ Error during sharded hyperdrive download:', error instanceof Error ? error.message : String(error));
         // Preserve cancellation errors
         if (error instanceof DownloadCancelledError) {
             throw error;
@@ -493,7 +491,7 @@ async function downloadShardedFilesToFilesystem(hyperdriveKey, firstShardFileNam
         throw new HyperdriveDownloadFailedError(`Sharded download failed for ${firstShardFileName} from hyperdrive: ${hyperdriveKey}`, error);
     }
     finally {
-        signal?.removeEventListener("abort", cleanup);
+        signal?.removeEventListener('abort', cleanup);
         if (!seed) {
             await cleanupHyperdrive(setup);
             // Delete only after close - Windows EBUSY on LOCK if deleted before corestore.close()
@@ -524,7 +522,7 @@ export async function downloadModelFromHyperdrive(hyperdriveKey, modelFileName,
                 markCacheMiss: () => {
                     hooks?.markCacheMiss?.();
                     ctx.setCacheHit(false);
-                },
+                }
             };
             return downloadShardedFilesToFilesystem(hyperdriveKey, modelFileName, model.shardMetadata, ctx.broadcastProgress, seed, ctx.signal, hooksWithCacheHit, ctx.shouldClearCache);
         }
@@ -540,11 +538,11 @@ export async function downloadModelFromHyperdrive(hyperdriveKey, modelFileName,
                 hooks?.markCacheHit?.();
                 ctx.setCacheHit(true);
                 ctx.broadcastProgress({
-                    type: "modelProgress",
+                    type: 'modelProgress',
                     downloaded: model.expectedSize,
                     total: model.expectedSize,
                     percentage: 100,
-                    downloadKey,
+                    downloadKey
                 });
                 // Delete any leftover corestore directory from previous runs (only when not seeding)
                 if (!seed) {
@@ -555,7 +553,7 @@ export async function downloadModelFromHyperdrive(hyperdriveKey, modelFileName,
         }
         hooks?.markCacheMiss?.();
         ctx.setCacheHit(false);
-        const checksumToValidate = expectedChecksum || model?.sha256Checksum || "";
+        const checksumToValidate = expectedChecksum || model?.sha256Checksum || '';
         await downloadSingleFileToFilesystem(modelPath, modelFileName, hyperdriveKey, corestoreDir, downloadKey, checksumToValidate, ctx.broadcastProgress, seed, ctx.signal, hooks, ctx.shouldClearCache);
         return modelPath;
     }, progressCallback, hooks?.requestBinding);

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

@@ -1,3 +1,3 @@
-export { handleLoadModel } from "./handler";
-export { resolveModelPath } from "./resolve";
+export { handleLoadModel } from './handler';
+export { resolveModelPath } from './resolve';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,2 +1,2 @@
-export { handleLoadModel } from "./handler.js";
-export { resolveModelPath } from "./resolve.js";
+export { handleLoadModel } from './handler.js';
+export { resolveModelPath } from './resolve.js';

package/dist/server/rpc/handlers/load-model/registry-client-options.d.ts

@@ -1,4 +1,4 @@
-import type { QvacConfig } from "../../../../schemas/index";
+import type { QvacConfig } from '../../../../schemas/index';
 export declare const DEFAULT_REGISTRY_STREAM_TIMEOUT_MS = 60000;
 export interface RegistryClientDownloadOptions {
     timeout: number;
@@ -16,7 +16,7 @@ export interface RegistryClientDownloadOptions {
  * unit-tested without standing up a real registry client.
  */
 export declare function buildRegistryClientOptions(params: {
-    sdkConfig: Pick<QvacConfig, "registryStreamTimeoutMs" | "registryDownloadMaxRetries">;
+    sdkConfig: Pick<QvacConfig, 'registryStreamTimeoutMs' | 'registryDownloadMaxRetries'>;
     outputFile: string;
     onProgress?: ((progress: {
         downloaded: number;

package/dist/server/rpc/handlers/load-model/registry-client-options.js

@@ -6,14 +6,13 @@ export const DEFAULT_REGISTRY_STREAM_TIMEOUT_MS = 60_000;
  */
 export function buildRegistryClientOptions(params) {
     const { sdkConfig, outputFile, onProgress, signal } = params;
-    const timeout = sdkConfig.registryStreamTimeoutMs
-        ?? DEFAULT_REGISTRY_STREAM_TIMEOUT_MS;
+    const timeout = sdkConfig.registryStreamTimeoutMs ?? DEFAULT_REGISTRY_STREAM_TIMEOUT_MS;
     const maxRetries = sdkConfig.registryDownloadMaxRetries;
     return {
         timeout,
         outputFile,
         ...(maxRetries !== undefined && { maxRetries }),
         ...(onProgress && { onProgress }),
-        ...(signal && { signal: signal }),
+        ...(signal && { signal: signal })
     };
 }

package/dist/server/rpc/handlers/load-model/registry-companion-set.d.ts

@@ -1,8 +1,8 @@
-import type { ModelProgressUpdate } from "../../../../schemas/index";
-import type { RegistryItem } from "../../../../models/registry/index";
-import type { AbortSignal } from "bare-abort-controller";
-import type { DownloadHooks } from "./types";
-type CompanionSetMetadata = NonNullable<RegistryItem["companionSet"]>;
+import type { ModelProgressUpdate } from '../../../../schemas/index';
+import type { RegistryItem } from '../../../../models/registry/index';
+import type { AbortSignal } from 'bare-abort-controller';
+import type { DownloadHooks } from './types';
+type CompanionSetMetadata = NonNullable<RegistryItem['companionSet']>;
 export interface DownloadCompanionSetOptions {
     companionSet: CompanionSetMetadata;
     downloadKey: string;

package/dist/server/rpc/handlers/load-model/registry-companion-set.js

@@ -1,10 +1,10 @@
-import { promises as fsPromises } from "bare-fs";
-import { getModelsCacheDir, getCompanionSetPath, getCompanionSetCacheDir, getSingleFileCachePath, generateShortHash, calculatePercentage, } from "../../../utils/index.js";
-import { measureChecksum } from "../../../utils/checksum.js";
-import { validateAndJoinPath } from "../../../utils/path-security.js";
-import { buildBlobBinding, downloadSingleFileFromRegistry, validateCachedFile, } from "./registry-download-utils.js";
-import { DownloadCancelledError, RegistryDownloadFailedError, } from "../../../../utils/errors-server.js";
-import { getServerLogger } from "../../../../logging/index.js";
+import { promises as fsPromises } from 'bare-fs';
+import { getModelsCacheDir, getCompanionSetPath, getCompanionSetCacheDir, getSingleFileCachePath, generateShortHash, calculatePercentage } from '../../../utils/index.js';
+import { measureChecksum } from '../../../utils/checksum.js';
+import { validateAndJoinPath } from '../../../utils/path-security.js';
+import { buildBlobBinding, downloadSingleFileFromRegistry, validateCachedFile } from './registry-download-utils.js';
+import { DownloadCancelledError, RegistryDownloadFailedError } from '../../../../utils/errors-server.js';
+import { getServerLogger } from '../../../../logging/index.js';
 const logger = getServerLogger();
 /**
  * Download a companion set from the registry, placing files directly
@@ -13,7 +13,7 @@ const logger = getServerLogger();
  * Returns the path to the primary file.
  */
 export async function downloadCompanionSetFromRegistry(options) {
-    const { companionSet, downloadKey, allowLegacyFlatCache = false, progressCallback, signal, hooks, shouldClearCache, } = options;
+    const { companionSet, downloadKey, allowLegacyFlatCache = false, progressCallback, signal, hooks, shouldClearCache } = options;
     const { files, setKey, primaryKey } = companionSet;
     validateCompanionSetMetadata(files, primaryKey);
     const primaryEntry = files.find((f) => f.key === primaryKey);
@@ -79,14 +79,12 @@ export async function downloadCompanionSetFromRegistry(options) {
                             totalFiles: files.length,
                             overallDownloaded: currentOverall,
                             overallTotal,
-                            overallPercentage: calculatePercentage(currentOverall, overallTotal),
-                        },
+                            overallPercentage: calculatePercentage(currentOverall, overallTotal)
+                        }
                     });
                 }
                 : undefined;
-            const blobBinding = file.blobCoreKey
-                ? buildBlobBinding(file)
-                : undefined;
+            const blobBinding = file.blobCoreKey ? buildBlobBinding(file) : undefined;
             await downloadSingleFileFromRegistry(file.registryPath, file.registrySource, filePath, file.targetName, downloadKey, file.expectedSize, file.sha256Checksum, fileProgressCallback, signal, blobBinding, hooks);
             overallDownloaded += file.expectedSize;
         }
@@ -96,13 +94,13 @@ export async function downloadCompanionSetFromRegistry(options) {
             try {
                 await fsPromises.rm(getCompanionSetCacheDir(setKey), {
                     recursive: true,
-                    force: true,
+                    force: true
                 });
             }
             catch (cleanupError) {
-                logger.debug("Failed to delete companion set cache during cleanup", {
+                logger.debug('Failed to delete companion set cache during cleanup', {
                     setKey,
-                    error: cleanupError,
+                    error: cleanupError
                 });
             }
         }
@@ -117,7 +115,7 @@ function emitFinalProgress(progressCallback, downloadKey, setKey, files) {
     const overallTotal = files.reduce((sum, f) => sum + f.expectedSize, 0);
     const lastFile = files[files.length - 1];
     progressCallback({
-        type: "modelProgress",
+        type: 'modelProgress',
         downloaded: overallTotal,
         total: overallTotal,
         percentage: 100,
@@ -129,8 +127,8 @@ function emitFinalProgress(progressCallback, downloadKey, setKey, files) {
             totalFiles: files.length,
             overallDownloaded: overallTotal,
             overallTotal,
-            overallPercentage: 100,
-        },
+            overallPercentage: 100
+        }
     });
 }
 function validateCompanionSetMetadata(files, primaryKey) {
@@ -146,7 +144,7 @@ function validateCompanionSetMetadata(files, primaryKey) {
     }
 }
 function isLegacyOnnxSet(files) {
-    return files.some((f) => f.primary === true && f.targetName.endsWith(".onnx"));
+    return files.some((f) => f.primary === true && f.targetName.endsWith('.onnx'));
 }
 /**
  * Check if a complete legacy ONNX cache exists for a companion set.
@@ -178,7 +176,7 @@ async function checkLegacyOnnxCache(primaryRegistryPath, files, hooks) {
 }
 function getLegacyOnnxPath(cacheKey, filename) {
     const baseCache = getModelsCacheDir();
-    return validateAndJoinPath(baseCache, "onnx", cacheKey, filename);
+    return validateAndJoinPath(baseCache, 'onnx', cacheKey, filename);
 }
 /**
  * Check if all companion files exist in the flat single-file cache.

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

@@ -1,9 +1,9 @@
-import type { ModelProgressUpdate } from "../../../../schemas/index";
-import type { QVACBlobBinding } from "@qvac/registry-client";
-import type { AbortSignal } from "bare-abort-controller";
-import type { DownloadHooks } from "./types";
-export { DEFAULT_REGISTRY_STREAM_TIMEOUT_MS, buildRegistryClientOptions, } from "./registry-client-options";
-export type { RegistryClientDownloadOptions } from "./registry-client-options";
+import type { ModelProgressUpdate } from '../../../../schemas/index';
+import type { QVACBlobBinding } from '@qvac/registry-client';
+import type { AbortSignal } from 'bare-abort-controller';
+import type { DownloadHooks } from './types';
+export { DEFAULT_REGISTRY_STREAM_TIMEOUT_MS, buildRegistryClientOptions } from './registry-client-options';
+export type { RegistryClientDownloadOptions } from './registry-client-options';
 export declare function buildBlobBinding(meta: {
     blobCoreKey: string;
     blobBlockOffset: number;