Struct SessionDeadline 

pub struct SessionDeadline { /* private fields */ }

A session’s absolute deadline. Immutable after construction, so it is shared as Arc<SessionDeadline> with no lock.

Implementations

impl SessionDeadline

pub fn new(max_wall_secs: Option<u64>) -> Self

Start the clock. None disables the ceiling entirely.

pub fn shared_default() -> Arc<Self>

The default ceiling, as a shared handle ready to thread down the ladder.

pub fn unlimited() -> Arc<Self>

No ceiling. For callers that impose their own bound.

pub fn admit(&self) -> Option<String>

Whether another iteration may begin. None admits; Some(reason) denies, with text meant for a human and for LoopOutcome.error.

pub fn remaining_secs(&self) -> Option<u64>

Seconds left before the deadline, or None when unbounded.

Callers clamp a round’s own timeout to this so admission cannot be followed by a full-length overrun. Saturates at 0 rather than wrapping.

pub fn remaining_duration(&self) -> Option<Duration>

Exact remaining duration. Agent builds use this to cancel an in-flight model/scenario future at the deadline instead of waiting for the next iteration-admission boundary.

pub fn elapsed_secs(&self) -> u64

pub fn elapsed_millis(&self) -> u64

Elapsed wall time in whole milliseconds, for check-result durations.

pub fn max_wall_secs(&self) -> Option<u64>

Configured whole-second ceiling, or None when unlimited.

Trait Implementations

impl Debug for SessionDeadline

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

Formats the value using the given formatter.