@lsproxy/proxy 0.2.0

package/dist/proxy-server.d.ts

@@ -0,0 +1,28 @@
+import { type BackendPoolOptions } from './backend-pool.js';
+export interface ProxyServerOptions extends BackendPoolOptions {
+    root: string;
+    socketOverride?: string;
+    idleTimeoutMs?: number;
+    lazyCloseMs?: number;
+}
+export declare class ProxyServer {
+    private readonly root;
+    private readonly sockPath;
+    private readonly pidFilePath;
+    private readonly idleTimeoutMs;
+    private readonly pool;
+    private readonly docState;
+    private server;
+    private readonly sessions;
+    private readonly activeSockets;
+    private idleTimer;
+    private sessionCounter;
+    constructor(opts: ProxyServerOptions);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private onSessionEnd;
+    private resetIdleTimer;
+    private isSocketLive;
+    private lazyCloseUri;
+}
+//# sourceMappingURL=proxy-server.d.ts.map

package/dist/proxy-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-server.d.ts","sourceRoot":"","sources":["../src/proxy-server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAKzE,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAc;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,cAAc,CAAK;IAE3B,YAAY,IAAI,EAAE,kBAAkB,EAgBnC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CA4C3B;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgB1B;IAED,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,YAAY;YAWN,YAAY;CAoB3B"}

package/dist/proxy-server.js

