@runanywhere/core 0.16.0

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_stt_analytics.h

@@ -0,0 +1,204 @@
+/**
+ * @file rac_stt_analytics.h
+ * @brief STT analytics service - 1:1 port of STTAnalyticsService.swift
+ *
+ * Tracks transcription operations and metrics.
+ * Lifecycle events are handled by the lifecycle manager.
+ *
+ * NOTE: Audio length estimation assumes 16-bit PCM @ 16kHz (standard for STT).
+ * Formula: audioLengthMs = (bytes / 2) / 16000 * 1000
+ *
+ * NOTE: Real-Time Factor (RTF) will be 0 or undefined for streaming transcription
+ * since audioLengthMs = 0 when audio is processed in chunks of unknown total length.
+ *
+ * Swift Source: Sources/RunAnywhere/Features/STT/Analytics/STTAnalyticsService.swift
+ */
+
+#ifndef RAC_STT_ANALYTICS_H
+#define RAC_STT_ANALYTICS_H
+
+#include <RACommons/rac_types.h>
+#include <RACommons/rac_stt_types.h>
+#include <RACommons/rac_model_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+/**
+ * @brief Opaque handle for STT analytics service
+ */
+typedef struct rac_stt_analytics_s* rac_stt_analytics_handle_t;
+
+/**
+ * @brief STT metrics structure
+ * Mirrors Swift's STTMetrics struct
+ */
+typedef struct rac_stt_metrics {
+    /** Total number of events tracked */
+    int32_t total_events;
+
+    /** Start time (milliseconds since epoch) */
+    int64_t start_time_ms;
+
+    /** Last event time (milliseconds since epoch, 0 if no events) */
+    int64_t last_event_time_ms;
+
+    /** Total number of transcriptions */
+    int32_t total_transcriptions;
+
+    /** Average confidence score across all transcriptions (0.0 to 1.0) */
+    float average_confidence;
+
+    /** Average processing latency in milliseconds */
+    double average_latency_ms;
+
+    /** Average real-time factor (processing time / audio length) */
+    double average_real_time_factor;
+
+    /** Total audio processed in milliseconds */
+    double total_audio_processed_ms;
+} rac_stt_metrics_t;
+
+// =============================================================================
+// LIFECYCLE
+// =============================================================================
+
+/**
+ * @brief Create an STT analytics service instance
+ *
+ * @param out_handle Output: Handle to the created service
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_create(rac_stt_analytics_handle_t* out_handle);
+
+/**
+ * @brief Destroy an STT analytics service instance
+ *
+ * @param handle Handle to destroy
+ */
+RAC_API void rac_stt_analytics_destroy(rac_stt_analytics_handle_t handle);
+
+// =============================================================================
+// TRANSCRIPTION TRACKING
+// =============================================================================
+
+/**
+ * @brief Start tracking a transcription
+ *
+ * @param handle Analytics service handle
+ * @param model_id The STT model identifier
+ * @param audio_length_ms Duration of audio in milliseconds
+ * @param audio_size_bytes Size of audio data in bytes
+ * @param language Language code for transcription
+ * @param is_streaming Whether this is a streaming transcription
+ * @param sample_rate Audio sample rate in Hz (default: 16000)
+ * @param framework The inference framework being used
+ * @param out_transcription_id Output: Generated unique ID (owned, must be freed with rac_free)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_start_transcription(
+    rac_stt_analytics_handle_t handle, const char* model_id, double audio_length_ms,
+    int32_t audio_size_bytes, const char* language, rac_bool_t is_streaming, int32_t sample_rate,
+    rac_inference_framework_t framework, char** out_transcription_id);
+
+/**
+ * @brief Track partial transcript (for streaming transcription)
+ *
+ * @param handle Analytics service handle
+ * @param text Partial transcript text
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_track_partial_transcript(rac_stt_analytics_handle_t handle,
+                                                                const char* text);
+
+/**
+ * @brief Track final transcript (for streaming transcription)
+ *
+ * @param handle Analytics service handle
+ * @param text Final transcript text
+ * @param confidence Confidence score (0.0 to 1.0)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_track_final_transcript(rac_stt_analytics_handle_t handle,
+                                                              const char* text, float confidence);
+
+/**
+ * @brief Complete a transcription
+ *
+ * @param handle Analytics service handle
+ * @param transcription_id The transcription ID
+ * @param text The transcribed text
+ * @param confidence Confidence score (0.0 to 1.0)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_complete_transcription(rac_stt_analytics_handle_t handle,
+                                                              const char* transcription_id,
+                                                              const char* text, float confidence);
+
+/**
+ * @brief Track transcription failure
+ *
+ * @param handle Analytics service handle
+ * @param transcription_id The transcription ID
+ * @param error_code Error code
+ * @param error_message Error message
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_track_transcription_failed(rac_stt_analytics_handle_t handle,
+                                                                  const char* transcription_id,
+                                                                  rac_result_t error_code,
+                                                                  const char* error_message);
+
+/**
+ * @brief Track language detection
+ *
+ * @param handle Analytics service handle
+ * @param language Detected language code
+ * @param confidence Detection confidence (0.0 to 1.0)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_track_language_detection(rac_stt_analytics_handle_t handle,
+                                                                const char* language,
+                                                                float confidence);
+
+/**
+ * @brief Track an error during STT operations
+ *
+ * @param handle Analytics service handle
+ * @param error_code Error code
+ * @param error_message Error message
+ * @param operation Operation that failed
+ * @param model_id Model ID (can be NULL)
+ * @param transcription_id Transcription ID (can be NULL)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_track_error(rac_stt_analytics_handle_t handle,
+                                                   rac_result_t error_code,
+                                                   const char* error_message, const char* operation,
+                                                   const char* model_id,
+                                                   const char* transcription_id);
+
+// =============================================================================
+// METRICS
+// =============================================================================
+
+/**
+ * @brief Get current analytics metrics
+ *
+ * @param handle Analytics service handle
+ * @param out_metrics Output: Metrics structure
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_analytics_get_metrics(rac_stt_analytics_handle_t handle,
+                                                   rac_stt_metrics_t* out_metrics);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_STT_ANALYTICS_H */

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_stt_component.h

