@runanywhere/web 0.1.0-beta.1

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

@@ -0,0 +1,417 @@
+/**
+ * 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 { RunAnywhere } from '../RunAnywhere';
+import { SherpaONNXBridge } from '../../Foundation/SherpaONNXBridge';
+import { SDKError, SDKErrorCode } from '../../Foundation/ErrorTypes';
+import { SDKLogger } from '../../Foundation/SDKLogger';
+import { EventBus } from '../../Foundation/EventBus';
+import { SDKEventType } from '../../types/enums';
+import { STTModelType } from './STTTypes';
+// Import sherpa-onnx C struct packing helpers.
+// These functions properly allocate and fill C structs in WASM memory
+// for passing to the sherpa-onnx C API.
+// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+// @ts-ignore — JS helper file, no .d.ts available
+import { initSherpaOnnxOfflineRecognizerConfig, initSherpaOnnxOnlineRecognizerConfig, freeConfig } from '../../../wasm/sherpa/sherpa-onnx-asr.js';
+const logger = new SDKLogger('STT');
+// ---------------------------------------------------------------------------
+// STT Types (re-exported from STTTypes.ts)
+// ---------------------------------------------------------------------------
+export { STTModelType } from './STTTypes';
+// ---------------------------------------------------------------------------
+// Config Builders (stateless helpers)
+// ---------------------------------------------------------------------------
+function requireSherpa() {
+    if (!RunAnywhere.isInitialized)
+        throw SDKError.notInitialized();
+    return SherpaONNXBridge.shared;
+}
+/**
+ * Build a sherpa-onnx offline recognizer config object suitable for
+ * `initSherpaOnnxOfflineRecognizerConfig()` from sherpa-onnx-asr.js.
+ *
+ * This returns a plain JS config object that the helper function will
+ * pack into a C struct in WASM memory.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function buildOfflineRecognizerConfig(config) {
+    const sampleRate = config.sampleRate ?? 16000;
+    const files = config.modelFiles;
+    // Base config with all model types empty (required for struct layout)
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const modelConfig = {
+        transducer: { encoder: '', decoder: '', joiner: '' },
+        paraformer: { model: '' },
+        nemoCtc: { model: '' },
+        whisper: { encoder: '', decoder: '', language: '', task: '', tailPaddings: -1 },
+        tdnn: { model: '' },
+        senseVoice: { model: '', language: '', useInverseTextNormalization: 0 },
+        moonshine: { preprocessor: '', encoder: '', uncachedDecoder: '', cachedDecoder: '' },
+        fireRedAsr: { encoder: '', decoder: '' },
+        dolphin: { model: '' },
+        zipformerCtc: { model: '' },
+        canary: { encoder: '', decoder: '', srcLang: '', tgtLang: '', usePnc: 1 },
+        wenetCtc: { model: '' },
+        omnilingual: { model: '' },
+        tokens: '',
+        numThreads: 1,
+        provider: 'cpu',
+        debug: 0,
+        modelType: '',
+        modelingUnit: '',
+        bpeVocab: '',
+        teleSpeechCtc: '',
+    };
+    if (config.type === STTModelType.Whisper) {
+        const f = files;
+        modelConfig.whisper = {
+            encoder: f.encoder,
+            decoder: f.decoder,
+            language: config.language ?? 'en',
+            task: 'transcribe',
+            tailPaddings: -1,
+        };
+        modelConfig.tokens = f.tokens;
+    }
+    else if (config.type === STTModelType.Paraformer) {
+        const f = files;
+        modelConfig.paraformer = { model: f.model };
+        modelConfig.tokens = f.tokens;
+    }
+    return {
+        featConfig: { sampleRate, featureDim: 80 },
+        modelConfig,
+        lmConfig: { model: '', scale: 1.0 },
+        decodingMethod: 'greedy_search',
+        maxActivePaths: 4,
+        hotwordsFile: '',
+        hotwordsScore: 1.5,
+        ruleFsts: '',
+        ruleFars: '',
+        blankPenalty: 0,
+    };
+}
+/**
+ * Build a sherpa-onnx online recognizer config object suitable for
+ * `initSherpaOnnxOnlineRecognizerConfig()` from sherpa-onnx-asr.js.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function buildOnlineRecognizerConfig(config) {
+    const sampleRate = config.sampleRate ?? 16000;
+    const files = config.modelFiles;
+    return {
+        featConfig: { sampleRate, featureDim: 80 },
+        modelConfig: {
+            transducer: {
+                encoder: files.encoder,
+                decoder: files.decoder,
+                joiner: files.joiner,
+            },
+            paraformer: { encoder: '', decoder: '' },
+            zipformer2Ctc: { model: '' },
+            nemoCtc: { model: '' },
+            toneCtc: { model: '' },
+            tokens: files.tokens,
+            numThreads: 1,
+            provider: 'cpu',
+            debug: 0,
+            modelType: '',
+            modelingUnit: '',
+            bpeVocab: '',
+        },
+        decodingMethod: 'greedy_search',
+        maxActivePaths: 4,
+        enableEndpoint: 1,
+        rule1MinTrailingSilence: 2.4,
+        rule2MinTrailingSilence: 1.2,
+        rule3MinUtteranceLength: 20,
+        hotwordsFile: '',
+        hotwordsScore: 1.5,
+        ctcFstDecoderConfig: { graph: '', maxActive: 3000 },
+        ruleFsts: '',
+        ruleFars: '',
+    };
+}
+// ---------------------------------------------------------------------------
+// STT Extension
+// ---------------------------------------------------------------------------
+class STTImpl {
+    extensionName = 'STT';
+    _offlineRecognizerHandle = 0;
+    _onlineRecognizerHandle = 0;
+    _currentModelType = STTModelType.Whisper;
+    _currentModelId = '';
+    /** Returns the currently loaded STT model type. */
+    get currentModelType() {
+        return this._currentModelType;
+    }
+    /**
+     * Load an STT model via sherpa-onnx.
+     * Model files must already be written to sherpa-onnx virtual FS
+     * (use SherpaONNXBridge.shared.downloadAndWrite() or .writeFile()).
+     */
+    async loadModel(config) {
+        const sherpa = requireSherpa();
+        await sherpa.ensureLoaded();
+        const m = sherpa.module;
+        // Clean up previous model
+        this.cleanup();
+        logger.info(`Loading STT model: ${config.modelId} (${config.type})`);
+        EventBus.shared.emit('model.loadStarted', SDKEventType.Model, {
+            modelId: config.modelId, component: 'stt',
+        });
+        const startMs = performance.now();
+        try {
+            if (config.type === STTModelType.Zipformer) {
+                // Streaming model: use online recognizer
+                const configObj = buildOnlineRecognizerConfig(config);
+                const configStruct = initSherpaOnnxOnlineRecognizerConfig(configObj, m);
+                this._onlineRecognizerHandle = m._SherpaOnnxCreateOnlineRecognizer(configStruct.ptr);
+                freeConfig(configStruct, m);
+                if (this._onlineRecognizerHandle === 0) {
+                    throw new SDKError(SDKErrorCode.ModelLoadFailed, `Failed to create online recognizer for ${config.modelId}`);
+                }
+            }
+            else {
+                // Non-streaming model (Whisper, Paraformer): use offline recognizer
+                const configObj = buildOfflineRecognizerConfig(config);
+                logger.debug(`Offline config: ${JSON.stringify(configObj.modelConfig.whisper)}`);
+                const configStruct = initSherpaOnnxOfflineRecognizerConfig(configObj, m);
+                this._offlineRecognizerHandle = m._SherpaOnnxCreateOfflineRecognizer(configStruct.ptr);
+                freeConfig(configStruct, m);
+                if (this._offlineRecognizerHandle === 0) {
+                    throw new SDKError(SDKErrorCode.ModelLoadFailed, `Failed to create offline recognizer for ${config.modelId}`);
+                }
+            }
+            this._currentModelType = config.type;
+            this._currentModelId = config.modelId;
+            const loadTimeMs = Math.round(performance.now() - startMs);
+            logger.info(`STT model loaded: ${config.modelId} in ${loadTimeMs}ms`);
+            EventBus.shared.emit('model.loadCompleted', SDKEventType.Model, {
+                modelId: config.modelId, component: 'stt', loadTimeMs,
+            });
+        }
+        catch (error) {
+            this.cleanup();
+            throw error;
+        }
+    }
+    /** Unload the STT model. */
+    async unloadModel() {
+        this.cleanup();
+        logger.info('STT model unloaded');
+    }
+    /** Check if an STT model is loaded. */
+    get isModelLoaded() {
+        return this._offlineRecognizerHandle !== 0 || this._onlineRecognizerHandle !== 0;
+    }
+    /** Get the current model ID. */
+    get modelId() {
+        return this._currentModelId;
+    }
+    /**
+     * Transcribe audio data (offline / non-streaming).
+     *
+     * @param audioSamples - Float32Array of PCM audio samples (mono, 16kHz)
+     * @param options - Transcription options
+     * @returns Transcription result
+     */
+    async transcribe(audioSamples, options = {}) {
+        const sherpa = requireSherpa();
+        const m = sherpa.module;
+        if (this._offlineRecognizerHandle === 0) {
+            if (this._onlineRecognizerHandle !== 0) {
+                // Streaming model: process all at once via online recognizer
+                return this._transcribeViaOnline(audioSamples, options);
+            }
+            throw new SDKError(SDKErrorCode.ModelNotLoaded, 'No STT model loaded. Call loadModel() first.');
+        }
+        const startMs = performance.now();
+        const sampleRate = options.sampleRate ?? 16000;
+        logger.debug(`Transcribing ${audioSamples.length} samples (${(audioSamples.length / sampleRate).toFixed(1)}s)`);
+        // Create stream
+        const stream = m._SherpaOnnxCreateOfflineStream(this._offlineRecognizerHandle);
+        if (stream === 0) {
+            throw new SDKError(SDKErrorCode.GenerationFailed, 'Failed to create offline stream');
+        }
+        // Copy audio to WASM memory
+        const audioPtr = m._malloc(audioSamples.length * 4);
+        m.HEAPF32.set(audioSamples, audioPtr / 4);
+        try {
+            // Feed audio
+            m._SherpaOnnxAcceptWaveformOffline(stream, sampleRate, audioPtr, audioSamples.length);
+            // Decode
+            m._SherpaOnnxDecodeOfflineStream(this._offlineRecognizerHandle, stream);
+            // Get result as JSON
+            const jsonPtr = m._SherpaOnnxGetOfflineStreamResultAsJson(stream);
+            const jsonStr = sherpa.readString(jsonPtr);
+            m._SherpaOnnxDestroyOfflineStreamResultJson(jsonPtr);
+            const result = JSON.parse(jsonStr || '{}');
+            const processingTimeMs = Math.round(performance.now() - startMs);
+            const transcription = {
+                text: (result.text ?? '').trim(),
+                confidence: result.confidence ?? 0,
+                detectedLanguage: result.lang,
+                processingTimeMs,
+            };
+            EventBus.shared.emit('stt.transcribed', SDKEventType.Voice, {
+                text: transcription.text,
+                confidence: transcription.confidence,
+            });
+            return transcription;
+        }
+        finally {
+            m._free(audioPtr);
+            m._SherpaOnnxDestroyOfflineStream(stream);
+        }
+    }
+    /** Internal: Transcribe via online recognizer (for streaming models used non-streaming) */
+    async _transcribeViaOnline(audioSamples, options = {}) {
+        const m = SherpaONNXBridge.shared.module;
+        const startMs = performance.now();
+        const sampleRate = options.sampleRate ?? 16000;
+        const stream = m._SherpaOnnxCreateOnlineStream(this._onlineRecognizerHandle);
+        if (stream === 0) {
+            throw new SDKError(SDKErrorCode.GenerationFailed, 'Failed to create online stream');
+        }
+        const audioPtr = m._malloc(audioSamples.length * 4);
+        m.HEAPF32.set(audioSamples, audioPtr / 4);
+        try {
+            m._SherpaOnnxOnlineStreamAcceptWaveform(stream, sampleRate, audioPtr, audioSamples.length);
+            m._SherpaOnnxOnlineStreamInputFinished(stream);
+            while (m._SherpaOnnxIsOnlineStreamReady(this._onlineRecognizerHandle, stream)) {
+                m._SherpaOnnxDecodeOnlineStream(this._onlineRecognizerHandle, stream);
+            }
+            const jsonPtr = m._SherpaOnnxGetOnlineStreamResultAsJson(this._onlineRecognizerHandle, stream);
+            const jsonStr = SherpaONNXBridge.shared.readString(jsonPtr);
+            m._SherpaOnnxDestroyOnlineStreamResultJson(jsonPtr);
+            const result = JSON.parse(jsonStr || '{}');
+            const processingTimeMs = Math.round(performance.now() - startMs);
+            return {
+                text: (result.text ?? '').trim(),
+                confidence: result.confidence ?? 0,
+                processingTimeMs,
+            };
+        }
+        finally {
+            m._free(audioPtr);
+            m._SherpaOnnxDestroyOnlineStream(stream);
+        }
+    }
+    /**
+     * Create a streaming transcription session.
+     * Returns an object to feed audio chunks and get results.
+     */
+    createStreamingSession(options = {}) {
+        if (this._onlineRecognizerHandle === 0) {
+            throw new SDKError(SDKErrorCode.ModelNotLoaded, 'No streaming STT model loaded. Use a zipformer model.');
+        }
+        return new STTStreamingSessionImpl(this._onlineRecognizerHandle, options);
+    }
+    /** Clean up the STT resources. */
+    cleanup() {
+        const sherpa = SherpaONNXBridge.shared;
+        if (!sherpa.isLoaded)
+            return;
+        const m = sherpa.module;
+        if (this._offlineRecognizerHandle !== 0) {
+            try {
+                m._SherpaOnnxDestroyOfflineRecognizer(this._offlineRecognizerHandle);
+            }
+            catch { /* ignore */ }
+            this._offlineRecognizerHandle = 0;
+        }
+        if (this._onlineRecognizerHandle !== 0) {
+            try {
+                m._SherpaOnnxDestroyOnlineRecognizer(this._onlineRecognizerHandle);
+            }
+            catch { /* ignore */ }
+            this._onlineRecognizerHandle = 0;
+        }
+        this._currentModelId = '';
+    }
+}
+export const STT = new STTImpl();
+/** Returns the currently loaded STT model type. */
+export function getCurrentSTTModelType() {
+    return STT.currentModelType;
+}
+class STTStreamingSessionImpl {
+    _stream;
+    _recognizer;
+    _sampleRate;
+    constructor(recognizer, options) {
+        this._recognizer = recognizer;
+        this._sampleRate = options.sampleRate ?? 16000;
+        const m = SherpaONNXBridge.shared.module;
+        this._stream = m._SherpaOnnxCreateOnlineStream(recognizer);
+        if (this._stream === 0) {
+            throw new SDKError(SDKErrorCode.GenerationFailed, 'Failed to create streaming session');
+        }
+    }
+    acceptWaveform(samples, sampleRate) {
+        const m = SherpaONNXBridge.shared.module;
+        const audioPtr = m._malloc(samples.length * 4);
+        m.HEAPF32.set(samples, audioPtr / 4);
+        m._SherpaOnnxOnlineStreamAcceptWaveform(this._stream, sampleRate ?? this._sampleRate, audioPtr, samples.length);
+        m._free(audioPtr);
+        // Decode available frames
+        while (m._SherpaOnnxIsOnlineStreamReady(this._recognizer, this._stream)) {
+            m._SherpaOnnxDecodeOnlineStream(this._recognizer, this._stream);
+        }
+    }
+    inputFinished() {
+        SherpaONNXBridge.shared.module._SherpaOnnxOnlineStreamInputFinished(this._stream);
+    }
+    getResult() {
+        const m = SherpaONNXBridge.shared.module;
+        const jsonPtr = m._SherpaOnnxGetOnlineStreamResultAsJson(this._recognizer, this._stream);
+        const jsonStr = SherpaONNXBridge.shared.readString(jsonPtr);
+        m._SherpaOnnxDestroyOnlineStreamResultJson(jsonPtr);
+        const result = JSON.parse(jsonStr || '{}');
+        const isEndpoint = m._SherpaOnnxOnlineStreamIsEndpoint(this._recognizer, this._stream) !== 0;
+        return {
+            text: (result.text ?? '').trim(),
+            isEndpoint,
+        };
+    }
+    reset() {
+        SherpaONNXBridge.shared.module._SherpaOnnxOnlineStreamReset(this._recognizer, this._stream);
+    }
+    destroy() {
+        if (this._stream !== 0) {
+            try {
+                SherpaONNXBridge.shared.module._SherpaOnnxDestroyOnlineStream(this._stream);
+            }
+            catch { /* ignore */ }
+            this._stream = 0;
+        }
+    }
+}
+//# sourceMappingURL=RunAnywhere+STT.js.map

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * RunAnywhere Web SDK - Structured Output Extension
+ *
+ * Adds JSON-structured output capabilities for LLM generation.
+ * Uses the RACommons rac_structured_output_* C API for schema-guided
+ * generation and JSON extraction/validation.
+ *
+ * Mirrors: sdk/runanywhere-swift/Sources/RunAnywhere/Public/Extensions/StructuredOutput/
+ *
+ * Usage:
+ *   import { StructuredOutput, TextGeneration } from '@runanywhere/web';
+ *
+ *   const schema = JSON.stringify({ type: 'object', properties: { name: { type: 'string' } } });
+ *   const prompt = await StructuredOutput.preparePrompt('List 3 colors', schema);
+ *   const result = await TextGeneration.generate(prompt);
+ *   const validated = StructuredOutput.validate(result.text, schema);
+ *   console.log(validated.extractedJson); // parsed JSON
+ */
+export interface StructuredOutputConfig {
+    /** JSON Schema string */
+    jsonSchema: string;
+    /** Whether to include the schema in the prompt (default: true) */
+    includeSchemaInPrompt?: boolean;
+}
+export interface StructuredOutputValidation {
+    isValid: boolean;
+    errorMessage?: string;
+    extractedJson?: string;
+}
+export declare const StructuredOutput: {
+    /**
+     * Extract JSON from a text response (finds first complete JSON object/array).
+     *
+     * @param text - Raw LLM output text
+     * @returns Extracted JSON string, or null if none found
+     */
+    extractJson(text: string): string | null;
+    /**
+     * Prepare a prompt with schema instructions for structured output.
+     *
+     * @param originalPrompt - The user's original prompt
+     * @param config - Schema configuration
+     * @returns Enhanced prompt with schema instructions
+     */
+    preparePrompt(originalPrompt: string, config: StructuredOutputConfig): string;
+    /**
+     * Get a system prompt that instructs the LLM to produce JSON matching a schema.
+     *
+     * @param jsonSchema - JSON Schema string
+     * @returns System prompt string
+     */
+    getSystemPrompt(jsonSchema: string): string;
+    /**
+     * Validate LLM output against a JSON schema.
+     *
+     * @param text - Raw LLM output
+     * @param config - Schema configuration
+     * @returns Validation result with extracted JSON if valid
+     */
+    validate(text: string, config: StructuredOutputConfig): StructuredOutputValidation;
+    /**
+     * Check if text contains a complete JSON object or array.
+     *
+     * @param text - Text to check
+     * @returns True if a complete JSON block was found
+     */
+    hasCompleteJson(text: string): boolean;
+};
+//# sourceMappingURL=RunAnywhere+StructuredOutput.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RunAnywhere+StructuredOutput.d.ts","sourceRoot":"","sources":["../../../src/Public/Extensions/RunAnywhere+StructuredOutput.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAmBH,MAAM,WAAW,sBAAsB;IACrC,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD,eAAO,MAAM,gBAAgB;IAC3B;;;;;OAKG;sBACe,MAAM,GAAG,MAAM,GAAG,IAAI;IA8BxC;;;;;;OAMG;kCAC2B,MAAM,UAAU,sBAAsB,GAAG,MAAM;IA0C7E;;;;;OAKG;gCACyB,MAAM,GAAG,MAAM;IA4B3C;;;;;;OAMG;mBACY,MAAM,UAAU,sBAAsB,GAAG,0BAA0B;IAkDlF;;;;;OAKG;0BACmB,MAAM,GAAG,OAAO;CAqBvC,CAAC"}