Struct ConversationSession 

pub struct ConversationSession {
    pub id: ConversationId,
    pub user_id: Option<String>,
    pub system_prompt: Option<String>,
    pub messages: Vec<ChatMessage>,
    pub turns: Vec<Turn>,
    pub state: SessionState,
    pub created_at: u64,
    pub updated_at: u64,
    pub metadata: HashMap<String, String>,
    /* private fields */
}

A session representing a conversation

Fields

id: ConversationId

Session ID

user_id: Option<String>

User ID (if applicable)

system_prompt: Option<String>

System prompt

messages: Vec<ChatMessage>

Message history

turns: Vec<Turn>

Conversation turns

state: SessionState

Session state

created_at: u64

When session was created

updated_at: u64

When session was last updated

metadata: HashMap<String, String>

Session metadata

Implementations

impl ConversationSession

pub fn new(id: impl Into<String>) -> Self

pub fn with_config(self, config: SessionConfig) -> Self

pub fn with_user_id(self, user_id: impl Into<String>) -> Self

pub fn with_system_prompt(self, prompt: impl Into<String>) -> Self

pub fn with_metadata( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

pub fn add_message(&mut self, role: ChatRole, content: impl Into<String>)

Add a message to the session

pub fn add_message_obj(&mut self, message: ChatMessage)

Add a pre-constructed message

pub fn get_context(&self, max_tokens: Option<usize>) -> Vec<&ChatMessage>

Get messages for context (within token limit)

pub fn get_all_messages(&self) -> &[ChatMessage]

Get all messages

pub fn get_recent(&self, n: usize) -> Vec<&ChatMessage>

Get recent N messages

pub fn get_by_role(&self, role: ChatRole) -> Vec<&ChatMessage>

Get messages by role

pub fn current_turn(&self) -> u32

Get current turn number

pub fn last_turn(&self) -> Option<&Turn>

Get the last turn

pub fn get_turn(&self, number: u32) -> Option<&Turn>

Get a specific turn

pub fn is_expired(&self) -> bool

Check if session is expired

pub fn age(&self) -> Duration

Get session age

pub fn clear_messages(&mut self)

Clear all messages (keep system prompt)

pub fn total_tokens(&self) -> usize

Get total estimated tokens

Trait Implementations

impl Clone for ConversationSession

fn clone(&self) -> ConversationSession

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConversationSession

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ConversationSession

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ConversationSession

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

where __S: Serializer,

Serialize this value into the given Serde serializer.