@@ -0,0 +1,162 @@
+/**
+ * @file rac_stt_component.h
+ * @brief RunAnywhere Commons - STT Capability Component
+ *
+ * C port of Swift's STTCapability.swift from:
+ * Sources/RunAnywhere/Features/STT/STTCapability.swift
+ *
+ * Actor-based STT capability that owns model lifecycle and transcription.
+ * Uses lifecycle manager for unified lifecycle + analytics handling.
+ */
+
+#ifndef RAC_STT_COMPONENT_H
+#define RAC_STT_COMPONENT_H
+
+#include <RACommons/rac_lifecycle.h>
+#include <RACommons/rac_error.h>
+#include <RACommons/rac_stt_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// NOTE: rac_stt_config_t is defined in rac_stt_types.h (included above)
+
+// =============================================================================
+// STT COMPONENT API - Mirrors Swift's STTCapability
+// =============================================================================
+
+/**
+ * @brief Create an STT capability component
+ *
+ * @param out_handle Output: Handle to the component
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_component_create(rac_handle_t* out_handle);
+
+/**
+ * @brief Configure the STT component
+ *
+ * @param handle Component handle
+ * @param config Configuration
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_component_configure(rac_handle_t handle,
+                                                 const rac_stt_config_t* config);
+
+/**
+ * @brief Check if model is loaded
+ *
+ * @param handle Component handle
+ * @return RAC_TRUE if loaded, RAC_FALSE otherwise
+ */
+RAC_API rac_bool_t rac_stt_component_is_loaded(rac_handle_t handle);
+
+/**
+ * @brief Get current model ID
+ *
+ * @param handle Component handle
+ * @return Current model ID (NULL if not loaded)
+ */
+RAC_API const char* rac_stt_component_get_model_id(rac_handle_t handle);
+
+/**
+ * @brief Load a model
+ *
+ * @param handle Component handle
+ * @param model_path File path to the model (used for loading) - REQUIRED
+ * @param model_id Model identifier for telemetry (e.g., "sherpa-onnx-whisper-tiny.en")
+ *                 Optional: if NULL, defaults to model_path
+ * @param model_name Human-readable model name (e.g., "Sherpa Whisper Tiny (ONNX)")
+ *                   Optional: if NULL, defaults to model_id
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_component_load_model(rac_handle_t handle, const char* model_path,
+                                                  const char* model_id, const char* model_name);
+
+/**
+ * @brief Unload the current model
+ *
+ * @param handle Component handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_component_unload(rac_handle_t handle);
+
+/**
+ * @brief Cleanup and reset the component
+ *
+ * @param handle Component handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_component_cleanup(rac_handle_t handle);
+
+/**
+ * @brief Transcribe audio data (batch mode)
+ *
+ * @param handle Component handle
+ * @param audio_data Audio data buffer
+ * @param audio_size Size of audio data in bytes
+ * @param options Transcription options (can be NULL for defaults)
+ * @param out_result Output: Transcription result
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_component_transcribe(rac_handle_t handle, const void* audio_data,
+                                                  size_t audio_size,
+                                                  const rac_stt_options_t* options,
+                                                  rac_stt_result_t* out_result);
+
+/**
+ * @brief Check if streaming is supported
+ *
+ * @param handle Component handle
+ * @return RAC_TRUE if streaming supported, RAC_FALSE otherwise
+ */
+RAC_API rac_bool_t rac_stt_component_supports_streaming(rac_handle_t handle);
+
+/**
+ * @brief Transcribe audio with streaming
+ *
+ * @param handle Component handle
+ * @param audio_data Audio chunk data
+ * @param audio_size Size of audio chunk
+ * @param options Transcription options
+ * @param callback Callback for partial results
+ * @param user_data User context passed to callback
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_component_transcribe_stream(rac_handle_t handle,
+                                                         const void* audio_data, size_t audio_size,
+                                                         const rac_stt_options_t* options,
+                                                         rac_stt_stream_callback_t callback,
+                                                         void* user_data);
+
+/**
+ * @brief Get lifecycle state
+ *
+ * @param handle Component handle
+ * @return Current lifecycle state
+ */
+RAC_API rac_lifecycle_state_t rac_stt_component_get_state(rac_handle_t handle);
+
+/**
+ * @brief Get lifecycle metrics
+ *
+ * @param handle Component handle
+ * @param out_metrics Output: Lifecycle metrics
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_component_get_metrics(rac_handle_t handle,
+                                                   rac_lifecycle_metrics_t* out_metrics);
+
+/**
+ * @brief Destroy the STT component
+ *
+ * @param handle Component handle
+ */
+RAC_API void rac_stt_component_destroy(rac_handle_t handle);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_STT_COMPONENT_H */

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_stt_events.h

