@sema-ai/core 1.275.1

package/dist/engine/lsp/frame-decoder.js

@@ -0,0 +1,53 @@
+/**
+ * LSP base-protocol framing over a byte stream (stdio) — `Content-Length: <n>\r\n\r\n<n bytes of JSON>`. A
+ * language server speaks JSON-RPC over stdin/stdout with THIS framing (the part a WebSocket transport skips,
+ * since each WS message is already one message). Ported 1:1 from service's unit-tested `lsp-frames` bridge
+ * decoder + CC's `StreamMessageReader`/`StreamMessageWriter` (vscode-jsonrpc) — hand-rolled here to keep core
+ * dependency-free (the framing is trivial; a native LSP-client dep is not worth it).
+ */
+/** Encode a JSON-RPC message body as an LSP base-protocol frame (header + payload) ready to write to stdin. */
+export function encodeFrame(json) {
+    const payload = Buffer.from(json, "utf8");
+    return Buffer.concat([Buffer.from(`Content-Length: ${payload.length}\r\n\r\n`, "ascii"), payload]);
+}
+/**
+ * A stateful decoder: feed it stdout chunks, get back complete JSON payloads (0+ per chunk — a frame can span
+ * chunks, and a chunk can hold several). `maxBytes` caps the buffer so a server that never emits a delimiter
+ * (or a corrupt Content-Length) can't grow it unboundedly — on overflow the buffer is dropped (fail-safe).
+ */
+export function makeFrameDecoder(maxBytes = 50 * 1024 * 1024) {
+    const HEADER_SLACK = 128; // room for "Content-Length: <n>\r\n\r\n" ON TOP of a max-size payload
+    let buf = Buffer.alloc(0);
+    return function decode(chunk) {
+        const frames = [];
+        buf = Buffer.concat([buf, chunk]);
+        // Cap at max PAYLOAD + header slack (not just maxBytes): a runaway/no-delimiter stream is still dropped, but a
+        // valid frame whose payload passes the `len <= maxBytes` check below now always fits here first — otherwise a
+        // frame with a near-maxBytes payload (header pushes header+payload over maxBytes) was wiped mid-arrival and
+        // could never complete, silently dropping a valid reply.
+        if (buf.length > maxBytes + HEADER_SLACK)
+            buf = Buffer.alloc(0);
+        for (;;) {
+            const he = buf.indexOf("\r\n\r\n");
+            if (he === -1)
+                break;
+            const m = /Content-Length:\s*(\d+)/i.exec(buf.subarray(0, he).toString("ascii"));
+            if (!m) {
+                buf = buf.subarray(he + 4);
+                continue;
+            }
+            const len = Number(m[1]);
+            if (!Number.isFinite(len) || len < 0 || len > maxBytes) {
+                buf = buf.subarray(he + 4);
+                continue; // skip a bad frame header rather than deadlock
+            }
+            const start = he + 4;
+            if (buf.length < start + len)
+                break; // wait for the rest of this frame
+            frames.push(buf.subarray(start, start + len).toString("utf8"));
+            buf = buf.subarray(start + len);
+        }
+        return frames;
+    };
+}
+//# sourceMappingURL=frame-decoder.js.map

package/dist/engine/lsp/frame-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame-decoder.js","sourceRoot":"","sources":["../../../src/engine/lsp/frame-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,+GAA+G;AAC/G,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,OAAO,CAAC,MAAM,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACrG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAQ,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;IAC1D,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,sEAAsE;IAChG,IAAI,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1B,OAAO,SAAS,MAAM,CAAC,KAAa;QAClC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAClC,+GAA+G;QAC/G,8GAA8G;QAC9G,4GAA4G;QAC5G,yDAAyD;QACzD,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ,GAAG,YAAY;YAAE,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAChE,SAAS,CAAC;YACR,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YACnC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAAE,MAAM;YACrB,MAAM,CAAC,GAAG,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACjF,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC3B,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,QAAQ,EAAE,CAAC;gBACvD,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBAC3B,SAAS,CAAC,+CAA+C;YAC3D,CAAC;YACD,MAAM,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;YACrB,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,GAAG,GAAG;gBAAE,MAAM,CAAC,kCAAkC;YACvE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/D,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/engine/lsp/node-lsp-manager.d.ts

