Struct HostSession 

pub struct HostSession { /* private fields */ }

One open conversation on a long-lived host.

Implementations

impl HostSession

pub fn new(run: PreparedRun, approval: SessionApproval) -> Self

Opens a session with the approval state its host presents.

pub fn agent_id(&self) -> &str

The persisted conversation id for this session: mentra’s agent id.

pub fn approval(&self) -> &SessionApproval

This conversation’s approval state, shared with its active turn.

pub async fn lock_turn(&self) -> MutexGuard<'_, PreparedRun>

Takes the turn lock. Held until the returned guard drops.

pub fn begin_turn(&self) -> TurnOptions

Arms a fresh cancellation token for a turn about to start.

pub fn interrupt(&self) -> Option<Interrupt>

The interrupt armed for the turn in flight, for whatever is about to wait on the client on that turn’s behalf. None between turns.

pub fn end_turn(&self)

Disarms after a turn ends, so a late session/cancel cannot cancel the next turn.

pub fn cancel(&self) -> bool

Trips the in-flight turn’s token and wakes anything waiting on the client for it. false when no turn is running.

Trait Implementations

impl Clone for HostSession

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.