@@ -0,0 +1,62 @@
+/**
+ * @file rac_stt_events.h
+ * @brief STT-specific event types - 1:1 port of STTEvent.swift
+ *
+ * Swift Source: Sources/RunAnywhere/Features/STT/Analytics/STTEvent.swift
+ */
+
+#ifndef RAC_STT_EVENTS_H
+#define RAC_STT_EVENTS_H
+
+#include <RACommons/rac_types.h>
+#include <RACommons/rac_events.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// STT EVENT TYPES
+// =============================================================================
+
+typedef enum rac_stt_event_type {
+    RAC_STT_EVENT_TRANSCRIPTION_STARTED = 0,
+    RAC_STT_EVENT_PARTIAL_TRANSCRIPT,
+    RAC_STT_EVENT_FINAL_TRANSCRIPT,
+    RAC_STT_EVENT_TRANSCRIPTION_COMPLETED,
+    RAC_STT_EVENT_TRANSCRIPTION_FAILED,
+    RAC_STT_EVENT_LANGUAGE_DETECTED,
+} rac_stt_event_type_t;
+
+// =============================================================================
+// EVENT PUBLISHING FUNCTIONS
+// =============================================================================
+
+RAC_API rac_result_t rac_stt_event_transcription_started(
+    const char* transcription_id, const char* model_id, double audio_length_ms,
+    int32_t audio_size_bytes, const char* language, rac_bool_t is_streaming,
+    rac_inference_framework_t framework);
+
+RAC_API rac_result_t rac_stt_event_partial_transcript(const char* text, int32_t word_count);
+
+RAC_API rac_result_t rac_stt_event_final_transcript(const char* text, float confidence);
+
+RAC_API rac_result_t rac_stt_event_transcription_completed(
+    const char* transcription_id, const char* model_id, const char* text, float confidence,
+    double duration_ms, double audio_length_ms, int32_t word_count, double real_time_factor,
+    const char* language, rac_bool_t is_streaming, rac_inference_framework_t framework);
+
+RAC_API rac_result_t rac_stt_event_transcription_failed(const char* transcription_id,
+                                                        const char* model_id,
+                                                        rac_result_t error_code,
+                                                        const char* error_message);
+
+RAC_API rac_result_t rac_stt_event_language_detected(const char* language, float confidence);
+
+RAC_API const char* rac_stt_event_type_string(rac_stt_event_type_t event_type);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_STT_EVENTS_H */

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_stt_onnx.h

