@runanywhere/web 0.1.0-beta.1

package/dist/Public/Extensions/RunAnywhere+Embeddings.d.ts

@@ -0,0 +1,56 @@
+/**
+ * RunAnywhere Web SDK - Embeddings Extension
+ *
+ * Adds text embedding generation capabilities via RACommons WASM.
+ * Uses the rac_embeddings_component_* C API for model lifecycle
+ * and embedding generation.
+ *
+ * Embeddings convert text into fixed-dimensional dense vectors
+ * useful for semantic search, clustering, and RAG.
+ *
+ * Backend: llama.cpp (GGUF embedding models like nomic-embed-text)
+ *
+ * Usage:
+ *   import { Embeddings } from '@runanywhere/web';
+ *
+ *   await Embeddings.loadModel('/models/nomic-embed-text-v1.5.Q4_K_M.gguf', 'nomic-embed');
+ *   const result = await Embeddings.embed('Hello, world!');
+ *   console.log('Dimension:', result.dimension);
+ *   console.log('Vector:', result.embeddings[0].data);
+ *
+ *   // Batch embedding
+ *   const batch = await Embeddings.embedBatch(['text1', 'text2', 'text3']);
+ */
+import type { EmbeddingsResult, EmbeddingsOptions } from './EmbeddingsTypes';
+export { EmbeddingsNormalize, EmbeddingsPooling, type EmbeddingVector, type EmbeddingsResult, type EmbeddingsOptions, } from './EmbeddingsTypes';
+declare class EmbeddingsImpl {
+    readonly extensionName = "Embeddings";
+    private _embeddingsComponentHandle;
+    private requireBridge;
+    private ensureEmbeddingsComponent;
+    /**
+     * Load an embedding model (GGUF format).
+     */
+    loadModel(modelPath: string, modelId: string, modelName?: string): Promise<void>;
+    /** Unload the embeddings model. */
+    unloadModel(): Promise<void>;
+    /** Check if an embeddings model is loaded. */
+    get isModelLoaded(): boolean;
+    /**
+     * Generate embedding for a single text.
+     */
+    embed(text: string, options?: EmbeddingsOptions): Promise<EmbeddingsResult>;
+    /**
+     * Generate embeddings for multiple texts at once.
+     */
+    embedBatch(texts: string[], options?: EmbeddingsOptions): Promise<EmbeddingsResult>;
+    /**
+     * Compute cosine similarity between two embedding vectors.
+     * Pure TypeScript utility -- no WASM call needed.
+     */
+    cosineSimilarity(a: Float32Array, b: Float32Array): number;
+    /** Clean up the embeddings component. */
+    cleanup(): void;
+}
+export declare const Embeddings: EmbeddingsImpl;
+//# sourceMappingURL=RunAnywhere+Embeddings.d.ts.map

package/dist/Public/Extensions/RunAnywhere+Embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunAnywhere+Embeddings.d.ts","sourceRoot":"","sources":["../../../src/Public/Extensions/RunAnywhere+Embeddings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AASH,OAAO,KAAK,EAEV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC;AAQ3B,cAAM,cAAc;IAClB,QAAQ,CAAC,aAAa,gBAAgB;IACtC,OAAO,CAAC,0BAA0B,CAAK;IAEvC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,yBAAyB;IAmBjC;;OAEG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BtF,mCAAmC;IAC7B,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAUlC,8CAA8C;IAC9C,IAAI,aAAa,IAAI,OAAO,CAO3B;IAED;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwCrF;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiD7F;;;OAGG;IACH,gBAAgB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM;IAgB1D,yCAAyC;IACzC,OAAO,IAAI,IAAI;CAUhB;AAED,eAAO,MAAM,UAAU,gBAAuB,CAAC"}

package/dist/Public/Extensions/RunAnywhere+Embeddings.js

