Struct ServeConfig 

pub struct ServeConfig {
    pub http_addr: String,
    pub require_auth: bool,
    pub auth_token_vault_key: String,
    pub max_sessions: usize,
    pub session_idle_ttl_secs: u64,
    pub max_queued_prompts: usize,
}

Top-level [serve] config block (spec-068 §9).

Example (TOML)

[serve]
http_addr = "127.0.0.1:8420"
require_auth = true
auth_token_vault_key = "ZEPH_SERVE_AUTH_TOKEN"
max_sessions = 50
session_idle_ttl_secs = 1800
max_queued_prompts = 8

Fields

http_addr: String

Address the HTTP/SSE API binds to. Default: "127.0.0.1:8420".

require_auth: bool

Require a bearer token on all /sessions* endpoints (/health is always unauthenticated). Default: true.

Per CLAUDE.md’s vault-only secrets policy, the token itself is never stored in this config file — only the vault key name to resolve it from (auth_token_vault_key).

auth_token_vault_key: String

Zeph age-vault key name to resolve the bearer token from at startup (spec-068 NFR-S4). Default: "ZEPH_SERVE_AUTH_TOKEN".

max_sessions: usize

Maximum number of concurrent live sessions the LiveSessionRegistry will hold. Default: 50.

session_idle_ttl_secs: u64

Seconds of no attached broadcast receivers before serve.evict shuts down and removes a session’s SessionActor (spec-068 §9.3). Default: 1800 (30 minutes).

max_queued_prompts: usize

Bounded mpsc capacity for a SessionActor’s prompt mailbox; a full mailbox returns HTTP 429 to the caller rather than blocking (spec-068 §9.2). Default: 8.

Trait Implementations

impl Clone for ServeConfig

fn clone(&self) -> ServeConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServeConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ServeConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ServeConfig

where ServeConfig: Default,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ServeConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.