@qvac/sdk 0.18.2 → 0.19.0

package/dist/server/rpc/handlers/get-loaded-model-info.js

@@ -1,45 +0,0 @@
-import { getModelEntry } from '../../../server/bare/registry/model-registry.js';
-import { getPlugin } from '../../../server/plugins/registry.js';
-import { detectToolDialectFromName } from '../../../server/utils/tools/index.js';
-import { ModelNotFoundError } from '../../../utils/errors-server.js';
-import { getServerLogger } from '../../../logging/index.js';
-const logger = getServerLogger();
-export function handleGetLoadedModelInfo(request) {
-    const { modelId } = request;
-    const entry = getModelEntry(modelId);
-    if (!entry) {
-        throw new ModelNotFoundError(modelId);
-    }
-    if (entry.isDelegated) {
-        const info = {
-            modelId: entry.id,
-            isDelegated: true,
-            handlers: [],
-            providerInfo: {
-                providerPublicKey: entry.delegated.providerPublicKey
-            }
-        };
-        return { type: 'getLoadedModelInfo', info };
-    }
-    const plugin = getPlugin(entry.local.modelType);
-    if (!plugin) {
-        logger.warn(`getLoadedModelInfo: no plugin registered for modelType "${entry.local.modelType}" on loaded model "${modelId}"`);
-    }
-    const handlers = plugin ? Object.keys(plugin.handlers) : [];
-    const info = {
-        modelId: entry.id,
-        isDelegated: false,
-        modelType: entry.local.modelType,
-        handlers,
-        loadedAt: entry.local.loadedAt,
-        ...(plugin && { displayName: plugin.displayName }),
-        ...(plugin && { addonPackage: plugin.addonPackage }),
-        ...(entry.local.name && { name: entry.local.name }),
-        ...(entry.local.path && { path: entry.local.path }),
-        // Same detection the completion normalizer uses, so callers see the dialect it parses.
-        ...(handlers.includes('completionStream') && {
-            toolDialect: detectToolDialectFromName(entry.local.name, entry.local.path)
-        })
-    };
-    return { type: 'getLoadedModelInfo', info };
-}

package/dist/server/rpc/handlers/get-model-info.d.ts

@@ -1,3 +0,0 @@
-import type { GetModelInfoRequest, GetModelInfoResponse } from '../../../schemas/index.js';
-export declare function handleGetModelInfo(request: GetModelInfoRequest): Promise<GetModelInfoResponse>;
-//# sourceMappingURL=get-model-info.d.ts.map

package/dist/server/rpc/handlers/get-model-info.js

