Struct ServerState 

pub struct ServerState {
    pub client_caps: RwLock<ClientCapabilities>,
    pub server_caps: ServerCapabilities,
    pub initialized: AtomicBool,
    pub cancellations: RwLock<HashMap<String, CancellationToken>>,
    pub negotiated_version: RwLock<Option<ProtocolVersion>>,
}

State for a running server.

Fields

client_caps: RwLock<ClientCapabilities>

Client capabilities negotiated during initialization.

server_caps: ServerCapabilities

Server capabilities advertised during initialization.

initialized: AtomicBool

Whether the server has been initialized.

cancellations: RwLock<HashMap<String, CancellationToken>>

Active cancellation tokens by request ID.

negotiated_version: RwLock<Option<ProtocolVersion>>

The protocol version negotiated during initialization.

This is stored as a ProtocolVersion enum for type-safe feature detection. Use methods like protocol_version().supports_tasks() to check capabilities.

Implementations

impl ServerState

pub fn new(server_caps: ServerCapabilities) -> Self

Create a new server state.

pub fn protocol_version(&self) -> Option<ProtocolVersion>

Get the negotiated protocol version.

Returns None if not yet initialized.

Example

if let Some(version) = state.protocol_version() {
    if version.supports_tasks() {
        // Tasks are available in this session
    }
}

pub fn set_protocol_version(&self, version: ProtocolVersion)

Set the negotiated protocol version.

Silently fails if the lock is poisoned.

pub fn client_caps(&self) -> ClientCapabilities

Get a snapshot of client capabilities.

Returns default capabilities if the lock is poisoned.

pub fn set_client_caps(&self, caps: ClientCapabilities)

Update client capabilities.

Silently fails if the lock is poisoned.

pub fn is_initialized(&self) -> bool

Check if the server is initialized.

pub fn set_initialized(&self)

Mark the server as initialized.

pub fn register_cancellation(&self, request_id: &str, token: CancellationToken)

Register a cancellation token for a request.

pub fn cancel_request(&self, request_id: &str)

Cancel a request by ID.

pub fn remove_cancellation(&self, request_id: &str)

Remove a cancellation token after request completion.