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

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

@@ -1,5 +1,7 @@
 /**
- * Normalized Milestone-1 error contract.
+ * 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 = {
     /**
@@ -9,7 +11,11 @@ export type IndeRunError = {
         [key: string]: unknown;
     };
     /**
-     * Normalized error taxonomy class.
+     * 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;
     /**
@@ -39,7 +45,11 @@ export type IndeRunError = {
     [property: string]: unknown;
 };
 /**
- * Normalized error taxonomy class.
+ * 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";
 //# 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;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACrC;;OAEG;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,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,aAAa,EAAE,KAAK,CAAC;IACrB,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"}
+{"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;;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;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAAG,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC"}

package/dist/generated/schemas.d.ts

@@ -2,7 +2,7 @@ export declare const taskRequestSchema: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
     readonly $id: "https://schemas.inderun.dev/1.0/task-request.schema.json";
     readonly title: "TaskRequest";
-    readonly description: "The standard request payload for initiating a text-to-text execution task within the IndeRun framework.";
+    readonly description: "The request payload for a Mode 1 (request/response) text-to-text execution. At least one of `prompt` (single-turn) or `messages` (multi-turn) must be present — both may be present together, though callers should typically supply just one; `constraints`/`preferences` steer routing but never select a provider directly.";
     readonly type: "object";
     readonly additionalProperties: true;
     readonly required: readonly ["schemaVersion", "task"];
@@ -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 standard response payload for completed text-to-text execution within the IndeRun framework.";
+    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 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: "Standardized reason describing how generation concluded (e.g., 'stop', 'length', 'cancelled', or 'error').";
+            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 enum: readonly ["stop", "length", "cancelled", "error"];
         };
         readonly usage: {
@@ -232,7 +232,7 @@ export declare const taskResultSchema: {
                     readonly minimum: 0;
                 };
                 readonly errorClass: {
-                    readonly description: "Included if the request resulted in a provider-level error (e.g., 'CapabilityMismatch' or 'Unavailable').";
+                    readonly description: "Present only if a provider reports a degraded outcome on an otherwise-successful result; no provider in this codebase currently sets this. Distinct from run() throwing — a thrown IndeRunError never produces a TaskResult at all.";
                     readonly enum: readonly ["CapabilityMismatch", "Offline", "AuthError", "RateLimited", "Timeout", "Unavailable", "Internal"];
                 };
             };
@@ -243,7 +243,7 @@ export declare const inderunErrorSchema: {
     readonly $schema: "https://json-schema.org/draft/2020-12/schema";
     readonly $id: "https://schemas.inderun.dev/1.0/inderun-error.schema.json";
     readonly title: "IndeRunError";
-    readonly description: "Normalized Milestone-1 error contract.";
+    readonly description: "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.";
     readonly type: "object";
     readonly additionalProperties: true;
     readonly required: readonly ["schemaVersion", "errorClass", "message"];
@@ -253,7 +253,7 @@ export declare const inderunErrorSchema: {
             readonly const: "1.0";
         };
         readonly errorClass: {
-            readonly description: "Normalized error taxonomy class.";
+            readonly description: "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).";
             readonly enum: readonly ["CapabilityMismatch", "Offline", "AuthError", "RateLimited", "Timeout", "Unavailable", "Internal"];
         };
         readonly message: {

package/dist/generated/schemas.js

@@ -3,7 +3,7 @@ export const taskRequestSchema = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.inderun.dev/1.0/task-request.schema.json",
     "title": "TaskRequest",
-    "description": "The standard request payload for initiating a text-to-text execution task within the IndeRun framework.",
+    "description": "The request payload for a Mode 1 (request/response) text-to-text execution. At least one of `prompt` (single-turn) or `messages` (multi-turn) must be present — both may be present together, though callers should typically supply just one; `constraints`/`preferences` steer routing but never select a provider directly.",
     "type": "object",
     "additionalProperties": true,
     "required": [
@@ -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 standard response payload for completed text-to-text execution within the IndeRun framework.",
+    "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).",
     "type": "object",
     "additionalProperties": true,
     "required": [
@@ -237,7 +237,7 @@ export const taskResultSchema = {
             }
         },
         "finishReason": {
-            "description": "Standardized reason describing how generation concluded (e.g., 'stop', 'length', 'cancelled', or 'error').",
+            "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.",
             "enum": [
                 "stop",
                 "length",
@@ -287,7 +287,7 @@ export const taskResultSchema = {
                     "minimum": 0
                 },
                 "errorClass": {
-                    "description": "Included if the request resulted in a provider-level error (e.g., 'CapabilityMismatch' or 'Unavailable').",
+                    "description": "Present only if a provider reports a degraded outcome on an otherwise-successful result; no provider in this codebase currently sets this. Distinct from run() throwing — a thrown IndeRunError never produces a TaskResult at all.",
                     "enum": [
                         "CapabilityMismatch",
                         "Offline",
@@ -306,7 +306,7 @@ export const inderunErrorSchema = {
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "$id": "https://schemas.inderun.dev/1.0/inderun-error.schema.json",
     "title": "IndeRunError",
-    "description": "Normalized Milestone-1 error contract.",
+    "description": "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.",
     "type": "object",
     "additionalProperties": true,
     "required": [
@@ -320,7 +320,7 @@ export const inderunErrorSchema = {
             "const": "1.0"
         },
         "errorClass": {
-            "description": "Normalized error taxonomy class.",
+            "description": "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).",
             "enum": [
                 "CapabilityMismatch",
                 "Offline",

package/dist/generated/task-request.d.ts

@@ -1,6 +1,8 @@
 /**
- * The standard request payload for initiating a text-to-text execution task within the
- * IndeRun framework.
+ * The request payload for a Mode 1 (request/response) text-to-text execution. At least one
+ * of `prompt` (single-turn) or `messages` (multi-turn) must be present — both may be
+ * present together, though callers should typically supply just one;
+ * `constraints`/`preferences` steer routing but never select a provider directly.
  */
 export type TaskRequest = {
     /**

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

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

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

@@ -1,11 +1,16 @@
 /**
- * The standard response payload for completed text-to-text execution within the IndeRun
- * framework.
+ * 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).
  */
 export type TaskResult = {
     /**
-     * Standardized reason describing how generation concluded (e.g., 'stop', 'length',
-     * 'cancelled', or 'error').
+     * 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.
      */
     finishReason: FinishReason;
     /**
@@ -31,8 +36,10 @@ export type TaskResult = {
     [property: string]: unknown;
 };
 /**
- * Standardized reason describing how generation concluded (e.g., 'stop', 'length',
- * 'cancelled', or 'error').
+ * 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.
  */
 export type FinishReason = "stop" | "length" | "cancelled" | "error";
 /**
@@ -54,8 +61,9 @@ export type Output = {
  */
 export type Telemetry = {
     /**
-     * Included if the request resulted in a provider-level error (e.g., 'CapabilityMismatch' or
-     * 'Unavailable').
+     * Present only if a provider reports a degraded outcome on an otherwise-successful result;
+     * no provider in this codebase currently sets this. Distinct from run() throwing — a thrown
+     * IndeRunError never produces a TaskResult at all.
      */
     errorClass?: ErrorClass;
     /**
@@ -71,8 +79,9 @@ export type Telemetry = {
     [property: string]: unknown;
 };
 /**
- * Included if the request resulted in a provider-level error (e.g., 'CapabilityMismatch' or
- * 'Unavailable').
+ * Present only if a provider reports a degraded outcome on an otherwise-successful result;
+ * no provider in this codebase currently sets this. Distinct from run() throwing — a thrown
+ * IndeRunError never produces a TaskResult at all.
  */
 export type ErrorClass = "CapabilityMismatch" | "Offline" | "AuthError" | "RateLimited" | "Timeout" | "Unavailable" | "Internal";
 /**

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;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG;IACrB;;;OAGG;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;;;GAGG;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;;;OAGG;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;;;GAGG;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;;;;;;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"}

package/package.json

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