Roadmap
Where the SDK stands
@circle-rd/auth-ai is published to npm (latest: 0.1.x). The public API is not stable: while the major version is 0, a breaking change bumps the minor version. The surface that exists today is described in the Reference: the OIDC relying party, the backend-for-frontend handlers, the Fastify adapter, the browser client with React and Vue bindings, Bearer verification, back-channel logout, the wallet and gateway clients, and the machine API for billing and consumption.
Available elsewhere
The Python SDK (auth-ai on PyPI) reproduces the same behaviours for Python backends: error codes, refresh serialisation, callback failure policy, logout token validation. It has its own documentation and repository.
Planned
| Item | Why |
|---|---|
Migration of gine | Move the gine application onto the SDK, as a real-world check of the API before it stabilises. |
| More adapters | Thin adapters on top of the Web-standard handlers, as needs appear. Today only Fastify has one; the other frameworks guide shows the bridge to write for the rest, and there is no Next.js adapter yet. |
Not planned here
The SDK has no debit API, by design: the LiteLLM gateway debits the wallet after each call. See Credit wallet and LiteLLM gateway.
To suggest or discuss a feature, open an issue on GitHub.