Expand description
HTTP server layer for the awaken agent framework.
Provides an Axum-based server that exposes agents over HTTP with Server-Sent
Events (SSE) streaming. Includes routing, protocol adapters (AI SDK, AG-UI),
mailbox polling, metrics, and request/response conversion utilities. Enabled
via the server feature flag on the awaken facade crate.
Modules§
- app
- Application state and server startup.
- config_
routes - durable_
message_ sink - Host implementation of the runtime’s
DurableMessageSink: delivers durable cross-threadsend_messagemessages by enqueuing a background run on the recipient thread via theMailbox. - error
- Canonical API error type for HTTP handlers.
- eval_
limits - Operator-tunable caps for the
/v1/eval/*endpoints. Lifted out ofapp.rsso adding/changing a knob doesn’t drag the central server config file past its line cap. - eval_
router /v1/eval/*route registration. Lifted out ofroutes.rsso the eval surface (datasets, runs, online, importers) lives next to its own handlers and stops dominating the central router file.- event_
relay - Transport-agnostic event relay pipeline.
- http_
run - HTTP run execution with SSE relay.
- http_
sse - SSE response helpers for streaming agent events over HTTP.
- mailbox
- Mailbox service: persistent run queue, dispatch execution, leasing, and lifecycle management.
- message_
convert - Shared message conversion for protocol handlers.
- metrics
- Prometheus metrics endpoint and metric definitions.
- outbox_
relay - Generic at-least-once outbox relay.
- prelude
- protocol_
fanout - Protocol replay outbox fanout relay.
- protocol_
projector - Protocol replay projectors backed by
ProtocolReplayLog. - protocol_
replay_ state - Optional ProtocolReplayLog and projector relay attachments.
- protocols
- query
- Shared query-parameter types for paginated endpoints.
- request
- Request preparation utilities.
- routes
- Axum router setup — unified route registration.
- run_
dispatch - scope
- services
- time
- Shared time-conversion helpers.
- transport