@runanywhere/core 0.16.11 → 0.17.0

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

@@ -1,335 +0,0 @@
-/**
- * @file rac_api_types.h
- * @brief API request and response data types
- *
- * Defines all data structures for API communication.
- * This is the canonical source of truth - platform SDKs create thin wrappers.
- */
-
-#ifndef RAC_API_TYPES_H
-#define RAC_API_TYPES_H
-
-#include <stdbool.h>
-#include <stddef.h>
-#include <stdint.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// =============================================================================
-// Authentication Types
-// =============================================================================
-
-/**
- * @brief Authentication request payload
- * Sent to POST /api/v1/auth/sdk/authenticate
- */
-typedef struct {
-    const char* api_key;
-    const char* device_id;
-    const char* platform;  // "ios", "android", etc.
-    const char* sdk_version;
-} rac_auth_request_t;
-
-/**
- * @brief Authentication response payload
- * Received from authentication and refresh endpoints
- */
-typedef struct {
-    char* access_token;
-    char* refresh_token;
-    char* device_id;
-    char* user_id;  // Can be NULL (org-level auth)
-    char* organization_id;
-    char* token_type;    // Usually "bearer"
-    int32_t expires_in;  // Seconds until expiry
-} rac_auth_response_t;
-
-/**
- * @brief Refresh token request payload
- * Sent to POST /api/v1/auth/sdk/refresh
- */
-typedef struct {
-    const char* device_id;
-    const char* refresh_token;
-} rac_refresh_request_t;
-
-// =============================================================================
-// Health Check Types
-// =============================================================================
-
-/**
- * @brief Health status enum
- */
-typedef enum {
-    RAC_HEALTH_HEALTHY = 0,
-    RAC_HEALTH_DEGRADED = 1,
-    RAC_HEALTH_UNHEALTHY = 2
-} rac_health_status_t;
-
-/**
- * @brief Health check response
- * Received from GET /v1/health
- */
-typedef struct {
-    rac_health_status_t status;
-    char* version;
-    int64_t timestamp;  // Unix timestamp
-} rac_health_response_t;
-
-// =============================================================================
-// Device Registration Types
-// =============================================================================
-
-/**
- * @brief Device hardware information
- */
-typedef struct {
-    const char* device_fingerprint;
-    const char* device_model;  // e.g., "iPhone15,2"
-    const char* os_version;    // e.g., "17.0"
-    const char* platform;      // "ios", "android", etc.
-    const char* architecture;  // "arm64", "x86_64", etc.
-    int64_t total_memory;      // Bytes
-    int32_t cpu_cores;
-    bool has_neural_engine;
-    bool has_gpu;
-} rac_device_info_t;
-
-/**
- * @brief Device registration request
- * Sent to POST /api/v1/devices/register
- */
-typedef struct {
-    rac_device_info_t device_info;
-    const char* sdk_version;
-    const char* build_token;
-    int64_t last_seen_at;  // Unix timestamp
-} rac_device_reg_request_t;
-
-/**
- * @brief Device registration response
- */
-typedef struct {
-    char* device_id;
-    char* status;       // "registered" or "updated"
-    char* sync_status;  // "synced" or "pending"
-} rac_device_reg_response_t;
-
-// =============================================================================
-// Telemetry Types
-// =============================================================================
-
-/**
- * @brief Telemetry event payload
- * Contains all possible fields for LLM, STT, TTS, VAD events
- */
-typedef struct {
-    // Required fields
-    const char* id;
-    const char* event_type;
-    int64_t timestamp;   // Unix timestamp ms
-    int64_t created_at;  // Unix timestamp ms
-
-    // Event classification
-    const char* modality;  // "llm", "stt", "tts", "model", "system"
-
-    // Device identification
-    const char* device_id;
-    const char* session_id;
-
-    // Model info
-    const char* model_id;
-    const char* model_name;
-    const char* framework;
-
-    // Device info
-    const char* device;
-    const char* os_version;
-    const char* platform;
-    const char* sdk_version;
-
-    // Common metrics
-    double processing_time_ms;
-    bool success;
-    bool has_success;  // Whether success field is set
-    const char* error_message;
-    const char* error_code;
-
-    // LLM-specific
-    int32_t input_tokens;
-    int32_t output_tokens;
-    int32_t total_tokens;
-    double tokens_per_second;
-    double time_to_first_token_ms;
-    double prompt_eval_time_ms;
-    double generation_time_ms;
-    int32_t context_length;
-    double temperature;
-    int32_t max_tokens;
-
-    // STT-specific
-    double audio_duration_ms;
-    double real_time_factor;
-    int32_t word_count;
-    double confidence;
-    const char* language;
-    bool is_streaming;
-    int32_t segment_index;
-
-    // TTS-specific
-    int32_t character_count;
-    double characters_per_second;
-    int32_t audio_size_bytes;
-    int32_t sample_rate;
-    const char* voice;
-    double output_duration_ms;
-
-    // Model lifecycle
-    int64_t model_size_bytes;
-    const char* archive_type;
-
-    // VAD-specific
-    double speech_duration_ms;
-
-    // SDK lifecycle
-    int32_t count;
-
-    // Storage
-    int64_t freed_bytes;
-
-    // Network
-    bool is_online;
-    bool has_is_online;
-} rac_telemetry_event_t;
-
-/**
- * @brief Telemetry batch request
- * Sent to POST /api/v1/sdk/telemetry
- */
-typedef struct {
-    rac_telemetry_event_t* events;
-    size_t event_count;
-    const char* device_id;
-    int64_t timestamp;
-    const char* modality;  // Can be NULL for V1 path
-} rac_telemetry_batch_t;
-
-/**
- * @brief Telemetry batch response
- */
-typedef struct {
-    bool success;
-    int32_t events_received;
-    int32_t events_stored;
-    int32_t events_skipped;
-    char** errors;
-    size_t error_count;
-    char* storage_version;  // "V1" or "V2"
-} rac_telemetry_response_t;
-
-// =============================================================================
-// API Error Types
-// =============================================================================
-
-/**
- * @brief API error information
- */
-typedef struct {
-    int32_t status_code;
-    char* message;
-    char* code;
-    char* raw_body;
-    char* request_url;
-} rac_api_error_t;
-
-// =============================================================================
-// Memory Management
-// =============================================================================
-
-/**
- * @brief Free authentication response
- */
-void rac_auth_response_free(rac_auth_response_t* response);
-
-/**
- * @brief Free health response
- */
-void rac_health_response_free(rac_health_response_t* response);
-
-/**
- * @brief Free device registration response
- */
-void rac_device_reg_response_free(rac_device_reg_response_t* response);
-
-/**
- * @brief Free telemetry response
- */
-void rac_telemetry_response_free(rac_telemetry_response_t* response);
-
-/**
- * @brief Free API error
- */
-void rac_api_error_free(rac_api_error_t* error);
-
-// =============================================================================
-// JSON Serialization
-// =============================================================================
-
-/**
- * @brief Serialize auth request to JSON
- * @param request The request to serialize
- * @return JSON string (caller must free), or NULL on error
- */
-char* rac_auth_request_to_json(const rac_auth_request_t* request);
-
-/**
- * @brief Parse auth response from JSON
- * @param json The JSON string
- * @param out_response Output response (caller must free with rac_auth_response_free)
- * @return 0 on success, -1 on error
- */
-int rac_auth_response_from_json(const char* json, rac_auth_response_t* out_response);
-
-/**
- * @brief Serialize refresh request to JSON
- */
-char* rac_refresh_request_to_json(const rac_refresh_request_t* request);
-
-/**
- * @brief Serialize device registration request to JSON
- */
-char* rac_device_reg_request_to_json(const rac_device_reg_request_t* request);
-
-/**
- * @brief Parse device registration response from JSON
- */
-int rac_device_reg_response_from_json(const char* json, rac_device_reg_response_t* out_response);
-
-/**
- * @brief Serialize telemetry event to JSON
- */
-char* rac_telemetry_event_to_json(const rac_telemetry_event_t* event);
-
-/**
- * @brief Serialize telemetry batch to JSON
- */
-char* rac_telemetry_batch_to_json(const rac_telemetry_batch_t* batch);
-
-/**
- * @brief Parse telemetry response from JSON
- */
-int rac_telemetry_response_from_json(const char* json, rac_telemetry_response_t* out_response);
-
-/**
- * @brief Parse API error from HTTP response
- */
-int rac_api_error_from_response(int status_code, const char* body, const char* url,
-                                rac_api_error_t* out_error);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif  // RAC_API_TYPES_H

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

