diff --git a/src/components/CopyAiPrompt.astro b/src/components/CopyAiPrompt.astro index 67d8720..ac08652 100644 --- a/src/components/CopyAiPrompt.astro +++ b/src/components/CopyAiPrompt.astro @@ -21,7 +21,7 @@ const prompt = getAiPrompt(rawSlug); AI Coding Prompt Claude & Cursor - authkestra = "0.13" + authkestra = "0.15"
"}`) with `WWW-Authenticate: DeviceSignature error=""`.
+
:::caution
-`allowed_algs` is asymmetric-only. `VerifierConfig::new` silently drops any HMAC algorithm you
+`allowed_algs` and `device_algs` are asymmetric-only. `VerifierConfig` silently drops any HMAC algorithm you
pass, and `verify()` rejects the whole HMAC family regardless — the device's private key never
leaves the device, so there is no symmetric secret a verifier could legitimately share.
:::
diff --git a/src/content/docs/providers/magic-link.md b/src/content/docs/providers/magic-link.md
index 9ca12b4..2e1cd77 100644
--- a/src/content/docs/providers/magic-link.md
+++ b/src/content/docs/providers/magic-link.md
@@ -11,7 +11,7 @@ To use magic links, enable the `magic-link` feature in your `Cargo.toml`:
```toml
[dependencies]
-authkestra-engine = { version = "0.13", features = ["magic-link"] }
+authkestra-engine = { version = "0.15", features = ["magic-link"] }
```
## Configuration
diff --git a/src/content/docs/providers/oauth2.mdx b/src/content/docs/providers/oauth2.mdx
index 19ab08d..7af25d8 100644
--- a/src/content/docs/providers/oauth2.mdx
+++ b/src/content/docs/providers/oauth2.mdx
@@ -18,7 +18,7 @@ If you are using multiple OAuth providers (e.g., GitHub and Google), enable thei
```toml
[dependencies]
-authkestra = { version = "0.13", features = ["axum", "github", "google"] }
+authkestra = { version = "0.15", features = ["axum", "github", "google"] }
```
## Stateless Engine Configuration
diff --git a/src/content/docs/providers/oidc.md b/src/content/docs/providers/oidc.md
index e081783..779b3e0 100644
--- a/src/content/docs/providers/oidc.md
+++ b/src/content/docs/providers/oidc.md
@@ -11,7 +11,7 @@ To use the OIDC client, enable the `oidc` feature on the `authkestra` crate.
```toml
[dependencies]
-authkestra = { version = "0.13", features = ["oidc", "memory"] }
+authkestra = { version = "0.15", features = ["oidc", "memory"] }
```
## Configuring the OIDC Provider
diff --git a/src/content/docs/providers/otp.md b/src/content/docs/providers/otp.md
index df3692d..1acd73d 100644
--- a/src/content/docs/providers/otp.md
+++ b/src/content/docs/providers/otp.md
@@ -11,7 +11,7 @@ To use OTP, enable the `otp` feature in your `Cargo.toml`. The example below als
```toml
[dependencies]
-authkestra-engine = { version = "0.13", features = ["otp", "memory"] }
+authkestra-engine = { version = "0.15", features = ["otp", "memory"] }
```
## Registering the Method
diff --git a/src/content/docs/providers/passkeys.md b/src/content/docs/providers/passkeys.md
index c6b23d5..f3ac9cb 100644
--- a/src/content/docs/providers/passkeys.md
+++ b/src/content/docs/providers/passkeys.md
@@ -11,7 +11,7 @@ To use Passkeys, enable the `webauthn` feature in your `Cargo.toml` (either on t
```toml
[dependencies]
-authkestra = { version = "0.13", features = ["webauthn"] }
+authkestra = { version = "0.15", features = ["webauthn"] }
```
## Configuration
diff --git a/src/content/docs/providers/recovery-codes.md b/src/content/docs/providers/recovery-codes.md
index 57db0f4..149b995 100644
--- a/src/content/docs/providers/recovery-codes.md
+++ b/src/content/docs/providers/recovery-codes.md
@@ -11,7 +11,7 @@ To use recovery codes, enable the `recovery-codes` feature in your `Cargo.toml`:
```toml
[dependencies]
-authkestra-engine = { version = "0.13", features = ["recovery-codes"] }
+authkestra-engine = { version = "0.15", features = ["recovery-codes"] }
```
## Configuration
diff --git a/src/content/docs/providers/totp.md b/src/content/docs/providers/totp.md
index b0c993c..b367d4f 100644
--- a/src/content/docs/providers/totp.md
+++ b/src/content/docs/providers/totp.md
@@ -11,7 +11,7 @@ To use TOTP, enable the `totp` feature in your `Cargo.toml`:
```toml
[dependencies]
-authkestra = { version = "0.13", features = ["totp"] }
+authkestra = { version = "0.15", features = ["totp"] }
```
## Configuration
@@ -79,4 +79,8 @@ let result = engine.authenticate(AuthInput::MfaChallenge {
### Built-in Replay Protection
-Authkestra strictly adheres to [RFC 6238](https://datatracker.ietf.org/doc/html/rfc6238). It automatically tracks the highest `last_used_step` in the credential store, preventing the exact same code from being submitted more than once within the validity window. This completely mitigates replay attacks!
+Authkestra strictly adheres to [RFC 6238](https://datatracker.ietf.org/doc/html/rfc6238). It atomically claims the active time step via `CredentialStore::claim_totp_step`, ensuring the exact same code cannot be accepted twice under concurrent requests or anywhere within the drift window.
+
+:::note[Custom `CredentialStore` migration (`v0.15+`)]
+Custom `CredentialStore` implementations must override `claim_totp_step` with atomic compare-and-advance semantics (`matched_step > last_used_step`). The trait's default implementation returns `AuthError::Unsupported`, causing matching TOTP logins to fail until updated.
+:::
diff --git a/src/content/docs/storage/kv-store.md b/src/content/docs/storage/kv-store.md
index 0282888..0aef054 100644
--- a/src/content/docs/storage/kv-store.md
+++ b/src/content/docs/storage/kv-store.md
@@ -11,7 +11,7 @@ Authkestra includes built-in generic KV stores (`memory` and `redis`), forwarded
```toml
[dependencies]
-authkestra = { version = "0.13", features = ["axum", "redis"] }
+authkestra = { version = "0.15", features = ["axum", "redis"] }
```
### 1. Memory Store (`memory`)
diff --git a/src/content/docs/storage/sql-store.md b/src/content/docs/storage/sql-store.md
index ad570c7..2a9e6ec 100644
--- a/src/content/docs/storage/sql-store.md
+++ b/src/content/docs/storage/sql-store.md
@@ -19,7 +19,7 @@ To use it, add the `authkestra-store-sqlx` crate and enable the feature for the
```toml
[dependencies]
-authkestra-store-sqlx = { version = "0.13", features = ["postgres"] }
+authkestra-store-sqlx = { version = "0.15", features = ["postgres"] }
# or mysql, sqlite
```
diff --git a/src/lib/ai-prompts.ts b/src/lib/ai-prompts.ts
index 1260a2e..c06ea2c 100644
--- a/src/lib/ai-prompts.ts
+++ b/src/lib/ai-prompts.ts
@@ -4,104 +4,104 @@
* Maps every documentation slug (across concepts/, guides/, providers/, advanced/, storage/, and root index)
* to a tailored, context-specific prompt for AI coding assistants (Claude, Cursor, etc.).
*
- * Target: authkestra = "0.13"
+ * Target: authkestra = "0.15"
* Reference: https://docs.authkestra.com/llms-full.txt
*/
export const AI_PROMPTS: Record = {
// Root index / Introduction
index:
- 'Implement an authentication stack using Authkestra v0.13 (authkestra = "0.13"). Configure the typestate builder Authkestra::builder() with Axum (features = ["axum", "memory", "github"]). Note that session and token state start as Missing at compile time and require a concrete store (e.g. MemoryStore or RedisStore) plus a cookie encryption key before calling .build(). Use AkWebAppEngine in your Axum router state and inject AuthSession into protected handlers. Refer to the complete documentation at https://docs.authkestra.com/llms-full.txt.',
+ 'Implement an authentication stack using Authkestra v0.15 (authkestra = "0.15"). Configure the typestate builder Authkestra::builder() with Axum (features = ["axum", "memory", "github"]). Note that session and token state start as Missing at compile time and require a concrete store (e.g. MemoryStore or RedisStore) plus a cookie encryption key (or SessionConfig::new for multi-replica keys) before calling .build(). Use AkWebAppEngine in your Axum router state and inject AuthSession into protected handlers. Refer to the complete documentation at https://docs.authkestra.com/llms-full.txt.',
// Concepts
'concepts/architecture':
- "Architect a modular identity service using Authkestra v0.13 (authkestra = \"0.13\"). Follow Authkestra's three-layer architecture: authkestra-engine (pure framework-agnostic core), extensions (authkestra-providers, authkestra-oidc, authkestra-policy, authkestra-ssf, authkestra-mcp), and adapters (authkestra-axum / authkestra-actix). Never create a UserStore trait — Authkestra has no user table; your application owns user records while Authkestra manages protocol state via KvStore, SessionStore, and OpStore. Refer to https://docs.authkestra.com/llms-full.txt.",
+ "Architect a modular identity service using Authkestra v0.15 (authkestra = \"0.15\"). Follow Authkestra's three-layer architecture: authkestra-engine (pure framework-agnostic core), extensions (authkestra-providers, authkestra-oidc, authkestra-policy, authkestra-ssf, authkestra-mcp), and adapters (authkestra-axum / authkestra-actix). Never create a UserStore trait: Authkestra has no user table; your application owns user records while Authkestra manages protocol state via KvStore, SessionStore, CredentialStore, and OpStore. Refer to https://docs.authkestra.com/llms-full.txt.",
'concepts/typestate-builder':
- 'Construct an Authkestra v0.13 (authkestra = "0.13") engine enforcing compile-time safety with the typestate builder pattern. Call Authkestra::builder() which initializes Engine. Supply a session store to transition to Engine (AkWebAppEngine), a token manager for Engine (AkApiEngine), or both for Engine (AkEngine). Calling .build() while required type parameters remain Missing is rejected by the Rust compiler. Derive AxumState or ActixState on your application router state. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Construct an Authkestra v0.15 (authkestra = "0.15") engine enforcing compile-time safety with the typestate builder pattern. Call Authkestra::builder() which initializes Engine. Supply a session store to transition to Engine (AkWebAppEngine), a token manager for Engine (AkApiEngine), or both for Engine (AkEngine). Calling .build() while required type parameters remain Missing is rejected by the Rust compiler. Derive AxumState or ActixState on your application router state. Refer to https://docs.authkestra.com/llms-full.txt.',
// Guides
'guides/quickstart':
- 'Implement an end-to-end GitHub OAuth2 login flow using Authkestra v0.13 (authkestra = "0.13", features = ["axum", "memory", "github"]). Initialize Authkestra::builder() with MemoryStore::new(), configure GitHubProvider with client credentials and scopes, set an encryption key with cookie_key(), and mount auth routes with .with_auth_routes(). Protect an Axum endpoint by extracting AuthSession and verify user authentication. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement an end-to-end GitHub OAuth2 login flow using Authkestra v0.15 (authkestra = "0.15", features = ["axum", "memory", "github"]). Initialize Authkestra::builder() with MemoryStore::new(), configure GithubProvider with client credentials, configure SessionConfig::new(key) for stable session cookies across restarts/replicas, and mount auth routes with .axum_router(). Protect an Axum endpoint by extracting AuthSession. Refer to https://docs.authkestra.com/llms-full.txt.',
'guides/framework-integration':
- 'Integrate Authkestra v0.13 (authkestra = "0.13", features = ["axum"] or ["actix"]) into a web application router. Wrap Arc in your application state using #[derive(AxumState)] or #[derive(ActixState)]. Extract AuthSession for cookie/session-based web apps or AuthToken for bearer JWT API routes. Use AxumExt / ActixExt to wire automatic /auth/login/{provider}, /auth/callback/{provider}, and /auth/logout routes with encrypted cookie state. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Integrate Authkestra v0.15 (authkestra = "0.15", features = ["axum"] or ["actix"]) into a web application router. Wrap AkWebAppEngine in your application state using #[derive(AxumState)] or #[derive(ActixState)]. Extract AuthSession for cookie/session-based web apps or AuthToken / Auth for bearer JWT API routes. Use AxumExt / ActixExt to wire automatic /auth/login/{provider}, /auth/callback/{provider}, and POST /auth/logout routes with encrypted cookie state. Refer to https://docs.authkestra.com/llms-full.txt.',
'guides/wired-endpoints':
- 'Configure and customize Authkestra v0.13 (authkestra = "0.13", features = ["axum", "memory"]) standard endpoints. Use AxumExt::with_auth_routes or manual route wiring for /auth/login/:provider, /auth/callback/:provider, and /auth/logout. Ensure CSRF protection via encrypted state cookies without database lookups. Use stateless_auth_routes() for stateless OAuth2 JWT flows. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Configure and customize Authkestra v0.15 (authkestra = "0.15", features = ["axum", "memory"]) standard endpoints. Use AxumExt::axum_router or manual route wiring for /auth/login/:provider, /auth/callback/:provider, and POST /auth/logout. Ensure CSRF protection via encrypted state cookies without database lookups. Use axum_router_stateless() for stateless OAuth2 JWT flows. Refer to https://docs.authkestra.com/llms-full.txt.',
'guides/ai-agents':
- 'Secure AI agents and Model Context Protocol (MCP) servers using Authkestra v0.13 (authkestra = "0.13", features = ["mcp", "passkeys", "axum"]). Use McpRouter to define tool endpoints across three security tiers: McpSecurityTier::Public, McpSecurityTier::Scoped, and McpSecurityTier::HumanApproved. For sensitive tools, bind parameters cryptographically using RFC 8785 JSON Canonicalization Scheme (JCS) SHA-256 digests and require a human biometric passkey step-up pulse before dispensing downstream OAuth tokens from EncryptedKvTokenVault (AES-256-GCM). Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Secure AI agents and Model Context Protocol (MCP) servers using Authkestra v0.15 (authkestra = "0.15", features = ["mcp", "webauthn", "axum"]). Use McpRouter::builder() to define tool endpoints across three security tiers: McpSecurityTier::Public, McpSecurityTier::Scoped, and McpSecurityTier::HumanApproved (with allow_unverified_identity_header(false) by default and optional with_policy_engine). For sensitive tools, bind parameters cryptographically using RFC 8785 JSON Canonicalization Scheme (JCS) SHA-256 digests and require a human biometric passkey step-up before dispensing downstream OAuth tokens from EncryptedKvTokenVault (AES-256-GCM). Refer to https://docs.authkestra.com/llms-full.txt.',
'guides/device-attestation':
- 'Implement cryptographic device attestation and key issuance using Authkestra v0.13 (authkestra = "0.13", features = ["op", "devsig", "axum"]). Configure DeviceIdentity with hardware-backed Ed25519 or ECDSA keys. Enforce per-request signatures (X-Signature and X-Attestation) with body digest hashing (bdh) against an Authkestra OpenID Provider verifying RFC 8693 token exchange. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement cryptographic device attestation and key issuance using Authkestra v0.15 (authkestra = "0.15", features = ["op", "devsig", "axum"]). Configure hardware-backed Ed25519 or ECDSA keys with authkestra-devsig profile v1 (VerifierConfig::profile_v1). Enforce per-request signatures (X-Signature and X-Attestation) with query/body digest rules (qsh/bdh) against an Authkestra OpenID Provider verifying RFC 8693 token exchange. Refer to https://docs.authkestra.com/llms-full.txt.',
// Authentication Flows / Providers
'providers/oauth2':
- 'Implement stateless OAuth2 authentication with Authkestra v0.13 (authkestra = "0.13", features = ["axum", "memory"]). Use AxumStatelessExt with encrypted cookie state and nonce validation to issue signed JWTs upon successful OAuth callback without writing session records to a database. Configure JwtStrategy for token verification. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement stateless OAuth2 authentication with Authkestra v0.15 (authkestra = "0.15", features = ["axum", "memory"]). Use AxumStatelessExt with encrypted cookie state and nonce validation to issue signed JWTs upon successful OAuth callback without writing session records to a database. Configure JwtStrategy for token verification. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/oidc':
- 'Configure an OpenID Connect (OIDC) client in Authkestra v0.13 (authkestra = "0.13", features = ["oidc", "axum", "memory"]). Use OidcProvider::discover to asynchronously fetch and background-cache provider metadata from .well-known/openid-configuration. Validate ID tokens using the provider\'s JWKS key set, enforce nonce binding, and map claims to an authenticated AuthSession. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Configure an OpenID Connect (OIDC) client in Authkestra v0.15 (authkestra = "0.15", features = ["oidc", "axum", "memory"]). Use OidcProvider::discover to asynchronously fetch and background-cache provider metadata from .well-known/openid-configuration. Validate ID tokens using the provider\'s JWKS key set, enforce nonce binding, and map claims to an authenticated AuthSession. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/client-credentials':
- 'Implement the OAuth 2.0 Client Credentials grant for machine-to-machine (M2M) communication using Authkestra v0.13 (authkestra = "0.13", features = ["engine", "axum"]). Support both client_secret_post/basic and asymmetric private_key_jwt (RFC 7523) client assertion authentication. Validate scopes and issue scoped AuthToken access tokens without human session overhead. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement the OAuth 2.0 Client Credentials grant for machine-to-machine (M2M) communication using Authkestra v0.15 (authkestra = "0.15", features = ["engine", "axum"]). Support both client_secret_post/basic and asymmetric private_key_jwt (RFC 7523) client assertion authentication. Validate scopes and issue scoped AuthToken access tokens without human session overhead. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/device-flow':
- 'Implement the RFC 8628 OAuth 2.0 Device Authorization Grant for headless CLIs and input-constrained devices using Authkestra v0.13 (authkestra = "0.13", features = ["op", "axum", "memory"]). Issue user_code and device_code with verification_uri, handle client polling with slow_down / authorization_pending status codes, and issue tokens once approved in a browser session. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement the RFC 8628 OAuth 2.0 Device Authorization Grant for headless CLIs and input-constrained devices using Authkestra v0.15 (authkestra = "0.15", features = ["op", "axum", "memory"]). Issue user_code and device_code with verification_uri, handle client polling with slow_down / authorization_pending status codes, and issue tokens once approved in a browser session. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/passkeys':
- 'Implement FIDO2 / WebAuthn passkey authentication using Authkestra v0.13 (authkestra = "0.13", features = ["webauthn", "axum", "memory"]). Use WebAuthnAuthMethod with CredentialStore. In v0.13, enforce re-proof gated enrolment: start_register requires (&Identity, &ReproofRequirement) to prevent confused-deputy attacks. Generate stable UUIDv5 user handles to prevent PII leakage to authenticators and validate origin and RP ID. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement FIDO2 / WebAuthn passkey authentication using Authkestra v0.15 (authkestra = "0.15", features = ["webauthn", "axum", "memory"]). Use WebAuthnAuthMethod with CredentialStore and enforce re-proof gated enrolment: start_register requires (&Identity, &ReproofRequirement) to prevent confused-deputy attacks. Generate stable UUIDv5 user handles to prevent PII leakage to authenticators and validate origin and RP ID. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/totp':
- 'Implement Time-based One-Time Password (TOTP, RFC 6238) MFA in Authkestra v0.13 (authkestra = "0.13", features = ["totp", "axum", "memory"]). In v0.13, register_totp requires (&Identity, &ReproofRequirement) to ensure the user re-authenticates before enrolling an authenticator app. Validate 6-digit codes with replay attack prevention and configurable drift windows. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement Time-based One-Time Password (TOTP, RFC 6238) MFA in Authkestra v0.15 (authkestra = "0.15", features = ["totp", "axum", "memory"]). register_totp requires (&Identity, &ReproofRequirement) to ensure the user re-authenticates before enrolling an authenticator app. Validate 6-digit codes with atomic replay protection via CredentialStore::claim_totp_step and configurable drift windows. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/magic-link':
- 'Implement passwordless email magic link authentication using Authkestra v0.13 (authkestra = "0.13", features = ["engine", "memory", "axum"]). Use MagicLinkAuthMethod backed by a store implementing AtomicConsume to ensure single-use consumption and eliminate TOCTOU race conditions when links are scanned by email security filters. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement passwordless email magic link authentication using Authkestra v0.15 (authkestra = "0.15", features = ["magic-link", "memory", "axum"]). Use MagicLinkAuthMethod backed by a store implementing AtomicConsume to ensure single-use consumption and eliminate TOCTOU race conditions when links are scanned by email security filters. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/otp':
- 'Implement email or SMS one-time passcode (OTP) authentication in Authkestra v0.13 (authkestra = "0.13", features = ["engine", "memory", "axum"]). Use OtpAuthMethod backed by a KvStore implementing AtomicDecrement to enforce strict per-challenge attempt limits, fail closed on exhaustion, and enforce short expiration TTLs. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement email or SMS one-time passcode (OTP) authentication in Authkestra v0.15 (authkestra = "0.15", features = ["otp", "memory", "axum"]). Use OtpAuthMethod backed by a KvStore implementing AtomicDecrement to enforce strict per-challenge attempt limits, fail closed on exhaustion, and enforce short expiration TTLs. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/recovery-codes':
- 'Implement backup recovery code authentication in Authkestra v0.13 (authkestra = "0.13", features = ["engine", "memory", "axum"]). Use RecoveryCodeAuthMethod with Argon2id cryptographic hashing. In v0.13, generating recovery codes requires (&Identity, &ReproofRequirement). Consuming a recovery code requires AtomicConsume to guarantee single-use invalidation. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement backup recovery code authentication in Authkestra v0.15 (authkestra = "0.15", features = ["recovery-codes", "memory", "axum"]). Use RecoveryCodeAuthMethod with Argon2id cryptographic hashing. Generating recovery codes requires (&Identity, &ReproofRequirement), and consuming a code requires AtomicConsume to guarantee single-use invalidation. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/bot-protection':
- 'Integrate CAPTCHA and bot protection into authentication flows using Authkestra v0.13 (authkestra = "0.13", features = ["engine", "axum"]). Use TurnstileVerifier or HCaptchaVerifier to validate client challenge tokens fail-closed before processing credential submission or triggering expensive password hashing. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Integrate CAPTCHA and bot protection into authentication flows using Authkestra v0.15 (authkestra = "0.15", features = ["engine", "captcha", "axum"]). Use TurnstileVerifier or HCaptchaVerifier to validate client challenge tokens fail-closed before processing credential submission or triggering expensive password hashing. Refer to https://docs.authkestra.com/llms-full.txt.',
'providers/device-signatures':
- 'Implement cryptographic request signing using Authkestra v0.13 (authkestra = "0.13", features = ["devsig", "axum"]). Enforce proof-of-possession on HTTP requests via X-Signature and X-Attestation headers. Use SignedRequest to verify Ed25519/ECDSA signatures over method, path, timestamp, and body digest hash (bdh) to protect APIs against MITM and replay attacks. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement cryptographic request signing using Authkestra v0.15 (authkestra = "0.15", features = ["devsig", "axum"]). Enforce device-signature profile v1 proof-of-possession via X-Signature and X-Attestation headers with VerifierConfig::profile_v1, optional separate device_algs, KeyRole (Ambient / UserPresent), qsh/bdh binding, and JSON {"error":""} refusals. Refer to https://docs.authkestra.com/llms-full.txt.',
// Building Servers & Advanced
'advanced/resource-server':
- 'Build a secure OAuth 2.0 Resource Server using Authkestra v0.13 (authkestra = "0.13", features = ["resource", "axum"]). Use Guard with JwtStrategy to validate Bearer tokens across multiple issuer JWKS endpoints. Enforce sender-constrained tokens via DPoP (RFC 9449) and mTLS (RFC 8705). Integrate with CedarPolicyEngine for fine-grained attribute-based access control. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Build a secure OAuth 2.0 Resource Server using Authkestra v0.15 (authkestra = "0.15", features = ["resource", "axum"]). Use Guard with JwtStrategy to validate Bearer tokens across multiple issuer JWKS endpoints (including nbf and strict issuer checks). Enforce sender-constrained tokens via DPoP (RFC 9449, with DpopNonces) and mTLS (RFC 8705), RFC 9470 StepUpRequirement challenges, and CedarPolicyEngine ABAC. Refer to https://docs.authkestra.com/llms-full.txt.',
'advanced/op-server':
- "Deploy a full OpenID Connect Provider (OP) using Authkestra v0.13 (authkestra = \"0.13\", features = [\"op\", \"sql-postgres\", \"axum\"]). Configure OpConfig and SqlxOpStore to serve discovery metadata at .well-known/openid-configuration, authorization endpoint, token endpoint with RFC 8693 Token Exchange, and RFC 8628 Device Authorization Grant. Refer to https://docs.authkestra.com/llms-full.txt.",
+ "Deploy a full OpenID Connect Provider (OP) using Authkestra v0.15 (authkestra = \"0.15\", features = [\"op\", \"sql-postgres\", \"axum\"]). Configure OpConfig, ClientRegistration (with allowed_audiences), and SqlxOpStore or CompositeOpStore (with DpopNonces) to serve discovery metadata at .well-known/openid-configuration, authorization endpoint, token endpoint with RFC 8693 Token Exchange, and RFC 8628 Device Authorization Grant. Refer to https://docs.authkestra.com/llms-full.txt.",
'advanced/policy-engine':
- 'Implement declarative Attribute-Based Access Control (ABAC) using AWS Cedar with Authkestra v0.13 (authkestra = "0.13", features = ["policy", "axum"]). Use CedarPolicyEngine (authkestra_policy::PolicyEngine) with AuthorizationRequest and a custom ResourceLoader (e.g. MemoryResourceLoader or DB loader). Note that the engine performs no direct I/O and fails closed with PolicyError::UnreliableDecision if an erroring forbid policy is skipped. Wire into Axum/Actix guards and MCP tool execution. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement declarative Attribute-Based Access Control (ABAC) using AWS Cedar with Authkestra v0.15 (authkestra = "0.15", features = ["policy", "axum"]). Use CedarPolicyEngine (authkestra_policy::PolicyEngine) and PolicyGuard (User::"{provider}:{external_id}" principals with percent-encoded : and %) with AuthorizationRequest and a ResourceLoader. Note that the engine performs no direct I/O and fails closed with PolicyError::UnreliableDecision if an erroring forbid policy is skipped. Refer to https://docs.authkestra.com/llms-full.txt.',
'advanced/continuous-access-evaluation':
- 'Implement OpenID Shared Signals Framework (SSF) and Continuous Access Evaluation Profile (CAEP) push event receiver in Authkestra v0.13 (authkestra = "0.13", features = ["ssf", "axum", "memory"]). Wire PushReceiver to handle POST /.well-known/ssf/events and POST /ssf/events. Configure SetVerifier with RFC 8417 Security Event Token validation and attach SessionRevocationHandler to automatically revoke matching sessions in SessionStore upon receiving SessionRevoked or CredentialChange events. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement OpenID Shared Signals Framework (SSF) and Continuous Access Evaluation Profile (CAEP) push event receiver in Authkestra v0.15 (authkestra = "0.15", features = ["ssf", "axum", "memory"]). Wire PushReceiver with ssf_axum_router / ssf_actix_scope to handle POST /.well-known/ssf/events and POST /ssf/events. Configure SetVerifier with RFC 8417 Security Event Token validation and attach SessionRevocationHandler (optionally with SessionSubjectResolver) to revoke sessions upon SessionRevoked or CredentialChange events. Refer to https://docs.authkestra.com/llms-full.txt.',
'advanced/instrumentation':
- 'Configure production observability for Authkestra v0.13 (authkestra = "0.13", features = ["engine", "axum"]). Leverage built-in tracing spans and events emitted across authentication ceremonies, OAuth handshakes, and Cedar policy evaluation. Ensure span attributes never leak PII or plaintext credentials while logging decision reasons and policy IDs. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Configure production observability for Authkestra v0.15 (authkestra = "0.15", features = ["engine", "axum"]). Leverage built-in tracing spans and events emitted across authentication ceremonies, OAuth handshakes, and Cedar policy evaluation. Ensure span attributes never leak PII or plaintext credentials while logging decision reasons and policy IDs. Refer to https://docs.authkestra.com/llms-full.txt.',
// Storage
'storage/overview':
- 'Design storage backends for Authkestra v0.13 (authkestra = "0.13", features = ["memory", "redis", "sql-postgres"]). Implement database-agnostic traits: SessionStore for user sessions, KvStore for short-lived protocol state (PKCE, magic links, OTP), CredentialStore for WebAuthn/TOTP secrets, and OpStore for OpenID Provider entities. Authkestra has no user table trait; your application schema owns user records outright. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Design storage backends for Authkestra v0.15 (authkestra = "0.15", features = ["memory", "redis", "sql-postgres"]). Implement database-agnostic traits: SessionStore for user sessions, KvStore for short-lived protocol state (PKCE, magic links, OTP), CredentialStore (including claim_totp_step) for WebAuthn/TOTP secrets, and OpStore for OpenID Provider entities. Authkestra has no user table trait; your application schema owns user records outright. Refer to https://docs.authkestra.com/llms-full.txt.',
'storage/kv-store':
- 'Configure key-value storage in Authkestra v0.13 (authkestra = "0.13", features = ["memory"] or ["redis"]). Use MemoryStore for development and testing, or RedisStore for production distributed caching. Store ephemeral OAuth state, magic link tokens, and rate-limiting counters with strict TTL expiration and atomic operations. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Configure key-value storage in Authkestra v0.15 (authkestra = "0.15", features = ["memory"] or ["redis"]). Use MemoryStore for development and testing, or RedisStore for production distributed caching. Store ephemeral OAuth state, magic link tokens, and rate-limiting counters with strict TTL expiration and atomic operations. Refer to https://docs.authkestra.com/llms-full.txt.',
'storage/sql-store':
- "Implement relational database storage for Authkestra v0.13's OpenID Provider (authkestra = \"0.13\", features = [\"op\", \"sql-postgres\"] or [\"sql-mysql\"] / [\"sql-sqlite\"]). Use SqlxOpStore to persist OAuth2 clients, authorization codes, refresh tokens, and consent grants with connection pooling and transactional integrity. Refer to https://docs.authkestra.com/llms-full.txt.",
+ "Implement relational database storage for Authkestra v0.15's OpenID Provider (authkestra = \"0.15\", features = [\"op\", \"sql-postgres\"] or [\"sql-mysql\"] / [\"sql-sqlite\"]). Use SqlxOpStore to persist OAuth2 clients, authorization codes, refresh tokens, and consent grants with connection pooling and transactional integrity. Refer to https://docs.authkestra.com/llms-full.txt.",
'storage/implementing-stores':
- 'Implement custom storage traits for Authkestra v0.13 (authkestra = "0.13", features = ["engine"]). Implement KvStore, AtomicConsume (for single-use tokens like magic links and recovery codes), and AtomicDecrement (for OTP attempt throttling) without TOCTOU race conditions. Implement SessionStore for session persistence. Ensure all storage errors are cleanly mapped to StoreError. Refer to https://docs.authkestra.com/llms-full.txt.',
+ 'Implement custom storage traits for Authkestra v0.15 (authkestra = "0.15", features = ["engine"]). Implement KvStore, AtomicConsume (for single-use tokens like magic links and recovery codes), AtomicDecrement (for OTP attempt throttling), CredentialStore::claim_totp_step, and SessionStore without TOCTOU race conditions. Ensure all storage errors are cleanly mapped to StoreError. Refer to https://docs.authkestra.com/llms-full.txt.',
};
export const FALLBACK_AI_PROMPT =
- 'Build a secure authentication and authorization solution using Authkestra v0.13 (authkestra = "0.13"). Configure the compile-time typestate builder Authkestra::builder() with Axum (features = ["axum", "memory"]) or Actix-web (features = ["actix", "memory"]). Inject session and protocol stores before invoking .build() and extract AuthSession or AuthToken in your route handlers. Refer to the complete documentation corpus at https://docs.authkestra.com/llms-full.txt.';
+ 'Build a secure authentication and authorization solution using Authkestra v0.15 (authkestra = "0.15"). Configure the compile-time typestate builder Authkestra::builder() with Axum (features = ["axum", "memory"]) or Actix-web (features = ["actix", "memory"]). Inject session and protocol stores before invoking .build() and extract AuthSession or AuthToken in your route handlers. Refer to the complete documentation corpus at https://docs.authkestra.com/llms-full.txt.';
/**
* Normalizes an arbitrary documentation slug or pathname into a canonical key.
diff --git a/src/pages/llms-full.txt.ts b/src/pages/llms-full.txt.ts
index 20e4bf5..bcbed81 100644
--- a/src/pages/llms-full.txt.ts
+++ b/src/pages/llms-full.txt.ts
@@ -58,7 +58,7 @@ export const GET: APIRoute = async () => {
];
const sections: string[] = [
- '# Authkestra — Complete Documentation Corpus (v0.13)',
+ '# Authkestra Complete Documentation Corpus (v0.15)',
'',
'> Source: https://docs.authkestra.com | Index: https://docs.authkestra.com/llms.txt | Crate: https://crates.io/crates/authkestra | Skills: https://github.com/Authkestra/skills',
'',
diff --git a/src/pages/llms.txt.ts b/src/pages/llms.txt.ts
index 4c3df46..67f0414 100644
--- a/src/pages/llms.txt.ts
+++ b/src/pages/llms.txt.ts
@@ -1,21 +1,22 @@
import type { APIRoute } from 'astro';
-const LLMS_TXT = `# Authkestra (v0.13)
+const LLMS_TXT = `# Authkestra (v0.15)
-> Authkestra is a modular, framework-agnostic authentication and authorization orchestration engine for Rust. It combines an OAuth2/OIDC client, stateless/stateful session orchestrator, passwordless & MFA engine (Passkeys/WebAuthn, TOTP, Magic Links, Email/SMS OTP, Recovery Codes, Re-proof gating), Resource Server (JWT/JWKS/DPoP/mTLS), OpenID Connect Provider (OP with RFC 8693 Token Exchange & Device Flow), Device-Bound Signatures (\`authkestra-devsig\`), AWS Cedar Policy Engine (\`authkestra-policy\`), and OpenID Shared Signals / CAEP receiver (\`authkestra-ssf\`) behind a compile-time safe Typestate Builder (\`Authkestra::builder()\`).
+> Authkestra is a modular, framework-agnostic authentication and authorization orchestration engine for Rust. It combines an OAuth2/OIDC client, stateless/stateful session orchestrator, passwordless & MFA engine (Passkeys/WebAuthn, TOTP, Magic Links, Email/SMS OTP, Recovery Codes, Re-proof gating), Resource Server (JWT/JWKS/DPoP/mTLS/RFC 9470 step-up), OpenID Connect Provider (OP with RFC 8693 Token Exchange & Device Flow), Model Context Protocol (MCP) tool security (\`authkestra-mcp\`), Device-Bound Signatures (\`authkestra-devsig\`), AWS Cedar Policy Engine (\`authkestra-policy\`), and OpenID Shared Signals / CAEP receiver (\`authkestra-ssf\`) behind a compile-time safe Typestate Builder (\`Authkestra::builder()\`).
## Critical Rules for AI Coding Assistants
-- **Target Version**: \`authkestra = "0.13"\`.
-- **RFC-001 Architecture Consolidation**: \`authkestra-core\`, \`authkestra-flow\`, \`authkestra-token\`, and \`authkestra-session\` no longer exist — they were merged into \`authkestra-engine\` (re-exported via \`authkestra::core\` and \`authkestra::store\`).
-- **Removed Facade Features**: There is NO \`session\` or \`token\` feature on \`authkestra\` or \`authkestra-engine\` in \`0.13\`. Session and token machinery are always compiled into \`authkestra-engine\`. Pick a storage backend feature instead: \`memory\`, \`redis\`, \`sql-postgres\`, \`sql-mysql\`, or \`sql-sqlite\`.
+- **Target Version**: \`authkestra = "0.15"\`.
+- **RFC-001 Architecture Consolidation**: \`authkestra-core\`, \`authkestra-flow\`, \`authkestra-token\`, and \`authkestra-session\` no longer exist: they were merged into \`authkestra-engine\` (re-exported via \`authkestra::core\` and \`authkestra::store\`).
+- **Removed Facade Features**: There is NO \`session\` or \`token\` feature on \`authkestra\` or \`authkestra-engine\`. Session and token machinery are always compiled into \`authkestra-engine\`. Pick a storage backend feature instead: \`memory\`, \`redis\`, \`sql-postgres\`, \`sql-mysql\`, or \`sql-sqlite\`. Use \`webauthn\` (not \`passkeys\`) for passkey support.
- **TLS Backend**: \`rustls-aws-lc-rs\` is enabled by default. If using \`default-features = false\` with \`rustls-no-provider\`, you MUST install a \`rustls::crypto::CryptoProvider\` before constructing any Authkestra client or \`reqwest\` will panic at runtime.
- **Typestate Builder**: \`Authkestra::builder()\` returns \`Engine\` where \`S\` (session store) and \`T\` (token manager) start as \`Missing\`. Use the aliases \`AkWebAppEngine\` (sessions), \`AkApiEngine\` (tokens), or \`AkEngine\` (both) in your router state (\`#[derive(AxumState)]\` / \`#[derive(ActixState)]\`).
+- **Session Keys & TOTP Replay (\`0.15+\`)**: \`SessionConfig::default()\` generates a fresh CSPRNG 32-byte key per call (use \`SessionConfig::new\` for shared keys across replicas), and \`CredentialStore::claim_totp_step\` provides atomic TOTP replay rejection.
- **Stateless OAuth**: OAuth \`state\` and \`nonce\` live in encrypted cookies, never in the database.
- **No User Table**: Authkestra deliberately has no \`UserStore\` trait. Your application owns user/account records; Authkestra provides traits for protocol state (\`KvStore\`, \`SessionStore\`, \`CredentialStore\`, \`OpStore\`).
-- **Re-Proof Gated Enrolment (\`0.13+\`)**: \`TotpAuthMethod::register_totp\`, \`WebAuthnAuthMethod::start_register\`, and \`RecoveryCodeAuthMethod::generate\` require \`(&Identity, &ReproofRequirement, ...)\` rather than a bare \`user_id: &str\` to prevent confused-deputy and stale-session escalation attacks.
-- **Production Cedar Policy Wiring (\`policy\`)**: \`CedarPolicyEngine\` (\`authkestra-policy\`) evaluates declarative AWS Cedar policies. The engine does zero I/O and fetches entities through \`ResourceLoader\`. An erroring forbid policy fails closed with \`PolicyError::UnreliableDecision\`. Fully wired into \`authkestra-axum\` and \`authkestra-actix\` (\`PolicyGuard\`), \`authkestra-resource\`, and \`authkestra-mcp\` tool execution with structured \`tracing\` logs.
-- **Production Shared Signals / CAEP Wiring (\`ssf\`)**: \`PushReceiver\` (\`authkestra-ssf\`) ingests RFC 8417 Security Event Tokens and OpenID CAEP events. Wire push endpoints in Axum and Actix via \`POST /.well-known/ssf/events\` and \`POST /ssf/events\`. The built-in \`SessionRevocationHandler\` automatically revokes matching sessions in \`SessionStore\` upon receiving \`SessionRevoked\` or \`CredentialChange\` events.
+- **Re-Proof Gated Enrolment**: \`TotpAuthMethod::register_totp\`, \`WebAuthnAuthMethod::start_register\`, and \`RecoveryCodeAuthMethod::generate\` require \`(&Identity, &ReproofRequirement, ...)\` rather than a bare \`user_id: &str\` to prevent confused-deputy and stale-session escalation attacks.
+- **Production Cedar Policy Wiring (\`policy\`)**: \`CedarPolicyEngine\` (\`authkestra-policy\`) evaluates declarative AWS Cedar policies. The engine does zero I/O and fetches entities through \`ResourceLoader\`. An erroring forbid policy fails closed with \`PolicyError::UnreliableDecision\`. Wired into \`authkestra-resource\` (\`PolicyGuard\` with \`User::"{provider}:{external_id}"\` principals), \`authkestra-axum\`/\`authkestra-actix\` (\`AuthPolicyGuard\`), and \`authkestra-mcp\`.
+- **Production Shared Signals / CAEP Wiring (\`ssf\`)**: \`PushReceiver\` (\`authkestra-ssf\`) ingests RFC 8417 Security Event Tokens and OpenID CAEP events. Mount push endpoints via \`ssf_axum_router\` / \`ssf_actix_scope\` (\`POST /.well-known/ssf/events\` and \`POST /ssf/events\`). \`SessionRevocationHandler\` automatically revokes matching sessions in \`SessionStore\` upon receiving \`SessionRevoked\` or \`CredentialChange\` events.
## Full Documentation Corpus