@runanywhere/core 0.16.11 → 0.17.0

package/ios/Frameworks/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_stt_types.h

@@ -1,389 +0,0 @@
-/**
- * @file rac_stt_types.h
- * @brief RunAnywhere Commons - STT Types and Data Structures
- *
- * C port of Swift's STT Models from:
- * Sources/RunAnywhere/Features/STT/Models/STTConfiguration.swift
- * Sources/RunAnywhere/Features/STT/Models/STTOptions.swift
- * Sources/RunAnywhere/Features/STT/Models/STTInput.swift
- * Sources/RunAnywhere/Features/STT/Models/STTOutput.swift
- * Sources/RunAnywhere/Features/STT/Models/STTTranscriptionResult.swift
- *
- * This header defines data structures only. For the service interface,
- * see rac_stt_service.h.
- */
-
-#ifndef RAC_STT_TYPES_H
-#define RAC_STT_TYPES_H
-
-#include <RACommons/rac_types.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// =============================================================================
-// CONSTANTS - Single Source of Truth for STT
-// Swift references these via CRACommons import
-// =============================================================================
-
-// Audio Format Constants
-#define RAC_STT_DEFAULT_SAMPLE_RATE 16000
-#define RAC_STT_MAX_SAMPLE_RATE 48000
-#define RAC_STT_MIN_SAMPLE_RATE 8000
-#define RAC_STT_BYTES_PER_SAMPLE 2
-#define RAC_STT_CHANNELS 1
-
-// Confidence Scores
-#define RAC_STT_DEFAULT_CONFIDENCE 0.9f
-#define RAC_STT_MIN_ACCEPTABLE_CONFIDENCE 0.5f
-
-// Streaming Constants
-#define RAC_STT_DEFAULT_STREAMING_CHUNK_MS 100
-#define RAC_STT_MIN_STREAMING_CHUNK_MS 50
-#define RAC_STT_MAX_STREAMING_CHUNK_MS 1000
-
-// Language
-#define RAC_STT_DEFAULT_LANGUAGE "en"
-
-// =============================================================================
-// AUDIO FORMAT - Mirrors Swift's AudioFormat
-// =============================================================================
-
-/**
- * @brief Audio format enumeration
- * Mirrors Swift's AudioFormat from AudioTypes.swift
- */
-typedef enum rac_audio_format_enum {
-    RAC_AUDIO_FORMAT_PCM = 0,
-    RAC_AUDIO_FORMAT_WAV = 1,
-    RAC_AUDIO_FORMAT_MP3 = 2,
-    RAC_AUDIO_FORMAT_OPUS = 3,
-    RAC_AUDIO_FORMAT_AAC = 4,
-    RAC_AUDIO_FORMAT_FLAC = 5
-} rac_audio_format_enum_t;
-
-// =============================================================================
-// CONFIGURATION - Mirrors Swift's STTConfiguration
-// =============================================================================
-
-/**
- * @brief STT component configuration
- *
- * Mirrors Swift's STTConfiguration struct exactly.
- * See: Sources/RunAnywhere/Features/STT/Models/STTConfiguration.swift
- */
-typedef struct rac_stt_config {
-    /** Model ID (optional - uses default if NULL) */
-    const char* model_id;
-
-    /** Preferred framework for transcription (use -1 for auto) */
-    int32_t preferred_framework;
-
-    /** Language code for transcription (e.g., "en-US") */
-    const char* language;
-
-    /** Sample rate in Hz (default: 16000) */
-    int32_t sample_rate;
-
-    /** Enable automatic punctuation in transcription */
-    rac_bool_t enable_punctuation;
-
-    /** Enable speaker diarization */
-    rac_bool_t enable_diarization;
-
-    /** Vocabulary list for improved recognition (NULL-terminated array, can be NULL) */
-    const char* const* vocabulary_list;
-    size_t num_vocabulary;
-
-    /** Maximum number of alternative transcriptions (default: 1) */
-    int32_t max_alternatives;
-
-    /** Enable word-level timestamps */
-    rac_bool_t enable_timestamps;
-} rac_stt_config_t;
-
-/**
- * @brief Default STT configuration
- */
-static const rac_stt_config_t RAC_STT_CONFIG_DEFAULT = {.model_id = RAC_NULL,
-                                                        .preferred_framework = -1,
-                                                        .language = "en-US",
-                                                        .sample_rate = RAC_STT_DEFAULT_SAMPLE_RATE,
-                                                        .enable_punctuation = RAC_TRUE,
-                                                        .enable_diarization = RAC_FALSE,
-                                                        .vocabulary_list = RAC_NULL,
-                                                        .num_vocabulary = 0,
-                                                        .max_alternatives = 1,
-                                                        .enable_timestamps = RAC_TRUE};
-
-// =============================================================================
-// OPTIONS - Mirrors Swift's STTOptions
-// =============================================================================
-
-/**
- * @brief STT transcription options
- *
- * Mirrors Swift's STTOptions struct.
- * See: Sources/RunAnywhere/Features/STT/Models/STTOptions.swift
- */
-typedef struct rac_stt_options {
-    /** Language code for transcription (e.g., "en", "es", "fr") */
-    const char* language;
-
-    /** Whether to auto-detect the spoken language */
-    rac_bool_t detect_language;
-
-    /** Enable automatic punctuation in transcription */
-    rac_bool_t enable_punctuation;
-
-    /** Enable speaker diarization */
-    rac_bool_t enable_diarization;
-
-    /** Maximum number of speakers (0 = auto) */
-    int32_t max_speakers;
-
-    /** Enable word-level timestamps */
-    rac_bool_t enable_timestamps;
-
-    /** Audio format of input data */
-    rac_audio_format_enum_t audio_format;
-
-    /** Sample rate of input audio (default: 16000 Hz) */
-    int32_t sample_rate;
-} rac_stt_options_t;
-
-/**
- * @brief Default STT options
- */
-static const rac_stt_options_t RAC_STT_OPTIONS_DEFAULT = {.language = "en",
-                                                          .detect_language = RAC_FALSE,
-                                                          .enable_punctuation = RAC_TRUE,
-                                                          .enable_diarization = RAC_FALSE,
-                                                          .max_speakers = 0,
-                                                          .enable_timestamps = RAC_TRUE,
-                                                          .audio_format = RAC_AUDIO_FORMAT_PCM,
-                                                          .sample_rate = 16000};
-
-// =============================================================================
-// RESULT - Mirrors Swift's STTTranscriptionResult
-// =============================================================================
-
-/**
- * @brief Word timestamp information
- */
-typedef struct rac_stt_word {
-    /** The word text */
-    const char* text;
-    /** Start time in milliseconds */
-    int64_t start_ms;
-    /** End time in milliseconds */
-    int64_t end_ms;
-    /** Confidence score (0.0 to 1.0) */
-    float confidence;
-} rac_stt_word_t;
-
-/**
- * @brief STT transcription result
- *
- * Mirrors Swift's STTTranscriptionResult struct.
- */
-typedef struct rac_stt_result {
-    /** Full transcribed text (owned, must be freed with rac_free) */
-    char* text;
-
-    /** Detected language code (can be NULL) */
-    char* detected_language;
-
-    /** Word-level timestamps (can be NULL) */
-    rac_stt_word_t* words;
-    size_t num_words;
-
-    /** Overall confidence score (0.0 to 1.0) */
-    float confidence;
-
-    /** Processing time in milliseconds */
-    int64_t processing_time_ms;
-} rac_stt_result_t;
-
-// =============================================================================
-// INFO - Mirrors Swift's STTService properties
-// =============================================================================
-
-/**
- * @brief STT service info
- */
-typedef struct rac_stt_info {
-    /** Whether the service is ready */
-    rac_bool_t is_ready;
-
-    /** Current model identifier (can be NULL) */
-    const char* current_model;
-
-    /** Whether streaming is supported */
-    rac_bool_t supports_streaming;
-} rac_stt_info_t;
-
-// =============================================================================
-// CALLBACKS
-// =============================================================================
-
-/**
- * @brief STT streaming callback
- *
- * Called for partial transcription results during streaming.
- *
- * @param partial_text Partial transcription text
- * @param is_final Whether this is a final result
- * @param user_data User-provided context
- */
-typedef void (*rac_stt_stream_callback_t)(const char* partial_text, rac_bool_t is_final,
-                                          void* user_data);
-
-// =============================================================================
-// INPUT - Mirrors Swift's STTInput
-// =============================================================================
-
-/**
- * @brief STT input data
- *
- * Mirrors Swift's STTInput struct.
- * See: Sources/RunAnywhere/Features/STT/Models/STTInput.swift
- */
-typedef struct rac_stt_input {
-    /** Audio data bytes (raw audio data) */
-    const uint8_t* audio_data;
-    size_t audio_data_size;
-
-    /** Alternative: audio buffer (PCM float samples) */
-    const float* audio_samples;
-    size_t num_samples;
-
-    /** Audio format of input data */
-    rac_audio_format_enum_t format;
-
-    /** Language code override (can be NULL to use config default) */
-    const char* language;
-
-    /** Sample rate of the audio (default: 16000) */
-    int32_t sample_rate;
-
-    /** Custom options override (can be NULL) */
-    const rac_stt_options_t* options;
-} rac_stt_input_t;
-
-/**
- * @brief Default STT input
- */
-static const rac_stt_input_t RAC_STT_INPUT_DEFAULT = {.audio_data = RAC_NULL,
-                                                      .audio_data_size = 0,
-                                                      .audio_samples = RAC_NULL,
-                                                      .num_samples = 0,
-                                                      .format = RAC_AUDIO_FORMAT_PCM,
-                                                      .language = RAC_NULL,
-                                                      .sample_rate = RAC_STT_DEFAULT_SAMPLE_RATE,
-                                                      .options = RAC_NULL};
-
-// =============================================================================
-// TRANSCRIPTION METADATA - Mirrors Swift's TranscriptionMetadata
-// =============================================================================
-
-/**
- * @brief Transcription metadata
- *
- * Mirrors Swift's TranscriptionMetadata struct.
- * See: Sources/RunAnywhere/Features/STT/Models/STTOutput.swift
- */
-typedef struct rac_transcription_metadata {
-    /** Model ID used for transcription */
-    const char* model_id;
-
-    /** Processing time in milliseconds */
-    int64_t processing_time_ms;
-
-    /** Audio length in milliseconds */
-    int64_t audio_length_ms;
-
-    /** Real-time factor (processing_time / audio_length) */
-    float real_time_factor;
-} rac_transcription_metadata_t;
-
-// =============================================================================
-// TRANSCRIPTION ALTERNATIVE - Mirrors Swift's TranscriptionAlternative
-// =============================================================================
-
-/**
- * @brief Alternative transcription
- *
- * Mirrors Swift's TranscriptionAlternative struct.
- */
-typedef struct rac_transcription_alternative {
-    /** Alternative transcription text */
-    const char* text;
-
-    /** Confidence score (0.0 to 1.0) */
-    float confidence;
-} rac_transcription_alternative_t;
-
-// =============================================================================
-// OUTPUT - Mirrors Swift's STTOutput
-// =============================================================================
-
-/**
- * @brief STT output data
- *
- * Mirrors Swift's STTOutput struct.
- * See: Sources/RunAnywhere/Features/STT/Models/STTOutput.swift
- */
-typedef struct rac_stt_output {
-    /** Transcribed text (owned, must be freed with rac_free) */
-    char* text;
-
-    /** Confidence score (0.0 to 1.0) */
-    float confidence;
-
-    /** Word-level timestamps (can be NULL) */
-    rac_stt_word_t* word_timestamps;
-    size_t num_word_timestamps;
-
-    /** Detected language if auto-detected (can be NULL) */
-    char* detected_language;
-
-    /** Alternative transcriptions (can be NULL) */
-    rac_transcription_alternative_t* alternatives;
-    size_t num_alternatives;
-
-    /** Processing metadata */
-    rac_transcription_metadata_t metadata;
-
-    /** Timestamp in milliseconds since epoch */
-    int64_t timestamp_ms;
-} rac_stt_output_t;
-
-// =============================================================================
-// TRANSCRIPTION RESULT - Alias for compatibility
-// =============================================================================
-
-/**
- * @brief STT transcription result (alias for rac_stt_output_t)
- *
- * For compatibility with existing code that uses "result" terminology.
- */
-typedef rac_stt_output_t rac_stt_transcription_result_t;
-
-// =============================================================================
-// MEMORY MANAGEMENT
-// =============================================================================
-
-/**
- * @brief Free STT result resources
- *
- * @param result Result to free (can be NULL)
- */
-RAC_API void rac_stt_result_free(rac_stt_result_t* result);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* RAC_STT_TYPES_H */

