Struct LspSessionPool 

pub struct LspSessionPool { /* private fields */ }

Implementations

impl LspSessionPool

pub fn new(project: ProjectRoot) -> Self

pub fn reset(&self, project: ProjectRoot) -> Self

Replace the project root and close all existing sessions.

pub fn shutdown(&self)

Shutdown all active LSP sessions in this pool by dropping them.

pub fn session_count(&self) -> usize

pub fn has_warm_session(&self, command: &str, args: &[String]) -> bool

Non-spawning warmth probe for the latency-sensitive default reference path. Returns true only when a live LSP session for command+args is already resident (child process still running). It never spawns a server — a cold or absent language returns false and leaves the pool untouched, so callers can gate precise LSP routing on warmth without risking a 2-30s cold start. Stale (exited) sessions are reaped as a side effect, mirroring ensure_session.

pub fn prewarm_session(&self, command: &str, args: &[String]) -> Result<()>

Spawn-and-initialize a session so later default-path calls find it warm (P1.3 pre-warm pool). Idempotent: an already-live session is a no-op. Runs the full spawn+initialize handshake, so callers should invoke this from a background thread — never on a bind/request hot path. Command whitelisting is enforced by ensure_session.

pub fn warm_session_quiescence( &self, command: &str, args: &[String], ) -> Option<Option<bool>>

Readiness of a warm session (P1.1): outer None = no live session for this server; Some(None) = live but the server never emitted a readiness signal (unknown — do NOT assume ready); Some(Some(q)) = the server’s latest experimental/serverStatus quiescence state. Warm ≠ quiescent: confidence calibration must treat Some(Some(false)) (still indexing) as degraded evidence.

pub fn find_referencing_symbols( &self, request: &LspRequest, ) -> Result<Vec<LspReference>>

pub fn find_referencing_symbols_tracking_spawn( &self, request: &LspRequest, ) -> Result<(Vec<LspReference>, bool)>

Same as [find_referencing_symbols], but also reports whether this call had to spawn the LSP server (a cold start). false means an already-resident warm session was reused. The warmth check and the spawn decision happen under the same lock, so the flag is race-free for this call: a caller that gated on an earlier has_warm_session probe can use it to detect the rare TOCTOU case where the server died between the probe and this request and had to be respawned mid-flight. Routing is unchanged — the flag only lets the caller describe what happened.

pub fn get_diagnostics( &self, request: &LspDiagnosticRequest, ) -> Result<Vec<LspDiagnostic>>

pub fn search_workspace_symbols( &self, request: &LspWorkspaceSymbolRequest, ) -> Result<Vec<LspWorkspaceSymbol>>

pub fn get_type_hierarchy( &self, request: &LspTypeHierarchyRequest, ) -> Result<HashMap<String, Value>>

pub fn resolve_symbol_target( &self, request: &LspResolveTargetRequest, ) -> Result<Vec<LspResolvedTarget>>

pub fn get_rename_plan( &self, request: &LspRenamePlanRequest, ) -> Result<LspRenamePlan>

pub fn rename_symbol(&self, request: &LspRenameRequest) -> Result<RenameResult>

pub fn rename_symbol_transaction( &self, request: &LspRenameRequest, ) -> Result<LspWorkspaceEditTransaction>

pub fn code_action_refactor( &self, request: &LspCodeActionRequest, ) -> Result<LspCodeActionRefactorResult>

pub fn code_action_refactor_plan( &self, request: &LspCodeActionRequest, ) -> Result<LspCodeActionRefactorPlan>