Struct LocalServerBuilder 

pub struct LocalServerBuilder { /* private fields */ }

Builder for the local deployment flavor: a fully in-memory, auth-off, single-process server, embeddable in-process.

All knobs are optional — LocalServer::builder().spawn().await boots the default flavor (in-memory everything, loopback :8787, no auth, no seed). Construct with LocalServer::builder.

Implementations

impl LocalServerBuilder

pub fn addr(self, addr: SocketAddr) -> Self

Bind on the given address instead of the default 127.0.0.1:8787.

Use port 0 for an ephemeral port (read the real one back from LocalServer::addr after spawn).

pub fn seed_kb(self, seed: bool) -> Self

Seed the knowledge base with the demo docs on boot (default false). Handy for an embedded demo / smoke test with grounded answers.

pub fn config(self, config: ServerConfig) -> Self

Override the full ServerConfig (e.g. to point at a gateway / model).

The local flavor still forces in-memory storage and the caller’s bind addr regardless of what this config says — the storage/bind fields are overwritten — so the “no external services” guarantee always holds. Use this to set the gateway URL / key / model / limits for live turns.

pub async fn spawn(self) -> Result<LocalServer>

Bind and spawn the server in a background task, returning a LocalServer handle carrying the real bound address (resolved even for port 0) and a graceful-shutdown switch.

Errors

Returns an error if binding the TCP listener fails (e.g. the port is in use). Serving errors after a successful bind surface when the handle is awaited / shut down.

Trait Implementations

impl Clone for LocalServerBuilder

fn clone(&self) -> LocalServerBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LocalServerBuilder

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

Formats the value using the given formatter.

impl Default for LocalServerBuilder

fn default() -> Self

Returns the “default value” for a type.