@independo/inderun-contracts 0.2.2 → 0.3.0-dev.2

package/dist/generated/stream-event.d.ts

@@ -0,0 +1,139 @@
+/**
+ * The canonical Mode 2 streaming event union, discriminated by 'type'. Every variant shares
+ * an envelope of schemaVersion, runId, sequence, timestamp, and type. 'sequence' is the
+ * ordering authority for events within a run (a monotonically increasing integer starting
+ * at 0 per runId) — consumers must order by 'sequence', not by arrival order, since a
+ * bridge hop (e.g. a future Capacitor bridge) could reorder delivery. Known event types are
+ * split into user-visible content ('content_delta', 'content_snapshot') and
+ * mechanical/diagnostic types ('lifecycle', 'diagnostic', 'terminal') so SDKs can
+ * distinguish what belongs in a chat UI from what is orchestration detail. Forward
+ * compatibility: this union closes with an open 'unknown_event' branch so a consumer built
+ * against an older revision of this schema does not hard-fail when a newer, additive minor
+ * revision introduces a new known type; per contracts/README.md's schema evolution policy,
+ * SDKs must treat an unrecognized 'type' as ignore-or-pass-through-for-diagnostics, never
+ * as a hard error. Design seam only; no engine or provider implementation exists yet (see
+ * docs/architecture/architecture.md).
+ */
+export type StreamEvent = {
+    /**
+     * Event-specific diagnostic metadata. It must not contain prompt payloads or raw secrets,
+     * matching the same guardrail as TelemetryEvent.payload.
+     *
+     * Structurally identical to StreamTerminalOutcome
+     * (contracts/schemas/stream-terminal-outcome.schema.json), duplicated by value here rather
+     * than by $ref, matching this repo's schema convention of no cross-file references. Keep
+     * both shapes in sync; a cross-check test asserts a shared fixture validates against both
+     * schemas.
+     *
+     * Optional event-specific payload for the unrecognized type. It must not contain prompt
+     * payloads or raw secrets.
+     */
+    payload?: Payload;
+    /**
+     * Opaque run identifier this event belongs to, matching StreamRunHandle.runId.
+     */
+    runId: string;
+    /**
+     * Contract schema version used to interpret this event payload.
+     */
+    schemaVersion: "1.0";
+    /**
+     * Zero-based, monotonically increasing event index within this run. The ordering authority;
+     * do not rely on delivery/arrival order.
+     *
+     * Zero-based, monotonically increasing event index within this run. This is always the
+     * highest sequence number for the run: the terminal event.
+     */
+    sequence: number;
+    /**
+     * Wall-clock event timestamp in Unix epoch milliseconds.
+     */
+    timestamp: number;
+    /**
+     * User-visible content: an incremental text increment since the previous content_delta or
+     * content_snapshot event. Mirrors ProviderDescriptor.streamingStyle 'tokens'/'chunks'
+     * (packages/inderun-web/src/core/provider.ts) — providers reporting either style normalize
+     * to content_delta.
+     *
+     * User-visible content: the full cumulative text produced so far. Mirrors
+     * ProviderDescriptor.streamingStyle 'snapshots' (packages/inderun-web/src/core/provider.ts)
+     * — providers reporting that style normalize to content_snapshot rather than
+     * content_delta.
+     *
+     * Mechanical/diagnostic: a run lifecycle transition (e.g. provider selection, execution
+     * start). Not user-visible content; not part of the generated text.
+     *
+     * Mechanical/diagnostic: free-form orchestration or provider diagnostic detail. Not
+     * user-visible content.
+     *
+     * Terminal: the last event of the run, carrying the mutually-exclusive
+     * completion/error/cancellation outcome. No further StreamEvent is delivered for this runId
+     * after this event.
+     *
+     * Forward-compatibility catch-all: any event type not among the known constants above.
+     * Exists so a consumer validating against this revision of the schema does not hard-fail
+     * when a future additive revision introduces a new known event type; SDKs must ignore or
+     * pass through such events for diagnostics rather than treating them as an error.
+     */
+    type: string;
+    [property: string]: unknown;
+};
+/**
+ * Event-specific diagnostic metadata. It must not contain prompt payloads or raw secrets,
+ * matching the same guardrail as TelemetryEvent.payload.
+ *
+ * Optional event-specific payload for the unrecognized type. It must not contain prompt
+ * payloads or raw secrets.
+ */
+export type Payload = {
+    /**
+     * The incremental text produced since the previous content event.
+     *
+     * The full cumulative text produced by the run so far.
+     */
+    text?: string;
+    /**
+     * The lifecycle phase reached.
+     */
+    phase?: Phase;
+    finalText?: string;
+    outcome?: Outcome;
+    runId?: string;
+    schemaVersion?: "1.0";
+    telemetry?: Telemetry;
+    usage?: Usage;
+    error?: Error;
+    partialText?: string;
+    reason?: string;
+    [property: string]: unknown;
+};
+export type Error = {
+    details?: {
+        [key: string]: unknown;
+    };
+    errorClass: ErrorClass;
+    message: string;
+    providerId?: string;
+    retryable?: boolean;
+    retryAfterMs?: number;
+    schemaVersion: "1.0";
+    [property: string]: unknown;
+};
+export type ErrorClass = "CapabilityMismatch" | "Offline" | "AuthError" | "RateLimited" | "Timeout" | "Unavailable" | "Internal";
+export type Outcome = "completed" | "error" | "cancelled";
+/**
+ * The lifecycle phase reached.
+ */
+export type Phase = "provider_selected" | "started";
+export type Telemetry = {
+    providerUsed: string;
+    totalMs: number;
+    [property: string]: unknown;
+};
+export type Usage = {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+    [property: string]: unknown;
+};
+//# sourceMappingURL=stream-event.d.ts.map

