aether-lspd 0.1.10

LSP daemon for sharing language servers across multiple agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

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`](crate::LspClient) connections to the appropriate language server subprocess. Language servers are spawned on demand and shared across clients working in the same workspace.

# Usage

```rust,no_run
use aether_lspd::LspDaemon;
use std::path::PathBuf;
use std::time::Duration;

# async fn example() -> aether_lspd::DaemonResult<()> {
let daemon = LspDaemon::new(
    PathBuf::from("/tmp/aether-lspd-1000/lsp-rust-abc123.sock"),
    Some(Duration::from_secs(300)),
);
daemon.run().await?;
# Ok(())
# }
```

# 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.