@@ -1,173 +0,0 @@
-import { models } from '../../../models/registry/models.js';
-import { getAllModelIds, getModelEntry } from '../../../server/bare/registry/model-registry.js';
-import { generateShortHash } from '../../../server/utils/index.js';
-import { promises as fsPromises } from 'bare-fs';
-import { getShardPath, getModelsCacheDir, getSingleFileCachePath } from '../../../server/utils/cache/paths.js';
-import { validateAndJoinPath } from '../../../server/utils/path-security.js';
-import { ModelNotFoundError } from '../../../utils/errors-server.js';
-export async function handleGetModelInfo(request) {
-    const { name } = request;
-    const catalogEntry = models.find((m) => m.name === name);
-    if (!catalogEntry) {
-        throw new ModelNotFoundError(`${name}" not found in catalog. Use model names from the catalog (e.g., "WHISPER_TINY", "EMBEDDINGGEMMA_300M_Q4_0")`);
-    }
-    const cacheKey = generateShortHash(catalogEntry.registryPath);
-    const cacheStatus = catalogEntry.shardMetadata && catalogEntry.shardMetadata.length > 0
-        ? await handleShardedModel(cacheKey, catalogEntry.shardMetadata)
-        : catalogEntry.companionSet
-            ? await handleCompanionSetModel(catalogEntry.companionSet, catalogEntry.registryPath, catalogEntry.addon)
-            : await handleSingleFileModel(catalogEntry.registryPath, catalogEntry.expectedSize, catalogEntry.sha256Checksum);
-    const { cacheFiles, isCached, actualSize, cachedAt, primaryPath } = cacheStatus;
-    const loadedModelIds = getAllModelIds();
-    const matchPath = primaryPath ?? cacheFiles[0]?.path;
-    const loadedInstances = [];
-    for (const id of loadedModelIds) {
-        const entry = getModelEntry(id);
-        if (!entry || entry.isDelegated)
-            continue;
-        const matchesByName = entry.local.name && entry.local.name === name;
-        const matchesByPath = !!matchPath && entry.local.path === matchPath;
-        if (matchesByName || matchesByPath) {
-            const instance = {
-                registryId: id,
-                loadedAt: entry.local.loadedAt,
-                config: entry.local.config
-            };
-            loadedInstances.push(instance);
-        }
-    }
-    const isLoaded = loadedInstances.length > 0;
-    const modelInfo = {
-        name: catalogEntry.name,
-        modelId: catalogEntry.modelId,
-        registryPath: catalogEntry.registryPath,
-        registrySource: catalogEntry.registrySource,
-        blobCoreKey: catalogEntry.blobCoreKey,
-        blobBlockOffset: catalogEntry.blobBlockOffset,
-        blobBlockLength: catalogEntry.blobBlockLength,
-        blobByteOffset: catalogEntry.blobByteOffset,
-        engine: catalogEntry.engine,
-        quantization: catalogEntry.quantization,
-        params: catalogEntry.params,
-        expectedSize: catalogEntry.expectedSize,
-        sha256Checksum: catalogEntry.sha256Checksum,
-        addon: catalogEntry.addon,
-        isCached,
-        isLoaded,
-        cacheFiles,
-        actualSize,
-        cachedAt,
-        loadedInstances: loadedInstances.length > 0 ? loadedInstances : undefined
-    };
-    return {
-        type: 'getModelInfo',
-        modelInfo
-    };
-}
-async function handleShardedModel(cacheKey, shardMetadata) {
-    const fileEntries = shardMetadata.map((s) => ({
-        filename: s.filename,
-        expectedSize: s.expectedSize,
-        sha256Checksum: s.sha256Checksum
-    }));
-    const paths = shardMetadata.map((s) => getShardPath(cacheKey, s.filename));
-    return checkCacheStatus(fileEntries, paths);
-}
-async function handleCompanionSetModel(companionSet, primaryRegistryPath, addon) {
-    const { setKey, primaryKey, files } = companionSet;
-    const baseCache = getModelsCacheDir();
-    const fileEntries = files.map((f) => ({
-        filename: f.targetName,
-        expectedSize: f.expectedSize,
-        sha256Checksum: f.sha256Checksum,
-        key: f.key
-    }));
-    const canonicalPaths = files.map((f) => validateAndJoinPath(baseCache, 'sets', setKey, f.targetName));
-    const canonicalResult = await checkCacheStatus(fileEntries, canonicalPaths, primaryKey);
-    if (canonicalResult.isCached)
-        return canonicalResult;
-    const isOnnxSet = files.some((f) => f.primary === true && f.targetName.endsWith('.onnx'));
-    if (isOnnxSet) {
-        const legacyCacheKey = generateShortHash(primaryRegistryPath);
-        const legacyPaths = files.map((f) => validateAndJoinPath(baseCache, 'onnx', legacyCacheKey, f.targetName));
-        const legacyResult = await checkCacheStatus(fileEntries, legacyPaths, primaryKey);
-        if (legacyResult.isCached)
-            return legacyResult;
-    }
-    else if (addon === 'nmt') {
-        // Legacy flat-cache compatibility for Bergamot-style companion sets.
-        // This is valid only for families whose runtime still works with explicit
-        // per-file absolute paths; it is not a generic rule for all companion sets.
-        const flatPaths = files.map((f) => getSingleFileCachePath(f.registryPath));
-        const flatResult = await checkCacheStatus(fileEntries, flatPaths, primaryKey);
-        if (flatResult.isCached)
-            return flatResult;
-    }
-    return canonicalResult;
-}
-async function checkCacheStatus(files, paths, primaryKey) {
-    const cacheFiles = [];
-    let allCached = true;
-    let totalActualSize = 0;
-    let latestCachedAt;
-    let primaryPath;
-    for (let i = 0; i < files.length; i++) {
-        const file = files[i];
-        const filePath = paths[i];
-        let fileCached = false;
-        let fileActualSize;
-        let fileCachedAt;
-        try {
-            const stats = await fsPromises.stat(filePath);
-            if (stats.isFile()) {
-                fileActualSize = stats.size;
-                fileCachedAt = stats.mtime;
-                fileCached = stats.size === file.expectedSize;
-            }
-        }
-        catch {
-            // file does not exist
-        }
-        if (primaryKey && file.key === primaryKey) {
-            primaryPath = filePath;
-        }
-        if (fileCached) {
-            totalActualSize += fileActualSize;
-            if (!latestCachedAt || fileCachedAt > latestCachedAt) {
-                latestCachedAt = fileCachedAt;
-            }
-        }
-        else {
-            allCached = false;
-        }
-        cacheFiles.push({
-            filename: file.filename,
-            path: filePath,
-            expectedSize: file.expectedSize,
-            sha256Checksum: file.sha256Checksum,
-            isCached: fileCached,
-            actualSize: fileActualSize,
-            cachedAt: fileCachedAt
-        });
-    }
-    if (!primaryPath && cacheFiles.length > 0) {
-        primaryPath = cacheFiles[0].path;
-    }
-    const result = {
-        cacheFiles,
-        isCached: allCached,
-        primaryPath
-    };
-    if (allCached) {
-        result.actualSize = totalActualSize;
-        if (latestCachedAt) {
-            result.cachedAt = latestCachedAt;
-        }
-    }
-    return result;
-}
-async function handleSingleFileModel(registryPath, expectedSize, sha256Checksum) {
-    const filename = registryPath.split('/').pop() || registryPath;
-    const filePath = getSingleFileCachePath(registryPath);
-    return checkCacheStatus([{ filename, expectedSize, sha256Checksum }], [filePath]);
-}

