Skip to content

IndeRunException

Standardized framework exception thrown when route selection or provider execution fails. Extends the native JavaScript Error class and exposes normalized error schema fields.

  • Error

new IndeRunException(params): IndeRunException

IndeRunExceptionParams

IndeRunException

Error.constructor

optional cause?: unknown

Error.cause


readonly optional details?: Record<string, unknown>

Custom details and metadata context.


readonly errorClass: ErrorClass

The categorized class of error.


message: string

Error.message


name: string

Error.name


readonly optional provenance?: ExecutionProvenance

How the failed execution played out: attempts, rejections, the provider committed to.


readonly optional providerId?: string

The provider ID responsible for the error.


readonly optional retryable?: boolean

Whether the error is transient and retryable.


readonly optional retryAfterMs?: number

Suggested cooling-down time in milliseconds before retry.


readonly optional runId?: string

The unique execution run ID.


readonly schemaVersion: "1.0" = "1.0"

The schema version matching the API contracts.


optional stack?: string

Error.stack

toContractError(): IndeRunError

Converts the exception into a JSON-compatible contract-compliant IndeRunError.

IndeRunError


withProvenance(provenance): IndeRunException

A copy of this exception carrying provenance. The engine attaches provenance once it knows how the whole execution ended, replacing anything set earlier.

ExecutionProvenance

IndeRunException