@independo/capacitor-inderun 1.1.0-dev.3 → 1.1.0-dev.5

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"}

package/dist/web.js

@@ -10,13 +10,27 @@ export class IndeRunWeb extends WebPlugin {
     startingStreams = new Set();
     pendingCancels = new Map();
     async configure(options) {
-        if (!options?.openAI) {
-            throw createUnavailable("Capacitor web execution requires OpenAI provider registration. Configure with openAI bootstrap options before calling run(request).").toContractError();
+        // The web SDK requires at least one provider, not specifically the cloud one. Held
+        // here as well as there so the failure is an `Unavailable` contract error rather than
+        // a raw SDK throw, which is what the facade's callers expect.
+        if (!options?.openAI && !options?.systemModel && !options?.onnx) {
+            throw createUnavailable("Capacitor web execution requires at least one provider registration. Configure with openAI, systemModel and/or onnx bootstrap options before calling run(request).").toContractError();
         }
         try {
-            const webOptions = {
-                openAI: compactOpenAIOptions(options)
-            };
+            // The SDK's own option type, not a hand-written copy of it: an upstream rename
+            // then fails at the type level instead of silently dropping a field. This is
+            // deliberately the *outbound* shape only — `ConfigureOptions` stays a narrower,
+            // JSON-serializable subset, because it has to cross the native bridge hop.
+            const webOptions = {};
+            if (options.openAI !== undefined) {
+                webOptions.openAI = compactOpenAIOptions(options.openAI);
+            }
+            if (options.systemModel !== undefined) {
+                webOptions.systemModel = compactSystemModelOptions(options.systemModel);
+            }
+            if (options.onnx !== undefined) {
+                webOptions.onnx = compactOnnxOptions(options.onnx);
+            }
             if (options.allowDirectOpenAIEndpoint !== undefined) {
                 webOptions.allowDirectOpenAIEndpoint = options.allowDirectOpenAIEndpoint;
             }
@@ -37,6 +51,20 @@ export class IndeRunWeb extends WebPlugin {
             throw toIndeRunException(error).toContractError();
         }
     }
+    async checkCapabilities() {
+        if (!this.engine) {
+            throw createUnavailable("Capacitor IndeRun has not been configured. Configure providers before calling checkCapabilities().").toContractError();
+        }
+        try {
+            // Deliberately uncast: the engine's snapshots are assigned straight into the
+            // bridge's own `ProviderCapabilitySnapshot`, so the two declarations staying
+            // identical is a compile error rather than a convention. See definitions.ts.
+            return { providers: await this.engine.checkCapabilities() };
+        }
+        catch (error) {
+            throw toIndeRunException(error).toContractError();
+        }
+    }
     /**
      * The web path deliberately round-trips through `notifyListeners` rather than
      * handing the engine's `StreamRun` straight back.
@@ -101,8 +129,17 @@ export class IndeRunWeb extends WebPlugin {
         }
     }
 }
-function compactOpenAIOptions(options) {
-    const openAI = options.openAI;
+/**
+ * Assigns only the fields the caller actually set. `exactOptionalPropertyTypes` makes
+ * this incremental style mandatory rather than cosmetic: assigning `undefined` to an
+ * optional property is an error, and an explicit `undefined` on the wire is not the same
+ * thing as an absent key to the provider that reads it.
+ *
+ * `id`, `healthCheckTimeoutMs` and `healthCheckCacheMs` are deliberately not bridged —
+ * all optional, and the bridge has no reason to expose provider-tuning knobs it cannot
+ * also offer on native.
+ */
+function compactOpenAIOptions(openAI) {
     const result = {
         model: openAI.model
     };
@@ -120,3 +157,25 @@ function compactOpenAIOptions(options) {
     }
     return result;
 }
+function compactSystemModelOptions(systemModel) {
+    const result = {};
+    if (systemModel.id !== undefined) {
+        result.id = systemModel.id;
+    }
+    if (systemModel.timeoutMs !== undefined) {
+        result.timeoutMs = systemModel.timeoutMs;
+    }
+    return result;
+}
+function compactOnnxOptions(onnx) {
+    const result = {
+        modelPackage: onnx.modelPackage
+    };
+    if (onnx.id !== undefined) {
+        result.id = onnx.id;
+    }
+    if (onnx.timeoutMs !== undefined) {
+        result.timeoutMs = onnx.timeoutMs;
+    }
+    return result;
+}

package/ios/Sources/IndeRunCapacitorPlugin/IndeRunCapacitorBridge.swift

@@ -49,6 +49,22 @@ struct CapacitorCancelStreamOptions: Codable {
     let reason: String?
 }
 
+/// IndeRunCore's `ProviderCapabilitySnapshot` is `Sendable` but not `Codable`, even
+/// though both of its members are. This mirror exists only to get it through
+/// `JSONEncoder`; see the upstream follow-up asking for `Codable` (and a schema) on
+/// the snapshot itself.
+private struct EncodableCapabilitySnapshot: Encodable {
+    let providerId: String
+    let descriptor: ProviderDescriptor
+    let capabilities: ProviderDynamicCapabilities
+}
+
+/// A Capacitor plugin method must resolve an object, never a top-level array, so the
+/// snapshots travel wrapped. `IndeRunCapacitor` unwraps them on the JS side.
+private struct CapabilitiesEnvelope: Encodable {
+    let providers: [EncodableCapabilitySnapshot]
+}
+
 /// Called with an already-encoded event/error for one run. The plugin turns these
 /// into `notifyListeners` calls; taking them as closures keeps the pump testable
 /// without Capacitor.
@@ -82,6 +98,16 @@ final class IndeRunCapacitorBridge {
         return try encode(result)
     }
 
+    func checkCapabilities() async throws -> JSObject {
+        guard let registry = configuredRegistry, let hostServices = configuredHostServices else {
+            throw createUnavailable(message: "Capacitor IndeRun has not been configured. Configure providers before calling checkCapabilities().")
+        }
+
+        // IndeRun is a stateless coordinator; new per call is intentional — registry is cached above.
+        let engine = IndeRun(registry: registry, hostServices: hostServices)
+        return try encode(capabilities: await engine.checkCapabilities())
+    }
+
     func startStream(
         options: JSObject,
         onEvent: @escaping StreamEventSink,
@@ -173,6 +199,24 @@ final class IndeRunCapacitorBridge {
         try encodeObject(handle)
     }
 
+    /// The descriptor's enums carry explicit raw values (`in_process`, not `inProcess`),
+    /// and JSONEncoder omits nil optionals — so an unset `streamingAvailable` arrives as
+    /// an absent key rather than a null, which is what lets the JS side read absence as
+    /// "inherit `descriptor.supports.streaming`".
+    func encode(capabilities: [ProviderCapabilitySnapshot]) throws -> JSObject {
+        try encodeObject(
+            CapabilitiesEnvelope(
+                providers: capabilities.map {
+                    EncodableCapabilitySnapshot(
+                        providerId: $0.providerId,
+                        descriptor: $0.descriptor,
+                        capabilities: $0.capabilities
+                    )
+                }
+            )
+        )
+    }
+
     private func makeRegistry(openAI: OpenAIProviderBootstrapOptions?) throws -> ProviderRegistry {
         let registry = ProviderRegistry()
         try registry.register(AppleFoundationModelsProvider())
@@ -222,10 +266,26 @@ final class IndeRunCapacitorBridge {
     private func encodeObject<T: Encodable>(_ value: T) throws -> JSObject {
         let data = try JSONEncoder().encode(value)
         let object = try JSONSerialization.jsonObject(with: data, options: [])
+
+        #if canImport(Capacitor)
+        // Capacitor's JSObject is [String: any JSValue], and a plain `as?` cast cannot
+        // produce one: JSONSerialization hands back NSDictionary/NSArray values, which do
+        // not conform to JSValue, so anything with a nested object or array — a TaskResult's
+        // `output`, a stream event's `payload`, the providers array — failed the cast and
+        // surfaced as "Capacitor bridge failed to encode a JSON object". JSTypes coerces the
+        // tree recursively, which is what the cast was standing in for.
+        guard let dictionary = object as? [AnyHashable: Any],
+              let coerced = JSTypes.coerceDictionaryToJSObject(dictionary) else {
+            throw createInternal(message: "Capacitor bridge failed to encode a JSON object.")
+        }
+        return coerced
+        #else
+        // Standalone builds alias JSObject to [String: Any], where the cast is exact.
         guard let dictionary = object as? JSObject else {
             throw createInternal(message: "Capacitor bridge failed to encode a JSON object.")
         }
         return dictionary
+        #endif
     }
 
     func mapAuthMode(_ value: String?) -> OpenAIAuthMode {

package/ios/Sources/IndeRunCapacitorPlugin/IndeRunCapacitorPlugin.swift

@@ -10,6 +10,7 @@ public final class IndeRunCapacitorPlugin: CAPPlugin, CAPBridgedPlugin {
     public let pluginMethods: [CAPPluginMethod] = [
         CAPPluginMethod(name: "configure", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "run", returnType: CAPPluginReturnPromise),
+        CAPPluginMethod(name: "checkCapabilities", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "startStream", returnType: CAPPluginReturnPromise),
         CAPPluginMethod(name: "cancelStream", returnType: CAPPluginReturnPromise)
     ]
@@ -25,7 +26,7 @@ public final class IndeRunCapacitorPlugin: CAPPlugin, CAPBridgedPlugin {
 
     @objc func configure(_ call: CAPPluginCall) {
         do {
-            try implementation.configure(options: call.options)
+            try implementation.configure(options: call.jsObjectRepresentation)
             call.resolve()
         } catch let error as IndeRunException {
             let contractError = error.toContractError()
@@ -42,7 +43,7 @@ public final class IndeRunCapacitorPlugin: CAPPlugin, CAPBridgedPlugin {
     @objc func run(_ call: CAPPluginCall) {
         Task {
             do {
-                let result = try await implementation.run(requestObject: call.options)
+                let result = try await implementation.run(requestObject: call.jsObjectRepresentation)
                 call.resolve(result)
             } catch let error as IndeRunException {
                 let contractError = error.toContractError()
@@ -57,6 +58,26 @@ public final class IndeRunCapacitorPlugin: CAPPlugin, CAPBridgedPlugin {
         }
     }
 
+    /// Reports every registered provider's static declaration and live availability
+    /// without executing a task. Availability changes between calls — a local model can
+    /// unload, cloud credentials can expire — so callers must not cache it across a run.
+    @objc func checkCapabilities(_ call: CAPPluginCall) {
+        Task {
+            do {
+                call.resolve(try await implementation.checkCapabilities())
+            } catch let error as IndeRunException {
+                let contractError = error.toContractError()
+                let details = try? implementation.encode(error: contractError)
+                call.reject(contractError.message, contractError.errorClass.rawValue, error, details)
+            } catch {
+                let normalized = toIndeRunException(error)
+                let contractError = normalized.toContractError()
+                let details = try? implementation.encode(error: contractError)
+                call.reject(contractError.message, contractError.errorClass.rawValue, normalized, details)
+            }
+        }
+    }
+
     /// Resolves with the run handle. Only validation and route-selection failures
     /// reject here; a provider failure, a cancellation, or completion all arrive as
     /// the single terminal event on `indeRunStreamEvent`.
@@ -69,7 +90,7 @@ public final class IndeRunCapacitorPlugin: CAPPlugin, CAPBridgedPlugin {
             guard let self else { return }
             do {
                 let handle = try await self.implementation.startStream(
-                    options: call.options,
+                    options: call.jsObjectRepresentation,
                     onEvent: { [weak self] streamId, event in
                         self?.notifyListeners(
                             "indeRunStreamEvent",
@@ -103,7 +124,7 @@ public final class IndeRunCapacitorPlugin: CAPPlugin, CAPBridgedPlugin {
     /// is a no-op by contract, not an error.
     @objc func cancelStream(_ call: CAPPluginCall) {
         do {
-            try implementation.cancelStream(options: call.options)
+            try implementation.cancelStream(options: call.jsObjectRepresentation)
             call.resolve()
         } catch let error as IndeRunException {
             let contractError = error.toContractError()