@runanywhere/web 0.1.0-beta.5 → 0.1.0-beta.6

package/dist/Foundation/StructOffsets.js

@@ -9,188 +9,154 @@
  * `offsetof()` in wasm_exports.cpp) exactly once after the WASM module is
  * loaded, and caches the results for the lifetime of the page.
  *
- * The offset system is extensible: backend packages (llamacpp, onnx) can
- * register additional offsets via `mergeOffsets()`.
- *
  * Usage:
- *   import { Offsets, loadOffsets } from '@runanywhere/web';
+ *   import { Offsets, loadOffsets } from '../Foundation/StructOffsets';
  *
  *   // Called once during SDK init (after WASM load):
  *   loadOffsets(wasmModule);
  *
  *   // Then anywhere:
- *   m.setValue(optPtr + Offsets.config.logLevel, 2, 'i32');
+ *   m.setValue(optPtr + Offsets.llmOptions.temperature, 0.8, 'float');
  */
 // ---------------------------------------------------------------------------
 // Singleton
 // ---------------------------------------------------------------------------
-let _offsets = {};
+let _offsets = null;
 /**
- * Get the cached struct offsets.
- * Returns the merged offsets from core + all registered backends.
+ * Get the cached struct offsets. Throws if `loadOffsets()` hasn't been called.
  */
 export function getOffsets() {
+    if (!_offsets) {
+        throw new Error('StructOffsets not loaded — call loadOffsets(module) after WASM init');
+    }
     return _offsets;
 }
 /**
  * Convenience re-export so callers can write `Offsets.vlmResult.text`.
- * Returns a Proxy that dynamically resolves from the cached offset store.
  */
 export const Offsets = new Proxy({}, {
     get(_target, prop) {
         return getOffsets()[prop];
     },
 });
