Module user_facing_error_codes 

Constants

BLOCKED_BY_HOOK

A user_prompt_submit hook rejected the inbound user message.

BUDGET_EXHAUSTED

BUDGET_PAUSED

DEPENDENCY_UNAVAILABLE

INVALID_TOOL_SCHEMA

MAX_ITERATIONS

MODEL_UNAVAILABLE

PROCESSING_ERROR

PROVIDER_MISCONFIGURED

PROVIDER_QUOTA_EXHAUSTED

Provider account is out of credits/quota (billing). Distinct from provider_misconfigured (bad/missing API key) so operators can tell “top up the account” apart from “fix the key”.

PROVIDER_RATE_LIMITED

PROVIDER_UNAVAILABLE

PROVIDER_USAGE_LIMIT_REACHED

Subscription/plan usage limit was reached (e.g. ChatGPT/Codex usage_limit_reached). Distinct from provider_rate_limited (a short transient throttle) because the reset is far in the future (hours) and carries a concrete resets_at timestamp, and distinct from provider_quota_exhausted (billing/credits) because it recovers on its own at the reset time without operator action.

REQUEST_TOO_LARGE

SOFT_LIMIT_REACHED