@runanywhere/core 0.16.0

package/cpp/HybridRunAnywhereCore.hpp

@@ -0,0 +1,271 @@
+/**
+ * HybridRunAnywhereCore.hpp
+ *
+ * Nitrogen HybridObject implementation for RunAnywhere Core SDK.
+ * This single C++ file works on both iOS and Android.
+ *
+ * Core SDK implementation - includes:
+ * - SDK Lifecycle (init, destroy)
+ * - Authentication
+ * - Device Registration
+ * - Model Registry
+ * - Download Service
+ * - Storage
+ * - Events
+ * - HTTP Client
+ * - Utilities
+ * - LLM/STT/TTS/VAD/VoiceAgent (backend-agnostic via rac_*_component_* APIs)
+ *
+ * The capability methods (LLM, STT, TTS, VAD) are BACKEND-AGNOSTIC.
+ * They call the C++ rac_*_component_* APIs which work with any registered backend.
+ * Apps must install a backend package to register the actual implementation:
+ * - @runanywhere/llamacpp registers the LLM backend
+ * - @runanywhere/onnx registers the STT/TTS/VAD backends
+ *
+ * The HybridRunAnywhereCoreSpec base class is auto-generated by Nitrogen
+ * from src/specs/RunAnywhereCore.nitro.ts
+ */
+
+#pragma once
+
+// Include the generated spec header (created by nitrogen)
+#if __has_include(<NitroModules/HybridObject.hpp>)
+#include "HybridRunAnywhereCoreSpec.hpp"
+#else
+// Fallback include path during development
+#include "../nitrogen/generated/shared/c++/HybridRunAnywhereCoreSpec.hpp"
+#endif
+
+#include <mutex>
+#include <string>
+#include <optional>
+#include <variant>
+#include <functional>
+
+namespace margelo::nitro::runanywhere {
+
+/**
+ * HybridRunAnywhereCore - Core SDK native implementation
+ *
+ * Implements the RunAnywhereCore interface defined in RunAnywhereCore.nitro.ts
+ * Delegates to modular bridges that call runanywhere-commons rac_* API.
+ */
+class HybridRunAnywhereCore : public HybridRunAnywhereCoreSpec {
+public:
+  HybridRunAnywhereCore();
+  ~HybridRunAnywhereCore();
+
+  // ============================================================================
+  // SDK Lifecycle
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> initialize(const std::string& configJson) override;
+  std::shared_ptr<Promise<void>> destroy() override;
+  std::shared_ptr<Promise<bool>> isInitialized() override;
+  std::shared_ptr<Promise<std::string>> getBackendInfo() override;
+
+  // ============================================================================
+  // Authentication - Delegates to AuthBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> authenticate(const std::string& apiKey) override;
+  std::shared_ptr<Promise<bool>> isAuthenticated() override;
+  std::shared_ptr<Promise<std::string>> getUserId() override;
+  std::shared_ptr<Promise<std::string>> getOrganizationId() override;
+  std::shared_ptr<Promise<bool>> setAuthTokens(const std::string& authResponseJson) override;
+
+  // ============================================================================
+  // Device Registration - Delegates to DeviceBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> registerDevice(const std::string& environmentJson) override;
+  std::shared_ptr<Promise<bool>> isDeviceRegistered() override;
+  std::shared_ptr<Promise<bool>> clearDeviceRegistration() override;
+  std::shared_ptr<Promise<std::string>> getDeviceId() override;
+
+  // ============================================================================
+  // Model Registry - Delegates to ModelRegistryBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<std::string>> getAvailableModels() override;
+  std::shared_ptr<Promise<std::string>> getModelInfo(const std::string& modelId) override;
+  std::shared_ptr<Promise<bool>> isModelDownloaded(const std::string& modelId) override;
+  std::shared_ptr<Promise<std::string>> getModelPath(const std::string& modelId) override;
+  std::shared_ptr<Promise<bool>> registerModel(const std::string& modelJson) override;
+
+  // ============================================================================
+  // Download Service - Delegates to DownloadBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> downloadModel(
+    const std::string& modelId,
+    const std::string& url,
+    const std::string& destPath) override;
+  std::shared_ptr<Promise<bool>> cancelDownload(const std::string& modelId) override;
+  std::shared_ptr<Promise<std::string>> getDownloadProgress(const std::string& modelId) override;
+
+  // ============================================================================
+  // Storage - Delegates to StorageBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<std::string>> getStorageInfo() override;
+  std::shared_ptr<Promise<bool>> clearCache() override;
+  std::shared_ptr<Promise<bool>> deleteModel(const std::string& modelId) override;
+
+  // ============================================================================
+  // Events - Delegates to EventBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<void>> emitEvent(const std::string& eventJson) override;
+  std::shared_ptr<Promise<std::string>> pollEvents() override;
+
+  // ============================================================================
+  // HTTP Client - Delegates to HTTPBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> configureHttp(
+    const std::string& baseUrl,
+    const std::string& apiKey) override;
+  std::shared_ptr<Promise<std::string>> httpPost(
+    const std::string& path,
+    const std::string& bodyJson) override;
+  std::shared_ptr<Promise<std::string>> httpGet(const std::string& path) override;
+
+  // ============================================================================
+  // Utility Functions
+  // ============================================================================
+
+  std::shared_ptr<Promise<std::string>> getLastError() override;
+  std::shared_ptr<Promise<bool>> extractArchive(
+    const std::string& archivePath,
+    const std::string& destPath) override;
+  std::shared_ptr<Promise<std::string>> getDeviceCapabilities() override;
+  std::shared_ptr<Promise<double>> getMemoryUsage() override;
+
+  // ============================================================================
+  // LLM Capability (Backend-Agnostic)
+  // Delegates to rac_llm_component_* APIs via LLMBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> loadTextModel(
+    const std::string& modelPath,
+    const std::optional<std::string>& configJson) override;
+  std::shared_ptr<Promise<bool>> isTextModelLoaded() override;
+  std::shared_ptr<Promise<bool>> unloadTextModel() override;
+  std::shared_ptr<Promise<std::string>> generate(
+    const std::string& prompt,
+    const std::optional<std::string>& optionsJson) override;
+  std::shared_ptr<Promise<std::string>> generateStream(
+    const std::string& prompt,
+    const std::string& optionsJson,
+    const std::function<void(const std::string&, bool)>& callback) override;
+  std::shared_ptr<Promise<bool>> cancelGeneration() override;
+  std::shared_ptr<Promise<std::string>> generateStructured(
+    const std::string& prompt,
+    const std::string& schema,
+    const std::optional<std::string>& optionsJson) override;
+
+  // ============================================================================
+  // STT Capability (Backend-Agnostic)
+  // Delegates to rac_stt_component_* APIs via STTBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> loadSTTModel(
+    const std::string& modelPath,
+    const std::string& modelType,
+    const std::optional<std::string>& configJson) override;
+  std::shared_ptr<Promise<bool>> isSTTModelLoaded() override;
+  std::shared_ptr<Promise<bool>> unloadSTTModel() override;
+  std::shared_ptr<Promise<std::string>> transcribe(
+    const std::string& audioBase64,
+    double sampleRate,
+    const std::optional<std::string>& language) override;
+  std::shared_ptr<Promise<std::string>> transcribeFile(
+    const std::string& filePath,
+    const std::optional<std::string>& language) override;
+
+  // ============================================================================
+  // TTS Capability (Backend-Agnostic)
+  // Delegates to rac_tts_component_* APIs via TTSBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> loadTTSModel(
+    const std::string& modelPath,
+    const std::string& modelType,
+    const std::optional<std::string>& configJson) override;
+  std::shared_ptr<Promise<bool>> isTTSModelLoaded() override;
+  std::shared_ptr<Promise<bool>> unloadTTSModel() override;
+  std::shared_ptr<Promise<std::string>> synthesize(
+    const std::string& text,
+    const std::string& voiceId,
+    double speedRate,
+    double pitchShift) override;
+  std::shared_ptr<Promise<std::string>> getTTSVoices() override;
+  std::shared_ptr<Promise<bool>> cancelTTS() override;
+
+  // ============================================================================
+  // VAD Capability (Backend-Agnostic)
+  // Delegates to rac_vad_component_* APIs via VADBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> loadVADModel(
+    const std::string& modelPath,
+    const std::optional<std::string>& configJson) override;
+  std::shared_ptr<Promise<bool>> isVADModelLoaded() override;
+  std::shared_ptr<Promise<bool>> unloadVADModel() override;
+  std::shared_ptr<Promise<std::string>> processVAD(
+    const std::string& audioBase64,
+    const std::optional<std::string>& optionsJson) override;
+  std::shared_ptr<Promise<void>> resetVAD() override;
+
+  // ============================================================================
+  // Secure Storage
+  // Matches Swift: KeychainManager.swift
+  // Uses platform adapter callbacks for Keychain/Keystore
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> secureStorageSet(
+    const std::string& key,
+    const std::string& value) override;
+  std::shared_ptr<Promise<std::variant<nitro::NullType, std::string>>> secureStorageGet(
+    const std::string& key) override;
+  std::shared_ptr<Promise<bool>> secureStorageDelete(const std::string& key) override;
+  std::shared_ptr<Promise<bool>> secureStorageExists(const std::string& key) override;
+  std::shared_ptr<Promise<std::string>> getPersistentDeviceUUID() override;
+
+  // ============================================================================
+  // Telemetry
+  // Matches Swift: CppBridge+Telemetry.swift
+  // C++ handles all telemetry logic - batching, JSON building, routing
+  // ============================================================================
+
+  std::shared_ptr<Promise<void>> flushTelemetry() override;
+  std::shared_ptr<Promise<bool>> isTelemetryInitialized() override;
+
+  // ============================================================================
+  // Voice Agent Capability (Backend-Agnostic)
+  // Delegates to rac_voice_agent_* APIs via VoiceAgentBridge
+  // ============================================================================
+
+  std::shared_ptr<Promise<bool>> initializeVoiceAgent(const std::string& configJson) override;
+  std::shared_ptr<Promise<bool>> initializeVoiceAgentWithLoadedModels() override;
+  std::shared_ptr<Promise<bool>> isVoiceAgentReady() override;
+  std::shared_ptr<Promise<std::string>> getVoiceAgentComponentStates() override;
+  std::shared_ptr<Promise<std::string>> processVoiceTurn(const std::string& audioBase64) override;
+  std::shared_ptr<Promise<std::string>> voiceAgentTranscribe(const std::string& audioBase64) override;
+  std::shared_ptr<Promise<std::string>> voiceAgentGenerateResponse(const std::string& prompt) override;
+  std::shared_ptr<Promise<std::string>> voiceAgentSynthesizeSpeech(const std::string& text) override;
+  std::shared_ptr<Promise<void>> cleanupVoiceAgent() override;
+
+private:
+  // Thread safety
+  std::mutex initMutex_;
+
+  // State tracking
+  std::string lastError_;
+
+  // Helper methods
+  void setLastError(const std::string& error);
+};
+
+} // namespace margelo::nitro::runanywhere

