Struct SessionContext 

pub struct SessionContext {
    pub session_id: String,
    pub get_state: Arc<dyn Fn(&str) -> Pin<Box<dyn Future<Output = Option<Value>> + Send + 'static>> + Send + Sync>,
    pub set_state: Arc<dyn Fn(&str, Value) -> Pin<Box<dyn Future<Output = ()> + Send + 'static>> + Send + Sync>,
    pub remove_state: Arc<dyn Fn(&str) -> Pin<Box<dyn Future<Output = Option<Value>> + Send + 'static>> + Send + Sync>,
    pub is_initialized: Arc<dyn Fn() -> Pin<Box<dyn Future<Output = bool> + Send + 'static>> + Send + Sync>,
    pub send_notification: Arc<dyn Fn(SessionEvent) -> Pin<Box<dyn Future<Output = ()> + Send + 'static>> + Send + Sync>,
    pub broadcaster: Option<Arc<dyn Any + Send + Sync>>,
}

Fields

session_id: String

Unique session identifier

get_state: Arc<dyn Fn(&str) -> Pin<Box<dyn Future<Output = Option<Value>> + Send + 'static>> + Send + Sync>

Get session state value by key (async)

set_state: Arc<dyn Fn(&str, Value) -> Pin<Box<dyn Future<Output = ()> + Send + 'static>> + Send + Sync>

Set session state value by key (async)

remove_state: Arc<dyn Fn(&str) -> Pin<Box<dyn Future<Output = Option<Value>> + Send + 'static>> + Send + Sync>

Remove session state value by key (async)

is_initialized: Arc<dyn Fn() -> Pin<Box<dyn Future<Output = bool> + Send + 'static>> + Send + Sync>

Check if session is initialized (async)

send_notification: Arc<dyn Fn(SessionEvent) -> Pin<Box<dyn Future<Output = ()> + Send + 'static>> + Send + Sync>

Send notification to this session (async)

broadcaster: Option<Arc<dyn Any + Send + Sync>>

NotificationBroadcaster for sending MCP-compliant notifications

Implementations

impl SessionContext

pub fn has_broadcaster(&self) -> bool

Check if this context has a broadcaster available

pub fn get_raw_broadcaster(&self) -> Option<Arc<dyn Any + Send + Sync>>

Get the raw broadcaster (as Any) - for use by framework internals

pub async fn get_typed_state<T>(&self, key: &str) -> Option<T>

where T: DeserializeOwned,

Convenience method to get typed session state (async)

pub async fn set_typed_state<T>( &self, key: &str, value: T, ) -> Result<(), String>

where T: Serialize,

Convenience method to set typed session state (async)

pub async fn notify(&self, event: SessionEvent)

Send a custom notification to this session (async)

pub async fn notify_progress( &self, progress_token: impl Into<String>, progress: u64, )

Send a progress notification

pub async fn notify_progress_with_total( &self, progress_token: impl Into<String>, progress: u64, total: u64, )

Send a progress notification with total

pub async fn notify_log( &self, level: LoggingLevel, data: Value, logger: Option<String>, meta: Option<HashMap<String, Value>>, )

Send a logging message notification (with session-aware level filtering)

pub async fn notify_resources_changed(&self)

Send a resource list changed notification

pub async fn notify_resource_updated(&self, uri: impl Into<String>)

Send a resource updated notification

pub async fn notify_tools_changed(&self)

Send a tools list changed notification

pub async fn get_logging_level(&self) -> LoggingLevel

Get the current logging level for this session (async)

pub async fn set_logging_level(&self, level: LoggingLevel)

Set the logging level for this session (async)

pub async fn should_log(&self, message_level: LoggingLevel) -> bool

Check if a log message at the given level should be sent to this session (async)

pub fn should_log_sync(&self, message_level: LoggingLevel) -> bool

Synchronous version of should_log for trait compatibility

Trait Implementations

impl Clone for SessionContext

fn clone(&self) -> SessionContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl LoggingTarget for SessionContext

Implement LoggingTarget trait from turul-mcp-builders to enable session-aware logging

fn should_log(&self, level: LoggingLevel) -> bool

Check if this target should receive a message at the given level

fn notify_log( &self, level: LoggingLevel, data: Value, logger: Option<String>, meta: Option<HashMap<String, Value>>, )

Send a log message to this target

impl SessionView for SessionContext

Implement SessionView trait for SessionContext (trait is defined in turul-mcp-session-storage)

This allows SessionContext to be used with middleware. Metadata is stored using a special prefix (“meta:”) to distinguish it from regular state.

fn session_id(&self) -> &str

Get the unique session identifier

fn get_state<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Value>, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get a state value from the session

fn set_state<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, value: Value, ) -> Pin<Box<dyn Future<Output = Result<(), String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Set a state value in the session

fn get_metadata<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<Option<Value>, String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Get a metadata value from the session

fn set_metadata<'life0, 'life1, 'async_trait>( &'life0 self, key: &'life1 str, value: Value, ) -> Pin<Box<dyn Future<Output = Result<(), String>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Set a metadata value in the session