Struct SessionManager 

pub struct SessionManager { /* private fields */ }

Manages the memory graph lifecycle, file I/O, and session state.

Implementations

impl SessionManager

pub fn open(path: &str) -> McpResult<Self>

Open or create a memory file at the given path.

pub fn graph(&self) -> &MemoryGraph

Get an immutable reference to the graph.

pub fn graph_mut(&mut self) -> &mut MemoryGraph

Get a mutable reference to the graph and mark as dirty.

pub fn query_engine(&self) -> &QueryEngine

Get the query engine.

pub fn write_engine(&self) -> &WriteEngine

Get the write engine.

pub fn workspace_manager(&self) -> &WorkspaceManager

Get the workspace manager (immutable).

pub fn workspace_manager_mut(&mut self) -> &mut WorkspaceManager

Get the workspace manager (mutable).

pub fn current_session_id(&self) -> u32

Current session ID.

pub fn start_session(&mut self, explicit_id: Option<u32>) -> McpResult<u32>

Start a new session, optionally with an explicit ID.

pub fn end_session_with_episode( &mut self, session_id: u32, summary: &str, ) -> McpResult<u64>

End a session and optionally create an episode summary.

pub fn save(&mut self) -> McpResult<()>

Save the graph to file with file-locking for concurrent session safety.

When multiple MCP instances share the same .amem file, this method:

1. Acquires an exclusive file lock (sidecar .amem.lock)
2. Checks if the file was modified externally (by another instance)
3. If so, re-reads the disk graph and merges our session’s new nodes
4. Writes the merged graph and releases the lock

pub fn maybe_auto_save(&mut self) -> McpResult<()>

Check if auto-save is needed and save if so.

pub fn run_maintenance_tick(&mut self) -> McpResult<()>

Runs autonomous maintenance: sleep-cycle, auto-save, and periodic backup.

pub fn maybe_run_sleep_cycle(&mut self) -> McpResult<()>

Run a periodic sleep-cycle: decay refresh + tier balancing + auto-archive.

pub fn maybe_auto_backup(&mut self) -> McpResult<()>

Periodic backup of persisted state with retention pruning.

pub fn mark_dirty(&mut self)

Mark the graph as dirty (needs saving).

pub fn file_path(&self) -> &PathBuf

Get the file path.

pub fn last_temporal_node_id(&self) -> Option<u64>

The ID of the most recent node in the temporal chain for this session.

pub fn advance_temporal_chain(&mut self, node_id: u64)

Advance the temporal chain pointer to the given node ID.

pub fn link_temporal(&mut self, prev_id: u64, next_id: u64) -> McpResult<()>

Create a TemporalNext edge from prev_id to next_id (forward in time).

pub fn maintenance_interval(&self) -> Duration

Background maintenance loop interval.

pub fn capture_prompt_request( &mut self, prompt_name: &str, arguments: Option<&Value>, ) -> McpResult<Option<u64>>

Capture a prompt template invocation (prompts/get) into memory.

pub fn capture_tool_call( &mut self, tool_name: &str, arguments: Option<&Value>, ) -> McpResult<Option<u64>>

Capture a tool call input context into memory based on capture mode.

pub fn add_event( &mut self, event_type: EventType, content: &str, confidence: f32, edges: Vec<(u64, EdgeType, f32)>, ) -> McpResult<(u64, usize)>

Add a cognitive event to the graph.

pub fn correct_node( &mut self, old_node_id: u64, new_content: &str, ) -> McpResult<u64>

Correct a previous belief.

Trait Implementations

impl Drop for SessionManager

fn drop(&mut self)

Executes the destructor for this type.