package/ios/Frameworks/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_stt_whispercpp.h

@@ -1,153 +0,0 @@
-/**
- * @file rac_stt_whispercpp.h
- * @brief RunAnywhere Core - WhisperCPP Backend for STT
- *
- * RAC API for WhisperCPP-based speech-to-text.
- * Provides high-quality transcription using whisper.cpp.
- *
- * NOTE: WhisperCPP and LlamaCPP both use GGML, which can cause symbol
- * conflicts if linked together. Use ONNX Whisper for STT when also
- * using LlamaCPP for LLM, or build with symbol prefixing.
- */
-
-#ifndef RAC_STT_WHISPERCPP_H
-#define RAC_STT_WHISPERCPP_H
-
-#include <RACommons/rac_error.h>
-#include <RACommons/rac_types.h>
-#include <RACommons/rac_stt.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// =============================================================================
-// EXPORT MACRO
-// =============================================================================
-
-#if defined(RAC_WHISPERCPP_BUILDING)
-#if defined(_WIN32)
-#define RAC_WHISPERCPP_API __declspec(dllexport)
-#elif defined(__GNUC__) || defined(__clang__)
-#define RAC_WHISPERCPP_API __attribute__((visibility("default")))
-#else
-#define RAC_WHISPERCPP_API
-#endif
-#else
-#define RAC_WHISPERCPP_API
-#endif
-
-// =============================================================================
-// CONFIGURATION
-// =============================================================================
-
-/**
- * WhisperCPP-specific configuration.
- */
-typedef struct rac_stt_whispercpp_config {
-    /** Number of threads (0 = auto) */
-    int32_t num_threads;
-
-    /** Enable GPU acceleration (Metal on Apple) */
-    rac_bool_t use_gpu;
-
-    /** Enable CoreML acceleration (Apple only) */
-    rac_bool_t use_coreml;
-
-    /** Language code for transcription (NULL = auto-detect) */
-    const char* language;
-
-    /** Translate to English (when source is non-English) */
-    rac_bool_t translate;
-} rac_stt_whispercpp_config_t;
-
-/**
- * Default WhisperCPP configuration.
- */
-static const rac_stt_whispercpp_config_t RAC_STT_WHISPERCPP_CONFIG_DEFAULT = {
-    .num_threads = 0,
-    .use_gpu = RAC_TRUE,
-    .use_coreml = RAC_TRUE,
-    .language = NULL,
-    .translate = RAC_FALSE};
-
-// =============================================================================
-// WHISPERCPP STT API
-// =============================================================================
-
-/**
- * Creates a WhisperCPP STT service.
- *
- * @param model_path Path to the Whisper GGML model file (.bin)
- * @param config WhisperCPP-specific configuration (can be NULL for defaults)
- * @param out_handle Output: Handle to the created service
- * @return RAC_SUCCESS or error code
- */
-RAC_WHISPERCPP_API rac_result_t rac_stt_whispercpp_create(const char* model_path,
-                                                          const rac_stt_whispercpp_config_t* config,
-                                                          rac_handle_t* out_handle);
-
-/**
- * Transcribes audio data.
- *
- * @param handle Service handle
- * @param audio_samples Float32 PCM samples (16kHz mono)
- * @param num_samples Number of samples
- * @param options STT options (can be NULL for defaults)
- * @param out_result Output: Transcription result
- * @return RAC_SUCCESS or error code
- */
-RAC_WHISPERCPP_API rac_result_t rac_stt_whispercpp_transcribe(rac_handle_t handle,
-                                                              const float* audio_samples,
-                                                              size_t num_samples,
-                                                              const rac_stt_options_t* options,
-                                                              rac_stt_result_t* out_result);
-
-/**
- * Gets detected language after transcription.
- *
- * @param handle Service handle
- * @param out_language Output: Language code (caller must free)
- * @return RAC_SUCCESS or error code
- */
-RAC_WHISPERCPP_API rac_result_t rac_stt_whispercpp_get_language(rac_handle_t handle,
-                                                                char** out_language);
-
-/**
- * Checks if model is loaded and ready.
- *
- * @param handle Service handle
- * @return RAC_TRUE if ready
- */
-RAC_WHISPERCPP_API rac_bool_t rac_stt_whispercpp_is_ready(rac_handle_t handle);
-
-/**
- * Destroys a WhisperCPP STT service.
- *
- * @param handle Service handle to destroy
- */
-RAC_WHISPERCPP_API void rac_stt_whispercpp_destroy(rac_handle_t handle);
-
-// =============================================================================
-// BACKEND REGISTRATION
-// =============================================================================
-
-/**
- * Registers the WhisperCPP backend with the commons module and service registries.
- *
- * @return RAC_SUCCESS or error code
- */
-RAC_WHISPERCPP_API rac_result_t rac_backend_whispercpp_register(void);
-
-/**
- * Unregisters the WhisperCPP backend.
- *
- * @return RAC_SUCCESS or error code
- */
-RAC_WHISPERCPP_API rac_result_t rac_backend_whispercpp_unregister(void);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* RAC_STT_WHISPERCPP_H */