@runanywhere/core 0.16.0

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

@@ -0,0 +1,158 @@
+/**
+ * @file rac_tts_component.h
+ * @brief RunAnywhere Commons - TTS Capability Component
+ *
+ * C port of Swift's TTSCapability.swift from:
+ * Sources/RunAnywhere/Features/TTS/TTSCapability.swift
+ *
+ * Actor-based TTS capability that owns voice lifecycle and synthesis.
+ * Uses lifecycle manager for unified lifecycle + analytics handling.
+ */
+
+#ifndef RAC_TTS_COMPONENT_H
+#define RAC_TTS_COMPONENT_H
+
+#include <RACommons/rac_lifecycle.h>
+#include <RACommons/rac_error.h>
+#include <RACommons/rac_tts_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// NOTE: rac_tts_config_t is defined in rac_tts_types.h (included above)
+
+// =============================================================================
+// TTS COMPONENT API - Mirrors Swift's TTSCapability
+// =============================================================================
+
+/**
+ * @brief Create a TTS capability component
+ *
+ * @param out_handle Output: Handle to the component
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_component_create(rac_handle_t* out_handle);
+
+/**
+ * @brief Configure the TTS component
+ *
+ * @param handle Component handle
+ * @param config Configuration
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_component_configure(rac_handle_t handle,
+                                                 const rac_tts_config_t* config);
+
+/**
+ * @brief Check if voice is loaded
+ *
+ * @param handle Component handle
+ * @return RAC_TRUE if loaded, RAC_FALSE otherwise
+ */
+RAC_API rac_bool_t rac_tts_component_is_loaded(rac_handle_t handle);
+
+/**
+ * @brief Get current voice ID
+ *
+ * @param handle Component handle
+ * @return Current voice ID (NULL if not loaded)
+ */
+RAC_API const char* rac_tts_component_get_voice_id(rac_handle_t handle);
+
+/**
+ * @brief Load a voice
+ *
+ * @param handle Component handle
+ * @param voice_path File path to the voice (used for loading) - REQUIRED
+ * @param voice_id Voice identifier for telemetry (e.g., "vits-piper-en_GB-alba-medium")
+ *                 Optional: if NULL, defaults to voice_path
+ * @param voice_name Human-readable voice name (e.g., "Piper TTS (British English)")
+ *                   Optional: if NULL, defaults to voice_id
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_component_load_voice(rac_handle_t handle, const char* voice_path,
+                                                  const char* voice_id, const char* voice_name);
+
+/**
+ * @brief Unload the current voice
+ *
+ * @param handle Component handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_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_tts_component_cleanup(rac_handle_t handle);
+
+/**
+ * @brief Stop current synthesis
+ *
+ * @param handle Component handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_component_stop(rac_handle_t handle);
+
+/**
+ * @brief Synthesize text to audio
+ *
+ * @param handle Component handle
+ * @param text Text to synthesize
+ * @param options Synthesis options (can be NULL for defaults)
+ * @param out_result Output: Synthesis result
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_component_synthesize(rac_handle_t handle, const char* text,
+                                                  const rac_tts_options_t* options,
+                                                  rac_tts_result_t* out_result);
+
+/**
+ * @brief Synthesize text with streaming
+ *
+ * @param handle Component handle
+ * @param text Text to synthesize
+ * @param options Synthesis options
+ * @param callback Callback for audio chunks
+ * @param user_data User context passed to callback
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_component_synthesize_stream(rac_handle_t handle, const char* text,
+                                                         const rac_tts_options_t* options,
+                                                         rac_tts_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_tts_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_tts_component_get_metrics(rac_handle_t handle,
+                                                   rac_lifecycle_metrics_t* out_metrics);
+
+/**
+ * @brief Destroy the TTS component
+ *
+ * @param handle Component handle
+ */
+RAC_API void rac_tts_component_destroy(rac_handle_t handle);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_TTS_COMPONENT_H */

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

