@independo/inderun-web 0.3.0-dev.4 → 0.3.0-dev.5

package/dist/core/engine.d.ts

@@ -54,13 +54,18 @@ export declare class IndeRun implements IndeRunApi {
     /**
      * Orchestrates a Mode 2 streaming execution of a TaskRequest.
      *
-     * Reuses the same route selection as run(), restricted to providers that declare
-     * `supports.streaming` and implement `stream()`. Fallback to the next provider is
-     * allowed only before the first content event has been admitted for the run; once
-     * one has been delivered, the run is committed to that provider and any later
-     * provider failure becomes a terminal error outcome rather than a silent provider
-     * swap. Cancellation always forecloses fallback, regardless of commit state, and
-     * is idempotent.
+     * Routes through the same planner as run(), asking it for a `stream` route: the
+     * planner rejects providers that do not declare `supports.streaming` or whose
+     * dynamic capability snapshot says they cannot stream here, and reports why. The
+     * whole returned chain is therefore mode-compatible and subject to the same
+     * privacy, locality, availability, and policy constraints as a Mode 1 route.
+     *
+     * Fallback to the next provider is allowed only before the first content event
+     * has been admitted for the run; once one has been delivered, the run is
+     * committed to that provider and any later provider failure becomes a terminal
+     * error outcome rather than a silent provider swap — partial output spliced from
+     * two providers is undetectable to the caller. Cancellation always forecloses
+     * fallback, regardless of commit state, and is idempotent.
      * @param request - The canonical task request containing prompts, tasks, and constraints.
      * @throws {IndeRunException} If validation fails or no eligible streaming provider exists.
      */

package/dist/core/engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAmB,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAQjD,OAAO,EAAuB,KAAK,gBAAgB,EAAwB,MAAM,gBAAgB,CAAC;AAGlG;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,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;;;;GAIG;AACH,qBAAa,OAAQ,YAAW,UAAU;IAWtC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;IAXtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAmB;IAE3C;;;;;OAKG;gBAEO,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,YAAY,EAClC,gBAAgB,CAAC,EAAE,gBAAgB;IAOrC;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAShB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;;;;;;OAOG;IACG,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAuIpD;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsQ/D;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;CASjE"}
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../src/core/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,eAAe,EAEpB,KAAK,WAAW,EAChB,KAAK,UAAU,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAmB,0BAA0B,EAAE,MAAM,eAAe,CAAC;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAQjD,OAAO,EAAuB,KAAK,gBAAgB,EAAwB,MAAM,gBAAgB,CAAC;AAGlG;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,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;;;;GAIG;AACH,qBAAa,OAAQ,YAAW,UAAU;IAWtC,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,YAAY;IAXtB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAmB;IAE3C;;;;;OAKG;gBAEO,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,EAAE,YAAY,EAClC,gBAAgB,CAAC,EAAE,gBAAgB;IAOrC;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAShB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAoBxB;;;;;;;OAOG;IACG,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAuIpD;;;;;;;;;;;;;;;;;OAiBG;IACG,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA8Q/D;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;CASjE"}

package/dist/core/engine.js

@@ -87,7 +87,7 @@ export class IndeRun {
                 });
             }
             // 2. Select the route based on constraints and host capabilities
