@runanywhere/core 0.16.0

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

@@ -0,0 +1,374 @@
+/**
+ * @file rac_tts_types.h
+ * @brief RunAnywhere Commons - TTS Types and Data Structures
+ *
+ * C port of Swift's TTS Models from:
+ * Sources/RunAnywhere/Features/TTS/Models/TTSConfiguration.swift
+ * Sources/RunAnywhere/Features/TTS/Models/TTSOptions.swift
+ * Sources/RunAnywhere/Features/TTS/Models/TTSInput.swift
+ * Sources/RunAnywhere/Features/TTS/Models/TTSOutput.swift
+ *
+ * This header defines data structures only. For the service interface,
+ * see rac_tts_service.h.
+ */
+
+#ifndef RAC_TTS_TYPES_H
+#define RAC_TTS_TYPES_H
+
+#include <RACommons/rac_types.h>
+#include <RACommons/rac_stt_types.h>  // For rac_audio_format_enum_t
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// CONSTANTS - Single Source of Truth for TTS
+// Swift references these via CRACommons import
+// =============================================================================
+
+// Audio Format Constants
+#define RAC_TTS_DEFAULT_SAMPLE_RATE 22050
+#define RAC_TTS_HIGH_QUALITY_SAMPLE_RATE 24000
+#define RAC_TTS_CD_QUALITY_SAMPLE_RATE 44100
+#define RAC_TTS_MAX_SAMPLE_RATE 48000
+#define RAC_TTS_BYTES_PER_SAMPLE 2
+#define RAC_TTS_CHANNELS 1
+
+// Speaking Rate Constants
+#define RAC_TTS_DEFAULT_SPEAKING_RATE 1.0f
+#define RAC_TTS_MIN_SPEAKING_RATE 0.5f
+#define RAC_TTS_MAX_SPEAKING_RATE 2.0f
+
+// Streaming Constants
+#define RAC_TTS_DEFAULT_STREAMING_CHUNK_BYTES 4096
+
+// =============================================================================
+// CONFIGURATION - Mirrors Swift's TTSConfiguration
+// =============================================================================
+
+/**
+ * @brief TTS component configuration
+ *
+ * Mirrors Swift's TTSConfiguration struct exactly.
+ * See: Sources/RunAnywhere/Features/TTS/Models/TTSConfiguration.swift
+ */
+typedef struct rac_tts_config {
+    /** Model ID (voice identifier for TTS, optional) */
+    const char* model_id;
+
+    /** Preferred framework (use -1 for auto) */
+    int32_t preferred_framework;
+
+    /** Voice identifier to use for synthesis */
+    const char* voice;
+
+    /** Language for synthesis (BCP-47 format, e.g., "en-US") */
+    const char* language;
+
+    /** Speaking rate (0.5 to 2.0, 1.0 is normal) */
+    float speaking_rate;
+
+    /** Speech pitch (0.5 to 2.0, 1.0 is normal) */
+    float pitch;
+
+    /** Speech volume (0.0 to 1.0) */
+    float volume;
+
+    /** Audio format for output */
+    rac_audio_format_enum_t audio_format;
+
+    /** Whether to use neural/premium voice if available */
+    rac_bool_t use_neural_voice;
+
+    /** Whether to enable SSML markup support */
+    rac_bool_t enable_ssml;
+} rac_tts_config_t;
+
+/**
+ * @brief Default TTS configuration
+ */
+static const rac_tts_config_t RAC_TTS_CONFIG_DEFAULT = {.model_id = RAC_NULL,
+                                                        .preferred_framework = -1,
+                                                        .voice = RAC_NULL,
+                                                        .language = "en-US",
+                                                        .speaking_rate = 1.0f,
+                                                        .pitch = 1.0f,
+                                                        .volume = 1.0f,
+                                                        .audio_format = RAC_AUDIO_FORMAT_PCM,
+                                                        .use_neural_voice = RAC_TRUE,
+                                                        .enable_ssml = RAC_FALSE};
+
+// =============================================================================
+// OPTIONS - Mirrors Swift's TTSOptions
+// =============================================================================
+
+/**
+ * @brief TTS synthesis options
+ *
+ * Mirrors Swift's TTSOptions struct exactly.
+ * See: Sources/RunAnywhere/Features/TTS/Models/TTSOptions.swift
+ */
+typedef struct rac_tts_options {
+    /** Voice to use for synthesis (can be NULL for default) */
+    const char* voice;
+
+    /** Language for synthesis (BCP-47 format, e.g., "en-US") */
+    const char* language;
+
+    /** Speech rate (0.0 to 2.0, 1.0 is normal) */
+    float rate;
+
+    /** Speech pitch (0.0 to 2.0, 1.0 is normal) */
+    float pitch;
+
+    /** Speech volume (0.0 to 1.0) */
+    float volume;
+
+    /** Audio format for output */
+    rac_audio_format_enum_t audio_format;
+
+    /** Sample rate for output audio in Hz */
+    int32_t sample_rate;
+
+    /** Whether to use SSML markup */
+    rac_bool_t use_ssml;
+} rac_tts_options_t;
+
+/**
+ * @brief Default TTS options
+ */
+static const rac_tts_options_t RAC_TTS_OPTIONS_DEFAULT = {.voice = RAC_NULL,
+                                                          .language = "en-US",
+                                                          .rate = 1.0f,
+                                                          .pitch = 1.0f,
+                                                          .volume = 1.0f,
+                                                          .audio_format = RAC_AUDIO_FORMAT_PCM,
+                                                          .sample_rate =
+                                                              RAC_TTS_DEFAULT_SAMPLE_RATE,
+                                                          .use_ssml = RAC_FALSE};
+
+// =============================================================================
+// INPUT - Mirrors Swift's TTSInput
+// =============================================================================
+
+/**
+ * @brief TTS input data
+ *
+ * Mirrors Swift's TTSInput struct exactly.
+ * See: Sources/RunAnywhere/Features/TTS/Models/TTSInput.swift
+ */
+typedef struct rac_tts_input {
+    /** Text to synthesize */
+    const char* text;
+
+    /** Optional SSML markup (overrides text if provided, can be NULL) */
+    const char* ssml;
+
+    /** Voice ID override (can be NULL) */
+    const char* voice_id;
+
+    /** Language override (can be NULL) */
+    const char* language;
+
+    /** Custom options override (can be NULL) */
+    const rac_tts_options_t* options;
+} rac_tts_input_t;
+
+/**
+ * @brief Default TTS input
+ */
+static const rac_tts_input_t RAC_TTS_INPUT_DEFAULT = {.text = RAC_NULL,
+                                                      .ssml = RAC_NULL,
+                                                      .voice_id = RAC_NULL,
+                                                      .language = RAC_NULL,
+                                                      .options = RAC_NULL};
+
+// =============================================================================
+// RESULT - Mirrors Swift's TTS result
+// =============================================================================
+
+/**
+ * @brief TTS synthesis result
+ */
+typedef struct rac_tts_result {
+    /** Audio data (owned, must be freed with rac_free) */
+    void* audio_data;
+
+    /** Size of audio data in bytes */
+    size_t audio_size;
+
+    /** Audio format */
+    rac_audio_format_enum_t audio_format;
+
+    /** Sample rate */
+    int32_t sample_rate;
+
+    /** Duration in milliseconds */
+    int64_t duration_ms;
+
+    /** Processing time in milliseconds */
+    int64_t processing_time_ms;
+} rac_tts_result_t;
+
+// =============================================================================
+// INFO - Mirrors Swift's TTSService properties
+// =============================================================================
+
+/**
+ * @brief TTS service info
+ */
+typedef struct rac_tts_info {
+    /** Whether the service is ready */
+    rac_bool_t is_ready;
+
+    /** Whether currently synthesizing */
+    rac_bool_t is_synthesizing;
+
+    /** Available voices (null-terminated array) */
+    const char* const* available_voices;
+    size_t num_voices;
+} rac_tts_info_t;
+
+// =============================================================================
+// CALLBACKS
+// =============================================================================
+
+/**
+ * @brief TTS streaming callback
+ *
+ * Called for each audio chunk during streaming synthesis.
+ *
+ * @param audio_data Audio chunk data
+ * @param audio_size Size of audio chunk
+ * @param user_data User-provided context
+ */
+typedef void (*rac_tts_stream_callback_t)(const void* audio_data, size_t audio_size,
+                                          void* user_data);
+
+// =============================================================================
+// PHONEME TIMESTAMP - Mirrors Swift's TTSPhonemeTimestamp
+// =============================================================================
+
+/**
+ * @brief Phoneme timestamp information
+ *
+ * Mirrors Swift's TTSPhonemeTimestamp struct.
+ * See: Sources/RunAnywhere/Features/TTS/Models/TTSOutput.swift
+ */
+typedef struct rac_tts_phoneme_timestamp {
+    /** The phoneme */
+    const char* phoneme;
+
+    /** Start time in milliseconds */
+    int64_t start_time_ms;
+
+    /** End time in milliseconds */
+    int64_t end_time_ms;
+} rac_tts_phoneme_timestamp_t;
+
+// =============================================================================
+// SYNTHESIS METADATA - Mirrors Swift's TTSSynthesisMetadata
+// =============================================================================
+
+/**
+ * @brief Synthesis metadata
+ *
+ * Mirrors Swift's TTSSynthesisMetadata struct.
+ * See: Sources/RunAnywhere/Features/TTS/Models/TTSOutput.swift
+ */
+typedef struct rac_tts_synthesis_metadata {
+    /** Voice used for synthesis */
+    const char* voice;
+
+    /** Language used for synthesis */
+    const char* language;
+
+    /** Processing time in milliseconds */
+    int64_t processing_time_ms;
+
+    /** Number of characters synthesized */
+    int32_t character_count;
+
+    /** Characters processed per second */
+    float characters_per_second;
+} rac_tts_synthesis_metadata_t;
+
+// =============================================================================
+// OUTPUT - Mirrors Swift's TTSOutput
+// =============================================================================
+
+/**
+ * @brief TTS output data
+ *
+ * Mirrors Swift's TTSOutput struct exactly.
+ * See: Sources/RunAnywhere/Features/TTS/Models/TTSOutput.swift
+ */
+typedef struct rac_tts_output {
+    /** Synthesized audio data (owned, must be freed with rac_free) */
+    void* audio_data;
+
+    /** Size of audio data in bytes */
+    size_t audio_size;
+
+    /** Audio format of the output */
+    rac_audio_format_enum_t format;
+
+    /** Duration of the audio in milliseconds */
+    int64_t duration_ms;
+
+    /** Phoneme timestamps if available (can be NULL) */
+    rac_tts_phoneme_timestamp_t* phoneme_timestamps;
+    size_t num_phoneme_timestamps;
+
+    /** Processing metadata */
+    rac_tts_synthesis_metadata_t metadata;
+
+    /** Timestamp in milliseconds since epoch */
+    int64_t timestamp_ms;
+} rac_tts_output_t;
+
+// =============================================================================
+// SPEAK RESULT - Mirrors Swift's TTSSpeakResult
+// =============================================================================
+
+/**
+ * @brief Speak result (metadata only, no audio data)
+ *
+ * Mirrors Swift's TTSSpeakResult struct.
+ * The SDK handles audio playback internally when using speak().
+ * See: Sources/RunAnywhere/Features/TTS/Models/TTSOutput.swift
+ */
+typedef struct rac_tts_speak_result {
+    /** Duration of the spoken audio in milliseconds */
+    int64_t duration_ms;
+
+    /** Audio format used */
+    rac_audio_format_enum_t format;
+
+    /** Audio size in bytes (0 for system TTS which plays directly) */
+    size_t audio_size_bytes;
+
+    /** Synthesis metadata */
+    rac_tts_synthesis_metadata_t metadata;
+
+    /** Timestamp when speech completed (milliseconds since epoch) */
+    int64_t timestamp_ms;
+} rac_tts_speak_result_t;
+
+// =============================================================================
+// MEMORY MANAGEMENT
+// =============================================================================
+
+/**
+ * @brief Free TTS result resources
+ *
+ * @param result Result to free (can be NULL)
+ */
+RAC_API void rac_tts_result_free(rac_tts_result_t* result);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_TTS_TYPES_H */

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

