walrus-core 0.0.10

Core types and traits for the Walrus agent runtime
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

//! Session — lightweight history container for agent conversations.

use std::time::Instant;

use crate::model::Message;

/// A conversation session tied to a specific agent.
///
/// Sessions own the conversation history and are stored behind
/// `Arc<Mutex<Session>>` in the runtime. Multiple sessions can
/// reference the same agent — each with independent history.
#[derive(Debug, Clone)]
pub struct Session {
    /// Unique session identifier (monotonic counter).
    pub id: u64,
    /// Name of the agent this session is bound to.
    pub agent: String,
    /// Conversation history (user/assistant/tool messages).
    pub history: Vec<Message>,
    /// Origin of this session (e.g. "user", "telegram:12345", agent name).
    pub created_by: String,
    /// When this session was created.
    pub created_at: Instant,
}

impl Session {
    /// Create a new session with an empty history.
    pub fn new(id: u64, agent: impl Into<String>, created_by: impl Into<String>) -> Self {
        Self {
            id,
            agent: agent.into(),
            history: Vec::new(),
            created_by: created_by.into(),
            created_at: Instant::now(),
        }
    }
}