@lsproxy/proxy 0.2.0 → 1.0.0

package/README.md

@@ -7,18 +7,18 @@ to it instead of spawning a fresh language server on every invocation.
 ## Why
 
 An LSP server's `initialize` handshake and project indexing typically take 1–15
-seconds. Paying that cost on every `lspeasy` call makes scripting impractical.
+seconds. Paying that cost on every `lsproxy` call makes scripting impractical.
 `@lsproxy/proxy` keeps the server alive between calls so subsequent invocations
 attach in under 100ms.
 
 ## How it works
 
 ```
-lspeasy textDocument hover src/foo.ts 12:7
+lsproxy textDocument hover src/foo.ts 12:7
    │
    ├─ checks ~/.lsproxy/<hash(root)>.sock
    │
-   ├─ (first call) spawns lsproxy daemon, awaits socket
+   ├─ (first call) spawns lsps daemon, awaits socket
    │
    └─ connects via SocketTransport ──► ClientSession
                                            │

package/dist/main.js

@@ -15,7 +15,7 @@ const { values } = parseArgs({
     strict: true
 });
 if (!values['root']) {
-    process.stderr.write('[lsproxy] fatal: --root is required\n');
+    process.stderr.write('[lsps] fatal: --root is required\n');
     process.exit(1);
 }
 const root = resolve(values['root']);
@@ -27,7 +27,7 @@ const server = new ProxyServer({
     lazyCloseMs: Number(values['lazy-close-delay'])
 });
 server.start().catch((err) => {
-    process.stderr.write(`[lsproxy] fatal: ${err.message}\n`);
+    process.stderr.write(`[lsps] fatal: ${err.message}\n`);
     process.exit(1);
 });
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,yBAAyB;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;QACtD,sBAAsB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC7D,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;KAC1D;IACD,gBAAgB,EAAE,KAAK;IACvB,MAAM,EAAE,IAAI;CACb,CAAC,CAAC;AAEH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;IAC7B,IAAI;IACJ,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3E,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,yBAAyB;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,MAAM,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;QACtD,sBAAsB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;QAC7D,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE;KAC1D;IACD,gBAAgB,EAAE,KAAK;IACvB,MAAM,EAAE,IAAI;CACb,CAAC,CAAC;AAEH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;IACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AACrC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC;IAC7B,IAAI;IACJ,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,EAAE,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC3E,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC7C,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;IACrD,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;CAChD,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAU,EAAE,EAAE;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,10 +1,29 @@
 {
   "name": "@lsproxy/proxy",
-  "version": "0.2.0",
-  "description": "Per-root LSP proxy daemon — holds warm language server connections for @lsproxy/cli",
+  "version": "1.0.0",
+  "description": "Per-root LSP multiplexing daemon — holds warm language server connections for @lsproxy/cli",
+  "private": false,
+  "keywords": [
+    "lsp",
+    "language-server-protocol",
+    "lsp-proxy",
+    "language-server",
+    "cli"
+  ],
+  "homepage": "https://github.com/pradeepmouli/lspeasy#readme",
+  "bugs": {
+    "url": "https://github.com/pradeepmouli/lspeasy/issues"
+  },
+  "license": "MIT",
+  "author": "Pradeep Mouli <pmouli@mac.com> (https://github.com/pradeepmouli)",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pradeepmouli/lspeasy.git",
+    "directory": "apps/proxy"
+  },
   "type": "module",
   "bin": {
-    "lsproxy": "./dist/main.js"
+    "lsps": "./dist/main.js"
   },
   "exports": {
     ".": {
@@ -14,9 +33,16 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
   "dependencies": {
-    "@lspeasy/core": "2.3.0",
-    "@lspeasy/client": "3.1.1"
+    "@lspeasy/client": "3.1.1",
+    "@lspeasy/core": "2.3.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3"

package/CHANGELOG.md

@@ -1,23 +0,0 @@
-# @lsproxy/proxy
-
-## 0.2.0
-
-### Minor Changes
-
-- 03fd44c: feat(cli): language-agnostic and capability-agnostic CLI
-
-  - `lsp.json` discovery: walks `<root>/lsp.json`, `<root>/.claude/lsp.json`, `<root>/.github/lsp.json`, `~/.claude/lsp.json`; `--server` overrides
-  - Runtime Zod → Commander translation: builds namespace/subcommand tree from `LSPSchemas × ServerCapabilities` so only what the connected server advertises is exposed
-  - Two-pass parse: `util.parseArgs` extracts globals, then Commander dispatches after capability detection
-  - Generic `lspeasy call <method> --params <json>` fallback always available
-  - Write operations (rename, formatting) now apply `WorkspaceEdit` results to disk; `--dry-run` shows planned changes without writing
-  - `workspace/symbol` gets a `<query>` positional via new `'query'` arg pattern
-
-  `@lspeasy/core`: expanded `LSPSchemas` to cover all standard text-document and workspace capabilities
-
-### Patch Changes
-
-- Updated dependencies [0eb1694]
-- Updated dependencies [03fd44c]
-  - @lspeasy/core@2.3.0
-  - @lspeasy/client@3.1.1

package/src/backend-pool.test.ts

@@ -1,101 +0,0 @@
-// 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

@@ -1,151 +0,0 @@
-// 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);
-  }
-}

package/src/client-session.ts

@@ -1,199 +0,0 @@
-// apps/proxy/src/client-session.ts
-import { extname } from 'node:path';
-import type { Transport } from '@lspeasy/core';
-import type { LSPClient } from '@lspeasy/client';
-import type { BackendPool } from './backend-pool.js';
-import type { DocumentStateManager } from './document-state.js';
-
-export interface ClientSessionOptions {
-  sessionId: string;
-  transport: Transport;
-  pool: BackendPool;
-  docState: DocumentStateManager;
-  root: string;
-  onEnd: (sessionId: string) => void;
-}
-
-type RawMsg = {
-  jsonrpc: '2.0';
-  id?: string | number | null;
-  method?: string;
-  params?: unknown;
-  result?: unknown;
-  error?: unknown;
-};
-
-export class ClientSession {
-  private readonly id: string;
-  private readonly transport: Transport;
-  private readonly pool: BackendPool;
-  private readonly docState: DocumentStateManager;
-  private readonly onEnd: (sessionId: string) => void;
-  private languageId = 'plaintext';
-  private requestIdCounter = 0;
-  private readonly pendingClientRequests = new Map<string | number, (result: unknown) => void>();
-  private applyEditDisposable: { dispose(): void } | undefined;
-
-  constructor(opts: ClientSessionOptions) {
-    this.id = opts.sessionId;
-    this.transport = opts.transport;
-    this.pool = opts.pool;
-    this.docState = opts.docState;
-    this.onEnd = opts.onEnd;
-
-    this.transport.onMessage((msg) => this.handleMessage(msg as unknown as RawMsg));
-    this.transport.onClose(() => this.handleClose());
-    this.transport.onError((e) => process.stderr.write(`[session:${this.id}] ${e.message}\n`));
-  }
-
-  private async handleMessage(msg: RawMsg): Promise<void> {
-    const isRequest = msg.id !== undefined && msg.method !== undefined;
-    const isNotification = msg.id === undefined && msg.method !== undefined;
-    // Response to a request we sent (e.g. workspace/applyEdit forwarded to CLI)
-    const isResponse = msg.id !== undefined && msg.method === undefined && msg.result !== undefined;
-
-    if (isResponse) {
-      const resolve = this.pendingClientRequests.get(msg.id as string | number);
-      if (resolve) {
-        this.pendingClientRequests.delete(msg.id as string | number);
-        resolve(msg.result);
-      }
-      return;
-    }
-
-    try {
-      if (isRequest) {
-        const result = await this.handleRequest(msg);
-        await this.transport.send({
-          jsonrpc: '2.0',
-          id: msg.id as string | number,
-          result
-        });
-      } else if (isNotification) {
-        await this.handleNotification(msg);
-      }
-    } catch (err) {
-      if (isRequest) {
-        await this.transport.send({
-          jsonrpc: '2.0',
-          id: msg.id as string | number,
-          error: { code: -32603, message: String(err) }
-        });
-      }
-    }
-  }
-
-  private async forwardToClient(method: string, params: unknown): Promise<unknown> {
-    const id = ++this.requestIdCounter;
-    return new Promise((resolve) => {
-      this.pendingClientRequests.set(id, resolve);
-      void this.transport.send({ jsonrpc: '2.0', id, method, params });
-    });
-  }
-
-  private async handleRequest(msg: RawMsg): Promise<unknown> {
-    if (msg.method === 'initialize') {
-      return this.handleInitialize(msg.params as Record<string, unknown>);
-    }
-    if (msg.method === 'shutdown') {
-      // Ack without tearing down the shared backend
-      return null;
-    }
-    const backend = this.backendForMsg(msg);
-    return (backend.sendRequest as (m: string, p: unknown) => Promise<unknown>)(
-      msg.method!,
-      msg.params
-    );
-  }
-
-  private async handleInitialize(params: Record<string, unknown>): Promise<unknown> {
-    const initOpts = params['initializationOptions'] as Record<string, unknown> | undefined;
-    this.languageId = (initOpts?.['languageId'] as string | undefined) ?? 'plaintext';
-    const backend = await this.pool.ensureBackend(this.languageId);
-
-    // Forward workspace/applyEdit from backend to this CLI session.
-    // The registration overwrites any prior session's handler — acceptable because
-    // applyEdit only fires during executeCommand, which is driven by an active session.
-    this.applyEditDisposable?.dispose();
-    this.applyEditDisposable = (
-      backend.onRequest as (m: string, h: (p: unknown) => Promise<unknown>) => { dispose(): void }
-    )('workspace/applyEdit', (p) => this.forwardToClient('workspace/applyEdit', p));
-
-    return { capabilities: backend.getServerCapabilities() ?? {} };
-  }
-
-  private async handleNotification(msg: RawMsg): Promise<void> {
-    // Session lifecycle — not forwarded to the shared backend
-    if (msg.method === 'initialized' || msg.method === 'exit') return;
-
-    if (msg.method === 'textDocument/didOpen') {
-      const p = msg.params as Record<string, unknown>;
-      const td = p['textDocument'] as Record<string, unknown>;
-      const uri = td['uri'] as string;
-      const content = td['text'] as string;
-      const langId = td['languageId'] as string;
-      const action = this.docState.onDidOpen(this.id, uri, content, langId);
-
-      const backend = await this.pool.ensureBackend(langId || this.languageIdForUri(uri));
-
-      if (action === 'open') {
-        await (backend.sendNotification as (m: string, p: unknown) => Promise<void>)(
-          'textDocument/didOpen',
-          p
-        );
-      } else if (action === 'change') {
-        await (backend.sendNotification as (m: string, p: unknown) => Promise<void>)(
-          'textDocument/didChange',
-          {
-            textDocument: { uri, version: (td['version'] as number) + 1 },
-            contentChanges: [{ text: content }]
-          }
-        );
-      }
-      // 'skip' → no-op
-      return;
-    }
-
-    if (msg.method === 'textDocument/didClose') {
-      const p = msg.params as Record<string, unknown>;
-      const td = p['textDocument'] as Record<string, unknown>;
-      const uri = td['uri'] as string;
-      this.docState.onDidClose(this.id, uri);
-      return;
-    }
-
-    // Forward all other notifications (didChange, willSave, etc.)
-    const backend = this.backendForMsg(msg);
-    await (backend.sendNotification as (m: string, p: unknown) => Promise<void>)(
-      msg.method!,
-      msg.params
-    );
-  }
-
-  private backendForMsg(msg: RawMsg): LSPClient {
-    // Prefer routing by URI extension; fall back to session's primary languageId
-    const params = msg.params as Record<string, unknown> | undefined;
-    const td = params?.['textDocument'] as Record<string, unknown> | undefined;
-    const uri = td?.['uri'] as string | undefined;
-    const langId = uri ? (this.languageIdForUri(uri) ?? this.languageId) : this.languageId;
-    const backend = this.pool.getBackend(langId) ?? this.pool.getBackend(this.languageId);
-    if (!backend) throw new Error(`No backend available for languageId "${langId}"`);
-    return backend;
-  }
-
-  private languageIdForUri(uri: string): string {
-    try {
-      const ext = extname(new URL(uri).pathname);
-      return this.pool.getLanguageIdForExtension(ext) ?? this.languageId;
-    } catch {
-      return this.languageId;
-    }
-  }
-
-  private handleClose(): void {
-    this.applyEditDisposable?.dispose();
-    this.applyEditDisposable = undefined;
-    this.docState.onSessionEnd(this.id);
-    this.onEnd(this.id);
-  }
-}

package/src/document-state.test.ts

@@ -1,64 +0,0 @@
-// apps/proxy/src/document-state.test.ts
-import { describe, it, expect, vi, afterEach } from 'vitest';
-import { DocumentStateManager } from './document-state.js';
-
-describe('DocumentStateManager', () => {
-  afterEach(() => vi.useRealTimers());
-
-  it('returns "open" for a new URI', () => {
-    const m = new DocumentStateManager();
-    expect(m.onDidOpen('session-1', 'file:///a.ts', 'hello', 'typescript')).toBe('open');
-  });
-
-  it('returns "skip" when a second session opens the same URI with same content', () => {
-    const m = new DocumentStateManager();
-    m.onDidOpen('session-1', 'file:///a.ts', 'hello', 'typescript');
-    expect(m.onDidOpen('session-2', 'file:///a.ts', 'hello', 'typescript')).toBe('skip');
-  });
-
-  it('returns "change" when a second session opens URI with different content', () => {
-    const m = new DocumentStateManager();
-    m.onDidOpen('session-1', 'file:///a.ts', 'hello', 'typescript');
-    expect(m.onDidOpen('session-2', 'file:///a.ts', 'world', 'typescript')).toBe('change');
-  });
-
-  it('onSessionEnd returns URIs that had last session closed', () => {
-    const m = new DocumentStateManager();
-    m.onDidOpen('s1', 'file:///a.ts', 'code', 'typescript');
-    m.onDidOpen('s1', 'file:///b.ts', 'code', 'typescript');
-    m.onDidOpen('s2', 'file:///a.ts', 'code', 'typescript');
-    const uris = m.onSessionEnd('s1');
-    // b.ts lost its only session, a.ts still has s2
-    expect(uris).toEqual(['file:///b.ts']);
-  });
-
-  it('cancels lazy-close timer when URI is reopened', () => {
-    vi.useFakeTimers();
-    const closeCallback = vi.fn();
-    const m = new DocumentStateManager({ lazyCloseMs: 1000, onClose: closeCallback });
-    m.onDidOpen('s1', 'file:///a.ts', 'x', 'typescript');
-    m.onSessionEnd('s1'); // schedules lazy close
-    m.onDidOpen('s2', 'file:///a.ts', 'x', 'typescript'); // should cancel timer
-    vi.advanceTimersByTime(2000);
-    expect(closeCallback).not.toHaveBeenCalled();
-  });
-
-  it('fires onClose callback after lazyCloseMs when no sessions remain', () => {
-    vi.useFakeTimers();
-    const closeCallback = vi.fn();
-    const m = new DocumentStateManager({ lazyCloseMs: 500, onClose: closeCallback });
-    m.onDidOpen('s1', 'file:///a.ts', 'x', 'typescript');
-    m.onSessionEnd('s1');
-    vi.advanceTimersByTime(600);
-    expect(closeCallback).toHaveBeenCalledWith('file:///a.ts');
-  });
-
-  it('getContent returns undefined after lazy eviction fires', () => {
-    vi.useFakeTimers();
-    const m = new DocumentStateManager({ lazyCloseMs: 500 });
-    m.onDidOpen('s1', 'file:///a.ts', 'content', 'typescript');
-    m.onSessionEnd('s1');
-    vi.advanceTimersByTime(600);
-    expect(m.getContent('file:///a.ts')).toBeUndefined();
-  });
-});