Errors

{
  "status": "error",
  "message": "Ese chat ya tiene un turno de la API en curso.",
  "message_code": "api_v1_chat_busy",
  "data": { "message_id": 90212 },
  "meta": { "request_id": "9f1c0a3e-7b2d-4f18-9a55-2c6e0d1b4a77" }
}

{
  "status": "error",
  "message": "No se pudo confirmar si la acción se aplicó. Consultá el estado del turno antes de reintentar.",
  "message_code": "api_v1_action_result_unknown",
  "data": [],
  "meta": {
    "request_id": "9f1c0a3e-7b2d-4f18-9a55-2c6e0d1b4a77",
    "error_details": {
      "schema_version": 1,
      "service": "core_ai",
      "service_code": "NC-SVC-01",
      "dependency": "core_control",
      "operation": "chat.action.resolve",
      "upstream_code": null,
      "failure_kind": "read_timeout",
      "operation_outcome": "unknown",
      "retryable": false,
      "retry_action": "check_status",
      "request_id": "9f1c0a3e-7b2d-4f18-9a55-2c6e0d1b4a77"
    }
  }
}

{
  "error": "invalid_scope",
  "error_description": "La credencial no tiene esos permisos: rules:write"
}

import random
import time

RETRYABLE = {429, 500, 502, 503, 504}


def with_retries(call, attempts: int = 4):
    """Reintenta con backoff exponencial y jitter.

    Solo los status de `RETRYABLE`: un 4xx de contrato no mejora por insistir.
    """
    for attempt in range(attempts):
        response = call()
        if response.status_code not in RETRYABLE or attempt == attempts - 1:
            return response

        retry_after = response.headers.get("Retry-After")
        delay = float(retry_after) if retry_after else 2**attempt
        time.sleep(delay + random.uniform(0, 0.5))

    return response