@@ -1,88 +0,0 @@
-/**
- * @file rac_audio_utils.h
- * @brief RunAnywhere Commons - Audio Utility Functions
- *
- * Provides audio format conversion utilities used across the SDK.
- * This centralizes audio processing logic that was previously duplicated
- * in Swift/Kotlin SDKs.
- */
-
-#ifndef RAC_AUDIO_UTILS_H
-#define RAC_AUDIO_UTILS_H
-
-#include <RACommons/rac_types.h>
-#include <RACommons/rac_tts_types.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// =============================================================================
-// AUDIO CONVERSION API
-// =============================================================================
-
-/**
- * @brief Convert Float32 PCM samples to WAV format (Int16 PCM with header)
- *
- * TTS backends typically output raw Float32 PCM samples in range [-1.0, 1.0].
- * This function converts them to a complete WAV file that can be played by
- * standard audio players (AVAudioPlayer on iOS, MediaPlayer on Android, etc.).
- *
- * WAV format details:
- * - RIFF header with WAVE format
- * - fmt chunk: PCM format (1), mono (1 channel), Int16 samples
- * - data chunk: Int16 samples (scaled from Float32)
- *
- * @param pcm_data Input Float32 PCM samples
- * @param pcm_size Size of pcm_data in bytes (must be multiple of 4)
- * @param sample_rate Sample rate in Hz (e.g., 22050 for Piper TTS)
- * @param out_wav_data Output: WAV file data (owned, must be freed with rac_free)
- * @param out_wav_size Output: Size of WAV data in bytes
- * @return RAC_SUCCESS or error code
- *
- * @note The caller owns the returned wav_data and must free it with rac_free()
- *
- * Example usage:
- * @code
- * void* wav_data = NULL;
- * size_t wav_size = 0;
- * rac_result_t result = rac_audio_float32_to_wav(
- *     pcm_samples, pcm_size, RAC_TTS_DEFAULT_SAMPLE_RATE, &wav_data, &wav_size);
- * if (result == RAC_SUCCESS) {
- *     // Use wav_data...
- *     rac_free(wav_data);
- * }
- * @endcode
- */
-RAC_API rac_result_t rac_audio_float32_to_wav(const void* pcm_data, size_t pcm_size,
-                                              int32_t sample_rate, void** out_wav_data,
-                                              size_t* out_wav_size);
-
-/**
- * @brief Convert Int16 PCM samples to WAV format
- *
- * Similar to rac_audio_float32_to_wav but for Int16 input samples.
- *
- * @param pcm_data Input Int16 PCM samples
- * @param pcm_size Size of pcm_data in bytes (must be multiple of 2)
- * @param sample_rate Sample rate in Hz
- * @param out_wav_data Output: WAV file data (owned, must be freed with rac_free)
- * @param out_wav_size Output: Size of WAV data in bytes
- * @return RAC_SUCCESS or error code
- */
-RAC_API rac_result_t rac_audio_int16_to_wav(const void* pcm_data, size_t pcm_size,
-                                            int32_t sample_rate, void** out_wav_data,
-                                            size_t* out_wav_size);
-
-/**
- * @brief Get WAV header size in bytes
- *
- * @return WAV header size (always 44 bytes for standard PCM WAV)
- */
-RAC_API size_t rac_audio_wav_header_size(void);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* RAC_AUDIO_UTILS_H */

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