-// ---------------------------------------------------------------------------
-// WASM offset helpers (exported for backend packages)
-// ---------------------------------------------------------------------------
-/**
- * Safely call a `_rac_wasm_offsetof_*` function. Returns 0 if the
- * function doesn't exist (e.g. backend not compiled in).
- */
-export function wasmOffsetOf(m, name) {
-    const fn = m[`_rac_wasm_offsetof_${name}`];
-    return typeof fn === 'function' ? fn() : 0;
-}
-/**
- * Safely call a `_rac_wasm_sizeof_*` function. Returns 0 if the
- * function doesn't exist.
- */
-export function wasmSizeOf(m, name) {
-    const fn = m[`_rac_wasm_sizeof_${name}`];
-    return typeof fn === 'function' ? fn() : 0;
-}
-// ---------------------------------------------------------------------------
-// Loading
-// ---------------------------------------------------------------------------
 /**
- * Load core struct field offsets from the WASM module.
- * Called once during SDK init (after WASM load).
+ * Read all struct field offsets from the WASM module and cache them.
+ * Must be called exactly once, after the WASM module is loaded.
  *
  * @param m - The Emscripten WASM module instance
  */
 export function loadOffsets(m) {
+    // Helper: safely call an offset function, returning 0 if it doesn't exist
+    // (e.g. when a backend wasn't compiled in).
+    const off = (name) => {
+        const fn = m[`_rac_wasm_offsetof_${name}`];
+        return typeof fn === 'function' ? fn() : 0;
+    };
+    const sz = (name) => {
+        const fn = m[`_rac_wasm_sizeof_${name}`];
+        return typeof fn === 'function' ? fn() : 0;
+    };
     _offsets = {
-        ..._offsets,
         config: {
-            logLevel: wasmOffsetOf(m, 'config_log_level'),
+            logLevel: off('config_log_level'),
         },
-    };
-}
-/**
- * Merge additional offsets from a backend package.
- * Called by backend providers during registration.
- *
- * @param offsets - Partial offset tables to merge
- */
-export function mergeOffsets(offsets) {
-    _offsets = { ..._offsets, ...offsets };
-}
-/**
- * Load offsets for a standalone WASM module (e.g. in a Web Worker).
- * Returns the offsets directly instead of storing them in the singleton.
- * Useful when the Worker has its own WASM instance.
- */
-export function loadOffsetsFromModule(m) {
-    loadOffsets(m);
-    // Also load all llama.cpp offsets for the worker (VLM Worker needs these)
-    loadLlamaCppOffsetsInto(m);
-    return _offsets;
-}
-/**
- * Load llama.cpp-specific offsets into the singleton.
- * Called by LlamaCppProvider.register() and loadOffsetsFromModule().
- */
-export function loadLlamaCppOffsetsInto(m) {
-    mergeOffsets({
         llmOptions: {
-            maxTokens: wasmOffsetOf(m, 'llm_options_max_tokens'),
-            temperature: wasmOffsetOf(m, 'llm_options_temperature'),
-            topP: wasmOffsetOf(m, 'llm_options_top_p'),
-            systemPrompt: wasmOffsetOf(m, 'llm_options_system_prompt'),
+            maxTokens: off('llm_options_max_tokens'),
+            temperature: off('llm_options_temperature'),
+            topP: off('llm_options_top_p'),
+            systemPrompt: off('llm_options_system_prompt'),
         },
         llmResult: {
-            text: wasmOffsetOf(m, 'llm_result_text'),
-            promptTokens: wasmOffsetOf(m, 'llm_result_prompt_tokens'),
-            completionTokens: wasmOffsetOf(m, 'llm_result_completion_tokens'),
+            text: off('llm_result_text'),
+            promptTokens: off('llm_result_prompt_tokens'),
+            completionTokens: off('llm_result_completion_tokens'),
         },
         vlmImage: {
-            format: wasmOffsetOf(m, 'vlm_image_format'),
-            filePath: wasmOffsetOf(m, 'vlm_image_file_path'),
-            pixelData: wasmOffsetOf(m, 'vlm_image_pixel_data'),
-            base64Data: wasmOffsetOf(m, 'vlm_image_base64_data'),
-            width: wasmOffsetOf(m, 'vlm_image_width'),
-            height: wasmOffsetOf(m, 'vlm_image_height'),
-            dataSize: wasmOffsetOf(m, 'vlm_image_data_size'),
+            format: off('vlm_image_format'),
+            filePath: off('vlm_image_file_path'),
+            pixelData: off('vlm_image_pixel_data'),
+            base64Data: off('vlm_image_base64_data'),
+            width: off('vlm_image_width'),
+            height: off('vlm_image_height'),
+            dataSize: off('vlm_image_data_size'),
         },
         vlmOptions: {
-            maxTokens: wasmOffsetOf(m, 'vlm_options_max_tokens'),
-            temperature: wasmOffsetOf(m, 'vlm_options_temperature'),
-            topP: wasmOffsetOf(m, 'vlm_options_top_p'),
-            streamingEnabled: wasmOffsetOf(m, 'vlm_options_streaming_enabled'),
-            systemPrompt: wasmOffsetOf(m, 'vlm_options_system_prompt'),
-            modelFamily: wasmOffsetOf(m, 'vlm_options_model_family'),
+            maxTokens: off('vlm_options_max_tokens'),
+            temperature: off('vlm_options_temperature'),
+            topP: off('vlm_options_top_p'),
+            streamingEnabled: off('vlm_options_streaming_enabled'),
+            systemPrompt: off('vlm_options_system_prompt'),
+            modelFamily: off('vlm_options_model_family'),
         },
         vlmResult: {
-            text: wasmOffsetOf(m, 'vlm_result_text'),
-            promptTokens: wasmOffsetOf(m, 'vlm_result_prompt_tokens'),
-            imageTokens: wasmOffsetOf(m, 'vlm_result_image_tokens'),
-            completionTokens: wasmOffsetOf(m, 'vlm_result_completion_tokens'),
-            totalTokens: wasmOffsetOf(m, 'vlm_result_total_tokens'),
-            timeToFirstTokenMs: wasmOffsetOf(m, 'vlm_result_time_to_first_token_ms'),
-            imageEncodeTimeMs: wasmOffsetOf(m, 'vlm_result_image_encode_time_ms'),
-            totalTimeMs: wasmOffsetOf(m, 'vlm_result_total_time_ms'),
-            tokensPerSecond: wasmOffsetOf(m, 'vlm_result_tokens_per_second'),
+            text: off('vlm_result_text'),
+            promptTokens: off('vlm_result_prompt_tokens'),
+            imageTokens: off('vlm_result_image_tokens'),
+            completionTokens: off('vlm_result_completion_tokens'),
+            totalTokens: off('vlm_result_total_tokens'),
+            timeToFirstTokenMs: off('vlm_result_time_to_first_token_ms'),
+            imageEncodeTimeMs: off('vlm_result_image_encode_time_ms'),
+            totalTimeMs: off('vlm_result_total_time_ms'),
+            tokensPerSecond: off('vlm_result_tokens_per_second'),
         },
         structuredOutputConfig: {
-            jsonSchema: wasmOffsetOf(m, 'structured_output_config_json_schema'),
-            includeSchemaInPrompt: wasmOffsetOf(m, 'structured_output_config_include_schema'),
+            jsonSchema: off('structured_output_config_json_schema'),
+            includeSchemaInPrompt: off('structured_output_config_include_schema'),
         },
         structuredOutputValidation: {
-            isValid: wasmOffsetOf(m, 'structured_output_validation_is_valid'),
-            errorMessage: wasmOffsetOf(m, 'structured_output_validation_error_message'),
-            extractedJson: wasmOffsetOf(m, 'structured_output_validation_extracted_json'),
+            isValid: off('structured_output_validation_is_valid'),
+            errorMessage: off('structured_output_validation_error_message'),
+            extractedJson: off('structured_output_validation_extracted_json'),
         },
         embeddingsOptions: {
-            normalize: wasmOffsetOf(m, 'embeddings_options_normalize'),
-            pooling: wasmOffsetOf(m, 'embeddings_options_pooling'),
-            nThreads: wasmOffsetOf(m, 'embeddings_options_n_threads'),
+            normalize: off('embeddings_options_normalize'),
+            pooling: off('embeddings_options_pooling'),
+            nThreads: off('embeddings_options_n_threads'),
         },
         embeddingsResult: {
-            embeddings: wasmOffsetOf(m, 'embeddings_result_embeddings'),
-            numEmbeddings: wasmOffsetOf(m, 'embeddings_result_num_embeddings'),
-            dimension: wasmOffsetOf(m, 'embeddings_result_dimension'),
-            processingTimeMs: wasmOffsetOf(m, 'embeddings_result_processing_time_ms'),
-            totalTokens: wasmOffsetOf(m, 'embeddings_result_total_tokens'),
+            embeddings: off('embeddings_result_embeddings'),
+            numEmbeddings: off('embeddings_result_num_embeddings'),
+            dimension: off('embeddings_result_dimension'),
+            processingTimeMs: off('embeddings_result_processing_time_ms'),
+            totalTokens: off('embeddings_result_total_tokens'),
         },
         embeddingVector: {
-            data: wasmOffsetOf(m, 'embedding_vector_data'),
-            dimension: wasmOffsetOf(m, 'embedding_vector_dimension'),
-            structSize: wasmSizeOf(m, 'embedding_vector'),
+            data: off('embedding_vector_data'),
+            dimension: off('embedding_vector_dimension'),
+            structSize: sz('embedding_vector'),
         },
         diffusionOptions: {
-            prompt: wasmOffsetOf(m, 'diffusion_options_prompt'),
-            negativePrompt: wasmOffsetOf(m, 'diffusion_options_negative_prompt'),
-            width: wasmOffsetOf(m, 'diffusion_options_width'),
-            height: wasmOffsetOf(m, 'diffusion_options_height'),
-            steps: wasmOffsetOf(m, 'diffusion_options_steps'),
-            guidanceScale: wasmOffsetOf(m, 'diffusion_options_guidance_scale'),
-            seed: wasmOffsetOf(m, 'diffusion_options_seed'),
-            scheduler: wasmOffsetOf(m, 'diffusion_options_scheduler'),
-            mode: wasmOffsetOf(m, 'diffusion_options_mode'),
-            denoiseStrength: wasmOffsetOf(m, 'diffusion_options_denoise_strength'),
-            reportIntermediate: wasmOffsetOf(m, 'diffusion_options_report_intermediate'),
-            progressStride: wasmOffsetOf(m, 'diffusion_options_progress_stride'),
+            prompt: off('diffusion_options_prompt'),
+            negativePrompt: off('diffusion_options_negative_prompt'),
+            width: off('diffusion_options_width'),
+            height: off('diffusion_options_height'),
+            steps: off('diffusion_options_steps'),
+            guidanceScale: off('diffusion_options_guidance_scale'),
+            seed: off('diffusion_options_seed'),
+            scheduler: off('diffusion_options_scheduler'),
+            mode: off('diffusion_options_mode'),
+            denoiseStrength: off('diffusion_options_denoise_strength'),
+            reportIntermediate: off('diffusion_options_report_intermediate'),
+            progressStride: off('diffusion_options_progress_stride'),
         },
         diffusionResult: {
-            imageData: wasmOffsetOf(m, 'diffusion_result_image_data'),
-            imageSize: wasmOffsetOf(m, 'diffusion_result_image_size'),
-            width: wasmOffsetOf(m, 'diffusion_result_width'),
-            height: wasmOffsetOf(m, 'diffusion_result_height'),
-            seedUsed: wasmOffsetOf(m, 'diffusion_result_seed_used'),
-            generationTimeMs: wasmOffsetOf(m, 'diffusion_result_generation_time_ms'),
-            safetyFlagged: wasmOffsetOf(m, 'diffusion_result_safety_flagged'),
+            imageData: off('diffusion_result_image_data'),
+            imageSize: off('diffusion_result_image_size'),
+            width: off('diffusion_result_width'),
+            height: off('diffusion_result_height'),
+            seedUsed: off('diffusion_result_seed_used'),
+            generationTimeMs: off('diffusion_result_generation_time_ms'),
+            safetyFlagged: off('diffusion_result_safety_flagged'),
         },
-    });
+    };
+}
+/**
+ * Load offsets for a standalone WASM module (e.g. in a Web Worker).
+ * Returns the offsets directly instead of storing them in the singleton.
+ * Useful when the Worker has its own WASM instance.
+ */
+export function loadOffsetsFromModule(m) {
+    loadOffsets(m);
+    return _offsets;
 }
 //# sourceMappingURL=StructOffsets.js.map

