Struct Session 

pub struct Session {
    pub id: String,
    pub history: Vec<Message>,
    pub metadata: Value,
    pub created_at_ms: u64,
    pub updated_at_ms: u64,
    pub expires_at_ms: Option<u64>,
}

A long-lived conversation.

Fields

id: String

Stable identifier (caller-supplied).

history: Vec<Message>

Conversation history.

metadata: Value

Free-form metadata. Examples: user-id, tenant-id, agent name.

created_at_ms: u64

Unix-millis when the session was created.

updated_at_ms: u64

Unix-millis when the session was last touched.

expires_at_ms: Option<u64>

Optional unix-millis after which the session is considered expired.

Implementations

impl Session

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

New session with empty history + null metadata.

pub fn with_metadata(self, metadata: Value) -> Self

Set metadata (replaces any existing value).

pub fn with_ttl(self, ttl: Duration) -> Self

Set a TTL relative to created_at_ms.

pub fn is_expired(&self) -> bool

True if the session has expired (relative to now_millis).

pub fn push(&mut self, msg: Message)

Append a message and bump updated_at_ms.

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<'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.