@runanywhere/web 0.1.0-beta.1

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;AAEzD,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;gBAE5C,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;IA8EtF;;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;IA4BxB,OAAO,CAAC,eAAe;CAOxB"}

package/dist/Infrastructure/AudioCapture.js

@@ -0,0 +1,231 @@
+/**
+ * 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)
+ */
+import { SDKLogger } from '../Foundation/SDKLogger';
+const logger = new SDKLogger('AudioCapture');
+/**
+ * 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 class AudioCapture {
+    audioContext = null;
+    mediaStream = null;
+    sourceNode = null;
+    processorNode = null;
+    _analyser = null;
+    _animFrameId = null;
+    _isCapturing = false;
+    _currentLevel = 0;
+    _pcmChunks = [];
+    config;
+    chunkCallback = null;
+    levelCallback = null;
+    constructor(config = {}) {
+        this.config = {
+            sampleRate: config.sampleRate ?? 16000,
+            chunkSize: config.chunkSize ?? 1600,
+            channels: config.channels ?? 1,
+        };
+    }
+    get isCapturing() {
+        return this._isCapturing;
+    }
+    /** Current normalized audio level (0..1), updated per animation frame. */
+    get currentLevel() {
+        return this._currentLevel;
+    }
+    /**
+     * Get the actual sample rate of the audio context.
+     * May differ from requested rate if browser doesn't support it.
+     */
+    get actualSampleRate() {
+        return this.audioContext?.sampleRate ?? this.config.sampleRate;
+    }
+    /** Duration of collected audio in seconds based on configured sample rate. */
+    get bufferDurationSeconds() {
+        const samples = this._pcmChunks.reduce((acc, c) => acc + c.length, 0);
+        return samples / this.config.sampleRate;
+    }
+    /**
+     * 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
+     */
+    async start(onChunk, onLevel) {
+        if (this._isCapturing) {
+            logger.debug('Already capturing');
+            return;
+        }
+        this.chunkCallback = onChunk ?? null;
+        this.levelCallback = onLevel ?? null;
+        this._pcmChunks = [];
+        this._currentLevel = 0;
+        logger.info(`Starting audio capture (${this.config.sampleRate}Hz, chunk=${this.config.chunkSize})`);
+        try {
+            // Request microphone access
+            this.mediaStream = await navigator.mediaDevices.getUserMedia({
+                audio: {
+                    sampleRate: { ideal: this.config.sampleRate },
+                    channelCount: { exact: this.config.channels },
+                    echoCancellation: true,
+                    noiseSuppression: true,
+                    autoGainControl: true,
+                },
+            });
+            // Create AudioContext at target sample rate
+            this.audioContext = new AudioContext({
+                sampleRate: this.config.sampleRate,
+            });
+            // Connect microphone to AudioContext
+            this.sourceNode = this.audioContext.createMediaStreamSource(this.mediaStream);
+            // --- AnalyserNode for level metering ---
+            this._analyser = this.audioContext.createAnalyser();
+            this._analyser.fftSize = 256;
+            this.sourceNode.connect(this._analyser);
+            // --- ScriptProcessorNode for chunk-based processing ---
+            // Note: ScriptProcessorNode is deprecated but AudioWorklet requires
+            // cross-origin isolation. We use ScriptProcessor as a fallback.
+            const bufferSize = this.nearestPowerOf2(this.config.chunkSize);
+            this.processorNode = this.audioContext.createScriptProcessor(bufferSize, this.config.channels, this.config.channels);
+            this.processorNode.onaudioprocess = (event) => {
+                if (!this._isCapturing)
+                    return;
+                const inputData = event.inputBuffer.getChannelData(0);
+                // Copy to avoid buffer reuse issues
+                const samples = new Float32Array(inputData.length);
+                samples.set(inputData);
+                // Accumulate into internal buffer
+                this._pcmChunks.push(samples);
+                // Notify chunk callback if provided
+                this.chunkCallback?.(samples);
+            };
+            this.sourceNode.connect(this.processorNode);
+            this.processorNode.connect(this.audioContext.destination);
+            this._isCapturing = true;
+            // Start level monitoring loop
+            this.startLevelMonitoring();
+            logger.info('Audio capture started');
+        }
+        catch (error) {
+            this.cleanupResources();
+            const message = error instanceof Error ? error.message : String(error);
+            logger.error(`Failed to start audio capture: ${message}`);
+            throw new Error(`Microphone access failed: ${message}`);
+        }
+    }
+    /**
+     * Stop capturing audio and release resources.
+     */
+    stop() {
+        if (!this._isCapturing)
+            return;
+        this._isCapturing = false;
+        this._currentLevel = 0;
+        this.chunkCallback = null;
+        this.levelCallback = null;
+        this.cleanupResources();
+        logger.info('Audio capture stopped');
+    }
+    /**
+     * Get all collected PCM audio as a single Float32Array.
+     * Does NOT clear the buffer — call `clearBuffer()` separately.
+     */
+    getAudioBuffer() {
+        if (this._pcmChunks.length === 0)
+            return new Float32Array(0);
+        const totalLength = this._pcmChunks.reduce((acc, c) => acc + c.length, 0);
+        const merged = new Float32Array(totalLength);
+        let offset = 0;
+        for (const chunk of this._pcmChunks) {
+            merged.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return merged;
+    }
+    /**
+     * Drain: return the current buffer and clear it for the next segment.
+     * Useful for live mode where we transcribe segments incrementally.
+     */
+    drainBuffer() {
+        const buffer = this.getAudioBuffer();
+        this._pcmChunks = [];
+        return buffer;
+    }
+    /** Clear collected PCM data without stopping capture. */
+    clearBuffer() {
+        this._pcmChunks = [];
+    }
+    /** Start the requestAnimationFrame loop that reads the AnalyserNode. */
+    startLevelMonitoring() {
+        const analyser = this._analyser;
+        if (!analyser)
+            return;
+        const dataArray = new Uint8Array(analyser.frequencyBinCount);
+        const tick = () => {
+            if (!this._isCapturing || !this._analyser)
+                return;
+            this._analyser.getByteFrequencyData(dataArray);
+            let sum = 0;
+            for (let i = 0; i < dataArray.length; i++)
+                sum += dataArray[i];
+            const avg = sum / dataArray.length / 255;
+            this._currentLevel = avg;
+            this.levelCallback?.(avg);
+            this._animFrameId = requestAnimationFrame(tick);
+        };
+        this._animFrameId = requestAnimationFrame(tick);
+    }
+    cleanupResources() {
+        if (this._animFrameId !== null) {
+            cancelAnimationFrame(this._animFrameId);
+            this._animFrameId = null;
+        }
+        if (this.processorNode) {
+            this.processorNode.disconnect();
+            this.processorNode.onaudioprocess = null;
+            this.processorNode = null;
+        }
+        if (this._analyser) {
+            this._analyser.disconnect();
+            this._analyser = null;
+        }
+        if (this.sourceNode) {
+            this.sourceNode.disconnect();
+            this.sourceNode = null;
+        }
+        if (this.audioContext) {
+            this.audioContext.close().catch(() => { });
+            this.audioContext = null;
+        }
+        if (this.mediaStream) {
+            this.mediaStream.getTracks().forEach((track) => track.stop());
+            this.mediaStream = null;
+        }
+    }
+    nearestPowerOf2(n) {
+        let power = 256;
+        while (power < n && power < 16384) {
+            power *= 2;
+        }
+        return power;
+    }
+}
+//# sourceMappingURL=AudioCapture.js.map