package/cpp/bridges/AuthBridge.cpp

@@ -0,0 +1,209 @@
+/**
+ * @file AuthBridge.cpp
+ * @brief C++ bridge for authentication operations.
+ *
+ * NOTE: The RACommons library (librac_commons.so) does NOT export auth state
+ * management functions. Authentication must be handled at the platform level
+ * (TypeScript/Kotlin/Swift) with tokens managed outside of C++.
+ *
+ * This bridge provides a passthrough interface that delegates to platform.
+ */
+
+#include "AuthBridge.hpp"
+#include "rac_error.h"
+#include <stdexcept>
+
+// Platform-specific logging
+#if defined(ANDROID) || defined(__ANDROID__)
+#include <android/log.h>
+#define LOG_TAG "AuthBridge"
+#define LOGI(...) __android_log_print(ANDROID_LOG_INFO, LOG_TAG, __VA_ARGS__)
+#define LOGD(...) __android_log_print(ANDROID_LOG_DEBUG, LOG_TAG, __VA_ARGS__)
+#define LOGE(...) __android_log_print(ANDROID_LOG_ERROR, LOG_TAG, __VA_ARGS__)
+#define LOGW(...) __android_log_print(ANDROID_LOG_WARN, LOG_TAG, __VA_ARGS__)
+#else
+#include <cstdio>
+#define LOGI(...) printf("[AuthBridge] "); printf(__VA_ARGS__); printf("\n")
+#define LOGD(...) printf("[AuthBridge DEBUG] "); printf(__VA_ARGS__); printf("\n")
+#define LOGE(...) printf("[AuthBridge ERROR] "); printf(__VA_ARGS__); printf("\n")
+#define LOGW(...) printf("[AuthBridge WARN] "); printf(__VA_ARGS__); printf("\n")
+#endif
+
+namespace runanywhere {
+namespace bridges {
+
+// =============================================================================
+// Singleton Implementation
+// =============================================================================
+
+AuthBridge& AuthBridge::shared() {
+    static AuthBridge instance;
+    return instance;
+}
+
+// =============================================================================
+// Platform Callbacks
+// =============================================================================
+
+void AuthBridge::setPlatformCallbacks(const AuthPlatformCallbacks& callbacks) {
+    platformCallbacks_ = callbacks;
+    LOGI("Platform callbacks set for AuthBridge");
+}
+
+// =============================================================================
+// JSON Building (Platform calls HTTP, we just format)
+// =============================================================================
+
+std::string AuthBridge::buildAuthenticateRequestJSON(
+    const std::string& apiKey,
+    const std::string& deviceId,
+    const std::string& platform,
+    const std::string& sdkVersion
+) {
+    // Simple JSON building without external dependencies
+    std::string json = "{";
+    json += "\"api_key\":\"" + apiKey + "\",";
+    json += "\"device_id\":\"" + deviceId + "\",";
+    json += "\"platform\":\"" + platform + "\",";
+    json += "\"sdk_version\":\"" + sdkVersion + "\"";
+    json += "}";
+    return json;
+}
+
+std::string AuthBridge::buildRefreshRequestJSON(
+    const std::string& refreshToken,
+    const std::string& deviceId
+) {
+    std::string json = "{";
+    json += "\"refresh_token\":\"" + refreshToken + "\",";
+    json += "\"device_id\":\"" + deviceId + "\"";
+    json += "}";
+    return json;
+}
+
+// =============================================================================
+// Response Handling (Parse JSON and extract fields)
+// =============================================================================
+
+AuthResponse AuthBridge::handleAuthResponse(const std::string& jsonResponse) {
+    AuthResponse response;
+
+    // Simple JSON parsing (extract key fields)
+    // In production, use a proper JSON library
+    auto extractString = [&](const std::string& key) -> std::string {
+        std::string searchKey = "\"" + key + "\":\"";
+        size_t pos = jsonResponse.find(searchKey);
+        if (pos == std::string::npos) return "";
+        pos += searchKey.length();
+        size_t endPos = jsonResponse.find("\"", pos);
+        if (endPos == std::string::npos) return "";
+        return jsonResponse.substr(pos, endPos - pos);
+    };
+
+    auto extractInt = [&](const std::string& key) -> int64_t {
+        std::string searchKey = "\"" + key + "\":";
+        size_t pos = jsonResponse.find(searchKey);
+        if (pos == std::string::npos) return 0;
+        pos += searchKey.length();
+        try {
+            return std::stoll(jsonResponse.substr(pos));
+        } catch (...) {
+            return 0;
+        }
+    };
+
+    response.accessToken = extractString("access_token");
+    response.refreshToken = extractString("refresh_token");
+    response.deviceId = extractString("device_id");
+    response.userId = extractString("user_id");
+    response.organizationId = extractString("organization_id");
+    response.expiresIn = extractInt("expires_in");
+    response.success = !response.accessToken.empty();
+
+    if (!response.success) {
+        response.error = extractString("error");
+        if (response.error.empty()) {
+            response.error = extractString("message");
+        }
+    }
+
+    return response;
+}
+
+// =============================================================================
+// State Management (Delegated to platform via callbacks)
+// =============================================================================
+
+void AuthBridge::setAuth(const AuthResponse& auth) {
+    // Store locally for C++ access
+    currentAuth_ = auth;
+    isAuthenticated_ = auth.success && !auth.accessToken.empty();
+
+    // Notify platform
+    if (platformCallbacks_.onAuthStateChanged) {
+        platformCallbacks_.onAuthStateChanged(isAuthenticated_);
+    }
+
+    LOGI("Auth state updated: authenticated=%d", isAuthenticated_ ? 1 : 0);
+}
+
+std::string AuthBridge::getAccessToken() const {
+    if (platformCallbacks_.getAccessToken) {
+        return platformCallbacks_.getAccessToken();
+    }
+    return currentAuth_.accessToken;
+}
+
+std::string AuthBridge::getRefreshToken() const {
+    if (platformCallbacks_.getRefreshToken) {
+        return platformCallbacks_.getRefreshToken();
+    }
+    return currentAuth_.refreshToken;
+}
+
+bool AuthBridge::isAuthenticated() const {
+    if (platformCallbacks_.isAuthenticated) {
+        return platformCallbacks_.isAuthenticated();
+    }
+    return isAuthenticated_;
+}
+
+bool AuthBridge::tokenNeedsRefresh() const {
+    if (platformCallbacks_.tokenNeedsRefresh) {
+        return platformCallbacks_.tokenNeedsRefresh();
+    }
+    // Default: check if we have refresh token but no valid access token
+    return !currentAuth_.refreshToken.empty() && currentAuth_.accessToken.empty();
+}
+
+std::string AuthBridge::getUserId() const {
+    if (platformCallbacks_.getUserId) {
+        return platformCallbacks_.getUserId();
+    }
+    return currentAuth_.userId;
+}
+
+std::string AuthBridge::getOrganizationId() const {
+    if (platformCallbacks_.getOrganizationId) {
+        return platformCallbacks_.getOrganizationId();
+    }
+    return currentAuth_.organizationId;
+}
+
+void AuthBridge::clearAuth() {
+    currentAuth_ = AuthResponse();
+    isAuthenticated_ = false;
+
+    if (platformCallbacks_.clearAuth) {
+        platformCallbacks_.clearAuth();
+    }
+
+    if (platformCallbacks_.onAuthStateChanged) {
+        platformCallbacks_.onAuthStateChanged(false);
+    }
+
+    LOGI("Auth state cleared");
+}
+
+} // namespace bridges
+} // namespace runanywhere

