Module domain_session 

Workspace-side per-session state.

Holds what workspace itself needs: routing metadata (AgentHandle slot, claude-issued session_id), the pending-interaction mailbox, and the facts every view reads through the view surface. The rest of the operational state a view renders (lifecycle, cwd, account info) lives on the view’s own session record.

Two classes are held here rather than folded per view. The turn signal DomainSession::runtime_state is the one the workspace needs authoritatively for its worker-liveness and prompt-interception guards, and DomainSession::background_work, DomainSession::available_commands and DomainSession::available_agents are held so a view arriving late reads them from the core.

Re-exports

use std::collections::HashMap; 🔒

use std::collections::HashSet; 🔒

use std::sync::Arc; 🔒

use forge_agent::AgentHandle; 🔒

use forge_primitives::AvailableAgent; 🔒

use forge_primitives::AvailableCommand; 🔒

use forge_primitives::AvailableModel; 🔒

use forge_primitives::CurrentModel; 🔒

use forge_primitives::EffortLevel; 🔒

use forge_primitives::McpServerStatus; 🔒

use forge_primitives::MonitorRecord; 🔒

use forge_primitives::PermissionMode; 🔒

use forge_primitives::RuntimeSessionState; 🔒

use forge_primitives::SessionId; 🔒

use crate::SessionSlot; 🔒

use crate::protocol::PendingInteractionSlot; 🔒

Structs

ContextUsage

How full the session’s context window is, from the bridge’s last answer. Both halves are Option because the upstream probe reports them independently.

DomainSession

HandoffState

The handoff this session is running, if any.

McpServers

The MCP servers a session’s bridge last reported, and the failure standing beside them when the read did not complete.

PendingAutoContinue

A continuation the failure left behind: the words the model will receive, taken by the fire as soon as the failed turn is folded.

PendingInteractions

The interactions a seat is parked on, oldest first.

Enums

TurnLiveness

What one frame says about whether a turn is open, when it says anything.

Constants

EFFORT_LEVEL_KEY 🔒

The CLI settings key a session’s effort is stamped under. One const, so the writer and this reader cannot split the seam.

SETTLED_STATES 🔒

Workspace’s owned per-session state. One DomainSession per active SessionTask. Single writer (the SessionTask); accessed via Arc<parking_lot::Mutex<DomainSession>> so the Workspace can route commands without locking the whole pool. The lifecycle states that settle a queued row.

Functions

configured_effort_from_settings 🔒

The effort level a spawn asked for, read back from the launch settings forge stamps for the CLI.

configured_permission_mode_from_settings 🔒

The mode a spawn asked for, read back from the same launch settings the effort comes from.

liveness_of

What one message says about a turn’s liveness, or None where it says nothing.