@runanywhere/web 0.1.0-beta.1

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

@@ -0,0 +1,196 @@
+/**
+ * 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
+ */
+import { RunAnywhere } from '../RunAnywhere';
+import { WASMBridge } from '../../Foundation/WASMBridge';
+import { Offsets } from '../../Foundation/StructOffsets';
+import { SDKError } from '../../Foundation/ErrorTypes';
+import { SDKLogger } from '../../Foundation/SDKLogger';
+const logger = new SDKLogger('StructuredOutput');
+function requireBridge() {
+    if (!RunAnywhere.isInitialized)
+        throw SDKError.notInitialized();
+    return WASMBridge.shared;
+}
+// ---------------------------------------------------------------------------
+// Structured Output Extension
+// ---------------------------------------------------------------------------
+export 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) {
+        const bridge = requireBridge();
+        const m = bridge.module;
+        const textPtr = bridge.allocString(text);
+        const outJsonPtr = m._malloc(4); // char** out_json
+        const outLenPtr = m._malloc(4); // size_t* out_length
+        try {
+            const result = m.ccall('rac_structured_output_extract_json', 'number', ['number', 'number', 'number'], [textPtr, outJsonPtr, outLenPtr]);
+            if (result !== 0)
+                return null;
+            const jsonPtr = m.getValue(outJsonPtr, '*');
+            if (!jsonPtr)
+                return null;
+            const json = bridge.readString(jsonPtr);
+            m._free(jsonPtr); // rac_strdup'd, so we free it
+            return json;
+        }
+        finally {
+            bridge.free(textPtr);
+            m._free(outJsonPtr);
+            m._free(outLenPtr);
+        }
+    },
+    /**
+     * 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, config) {
+        const bridge = requireBridge();
+        const m = bridge.module;
+        const promptPtr = bridge.allocString(originalPrompt);
+        // Build rac_structured_output_config_t: { json_schema, include_schema_in_prompt }
+        const configSize = m._rac_wasm_sizeof_structured_output_config();
+        const configPtr = m._malloc(configSize);
+        const soConf = Offsets.structuredOutputConfig;
+        const schemaPtr = bridge.allocString(config.jsonSchema);
+        m.setValue(configPtr + soConf.jsonSchema, schemaPtr, '*');
+        m.setValue(configPtr + soConf.includeSchemaInPrompt, (config.includeSchemaInPrompt !== false) ? 1 : 0, 'i32');
+        const outPromptPtr = m._malloc(4);
+        try {
+            const result = m.ccall('rac_structured_output_prepare_prompt', 'number', ['number', 'number', 'number'], [promptPtr, configPtr, outPromptPtr]);
+            if (result !== 0) {
+                logger.warning('Failed to prepare structured prompt, returning original');
+                return originalPrompt;
+            }
+            const preparedPtr = m.getValue(outPromptPtr, '*');
+            if (!preparedPtr)
+                return originalPrompt;
+            const prepared = bridge.readString(preparedPtr);
+            m._free(preparedPtr);
+            return prepared;
+        }
+        finally {
+            bridge.free(promptPtr);
+            bridge.free(schemaPtr);
+            m._free(configPtr);
+            m._free(outPromptPtr);
+        }
+    },
+    /**
+     * 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) {
+        const bridge = requireBridge();
+        const m = bridge.module;
+        const schemaPtr = bridge.allocString(jsonSchema);
+        const outPtr = m._malloc(4);
+        try {
+            const result = m.ccall('rac_structured_output_get_system_prompt', 'number', ['number', 'number'], [schemaPtr, outPtr]);
+            if (result !== 0)
+                return '';
+            const ptr = m.getValue(outPtr, '*');
+            if (!ptr)
+                return '';
+            const prompt = bridge.readString(ptr);
+            m._free(ptr);
+            return prompt;
+        }
+        finally {
+            bridge.free(schemaPtr);
+            m._free(outPtr);
+        }
+    },
+    /**
+     * 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, config) {
+        const bridge = requireBridge();
+        const m = bridge.module;
+        const textPtr = bridge.allocString(text);
+        const configSize = m._rac_wasm_sizeof_structured_output_config();
+        const configPtr = m._malloc(configSize);
+        const soConf2 = Offsets.structuredOutputConfig;
+        const schemaPtr = bridge.allocString(config.jsonSchema);
+        m.setValue(configPtr + soConf2.jsonSchema, schemaPtr, '*');
+        m.setValue(configPtr + soConf2.includeSchemaInPrompt, (config.includeSchemaInPrompt !== false) ? 1 : 0, 'i32');
+        // rac_structured_output_validation_t (size from sizeof helper)
+        const valSize = 12; // 3 fields × 4 bytes on wasm32 — all i32/ptr
+        const valPtr = m._malloc(valSize);
+        try {
+            const result = m.ccall('rac_structured_output_validate', 'number', ['number', 'number', 'number'], [textPtr, configPtr, valPtr]);
+            if (result !== 0) {
+                return { isValid: false, errorMessage: 'Validation call failed' };
+            }
+            const soVal = Offsets.structuredOutputValidation;
+            const isValid = m.getValue(valPtr + soVal.isValid, 'i32') === 1;
+            const errorMsgPtr = m.getValue(valPtr + soVal.errorMessage, '*');
+            const extractedPtr = m.getValue(valPtr + soVal.extractedJson, '*');
+            const validation = {
+                isValid,
+                errorMessage: errorMsgPtr ? bridge.readString(errorMsgPtr) : undefined,
+                extractedJson: extractedPtr ? bridge.readString(extractedPtr) : undefined,
+            };
+            // Free C validation struct
+            m.ccall('rac_structured_output_validation_free', null, ['number'], [valPtr]);
+            return validation;
+        }
+        finally {
+            bridge.free(textPtr);
+            bridge.free(schemaPtr);
+            m._free(configPtr);
+        }
+    },
+    /**
+     * 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) {
+        const bridge = requireBridge();
+        const m = bridge.module;
+        const textPtr = bridge.allocString(text);
+        const startPtr = m._malloc(4);
+        const endPtr = m._malloc(4);
+        try {
+            const found = m.ccall('rac_structured_output_find_complete_json', 'number', ['number', 'number', 'number'], [textPtr, startPtr, endPtr]);
+            return found === 1;
+        }
+        finally {
+            bridge.free(textPtr);
+            m._free(startPtr);
+            m._free(endPtr);
+        }
+    },
+};
+//# sourceMappingURL=RunAnywhere+StructuredOutput.js.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * RunAnywhere Web SDK - Text-to-Speech Extension
+ *
+ * Adds TTS (speech synthesis) capabilities via sherpa-onnx WASM.
+ * Uses Piper/VITS ONNX models for offline, on-device speech synthesis.
+ *
+ * Mirrors: sdk/runanywhere-swift/Sources/RunAnywhere/Public/Extensions/TTS/
+ *
+ * Usage:
+ *   import { TTS } from '@runanywhere/web';
+ *
+ *   await TTS.loadVoice({
+ *     voiceId: 'piper-en-amy',
+ *     modelPath: '/models/tts/model.onnx',
+ *     tokensPath: '/models/tts/tokens.txt',
+ *     dataDir: '/models/tts/espeak-ng-data',
+ *   });
+ *
+ *   const result = await TTS.synthesize('Hello world');
+ *   // result.audioData is Float32Array of PCM samples
+ */
+import type { TTSVoiceConfig, TTSSynthesisResult, TTSSynthesizeOptions } from './TTSTypes';
+export type { TTSVoiceConfig, TTSSynthesisResult, TTSSynthesizeOptions } from './TTSTypes';
+declare class TTSImpl {
+    readonly extensionName = "TTS";
+    private _ttsHandle;
+    private _currentVoiceId;
+    /**
+     * Load a TTS voice model via sherpa-onnx.
+     * Model files must already be written to sherpa-onnx virtual FS.
+     */
+    loadVoice(config: TTSVoiceConfig): Promise<void>;
+    /** Unload the TTS voice. */
+    unloadVoice(): Promise<void>;
+    /** Check if a TTS voice is loaded. */
+    get isVoiceLoaded(): boolean;
+    /** Get current voice ID. */
+    get voiceId(): string;
+    /** Get the sample rate of the loaded TTS model. */
+    get sampleRate(): number;
+    /** Get the number of speakers in the loaded model. */
+    get numSpeakers(): number;
+    /**
+     * Synthesize speech from text.
+     *
+     * @param text - Text to synthesize
+     * @param options - Synthesis options (speaker ID, speed)
+     * @returns Synthesis result with PCM audio data
+     */
+    synthesize(text: string, options?: TTSSynthesizeOptions): Promise<TTSSynthesisResult>;
+    /** Clean up the TTS resources. */
+    cleanup(): void;
+}
+export declare const TTS: TTSImpl;
+//# sourceMappingURL=RunAnywhere+TTS.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RunAnywhere+TTS.d.ts","sourceRoot":"","sources":["../../../src/Public/Extensions/RunAnywhere+TTS.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAQH,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3F,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAoB3F,cAAM,OAAO;IACX,QAAQ,CAAC,aAAa,SAAS;IAC/B,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,eAAe,CAAM;IAE7B;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6EtD,4BAA4B;IACtB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC,sCAAsC;IACtC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED,4BAA4B;IAC5B,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,mDAAmD;IACnD,IAAI,UAAU,IAAI,MAAM,CAGvB;IAED,sDAAsD;IACtD,IAAI,WAAW,IAAI,MAAM,CAGxB;IAED;;;;;;OAMG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsG/F,kCAAkC;IAClC,OAAO,IAAI,IAAI;CAShB;AAED,eAAO,MAAM,GAAG,SAAgB,CAAC"}

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

