Struct Session 

pub struct Session {
    pub id: String,
    pub agent_name: String,
    pub user_id: Option<String>,
    pub title: Option<String>,
    pub messages: Vec<AgencyMessage>,
    pub state: SessionState,
    pub token_usage: TokenUsage,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub metadata: HashMap<String, Value>,
}

A conversation session

Fields

id: String

Unique session ID

agent_name: String

Associated agent name

user_id: Option<String>

User ID (optional)

title: Option<String>

Session title/name

messages: Vec<AgencyMessage>

Conversation messages

state: SessionState

Session state

token_usage: TokenUsage

Token usage

created_at: DateTime<Utc>

Creation timestamp

updated_at: DateTime<Utc>

Last update timestamp

metadata: HashMap<String, Value>

Custom metadata

Implementations

impl Session

pub fn new(agent_name: impl Into<String>, user_id: Option<String>) -> Self

Create a new session

pub fn add_message(&mut self, message: AgencyMessage)

Add a message to the session

pub fn to_api_messages(&self) -> Vec<Value>

Get messages formatted for model API

pub fn last_messages(&self, n: usize) -> &[AgencyMessage]

Get the last N messages

pub fn clear_messages(&mut self)

Clear messages but keep state

pub fn rewind_to(&mut self, message_id: &str) -> Option<Vec<AgencyMessage>>

Rewind to before a specific message

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.