package/dist/Infrastructure/AudioCapture.js.map

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

package/dist/Infrastructure/AudioPlayback.d.ts

@@ -0,0 +1,53 @@
+/**
+ * RunAnywhere Web SDK - Audio Playback
+ *
+ * Plays synthesized audio (TTS output) using Web Audio API.
+ * Accepts Float32Array PCM samples and plays them through
+ * the browser's audio output.
+ *
+ * Supports:
+ *   - One-shot playback of PCM audio buffers
+ *   - Streaming playback (queued chunks)
+ *   - Playback controls (stop, pause, resume)
+ *   - Completion callbacks
+ */
+export type PlaybackCompleteCallback = () => void;
+export interface PlaybackConfig {
+    /** Sample rate of the audio (default: 22050 for Piper TTS) */
+    sampleRate?: number;
+    /** Volume (0.0 - 1.0, default: 1.0) */
+    volume?: number;
+}
+/**
+ * AudioPlayback - Plays synthesized audio through browser speakers.
+ */
+export declare class AudioPlayback {
+    private audioContext;
+    private gainNode;
+    private currentSource;
+    private _isPlaying;
+    private config;
+    constructor(config?: PlaybackConfig);
+    get isPlaying(): boolean;
+    /**
+     * Play a Float32Array of PCM audio samples.
+     *
+     * @param samples - PCM audio data (Float32Array)
+     * @param sampleRate - Sample rate (overrides config)
+     * @returns Promise that resolves when playback completes
+     */
+    play(samples: Float32Array, sampleRate?: number): Promise<void>;
+    /**
+     * Stop playback immediately.
+     */
+    stop(): void;
+    /**
+     * Set playback volume.
+     */
+    setVolume(volume: number): void;
+    /**
+     * Release all audio resources.
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=AudioPlayback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioPlayback.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/AudioPlayback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,MAAM,MAAM,wBAAwB,GAAG,MAAM,IAAI,CAAC;AAElD,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAA2B;gBAE7B,MAAM,GAAE,cAAmB;IAOvC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiDrE;;OAEG;IACH,IAAI,IAAI,IAAI;IAYZ;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,OAAO,IAAI,IAAI;CAQhB"}

package/dist/Infrastructure/AudioPlayback.js

@@ -0,0 +1,117 @@
+/**
+ * RunAnywhere Web SDK - Audio Playback
+ *
+ * Plays synthesized audio (TTS output) using Web Audio API.
+ * Accepts Float32Array PCM samples and plays them through
+ * the browser's audio output.
+ *
+ * Supports:
+ *   - One-shot playback of PCM audio buffers
+ *   - Streaming playback (queued chunks)
+ *   - Playback controls (stop, pause, resume)
+ *   - Completion callbacks
+ */
+import { SDKLogger } from '../Foundation/SDKLogger';
+import { EventBus } from '../Foundation/EventBus';
+import { SDKEventType } from '../types/enums';
+const logger = new SDKLogger('AudioPlayback');
+/**
+ * AudioPlayback - Plays synthesized audio through browser speakers.
+ */
+export class AudioPlayback {
+    audioContext = null;
+    gainNode = null;
+    currentSource = null;
+    _isPlaying = false;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            sampleRate: config.sampleRate ?? 22050,
+            volume: config.volume ?? 1.0,
+        };
+    }
+    get isPlaying() {
+        return this._isPlaying;
+    }
+    /**
+     * Play a Float32Array of PCM audio samples.
+     *
+     * @param samples - PCM audio data (Float32Array)
+     * @param sampleRate - Sample rate (overrides config)
+     * @returns Promise that resolves when playback completes
+     */
+    async play(samples, sampleRate) {
+        this.stop(); // Stop any current playback
+        const rate = sampleRate ?? this.config.sampleRate;
+        const durationMs = (samples.length / rate) * 1000;
+        logger.debug(`Playing ${samples.length} samples at ${rate}Hz (${(durationMs / 1000).toFixed(1)}s)`);
+        // Create or resume AudioContext
+        if (!this.audioContext || this.audioContext.state === 'closed') {
+            this.audioContext = new AudioContext({ sampleRate: rate });
+        }
+        if (this.audioContext.state === 'suspended') {
+            await this.audioContext.resume();
+        }
+        // Create gain node for volume control
+        if (!this.gainNode || this.gainNode.context !== this.audioContext) {
+            this.gainNode = this.audioContext.createGain();
+            this.gainNode.connect(this.audioContext.destination);
+        }
+        this.gainNode.gain.value = this.config.volume;
+        // Create audio buffer from samples
+        const audioBuffer = this.audioContext.createBuffer(1, samples.length, rate);
+        audioBuffer.getChannelData(0).set(samples);
+        // Create and play source node
+        return new Promise((resolve) => {
+            const source = this.audioContext.createBufferSource();
+            source.buffer = audioBuffer;
+            source.connect(this.gainNode);
+            source.onended = () => {
+                this._isPlaying = false;
+                this.currentSource = null;
+                EventBus.shared.emit('playback.completed', SDKEventType.Voice, { durationMs });
+                resolve();
+            };
+            this.currentSource = source;
+            this._isPlaying = true;
+            EventBus.shared.emit('playback.started', SDKEventType.Voice, { durationMs, sampleRate: rate });
+            source.start();
+        });
+    }
+    /**
+     * Stop playback immediately.
+     */
+    stop() {
+        if (this.currentSource) {
+            try {
+                this.currentSource.stop();
+            }
+            catch {
+                // Already stopped
+            }
+            this.currentSource = null;
+        }
+        this._isPlaying = false;
+    }
+    /**
+     * Set playback volume.
+     */
+    setVolume(volume) {
+        this.config.volume = Math.max(0, Math.min(1, volume));
+        if (this.gainNode) {
+            this.gainNode.gain.value = this.config.volume;
+        }
+    }
+    /**
+     * Release all audio resources.
+     */
+    dispose() {
+        this.stop();
+        if (this.audioContext && this.audioContext.state !== 'closed') {
+            this.audioContext.close().catch(() => { });
+        }
+        this.audioContext = null;
+        this.gainNode = null;
+    }
+}
+//# sourceMappingURL=AudioPlayback.js.map