@@ -0,0 +1,253 @@
+/**
+ * RunAnywhere Web SDK - Text-to-Speech Extension
+ *
+ * Adds TTS (speech synthesis) capabilities via sherpa-onnx WASM.
+ * Uses Piper/VITS ONNX models for offline, on-device speech synthesis.
+ *
+ * Mirrors: sdk/runanywhere-swift/Sources/RunAnywhere/Public/Extensions/TTS/
+ *
+ * Usage:
+ *   import { TTS } from '@runanywhere/web';
+ *
+ *   await TTS.loadVoice({
+ *     voiceId: 'piper-en-amy',
+ *     modelPath: '/models/tts/model.onnx',
+ *     tokensPath: '/models/tts/tokens.txt',
+ *     dataDir: '/models/tts/espeak-ng-data',
+ *   });
+ *
+ *   const result = await TTS.synthesize('Hello world');
+ *   // result.audioData is Float32Array of PCM samples
+ */
+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';
+// @ts-ignore – sherpa-onnx-tts.js has no .d.ts
+import { initSherpaOnnxOfflineTtsConfig, freeConfig } from '../../../wasm/sherpa/sherpa-onnx-tts.js';
+const logger = new SDKLogger('TTS');
+// ---------------------------------------------------------------------------
+// Internal Helpers
+// ---------------------------------------------------------------------------
+function requireSherpa() {
+    if (!RunAnywhere.isInitialized)
+        throw SDKError.notInitialized();
+    return SherpaONNXBridge.shared;
+}
+// ---------------------------------------------------------------------------
+// TTS Extension
+// ---------------------------------------------------------------------------
+class TTSImpl {
+    extensionName = 'TTS';
+    _ttsHandle = 0;
+    _currentVoiceId = '';
+    /**
+     * Load a TTS voice model via sherpa-onnx.
+     * Model files must already be written to sherpa-onnx virtual FS.
+     */
+    async loadVoice(config) {
+        const sherpa = requireSherpa();
+        await sherpa.ensureLoaded();
+        const m = sherpa.module;
+        // Clean up previous voice
+        this.cleanup();
+        logger.info(`Loading TTS voice: ${config.voiceId}`);
+        EventBus.shared.emit('model.loadStarted', SDKEventType.Model, {
+            modelId: config.voiceId, component: 'tts',
+        });
+        const startMs = performance.now();
+        // Build the proper C struct config for sherpa-onnx offline TTS
+        // Uses the initSherpaOnnxOfflineTtsConfig helper from sherpa-onnx-tts.js
+        // which packs the config into WASM memory as the C API expects.
+        const configObj = {
+            offlineTtsModelConfig: {
+                offlineTtsVitsModelConfig: {
+                    model: config.modelPath,
+                    lexicon: config.lexicon ?? '',
+                    tokens: config.tokensPath,
+                    dataDir: config.dataDir ?? '',
+                    noiseScale: 0.667,
+                    noiseScaleW: 0.8,
+                    lengthScale: 1.0,
+                },
+                numThreads: config.numThreads ?? 1,
+                debug: 0,
+                provider: 'cpu',
+            },
+            ruleFsts: '',
+            ruleFars: '',
+            maxNumSentences: 1,
+            silenceScale: 0.2,
+        };
+        logger.debug(`Building TTS config struct... (_CopyHeap available: ${typeof m._CopyHeap})`);
+        let configStruct;
+        try {
+            configStruct = initSherpaOnnxOfflineTtsConfig(configObj, m);
+        }
+        catch (initErr) {
+            const msg = initErr instanceof Error ? initErr.message : JSON.stringify(initErr);
+            logger.error(`Failed to build TTS config struct: ${msg}`);
+            throw new SDKError(SDKErrorCode.ModelLoadFailed, `Failed to build TTS config: ${msg}`);
+        }
+        try {
+            logger.debug(`Calling _SherpaOnnxCreateOfflineTts with ptr=${configStruct.ptr}`);
+            this._ttsHandle = m._SherpaOnnxCreateOfflineTts(configStruct.ptr);
+            if (this._ttsHandle === 0) {
+                throw new SDKError(SDKErrorCode.ModelLoadFailed, `Failed to create TTS engine for voice: ${config.voiceId}`);
+            }
+            this._currentVoiceId = config.voiceId;
+            const loadTimeMs = Math.round(performance.now() - startMs);
+            logger.info(`TTS voice loaded: ${config.voiceId} in ${loadTimeMs}ms`);
+            EventBus.shared.emit('model.loadCompleted', SDKEventType.Model, {
+                modelId: config.voiceId, component: 'tts', loadTimeMs,
+            });
+        }
+        catch (error) {
+            this.cleanup();
+            if (error instanceof Error)
+                throw error;
+            const msg = typeof error === 'object' ? JSON.stringify(error) : String(error);
+            throw new SDKError(SDKErrorCode.ModelLoadFailed, `TTS creation failed: ${msg}`);
+        }
+        finally {
+            freeConfig(configStruct, m);
+        }
+    }
+    /** Unload the TTS voice. */
+    async unloadVoice() {
+        this.cleanup();
+        logger.info('TTS voice unloaded');
+    }
+    /** Check if a TTS voice is loaded. */
+    get isVoiceLoaded() {
+        return this._ttsHandle !== 0;
+    }
+    /** Get current voice ID. */
+    get voiceId() {
+        return this._currentVoiceId;
+    }
+    /** Get the sample rate of the loaded TTS model. */
+    get sampleRate() {
+        if (this._ttsHandle === 0)
+            return 0;
+        return SherpaONNXBridge.shared.module._SherpaOnnxOfflineTtsSampleRate(this._ttsHandle);
+    }
+    /** Get the number of speakers in the loaded model. */
+    get numSpeakers() {
+        if (this._ttsHandle === 0)
+            return 0;
+        return SherpaONNXBridge.shared.module._SherpaOnnxOfflineTtsNumSpeakers(this._ttsHandle);
+    }
+    /**
+     * Synthesize speech from text.
+     *
+     * @param text - Text to synthesize
+     * @param options - Synthesis options (speaker ID, speed)
+     * @returns Synthesis result with PCM audio data
+     */
+    async synthesize(text, options = {}) {
+        const sherpa = requireSherpa();
+        const m = sherpa.module;
+        if (this._ttsHandle === 0) {
+            throw new SDKError(SDKErrorCode.ModelNotLoaded, 'No TTS voice loaded. Call loadVoice() first.');
+        }
+        const startMs = performance.now();
+        const sid = options.speakerId ?? 0;
+        const speed = options.speed ?? 1.0;
+        logger.debug(`Synthesizing: "${text.substring(0, 80)}..." (sid=${sid}, speed=${speed})`);
+        const textPtr = sherpa.allocString(text);
+        try {
+            // SherpaOnnxOfflineTtsGenerate returns a pointer to generated audio struct:
+            // struct { const float* samples; int32_t n; int32_t sample_rate; }
+            logger.debug(`Calling _SherpaOnnxOfflineTtsGenerate (handle=${this._ttsHandle})`);
+            let audioPtr;
+            try {
+                audioPtr = m._SherpaOnnxOfflineTtsGenerate(this._ttsHandle, textPtr, sid, speed);
+            }
+            catch (wasmErr) {
+                // C++ exceptions thrown from WASM appear as numeric exception pointers
+                let errMsg;
+                if (typeof wasmErr === 'number') {
+                    // Try to extract C++ exception message from WASM memory
+                    let cppMsg = '';
+                    try {
+                        // Emscripten exception layout: the exception pointer points to the thrown object.
+                        // For std::exception, the what() string is typically at a known offset.
+                        // Try reading as UTF8 string from various offsets
+                        const offsets = [0, 4, 8, 12, 16];
+                        for (const off of offsets) {
+                            const strPtr = m.HEAP32[(wasmErr + off) / 4];
+                            if (strPtr > 0 && strPtr < m.HEAPU8.length) {
+                                const str = m.UTF8ToString(strPtr);
+                                if (str && str.length > 2 && str.length < 1000 && /^[\x20-\x7e]/.test(str)) {
+                                    cppMsg = str;
+                                    break;
+                                }
+                            }
+                        }
+                    }
+                    catch { /* ignore */ }
+                    errMsg = cppMsg
+                        ? `WASM C++ exception: ${cppMsg}`
+                        : `WASM C++ exception (ptr=${wasmErr}). Possible cause: model incompatibility or insufficient memory.`;
+                }
+                else {
+                    errMsg = String(wasmErr);
+                }
+                logger.error(`TTS WASM error: ${errMsg}`);
+                throw new SDKError(SDKErrorCode.GenerationFailed, `TTS synthesis WASM error: ${errMsg}`);
+            }
+            logger.debug(`_SherpaOnnxOfflineTtsGenerate returned: ${audioPtr}`);
+            if (!audioPtr || audioPtr === 0) {
+                throw new SDKError(SDKErrorCode.GenerationFailed, 'TTS synthesis failed (null audio pointer)');
+            }
+            // Read the generated audio struct using HEAP32 (matches sherpa-onnx-tts.js pattern)
+            const numSamples = m.HEAP32[audioPtr / 4 + 1];
+            const sampleRate = m.HEAP32[audioPtr / 4 + 2];
+            const samplesFloatIdx = m.HEAP32[audioPtr / 4] / 4; // float pointer / 4 = float array index
+            logger.debug(`TTS audio: numSamples=${numSamples}, sampleRate=${sampleRate}, samplesIdx=${samplesFloatIdx}`);
+            // Copy audio data from WASM heap
+            const audioData = new Float32Array(numSamples);
+            if (samplesFloatIdx && numSamples > 0) {
+                for (let i = 0; i < numSamples; i++) {
+                    audioData[i] = m.HEAPF32[samplesFloatIdx + i];
+                }
+            }
+            // Destroy the audio struct
+            m._SherpaOnnxDestroyOfflineTtsGeneratedAudio(audioPtr);
+            const processingTimeMs = Math.round(performance.now() - startMs);
+            const durationMs = Math.round((numSamples / sampleRate) * 1000);
+            const result = {
+                audioData,
+                sampleRate,
+                durationMs,
+                processingTimeMs,
+            };
+            EventBus.shared.emit('tts.synthesized', SDKEventType.Voice, {
+                durationMs,
+                sampleRate,
+                textLength: text.length,
+            });
+            logger.debug(`TTS generated ${durationMs}ms audio in ${processingTimeMs}ms`);
+            return result;
+        }
+        finally {
+            sherpa.free(textPtr);
+        }
+    }
+    /** Clean up the TTS resources. */
+    cleanup() {
+        if (this._ttsHandle !== 0) {
+            try {
+                SherpaONNXBridge.shared.module._SherpaOnnxDestroyOfflineTts(this._ttsHandle);
+            }
+            catch { /* ignore */ }
+            this._ttsHandle = 0;
+        }
+        this._currentVoiceId = '';
+    }
+}
+export const TTS = new TTSImpl();
+//# sourceMappingURL=RunAnywhere+TTS.js.map

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

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

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

