Class BaseProviderAbstract

Protected_supportedModels

Protected ReadonlybaseConfig

ProtectedbaseURL

• get baseURL(): string | undefined

  Origin this provider talks to; shown in PROVIDER_UNREACHABLE hints.

  Returns string | undefined

Protectedcached

• cached(): string[] | null

  The last successful discovery, while younger than modelCacheTtlMs (default 5 min; 0 disables).

  Returns string[] | null

Protectedclassify

• classify(_status: number, _json: any, _text: string): Refinement

  Provider-specific reading of an error body. Return the fields you can tell from it (code, providerCode, hint, retryAfterMs); the status code default fills the rest.

  Parameters

  • _status: number
  • _json: any
  • _text: string

  Returns Refinement

Protectederror

• error(
      code: AIErrorCode,
      message: string,
      extra?: { details?: unknown; hint?: string; model?: string },
  ): AIError

  A fresh AIError for a failure this provider detects itself (no key, no model, blocked answer).

  Parameters

  • code: AIErrorCode
  • message: string
  • extra: { details?: unknown; hint?: string; model?: string } = {}

  Returns AIError

ProtectederrorContext

• errorContext(model?: string): ClassifyContext

  Parameters

  • Optionalmodel: string

  Returns ClassifyContext

Protectedfail

• fail(error: AIError, modelUsed?: string): AIResponse

  Parameters

  • error: AIError
  • OptionalmodelUsed: string

  Returns AIResponse

Protectedhttp

• http<T = any>(url: string, options?: HttpOptions): Promise<T>

  JSON request. Non-2xx throws [HttpError]; the JSON body (if any) is on .json.

  Type Parameters

  • T = any

  Parameters

  • url: string
  • options: HttpOptions = {}

  Returns Promise<T>

ProtectedhttpFull

• httpFull<T = any>(url: string, options?: HttpOptions): Promise<HttpResult<T>>

  JSON request with the reply's status and headers (request ids live there).

  Type Parameters

  • T = any

  Parameters

  • url: string
  • options: HttpOptions = {}

  Returns Promise<HttpResult<T>>

ProtectedhttpStream

• httpStream(
      url: string,
      options?: HttpOptions,
  ): Promise<AsyncIterable<Uint8Array>>

  Streaming request: the body as an async iterable of bytes, idle-guarded. Non-2xx throws [HttpError].

  Parameters

  • url: string
  • options: HttpOptions = {}

  Returns Promise<AsyncIterable<Uint8Array>>

Protectedok

• ok(data: string, extra?: OkExtra): AIResponse

  Parameters

  • data: string
  • extra: OkExtra = {}

  Returns AIResponse

ProtectedrequestOptions

• requestOptions(
      request: AIRequest,
  ): Pick<HttpOptions, "signal" | "timeout" | "idleTimeout">

  The per-request knobs (signal, timeouts) as http options.

  Parameters

  • request: AIRequest

  Returns Pick<HttpOptions, "signal" | "timeout" | "idleTimeout">

ProtectedsetDiscovered

• setDiscovered(ids: string[]): string[]

  Records what discovery found, keeping any seeded models first so the caller's chosen default stays the default.

  Parameters

  • ids: string[]

  Returns string[]

ProtectedtoError

• toError(error: unknown, model?: string): AIError

  Any thrown value → AIError carrying this provider's classification.

  Parameters

  • error: unknown
  • Optionalmodel: string

  Returns AIError