@@ -0,0 +1,105 @@
+import { type SessionWarmup } from "../../core/lsp-session.js";
+import { type LspChildProcess } from "./stdio-lsp-transport.js";
+import type { LspServerManager, LspSession, LspReadText } from "../../core/lsp.js";
+import type { ExecutionEnv } from "../../internal/harness.js";
+/**
+ * Default language → server command table (the DETERMINED supported set). Each value is a `command [args…]`
+ * whose binary must be on the host `PATH`; absent ⇒ that language degrades. Mirrors the servers service bakes
+ * into its sandbox templates (so TOC & TOB expose the SAME languages when installed), plus the common
+ * rust/c/cpp servers a local dev box usually has. Override/extend via {@link NodeLspManagerOptions.servers}
+ * (a `null` value disables a language). All of these speak LSP over stdio by default.
+ */
+export declare const DEFAULT_LSP_SERVERS: Readonly<Record<string, string>>;
+/** Spawn a child (default). Resolves the child on a successful `spawn`, or `undefined` on `error` (ENOENT =
+ *  server not installed → the manager degrades that language). Waiting for the 'spawn'/'error' race before use
+ *  is CRITICAL: `spawn()` returns synchronously but ENOENT fires 'error' asynchronously (CC's LSPClient §1.5). */
+export type LspSpawn = (command: string, args: string[], cwd: string, signal?: AbortSignal) => Promise<LspChildProcess | undefined>;
+export interface NodeLspManagerOptions {
+    /** Override/extend {@link DEFAULT_LSP_SERVERS} (merged over it; a `null` value disables that language). */
+    servers?: Record<string, string | null>;
+    /** Injectable spawn (tests supply a fake server; default = {@link defaultLspSpawn} over `child_process.spawn`). */
+    spawn?: LspSpawn;
+    /** Read a file's CURRENT text for the session's didOpen/didChange re-sync (default = local `fs.readFile` utf8). */
+    readText?: LspReadText;
+    /** Resolve the server `cwd`/`rootUri` for a file (default = env.cwd ?? nearest project marker ?? file dir). */
+    resolveRoot?: (filePath: string, env?: ExecutionEnv) => string;
+    /** Observability hook (open/heal/degrade/evict events). */
+    log?: (event: string, fields: Record<string, unknown>) => void;
+    /** Warm-up window override (see {@link TransportLspSession}); default 10s/1s. */
+    warmup?: SessionWarmup;
+    /** Max concurrently-cached language servers before LRU eviction (default 16, min 1). A safety net bounding
+     *  the cache when a deployment can't call {@link NodeLspManager.evict} at task-end (e.g. ephemeral/worktree
+     *  roots). Each cached server is a real process (jdtls = a JVM), so keep this modest. */
+    maxSessions?: number;
+    /** Idle-TTL (ms) after which an unused server is auto-reclaimed by a background sweep (default 600_000 = 10
+     *  min; 0 disables). Self-healing complement to {@link NodeLspManager.evict}: a deployment that can't call
+     *  `evict` at task-end still won't leak — an abandoned server dies on its own. An actively reused server never
+     *  goes idle (its last-used stamp refreshes on every lookup), so a modest TTL doesn't churn the happy path. */
+    idleTtlMs?: number;
+    /** design/121: the workspace diagnostics registry every session feeds from publishDiagnostics.
+     *  WORKSPACE-scoped, not server-scoped — it survives heal/evict (diagnostics belong to files, not to a
+     *  server instance). Absent ⇒ notifications stay dropped (pre-121 behavior byte-for-byte). */
+    diagnostics?: import("../../core/lsp-diagnostics.js").LspDiagnosticsRegistry;
+}
+export declare class NodeLspManager implements LspServerManager {
+    private readonly servers;
+    private readonly spawnFn;
+    private readonly readTextFn;
+    private readonly resolveRootFn;
+    private readonly log;
+    private readonly warmup?;
+    /** design/121: the workspace diagnostics registry (see {@link NodeLspManagerOptions.diagnostics}) —
+     *  public so the Runner drains it at turn boundaries via {@link LspServerManager.diagnostics}. */
+    readonly diagnostics: import("../../core/lsp-diagnostics.js").LspDiagnosticsRegistry;
+    private readonly maxSessions;
+    private readonly idleTtlMs;
+    private sweepTimer?;
+    /** `<language> <root>` → the live session + its root + last-used stamp (reused across ops; healed when its
+     *  transport dies; idle-TTL swept; LRU-evicted over {@link maxSessions}; `evict(root)` drops a task's servers
+     *  at task-end). Space-separated key is unambiguous — a languageId never contains a space. */
+    private readonly cache;
+    /** In-flight opens (concurrent ops on the same language+root share ONE spawn/initialize). Tracks each open's
+     *  `root` + a `cancelled` flag so {@link evict}/{@link dispose} can reclaim a server whose open resolves AFTER
+     *  the teardown already ran (else its `.then` caches a live child that nothing reclaims — permanently after
+     *  dispose, since the sweep timer is cleared). */
+    private readonly opening;
+    /** Set by {@link dispose}: an in-flight open that resolves after dispose self-closes instead of caching. */
+    private disposed;
+    constructor(opts?: NodeLspManagerOptions);
+    /** Close + drop every server idle past {@link idleTtlMs}. Runs on a timer; best-effort. */
+    private sweepIdle;
+    sessionFor(filePath: string, signal?: AbortSignal, env?: ExecutionEnv): Promise<LspSession | undefined>;
+    /** Spawn + initialize a fresh session for `key`, deduping concurrent opens. */
+    private open;
+    /** LRU-evict (close) the least-recently-used server(s) until there is room for one more under {@link maxSessions}.
+     *  A safety net: without an explicit {@link evict}, a long-lived process spawning tasks with EPHEMERAL roots
+     *  (worktree / per-task cwd) would otherwise leak one heavyweight language server per (task × language). */
+    private evictOverCap;
+    /**
+     * Evict + kill every cached language server rooted at `root`. Call this at TASK-END for an ephemeral/worktree
+     * cwd so a heavyweight server (e.g. a jdtls JVM) doesn't outlive the task that spawned it — the deterministic
+     * complement to the LRU cap. `root` must match what `resolveRoot` produced for the task (the host lane uses the
+     * task's `env.cwd`). Best-effort + idempotent (an unknown/already-evicted root is a no-op).
+     */
+    evict(root: string): Promise<void>;
+    private openSession;
+    private serverCmd;
+    /** Kill every running server + stop the idle sweep (call on runner/deployment shutdown). Best-effort. */
+    dispose(): Promise<void>;
+}
+/** Resolve a file path to a languageId via its extension (undefined = no mapping → degrade). */
+export declare function languageFor(filePath: string): string | undefined;
+/** service [377] ask ②: on Windows, npm-global language servers materialize as `.cmd` shims and
+ *  Node 20+ `spawn(cmd, args)` without a shell rejects them (EINVAL, CVE-2024-27980 hardening) —
+ *  every DEFAULT_LSP_SERVERS entry would silently degrade to "no LSP". `shell:true` routes through
+ *  cmd.exe so PATHEXT/.cmd resolution works. Injection surface: `command`/`args` come from
+ *  LspServerSpec (deployment configuration, trusted) or DEFAULT_LSP_SERVERS constants — never from
+ *  the model. Exported as a pure function so the win32 branch is testable off-platform. */
+export declare function lspSpawnOptions(cwd: string): {
+    cwd: string;
+    stdio: ["pipe", "pipe", "ignore"];
+    shell?: boolean;
+};
+/** Default spawn over `child_process.spawn`, resolving on 'spawn' / `undefined` on 'error' (ENOENT = degrade). */
+export declare const defaultLspSpawn: LspSpawn;
+//# sourceMappingURL=node-lsp-manager.d.ts.map

