Struct SessionManager 

pub struct SessionManager {
    pub current_session_id: Option<String>,
    pub messages: Vec<SessionMessage>,
    pub context_checkpoint: Option<Value>,
    /* private fields */
}

Fields

current_session_id: Option<String>

messages: Vec<SessionMessage>

context_checkpoint: Option<Value>

Retrieval cutoff for the model view (optional; persisted per session).

Implementations

impl SessionManager

pub fn new(project_path: &Path) -> Self

pub fn project_path(&self) -> PathBuf

Project root this session store belongs to (<project>/.aacode/sessions).

pub fn create_session( &mut self, task: &str, title: Option<&str>, ) -> Result<String>

Create a new session and make it current. Returns the session id.

pub fn add_message(&mut self, msg: SessionMessage) -> Result<()>

Append a message to the current session. Writes are batched via a cooldown (every N messages or every flush_interval_secs) to avoid full-file serialize + disk write on every single message.

pub fn add_messages( &mut self, msgs: impl IntoIterator<Item = SessionMessage>, ) -> Result<()>

Append several messages (batch) then persist once.

pub fn flush(&mut self) -> Result<()>

Force a write of the current session to disk (messages + index).

pub fn switch_session(&mut self, id: &str) -> Result<bool>

Load an existing session as current.

pub fn context_checkpoint(&self) -> Option<Value>

Persisted retrieval checkpoint (model-view cutoff only).

pub fn set_context_checkpoint( &mut self, checkpoint: Option<Value>, ) -> Result<()>

Persist a retrieval checkpoint. Messages themselves are never modified.

pub fn export_jsonl(&self, id: &str) -> Result<String>

Export one session as JSONL (user-triggered, read-only).

Format: a header line, one message line per persisted message, and a footer line. Stable IDs/fields; no execution replay. Tool output text is exported verbatim — callers are responsible for not exporting sessions that contain secrets.

pub fn fork_session( &mut self, source_id: &str, upto: Option<usize>, ) -> Result<String>

Fork a session from a message prefix into a new session.

The prefix is copied by value; the source session is untouched and the new session is not made current. A boundary that would split an assistant(tool_calls) from its tool results is moved back to before the assistant so tool pairing is always intact. The retrieval checkpoint is reset (it is recomputed safely for the new session).

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

List all sessions, newest activity first. Falls back to scanning disk files when the index is empty.

pub fn delete_session(&mut self, id: &str) -> Result<bool>

Delete a session file + index entry.

pub fn read_session_messages(&self, id: &str) -> Vec<SessionMessage>

Read messages of a session file directly (without switching).

pub fn ensure_session(&mut self, sid: &str, title: &str) -> Result<()>

Ensure a session with the given id exists (idempotent create-or-touch). If it exists, its last_activity is bumped (and a non-empty title updates the stored title); otherwise an empty session file + index entry are created.

pub fn rename_session(&mut self, sid: &str, title: &str) -> Result<()>

Set an explicit title on an existing session (no-op if missing).

pub fn touch_session(&mut self, sid: &str) -> Result<()>

Bump last_activity of an existing session (no-op if missing).

pub fn append_session_messages( &mut self, sid: &str, msgs: Vec<SessionMessage>, ) -> Result<()>

Append messages to a session file (creating the session if missing), then refresh the index entry (counts + last_activity + title fallback).

pub fn history_chat(&self) -> Vec<ChatMessage>

Get the current session’s messages as ChatMessages (for LLM history). System messages are included so that dynamically-appended context (project analysis, init instructions, compaction summaries, etc.) are preserved in the prefix for provider KV-cache stability across calls.

pub fn ended_mid_tool(&self) -> bool

Whether the last message is a tool result (interrupted mid-execution).