@independo/inderun-web 0.3.0-dev.1 → 0.3.0-dev.3

package/dist/core/engine.d.ts

@@ -1,9 +1,20 @@
-import { type TaskRequest, type TaskResult } from "@independo/inderun-contracts";
+import { type StreamEvent, type StreamRunHandle, type TaskRequest, type TaskResult } from "@independo/inderun-contracts";
 import type { HostServices } from "./host.js";
 import type { ProviderCapabilitySnapshot } from "./provider.js";
 import type { IndeRunApi } from "./generated/inderun-api.js";
 import { ProviderRegistry } from "./registry.js";
 import { type TelemetryService } from "./telemetry.js";
+/**
+ * Handle returned by IndeRun.stream(). `events` is the canonical StreamEvent
+ * sequence for this run, terminating in exactly one terminal StreamEvent per the
+ * Event Gate's guarantee. `cancel()` is idempotent: repeated or concurrent calls
+ * produce exactly one `cancelled` terminal outcome.
+ */
+export interface StreamHandleResult {
+    handle: StreamRunHandle;
+    events: AsyncIterable<StreamEvent>;
+    cancel(reason?: string): void;
+}
 /**
  * Main orchestrator SDK entrypoint class.
  * Validates tasks, executes routing rules based on request constraints and connectivity,
@@ -40,6 +51,20 @@ export declare class IndeRun implements IndeRunApi {
      * @throws {IndeRunException} Standardized error indicating validation, connection, or provider failures.
      */
     run(request: TaskRequest): Promise<TaskResult>;
