CIRCLE
Project

Roadmap

What is planned for CIRCLE auth-ai after the first release. Planned items are intentions, not commitments.

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

Everything in this section is planned and not implemented. The only features documented elsewhere in this site are those present in the source.
ItemWhy
Migration of gineMove the gine application onto the SDK, as a real-world check of the API before it stabilises.
More adaptersThin 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.

Copyright © 2026