@independo/inderun-contracts 0.4.0-rc.2 → 0.5.0-rc.1

package/dist/generated/execution-provenance.d.ts

@@ -91,5 +91,5 @@ export type ExecutionProvenanceRouteRejection = {
     providerId: string;
     [property: string]: unknown;
 };
-export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_supported" | "streaming_unavailable" | "privacy_constraint" | "cloud_constraint" | "offline" | "capability_unavailable" | "not_in_model_profile";
+export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_supported" | "streaming_unavailable" | "privacy_constraint" | "cloud_constraint" | "offline" | "capability_unavailable" | "not_in_model_profile" | "input_not_supported" | "output_delivery_not_supported" | "output_format_not_supported" | "locale_not_supported" | "voice_not_available";
 //# sourceMappingURL=execution-provenance.d.ts.map

package/dist/generated/execution-provenance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execution-provenance.d.ts","sourceRoot":"","sources":["../../src/generated/execution-provenance.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,eAAe,EAAE,iCAAiC,EAAE,CAAC;IACrD;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAK,cAAc,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,iCAAiC,GAAG;IAC5C,KAAK,EAAO,IAAI,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,IAAI,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,SAAS,GAAG,wBAAwB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"execution-provenance.d.ts","sourceRoot":"","sources":["../../src/generated/execution-provenance.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,eAAe,EAAE,iCAAiC,EAAE,CAAC;IACrD;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAK,cAAc,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,iCAAiC,GAAG;IAC5C,KAAK,EAAO,IAAI,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,IAAI,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,SAAS,GAAG,wBAAwB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,+BAA+B,GAAG,6BAA6B,GAAG,sBAAsB,GAAG,qBAAqB,CAAC"}

package/dist/generated/inderun-error.d.ts

@@ -153,5 +153,5 @@ export type ExecutionProvenanceRouteRejection = {
     providerId: string;
     [property: string]: unknown;
 };
-export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_supported" | "streaming_unavailable" | "privacy_constraint" | "cloud_constraint" | "offline" | "capability_unavailable" | "not_in_model_profile";
+export type Code = "task_not_supported" | "run_not_supported" | "streaming_not_supported" | "streaming_unavailable" | "privacy_constraint" | "cloud_constraint" | "offline" | "capability_unavailable" | "not_in_model_profile" | "input_not_supported" | "output_delivery_not_supported" | "output_format_not_supported" | "locale_not_supported" | "voice_not_available";
 //# sourceMappingURL=inderun-error.d.ts.map

package/dist/generated/inderun-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inderun-error.d.ts","sourceRoot":"","sources":["../../src/generated/inderun-error.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB;;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;;;;OAIG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;;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,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,eAAe,EAAE,iCAAiC,EAAE,CAAC;IACrD;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAK,cAAc,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,iCAAiC,GAAG;IAC5C,KAAK,EAAO,IAAI,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,IAAI,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,SAAS,GAAG,wBAAwB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"inderun-error.d.ts","sourceRoot":"","sources":["../../src/generated/inderun-error.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB;;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;;;;OAIG;IACH,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC;;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,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;AAEjI;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,EAAE,QAAQ,CAAC;IACnB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,eAAe,EAAE,iCAAiC,EAAE,CAAC;IACrD;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAK,cAAc,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAElE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,iCAAiC,GAAG;IAC5C,KAAK,EAAO,IAAI,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B,CAAA;AAED,MAAM,MAAM,IAAI,GAAG,oBAAoB,GAAG,mBAAmB,GAAG,yBAAyB,GAAG,uBAAuB,GAAG,oBAAoB,GAAG,kBAAkB,GAAG,SAAS,GAAG,wBAAwB,GAAG,sBAAsB,GAAG,qBAAqB,GAAG,+BAA+B,GAAG,6BAA6B,GAAG,sBAAsB,GAAG,qBAAqB,CAAC"}

package/dist/generated/index.d.ts

@@ -10,6 +10,9 @@ 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 type { ProviderCapabilitySnapshot } from "./provider-capability-snapshot.js";
+export type { ProviderDescriptor } from "./provider-descriptor.js";
+export type { ProviderDynamicCapabilities } from "./provider-dynamic-capabilities.js";
 export type { ExecutionProvenance } from "./execution-provenance.js";
 export * from "./schemas.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/generated/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAC1E,YAAY,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpF,YAAY,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,YAAY,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AACtF,YAAY,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AACrE,cAAc,cAAc,CAAC"}

