Struct LspDaemon 

pub struct LspDaemon { /* private fields */ }

The daemon runtime that manages language server processes and multiplexes client connections.

LspDaemon listens on a Unix domain socket and routes LSP requests from multiple LspClient connections to the appropriate language server subprocess. Language servers are spawned on demand and shared across clients working in the same workspace.

Usage

use aether_lspd::LspDaemon;
use std::path::PathBuf;
use std::time::Duration;

let daemon = LspDaemon::new(
    PathBuf::from("/tmp/aether-lspd-1000/lsp-rust-abc123.sock"),
    Some(Duration::from_secs(300)),
);
daemon.run().await?;

Lifecycle

1. Bind – Acquires a lockfile and binds the Unix socket.
2. Listen – Accepts client connections and spawns a handler task per client.
3. Shutdown – Triggered by any of: SIGTERM/SIGINT, idle timeout, or all workspace roots being deleted from disk. On shutdown the daemon stops all language servers and removes the socket file.

Idle timeout

When idle_timeout is Some, the daemon shuts down after the specified duration with zero connected clients. Activity resets whenever a client connects or disconnects.

Workspace liveness

The daemon periodically checks whether the workspace directories it manages still exist on disk. If every registered workspace root has been deleted, the daemon shuts down automatically.

Implementations

impl LspDaemon

pub fn new(socket_path: PathBuf, idle_timeout: Option<Duration>) -> Self

Create a daemon with socket and idle-timeout settings.

pub async fn run(self) -> DaemonResult<()>

Run the daemon until shutdown.