@independo/capacitor-inderun 1.1.0-dev.1 → 1.1.0-dev.11

package/android/src/test/kotlin/app/independo/inderun/capacitor/IndeRunSerializerCapabilitiesTest.kt

@@ -0,0 +1,253 @@
+package app.independo.inderun.capacitor
+
+import app.independo.inderun.core.ProviderCapabilitySnapshot
+import app.independo.inderun.core.ProviderDescriptor
+import app.independo.inderun.core.ProviderDynamicCapabilities
+import org.junit.Assert.assertEquals
+import org.junit.Assert.assertFalse
+import org.junit.Assert.assertTrue
+import org.junit.Test
+
+class IndeRunSerializerCapabilitiesTest {
+
+    private fun snapshot(
+        providerId: String,
+        type: ProviderDescriptor.ProviderType,
+        transport: ProviderDescriptor.TransportType,
+        streamingStyle: ProviderDescriptor.StreamingStyle? = null,
+        streaming: Boolean,
+        cancel: ProviderDescriptor.CancelSemantics,
+        limits: ProviderDescriptor.ResourceLimits? = null,
+        privacy: ProviderDescriptor.PrivacyDescriptor? = null,
+        capabilities: ProviderDynamicCapabilities
+    ): ProviderCapabilitySnapshot = ProviderCapabilitySnapshot(
+        providerId = providerId,
+        descriptor = ProviderDescriptor(
+            id = providerId,
+            type = type,
+            transport = transport,
+            streamingStyle = streamingStyle,
+            supports = ProviderDescriptor.SupportsCapabilities(
+                run = true,
+                streaming = streaming,
+                realtime = false,
+                tools = false,
+                reasoningEvents = false,
+                structuredOutput = false,
+                multimodal = false
+            ),
+            cancel = cancel,
+            tasks = listOf("text_to_text"),
+            limits = limits,
+            privacy = privacy
+        ),
+        capabilities = capabilities
+    )
+
+    @Test
+    fun `encodeCapabilitySnapshots wraps the snapshots in a providers array`() {
+        val encoded = IndeRunSerializer.encodeCapabilitySnapshots(
+            listOf(
+                snapshot(
+                    providerId = "openai",
+                    type = ProviderDescriptor.ProviderType.cloud,
+                    transport = ProviderDescriptor.TransportType.http,
+                    streamingStyle = ProviderDescriptor.StreamingStyle.tokens,
+                    streaming = true,
+                    cancel = ProviderDescriptor.CancelSemantics.hard,
+                    limits = ProviderDescriptor.ResourceLimits(
+                        maxInputTokens = 128_000,
+                        maxOutputTokens = 4_096
+                    ),
+                    privacy = ProviderDescriptor.PrivacyDescriptor(
+                        dataLeavesDevice = true,
+                        regions = listOf("us")
+                    ),
+                    capabilities = ProviderDynamicCapabilities(available = true)
+                )
+            )
+        )
+
+        val providers = encoded.getJSONArray("providers")
+        assertEquals(1, providers.length())
+
+        val provider = providers.getJSONObject(0)
+        assertEquals("openai", provider.getString("providerId"))
+
+        val descriptor = provider.getJSONObject("descriptor")
+        assertEquals("openai", descriptor.getString("id"))
+        assertEquals("cloud", descriptor.getString("type"))
+        assertEquals("http", descriptor.getString("transport"))
+        assertEquals("tokens", descriptor.getString("streamingStyle"))
+        assertEquals("hard", descriptor.getString("cancel"))
+        assertEquals(1, descriptor.getJSONArray("tasks").length())
+        assertEquals("text_to_text", descriptor.getJSONArray("tasks").getString(0))
+
+        val supports = descriptor.getJSONObject("supports")
+        assertTrue(supports.getBoolean("run"))
+        assertTrue(supports.getBoolean("streaming"))
+        assertFalse(supports.getBoolean("realtime"))
+        assertFalse(supports.getBoolean("tools"))
+        assertFalse(supports.getBoolean("reasoningEvents"))
+        assertFalse(supports.getBoolean("structuredOutput"))
+        assertFalse(supports.getBoolean("multimodal"))
+
+        val limits = descriptor.getJSONObject("limits")
+        assertEquals(128_000, limits.getInt("maxInputTokens"))
+        assertEquals(4_096, limits.getInt("maxOutputTokens"))
+        assertFalse(limits.has("maxImageBytes"))
+        assertFalse(limits.has("maxAudioSeconds"))
+
+        val privacy = descriptor.getJSONObject("privacy")
+        assertTrue(privacy.getBoolean("dataLeavesDevice"))
+        assertEquals("us", privacy.getJSONArray("regions").getString(0))
+
+        assertTrue(provider.getJSONObject("capabilities").getBoolean("available"))
+    }
+
+    /**
+     * `in_process` and `system_service` are the two descriptor constants a future upstream
+     * rename to camelCase would silently corrupt on the wire, because the TypeScript union
+     * in src/definitions.ts spells them out. Asserting the literals is the guard.
+     */
+    @Test
+    fun `encodeCapabilitySnapshots writes snake case transport constants verbatim`() {
+        val encoded = IndeRunSerializer.encodeCapabilitySnapshots(
+            listOf(
+                snapshot(
+                    providerId = "local.onnx.genai.android",
+                    type = ProviderDescriptor.ProviderType.local,
+                    transport = ProviderDescriptor.TransportType.in_process,
+                    streaming = false,
+                    cancel = ProviderDescriptor.CancelSemantics.soft,
+                    capabilities = ProviderDynamicCapabilities(
+                        available = false,
+                        reason = "No model package configured."
+                    )
+                ),
+                snapshot(
+                    providerId = "android.mlkit.genai",
+                    type = ProviderDescriptor.ProviderType.local,
+                    transport = ProviderDescriptor.TransportType.system_service,
+                    streamingStyle = ProviderDescriptor.StreamingStyle.chunks,
+                    streaming = true,
+                    cancel = ProviderDescriptor.CancelSemantics.soft,
+                    capabilities = ProviderDynamicCapabilities(available = true)
+                )
+            )
+        )
+
+        val providers = encoded.getJSONArray("providers")
+        assertEquals(
+            "in_process",
+            providers.getJSONObject(0).getJSONObject("descriptor").getString("transport")
+        )
+        assertEquals(
+            "system_service",
+            providers.getJSONObject(1).getJSONObject("descriptor").getString("transport")
+        )
+        assertEquals(
+            "chunks",
+            providers.getJSONObject(1).getJSONObject("descriptor").getString("streamingStyle")
+        )
+    }
+
+    /**
+     * Absence is the contract's "inherit the static declaration" state, so the nullable
+     * flags must not reach the wire as nulls — a null would be a third state no consumer
+     * has. Same for the optional descriptor sub-objects.
+     */
+    @Test
+    fun `encodeCapabilitySnapshots omits unset optional fields instead of writing null`() {
+        val encoded = IndeRunSerializer.encodeCapabilitySnapshots(
+            listOf(
+                snapshot(
+                    providerId = "android.mlkit.genai",
+                    type = ProviderDescriptor.ProviderType.local,
+                    transport = ProviderDescriptor.TransportType.system_service,
+                    streaming = true,
+                    cancel = ProviderDescriptor.CancelSemantics.soft,
+                    capabilities = ProviderDynamicCapabilities(available = true)
+                )
+            )
+        )
+
+        val provider = encoded.getJSONArray("providers").getJSONObject(0)
+        val descriptor = provider.getJSONObject("descriptor")
+        assertFalse(descriptor.has("streamingStyle"))
+        assertFalse(descriptor.has("limits"))
+        assertFalse(descriptor.has("privacy"))
+
+        val capabilities = provider.getJSONObject("capabilities")
+        assertFalse(capabilities.has("reason"))
+        assertFalse(capabilities.has("streamingAvailable"))
+        assertFalse(capabilities.has("streamingUnavailableReason"))
+        assertFalse(capabilities.has("cancellationAvailable"))
+    }
+
+    @Test
+    fun `encodeCapabilitySnapshots encodes streaming taken away at runtime`() {
+        val encoded = IndeRunSerializer.encodeCapabilitySnapshots(
+            listOf(
+                snapshot(
+                    providerId = "openai",
+                    type = ProviderDescriptor.ProviderType.cloud,
+                    transport = ProviderDescriptor.TransportType.http,
+                    streamingStyle = ProviderDescriptor.StreamingStyle.tokens,
+                    streaming = true,
+                    cancel = ProviderDescriptor.CancelSemantics.hard,
+                    capabilities = ProviderDynamicCapabilities(
+                        available = true,
+                        streamingAvailable = false,
+                        streamingUnavailableReason = "Host has no streaming HTTP client.",
+                        cancellationAvailable = true
+                    )
+                )
+            )
+        )
+
+        val capabilities = encoded.getJSONArray("providers")
+            .getJSONObject(0)
+            .getJSONObject("capabilities")
+        assertTrue(capabilities.getBoolean("available"))
+        assertFalse(capabilities.getBoolean("streamingAvailable"))
+        assertEquals(
+            "Host has no streaming HTTP client.",
+            capabilities.getString("streamingUnavailableReason")
+        )
+        assertTrue(capabilities.getBoolean("cancellationAvailable"))
+    }
+
+    @Test
+    fun `encodeCapabilitySnapshots encodes an empty registry as an empty array`() {
+        val encoded = IndeRunSerializer.encodeCapabilitySnapshots(emptyList())
+
+        assertTrue(encoded.has("providers"))
+        assertEquals(0, encoded.getJSONArray("providers").length())
+    }
+
+    /**
+     * Every enum constant of every descriptor enum maps to the wire spelling the
+     * TypeScript unions declare. Exhaustive by construction: `values()` grows when
+     * upstream adds a constant, and a renamed one fails here rather than in a demo.
+     */
+    @Test
+    fun `every descriptor enum constant maps to its declared wire value`() {
+        assertEquals(
+            listOf("local", "edge", "cloud"),
+            ProviderDescriptor.ProviderType.values().map { it.name }
+        )
+        assertEquals(
+            listOf("in_process", "system_service", "http", "sse", "realtime"),
+            ProviderDescriptor.TransportType.values().map { it.name }
+        )
+        assertEquals(
+            listOf("tokens", "chunks", "snapshots"),
+            ProviderDescriptor.StreamingStyle.values().map { it.name }
+        )
+        assertEquals(
+            listOf("hard", "soft", "none"),
+            ProviderDescriptor.CancelSemantics.values().map { it.name }
+        )
+    }
+}

