Error handling

ReyGridError
├── ReyGridApiError            # any 4xx / 5xx
│   ├── ReyGridAuthError       # 401
│   ├── ReyGridValidationError # 400
│   ├── ReyGridNotFoundError   # 404
│   ├── ReyGridConflictError   # 409
│   ├── ReyGridPermissionError # 403 (plan limit, model not on plan, restricted key)
│   └── ReyGridRateLimitError  # 429 (rate limited, key quota used up)
├── ReyGridNetworkError        # timeout, DNS, connection refused
└── ReyGridStreamError         # malformed SSE frame

from reygrid import (
    ReyGridApiError,
    ReyGridAuthError,
    ReyGridNetworkError,
    ReyGridNotFoundError,
)

try:
    client.list_messages("{AgentId}", "user-42")
except ReyGridAuthError:
    print("Bad API key")
except ReyGridNotFoundError:
    print("No such conversation")
except ReyGridNetworkError as e:
    print(f"Network problem: {e}")
except ReyGridApiError as e:
    print(f"API {e.status_code}: {e.code} — {e}")

from reygrid import ReyGridApiError, ReyGridPermissionError

try:
    client.add_text_source("{AgentId}", "Refunds", "…")
except ReyGridPermissionError as e:
    if e.code == "PLAN_LIMIT_REACHED":
        print("Upgrade to add more knowledge")
except ReyGridApiError as e:
    if e.code == "INVALID_BODY":
        print((e.details or {}).get("list"))  # validation errors per field
    else:
        print(e.status_code, e.code, e)