@independo/inderun-contracts 0.3.0-dev.8 → 0.3.0

package/README.md

@@ -2,9 +2,9 @@
 
 [![npm](https://img.shields.io/npm/v/@independo/inderun-contracts?logo=npm)](https://www.npmjs.com/package/@independo/inderun-contracts)
 
-> Part of **[IndeRun](https://github.com/independo-gmbh/inderun)** — an open-source AI execution
-> framework that gives applications one unified API for running tasks across on-device, edge, and
-> cloud providers. New here? Start with the [IndeRun README](https://github.com/independo-gmbh/inderun#readme).
+> Part of **[IndeRun](https://github.com/independo-gmbh/inderun)** — on-device AI with automatic
+> cloud fallback, for cross-platform apps. New here? Start with the
+> [IndeRun README](https://github.com/independo-gmbh/inderun#readme).
 
 Canonical JSON Schema-backed contracts for IndeRun.
 

package/dist/generated/schemas.d.ts

@@ -159,7 +159,7 @@ export declare const taskResultSchema: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
     readonly $id: "https://schemas.inderun.dev/1.0/task-result.schema.json";
     readonly title: "TaskResult";
-    readonly description: "The response payload for a completed text-to-text execution. A full execution failure (validation, routing, or every attempted provider failing) is surfaced by run() throwing an IndeRunError instead of returning a TaskResult; finishReason and telemetry.errorClass are reserved for a provider reporting a non-fatal, degraded outcome on an otherwise-successful result (not currently produced by any provider in this codebase).";
+    readonly description: "The response payload for a completed text-to-text execution. A full execution failure (validation, routing, or every attempted provider failing) is surfaced by run() throwing an IndeRunError instead of returning a TaskResult; finishReason and telemetry.errorClass are reserved for a provider reporting a non-fatal, degraded outcome on an otherwise-successful result (finishReason 'error' is produced by the Android ML Kit GenAI provider; telemetry.errorClass is not currently set by any provider in this codebase).";
     readonly type: "object";
     readonly additionalProperties: true;
     readonly required: readonly ["schemaVersion", "runId", "output", "finishReason", "telemetry"];
@@ -190,7 +190,7 @@ export declare const taskResultSchema: {
             };
         };
         readonly finishReason: {
-            readonly description: "How generation ended: 'stop' (natural end), 'length' (hit maxOutputTokens), or 'cancelled'. 'error' is reserved for a provider reporting a non-fatal issue on an otherwise-returned result — no provider in this codebase currently produces it, since a full execution failure is instead surfaced by run() throwing an IndeRunError.";
+            readonly description: "How generation ended: 'stop' (natural end), 'length' (hit maxOutputTokens), or 'cancelled'. 'error' is reserved for a provider reporting a non-fatal issue on an otherwise-returned result — the Android ML Kit GenAI provider produces it when Gemini Nano reports a finish reason that is neither a natural stop nor the token limit. A full execution failure is instead surfaced by run() throwing an IndeRunError.";
             readonly enum: readonly ["stop", "length", "cancelled", "error"];
         };
         readonly usage: {
@@ -825,7 +825,7 @@ export declare const streamEventSchema: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
     readonly $id: "https://schemas.inderun.dev/1.0/stream-event.schema.json";
     readonly title: "StreamEvent";
-    readonly description: "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).";
+    readonly description: "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. All three engines implement this union (see docs/architecture/architecture.md).";
     readonly oneOf: readonly [{
         readonly type: "object";
         readonly additionalProperties: true;
@@ -891,7 +891,7 @@ export declare const streamEventSchema: {
                 readonly minimum: 0;
             };
             readonly type: {
-                readonly description: "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.";
+                readonly description: "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. Retraction: a provider of any streamingStyle may additionally emit a content_snapshot to withdraw content it has already delivered, since a snapshot replaces the run's cumulative text rather than appending to it; an empty one therefore resets that text to nothing. This is how a provider whose backend rejects an in-flight response after partial delivery — an on-device safety/policy check, for example — tells consumers to discard what they have, so a consumer must handle content_snapshot even when the provider's declared style is 'tokens' or 'chunks'.";
                 readonly const: "content_snapshot";
             };
             readonly payload: {

package/dist/generated/schemas.js

@@ -197,7 +197,7 @@ export const taskResultSchema = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.inderun.dev/1.0/task-result.schema.json",
     "title": "TaskResult",
-    "description": "The response payload for a completed text-to-text execution. A full execution failure (validation, routing, or every attempted provider failing) is surfaced by run() throwing an IndeRunError instead of returning a TaskResult; finishReason and telemetry.errorClass are reserved for a provider reporting a non-fatal, degraded outcome on an otherwise-successful result (not currently produced by any provider in this codebase).",
+    "description": "The response payload for a completed text-to-text execution. A full execution failure (validation, routing, or every attempted provider failing) is surfaced by run() throwing an IndeRunError instead of returning a TaskResult; finishReason and telemetry.errorClass are reserved for a provider reporting a non-fatal, degraded outcome on an otherwise-successful result (finishReason 'error' is produced by the Android ML Kit GenAI provider; telemetry.errorClass is not currently set by any provider in this codebase).",
     "type": "object",
     "additionalProperties": true,
     "required": [
@@ -237,7 +237,7 @@ export const taskResultSchema = {
             }
         },
         "finishReason": {
-            "description": "How generation ended: 'stop' (natural end), 'length' (hit maxOutputTokens), or 'cancelled'. 'error' is reserved for a provider reporting a non-fatal issue on an otherwise-returned result — no provider in this codebase currently produces it, since a full execution failure is instead surfaced by run() throwing an IndeRunError.",
+            "description": "How generation ended: 'stop' (natural end), 'length' (hit maxOutputTokens), or 'cancelled'. 'error' is reserved for a provider reporting a non-fatal issue on an otherwise-returned result — the Android ML Kit GenAI provider produces it when Gemini Nano reports a finish reason that is neither a natural stop nor the token limit. A full execution failure is instead surfaced by run() throwing an IndeRunError.",
             "enum": [
                 "stop",
                 "length",
@@ -1024,7 +1024,7 @@ export const streamEventSchema = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.inderun.dev/1.0/stream-event.schema.json",
     "title": "StreamEvent",
-    "description": "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).",
+    "description": "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. All three engines implement this union (see docs/architecture/architecture.md).",
     "oneOf": [
         {
             "type": "object",
@@ -1108,7 +1108,7 @@ export const streamEventSchema = {
                     "minimum": 0
                 },
                 "type": {
-                    "description": "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.",
+                    "description": "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. Retraction: a provider of any streamingStyle may additionally emit a content_snapshot to withdraw content it has already delivered, since a snapshot replaces the run's cumulative text rather than appending to it; an empty one therefore resets that text to nothing. This is how a provider whose backend rejects an in-flight response after partial delivery — an on-device safety/policy check, for example — tells consumers to discard what they have, so a consumer must handle content_snapshot even when the provider's declared style is 'tokens' or 'chunks'.",
                     "const": "content_snapshot"
                 },
                 "payload": {

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

@@ -11,7 +11,7 @@
  * 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
+ * as a hard error. All three engines implement this union (see
  * docs/architecture/architecture.md).
  */
 export type StreamEvent = {
@@ -57,8 +57,14 @@ export type StreamEvent = {
      *
      * 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.
+     * — providers reporting that style normalize to content_snapshot rather than content_delta.
+     * Retraction: a provider of any streamingStyle may additionally emit a content_snapshot to
+     * withdraw content it has already delivered, since a snapshot replaces the run's cumulative
+     * text rather than appending to it; an empty one therefore resets that text to nothing.
+     * This is how a provider whose backend rejects an in-flight response after partial delivery
+     * — an on-device safety/policy check, for example — tells consumers to discard what they
+     * have, so a consumer must handle content_snapshot even when the provider's declared style
+     * is 'tokens' or 'chunks'.
      *
      * Mechanical/diagnostic: a run lifecycle transition (e.g. provider selection, execution
      * start). Not user-visible content; not part of the generated text.

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

@@ -1 +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,YAAY,CAAC,EAAG,YAAY,CAAC;IAC7B,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,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;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,YAAY,CAAC,EAAG,YAAY,CAAC;IAC7B,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,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE,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/task-result.d.ts

@@ -3,14 +3,16 @@
  * (validation, routing, or every attempted provider failing) is surfaced by run() throwing
  * an IndeRunError instead of returning a TaskResult; finishReason and telemetry.errorClass
  * are reserved for a provider reporting a non-fatal, degraded outcome on an
- * otherwise-successful result (not currently produced by any provider in this codebase).
+ * otherwise-successful result (finishReason 'error' is produced by the Android ML Kit GenAI
+ * provider; telemetry.errorClass is not currently set by any provider in this codebase).
  */
 export type TaskResult = {
     /**
      * How generation ended: 'stop' (natural end), 'length' (hit maxOutputTokens), or
      * 'cancelled'. 'error' is reserved for a provider reporting a non-fatal issue on an
-     * otherwise-returned result — no provider in this codebase currently produces it, since a
-     * full execution failure is instead surfaced by run() throwing an IndeRunError.
+     * otherwise-returned result — the Android ML Kit GenAI provider produces it when Gemini
+     * Nano reports a finish reason that is neither a natural stop nor the token limit. A full
+     * execution failure is instead surfaced by run() throwing an IndeRunError.
      */
     finishReason: FinishReason;
     /**
@@ -38,8 +40,9 @@ export type TaskResult = {
 /**
  * How generation ended: 'stop' (natural end), 'length' (hit maxOutputTokens), or
  * 'cancelled'. 'error' is reserved for a provider reporting a non-fatal issue on an
- * otherwise-returned result — no provider in this codebase currently produces it, since a
- * full execution failure is instead surfaced by run() throwing an IndeRunError.
+ * otherwise-returned result — the Android ML Kit GenAI provider produces it when Gemini
+ * Nano reports a finish reason that is neither a natural stop nor the token limit. A full
+ * execution failure is instead surfaced by run() throwing an IndeRunError.
  */
 export type FinishReason = "stop" | "length" | "cancelled" | "error";
 /**

package/dist/generated/task-result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-result.d.ts","sourceRoot":"","sources":["../../src/generated/task-result.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB;;;;;OAKG;IACH,YAAY,EAAE,YAAY,CAAC;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;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;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI;;GAEG;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"}
+{"version":3,"file":"task-result.d.ts","sourceRoot":"","sources":["../../src/generated/task-result.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB;;;;;;OAMG;IACH,YAAY,EAAE,YAAY,CAAC;IAC3B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,OAAO,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACjB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;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;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI;;GAEG;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/index.d.ts

@@ -1,6 +1,35 @@
+/**
+ * Canonical IndeRun contracts for TypeScript (`@independo/inderun-contracts`).
+ *
+ * Everything here derives from the JSON Schemas in `contracts/schemas/`, which are
+ * the single source of truth across all four languages — the TypeScript types
+ * below, the Kotlin and Swift contract models, and the Rust route-core model are
+ * all generated from them by `pnpm generate`. Do not hand-edit anything under
+ * `src/generated/`; change the schema and regenerate.
+ *
+ * Apps normally do not depend on this package directly: the SDKs re-export the
+ * contract types their own signatures use. Reach for it when you need the schemas
+ * themselves or the runtime validators.
+ */
+/** The generated request/response, streaming, routing, and telemetry models. */
 export type * from "./generated/index.js";
+/** The JSON Schemas those models were generated from, for runtime use. */
 export { httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, streamEventSchema, streamRunSchema, streamTerminalOutcomeSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
+/**
+ * Ajv-backed validators for each contract. The `get*ValidationIssues` form returns
+ * a list of human-readable issues (empty when valid); the `validate*` form is the
+ * boolean type guard.
+ */
 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";
+/**
+ * Narrowed aliases over the generated models: the closed enums the SDKs switch on,
+ * and the routing input/output shapes under the names the engines use.
+ */
 export type { FinishReason, IndeRunErrorClass, ModelPackageFormat, ModelSourceType, SchemaVersion, SharedRoutePlan, SharedRoutePlannerInput, TaskKind, RoutingConstraints, RoutingPreferences } from "./types.js";
+/**
+ * The host-services contract: the platform capabilities an SDK reads and calls
+ * through. Defined here rather than per-SDK so the three platforms expose the
+ * same seams.
+ */
 export type { AbortSignalLike, ConnectivityService, ThermalState, DeviceConstraintsService, SecureStorageService, ClockService, HttpClientService, HttpStreamResponse, HttpStreamingClientService, 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,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,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACb,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,gFAAgF;AAChF,mBAAmB,sBAAsB,CAAC;AAE1C,0EAA0E;AAC1E,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;;;;GAIG;AACH,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;;;GAGG;AACH,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;;;;GAIG;AACH,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,YAAY,EACZ,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACb,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -1,2 +1,21 @@
+/**
+ * Canonical IndeRun contracts for TypeScript (`@independo/inderun-contracts`).
+ *
+ * Everything here derives from the JSON Schemas in `contracts/schemas/`, which are
+ * the single source of truth across all four languages — the TypeScript types
+ * below, the Kotlin and Swift contract models, and the Rust route-core model are
+ * all generated from them by `pnpm generate`. Do not hand-edit anything under
+ * `src/generated/`; change the schema and regenerate.
+ *
+ * Apps normally do not depend on this package directly: the SDKs re-export the
+ * contract types their own signatures use. Reach for it when you need the schemas
+ * themselves or the runtime validators.
+ */
+/** The JSON Schemas those models were generated from, for runtime use. */
 export { httpRequestSchema, httpResponseSchema, inderunErrorSchema, modelPackageSchema, routePlanSchema, routePlannerInputSchema, streamEventSchema, streamRunSchema, streamTerminalOutcomeSchema, taskRequestSchema, taskResultSchema, telemetryEventSchema } from "./generated/index.js";
+/**
+ * Ajv-backed validators for each contract. The `get*ValidationIssues` form returns
+ * a list of human-readable issues (empty when valid); the `validate*` form is the
+ * boolean type guard.
+ */
 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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@independo/inderun-contracts",
-  "version": "0.3.0-dev.8",
-  "description": "Canonical JSON Schemas, generated TypeScript types, and validators for IndeRun contracts.",
+  "version": "0.3.0",
+  "description": "Canonical JSON Schemas, generated TypeScript types, and validators for the IndeRun task, streaming, error, and routing contracts.",
   "license": "MIT",
   "author": {
     "name": "Independo GmbH",
@@ -11,7 +11,7 @@
   "bugs": "https://github.com/independo-gmbh/inderun/issues",
   "repository": {
     "type": "git",
-    "url": "https://github.com/independo-gmbh/inderun.git",
+    "url": "git+https://github.com/independo-gmbh/inderun.git",
     "directory": "packages/contracts"
   },
   "publishConfig": {
@@ -21,9 +21,12 @@
   "keywords": [
     "inderun",
     "ai",
+    "llm",
     "contracts",
     "json-schema",
-    "validation"
+    "validation",
+    "types",
+    "streaming"
   ],
   "engines": {
     "node": ">=24"
@@ -39,17 +42,20 @@
   },
   "files": [
     "dist",
+    "src",
+    "!src/**/*.test.ts",
     "README.md"
   ],
   "dependencies": {
     "ajv": "^8.20.0"
   },
   "devDependencies": {
-    "@types/node": "^26.2.0",
+    "@types/node": "^26.5.1",
     "vitest": "^4.1.11"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "test": "vitest run"
+    "test": "vitest run",
+    "verify:packaging": "publint && attw --pack . --profile esm-only"
   }
 }

package/src/generated/http-request.ts

@@ -0,0 +1,34 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+
+/**
+ * Normalized HTTP request payload for host-provided cloud transport.
+ */
+export type HttpRequest = {
+    /**
+     * Optional serialized request body. For JSON APIs this should be a JSON string.
+     */
+    body?: string;
+    /**
+     * HTTP headers to send after the provider adapter has applied any required transport-level
+     * credentials.
+     */
+    headers?: { [key: string]: string };
+    /**
+     * HTTP method to use for the request.
+     */
+    method: Method;
+    /**
+     * Optional maximum duration for the host transport attempt in milliseconds.
+     */
+    timeoutMs?: number;
+    /**
+     * Absolute target URL for the provider transport request.
+     */
+    url: string;
+    [property: string]: unknown;
+}
+
+/**
+ * HTTP method to use for the request.
+ */
+export type Method = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";

package/src/generated/http-response.ts

@@ -0,0 +1,24 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+
+/**
+ * Normalized HTTP response payload returned by host-provided cloud transport.
+ */
+export type HttpResponse = {
+    /**
+     * Serialized response body returned by the provider transport.
+     */
+    body: string;
+    /**
+     * HTTP response headers normalized to string key-value pairs.
+     */
+    headers: { [key: string]: string };
+    /**
+     * HTTP status code returned by the provider transport.
+     */
+    status: number;
+    /**
+     * HTTP status text returned by the provider transport.
+     */
+    statusText: string;
+    [property: string]: unknown;
+}

package/src/generated/inderun-error.ts

@@ -0,0 +1,55 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+
+/**
+ * The error shape thrown by run() (wrapped in an IndeRunException) when execution fails —
+ * via validation, routing (no eligible provider), or every attempted provider failing.
+ * Never returned as part of a successful TaskResult.
+ */
+export type IndeRunError = {
+    /**
+     * Optional structured diagnostic details. It must not contain raw secrets.
+     */
+    details?: { [key: string]: unknown };
+    /**
+     * Normalized error taxonomy, shared with TaskResult.telemetry.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;
+    /**
+     * Opaque run identifier associated with the failed execution, if available.
+     */
+    runId?: string;
+    /**
+     * Contract schema version used to interpret the error payload.
+     */
+    schemaVersion: "1.0";
+    [property: string]: unknown;
+}
+
+/**
+ * Normalized error taxonomy, shared with TaskResult.telemetry.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";

package/src/generated/index.ts

@@ -0,0 +1,15 @@
+/* This file was generated from JSON Schema. Do not edit by hand. */
+
+export type { TaskRequest } from "./task-request.js";
+export type { TaskResult } from "./task-result.js";
+export type { IndeRunError } from "./inderun-error.js";
+export type { HttpRequest } from "./http-request.js";
+export type { HttpResponse } from "./http-response.js";
+export type { TelemetryEvent } from "./telemetry-event.js";
+export type { RoutePlannerInput } from "./route-planner-input.js";
+export type { RoutePlan } from "./route-plan.js";
+export type { ModelPackage } from "./model-package.js";
+export type { StreamRunHandle } from "./stream-run.js";
+export type { StreamEvent } from "./stream-event.js";
+export type { StreamTerminalOutcome } from "./stream-terminal-outcome.js";
+export * from "./schemas.js";

package/src/generated/model-package.ts

@@ -0,0 +1,191 @@
+/* This file was generated from JSON Schema using quicktype. Do not edit by hand. */
+
+/**
+ * Provider-neutral descriptor for a developer-supplied/custom local model made available to
+ * an IndeRun local-model provider family (for example, the ONNX Runtime family). It
+ * describes model identity, format, task support, source, files, integrity, licensing, and
+ * resource expectations. It is bootstrap/configuration metadata resolved before execution;
+ * it is not part of the public TaskRequest/TaskResult surface, and it must not carry raw
+ * secrets.
+ */
+export type ModelPackage = {
+    /**
+     * Files that make up the model package, expressed as source-relative names/paths. The
+     * provider adapter and model source resolve these to concrete bytes per platform.
+     */
+    files?: Files;
+    /**
+     * Model packaging format the target runtime family must understand. 'onnx' is a plain ONNX
+     * graph, 'ort' is an ONNX Runtime optimized/mobile format, 'genai' is an ONNX Runtime GenAI
+     * model package.
+     */
+    format: Format;
+    /**
+     * Stable application-scoped identifier for the model package.
+     */
+    id: string;
+    /**
+     * Optional integrity metadata used to validate resolved files before load.
+     */
+    integrity?: Integrity;
+    /**
+     * Optional license/source metadata for the model, for developer transparency. Free-form.
+     */
+    license?: License;
+    /**
+     * Optional known resource expectations, used by capability checks to reject on constrained
+     * devices before load.
+     */
+    limits?: Limits;
+    /**
+     * Optional runtime compatibility expectations. Fields are advisory hints for capability
+     * checks; the provider adapter owns exact enforcement.
+     */
+    runtime?: Runtime;
+    /**
+     * Where the model files are obtained from. Availability of each source type is
+     * platform-dependent; see the ONNX Runtime provider-family specification for the
+     * per-platform support matrix.
+     */
+    source?: Source;
+    /**
+     * IndeRun task kinds this model package can serve (for example 'text_to_text'). Used by
+     * dynamic capability checks and route matching.
+     */
+    tasks?: string[];
+    /**
+     * Optional application-defined version for the model package, used for cache invalidation
+     * and compatibility checks.
+     */
+    version?: string;
+    [property: string]: unknown;
+}
+
+/**
+ * Files that make up the model package, expressed as source-relative names/paths. The
+ * provider adapter and model source resolve these to concrete bytes per platform.
+ */
+export type Files = {
+    /**
+     * Optional model/generation config file, where the model requires one.
+     */
+    config?: string;
+    /**
+     * Optional external data files referenced by the model graph (for example ONNX external
+     * weights).
+     */
+    external?: string[];
+    /**
+     * Files that must be present for the package to load (for example the model graph).
+     */
+    required?: string[];
+    /**
+     * Optional tokenizer file, where the model requires one.
+     */
+    tokenizer?: string;
+    [property: string]: unknown;
+}
+
+/**
+ * Model packaging format the target runtime family must understand. 'onnx' is a plain ONNX
+ * graph, 'ort' is an ONNX Runtime optimized/mobile format, 'genai' is an ONNX Runtime GenAI
+ * model package.
+ */
+export type Format = "onnx" | "ort" | "genai";
+
+/**
+ * Optional integrity metadata used to validate resolved files before load.
+ */
+export type Integrity = {
+    /**
+     * Map of file name to expected checksum (for example 'sha256:...'). Absence means integrity
+     * is not verified by IndeRun.
+     */
+    checksums?: { [key: string]: string };
+    [property: string]: unknown;
+}
+
+/**
+ * Optional license/source metadata for the model, for developer transparency. Free-form.
+ */
+export type License = {
+    /**
+     * SPDX license identifier where known (for example 'Apache-2.0').
+     */
+    spdx?: string;
+    /**
+     * License or model card URL where available.
+     */
+    url?: string;
+    [property: string]: unknown;
+}
+
+/**
+ * Optional known resource expectations, used by capability checks to reject on constrained
+ * devices before load.
+ */
+export type Limits = {
+    /**
+     * Approximate on-disk size of the resolved package, where known.
+     */
+    diskBytes?: number;
+    /**
+     * Approximate peak memory required to run the model, where known.
+     */
+    memBytes?: number;
+    [property: string]: unknown;
+}
+
+/**
+ * Optional runtime compatibility expectations. Fields are advisory hints for capability
+ * checks; the provider adapter owns exact enforcement.
+ */
+export type Runtime = {
+    /**
+     * Minimum ONNX opset version the model requires, where known.
+     */
+    minOpset?: number;
+    /**
+     * Minimum runtime package version required to load the model, where known.
+     */
+    minRuntimeVersion?: string;
+    /**
+     * Platforms the package is expected to run on (for example 'web', 'android', 'apple').
+     * Absence means unconstrained.
+     */
+    platforms?: string[];
+    [property: string]: unknown;
+}
+
+/**
+ * Where the model files are obtained from. Availability of each source type is
+ * platform-dependent; see the ONNX Runtime provider-family specification for the
+ * per-platform support matrix.
+ */
+export type Source = {
+    /**
+     * Optional source-specific reference (for example a registry repo id or a bundled asset
+     * base path). Interpretation depends on 'sourceType'. Must not contain credentials: URL
+     * userinfo (for example 'https://user:pass@host/...') is rejected, and credentials must be
+     * supplied via authContextRef instead.
+     */
+    ref?: string;
+    /**
+     * Discriminator for how the host makes model files available. 'registry' is a web
+     * repository/registry reference (for example a Hugging Face-style repo), 'bundled' is an
+     * app asset/resource, 'programmatic' is supplied directly by application code, 'filesystem'
+     * is a local path where the platform allows it, 'app_managed' is an app-managed
+     * cache/storage location, 'remote' is a host-managed download.
+     */
+    sourceType: SourceType;
+    [property: string]: unknown;
+}
+
+/**
+ * Discriminator for how the host makes model files available. 'registry' is a web
+ * repository/registry reference (for example a Hugging Face-style repo), 'bundled' is an
+ * app asset/resource, 'programmatic' is supplied directly by application code, 'filesystem'
+ * is a local path where the platform allows it, 'app_managed' is an app-managed
+ * cache/storage location, 'remote' is a host-managed download.
+ */
+export type SourceType = "registry" | "bundled" | "programmatic" | "filesystem" | "app_managed" | "remote";