docs(leap-sdk): update to v0.10.0

.gitignore

@@ -164,4 +164,7 @@ Thumbs.db
 env
 env/*
 
-__pycache__/
+__pycache__/
+
+devlog/
+worktrees/

deployment/on-device/android/ai-agent-usage-guide.mdx

@@ -17,14 +17,14 @@
 
 ## Installation
 
 ### Gradle Dependencies
 
 **Recommended**: Use version catalog for dependency management.
 
 ```toml
 # gradle/libs.versions.toml
 [versions]
-leapSdk = "0.9.7"
+leapSdk = "0.10.0"
 
 [libraries]
 leap-sdk = { module = "ai.liquid.leap:leap-sdk", version.ref = "leapSdk" }
@@ -44,8 +44,8 @@
 ```kotlin
 // app/build.gradle.kts
 dependencies {
-    implementation("ai.liquid.leap:leap-sdk:0.9.7")
-    implementation("ai.liquid.leap:leap-model-downloader:0.9.7")
+    implementation("ai.liquid.leap:leap-sdk:0.10.0")
+    implementation("ai.liquid.leap:leap-model-downloader:0.10.0")
 }
 ```
 
@@ -139,7 +139,7 @@
 }
 ```
 
 Available models and quantizations: [LEAP Model Library](https://leap.liquid.ai/models)
 
 ### Method 2: Download Without Loading
 
@@ -197,7 +197,7 @@
 
 ### Method 3: Cross-Platform LeapDownloader
 
 For Kotlin Multiplatform projects (iOS, macOS, JVM, Android):
 
 ```kotlin
 import ai.liquid.leap.LeapDownloader
@@ -447,7 +447,7 @@
 **Methods**:
 - `createConversation(systemPrompt: String? = null): Conversation` - Start new chat
 - `createConversationFromHistory(history: List<ChatMessage>): Conversation` - Restore chat
 - `suspend fun unload()` - Free memory (MUST call in onCleared with runBlocking)
 
 ### Conversation
 Manages chat history and generation state.
@@ -622,7 +622,7 @@
 }
 ```
 
 ## Multimodal Input
 
 ### Vision (Image + Text)
 ```kotlin
@@ -681,7 +681,7 @@
 - **LFM2-1.2B**: Stable version
 - **LFM2-1.2B-Tool**: Optimized for function calling
 
 ### Multimodal Models
 - **LFM2.5-VL-1.6B**: Vision + text
 - **LFM2.5-Audio-1.5B**: Audio + text (TTS, ASR, voice chat)
 
@@ -902,7 +902,7 @@
 
 ### Model won't load
 - Check internet connection (first download)
 - Verify minSdk = 31 in build.gradle.kts
 - Use physical device (emulators may crash)
 - Check storage space (models: 500MB-2GB)
 
@@ -917,6 +917,6 @@
 - Check sample rate (16kHz recommended)
 
 ### Memory issues
 - Call `modelRunner?.unload()` in onCleared
 - Don't load multiple models simultaneously
 - Use appropriate quantization (Q4_K_M recommended)

deployment/on-device/android/android-quick-start-guide.mdx

@@ -3,7 +3,7 @@
 description: "Get up and running with the LEAP Android SDK in minutes. Install the SDK, load models, and start generating content."
 ---
 
-Latest version: `v0.9.7`
+Latest version: `v0.10.0`
 
 <Info>
 The LEAP SDK is now a **Kotlin Multiplatform** library supporting Android, iOS, macOS, and JVM. While Android is well-tested and production-ready, other platforms are currently in testing.
@@ -19,7 +19,7 @@
   plugins {
       id("com.android.application") version "8.13.2" apply false
       id("com.android.library") version "8.13.2" apply false
-      id("org.jetbrains.kotlin.android") version "2.3.10" apply false
+      id("org.jetbrains.kotlin.android") version "2.3.20" apply false
   }
   ```
 * A working Android device that supports `arm64-v8a` ABI with [developer mode enabled](https://developer.android.com/studio/debug/dev-options). We recommend having 3GB+ of RAM to run the models.
@@ -61,8 +61,16 @@
 
 ```kotlin
 dependencies {
-  implementation("ai.liquid.leap:leap-sdk:0.9.7")
-  implementation("ai.liquid.leap:leap-model-downloader:0.9.7") // Android-specific model downloader
+  implementation("ai.liquid.leap:leap-sdk:0.10.0")
+  implementation("ai.liquid.leap:leap-model-downloader:0.10.0") // Android-specific model downloader
+
+  // Optional: OpenAI-compatible cloud chat client
+  // See /deployment/on-device/android/openai-client
+  // implementation("ai.liquid.leap:leap-openai-client:0.10.0")
+
+  // Optional: Voice assistant widget (Compose Multiplatform)
+  // See /deployment/on-device/android/voice-assistant
+  // implementation("ai.liquid.leap:leap-ui:0.10.0")
 }
 ```
 
@@ -72,11 +80,14 @@
 
 ```toml
 [versions]
-leapSdk = "0.9.7"
+leapSdk = "0.10.0"
 
 [libraries]
 leap-sdk = { module = "ai.liquid.leap:leap-sdk", version.ref = "leapSdk" }
 leap-model-downloader = { module = "ai.liquid.leap:leap-model-downloader", version.ref = "leapSdk" }
+# Optional modules:
+leap-openai-client = { module = "ai.liquid.leap:leap-openai-client", version.ref = "leapSdk" }
+leap-ui = { module = "ai.liquid.leap:leap-ui", version.ref = "leapSdk" }
 ```
 
 Then in `app/build.gradle.kts`:
@@ -85,6 +96,8 @@
 dependencies {
   implementation(libs.leap.sdk)
   implementation(libs.leap.model.downloader)
+  // implementation(libs.leap.openai.client)  // see openai-client.mdx
+  // implementation(libs.leap.ui)             // see voice-assistant.mdx
 }
 ```
 
@@ -99,7 +112,7 @@
 The SDK uses **GGUF manifests** for loading models (recommended for all new projects due to superior inference performance and better default generation parameters).
 
 <Info>
 Legacy Executorch bundle support is available in the accordion below for existing projects.
 </Info>
 
 ## Loading from GGUF Manifest
@@ -108,7 +121,7 @@
 
 ### Android: Using LeapModelDownloader (Recommended)
 
 For Android, `LeapModelDownloader` provides the best experience with background downloads, WorkManager integration, and notification support. This function takes some time to finish as loading the model is a heavy I/O operation, but it is safe to call on the main thread. The function should be executed in a coroutine scope.
 
 **ViewModel**
 
@@ -302,7 +315,7 @@
 
   ### Loading from local bundle file
 
   The `LeapClient.loadModel` suspend function loads a model bundle file and returns a model runner instance for invoking the model. This function takes some time to finish as loading the model is a heavy I/O operation, but it is safe to call on the main thread. The function should be executed in a coroutine scope.
 
   ```kotlin
   lifecycleScope.launch {

deployment/on-device/android/model-loading.mdx

@@ -104,7 +104,7 @@
 The `LeapDownloader` class is a **cross-platform** model loader available in the core `leap-sdk` module. It works on Android, iOS, macOS, and JVM platforms. Use this for:
 - iOS and macOS applications
 - JVM/Desktop applications
 - Cross-platform Kotlin Multiplatform code
 - Android apps that don't need background download features
 
 ```kotlin
@@ -113,7 +113,7 @@
 
 | Field | Type | Required | Default | Description |
 |-------|------|----------|---------|-------------|
 | `config` | `LeapDownloaderConfig` | No | `LeapDownloaderConfig()` | Configuration options for the downloader. See [`LeapDownloaderConfig`](#leapdownloaderconfig) for more details. |
 
 <br/>
 ### `loadModel`
@@ -149,6 +149,94 @@
 
 `Manifest`: The [`Manifest`](#manifest) instance that contains the metadata of the downloaded model.
 
+<br/>
+## `loadSimpleModel` (sideloaded models)
+
+`LeapDownloader.loadSimpleModel` and `LeapModelDownloader.loadSimpleModel` (added in v0.10.0) load a model from explicit resource paths or URLs without going through the LEAP Model Library manifest. Use this when:
+
+- You ship the model as an app asset or download it via your own pipeline.
+- You `adb push` a model into `/data/local/tmp/leap/` for development.
+- You stage a multimodal model + companion files (`mmproj`, audio decoder, audio tokenizer) into a known directory.
+
+```kotlin
+suspend fun loadSimpleModel(
+    model: ModelSource,
+    modelLoadingOptions: ModelLoadingOptions? = null,
+    generationTimeParameters: GenerationTimeParameters? = null,
+    progress: (ProgressData) -> Unit = {},
+): ModelRunner
+```
+
+`ModelSource` carries the four resource locations:
+
+```kotlin
+data class ModelSource(
+    val modelName: String,
+    val quantizationId: String,
+    val modelPath: String,
+    val mmprojPath: String? = null,
+    val audioDecoderPath: String? = null,
+    val audioTokenizerPath: String? = null,
+)
+```
+
+Each path can be:
+
+- An **absolute filesystem path** (e.g. `/data/local/tmp/leap/lfm2.gguf`).
+- A `file://` URL — both `file:///path` and `file://localhost/path` resolve identically (RFC 8089 §3). Other authorities are rejected.
+- An `http(s)://` URL — fetched and cached on first use.
+
+When a resource resolves to a local path that already exists on disk, the SDK skips the cache lookup and download entirely and uses the file verbatim. This is the recommended sideload entry point.
+
+### Sideload an Android-bundled model
+
+```kotlin
+import ai.liquid.leap.manifest.ModelSource
+import ai.liquid.leap.model_downloader.LeapModelDownloader
+
+val modelDownloader = LeapModelDownloader(context)
+
+lifecycleScope.launch {
+    val modelRunner = modelDownloader.loadSimpleModel(
+        model = ModelSource(
+            modelName = "LFM2-1.2B",
+            quantizationId = "Q5_K_M",
+            modelPath = "/data/local/tmp/leap/lfm2-1.2b-q5_k_m.gguf",
+        ),
+    )
+    // Use modelRunner...
+}
+```
+
+### Sideload a multimodal model with companion files
+
+```kotlin
+val modelRunner = modelDownloader.loadSimpleModel(
+    model = ModelSource(
+        modelName = "LFM2-VL-450M",
+        quantizationId = "Q4_K_M",
+        modelPath = "file:///data/local/tmp/leap/lfm2-vl.gguf",
+        mmprojPath = "file:///data/local/tmp/leap/lfm2-vl-mmproj.gguf",
+    ),
+)
+```
+
+The same API exists on `LeapDownloader` for cross-platform code:
+
+```kotlin
+import ai.liquid.leap.LeapDownloader
+import ai.liquid.leap.LeapDownloaderConfig
+
+val downloader = LeapDownloader(LeapDownloaderConfig(saveDir = baseDir))
+val modelRunner = downloader.loadSimpleModel(
+    model = ModelSource(
+        modelName = "LFM2-1.2B",
+        quantizationId = "Q5_K_M",
+        modelPath = localPath,
+    ),
+)
+```
+
 <br/>
 ## `LeapDownloaderConfig`
 The `LeapDownloaderConfig` class contains all the configuration options for `LeapDownloader`. It is a data class with the following fields:
@@ -233,7 +321,7 @@
 
   - `path`: A local path pointing to model bundle file. Both `.bundle` files and `.gguf` files are supported.
   - `options`: Options for loading the model.
   - `mmprojPath`: Optional multimodal projection model path. This parameter should only be filled if the model needs a separate multimodal projection model to parsing multimodal (image, audio, etc.) contents.
 
   <Info>
   The function will throw `LeapModelLoadingException` if LEAP fails to load the model.
@@ -253,9 +341,9 @@
   ```
 
   - `modelPath`: Main model path.
   - `mmprojPath`: Multimodal projection model path.
   - `audioDecoderPath`: Audio decoder model path.
   - `audioTokenizerPath`: Audio tokenizer model path.
 
   ### `loadModelAsResult`