package/dist/Infrastructure/AudioPlayback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioPlayback.js","sourceRoot":"","sources":["../../src/Infrastructure/AudioPlayback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,eAAe,CAAC,CAAC;AAW9C;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,YAAY,GAAwB,IAAI,CAAC;IACzC,QAAQ,GAAoB,IAAI,CAAC;IACjC,aAAa,GAAiC,IAAI,CAAC;IACnD,UAAU,GAAG,KAAK,CAAC;IACnB,MAAM,CAA2B;IAEzC,YAAY,SAAyB,EAAE;QACrC,IAAI,CAAC,MAAM,GAAG;YACZ,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,KAAK;YACtC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,GAAG;SAC7B,CAAC;IACJ,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,OAAqB,EAAE,UAAmB;QACnD,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,4BAA4B;QAEzC,MAAM,IAAI,GAAG,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;QAClD,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;QAElD,MAAM,CAAC,KAAK,CAAC,WAAW,OAAO,CAAC,MAAM,eAAe,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEpG,gCAAgC;QAChC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/D,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC5C,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACnC,CAAC;QAED,sCAAsC;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YAClE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,CAAC;YAC/C,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAE9C,mCAAmC;QACnC,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5E,WAAW,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAE3C,8BAA8B;QAC9B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAa,CAAC,kBAAkB,EAAE,CAAC;YACvD,MAAM,CAAC,MAAM,GAAG,WAAW,CAAC;YAC5B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAS,CAAC,CAAC;YAE/B,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;gBACpB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;gBACxB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;gBAC1B,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,YAAY,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC/E,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YAEF,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;YAC5B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YAEvB,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,KAAK,EAAE,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/F,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;YACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAChD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9D,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAgB,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/Infrastructure/DeviceCapabilities.d.ts

