This release is a pre-release and may not be stable for production use.
Swarmauri Token Composite
Algorithm-routing token service delegating to child providers based on JWT headers, claims, or algorithms.
Features
- Compose multiple asynchronous
ITokenServiceimplementations behind a singleCompositeTokenServicefacade. - Dispatch mint requests by explicit service hints (
headers["svc"]), token type headers (headers["typ"]), confirmation claims (claims["cnf"]), or requested algorithms. - Detect verification routes from SSH certificate prefixes, JWT-style tokens (including DPoP and mTLS-bound variants), or fall back through each service until one succeeds.
- Merge child capability metadata and JWKS responses, de-duplicating keys by
kidso downstream clients can rely on a single aggregated feed.
Installation
Install the package with your preferred Python packaging tool:
pip install swarmauri_tokens_composite
poetry add swarmauri_tokens_composite
If you use uv, install it (skip the first line if uv is already available) and then add the package:
curl -LsSf https://astral.sh/uv/install.sh | sh
uv pip install swarmauri_tokens_composite
Usage
CompositeTokenService accepts a list of services implementing ITokenService. It inspects headers, claims, and requested algorithms to choose the most appropriate delegate for mint, verify, and jwks calls. The child services remain responsible for the actual cryptographic work, while the composite aggregates their capabilities and keys.
# README Example: CompositeTokenService basic routing
import asyncio
from typing import Any, Dict, Iterable
from swarmauri_tokens_composite import CompositeTokenService
class MemoryTokenService:
"""In-memory stand-in for an async ITokenService implementation."""
def __init__(self, type_name: str, formats: Iterable[str], algs: Iterable[str]):
self.type = type_name
self._formats = tuple(formats)
self._algs = tuple(algs)
def supports(self) -> Dict[str, Iterable[str]]:
return {"formats": self._formats, "algs": self._algs}
async def mint(
self, claims: Dict[str, Any], *, alg: str, headers=None, **_: Any
) -> str:
return f"{self.type}:{alg}:{claims['sub']}"
async def verify(self, token: str, **kwargs) -> Dict[str, Any]:
svc, alg, sub = token.split(":", 2)
if svc != self.type:
raise ValueError("routed to wrong service")
return {"sub": sub, "alg": alg, "service": svc}
async def jwks(self) -> Dict[str, Any]:
return {"keys": [{"kid": f"{self.type}-kid"}]}
def build_composite() -> CompositeTokenService:
jwt_service = MemoryTokenService("JWTTokenService", ["JWT"], ["HS256"])
ssh_service = MemoryTokenService("SshCertTokenService", ["SSH-CERT"], ["ssh-ed25519"])
return CompositeTokenService([jwt_service, ssh_service])
def describe_example(result: Dict[str, Any]) -> None:
print("JWT token:", result["jwt_token"])
print("SSH token:", result["ssh_token"])
print("JWT service handled mint/verify:", result["jwt_claims"]["service"])
print("SSH service handled mint/verify:", result["ssh_claims"]["service"])
print("JWKS keys:", {entry["kid"] for entry in result["jwks"]["keys"]})
async def main() -> Dict[str, Any]:
composite = build_composite()
jwt_token = await composite.mint({"sub": "alice"}, alg="HS256")
ssh_token = await composite.mint({"sub": "bob"}, alg="ssh-ed25519")
jwt_claims = await composite.verify(jwt_token)
ssh_claims = await composite.verify(ssh_token)
jwks = await composite.jwks()
return {
"jwt_token": jwt_token,
"ssh_token": ssh_token,
"jwt_claims": jwt_claims,
"ssh_claims": ssh_claims,
"jwks": jwks,
}
example_result = asyncio.run(main())
describe_example(example_result)
The example above shows how the composite selects different child services by algorithm while producing a merged JWKS response. In production you would supply concrete implementations that speak to HSMs, remote signing services, or other secure key stores.
Entry point
The provider is registered under the swarmauri.tokens entry-point as CompositeTokenService.
Want to help?
If you want to contribute to swarmauri-sdk, read up on our guidelines for contributing that will help you get started.
Metadata
Release files for swarmauri_tokens_composite 0.11.0.dev1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| swarmauri_tokens_composite-0.11.0.dev1.tar.gz | 10.3 kB | Without provenance | Details for swarmauri_tokens_composite-0.11.0.dev1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| swarmauri_tokens_composite-0.11.0.dev1-py3-none-any.whl | Python 3 | none | any | Details for swarmauri_tokens_composite-0.11.0.dev1-py3-none-any.whl |
Total release size: 21.6 kB
Release files / swarmauri_tokens_composite-0.11.0.dev1.tar.gz
| Download URL | swarmauri_tokens_composite-0.11.0.dev1.tar.gz |
|---|---|
| Size | 10.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b9dc5bc3ef1d81f5bce519396ea4a55157b29e751c5ad4329f5b4c365d271723
|
|
BLAKE2b-256 checksum How to use checksums |
6d201ed88c055660f6b081dcc1c0a23bd527b41b86473735a32276eceeb427e6
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / swarmauri_tokens_composite-0.11.0.dev1-py3-none-any.whl
| Download URL | swarmauri_tokens_composite-0.11.0.dev1-py3-none-any.whl |
|---|---|
| Size | 11.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
22a81450020530a4ccfbcd2316dfe2d7aecf10af481e2ab58f2504c9e394a689
|
|
BLAKE2b-256 checksum How to use checksums |
ed028f208d609413d151fecc88f9e67f66d41587c90c847c7c66985753496660
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Security for swarmauri_tokens_composite 0.11.0.dev1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.