Struct Session 

pub struct Session {
    pub key: String,
    pub messages: Vec<Value>,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub metadata: HashMap<String, Value>,
    pub last_consolidated: usize,
}

A conversation session.

Messages are append-only for LLM cache efficiency. The consolidation process writes summaries to MEMORY.md / HISTORY.md but does not modify the messages list or get_history output.

Fields

key: String

Session key, typically "{channel}:{chat_id}".

messages: Vec<Value>

Ordered list of messages (append-only).

created_at: DateTime<Utc>

When the session was first created.

updated_at: DateTime<Utc>

When the session was last updated.

metadata: HashMap<String, Value>

Arbitrary session metadata.

last_consolidated: usize

Number of messages already consolidated to external files.

Implementations

impl Session

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

Create a new empty session with the given key.

pub fn add_message( &mut self, role: &str, content: &str, extras: Option<HashMap<String, Value>>, )

Append a message to the session.

Extra fields can be passed via extras and will be merged into the message object alongside role, content, and timestamp.

pub fn get_history(&self, max_messages: usize) -> Vec<Value>

Get recent messages in LLM format.

Returns at most max_messages entries from the end of the history. Preserves tool_call_id and tool_calls metadata when present so that the LLM can correctly associate tool results with tool calls.

pub fn clear(&mut self)

Clear all messages and reset consolidation state.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.

impl Default for Session

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Session

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for Session

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

where __S: Serializer,

Serialize this value into the given Serde serializer.