package/dist/generated/stream-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-event.d.ts","sourceRoot":"","sources":["../../src/generated/stream-event.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,WAAW,GAAG;IACtB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,GAAG;IAClB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,CAAC,EAAU,KAAK,CAAC;IACtB,SAAS,CAAC,EAAM,MAAM,CAAC;IACvB,OAAO,CAAC,EAAQ,OAAO,CAAC;IACxB,KAAK,CAAC,EAAU,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,SAAS,CAAC,EAAM,SAAS,CAAC;IAC1B,KAAK,CAAC,EAAU,KAAK,CAAC;IACtB,KAAK,CAAC,EAAU,KAAK,CAAC;IACtB,WAAW,CAAC,EAAI,MAAM,CAAC;IACvB,MAAM,CAAC,EAAS,MAAM,CAAC;IACvB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAChB,OAAO,CAAC,EAAO;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC1C,UAAU,EAAK,UAAU,CAAC;IAC1B,OAAO,EAAQ,MAAM,CAAC;IACtB,UAAU,CAAC,EAAI,MAAM,CAAC;IACtB,SAAS,CAAC,EAAK,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,mBAAmB,GAAG,SAAS,CAAC;AAEpD,MAAM,MAAM,SAAS,GAAG;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAO,MAAM,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,KAAK,GAAG;IAChB,WAAW,CAAC,EAAG,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAG,MAAM,CAAC;IACtB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA"}

package/dist/generated/stream-event.js

@@ -0,0 +1,2 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+export {};

package/dist/generated/stream-run.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The serializable acknowledgment returned when a Mode 2 stream is opened, before any
+ * StreamEvent has arrived. This is the identity/correlation contract only: the live,
+ * consumable stream itself is a platform-idiomatic construct (an AsyncIterable<StreamEvent>
+ * in TypeScript, a Flow<StreamEvent> in Kotlin, an AsyncThrowingStream<StreamEvent, Error>
+ * in Swift) that is never serialized and is out of scope for this schema. Design seam only;
+ * no engine or provider implementation exists yet (see docs/architecture/architecture.md).
+ */
+export type StreamRunHandle = {
+    /**
+     * Identifier of the provider selected to service this stream, if routing has completed by
+     * the time the handle is returned. Absent while route selection is still pending.
+     */
+    providerId?: string;
+    /**
+     * A unique, opaque identifier assigned by the engine for this stream run. Every StreamEvent
+     * and the terminal StreamTerminalOutcome for this run carry the same runId, matching the
+     * identity convention used by TaskResult.runId and IndeRunError.runId.
+     */
+    runId: string;
+    /**
+     * Contract schema version used to interpret this handle payload.
+     */
+    schemaVersion: "1.0";
+    /**
+     * Wall-clock time the stream run was opened, in Unix epoch milliseconds.
+     */
+    startedAt: number;
+    [property: string]: unknown;
+};
+//# sourceMappingURL=stream-run.d.ts.map

package/dist/generated/stream-run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-run.d.ts","sourceRoot":"","sources":["../../src/generated/stream-run.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA"}

package/dist/generated/stream-run.js

@@ -0,0 +1,2 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+export {};

package/dist/generated/stream-terminal-outcome.d.ts

