@runanywhere/web 0.1.0-beta.1

package/dist/Infrastructure/ExtensionRegistry.js

@@ -0,0 +1,41 @@
+/**
+ * Extension Registry - Manages SDK extension lifecycle
+ *
+ * Provides a centralised registry so that RunAnywhere.shutdown() does not
+ * need to hard-code every extension cleanup call.  Extensions are registered
+ * during SDK initialisation and cleaned up in reverse order on shutdown.
+ */
+// ---------------------------------------------------------------------------
+// Extension Registry Singleton
+// ---------------------------------------------------------------------------
+class ExtensionRegistryImpl {
+    extensions = [];
+    /** Register an extension. Call in dependency order (low-level first). */
+    register(extension) {
+        // Avoid double-registration (e.g. if initialize() is called twice)
+        if (!this.extensions.includes(extension)) {
+            this.extensions.push(extension);
+        }
+    }
+    /**
+     * Cleanup all registered extensions in reverse registration order.
+     * Each cleanup is individually wrapped in try-catch so one failure
+     * does not prevent the rest from being cleaned up.
+     */
+    cleanupAll() {
+        for (let i = this.extensions.length - 1; i >= 0; i--) {
+            try {
+                this.extensions[i].cleanup();
+            }
+            catch {
+                // Ignore errors during shutdown
+            }
+        }
+    }
+    /** Reset the registry (call after full shutdown). */
+    reset() {
+        this.extensions = [];
+    }
+}
+export const ExtensionRegistry = new ExtensionRegistryImpl();
+//# sourceMappingURL=ExtensionRegistry.js.map

package/dist/Infrastructure/ExtensionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionRegistry.js","sourceRoot":"","sources":["../../src/Infrastructure/ExtensionRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,qBAAqB;IACjB,UAAU,GAAmB,EAAE,CAAC;IAExC,yEAAyE;IACzE,QAAQ,CAAC,SAAuB;QAC9B,mEAAmE;QACnE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACrD,IAAI,CAAC;gBACH,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;CACF;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

