Struct LdsState 

pub struct LdsState { /* private fields */ }

Top-level mutable state for the MCP server.

Holds a ledger of all live Sessions, indexed by session_id (opaque hash) and alias (human-readable label). One session is designated the default session, returned by Self::session for backward-compatible tool calls that pre-date per-call session_id addressing.

The MCP handler wraps this in Arc<RwLock<LdsState>> for concurrent tool access. Mutations (create / close / alias) take the write lock; reads (resolve / list / describe / doctor) take the read lock.

Implementations

impl LdsState

pub fn new() -> LdsState

pub fn create_session( &mut self, config: SessionConfig, make_default: bool, ) -> Result<Arc<Session>, CoreError>

Create a new session and register it in the ledger.

If make_default is true (or no default exists yet), the new session becomes the implicit default.

Returns CoreError::AliasConflict if config.alias is already taken by another session.

pub fn start_session( &mut self, config: SessionConfig, ) -> Result<Arc<Session>, CoreError>

Backward-compatible entry point used by the legacy session_start MCP tool. Always replaces the default session.

pub fn resolve(&self, key: &str) -> Result<Arc<Session>, CoreError>

Look up a session by id or alias.

key is tried as an alias first, then as a session_id. Returns CoreError::SessionNotFound if neither matches.

pub fn session(&self) -> Result<Arc<Session>, CoreError>

Return the default session for backward-compatible tool calls.

pub fn default_session_id(&self) -> Option<&str>

pub fn list_sessions(&self) -> Vec<SessionEntry>

Snapshot every session in the ledger.

pub fn describe(&self, key: &str) -> Result<SessionEntry, CoreError>

Describe a single session by id or alias.

pub fn set_alias(&mut self, key: &str, alias: String) -> Result<(), CoreError>

Assign or change an alias on an existing session.

Returns CoreError::AliasConflict if the new alias is already held by another session.

pub fn unset_alias(&mut self, alias: &str) -> Result<(), CoreError>

Remove an alias from the ledger. The session itself remains.

pub fn close(&mut self, key: &str) -> Result<(), CoreError>

Close (drop) a session by id or alias.

If the closed session was the default, the default is cleared and must be re-set by a subsequent session_start / session_create with make_default=true.

impl LdsState

pub fn doctor(&self, key: &str) -> Result<DoctorReport, CoreError>

Run health checks on a single session (by id / alias).

Trait Implementations

impl Clone for LdsState

fn clone(&self) -> LdsState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LdsState

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

Formats the value using the given formatter.

impl Default for LdsState

fn default() -> LdsState

Returns the “default value” for a type.