package/dist/server/rpc/handlers/get-system-resources.d.ts

@@ -1,3 +0,0 @@
-import type { GetSystemResourcesRequest, GetSystemResourcesResponse } from '../../../schemas/system-resources.js';
-export declare function handleGetSystemResources(request: GetSystemResourcesRequest): GetSystemResourcesResponse;
-//# sourceMappingURL=get-system-resources.d.ts.map

package/dist/server/rpc/handlers/get-system-resources.js

@@ -1,53 +0,0 @@
-import { getWorkerResourceCollector } from '../../../server/bare/resources/worker-collector.js';
-export function handleGetSystemResources(request) {
-    const collector = getWorkerResourceCollector();
-    if (!collector) {
-        return {
-            type: 'getSystemResources',
-            capabilities: {
-                cpu: {
-                    status: 'failed',
-                    reason: 'CPU resource collector is not initialized'
-                },
-                memory: {
-                    totalBytes: {
-                        status: 'failed',
-                        reason: 'CPU resource collector is not initialized'
-                    }
-                },
-                gpus: {
-                    status: 'failed',
-                    reason: 'GPU resource collector is not initialized'
-                }
-            },
-            ...(request.sample && {
-                sample: {
-                    sampledAt: Date.now(),
-                    cpu: {
-                        status: 'failed',
-                        reason: 'CPU resource collector is not initialized'
-                    },
-                    memory: {
-                        usedBytes: {
-                            status: 'failed',
-                            reason: 'CPU resource collector is not initialized'
-                        },
-                        totalBytes: {
-                            status: 'failed',
-                            reason: 'CPU resource collector is not initialized'
-                        }
-                    },
-                    gpus: {
-                        status: 'failed',
-                        reason: 'GPU resource collector is not initialized'
-                    }
-                }
-            })
-        };
-    }
-    return {
-        type: 'getSystemResources',
-        capabilities: collector.getCapabilities(),
-        ...(request.sample && { sample: collector.sample() })
-    };
-}

