cascadeflowError
├── BudgetExceededError
├── ConfigError
├── ProviderError
├── ModelError
├── RateLimitError
├── QualityThresholdError
├── RoutingError
├── ValidationError
└── ToolExecutionError

from cascadeflow.exceptions import (
    cascadeflowError,
    BudgetExceededError,
    ProviderError,
)

try:
    result = await agent.run("Complex query")
except BudgetExceededError as e:
    print(f"Budget exceeded: {e}")
    # Handle gracefully — return cached response, notify user, etc.
except ProviderError as e:
    print(f"Provider error: {e}")
    # Retry with different provider or model
except cascadeflowError as e:
    print(f"cascadeflow error: {e}")