Errors and retries

SpineError
├── SpineConnectionError       # network / transport failures
├── SpineTimeoutError          # HTTP timeout or polling timeout
└── SpineAPIError              # 4xx / 5xx HTTP responses
    ├── AuthenticationError    # 401
    ├── BadRequestError        # 400
    ├── NotFoundError          # 404
    ├── RateLimitError         # 429 (after retry budget exhausted)
    └── ServerError            # 5xx (after retry budget exhausted)

from spine import SpineClient, BadRequestError

try:
    with SpineClient() as client:
        client.runs.create(prompt="x", template="bogus")
except BadRequestError as exc:
    print(exc.status_code)      # 400
    print(exc.error_message)    # "Invalid template: bogus. Valid templates: ..."
    print(exc.request_id)       # value of X-Request-ID header
    print(exc.response_body)    # parsed JSON body

from spine import SpineClient, RetryPolicy

client = SpineClient(
    retry_policy=RetryPolicy(
        max_retries=5,      # default: 3
        base_delay=1.0,     # default: 0.5
        max_delay=60.0,     # default: 30.0
        jitter=0.2,         # ±20% jitter, default: 0.1
    ),
)

import httpx
from spine import SpineClient

client = SpineClient(timeout=httpx.Timeout(120.0, connect=5.0))

result = handle.wait(timeout=1800)   # 30 minutes