-            const routeSelection = await this.router.selectRoute(request, this.hostServices);
+            const routeSelection = await this.router.selectRoute(request, this.hostServices, "run");
             const providers = [routeSelection.provider, ...routeSelection.fallbackProviders];
             // Emit route_decided event
             this.safeEmit({
@@ -194,13 +194,18 @@ export class IndeRun {
     /**
      * Orchestrates a Mode 2 streaming execution of a TaskRequest.
      *
-     * Reuses the same route selection as run(), restricted to providers that declare
-     * `supports.streaming` and implement `stream()`. Fallback to the next provider is
-     * allowed only before the first content event has been admitted for the run; once
-     * one has been delivered, the run is committed to that provider and any later
-     * provider failure becomes a terminal error outcome rather than a silent provider
-     * swap. Cancellation always forecloses fallback, regardless of commit state, and
-     * is idempotent.
+     * Routes through the same planner as run(), asking it for a `stream` route: the
+     * planner rejects providers that do not declare `supports.streaming` or whose
+     * dynamic capability snapshot says they cannot stream here, and reports why. The
+     * whole returned chain is therefore mode-compatible and subject to the same
+     * privacy, locality, availability, and policy constraints as a Mode 1 route.
+     *
+     * Fallback to the next provider is allowed only before the first content event
+     * has been admitted for the run; once one has been delivered, the run is
+     * committed to that provider and any later provider failure becomes a terminal
+     * error outcome rather than a silent provider swap — partial output spliced from
+     * two providers is undetectable to the caller. Cancellation always forecloses
+     * fallback, regardless of commit state, and is idempotent.
      * @param request - The canonical task request containing prompts, tasks, and constraints.
      * @throws {IndeRunException} If validation fails or no eligible streaming provider exists.
      */
@@ -215,9 +220,17 @@ export class IndeRun {
                 .join("; ")}`;
             throw createInternal(message, { runId, details: { validationIssues } });
         }
-        const routeSelection = await this.router.selectRoute(request, this.hostServices);
-        const allProviders = [routeSelection.provider, ...routeSelection.fallbackProviders];
-        const providers = allProviders.filter((p) => p.describe().supports.streaming && typeof p.stream === "function");
+        // Route selection failures are the one class of stream error that surfaces as a
+        // rejected promise instead of a terminal event, so they must still carry the
+        // runId — there is no handle for the caller to correlate them with otherwise.
+        let routeSelection;
+        try {
+            routeSelection = await this.router.selectRoute(request, this.hostServices, "stream");
+        }
+        catch (error) {
+            throw toIndeRunException(error, { runId });
+        }
+        const providers = [routeSelection.provider, ...routeSelection.fallbackProviders];
         this.safeEmit({
             type: "route_decided",
             runId,
@@ -235,6 +248,9 @@ export class IndeRun {
                 plannerUnavailableReason: routeSelection.plannerUnavailableReason ?? null
             }
         });
+        // Defensive only: streaming eligibility is decided by the route planner, which
+        // throws with its own rejection reasons when nothing can stream. Reaching here
+        // means a planned provider was unregistered between planning and selection.
         if (providers.length === 0) {
             throw createCapabilityMismatch("No eligible provider supports streaming for this request.", {
                 runId,

package/dist/core/provider.d.ts

@@ -82,6 +82,25 @@ export interface ProviderDynamicCapabilities {
      * Detail message if availability check fails.
      */
     reason?: string;
+    /**
+     * Whether the provider can stream (Mode 2) right now on this host. Leave
+     * undefined to inherit the static `descriptor.supports.streaming` value —
+     * only set it when the runtime environment can take streaming away from a
+     * provider that otherwise declares it (e.g. the host has no chunked HTTP
+     * capability).
+     */
+    streamingAvailable?: boolean;
+    /**
+     * Detail message used when `streamingAvailable` is false. Omit to let the
+     * route planner synthesize a generic message.
+     */
+    streamingUnavailableReason?: string;
+    /**
+     * Whether cancellation is honored right now on this host. Leave undefined to
+     * inherit the static `descriptor.cancel` value (anything other than `"none"`
+     * means available).
+     */
+    cancellationAvailable?: boolean;
 }
 /**
  * One registered provider's identity, fixed capabilities, and live availability,

package/dist/core/provider.d.ts.map

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

package/dist/core/route-planner.d.ts

@@ -2,6 +2,11 @@ import type { RoutePlan as SharedPlannerRoutePlan, RoutePlannerInput as SharedPl
 import type { HostServices } from "./host.js";
 import type { ProviderAdapter } from "./provider.js";
 export type { SharedPlannerInput, SharedPlannerRoutePlan };
+/**
+ * Interaction mode the caller is requesting a route for. Passed to the shared
+ * planner, which rejects providers that cannot satisfy it.
+ */
+export type InteractionMode = NonNullable<SharedPlannerInput["interactionMode"]>;
 /**
  * Minimal shape of the shared route-core module (the WASM wrapper), used to
  * plan routes via JSON in/JSON out. `initSharedCore` initializes the WASM
@@ -73,5 +78,5 @@ export declare function collectProviderRuntimeSnapshots(registryProviders: Provi
  * consumes, applying default constraints/preferences and the current network
  * state.
  */
-export declare function buildSharedPlannerInput(request: TaskRequest, snapshots: ProviderRuntimeSnapshot[], networkOnline: boolean): SharedPlannerInput;
+export declare function buildSharedPlannerInput(request: TaskRequest, snapshots: ProviderRuntimeSnapshot[], networkOnline: boolean, interactionMode?: InteractionMode): SharedPlannerInput;
 //# sourceMappingURL=route-planner.d.ts.map

package/dist/core/route-planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-planner.d.ts","sourceRoot":"","sources":["../../src/core/route-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,IAAI,sBAAsB,EACnC,iBAAiB,IAAI,kBAAkB,EACvC,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC/B,eAAe,GAAG,sBAAsB,GAAG,aAAa,GAAG,aAAa,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IAC/B,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/D;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAClE,YAAY,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;CACvE;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,aAAa,CAAC,CAAsC;IAC5D,OAAO,CAAC,iBAAiB,CAAC,CAAwB;IAClD,OAAO,CAAC,SAAS,CAAS;IAEpB,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;YAkBrD,UAAU;YAOV,YAAY;IA6B1B,OAAO,CAAC,QAAQ;CAUjB;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,iBAAiB,EAAE,eAAe,EAAE,EACpC,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAepC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,uBAAuB,EAAE,EACpC,aAAa,EAAE,OAAO,GACrB,kBAAkB,CAsBpB"}
+{"version":3,"file":"route-planner.d.ts","sourceRoot":"","sources":["../../src/core/route-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,IAAI,sBAAsB,EACnC,iBAAiB,IAAI,kBAAkB,EACvC,WAAW,EACZ,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,CAAC,CAAC;AAEjF;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChE;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC/B,eAAe,GAAG,sBAAsB,GAAG,aAAa,GAAG,aAAa,CAAC;AAE3E;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IAC/B,iBAAiB,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAC/D;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAClE,YAAY,EAAE,kBAAkB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,CAAC;CACvE;AAED;;;;;;;;;GASG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACnD,OAAO,CAAC,aAAa,CAAC,CAAsC;IAC5D,OAAO,CAAC,iBAAiB,CAAC,CAAwB;IAClD,OAAO,CAAC,SAAS,CAAS;IAEpB,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,cAAc,CAAC;YAkBrD,UAAU;YAOV,YAAY;IA6B1B,OAAO,CAAC,QAAQ;CAUjB;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,iBAAiB,EAAE,eAAe,EAAE,EACpC,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAepC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,WAAW,EACpB,SAAS,EAAE,uBAAuB,EAAE,EACpC,aAAa,EAAE,OAAO,EACtB,eAAe,GAAE,eAAuB,GACvC,kBAAkB,CAuBpB"}

package/dist/core/route-planner.js

@@ -81,7 +81,7 @@ export async function collectProviderRuntimeSnapshots(registryProviders, hostSer
         return {
             provider,
             descriptor: toSharedPlannerDescriptor(descriptor),
-            capabilities: toSharedPlannerCapabilities(capabilities)
+            capabilities: toSharedPlannerCapabilities(capabilities, descriptor, provider)
         };
     }));
     return snapshots.sort((left, right) => left.descriptor.id.localeCompare(right.descriptor.id));
@@ -91,13 +91,14 @@ export async function collectProviderRuntimeSnapshots(registryProviders, hostSer
  * consumes, applying default constraints/preferences and the current network
  * state.
  */
-export function buildSharedPlannerInput(request, snapshots, networkOnline) {
+export function buildSharedPlannerInput(request, snapshots, networkOnline, interactionMode = "run") {
     const constraints = request.constraints ?? {};
     const preferences = request.preferences ?? {};
     return {
         task: {
             kind: request.task.kind
         },
+        interactionMode,
         constraints: {
             privacy: constraints.privacy ?? "cloud_allowed",
             cloud: constraints.cloud ?? "allowed",
@@ -118,8 +119,10 @@ function toSharedPlannerDescriptor(descriptor) {
         id: descriptor.id,
         type: descriptor.type,
         supports: {
-            run: descriptor.supports.run
+            run: descriptor.supports.run,
+            streaming: descriptor.supports.streaming
         },
+        cancel: descriptor.cancel,
         tasks: descriptor.tasks,
         ...(descriptor.privacy
             ? {
@@ -131,9 +134,30 @@ function toSharedPlannerDescriptor(descriptor) {
             : {})
     };
 }
-function toSharedPlannerCapabilities(capabilities) {
+/**
+ * Projects the dynamic capability snapshot for the planner.
+ *
+ * `stream()` being absent from the adapter is folded in here rather than
+ * filtered out downstream: an adapter that declares `supports.streaming` but
+ * never implemented the method is not streaming-capable, and saying so as a
+ * planner-visible reason is what lets the route explanation name the provider
+ * instead of silently dropping it.
+ */
+function toSharedPlannerCapabilities(capabilities, descriptor, provider) {
+    const declaresStreaming = capabilities.streamingAvailable ?? descriptor.supports.streaming;
+    const implementsStream = typeof provider.stream === "function";
+    const streamingAvailable = declaresStreaming && implementsStream;
+    const streamingUnavailableReason = capabilities.streamingUnavailableReason ??
+        (declaresStreaming && !implementsStream
+            ? `Provider '${descriptor.id}' declares streaming but does not implement stream().`
+            : undefined);
     return {
         available: capabilities.available,
-        ...(capabilities.reason ? { reason: capabilities.reason } : {})
+        ...(capabilities.reason ? { reason: capabilities.reason } : {}),
+        streamingAvailable,
+        ...(!streamingAvailable && streamingUnavailableReason ? { streamingUnavailableReason } : {}),
+        ...(capabilities.cancellationAvailable !== undefined
+            ? { cancellationAvailable: capabilities.cancellationAvailable }
+            : {})
     };
 }

package/dist/core/router.d.ts

@@ -2,7 +2,7 @@ import type { TaskRequest } from "@independo/inderun-contracts";
 import type { HostServices } from "./host.js";
 import type { ProviderAdapter } from "./provider.js";
 import type { ProviderRegistry } from "./registry.js";
-import { type RoutePlanner, type SharedPlannerRoutePlan, type WasmUnavailableReason } from "./route-planner.js";
+import { type InteractionMode, type RoutePlanner, type SharedPlannerRoutePlan, type WasmUnavailableReason } from "./route-planner.js";
 /**
  * Output structure from the Router containing the chosen provider and a route selection description.
  */
@@ -52,13 +52,47 @@ export declare class Router {
      *  - `CapabilityMismatch` when `execution === 'on_device'` but no local provider is registered or available.
      *  - `Offline` when `execution === 'cloud'` but the device lacks internet connectivity.
      *  - `Unavailable` when `execution === 'cloud'` but no cloud provider is registered or functional.
+     *
+     * The requested `interactionMode` is a planning input, not a post-filter: the
+     * shared planner rejects providers that cannot satisfy it and says why, so the
+     * whole returned chain is mode-compatible.
      */
-    selectRoute(request: TaskRequest, hostServices: HostServices): Promise<RouteSelection>;
+    selectRoute(request: TaskRequest, hostServices: HostServices, interactionMode?: InteractionMode): Promise<RouteSelection>;
     private selectFromSharedPlan;
     private selectFallbackRoute;
     private buildSelectionFromRoutePlan;
+    /**
+     * Hand-written mirror of the shared Rust planner (`rust/inderun-route-core/src/planner.rs`),
+     * used when the WASM core cannot be loaded. It reproduces the same rejection
+     * codes and messages so route explanations stay comparable across both paths.
+     *
+     * Known, deliberate divergence: this mirror keeps the id-sorted snapshot order
+     * instead of reproducing the Rust placement/preference ranks, so `optimizeFor`
+     * does not influence ordering here.
+     */
     private createFallbackPlan;
+    /**
+     * Mirrors `infer_failure_code` in the shared Rust planner. The offline class is
+     * derived from the rejection reasons rather than from the connectivity flag
+     * alone: an offline host whose only provider is local and non-streaming failed
+     * on capability, not on connectivity, and reporting `Offline` there would
+     * contradict the explanation shipped alongside it.
+     */
+    private inferFallbackFailureCode;
+    /**
+     * Mirrors `evaluate_provider` in the shared Rust planner: it accumulates every
+     * violated rule rather than short-circuiting, so a rejected provider carries a
+     * complete explanation. The streaming checks are ordered static-before-dynamic
+     * for the same reason as in Rust — a provider that never declared streaming
+     * must not also be reported as dynamically unavailable.
+     */
+    private evaluateFallbackCandidate;
     private buildFallbackFailureSummary;
+    /**
+     * Routing failure throws before any `route_decided` telemetry is emitted, so the
+     * plan's diagnostics are attached to the exception — that is the only channel
+     * through which a caller learns *why* each provider was rejected.
+     */
     private routePlanFailure;
 }
 //# sourceMappingURL=router.d.ts.map

package/dist/core/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/core/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOtD,OAAO,EAIL,KAAK,YAAY,EAEjB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAE3B,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;IAC1B;;OAEG;IACH,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC;;OAEG;IACH,SAAS,EAAE,sBAAsB,CAAC;IAClC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,qBAAqB,CAAC;CAClD;AAED;;;;GAIG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;gBADP,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE,YAAqC;IAGxD;;;;;;;;;OASG;IACG,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC;IAc5F,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,2BAA2B;IA2BnC,OAAO,CAAC,kBAAkB;IA0F1B,OAAO,CAAC,2BAA2B;IAiCnC,OAAO,CAAC,gBAAgB;CAYzB"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/core/router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAOtD,OAAO,EAGL,KAAK,eAAe,EAEpB,KAAK,YAAY,EAEjB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAE3B,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;IAC1B;;OAEG;IACH,iBAAiB,EAAE,eAAe,EAAE,CAAC;IACrC;;OAEG;IACH,SAAS,EAAE,sBAAsB,CAAC;IAClC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,UAAU,CAAC;IACnC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,qBAAqB,CAAC;CAClD;AAED;;;;GAIG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,OAAO;gBADP,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,GAAE,YAAqC;IAGxD;;;;;;;;;;;;;OAaG;IACG,WAAW,CACf,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,YAAY,EAC1B,eAAe,GAAE,eAAuB,GACvC,OAAO,CAAC,cAAc,CAAC;IAoB1B,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,2BAA2B;IA2BnC;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAwE1B;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAsBhC;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IA4FjC,OAAO,CAAC,2BAA2B;IAyCnC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CAkBzB"}

package/dist/core/router.js

@@ -21,16 +21,20 @@ export class Router {
      *  - `CapabilityMismatch` when `execution === 'on_device'` but no local provider is registered or available.
      *  - `Offline` when `execution === 'cloud'` but the device lacks internet connectivity.
      *  - `Unavailable` when `execution === 'cloud'` but no cloud provider is registered or functional.
+     *
+     * The requested `interactionMode` is a planning input, not a post-filter: the
+     * shared planner rejects providers that cannot satisfy it and says why, so the
+     * whole returned chain is mode-compatible.
      */
-    async selectRoute(request, hostServices) {
+    async selectRoute(request, hostServices, interactionMode = "run") {
         const online = await hostServices.connectivity.isOnline();
         const snapshots = await collectProviderRuntimeSnapshots(this.registry.list(), hostServices);
-        const planInput = buildSharedPlannerInput(request, snapshots, online);
+        const planInput = buildSharedPlannerInput(request, snapshots, online, interactionMode);
         const outcome = await this.planner.planRoute(planInput);
         if (outcome.routePlan) {
             return this.selectFromSharedPlan(snapshots, outcome.routePlan);
         }
-        return this.selectFallbackRoute(request, snapshots, online, outcome.unavailableReason);
+        return this.selectFallbackRoute(request, snapshots, online, interactionMode, outcome.unavailableReason);
     }
     selectFromSharedPlan(snapshots, routePlan) {
         if (!routePlan.selectedProviderId) {
@@ -38,8 +42,8 @@ export class Router {
         }
         return this.buildSelectionFromRoutePlan(snapshots, routePlan, "wasm");
     }
-    selectFallbackRoute(request, snapshots, online, plannerUnavailableReason) {
-        const plan = this.createFallbackPlan(request, snapshots, online);
+    selectFallbackRoute(request, snapshots, online, interactionMode, plannerUnavailableReason) {
+        const plan = this.createFallbackPlan(request, snapshots, online, interactionMode);
         if (!plan.selectedProviderId) {
             throw this.routePlanFailure(plan);
         }
@@ -62,58 +66,48 @@ export class Router {
             ...(plannerUnavailableReason ? { plannerUnavailableReason } : {})
         };
     }
-    createFallbackPlan(request, snapshots, online) {
-        const planInput = buildSharedPlannerInput(request, snapshots, online);
-        const eligible = snapshots
-            .filter((candidate) => candidate.descriptor.tasks.includes(planInput.task.kind))
-            .filter((candidate) => candidate.descriptor.supports.run);
+    /**
+     * Hand-written mirror of the shared Rust planner (`rust/inderun-route-core/src/planner.rs`),
+     * used when the WASM core cannot be loaded. It reproduces the same rejection
+     * codes and messages so route explanations stay comparable across both paths.
+     *
+     * Known, deliberate divergence: this mirror keeps the id-sorted snapshot order
+     * instead of reproducing the Rust placement/preference ranks, so `optimizeFor`
+     * does not influence ordering here.
+     */
+    createFallbackPlan(request, snapshots, online, interactionMode) {
+        const planInput = buildSharedPlannerInput(request, snapshots, online, interactionMode);
+        const eligible = snapshots.filter((candidate) => candidate.descriptor.tasks.includes(planInput.task.kind));
         const localCandidates = eligible.filter((candidate) => candidate.descriptor.type !== "cloud");
         const cloudCandidates = eligible.filter((candidate) => candidate.descriptor.type === "cloud");
         // Constraint filtering must apply to the whole candidate list, not just the selected provider:
         // the remainder becomes the engine's fallback chain, and a fallback that violates the request
         // constraints would let a `local_required` run be retried against a cloud provider.
-        const admissible = eligible.filter((candidate) => {
-            const descriptor = candidate.descriptor;
-            const constraints = planInput.constraints;
-            // Mirrors `is_data_private` in the shared Rust planner: a provider is private when it
-            // declares that data does not leave the device, defaulting to non-cloud providers.
-            const isDataPrivate = descriptor.privacy
-                ? !descriptor.privacy.dataLeavesDevice
-                : descriptor.type !== "cloud";
-            if (constraints.cloud === "forbidden" && descriptor.type === "cloud") {
-                return false;
-            }
-            if (constraints.cloud === "required" && descriptor.type !== "cloud") {
-                return false;
-            }
-            if (constraints.privacy === "local_required" && !isDataPrivate) {
-                return false;
-            }
-            if (constraints.privacy === "cloud_required" && descriptor.type !== "cloud") {
-                return false;
+        const admissible = [];
+        const rejectedProviders = [];
+        for (const candidate of snapshots) {
+            const reasons = this.evaluateFallbackCandidate(candidate, planInput, interactionMode);
+            if (reasons.length === 0) {
+                admissible.push(candidate);
             }
-            if (!online && descriptor.type === "cloud") {
-                return false;
+            else {
+                rejectedProviders.push({ providerId: candidate.descriptor.id, reasons });
             }
-            return candidate.capabilities.available;
-        });
+        }
         if (admissible.length === 0) {
             const failureSummary = this.buildFallbackFailureSummary({
                 online,
+                interactionMode,
+                taskKind: planInput.task.kind,
                 constraints: planInput.constraints,
                 localCandidates,
                 cloudCandidates
             });
-            const failureCode = !online
-                ? "offline"
-                : planInput.constraints.cloud === "required" ||
-                    planInput.constraints.privacy === "cloud_required"
-                    ? "unavailable"
-                    : "capability_mismatch";
+            const failureCode = this.inferFallbackFailureCode(planInput, rejectedProviders);
             return {
                 fallbackProviderIds: [],
                 candidates: [],
-                rejectedProviders: [],
+                rejectedProviders,
                 failureCode,
                 explanation: {
                     summary: failureSummary
@@ -121,6 +115,9 @@ export class Router {
             };
         }
         const selectedProviderId = admissible[0]?.descriptor.id;
+        const summary = interactionMode === "stream"
+            ? `Selected streaming provider '${selectedProviderId}' deterministically from ${admissible.length} eligible candidate(s).`
+            : `Selected provider '${selectedProviderId}' deterministically from ${admissible.length} eligible candidate(s).`;
         return {
             selectedProviderId,
             fallbackProviderIds: admissible.slice(1).map((candidate) => candidate.descriptor.id),
@@ -128,13 +125,113 @@ export class Router {
                 providerId: candidate.descriptor.id,
                 order: index
             })),
-            rejectedProviders: [],
+            rejectedProviders,
             explanation: {
-                summary: `Selected provider '${selectedProviderId}' deterministically from ${admissible.length} eligible candidate(s).`,
+                summary,
                 selectedProviderId
             }
         };
     }
+    /**
+     * Mirrors `infer_failure_code` in the shared Rust planner. The offline class is
+     * derived from the rejection reasons rather than from the connectivity flag
+     * alone: an offline host whose only provider is local and non-streaming failed
+     * on capability, not on connectivity, and reporting `Offline` there would
+     * contradict the explanation shipped alongside it.
+     */
+    inferFallbackFailureCode(planInput, rejectedProviders) {
+        if (rejectedProviders.some((rejected) => rejected.reasons.some((reason) => reason.code === "offline"))) {
+            return "offline";
+        }
+        if (planInput.constraints.cloud === "required" ||
+            planInput.constraints.privacy === "cloud_required") {
+            return "unavailable";
+        }
+        return "capability_mismatch";
+    }
+    /**
+     * Mirrors `evaluate_provider` in the shared Rust planner: it accumulates every
+     * violated rule rather than short-circuiting, so a rejected provider carries a
+     * complete explanation. The streaming checks are ordered static-before-dynamic
+     * for the same reason as in Rust — a provider that never declared streaming
+     * must not also be reported as dynamically unavailable.
+     */
+    evaluateFallbackCandidate(candidate, planInput, interactionMode) {
+        const descriptor = candidate.descriptor;
+        const capabilities = candidate.capabilities;
+        const constraints = planInput.constraints;
+        const wantsStream = interactionMode === "stream";
+        const reasons = [];
+        // Mirrors `is_data_private` in the shared Rust planner: a provider is private when it
+        // declares that data does not leave the device, defaulting to non-cloud providers.
+        const isDataPrivate = descriptor.privacy
+            ? !descriptor.privacy.dataLeavesDevice
+            : descriptor.type !== "cloud";
+        if (!descriptor.tasks.includes(planInput.task.kind)) {
+            reasons.push({
+                code: "task_not_supported",
+                message: `Provider '${descriptor.id}' does not support task '${planInput.task.kind}'.`
+            });
+        }
+        if (!wantsStream && !descriptor.supports.run) {
+            reasons.push({
+                code: "run_not_supported",
+                message: `Provider '${descriptor.id}' does not support run().`
+            });
+        }
+        if (wantsStream) {
+            if (!descriptor.supports.streaming) {
+                reasons.push({
+                    code: "streaming_not_supported",
+                    message: `Provider '${descriptor.id}' does not support streaming (Mode 2).`
+                });
+            }
+            else if (capabilities.streamingAvailable === false) {
+                reasons.push({
+                    code: "streaming_unavailable",
+                    message: capabilities.streamingUnavailableReason ??
+                        `Provider '${descriptor.id}' cannot stream in the current host environment.`
+                });
+            }
+        }
+        if (constraints.privacy === "local_required" && !isDataPrivate) {
+            reasons.push({
+                code: "privacy_constraint",
+                message: `Provider '${descriptor.id}' does not satisfy local-required privacy.`
+            });
+        }
+        if (constraints.privacy === "cloud_required" && descriptor.type !== "cloud") {
+            reasons.push({
+                code: "privacy_constraint",
+                message: `Provider '${descriptor.id}' does not satisfy cloud-required privacy.`
+            });
+        }
+        if (constraints.cloud === "forbidden" && descriptor.type === "cloud") {
+            reasons.push({
+                code: "cloud_constraint",
+                message: `Provider '${descriptor.id}' is cloud-based but cloud execution is forbidden.`
+            });
+        }
+        if (constraints.cloud === "required" && descriptor.type !== "cloud") {
+            reasons.push({
+                code: "cloud_constraint",
+                message: `Provider '${descriptor.id}' is not cloud-based but cloud execution is required.`
+            });
+        }
+        if (constraints.networkOnline === false && descriptor.type === "cloud") {
+            reasons.push({
+                code: "offline",
+                message: `Provider '${descriptor.id}' requires cloud connectivity, but the host is offline.`
+            });
+        }
+        if (!capabilities.available) {
+            reasons.push({
+                code: "capability_unavailable",
+                message: capabilities.reason ?? `Provider '${descriptor.id}' is currently unavailable.`
+            });
+        }
+        return reasons;
+    }
     buildFallbackFailureSummary(input) {
         const wantsCloud = input.constraints.cloud === "required" || input.constraints.privacy === "cloud_required";
         const wantsLocal = input.constraints.privacy === "local_required";
@@ -153,18 +250,34 @@ export class Router {
             }
             return "No on-device provider is currently available.";
         }
+        if (input.interactionMode === "stream") {
+            // Kept verbatim in sync with the shared Rust planner's stream-mode failure
+            // summary so the message a caller sees does not depend on which planner ran.
+            return `No provider capable of streaming was found for task '${input.taskKind}'.`;
+        }
         return "No eligible provider found for the current routing constraints.";
     }
+    /**
+     * Routing failure throws before any `route_decided` telemetry is emitted, so the
+     * plan's diagnostics are attached to the exception — that is the only channel
+     * through which a caller learns *why* each provider was rejected.
+     */
     routePlanFailure(routePlan) {
         const message = routePlan.explanation.summary;
+        const details = {
+            details: {
+                failureCode: routePlan.failureCode,
+                rejectedProviders: routePlan.rejectedProviders
+            }
+        };
         switch (routePlan.failureCode) {
             case "offline":
-                throw createOffline(message);
+                throw createOffline(message, details);
             case "unavailable":
-                throw createUnavailable(message);
+                throw createUnavailable(message, details);
             case "capability_mismatch":
             default:
-                throw createCapabilityMismatch(message);
+                throw createCapabilityMismatch(message, details);
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@independo/inderun-web",
-  "version": "0.3.0-dev.4",
+  "version": "0.3.0-dev.5",
   "description": "TypeScript/Web SDK for IndeRun.",
   "license": "MIT",
   "author": {
@@ -55,8 +55,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@independo/inderun-contracts": "^0.3.0-dev.4",
-    "@independo/inderun-route-core-wasm": "^0.3.0-dev.4"
+    "@independo/inderun-contracts": "^0.3.0-dev.5",
+    "@independo/inderun-route-core-wasm": "^0.3.0-dev.5"
   },
   "peerDependencies": {
     "@huggingface/transformers": "^4.0.0"