@runanywhere/core 0.16.0

package/RunAnywhereCore.podspec

@@ -0,0 +1,130 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+# =============================================================================
+# Version Constants (MUST match Swift Package.swift)
+# =============================================================================
+COMMONS_VERSION = "0.1.4"
+
+# =============================================================================
+# Binary Source - RACommons from runanywhere-sdks
+# =============================================================================
+GITHUB_ORG = "RunanywhereAI"
+COMMONS_REPO = "runanywhere-sdks"
+
+# =============================================================================
+# testLocal Toggle
+# Set RA_TEST_LOCAL=1 or create .testlocal file to use local binaries
+# =============================================================================
+TEST_LOCAL = ENV['RA_TEST_LOCAL'] == '1' || File.exist?(File.join(__dir__, '.testlocal'))
+
+Pod::Spec.new do |s|
+  s.name         = "RunAnywhereCore"
+  s.module_name  = "RunAnywhereCore"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = "https://runanywhere.com"
+  s.license      = package["license"]
+  s.authors      = "RunAnywhere AI"
+
+  s.platforms    = { :ios => "15.1" }
+  s.source       = { :git => "https://github.com/RunanywhereAI/sdks.git", :tag => "#{s.version}" }
+
+  # =============================================================================
+  # Core SDK - RACommons Only
+  # No LLM/STT/TTS/VAD backends - those are in @runanywhere/llamacpp and @runanywhere/onnx
+  # =============================================================================
+  if TEST_LOCAL
+    puts "[RunAnywhereCore] Using LOCAL RACommons from ios/Binaries/"
+    s.vendored_frameworks = "ios/Binaries/RACommons.xcframework"
+  else
+    s.prepare_command = <<-CMD
+      set -e
+
+      FRAMEWORK_DIR="ios/Frameworks"
+      VERSION="#{COMMONS_VERSION}"
+      VERSION_FILE="$FRAMEWORK_DIR/.version"
+
+      # Check if already downloaded with correct version
+      if [ -f "$VERSION_FILE" ] && [ -d "$FRAMEWORK_DIR/RACommons.xcframework" ]; then
+        CURRENT_VERSION=$(cat "$VERSION_FILE")
+        if [ "$CURRENT_VERSION" = "$VERSION" ]; then
+          echo "✅ RACommons.xcframework version $VERSION already downloaded"
+          exit 0
+        fi
+      fi
+
+      echo "📦 Downloading RACommons.xcframework version $VERSION..."
+
+      mkdir -p "$FRAMEWORK_DIR"
+      rm -rf "$FRAMEWORK_DIR/RACommons.xcframework"
+
+      # Download RACommons from runanywhere-sdks
+      DOWNLOAD_URL="https://github.com/#{GITHUB_ORG}/#{COMMONS_REPO}/releases/download/commons-v$VERSION/RACommons-ios-v$VERSION.zip"
+      ZIP_FILE="/tmp/RACommons.zip"
+
+      echo "   URL: $DOWNLOAD_URL"
+
+      curl -L -f -o "$ZIP_FILE" "$DOWNLOAD_URL" || {
+        echo "❌ Failed to download RACommons from $DOWNLOAD_URL"
+        exit 1
+      }
+
+      echo "📂 Extracting RACommons.xcframework..."
+      unzip -q -o "$ZIP_FILE" -d "$FRAMEWORK_DIR/"
+      rm -f "$ZIP_FILE"
+
+      echo "$VERSION" > "$VERSION_FILE"
+
+      if [ -d "$FRAMEWORK_DIR/RACommons.xcframework" ]; then
+        echo "✅ RACommons.xcframework installed successfully"
+      else
+        echo "❌ RACommons.xcframework extraction failed"
+        exit 1
+      fi
+    CMD
+
+    s.vendored_frameworks = "ios/Frameworks/RACommons.xcframework"
+  end
+
+  # Source files - Core only (no LLM/STT/TTS/VAD bridges)
+  s.source_files = [
+    "ios/**/*.{swift}",
+    "ios/**/*.{h,m,mm}",
+    "cpp/HybridRunAnywhereCore.cpp",
+    "cpp/HybridRunAnywhereCore.hpp",
+    "cpp/bridges/**/*.{cpp,hpp}",
+  ]
+
+  # Build settings with header paths for RACommons.xcframework
+  s.pod_target_xcconfig = {
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++17",
+    "HEADER_SEARCH_PATHS" => [
+      "$(PODS_TARGET_SRCROOT)/cpp",
+      "$(PODS_TARGET_SRCROOT)/cpp/bridges",
+      "$(PODS_TARGET_SRCROOT)/ios/Frameworks/RACommons.xcframework/ios-arm64/RACommons.framework/Headers",
+      "$(PODS_TARGET_SRCROOT)/ios/Frameworks/RACommons.xcframework/ios-arm64_x86_64-simulator/RACommons.framework/Headers",
+      "$(PODS_TARGET_SRCROOT)/ios/Binaries/RACommons.xcframework/ios-arm64/RACommons.framework/Headers",
+      "$(PODS_TARGET_SRCROOT)/ios/Binaries/RACommons.xcframework/ios-arm64_x86_64-simulator/RACommons.framework/Headers",
+      "$(PODS_ROOT)/Headers/Public",
+    ].join(" "),
+    "GCC_PREPROCESSOR_DEFINITIONS" => "$(inherited) HAS_RACOMMONS=1",
+    "DEFINES_MODULE" => "YES",
+    "SWIFT_OBJC_INTEROP_MODE" => "objcxx",
+  }
+
+  # Required system libraries and frameworks
+  s.libraries = "c++", "archive", "bz2"
+  s.frameworks = "Accelerate", "Foundation", "CoreML", "AudioToolbox"
+
+  # React Native dependencies
+  s.dependency 'React-jsi'
+  s.dependency 'React-callinvoker'
+
+  # Load Nitrogen-generated autolinking
+  load 'nitrogen/generated/ios/RunAnywhereCore+autolinking.rb'
+  add_nitrogen_files(s)
+
+  install_modules_dependencies(s)
+end