@@ -0,0 +1,54 @@
+/**
+ * @file rac_tts_events.h
+ * @brief TTS-specific event types - 1:1 port of TTSEvent.swift
+ *
+ * Swift Source: Sources/RunAnywhere/Features/TTS/Analytics/TTSEvent.swift
+ */
+
+#ifndef RAC_TTS_EVENTS_H
+#define RAC_TTS_EVENTS_H
+
+#include <RACommons/rac_types.h>
+#include <RACommons/rac_events.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// TTS EVENT TYPES
+// =============================================================================
+
+typedef enum rac_tts_event_type {
+    RAC_TTS_EVENT_SYNTHESIS_STARTED = 0,
+    RAC_TTS_EVENT_SYNTHESIS_CHUNK,
+    RAC_TTS_EVENT_SYNTHESIS_COMPLETED,
+    RAC_TTS_EVENT_SYNTHESIS_FAILED,
+} rac_tts_event_type_t;
+
+// =============================================================================
+// EVENT PUBLISHING FUNCTIONS
+// =============================================================================
+
+RAC_API rac_result_t rac_tts_event_synthesis_started(const char* synthesis_id, const char* model_id,
+                                                     int32_t character_count, int32_t sample_rate,
+                                                     rac_inference_framework_t framework);
+
+RAC_API rac_result_t rac_tts_event_synthesis_chunk(const char* synthesis_id, int32_t chunk_size);
+
+RAC_API rac_result_t rac_tts_event_synthesis_completed(
+    const char* synthesis_id, const char* model_id, int32_t character_count,
+    double audio_duration_ms, int32_t audio_size_bytes, double processing_duration_ms,
+    double characters_per_second, int32_t sample_rate, rac_inference_framework_t framework);
+
+RAC_API rac_result_t rac_tts_event_synthesis_failed(const char* synthesis_id, const char* model_id,
+                                                    rac_result_t error_code,
+                                                    const char* error_message);
+
+RAC_API const char* rac_tts_event_type_string(rac_tts_event_type_t event_type);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_TTS_EVENTS_H */

package/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/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 <RACommons/rac_error.h>
+#include <RACommons/rac_types.h>
+#include <RACommons/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/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers/rac_tts_platform.h