package/dist/generated/provider-capability-snapshot.d.ts

@@ -0,0 +1,370 @@
+/**
+ * One registered provider's identity, static declaration and live capability check, as
+ * returned by checkCapabilities(). A read-only snapshot: producing it executes no task and
+ * has no side effects.
+ */
+export type ProviderCapabilitySnapshot = {
+    /**
+     * The provider's live capability check at the time of the call.
+     */
+    capabilities: ProviderDynamicCapabilities;
+    /**
+     * The provider's static capability declaration.
+     */
+    descriptor: ProviderDescriptor;
+    /**
+     * Identifier of the provider; equal to descriptor.id.
+     */
+    providerId: string;
+    [property: string]: unknown;
+};
+/**
+ * The provider's live capability check at the time of the call.
+ *
+ * A provider's live capability check, evaluated on the current host when routing or when
+ * checkCapabilities() is called. Unlike the descriptor it can change between calls.
+ */
+export type ProviderDynamicCapabilities = {
+    /**
+     * Whether the provider is available and functional on this host right now.
+     */
+    available: boolean;
+    /**
+     * Whether cancellation is honored on this host right now. Absent inherits the static
+     * descriptor.cancel value: any value other than 'none' means available. Never null.
+     */
+    cancellationAvailable?: boolean;
+    /**
+     * Why the provider is unavailable, when available is false.
+     */
+    reason?: string;
+    /**
+     * Whether the provider can stream (Mode 2) on this host right now. Absent inherits the
+     * static descriptor.supports.streaming value; only set it when the host takes streaming
+     * away from a provider that otherwise declares it. Never null.
+     */
+    streamingAvailable?: boolean;
+    /**
+     * Why streaming is unavailable, when streamingAvailable is false. Absent lets the route
+     * planner synthesize a default message.
+     */
+    streamingUnavailableReason?: string;
+    /**
+     * Per-task overrides of the provider-level check, for tasks whose availability differs on
+     * this host, e.g. a voice that is not installed. Every field of an entry is optional and
+     * absent inherits the provider-level value; a false at either level wins.
+     */
+    taskCapabilities?: ProviderTaskAvailability[];
+    [property: string]: unknown;
+};
+/**
+ * The live check for one task kind.
+ */
+export type ProviderTaskAvailability = {
+    /**
+     * Whether the task can run on this host right now. Absent inherits the provider-level
+     * available. Never null.
+     */
+    available?: boolean;
+    /**
+     * Whether cancellation is honored for this task right now. Absent inherits. Never null.
+     */
+    cancellationAvailable?: boolean;
+    /**
+     * The task kind this entry describes.
+     */
+    kind: string;
+    /**
+     * BCP 47 locales available for this task right now. Absent means the provider cannot
+     * enumerate them.
+     */
+    locales?: string[];
+    /**
+     * Why the task is unavailable, when available is false.
+     */
+    reason?: string;
+    /**
+     * Whether the task can stream on this host right now. Absent inherits. Never null.
+     */
+    streamingAvailable?: boolean;
+    /**
+     * Why streaming is unavailable for this task, when streamingAvailable is false.
+     */
+    streamingUnavailableReason?: string;
+    /**
+     * Voices available for this task right now. Absent means the provider cannot enumerate
+     * them; a request that requires a voice then never routes to it.
+     */
+    voices?: ProviderVoice[];
+    [property: string]: unknown;
+};
+/**
+ * Provider-neutral traits of one available voice. Carries no provider voice identifier.
+ */
+export type ProviderVoice = {
+    gender?: VoiceGender;
+    /**
+     * BCP 47 locale the voice speaks.
+     */
+    locale: string;
+    /**
+     * Whether using the voice sends data off the device. Absent inherits the task's privacy
+     * posture.
+     */
+    networkRequired?: boolean;
+    [property: string]: unknown;
+};
+/**
+ * Perceived gender of a voice, as the platform reports it.
+ */
+export type VoiceGender = "female" | "male" | "neutral";
+/**
+ * The provider's static capability declaration.
+ *
+ * A provider's static capability declaration: identity, placement, transport, supported
+ * interaction modes and tasks, cancellation guarantee, resource limits and privacy posture.
+ * It does not change while the provider is registered. The route planner,
+ * checkCapabilities() and execution provenance all read this one shape.
+ */
+export type ProviderDescriptor = {
+    /**
+     * Cancellation guarantee: 'hard' stops processing including remote work, 'soft' stops
+     * reading locally while remote work may continue, 'none' means cancellation is unsupported.
+     * Independently of this value, the engine delivers no event after a cancel.
+     */
+    cancel: CancelSemantics;
+    /**
+     * Unique identifier of the provider instance (a target), e.g. 'apple_foundation_models' or
+     * 'openai_compatible_cloud:gpt-5-mini'. Model profiles list targets by this id.
+     */
+    id: string;
+    /**
+     * Optional input and output resource limits.
+     */
+    limits?: ProviderLimits;
+    /**
+     * The model this provider instance is bound to, when it can name one. Cloud providers
+     * report the model id they send; platform-managed models report an opaque platform alias
+     * rather than a guessed weight name. Absent means the provider cannot name its model.
+     */
+    model?: string;
+    /**
+     * Data-egress posture, used to enforce local and cloud routing rules. Absent means a local
+     * or edge provider is treated as keeping data on the device and a cloud provider as sending
+     * it off.
+     */
+    privacy?: ProviderPrivacy;
+    /**
+     * How a streaming provider delivers incremental output: individual tokens, larger chunks,
+     * or whole snapshots. Absent for providers that do not stream.
+     */
+    streamingStyle?: StreamingStyle;
+    /**
+     * Interaction modes and features the provider statically declares.
+     */
+    supports: ProviderSupports;
+    /**
+     * What the provider can do for each task: accepted inputs, interaction modes, output
+     * deliveries and formats, cancellation, locales and privacy. When present it is
+     * authoritative for routing and must list every task the provider serves. When absent (a
+     * legacy descriptor), routing infers exactly one entry — 'text_to_text' with text input,
+     * inline output, run/stream from supports and cancel from cancel — if tasks contains
+     * 'text_to_text', and nothing for any other task: a legacy descriptor is never treated as
+     * capable of a non-text task.
+     */
+    taskCapabilities?: ProviderTaskCapability[];
+    /**
+     * Task kinds the provider supports, e.g. 'text_to_text'. When taskCapabilities is present
+     * it must describe the same kinds and is what routing reads; without it, routing infers
+     * capabilities for 'text_to_text' alone (see taskCapabilities).
+     */
+    tasks: string[];
+    /**
+     * How the engine reaches the provider: in-process runtime, operating-system service,
+     * buffered HTTP, server-sent events, or a realtime connection.
+     */
+    transport: ProviderTransport;
+    /**
+     * Execution placement: 'local' (on the device), 'edge', or 'cloud'.
+     */
+    type: ProviderType;
+    [property: string]: unknown;
+};
+/**
+ * Cancellation guarantee: 'hard' stops processing including remote work, 'soft' stops
+ * reading locally while remote work may continue, 'none' means cancellation is unsupported.
+ * Independently of this value, the engine delivers no event after a cancel.
+ *
+ * Cancellation guarantee for this task. It may differ from the provider-level cancel, e.g.
+ * when stopping playback is immediate but a synthesis request cannot be aborted.
+ */
+export type CancelSemantics = "hard" | "soft" | "none";
+/**
+ * Optional input and output resource limits.
+ */
+export type ProviderLimits = {
+    /**
+     * Longest accepted or produced audio, in seconds.
+     */
+    maxAudioSeconds?: number;
+    /**
+     * Largest accepted image, in bytes.
+     */
+    maxImageBytes?: number;
+    /**
+     * Largest accepted input, in tokens.
+     */
+    maxInputTokens?: number;
+    /**
+     * Largest output the provider produces, in tokens.
+     */
+    maxOutputTokens?: number;
+    [property: string]: unknown;
+};
+/**
+ * Data-egress posture, used to enforce local and cloud routing rules. Absent means a local
+ * or edge provider is treated as keeping data on the device and a cloud provider as sending
+ * it off.
+ *
+ * Data-egress posture for this task when it differs from the provider-level privacy, e.g. a
+ * provider whose speech synthesis uses a network service. Absent inherits
+ * descriptor.privacy.
+ */
+export type ProviderPrivacy = {
+    /**
+     * Whether request content leaves the device.
+     */
+    dataLeavesDevice: boolean;
+    /**
+     * Geographic regions where a cloud provider processes data.
+     */
+    regions?: string[];
+    [property: string]: unknown;
+};
+/**
+ * How a streaming provider delivers incremental output: individual tokens, larger chunks,
+ * or whole snapshots. Absent for providers that do not stream.
+ */
+export type StreamingStyle = "tokens" | "chunks" | "snapshots";
+/**
+ * Interaction modes and features the provider statically declares.
+ */
+export type ProviderSupports = {
+    /**
+     * Whether the provider accepts non-text inputs such as images or audio.
+     */
+    multimodal: boolean;
+    /**
+     * Whether the provider supports Mode 3 realtime sessions. Reserved; no engine implements
+     * Mode 3 yet.
+     */
+    realtime: boolean;
+    /**
+     * Whether the provider emits reasoning events alongside content.
+     */
+    reasoningEvents: boolean;
+    /**
+     * Whether the provider supports Mode 1 run (request/response).
+     */
+    run: boolean;
+    /**
+     * Whether the provider supports Mode 2 stream. A provider that declares it must also
+     * implement the streaming adapter; the engines report it as unavailable otherwise.
+     */
+    streaming: boolean;
+    /**
+     * Whether the provider supports structured output constrained by a JSON schema.
+     */
+    structuredOutput: boolean;
+    /**
+     * Whether the provider supports tool calling.
+     */
+    tools: boolean;
+    [property: string]: unknown;
+};
+/**
+ * The provider's static capabilities for one task kind.
+ */
+export type ProviderTaskCapability = {
+    /**
+     * Cancellation guarantee for this task. It may differ from the provider-level cancel, e.g.
+     * when stopping playback is immediate but a synthesis request cannot be aborted.
+     */
+    cancel: CancelSemantics;
+    /**
+     * Input media kinds the provider accepts for this task.
+     */
+    inputs: [TaskInputKind, ...TaskInputKind[]];
+    /**
+     * Interaction modes the provider supports for this task.
+     */
+    interaction: ProviderTaskInteraction;
+    /**
+     * The task kind this entry describes, e.g. 'text_to_speech'.
+     */
+    kind: string;
+    /**
+     * BCP 47 locales the provider can serve for this task, when it knows them statically.
+     * Absent means unknown; the dynamic check may report them instead.
+     */
+    locales?: string[];
+    /**
+     * How results of this task can be delivered. A provider lists only what it really produces:
+     * a provider that can only play audio lists 'playback' and never 'artifact'.
+     */
+    outputs: [ProviderTaskOutput, ...ProviderTaskOutput[]];
+    /**
+     * Data-egress posture for this task when it differs from the provider-level privacy, e.g. a
+     * provider whose speech synthesis uses a network service. Absent inherits
+     * descriptor.privacy.
+     */
+    privacy?: ProviderPrivacy;
+    [property: string]: unknown;
+};
+/**
+ * A kind of input medium a task consumes.
+ */
+export type TaskInputKind = "text" | "image" | "audio";
+/**
+ * Interaction modes the provider supports for this task.
+ */
+export type ProviderTaskInteraction = {
+    /**
+     * Whether the provider supports Mode 1 run for this task.
+     */
+    run: boolean;
+    /**
+     * Whether the provider supports Mode 2 stream for this task.
+     */
+    stream: boolean;
+    [property: string]: unknown;
+};
+/**
+ * One way the provider can deliver a task's result.
+ */
+export type ProviderTaskOutput = {
+    delivery: OutputDelivery;
+    /**
+     * Media types the provider can produce with this delivery, e.g. 'audio/wav'. Absent means
+     * the provider does not declare them; a request that requires specific media types never
+     * routes to such an output.
+     */
+    mediaTypes?: string[];
+    [property: string]: unknown;
+};
+/**
+ * How a task's result reaches the application: 'inline' content in the result (text),
+ * 'playback' as a managed, audible effect on the device with no retrievable bytes, or
+ * 'artifact' as retrievable media.
+ */
+export type OutputDelivery = "inline" | "playback" | "artifact";
+/**
+ * How the engine reaches the provider: in-process runtime, operating-system service,
+ * buffered HTTP, server-sent events, or a realtime connection.
+ */
+export type ProviderTransport = "in_process" | "system_service" | "http" | "sse" | "realtime";
+/**
+ * Execution placement: 'local' (on the device), 'edge', or 'cloud'.
+ */
+export type ProviderType = "local" | "edge" | "cloud";
+//# sourceMappingURL=provider-capability-snapshot.d.ts.map

package/dist/generated/provider-capability-snapshot.d.ts.map

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

package/dist/generated/provider-capability-snapshot.js

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