@@ -0,0 +1,240 @@
+/**
+ * RunAnywhere Web SDK - Embeddings Extension
+ *
+ * Adds text embedding generation capabilities via RACommons WASM.
+ * Uses the rac_embeddings_component_* C API for model lifecycle
+ * and embedding generation.
+ *
+ * Embeddings convert text into fixed-dimensional dense vectors
+ * useful for semantic search, clustering, and RAG.
+ *
+ * Backend: llama.cpp (GGUF embedding models like nomic-embed-text)
+ *
+ * Usage:
+ *   import { Embeddings } from '@runanywhere/web';
+ *
+ *   await Embeddings.loadModel('/models/nomic-embed-text-v1.5.Q4_K_M.gguf', 'nomic-embed');
+ *   const result = await Embeddings.embed('Hello, world!');
+ *   console.log('Dimension:', result.dimension);
+ *   console.log('Vector:', result.embeddings[0].data);
+ *
+ *   // Batch embedding
+ *   const batch = await Embeddings.embedBatch(['text1', 'text2', 'text3']);
+ */
+import { RunAnywhere } from '../RunAnywhere';
+import { WASMBridge } from '../../Foundation/WASMBridge';
+import { Offsets } from '../../Foundation/StructOffsets';
+import { SDKError, SDKErrorCode } from '../../Foundation/ErrorTypes';
+import { SDKLogger } from '../../Foundation/SDKLogger';
+import { EventBus } from '../../Foundation/EventBus';
+import { SDKEventType } from '../../types/enums';
+export { EmbeddingsNormalize, EmbeddingsPooling, } from './EmbeddingsTypes';
+const logger = new SDKLogger('Embeddings');
+// ---------------------------------------------------------------------------
+// Embeddings Extension
+// ---------------------------------------------------------------------------
+class EmbeddingsImpl {
+    extensionName = 'Embeddings';
+    _embeddingsComponentHandle = 0;
+    requireBridge() {
+        if (!RunAnywhere.isInitialized)
+            throw SDKError.notInitialized();
+        return WASMBridge.shared;
+    }
+    ensureEmbeddingsComponent() {
+        if (this._embeddingsComponentHandle !== 0)
+            return this._embeddingsComponentHandle;
+        const bridge = this.requireBridge();
+        const m = bridge.module;
+        const handlePtr = m._malloc(4);
+        const result = bridge.callFunction('rac_embeddings_component_create', 'number', ['number'], [handlePtr]);
+        if (result !== 0) {
+            m._free(handlePtr);
+            bridge.checkResult(result, 'rac_embeddings_component_create');
+        }
+        this._embeddingsComponentHandle = m.getValue(handlePtr, 'i32');
+        m._free(handlePtr);
+        logger.debug('Embeddings component created');
+        return this._embeddingsComponentHandle;
+    }
+    /**
+     * Load an embedding model (GGUF format).
+     */
+    async loadModel(modelPath, modelId, modelName) {
+        const bridge = this.requireBridge();
+        const m = bridge.module;
+        const handle = this.ensureEmbeddingsComponent();
+        logger.info(`Loading embeddings model: ${modelId} from ${modelPath}`);
+        EventBus.shared.emit('model.loadStarted', SDKEventType.Model, { modelId, component: 'embeddings' });
+        const pathPtr = bridge.allocString(modelPath);
+        const idPtr = bridge.allocString(modelId);
+        const namePtr = bridge.allocString(modelName ?? modelId);
+        try {
+            const result = m.ccall('rac_embeddings_component_load_model', 'number', ['number', 'number', 'number', 'number'], [handle, pathPtr, idPtr, namePtr]);
+            bridge.checkResult(result, 'rac_embeddings_component_load_model');
+            logger.info(`Embeddings model loaded: ${modelId}`);
+            EventBus.shared.emit('model.loadCompleted', SDKEventType.Model, { modelId, component: 'embeddings' });
+        }
+        finally {
+            bridge.free(pathPtr);
+            bridge.free(idPtr);
+            bridge.free(namePtr);
+        }
+    }
+    /** Unload the embeddings model. */
+    async unloadModel() {
+        if (this._embeddingsComponentHandle === 0)
+            return;
+        const bridge = this.requireBridge();
+        const result = bridge.module.ccall('rac_embeddings_component_unload', 'number', ['number'], [this._embeddingsComponentHandle]);
+        bridge.checkResult(result, 'rac_embeddings_component_unload');
+        logger.info('Embeddings model unloaded');
+    }
+    /** Check if an embeddings model is loaded. */
+    get isModelLoaded() {
+        if (this._embeddingsComponentHandle === 0)
+            return false;
+        try {
+            return WASMBridge.shared.module.ccall('rac_embeddings_component_is_loaded', 'number', ['number'], [this._embeddingsComponentHandle]) === 1;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Generate embedding for a single text.
+     */
+    async embed(text, options = {}) {
+        const bridge = this.requireBridge();
+        const m = bridge.module;
+        const handle = this.ensureEmbeddingsComponent();
+        if (!this.isModelLoaded) {
+            throw new SDKError(SDKErrorCode.ModelNotLoaded, 'No embeddings model loaded. Call loadModel() first.');
+        }
+        logger.debug(`Embedding text (${text.length} chars)`);
+        const textPtr = bridge.allocString(text);
+        // Build rac_embeddings_options_t
+        const optSize = m._rac_wasm_sizeof_embeddings_options();
+        const optPtr = m._malloc(optSize);
+        const eOpt = Offsets.embeddingsOptions;
+        m.setValue(optPtr + eOpt.normalize, options.normalize !== undefined ? options.normalize : -1, 'i32');
+        m.setValue(optPtr + eOpt.pooling, options.pooling !== undefined ? options.pooling : -1, 'i32');
+        m.setValue(optPtr + eOpt.nThreads, 0, 'i32'); // n_threads = auto
+        // Result struct
+        const resSize = m._rac_wasm_sizeof_embeddings_result();
+        const resPtr = m._malloc(resSize);
+        try {
+            const r = m.ccall('rac_embeddings_component_embed', 'number', ['number', 'number', 'number', 'number'], [handle, textPtr, optPtr, resPtr]);
+            bridge.checkResult(r, 'rac_embeddings_component_embed');
+            return readEmbeddingsResult(bridge, m, resPtr);
+        }
+        finally {
+            bridge.free(textPtr);
+            m._free(optPtr);
+        }
+    }
+    /**
+     * Generate embeddings for multiple texts at once.
+     */
+    async embedBatch(texts, options = {}) {
+        const bridge = this.requireBridge();
+        const m = bridge.module;
+        const handle = this.ensureEmbeddingsComponent();
+        if (!this.isModelLoaded) {
+            throw new SDKError(SDKErrorCode.ModelNotLoaded, 'No embeddings model loaded. Call loadModel() first.');
+        }
+        logger.debug(`Embedding batch of ${texts.length} texts`);
+        // Allocate array of string pointers
+        const textPtrs = [];
+        const textArrayPtr = m._malloc(texts.length * 4);
+        for (let i = 0; i < texts.length; i++) {
+            const ptr = bridge.allocString(texts[i]);
+            textPtrs.push(ptr);
+            m.setValue(textArrayPtr + i * 4, ptr, '*');
+        }
+        // Options
+        const optSize = m._rac_wasm_sizeof_embeddings_options();
+        const optPtr = m._malloc(optSize);
+        const eOpt2 = Offsets.embeddingsOptions;
+        m.setValue(optPtr + eOpt2.normalize, options.normalize !== undefined ? options.normalize : -1, 'i32');
+        m.setValue(optPtr + eOpt2.pooling, options.pooling !== undefined ? options.pooling : -1, 'i32');
+        m.setValue(optPtr + eOpt2.nThreads, 0, 'i32');
+        // Result
+        const resSize = m._rac_wasm_sizeof_embeddings_result();
+        const resPtr = m._malloc(resSize);
+        try {
+            const r = m.ccall('rac_embeddings_component_embed_batch', 'number', ['number', 'number', 'number', 'number', 'number'], [handle, textArrayPtr, texts.length, optPtr, resPtr]);
+            bridge.checkResult(r, 'rac_embeddings_component_embed_batch');
+            return readEmbeddingsResult(bridge, m, resPtr);
+        }
+        finally {
+            for (const ptr of textPtrs)
+                bridge.free(ptr);
+            m._free(textArrayPtr);
+            m._free(optPtr);
+        }
+    }
+    /**
+     * Compute cosine similarity between two embedding vectors.
+     * Pure TypeScript utility -- no WASM call needed.
+     */
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length)
+            throw new Error('Vectors must have the same dimension');
+        let dot = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dot += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+        return denominator === 0 ? 0 : dot / denominator;
+    }
+    /** Clean up the embeddings component. */
+    cleanup() {
+        if (this._embeddingsComponentHandle !== 0) {
+            try {
+                WASMBridge.shared.module.ccall('rac_embeddings_component_destroy', null, ['number'], [this._embeddingsComponentHandle]);
+            }
+            catch { /* ignore */ }
+            this._embeddingsComponentHandle = 0;
+        }
+    }
+}
+export const Embeddings = new EmbeddingsImpl();
+// ---------------------------------------------------------------------------
+// Helper: Read rac_embeddings_result_t from WASM memory
+// ---------------------------------------------------------------------------
+function readEmbeddingsResult(bridge, m, resPtr) {
+    // rac_embeddings_result_t (offsets from compiler via StructOffsets)
+    const eRes = Offsets.embeddingsResult;
+    const embeddingsArrayPtr = m.getValue(resPtr + eRes.embeddings, '*');
+    const numEmbeddings = m.getValue(resPtr + eRes.numEmbeddings, 'i32');
+    const dimension = m.getValue(resPtr + eRes.dimension, 'i32');
+    const processingTimeMs = m.getValue(resPtr + eRes.processingTimeMs, 'i32'); // low 32 bits of int64
+    const totalTokens = m.getValue(resPtr + eRes.totalTokens, 'i32');
+    const embeddings = [];
+    const ev = Offsets.embeddingVector;
+    for (let i = 0; i < numEmbeddings; i++) {
+        // Each rac_embedding_vector_t
+        const vecPtr = embeddingsArrayPtr + i * ev.structSize;
+        const dataPtr = m.getValue(vecPtr + ev.data, '*');
+        const vecDim = m.getValue(vecPtr + ev.dimension, 'i32');
+        const data = new Float32Array(vecDim);
+        if (dataPtr && vecDim > 0) {
+            data.set(bridge.readFloat32Array(dataPtr, vecDim));
+        }
+        embeddings.push({ data, dimension: vecDim });
+    }
+    // Free C result
+    m.ccall('rac_embeddings_result_free', null, ['number'], [resPtr]);
+    EventBus.shared.emit('embeddings.generated', SDKEventType.Generation, {
+        numEmbeddings,
+        dimension,
+        processingTimeMs,
+    });
+    return { embeddings, dimension, processingTimeMs, totalTokens };
+}
+//# sourceMappingURL=RunAnywhere+Embeddings.js.map

