Struct ServerConfig 

pub struct ServerConfig {
    pub host: String,
    pub port: u16,
    pub channel: String,
    pub auth_token: String,
    pub log_level: String,
    pub log_format: String,
    pub log_file: Option<String>,
    pub database_url: Option<String>,
    pub config_path: Option<String>,
    pub strict_type_driven_transport: bool,
    pub default_backend: Option<String>,
    pub schemas_dir: Option<String>,
}

Server configuration — mirrors CLI args for axon serve.

Fields

host: String

port: u16

channel: String

auth_token: String

log_level: String

log_format: String

Log output format: “json” or “pretty”.

log_file: Option<String>

Optional directory for daily-rotated log files.

database_url: Option<String>

PostgreSQL connection URL (for persistent storage).

config_path: Option<String>

Optional path for persisted config file.

strict_type_driven_transport: bool

§Fase 31.d (D6) — Type-Driven Wire Inference activation flag.

When true, POST /v1/execute promotes to SSE for any flow the type-checker inferred as stream-producing (i.e. the AxonEndpoint AST node carries implicit_transport == "sse") REGARDLESS of the Accept: header. The D1 inference becomes the wire’s authoritative source.

When false (D6 default in v1.22.x — backwards-compat first), the Fase 30.e D4 + D5 negotiation matrix is preserved verbatim. Only the additive 31.e diagnostic header is observable for existing clients.

D9 ratified — this flag flips to default true in v2.0.0 (Fase 35+ candidate) with the full migration guide already published in docs/MIGRATION_v1.22.md (31.h).

Adopters opt in via three converging surfaces (31.f):

• CLI: axon serve --strict-type-driven-transport
• Config file: [server] strict_type_driven_transport = true
• Env var: AXON_STRICT_TYPE_DRIVEN_TRANSPORT=1

default_backend: Option<String>

§Fase 36.g (D7) — Server-wide default execution backend.

Rung 3 of the Fase 36 Backend Resolution Contract ladder: when a request behind an axonendpoint names no backend (rung 1) and the route declares none (rung 2), this server default is consulted before the environment-available auto rungs.

None ≡ no server default — resolution falls straight through to the auto rungs (operator-tuned registry scores → the providers with an API key in the environment). A Some("auto") value is transparent — it behaves as None at the ladder. Lets an operator pin a fleet-wide default without editing a single .axon.

Adopters set it via three converging surfaces (D7 — mirrors the strict_type_driven_transport precedence):

• CLI: axon serve --backend <name>
• Env var: AXON_DEFAULT_BACKEND=<name>
• Programmatic: this field. The CLI flag wins when both CLI and env are set. The value is validated against the closed catalog (parser::AXONENDPOINT_BACKEND_VALUES) at run_serve startup — an unknown name fails fast, before the first request is served.

schemas_dir: Option<String>

§Fase 38.j (D3 + D7 + D8) — Directory containing declared store- schema manifests (*.axon-schema.json files at the project root and/or under a schemas/ subdirectory).

When Some(path), POST /v1/deploy loads and merges every manifest under the directory before running the deploy-time store verification pass. The declared columns of every Fase 38 schema: form (a/b/c) are then proven AGAINST the live Postgres introspection — any drift fails the deploy with structured axon-T807 (DeclaredVsLiveDrift) diagnostics. axon-T805 (manifest hash mismatch) and axon-T806 (missing per-tenant env var) also surface here.

None ≡ no manifest loading — the v1.37.0 verify behavior is preserved verbatim (D5 absolute backwards-compat). An adopter who never adopts Fase 38’s compile-time schema observes ZERO behavior change at deploy.

Adopters set it via three converging surfaces (D7 — mirrors the default_backend precedence):

• CLI: axon serve --schemas-dir <path>
• Env var: AXON_SCHEMAS_DIR=<path>
• Programmatic: this field. The CLI flag wins when both CLI and env are set. An empty value collapses to None. The directory’s existence is NOT verified at startup — a missing dir resolves to “no manifest files” the same way an empty dir does (load_and_merge_manifests is total).

Implementations

impl ServerConfig

pub fn auth_enabled(&self) -> bool

Whether authentication is enabled.

pub fn bind_addr(&self) -> String

The bind address string (host:port).

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.

impl Default for ServerConfig

§Fase 50.d/2 (v2.4.0) — minimal ServerConfig for embedded callers (notably axon-enterprise’s runtime executor that constructs ServerState to drive server_execute_streaming).

Defaults: in-memory channel (no DB), no auth token, INFO logs to stdout, no persisted state path. Adopters that need persistence or auth construct ServerConfig explicitly. This default is total + side-effect-free: ServerState::new(ServerConfig::default()) produces a fresh in-memory state with no on-disk recovery attempted (when config_path is None).

fn default() -> Self

Returns the “default value” for a type.