@@ -0,0 +1,165 @@
+/**
+ * How a Mode 2 stream run ended. Completion, error, and cancellation are mutually exclusive
+ * terminal outcomes, enforced here as a closed set of three oneOf branches discriminated by
+ * 'outcome' (unlike StreamEvent.type, this set is not open-ended: the three-way terminal
+ * outcome is a fixed architectural guarantee, not something new outcome kinds get added
+ * to). Exactly one StreamTerminalOutcome is produced per run, and no further StreamEvent is
+ * delivered after it (see docs/architecture/architecture.md, 'Cancellation And Fallback').
+ * This shape is also embedded by value as the payload of the terminal StreamEvent
+ * (stream-event.schema.json) so it can additionally be exposed standalone, e.g. as a
+ * completion future/promise a stream handle resolves independently of consuming the full
+ * event sequence; the two copies must stay structurally identical. Note on
+ * additionalProperties: per this repo's forward-compatible convention every branch permits
+ * unknown extra fields, so mutual exclusivity is enforced via the required 'outcome'
+ * discriminator plus each branch's own required peer field (finalText/error/partialText)
+ * being present, not by forbidding a payload from also carrying an unrelated stray field
+ * from another branch's vocabulary.
+ */
+export type StreamTerminalOutcome = {
+    /**
+     * The full, cumulative text produced by the run. Equivalent in role to
+     * TaskResult.output.text for Mode 1.
+     */
+    finalText?: string;
+    /**
+     * The stream completed normally: every provider-generated event was delivered before this
+     * outcome was produced.
+     *
+     * The stream ended in failure: validation, routing (no eligible provider), or every
+     * attempted provider failing.
+     *
+     * The stream was cancelled. No further StreamEvent is delivered after this outcome, and no
+     * further fallback attempt is made, per the engine's cancellation guarantee.
+     */
+    outcome: Outcome;
+    /**
+     * The stream run this outcome terminates, matching StreamRunHandle.runId and every
+     * StreamEvent.runId for the run.
+     */
+    runId: string;
+    /**
+     * Contract schema version used to interpret this outcome payload.
+     */
+    schemaVersion: "1.0";
+    /**
+     * Required metadata providing an overview of the execution result and performance metrics.
+     * Same shape as TaskResult.telemetry.
+     */
+    telemetry?: Telemetry;
+    /**
+     * Optional metadata regarding the quantity of tokens processed by the provider. Same shape
+     * as TaskResult.usage.
+     */
+    usage?: Usage;
+    /**
+     * The normalized error for this failure. Structurally identical to IndeRunError
+     * (contracts/schemas/inderun-error.schema.json), duplicated by value here rather than by
+     * $ref, matching this repo's schema convention of no cross-file references. Keep both
+     * shapes in sync; a cross-check test asserts a shared fixture validates against both
+     * schemas.
+     */
+    error?: Error;
+    /**
+     * Whatever cumulative text had already been delivered via content_delta/content_snapshot
+     * StreamEvents before the cancellation point. May be empty if cancellation occurred before
+     * any content was produced.
+     */
+    partialText?: string;
+    /**
+     * Optional human-readable reason the run was cancelled (e.g. caller-initiated abort). Not a
+     * machine-taxonomy field; use errorClass on the 'error' outcome branch for failure
+     * classification.
+     */
+    reason?: string;
+    [property: string]: unknown;
+};
+/**
+ * The normalized error for this failure. Structurally identical to IndeRunError
+ * (contracts/schemas/inderun-error.schema.json), duplicated by value here rather than by
+ * $ref, matching this repo's schema convention of no cross-file references. Keep both
+ * shapes in sync; a cross-check test asserts a shared fixture validates against both
+ * schemas.
+ */
+export type Error = {
+    /**
+     * Optional structured diagnostic details. It must not contain raw secrets.
+     */
+    details?: {
+        [key: string]: unknown;
+    };
+    /**
+     * Normalized error taxonomy, identical to IndeRunError.errorClass: CapabilityMismatch
+     * (request needs something no eligible provider supports), Offline/Unavailable (provider
+     * unreachable or not ready), AuthError (credential/auth failure), RateLimited (provider
+     * throttled the request), Timeout (provider exceeded its execution budget), Internal
+     * (unexpected engine-side failure).
+     */
+    errorClass: ErrorClass;
+    /**
+     * Human-readable error message suitable for logs and developer diagnostics.
+     */
+    message: string;
+    /**
+     * Identifier of the provider associated with the failure, if execution reached a provider.
+     */
+    providerId?: string;
+    /**
+     * Whether retrying the same request may succeed.
+     */
+    retryable?: boolean;
+    /**
+     * Optional suggested delay before retrying, in milliseconds.
+     */
+    retryAfterMs?: number;
+    /**
+     * Contract schema version used to interpret the error payload.
+     */
+    schemaVersion: "1.0";
+    [property: string]: unknown;
+};
+/**
+ * Normalized error taxonomy, identical to IndeRunError.errorClass: CapabilityMismatch
+ * (request needs something no eligible provider supports), Offline/Unavailable (provider
+ * unreachable or not ready), AuthError (credential/auth failure), RateLimited (provider
+ * throttled the request), Timeout (provider exceeded its execution budget), Internal
+ * (unexpected engine-side failure).
+ */
+export type ErrorClass = "CapabilityMismatch" | "Offline" | "AuthError" | "RateLimited" | "Timeout" | "Unavailable" | "Internal";
+export type Outcome = "completed" | "error" | "cancelled";
+/**
+ * Required metadata providing an overview of the execution result and performance metrics.
+ * Same shape as TaskResult.telemetry.
+ */
+export type Telemetry = {
+    /**
+     * The identifier for the specific provider that handled the request (e.g.,
+     * 'openai_compatible_cloud').
+     */
+    providerUsed: string;
+    /**
+     * Measured execution duration in milliseconds, including route selection and result
+     * processing.
+     */
+    totalMs: number;
+    [property: string]: unknown;
+};
+/**
+ * Optional metadata regarding the quantity of tokens processed by the provider. Same shape
+ * as TaskResult.usage.
+ */
+export type Usage = {
+    /**
+     * Number of input tokens consumed, as reported by the provider.
+     */
+    inputTokens?: number;
+    /**
+     * Number of output tokens generated, as reported by the provider.
+     */
+    outputTokens?: number;
+    /**
+     * Aggregated token count for this request, as reported by the provider.
+     */
+    totalTokens?: number;
+    [property: string]: unknown;
+};
+//# sourceMappingURL=stream-terminal-outcome.d.ts.map

