Skip to content

IndeRunError

IndeRunError = object

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.

[property: string]: unknown

optional details?: object

Optional structured diagnostic details. It must not contain raw secrets.

[key: string]: unknown


errorClass: ErrorClass

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).


message: string

Human-readable error message suitable for logs and developer diagnostics.


optional provenance?: ExecutionProvenance

Normalized execution provenance: which target ran, its declared locality, the configured and reported model, and how fallback and routing played out. See execution-provenance.schema.json.


optional providerId?: string

Identifier of the provider associated with the failure, if execution reached a provider.


optional retryable?: boolean

Whether retrying the same request may succeed.


optional retryAfterMs?: number

Optional suggested delay before retrying, in milliseconds.


optional runId?: string

Opaque run identifier associated with the failed execution, if available.


schemaVersion: "1.0"

Contract schema version used to interpret the error payload.