@@ -0,0 +1,197 @@
+/**
+ * @file rac_tts_platform.h
+ * @brief RunAnywhere Commons - Platform TTS Backend (System TTS)
+ *
+ * C API for platform-native TTS services. On Apple platforms, this uses
+ * AVSpeechSynthesizer. The actual implementation is in Swift, with C++
+ * providing the registration and callback infrastructure.
+ *
+ * This backend follows the same pattern as ONNX TTS backend, but delegates
+ * to Swift via function pointer callbacks since AVSpeechSynthesizer is
+ * an Apple-only framework.
+ */
+
+#ifndef RAC_TTS_PLATFORM_H
+#define RAC_TTS_PLATFORM_H
+
+#include <RACommons/rac_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+/** Opaque handle to platform TTS service */
+typedef struct rac_tts_platform* rac_tts_platform_handle_t;
+
+/**
+ * Platform TTS configuration.
+ */
+typedef struct rac_tts_platform_config {
+    /** Voice identifier (can be NULL for default) */
+    const char* voice_id;
+    /** Language code (e.g., "en-US") */
+    const char* language;
+    /** Reserved for future use */
+    void* reserved;
+} rac_tts_platform_config_t;
+
+/**
+ * Synthesis options for platform TTS.
+ */
+typedef struct rac_tts_platform_options {
+    /** Speech rate (0.5 = half speed, 1.0 = normal, 2.0 = double) */
+    float rate;
+    /** Pitch multiplier (0.5 = low, 1.0 = normal, 2.0 = high) */
+    float pitch;
+    /** Volume (0.0 = silent, 1.0 = full) */
+    float volume;
+    /** Voice identifier override (can be NULL) */
+    const char* voice_id;
+    /** Reserved for future options */
+    void* reserved;
+} rac_tts_platform_options_t;
+
+// =============================================================================
+// SWIFT CALLBACK TYPES
+// =============================================================================
+
+/**
+ * Callback to check if platform TTS can handle a voice ID.
+ * Implemented in Swift.
+ *
+ * @param voice_id Voice identifier to check (can be NULL)
+ * @param user_data User-provided context
+ * @return RAC_TRUE if this backend can handle the voice
+ */
+typedef rac_bool_t (*rac_platform_tts_can_handle_fn)(const char* voice_id, void* user_data);
+
+/**
+ * Callback to create platform TTS service.
+ * Implemented in Swift.
+ *
+ * @param config Configuration options
+ * @param user_data User-provided context
+ * @return Handle to created service (Swift object pointer), or NULL on failure
+ */
+typedef rac_handle_t (*rac_platform_tts_create_fn)(const rac_tts_platform_config_t* config,
+                                                   void* user_data);
+
+/**
+ * Callback to synthesize speech.
+ * Implemented in Swift.
+ *
+ * @param handle Service handle from create
+ * @param text Text to synthesize
+ * @param options Synthesis options
+ * @param user_data User-provided context
+ * @return RAC_SUCCESS or error code
+ */
+typedef rac_result_t (*rac_platform_tts_synthesize_fn)(rac_handle_t handle, const char* text,
+                                                       const rac_tts_platform_options_t* options,
+                                                       void* user_data);
+
+/**
+ * Callback to stop speech.
+ * Implemented in Swift.
+ *
+ * @param handle Service handle
+ * @param user_data User-provided context
+ */
+typedef void (*rac_platform_tts_stop_fn)(rac_handle_t handle, void* user_data);
+
+/**
+ * Callback to destroy platform TTS service.
+ * Implemented in Swift.
+ *
+ * @param handle Service handle to destroy
+ * @param user_data User-provided context
+ */
+typedef void (*rac_platform_tts_destroy_fn)(rac_handle_t handle, void* user_data);
+
+/**
+ * Swift callbacks for platform TTS operations.
+ */
+typedef struct rac_platform_tts_callbacks {
+    rac_platform_tts_can_handle_fn can_handle;
+    rac_platform_tts_create_fn create;
+    rac_platform_tts_synthesize_fn synthesize;
+    rac_platform_tts_stop_fn stop;
+    rac_platform_tts_destroy_fn destroy;
+    void* user_data;
+} rac_platform_tts_callbacks_t;
+
+// =============================================================================
+// CALLBACK REGISTRATION
+// =============================================================================
+
+/**
+ * Sets the Swift callbacks for platform TTS operations.
+ * Must be called before using platform TTS services.
+ *
+ * @param callbacks Callback functions (copied internally)
+ * @return RAC_SUCCESS on success
+ */
+RAC_API rac_result_t rac_platform_tts_set_callbacks(const rac_platform_tts_callbacks_t* callbacks);
+
+/**
+ * Gets the current Swift callbacks.
+ *
+ * @return Pointer to callbacks, or NULL if not set
+ */
+RAC_API const rac_platform_tts_callbacks_t* rac_platform_tts_get_callbacks(void);
+
+/**
+ * Checks if Swift callbacks are registered.
+ *
+ * @return RAC_TRUE if callbacks are available
+ */
+RAC_API rac_bool_t rac_platform_tts_is_available(void);
+
+// =============================================================================
+// SERVICE API
+// =============================================================================
+
+/**
+ * Creates a platform TTS service.
+ *
+ * @param config Configuration options (can be NULL for defaults)
+ * @param out_handle Output: Service handle
+ * @return RAC_SUCCESS on success, or error code
+ */
+RAC_API rac_result_t rac_tts_platform_create(const rac_tts_platform_config_t* config,
+                                             rac_tts_platform_handle_t* out_handle);
+
+/**
+ * Destroys a platform TTS service.
+ *
+ * @param handle Service handle to destroy
+ */
+RAC_API void rac_tts_platform_destroy(rac_tts_platform_handle_t handle);
+
+/**
+ * Synthesizes speech using platform TTS.
+ *
+ * @param handle Service handle
+ * @param text Text to synthesize
+ * @param options Synthesis options (can be NULL for defaults)
+ * @return RAC_SUCCESS on success, or error code
+ */
+RAC_API rac_result_t rac_tts_platform_synthesize(rac_tts_platform_handle_t handle, const char* text,
+                                                 const rac_tts_platform_options_t* options);
+
+/**
+ * Stops current speech synthesis.
+ *
+ * @param handle Service handle
+ */
+RAC_API void rac_tts_platform_stop(rac_tts_platform_handle_t handle);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_TTS_PLATFORM_H */

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