package/dist/Foundation/StructOffsets.js.map

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

package/dist/Infrastructure/AudioCapture.d.ts

@@ -0,0 +1,99 @@
+/**
+ * RunAnywhere Web SDK - Audio Capture
+ *
+ * Captures microphone audio using Web Audio API and provides
+ * Float32Array PCM samples suitable for STT and VAD processing.
+ *
+ * Supports:
+ *   - Real-time microphone capture via getUserMedia
+ *   - Configurable sample rate (resampling via AudioContext)
+ *   - Chunk-based callbacks for streaming STT/VAD
+ *   - Buffer accumulation (getAudioBuffer, drainBuffer, clearBuffer)
+ *   - Audio level monitoring via AnalyserNode (currentLevel getter)
+ */
+export type AudioChunkCallback = (samples: Float32Array) => void;
+export type AudioLevelCallback = (level: number) => void;
+/** Callback invoked when the microphone track ends unexpectedly (OS/browser killed it). */
+export type AudioTrackEndedCallback = () => void;
+export interface AudioCaptureConfig {
+    /** Target sample rate (default: 16000 for STT) */
+    sampleRate?: number;
+    /** Chunk size in samples (default: 1600 = 100ms at 16kHz) */
+    chunkSize?: number;
+    /** Number of audio channels (default: 1, mono) */
+    channels?: number;
+}
+/**
+ * AudioCapture - Captures microphone audio for STT/VAD processing.
+ *
+ * Uses Web Audio API (AudioContext + ScriptProcessorNode) to capture
+ * microphone audio, resample to target rate, and deliver Float32Array
+ * PCM chunks to the consumer.
+ *
+ * Includes buffer accumulation for batch STT and an AnalyserNode for
+ * real-time audio level metering (0-1 range).
+ */
+export declare class AudioCapture {
+    private audioContext;
+    private mediaStream;
+    private sourceNode;
+    private processorNode;
+    private _analyser;
+    private _animFrameId;
+    private _isCapturing;
+    private _currentLevel;
+    private _pcmChunks;
+    private readonly config;
+    private chunkCallback;
+    private levelCallback;
+    /**
+     * Callback invoked when the microphone track ends unexpectedly.
+     *
+     * On mobile browsers, the OS can revoke mic access due to power management,
+     * screen lock, another app requesting the mic, or AudioContext suspension.
+     * Set this to detect and recover from such interruptions.
+     */
+    onTrackEnded: AudioTrackEndedCallback | null;
+    /** Bound handler for the track 'ended' event (stored for cleanup). */
+    private _boundOnTrackEnded;
+    constructor(config?: AudioCaptureConfig);
+    get isCapturing(): boolean;
+    /** Current normalized audio level (0..1), updated per animation frame. */
+    get currentLevel(): number;
+    /**
+     * Get the actual sample rate of the audio context.
+     * May differ from requested rate if browser doesn't support it.
+     */
+    get actualSampleRate(): number;
+    /** Duration of collected audio in seconds based on configured sample rate. */
+    get bufferDurationSeconds(): number;
+    /**
+     * Start capturing microphone audio.
+     *
+     * @param onChunk - Optional callback receiving Float32Array chunks of PCM audio (streaming)
+     * @param onLevel - Optional callback invoked per animation frame with audio level 0..1
+     * @throws If microphone permission is denied
+     */
+    start(onChunk?: AudioChunkCallback, onLevel?: AudioLevelCallback): Promise<void>;
+    /**
+     * Stop capturing audio and release resources.
+     */
+    stop(): void;
+    /**
+     * Get all collected PCM audio as a single Float32Array.
+     * Does NOT clear the buffer — call `clearBuffer()` separately.
+     */
+    getAudioBuffer(): Float32Array;
+    /**
+     * Drain: return the current buffer and clear it for the next segment.
+     * Useful for live mode where we transcribe segments incrementally.
+     */
+    drainBuffer(): Float32Array;
+    /** Clear collected PCM data without stopping capture. */
+    clearBuffer(): void;
+    /** Start the requestAnimationFrame loop that reads the AnalyserNode. */
+    private startLevelMonitoring;
+    private cleanupResources;
+    private nearestPowerOf2;
+}
+//# sourceMappingURL=AudioCapture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioCapture.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/AudioCapture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AACzD,2FAA2F;AAC3F,MAAM,MAAM,uBAAuB,GAAG,MAAM,IAAI,CAAC;AAEjD,MAAM,WAAW,kBAAkB;IACjC,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAsB;IAExC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+B;IACtD,OAAO,CAAC,aAAa,CAAmC;IACxD,OAAO,CAAC,aAAa,CAAmC;IAExD;;;;;;OAMG;IACH,YAAY,EAAE,uBAAuB,GAAG,IAAI,CAAQ;IAEpD,sEAAsE;IACtE,OAAO,CAAC,kBAAkB,CAA6B;gBAE3C,MAAM,GAAE,kBAAuB;IAQ3C,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,0EAA0E;IAC1E,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED,8EAA8E;IAC9E,IAAI,qBAAqB,IAAI,MAAM,CAGlC;IAED;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,kBAAkB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgGtF;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;;OAGG;IACH,cAAc,IAAI,YAAY;IAY9B;;;OAGG;IACH,WAAW,IAAI,YAAY;IAM3B,yDAAyD;IACzD,WAAW,IAAI,IAAI;IAInB,wEAAwE;IACxE,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,gBAAgB;IAkCxB,OAAO,CAAC,eAAe;CAOxB"}