@runanywhere/core 0.16.0

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

@@ -0,0 +1,160 @@
+/**
+ * @file rac_component_types.h
+ * @brief RunAnywhere Commons - Core Component Types
+ *
+ * C port of Swift's component types from:
+ * Sources/RunAnywhere/Core/Types/ComponentTypes.swift
+ * Sources/RunAnywhere/Core/Capabilities/Analytics/ResourceTypes.swift
+ *
+ * These types define SDK components, their configurations, and resource types.
+ */
+
+#ifndef RAC_COMPONENT_TYPES_H
+#define RAC_COMPONENT_TYPES_H
+
+#include <RACommons/rac_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// SDK COMPONENT - Mirrors Swift's SDKComponent enum
+// =============================================================================
+
+/**
+ * @brief SDK component types for identification
+ *
+ * Mirrors Swift's SDKComponent enum exactly.
+ * See: Sources/RunAnywhere/Core/Types/ComponentTypes.swift
+ */
+typedef enum rac_sdk_component {
+    RAC_COMPONENT_LLM = 0,       /**< Large Language Model */
+    RAC_COMPONENT_STT = 1,       /**< Speech-to-Text */
+    RAC_COMPONENT_TTS = 2,       /**< Text-to-Speech */
+    RAC_COMPONENT_VAD = 3,       /**< Voice Activity Detection */
+    RAC_COMPONENT_VOICE = 4,     /**< Voice Agent */
+    RAC_COMPONENT_EMBEDDING = 5, /**< Embedding generation */
+} rac_sdk_component_t;
+
+/**
+ * @brief Get human-readable display name for SDK component
+ *
+ * @param component The SDK component type
+ * @return Display name string (static, do not free)
+ */
+RAC_API const char* rac_sdk_component_display_name(rac_sdk_component_t component);
+
+/**
+ * @brief Get raw string value for SDK component
+ *
+ * Mirrors Swift's rawValue property.
+ *
+ * @param component The SDK component type
+ * @return Raw string value (static, do not free)
+ */
+RAC_API const char* rac_sdk_component_raw_value(rac_sdk_component_t component);
+
+// =============================================================================
+// CAPABILITY RESOURCE TYPE - Mirrors Swift's CapabilityResourceType enum
+// =============================================================================
+
+/**
+ * @brief Types of resources that can be loaded by capabilities
+ *
+ * Mirrors Swift's CapabilityResourceType enum exactly.
+ * See: Sources/RunAnywhere/Core/Capabilities/Analytics/ResourceTypes.swift
+ */
+typedef enum rac_capability_resource_type {
+    RAC_RESOURCE_LLM_MODEL = 0,         /**< LLM model */
+    RAC_RESOURCE_STT_MODEL = 1,         /**< STT model */
+    RAC_RESOURCE_TTS_VOICE = 2,         /**< TTS voice */
+    RAC_RESOURCE_VAD_MODEL = 3,         /**< VAD model */
+    RAC_RESOURCE_DIARIZATION_MODEL = 4, /**< Diarization model */
+} rac_capability_resource_type_t;
+
+/**
+ * @brief Get raw string value for capability resource type
+ *
+ * Mirrors Swift's rawValue property.
+ *
+ * @param type The capability resource type
+ * @return Raw string value (static, do not free)
+ */
+RAC_API const char* rac_capability_resource_type_raw_value(rac_capability_resource_type_t type);
+
+// =============================================================================
+// COMPONENT CONFIGURATION - Mirrors Swift's ComponentConfiguration protocol
+// =============================================================================
+
+/**
+ * @brief Base component configuration
+ *
+ * Mirrors Swift's ComponentConfiguration protocol.
+ * See: Sources/RunAnywhere/Core/Types/ComponentTypes.swift
+ *
+ * Note: In C, we use a struct with common fields instead of a protocol.
+ * Specific configurations (LLM, STT, TTS, VAD) extend this with their own fields.
+ */
+typedef struct rac_component_config_base {
+    /** Model identifier (optional - uses default if NULL) */
+    const char* model_id;
+
+    /** Preferred inference framework (use -1 for auto/none) */
+    int32_t preferred_framework;
+} rac_component_config_base_t;
+
+/**
+ * @brief Default base component configuration
+ */
+static const rac_component_config_base_t RAC_COMPONENT_CONFIG_BASE_DEFAULT = {
+    .model_id = RAC_NULL, .preferred_framework = -1 /* No preference */
+};
+
+// =============================================================================
+// COMPONENT INPUT/OUTPUT - Mirrors Swift's ComponentInput/ComponentOutput protocols
+// =============================================================================
+
+/**
+ * @brief Base component output with timestamp
+ *
+ * Mirrors Swift's ComponentOutput protocol requirement.
+ * All outputs include a timestamp in milliseconds since epoch.
+ */
+typedef struct rac_component_output_base {
+    /** Timestamp in milliseconds since epoch (1970-01-01 00:00:00 UTC) */
+    int64_t timestamp_ms;
+} rac_component_output_base_t;
+
+// =============================================================================
+// INFERENCE FRAMEWORK - Mirrors Swift's InferenceFramework enum
+// (Typically defined in model_types, but included here for completeness)
+// =============================================================================
+
+/**
+ * @brief Get SDK component type from capability resource type
+ *
+ * Maps resource types to their corresponding SDK components.
+ *
+ * @param resource_type The capability resource type
+ * @return Corresponding SDK component type
+ */
+RAC_API rac_sdk_component_t
+rac_resource_type_to_component(rac_capability_resource_type_t resource_type);
+
+/**
+ * @brief Get capability resource type from SDK component type
+ *
+ * Maps SDK components to their corresponding resource types.
+ *
+ * @param component The SDK component type
+ * @return Corresponding capability resource type, or -1 if no mapping exists
+ */
+RAC_API rac_capability_resource_type_t
+rac_component_to_resource_type(rac_sdk_component_t component);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_COMPONENT_TYPES_H */

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

