Reference · the public surface

Find the owner of the problem.

Wreath modules are named after the job they do. Start from the boundary in your system, then follow the owning module into its API.

dependency-free coreexplicit ownershipstartup compilation

Build the first route Choose a story

Request path#

Need	Module
application and lifespan	`wreath.app`
routing	`wreath.router`
typed inputs and dependencies	`wreath.binding`
request and response objects	`wreath.request`, `wreath.response`
middleware and first-class policy	`wreath.middleware`, `wreath.policy`
OpenAPI and client generation	`wreath.openapi`, `wreath.typegen`
templates and static assets	`wreath.templates`, `wreath.staticfiles`

Identity, policy and tenancy#

Need	Module
identities and authentication	`wreath.auth`
Cedar authorization	`wreath.authorization`
users, sessions and second factors	`wreath.users`, `wreath.session_store`
organisations and membership	`wreath.organizations`
tenant resolution and isolation	`wreath.tenancy`
SAML, OIDC and provider flows	`wreath.saml`, `wreath.sso`
SCIM users and groups	`wreath.organizations.scim_router`
quotas and entitlements	`wreath.quota`
platform support operations	`wreath.platform`

Data and analysis#

Need	Module
PostgreSQL protocol and pooling	`wreath.postgres`
models, queries and sessions	`wreath.orm`
schema change	`wreath.migrations`
safe SQL and stores	`wreath.sql`, `wreath.store`
time zones, buckets and recurrence	`wreath.temporal`
aggregation and chart projection	`wreath.series`
geographic values and predicates	`wreath.geospatial`
bounded client synchronization	`wreath.sync`
object storage and resumable uploads	`wreath.objects`
artifact attestation	`wreath.provenance`

Realtime and durable work#

Lifetime	Module
one WebSocket connection	`wreath.websocket`
a live room	`wreath.rooms`
cross-worker messages	`wreath.messaging`
resumable output	`wreath.streams`
visible task status	`wreath.progress`
a durable attempt	`wreath.jobs`
several durable steps	`wreath.workflows`
one live owner of an entity	`wreath.entity`
user-facing delivery	`wreath.notifications`

AI and protocols#

Need	Module
MCP tools, resources and prompts	`wreath.mcp`
governed model agents, backplanes and tool execution	`wreath.agents`
Slack, Teams and Discord ChatOps	`wreath.chat`
GraphQL	`wreath.graphql`
gRPC	`wreath.grpc`
Protocol Buffers	`wreath.protobuf`
OAuth authorization server	`wreath.oauth`
HTTP message signatures	`wreath.signatures`

Boundaries and delivery#

Need	Module
outbound HTTP	`wreath.http_client`
hosted payments, subscriptions and Stripe	`wreath.billing`, `wreath.payments`
service-to-service calls	`wreath.service_client`
verified inbound and durable outbound webhooks	`wreath.webhooks`
native reverse proxy	`wreath.edge`
response caching and purge tags	`wreath.response_cache`
email and push delivery	`wreath.email`, `wreath.notifications`

Operations and evidence#

Need	Module
native HTTP server	`wreath.server`
health and readiness	`wreath.health`
logs, metrics and traces	`wreath.logging`, `wreath.metrics`, `wreath.telemetry`
bounded request evidence	`wreath.recording`
deterministic reproduction	`wreath.replay`, `wreath.simulation`
application testing	`wreath.testing`
startup hardening and diagnostics	`wreath.hardening`, `wreath.doctor`

Complete member reference#

Every page below is generated from the installed Wreath objects during a strict docs build. A renamed class, broken import or stale target fails the build instead of quietly publishing fictional API documentation.

For task-oriented examples, begin with the guides. The reference pages answer “what exactly ships?”; the guides answer “how do these parts fit together safely?”