package/android/CMakeLists.txt

@@ -0,0 +1,92 @@
+project(runanywherecore)
+cmake_minimum_required(VERSION 3.9.0)
+
+set(PACKAGE_NAME runanywherecore)
+set(CMAKE_VERBOSE_MAKEFILE ON)
+set(CMAKE_CXX_STANDARD 20)
+
+# Path to pre-built native libraries (downloaded from runanywhere-sdks)
+set(JNILIB_DIR ${CMAKE_SOURCE_DIR}/src/main/jniLibs/${ANDROID_ABI})
+
+# Path to RAC headers (downloaded with native libraries)
+set(RAC_INCLUDE_DIR ${CMAKE_SOURCE_DIR}/src/main/include)
+
+# =============================================================================
+# RACommons - Core SDK functionality (rac_* API)
+# This is the ONLY native library in the core package
+# RACommons is REQUIRED - it's downloaded via Gradle downloadNativeLibs task
+# =============================================================================
+if(NOT EXISTS "${JNILIB_DIR}/librac_commons.so")
+    message(FATAL_ERROR "[RunAnywhereCore] RACommons not found at ${JNILIB_DIR}/librac_commons.so\n"
+                        "Run: ./gradlew :runanywhere_core:downloadNativeLibs")
+endif()
+
+add_library(rac_commons SHARED IMPORTED)
+set_target_properties(rac_commons PROPERTIES
+    IMPORTED_LOCATION "${JNILIB_DIR}/librac_commons.so"
+    IMPORTED_NO_SONAME TRUE
+)
+message(STATUS "[RunAnywhereCore] Found RACommons at ${JNILIB_DIR}/librac_commons.so")
+
+# =============================================================================
+# Source files - Core bridges only (no LLM/STT/TTS/VAD)
+# =============================================================================
+# Collect core bridge source files
+file(GLOB BRIDGE_SOURCES "../cpp/bridges/*.cpp")
+
+add_library(${PACKAGE_NAME} SHARED
+    src/main/cpp/cpp-adapter.cpp
+    ../cpp/HybridRunAnywhereCore.cpp
+    ${BRIDGE_SOURCES}
+)
+
+# Add Nitrogen specs (this handles all React Native linking)
+include(${CMAKE_SOURCE_DIR}/../nitrogen/generated/android/runanywherecore+autolinking.cmake)
+
+# =============================================================================
+# Include directories
+# =============================================================================
+include_directories(
+    "src/main/cpp"
+    "../cpp"
+    "../cpp/bridges"
+    "${CMAKE_SOURCE_DIR}/include"
+    # RAC API headers from runanywhere-commons (flat access)
+    "${RAC_INCLUDE_DIR}"
+    "${RAC_INCLUDE_DIR}/rac"
+    "${RAC_INCLUDE_DIR}/rac/core"
+    "${RAC_INCLUDE_DIR}/rac/core/capabilities"
+    "${RAC_INCLUDE_DIR}/rac/features"
+    "${RAC_INCLUDE_DIR}/rac/features/llm"
+    "${RAC_INCLUDE_DIR}/rac/features/stt"
+    "${RAC_INCLUDE_DIR}/rac/features/tts"
+    "${RAC_INCLUDE_DIR}/rac/features/vad"
+    "${RAC_INCLUDE_DIR}/rac/features/voice_agent"
+    "${RAC_INCLUDE_DIR}/rac/features/platform"
+    "${RAC_INCLUDE_DIR}/rac/infrastructure"
+    "${RAC_INCLUDE_DIR}/rac/infrastructure/device"
+    "${RAC_INCLUDE_DIR}/rac/infrastructure/download"
+    "${RAC_INCLUDE_DIR}/rac/infrastructure/events"
+    "${RAC_INCLUDE_DIR}/rac/infrastructure/model_management"
+    "${RAC_INCLUDE_DIR}/rac/infrastructure/network"
+    "${RAC_INCLUDE_DIR}/rac/infrastructure/storage"
+    "${RAC_INCLUDE_DIR}/rac/infrastructure/telemetry"
+)
+
+# =============================================================================
+# Linking
+# =============================================================================
+find_library(LOG_LIB log)
+
+target_link_libraries(
+    ${PACKAGE_NAME}
+    ${LOG_LIB}
+    android
+)
+
+# Link RACommons - REQUIRED for core functionality
+target_link_libraries(${PACKAGE_NAME} rac_commons)
+target_compile_definitions(${PACKAGE_NAME} PRIVATE HAS_RACOMMONS=1)
+
+# NOTE: No LlamaCPP or ONNX linking here
+# Those are in @runanywhere/llamacpp and @runanywhere/onnx packages respectively