package/dist/Public/Extensions/RunAnywhere+Embeddings.js.map

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

package/dist/Public/Extensions/RunAnywhere+ModelManagement.d.ts

@@ -0,0 +1,53 @@
+/**
+ * RunAnywhere Web SDK - Model Management Extension
+ *
+ * Handles model downloading, storage, and lifecycle in the browser.
+ * Uses Fetch API for downloads and Emscripten FS for storage.
+ *
+ * Mirrors: sdk/runanywhere-swift/Sources/RunAnywhere/Public/Extensions/
+ *          ModelManagement/RunAnywhere+ModelManagement.swift
+ */
+/** Download progress callback */
+export type DownloadProgressCallback = (bytesDownloaded: number, totalBytes: number, progress: number) => void;
+/** Model download options */
+export interface ModelDownloadOptions {
+    /** Override destination path (default: /models/<filename>) */
+    destPath?: string;
+    /** Progress callback */
+    onProgress?: DownloadProgressCallback;
+    /** AbortController signal for cancellation */
+    signal?: AbortSignal;
+}
+export declare const ModelManagement: {
+    /**
+     * Download a model file from a URL to Emscripten FS.
+     *
+     * Uses Fetch API with ReadableStream for progress tracking.
+     * The downloaded file is stored in the Emscripten virtual filesystem
+     * and can be loaded by llama.cpp / whisper.cpp directly.
+     *
+     * @param url - URL to download the model from
+     * @param modelId - Identifier for the model
+     * @param options - Download options (progress callback, dest path, etc.)
+     * @returns Local path where model was saved (in Emscripten FS)
+     */
+    downloadModel(url: string, modelId: string, options?: ModelDownloadOptions): Promise<string>;
+    /**
+     * Check if a model file exists in Emscripten FS.
+     */
+    isModelDownloaded(path: string): boolean;
+    /**
+     * Delete a downloaded model from Emscripten FS.
+     */
+    deleteModel(path: string): void;
+    /**
+     * Get the size of a downloaded model file.
+     * @returns Size in bytes, or 0 if not found
+     */
+    getModelSize(path: string): number;
+    /**
+     * List all model files in the models directory.
+     */
+    listDownloadedModels(): string[];
+};
+//# sourceMappingURL=RunAnywhere+ModelManagement.d.ts.map