package/dist/engine/lsp/node-lsp-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-lsp-manager.d.ts","sourceRoot":"","sources":["../../../src/engine/lsp/node-lsp-manager.ts"],"names":[],"mappings":"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"}

package/dist/engine/lsp/node-lsp-manager.js

@@ -0,0 +1,343 @@
+/**
+ * `NodeLspManager` — the TOC (local, non-sandbox) {@link LspServerManager}: spawns a real language server on the
+ * LOCAL host via `child_process` and speaks LSP JSON-RPC over its stdio, a faithful copy of CC's
+ * `services/lsp/manager` + `LSPClient`. The remote (TOB) lane runs the server INSIDE a sandbox behind a WS
+ * bridge (service's E2B/kata manager) because the base `execStream` seam is output-only; this local lane has no
+ * such limit — Node's `child_process` gives full duplex stdio, so it drives the server directly.
+ *
+ * Protocol logic (op-map, file-sync, warm-up, heal) is core-single-sourced ({@link TransportLspSession}); this
+ * file adds only the local wiring: language→command registry, spawn, the `initialize` handshake, and a
+ * per-(language,root) session cache with heal-on-death. Servers are NOT bundled — the binary must be on the
+ * host `PATH` (same contract as CC); a missing server degrades that language gracefully (the `LSP` tool then
+ * tells the model to fall back to Grep/Read).
+ */
+import { spawn } from "node:child_process";
+import { killProcessTree } from "../execution-env/kill-tree.js";
+import { readFile } from "node:fs/promises";
+import { dirname, extname, resolve as resolvePath } from "node:path";
+import { existsSync } from "node:fs";
+import { pathToUri } from "../../core/lsp-protocol.js";
+import { LspDiagnosticsRegistry } from "../../core/lsp-diagnostics.js";
+import { TransportLspSession } from "../../core/lsp-session.js";
+import { StdioLspTransport } from "./stdio-lsp-transport.js";
+/**
+ * Default language → server command table (the DETERMINED supported set). Each value is a `command [args…]`
+ * whose binary must be on the host `PATH`; absent ⇒ that language degrades. Mirrors the servers service bakes
+ * into its sandbox templates (so TOC & TOB expose the SAME languages when installed), plus the common
+ * rust/c/cpp servers a local dev box usually has. Override/extend via {@link NodeLspManagerOptions.servers}
+ * (a `null` value disables a language). All of these speak LSP over stdio by default.
+ */
+export const DEFAULT_LSP_SERVERS = {
+    typescript: "typescript-language-server --stdio",
+    javascript: "typescript-language-server --stdio",
+    python: "pyright-langserver --stdio",
+    go: "gopls",
+    rust: "rust-analyzer",
+    dart: "dart language-server",
+    kotlin: "kotlin-language-server",
+    java: "jdtls",
+    swift: "sourcekit-lsp",
+    c: "clangd",
+    cpp: "clangd",
+};
+/** File extension → languageId (drives which server a path resolves to). */
+const EXT_LANG = {
+    ".ts": "typescript", ".tsx": "typescript", ".mts": "typescript", ".cts": "typescript",
+    ".js": "javascript", ".jsx": "javascript", ".mjs": "javascript", ".cjs": "javascript",
+    ".py": "python", ".pyi": "python",
+    ".go": "go",
+    ".rs": "rust",
+    ".dart": "dart",
+    ".kt": "kotlin", ".kts": "kotlin",
+    ".java": "java",
+    ".swift": "swift",
+    ".c": "c", ".h": "c",
+    ".cc": "cpp", ".cpp": "cpp", ".cxx": "cpp", ".hpp": "cpp", ".hh": "cpp", ".hxx": "cpp",
+};
+/** Project-root markers, checked walking UP from a file to pick the language server's `cwd`/`rootUri`. */
+const ROOT_MARKERS = [
+    "package.json", "tsconfig.json", "jsconfig.json", "go.mod", "Cargo.toml", "pubspec.yaml",
+    "build.gradle", "build.gradle.kts", "settings.gradle", "settings.gradle.kts", "pom.xml",
+    "Package.swift", "pyproject.toml", "setup.py", "requirements.txt", "compile_commands.json", ".git",
+];
+/** The `initialize` client capabilities — the ops core's `LSP` tool exposes (mirrors service's handshake).
+ *  design/121: `publishDiagnostics` declares we accept pushed diagnostics (harmless when no registry is
+ *  wired — the transport drops undispatched notifications, exactly as before). */
+const CLIENT_CAPABILITIES = {
+    textDocument: {
+        definition: {}, references: {}, hover: {}, documentSymbol: {}, implementation: {}, callHierarchy: {},
+        publishDiagnostics: { versionSupport: true },
+    },
+    workspace: { symbol: {} },
+};
+export class NodeLspManager {
+    servers;
+    spawnFn;
+    readTextFn;
+    resolveRootFn;
+    log;
+    warmup;
+    /** design/121: the workspace diagnostics registry (see {@link NodeLspManagerOptions.diagnostics}) —
+     *  public so the Runner drains it at turn boundaries via {@link LspServerManager.diagnostics}. */
+    diagnostics;
+    maxSessions;
+    idleTtlMs;
+    sweepTimer;
+    /** `<language> <root>` → the live session + its root + last-used stamp (reused across ops; healed when its
+     *  transport dies; idle-TTL swept; LRU-evicted over {@link maxSessions}; `evict(root)` drops a task's servers
+     *  at task-end). Space-separated key is unambiguous — a languageId never contains a space. */
+    cache = new Map();
+    /** In-flight opens (concurrent ops on the same language+root share ONE spawn/initialize). Tracks each open's
+     *  `root` + a `cancelled` flag so {@link evict}/{@link dispose} can reclaim a server whose open resolves AFTER
+     *  the teardown already ran (else its `.then` caches a live child that nothing reclaims — permanently after
+     *  dispose, since the sweep timer is cleared). */
+    opening = new Map();
+    /** Set by {@link dispose}: an in-flight open that resolves after dispose self-closes instead of caching. */
+    disposed = false;
+    constructor(opts = {}) {
+        this.servers = { ...DEFAULT_LSP_SERVERS, ...opts.servers };
+        this.spawnFn = opts.spawn ?? defaultLspSpawn;
+        this.readTextFn = opts.readText ?? ((fp) => readFile(fp, "utf8"));
+        this.resolveRootFn = opts.resolveRoot ?? defaultResolveRoot;
+        this.log = opts.log ?? (() => { });
+        this.warmup = opts.warmup;
+        this.diagnostics = opts.diagnostics ?? new LspDiagnosticsRegistry();
+        this.maxSessions = Math.max(1, opts.maxSessions ?? 16);
+        this.idleTtlMs = Math.max(0, opts.idleTtlMs ?? 600_000); // 10 min; 0 disables
+        if (this.idleTtlMs > 0) {
+            // Self-healing safety net: reclaim a server left idle past the TTL (e.g. an ephemeral/worktree task that
+            // ended and never called `evict`) WITHOUT the deployment having to plumb per-task eviction. An actively
+            // reused server never goes idle (its `lastUsed` refreshes on every cache-hit), so this only kills truly
+            // abandoned servers. Unref'd so it never keeps the process alive; cleared in `dispose()`.
+            this.sweepTimer = setInterval(() => void this.sweepIdle(), Math.min(this.idleTtlMs, 60_000));
+            this.sweepTimer.unref?.();
+        }
+    }
+    /** Close + drop every server idle past {@link idleTtlMs}. Runs on a timer; best-effort. */
+    sweepIdle() {
+        const cutoff = Date.now() - this.idleTtlMs;
+        for (const [key, e] of [...this.cache]) {
+            if (e.lastUsed < cutoff) {
+                this.cache.delete(key);
+                this.log("lsp_evict_idle", { key });
+                void e.session.close().catch(() => undefined);
+            }
+        }
+    }
+    async sessionFor(filePath, signal, env) {
+        const language = languageFor(filePath);
+        if (!language || !this.serverCmd(language))
+            return undefined; // unsupported language → graceful degrade
+        const root = this.resolveRootFn(filePath, env);
+        const key = `${language} ${root}`;
+        const cached = this.cache.get(key);
+        if (cached && !cached.session.closed) {
+            cached.lastUsed = Date.now(); // freshen for LRU
+            return cached.session;
+        }
+        if (cached) {
+            // Transport died (server crashed / killed) → heal: fresh server, carry over the didOpen'd files so a new
+            // inferred-project server still sees them (else cross-file ops silently degrade to single-file).
+            this.cache.delete(key);
+            const carry = cached.session.openedFiles();
+            this.log("lsp_heal", { language, root, carried: carry.length });
+            const healed = await this.open(key, language, root, signal, env);
+            if (healed && carry.length)
+                await healed.warmOpen(carry, signal).catch(() => undefined);
+            return healed;
+        }
+        return this.open(key, language, root, signal, env);
+    }
+    /** Spawn + initialize a fresh session for `key`, deduping concurrent opens. */
+    open(key, language, root, signal, env) {
+        const inflight = this.opening.get(key);
+        if (inflight)
+            return inflight.job;
+        const entry = { root, cancelled: false, job: undefined };
+        entry.job = this.openSession(language, root, signal, env)
+            .then(async (session) => {
+            if (!session)
+                return undefined;
+            // If the manager was disposed, or this root was evicted, WHILE we were spawning/initializing, don't cache
+            // a live server nobody will reclaim (dispose already cleared the sweep timer) — close it and report none.
+            if (this.disposed || entry.cancelled) {
+                await session.close().catch(() => undefined);
+                return undefined;
+            }
+            this.evictOverCap(); // LRU-bound the cache before inserting the new server
+            this.cache.set(key, { session, root, lastUsed: Date.now() });
+            return session;
+        })
+            .finally(() => this.opening.delete(key));
+        this.opening.set(key, entry);
+        return entry.job;
+    }
+    /** LRU-evict (close) the least-recently-used server(s) until there is room for one more under {@link maxSessions}.
+     *  A safety net: without an explicit {@link evict}, a long-lived process spawning tasks with EPHEMERAL roots
+     *  (worktree / per-task cwd) would otherwise leak one heavyweight language server per (task × language). */
+    evictOverCap() {
+        while (this.cache.size >= this.maxSessions) {
+            let lruKey;
+            let lruTime = Infinity;
+            for (const [k, e] of this.cache) {
+                if (e.lastUsed < lruTime) {
+                    lruTime = e.lastUsed;
+                    lruKey = k;
+                }
+            }
+            if (lruKey === undefined)
+                break;
+            const evicted = this.cache.get(lruKey);
+            this.cache.delete(lruKey);
+            this.log("lsp_evict_lru", { key: lruKey });
+            void evicted.session.close().catch(() => undefined);
+        }
+    }
+    /**
+     * Evict + kill every cached language server rooted at `root`. Call this at TASK-END for an ephemeral/worktree
+     * cwd so a heavyweight server (e.g. a jdtls JVM) doesn't outlive the task that spawned it — the deterministic
+     * complement to the LRU cap. `root` must match what `resolveRoot` produced for the task (the host lane uses the
+     * task's `env.cwd`). Best-effort + idempotent (an unknown/already-evicted root is a no-op).
+     */
+    async evict(root) {
+        const closing = [];
+        for (const [key, e] of [...this.cache]) {
+            if (e.root === root) {
+                this.cache.delete(key);
+                this.log("lsp_evict", { root });
+                closing.push(e.session.close().catch(() => undefined));
+            }
+        }
+        // Also cancel any in-flight open for this root: its `.then` would otherwise cache a LIVE server AFTER this
+        // evict returned (the server would then outlive the task until the idle sweep, or forever if idleTtlMs=0).
+        // Marking `cancelled` makes that `.then` self-close instead; awaiting the job awaits that close.
+        for (const o of this.opening.values()) {
+            if (o.root === root) {
+                o.cancelled = true;
+                closing.push(o.job.then(() => undefined).catch(() => undefined));
+            }
+        }
+        await Promise.all(closing);
+    }
+    async openSession(language, root, signal, _env) {
+        const cmd = this.serverCmd(language);
+        if (!cmd)
+            return undefined;
+        // [K-PLATFORM-SWEEP] MINOR#8: minimal quote-aware tokenizer — a bare \s+ split shredded win32
+        // space-bearing server paths ("C:\\Program Files\\...\\server.exe" --stdio). Double-quoted segments
+        // stay whole; everything else splits on whitespace (config authors quote paths, CC-style).
+        const tokens = (cmd.match(/"[^"]*"|\S+/g) ?? []).map((t) => (t.startsWith('"') && t.endsWith('"') && t.length >= 2 ? t.slice(1, -1) : t));
+        const [command, ...args] = tokens.length > 0 ? tokens : [""];
+        const child = await this.spawnFn(command, args, root, signal).catch(() => undefined);
+        if (!child) {
+            this.log("lsp_spawn_degraded", { language, root, command });
+            return undefined; // not installed / spawn failed → graceful degrade
+        }
+        const transport = new StdioLspTransport(child);
+        try {
+            await transport.request("initialize", { processId: null, rootUri: pathToUri(root), capabilities: CLIENT_CAPABILITIES }, signal);
+            transport.notify("initialized", {});
+        }
+        catch (e) {
+            await transport.close();
+            this.log("lsp_init_degraded", { language, root, err: e instanceof Error ? e.message : String(e) });
+            return undefined;
+        }
+        this.log("lsp_open", { language, root });
+        return new TransportLspSession(transport, language, this.readTextFn, this.log, this.warmup, this.diagnostics);
+    }
+    serverCmd(language) {
+        const cmd = this.servers[language];
+        return cmd ? cmd : undefined; // null (explicitly disabled) or absent → undefined
+    }
+    /** Kill every running server + stop the idle sweep (call on runner/deployment shutdown). Best-effort. */
+    async dispose() {
+        this.disposed = true; // in-flight opens now self-close instead of caching (see open())
+        if (this.sweepTimer)
+            clearInterval(this.sweepTimer);
+        // Await in-flight opens too — with `disposed` set they self-close, but a spawn/initialize racing this dispose
+        // would otherwise resolve AFTER we return and strand a live child (the sweep timer is already cleared).
+        const opening = [...this.opening.values()].map((o) => o.job.catch(() => undefined));
+        const sessions = [...this.cache.values()].map((e) => e.session);
+        this.cache.clear();
+        await Promise.all([...sessions.map((s) => s.close().catch(() => undefined)), ...opening]);
+    }
+}
+/** Resolve a file path to a languageId via its extension (undefined = no mapping → degrade). */
+export function languageFor(filePath) {
+    return EXT_LANG[extname(filePath).toLowerCase()];
+}
+/** Default root: the nearest ancestor dir holding a project marker (walking up from the file), else the env's
+ *  cwd, else the file's own directory. env.cwd wins when present (the runner's workspace is authoritative). */
+function defaultResolveRoot(filePath, env) {
+    if (env?.cwd)
+        return env.cwd;
+    let dir = dirname(resolvePath(filePath));
+    for (;;) {
+        for (const m of ROOT_MARKERS)
+            if (existsSync(resolvePath(dir, m)))
+                return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            break; // reached filesystem root
+        dir = parent;
+    }
+    return dirname(resolvePath(filePath));
+}
+/** service [377] ask ②: on Windows, npm-global language servers materialize as `.cmd` shims and
+ *  Node 20+ `spawn(cmd, args)` without a shell rejects them (EINVAL, CVE-2024-27980 hardening) —
+ *  every DEFAULT_LSP_SERVERS entry would silently degrade to "no LSP". `shell:true` routes through
+ *  cmd.exe so PATHEXT/.cmd resolution works. Injection surface: `command`/`args` come from
+ *  LspServerSpec (deployment configuration, trusted) or DEFAULT_LSP_SERVERS constants — never from
+ *  the model. Exported as a pure function so the win32 branch is testable off-platform. */
+export function lspSpawnOptions(cwd) {
+    return process.platform === "win32"
+        ? { cwd, stdio: ["pipe", "pipe", "ignore"], shell: true }
+        : { cwd, stdio: ["pipe", "pipe", "ignore"] };
+}
+/** Default spawn over `child_process.spawn`, resolving on 'spawn' / `undefined` on 'error' (ENOENT = degrade). */
+export const defaultLspSpawn = (command, args, cwd, signal) => new Promise((resolve) => {
+    let child;
+    try {
+        child = spawn(command, args, lspSpawnOptions(cwd));
+    }
+    catch {
+        return resolve(undefined); // synchronous throw (e.g. bad cwd)
+    }
+    const onSpawn = () => {
+        cleanup();
+        resolve(child);
+    };
+    const onError = () => {
+        cleanup();
+        resolve(undefined); // ENOENT: binary not on PATH → degrade
+    };
+    const onAbort = () => {
+        cleanup();
+        try {
+            // win32 + shell:true: `child` is the cmd.exe shim — kill() alone orphans the actual
+            // language server underneath it; take the tree down (POSIX path byte-identical).
+            if (process.platform === "win32" && child.pid)
+                killProcessTree(child.pid, { force: true });
+            else
+                child.kill();
+        }
+        catch {
+            /* not started */
+        }
+        resolve(undefined);
+    };
+    const cleanup = () => {
+        child.removeListener("spawn", onSpawn);
+        child.removeListener("error", onError);
+        signal?.removeEventListener("abort", onAbort);
+    };
+    child.once("spawn", onSpawn);
+    child.once("error", onError);
+    if (signal) {
+        if (signal.aborted)
+            return onAbort();
+        signal.addEventListener("abort", onAbort, { once: true });
+    }
+});
+//# sourceMappingURL=node-lsp-manager.js.map

package/dist/engine/lsp/node-lsp-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-lsp-manager.js","sourceRoot":"","sources":["../../../src/engine/lsp/node-lsp-manager.ts"],"names":[],"mappings":"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"}

package/dist/engine/lsp/stdio-lsp-transport.d.ts

@@ -0,0 +1,37 @@
+import type { LspTransport } from "../../core/lsp.js";
+/** The slice of a spawned child process the transport uses (so a test can drive a fake duplex — no real spawn). */
+export interface LspChildProcess {
+    stdin: {
+        write(data: Buffer): void;
+        on(event: "error", cb: (err: unknown) => void): void;
+    };
+    stdout: {
+        on(event: "data", cb: (chunk: Buffer) => void): void;
+    };
+    on(event: "exit" | "error", cb: (arg?: unknown) => void): void;
+    kill(signal?: string): void;
+    /** Present on a real child process; used on win32 (shell:true shim) to tree-kill on close. */
+    pid?: number;
+}
+export declare class StdioLspTransport implements LspTransport {
+    private readonly child;
+    private readonly requestTimeoutMs;
+    private nextId;
+    private readonly pending;
+    private isClosed;
+    private readonly decode;
+    /** design/121: server→client notification subscribers (publishDiagnostics, …). Empty = pre-121 behavior. */
+    private readonly notificationHandlers;
+    constructor(child: LspChildProcess, requestTimeoutMs?: number);
+    /** Manager-visible liveness: evict + reopen instead of reusing a dead server (crashed / killed). */
+    get closed(): boolean;
+    private onMessage;
+    /** design/121 {@link LspTransport.onNotification}: subscribe to server notifications; returns unsubscribe. */
+    onNotification(handler: (method: string, params: unknown) => void): () => void;
+    private failAll;
+    private send;
+    request(method: string, params: unknown, signal?: AbortSignal): Promise<unknown>;
+    notify(method: string, params: unknown): void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=stdio-lsp-transport.d.ts.map

package/dist/engine/lsp/stdio-lsp-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-lsp-transport.d.ts","sourceRoot":"","sources":["../../../src/engine/lsp/stdio-lsp-transport.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,mHAAmH;AACnH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC;IAC3F,MAAM,EAAE;QAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;KAAE,CAAC;IACjE,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,8FAA8F;IAC9F,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAOD,qBAAa,iBAAkB,YAAW,YAAY;IASlD,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IATnC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IACtD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;IAC7C,4GAA4G;IAC5G,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAwD;gBAG1E,KAAK,EAAE,eAAe,EACtB,gBAAgB,SAAS;IAW5C,oGAAoG;IACpG,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,OAAO,CAAC,SAAS;IAkDjB,8GAA8G;IAC9G,cAAc,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,MAAM,IAAI;IAK9E,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAgDhF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IASvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAW7B"}