Struct TuiRegistry 

pub struct TuiRegistry { /* private fields */ }

Daemon-wide registry of connected TUI clients. Source of truth for live TUI connection state. Not persisted — rebuilt on each daemon start from incoming initialize handshakes.

Implementations

impl TuiRegistry

pub fn new(config_dir: &Path) -> Self

Create a registry, attempting to load the signing key from <config_dir>/.secret_key. If the file is missing or unreadable, signing is silently disabled.

pub fn signing_is_enabled(&self) -> bool

Whether HMAC signing is enabled (.secret_key was loaded).

pub fn generate_tui_id() -> String

Generate a short TUI ID: tui_ + 8 hex chars (4 random bytes).

pub fn generate_unique_tui_id(&self) -> String

Generate a TUI ID that is not currently in the registry.

pub fn sign(&self, tui_id: &str) -> Option<String>

Sign a TUI ID with HMAC-SHA256. Returns None if signing is disabled.

pub fn verify(&self, tui_id: &str, sig: &str) -> bool

Verify a TUI ID + signature. Returns true if:

• Signing is disabled (trust all), OR
• The signature is valid.

pub fn register(&self, entry: TuiEntry) -> TuiEpoch

Register a connected TUI, displacing any earlier registration of the same id. Returns the epoch this registration owns; the caller must quote it back to Self::unregister so a late teardown cannot evict a successor.

pub fn unregister(&self, tui_id: &str, epoch: TuiEpoch)

Unregister a disconnected TUI, but ONLY while epoch is still the live registration for that id.

A reconnect adopts the same id under a new epoch, and the displaced connection’s teardown can run at any point after that — it may still be draining, or parked in a bounded write. Removing by key alone would let that late teardown evict the connection that replaced it.

pub fn list(&self) -> Vec<TuiEntry>

Snapshot of all connected TUIs.

pub fn get_env(&self, tui_id: &str) -> Option<HashMap<String, String>>

Return a clone of the environment captured from the TUI identified by tui_id, or None if the TUI is not currently connected.