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 auth(self, auth: Arc<dyn AuthVerifier>) -> Self

Install a custom AuthVerifier for the local flavor.

Without this, the local flavor runs auth-off (NoAuthVerifier) — fine for pure loopback. Pass a LocalTokenVerifier to gate stray local processes with a shared secret (recommended when binding beyond loopback, e.g. over a tailnet).

pub fn tools(self, provider: Arc<dyn ToolProvider>) -> Self

Install a host ToolProvider so the runner merges its per-turn tools into every turn alongside the built-ins (the #68 injection seam). The local flavor uses this to add an OS-sandboxed shell + egress-routed tools — the isolation the cloud flavor gets from its container/network sandbox instead.

pub fn serve_widget(self, token: Option<String>) -> Self

Serve the official @smooai/smooth-operator widget from this server: a host page at / and the bundle at /chat-widget.iife.js. token is injected into the page so the widget connects to this server’s /ws?token=… (pair it with a matching auth verifier); pass None for a no-auth local server.

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.