Struct SessionsService 

pub struct SessionsService { /* private fields */ }

Hosts the cross-window SessionsRegistry as a DaemonService.

Implementations

impl SessionsService

pub fn new() -> Self

Creates the service with an empty registry. Cheap — no I/O and no task; the daemon calls start_watcher to begin the transcript watcher, while tests use the bare service.

pub fn with_journal_dir(self, dir: PathBuf) -> Self

Reads the hook journals under dir (see crate::sessions::journal): replayed at startup and tailed while the daemon runs, once start_watcher starts the task.

pub fn start_watcher(&self)

Starts the engine-owned transcript watcher (Feed 2): a background task that scans ~/.claude/projects/**/*.jsonl for new/growing transcripts and feeds the registry, so a session started before the daemon — or working through the hook-silent thinking window — is still discovered and marked active. Alongside it runs the Codex rollout watcher (#1909), which discovers Codex sessions from $CODEX_HOME/sessions/ and ends archived or killed ones. Idempotent, and a no-op outside a tokio runtime (mirroring the worktrees menu-refresh and Snowflake keep-alive tasks), so unit tests that build a bare service start no watcher.

Trait Implementations

impl DaemonService for SessionsService

fn name(&self) -> &'static str

Stable identifier used to route control-socket envelopes to this service (the envelope’s service field) and to label its status/menu.

fn handle<'life0, 'life1, 'async_trait>( &'life0 self, op: &'life1 str, payload: Value, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Handles an operation routed to this service, returning a JSON payload.

fn subscribe( &self, op: &str, _payload: &Value, ) -> Option<Box<dyn ServiceStream>>

Opens a push subscription for a streaming op, or returns None when op is not one this service streams (the default for every service).

fn menu(&self) -> MenuSnapshot

Cheap snapshot of the service’s tray submenu, polled by the menu-bar shell. Must not block.

fn menu_action<'life0, 'life1, 'async_trait>( &'life0 self, action_id: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<()>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait,

Performs a tray menu action previously surfaced by menu, identified by its MenuAction::id.

fn status<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ServiceStatus> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Structured status for daemon status aggregation.

fn credit_accept_outage(&self, outage: Duration)

Told that the control socket could not accept connections for outage (descriptor exhaustion, #2111), so no client could have reached this service for that long.

fn shutdown<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = ()> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Gracefully stops the service, draining in-flight work. Called once on daemon shutdown.

impl Default for SessionsService

fn default() -> Self

Returns the “default value” for a type.