@@ -0,0 +1,99 @@
+/**
+ * @file rac_stt_onnx.h
+ * @brief RunAnywhere Core - ONNX Backend RAC API for STT
+ *
+ * Direct RAC API export from runanywhere-core's ONNX STT backend.
+ * Mirrors Swift's ONNXSTTService implementation pattern.
+ */
+
+#ifndef RAC_STT_ONNX_H
+#define RAC_STT_ONNX_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_ONNX_BUILDING)
+#if defined(_WIN32)
+#define RAC_ONNX_API __declspec(dllexport)
+#elif defined(__GNUC__) || defined(__clang__)
+#define RAC_ONNX_API __attribute__((visibility("default")))
+#else
+#define RAC_ONNX_API
+#endif
+#else
+#define RAC_ONNX_API
+#endif
+
+// =============================================================================
+// CONFIGURATION
+// =============================================================================
+
+/**
+ * ONNX STT model types.
+ */
+typedef enum rac_stt_onnx_model_type {
+    RAC_STT_ONNX_MODEL_WHISPER = 0,
+    RAC_STT_ONNX_MODEL_ZIPFORMER = 1,
+    RAC_STT_ONNX_MODEL_PARAFORMER = 2,
+    RAC_STT_ONNX_MODEL_AUTO = 99
+} rac_stt_onnx_model_type_t;
+
+/**
+ * ONNX STT configuration.
+ */
+typedef struct rac_stt_onnx_config {
+    rac_stt_onnx_model_type_t model_type;
+    int32_t num_threads;
+    rac_bool_t use_coreml;
+} rac_stt_onnx_config_t;
+
+static const rac_stt_onnx_config_t RAC_STT_ONNX_CONFIG_DEFAULT = {
+    .model_type = RAC_STT_ONNX_MODEL_AUTO, .num_threads = 0, .use_coreml = RAC_TRUE};
+
+// =============================================================================
+// ONNX STT API
+// =============================================================================
+
+RAC_ONNX_API rac_result_t rac_stt_onnx_create(const char* model_path,
+                                              const rac_stt_onnx_config_t* config,
+                                              rac_handle_t* out_handle);
+
+RAC_ONNX_API rac_result_t rac_stt_onnx_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);
+
+RAC_ONNX_API rac_bool_t rac_stt_onnx_supports_streaming(rac_handle_t handle);
+
+RAC_ONNX_API rac_result_t rac_stt_onnx_create_stream(rac_handle_t handle, rac_handle_t* out_stream);
+
+RAC_ONNX_API rac_result_t rac_stt_onnx_feed_audio(rac_handle_t handle, rac_handle_t stream,
+                                                  const float* audio_samples, size_t num_samples);
+
+RAC_ONNX_API rac_bool_t rac_stt_onnx_stream_is_ready(rac_handle_t handle, rac_handle_t stream);
+
+RAC_ONNX_API rac_result_t rac_stt_onnx_decode_stream(rac_handle_t handle, rac_handle_t stream,
+                                                     char** out_text);
+
+RAC_ONNX_API void rac_stt_onnx_input_finished(rac_handle_t handle, rac_handle_t stream);
+
+RAC_ONNX_API rac_bool_t rac_stt_onnx_is_endpoint(rac_handle_t handle, rac_handle_t stream);
+
+RAC_ONNX_API void rac_stt_onnx_destroy_stream(rac_handle_t handle, rac_handle_t stream);
+
+RAC_ONNX_API void rac_stt_onnx_destroy(rac_handle_t handle);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_STT_ONNX_H */

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_stt_service.h

