@runanywhere/core 0.16.0

package/android/src/main/include/rac/backends/rac_stt_whispercpp.h

@@ -0,0 +1,153 @@
+/**
+ * @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 "rac/core/rac_error.h"
+#include "rac/core/rac_types.h"
+#include "rac/features/stt/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 */

package/android/src/main/include/rac/backends/rac_tts_onnx.h

@@ -0,0 +1,71 @@
+/**
+ * @file rac_tts_onnx.h
+ * @brief RunAnywhere Core - ONNX Backend RAC API for TTS
+ *
+ * Direct RAC API export from runanywhere-core's ONNX TTS backend.
+ */
+
+#ifndef RAC_TTS_ONNX_H
+#define RAC_TTS_ONNX_H
+
+#include "rac/core/rac_error.h"
+#include "rac/core/rac_types.h"
+#include "rac/features/tts/rac_tts.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
+// =============================================================================
+
+typedef struct rac_tts_onnx_config {
+    int32_t num_threads;
+    rac_bool_t use_coreml;
+    int32_t sample_rate;
+} rac_tts_onnx_config_t;
+
+static const rac_tts_onnx_config_t RAC_TTS_ONNX_CONFIG_DEFAULT = {
+    .num_threads = 0, .use_coreml = RAC_TRUE, .sample_rate = 22050};
+
+// =============================================================================
+// ONNX TTS API
+// =============================================================================
+
+RAC_ONNX_API rac_result_t rac_tts_onnx_create(const char* model_path,
+                                              const rac_tts_onnx_config_t* config,
+                                              rac_handle_t* out_handle);
+
+RAC_ONNX_API rac_result_t rac_tts_onnx_synthesize(rac_handle_t handle, const char* text,
+                                                  const rac_tts_options_t* options,
+                                                  rac_tts_result_t* out_result);
+
+RAC_ONNX_API rac_result_t rac_tts_onnx_get_voices(rac_handle_t handle, char*** out_voices,
+                                                  size_t* out_count);
+
+RAC_ONNX_API void rac_tts_onnx_stop(rac_handle_t handle);
+
+RAC_ONNX_API void rac_tts_onnx_destroy(rac_handle_t handle);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_TTS_ONNX_H */

package/android/src/main/include/rac/backends/rac_vad_onnx.h