package/android/build.gradle

@@ -0,0 +1,321 @@
+def getExtOrDefault(name) {
+    return rootProject.ext.has(name) ? rootProject.ext.get(name) : project.properties['RunAnywhereCore_' + name]
+}
+
+// Only arm64-v8a is supported - native libraries are only built for 64-bit ARM
+def reactNativeArchitectures() {
+    return ["arm64-v8a"]
+}
+
+apply plugin: 'com.android.library'
+apply plugin: 'kotlin-android'
+apply from: '../nitrogen/generated/android/runanywherecore+autolinking.gradle'
+apply plugin: 'com.facebook.react'
+
+def getExtOrIntegerDefault(name) {
+    if (rootProject.ext.has(name)) {
+        return rootProject.ext.get(name)
+    } else if (project.properties.containsKey('RunAnywhereCore_' + name)) {
+        return (project.properties['RunAnywhereCore_' + name]).toInteger()
+    }
+    def defaults = [
+        'compileSdkVersion': 36,
+        'minSdkVersion': 24,
+        'targetSdkVersion': 36
+    ]
+    return defaults[name] ?: 36
+}
+
+// =============================================================================
+// Version Constants (MUST match Swift Package.swift and iOS Podspec)
+// RACommons ONLY - no backend binaries
+// =============================================================================
+def commonsVersion = "0.1.4"
+
+// =============================================================================
+// Binary Source - RACommons from runanywhere-sdks
+// =============================================================================
+def githubOrg = "RunanywhereAI"
+def commonsRepo = "runanywhere-sdks"
+
+// =============================================================================
+// testLocal Toggle
+// =============================================================================
+def useLocalBuild = project.findProperty("runanywhere.testLocal")?.toBoolean() ?:
+                    System.getenv("RA_TEST_LOCAL") == "1" ?: false
+
+// Native libraries directory
+def jniLibsDir = file("src/main/jniLibs")
+def downloadedLibsDir = file("build/downloaded-libs")
+def includeDir = file("src/main/include")
+
+// Local runanywhere-commons path (for local builds)
+def runAnywhereCommonsDir = file("../../../../runanywhere-commons")
+
+android {
+    namespace "com.margelo.nitro.runanywhere.core"
+
+    compileSdkVersion getExtOrIntegerDefault('compileSdkVersion')
+
+    defaultConfig {
+        minSdkVersion getExtOrIntegerDefault('minSdkVersion')
+        targetSdkVersion getExtOrIntegerDefault('targetSdkVersion')
+
+        ndk {
+            abiFilters 'arm64-v8a'
+        }
+
+        externalNativeBuild {
+            cmake {
+                cppFlags "-frtti -fexceptions -Wall -fstack-protector-all"
+                arguments "-DANDROID_STL=c++_shared"
+                abiFilters 'arm64-v8a'
+            }
+        }
+    }
+
+    externalNativeBuild {
+        cmake {
+            path "CMakeLists.txt"
+        }
+    }
+
+    packagingOptions {
+        excludes = [
+            "META-INF",
+            "META-INF/**"
+        ]
+        pickFirsts = [
+            "**/libc++_shared.so",
+            "**/libjsi.so",
+            "**/libfbjni.so",
+            "**/libfolly_runtime.so",
+            "**/librac_commons.so",
+            "**/librunanywhere_jni.so"
+        ]
+        jniLibs {
+            useLegacyPackaging = true
+        }
+    }
+
+    buildFeatures {
+        buildConfig true
+        prefab true
+    }
+
+    buildTypes {
+        release {
+            minifyEnabled false
+        }
+    }
+
+    lint {
+        disable 'GradleCompatible'
+    }
+
+    compileOptions {
+        sourceCompatibility JavaVersion.VERSION_17
+        targetCompatibility JavaVersion.VERSION_17
+    }
+
+    kotlinOptions {
+        jvmTarget = "17"
+    }
+
+    sourceSets {
+        main {
+            java.srcDirs += [
+                "generated/java",
+                "generated/jni"
+            ]
+
+            if (useLocalBuild) {
+                def commonsDistDir = new File(runAnywhereCommonsDir, "dist/android")
+                if (commonsDistDir.exists()) {
+                    jniLibs.srcDirs = [commonsDistDir]
+                    logger.lifecycle("[RunAnywhereCore] Using LOCAL native libraries from: $commonsDistDir")
+                } else {
+                    logger.warn("[RunAnywhereCore] Local commons dist not found at: $commonsDistDir")
+                }
+            } else {
+                jniLibs.srcDirs = [jniLibsDir]
+            }
+        }
+    }
+}
+
+// =============================================================================
+// Download Native Libraries (RACommons ONLY)
+// Backend modules (LlamaCPP, ONNX) are downloaded by their respective packages
+// =============================================================================
+
+task downloadNativeLibs {
+    description = "Downloads RACommons from GitHub releases"
+    group = "build setup"
+
+    def versionFile = file("${jniLibsDir}/.version")
+    def expectedVersion = commonsVersion
+
+    outputs.dir(jniLibsDir)
+    outputs.upToDateWhen {
+        versionFile.exists() && versionFile.text.trim() == expectedVersion
+    }
+
+    doLast {
+        if (useLocalBuild) {
+            logger.lifecycle("[RunAnywhereCore] Skipping download - using local build mode")
+            return
+        }
+
+        def currentVersion = versionFile.exists() ? versionFile.text.trim() : ""
+        if (currentVersion == expectedVersion) {
+            logger.lifecycle("[RunAnywhereCore] RACommons version $expectedVersion already downloaded")
+            return
+        }
+
+        logger.lifecycle("[RunAnywhereCore] Downloading RACommons...")
+        logger.lifecycle("  Commons Version: $commonsVersion")
+
+        downloadedLibsDir.mkdirs()
+        jniLibsDir.deleteDir()
+        jniLibsDir.mkdirs()
+        includeDir.mkdirs()
+
+        // =============================================================================
+        // Download RACommons from runanywhere-sdks
+        // =============================================================================
+        def commonsUrl = "https://github.com/${githubOrg}/${commonsRepo}/releases/download/commons-v${commonsVersion}/RACommons-android-v${commonsVersion}.zip"
+        def commonsZip = file("${downloadedLibsDir}/RACommons.zip")
+
+        logger.lifecycle("\n📦 Downloading RACommons...")
+        logger.lifecycle("   URL: $commonsUrl")
+
+        try {
+            new URL(commonsUrl).withInputStream { input ->
+                commonsZip.withOutputStream { output ->
+                    output << input
+                }
+            }
+            logger.lifecycle("   Downloaded: ${commonsZip.length() / 1024}KB")
+
+            // Extract and flatten the archive structure
+            // Archive structure: jniLibs/arm64-v8a/*.so
+            // Target structure: arm64-v8a/*.so (directly in jniLibsDir)
+            copy {
+                from zipTree(commonsZip)
+                into jniLibsDir
+                // IMPORTANT: Exclude libc++_shared.so - React Native provides its own
+                // Using a different version causes ABI compatibility issues
+                exclude "**/libc++_shared.so"
+                eachFile { fileCopyDetails ->
+                    def pathString = fileCopyDetails.relativePath.pathString
+                    // Handle jniLibs/ABI/*.so structure -> flatten to ABI/*.so
+                    if (pathString.startsWith("jniLibs/") && pathString.endsWith(".so")) {
+                        def newPath = pathString.replaceFirst("^jniLibs/", "")
+                        fileCopyDetails.relativePath = new RelativePath(true, newPath.split("/"))
+                    } else if (pathString.endsWith(".so")) {
+                        // Keep .so files as-is if already in correct structure
+                    } else {
+                        // Exclude non-so files from jniLibs
+                        if (!pathString.contains("include/")) {
+                            fileCopyDetails.exclude()
+                        }
+                    }
+                }
+                includeEmptyDirs = false
+            }
+
+            // Copy headers if present in the archive
+            def tempExtract = file("${downloadedLibsDir}/temp-commons")
+            tempExtract.deleteDir()
+            copy {
+                from zipTree(commonsZip)
+                into tempExtract
+            }
+            def headersDir = new File(tempExtract, "include")
+            if (headersDir.exists()) {
+                copy {
+                    from headersDir
+                    into includeDir
+                }
+                logger.lifecycle("   ✅ RACommons headers installed")
+            }
+            // Also check for nested jniLibs/include structure
+            def nestedHeadersDir = new File(tempExtract, "jniLibs/include")
+            if (nestedHeadersDir.exists()) {
+                copy {
+                    from nestedHeadersDir
+                    into includeDir
+                }
+                logger.lifecycle("   ✅ RACommons headers installed (from nested path)")
+            }
+            tempExtract.deleteDir()
+
+            logger.lifecycle("   ✅ RACommons installed")
+        } catch (Exception e) {
+            logger.error("❌ Failed to download RACommons: ${e.message}")
+            throw new GradleException("Failed to download RACommons", e)
+        }
+
+        // =============================================================================
+        // List installed files
+        // =============================================================================
+        logger.lifecycle("\n📋 Installed native libraries:")
+        jniLibsDir.listFiles()?.findAll { it.isDirectory() }?.each { abiDir ->
+            logger.lifecycle("  ${abiDir.name}/")
+            abiDir.listFiles()?.findAll { it.name.endsWith(".so") }?.sort()?.each { soFile ->
+                logger.lifecycle("    ${soFile.name} (${soFile.length() / 1024}KB)")
+            }
+        }
+
+        if (includeDir.exists() && includeDir.listFiles()?.size() > 0) {
+            logger.lifecycle("\n📋 Installed headers:")
+            includeDir.eachFileRecurse { file ->
+                if (file.isFile() && file.name.endsWith(".h")) {
+                    logger.lifecycle("  ${file.relativePath(includeDir)}")
+                }
+            }
+        }
+
+        versionFile.text = expectedVersion
+        logger.lifecycle("\n✅ RACommons version $expectedVersion installed")
+    }
+}
+
+if (!useLocalBuild) {
+    preBuild.dependsOn downloadNativeLibs
+
+    afterEvaluate {
+        tasks.matching {
+            it.name.contains("generateCodegen") || it.name.contains("Codegen")
+        }.configureEach {
+            mustRunAfter downloadNativeLibs
+        }
+    }
+}
+
+task cleanNativeLibs(type: Delete) {
+    description = "Removes downloaded native libraries"
+    group = "build"
+    delete jniLibsDir
+    delete downloadedLibsDir
+    delete includeDir
+}
+
+clean.dependsOn cleanNativeLibs
+
+repositories {
+    mavenCentral()
+    google()
+}
+
+dependencies {
+    implementation "com.facebook.react:react-android"
+    implementation project(":react-native-nitro-modules")
+
+    // Apache Commons Compress for tar.gz archive extraction
+    implementation "org.apache.commons:commons-compress:1.26.0"
+    
+    // AndroidX Security for EncryptedSharedPreferences (device identity persistence)
+    implementation "androidx.security:security-crypto:1.1.0-alpha06"
+}

package/android/consumer-rules.pro

@@ -0,0 +1,5 @@
+# Keep ArchiveUtility for JNI access
+-keep class com.margelo.nitro.runanywhere.ArchiveUtility { *; }
+-keepclassmembers class com.margelo.nitro.runanywhere.ArchiveUtility {
+    public static *** extract(java.lang.String, java.lang.String);
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,3 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.margelo.nitro.runanywhere.core">
+</manifest>