@@ -0,0 +1,39 @@
+/**
+ * RunAnywhere Web SDK - Device Capabilities
+ *
+ * Detects browser capabilities relevant to on-device AI inference:
+ * WebGPU, SharedArrayBuffer (for pthreads), WASM SIMD, etc.
+ */
+import type { DeviceInfoData } from '../types/models';
+import type { AccelerationMode } from '../Foundation/WASMBridge';
+export interface WebCapabilities {
+    /** WebGPU available and functional */
+    hasWebGPU: boolean;
+    /** WebGPU adapter info (if available) */
+    gpuAdapterInfo?: Record<string, string>;
+    /** The acceleration mode actually in use by the WASM module ('webgpu' | 'cpu'). */
+    activeAcceleration: AccelerationMode;
+    /** SharedArrayBuffer available (needed for pthreads/multithreaded WASM) */
+    hasSharedArrayBuffer: boolean;
+    /** Cross-Origin Isolation enabled (required for SharedArrayBuffer) */
+    isCrossOriginIsolated: boolean;
+    /** WebAssembly SIMD supported */
+    hasWASMSIMD: boolean;
+    /** Origin Private File System available */
+    hasOPFS: boolean;
+    /** Estimated device memory (GB) */
+    deviceMemoryGB: number;
+    /** Number of logical CPU cores */
+    hardwareConcurrency: number;
+    /** User agent string */
+    userAgent: string;
+}
+/**
+ * Detect all browser capabilities relevant to AI inference.
+ */
+export declare function detectCapabilities(): Promise<WebCapabilities>;
+/**
+ * Build a DeviceInfoData from detected capabilities.
+ */
+export declare function getDeviceInfo(): Promise<DeviceInfoData>;
+//# sourceMappingURL=DeviceCapabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceCapabilities.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/DeviceCapabilities.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,mFAAmF;IACnF,kBAAkB,EAAE,gBAAgB,CAAC;IACrC,2EAA2E;IAC3E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sEAAsE;IACtE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iCAAiC;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,eAAe,CAAC,CA+CnE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,cAAc,CAAC,CAY7D"}