@@ -0,0 +1,84 @@
+/**
+ * @file rac_vad_onnx.h
+ * @brief RunAnywhere Core - ONNX Backend RAC API for VAD
+ *
+ * Direct RAC API export from runanywhere-core's ONNX VAD backend.
+ */
+
+#ifndef RAC_VAD_ONNX_H
+#define RAC_VAD_ONNX_H
+
+#include "rac/core/rac_error.h"
+#include "rac/core/rac_types.h"
+#include "rac/features/vad/rac_vad.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
+// =============================================================================
+
+typedef struct rac_vad_onnx_config {
+    int32_t sample_rate;
+    float energy_threshold;
+    float frame_length;
+    int32_t num_threads;
+} rac_vad_onnx_config_t;
+
+static const rac_vad_onnx_config_t RAC_VAD_ONNX_CONFIG_DEFAULT = {
+    .sample_rate = 16000, .energy_threshold = 0.5f, .frame_length = 0.032f, .num_threads = 0};
+
+// =============================================================================
+// ONNX VAD API
+// =============================================================================
+
+RAC_ONNX_API rac_result_t rac_vad_onnx_create(const char* model_path,
+                                              const rac_vad_onnx_config_t* config,
+                                              rac_handle_t* out_handle);
+
+RAC_ONNX_API rac_result_t rac_vad_onnx_process(rac_handle_t handle, const float* samples,
+                                               size_t num_samples, rac_bool_t* out_is_speech);
+
+RAC_ONNX_API rac_result_t rac_vad_onnx_start(rac_handle_t handle);
+
+RAC_ONNX_API rac_result_t rac_vad_onnx_stop(rac_handle_t handle);
+
+RAC_ONNX_API rac_result_t rac_vad_onnx_reset(rac_handle_t handle);
+
+RAC_ONNX_API rac_result_t rac_vad_onnx_set_threshold(rac_handle_t handle, float threshold);
+
+RAC_ONNX_API rac_bool_t rac_vad_onnx_is_speech_active(rac_handle_t handle);
+
+RAC_ONNX_API void rac_vad_onnx_destroy(rac_handle_t handle);
+
+// =============================================================================
+// BACKEND REGISTRATION
+// =============================================================================
+
+RAC_ONNX_API rac_result_t rac_backend_onnx_register(void);
+
+RAC_ONNX_API rac_result_t rac_backend_onnx_unregister(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_VAD_ONNX_H */

package/android/src/main/include/rac/core/capabilities/rac_lifecycle.h

@@ -0,0 +1,290 @@
+/**
+ * @file rac_lifecycle.h
+ * @brief RunAnywhere Commons - Lifecycle Management API
+ *
+ * C port of Swift's ManagedLifecycle.swift from:
+ * Sources/RunAnywhere/Core/Capabilities/ManagedLifecycle.swift
+ *
+ * Provides unified lifecycle management with integrated event tracking.
+ * Tracks lifecycle events (load, unload) via EventPublisher.
+ */
+
+#ifndef RAC_LIFECYCLE_H
+#define RAC_LIFECYCLE_H
+
+#include "rac/core/rac_error.h"
+#include "rac/core/rac_types.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// TYPES - Mirrors Swift's CapabilityLoadingState
+// =============================================================================
+
+/**
+ * @brief Capability loading state
+ *
+ * Mirrors Swift's CapabilityLoadingState enum.
+ */
+typedef enum rac_lifecycle_state {
+    RAC_LIFECYCLE_STATE_IDLE = 0,    /**< Not loaded */
+    RAC_LIFECYCLE_STATE_LOADING = 1, /**< Currently loading */
+    RAC_LIFECYCLE_STATE_LOADED = 2,  /**< Successfully loaded */
+    RAC_LIFECYCLE_STATE_FAILED = 3   /**< Load failed */
+} rac_lifecycle_state_t;
+
+/**
+ * @brief Resource type for lifecycle tracking
+ *
+ * Mirrors Swift's CapabilityResourceType enum.
+ */
+typedef enum rac_resource_type {
+    RAC_RESOURCE_TYPE_LLM_MODEL = 0,
+    RAC_RESOURCE_TYPE_STT_MODEL = 1,
+    RAC_RESOURCE_TYPE_TTS_VOICE = 2,
+    RAC_RESOURCE_TYPE_VAD_MODEL = 3,
+    RAC_RESOURCE_TYPE_DIARIZATION_MODEL = 4
+} rac_resource_type_t;
+
+/**
+ * @brief Lifecycle metrics
+ *
+ * Mirrors Swift's ModelLifecycleMetrics struct.
+ */
+typedef struct rac_lifecycle_metrics {
+    /** Total lifecycle events */
+    int32_t total_events;
+
+    /** Start time (ms since epoch) */
+    int64_t start_time_ms;
+
+    /** Last event time (ms since epoch, 0 if none) */
+    int64_t last_event_time_ms;
+
+    /** Total load attempts */
+    int32_t total_loads;
+
+    /** Successful loads */
+    int32_t successful_loads;
+
+    /** Failed loads */
+    int32_t failed_loads;
+
+    /** Average load time in milliseconds */
+    double average_load_time_ms;
+
+    /** Total unloads */
+    int32_t total_unloads;
+} rac_lifecycle_metrics_t;
+
+/**
+ * @brief Lifecycle configuration
+ */
+typedef struct rac_lifecycle_config {
+    /** Resource type for event tracking */
+    rac_resource_type_t resource_type;
+
+    /** Logger category (can be NULL for default) */
+    const char* logger_category;
+
+    /** User data for callbacks */
+    void* user_data;
+} rac_lifecycle_config_t;
+
+/**
+ * @brief Service creation callback
+ *
+ * Called by the lifecycle manager to create a service for a given model ID.
+ *
+ * @param model_id The model ID to load
+ * @param user_data User-provided context
+ * @param out_service Output: Handle to the created service
+ * @return RAC_SUCCESS or error code
+ */
+typedef rac_result_t (*rac_lifecycle_create_service_fn)(const char* model_id, void* user_data,
+                                                        rac_handle_t* out_service);
+
+/**
+ * @brief Service destroy callback
+ *
+ * Called by the lifecycle manager to destroy a service.
+ *
+ * @param service Handle to the service to destroy
+ * @param user_data User-provided context
+ */
+typedef void (*rac_lifecycle_destroy_service_fn)(rac_handle_t service, void* user_data);
+
+// =============================================================================
+// LIFECYCLE API - Mirrors Swift's ManagedLifecycle
+// =============================================================================
+
+/**
+ * @brief Create a lifecycle manager
+ *
+ * @param config Lifecycle configuration
+ * @param create_fn Service creation callback
+ * @param destroy_fn Service destruction callback (can be NULL)
+ * @param out_handle Output: Handle to the lifecycle manager
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_create(const rac_lifecycle_config_t* config,
+                                          rac_lifecycle_create_service_fn create_fn,
+                                          rac_lifecycle_destroy_service_fn destroy_fn,
+                                          rac_handle_t* out_handle);
+
+/**
+ * @brief Load a model with automatic event tracking
+ *
+ * Mirrors Swift's ManagedLifecycle.load(_:)
+ * If already loaded with same ID, skips duplicate load.
+ *
+ * @param handle Lifecycle manager 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
+ * @param out_service Output: Handle to the loaded service
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_load(rac_handle_t handle, const char* model_path,
+                                        const char* model_id, const char* model_name,
+                                        rac_handle_t* out_service);
+
+/**
+ * @brief Unload the currently loaded model
+ *
+ * Mirrors Swift's ManagedLifecycle.unload()
+ *
+ * @param handle Lifecycle manager handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_unload(rac_handle_t handle);
+
+/**
+ * @brief Reset all state
+ *
+ * Mirrors Swift's ManagedLifecycle.reset()
+ *
+ * @param handle Lifecycle manager handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_reset(rac_handle_t handle);
+
+/**
+ * @brief Get current lifecycle state
+ *
+ * Mirrors Swift's ManagedLifecycle.state
+ *
+ * @param handle Lifecycle manager handle
+ * @return Current state
+ */
+RAC_API rac_lifecycle_state_t rac_lifecycle_get_state(rac_handle_t handle);
+
+/**
+ * @brief Check if a model is loaded
+ *
+ * Mirrors Swift's ManagedLifecycle.isLoaded
+ *
+ * @param handle Lifecycle manager handle
+ * @return RAC_TRUE if loaded, RAC_FALSE otherwise
+ */
+RAC_API rac_bool_t rac_lifecycle_is_loaded(rac_handle_t handle);
+
+/**
+ * @brief Get current model ID
+ *
+ * Mirrors Swift's ManagedLifecycle.currentModelId
+ *
+ * @param handle Lifecycle manager handle
+ * @return Current model ID (may be NULL if not loaded)
+ */
+RAC_API const char* rac_lifecycle_get_model_id(rac_handle_t handle);
+
+/**
+ * @brief Get current model name (human-readable)
+ *
+ * @param handle Lifecycle manager handle
+ * @return Current model name (may be NULL if not loaded)
+ */
+RAC_API const char* rac_lifecycle_get_model_name(rac_handle_t handle);
+
+/**
+ * @brief Get current service handle
+ *
+ * Mirrors Swift's ManagedLifecycle.currentService
+ *
+ * @param handle Lifecycle manager handle
+ * @return Current service handle (may be NULL if not loaded)
+ */
+RAC_API rac_handle_t rac_lifecycle_get_service(rac_handle_t handle);
+
+/**
+ * @brief Require service or return error
+ *
+ * Mirrors Swift's ManagedLifecycle.requireService()
+ *
+ * @param handle Lifecycle manager handle
+ * @param out_service Output: Service handle
+ * @return RAC_SUCCESS or RAC_ERROR_NOT_INITIALIZED if not loaded
+ */
+RAC_API rac_result_t rac_lifecycle_require_service(rac_handle_t handle, rac_handle_t* out_service);
+
+/**
+ * @brief Track an operation error
+ *
+ * Mirrors Swift's ManagedLifecycle.trackOperationError(_:operation:)
+ *
+ * @param handle Lifecycle manager handle
+ * @param error_code Error code
+ * @param operation Operation name
+ */
+RAC_API void rac_lifecycle_track_error(rac_handle_t handle, rac_result_t error_code,
+                                       const char* operation);
+
+/**
+ * @brief Get lifecycle metrics
+ *
+ * Mirrors Swift's ManagedLifecycle.getLifecycleMetrics()
+ *
+ * @param handle Lifecycle manager handle
+ * @param out_metrics Output: Lifecycle metrics
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_lifecycle_get_metrics(rac_handle_t handle,
+                                               rac_lifecycle_metrics_t* out_metrics);
+
+/**
+ * @brief Destroy a lifecycle manager
+ *
+ * @param handle Lifecycle manager handle
+ */
+RAC_API void rac_lifecycle_destroy(rac_handle_t handle);
+
+// =============================================================================
+// CONVENIENCE STATE HELPERS
+// =============================================================================
+
+/**
+ * @brief Get state name string
+ *
+ * @param state Lifecycle state
+ * @return Human-readable state name
+ */
+RAC_API const char* rac_lifecycle_state_name(rac_lifecycle_state_t state);
+
+/**
+ * @brief Get resource type name string
+ *
+ * @param type Resource type
+ * @return Human-readable resource type name
+ */
+RAC_API const char* rac_resource_type_name(rac_resource_type_t type);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_LIFECYCLE_H */