package/dist/Public/Extensions/RunAnywhere+ModelManagement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunAnywhere+ModelManagement.d.ts","sourceRoot":"","sources":["../../../src/Public/Extensions/RunAnywhere+ModelManagement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,iCAAiC;AACjC,MAAM,MAAM,wBAAwB,GAAG,CACrC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,KACb,IAAI,CAAC;AAEV,6BAA6B;AAC7B,MAAM,WAAW,oBAAoB;IACnC,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,wBAAwB,CAAC;IACtC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAKD,eAAO,MAAM,eAAe;IAC1B;;;;;;;;;;;OAWG;uBAEI,MAAM,WACF,MAAM,YACN,oBAAoB,GAC5B,OAAO,CAAC,MAAM,CAAC;IA2FlB;;OAEG;4BACqB,MAAM,GAAG,OAAO;IASxC;;OAEG;sBACe,MAAM,GAAG,IAAI;IAU/B;;;OAGG;uBACgB,MAAM,GAAG,MAAM;IASlC;;OAEG;4BACqB,MAAM,EAAE;CAKjC,CAAC"}

package/dist/Public/Extensions/RunAnywhere+ModelManagement.js

@@ -0,0 +1,153 @@
+/**
+ * RunAnywhere Web SDK - Model Management Extension
+ *
+ * Handles model downloading, storage, and lifecycle in the browser.
+ * Uses Fetch API for downloads and Emscripten FS for storage.
+ *
+ * Mirrors: sdk/runanywhere-swift/Sources/RunAnywhere/Public/Extensions/
+ *          ModelManagement/RunAnywhere+ModelManagement.swift
+ */
+import { RunAnywhere } from '../RunAnywhere';
+import { WASMBridge } from '../../Foundation/WASMBridge';
+import { SDKError } from '../../Foundation/ErrorTypes';
+import { SDKLogger } from '../../Foundation/SDKLogger';
+import { EventBus } from '../../Foundation/EventBus';
+import { SDKEventType } from '../../types/enums';
+const logger = new SDKLogger('ModelManagement');
+/** Models directory in Emscripten FS */
+const MODELS_DIR = '/models';
+export const ModelManagement = {
+    /**
+     * Download a model file from a URL to Emscripten FS.
+     *
+     * Uses Fetch API with ReadableStream for progress tracking.
+     * The downloaded file is stored in the Emscripten virtual filesystem
+     * and can be loaded by llama.cpp / whisper.cpp directly.
+     *
+     * @param url - URL to download the model from
+     * @param modelId - Identifier for the model
+     * @param options - Download options (progress callback, dest path, etc.)
+     * @returns Local path where model was saved (in Emscripten FS)
+     */
+    async downloadModel(url, modelId, options = {}) {
+        if (!RunAnywhere.isInitialized) {
+            throw SDKError.notInitialized();
+        }
+        const bridge = WASMBridge.shared;
+        const m = bridge.module;
+        // Determine destination path
+        const filename = url.split('/').pop() ?? `${modelId}.gguf`;
+        const destPath = options.destPath ?? `${MODELS_DIR}/${filename}`;
+        logger.info(`Downloading model: ${modelId} from ${url}`);
+        EventBus.shared.emit('model.downloadStarted', SDKEventType.Model, { modelId, url });
+        // Ensure models directory exists
+        try {
+            m.FS.mkdir(MODELS_DIR);
+        }
+        catch {
+            // Directory already exists
+        }
+        try {
+            const response = await fetch(url, { signal: options.signal });
+            if (!response.ok) {
+                throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+            }
+            const contentLength = parseInt(response.headers.get('content-length') ?? '0', 10);
+            const reader = response.body?.getReader();
+            if (!reader) {
+                throw new Error('ReadableStream not supported');
+            }
+            const chunks = [];
+            let downloaded = 0;
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                chunks.push(value);
+                downloaded += value.length;
+                const progress = contentLength > 0 ? downloaded / contentLength : 0;
+                options.onProgress?.(downloaded, contentLength, progress);
+                EventBus.shared.emit('model.downloadProgress', SDKEventType.Model, {
+                    modelId,
+                    progress,
+                    bytesDownloaded: downloaded,
+                    totalBytes: contentLength,
+                });
+            }
+            // Combine chunks
+            const totalData = new Uint8Array(downloaded);
+            let offset = 0;
+            for (const chunk of chunks) {
+                totalData.set(chunk, offset);
+                offset += chunk.length;
+            }
+            // Write to Emscripten FS
+            m.FS.writeFile(destPath, totalData);
+            // Verify
+            const stat = m.FS.stat(destPath);
+            logger.info(`Model downloaded: ${modelId} (${(stat.size / 1024 / 1024).toFixed(1)} MB) -> ${destPath}`);
+            EventBus.shared.emit('model.downloadCompleted', SDKEventType.Model, {
+                modelId,
+                localPath: destPath,
+                sizeBytes: stat.size,
+            });
+            return destPath;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`Download failed for ${modelId}: ${message}`);
+            EventBus.shared.emit('model.downloadFailed', SDKEventType.Model, {
+                modelId,
+                error: message,
+            });
+            throw error;
+        }
+    },
+    /**
+     * Check if a model file exists in Emscripten FS.
+     */
+    isModelDownloaded(path) {
+        try {
+            const m = WASMBridge.shared.module;
+            return m.FS.analyzePath(path).exists;
+        }
+        catch {
+            return false;
+        }
+    },
+    /**
+     * Delete a downloaded model from Emscripten FS.
+     */
+    deleteModel(path) {
+        try {
+            const m = WASMBridge.shared.module;
+            m.FS.unlink(path);
+            logger.info(`Model deleted: ${path}`);
+        }
+        catch (error) {
+            logger.error(`Failed to delete model: ${error}`);
+        }
+    },
+    /**
+     * Get the size of a downloaded model file.
+     * @returns Size in bytes, or 0 if not found
+     */
+    getModelSize(path) {
+        try {
+            const m = WASMBridge.shared.module;
+            return m.FS.stat(path).size;
+        }
+        catch {
+            return 0;
+        }
+    },
+    /**
+     * List all model files in the models directory.
+     */
+    listDownloadedModels() {
+        // Note: Emscripten FS readdir requires node-like API
+        // For now, return empty -- this will be enhanced with OPFS in Phase 5
+        return [];
+    },
+};
+//# sourceMappingURL=RunAnywhere+ModelManagement.js.map