@@ -0,0 +1,80 @@
+/**
+ * RunAnywhere Web SDK - Text Generation Extension
+ *
+ * Adds LLM text generation capabilities to RunAnywhere.
+ * Mirrors: sdk/runanywhere-swift/Sources/RunAnywhere/Public/Extensions/LLM/
+ *
+ * Usage:
+ *   import { RunAnywhere } from '@runanywhere/web';
+ *
+ *   await RunAnywhere.loadModel('tinyllama-1.1b-q4');
+ *   const result = await RunAnywhere.generate('Hello!', { maxTokens: 100 });
+ *   console.log(result.text);
+ *
+ *   // Streaming
+ *   for await (const token of RunAnywhere.generateStream('Tell me a story')) {
+ *     process.stdout.write(token);
+ *   }
+ */
+import type { LLMGenerationOptions, LLMGenerationResult, LLMStreamingResult } from '../../types/LLMTypes';
+declare class TextGenerationImpl {
+    readonly extensionName = "TextGeneration";
+    private _llmComponentHandle;
+    /** Ensure the SDK is initialized and return the bridge. */
+    private requireBridge;
+    /** Ensure the LLM component is created. */
+    private ensureLLMComponent;
+    /**
+     * Load an LLM model for text generation.
+     *
+     * @param modelPath - Path to the model file (in Emscripten FS)
+     * @param modelId - Model identifier
+     * @param modelName - Human-readable model name
+     */
+    loadModel(modelPath: string, modelId: string, modelName?: string): Promise<void>;
+    /**
+     * Unload the currently loaded LLM model.
+     */
+    unloadModel(): Promise<void>;
+    /**
+     * Check if an LLM model is currently loaded.
+     */
+    get isModelLoaded(): boolean;
+    /**
+     * Generate text from a prompt (non-streaming).
+     *
+     * Uses `ccall` with `{async: true}` so that Emscripten's JSPI / Asyncify
+     * can suspend the WASM stack for async WebGPU buffer operations. Without
+     * this the blocking C function traps with `RuntimeError: unreachable` on
+     * WebGPU builds because the browser event-loop cannot pump GPU command
+     * buffers while the main thread is blocked in a synchronous ccall.
+     *
+     * @param prompt - Input text prompt
+     * @param options - Generation options (temperature, maxTokens, etc.)
+     * @returns Generation result with text and metrics
+     */
+    generate(prompt: string, options?: LLMGenerationOptions): Promise<LLMGenerationResult>;
+    /**
+     * Generate text with streaming (returns AsyncIterable of tokens).
+     *
+     * Async because the underlying C call uses `{async: true}` so Emscripten's
+     * JSPI can suspend the WASM stack during WebGPU buffer operations.  On
+     * CPU-only builds the result is simply an already-resolved Promise.
+     *
+     * @param prompt - Input text prompt
+     * @param options - Generation options
+     * @returns Streaming result with async token stream and final result promise
+     */
+    generateStream(prompt: string, options?: LLMGenerationOptions): Promise<LLMStreamingResult>;
+    /**
+     * Cancel any in-progress generation.
+     */
+    cancel(): void;
+    /**
+     * Clean up the LLM component (frees memory).
+     */
+    cleanup(): void;
+}
+export declare const TextGeneration: TextGenerationImpl;
+export {};
+//# sourceMappingURL=RunAnywhere+TextGeneration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RunAnywhere+TextGeneration.d.ts","sourceRoot":"","sources":["../../../src/Public/Extensions/RunAnywhere+TextGeneration.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AASH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAQ1G,cAAM,kBAAkB;IACtB,QAAQ,CAAC,aAAa,oBAAoB;IAC1C,OAAO,CAAC,mBAAmB,CAAK;IAEhC,2DAA2D;IAC3D,OAAO,CAAC,aAAa;IAOrB,2CAA2C;YAC7B,kBAAkB;IA2BhC;;;;;;OAMG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCtF;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBlC;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAQ3B;IAED;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4HhG;;;;;;;;;;OAUG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA0LrG;;OAEG;IACH,MAAM,IAAI,IAAI;IAUd;;OAEG;IACH,OAAO,IAAI,IAAI;CAWhB;AAED,eAAO,MAAM,cAAc,oBAA2B,CAAC"}