@@ -1,252 +0,0 @@
-/**
- * @file rac_auth_manager.h
- * @brief Authentication state management
- *
- * Manages authentication state including tokens, expiry, and refresh logic.
- * Platform SDKs provide HTTP transport and secure storage callbacks.
- */
-
-#ifndef RAC_AUTH_MANAGER_H
-#define RAC_AUTH_MANAGER_H
-
-#include <stdbool.h>
-#include <stdint.h>
-
-#include <RACommons/rac_api_types.h>
-#include <RACommons/rac_environment.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-// =============================================================================
-// Auth State
-// =============================================================================
-
-/**
- * @brief Authentication state structure
- *
- * Managed internally - use accessor functions.
- */
-typedef struct {
-    char* access_token;
-    char* refresh_token;
-    char* device_id;
-    char* user_id;  // Can be NULL
-    char* organization_id;
-    int64_t token_expires_at;  // Unix timestamp (seconds)
-    bool is_authenticated;
-} rac_auth_state_t;
-
-// =============================================================================
-// Platform Callbacks
-// =============================================================================
-
-/**
- * @brief Callback for secure storage operations
- *
- * Platform implements to store tokens in Keychain/KeyStore.
- */
-typedef struct {
-    /**
-     * @brief Store string value securely
-     * @param key Storage key
-     * @param value Value to store
-     * @return 0 on success, -1 on error
-     */
-    int (*store)(const char* key, const char* value, void* context);
-
-    /**
-     * @brief Retrieve string value
-     * @param key Storage key
-     * @param out_value Output buffer (caller provides)
-     * @param buffer_size Size of output buffer
-     * @return Length of value, or -1 on error/not found
-     */
-    int (*retrieve)(const char* key, char* out_value, size_t buffer_size, void* context);
-
-    /**
-     * @brief Delete stored value
-     * @param key Storage key
-     * @return 0 on success, -1 on error
-     */
-    int (*delete_key)(const char* key, void* context);
-
-    /**
-     * @brief Context pointer passed to all callbacks
-     */
-    void* context;
-} rac_secure_storage_t;
-
-// =============================================================================
-// Keychain Keys (for platform implementations)
-// =============================================================================
-
-#define RAC_KEY_ACCESS_TOKEN "com.runanywhere.sdk.accessToken"
-#define RAC_KEY_REFRESH_TOKEN "com.runanywhere.sdk.refreshToken"
-#define RAC_KEY_DEVICE_ID "com.runanywhere.sdk.deviceId"
-#define RAC_KEY_USER_ID "com.runanywhere.sdk.userId"
-#define RAC_KEY_ORGANIZATION_ID "com.runanywhere.sdk.organizationId"
-
-// =============================================================================
-// Initialization
-// =============================================================================
-
-/**
- * @brief Initialize auth manager
- * @param storage Secure storage callbacks (can be NULL for in-memory only)
- */
-void rac_auth_init(const rac_secure_storage_t* storage);
-
-/**
- * @brief Reset auth manager state
- */
-void rac_auth_reset(void);
-
-// =============================================================================
-// Token State
-// =============================================================================
-
-/**
- * @brief Check if currently authenticated
- * @return true if valid access token exists
- */
-bool rac_auth_is_authenticated(void);
-
-/**
- * @brief Check if token needs refresh
- *
- * Returns true if token expires within 60 seconds.
- *
- * @return true if token should be refreshed
- */
-bool rac_auth_needs_refresh(void);
-
-/**
- * @brief Get current access token
- * @return Access token string, or NULL if not authenticated
- */
-const char* rac_auth_get_access_token(void);
-
-/**
- * @brief Get current device ID
- * @return Device ID string, or NULL if not set
- */
-const char* rac_auth_get_device_id(void);
-
-/**
- * @brief Get current user ID
- * @return User ID string, or NULL if not set
- */
-const char* rac_auth_get_user_id(void);
-
-/**
- * @brief Get current organization ID
- * @return Organization ID string, or NULL if not set
- */
-const char* rac_auth_get_organization_id(void);
-
-// =============================================================================
-// Request Building
-// =============================================================================
-
-/**
- * @brief Build authentication request JSON
- *
- * Creates JSON payload for POST /api/v1/auth/sdk/authenticate
- *
- * @param config SDK configuration with credentials
- * @return JSON string (caller must free), or NULL on error
- */
-char* rac_auth_build_authenticate_request(const rac_sdk_config_t* config);
-
-/**
- * @brief Build token refresh request JSON
- *
- * Creates JSON payload for POST /api/v1/auth/sdk/refresh
- *
- * @return JSON string (caller must free), or NULL if no refresh token
- */
-char* rac_auth_build_refresh_request(void);
-
-// =============================================================================
-// Response Handling
-// =============================================================================
-
-/**
- * @brief Parse and store authentication response
- *
- * Updates internal auth state and optionally persists to secure storage.
- *
- * @param json JSON response body
- * @return 0 on success, -1 on parse error
- */
-int rac_auth_handle_authenticate_response(const char* json);
-
-/**
- * @brief Parse and store refresh response
- *
- * Updates internal auth state and optionally persists to secure storage.
- *
- * @param json JSON response body
- * @return 0 on success, -1 on parse error
- */
-int rac_auth_handle_refresh_response(const char* json);
-
-// =============================================================================
-// Token Management
-// =============================================================================
-
-/**
- * @brief Get valid access token, triggering refresh if needed
- *
- * This is the main entry point for getting a token. If the current token
- * is expired or about to expire, it will:
- * 1. Build a refresh request
- * 2. Return a pending state indicating refresh is needed
- *
- * Platform must then:
- * 1. Execute the HTTP request
- * 2. Call rac_auth_handle_refresh_response with result
- * 3. Call this function again to get the new token
- *
- * @param out_token Output pointer for token string
- * @param out_needs_refresh Set to true if refresh HTTP call is needed
- * @return 0 on success (token valid), 1 if refresh needed, -1 on error
- */
-int rac_auth_get_valid_token(const char** out_token, bool* out_needs_refresh);
-
-/**
- * @brief Clear all authentication state
- *
- * Clears in-memory state and secure storage.
- */
-void rac_auth_clear(void);
-
-// =============================================================================
-// Persistence
-// =============================================================================
-
-/**
- * @brief Load tokens from secure storage
- *
- * Call during initialization to restore saved auth state.
- *
- * @return 0 on success (tokens loaded), -1 if not found or error
- */
-int rac_auth_load_stored_tokens(void);
-
-/**
- * @brief Save current tokens to secure storage
- *
- * Called automatically by response handlers, but can be called manually.
- *
- * @return 0 on success, -1 on error
- */
-int rac_auth_save_tokens(void);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif  // RAC_AUTH_MANAGER_H