Struct ServerConfig 

pub struct ServerConfig {
    pub bind: String,
    pub port: u16,
    pub gateway_url: String,
    pub gateway_key: Option<String>,
    pub model: String,
    pub seed_kb: bool,
    pub max_iterations: u32,
    pub max_tokens: u32,
    pub storage: StorageBackend,
    pub widget_auth_strict: bool,
}

Fully-resolved server configuration.

Fields

bind: String

IP address to bind (127.0.0.1 for local dev, 0.0.0.0 in containers).

port: u16

Port to bind.

gateway_url: String

LLM gateway base URL.

gateway_key: Option<String>

Optional gateway API key. None means LLM turns are unavailable and send_message returns a clean error.

model: String

Model id.

seed_kb: bool

Whether to seed the knowledge base with demo docs on startup.

max_iterations: u32

Agent-loop iteration cap per turn.

max_tokens: u32

max_tokens per LLM call.

storage: StorageBackend

Storage backend (drives both the storage adapter and the matching durable admin stores). Defaults to StorageBackend::Memory.

widget_auth_strict: bool

Fail-closed embeddable-widget auth: when true, a session for an agent the WidgetAuthProvider has no policy for is rejected (unknown/unregistered agents can’t be embedded). When false (default), an absent policy is allowed — so the permissive default provider leaves /ws open. Set WIDGET_AUTH_STRICT=1 in front of a real provider. Origin + authContext are always enforced for agents that do have a policy, regardless of this flag.

Implementations

impl ServerConfig

pub fn from_env() -> Self

Read configuration from the environment, applying documented defaults.

pub fn has_llm(&self) -> bool

true when a gateway key is present, so LLM turns can actually run.

pub fn llm_config(&self) -> Option<LlmConfig>

Build the smooth-operator LlmConfig for live turns.

Returns None when no gateway key is configured (callers should emit a clean protocol error rather than attempting a turn).

Trait Implementations

impl Clone for ServerConfig

fn clone(&self) -> ServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerConfig

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

Formats the value using the given formatter.