package/dist/generated/stream-terminal-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-terminal-outcome.d.ts","sourceRoot":"","sources":["../../src/generated/stream-terminal-outcome.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;;OASG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACrC;;;;;;OAMG;IACH,UAAU,EAAE,UAAU,CAAC;IACvB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1D;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,KAAK,GAAG;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA"}

package/dist/generated/stream-terminal-outcome.js

@@ -0,0 +1,2 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+export {};

package/dist/generated/telemetry-event.d.ts

@@ -25,5 +25,5 @@ export type TelemetryEvent = {
 /**
  * Telemetry event kind emitted by the orchestrator or provider integration.
  */
-export type Type = "route_decided" | "attempt_succeeded" | "attempt_failed";
+export type Type = "route_decided" | "attempt_succeeded" | "attempt_failed" | "stream_attempt_started" | "stream_attempt_succeeded" | "stream_attempt_failed" | "stream_completed" | "stream_failed" | "stream_cancelled";
 //# sourceMappingURL=telemetry-event.d.ts.map

package/dist/generated/telemetry-event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry-event.d.ts","sourceRoot":"","sources":["../../src/generated/telemetry-event.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB;;OAEG;IACH,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACpC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IACX,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,mBAAmB,GAAG,gBAAgB,CAAC"}
+{"version":3,"file":"telemetry-event.d.ts","sourceRoot":"","sources":["../../src/generated/telemetry-event.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IACzB;;OAEG;IACH,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACpC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IACX,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,eAAe,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,wBAAwB,GAAG,0BAA0B,GAAG,uBAAuB,GAAG,kBAAkB,GAAG,eAAe,GAAG,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export type * from "./generated/index.js";
-export { httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
-export { getHttpRequestValidationIssues, getHttpResponseValidationIssues, getIndeRunErrorValidationIssues, getModelPackageValidationIssues, getRoutePlanValidationIssues, getRoutePlannerInputValidationIssues, getTaskRequestValidationIssues, getTaskResultValidationIssues, getTelemetryEventValidationIssues, validateHttpRequest, validateHttpResponse, validateIndeRunError, validateModelPackage, validateRoutePlan, validateRoutePlannerInput, validateTaskRequest, validateTaskResult, validateTelemetryEvent, type ValidationIssue } from "./validators.js";
+export { httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, streamEventSchema, streamRunSchema, streamTerminalOutcomeSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
+export { getHttpRequestValidationIssues, getHttpResponseValidationIssues, getIndeRunErrorValidationIssues, getModelPackageValidationIssues, getRoutePlanValidationIssues, getRoutePlannerInputValidationIssues, getStreamEventValidationIssues, getStreamRunHandleValidationIssues, getStreamTerminalOutcomeValidationIssues, getTaskRequestValidationIssues, getTaskResultValidationIssues, getTelemetryEventValidationIssues, validateHttpRequest, validateHttpResponse, validateIndeRunError, validateModelPackage, validateRoutePlan, validateRoutePlannerInput, validateStreamEvent, validateStreamRunHandle, validateStreamTerminalOutcome, validateTaskRequest, validateTaskResult, validateTelemetryEvent, type ValidationIssue } from "./validators.js";
 export type { FinishReason, IndeRunErrorClass, ModelPackageFormat, ModelSourceType, SchemaVersion, SharedRoutePlan, SharedRoutePlannerInput, TaskKind, RoutingConstraints, RoutingPreferences } from "./types.js";
 export type { ConnectivityService, ThermalState, DeviceConstraintsService, SecureStorageService, ClockService, HttpClientService, TelemetryEventType, TelemetryService, HostServices } from "./host.js";
 //# 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,mBAAmB,sBAAsB,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,+BAA+B,EAC/B,+BAA+B,EAC/B,4BAA4B,EAC5B,oCAAoC,EACpC,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACb,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,sBAAsB,CAAC;AAC1C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,iBAAiB,EACjB,eAAe,EACf,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,8BAA8B,EAC9B,+BAA+B,EAC/B,+BAA+B,EAC/B,+BAA+B,EAC/B,4BAA4B,EAC5B,oCAAoC,EACpC,8BAA8B,EAC9B,kCAAkC,EAClC,wCAAwC,EACxC,8BAA8B,EAC9B,6BAA6B,EAC7B,iCAAiC,EACjC,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,yBAAyB,EACzB,mBAAmB,EACnB,uBAAuB,EACvB,6BAA6B,EAC7B,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,eAAe,EACf,uBAAuB,EACvB,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACb,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
-export { getHttpRequestValidationIssues, getHttpResponseValidationIssues, getIndeRunErrorValidationIssues, getModelPackageValidationIssues, getRoutePlanValidationIssues, getRoutePlannerInputValidationIssues, getTaskRequestValidationIssues, getTaskResultValidationIssues, getTelemetryEventValidationIssues, validateHttpRequest, validateHttpResponse, validateIndeRunError, validateModelPackage, validateRoutePlan, validateRoutePlannerInput, validateTaskRequest, validateTaskResult, validateTelemetryEvent } from "./validators.js";
+export { httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, streamEventSchema, streamRunSchema, streamTerminalOutcomeSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
+export { getHttpRequestValidationIssues, getHttpResponseValidationIssues, getIndeRunErrorValidationIssues, getModelPackageValidationIssues, getRoutePlanValidationIssues, getRoutePlannerInputValidationIssues, getStreamEventValidationIssues, getStreamRunHandleValidationIssues, getStreamTerminalOutcomeValidationIssues, getTaskRequestValidationIssues, getTaskResultValidationIssues, getTelemetryEventValidationIssues, validateHttpRequest, validateHttpResponse, validateIndeRunError, validateModelPackage, validateRoutePlan, validateRoutePlannerInput, validateStreamEvent, validateStreamRunHandle, validateStreamTerminalOutcome, validateTaskRequest, validateTaskResult, validateTelemetryEvent } from "./validators.js";

package/dist/validators.d.ts

@@ -4,6 +4,9 @@ import type { HttpResponse } from "./generated/http-response.js";
 import type { ModelPackage } from "./generated/model-package.js";
 import type { RoutePlan } from "./generated/route-plan.js";
 import type { RoutePlannerInput } from "./generated/route-planner-input.js";
+import type { StreamEvent } from "./generated/stream-event.js";
+import type { StreamRunHandle } from "./generated/stream-run.js";
+import type { StreamTerminalOutcome } from "./generated/stream-terminal-outcome.js";
 import type { TaskRequest } from "./generated/task-request.js";
 import type { TaskResult } from "./generated/task-result.js";
 import type { TelemetryEvent } from "./generated/telemetry-event.js";
@@ -21,6 +24,9 @@ export declare function validateTelemetryEvent(value: unknown): value is Telemet
 export declare function validateRoutePlannerInput(value: unknown): value is RoutePlannerInput;
 export declare function validateRoutePlan(value: unknown): value is RoutePlan;
 export declare function validateModelPackage(value: unknown): value is ModelPackage;
+export declare function validateStreamRunHandle(value: unknown): value is StreamRunHandle;
+export declare function validateStreamEvent(value: unknown): value is StreamEvent;
+export declare function validateStreamTerminalOutcome(value: unknown): value is StreamTerminalOutcome;
 export declare function getTaskRequestValidationIssues(value: unknown): ValidationIssue[];
 export declare function getTaskResultValidationIssues(value: unknown): ValidationIssue[];
 export declare function getIndeRunErrorValidationIssues(value: unknown): ValidationIssue[];
@@ -30,4 +36,7 @@ export declare function getTelemetryEventValidationIssues(value: unknown): Valid
 export declare function getRoutePlannerInputValidationIssues(value: unknown): ValidationIssue[];
 export declare function getRoutePlanValidationIssues(value: unknown): ValidationIssue[];
 export declare function getModelPackageValidationIssues(value: unknown): ValidationIssue[];
+export declare function getStreamRunHandleValidationIssues(value: unknown): ValidationIssue[];
+export declare function getStreamEventValidationIssues(value: unknown): ValidationIssue[];
+export declare function getStreamTerminalOutcomeValidationIssues(value: unknown): ValidationIssue[];
 //# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAY5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAqBF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAExE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAEtE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE1E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAExE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE1E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAE9E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAEpF;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAEpE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAE1E;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAOhF;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAI/E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAIjF;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEhF;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEjF;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAInF;AAED,wBAAgB,oCAAoC,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAEtF;AAED,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAE9E;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,EAAE,CAIjF"}
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"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"}

package/dist/validators.js

@@ -1,5 +1,5 @@
 import Ajv2020 from "ajv/dist/2020.js";
-import { httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
+import { httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, streamEventSchema, streamRunSchema, streamTerminalOutcomeSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
 const Ajv2020Constructor = Ajv2020;
 const ajv = new Ajv2020Constructor({
     allErrors: true,
@@ -16,6 +16,9 @@ const validateTelemetryEventSchema = ajv.compile(telemetryEventSchema);
 const validateRoutePlannerInputSchema = ajv.compile(routePlannerInputSchema);
 const validateRoutePlanSchema = ajv.compile(routePlanSchema);
 const validateModelPackageSchema = ajv.compile(modelPackageSchema);
+const validateStreamRunHandleSchema = ajv.compile(streamRunSchema);
+const validateStreamEventSchema = ajv.compile(streamEventSchema);
+const validateStreamTerminalOutcomeSchema = ajv.compile(streamTerminalOutcomeSchema);
 export function validateTaskRequest(value) {
     return getTaskRequestValidationIssues(value).length === 0;
 }
@@ -43,6 +46,15 @@ export function validateRoutePlan(value) {
 export function validateModelPackage(value) {
     return getModelPackageValidationIssues(value).length === 0;
 }
+export function validateStreamRunHandle(value) {
+    return getStreamRunHandleValidationIssues(value).length === 0;
+}
+export function validateStreamEvent(value) {
+    return getStreamEventValidationIssues(value).length === 0;
+}
+export function validateStreamTerminalOutcome(value) {
+    return getStreamTerminalOutcomeValidationIssues(value).length === 0;
+}
 export function getTaskRequestValidationIssues(value) {
     const issues = getValidationIssues(validateTaskRequestSchema, value, {
         forbidInlineSecrets: true
@@ -82,6 +94,19 @@ export function getModelPackageValidationIssues(value) {
         forbidInlineSecrets: true
     });
 }
+export function getStreamRunHandleValidationIssues(value) {
+    return getValidationIssues(validateStreamRunHandleSchema, value);
+}
+export function getStreamEventValidationIssues(value) {
+    return getValidationIssues(validateStreamEventSchema, value, {
+        forbidInlineSecrets: true
+    });
+}
+export function getStreamTerminalOutcomeValidationIssues(value) {
+    return getValidationIssues(validateStreamTerminalOutcomeSchema, value, {
+        forbidInlineSecrets: true
+    });
+}
 function getValidationIssues(validateSchema, value, options = {}) {
     const issues = [];
     if (!validateSchema(value)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@independo/inderun-contracts",
-  "version": "0.2.2",
+  "version": "0.3.0-dev.2",
   "description": "Canonical JSON Schemas, generated TypeScript types, and validators for IndeRun contracts.",
   "license": "MIT",
   "author": {