Struct ServerStateConfig 

pub struct ServerStateConfig {
    pub journal_dir: PathBuf,
    pub shared_memgine: Option<Arc<Mutex<MemgineEngine>>>,
    pub inference: Option<Arc<InferenceEngine>>,
    pub a2a_runtime: Option<Arc<Runtime>>,
    pub a2a_store: Option<Arc<dyn TaskStore>>,
    pub a2a_card_source: Option<Arc<AgentCardSource>>,
    pub approval_gate: Option<ApprovalGate>,
}

standalone car-server binary uses ServerState::standalone which calls with_config under the hood.

Fields

journal_dir: PathBuf

shared_memgine: Option<Arc<Mutex<MemgineEngine>>>

Optional pre-constructed memgine engine. When None, each create_session call builds a fresh engine; embedders that want to share a single engine across sessions can supply a clone of their Arc<Mutex<MemgineEngine>> here.

inference: Option<Arc<InferenceEngine>>

Optional pre-constructed inference engine.

a2a_runtime: Option<Arc<Runtime>>

Optional embedder-supplied A2A runtime. Used by the in-core A2aDispatcher to execute peer-driven proposals. When None, the dispatcher uses a fresh Runtime with register_agent_basics — peer agents see CAR’s built-in tools and nothing else, matching the behaviour of the standalone start_a2a_listener.

a2a_store: Option<Arc<dyn TaskStore>>

Optional embedder-supplied A2A task store. When None, defaults to InMemoryTaskStore. tokhn-style embedders that want a polling-friendly persistent store plug it in here.

a2a_card_source: Option<Arc<AgentCardSource>>

Optional embedder-supplied agent card factory. When None, the dispatcher serves a card built from the A2A runtime’s tool schemas at construction time, advertising its public URL as ws://127.0.0.1:9100/ (the WS surface the dispatcher itself is reachable on).

approval_gate: Option<ApprovalGate>

Approval-gate policy. When None, the dispatcher uses ApprovalGate::default (gate ON, the macOS-automation surface gated, 60s timeout). Pass ApprovalGate::disabled to opt out — only appropriate when no untrusted caller can reach the WS port.

Implementations

impl ServerStateConfig

pub fn new(journal_dir: PathBuf) -> Self

Minimal config suitable for the standalone car-server binary: only the journal dir is required; everything else is lazily constructed at first use.

pub fn with_shared_memgine(self, engine: Arc<Mutex<MemgineEngine>>) -> Self

pub fn with_inference(self, engine: Arc<InferenceEngine>) -> Self

pub fn with_a2a_runtime(self, runtime: Arc<Runtime>) -> Self

Plug in an embedder-supplied runtime for the A2A dispatcher. Use case: tokhn-daemon wants peers to see its OPA preflight tooling, not just CAR’s register_agent_basics defaults.

pub fn with_a2a_store(self, store: Arc<dyn TaskStore>) -> Self

Plug in an embedder-supplied task store for the A2A dispatcher. Use case: tokhn’s polling-friendly persistent store keyed by their session id.

pub fn with_a2a_card_source(self, source: Arc<AgentCardSource>) -> Self

Plug in an embedder-supplied agent card factory. The factory is invoked on every agent/getAuthenticatedExtendedCard dispatch, so embedders can reflect runtime tool changes.

pub fn with_approval_gate(self, gate: ApprovalGate) -> Self

Override the approval-gate policy. Pass ApprovalGate::disabled to skip the gate entirely (only appropriate when no untrusted caller can reach the WS port); pass a customised ApprovalGate to add or remove methods or to change the timeout.