From e1cfb056dc22b3d3cacbbf4eaf88c383eadb3ff6 Mon Sep 17 00:00:00 2001 From: Mike Grabowski Date: Thu, 29 Oct 2026 22:55:20 +0100 Subject: [PATCH 1/3] feat(adk)!: make isAvailable synchronous, like apple isAvailable() on the provider and the language model now returns a boolean, so checks like if (provider.isAvailable()) work as for the other providers. It answers from the last Gemini Nano status getModelInfo() or prepare() saw, or else from whether AICore is installed. Exact availability stays in the async getModelInfo(). Closes #332. Builds on #290. Co-Authored-By: Claude Opus 5.5 --- .../adk/android/src/main/AndroidManifest.xml | 4 +++ .../com/callstack/ai/adk/AdkAgentRunner.kt | 29 ++++++++++++++++++- .../callstack/ai/adk/NativeAdkEngineModule.kt | 3 ++ packages/adk/src/NativeAdkEngine.ts | 2 ++ packages/adk/src/__tests__/ai-sdk.test.ts | 16 +++++----- packages/adk/src/ai-sdk.ts | 23 +++++++++++---- 6 files changed, 63 insertions(+), 14 deletions(-) diff --git a/packages/adk/android/src/main/AndroidManifest.xml b/packages/adk/android/src/main/AndroidManifest.xml index d6f4979b3..d26d27e71 100644 --- a/packages/adk/android/src/main/AndroidManifest.xml +++ b/packages/adk/android/src/main/AndroidManifest.xml @@ -1,3 +1,7 @@ + + + + diff --git a/packages/adk/android/src/main/java/com/callstack/ai/adk/AdkAgentRunner.kt b/packages/adk/android/src/main/java/com/callstack/ai/adk/AdkAgentRunner.kt index 2e7a02750..cf9dbb349 100644 --- a/packages/adk/android/src/main/java/com/callstack/ai/adk/AdkAgentRunner.kt +++ b/packages/adk/android/src/main/java/com/callstack/ai/adk/AdkAgentRunner.kt @@ -1,6 +1,7 @@ package com.callstack.ai.adk import android.content.Context +import android.content.pm.PackageManager import android.net.Uri import android.util.Base64 import com.facebook.react.bridge.ReadableArray @@ -39,6 +40,8 @@ import kotlinx.coroutines.sync.withLock import java.util.UUID import java.util.concurrent.ConcurrentHashMap +private const val AICORE_PACKAGE = "com.google.android.aicore" + data class AdkRunResult( val content: String, val reasoning: String?, @@ -82,6 +85,26 @@ class AdkAgentRunner( ) { private val nanoModels = ConcurrentHashMap() private val nanoPrepareMutex = Mutex() + // The last Gemini Nano status seen per model selection, for the synchronous check + private val nanoStatuses = ConcurrentHashMap() + + /** + * Whether Gemini Nano is available or downloadable, answered without async work: from the last + * status this process saw, or else from whether AICore is installed. + */ + fun isNanoAvailable(config: NanoConfig): Boolean { + // The latest status wins over a model prepared earlier, which may have gone away since + nanoStatuses[config]?.let { + return it == FeatureStatus.AVAILABLE || it == FeatureStatus.DOWNLOADABLE + } + if (nanoModels.containsKey(config)) return true + return try { + context.packageManager.getPackageInfo(AICORE_PACKAGE, 0) + true + } catch (_: PackageManager.NameNotFoundException) { + false + } + } private fun nanoClient(config: NanoConfig): GenerativeModel { if (config.releaseStage == null && config.preference == null) { @@ -109,7 +132,9 @@ class AdkAgentRunner( if (nanoModels.containsKey(config)) return val model = nanoClient(config) - when (val status = model.checkStatus()) { + val status = model.checkStatus() + nanoStatuses[config] = status + when (status) { FeatureStatus.UNAVAILABLE -> throw AdkErrors.AdkException( AdkErrors.MODEL_UNAVAILABLE, @@ -119,6 +144,7 @@ class AdkAgentRunner( } model.warmup() nanoModels[config] = model + nanoStatuses[config] = FeatureStatus.AVAILABLE } } @@ -165,6 +191,7 @@ class AdkAgentRunner( } catch (_: Exception) { return AdkModelInfo(availability = "unknown") } + nanoStatuses[config] = status return when (status) { FeatureStatus.UNAVAILABLE -> AdkModelInfo(availability = "unavailable") diff --git a/packages/adk/android/src/main/java/com/callstack/ai/adk/NativeAdkEngineModule.kt b/packages/adk/android/src/main/java/com/callstack/ai/adk/NativeAdkEngineModule.kt index 0348a5470..ab223b08a 100644 --- a/packages/adk/android/src/main/java/com/callstack/ai/adk/NativeAdkEngineModule.kt +++ b/packages/adk/android/src/main/java/com/callstack/ai/adk/NativeAdkEngineModule.kt @@ -44,6 +44,9 @@ class NativeAdkEngineModule(reactContext: ReactApplicationContext) : reject(AdkErrors.codeFor(error), error.message ?: "Unknown ADK error", error) } + override fun isAvailable(nano: ReadableMap?): Boolean = + runner.isNanoAvailable(NanoConfig.from(nano)) + override fun getModelInfo(nano: ReadableMap?, promise: Promise) { scope.launch { try { diff --git a/packages/adk/src/NativeAdkEngine.ts b/packages/adk/src/NativeAdkEngine.ts index 62249194b..816313ad2 100644 --- a/packages/adk/src/NativeAdkEngine.ts +++ b/packages/adk/src/NativeAdkEngine.ts @@ -89,6 +89,8 @@ export interface NanoDownloadProgressEvent { } export interface Spec extends TurboModule { + /** Quick synchronous check, see `AdkProvider.isAvailable` */ + isAvailable(nano?: AdkNanoModelConfig): boolean getModelInfo(nano?: AdkNanoModelConfig): Promise prepareNano(nano?: AdkNanoModelConfig): Promise countTokens(text: string, nano?: AdkNanoModelConfig): Promise diff --git a/packages/adk/src/__tests__/ai-sdk.test.ts b/packages/adk/src/__tests__/ai-sdk.test.ts index 761031c69..04997291f 100644 --- a/packages/adk/src/__tests__/ai-sdk.test.ts +++ b/packages/adk/src/__tests__/ai-sdk.test.ts @@ -46,6 +46,7 @@ const streamText = mock( ) const prepareNano = mock(async (_nano?: unknown) => {}) const cancelStream = mock(async (_id: string) => {}) +const isAvailable = mock((_nano?: unknown) => true) const getModelInfo = mock(async (_nano?: unknown) => ({ availability: 'downloadable', })) @@ -59,6 +60,7 @@ mock.module('react-native', () => ({ prepareNano, cancelStream, getModelInfo, + isAvailable, onStreamUpdate, onStreamComplete, onStreamError, @@ -145,14 +147,14 @@ describe('provider', () => { expect(getModelInfo.mock.calls.at(-1)![0]).toEqual({ preference: 'fast' }) }) - test('derives isAvailable from the model info', async () => { - const provider = createAdkProvider() - expect(await provider.isAvailable()).toBe(true) + test('checks availability synchronously', () => { + const provider = createAdkProvider({ nano: { preference: 'fast' } }) - getModelInfo.mockImplementationOnce(async () => ({ - availability: 'downloading', - })) - expect(await provider.isAvailable()).toBe(false) + expect(provider.isAvailable()).toBe(true) + expect(isAvailable.mock.calls.at(-1)).toEqual([{ preference: 'fast' }]) + + isAvailable.mockImplementationOnce(() => false) + expect(provider().isAvailable()).toBe(false) }) }) diff --git a/packages/adk/src/ai-sdk.ts b/packages/adk/src/ai-sdk.ts index 49c5a9287..1a2b3a003 100644 --- a/packages/adk/src/ai-sdk.ts +++ b/packages/adk/src/ai-sdk.ts @@ -69,6 +69,8 @@ export interface AdkPrepareOptions { } export interface AdkLanguageModel extends LanguageModelV4 { + /** Quick synchronous check, see `AdkProvider.isAvailable` */ + isAvailable: () => boolean /** Downloads Gemini Nano when needed and loads it, reporting download progress */ prepare: (options?: AdkPrepareOptions) => Promise /** Counts tokens with the Gemini Nano tokenizer */ @@ -79,8 +81,12 @@ export interface AdkProvider { (options?: AdkLanguageModelOptions): AdkLanguageModel readonly specificationVersion: 'v4' languageModel: (options?: AdkLanguageModelOptions) => AdkLanguageModel - /** Whether Gemini Nano can be used now: it is `available` or `downloadable` */ - isAvailable: () => Promise + /** + * Quick synchronous check whether Gemini Nano can be used. It reflects the + * last status `getModelInfo()` or `prepare()` saw, or else whether AICore is + * installed. Use `getModelInfo()` for the exact availability + */ + isAvailable: () => boolean /** Gemini Nano's availability, for the provider's model selection or `nano` */ getModelInfo: (options?: { nano?: AdkNanoModelConfig @@ -114,6 +120,10 @@ const listenForDownloadProgress = ( ) : null +function isAvailable(nano: AdkNanoModelConfig | undefined) { + return Platform.OS === 'android' && getNativeAdkEngine().isAvailable(nano) +} + async function getModelInfo( nano: AdkNanoModelConfig | undefined ): Promise { @@ -144,10 +154,7 @@ export function createAdkProvider( } provider.specificationVersion = 'v4' as const provider.languageModel = createLanguageModel - provider.isAvailable = async () => { - const { availability } = await getModelInfo(defaults.nano) - return availability === 'available' || availability === 'downloadable' - } + provider.isAvailable = () => isAvailable(defaults.nano) provider.getModelInfo = (options: { nano?: AdkNanoModelConfig } = {}) => getModelInfo(options.nano ?? defaults.nano) return provider @@ -317,6 +324,10 @@ class AdkChatLanguageModel implements AdkLanguageModel { } } + isAvailable(): boolean { + return isAvailable(this.agentConfig.nano) + } + async prepare(options: AdkPrepareOptions = {}): Promise { const listener = listenForDownloadProgress(options.onProgress) try { From 7860e34cfe14c4dffbeaef8281ec420dbcae0176 Mon Sep 17 00:00:00 2001 From: Mike Grabowski Date: Thu, 29 Oct 2026 22:55:20 +0100 Subject: [PATCH 2/3] docs(adk): document the synchronous isAvailable Co-Authored-By: Claude Opus 5.5 --- .../content/docs/docs/adk/getting-started.mdx | 2 +- website/src/content/docs/docs/adk/models.md | 18 +++++++++++++++--- 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/website/src/content/docs/docs/adk/getting-started.mdx b/website/src/content/docs/docs/adk/getting-started.mdx index ffc2b0166..53266cd42 100644 --- a/website/src/content/docs/docs/adk/getting-started.mdx +++ b/website/src/content/docs/docs/adk/getting-started.mdx @@ -76,7 +76,7 @@ Pass `adk()` to the AI SDK. Check that Gemini Nano can run on the device first: import { adk } from '@react-native-ai/adk' import { generateText } from 'ai' -if (await adk.isAvailable()) { +if (adk.isAvailable()) { const { text } = await generateText({ model: adk(), prompt: 'Summarize on-device AI in one sentence.', diff --git a/website/src/content/docs/docs/adk/models.md b/website/src/content/docs/docs/adk/models.md index 8bda3f547..27bb2bce1 100644 --- a/website/src/content/docs/docs/adk/models.md +++ b/website/src/content/docs/docs/adk/models.md @@ -35,9 +35,21 @@ switch (info.availability) { When Gemini Nano is `available`, `getModelInfo()` also returns `baseModelName` and `contextSize`, its input token limit. -`adk.isAvailable()` is the yes/no version: it's `true` when Gemini Nano is -`available` or `downloadable`. Both are cheap, never download anything, and are -safe to call at startup and again when the app resumes. See the +`adk.isAvailable()` and `model.isAvailable()` are the yes/no version. Like +`apple.isAvailable()`, they return a boolean synchronously, so UI code can call +them directly: + +```typescript +if (adk.isAvailable()) { + // Show Gemini Nano in the model picker +} +``` + +ML Kit only reports Gemini Nano's status asynchronously, so the synchronous +check uses the last status `getModelInfo()` or `prepare()` saw, or else whether +AICore is installed. Call `getModelInfo()` for the exact state, such as whether +Gemini Nano still needs a download. Neither call downloads anything, and both +are safe at startup and again when the app resumes. See the [ML Kit GenAI documentation](https://developers.google.com/ml-kit/genai#feature-device) for the supported devices. From 66d1683d80e67743e75d5dcc1f51dd4a68433632 Mon Sep 17 00:00:00 2001 From: Mike Grabowski Date: Thu, 29 Oct 2026 22:55:22 +0100 Subject: [PATCH 3/3] chore(adk): check the synchronous isAvailable on device Co-Authored-By: Claude Opus 5.5 --- harness/adk/availability.harness.ts | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) diff --git a/harness/adk/availability.harness.ts b/harness/adk/availability.harness.ts index b8028d375..2cbaefe36 100644 --- a/harness/adk/availability.harness.ts +++ b/harness/adk/availability.harness.ts @@ -18,7 +18,12 @@ describe('adk availability', () => { const info = await adk.getModelInfo() expect(info.availability).toBe('available') expect(info.contextSize).toBeGreaterThan(0) - expect(await adk.isAvailable()).toBe(true) + expect(adk.isAvailable()).toBe(true) + }) + + it('checks availability synchronously', () => { + expect(typeof adk.isAvailable()).toBe('boolean') + expect(adk().isAvailable()).toBe(adk.isAvailable()) }) it('counts tokens with the Gemini Nano tokenizer', async () => {