expo-local-llm 0.2.0 → 0.2.2

package/README.md

@@ -163,6 +163,28 @@ const recipe = JSON.parse(await respond('Give me a pasta recipe'));
 - Tool calling is iOS 26+ only. Android will throw at session creation if tools are passed.
 - Structured output uses instruction-based JSON guidance, not Apple's constrained decoding.
 
+## Why an Expo module?
+
+This is built as an [Expo Module](https://docs.expo.dev/modules/overview/), not
+a bare React Native library. Here's why:
+
+- **`expo install` and go** — no manual Xcode/Gradle linking, no `pod install`
+  surprises. Works with `npx expo prebuild` and managed workflow out of the box.
+- **SharedObject lifecycle** — `LLMSession` extends Expo's `SharedObject`, which
+  handles native memory management, event subscriptions, and cleanup
+  automatically when the JS object is garbage collected. In bare RN you'd wire
+  this yourself with `NativeEventEmitter` and manual release calls.
+- **Class DSL** — the native module exposes `LLMSession` as a first-class JS
+  object with instance methods (`session.respond()`, `session.streamResponse()`)
+  rather than flat module-level functions with session IDs. This is an Expo
+  Modules API feature that doesn't exist in the classic RN bridge.
+- **Cross-platform parity** — Expo's Kotlin DSL mirrors the Swift DSL, so the
+  iOS and Android modules have the same structure. Adding Android tool calling
+  later means implementing the same interface, not building a separate bridge.
+
+If you're on bare React Native without Expo, this module won't work — you'd need
+to add `expo-modules-core` as a dependency or use a different library.
+
 ## How is this different from @callstack/ai? (as of March 2026)
 
 [@callstack/ai](https://github.com/callstackincubator/ai) is a full-featured

package/ios/ExpoLocalLlmModule.swift

@@ -52,8 +52,6 @@ public class ExpoLocalLlmModule: Module {
       Function("rejectToolCall") { (session: LLMSession, callId: String, error: String) in
         try session.rejectToolCall(callId: callId, error: error)
       }
-
-      Events("token", "streamComplete", "streamError", "toolCall")
     }
 
     OnAppEntersForeground {

package/ios/FoundationModelBridge.swift

@@ -23,7 +23,8 @@ enum FoundationModelBridge {
     }
   }
 
-  static func createSession(instructions: String?, tools: [any Tool] = []) -> LanguageModelSession {
+  static func createSession(instructions: String?, dynamicTools: [DynamicTool] = []) -> LanguageModelSession {
+    let tools: [any Tool] = dynamicTools
     if tools.isEmpty {
       if let instructions {
         return LanguageModelSession(instructions: instructions)

package/ios/LLMSession.swift

@@ -113,7 +113,7 @@ class LLMSession: SharedObject {
     // Cancel any pending tool calls from the old session
     store.cancelAll()
 
-    var tools: [any Tool] = []
+    var dynamicTools: [DynamicTool] = []
     registeredTools.removeAll()
 
     for config in toolConfigs {
@@ -138,12 +138,12 @@ class LLMSession: SharedObject {
         ])
       }
       registeredTools[config.name] = tool
-      tools.append(tool)
+      dynamicTools.append(tool)
     }
 
     nativeSession = FoundationModelBridge.createSession(
       instructions: sessionInstructions,
-      tools: tools
+      dynamicTools: dynamicTools
     )
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-local-llm",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Expo module for on-device LLM inference via Apple Foundation Models (iOS) and Gemini Nano (Android)",
   "main": "build/index.js",
   "types": "build/index.d.ts",