package/dist/server/rpc/handlers/heartbeat-delegated.d.ts

@@ -1,4 +0,0 @@
-import type { HeartbeatRequest, HeartbeatResponse } from '../../../schemas/index.js';
-import type { DelegatedHandlerOptions } from '../../../server/rpc/profiling/index.js';
-export declare function handleHeartbeatDelegated(request: HeartbeatRequest, options?: DelegatedHandlerOptions): Promise<HeartbeatResponse>;
-//# sourceMappingURL=heartbeat-delegated.d.ts.map

package/dist/server/rpc/handlers/heartbeat-delegated.js

@@ -1,32 +0,0 @@
-import { getServerLogger } from '../../../logging/index.js';
-import { getRPC } from '../../../server/bare/delegate-rpc-client.js';
-import { send } from '../../../server/rpc/delegate-transport.js';
-import { DelegateConnectionFailedError } from '../../../utils/errors-server.js';
-const logger = getServerLogger();
-export async function handleHeartbeatDelegated(request, options) {
-    const { delegate } = request;
-    if (!delegate) {
-        throw new DelegateConnectionFailedError('Delegated heartbeat handler called without delegate info');
-    }
-    const { providerPublicKey, timeout } = delegate;
-    try {
-        const rpc = await getRPC(providerPublicKey, { timeout });
-        const delegateOpts = {
-            peerKey: providerPublicKey
-        };
-        if (timeout !== undefined) {
-            delegateOpts.timeout = timeout;
-        }
-        if (options?.profilingMeta) {
-            delegateOpts.profilingMeta = options.profilingMeta;
-        }
-        // eslint-disable-next-line @typescript-eslint/no-unused-vars
-        const { delegate: _delegate, ...providerRequest } = request;
-        const response = await send(providerRequest, rpc, delegateOpts);
-        return response;
-    }
-    catch (error) {
-        logger.error('Error during delegated heartbeat:', error);
-        throw error;
-    }
-}

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

@@ -1,3 +0,0 @@
-import type { HeartbeatResponse } from '../../../schemas/index.js';
-export declare function handleHeartbeat(): HeartbeatResponse;
-//# sourceMappingURL=heartbeat.d.ts.map

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

@@ -1,3 +0,0 @@
-export function handleHeartbeat() {
-    return { type: 'heartbeat', number: Math.random() * 100 };
-}

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

