Struct ChatSession 

pub struct ChatSession {
    pub session_id: Uuid,
    pub system: Option<String>,
    pub messages: Vec<Message>,
    pub cache_strategy: CacheStrategy,
}

Conversation state.

Fields

session_id: Uuid

system: Option<String>

Optional system prompt.

messages: Vec<Message>

Message history in normalized form.

cache_strategy: CacheStrategy

Cache-injection strategy.

Implementations

impl ChatSession

pub fn new() -> Self

pub fn with_system(self, system: impl Into<String>) -> Self

pub fn with_cache_strategy(self, strategy: CacheStrategy) -> Self

pub fn push_user(&mut self, content: impl Into<String>)

Append a user text message.

pub fn push_assistant(&mut self, response: NormalizedResponse)

Append the assistant’s response content blocks verbatim.

pub fn push_tool_results(&mut self, results: Vec<ToolResultMessage>)

Append tool results as a single user message containing ContentBlock::ToolResult blocks. Providers translate the exact shape at the wire layer.

pub fn append_to_last_user(&mut self, text: impl Into<String>)

Append text to the tail of the most recent user message as a new ContentBlock::Text block. Used for mid-turn injections (stream rules) that must NOT create a bare user message after tool results (provider alternation rules — spec D7). Falls back to pushing a new user message when no user message exists; that only happens with an empty, system-only, or assistant-only history, where a user message is alternation-safe.

Caller contract: intended for mid-turn injection while the tail message is a user message (before any assistant commit). If the tail is an assistant message, the text lands on an older user message mid-history.

pub fn len(&self) -> usize

Total message count (including system messages if pushed manually).

pub fn is_empty(&self) -> bool

pub fn compress( &mut self, target_tokens: u32, compressor: &dyn HistoryCompressor, tokenizer: &dyn Tokenizer, ) -> u32

Compress history in place to fit within target_tokens using the provided compressor and tokenizer. Returns the token count after compression (may still exceed target_tokens if no further moves were safe).

pub fn save(&self, path: &Path) -> Result<(), ClassifiedError>

Persist the session to disk as JSON (supports /resume).

pub fn load(path: &Path) -> Result<Self, ClassifiedError>

Load a session from disk.

Trait Implementations

impl Clone for ChatSession

fn clone(&self) -> ChatSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ChatSession

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ChatSession

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ChatSession

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ChatSession

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.