@@ -0,0 +1,264 @@
+/**
+ * @file rac_types.h
+ * @brief RunAnywhere Commons - Common Types and Definitions
+ *
+ * This header defines common types, handle types, and macros used throughout
+ * the runanywhere-commons library. All types use the RAC_ prefix to distinguish
+ * from the underlying runanywhere-core (ra_*) types.
+ */
+
+#ifndef RAC_TYPES_H
+#define RAC_TYPES_H
+
+#include <stddef.h>
+#include <stdint.h>
+
+/**
+ * Null pointer macro for use in static initializers.
+ * Uses nullptr in C++ (preferred by clang-tidy modernize-use-nullptr)
+ * and NULL in C for compatibility.
+ */
+#ifdef __cplusplus
+#define RAC_NULL nullptr
+#else
+#define RAC_NULL NULL
+#endif
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// API VISIBILITY MACROS
+// =============================================================================
+//
+// RAC_API marks functions that must be visible to FFI (dlsym).
+//
+// CRITICAL: For iOS/Android Flutter FFI, symbols MUST have public visibility
+// even when statically linked. dlsym(RTLD_DEFAULT, ...) can only find symbols
+// with "external" visibility, not "private external".
+//
+// Without visibility("default"), static library symbols get "private external"
+// visibility (due to -fvisibility=hidden), which becomes "non-external" (local)
+// in the final binary - breaking FFI symbol lookup.
+// =============================================================================
+
+#if defined(_WIN32)
+#if defined(RAC_BUILDING_SHARED)
+#define RAC_API __declspec(dllexport)
+#elif defined(RAC_USING_SHARED)
+#define RAC_API __declspec(dllimport)
+#else
+#define RAC_API
+#endif
+#elif defined(__GNUC__) || defined(__clang__)
+// Always use default visibility for FFI compatibility
+// This ensures dlsym() can find symbols even in static libraries
+#define RAC_API __attribute__((visibility("default")))
+#else
+#define RAC_API
+#endif
+
+// =============================================================================
+// RESULT TYPE
+// =============================================================================
+
+/**
+ * Result type for all RAC functions.
+ * - 0 indicates success
+ * - Negative values indicate errors (see rac_error.h)
+ *
+ * Error code ranges:
+ * - runanywhere-core (ra_*): 0 to -99
+ * - runanywhere-commons (rac_*): -100 to -999
+ */
+typedef int32_t rac_result_t;
+
+/** Success result */
+#define RAC_SUCCESS ((rac_result_t)0)
+
+// =============================================================================
+// BOOLEAN TYPE
+// =============================================================================
+
+/** Boolean type for C compatibility */
+typedef int32_t rac_bool_t;
+
+#define RAC_TRUE ((rac_bool_t)1)
+#define RAC_FALSE ((rac_bool_t)0)
+
+// =============================================================================
+// HANDLE TYPES
+// =============================================================================
+
+/**
+ * Opaque handle for internal objects.
+ * Handles should be treated as opaque pointers.
+ */
+typedef void* rac_handle_t;
+
+/** Invalid handle value */
+#define RAC_INVALID_HANDLE ((rac_handle_t)NULL)
+
+// =============================================================================
+// STRING TYPES
+// =============================================================================
+
+/**
+ * String view (non-owning reference to a string).
+ * The string is NOT guaranteed to be null-terminated.
+ */
+typedef struct rac_string_view {
+    const char* data; /**< Pointer to string data */
+    size_t length;    /**< Length in bytes (not including any null terminator) */
+} rac_string_view_t;
+
+/**
+ * Creates a string view from a null-terminated C string.
+ */
+#define RAC_STRING_VIEW(s) ((rac_string_view_t){(s), (s) ? strlen(s) : 0})
+
+// =============================================================================
+// AUDIO TYPES
+// =============================================================================
+
+/**
+ * Audio buffer for STT/VAD operations.
+ * Contains PCM float samples in the range [-1.0, 1.0].
+ */
+typedef struct rac_audio_buffer {
+    const float* samples; /**< PCM float samples */
+    size_t num_samples;   /**< Number of samples */
+    int32_t sample_rate;  /**< Sample rate in Hz (e.g., 16000) */
+    int32_t channels;     /**< Number of channels (1 = mono, 2 = stereo) */
+} rac_audio_buffer_t;
+
+/**
+ * Audio format specification.
+ */
+typedef struct rac_audio_format {
+    int32_t sample_rate;     /**< Sample rate in Hz */
+    int32_t channels;        /**< Number of channels */
+    int32_t bits_per_sample; /**< Bits per sample (16 or 32) */
+} rac_audio_format_t;
+
+// =============================================================================
+// MEMORY INFO
+// =============================================================================
+
+/**
+ * Memory information structure.
+ * Used by the platform adapter to report available memory.
+ */
+typedef struct rac_memory_info {
+    uint64_t total_bytes;     /**< Total physical memory in bytes */
+    uint64_t available_bytes; /**< Available memory in bytes */
+    uint64_t used_bytes;      /**< Used memory in bytes */
+} rac_memory_info_t;
+
+// =============================================================================
+// CAPABILITY TYPES
+// =============================================================================
+
+/**
+ * Capability types supported by backends.
+ * These match the capabilities defined in runanywhere-core.
+ */
+typedef enum rac_capability {
+    RAC_CAPABILITY_UNKNOWN = 0,
+    RAC_CAPABILITY_TEXT_GENERATION = 1, /**< LLM text generation */
+    RAC_CAPABILITY_EMBEDDINGS = 2,      /**< Text embeddings */
+    RAC_CAPABILITY_STT = 3,             /**< Speech-to-text */
+    RAC_CAPABILITY_TTS = 4,             /**< Text-to-speech */
+    RAC_CAPABILITY_VAD = 5,             /**< Voice activity detection */
+    RAC_CAPABILITY_DIARIZATION = 6,     /**< Speaker diarization */
+} rac_capability_t;
+
+/**
+ * Device type for backend execution.
+ */
+typedef enum rac_device {
+    RAC_DEVICE_CPU = 0,
+    RAC_DEVICE_GPU = 1,
+    RAC_DEVICE_NPU = 2,
+    RAC_DEVICE_AUTO = 3,
+} rac_device_t;
+
+// =============================================================================
+// LOG LEVELS
+// =============================================================================
+
+/**
+ * Log level for the logging callback.
+ */
+typedef enum rac_log_level {
+    RAC_LOG_TRACE = 0,
+    RAC_LOG_DEBUG = 1,
+    RAC_LOG_INFO = 2,
+    RAC_LOG_WARNING = 3,
+    RAC_LOG_ERROR = 4,
+    RAC_LOG_FATAL = 5,
+} rac_log_level_t;
+
+// =============================================================================
+// VERSION INFO
+// =============================================================================
+
+/**
+ * Version information structure.
+ */
+typedef struct rac_version {
+    uint16_t major;
+    uint16_t minor;
+    uint16_t patch;
+    const char* string; /**< Version string (e.g., "1.0.0") */
+} rac_version_t;
+
+// =============================================================================
+// UTILITY MACROS
+// =============================================================================
+
+/** Check if a result is a success */
+#define RAC_SUCCEEDED(result) ((result) >= 0)
+
+/** Check if a result is an error */
+#define RAC_FAILED(result) ((result) < 0)
+
+/** Check if a handle is valid */
+#define RAC_IS_VALID_HANDLE(handle) ((handle) != RAC_INVALID_HANDLE)
+
+// =============================================================================
+// MEMORY MANAGEMENT
+// =============================================================================
+
+/**
+ * Frees memory allocated by RAC functions.
+ *
+ * Use this to free strings and buffers returned by RAC functions that
+ * are marked as "must be freed with rac_free".
+ *
+ * @param ptr Pointer to memory to free (can be NULL)
+ */
+RAC_API void rac_free(void* ptr);
+
+/**
+ * Allocates memory using the RAC allocator.
+ *
+ * @param size Number of bytes to allocate
+ * @return Pointer to allocated memory, or NULL on failure
+ */
+RAC_API void* rac_alloc(size_t size);
+
+/**
+ * Duplicates a null-terminated string.
+ *
+ * @param str String to duplicate (can be NULL)
+ * @return Duplicated string (must be freed with rac_free), or NULL if str is NULL
+ */
+RAC_API char* rac_strdup(const char* str);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_TYPES_H */

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

@@ -0,0 +1,17 @@
+/**
+ * @file rac_vad.h
+ * @brief RunAnywhere Commons - VAD API (Convenience Header)
+ *
+ * This header includes both types and service interface for convenience.
+ * For better separation of concerns, prefer including:
+ * - rac_vad_types.h for data structures only
+ * - rac_vad_service.h for the service interface
+ */
+
+#ifndef RAC_VAD_H
+#define RAC_VAD_H
+
+#include <RACommons/rac_vad_service.h>
+#include <RACommons/rac_vad_types.h>
+
+#endif /* RAC_VAD_H */