@@ -1,76 +0,0 @@
-import { handleBatchCompletionStream } from './batch-completion-stream.js';
-import { handleCompletionOrchestrate } from './completion-orchestrate.js';
-import { handleCompletionStream } from './completion-stream.js';
-import { handleDownloadAsset } from './download-asset.js';
-import { handleLoadModel } from './load-model/index.js';
-import { handleUnloadModel } from './unload-model.js';
-import { handleEmbed } from './embed.js';
-import { handleTranscribe } from './transcribe.js';
-import { handleTranscribeStream } from './transcribe-stream.js';
-import { handleBciTranscribe } from './bci-transcribe.js';
-import { handleBciTranscribeStream } from './bci-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';
-import { cancelHandler } from './cancelHandler.js';
-import { handleDeleteCache } from './delete-cache.js';
-import { handleTextToSpeech } from './text-to-speech.js';
-import { handleTextToSpeechStream } from './text-to-speech-stream.js';
-import { handleGetModelInfo } from './get-model-info.js';
-import { handleGetLoadedModelInfo } from './get-loaded-model-info.js';
-import { handleGetSystemResources } from './get-system-resources.js';
-import { handleFinetune } from './finetune.js';
-import { handleOCRStream } from './ocr-stream.js';
-import { handleHeartbeat } from './heartbeat.js';
-import { handleDiffusionStream } from './diffusion-stream.js';
-import { handleVideoStream } from './video-stream.js';
-import { handleUpscaleStream } from './upscale-stream.js';
-import { handlePluginInvoke, handlePluginInvokeStream } from './plugin-invoke.js';
-import { handleModelRegistryList, handleModelRegistrySearch, handleModelRegistryGetModel } from './registry.js';
-import { handleSuspend } from './suspend.js';
-import { handleResume } from './resume.js';
-import { handleState } from './state.js';
-import { handleAudioGenStream } from '../../../server/rpc/handlers/audio-gen-stream.js';
-export declare const handlers: {
-    audioGenStream: typeof handleAudioGenStream;
-    heartbeat: typeof handleHeartbeat;
-    batchCompletionStream: typeof handleBatchCompletionStream;
-    completionStream: typeof handleCompletionStream;
-    completionOrchestrate: typeof handleCompletionOrchestrate;
-    downloadAsset: typeof handleDownloadAsset;
-    deleteCache: typeof handleDeleteCache;
-    loadModel: typeof handleLoadModel;
-    unloadModel: typeof handleUnloadModel;
-    embed: typeof handleEmbed;
-    transcribe: typeof handleTranscribe;
-    transcribeStream: typeof handleTranscribeStream;
-    bciTranscribe: typeof handleBciTranscribe;
-    bciTranscribeStream: typeof handleBciTranscribeStream;
-    provide: typeof provideHandler;
-    stopProvide: typeof stopProvideHandler;
-    translate: typeof handleTranslate;
-    loggingStream: typeof handleLoggingStream;
-    rag: typeof handleRag;
-    cancel: typeof cancelHandler;
-    textToSpeech: typeof handleTextToSpeech;
-    textToSpeechStream: typeof handleTextToSpeechStream;
-    getModelInfo: typeof handleGetModelInfo;
-    getLoadedModelInfo: typeof handleGetLoadedModelInfo;
-    getSystemResources: typeof handleGetSystemResources;
-    finetune: typeof handleFinetune;
-    ocrStream: typeof handleOCRStream;
-    diffusionStream: typeof handleDiffusionStream;
-    videoStream: typeof handleVideoStream;
-    upscaleStream: typeof handleUpscaleStream;
-    pluginInvoke: typeof handlePluginInvoke;
-    pluginInvokeStream: typeof handlePluginInvokeStream;
-    modelRegistryList: typeof handleModelRegistryList;
-    modelRegistrySearch: typeof handleModelRegistrySearch;
-    modelRegistryGetModel: typeof handleModelRegistryGetModel;
-    suspend: typeof handleSuspend;
-    resume: typeof handleResume;
-    state: typeof handleState;
-};
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,75 +0,0 @@
-import { handleBatchCompletionStream } from './batch-completion-stream.js';
-import { handleCompletionOrchestrate } from './completion-orchestrate.js';
-import { handleCompletionStream } from './completion-stream.js';
-import { handleDownloadAsset } from './download-asset.js';
-import { handleLoadModel } from './load-model/index.js';
-import { handleUnloadModel } from './unload-model.js';
-import { handleEmbed } from './embed.js';
-import { handleTranscribe } from './transcribe.js';
-import { handleTranscribeStream } from './transcribe-stream.js';
-import { handleBciTranscribe } from './bci-transcribe.js';
-import { handleBciTranscribeStream } from './bci-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';
-import { cancelHandler } from './cancelHandler.js';
-import { handleDeleteCache } from './delete-cache.js';
-import { handleTextToSpeech } from './text-to-speech.js';
-import { handleTextToSpeechStream } from './text-to-speech-stream.js';
-import { handleGetModelInfo } from './get-model-info.js';
-import { handleGetLoadedModelInfo } from './get-loaded-model-info.js';
-import { handleGetSystemResources } from './get-system-resources.js';
-import { handleFinetune } from './finetune.js';
-import { handleOCRStream } from './ocr-stream.js';
-import { handleHeartbeat } from './heartbeat.js';
-import { handleDiffusionStream } from './diffusion-stream.js';
-import { handleVideoStream } from './video-stream.js';
-import { handleUpscaleStream } from './upscale-stream.js';
-import { handlePluginInvoke, handlePluginInvokeStream } from './plugin-invoke.js';
-import { handleModelRegistryList, handleModelRegistrySearch, handleModelRegistryGetModel } from './registry.js';
-import { handleSuspend } from './suspend.js';
-import { handleResume } from './resume.js';
-import { handleState } from './state.js';
-import { handleAudioGenStream } from '../../../server/rpc/handlers/audio-gen-stream.js';
-export const handlers = {
-    audioGenStream: handleAudioGenStream,
-    heartbeat: handleHeartbeat,
-    batchCompletionStream: handleBatchCompletionStream,
-    completionStream: handleCompletionStream,
-    completionOrchestrate: handleCompletionOrchestrate,
-    downloadAsset: handleDownloadAsset,
-    deleteCache: handleDeleteCache,
-    loadModel: handleLoadModel,
-    unloadModel: handleUnloadModel,
-    embed: handleEmbed,
-    transcribe: handleTranscribe,
-    transcribeStream: handleTranscribeStream,
-    bciTranscribe: handleBciTranscribe,
-    bciTranscribeStream: handleBciTranscribeStream,
-    provide: provideHandler,
-    stopProvide: stopProvideHandler,
-    translate: handleTranslate,
-    loggingStream: handleLoggingStream,
-    rag: handleRag,
-    cancel: cancelHandler,
-    textToSpeech: handleTextToSpeech,
-    textToSpeechStream: handleTextToSpeechStream,
-    getModelInfo: handleGetModelInfo,
-    getLoadedModelInfo: handleGetLoadedModelInfo,
-    getSystemResources: handleGetSystemResources,
-    finetune: handleFinetune,
-    ocrStream: handleOCRStream,
-    diffusionStream: handleDiffusionStream,
-    videoStream: handleVideoStream,
-    upscaleStream: handleUpscaleStream,
-    pluginInvoke: handlePluginInvoke,
-    pluginInvokeStream: handlePluginInvokeStream,
-    modelRegistryList: handleModelRegistryList,
-    modelRegistrySearch: handleModelRegistrySearch,
-    modelRegistryGetModel: handleModelRegistryGetModel,
-    suspend: handleSuspend,
-    resume: handleResume,
-    state: handleState
-};

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