@@ -0,0 +1,331 @@
+/**
+ * @file rac_core.h
+ * @brief RunAnywhere Commons - Core Initialization and Module Management
+ *
+ * This header provides the core API for initializing and shutting down
+ * the commons library, as well as module registration and discovery.
+ */
+
+#ifndef RAC_CORE_H
+#define RAC_CORE_H
+
+#include <RACommons/rac_error.h>
+#include <RACommons/rac_types.h>
+#include <RACommons/rac_model_types.h>
+#include <RACommons/rac_environment.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// FORWARD DECLARATIONS
+// =============================================================================
+
+/** Platform adapter (see rac_platform_adapter.h) */
+typedef struct rac_platform_adapter rac_platform_adapter_t;
+
+// =============================================================================
+// CONFIGURATION
+// =============================================================================
+
+/**
+ * Configuration for initializing the commons library.
+ */
+typedef struct rac_config {
+    /** Platform adapter providing file, logging, and other platform callbacks */
+    const rac_platform_adapter_t* platform_adapter;
+
+    /** Log level for internal logging */
+    rac_log_level_t log_level;
+
+    /** Application-specific tag for logging */
+    const char* log_tag;
+
+    /** Reserved for future use (set to NULL) */
+    void* reserved;
+} rac_config_t;
+
+// =============================================================================
+// INITIALIZATION API
+// =============================================================================
+
+/**
+ * Initializes the commons library.
+ *
+ * This must be called before any other RAC functions. The platform adapter
+ * is required and provides callbacks for platform-specific operations.
+ *
+ * @param config Configuration options (platform_adapter is required)
+ * @return RAC_SUCCESS on success, or an error code on failure
+ *
+ * @note HTTP requests return RAC_ERROR_NOT_SUPPORTED - networking should be
+ *       handled by the SDK layer (Swift/Kotlin), not the C++ layer.
+ */
+RAC_API rac_result_t rac_init(const rac_config_t* config);
+
+/**
+ * Shuts down the commons library.
+ *
+ * This releases all resources and unregisters all modules. Any active
+ * handles become invalid after this call.
+ */
+RAC_API void rac_shutdown(void);
+
+/**
+ * Checks if the commons library is initialized.
+ *
+ * @return RAC_TRUE if initialized, RAC_FALSE otherwise
+ */
+RAC_API rac_bool_t rac_is_initialized(void);
+
+/**
+ * Gets the version of the commons library.
+ *
+ * @return Version information structure
+ */
+RAC_API rac_version_t rac_get_version(void);
+
+/**
+ * Configures logging based on the environment.
+ *
+ * This configures C++ local logging (stderr) based on the environment:
+ * - Development: stderr ON, min level DEBUG
+ * - Staging: stderr ON, min level INFO
+ * - Production: stderr OFF, min level WARNING (logs only go to Swift bridge)
+ *
+ * Call this during SDK initialization after setting the platform adapter.
+ *
+ * @param environment The current SDK environment
+ * @return RAC_SUCCESS on success
+ */
+RAC_API rac_result_t rac_configure_logging(rac_environment_t environment);
+
+// =============================================================================
+// MODULE INFORMATION
+// =============================================================================
+
+/**
+ * Information about a registered module (backend).
+ */
+typedef struct rac_module_info {
+    const char* id;          /**< Unique module identifier */
+    const char* name;        /**< Human-readable name */
+    const char* version;     /**< Module version string */
+    const char* description; /**< Module description */
+
+    /** Capabilities provided by this module */
+    const rac_capability_t* capabilities;
+    size_t num_capabilities;
+} rac_module_info_t;
+
+// =============================================================================
+// MODULE REGISTRATION API
+// =============================================================================
+
+/**
+ * Registers a module with the registry.
+ *
+ * Modules (backends) call this to register themselves with the commons layer.
+ * This allows the SDK to discover available backends at runtime.
+ *
+ * @param info Module information (copied internally)
+ * @return RAC_SUCCESS on success, or an error code on failure
+ */
+RAC_API rac_result_t rac_module_register(const rac_module_info_t* info);
+
+/**
+ * Unregisters a module from the registry.
+ *
+ * @param module_id The unique ID of the module to unregister
+ * @return RAC_SUCCESS on success, or an error code on failure
+ */
+RAC_API rac_result_t rac_module_unregister(const char* module_id);
+
+/**
+ * Gets the list of registered modules.
+ *
+ * @param out_modules Pointer to receive the module list (do not free)
+ * @param out_count Pointer to receive the number of modules
+ * @return RAC_SUCCESS on success, or an error code on failure
+ *
+ * @note The returned list is valid until the next module registration/unregistration.
+ */
+RAC_API rac_result_t rac_module_list(const rac_module_info_t** out_modules, size_t* out_count);
+
+/**
+ * Gets modules that provide a specific capability.
+ *
+ * @param capability The capability to search for
+ * @param out_modules Pointer to receive the module list (do not free)
+ * @param out_count Pointer to receive the number of modules
+ * @return RAC_SUCCESS on success, or an error code on failure
+ */
+RAC_API rac_result_t rac_modules_for_capability(rac_capability_t capability,
+                                                const rac_module_info_t** out_modules,
+                                                size_t* out_count);
+
+/**
+ * Gets information about a specific module.
+ *
+ * @param module_id The unique ID of the module
+ * @param out_info Pointer to receive the module info (do not free)
+ * @return RAC_SUCCESS on success, or RAC_ERROR_MODULE_NOT_FOUND if not found
+ */
+RAC_API rac_result_t rac_module_get_info(const char* module_id, const rac_module_info_t** out_info);
+
+// =============================================================================
+// SERVICE PROVIDER API - Mirrors Swift's ServiceRegistry
+// =============================================================================
+
+/**
+ * Service request for creating services.
+ * Passed to canHandle and create functions.
+ *
+ * Mirrors Swift's approach where canHandle receives a model/voice ID.
+ */
+typedef struct rac_service_request {
+    /** Model or voice ID to check/create for (can be NULL for default) */
+    const char* identifier;
+
+    /** Configuration JSON string (can be NULL) */
+    const char* config_json;
+
+    /** The capability being requested */
+    rac_capability_t capability;
+
+    /** Framework hint for routing (from model registry) */
+    rac_inference_framework_t framework;
+
+    /** Local path to model file (can be NULL if using identifier lookup) */
+    const char* model_path;
+} rac_service_request_t;
+
+/**
+ * canHandle function type.
+ * Mirrors Swift's `canHandle: @Sendable (String?) -> Bool`
+ *
+ * @param request The service request
+ * @param user_data Provider-specific context
+ * @return RAC_TRUE if this provider can handle the request
+ */
+typedef rac_bool_t (*rac_service_can_handle_fn)(const rac_service_request_t* request,
+                                                void* user_data);
+
+/**
+ * Service factory function type.
+ * Mirrors Swift's factory closure.
+ *
+ * @param request The service request
+ * @param user_data Provider-specific context
+ * @return Handle to created service, or NULL on failure
+ */
+typedef rac_handle_t (*rac_service_create_fn)(const rac_service_request_t* request,
+                                              void* user_data);
+
+/**
+ * Service provider registration.
+ * Mirrors Swift's ServiceRegistration struct.
+ */
+typedef struct rac_service_provider {
+    /** Provider name (e.g., "LlamaCPPService") */
+    const char* name;
+
+    /** Capability this provider offers */
+    rac_capability_t capability;
+
+    /** Priority (higher = preferred, default 100) */
+    int32_t priority;
+
+    /** Function to check if provider can handle request */
+    rac_service_can_handle_fn can_handle;
+
+    /** Function to create service instance */
+    rac_service_create_fn create;
+
+    /** User data passed to callbacks */
+    void* user_data;
+} rac_service_provider_t;
+
+/**
+ * Registers a service provider.
+ *
+ * Mirrors Swift's ServiceRegistry.registerSTT/LLM/TTS/VAD methods.
+ * Providers are sorted by priority (higher first).
+ *
+ * @param provider Provider information (copied internally)
+ * @return RAC_SUCCESS on success, or an error code on failure
+ */
+RAC_API rac_result_t rac_service_register_provider(const rac_service_provider_t* provider);
+
+/**
+ * Unregisters a service provider.
+ *
+ * @param name The name of the provider to unregister
+ * @param capability The capability the provider was registered for
+ * @return RAC_SUCCESS on success, or an error code on failure
+ */
+RAC_API rac_result_t rac_service_unregister_provider(const char* name, rac_capability_t capability);
+
+/**
+ * Creates a service for a specific capability.
+ *
+ * Mirrors Swift's createSTT/LLM/TTS/VAD methods.
+ * Finds first provider that canHandle the request (sorted by priority).
+ *
+ * @param capability The capability needed
+ * @param request The service request (can have identifier and config)
+ * @param out_handle Pointer to receive the service handle
+ * @return RAC_SUCCESS on success, or an error code on failure
+ */
+RAC_API rac_result_t rac_service_create(rac_capability_t capability,
+                                        const rac_service_request_t* request,
+                                        rac_handle_t* out_handle);
+
+/**
+ * Lists registered providers for a capability.
+ *
+ * @param capability The capability to list providers for
+ * @param out_names Pointer to receive array of provider names
+ * @param out_count Pointer to receive count
+ * @return RAC_SUCCESS on success
+ */
+RAC_API rac_result_t rac_service_list_providers(rac_capability_t capability,
+                                                const char*** out_names, size_t* out_count);
+
+// =============================================================================
+// GLOBAL MODEL REGISTRY API
+// =============================================================================
+
+/**
+ * Gets the global model registry instance.
+ * The registry is created automatically on first access.
+ *
+ * @return Handle to the global model registry
+ */
+RAC_API struct rac_model_registry* rac_get_model_registry(void);
+
+/**
+ * Registers a model with the global registry.
+ * Convenience function that calls rac_model_registry_save on the global registry.
+ *
+ * @param model Model info to register
+ * @return RAC_SUCCESS on success, or error code
+ */
+RAC_API rac_result_t rac_register_model(const struct rac_model_info* model);
+
+/**
+ * Gets model info from the global registry.
+ * Convenience function that calls rac_model_registry_get on the global registry.
+ *
+ * @param model_id Model identifier
+ * @param out_model Output: Model info (owned, must be freed with rac_model_info_free)
+ * @return RAC_SUCCESS on success, RAC_ERROR_NOT_FOUND if not registered
+ */
+RAC_API rac_result_t rac_get_model(const char* model_id, struct rac_model_info** out_model);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif /* RAC_CORE_H */

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