@@ -0,0 +1,146 @@
+// apps/proxy/src/proxy-server.ts
+import { createServer, createConnection } from 'node:net';
+import { writeFileSync, unlinkSync, existsSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { socketToTransport } from '@lspeasy/core/node';
+import { BackendPool } from './backend-pool.js';
+import { DocumentStateManager } from './document-state.js';
+import { ClientSession } from './client-session.js';
+import { socketPath, pidPath } from './socket-path.js';
+export class ProxyServer {
+    root;
+    sockPath;
+    pidFilePath;
+    idleTimeoutMs;
+    pool;
+    docState;
+    server;
+    sessions = new Map();
+    activeSockets = new Set();
+    idleTimer;
+    sessionCounter = 0;
+    constructor(opts) {
+        this.root = opts.root;
+        this.sockPath = opts.socketOverride ?? socketPath(opts.root);
+        this.pidFilePath = opts.socketOverride
+            ? opts.socketOverride.endsWith('.sock')
+                ? opts.socketOverride.slice(0, -5) + '.pid'
+                : opts.socketOverride + '.pid'
+            : pidPath(opts.root);
+        this.idleTimeoutMs = opts.idleTimeoutMs ?? 1_800_000;
+        this.pool = new BackendPool(opts.root, {
+            ...(opts.backendIdleMs !== undefined && { backendIdleMs: opts.backendIdleMs })
+        });
+        this.docState = new DocumentStateManager({
+            ...(opts.lazyCloseMs !== undefined && { lazyCloseMs: opts.lazyCloseMs }),
+            onClose: (uri) => this.lazyCloseUri(uri)
+        });
+    }
+    async start() {
+        mkdirSync(dirname(this.sockPath), { recursive: true });
+        const srv = createServer((socket) => {
+            this.activeSockets.add(socket);
+            socket.on('close', () => this.activeSockets.delete(socket));
+            const sessionId = `s${++this.sessionCounter}`;
+            const transport = socketToTransport(socket);
+            const session = new ClientSession({
+                sessionId,
+                transport,
+                pool: this.pool,
+                docState: this.docState,
+                root: this.root,
+                onEnd: (id) => this.onSessionEnd(id)
+            });
+            this.sessions.set(sessionId, session);
+            this.resetIdleTimer();
+        });
+        this.server = srv;
+        await new Promise((resolve, reject) => {
+            srv.on('error', async (err) => {
+                if (err.code === 'EADDRINUSE') {
+                    const live = await this.isSocketLive(this.sockPath);
+                    if (live) {
+                        process.stderr.write('[lsproxy] socket already in use — another daemon is running\n');
+                        process.exit(0);
+                    }
+                    // Stale socket from a crashed daemon — remove and retry once
+                    unlinkSync(this.sockPath);
+                    srv.listen(this.sockPath, resolve);
+                }
+                else {
+                    reject(err);
+                }
+            });
+            srv.listen(this.sockPath, resolve);
+        });
+        writeFileSync(this.pidFilePath, String(process.pid), 'utf8');
+        process.stderr.write(`[lsproxy] listening on ${this.sockPath}\n`);
+        process.on('SIGTERM', () => this.stop());
+        this.resetIdleTimer();
+    }
+    async stop() {
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = undefined;
+        }
+        await this.pool.stopAll();
+        for (const sock of this.activeSockets)
+            sock.destroy();
+        await new Promise((resolve) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close(() => resolve());
+        });
+        if (existsSync(this.sockPath))
+            unlinkSync(this.sockPath);
+        if (existsSync(this.pidFilePath))
+            unlinkSync(this.pidFilePath);
+    }
+    onSessionEnd(sessionId) {
+        this.sessions.delete(sessionId);
+        this.resetIdleTimer();
+    }
+    resetIdleTimer() {
+        if (this.idleTimer)
+            clearTimeout(this.idleTimer);
+        if (this.sessions.size > 0)
+            return;
+        this.idleTimer = setTimeout(() => {
+            process.stderr.write('[lsproxy] idle timeout — shutting down\n');
+            this.stop().then(() => process.exit(0));
+        }, this.idleTimeoutMs);
+    }
+    isSocketLive(sockPath) {
+        return new Promise((resolve) => {
+            const sock = createConnection({ path: sockPath });
+            sock.once('connect', () => {
+                sock.destroy();
+                resolve(true);
+            });
+            sock.once('error', () => resolve(false));
+        });
+    }
+    async lazyCloseUri(uri) {
+        const ext = (() => {
+            try {
+                return new URL(uri).pathname.split('.').pop() ?? '';
+            }
+            catch {
+                return '';
+            }
+        })();
+        const langId = ext ? this.pool.getLanguageIdForExtension(`.${ext}`) : undefined;
+        const backend = langId ? this.pool.getBackend(langId) : undefined;
+        if (!backend)
+            return;
+        try {
+            await backend.sendNotification('textDocument/didClose', { textDocument: { uri } });
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+//# sourceMappingURL=proxy-server.js.map

package/dist/proxy-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-server.js","sourceRoot":"","sources":["../src/proxy-server.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAA4B,MAAM,UAAU,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,WAAW,EAA2B,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AASvD,MAAM,OAAO,WAAW;IACL,IAAI,CAAS;IACb,QAAQ,CAAS;IACjB,WAAW,CAAS;IACpB,aAAa,CAAS;IACtB,IAAI,CAAc;IAClB,QAAQ,CAAuB;IACxC,MAAM,CAAqB;IAClB,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC5C,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAC3C,SAAS,CAA4C;IACrD,cAAc,GAAG,CAAC,CAAC;IAE3B,YAAY,IAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,cAAc,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7D,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,cAAc;YACpC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC;gBACrC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM;gBAC3C,CAAC,CAAC,IAAI,CAAC,cAAc,GAAG,MAAM;YAChC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE;YACrC,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,EAAE,aAAa,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;SAC/E,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,GAAG,IAAI,oBAAoB,CAAC;YACvC,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;YACxE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,KAAK;QACT,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvD,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;YAClC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC5D,MAAM,SAAS,GAAG,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC;gBAChC,SAAS;gBACT,SAAS;gBACT,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;aACrC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACtC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;QAClB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC1C,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,GAA0B,EAAE,EAAE;gBACnD,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;oBAC9B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACpD,IAAI,IAAI,EAAE,CAAC;wBACT,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;wBACtF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;oBAClB,CAAC;oBACD,6DAA6D;oBAC7D,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBAC1B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACrC,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YACH,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QAElE,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,CAAC;QACD,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,aAAa;YAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACtD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjB,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QACH,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC;YAAE,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjE,CAAC;IAEO,YAAY,CAAC,SAAiB;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAChC,IAAI,CAAC,cAAc,EAAE,CAAC;IACxB,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,SAAS;YAAE,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACjD,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC;YAAE,OAAO;QACnC,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;YACjE,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC;IAEO,YAAY,CAAC,QAAgB;QACnC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;gBACxB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,GAAW;QACpC,MAAM,GAAG,GAAG,CAAC,GAAG,EAAE;YAChB,IAAI,CAAC;gBACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,IAAI,CAAC;YACH,MAAO,OAAO,CAAC,gBAA6D,CAC1E,uBAAuB,EACvB,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,CAC1B,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;CACF"}

package/dist/socket-path.d.ts

@@ -0,0 +1,3 @@
+export declare function socketPath(root: string): string;
+export declare function pidPath(root: string): string;
+//# sourceMappingURL=socket-path.d.ts.map

package/dist/socket-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-path.d.ts","sourceRoot":"","sources":["../src/socket-path.ts"],"names":[],"mappings":"AAQA,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C"}

package/dist/socket-path.js

@@ -0,0 +1,13 @@
+import { createHash } from 'node:crypto';
+import { resolve, join } from 'node:path';
+import { homedir } from 'node:os';
+function rootHash(root) {
+    return createHash('sha1').update(resolve(root)).digest('hex').slice(0, 12);
+}
+export function socketPath(root) {
+    return join(homedir(), '.lsproxy', `${rootHash(root)}.sock`);
+}
+export function pidPath(root) {
+    return join(homedir(), '.lsproxy', `${rootHash(root)}.pid`);
+}
+//# sourceMappingURL=socket-path.js.map

package/dist/socket-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket-path.js","sourceRoot":"","sources":["../src/socket-path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC9D,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@lsproxy/proxy",
+  "version": "0.2.0",
+  "description": "Per-root LSP proxy daemon — holds warm language server connections for @lsproxy/cli",
+  "type": "module",
+  "bin": {
+    "lsproxy": "./dist/main.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@lspeasy/core": "2.3.0",
+    "@lspeasy/client": "3.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsgo --build",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "type-check": "tsgo --noEmit"
+  }
+}

package/src/backend-pool.test.ts

@@ -0,0 +1,101 @@
+// apps/proxy/src/backend-pool.test.ts
+import { describe, it, expect, vi, afterEach, beforeEach } from 'vitest';
+import { BackendPool } from './backend-pool.js';
+import { discoverServerByLanguageId } from '@lspeasy/core';
+
+vi.mock('@lspeasy/core', async (importActual) => {
+  const actual = await importActual<typeof import('@lspeasy/core')>();
+  return {
+    ...actual,
+    discoverServerByLanguageId: vi.fn(),
+    discoverExtensionMap: vi.fn(() => ({ '.ts': 'typescript' }))
+  };
+});
+
+vi.mock('@lspeasy/client', () => ({
+  LSPClient: vi.fn().mockImplementation(function () {
+    return {
+      connect: vi.fn().mockResolvedValue(undefined),
+      disconnect: vi.fn().mockResolvedValue(undefined),
+      getServerCapabilities: vi.fn().mockReturnValue({ hoverProvider: true }),
+      sendRequest: vi.fn().mockResolvedValue(null),
+      sendNotification: vi.fn().mockResolvedValue(undefined)
+    };
+  })
+}));
+
+vi.mock('node:child_process', () => ({
+  spawn: vi.fn().mockReturnValue({
+    stdout: { on: vi.fn() },
+    stdin: { on: vi.fn() },
+    on: vi.fn(),
+    kill: vi.fn()
+  })
+}));
+
+describe('BackendPool', () => {
+  beforeEach(() => {
+    (discoverServerByLanguageId as ReturnType<typeof vi.fn>).mockReturnValue({
+      serverCommand: '"typescript-language-server" "--stdio"',
+      languageId: 'typescript'
+    });
+  });
+
+  afterEach(() => {
+    vi.restoreAllMocks();
+    vi.useRealTimers();
+  });
+
+  it('creates a backend on first ensureBackend call', async () => {
+    const pool = new BackendPool('/project');
+    const client = await pool.ensureBackend('typescript');
+    expect(client).toBeDefined();
+  });
+
+  it('returns the same client on subsequent calls', async () => {
+    const pool = new BackendPool('/project');
+    const c1 = await pool.ensureBackend('typescript');
+    const c2 = await pool.ensureBackend('typescript');
+    expect(c1).toBe(c2);
+  });
+
+  it('throws when no server is configured for languageId', async () => {
+    (discoverServerByLanguageId as ReturnType<typeof vi.fn>).mockReturnValue(null);
+    const pool = new BackendPool('/project');
+    await expect(pool.ensureBackend('python')).rejects.toThrow('python');
+  });
+
+  it('getLanguageIdForExtension returns the languageId for a known extension', () => {
+    const pool = new BackendPool('/project');
+    expect(pool.getLanguageIdForExtension('.ts')).toBe('typescript');
+  });
+
+  it('stopAll disconnects live backends', async () => {
+    const pool = new BackendPool('/project');
+    const client = (await pool.ensureBackend('typescript')) as any;
+    await pool.stopAll();
+    expect(client.disconnect).toHaveBeenCalled();
+  });
+
+  it('fires stopBackend after backendIdleMs', async () => {
+    vi.useFakeTimers();
+    const pool = new BackendPool('/project', { backendIdleMs: 1000 });
+    const client = (await pool.ensureBackend('typescript')) as any;
+    vi.advanceTimersByTime(1000);
+    await vi.runAllTimersAsync();
+    expect(client.disconnect).toHaveBeenCalled();
+  });
+
+  it('resets idle timer on repeated ensureBackend calls', async () => {
+    vi.useFakeTimers();
+    const pool = new BackendPool('/project', { backendIdleMs: 1000 });
+    await pool.ensureBackend('typescript');
+    vi.advanceTimersByTime(500);
+    const client = (await pool.ensureBackend('typescript')) as any;
+    vi.advanceTimersByTime(600); // only 600ms since last call — should not fire yet
+    expect(client.disconnect).not.toHaveBeenCalled();
+    vi.advanceTimersByTime(400); // now 1000ms after last call — fires
+    await vi.runAllTimersAsync();
+    expect(client.disconnect).toHaveBeenCalled();
+  });
+});

package/src/backend-pool.ts

@@ -0,0 +1,151 @@
+// apps/proxy/src/backend-pool.ts
+import { spawn } from 'node:child_process';
+import { resolve, basename } from 'node:path';
+import type { Readable, Writable } from 'node:stream';
+import { pathToFileURL } from 'node:url';
+import { LSPClient } from '@lspeasy/client';
+import {
+  tokenizeCommand,
+  discoverServerByLanguageId,
+  discoverExtensionMap,
+  type ClientCapabilities
+} from '@lspeasy/core';
+import { StdioTransport } from '@lspeasy/core/node';
+
+// Advertise full capabilities so backends expose their complete ServerCapabilities.
+const CLIENT_CAPABILITIES = {
+  textDocument: {
+    synchronization: { dynamicRegistration: false },
+    definition: { dynamicRegistration: false },
+    declaration: { dynamicRegistration: false },
+    typeDefinition: { dynamicRegistration: false },
+    implementation: { dynamicRegistration: false },
+    references: { dynamicRegistration: false },
+    documentSymbol: { dynamicRegistration: false },
+    hover: { dynamicRegistration: false },
+    completion: { dynamicRegistration: false },
+    signatureHelp: { dynamicRegistration: false },
+    rename: { dynamicRegistration: false },
+    codeAction: { dynamicRegistration: false },
+    formatting: { dynamicRegistration: false },
+    rangeFormatting: { dynamicRegistration: false }
+  },
+  workspace: {
+    applyEdit: true,
+    executeCommand: { dynamicRegistration: false },
+    symbol: { dynamicRegistration: false }
+  }
+} satisfies Partial<ClientCapabilities>;
+
+export interface BackendPoolOptions {
+  backendIdleMs?: number;
+}
+
+interface BackendEntry {
+  client: LSPClient;
+  proc: ReturnType<typeof spawn>;
+  idleTimer?: ReturnType<typeof setTimeout>;
+}
+
+export class BackendPool {
+  private readonly backends = new Map<string, BackendEntry>();
+  private readonly starting = new Map<string, Promise<LSPClient>>();
+  private readonly extensionMap: Record<string, string>;
+  private readonly backendIdleMs: number;
+
+  constructor(
+    private readonly root: string,
+    opts: BackendPoolOptions = {}
+  ) {
+    this.backendIdleMs = opts.backendIdleMs ?? 600_000;
+    this.extensionMap = discoverExtensionMap(root);
+  }
+
+  getLanguageIdForExtension(ext: string): string | undefined {
+    return this.extensionMap[ext];
+  }
+
+  getBackend(languageId: string): LSPClient | undefined {
+    return this.backends.get(languageId)?.client;
+  }
+
+  async ensureBackend(languageId: string): Promise<LSPClient> {
+    const existing = this.backends.get(languageId);
+    if (existing) {
+      this.resetIdleTimer(languageId, existing);
+      return existing.client;
+    }
+
+    // Deduplicate concurrent startup calls for the same languageId
+    const inflight = this.starting.get(languageId);
+    if (inflight) return inflight;
+
+    const promise = this.startBackend(languageId);
+    this.starting.set(languageId, promise);
+    try {
+      return await promise;
+    } finally {
+      this.starting.delete(languageId);
+    }
+  }
+
+  private async startBackend(languageId: string): Promise<LSPClient> {
+    const discovered = discoverServerByLanguageId(this.root, languageId);
+    if (!discovered) {
+      throw new Error(`No LSP server configured for languageId "${languageId}"`);
+    }
+
+    const [cmd, ...args] = tokenizeCommand(discovered.serverCommand);
+    if (!cmd) throw new Error('Empty server command');
+
+    const proc = spawn(cmd, args, { cwd: this.root, stdio: 'pipe' });
+    const transport = new StdioTransport({
+      input: proc.stdout as Readable,
+      output: proc.stdin as Writable
+    });
+
+    const rootDir = resolve(this.root);
+    const rootUri = pathToFileURL(rootDir).href;
+    const client = new LSPClient({
+      name: 'lsproxy',
+      version: '0.1.0',
+      capabilities: CLIENT_CAPABILITIES as ClientCapabilities,
+      rootUri,
+      workspaceFolders: [{ uri: rootUri, name: basename(rootDir) }]
+    });
+
+    await client.connect(transport);
+
+    const entry: BackendEntry = { client, proc };
+    this.backends.set(languageId, entry);
+    this.resetIdleTimer(languageId, entry);
+    return client;
+  }
+
+  async stopBackend(languageId: string): Promise<void> {
+    const entry = this.backends.get(languageId);
+    if (!entry) return;
+    if (entry.idleTimer) {
+      clearTimeout(entry.idleTimer);
+      delete entry.idleTimer;
+    }
+    this.backends.delete(languageId);
+    try {
+      await entry.client.disconnect();
+    } catch {
+      // ignore
+    }
+    entry.proc.kill();
+  }
+
+  async stopAll(): Promise<void> {
+    await Promise.all([...this.backends.keys()].map((id) => this.stopBackend(id)));
+  }
+
+  private resetIdleTimer(languageId: string, entry: BackendEntry): void {
+    if (entry.idleTimer) {
+      clearTimeout(entry.idleTimer);
+    }
+    entry.idleTimer = setTimeout(() => this.stopBackend(languageId), this.backendIdleMs);
+  }
+}