Struct Session 

pub struct Session { /* private fields */ }

A bounded context for agent operations.

Sessions provide:

• Traceability: All events link to a session
• Time bounds: Sessions expire after max_duration
• Depth limits: Prevents runaway agent spawning
• Scope: Session-level capability constraints

Implementations

impl Session

pub const DEFAULT_MAX_DEPTH: u32 = 10

Default maximum depth for causal chains.

pub const DEFAULT_MAX_DURATION: Duration

Default maximum session duration (1 hour).

pub fn builder() -> SessionBuilder

Create a new session builder.

pub fn id(&self) -> SessionId

Get the session ID.

pub fn principal(&self) -> &PrincipalId

Get the principal who initiated this session.

pub fn started_at(&self) -> i64

Get when the session started.

pub fn ended_at(&self) -> Option<i64>

Get when the session ended, if it has.

pub fn max_duration(&self) -> Duration

Get the maximum allowed duration.

pub fn max_depth(&self) -> u32

Get the maximum allowed causal depth.

pub fn capabilities(&self) -> Option<&CapabilitySet>

Get the session-level capabilities (Section 3.2.2).

pub fn purpose(&self) -> &str

Get the session purpose.

pub fn is_active(&self) -> bool

Check if the session is still active (not ended).

pub fn is_expired(&self, current_time: i64) -> bool

Check if the session has expired based on max_duration.

pub fn remaining_duration(&self, current_time: i64) -> Option<Duration>

Get remaining duration before expiry.

Returns None if already expired.

pub fn end( &mut self, current_time: i64, reason: SessionEndReason, ) -> Result<SessionSummary>

End the session.

Errors

Returns error if session is already ended.

pub fn record_event(&mut self)

Record an event in this session.

pub fn record_action(&mut self)

Record an action in this session.

pub fn hash(&self) -> Hash

Compute a unique hash for this session.

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.