package/cpp/bridges/AuthBridge.hpp

@@ -0,0 +1,157 @@
+/**
+ * @file AuthBridge.hpp
+ * @brief C++ bridge for authentication operations.
+ *
+ * NOTE: The RACommons library (librac_commons.so) does NOT export auth state
+ * management functions. Authentication must be handled at the platform level
+ * (TypeScript/Kotlin/Swift) with tokens managed outside of C++.
+ *
+ * This bridge provides a passthrough interface that delegates to platform.
+ */
+
+#pragma once
+
+#include <string>
+#include <functional>
+
+namespace runanywhere {
+namespace bridges {
+
+/**
+ * Auth response structure
+ */
+struct AuthResponse {
+    bool success = false;
+    std::string accessToken;
+    std::string refreshToken;
+    std::string deviceId;
+    std::string userId;
+    std::string organizationId;
+    int64_t expiresIn = 0;
+    std::string error;
+};
+
+/**
+ * Platform callbacks for auth operations
+ *
+ * Platform (TypeScript/Kotlin/Swift) implements secure storage
+ * and HTTP operations, this C++ layer just provides the interface.
+ */
+struct AuthPlatformCallbacks {
+    // Get tokens from platform secure storage
+    std::function<std::string()> getAccessToken;
+    std::function<std::string()> getRefreshToken;
+
+    // Query auth state
+    std::function<bool()> isAuthenticated;
+    std::function<bool()> tokenNeedsRefresh;
+
+    // Get user info
+    std::function<std::string()> getUserId;
+    std::function<std::string()> getOrganizationId;
+
+    // Clear auth (logout)
+    std::function<void()> clearAuth;
+
+    // Notify platform of auth state changes
+    std::function<void(bool authenticated)> onAuthStateChanged;
+};
+
+/**
+ * AuthBridge - Authentication state management
+ *
+ * Provides JSON building/parsing utilities and state access.
+ * Actual HTTP calls and secure storage are done by platform.
+ */
+class AuthBridge {
+public:
+    /**
+     * Get shared instance
+     */
+    static AuthBridge& shared();
+
+    /**
+     * Set platform callbacks
+     * Must be called during SDK initialization
+     */
+    void setPlatformCallbacks(const AuthPlatformCallbacks& callbacks);
+
+    /**
+     * Build authenticate request JSON
+     * Platform uses this to make HTTP POST to /api/v1/auth/sdk/authenticate
+     */
+    std::string buildAuthenticateRequestJSON(
+        const std::string& apiKey,
+        const std::string& deviceId,
+        const std::string& platform,
+        const std::string& sdkVersion
+    );
+
+    /**
+     * Build refresh request JSON
+     * Platform uses this to make HTTP POST to /api/v1/auth/sdk/refresh
+     */
+    std::string buildRefreshRequestJSON(
+        const std::string& refreshToken,
+        const std::string& deviceId
+    );
+
+    /**
+     * Handle authentication response JSON
+     * Returns parsed AuthResponse
+     */
+    AuthResponse handleAuthResponse(const std::string& jsonResponse);
+
+    /**
+     * Set auth state (called by platform after successful auth)
+     */
+    void setAuth(const AuthResponse& auth);
+
+    /**
+     * Get current access token
+     */
+    std::string getAccessToken() const;
+
+    /**
+     * Get current refresh token
+     */
+    std::string getRefreshToken() const;
+
+    /**
+     * Check if currently authenticated
+     */
+    bool isAuthenticated() const;
+
+    /**
+     * Check if token needs refresh
+     */
+    bool tokenNeedsRefresh() const;
+
+    /**
+     * Get user ID
+     */
+    std::string getUserId() const;
+
+    /**
+     * Get organization ID
+     */
+    std::string getOrganizationId() const;
+
+    /**
+     * Clear authentication state
+     */
+    void clearAuth();
+
+private:
+    AuthBridge() = default;
+    ~AuthBridge() = default;
+    AuthBridge(const AuthBridge&) = delete;
+    AuthBridge& operator=(const AuthBridge&) = delete;
+
+    AuthPlatformCallbacks platformCallbacks_{};
+    AuthResponse currentAuth_{};
+    bool isAuthenticated_ = false;
+};
+
+} // namespace bridges
+} // namespace runanywhere