package/dist/Infrastructure/DeviceCapabilities.js

@@ -0,0 +1,111 @@
+/**
+ * RunAnywhere Web SDK - Device Capabilities
+ *
+ * Detects browser capabilities relevant to on-device AI inference:
+ * WebGPU, SharedArrayBuffer (for pthreads), WASM SIMD, etc.
+ */
+import { SDKLogger } from '../Foundation/SDKLogger';
+const logger = new SDKLogger('DeviceCapabilities');
+/**
+ * Detect all browser capabilities relevant to AI inference.
+ */
+export async function detectCapabilities() {
+    // Import WASMBridge lazily to avoid circular imports at module level
+    const { WASMBridge } = await import('../Foundation/WASMBridge');
+    const capabilities = {
+        hasWebGPU: false,
+        activeAcceleration: WASMBridge.shared.isLoaded ? WASMBridge.shared.accelerationMode : 'cpu',
+        hasSharedArrayBuffer: typeof SharedArrayBuffer !== 'undefined',
+        isCrossOriginIsolated: typeof crossOriginIsolated !== 'undefined' ? crossOriginIsolated : false,
+        hasWASMSIMD: detectWASMSIMD(),
+        hasOPFS: typeof navigator !== 'undefined' && 'storage' in navigator && 'getDirectory' in navigator.storage,
+        deviceMemoryGB: navigator.deviceMemory ?? 4,
+        hardwareConcurrency: navigator.hardwareConcurrency ?? 4,
+        userAgent: navigator.userAgent,
+    };
+    // Detect WebGPU
+    if (typeof navigator !== 'undefined' && 'gpu' in navigator) {
+        try {
+            const gpu = navigator.gpu;
+            const adapter = await gpu?.requestAdapter();
+            if (adapter) {
+                capabilities.hasWebGPU = true;
+                try {
+                    const info = await adapter.requestAdapterInfo();
+                    capabilities.gpuAdapterInfo = {
+                        vendor: info.vendor ?? '',
+                        architecture: info.architecture ?? '',
+                        description: info.description ?? '',
+                    };
+                }
+                catch { /* adapter info not available */ }
+            }
+        }
+        catch {
+            logger.debug('WebGPU detection failed');
+        }
+    }
+    logger.info(`Capabilities: WebGPU=${capabilities.hasWebGPU}, ` +
+        `SharedArrayBuffer=${capabilities.hasSharedArrayBuffer}, ` +
+        `SIMD=${capabilities.hasWASMSIMD}, ` +
+        `OPFS=${capabilities.hasOPFS}, ` +
+        `Memory=${capabilities.deviceMemoryGB}GB, ` +
+        `Cores=${capabilities.hardwareConcurrency}`);
+    return capabilities;
+}
+/**
+ * Build a DeviceInfoData from detected capabilities.
+ */
+export async function getDeviceInfo() {
+    const caps = await detectCapabilities();
+    return {
+        model: 'Browser',
+        name: getBrowserName(caps.userAgent),
+        osVersion: getOSVersion(caps.userAgent),
+        totalMemory: caps.deviceMemoryGB * 1024 * 1024 * 1024,
+        architecture: 'wasm32',
+        hasWebGPU: caps.hasWebGPU,
+        hasSharedArrayBuffer: caps.hasSharedArrayBuffer,
+    };
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function detectWASMSIMD() {
+    try {
+        // Check for WASM SIMD support by validating a minimal SIMD module
+        const simdTest = new Uint8Array([
+            0, 97, 115, 109, 1, 0, 0, 0, 1, 5, 1, 96, 0, 1, 123, 3, 2, 1, 0,
+            10, 10, 1, 8, 0, 65, 0, 253, 15, 253, 98, 11,
+        ]);
+        return WebAssembly.validate(simdTest);
+    }
+    catch {
+        return false;
+    }
+}
+function getBrowserName(ua) {
+    if (ua.includes('Firefox'))
+        return 'Firefox';
+    if (ua.includes('Edg/'))
+        return 'Edge';
+    if (ua.includes('Chrome'))
+        return 'Chrome';
+    if (ua.includes('Safari'))
+        return 'Safari';
+    return 'Unknown Browser';
+}
+function getOSVersion(ua) {
+    if (ua.includes('Windows'))
+        return 'Windows';
+    if (ua.includes('Mac OS X'))
+        return 'macOS';
+    if (ua.includes('Linux'))
+        return 'Linux';
+    if (ua.includes('Android'))
+        return 'Android';
+    if (ua.includes('iOS'))
+        return 'iOS';
+    return 'Unknown OS';
+}
+//# sourceMappingURL=DeviceCapabilities.js.map

package/dist/Infrastructure/DeviceCapabilities.js.map

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

package/dist/Infrastructure/ExtensionRegistry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 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.
+ */
+/** Common interface that every SDK extension must implement. */
+export interface SDKExtension {
+    /** Human-readable name for logging / debugging. */
+    readonly extensionName: string;
+    /** Release all resources held by this extension. */
+    cleanup(): void;
+}
+declare class ExtensionRegistryImpl {
+    private extensions;
+    /** Register an extension. Call in dependency order (low-level first). */
+    register(extension: SDKExtension): void;
+    /**
+     * 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(): void;
+    /** Reset the registry (call after full shutdown). */
+    reset(): void;
+}
+export declare const ExtensionRegistry: ExtensionRegistryImpl;
+export {};
+//# sourceMappingURL=ExtensionRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExtensionRegistry.d.ts","sourceRoot":"","sources":["../../src/Infrastructure/ExtensionRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oDAAoD;IACpD,OAAO,IAAI,IAAI,CAAC;CACjB;AAMD,cAAM,qBAAqB;IACzB,OAAO,CAAC,UAAU,CAAsB;IAExC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,YAAY,GAAG,IAAI;IAOvC;;;;OAIG;IACH,UAAU,IAAI,IAAI;IAUlB,qDAAqD;IACrD,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,iBAAiB,uBAA8B,CAAC"}