expo-ai-kit 0.1.21 → 0.2.0

package/README.md

@@ -1138,7 +1138,7 @@ const { text } = await sendMessage(messages, { systemPrompt: '...' });
 | Web/generic fallback | Idea | Medium |
 | Configurable hyperparameters (temperature, etc.) | Idea | Low |
 
-Have a feature request? [Open an issue](https://github.com/laraelmas/expo-ai-kit/issues)!
+Have a feature request? [Open an issue](https://github.com/saidkaban/expo-ai-kit/issues)!
 
 ## License
 
@@ -1152,6 +1152,6 @@ Contributions are welcome! Please refer to guidelines described in the [contribu
 
 - [Documentation](https://expo-ai-kit.com)
 - [npm package](https://www.npmjs.com/package/expo-ai-kit)
-- [GitHub repository](https://github.com/laraelmas/expo-ai-kit)
+- [GitHub repository](https://github.com/saidkaban/expo-ai-kit)
 - [Apple Foundation Models](https://developer.apple.com/documentation/foundationmodels)
 - [Google ML Kit Prompt API](https://developers.google.com/ml-kit/genai)

package/build/ExpoAiKitModule.d.ts

@@ -1,13 +1,22 @@
 import type { EventSubscription } from 'expo-modules-core';
-import { LLMMessage, LLMResponse, LLMStreamEvent } from './types';
+import { LLMMessage, LLMResponse, LLMStreamEvent, BuiltInModel, DownloadableModelStatus, ModelDownloadProgressEvent, ModelStateChangeEvent } from './types';
 export type ExpoAiKitModuleEvents = {
     onStreamToken: (event: LLMStreamEvent) => void;
+    onDownloadProgress: (event: ModelDownloadProgressEvent) => void;
+    onModelStateChange: (event: ModelStateChangeEvent) => void;
 };
 export interface ExpoAiKitNativeModule {
     isAvailable(): boolean;
     sendMessage(messages: LLMMessage[], systemPrompt: string): Promise<LLMResponse>;
     startStreaming(messages: LLMMessage[], systemPrompt: string, sessionId: string): Promise<void>;
     stopStreaming(sessionId: string): Promise<void>;
+    getBuiltInModels(): BuiltInModel[];
+    getDownloadableModelStatus(modelId: string): DownloadableModelStatus;
+    setModel(modelId: string): Promise<void>;
+    getActiveModel(): string;
+    unloadModel(): Promise<void>;
+    downloadModel(modelId: string, url: string, sha256: string): Promise<void>;
+    deleteModel(modelId: string): Promise<void>;
     addListener<K extends keyof ExpoAiKitModuleEvents>(eventName: K, listener: ExpoAiKitModuleEvents[K]): EventSubscription;
 }
 declare const ExpoAiKitModule: ExpoAiKitNativeModule;

package/build/ExpoAiKitModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoAiKitModule.d.ts","sourceRoot":"","sources":["../src/ExpoAiKitModule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,MAAM,WAAW,qBAAqB;IACpC,WAAW,IAAI,OAAO,CAAC;IACvB,WAAW,CACT,QAAQ,EAAE,UAAU,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,cAAc,CACZ,QAAQ,EAAE,UAAU,EAAE,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,WAAW,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAC/C,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,iBAAiB,CAAC;CACtB;AAED,QAAA,MAAM,eAAe,uBACoC,CAAC;AAE1D,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ExpoAiKitModule.d.ts","sourceRoot":"","sources":["../src/ExpoAiKitModule.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,YAAY,EACZ,uBAAuB,EACvB,0BAA0B,EAC1B,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/C,kBAAkB,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAChE,kBAAkB,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;CAC5D,CAAC;AAEF,MAAM,WAAW,qBAAqB;IAEpC,WAAW,IAAI,OAAO,CAAC;IACvB,WAAW,CACT,QAAQ,EAAE,UAAU,EAAE,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,CAAC;IACxB,cAAc,CACZ,QAAQ,EAAE,UAAU,EAAE,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGhD,gBAAgB,IAAI,YAAY,EAAE,CAAC;IACnC,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAAC;IAKrE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,cAAc,IAAI,MAAM,CAAC;IAGzB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7B,aAAa,CACX,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG5C,WAAW,CAAC,CAAC,SAAS,MAAM,qBAAqB,EAC/C,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,qBAAqB,CAAC,CAAC,CAAC,GACjC,iBAAiB,CAAC;CACtB;AAED,QAAA,MAAM,eAAe,uBACoC,CAAC;AAE1D,eAAe,eAAe,CAAC"}

package/build/ExpoAiKitModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoAiKitModule.js","sourceRoot":"","sources":["../src/ExpoAiKitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA0BxD,MAAM,eAAe,GACnB,mBAAmB,CAAwB,WAAW,CAAC,CAAC;AAE1D,eAAe,eAAe,CAAC","sourcesContent":["import { requireNativeModule } from 'expo-modules-core';\nimport type { EventSubscription } from 'expo-modules-core';\nimport { LLMMessage, LLMResponse, LLMStreamEvent } from './types';\n\nexport type ExpoAiKitModuleEvents = {\n  onStreamToken: (event: LLMStreamEvent) => void;\n};\n\nexport interface ExpoAiKitNativeModule {\n  isAvailable(): boolean;\n  sendMessage(\n    messages: LLMMessage[],\n    systemPrompt: string\n  ): Promise<LLMResponse>;\n  startStreaming(\n    messages: LLMMessage[],\n    systemPrompt: string,\n    sessionId: string\n  ): Promise<void>;\n  stopStreaming(sessionId: string): Promise<void>;\n  addListener<K extends keyof ExpoAiKitModuleEvents>(\n    eventName: K,\n    listener: ExpoAiKitModuleEvents[K]\n  ): EventSubscription;\n}\n\nconst ExpoAiKitModule =\n  requireNativeModule<ExpoAiKitNativeModule>('ExpoAiKit');\n\nexport default ExpoAiKitModule;\n"]}
+{"version":3,"file":"ExpoAiKitModule.js","sourceRoot":"","sources":["../src/ExpoAiKitModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AA4DxD,MAAM,eAAe,GACnB,mBAAmB,CAAwB,WAAW,CAAC,CAAC;AAE1D,eAAe,eAAe,CAAC","sourcesContent":["import { requireNativeModule } from 'expo-modules-core';\nimport type { EventSubscription } from 'expo-modules-core';\nimport {\n  LLMMessage,\n  LLMResponse,\n  LLMStreamEvent,\n  BuiltInModel,\n  DownloadableModelStatus,\n  ModelDownloadProgressEvent,\n  ModelStateChangeEvent,\n} from './types';\n\nexport type ExpoAiKitModuleEvents = {\n  onStreamToken: (event: LLMStreamEvent) => void;\n  onDownloadProgress: (event: ModelDownloadProgressEvent) => void;\n  onModelStateChange: (event: ModelStateChangeEvent) => void;\n};\n\nexport interface ExpoAiKitNativeModule {\n  // Existing inference API\n  isAvailable(): boolean;\n  sendMessage(\n    messages: LLMMessage[],\n    systemPrompt: string\n  ): Promise<LLMResponse>;\n  startStreaming(\n    messages: LLMMessage[],\n    systemPrompt: string,\n    sessionId: string\n  ): Promise<void>;\n  stopStreaming(sessionId: string): Promise<void>;\n\n  // Model discovery\n  getBuiltInModels(): BuiltInModel[];\n  getDownloadableModelStatus(modelId: string): DownloadableModelStatus;\n\n  // Model selection & memory management\n  // setModel is async: switching to a downloadable model loads it into memory.\n  // Auto-unloads the previous downloadable model (only one loaded at a time).\n  setModel(modelId: string): Promise<void>;\n  getActiveModel(): string;\n  // Explicitly free memory from the loaded downloadable model.\n  // Reverts to the platform built-in model.\n  unloadModel(): Promise<void>;\n\n  // Model lifecycle (downloadable models only)\n  downloadModel(\n    modelId: string,\n    url: string,\n    sha256: string\n  ): Promise<void>;\n  deleteModel(modelId: string): Promise<void>;\n\n  // Event subscription\n  addListener<K extends keyof ExpoAiKitModuleEvents>(\n    eventName: K,\n    listener: ExpoAiKitModuleEvents[K]\n  ): EventSubscription;\n}\n\nconst ExpoAiKitModule =\n  requireNativeModule<ExpoAiKitNativeModule>('ExpoAiKit');\n\nexport default ExpoAiKitModule;\n"]}

package/build/hooks.d.ts

@@ -1,4 +1,4 @@
-import type { UseChatOptions, UseChatReturn, UseCompletionOptions, UseCompletionReturn, UseOnDeviceAIReturn } from './types';
+import type { UseChatOptions, UseChatReturn, UseCompletionOptions, UseCompletionReturn, UseOnDeviceAIReturn, BuiltInModel, DownloadableModel, DownloadableModelStatus, ModelError } from './types';
 /**
  * React hook to check if on-device AI is available.
  *
@@ -85,4 +85,63 @@ export declare function useChat(options?: UseChatOptions): UseChatReturn;
  * ```
  */
 export declare function useCompletion(options?: UseCompletionOptions): UseCompletionReturn;
+/**
+ * React hook for managing a downloadable model's lifecycle.
+ *
+ * Tracks download status, progress, and provides download/delete controls.
+ *
+ * @param modelId - The downloadable model ID (e.g. 'gemma-e2b')
+ * @returns Model status, progress, and control functions
+ *
+ * @example
+ * ```tsx
+ * function ModelManager() {
+ *   const { status, progress, download, delete: remove, error } = useModel('gemma-e2b');
+ *
+ *   if (status === 'not-downloaded') {
+ *     return <Button title="Download" onPress={download} />;
+ *   }
+ *   if (status === 'downloading') {
+ *     return <Text>Downloading: {Math.round(progress * 100)}%</Text>;
+ *   }
+ *   if (status === 'loading') {
+ *     return <Text>Loading model...</Text>;
+ *   }
+ *   return <Text>Model ready!</Text>;
+ * }
+ * ```
+ */
+export declare function useModel(modelId: string): {
+    status: DownloadableModelStatus;
+    progress: number;
+    download: () => Promise<void>;
+    delete: () => Promise<void>;
+    error: ModelError | null;
+};
+/**
+ * React hook to discover all available models (built-in and downloadable).
+ *
+ * @returns Built-in models, downloadable models, and loading state
+ *
+ * @example
+ * ```tsx
+ * function ModelPicker() {
+ *   const { builtIn, downloadable, isLoading } = useAvailableModels();
+ *
+ *   if (isLoading) return <Text>Loading models...</Text>;
+ *
+ *   return (
+ *     <View>
+ *       <Text>Built-in: {builtIn.map(m => m.name).join(', ')}</Text>
+ *       <Text>Downloadable: {downloadable.map(m => m.name).join(', ')}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAvailableModels(): {
+    builtIn: BuiltInModel[];
+    downloadable: DownloadableModel[];
+    isLoading: boolean;
+};
 //# sourceMappingURL=hooks.d.ts.map

package/build/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAmBjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAwBnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CA8GnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAgFrF"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,UAAU,EACX,MAAM,SAAS,CAAC;AAmBjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CAwBnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,aAAa,CA8GnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,mBAAmB,CAgFrF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG;IACzC,MAAM,EAAE,uBAAuB,CAAC;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B,CA0EA;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,IAAI;IACpC,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;CACpB,CAwBA"}

package/build/hooks.js

@@ -1,6 +1,7 @@
 import { useState, useEffect, useRef, useCallback } from 'react';
-import { isAvailable, streamMessage } from './index';
+import { isAvailable, streamMessage, getBuiltInModels as getBuiltInModelsApi, getDownloadableModels as getDownloadableModelsApi, downloadModel as downloadModelApi, deleteModel as deleteModelApi, } from './index';
 import { ChatMemoryManager } from './memory';
+import ExpoAiKitModule from './ExpoAiKitModule';
 // Cache availability result across all hook instances
 let availabilityCache = null;
 let availabilityPromise = null;
@@ -290,4 +291,136 @@ export function useCompletion(options = {}) {
         error,
     };
 }
+/**
+ * React hook for managing a downloadable model's lifecycle.
+ *
+ * Tracks download status, progress, and provides download/delete controls.
+ *
+ * @param modelId - The downloadable model ID (e.g. 'gemma-e2b')
+ * @returns Model status, progress, and control functions
+ *
+ * @example
+ * ```tsx
+ * function ModelManager() {
+ *   const { status, progress, download, delete: remove, error } = useModel('gemma-e2b');
+ *
+ *   if (status === 'not-downloaded') {
+ *     return <Button title="Download" onPress={download} />;
+ *   }
+ *   if (status === 'downloading') {
+ *     return <Text>Downloading: {Math.round(progress * 100)}%</Text>;
+ *   }
+ *   if (status === 'loading') {
+ *     return <Text>Loading model...</Text>;
+ *   }
+ *   return <Text>Model ready!</Text>;
+ * }
+ * ```
+ */
+export function useModel(modelId) {
+    const [status, setStatus] = useState('not-downloaded');
+    const [progress, setProgress] = useState(0);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        // Query initial status
+        try {
+            const initialStatus = ExpoAiKitModule.getDownloadableModelStatus(modelId);
+            setStatus(initialStatus);
+        }
+        catch {
+            // Model not found or native module not ready
+        }
+        // Listen for state changes
+        const stateSubscription = ExpoAiKitModule.addListener('onModelStateChange', (event) => {
+            if (event.modelId === modelId && mountedRef.current) {
+                setStatus(event.status);
+            }
+        });
+        // Listen for download progress
+        const progressSubscription = ExpoAiKitModule.addListener('onDownloadProgress', (event) => {
+            if (event.modelId === modelId && mountedRef.current) {
+                setProgress(event.progress);
+            }
+        });
+        return () => {
+            mountedRef.current = false;
+            stateSubscription.remove();
+            progressSubscription.remove();
+        };
+    }, [modelId]);
+    const download = useCallback(async () => {
+        setError(null);
+        setProgress(0);
+        try {
+            await downloadModelApi(modelId, {
+                onProgress: (p) => {
+                    if (mountedRef.current)
+                        setProgress(p);
+                },
+            });
+        }
+        catch (err) {
+            if (mountedRef.current) {
+                setError(err);
+            }
+        }
+    }, [modelId]);
+    const del = useCallback(async () => {
+        setError(null);
+        try {
+            await deleteModelApi(modelId);
+            if (mountedRef.current) {
+                setStatus('not-downloaded');
+                setProgress(0);
+            }
+        }
+        catch (err) {
+            if (mountedRef.current) {
+                setError(err);
+            }
+        }
+    }, [modelId]);
+    return { status, progress, download, delete: del, error };
+}
+/**
+ * React hook to discover all available models (built-in and downloadable).
+ *
+ * @returns Built-in models, downloadable models, and loading state
+ *
+ * @example
+ * ```tsx
+ * function ModelPicker() {
+ *   const { builtIn, downloadable, isLoading } = useAvailableModels();
+ *
+ *   if (isLoading) return <Text>Loading models...</Text>;
+ *
+ *   return (
+ *     <View>
+ *       <Text>Built-in: {builtIn.map(m => m.name).join(', ')}</Text>
+ *       <Text>Downloadable: {downloadable.map(m => m.name).join(', ')}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ */
+export function useAvailableModels() {
+    const [builtIn, setBuiltIn] = useState([]);
+    const [downloadable, setDownloadable] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    useEffect(() => {
+        let mounted = true;
+        Promise.all([getBuiltInModelsApi(), getDownloadableModelsApi()]).then(([bi, dl]) => {
+            if (mounted) {
+                setBuiltIn(bi);
+                setDownloadable(dl);
+                setIsLoading(false);
+            }
+        });
+        return () => {
+            mounted = false;
+        };
+    }, []);
+    return { builtIn, downloadable, isLoading };
+}
 //# sourceMappingURL=hooks.js.map

package/build/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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","sourcesContent":["import { useState, useEffect, useRef, useCallback } from 'react';\nimport { isAvailable, streamMessage } from './index';\nimport { ChatMemoryManager } from './memory';\nimport type {\n  LLMMessage,\n  UseChatOptions,\n  UseChatReturn,\n  UseCompletionOptions,\n  UseCompletionReturn,\n  UseOnDeviceAIReturn,\n} from './types';\n\n// Cache availability result across all hook instances\nlet availabilityCache: boolean | null = null;\nlet availabilityPromise: Promise<boolean> | null = null;\n\nfunction checkAvailability(): Promise<boolean> {\n  if (availabilityCache !== null) {\n    return Promise.resolve(availabilityCache);\n  }\n  if (!availabilityPromise) {\n    availabilityPromise = isAvailable().then((result) => {\n      availabilityCache = result;\n      return result;\n    });\n  }\n  return availabilityPromise;\n}\n\n/**\n * React hook to check if on-device AI is available.\n *\n * Caches the result so multiple components don't re-check.\n *\n * @returns Object with isAvailable and isChecking states\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { isAvailable, isChecking } = useOnDeviceAI();\n *\n *   if (isChecking) return <Text>Checking AI availability...</Text>;\n *   if (!isAvailable) return <Text>On-device AI not available</Text>;\n *\n *   return <ChatComponent />;\n * }\n * ```\n */\nexport function useOnDeviceAI(): UseOnDeviceAIReturn {\n  const [available, setAvailable] = useState(availabilityCache ?? false);\n  const [checking, setChecking] = useState(availabilityCache === null);\n\n  useEffect(() => {\n    if (availabilityCache !== null) {\n      setAvailable(availabilityCache);\n      setChecking(false);\n      return;\n    }\n\n    let mounted = true;\n    checkAvailability().then((result) => {\n      if (mounted) {\n        setAvailable(result);\n        setChecking(false);\n      }\n    });\n    return () => {\n      mounted = false;\n    };\n  }, []);\n\n  return { isAvailable: available, isChecking: checking };\n}\n\n/**\n * React hook for building chat interfaces with on-device AI.\n *\n * Manages messages, input state, streaming, and conversation memory automatically.\n * Built on top of ChatMemoryManager and streamMessage.\n *\n * @param options - Configuration options for the chat\n * @returns Chat state and control functions\n *\n * @example\n * ```tsx\n * function ChatScreen() {\n *   const { messages, input, setInput, sendMessage, isStreaming, stop } = useChat({\n *     systemPrompt: 'You are a helpful assistant.',\n *   });\n *\n *   return (\n *     <View>\n *       <FlatList\n *         data={messages}\n *         renderItem={({ item }) => (\n *           <Text>{item.role}: {item.content}</Text>\n *         )}\n *       />\n *       <TextInput value={input} onChangeText={setInput} />\n *       {isStreaming ? (\n *         <Button title=\"Stop\" onPress={stop} />\n *       ) : (\n *         <Button title=\"Send\" onPress={() => sendMessage()} />\n *       )}\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useChat(options: UseChatOptions = {}): UseChatReturn {\n  const { systemPrompt, maxTurns, initialMessages, onFinish, onError } = options;\n\n  const memoryRef = useRef(new ChatMemoryManager({ maxTurns, systemPrompt }));\n\n  // Initialize with initial messages\n  const initializedRef = useRef(false);\n  if (!initializedRef.current && initialMessages) {\n    for (const msg of initialMessages) {\n      memoryRef.current.addMessage(msg);\n    }\n    initializedRef.current = true;\n  }\n\n  const [messages, setMessages] = useState<LLMMessage[]>(memoryRef.current.getMessages());\n  const [input, setInput] = useState('');\n  const [isStreaming, setIsStreaming] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const stopRef = useRef<(() => void) | null>(null);\n  const mountedRef = useRef(true);\n  const inputRef = useRef(input);\n  inputRef.current = input;\n  const streamingRef = useRef(isStreaming);\n  streamingRef.current = isStreaming;\n  const onFinishRef = useRef(onFinish);\n  onFinishRef.current = onFinish;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    return () => {\n      mountedRef.current = false;\n      stopRef.current?.();\n    };\n  }, []);\n\n  const send = useCallback(\n    async (text?: string) => {\n      const content = (text ?? inputRef.current).trim();\n      if (!content || streamingRef.current) return;\n\n      setError(null);\n\n      // Add user message\n      memoryRef.current.addUserMessage(content);\n      setMessages([...memoryRef.current.getMessages()]);\n      if (!text) setInput('');\n\n      setIsStreaming(true);\n\n      try {\n        const allMessages = memoryRef.current.getAllMessages();\n\n        // Use a temporary message for streaming display\n        let accumulatedText = '';\n        const { promise, stop } = streamMessage(allMessages, (event) => {\n          if (!mountedRef.current) return;\n          accumulatedText = event.accumulatedText;\n          // Update messages with streaming assistant response\n          const currentMessages = memoryRef.current.getMessages();\n          setMessages([\n            ...currentMessages,\n            { role: 'assistant' as const, content: accumulatedText },\n          ]);\n        });\n\n        stopRef.current = stop;\n        const response = await promise;\n\n        if (!mountedRef.current) return;\n\n        // Add the final assistant message to memory\n        memoryRef.current.addAssistantMessage(response.text);\n        setMessages([...memoryRef.current.getMessages()]);\n        onFinishRef.current?.(response);\n      } catch (err) {\n        if (!mountedRef.current) return;\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        onErrorRef.current?.(e);\n      } finally {\n        stopRef.current = null;\n        if (mountedRef.current) {\n          setIsStreaming(false);\n        }\n      }\n    },\n    []\n  );\n\n  const stop = useCallback(() => {\n    stopRef.current?.();\n  }, []);\n\n  const clear = useCallback(() => {\n    memoryRef.current.clear();\n    setMessages([]);\n    setError(null);\n  }, []);\n\n  return {\n    messages,\n    input,\n    setInput,\n    sendMessage: send,\n    isStreaming,\n    stop,\n    clear,\n    error,\n  };\n}\n\n/**\n * React hook for single-shot AI completions.\n *\n * Unlike useChat (which manages a conversation), useCompletion is for\n * one-off tasks like summarization, translation, or content generation.\n *\n * @param options - Configuration options\n * @returns Completion state and control functions\n *\n * @example\n * ```tsx\n * function SummarizerScreen() {\n *   const { completion, isLoading, complete, stop } = useCompletion({\n *     systemPrompt: 'You are a summarization assistant. Summarize the given text concisely.',\n *   });\n *\n *   return (\n *     <View>\n *       <Button\n *         title=\"Summarize\"\n *         onPress={() => complete('Long article text here...')}\n *       />\n *       {isLoading && <Button title=\"Stop\" onPress={stop} />}\n *       <Text>{completion}</Text>\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useCompletion(options: UseCompletionOptions = {}): UseCompletionReturn {\n  const { systemPrompt, onFinish, onError } = options;\n\n  const [completion, setCompletion] = useState('');\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const stopRef = useRef<(() => void) | null>(null);\n  const mountedRef = useRef(true);\n  const loadingRef = useRef(isLoading);\n  loadingRef.current = isLoading;\n  const completionRef = useRef(completion);\n  completionRef.current = completion;\n  const systemPromptRef = useRef(systemPrompt);\n  systemPromptRef.current = systemPrompt;\n  const onFinishRef = useRef(onFinish);\n  onFinishRef.current = onFinish;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    return () => {\n      mountedRef.current = false;\n      stopRef.current?.();\n    };\n  }, []);\n\n  const complete = useCallback(\n    async (prompt: string) => {\n      if (loadingRef.current) return completionRef.current;\n\n      setError(null);\n      setCompletion('');\n      setIsLoading(true);\n\n      try {\n        const messages: LLMMessage[] = [{ role: 'user', content: prompt }];\n        const { promise, stop } = streamMessage(\n          messages,\n          (event) => {\n            if (!mountedRef.current) return;\n            setCompletion(event.accumulatedText);\n          },\n          systemPromptRef.current ? { systemPrompt: systemPromptRef.current } : undefined\n        );\n\n        stopRef.current = stop;\n        const response = await promise;\n\n        if (!mountedRef.current) return '';\n\n        setCompletion(response.text);\n        onFinishRef.current?.(response);\n        return response.text;\n      } catch (err) {\n        if (!mountedRef.current) return '';\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        onErrorRef.current?.(e);\n        return '';\n      } finally {\n        stopRef.current = null;\n        if (mountedRef.current) {\n          setIsLoading(false);\n        }\n      }\n    },\n    []\n  );\n\n  const stop = useCallback(() => {\n    stopRef.current?.();\n  }, []);\n\n  return {\n    completion,\n    isLoading,\n    complete,\n    stop,\n    error,\n  };\n}\n"]}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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","sourcesContent":["import { useState, useEffect, useRef, useCallback } from 'react';\nimport {\n  isAvailable,\n  streamMessage,\n  getBuiltInModels as getBuiltInModelsApi,\n  getDownloadableModels as getDownloadableModelsApi,\n  downloadModel as downloadModelApi,\n  deleteModel as deleteModelApi,\n} from './index';\nimport { ChatMemoryManager } from './memory';\nimport ExpoAiKitModule from './ExpoAiKitModule';\nimport type {\n  LLMMessage,\n  UseChatOptions,\n  UseChatReturn,\n  UseCompletionOptions,\n  UseCompletionReturn,\n  UseOnDeviceAIReturn,\n  BuiltInModel,\n  DownloadableModel,\n  DownloadableModelStatus,\n  ModelError,\n} from './types';\n\n// Cache availability result across all hook instances\nlet availabilityCache: boolean | null = null;\nlet availabilityPromise: Promise<boolean> | null = null;\n\nfunction checkAvailability(): Promise<boolean> {\n  if (availabilityCache !== null) {\n    return Promise.resolve(availabilityCache);\n  }\n  if (!availabilityPromise) {\n    availabilityPromise = isAvailable().then((result) => {\n      availabilityCache = result;\n      return result;\n    });\n  }\n  return availabilityPromise;\n}\n\n/**\n * React hook to check if on-device AI is available.\n *\n * Caches the result so multiple components don't re-check.\n *\n * @returns Object with isAvailable and isChecking states\n *\n * @example\n * ```tsx\n * function MyComponent() {\n *   const { isAvailable, isChecking } = useOnDeviceAI();\n *\n *   if (isChecking) return <Text>Checking AI availability...</Text>;\n *   if (!isAvailable) return <Text>On-device AI not available</Text>;\n *\n *   return <ChatComponent />;\n * }\n * ```\n */\nexport function useOnDeviceAI(): UseOnDeviceAIReturn {\n  const [available, setAvailable] = useState(availabilityCache ?? false);\n  const [checking, setChecking] = useState(availabilityCache === null);\n\n  useEffect(() => {\n    if (availabilityCache !== null) {\n      setAvailable(availabilityCache);\n      setChecking(false);\n      return;\n    }\n\n    let mounted = true;\n    checkAvailability().then((result) => {\n      if (mounted) {\n        setAvailable(result);\n        setChecking(false);\n      }\n    });\n    return () => {\n      mounted = false;\n    };\n  }, []);\n\n  return { isAvailable: available, isChecking: checking };\n}\n\n/**\n * React hook for building chat interfaces with on-device AI.\n *\n * Manages messages, input state, streaming, and conversation memory automatically.\n * Built on top of ChatMemoryManager and streamMessage.\n *\n * @param options - Configuration options for the chat\n * @returns Chat state and control functions\n *\n * @example\n * ```tsx\n * function ChatScreen() {\n *   const { messages, input, setInput, sendMessage, isStreaming, stop } = useChat({\n *     systemPrompt: 'You are a helpful assistant.',\n *   });\n *\n *   return (\n *     <View>\n *       <FlatList\n *         data={messages}\n *         renderItem={({ item }) => (\n *           <Text>{item.role}: {item.content}</Text>\n *         )}\n *       />\n *       <TextInput value={input} onChangeText={setInput} />\n *       {isStreaming ? (\n *         <Button title=\"Stop\" onPress={stop} />\n *       ) : (\n *         <Button title=\"Send\" onPress={() => sendMessage()} />\n *       )}\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useChat(options: UseChatOptions = {}): UseChatReturn {\n  const { systemPrompt, maxTurns, initialMessages, onFinish, onError } = options;\n\n  const memoryRef = useRef(new ChatMemoryManager({ maxTurns, systemPrompt }));\n\n  // Initialize with initial messages\n  const initializedRef = useRef(false);\n  if (!initializedRef.current && initialMessages) {\n    for (const msg of initialMessages) {\n      memoryRef.current.addMessage(msg);\n    }\n    initializedRef.current = true;\n  }\n\n  const [messages, setMessages] = useState<LLMMessage[]>(memoryRef.current.getMessages());\n  const [input, setInput] = useState('');\n  const [isStreaming, setIsStreaming] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const stopRef = useRef<(() => void) | null>(null);\n  const mountedRef = useRef(true);\n  const inputRef = useRef(input);\n  inputRef.current = input;\n  const streamingRef = useRef(isStreaming);\n  streamingRef.current = isStreaming;\n  const onFinishRef = useRef(onFinish);\n  onFinishRef.current = onFinish;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    return () => {\n      mountedRef.current = false;\n      stopRef.current?.();\n    };\n  }, []);\n\n  const send = useCallback(\n    async (text?: string) => {\n      const content = (text ?? inputRef.current).trim();\n      if (!content || streamingRef.current) return;\n\n      setError(null);\n\n      // Add user message\n      memoryRef.current.addUserMessage(content);\n      setMessages([...memoryRef.current.getMessages()]);\n      if (!text) setInput('');\n\n      setIsStreaming(true);\n\n      try {\n        const allMessages = memoryRef.current.getAllMessages();\n\n        // Use a temporary message for streaming display\n        let accumulatedText = '';\n        const { promise, stop } = streamMessage(allMessages, (event) => {\n          if (!mountedRef.current) return;\n          accumulatedText = event.accumulatedText;\n          // Update messages with streaming assistant response\n          const currentMessages = memoryRef.current.getMessages();\n          setMessages([\n            ...currentMessages,\n            { role: 'assistant' as const, content: accumulatedText },\n          ]);\n        });\n\n        stopRef.current = stop;\n        const response = await promise;\n\n        if (!mountedRef.current) return;\n\n        // Add the final assistant message to memory\n        memoryRef.current.addAssistantMessage(response.text);\n        setMessages([...memoryRef.current.getMessages()]);\n        onFinishRef.current?.(response);\n      } catch (err) {\n        if (!mountedRef.current) return;\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        onErrorRef.current?.(e);\n      } finally {\n        stopRef.current = null;\n        if (mountedRef.current) {\n          setIsStreaming(false);\n        }\n      }\n    },\n    []\n  );\n\n  const stop = useCallback(() => {\n    stopRef.current?.();\n  }, []);\n\n  const clear = useCallback(() => {\n    memoryRef.current.clear();\n    setMessages([]);\n    setError(null);\n  }, []);\n\n  return {\n    messages,\n    input,\n    setInput,\n    sendMessage: send,\n    isStreaming,\n    stop,\n    clear,\n    error,\n  };\n}\n\n/**\n * React hook for single-shot AI completions.\n *\n * Unlike useChat (which manages a conversation), useCompletion is for\n * one-off tasks like summarization, translation, or content generation.\n *\n * @param options - Configuration options\n * @returns Completion state and control functions\n *\n * @example\n * ```tsx\n * function SummarizerScreen() {\n *   const { completion, isLoading, complete, stop } = useCompletion({\n *     systemPrompt: 'You are a summarization assistant. Summarize the given text concisely.',\n *   });\n *\n *   return (\n *     <View>\n *       <Button\n *         title=\"Summarize\"\n *         onPress={() => complete('Long article text here...')}\n *       />\n *       {isLoading && <Button title=\"Stop\" onPress={stop} />}\n *       <Text>{completion}</Text>\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useCompletion(options: UseCompletionOptions = {}): UseCompletionReturn {\n  const { systemPrompt, onFinish, onError } = options;\n\n  const [completion, setCompletion] = useState('');\n  const [isLoading, setIsLoading] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n  const stopRef = useRef<(() => void) | null>(null);\n  const mountedRef = useRef(true);\n  const loadingRef = useRef(isLoading);\n  loadingRef.current = isLoading;\n  const completionRef = useRef(completion);\n  completionRef.current = completion;\n  const systemPromptRef = useRef(systemPrompt);\n  systemPromptRef.current = systemPrompt;\n  const onFinishRef = useRef(onFinish);\n  onFinishRef.current = onFinish;\n  const onErrorRef = useRef(onError);\n  onErrorRef.current = onError;\n\n  useEffect(() => {\n    return () => {\n      mountedRef.current = false;\n      stopRef.current?.();\n    };\n  }, []);\n\n  const complete = useCallback(\n    async (prompt: string) => {\n      if (loadingRef.current) return completionRef.current;\n\n      setError(null);\n      setCompletion('');\n      setIsLoading(true);\n\n      try {\n        const messages: LLMMessage[] = [{ role: 'user', content: prompt }];\n        const { promise, stop } = streamMessage(\n          messages,\n          (event) => {\n            if (!mountedRef.current) return;\n            setCompletion(event.accumulatedText);\n          },\n          systemPromptRef.current ? { systemPrompt: systemPromptRef.current } : undefined\n        );\n\n        stopRef.current = stop;\n        const response = await promise;\n\n        if (!mountedRef.current) return '';\n\n        setCompletion(response.text);\n        onFinishRef.current?.(response);\n        return response.text;\n      } catch (err) {\n        if (!mountedRef.current) return '';\n        const e = err instanceof Error ? err : new Error(String(err));\n        setError(e);\n        onErrorRef.current?.(e);\n        return '';\n      } finally {\n        stopRef.current = null;\n        if (mountedRef.current) {\n          setIsLoading(false);\n        }\n      }\n    },\n    []\n  );\n\n  const stop = useCallback(() => {\n    stopRef.current?.();\n  }, []);\n\n  return {\n    completion,\n    isLoading,\n    complete,\n    stop,\n    error,\n  };\n}\n\n/**\n * React hook for managing a downloadable model's lifecycle.\n *\n * Tracks download status, progress, and provides download/delete controls.\n *\n * @param modelId - The downloadable model ID (e.g. 'gemma-e2b')\n * @returns Model status, progress, and control functions\n *\n * @example\n * ```tsx\n * function ModelManager() {\n *   const { status, progress, download, delete: remove, error } = useModel('gemma-e2b');\n *\n *   if (status === 'not-downloaded') {\n *     return <Button title=\"Download\" onPress={download} />;\n *   }\n *   if (status === 'downloading') {\n *     return <Text>Downloading: {Math.round(progress * 100)}%</Text>;\n *   }\n *   if (status === 'loading') {\n *     return <Text>Loading model...</Text>;\n *   }\n *   return <Text>Model ready!</Text>;\n * }\n * ```\n */\nexport function useModel(modelId: string): {\n  status: DownloadableModelStatus;\n  progress: number;\n  download: () => Promise<void>;\n  delete: () => Promise<void>;\n  error: ModelError | null;\n} {\n  const [status, setStatus] = useState<DownloadableModelStatus>('not-downloaded');\n  const [progress, setProgress] = useState(0);\n  const [error, setError] = useState<ModelError | null>(null);\n  const mountedRef = useRef(true);\n\n  useEffect(() => {\n    // Query initial status\n    try {\n      const initialStatus = ExpoAiKitModule.getDownloadableModelStatus(modelId);\n      setStatus(initialStatus);\n    } catch {\n      // Model not found or native module not ready\n    }\n\n    // Listen for state changes\n    const stateSubscription = ExpoAiKitModule.addListener(\n      'onModelStateChange',\n      (event) => {\n        if (event.modelId === modelId && mountedRef.current) {\n          setStatus(event.status);\n        }\n      }\n    );\n\n    // Listen for download progress\n    const progressSubscription = ExpoAiKitModule.addListener(\n      'onDownloadProgress',\n      (event) => {\n        if (event.modelId === modelId && mountedRef.current) {\n          setProgress(event.progress);\n        }\n      }\n    );\n\n    return () => {\n      mountedRef.current = false;\n      stateSubscription.remove();\n      progressSubscription.remove();\n    };\n  }, [modelId]);\n\n  const download = useCallback(async () => {\n    setError(null);\n    setProgress(0);\n    try {\n      await downloadModelApi(modelId, {\n        onProgress: (p) => {\n          if (mountedRef.current) setProgress(p);\n        },\n      });\n    } catch (err) {\n      if (mountedRef.current) {\n        setError(err as ModelError);\n      }\n    }\n  }, [modelId]);\n\n  const del = useCallback(async () => {\n    setError(null);\n    try {\n      await deleteModelApi(modelId);\n      if (mountedRef.current) {\n        setStatus('not-downloaded');\n        setProgress(0);\n      }\n    } catch (err) {\n      if (mountedRef.current) {\n        setError(err as ModelError);\n      }\n    }\n  }, [modelId]);\n\n  return { status, progress, download, delete: del, error };\n}\n\n/**\n * React hook to discover all available models (built-in and downloadable).\n *\n * @returns Built-in models, downloadable models, and loading state\n *\n * @example\n * ```tsx\n * function ModelPicker() {\n *   const { builtIn, downloadable, isLoading } = useAvailableModels();\n *\n *   if (isLoading) return <Text>Loading models...</Text>;\n *\n *   return (\n *     <View>\n *       <Text>Built-in: {builtIn.map(m => m.name).join(', ')}</Text>\n *       <Text>Downloadable: {downloadable.map(m => m.name).join(', ')}</Text>\n *     </View>\n *   );\n * }\n * ```\n */\nexport function useAvailableModels(): {\n  builtIn: BuiltInModel[];\n  downloadable: DownloadableModel[];\n  isLoading: boolean;\n} {\n  const [builtIn, setBuiltIn] = useState<BuiltInModel[]>([]);\n  const [downloadable, setDownloadable] = useState<DownloadableModel[]>([]);\n  const [isLoading, setIsLoading] = useState(true);\n\n  useEffect(() => {\n    let mounted = true;\n\n    Promise.all([getBuiltInModelsApi(), getDownloadableModelsApi()]).then(\n      ([bi, dl]) => {\n        if (mounted) {\n          setBuiltIn(bi);\n          setDownloadable(dl);\n          setIsLoading(false);\n        }\n      }\n    );\n\n    return () => {\n      mounted = false;\n    };\n  }, []);\n\n  return { builtIn, downloadable, isLoading };\n}\n"]}

package/build/index.d.ts

@@ -1,7 +1,8 @@
-import { LLMMessage, LLMSendOptions, LLMResponse, LLMStreamOptions, LLMStreamCallback, LLMSummarizeOptions, LLMTranslateOptions, LLMRewriteOptions, LLMExtractKeyPointsOptions, LLMAnswerQuestionOptions, LLMSuggestOptions, LLMSuggestResponse, LLMSmartReplyOptions, LLMAutocompleteOptions } from './types';
+import { LLMMessage, LLMSendOptions, LLMResponse, LLMStreamOptions, LLMStreamCallback, LLMSummarizeOptions, LLMTranslateOptions, LLMRewriteOptions, LLMExtractKeyPointsOptions, LLMAnswerQuestionOptions, LLMSuggestOptions, LLMSuggestResponse, LLMSmartReplyOptions, LLMAutocompleteOptions, BuiltInModel, DownloadableModel } from './types';
 export * from './types';
 export * from './memory';
 export * from './hooks';
+export * from './models';
 /**
  * Check if on-device AI is available on the current device.
  * Returns false on unsupported platforms (web, etc.).
@@ -513,4 +514,84 @@ export declare function streamAutocomplete(partialText: string, onToken: LLMStre
  * ```
  */
 export declare function parseSuggestResponse(raw: string): LLMSuggestResponse;
+/**
+ * Get all built-in models available on the current platform.
+ *
+ * Built-in models are provided by the OS and require no download.
+ * On iOS this returns Apple Foundation Models; on Android, ML Kit.
+ *
+ * @returns Array of built-in models with availability status
+ */
+export declare function getBuiltInModels(): Promise<BuiltInModel[]>;
+/**
+ * Get all downloadable models from the registry, enriched with on-device status.
+ *
+ * Reads from the hardcoded MODEL_REGISTRY and queries the native layer
+ * for the current download/load status of each model.
+ *
+ * @returns Array of downloadable models with their current status
+ */
+export declare function getDownloadableModels(): Promise<DownloadableModel[]>;
+/**
+ * Download a model to the device.
+ *
+ * Looks up the model in the registry, validates platform support and
+ * device requirements, then initiates the download with integrity verification.
+ *
+ * @param modelId - ID of the model to download (e.g. 'gemma-e2b')
+ * @param options - Optional download configuration
+ * @param options.onProgress - Callback with download progress (0-1)
+ * @throws {ModelError} MODEL_NOT_FOUND if modelId is not in the registry
+ * @throws {ModelError} DEVICE_NOT_SUPPORTED if platform is not supported
+ * @throws {ModelError} DOWNLOAD_FAILED on network error
+ * @throws {ModelError} DOWNLOAD_STORAGE_FULL if insufficient disk space
+ * @throws {ModelError} DOWNLOAD_CORRUPT if SHA256 hash doesn't match
+ */
+export declare function downloadModel(modelId: string, options?: {
+    onProgress?: (progress: number) => void;
+}): Promise<void>;
+/**
+ * Delete a downloaded model from the device.
+ *
+ * If the model is currently loaded, it will be unloaded first.
+ *
+ * @param modelId - ID of the model to delete
+ * @throws {ModelError} MODEL_NOT_FOUND if modelId is not in the registry
+ */
+export declare function deleteModel(modelId: string): Promise<void>;
+/**
+ * Set the active model for inference.
+ *
+ * This is the sole gatekeeper for model validity. If setModel succeeds,
+ * the model is loaded and ready -- sendMessage never needs its own check.
+ *
+ * For downloadable models, this loads the model into memory (status
+ * transitions: loading -> ready). Only one downloadable model can be
+ * loaded at a time; the previous one is auto-unloaded.
+ *
+ * For built-in models, this simply switches the active backend.
+ *
+ * If setModel was never called, sendMessage uses the platform built-in
+ * model (today's behavior, no error).
+ *
+ * @param modelId - ID of the model to activate (e.g. 'gemma-e2b', 'apple-fm', 'mlkit')
+ * @throws {ModelError} MODEL_NOT_FOUND if modelId is invalid
+ * @throws {ModelError} MODEL_NOT_DOWNLOADED if the downloadable model file is not on disk
+ * @throws {ModelError} MODEL_LOAD_FAILED if loading into memory fails
+ * @throws {ModelError} INFERENCE_OOM if device can't fit model in memory
+ */
+export declare function setModel(modelId: string): Promise<void>;
+/**
+ * Get the ID of the currently active model.
+ *
+ * @returns The active model ID (e.g. 'apple-fm', 'mlkit', 'gemma-e2b')
+ */
+export declare function getActiveModel(): string;
+/**
+ * Explicitly unload the current downloadable model from memory.
+ *
+ * Frees memory and reverts to the platform built-in model.
+ * No-op if no downloadable model is currently loaded.
+ */
+export declare function unloadModel(): Promise<void>;
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -1,8 +1,11 @@
 import ExpoAiKitModule from './ExpoAiKitModule';
 import { Platform } from 'react-native';
+import { ModelError, } from './types';
+import { MODEL_REGISTRY, getRegistryEntry } from './models';
 export * from './types';
 export * from './memory';
 export * from './hooks';
+export * from './models';
 const DEFAULT_SYSTEM_PROMPT = 'You are a helpful, friendly assistant. Answer the user directly and concisely.';
 let streamIdCounter = 0;
 function generateSessionId() {
@@ -890,4 +893,141 @@ export function parseSuggestResponse(raw) {
         raw,
     };
 }
+// ============================================================================
+// Model Management API
+// ============================================================================
+/**
+ * Get all built-in models available on the current platform.
+ *
+ * Built-in models are provided by the OS and require no download.
+ * On iOS this returns Apple Foundation Models; on Android, ML Kit.
+ *
+ * @returns Array of built-in models with availability status
+ */
+export async function getBuiltInModels() {
+    if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
+        return [];
+    }
+    return ExpoAiKitModule.getBuiltInModels();
+}
+/**
+ * Get all downloadable models from the registry, enriched with on-device status.
+ *
+ * Reads from the hardcoded MODEL_REGISTRY and queries the native layer
+ * for the current download/load status of each model.
+ *
+ * @returns Array of downloadable models with their current status
+ */
+export async function getDownloadableModels() {
+    if (Platform.OS !== 'ios' && Platform.OS !== 'android') {
+        return [];
+    }
+    const platformModels = MODEL_REGISTRY.filter((entry) => entry.supportedPlatforms.includes(Platform.OS));
+    return platformModels.map((entry) => {
+        const status = ExpoAiKitModule.getDownloadableModelStatus(entry.id);
+        return {
+            id: entry.id,
+            name: entry.name,
+            parameterCount: entry.parameterCount,
+            sizeBytes: entry.sizeBytes,
+            contextWindow: entry.contextWindow,
+            minRamBytes: entry.minRamBytes,
+            status,
+        };
+    });
+}
+/**
+ * Download a model to the device.
+ *
+ * Looks up the model in the registry, validates platform support and
+ * device requirements, then initiates the download with integrity verification.
+ *
+ * @param modelId - ID of the model to download (e.g. 'gemma-e2b')
+ * @param options - Optional download configuration
+ * @param options.onProgress - Callback with download progress (0-1)
+ * @throws {ModelError} MODEL_NOT_FOUND if modelId is not in the registry
+ * @throws {ModelError} DEVICE_NOT_SUPPORTED if platform is not supported
+ * @throws {ModelError} DOWNLOAD_FAILED on network error
+ * @throws {ModelError} DOWNLOAD_STORAGE_FULL if insufficient disk space
+ * @throws {ModelError} DOWNLOAD_CORRUPT if SHA256 hash doesn't match
+ */
+export async function downloadModel(modelId, options) {
+    const entry = getRegistryEntry(modelId);
+    if (!entry) {
+        throw new ModelError('MODEL_NOT_FOUND', modelId);
+    }
+    if (!entry.supportedPlatforms.includes(Platform.OS)) {
+        throw new ModelError('DEVICE_NOT_SUPPORTED', modelId, `Model ${modelId} is not supported on ${Platform.OS}`);
+    }
+    let subscription;
+    if (options?.onProgress) {
+        subscription = ExpoAiKitModule.addListener('onDownloadProgress', (event) => {
+            if (event.modelId === modelId) {
+                options.onProgress(event.progress);
+            }
+        });
+    }
+    try {
+        await ExpoAiKitModule.downloadModel(modelId, entry.downloadUrl, entry.sha256);
+    }
+    finally {
+        subscription?.remove();
+    }
+}
+/**
+ * Delete a downloaded model from the device.
+ *
+ * If the model is currently loaded, it will be unloaded first.
+ *
+ * @param modelId - ID of the model to delete
+ * @throws {ModelError} MODEL_NOT_FOUND if modelId is not in the registry
+ */
+export async function deleteModel(modelId) {
+    const entry = getRegistryEntry(modelId);
+    if (!entry) {
+        throw new ModelError('MODEL_NOT_FOUND', modelId);
+    }
+    await ExpoAiKitModule.deleteModel(modelId);
+}
+/**
+ * Set the active model for inference.
+ *
+ * This is the sole gatekeeper for model validity. If setModel succeeds,
+ * the model is loaded and ready -- sendMessage never needs its own check.
+ *
+ * For downloadable models, this loads the model into memory (status
+ * transitions: loading -> ready). Only one downloadable model can be
+ * loaded at a time; the previous one is auto-unloaded.
+ *
+ * For built-in models, this simply switches the active backend.
+ *
+ * If setModel was never called, sendMessage uses the platform built-in
+ * model (today's behavior, no error).
+ *
+ * @param modelId - ID of the model to activate (e.g. 'gemma-e2b', 'apple-fm', 'mlkit')
+ * @throws {ModelError} MODEL_NOT_FOUND if modelId is invalid
+ * @throws {ModelError} MODEL_NOT_DOWNLOADED if the downloadable model file is not on disk
+ * @throws {ModelError} MODEL_LOAD_FAILED if loading into memory fails
+ * @throws {ModelError} INFERENCE_OOM if device can't fit model in memory
+ */
+export async function setModel(modelId) {
+    await ExpoAiKitModule.setModel(modelId);
+}
+/**
+ * Get the ID of the currently active model.
+ *
+ * @returns The active model ID (e.g. 'apple-fm', 'mlkit', 'gemma-e2b')
+ */
+export function getActiveModel() {
+    return ExpoAiKitModule.getActiveModel();
+}
+/**
+ * Explicitly unload the current downloadable model from memory.
+ *
+ * Frees memory and reverts to the platform built-in model.
+ * No-op if no downloadable model is currently loaded.
+ */
+export async function unloadModel() {
+    await ExpoAiKitModule.unloadModel();
+}
 //# sourceMappingURL=index.js.map