ProviderError

Defined in: core/src/errors.ts:117

Extends

• Error

Extended by

• NoAvailableProviderError
• NoAvailableKeyError

Constructors

Constructor

new ProviderError(
   provider,
   kind,
   message,
   opts?
): ProviderError;

Defined in: core/src/errors.ts:134

Parameters

Parameter	Type
provider	string
kind	ErrorKind
message	string
opts	{ body?: string; cause?: unknown; code?: string; resetAtMs?: number; retryAfterMs?: number; shouldRetry?: boolean; status?: number; window?: RateLimitWindow; }
opts.body?	string
opts.cause?	unknown
opts.code?	string
opts.resetAtMs?	number
opts.retryAfterMs?	number
opts.shouldRetry?	boolean
opts.status?	number
opts.window?	RateLimitWindow

Returns

ProviderError

Overrides

Error.constructor

Properties

body?

readonly optional body?: string;

Defined in: core/src/errors.ts:132

The provider’s own response body, truncated. It carries the actual reason, otherwise lost behind “400 status code (no body)”.

---

cause?

optional cause?: unknown;

Defined in: node_modules/.bun/typescript@5.9.3/node_modules/typescript/lib/lib.es2022.error.d.ts:26

Inherited from

Error.cause

---

code?

readonly optional code?: string;

Defined in: core/src/errors.ts:121

---

kind

readonly kind: ErrorKind;

Defined in: core/src/errors.ts:119

---

message

message: string;

Defined in: node_modules/.bun/typescript@5.9.3/node_modules/typescript/lib/lib.es5.d.ts:1077

Inherited from

Error.message

---

name

name: string;

Defined in: node_modules/.bun/typescript@5.9.3/node_modules/typescript/lib/lib.es5.d.ts:1076

Inherited from

Error.name

---

provider

readonly provider: string;

Defined in: core/src/errors.ts:118

---

resetAtMs?

readonly optional resetAtMs?: number;

Defined in: core/src/errors.ts:126

Absolute reset of the binding limit. Can be days beyond Retry-After.

---

retryAfterMs?

readonly optional retryAfterMs?: number;

Defined in: core/src/errors.ts:124

Honoured when the provider said how long to wait (Retry-After, or Gemini’s RetryInfo.retryDelay).

---

shouldRetry?

readonly optional shouldRetry?: boolean;

Defined in: core/src/errors.ts:129

Explicit server directive (x-should-retry), overriding default classification.

---

stack?

optional stack?: string;

Defined in: node_modules/.bun/typescript@5.9.3/node_modules/typescript/lib/lib.es5.d.ts:1078

Inherited from

Error.stack

---

status?

readonly optional status?: number;

Defined in: core/src/errors.ts:120

---

window?

readonly optional window?: RateLimitWindow;

Defined in: core/src/errors.ts:127

Accessors

isBackupEligible

Get Signature

get isBackupEligible(): boolean;

Defined in: core/src/errors.ts:167

Returns

boolean

---

isTransient

Get Signature

get isTransient(): boolean;

Defined in: core/src/errors.ts:162

Returns

boolean

Methods

from()

static from(provider, err): ProviderError;

Defined in: core/src/errors.ts:173

Wrap anything thrown into a classified ProviderError. Already-wrapped errors pass through untouched, so classification happens exactly once.

Parameters

Parameter	Type
provider	string
err	unknown

Returns

ProviderError