@@ -0,0 +1,162 @@
+/**
+ * @file rac_tts_service.h
+ * @brief RunAnywhere Commons - TTS Service Interface
+ *
+ * Defines the generic TTS service API and vtable for multi-backend dispatch.
+ * Backends (ONNX, Platform/System TTS, etc.) implement the vtable and register
+ * with the service registry.
+ */
+
+#ifndef RAC_TTS_SERVICE_H
+#define RAC_TTS_SERVICE_H
+
+#include <RACommons/rac_error.h>
+#include <RACommons/rac_tts_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// SERVICE VTABLE - Backend implementations provide this
+// =============================================================================
+
+/**
+ * TTS Service operations vtable.
+ * Each backend implements these functions and provides a static vtable.
+ */
+typedef struct rac_tts_service_ops {
+    /** Initialize the service */
+    rac_result_t (*initialize)(void* impl);
+
+    /** Synthesize text to audio (blocking) */
+    rac_result_t (*synthesize)(void* impl, const char* text, const rac_tts_options_t* options,
+                               rac_tts_result_t* out_result);
+
+    /** Stream synthesis for long text */
+    rac_result_t (*synthesize_stream)(void* impl, const char* text,
+                                      const rac_tts_options_t* options,
+                                      rac_tts_stream_callback_t callback, void* user_data);
+
+    /** Stop current synthesis */
+    rac_result_t (*stop)(void* impl);
+
+    /** Get service info */
+    rac_result_t (*get_info)(void* impl, rac_tts_info_t* out_info);
+
+    /** Cleanup/release resources (keeps service alive) */
+    rac_result_t (*cleanup)(void* impl);
+
+    /** Destroy the service */
+    void (*destroy)(void* impl);
+} rac_tts_service_ops_t;
+
+/**
+ * TTS Service instance.
+ * Contains vtable pointer and backend-specific implementation.
+ */
+typedef struct rac_tts_service {
+    /** Vtable with backend operations */
+    const rac_tts_service_ops_t* ops;
+
+    /** Backend-specific implementation handle */
+    void* impl;
+
+    /** Model/voice ID for reference */
+    const char* model_id;
+} rac_tts_service_t;
+
+// =============================================================================
+// PUBLIC API - Generic service functions
+// =============================================================================
+
+/**
+ * @brief Create a TTS service
+ *
+ * Routes through service registry to find appropriate backend.
+ *
+ * @param voice_id Voice/model identifier (registry ID or path)
+ * @param out_handle Output: Handle to the created service
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_create(const char* voice_id, rac_handle_t* out_handle);
+
+/**
+ * @brief Initialize a TTS service
+ *
+ * @param handle Service handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_initialize(rac_handle_t handle);
+
+/**
+ * @brief Synthesize text to audio
+ *
+ * @param handle Service handle
+ * @param text Text to synthesize
+ * @param options Synthesis options (can be NULL for defaults)
+ * @param out_result Output: Synthesis result (caller must free with rac_tts_result_free)
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_synthesize(rac_handle_t handle, const char* text,
+                                        const rac_tts_options_t* options,
+                                        rac_tts_result_t* out_result);
+
+/**
+ * @brief Stream synthesis for long text
+ *
+ * @param handle Service handle
+ * @param text Text to synthesize
+ * @param options Synthesis options
+ * @param callback Callback for each audio chunk
+ * @param user_data User context passed to callback
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_synthesize_stream(rac_handle_t handle, const char* text,
+                                               const rac_tts_options_t* options,
+                                               rac_tts_stream_callback_t callback, void* user_data);
+
+/**
+ * @brief Stop current synthesis
+ *
+ * @param handle Service handle
+ * @return RAC_SUCCESS or error code
+ */
+RAC_API rac_result_t rac_tts_stop(rac_handle_t handle);
+
+/**
+ * @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_tts_get_info(rac_handle_t handle, rac_tts_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_tts_cleanup(rac_handle_t handle);
+
+/**
+ * @brief Destroy a TTS service instance
+ *
+ * @param handle Service handle to destroy
+ */
+RAC_API void rac_tts_destroy(rac_handle_t handle);
+
+/**
+ * @brief Free a TTS result
+ *
+ * @param result Result to free
+ */
+RAC_API void rac_tts_result_free(rac_tts_result_t* result);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_TTS_SERVICE_H */