airefinery-sdk 1.17.1 release

🚀 Announcement: AI Refinery SDK v1.17.1 Released ⚡️

We are pleased to announce the availability of AI Refinery SDK v1.17.1. This release focuses on improving type-safety, error transparency, and authentication flexibility.

🛠 Improvements & Fixes

• Typed DistillerClient Responses
  • All public methods of DistillerClient now return fully typed objects for improved IDE auto-completion, static analysis (e.g., mypy), and overall developer experience.

• Enhanced Error Handling & Propagation
  • Server-side errors are now surfaced through a clearer exception hierarchy.

• air.auth.TokenProvider (OAuth 2.0 / OIDC Support)
  OAuth users can now authenticate with an access-token flow in addition to a static API key.

  from air.auth import TokenProvider
  from air import AsyncAIRefinery
  
  # Keycloak token-endpoint pattern:
  #   https://<kc-host>/realms/<realm>/protocol/openid-connect/token
  keycloak_token_url = (
      "https://keycloak.example.com/realms/my-realm/protocol/openid-connect/token"
  )
  
  token_provider = TokenProvider(
      url=keycloak_token_url,
      client_id="my-client",
      client_secret="s3cr3t",
      extra_fields={"audience": "my-api"},  # optional; adapt to your IdP
  )
  
  client = AsyncAIRefinery(api_key=token_provider)
  
  # ─────────────────────────────────────────────────────────────
  # Existing AI Refinery API-key authentication remains fully supported:
  # client = AsyncAIRefinery(api_key="your_static_api_key")

✅ Compatibility

• This is a non-breaking upgrade from version 1.16.0.
• SDK versions ≤ 1.15.1 can still connect to the current Distiller API server without modification.
• Applications that have not yet migrated to API-Key–only or TokenProvider authentication must do so before upgrading. Refer to the Quickstart guide for details:
  https://sdk.airefinery.accenture.com/setup/quickstart/

Thank you for your continued feedback and support.