@@ -0,0 +1,154 @@
+/**
+ * @file rac_stt_service.h
+ * @brief RunAnywhere Commons - STT Service Interface
+ *
+ * Defines the generic STT service API and vtable for multi-backend dispatch.
+ * Backends (ONNX, Whisper, etc.) implement the vtable and register
+ * with the service registry.
+ */
+
+#ifndef RAC_STT_SERVICE_H
+#define RAC_STT_SERVICE_H
+
+#include <RACommons/rac_error.h>
+#include <RACommons/rac_stt_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// SERVICE VTABLE - Backend implementations provide this
+// =============================================================================
+
+/**
+ * STT Service operations vtable.
+ * Each backend implements these functions and provides a static vtable.
+ */
+typedef struct rac_stt_service_ops {
+    /** Initialize the service with a model path */
+    rac_result_t (*initialize)(void* impl, const char* model_path);
+
+    /** Transcribe audio (batch mode) */
+    rac_result_t (*transcribe)(void* impl, const void* audio_data, size_t audio_size,
+                               const rac_stt_options_t* options, rac_stt_result_t* out_result);
+
+    /** Stream transcription for real-time processing */
+    rac_result_t (*transcribe_stream)(void* impl, const void* audio_data, size_t audio_size,
+                                      const rac_stt_options_t* options,
+                                      rac_stt_stream_callback_t callback, void* user_data);
+
+    /** Get service info */
+    rac_result_t (*get_info)(void* impl, rac_stt_info_t* out_info);
+
+    /** Cleanup/unload model (keeps service alive) */
+    rac_result_t (*cleanup)(void* impl);
+
+    /** Destroy the service */
+    void (*destroy)(void* impl);
+} rac_stt_service_ops_t;
+
+/**
+ * STT Service instance.
+ * Contains vtable pointer and backend-specific implementation.
+ */
+typedef struct rac_stt_service {
+    /** Vtable with backend operations */
+    const rac_stt_service_ops_t* ops;
+
+    /** Backend-specific implementation handle */
+    void* impl;
+
+    /** Model ID for reference */
+    const char* model_id;
+} rac_stt_service_t;
+
+// =============================================================================
+// PUBLIC API - Generic service functions
+// =============================================================================
+
+/**
+ * @brief Create an STT service
+ *
+ * Routes through service registry to find appropriate backend.
+ *
+ * @param model_path Path to the model file (can be NULL for some providers)
+ * @param out_handle Output: Handle to the created service
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_create(const char* model_path, rac_handle_t* out_handle);
+
+/**
+ * @brief Initialize an STT service
+ *
+ * @param handle Service handle
+ * @param model_path Path to the model file (can be NULL)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_initialize(rac_handle_t handle, const char* model_path);
+
+/**
+ * @brief Transcribe audio data (batch mode)
+ *
+ * @param handle Service handle
+ * @param audio_data Audio data buffer
+ * @param audio_size Size of audio data in bytes
+ * @param options Transcription options (can be NULL for defaults)
+ * @param out_result Output: Transcription result (caller must free with rac_stt_result_free)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_transcribe(rac_handle_t handle, const void* audio_data,
+                                        size_t audio_size, const rac_stt_options_t* options,
+                                        rac_stt_result_t* out_result);
+
+/**
+ * @brief Stream transcription for real-time processing
+ *
+ * @param handle Service handle
+ * @param audio_data Audio chunk data
+ * @param audio_size Size of audio chunk
+ * @param options Transcription options
+ * @param callback Callback for partial results
+ * @param user_data User context passed to callback
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_transcribe_stream(rac_handle_t handle, const void* audio_data,
+                                               size_t audio_size, const rac_stt_options_t* options,
+                                               rac_stt_stream_callback_t callback, void* user_data);
+
+/**
+ * @brief Get service information
+ *
+ * @param handle Service handle
+ * @param out_info Output: Service information
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_get_info(rac_handle_t handle, rac_stt_info_t* out_info);
+
+/**
+ * @brief Cleanup and release resources
+ *
+ * @param handle Service handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_stt_cleanup(rac_handle_t handle);
+
+/**
+ * @brief Destroy an STT service instance
+ *
+ * @param handle Service handle to destroy
+ */
+RAC_API void rac_stt_destroy(rac_handle_t handle);
+
+/**
+ * @brief Free an STT result
+ *
+ * @param result Result to free
+ */
+RAC_API void rac_stt_result_free(rac_stt_result_t* result);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_STT_SERVICE_H */