@@ -1,98 +0,0 @@
-import type { ModelProgressUpdate } from '../../../../schemas/index.js';
-import { AbortController, type AbortSignal } from 'bare-abort-controller';
-import type { DisposableScope } from '../../../../server/bare/runtime/disposable-scope.js';
-import type { DownloadHooks } from '../../../../server/rpc/handlers/load-model/types.js';
-/**
- * Per-subscriber binding to a registry-tracked request.
- * `startOrJoinDownload` is request-aware: each caller (the
- * `await using ctx = await registry.begin(...)` inside `handleLoadModel` /
- * `handleDownloadAsset`) registers a subscriber bound to its
- * `requestId`. A `cancel({ requestId })` against the registry aborts
- * the subscriber's `ctx.signal`, which:
- *   - rejects this subscriber's promise so the awaiting handler unwinds;
- *   - removes this subscriber from `transfer.subscribers`;
- *   - tears down the transfer iff this was the last subscriber.
- *
- * The shared-transfer dedup logic in `startOrJoinDownload` is preserved
- * — two callers requesting the same `downloadKey` still share one
- * underlying download — but cancel is per-`requestId`-honest:
- * cancelling one subscriber does not affect siblings on the same
- * `downloadKey`.
- */
-export interface SubscriberRequestBinding {
-    signal: AbortSignal;
-    scope: DisposableScope;
-    requestId: string;
-}
-export interface Subscriber {
-    id: string;
-    onProgress?: ((progress: ModelProgressUpdate) => void) | undefined;
-    settled: boolean;
-    resolve: (path: string) => void;
-    reject: (error: unknown) => void;
-    promise: Promise<string>;
-    /** Identity of the registry request this subscriber belongs to, if any. */
-    requestId?: string | undefined;
-}
-export interface Transfer {
-    downloadKey: string;
-    abortController: AbortController;
-    subscribers: Map<string, Subscriber>;
-    lastProgress?: ModelProgressUpdate | undefined;
-    downloadPromise?: Promise<string> | undefined;
-    clearCache: boolean;
-    cacheHit?: boolean;
-}
-export interface DownloadContext {
-    broadcastProgress: (progress: ModelProgressUpdate) => void;
-    signal: AbortSignal;
-    shouldClearCache: () => boolean;
-    setCacheHit: (cacheHit: boolean) => void;
-}
-export interface StartOrJoinResult {
-    promise: Promise<string>;
-    joined: boolean;
-    getCacheHit: () => boolean | undefined;
-}
-export declare function startOrJoinDownload(downloadKey: string, startDownload: (ctx: DownloadContext) => Promise<string>, onProgress?: (progress: ModelProgressUpdate) => void, request?: SubscriberRequestBinding): StartOrJoinResult;
-/**
- * Legacy cancel entry point. Callers (`cancelHandler`'s deprecated
- * `case "downloadAsset"` arm, the shutdown sweep, intra-resolve
- * cleanup) call this with a `downloadKey`. The single source of cancel
- * routing is the request registry, so this function resolves each
- * subscriber's request via `registry.cancel({ requestId })`.
- *
- * Subscribers without a `requestId` (legacy callers that didn't pass a
- * registry binding) are settled directly with `DownloadCancelledError`
- * so we don't leak the transfer if a legacy code path holds the only
- * reference.
- */
-/**
- * Set `clearCache=true` on the transfer that owns the subscriber bound
- * to `requestId`, so when the registry's targeted cancel removes that
- * subscriber and we reach last-subscriber teardown, the partial
- * download file is deleted instead of preserved for automatic resume.
- *
- * Lookup is O(transfers * subscribers); transfers are short-lived and
- * subscriber counts per transfer are tiny in practice, so this is
- * fine. Returns `true` if a matching subscriber was found, `false`
- * otherwise — the cancel handler treats both cases identically (the
- * registry cancel still fires) and the return value is informational.
- *
- * Added in 0.11.0 to support `cancel({ requestId, clearCache: true })`
- * for download requests after the wire schema collapse removed the
- * `{ operation: "downloadAsset", downloadKey, clearCache }` arm. The
- * subscriber is the unit of `clearCache` even though the flag lives on
- * the shared transfer: if any subscriber on the transfer asks for
- * clearCache, the partial file is deleted when the last subscriber
- * leaves, matching the pre-collapse behaviour.
- */
-export declare function markClearCacheForRequest(requestId: string): boolean;
-export declare function cancelTransfer(downloadKey: string, clearCache?: boolean): void;
-export declare function createHyperdriveDownloadKey(hyperdriveKey: string, modelFileName: string): string;
-export declare function createHttpDownloadKey(url: string): string;
-export declare function createRegistryDownloadKey(registrySource: string, registryPath: string): string;
-export declare function applyJoinedDownloadStats(result: StartOrJoinResult, hooks?: DownloadHooks): Promise<string>;
-export declare function cancelAllDownloads(): void;
-export declare function cleanupDownloads(): Promise<void>;
-//# sourceMappingURL=download-manager.d.ts.map