package/android/src/test/kotlin/app/independo/inderun/capacitor/IndeRunSerializerTest.kt

@@ -142,6 +142,29 @@ class IndeRunSerializerTest {
 
     // --- encodeError ---
 
+    /**
+     * `systemModel` and `onnx` are web-only bootstrap keys, like
+     * `allowDirectOpenAIEndpoint`. Android registers its own on-device provider, so it must
+     * ignore them rather than fail on the options object that carries them.
+     */
+    @Test
+    fun `parseConfigureOptions ignores the web-only provider bootstrap keys`() {
+        val options = IndeRunSerializer.parseConfigureOptions(
+            JSONObject(
+                """
+                {
+                  "openAI": { "model": "gpt-5.2", "auth": "none" },
+                  "systemModel": { "id": "local.system-model.web", "timeoutMs": 30000 },
+                  "onnx": { "modelPackage": { "id": "demo", "format": "onnx" } }
+                }
+                """.trimIndent()
+            )
+        )
+
+        assertEquals("gpt-5.2", options.openAI?.model)
+        assertEquals("none", options.openAI?.auth)
+    }
+
     @Test
     fun `encodeError produces correct shape with required fields only`() {
         val encoded = IndeRunSerializer.encodeError(
@@ -177,4 +200,60 @@ class IndeRunSerializerTest {
         assertEquals(2000L, encoded.getLong("retryAfterMs"))
         assertEquals("run_abc", encoded.getString("runId"))
     }
+
+    /**
+     * A routing refusal carries its plan diagnostics on the error's `details`, and since
+     * inderun 0.3.0 it does so on iOS and Android too, not just on the web SDK. The shape
+     * is nested — a `rejectedProviders` array of objects, each with its own `reasons`
+     * array — and `encodeError` hands the whole map to `JSONObject(Map)`, which deep-wraps
+     * via `wrap()`. Nothing asserted that before; this is the data a provider-refusal UI
+     * actually reads, so a regression here would be invisible until a demo showed an empty
+     * table.
+     */
+    @Test
+    fun `encodeError preserves nested route-plan diagnostics in details`() {
+        val encoded = IndeRunSerializer.encodeError(
+            IndeRunError(
+                errorClass = IndeRunErrorClass.CapabilityMismatch,
+                message = "No eligible provider can stream this request.",
+                details = mapOf(
+                    "failureCode" to "CapabilityMismatch",
+                    "rejectedProviders" to listOf(
+                        mapOf(
+                            "providerId" to "android.mlkit.genai",
+                            "reasons" to listOf(
+                                mapOf(
+                                    "code" to "streaming_not_supported",
+                                    "message" to "Provider does not declare streaming."
+                                )
+                            )
+                        ),
+                        mapOf(
+                            "providerId" to "openai",
+                            "reasons" to listOf(
+                                mapOf("code" to "privacy_constraint", "message" to "local_required forbids cloud.")
+                            )
+                        )
+                    )
+                )
+            )
+        )
+
+        val details = encoded.getJSONObject("details")
+        assertEquals("CapabilityMismatch", details.getString("failureCode"))
+
+        val rejected = details.getJSONArray("rejectedProviders")
+        assertEquals(2, rejected.length())
+        assertEquals("android.mlkit.genai", rejected.getJSONObject(0).getString("providerId"))
+        assertEquals(
+            "streaming_not_supported",
+            rejected.getJSONObject(0).getJSONArray("reasons").getJSONObject(0).getString("code")
+        )
+        assertEquals("openai", rejected.getJSONObject(1).getString("providerId"))
+        assertEquals(
+            "privacy_constraint",
+            rejected.getJSONObject(1).getJSONArray("reasons").getJSONObject(0).getString("code")
+        )
+    }
+
 }

package/dist/definitions.d.ts

@@ -1,5 +1,5 @@
 import type { PluginListenerHandle } from "@capacitor/core";
-import type { IndeRunError, StreamEvent, StreamRunHandle, TaskRequest, TaskResult } from "@independo/inderun-contracts";
+import type { IndeRunError, ModelPackage, StreamEvent, StreamRunHandle, TaskRequest, TaskResult } from "@independo/inderun-contracts";
 export interface OpenAIProviderBootstrapOptions {
     model: string;
     endpointUrl?: string;
@@ -7,8 +7,50 @@ export interface OpenAIProviderBootstrapOptions {
     authContextRef?: string;
     timeoutMs?: number;
 }
+/**
+ * Bootstrap options for the browser-managed on-device provider (Chrome's Prompt API).
+ *
+ * **Web only**, and ignored on iOS and Android, which register their own on-device
+ * providers — Apple Foundation Models and ML Kit GenAI — from `configure()` regardless.
+ *
+ * The browser owns model availability, download and execution, so there is nothing to
+ * configure: registering it is the whole point, and it is what makes
+ * `constraints.privacy = "local_required"` routable in a browser. Mode 1 only — this
+ * provider does not stream, so a `local_required` *stream* on the web is still refused at
+ * routing time.
+ *
+ * The web SDK's `runtime` injection seam is deliberately not exposed: it is a function,
+ * and `configure()` has to survive a JSON bridge hop on native.
+ */
+export interface SystemModelProviderBootstrapOptions {
+    id?: string;
+    timeoutMs?: number;
+}
+/**
+ * Bootstrap options for the Web ONNX Runtime provider, for a developer-supplied local
+ * model.
+ *
+ * **Web only**, like `systemModel`, and Mode 1 only.
+ *
+ * Two caveats worth knowing before reaching for this. The consumer has to install the
+ * optional `@huggingface/transformers` peer dependency — this bridge does not declare it —
+ * and supply real model weights, because the web SDK's `runtime` seam is a function and so
+ * cannot cross the JSON bridge hop: only the default Transformers.js runtime is reachable
+ * from here, never the fixture runtime the upstream demos use offline. A registered
+ * provider that cannot load turns a clean routing refusal into a provider error, so
+ * register it only when the weights are actually there.
+ */
+export interface OnnxProviderBootstrapOptions {
+    id?: string;
+    modelPackage: ModelPackage;
+    timeoutMs?: number;
+}
 export interface ConfigureOptions {
     openAI?: OpenAIProviderBootstrapOptions;
+    /** Web only; native registers its own on-device provider. */
+    systemModel?: SystemModelProviderBootstrapOptions;
+    /** Web only; native registers its own on-device provider. */
+    onnx?: OnnxProviderBootstrapOptions;
     allowDirectOpenAIEndpoint?: boolean;
 }
 /**
@@ -53,9 +95,88 @@ export interface StreamRun {
     events: AsyncIterable<StreamEvent>;
     cancel(reason?: string): void;
 }
+/**
+ * A provider's static capability declaration.
+ *
+ * Declared here rather than imported, because — unlike `TaskRequest`, `StreamEvent` and
+ * the rest — this shape is *not* a generated contract. There is no schema for it in
+ * `@independo/inderun-contracts` and no validator; each SDK declares it independently
+ * (`core/provider.d.ts` in `@independo/inderun-web`, `IndeRunCore/Provider.swift`,
+ * `core/Provider.kt`), and this is the fourth copy. Importing it from
+ * `@independo/inderun-web` is not an option either: that would make the native
+ * platforms' plugin contract depend on the web SDK.
+ *
+ * The drift guard is in `web.ts`, which returns the web SDK's value into this type
+ * uncast — so `tsc` proves the shapes still match on every build, the same way the
+ * `StreamRun` mirror below is checked. See the upstream follow-up asking for a schema.
+ */
+export interface ProviderDescriptor {
+    id: string;
+    type: "local" | "edge" | "cloud";
+    transport: "in_process" | "system_service" | "http" | "sse" | "realtime";
+    streamingStyle?: "tokens" | "chunks" | "snapshots";
+    supports: {
+        run: boolean;
+        streaming: boolean;
+        realtime: boolean;
+        tools: boolean;
+        reasoningEvents: boolean;
+        structuredOutput: boolean;
+        multimodal: boolean;
+    };
+    cancel: "hard" | "soft" | "none";
+    tasks: string[];
+    limits?: {
+        maxInputTokens?: number;
+        maxOutputTokens?: number;
+        maxImageBytes?: number;
+        maxAudioSeconds?: number;
+    };
+    privacy?: {
+        dataLeavesDevice: boolean;
+        regions?: string[];
+    };
+}
+/**
+ * A provider's live availability, as of the moment `checkCapabilities()` was called.
+ *
+ * `streamingAvailable` and `cancellationAvailable` are **absent**, not `null`, when the
+ * runtime has nothing to say: absence means *inherit the static declaration*
+ * (`descriptor.supports.streaming`, and `descriptor.cancel !== "none"`). Both native
+ * encoders omit the key rather than emitting null for exactly that reason.
+ */
+export interface ProviderDynamicCapabilities {
+    available: boolean;
+    reason?: string;
+    streamingAvailable?: boolean;
+    streamingUnavailableReason?: string;
+    cancellationAvailable?: boolean;
+}
+/** One registered provider's identity, static declaration, and live availability. */
+export interface ProviderCapabilitySnapshot {
+    providerId: string;
+    descriptor: ProviderDescriptor;
+    capabilities: ProviderDynamicCapabilities;
+}
+/**
+ * Envelope for `checkCapabilities()`. The array is wrapped because a Capacitor plugin
+ * method must resolve an object on both native platforms — `PluginCall.resolve(JSObject)`
+ * and `call.resolve([String: Any])` cannot carry a top-level array. `IndeRunCapacitor`
+ * and `createIndeRunCapacitor()` unwrap it, so app code sees the same
+ * `ProviderCapabilitySnapshot[]` the three platform SDKs return.
+ */
+export interface CheckCapabilitiesResult {
+    providers: ProviderCapabilitySnapshot[];
+}
 export interface IndeRunCapacitorPlugin {
     configure(options?: ConfigureOptions): Promise<void>;
     run(request: TaskRequest): Promise<TaskResult>;
+    /**
+     * Live snapshot of every registered provider, without executing a task. Availability
+     * changes between calls — a local model can unload, cloud credentials can expire — so
+     * do not cache it across a `run()` or `stream()`.
+     */
+    checkCapabilities(): Promise<CheckCapabilitiesResult>;
     /**
      * Unlike `run(request)`, which passes the request at the options root, this nests it
      * under `request` so the envelope can also carry `streamId`. Both native decode sites

package/dist/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,WAAW,EACX,UAAU,EACX,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,8BAA8B,CAAC;IACxC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6FAA6F;AAC7F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IACnC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C;;;;OAIG;IACH,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACnE,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,WAAW,CACT,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,GAC5D,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,WAAW,CACT,SAAS,EAAE,oBAAoB,EAC/B,YAAY,EAAE,CAAC,YAAY,EAAE,uBAAuB,KAAK,IAAI,GAC5D,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACjC,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../src/definitions.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,20 +1,23 @@
 import type { TaskRequest, TaskResult } from "@independo/inderun-contracts";
-import type { CancelStreamOptions, ConfigureOptions, IndeRunCapacitorPlugin as IndeRunCapacitorPluginContract, OpenAIProviderBootstrapOptions, StartStreamOptions, StreamErrorNotification, StreamEventNotification, StreamRun } from "./definitions.js";
+import type { CancelStreamOptions, CheckCapabilitiesResult, ConfigureOptions, IndeRunCapacitorPlugin as IndeRunCapacitorPluginContract, OnnxProviderBootstrapOptions, OpenAIProviderBootstrapOptions, ProviderCapabilitySnapshot, ProviderDescriptor, ProviderDynamicCapabilities, StartStreamOptions, StreamErrorNotification, StreamEventNotification, StreamRun, SystemModelProviderBootstrapOptions } from "./definitions.js";
 /**
  * The plugin contract plus the ergonomic Mode 2 entry point. `stream()` is not a
  * plugin method — it is `startStream`, the event listeners, and `cancelStream`
  * reassembled into the same shape the platform SDKs return from `stream()`.
  */
-export interface IndeRunCapacitorApi extends IndeRunCapacitorPluginContract {
+export interface IndeRunCapacitorApi extends Omit<IndeRunCapacitorPluginContract, "checkCapabilities"> {
     stream(request: TaskRequest): Promise<StreamRun>;
+    /** The plugin's `{ providers }` envelope, unwrapped to match the platform SDKs. */
+    checkCapabilities(): Promise<ProviderCapabilitySnapshot[]>;
 }
 export declare const IndeRunCapacitor: IndeRunCapacitorApi;
 export interface IndeRunCapacitorInstance {
     run(request: TaskRequest): Promise<TaskResult>;
     stream(request: TaskRequest): Promise<StreamRun>;
+    checkCapabilities(): Promise<ProviderCapabilitySnapshot[]>;
 }
 export declare function createIndeRunCapacitor(options?: ConfigureOptions): IndeRunCapacitorInstance;
 export { STREAM_ERROR_NAME, STREAM_EVENT_NAME } from "./streaming.js";
-export type { CancelStreamOptions, ConfigureOptions, IndeRunCapacitorPluginContract as IndeRunCapacitorPlugin, OpenAIProviderBootstrapOptions, StartStreamOptions, StreamErrorNotification, StreamEventNotification, StreamRun, TaskRequest, TaskResult };
+export type { CancelStreamOptions, CheckCapabilitiesResult, ConfigureOptions, IndeRunCapacitorPluginContract as IndeRunCapacitorPlugin, OnnxProviderBootstrapOptions, OpenAIProviderBootstrapOptions, ProviderCapabilitySnapshot, ProviderDescriptor, ProviderDynamicCapabilities, StartStreamOptions, StreamErrorNotification, StreamEventNotification, StreamRun, SystemModelProviderBootstrapOptions, TaskRequest, TaskResult };
 export type * from "@independo/inderun-contracts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,WAAW,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE7F,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,IAAI,8BAA8B,EACxD,8BAA8B,EAC9B,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,SAAS,EACV,MAAM,kBAAkB,CAAC;AAQ1B;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,8BAA8B;IACzE,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,gBAAgB,EAAE,mBA4C9B,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;CAClD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,wBAAwB,CAsB3F;AAED,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,YAAY,EACV,mBAAmB,EACnB,gBAAgB,EAChB,8BAA8B,IAAI,sBAAsB,EACxD,8BAA8B,EAC9B,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,SAAS,EACT,WAAW,EACX,UAAU,EACX,CAAC;AAEF,mBAAmB,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,WAAW,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE7F,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,IAAI,8BAA8B,EACxD,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,EAC1B,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,SAAS,EACT,mCAAmC,EACpC,MAAM,kBAAkB,CAAC;AAQ1B;;;;GAIG;AACH,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,8BAA8B,EAAE,mBAAmB,CAAC;IACpG,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACjD,mFAAmF;IACnF,iBAAiB,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC;CAC5D;AAED,eAAO,MAAM,gBAAgB,EAAE,mBAqD9B,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IACjD,iBAAiB,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC,CAAC;CAC5D;AAED,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,wBAAwB,CA4B3F;AAED,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,YAAY,EACV,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,8BAA8B,IAAI,sBAAsB,EACxD,4BAA4B,EAC5B,8BAA8B,EAC9B,0BAA0B,EAC1B,kBAAkB,EAClB,2BAA2B,EAC3B,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACvB,SAAS,EACT,mCAAmC,EACnC,WAAW,EACX,UAAU,EACX,CAAC;AAEF,mBAAmB,8BAA8B,CAAC"}

package/dist/index.js

@@ -21,6 +21,15 @@ export const IndeRunCapacitor = {
             throw normalizePluginError(error);
         }
     },
+    async checkCapabilities() {
+        try {
+            const result = await IndeRunCapacitorNative.checkCapabilities();
+            return result.providers;
+        }
+        catch (error) {
+            throw normalizePluginError(error);
+        }
+    },
     async startStream(options) {
         try {
             return await IndeRunCapacitorNative.startStream(options);
@@ -62,6 +71,11 @@ export function createIndeRunCapacitor(options) {
         async stream(request) {
             await ensureConfigured();
             return IndeRunCapacitor.stream(request);
+        },
+        // Configures first: without a registry there are no providers to report on.
+        async checkCapabilities() {
+            await ensureConfigured();
+            return IndeRunCapacitor.checkCapabilities();
         }
     };
 }

package/dist/web.d.ts

@@ -1,6 +1,6 @@
 import type { StreamRunHandle, TaskResult } from "@independo/inderun-contracts";
 import { WebPlugin } from "@capacitor/core";
-import type { CancelStreamOptions, ConfigureOptions, IndeRunCapacitorPlugin, StartStreamOptions } from "./definitions.js";
+import type { CancelStreamOptions, CheckCapabilitiesResult, ConfigureOptions, IndeRunCapacitorPlugin, StartStreamOptions } from "./definitions.js";
 import type { TaskRequest } from "@independo/inderun-contracts";
 export declare class IndeRunWeb extends WebPlugin implements IndeRunCapacitorPlugin {
     private engine;
@@ -9,6 +9,7 @@ export declare class IndeRunWeb extends WebPlugin implements IndeRunCapacitorPlu
     private readonly pendingCancels;
     configure(options?: ConfigureOptions): Promise<void>;
     run(request: TaskRequest): Promise<TaskResult>;
+    checkCapabilities(): Promise<CheckCapabilitiesResult>;
     /**
      * The web path deliberately round-trips through `notifyListeners` rather than
      * handing the engine's `StreamRun` straight back.

package/dist/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE,qBAAa,UAAW,SAAQ,SAAU,YAAW,sBAAsB;IACzE,OAAO,CAAC,MAAM,CAAwB;IAItC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyC;IAElE,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BzD;IAEK,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAYnD;IAED;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8BvE;IAEK,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9D;YAEa,IAAI;CAenB"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,sBAAsB,EACtB,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAIhE,qBAAa,UAAW,SAAQ,SAAU,YAAW,sBAAsB;IACzE,OAAO,CAAC,MAAM,CAAwB;IAItC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyC;IAElE,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCzD;IAEK,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAYnD;IAEK,iBAAiB,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAe1D;IAED;;;;;;;;OAQG;IACG,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA8BvE;IAEK,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB9D;YAEa,IAAI;CAenB"}