package/dist/Infrastructure/ModelDownloader.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Model Downloader - Download orchestration with OPFS persistence
+ *
+ * Handles single-file and multi-file model downloads with progress tracking.
+ * Delegates all OPFS storage operations to the enhanced OPFSStorage class.
+ * Extracted from ModelManager to separate download concerns from load/catalog logic.
+ */
+import { OPFSStorage } from './OPFSStorage';
+import type { MetadataMap } from './OPFSStorage';
+import type { ManagedModel } from './ModelRegistry';
+import type { ModelRegistry } from './ModelRegistry';
+/** Candidate model that could be evicted to free space. */
+export interface EvictionCandidateInfo {
+    id: string;
+    name: string;
+    sizeBytes: number;
+    lastUsedAt: number;
+}
+/** Result of a pre-download quota check. */
+export interface QuotaCheckResult {
+    /** Whether the model fits in available storage without eviction. */
+    fits: boolean;
+    /** Currently available bytes (estimate). */
+    availableBytes: number;
+    /** Total bytes needed for the model (primary + additional files). */
+    neededBytes: number;
+    /**
+     * Models that could be evicted to free space, sorted by lastUsedAt ascending
+     * (least recently used first). Only populated when `fits` is false.
+     */
+    evictionCandidates: EvictionCandidateInfo[];
+}
+export declare class ModelDownloader {
+    private readonly storage;
+    private readonly registry;
+    /**
+     * In-memory fallback cache for models that were downloaded successfully
+     * but failed to persist to OPFS (e.g. storage quota exceeded).
+     * Keyed by modelId/file key. Cleared once the data is consumed by loadFromOPFS.
+     */
+    private readonly memoryCache;
+    constructor(registry: ModelRegistry, storage: OPFSStorage);
+    /**
+     * Check whether a model will fit in OPFS without eviction.
+     *
+     * Uses `navigator.storage.estimate()` for available space and compares
+     * against the model's total size (primary + additional files).
+     * If the model won't fit, returns eviction candidates sorted by LRU.
+     *
+     * @param model       - The model to check
+     * @param metadata    - LRU metadata map (lastUsedAt per model)
+     * @param loadedModelId - Currently loaded model ID (excluded from eviction)
+     */
+    checkStorageQuota(model: ManagedModel, metadata: MetadataMap, loadedModelId?: string): Promise<QuotaCheckResult>;
+    /**
+     * Download a model (and any additional companion files).
+     * Handles both single-file and multi-file models.
+     */
+    downloadModel(modelId: string): Promise<void>;
+    /**
+     * Download a file from a URL with optional progress callback.
+     * Exposed so ModelManager can use it for on-demand file downloads during load.
+     *
+     * URLs are validated before fetching to prevent SSRF and enforce HTTPS.
+     */
+    downloadFile(url: string, onProgress?: (progress: number, bytesDownloaded: number, totalBytes: number) => void): Promise<Uint8Array>;
+    /** Store data in OPFS via OPFSStorage. Auto-evicts old models if quota is exceeded, falls back to in-memory cache. */
+    storeInOPFS(key: string, data: Uint8Array): Promise<void>;
+    /**
+     * Evict old models from OPFS to free space for a new model.
+     * Deletes models sorted by oldest-first until enough space is freed,
+     * skipping the model being stored AND any sibling files that belong
+     * to the same model (e.g. main model file and its mmproj companion).
+     *
+     * Sibling detection: files are siblings if one key is a prefix of
+     * the other, separated by "__" (e.g. "modelA" and "modelA__mmproj-...").
+     */
+    private evictOPFSModels;
+    /** Load data from OPFS via OPFSStorage, falling back to in-memory cache. */
+    loadFromOPFS(key: string): Promise<Uint8Array | null>;
+    /** Check existence in OPFS or in-memory cache. */
+    existsInOPFS(key: string): Promise<boolean>;
+    /** Check if data exists in actual OPFS storage (NOT memory cache). */
+    existsInActualOPFS(key: string): Promise<boolean>;
+    /** Delete from OPFS and memory cache. */
+    deleteFromOPFS(key: string): Promise<void>;
+    /** Get file size from OPFS without reading into memory. */
+    getOPFSFileSize(key: string): Promise<number | null>;
+    /**
+     * Build an OPFS key for additional files (e.g., mmproj).
+     * Uses `__` separator to avoid name collisions between
+     * a primary model FILE and a directory with the same name.
+     */
+    additionalFileKey(modelId: string, filename: string): string;
+    /** Emit a structured download progress event via EventBus */
+    private emitDownloadProgress;
+}
+//# sourceMappingURL=ModelDownloader.d.ts.map

package/dist/Infrastructure/ModelDownloader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelDownloader.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/ModelDownloader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,iBAAiB,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAMrD,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4CAA4C;AAC5C,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,4CAA4C;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,kBAAkB,EAAE,qBAAqB,EAAE,CAAC;CAC7C;AAkED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;gBAEjD,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,WAAW;IASzD;;;;;;;;;;OAUG;IACG,iBAAiB,CACrB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,WAAW,EACrB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,CAAC;IAmD5B;;;OAGG;IACG,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyGnD;;;;;OAKG;IACG,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GACnF,OAAO,CAAC,UAAU,CAAC;IA+BtB,sHAAsH;IAChH,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAuC/D;;;;;;;;OAQG;YACW,eAAe;IAmD7B,4EAA4E;IACtE,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA6B3D,kDAAkD;IAC5C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKjD,sEAAsE;IAChE,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,yCAAyC;IACnC,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD,2DAA2D;IACrD,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ1D;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI5D,6DAA6D;IAC7D,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/Infrastructure/ModelDownloader.js

