Struct SessionActorHandle 

pub struct SessionActorHandle {
    pub tx: Sender<SessionCommand>,
    pub tx_out: Sender<SessionOutput>,
    pub last_active: Instant,
    pub cancel: CancellationToken,
    pub resume_banner_sent: Arc<AtomicBool>,
    pub pending_resume_banner: Option<Arc<str>>,
}

Bookkeeping handle for one live session, held by LiveSessionRegistry (spec §9.3).

Cheap to clone — tx/tx_out are Arc-backed channel senders.

Fields

tx: Sender<SessionCommand>

Mailbox for SessionCommands; same-session prompts are serialized by this mpsc’s FIFO ordering (spec §9.2 concurrency policy — no separate turn-lock needed).

tx_out: Sender<SessionOutput>

Broadcast source new subscribers (SSE connections, TUI attach) subscribe to.

last_active: Instant

Updated by LiveSessionRegistry::get on every lookup; read by LiveSessionRegistry::idle_candidates for TTL eviction.

cancel: CancellationToken

Cancelling this token ends exactly this session’s actor gracefully — the same effect as sending SessionCommand::Shutdown, but usable without an owned mpsc permit. What serve.evict idle eviction (spec §9.3) calls to target one session without affecting any other live actor. Distinct from the process-wide TaskSupervisor cancellation token.

resume_banner_sent: Arc<AtomicBool>

Resume-banner single-emission guard (spec-068 §13.5, AC-24): when more than one display-owning channel attaches to the same live session, exactly one attach must render the banner. Arc-shared across every Clone of this handle so all attach paths observe the same flag. Use Self::claim_resume_banner rather than reading this directly.

pending_resume_banner: Option<Arc<str>>

Resume-visibility banner text, computed once at session build time (spec-068 §13.5, AC-24) from the session’s replayed history. None when [session.resume] show_banner = false or the session had no prior history to resume. Rendered by exactly one attach path, gated by Self::claim_resume_banner — see GET /sessions/:id/events (events_session_handler, src/serve/handlers.rs) for the sole production consumer.

Implementations

impl SessionActorHandle

pub fn claim_resume_banner(&self) -> bool

Atomically claim the right to render the resume banner for this session.

Returns true for exactly one caller across all attach paths sharing this handle (via Clone) — that caller renders the banner; every other caller (this attach or any subsequent one) gets false and must render nothing (spec-068 §13.5, AC-24).

Trait Implementations

impl Clone for SessionActorHandle

fn clone(&self) -> SessionActorHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.