Struct CortexServer 

pub struct CortexServer { /* private fields */ }

The Córtex API Server.

This struct encapsulates the server’s configuration and shared state, and provides methods to build the router and run the server.

Implementations

impl CortexServer

pub fn new(config: CortexConfig) -> Result<Self>

Creates a new CortexServer with a given configuration.

The graph database backend is selected based on config.db_path:

• Some(":memory:") — volatile in-memory storage.
• Some(path) — Sled-backed persistent storage at the given path.
• None — Sled-backed persistent storage at ~/.aingle/cortex/graph.sled.

pub fn with_state(config: CortexConfig, state: AppState) -> Self

Creates a new CortexServer with a given configuration and a pre-existing AppState.

pub fn state(&self) -> &AppState

Returns a reference to the shared AppState.

pub fn state_mut(&mut self) -> &mut AppState

Returns a mutable reference to the shared AppState.

pub fn build_router(&self) -> Router

Builds the axum router, combining all API routes and middleware.

pub async fn run(self) -> Result<()>

Runs the server indefinitely.

pub async fn run_with_shutdown<F>(self, shutdown_signal: F) -> Result<()>

where F: Future<Output = ()> + Send + 'static,

Runs the server with a graceful shutdown signal.

The server will run until the shutdown_signal future completes.