@@ -0,0 +1,85 @@
+/**
+ * @file rac_dev_config.h
+ * @brief Development mode configuration API
+ *
+ * Provides access to development mode configuration values.
+ * The actual values are defined in development_config.cpp which is git-ignored.
+ *
+ * This allows:
+ * - Cross-platform sharing of dev config (iOS, Android, Flutter)
+ * - Git-ignored secrets with template for developers
+ * - Consistent development environment across SDKs
+ *
+ * Security Model:
+ * - development_config.cpp is in .gitignore (not committed to main branch)
+ * - Real values are ONLY in release tags (for SPM/Maven distribution)
+ * - Used ONLY when SDK is in .development mode
+ * - Backend validates build token via POST /api/v1/devices/register/dev
+ */
+
+#ifndef RAC_DEV_CONFIG_H
+#define RAC_DEV_CONFIG_H
+
+#include <stdbool.h>
+
+#include <RACommons/rac_types.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+// =============================================================================
+// Development Configuration API
+// =============================================================================
+
+/**
+ * @brief Check if development config is available
+ * @return true if development config is properly configured
+ */
+RAC_API bool rac_dev_config_is_available(void);
+
+/**
+ * @brief Get Supabase project URL for development mode
+ * @return URL string (static, do not free)
+ */
+RAC_API const char* rac_dev_config_get_supabase_url(void);
+
+/**
+ * @brief Get Supabase anon key for development mode
+ * @return API key string (static, do not free)
+ */
+RAC_API const char* rac_dev_config_get_supabase_key(void);
+
+/**
+ * @brief Get build token for development mode
+ * @return Build token string (static, do not free)
+ */
+RAC_API const char* rac_dev_config_get_build_token(void);
+
+/**
+ * @brief Get Sentry DSN for crash reporting (optional)
+ * @return Sentry DSN string, or NULL if not configured
+ */
+RAC_API const char* rac_dev_config_get_sentry_dsn(void);
+
+// =============================================================================
+// Convenience Functions
+// =============================================================================
+
+/**
+ * @brief Check if Supabase config is valid
+ * @return true if URL and key are non-empty
+ */
+RAC_API bool rac_dev_config_has_supabase(void);
+
+/**
+ * @brief Check if build token is valid
+ * @return true if build token is non-empty
+ */
+RAC_API bool rac_dev_config_has_build_token(void);
+
+#ifdef __cplusplus
+}
+#endif
+
+#endif  // RAC_DEV_CONFIG_H