Module: ActiveAgent::Providers::Errors

Defined in:

lib/active_agent/providers/errors.rb

Overview

Typed provider failures, normalized across vendor SDKs.

Every vendor raises its own exception classes for the same underlying conditions (rate limits, context overflows, content filters, outages), which makes retry/backoff/fallback policy impossible to express portably. The taxonomy classifies vendor errors into a small set of framework types — the original exception is preserved as #cause, so nothing is lost.

Examples:

Portable retry policy

rescue_from ActiveAgent::Providers::Errors::RateLimited do |error|
  retry_job wait: 30.seconds
end

Fallback on outage

rescue_from ActiveAgent::Providers::Errors::ServiceUnavailable do |error|
  FallbackAgent.with(params).ask.generate_later
end

Defined Under Namespace

Modules: Taxonomy Classes: AuthenticationFailed, ContentFiltered, ContextLengthExceeded, InvalidRequest, ProviderError, RateLimited, ServiceUnavailable