@@ -0,0 +1,431 @@
+/**
+ * Model Downloader - Download orchestration with OPFS persistence
+ *
+ * Handles single-file and multi-file model downloads with progress tracking.
+ * Delegates all OPFS storage operations to the enhanced OPFSStorage class.
+ * Extracted from ModelManager to separate download concerns from load/catalog logic.
+ */
+import { EventBus } from '../Foundation/EventBus';
+import { SDKLogger } from '../Foundation/SDKLogger';
+import { ModelStatus, DownloadStage, SDKEventType } from '../types/enums';
+// ---------------------------------------------------------------------------
+// Model Downloader
+// ---------------------------------------------------------------------------
+/**
+ * Validate that a URL is safe to fetch from.
+ *
+ * Security: Prevents SSRF-like attacks where user-controlled model URLs
+ * could be pointed at internal/private network addresses. Only HTTPS is
+ * allowed in production. HTTP is permitted for localhost during development.
+ *
+ * @param url - The URL to validate
+ * @throws Error if the URL is not allowed
+ */
+function validateModelUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid model URL: ${url}`);
+    }
+    // Only allow HTTPS (and HTTP for localhost during development)
+    const isLocalhost = parsed.hostname === 'localhost' ||
+        parsed.hostname === '127.0.0.1' ||
+        parsed.hostname === '[::1]';
+    if (parsed.protocol === 'http:' && !isLocalhost) {
+        throw new Error(`Model URL must use HTTPS (got HTTP for ${parsed.hostname}). ` +
+            'HTTP is only allowed for localhost during development.');
+    }
+    if (parsed.protocol !== 'https:' && parsed.protocol !== 'http:') {
+        throw new Error(`Model URL has unsupported protocol: ${parsed.protocol}`);
+    }
+    // Block common private/internal network ranges
+    const blockedPatterns = [
+        /^10\./,
+        /^172\.(1[6-9]|2\d|3[0-1])\./,
+        /^192\.168\./,
+        /^169\.254\./,
+        /^0\./,
+    ];
+    if (!isLocalhost) {
+        for (const pattern of blockedPatterns) {
+            if (pattern.test(parsed.hostname)) {
+                throw new Error(`Model URL points to private network address: ${parsed.hostname}`);
+            }
+        }
+    }
+}
+/**
+ * ModelDownloader — downloads model files (single or multi-file) and
+ * persists them in OPFS via `OPFSStorage`. Reports progress to the
+ * `ModelRegistry` and emits events via `EventBus`.
+ */
+const logger = new SDKLogger('ModelDownloader');
+export class ModelDownloader {
+    storage;
+    registry;
+    /**
+     * In-memory fallback cache for models that were downloaded successfully
+     * but failed to persist to OPFS (e.g. storage quota exceeded).
+     * Keyed by modelId/file key. Cleared once the data is consumed by loadFromOPFS.
+     */
+    memoryCache = new Map();
+    constructor(registry, storage) {
+        this.registry = registry;
+        this.storage = storage;
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Check whether a model will fit in OPFS without eviction.
+     *
+     * Uses `navigator.storage.estimate()` for available space and compares
+     * against the model's total size (primary + additional files).
+     * If the model won't fit, returns eviction candidates sorted by LRU.
+     *
+     * @param model       - The model to check
+     * @param metadata    - LRU metadata map (lastUsedAt per model)
+     * @param loadedModelId - Currently loaded model ID (excluded from eviction)
+     */
+    async checkStorageQuota(model, metadata, loadedModelId) {
+        const { usedBytes, quotaBytes } = await this.storage.getStorageUsage();
+        const availableBytes = Math.max(0, quotaBytes - usedBytes);
+        // Estimate total download size
+        const neededBytes = model.memoryRequirement ?? 0;
+        if (availableBytes >= neededBytes) {
+            return { fits: true, availableBytes, neededBytes, evictionCandidates: [] };
+        }
+        // Not enough space — build eviction candidate list
+        const stored = await this.storage.listModels();
+        const keepBase = model.id.split('__')[0];
+        const candidates = [];
+        for (const s of stored) {
+            // Skip the model being downloaded and its siblings
+            const storedBase = s.id.split('__')[0];
+            if (storedBase === keepBase)
+                continue;
+            // Skip currently loaded model
+            if (loadedModelId && s.id === loadedModelId)
+                continue;
+            // Skip metadata file
+            if (s.id === '_metadata.json')
+                continue;
+            const registered = this.registry.getModel(s.id) ?? this.registry.getModel(storedBase);
+            candidates.push({
+                id: storedBase,
+                name: registered?.name ?? s.id,
+                sizeBytes: s.sizeBytes,
+                lastUsedAt: metadata[storedBase]?.lastUsedAt ?? s.lastModified,
+            });
+        }
+        // Deduplicate by base id (main model + companion files combined)
+        const deduped = new Map();
+        for (const c of candidates) {
+            const existing = deduped.get(c.id);
+            if (existing) {
+                existing.sizeBytes += c.sizeBytes;
+            }
+            else {
+                deduped.set(c.id, { ...c });
+            }
+        }
+        // Sort by least-recently-used first
+        const sorted = [...deduped.values()].sort((a, b) => a.lastUsedAt - b.lastUsedAt);
+        return { fits: false, availableBytes, neededBytes, evictionCandidates: sorted };
+    }
+    /**
+     * Download a model (and any additional companion files).
+     * Handles both single-file and multi-file models.
+     */
+    async downloadModel(modelId) {
+        const model = this.registry.getModel(modelId);
+        if (!model)
+            return;
+        this.registry.updateModel(modelId, { status: ModelStatus.Downloading, downloadProgress: 0 });
+        EventBus.shared.emit('model.downloadStarted', SDKEventType.Model, { modelId, url: model.url });
+        try {
+            const totalFiles = 1 + (model.additionalFiles?.length ?? 0);
+            let totalBytesDownloaded = 0;
+            let totalBytesExpected = 0;
+            // Download the primary file
+            const primaryData = await this.downloadFile(model.url, (progress, bytesDown, bytesTotal) => {
+                totalBytesDownloaded = bytesDown;
+                totalBytesExpected = bytesTotal * totalFiles; // rough estimate
+                const overallProgress = progress / totalFiles;
+                this.registry.updateModel(modelId, { downloadProgress: overallProgress });
+                this.emitDownloadProgress({
+                    modelId,
+                    stage: DownloadStage.Downloading,
+                    progress: overallProgress,
+                    bytesDownloaded: totalBytesDownloaded,
+                    totalBytes: totalBytesExpected,
+                    currentFile: model.url.split('/').pop(),
+                    filesCompleted: 0,
+                    filesTotal: totalFiles,
+                });
+            });
+            await this.storeInOPFS(modelId, primaryData);
+            // Download additional files (e.g., mmproj for VLM)
+            if (model.additionalFiles && model.additionalFiles.length > 0) {
+                for (let i = 0; i < model.additionalFiles.length; i++) {
+                    const file = model.additionalFiles[i];
+                    const fileKey = this.additionalFileKey(modelId, file.filename);
+                    const fileData = await this.downloadFile(file.url, (progress, bytesDown, bytesTotal) => {
+                        const baseProgress = (1 + i) / totalFiles;
+                        const fileProgress = progress / totalFiles;
+                        const overallProgress = baseProgress + fileProgress;
+                        this.registry.updateModel(modelId, { downloadProgress: overallProgress });
+                        this.emitDownloadProgress({
+                            modelId,
+                            stage: DownloadStage.Downloading,
+                            progress: overallProgress,
+                            bytesDownloaded: bytesDown,
+                            totalBytes: bytesTotal,
+                            currentFile: file.filename,
+                            filesCompleted: 1 + i,
+                            filesTotal: totalFiles,
+                        });
+                    });
+                    await this.storeInOPFS(fileKey, fileData);
+                }
+            }
+            // Validating stage
+            this.emitDownloadProgress({
+                modelId,
+                stage: DownloadStage.Validating,
+                progress: 0.95,
+                bytesDownloaded: totalBytesDownloaded,
+                totalBytes: totalBytesExpected,
+                filesCompleted: totalFiles,
+                filesTotal: totalFiles,
+            });
+            let totalSize = primaryData.length;
+            if (model.additionalFiles) {
+                for (const file of model.additionalFiles) {
+                    const fileKey = this.additionalFileKey(modelId, file.filename);
+                    const size = await this.storage.getFileSize(fileKey);
+                    if (size !== null)
+                        totalSize += size;
+                }
+            }
+            this.registry.updateModel(modelId, {
+                status: ModelStatus.Downloaded,
+                downloadProgress: 1,
+                sizeBytes: totalSize,
+            });
+            // Completed stage
+            this.emitDownloadProgress({
+                modelId,
+                stage: DownloadStage.Completed,
+                progress: 1,
+                bytesDownloaded: totalSize,
+                totalBytes: totalSize,
+                filesCompleted: totalFiles,
+                filesTotal: totalFiles,
+            });
+            EventBus.shared.emit('model.downloadCompleted', SDKEventType.Model, { modelId, sizeBytes: totalSize });
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            this.registry.updateModel(modelId, { status: ModelStatus.Error, error: message });
+            EventBus.shared.emit('model.downloadFailed', SDKEventType.Model, { modelId, error: message });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // OPFS delegation helpers (used by ModelManager for load-time operations)
+    // ---------------------------------------------------------------------------
+    /**
+     * Download a file from a URL with optional progress callback.
+     * Exposed so ModelManager can use it for on-demand file downloads during load.
+     *
+     * URLs are validated before fetching to prevent SSRF and enforce HTTPS.
+     */
+    async downloadFile(url, onProgress) {
+        validateModelUrl(url);
+        const response = await fetch(url);
+        if (!response.ok)
+            throw new Error(`HTTP ${response.status} for ${url}`);
+        const total = Number(response.headers.get('content-length') || 0);
+        const reader = response.body?.getReader();
+        if (!reader)
+            throw new Error('No response body');
+        const chunks = [];
+        let received = 0;
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            chunks.push(value);
+            received += value.length;
+            const progress = total > 0 ? received / total : 0;
+            onProgress?.(progress, received, total);
+        }
+        const data = new Uint8Array(received);
+        let offset = 0;
+        for (const chunk of chunks) {
+            data.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return data;
+    }
+    /** Store data in OPFS via OPFSStorage. Auto-evicts old models if quota is exceeded, falls back to in-memory cache. */
+    async storeInOPFS(key, data) {
+        const sizeMB = (data.length / 1024 / 1024).toFixed(1);
+        try {
+            // First attempt
+            await this.storage.saveModel(key, data.buffer);
+            logger.info(`Stored ${key} in OPFS (${sizeMB} MB)`);
+            this.memoryCache.delete(key);
+            return;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            const isQuota = msg.toLowerCase().includes('quota');
+            if (!isQuota) {
+                // Non-quota error — fall back to memory cache directly
+                logger.warning(`OPFS store failed for "${key}": ${msg}`);
+                logger.info(`Caching "${key}" in memory (${sizeMB} MB) for current session`);
+                this.memoryCache.set(key, data);
+                return;
+            }
+            // Quota exceeded — try to evict old models and retry
+            logger.warning(`OPFS quota exceeded for "${key}" (${sizeMB} MB), evicting old models...`);
+            await this.evictOPFSModels(key, data.length);
+        }
+        // Retry after eviction
+        try {
+            await this.storage.saveModel(key, data.buffer);
+            logger.info(`Stored ${key} in OPFS after eviction (${sizeMB} MB)`);
+            this.memoryCache.delete(key);
+        }
+        catch (retryErr) {
+            const retryMsg = retryErr instanceof Error ? retryErr.message : String(retryErr);
+            logger.warning(`OPFS store still failed after eviction for "${key}": ${retryMsg}`);
+            logger.info(`Caching "${key}" in memory (${sizeMB} MB) for current session`);
+            this.memoryCache.set(key, data);
+        }
+    }
+    /**
+     * Evict old models from OPFS to free space for a new model.
+     * Deletes models sorted by oldest-first until enough space is freed,
+     * skipping the model being stored AND any sibling files that belong
+     * to the same model (e.g. main model file and its mmproj companion).
+     *
+     * Sibling detection: files are siblings if one key is a prefix of
+     * the other, separated by "__" (e.g. "modelA" and "modelA__mmproj-...").
+     */
+    async evictOPFSModels(keepKey, neededBytes) {
+        const stored = await this.storage.listModels();
+        if (stored.length === 0)
+            return;
+        // Extract the base model ID (everything before the first "__" separator).
+        // This links companion files: "modelA__mmproj-..." → base "modelA".
+        const keepBase = keepKey.split('__')[0];
+        // Sort by oldest first (least recently modified)
+        stored.sort((a, b) => a.lastModified - b.lastModified);
+        let freedBytes = 0;
+        for (const model of stored) {
+            // Never evict the file we're about to store
+            if (model.id === keepKey)
+                continue;
+            // Never evict internal metadata files
+            if (model.id === '_metadata.json')
+                continue;
+            // Never evict sibling files that belong to the same model.
+            // A stored file is a sibling if its base (before "__") matches keepBase,
+            // or if keepBase starts with the stored file's ID (the stored file IS
+            // the main model and we're storing a companion like mmproj).
+            const storedBase = model.id.split('__')[0];
+            if (storedBase === keepBase)
+                continue;
+            const sizeMBEvict = (model.sizeBytes / 1024 / 1024).toFixed(1);
+            logger.info(`Evicting "${model.id}" (${sizeMBEvict} MB) from OPFS`);
+            await this.storage.deleteModel(model.id);
+            // Also update registry status if this model is registered
+            const registered = this.registry.getModel(model.id);
+            if (registered && registered.status === ModelStatus.Downloaded) {
+                this.registry.updateModel(model.id, { status: ModelStatus.Registered });
+            }
+            // Emit event so UI can show a toast notification
+            EventBus.shared.emit('model.evicted', SDKEventType.Storage, {
+                modelId: model.id,
+                modelName: registered?.name ?? model.id,
+                freedBytes: model.sizeBytes,
+            });
+            freedBytes += model.sizeBytes;
+            if (freedBytes >= neededBytes) {
+                logger.info(`Evicted ${(freedBytes / 1024 / 1024).toFixed(1)} MB, should have room now`);
+                break;
+            }
+        }
+    }
+    /** Load data from OPFS via OPFSStorage, falling back to in-memory cache. */
+    async loadFromOPFS(key) {
+        // Try OPFS first (persistent storage)
+        const buffer = await this.storage.loadModel(key);
+        if (buffer && buffer.byteLength > 0) {
+            const sizeMB = buffer.byteLength / 1024 / 1024;
+            logger.debug(`Loading ${key} from OPFS (${sizeMB.toFixed(1)} MB)`);
+            return new Uint8Array(buffer);
+        }
+        // Clean up corrupted 0-byte OPFS entries
+        if (buffer && buffer.byteLength === 0) {
+            logger.warning(`OPFS entry for "${key}" is 0 bytes (corrupted), deleting`);
+            await this.deleteFromOPFS(key);
+        }
+        // Fall back to in-memory cache (populated when OPFS store failed, e.g. quota exceeded).
+        // IMPORTANT: Do NOT delete from cache here — the model may be unloaded and
+        // reloaded later (switching between models). Memory cache entries are only
+        // cleared on explicit model deletion via deleteFromOPFS().
+        const cached = this.memoryCache.get(key);
+        if (cached) {
+            const sizeMB = cached.length / 1024 / 1024;
+            logger.debug(`Loading ${key} from memory cache (${sizeMB.toFixed(1)} MB) — not persisted to OPFS`);
+            return cached;
+        }
+        return null;
+    }
+    /** Check existence in OPFS or in-memory cache. */
+    async existsInOPFS(key) {
+        if (this.memoryCache.has(key))
+            return true;
+        return this.storage.hasModel(key);
+    }
+    /** Check if data exists in actual OPFS storage (NOT memory cache). */
+    async existsInActualOPFS(key) {
+        return this.storage.hasModel(key);
+    }
+    /** Delete from OPFS and memory cache. */
+    async deleteFromOPFS(key) {
+        this.memoryCache.delete(key);
+        await this.storage.deleteModel(key);
+    }
+    /** Get file size from OPFS without reading into memory. */
+    async getOPFSFileSize(key) {
+        return this.storage.getFileSize(key);
+    }
+    // ---------------------------------------------------------------------------
+    // Helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Build an OPFS key for additional files (e.g., mmproj).
+     * Uses `__` separator to avoid name collisions between
+     * a primary model FILE and a directory with the same name.
+     */
+    additionalFileKey(modelId, filename) {
+        return `${modelId}__${filename}`;
+    }
+    /** Emit a structured download progress event via EventBus */
+    emitDownloadProgress(progress) {
+        EventBus.shared.emit('model.downloadProgress', SDKEventType.Model, {
+            modelId: progress.modelId,
+            progress: progress.progress,
+            bytesDownloaded: progress.bytesDownloaded,
+            totalBytes: progress.totalBytes,
+            stage: progress.stage,
+        });
+    }
+}
+//# sourceMappingURL=ModelDownloader.js.map

package/dist/Infrastructure/ModelDownloader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelDownloader.js","sourceRoot":"","sources":["../../src/Infrastructure/ModelDownloader.ts"],"names":[],"mappings":"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"}

package/dist/Infrastructure/ModelLoaderTypes.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Model Loader Interfaces
+ *
+ * Defines the contracts that model-loading extensions must implement.
+ * ModelManager depends on these interfaces (Infrastructure layer) rather
+ * than on the concrete extension objects in the Public layer, keeping the
+ * dependency flow correct: Public -> Infrastructure -> Foundation.
+ *
+ * Registrations are performed by the Public layer during SDK initialisation.
+ */
+import type { STTModelConfig } from '../Public/Extensions/STTTypes';
+import type { TTSVoiceConfig } from '../Public/Extensions/TTSTypes';
+import type { VADModelConfig } from '../Public/Extensions/VADTypes';
+/** Loader for LLM text generation models (RACommons WASM). */
+export interface LLMModelLoader {
+    loadModel(modelPath: string, modelId: string, modelName?: string): Promise<void>;
+    unloadModel(): Promise<void>;
+}
+/** Loader for STT models (sherpa-onnx). */
+export interface STTModelLoader {
+    loadModel(config: STTModelConfig): Promise<void>;
+    unloadModel(): Promise<void>;
+}
+/** Loader for TTS voice models (sherpa-onnx). */
+export interface TTSModelLoader {
+    loadVoice(config: TTSVoiceConfig): Promise<void>;
+    unloadVoice(): Promise<void>;
+}
+/** Loader for VAD models (sherpa-onnx). */
+export interface VADModelLoader {
+    loadModel(config: VADModelConfig): Promise<void>;
+    cleanup(): void;
+}
+//# sourceMappingURL=ModelLoaderTypes.d.ts.map

package/dist/Infrastructure/ModelLoaderTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelLoaderTypes.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/ModelLoaderTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAMpE,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/Infrastructure/ModelLoaderTypes.js

@@ -0,0 +1,12 @@
+/**
+ * Model Loader Interfaces
+ *
+ * Defines the contracts that model-loading extensions must implement.
+ * ModelManager depends on these interfaces (Infrastructure layer) rather
+ * than on the concrete extension objects in the Public layer, keeping the
+ * dependency flow correct: Public -> Infrastructure -> Foundation.
+ *
+ * Registrations are performed by the Public layer during SDK initialisation.
+ */
+export {};
+//# sourceMappingURL=ModelLoaderTypes.js.map

package/dist/Infrastructure/ModelLoaderTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModelLoaderTypes.js","sourceRoot":"","sources":["../../src/Infrastructure/ModelLoaderTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}