package/dist/Public/Extensions/RunAnywhere+ModelManagement.js.map

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

package/dist/Public/Extensions/RunAnywhere+STT.d.ts

@@ -0,0 +1,95 @@
+/**
+ * RunAnywhere Web SDK - Speech-to-Text Extension
+ *
+ * Adds STT (speech recognition) capabilities via sherpa-onnx WASM.
+ * Supports both offline (Whisper) and online (streaming Zipformer) models.
+ *
+ * Uses the sherpa-onnx C struct packing helpers from sherpa-onnx-asr.js
+ * to properly allocate config structs in WASM memory (NOT JSON strings).
+ *
+ * Mirrors: sdk/runanywhere-swift/Sources/RunAnywhere/Public/Extensions/STT/
+ *
+ * Usage:
+ *   import { STT } from '@runanywhere/web';
+ *
+ *   // Load model files (downloaded separately)
+ *   await STT.loadModel({
+ *     modelId: 'whisper-tiny-en',
+ *     type: 'whisper',
+ *     modelFiles: {
+ *       encoder: '/models/whisper-tiny-en/encoder.onnx',
+ *       decoder: '/models/whisper-tiny-en/decoder.onnx',
+ *       tokens: '/models/whisper-tiny-en/tokens.txt',
+ *     },
+ *   });
+ *
+ *   const result = await STT.transcribe(audioFloat32Array);
+ *   console.log(result.text);
+ */
+import { STTModelType } from './STTTypes';
+import type { STTModelConfig, STTTranscriptionResult } from './STTTypes';
+export { STTModelType } from './STTTypes';
+export type { STTModelConfig, STTWhisperFiles, STTZipformerFiles, STTParaformerFiles, STTTranscriptionResult, STTWord } from './STTTypes';
+export interface STTTranscribeOptions {
+    language?: string;
+    sampleRate?: number;
+}
+/** Callback for streaming STT partial results */
+export type STTStreamCallback = (text: string, isFinal: boolean) => void;
+declare class STTImpl {
+    readonly extensionName = "STT";
+    private _offlineRecognizerHandle;
+    private _onlineRecognizerHandle;
+    private _currentModelType;
+    private _currentModelId;
+    /** Returns the currently loaded STT model type. */
+    get currentModelType(): STTModelType;
+    /**
+     * Load an STT model via sherpa-onnx.
+     * Model files must already be written to sherpa-onnx virtual FS
+     * (use SherpaONNXBridge.shared.downloadAndWrite() or .writeFile()).
+     */
+    loadModel(config: STTModelConfig): Promise<void>;
+    /** Unload the STT model. */
+    unloadModel(): Promise<void>;
+    /** Check if an STT model is loaded. */
+    get isModelLoaded(): boolean;
+    /** Get the current model ID. */
+    get modelId(): string;
+    /**
+     * Transcribe audio data (offline / non-streaming).
+     *
+     * @param audioSamples - Float32Array of PCM audio samples (mono, 16kHz)
+     * @param options - Transcription options
+     * @returns Transcription result
+     */
+    transcribe(audioSamples: Float32Array, options?: STTTranscribeOptions): Promise<STTTranscriptionResult>;
+    /** Internal: Transcribe via online recognizer (for streaming models used non-streaming) */
+    _transcribeViaOnline(audioSamples: Float32Array, options?: STTTranscribeOptions): Promise<STTTranscriptionResult>;
+    /**
+     * Create a streaming transcription session.
+     * Returns an object to feed audio chunks and get results.
+     */
+    createStreamingSession(options?: STTTranscribeOptions): STTStreamingSession;
+    /** Clean up the STT resources. */
+    cleanup(): void;
+}
+export declare const STT: STTImpl;
+/** Returns the currently loaded STT model type. */
+export declare function getCurrentSTTModelType(): STTModelType;
+export interface STTStreamingSession {
+    /** Feed audio samples to the recognizer */
+    acceptWaveform(samples: Float32Array, sampleRate?: number): void;
+    /** Signal end of audio input */
+    inputFinished(): void;
+    /** Get current partial/final result */
+    getResult(): {
+        text: string;
+        isEndpoint: boolean;
+    };
+    /** Reset after endpoint */
+    reset(): void;
+    /** Destroy the streaming session */
+    destroy(): void;
+}
+//# sourceMappingURL=RunAnywhere+STT.d.ts.map

