Struct ChatSession 

pub struct ChatSession { /* private fields */ }

Chat session state

Implementations

impl ChatSession

pub fn new(provider: String, model: String) -> Self

Create a new chat session

pub fn add_user_message(&mut self, content: String)

Add a user message to the conversation

pub fn add_assistant_message( &mut self, content: String, role: MessageRole, metadata: Option<MessageMetadata>, )

Add an assistant message to the conversation (generic)

pub fn add_thinking_message(&mut self, reasoning: String, needs_context: bool)

Add a thinking/assessment message

pub fn add_tools_message(&mut self, content: String, tool_calls: Vec<String>)

Add a tool gathering message

pub fn add_queries_message(&mut self, queries: Vec<String>)

Add a queries generated message

pub fn add_execution_message( &mut self, results_count: usize, execution_time_ms: u64, )

Add an execution status message

pub fn add_answer_message(&mut self, answer: String)

Add a final answer message

pub fn add_system_message(&mut self, content: String)

Add a system message (e.g., compaction summary)

pub fn clear(&mut self)

Clear all messages and reset token count

pub fn messages(&self) -> &[Message]

Get all messages in the conversation

pub fn total_tokens(&self) -> usize

Get total token count

pub fn context_limit(&self) -> usize

Get context window limit

pub fn context_usage(&self) -> f32

Get context usage as percentage (0.0 to 1.0)

pub fn is_near_limit(&self) -> bool

Check if we’re approaching context limit (>80%)

pub fn should_compact(&self) -> bool

Check if we should suggest compaction (>90%)

pub fn provider(&self) -> &str

Get provider name

pub fn model(&self) -> &str

Get model name

pub fn update_provider(&mut self, provider: String, model: String)

Update provider and model (for /model command)

pub fn build_context(&self) -> String

Build conversation history for LLM prompt

Returns a formatted string suitable for including in LLM prompts, containing all messages in chronological order.

pub fn prepare_compaction(&self, keep_recent: usize) -> (String, usize, usize)

Compact old messages by summarizing them

Keeps the last keep_recent messages verbatim and returns the older messages as a formatted string that can be sent to an LLM for summarization.

Returns (old_messages_for_summary, kept_messages_count, tokens_to_compact)

pub fn apply_compaction(&mut self, remove_count: usize, summary: String)

Apply compaction by replacing old messages with a summary

Removes the first remove_count messages and replaces them with a single system message containing the summary.