Struct SessionManager 

pub struct SessionManager { /* private fields */ }

High-level session management

Implementations

impl SessionManager

pub fn new(db: Database) -> Self

Create a new SessionManager

Arguments

• db - Database instance

Returns

A new SessionManager instance

pub fn start_session(&self, user_id: Option<&str>) -> Result<Session>

Start a new session

Arguments

• user_id - Optional user identifier

Returns

The newly created session

pub async fn add_user_message( &self, session_id: &str, query: &str, config: CompilerConfig, index: &VectorIndex, api_key: Option<&str>, ) -> Result<(Message, WorkingSet)>

Add a user message and compile context

This method:

1. Adds the user message to the database
2. Calls the compiler to generate a WorkingSet from the query
3. Associates the WorkingSet with the session
4. Returns both the Message and WorkingSet

Arguments

• session_id - The session ID
• query - The user’s query
• config - Compiler configuration
• index - Vector index for search
• api_key - Optional OpenAI API key (for embeddings)

Returns

Tuple of (Message, WorkingSet)

pub fn add_assistant_message( &self, session_id: &str, content: &str, metadata: Option<&Value>, ) -> Result<Message>

Add an assistant response

Arguments

• session_id - The session ID
• content - The assistant’s response
• metadata - Optional metadata (e.g., model info, citations)

Returns

The newly created message

pub fn get_conversation_history( &self, session_id: &str, max_tokens: Option<usize>, ) -> Result<String>

Get conversation history formatted for LLM consumption

Formats messages as:

User: <message>

Assistant: <message>

User: <message>
...

If max_tokens is specified, older messages are truncated to stay within the token budget. Most recent messages are always kept (they’re most relevant).

Arguments

• session_id - The session ID
• max_tokens - Optional token limit

Returns

Formatted conversation history as a string

pub fn replay_session(&self, session_id: &str) -> Result<SessionReplay>

Replay a session for debugging

Groups messages into conversation turns (user + assistant pairs) and includes associated working sets for analysis.

Arguments

• session_id - The session ID

Returns

SessionReplay with structured debug data