package/dist/Public/Extensions/RunAnywhere+STT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RunAnywhere+STT.d.ts","sourceRoot":"","sources":["../../../src/Public/Extensions/RunAnywhere+STT.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAQH,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,cAAc,EAA0D,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAejI,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1I,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AA8HzE,cAAM,OAAO;IACX,QAAQ,CAAC,aAAa,SAAS;IAC/B,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,eAAe,CAAM;IAE7B,mDAAmD;IACnD,IAAI,gBAAgB,IAAI,YAAY,CAEnC;IAED;;;;OAIG;IACG,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAyDtD,4BAA4B;IACtB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,uCAAuC;IACvC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,gCAAgC;IAChC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;;OAMG;IACG,UAAU,CACd,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,sBAAsB,CAAC;IA6DlC,2FAA2F;IACrF,oBAAoB,CACxB,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,sBAAsB,CAAC;IAuClC;;;OAGG;IACH,sBAAsB,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB;IAW/E,kCAAkC;IAClC,OAAO,IAAI,IAAI;CAkBhB;AAED,eAAO,MAAM,GAAG,SAAgB,CAAC;AAEjC,mDAAmD;AACnD,wBAAgB,sBAAsB,IAAI,YAAY,CAErD;AAMD,MAAM,WAAW,mBAAmB;IAClC,2CAA2C;IAC3C,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjE,gCAAgC;IAChC,aAAa,IAAI,IAAI,CAAC;IACtB,uCAAuC;IACvC,SAAS,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,2BAA2B;IAC3B,KAAK,IAAI,IAAI,CAAC;IACd,oCAAoC;IACpC,OAAO,IAAI,IAAI,CAAC;CACjB"}