Struct SessionGovernor 

pub struct SessionGovernor { /* private fields */ }

Implementations

impl SessionGovernor

pub fn new(config: SessionConfig) -> Self

pub fn with_digest(self, digest_config: DigestConfig) -> Self

pub fn with_learning( self, learning_config: LearningConfig, skills_dir: PathBuf, ) -> Self

pub fn tick(&self, db: &Database) -> Result<usize>

Run a single maintenance tick: expire stale sessions based on TTL. Returns the number of sessions actually expired.

pub fn spawn( &self, db: &Database, agent_id: &str, scope: Option<&SessionScope>, ) -> Result<String>

Spawn a new scoped session for the given agent, returning the session id.

pub fn rotate_agent_scope_sessions( &self, db: &Database, agent_id: &str, ) -> Result<usize>

Rotate active agent-scope sessions by archiving them and creating a new active session for the same agent.

pub fn diagnose_retrieval_health(&self, db: &Database) -> String

Return a human-readable report on retrieval-memory health.

The mechanic can call this to decide whether the hygiene thresholds in LearningConfig need adjusting — no auto-tuning, just data.