+    /**
+     * 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.
+     * @param request - The canonical task request containing prompts, tasks, and constraints.
+     * @throws {IndeRunException} If validation fails or no eligible streaming provider exists.
+     */
+    stream(request: TaskRequest): Promise<StreamHandleResult>;
     /**
      * Reports each registered provider's static descriptor and current dynamic capability check,
      * without executing a task. Useful for UI that shows live provider availability before a run.

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,UAAU,EAChB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,OAAO,EAAuB,KAAK,gBAAgB,EAAwB,MAAM,gBAAgB,CAAC;AAElG;;;;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;;;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;;;;;;;;;;;;OAYG;IACG,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsQ/D;;;OAGG;IACG,iBAAiB,IAAI,OAAO,CAAC,0BAA0B,EAAE,CAAC;CASjE"}

package/dist/core/engine.js

@@ -1,8 +1,9 @@
 import { getTaskRequestValidationIssues } from "@independo/inderun-contracts";
 import { ProviderRegistry } from "./registry.js";
 import { Router } from "./router.js";
-import { createInternal, toIndeRunException } from "./errors.js";
+import { createCapabilityMismatch, createInternal, createUnavailable, toIndeRunException } from "./errors.js";
 import { NoOpTelemetryService } from "./telemetry.js";
+import { EventGate } from "./event-gate.js";
 /**
  * Main orchestrator SDK entrypoint class.
  * Validates tasks, executes routing rules based on request constraints and connectivity,
@@ -190,6 +191,261 @@ export class IndeRun {
             throw exception;
         }
     }
+    /**
+     * 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.
+     * @param request - The canonical task request containing prompts, tasks, and constraints.
+     * @throws {IndeRunException} If validation fails or no eligible streaming provider exists.
+     */
+    async stream(request) {
+        const startTime = this.hostServices.clock ? this.hostServices.clock.now() : Date.now();
+        const now = () => (this.hostServices.clock ? this.hostServices.clock.now() : Date.now());
+        const runId = request.requestId || `run_${Math.random().toString(36).substring(2, 11)}`;
+        const validationIssues = getTaskRequestValidationIssues(request);
+        if (validationIssues.length > 0) {
+            const message = `Validation failed for TaskRequest: ${validationIssues
+                .map((i) => `${i.path} - ${i.message}`)
+                .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");
+        this.safeEmit({
+            type: "route_decided",
+            runId,
+            timestamp: now(),
+            payload: {
+                selectedProviderId: routeSelection.routePlan.selectedProviderId,
+                fallbackProviderIds: routeSelection.routePlan.fallbackProviderIds,
+                rejectedProviders: routeSelection.routePlan.rejectedProviders,
+                fallbackAvailable: providers.length > 1,
+                taskKind: request.task.kind,
+                explanation: routeSelection.explanation,
+                constraints: request.constraints ?? null,
+                preferences: request.preferences ?? null,
+                plannerSource: routeSelection.plannerSource,
+                plannerUnavailableReason: routeSelection.plannerUnavailableReason ?? null
+            }
+        });
+        if (providers.length === 0) {
+            throw createCapabilityMismatch("No eligible provider supports streaming for this request.", {
+                runId,
+                details: { taskKind: request.task.kind }
+            });
+        }
+        const controller = new AbortController();
+        const gate = new EventGate(runId);
+        const hostServices = this.hostServices;
+        const safeEmit = this.safeEmit.bind(this);
+        const getStableMessage = this.getStableMessage.bind(this);
+        const handle = {
+            runId,
+            schemaVersion: "1.0",
+            startedAt: startTime,
+            providerId: providers[0].describe().id
+        };
+        async function* run() {
+            const attemptedProviderIds = [];
+            let committed = false;
+            const cancelledOutcome = (partialText) => {
+                const reason = typeof controller.signal.reason === "string" ? controller.signal.reason : undefined;
+                return {
+                    outcome: "cancelled",
+                    runId,
+                    schemaVersion: "1.0",
+                    partialText,
+                    ...(reason !== undefined ? { reason } : {})
+                };
+            };
+            for (const [index, provider] of providers.entries()) {
+                if (controller.signal.aborted) {
+                    break;
+                }
+                const providerId = provider.describe().id;
+                attemptedProviderIds.push(providerId);
+                safeEmit({
+                    type: "stream_attempt_started",
+                    runId,
+                    timestamp: now(),
+                    payload: { providerId, fallbackOccurred: index > 0 }
+                });
+                let partialText = "";
+                try {
+                    const iterable = provider.stream(request, {
+                        runId,
+                        hostServices: hostServices,
+                        signal: controller.signal
+                    });
+                    let terminatedInLoop = false;
+                    for await (const ev of iterable) {
+                        if (controller.signal.aborted) {
+                            break;
+                        }
+                        if (ev.kind === "error") {
+                            throw ev.error;
+                        }
+                        if (ev.kind === "delta" || ev.kind === "snapshot") {
+                            partialText = ev.kind === "delta" ? partialText + ev.text : ev.text;
+                            if (!committed) {
+                                committed = true;
+                                safeEmit({
+                                    type: "stream_attempt_succeeded",
+                                    runId,
+                                    timestamp: now(),
+                                    payload: { providerId, attemptedProviderIds }
+                                });
+                            }
+                            const streamEvent = gate.admit({
+                                timestamp: now(),
+                                type: ev.kind === "delta" ? "content_delta" : "content_snapshot",
+                                payload: { text: ev.text }
+                            });
+                            if (streamEvent)
+                                yield streamEvent;
+                            continue;
+                        }
+                        // ev.kind === "done"
+                        const outcome = {
+                            outcome: "completed",
+                            runId,
+                            schemaVersion: "1.0",
+                            finalText: ev.finalText,
+                            telemetry: { providerUsed: providerId, totalMs: now() - startTime },
+                            ...(ev.usage !== undefined ? { usage: ev.usage } : {})
+                        };
+                        const terminal = gate.terminate(outcome, now());
+                        safeEmit({
+                            type: "stream_completed",
+                            runId,
+                            timestamp: now(),
+                            payload: { providerId, durationMs: now() - startTime, attemptedProviderIds }
+                        });
+                        terminatedInLoop = true;
+                        if (terminal)
+                            yield terminal;
+                        return;
+                    }
+                    if (terminatedInLoop) {
+                        return;
+                    }
+                    if (controller.signal.aborted) {
+                        const terminal = gate.terminate(cancelledOutcome(partialText), now());
+                        safeEmit({
+                            type: "stream_cancelled",
+                            runId,
+                            timestamp: now(),
+                            payload: { providerId, attemptedProviderIds }
+                        });
+                        if (terminal)
+                            yield terminal;
+                        return;
+                    }
+                    // Provider's iterable ended without a terminal "done"/"error" event.
+                    throw new Error(`Provider '${providerId}' stream ended without a terminal event.`);
+                }
+                catch (err) {
+                    if (controller.signal.aborted) {
+                        const terminal = gate.terminate(cancelledOutcome(partialText), now());
+                        safeEmit({
+                            type: "stream_cancelled",
+                            runId,
+                            timestamp: now(),
+                            payload: { providerId, attemptedProviderIds }
+                        });
+                        if (terminal)
+                            yield terminal;
+                        return;
+                    }
+                    const exception = toIndeRunException(err, {
+                        providerId,
+                        runId,
+                        details: { attemptedProviderIds }
+                    });
+                    if (!committed) {
+                        safeEmit({
+                            type: "stream_attempt_failed",
+                            runId,
+                            timestamp: now(),
+                            payload: {
+                                providerId,
+                                errorClass: exception.errorClass,
+                                message: getStableMessage(exception.errorClass)
+                            }
+                        });
+                        continue;
+                    }
+                    const outcome = {
+                        outcome: "error",
+                        runId,
+                        schemaVersion: "1.0",
+                        error: exception.toContractError(),
+                        partialText
+                    };
+                    const terminal = gate.terminate(outcome, now());
+                    safeEmit({
+                        type: "stream_failed",
+                        runId,
+                        timestamp: now(),
+                        payload: {
+                            providerId,
+                            errorClass: exception.errorClass,
+                            message: getStableMessage(exception.errorClass),
+                            attemptedProviderIds
+                        }
+                    });
+                    if (terminal)
+                        yield terminal;
+                    return;
+                }
+            }
+            // Every provider failed pre-commit, or cancellation landed before any attempt started.
+            if (controller.signal.aborted) {
+                const terminal = gate.terminate(cancelledOutcome(""), now());
+                safeEmit({
+                    type: "stream_cancelled",
+                    runId,
+                    timestamp: now(),
+                    payload: { attemptedProviderIds }
+                });
+                if (terminal)
+                    yield terminal;
+                return;
+            }
+            const exception = createUnavailable("All eligible streaming providers failed.", {
+                runId,
+                details: { attemptedProviderIds }
+            });
+            const outcome = {
+                outcome: "error",
+                runId,
+                schemaVersion: "1.0",
+                error: exception.toContractError(),
+                partialText: ""
+            };
+            const terminal = gate.terminate(outcome, now());
+            safeEmit({
+                type: "stream_failed",
+                runId,
+                timestamp: now(),
+                payload: {
+                    errorClass: exception.errorClass,
+                    message: getStableMessage(exception.errorClass),
+                    attemptedProviderIds
+                }
+            });
+            if (terminal)
+                yield terminal;
+        }
+        return { handle, events: run(), cancel: (reason) => controller.abort(reason) };
+    }
     /**
      * Reports each registered provider's static descriptor and current dynamic capability check,
      * without executing a task. Useful for UI that shows live provider availability before a run.

package/dist/core/event-gate.d.ts

@@ -0,0 +1,37 @@
+import type { StreamEvent, StreamTerminalOutcome } from "@independo/inderun-contracts";
+/**
+ * Per-run gatekeeper for Mode 2 streaming. Enforces the two structural guarantees
+ * required by the streaming orchestrator: exactly one terminal outcome is ever
+ * produced for a run, and no event is admitted after that terminal outcome fires.
+ *
+ * Correctness relies on `admit`/`terminate` performing their check-and-set
+ * synchronously with no `await` in between — safe under JS's single-threaded,
+ * run-to-completion semantics even with interleaved `await` resumption elsewhere
+ * (e.g. a provider's async iterator and a caller's `cancel()` racing).
+ */
+export declare class EventGate {
+    private readonly runId;
+    private sequence;
+    private terminated;
+    private terminalOutcome;
+    constructor(runId: string);
+    /**
+     * Admits a non-terminal StreamEvent, assigning it the next monotonic sequence
+     * number. Returns null (suppressing the event) if the run has already terminated.
+     */
+    admit(event: {
+        timestamp: number;
+        type: string;
+        payload?: StreamEvent["payload"];
+    }): StreamEvent | null;
+    /**
+     * Terminates the run with the given outcome. First writer wins: only the first
+     * call produces a terminal StreamEvent and stores the outcome; every subsequent
+     * call (duplicate provider "done", late error after cancel, concurrent cancel()
+     * calls) is a silent no-op that returns null, making repeated cancellation safe.
+     */
+    terminate(outcome: StreamTerminalOutcome, timestamp: number): StreamEvent | null;
+    isTerminated(): boolean;
+    getOutcome(): StreamTerminalOutcome | undefined;
+}
+//# sourceMappingURL=event-gate.d.ts.map

package/dist/core/event-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-gate.d.ts","sourceRoot":"","sources":["../../src/core/event-gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAEvF;;;;;;;;;GASG;AACH,qBAAa,SAAS;IAKR,OAAO,CAAC,QAAQ,CAAC,KAAK;IAJlC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAAoC;gBAE9B,KAAK,EAAE,MAAM;IAE1C;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;KAClC,GAAG,WAAW,GAAG,IAAI;IActB;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAgBhF,YAAY,IAAI,OAAO;IAIvB,UAAU,IAAI,qBAAqB,GAAG,SAAS;CAGhD"}

package/dist/core/event-gate.js

@@ -0,0 +1,63 @@
+/**
+ * Per-run gatekeeper for Mode 2 streaming. Enforces the two structural guarantees
+ * required by the streaming orchestrator: exactly one terminal outcome is ever
+ * produced for a run, and no event is admitted after that terminal outcome fires.
+ *
+ * Correctness relies on `admit`/`terminate` performing their check-and-set
+ * synchronously with no `await` in between — safe under JS's single-threaded,
+ * run-to-completion semantics even with interleaved `await` resumption elsewhere
+ * (e.g. a provider's async iterator and a caller's `cancel()` racing).
+ */
+export class EventGate {
+    runId;
+    sequence = 0;
+    terminated = false;
+    terminalOutcome;
+    constructor(runId) {
+        this.runId = runId;
+    }
+    /**
+     * Admits a non-terminal StreamEvent, assigning it the next monotonic sequence
+     * number. Returns null (suppressing the event) if the run has already terminated.
+     */
+    admit(event) {
+        if (this.terminated) {
+            return null;
+        }
+        return {
+            runId: this.runId,
+            schemaVersion: "1.0",
+            sequence: this.sequence++,
+            timestamp: event.timestamp,
+            type: event.type,
+            ...(event.payload !== undefined ? { payload: event.payload } : {})
+        };
+    }
+    /**
+     * Terminates the run with the given outcome. First writer wins: only the first
+     * call produces a terminal StreamEvent and stores the outcome; every subsequent
+     * call (duplicate provider "done", late error after cancel, concurrent cancel()
+     * calls) is a silent no-op that returns null, making repeated cancellation safe.
+     */
+    terminate(outcome, timestamp) {
+        if (this.terminated) {
+            return null;
+        }
+        this.terminated = true;
+        this.terminalOutcome = outcome;
+        return {
+            runId: this.runId,
+            schemaVersion: "1.0",
+            sequence: this.sequence++,
+            timestamp,
+            type: "terminal",
+            payload: outcome
+        };
+    }
+    isTerminated() {
+        return this.terminated;
+    }
+    getOutcome() {
+        return this.terminalOutcome;
+    }
+}

package/dist/core/provider.d.ts

@@ -118,6 +118,42 @@ export interface RunContext {
      */
     hostServices: HostServices;
 }
+/**
+ * Execution context passed to provider stream commands. Extends RunContext with the
+ * caller-driven cancellation signal; the Engine core owns the AbortController and
+ * threads its signal here, so providers never need to construct their own.
+ */
+export interface ProviderStreamContext extends RunContext {
+    /**
+     * Signals caller-driven cancellation of this stream. Providers with `cancel: "hard"`
+     * should tear down their connection immediately on abort; `cancel: "soft"` providers
+     * may stop relaying events without interrupting underlying local work; `cancel:
+     * "none"` providers may ignore it entirely; the engine enforces the caller-visible
+     * cancellation guarantee at the consumer loop regardless of what the provider does.
+     */
+    signal: AbortSignal;
+}
+/**
+ * A raw, provider-shaped streaming event yielded by ProviderAdapter.stream(). This is
+ * intentionally distinct from the canonical StreamEvent contract: providers emit
+ * provider-shaped deltas here, and the Engine core's Event Gate normalizes these into
+ * StreamEvent/StreamTerminalOutcome, keeping provider-specific mechanics from leaking
+ * through the public API.
+ */
+export type ProviderStreamEvent = {
+    kind: "delta";
+    text: string;
+} | {
+    kind: "snapshot";
+    text: string;
+} | {
+    kind: "done";
+    finalText: string;
+    usage?: TaskResult["usage"];
+} | {
+    kind: "error";
+    error: unknown;
+};
 /**
  * Pluggable execution adapter contract that wraps a specific model runtime
  * (system frameworks, local runtimes, or cloud APIs) and exposes normalized APIs.
@@ -135,5 +171,10 @@ export interface ProviderAdapter {
      * Executes a task request in Mode 1 (request/response).
      */
     run(req: TaskRequest, ctx: RunContext): Promise<TaskResult>;
+    /**
+     * Executes a task request in Mode 2 (streaming). Optional: only providers declaring
+     * `describe().supports.streaming === true` are expected to implement this.
+     */
+    stream?(req: TaskRequest, ctx: ProviderStreamContext): AsyncIterable<ProviderStreamEvent>;
 }
 //# sourceMappingURL=provider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/core/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC;;OAEG;IACH,SAAS,EAAE,YAAY,GAAG,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IACzE;;OAEG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAEnD;;OAEG;IACH,QAAQ,EAAE;QACR,mEAAmE;QACnE,GAAG,EAAE,OAAO,CAAC;QACb,mDAAmD;QACnD,SAAS,EAAE,OAAO,CAAC;QACnB,6DAA6D;QAC7D,QAAQ,EAAE,OAAO,CAAC;QAClB,6DAA6D;QAC7D,KAAK,EAAE,OAAO,CAAC;QACf,wEAAwE;QACxE,eAAe,EAAE,OAAO,CAAC;QACzB,kFAAkF;QAClF,gBAAgB,EAAE,OAAO,CAAC;QAC1B,6EAA6E;QAC7E,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IAEF;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAEjC;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,6DAA6D;QAC7D,gBAAgB,EAAE,OAAO,CAAC;QAC1B,2DAA2D;QAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;OAGG;IACH,YAAY,EAAE,2BAA2B,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,IAAI,kBAAkB,CAAC;IAC/B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACvE;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7D"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/core/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACjC;;OAEG;IACH,SAAS,EAAE,YAAY,GAAG,gBAAgB,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAC;IACzE;;OAEG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;IAEnD;;OAEG;IACH,QAAQ,EAAE;QACR,mEAAmE;QACnE,GAAG,EAAE,OAAO,CAAC;QACb,mDAAmD;QACnD,SAAS,EAAE,OAAO,CAAC;QACnB,6DAA6D;QAC7D,QAAQ,EAAE,OAAO,CAAC;QAClB,6DAA6D;QAC7D,KAAK,EAAE,OAAO,CAAC;QACf,wEAAwE;QACxE,eAAe,EAAE,OAAO,CAAC;QACzB,kFAAkF;QAClF,gBAAgB,EAAE,OAAO,CAAC;QAC1B,6EAA6E;QAC7E,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;IAEF;;;;;OAKG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAEjC;;OAEG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF;;OAEG;IACH,OAAO,CAAC,EAAE;QACR,6DAA6D;QAC7D,gBAAgB,EAAE,OAAO,CAAC;QAC1B,2DAA2D;QAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,EAAE,kBAAkB,CAAC;IAC/B;;;OAGG;IACH,YAAY,EAAE,2BAA2B,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,UAAU;IACvD;;;;;;OAMG;IACH,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAC3B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtC;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,QAAQ,IAAI,kBAAkB,CAAC;IAC/B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAC;IACvE;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D;;;OAGG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,qBAAqB,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;CAC3F"}

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 export { type ConnectivityService, type DeviceConstraintsService, type SecureStorageService, type ClockService, type HttpClientService, type HttpRequest, type HttpResponse, type HostServices, type ThermalState } from "./core/host.js";
-export { type ProviderDescriptor, type ProviderDynamicCapabilities, type ProviderCapabilitySnapshot, type RunContext, type ProviderAdapter } from "./core/provider.js";
+export { type ProviderDescriptor, type ProviderDynamicCapabilities, type ProviderCapabilitySnapshot, type RunContext, type ProviderAdapter, type ProviderStreamContext, type ProviderStreamEvent } from "./core/provider.js";
+export { EventGate } from "./core/event-gate.js";
 export { ProviderRegistry } from "./core/registry.js";
 export { type RouteSelection, Router } from "./core/router.js";
 export { type RoutePlanner, type PlannerOutcome, type WasmUnavailableReason, type SharedPlannerInput, type SharedPlannerRoutePlan, WasmRoutePlanner } from "./core/route-planner.js";
 export { type IndeRunExceptionParams, IndeRunException, createCapabilityMismatch, createOffline, createAuthError, createRateLimited, createTimeout, createUnavailable, createInternal, toIndeRunException } from "./core/errors.js";
-export { IndeRun } from "./core/engine.js";
+export { IndeRun, type StreamHandleResult } from "./core/engine.js";
 export type { IndeRunApi } from "./core/generated/inderun-api.js";
 export { type TelemetryEventType, type TelemetryEvent, type TelemetryService, NoOpTelemetryService } from "./core/telemetry.js";
 export { BrowserConnectivityService, FetchHttpClient, SystemClockService, createBrowserHostServices, type CreateBrowserHostServicesOptions, type FetchHttpClientOptions } from "./core/browser-host.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,YAAY,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,kBAAkB,EAClB,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,KAAK,sBAAsB,EAC3B,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACpE,YAAY,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,oBAAoB,EACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,eAAe,EACf,kBAAkB,EAClB,yBAAyB,EACzB,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export {} from "./core/host.js";
 export {} from "./core/provider.js";
+export { EventGate } from "./core/event-gate.js";
 export { ProviderRegistry } from "./core/registry.js";
 export { Router } from "./core/router.js";
 export { WasmRoutePlanner } from "./core/route-planner.js";

package/package.json

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