@hansjm10/volt-coding-agent 0.0.0-bootstrap.0 → 0.1.0

package/dist/core/lsp/manager.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Config-driven multi-server LSP manager.
+ *
+ * Routes files to language servers by extension, lazily spawns one client per
+ * (server, project root), and formats post-mutation diagnostics for tool
+ * results. Server start failures are reported once and then suppressed.
+ */
+import type { HostInteraction } from "../host-interaction.ts";
+import type { ToolDiagnosticsProvider } from "../tools/diagnostics-provider.ts";
+import type { LspNavigationProvider } from "../tools/lsp.ts";
+import { type ResolvedLspConfig } from "./config.ts";
+export interface LspManagerOptions {
+    cwd: string;
+    config: ResolvedLspConfig;
+    hostInteraction?: HostInteraction;
+    installRunner?: LspInstallRunner;
+}
+export interface LspInstallCommandOptions {
+    cwd: string;
+    signal?: AbortSignal;
+    onChunk?: (chunk: string) => void;
+}
+export interface LspInstallCommandResult {
+    exitCode: number | null;
+    output: string;
+}
+export type LspInstallRunner = (command: readonly string[], options: LspInstallCommandOptions) => Promise<LspInstallCommandResult>;
+export interface LspServerStatus {
+    name: string;
+    root: string;
+    alive: boolean;
+    openDocuments: number;
+    /** Milliseconds since the server was last used */
+    idleMs: number;
+}
+export declare function runDefaultLspInstallCommand(command: readonly string[], options: LspInstallCommandOptions): Promise<LspInstallCommandResult>;
+export declare class LspManager implements ToolDiagnosticsProvider, LspNavigationProvider {
+    private cwd;
+    private config;
+    private clients;
+    private startFailures;
+    private hostInteraction;
+    private installRunner;
+    private installPromptsUsed;
+    private installAttempts;
+    private disposed;
+    /** Summaries of WorkspaceEdits applied via server-initiated workspace/applyEdit */
+    private serverApplyEditSummaries;
+    private lastUsedAt;
+    private idleTimer;
+    private tracer;
+    constructor(options: LspManagerOptions);
+    setHostInteraction(hostInteraction: HostInteraction | undefined): void;
+    /** Status of all spawned language servers. */
+    getStatus(): LspServerStatus[];
+    /** Path of the active trace file, if tracing is enabled. */
+    getTraceFile(): string | undefined;
+    /** Enable or disable protocol tracing for current and future servers. */
+    setTraceFile(filePath: string | undefined): Promise<void>;
+    /** Synchronously stop tracing during non-awaitable process teardown. */
+    closeTraceSync(): void;
+    /** Dispose all running servers. They respawn lazily on next use. Returns the number stopped. */
+    restart(): number;
+    private shutdownIdleClients;
+    /**
+     * Collect diagnostics for a file that was just written.
+     *
+     * Also reports other open files that went from clean to failing as a result
+     * of this change (best-effort: depends on the server republishing for open
+     * documents within the settle window).
+     *
+     * Returns formatted diagnostics text, or undefined when no matching server
+     * is configured, the server is unavailable, or there is nothing to report.
+     */
+    getDiagnostics(absolutePath: string, content: string, signal?: AbortSignal): Promise<string | undefined>;
+    /** Paths of other open documents that currently have no reportable diagnostics. */
+    private collectCleanOpenDocuments;
+    /** Report open documents that went from clean to failing since the snapshot. */
+    private formatNewlyFailing;
+    dispose(): void;
+    definition(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    references(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    implementations(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    typeDefinition(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    hover(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string>;
+    documentSymbols(absolutePath: string, signal?: AbortSignal): Promise<string>;
+    callHierarchy(absolutePath: string, symbol: string, direction: "incoming" | "outgoing", line?: number, signal?: AbortSignal): Promise<string>;
+    workspaceSymbols(absolutePath: string, query: string, signal?: AbortSignal): Promise<string>;
+    fileDiagnostics(absolutePath: string, signal?: AbortSignal): Promise<string>;
+    private locationQuery;
+    private openSession;
+    rename(absolutePath: string, symbol: string, newName: string, line?: number, signal?: AbortSignal): Promise<string>;
+    codeFix(absolutePath: string, options: {
+        symbol?: string;
+        line?: number;
+        title?: string;
+        kind?: string;
+    }, signal?: AbortSignal): Promise<string>;
+    private applyCodeAction;
+    private applyWorkspaceEdit;
+    private assertWorkspaceEditOperationInRoot;
+    private assertWorkspaceEditPathInRoot;
+    private refreshStale;
+    private appendSymbolLines;
+    private formatLocation;
+    private noServerMessage;
+    private describeRequestError;
+    private displayPath;
+    private findServer;
+    private findRoot;
+    private getClient;
+    private handleClientError;
+    private removeFailedClient;
+    private recordStartFailure;
+    private tryInstallMissingServer;
+    private createInstallAttemptFailure;
+    private runInstallPrompt;
+    private formatInstallFailure;
+    private emitHostActionUpdate;
+    private formatDiagnostics;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/core/lsp/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/core/lsp/manager.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Config-driven multi-server LSP manager.\n *\n * Routes files to language servers by extension, lazily spawns one client per\n * (server, project root), and formats post-mutation diagnostics for tool\n * results. Server start failures are reported once and then suppressed.\n */\n\nimport { spawn } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { existsSync } from \"node:fs\";\nimport { rename as fsRename, mkdir, readFile, rm, writeFile } from \"node:fs/promises\";\nimport { dirname, extname, isAbsolute, join, relative } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport type { HostInteraction } from \"../host-interaction.ts\";\nimport type { ToolDiagnosticsProvider } from \"../tools/diagnostics-provider.ts\";\nimport { withFileMutationQueue } from \"../tools/file-mutation-queue.ts\";\nimport type { LspNavigationProvider } from \"../tools/lsp.ts\";\nimport { LspClient, type LspDiagnostic, type LspPosition, type LspRange } from \"./client.ts\";\nimport {\n\ttype LspInstallRecipe,\n\ttype ResolvedLspConfig,\n\ttype ResolvedLspServerConfig,\n\tSEVERITY_NAMES,\n} from \"./config.ts\";\nimport { LspTracer } from \"./trace.ts\";\nimport {\n\tapplyTextEdits,\n\ttype LspWorkspaceEdit,\n\ttype NormalizedWorkspaceOperation,\n\tnormalizeWorkspaceEdit,\n} from \"./workspace-edit.ts\";\n\nexport interface LspManagerOptions {\n\tcwd: string;\n\tconfig: ResolvedLspConfig;\n\thostInteraction?: HostInteraction;\n\tinstallRunner?: LspInstallRunner;\n}\n\nexport interface LspInstallCommandOptions {\n\tcwd: string;\n\tsignal?: AbortSignal;\n\tonChunk?: (chunk: string) => void;\n}\n\nexport interface LspInstallCommandResult {\n\texitCode: number | null;\n\toutput: string;\n}\n\nexport type LspInstallRunner = (\n\tcommand: readonly string[],\n\toptions: LspInstallCommandOptions,\n) => Promise<LspInstallCommandResult>;\n\nexport interface LspServerStatus {\n\tname: string;\n\troot: string;\n\talive: boolean;\n\topenDocuments: number;\n\t/** Milliseconds since the server was last used */\n\tidleMs: number;\n}\n\ninterface ServerFailureState {\n\tcount: number;\n\treported: boolean;\n}\n\ntype LspClientErrorResult = { retry: true } | { retry: false; message?: string };\n\ninterface LspInstallAttemptResult {\n\tretry: boolean;\n\tmessage?: string;\n}\n\nconst MAX_START_ATTEMPTS = 3;\nconst MAX_REFERENCES = 50;\nconst MAX_SYMBOL_LINES = 200;\nconst MAX_CROSS_FILE_REPORTS = 5;\nconst LSP_INSTALL_REQUEST_TIMEOUT_MS = 10 * 60_000;\nconst MAX_INSTALL_OUTPUT_CHARS = 12000;\n\nfunction uriToPath(uri: string): string {\n\ttry {\n\t\treturn fileURLToPath(uri);\n\t} catch {\n\t\treturn uri;\n\t}\n}\n\nfunction isPathInsideRoot(rootDir: string, absolutePath: string): boolean {\n\tif (!isAbsolute(absolutePath)) {\n\t\treturn false;\n\t}\n\tconst rel = relative(rootDir, absolutePath);\n\treturn rel === \"\" || (rel !== \"\" && !rel.startsWith(\"..\") && !isAbsolute(rel));\n}\n\nconst SYMBOL_KIND_NAMES: Record<number, string> = {\n\t1: \"file\",\n\t2: \"module\",\n\t3: \"namespace\",\n\t4: \"package\",\n\t5: \"class\",\n\t6: \"method\",\n\t7: \"property\",\n\t8: \"field\",\n\t9: \"constructor\",\n\t10: \"enum\",\n\t11: \"interface\",\n\t12: \"function\",\n\t13: \"variable\",\n\t14: \"constant\",\n\t15: \"string\",\n\t16: \"number\",\n\t17: \"boolean\",\n\t18: \"array\",\n\t19: \"object\",\n\t20: \"key\",\n\t21: \"null\",\n\t22: \"enum member\",\n\t23: \"struct\",\n\t24: \"event\",\n\t25: \"operator\",\n\t26: \"type parameter\",\n};\n\ninterface LspLocation {\n\turi: string;\n\trange: LspRange;\n}\n\ninterface LspLocationLink {\n\ttargetUri: string;\n\ttargetRange: LspRange;\n\ttargetSelectionRange?: LspRange;\n}\n\ninterface LspDocumentSymbol {\n\tname: string;\n\tkind: number;\n\tselectionRange?: LspRange;\n\tlocation?: { range: LspRange };\n\tchildren?: LspDocumentSymbol[];\n}\n\ninterface LspHoverResult {\n\tcontents: unknown;\n}\n\ninterface CallHierarchyItem {\n\tname: string;\n\tkind: number;\n\turi: string;\n\trange: LspRange;\n\tselectionRange?: LspRange;\n}\n\ninterface LspCommand {\n\ttitle?: string;\n\tcommand: string;\n\targuments?: unknown[];\n}\n\ninterface LspCodeAction {\n\ttitle: string;\n\tkind?: string;\n\tedit?: LspWorkspaceEdit;\n\tcommand?: LspCommand;\n}\n\ninterface NormalizedCodeAction {\n\ttitle: string;\n\tkind?: string;\n\tedit?: LspWorkspaceEdit;\n\tcommand?: LspCommand;\n\t/** Raw action payload, used for codeAction/resolve */\n\traw: unknown;\n}\n\nfunction positionLeq(a: LspPosition, b: LspPosition): boolean {\n\treturn a.line < b.line || (a.line === b.line && a.character <= b.character);\n}\n\nfunction rangesOverlap(a: LspRange, b: LspRange): boolean {\n\treturn positionLeq(a.start, b.end) && positionLeq(b.start, a.end);\n}\n\nfunction quoteWindowsArg(arg: string): string {\n\treturn /\\s/.test(arg) ? `\"${arg.replace(/\"/g, '\\\\\"')}\"` : arg;\n}\n\nfunction appendBoundedOutput(current: string, chunk: string): string {\n\tconst next = current + chunk;\n\tif (next.length <= MAX_INSTALL_OUTPUT_CHARS) {\n\t\treturn next;\n\t}\n\treturn next.slice(next.length - MAX_INSTALL_OUTPUT_CHARS);\n}\n\nfunction commandToDisplay(command: readonly string[]): string {\n\treturn command.map((arg) => (/\\s/.test(arg) ? JSON.stringify(arg) : arg)).join(\" \");\n}\n\nexport function runDefaultLspInstallCommand(\n\tcommand: readonly string[],\n\toptions: LspInstallCommandOptions,\n): Promise<LspInstallCommandResult> {\n\tif (command.length === 0) {\n\t\treturn Promise.reject(new Error(\"LSP install command cannot be empty\"));\n\t}\n\tif (options.signal?.aborted) {\n\t\treturn Promise.reject(new Error(\"LSP server install aborted\"));\n\t}\n\n\treturn new Promise((resolve, reject) => {\n\t\tlet output = \"\";\n\t\tlet settled = false;\n\t\tconst child =\n\t\t\tprocess.platform === \"win32\"\n\t\t\t\t? spawn(command.map(quoteWindowsArg).join(\" \"), {\n\t\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\t\tshell: true,\n\t\t\t\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\t\t\t\twindowsHide: true,\n\t\t\t\t\t})\n\t\t\t\t: spawn(command[0], command.slice(1), {\n\t\t\t\t\t\tcwd: options.cwd,\n\t\t\t\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t\t\t\t});\n\n\t\tconst cleanup = (): void => {\n\t\t\toptions.signal?.removeEventListener(\"abort\", onAbort);\n\t\t};\n\t\tconst finish = (result: LspInstallCommandResult): void => {\n\t\t\tif (settled) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsettled = true;\n\t\t\tcleanup();\n\t\t\tresolve(result);\n\t\t};\n\t\tconst fail = (error: Error): void => {\n\t\t\tif (settled) {\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tsettled = true;\n\t\t\tcleanup();\n\t\t\treject(error);\n\t\t};\n\t\tfunction onAbort(): void {\n\t\t\ttry {\n\t\t\t\tchild.kill();\n\t\t\t} catch {\n\t\t\t\t// Process already exited.\n\t\t\t}\n\t\t\tfail(new Error(\"LSP server install aborted\"));\n\t\t}\n\n\t\tchild.stdout?.on(\"data\", (chunk: Buffer) => {\n\t\t\tconst text = chunk.toString(\"utf-8\");\n\t\t\toutput = appendBoundedOutput(output, text);\n\t\t\toptions.onChunk?.(text);\n\t\t});\n\t\tchild.stderr?.on(\"data\", (chunk: Buffer) => {\n\t\t\tconst text = chunk.toString(\"utf-8\");\n\t\t\toutput = appendBoundedOutput(output, text);\n\t\t\toptions.onChunk?.(text);\n\t\t});\n\t\tchild.once(\"error\", (error) => {\n\t\t\tfail(new Error(`Failed to run LSP install command \"${commandToDisplay(command)}\": ${error.message}`));\n\t\t});\n\t\tchild.once(\"close\", (code) => {\n\t\t\tfinish({ exitCode: code, output });\n\t\t});\n\t\toptions.signal?.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n}\n\n/** Normalize codeAction results: bare Commands and CodeAction literals. */\nfunction normalizeCodeActions(result: unknown): NormalizedCodeAction[] {\n\tif (!Array.isArray(result)) {\n\t\treturn [];\n\t}\n\tconst actions: NormalizedCodeAction[] = [];\n\tfor (const item of result) {\n\t\tif (!item || typeof item !== \"object\" || typeof (item as { title?: unknown }).title !== \"string\") {\n\t\t\tcontinue;\n\t\t}\n\t\tconst entry = item as LspCodeAction & { command?: LspCommand | string };\n\t\tif (typeof entry.command === \"string\") {\n\t\t\t// Bare Command shape.\n\t\t\tactions.push({ title: entry.title, command: entry as unknown as LspCommand, raw: item });\n\t\t} else {\n\t\t\tactions.push({ title: entry.title, kind: entry.kind, edit: entry.edit, command: entry.command, raw: item });\n\t\t}\n\t}\n\treturn actions;\n}\n\ntype DocumentSession = { error: string } | { client: LspClient; uri: string; content: string };\n\n/** Normalize definition results: Location | Location[] | LocationLink[] | null. */\nfunction normalizeLocations(result: unknown): LspLocation[] {\n\tif (!result) {\n\t\treturn [];\n\t}\n\tconst items = Array.isArray(result) ? result : [result];\n\tconst locations: LspLocation[] = [];\n\tfor (const item of items) {\n\t\tconst location = item as Partial<LspLocation> & Partial<LspLocationLink>;\n\t\tif (typeof location.uri === \"string\" && location.range) {\n\t\t\tlocations.push({ uri: location.uri, range: location.range });\n\t\t} else if (typeof location.targetUri === \"string\") {\n\t\t\tconst range = location.targetSelectionRange ?? location.targetRange;\n\t\t\tif (range) {\n\t\t\t\tlocations.push({ uri: location.targetUri, range });\n\t\t\t}\n\t\t}\n\t}\n\treturn locations;\n}\n\n/** Extract plain text from LSP hover contents (string | MarkedString[] | MarkupContent). */\nfunction hoverContentsToText(contents: unknown): string {\n\tif (typeof contents === \"string\") {\n\t\treturn contents;\n\t}\n\tif (Array.isArray(contents)) {\n\t\treturn contents\n\t\t\t.map((entry) => hoverContentsToText(entry))\n\t\t\t.filter((text) => text.length > 0)\n\t\t\t.join(\"\\n\\n\");\n\t}\n\tif (contents && typeof contents === \"object\" && \"value\" in contents) {\n\t\tconst value = (contents as { value: unknown }).value;\n\t\treturn typeof value === \"string\" ? value : \"\";\n\t}\n\treturn \"\";\n}\n\n/**\n * Locate a symbol occurrence in document text.\n *\n * Prefers a word-boundary match on the hinted line, then a word-boundary match\n * anywhere in the file, then plain substring matches.\n */\nfunction findSymbolPosition(content: string, symbol: string, line?: number): LspPosition | undefined {\n\tconst lines = content.split(\"\\n\");\n\tconst escaped = symbol.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n\tconst wordPattern = new RegExp(`(?<![\\\\w$])${escaped}(?![\\\\w$])`);\n\n\tconst searchLine = (index: number): LspPosition | undefined => {\n\t\tconst text = lines[index];\n\t\tif (text === undefined) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst wordMatch = wordPattern.exec(text);\n\t\tif (wordMatch) {\n\t\t\treturn { line: index, character: wordMatch.index };\n\t\t}\n\t\tconst plainIndex = text.indexOf(symbol);\n\t\treturn plainIndex === -1 ? undefined : { line: index, character: plainIndex };\n\t};\n\n\tif (line !== undefined && line >= 1 && line <= lines.length) {\n\t\tconst position = searchLine(line - 1);\n\t\tif (position) {\n\t\t\treturn position;\n\t\t}\n\t}\n\tfor (let index = 0; index < lines.length; index++) {\n\t\tconst text = lines[index];\n\t\tconst wordMatch = wordPattern.exec(text);\n\t\tif (wordMatch) {\n\t\t\treturn { line: index, character: wordMatch.index };\n\t\t}\n\t}\n\tfor (let index = 0; index < lines.length; index++) {\n\t\tconst plainIndex = lines[index].indexOf(symbol);\n\t\tif (plainIndex !== -1) {\n\t\t\treturn { line: index, character: plainIndex };\n\t\t}\n\t}\n\treturn undefined;\n}\n\nexport class LspManager implements ToolDiagnosticsProvider, LspNavigationProvider {\n\tprivate cwd: string;\n\tprivate config: ResolvedLspConfig;\n\tprivate clients = new Map<string, LspClient>();\n\tprivate startFailures = new Map<string, ServerFailureState>();\n\tprivate hostInteraction: HostInteraction | undefined;\n\tprivate installRunner: LspInstallRunner;\n\tprivate installPromptsUsed = new Set<string>();\n\tprivate installAttempts = new Map<string, Promise<LspInstallAttemptResult>>();\n\tprivate disposed = false;\n\t/** Summaries of WorkspaceEdits applied via server-initiated workspace/applyEdit */\n\tprivate serverApplyEditSummaries: string[] = [];\n\tprivate lastUsedAt = new Map<string, number>();\n\tprivate idleTimer: NodeJS.Timeout | undefined;\n\tprivate tracer: LspTracer | undefined;\n\n\tconstructor(options: LspManagerOptions) {\n\t\tthis.cwd = options.cwd;\n\t\tthis.config = options.config;\n\t\tthis.hostInteraction = options.hostInteraction;\n\t\tthis.installRunner = options.installRunner ?? runDefaultLspInstallCommand;\n\t\tif (this.config.traceFile) {\n\t\t\tthis.tracer = new LspTracer(this.config.traceFile);\n\t\t}\n\t\tif (this.config.idleShutdownMs > 0) {\n\t\t\tconst checkIntervalMs = Math.max(250, Math.min(this.config.idleShutdownMs / 2, 60000));\n\t\t\tthis.idleTimer = setInterval(() => this.shutdownIdleClients(), checkIntervalMs);\n\t\t\tthis.idleTimer.unref();\n\t\t}\n\t}\n\n\tsetHostInteraction(hostInteraction: HostInteraction | undefined): void {\n\t\tthis.hostInteraction = hostInteraction;\n\t}\n\n\t/** Status of all spawned language servers. */\n\tgetStatus(): LspServerStatus[] {\n\t\tconst now = Date.now();\n\t\treturn [...this.clients.entries()].map(([key, client]) => {\n\t\t\tconst [name, root] = key.split(\"\\u0000\");\n\t\t\treturn {\n\t\t\t\tname,\n\t\t\t\troot,\n\t\t\t\talive: client.isAlive,\n\t\t\t\topenDocuments: client.openDocumentCount,\n\t\t\t\tidleMs: now - (this.lastUsedAt.get(key) ?? now),\n\t\t\t};\n\t\t});\n\t}\n\n\t/** Path of the active trace file, if tracing is enabled. */\n\tgetTraceFile(): string | undefined {\n\t\treturn this.tracer?.filePath;\n\t}\n\n\t/** Enable or disable protocol tracing for current and future servers. */\n\tasync setTraceFile(filePath: string | undefined): Promise<void> {\n\t\tconst previousTracer = this.tracer;\n\t\tthis.tracer = filePath ? new LspTracer(filePath) : undefined;\n\t\tfor (const client of this.clients.values()) {\n\t\t\tclient.setTracer(this.tracer);\n\t\t}\n\t\tawait previousTracer?.dispose();\n\t}\n\n\t/** Synchronously stop tracing during non-awaitable process teardown. */\n\tcloseTraceSync(): void {\n\t\tconst previousTracer = this.tracer;\n\t\tthis.tracer = undefined;\n\t\tfor (const client of this.clients.values()) {\n\t\t\tclient.setTracer(undefined);\n\t\t}\n\t\tpreviousTracer?.disposeSync();\n\t}\n\n\t/** Dispose all running servers. They respawn lazily on next use. Returns the number stopped. */\n\trestart(): number {\n\t\tconst count = this.clients.size;\n\t\tfor (const client of this.clients.values()) {\n\t\t\tclient.dispose();\n\t\t}\n\t\tthis.clients.clear();\n\t\tthis.lastUsedAt.clear();\n\t\tthis.startFailures.clear();\n\t\tthis.installPromptsUsed.clear();\n\t\tthis.installAttempts.clear();\n\t\treturn count;\n\t}\n\n\tprivate shutdownIdleClients(): void {\n\t\tif (this.disposed) {\n\t\t\treturn;\n\t\t}\n\t\tconst now = Date.now();\n\t\tfor (const [key, client] of [...this.clients.entries()]) {\n\t\t\tconst lastUsed = this.lastUsedAt.get(key) ?? now;\n\t\t\tif (now - lastUsed >= this.config.idleShutdownMs) {\n\t\t\t\tclient.dispose();\n\t\t\t\tthis.clients.delete(key);\n\t\t\t\tthis.lastUsedAt.delete(key);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Collect diagnostics for a file that was just written.\n\t *\n\t * Also reports other open files that went from clean to failing as a result\n\t * of this change (best-effort: depends on the server republishing for open\n\t * documents within the settle window).\n\t *\n\t * Returns formatted diagnostics text, or undefined when no matching server\n\t * is configured, the server is unavailable, or there is nothing to report.\n\t */\n\tasync getDiagnostics(absolutePath: string, content: string, signal?: AbortSignal): Promise<string | undefined> {\n\t\tif (this.disposed) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst server = this.findServer(absolutePath);\n\t\tif (!server) {\n\t\t\treturn undefined;\n\t\t}\n\n\t\twhile (!this.disposed) {\n\t\t\tconst failure = this.startFailures.get(server.name);\n\t\t\tif (failure && failure.count >= MAX_START_ATTEMPTS) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\n\t\t\tconst client = this.getClient(server, absolutePath);\n\t\t\tconst cleanBefore = this.collectCleanOpenDocuments(client, absolutePath);\n\t\t\tlet diagnostics: LspDiagnostic[];\n\t\t\ttry {\n\t\t\t\tdiagnostics = await client.getDiagnostics(\n\t\t\t\t\tabsolutePath,\n\t\t\t\t\tcontent,\n\t\t\t\t\tthis.config.settleMs,\n\t\t\t\t\tthis.config.firstSettleMs,\n\t\t\t\t\tsignal,\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\tconst result = await this.handleClientError(server, client, error, signal);\n\t\t\t\tif (result.retry) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\treturn result.message;\n\t\t\t}\n\t\t\tif (this.disposed) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\tthis.startFailures.delete(server.name);\n\n\t\t\tconst ownDiagnostics = this.formatDiagnostics(absolutePath, diagnostics);\n\t\t\tconst crossFile = this.formatNewlyFailing(client, absolutePath, cleanBefore);\n\t\t\tif (ownDiagnostics && crossFile) {\n\t\t\t\treturn `${ownDiagnostics}\\n${crossFile}`;\n\t\t\t}\n\t\t\treturn ownDiagnostics ?? crossFile;\n\t\t}\n\n\t\treturn undefined;\n\t}\n\n\t/** Paths of other open documents that currently have no reportable diagnostics. */\n\tprivate collectCleanOpenDocuments(client: LspClient, excludePath: string): Set<string> {\n\t\tconst clean = new Set<string>();\n\t\tfor (const path of client.getOpenDocumentPaths()) {\n\t\t\tif (path === excludePath) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst reportable = client\n\t\t\t\t.getPublishedDiagnostics(path)\n\t\t\t\t.filter((diagnostic) => (diagnostic.severity ?? 1) <= this.config.maxSeverity);\n\t\t\tif (reportable.length === 0) {\n\t\t\t\tclean.add(path);\n\t\t\t}\n\t\t}\n\t\treturn clean;\n\t}\n\n\t/** Report open documents that went from clean to failing since the snapshot. */\n\tprivate formatNewlyFailing(client: LspClient, excludePath: string, cleanBefore: Set<string>): string | undefined {\n\t\tconst sections: string[] = [];\n\t\tfor (const path of client.getOpenDocumentPaths()) {\n\t\t\tif (path === excludePath || !cleanBefore.has(path)) {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tconst formatted = this.formatDiagnostics(path, client.getPublishedDiagnostics(path));\n\t\t\tif (formatted) {\n\t\t\t\tsections.push(formatted);\n\t\t\t}\n\t\t}\n\t\tif (sections.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst shown = sections.slice(0, MAX_CROSS_FILE_REPORTS);\n\t\tif (sections.length > shown.length) {\n\t\t\tshown.push(\n\t\t\t\t`... and ${sections.length - shown.length} more file${sections.length - shown.length === 1 ? \"\" : \"s\"}`,\n\t\t\t);\n\t\t}\n\t\treturn `Newly failing in other open files:\\n${shown.join(\"\\n\")}`;\n\t}\n\n\tdispose(): void {\n\t\tthis.disposed = true;\n\t\tif (this.idleTimer) {\n\t\t\tclearInterval(this.idleTimer);\n\t\t\tthis.idleTimer = undefined;\n\t\t}\n\t\tfor (const client of this.clients.values()) {\n\t\t\tclient.dispose();\n\t\t}\n\t\tthis.clients.clear();\n\t\tthis.lastUsedAt.clear();\n\t\tthis.installAttempts.clear();\n\t\tvoid this.tracer?.dispose();\n\t\tthis.tracer = undefined;\n\t}\n\n\t// =========================================================================\n\t// Navigation (LspNavigationProvider)\n\t// =========================================================================\n\n\tasync definition(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string> {\n\t\treturn this.locationQuery(\"textDocument/definition\", \"definition\", absolutePath, symbol, line, signal);\n\t}\n\n\tasync references(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string> {\n\t\treturn this.locationQuery(\"textDocument/references\", \"references\", absolutePath, symbol, line, signal);\n\t}\n\n\tasync implementations(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string> {\n\t\treturn this.locationQuery(\"textDocument/implementation\", \"implementations\", absolutePath, symbol, line, signal);\n\t}\n\n\tasync typeDefinition(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string> {\n\t\treturn this.locationQuery(\"textDocument/typeDefinition\", \"type definition\", absolutePath, symbol, line, signal);\n\t}\n\n\tasync hover(absolutePath: string, symbol: string, line?: number, signal?: AbortSignal): Promise<string> {\n\t\tconst session = await this.openSession(absolutePath, signal);\n\t\tif (\"error\" in session) {\n\t\t\treturn session.error;\n\t\t}\n\t\tconst position = findSymbolPosition(session.content, symbol, line);\n\t\tif (!position) {\n\t\t\treturn `Symbol \"${symbol}\" not found in ${this.displayPath(absolutePath)}.`;\n\t\t}\n\t\ttry {\n\t\t\tconst result = (await session.client.sendRequest(\n\t\t\t\t\"textDocument/hover\",\n\t\t\t\t{ textDocument: { uri: session.uri }, position },\n\t\t\t\tsignal,\n\t\t\t)) as LspHoverResult | null;\n\t\t\tconst text = result ? hoverContentsToText(result.contents).trim() : \"\";\n\t\t\treturn text.length > 0 ? text : `No hover information for \"${symbol}\".`;\n\t\t} catch (error) {\n\t\t\treturn this.describeRequestError(absolutePath, error);\n\t\t}\n\t}\n\n\tasync documentSymbols(absolutePath: string, signal?: AbortSignal): Promise<string> {\n\t\tconst session = await this.openSession(absolutePath, signal);\n\t\tif (\"error\" in session) {\n\t\t\treturn session.error;\n\t\t}\n\t\ttry {\n\t\t\tconst result = (await session.client.sendRequest(\n\t\t\t\t\"textDocument/documentSymbol\",\n\t\t\t\t{ textDocument: { uri: session.uri } },\n\t\t\t\tsignal,\n\t\t\t)) as LspDocumentSymbol[] | null;\n\t\t\tif (!result || result.length === 0) {\n\t\t\t\treturn `No symbols found in ${this.displayPath(absolutePath)}.`;\n\t\t\t}\n\t\t\tconst lines: string[] = [];\n\t\t\tthis.appendSymbolLines(result, 0, lines);\n\t\t\tif (lines.length > MAX_SYMBOL_LINES) {\n\t\t\t\tconst extra = lines.length - MAX_SYMBOL_LINES;\n\t\t\t\treturn [...lines.slice(0, MAX_SYMBOL_LINES), `... and ${extra} more`].join(\"\\n\");\n\t\t\t}\n\t\t\treturn lines.join(\"\\n\");\n\t\t} catch (error) {\n\t\t\treturn this.describeRequestError(absolutePath, error);\n\t\t}\n\t}\n\n\tasync callHierarchy(\n\t\tabsolutePath: string,\n\t\tsymbol: string,\n\t\tdirection: \"incoming\" | \"outgoing\",\n\t\tline?: number,\n\t\tsignal?: AbortSignal,\n\t): Promise<string> {\n\t\tconst session = await this.openSession(absolutePath, signal);\n\t\tif (\"error\" in session) {\n\t\t\treturn session.error;\n\t\t}\n\t\tconst position = findSymbolPosition(session.content, symbol, line);\n\t\tif (!position) {\n\t\t\treturn `Symbol \"${symbol}\" not found in ${this.displayPath(absolutePath)}.`;\n\t\t}\n\t\ttry {\n\t\t\tconst items = (await session.client.sendRequest(\n\t\t\t\t\"textDocument/prepareCallHierarchy\",\n\t\t\t\t{ textDocument: { uri: session.uri }, position },\n\t\t\t\tsignal,\n\t\t\t)) as CallHierarchyItem[] | null;\n\t\t\tif (!items || items.length === 0) {\n\t\t\t\treturn `No call hierarchy available for \"${symbol}\" (it may not be a callable symbol).`;\n\t\t\t}\n\t\t\tconst item = items[0];\n\t\t\tconst label = direction === \"incoming\" ? \"callers of\" : \"calls made by\";\n\t\t\tconst method = direction === \"incoming\" ? \"callHierarchy/incomingCalls\" : \"callHierarchy/outgoingCalls\";\n\t\t\tconst calls = (await session.client.sendRequest(method, { item }, signal)) as Array<{\n\t\t\t\tfrom?: CallHierarchyItem;\n\t\t\t\tto?: CallHierarchyItem;\n\t\t\t}> | null;\n\t\t\tif (!calls || calls.length === 0) {\n\t\t\t\treturn `No ${label} \"${item.name}\" found.`;\n\t\t\t}\n\t\t\tconst shown = calls.slice(0, MAX_REFERENCES);\n\t\t\tconst lines: string[] = [`${direction === \"incoming\" ? \"Callers of\" : \"Calls made by\"} \"${item.name}\":`];\n\t\t\tfor (const call of shown) {\n\t\t\t\tconst target = direction === \"incoming\" ? call.from : call.to;\n\t\t\t\tif (!target) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tconst kind = SYMBOL_KIND_NAMES[target.kind] ?? \"symbol\";\n\t\t\t\tconst path = this.displayPath(uriToPath(target.uri));\n\t\t\t\tconst targetLine = (target.selectionRange ?? target.range).start.line + 1;\n\t\t\t\tlines.push(`${target.name} (${kind}) ${path}:${targetLine}`);\n\t\t\t}\n\t\t\tif (calls.length > shown.length) {\n\t\t\t\tlines.push(`... and ${calls.length - shown.length} more`);\n\t\t\t}\n\t\t\treturn lines.join(\"\\n\");\n\t\t} catch (error) {\n\t\t\treturn this.describeRequestError(absolutePath, error);\n\t\t}\n\t}\n\n\tasync workspaceSymbols(absolutePath: string, query: string, signal?: AbortSignal): Promise<string> {\n\t\tconst session = await this.openSession(absolutePath, signal);\n\t\tif (\"error\" in session) {\n\t\t\treturn session.error;\n\t\t}\n\t\ttry {\n\t\t\tconst result = (await session.client.sendRequest(\"workspace/symbol\", { query }, signal)) as Array<{\n\t\t\t\tname: string;\n\t\t\t\tkind: number;\n\t\t\t\tcontainerName?: string;\n\t\t\t\tlocation?: { uri: string; range?: LspRange };\n\t\t\t}> | null;\n\t\t\tif (!result || result.length === 0) {\n\t\t\t\treturn `No workspace symbols matching \"${query}\".`;\n\t\t\t}\n\t\t\tconst shown = result.slice(0, MAX_REFERENCES);\n\t\t\tconst lines = shown.map((symbol) => {\n\t\t\t\tconst kind = SYMBOL_KIND_NAMES[symbol.kind] ?? \"symbol\";\n\t\t\t\tconst container = symbol.containerName ? ` in ${symbol.containerName}` : \"\";\n\t\t\t\tlet location = \"\";\n\t\t\t\tif (symbol.location?.uri) {\n\t\t\t\t\tconst path = this.displayPath(uriToPath(symbol.location.uri));\n\t\t\t\t\tconst line = symbol.location.range ? `:${symbol.location.range.start.line + 1}` : \"\";\n\t\t\t\t\tlocation = ` ${path}${line}`;\n\t\t\t\t}\n\t\t\t\treturn `${symbol.name} (${kind})${container}${location}`;\n\t\t\t});\n\t\t\tif (result.length > shown.length) {\n\t\t\t\tlines.push(`... and ${result.length - shown.length} more`);\n\t\t\t}\n\t\t\treturn lines.join(\"\\n\");\n\t\t} catch (error) {\n\t\t\treturn this.describeRequestError(absolutePath, error);\n\t\t}\n\t}\n\n\tasync fileDiagnostics(absolutePath: string, signal?: AbortSignal): Promise<string> {\n\t\t// openSession applies the start-failure breaker and failure accounting,\n\t\t// so a broken server is not respawned on every diagnostics request.\n\t\tconst session = await this.openSession(absolutePath, signal);\n\t\tif (\"error\" in session) {\n\t\t\treturn session.error;\n\t\t}\n\t\ttry {\n\t\t\tconst diagnostics = await session.client.getDiagnostics(\n\t\t\t\tabsolutePath,\n\t\t\t\tsession.content,\n\t\t\t\tthis.config.settleMs,\n\t\t\t\tthis.config.firstSettleMs,\n\t\t\t\tsignal,\n\t\t\t);\n\t\t\treturn (\n\t\t\t\tthis.formatDiagnostics(absolutePath, diagnostics) ?? `No diagnostics in ${this.displayPath(absolutePath)}.`\n\t\t\t);\n\t\t} catch (error) {\n\t\t\treturn this.describeRequestError(absolutePath, error);\n\t\t}\n\t}\n\n\tprivate async locationQuery(\n\t\tmethod: string,\n\t\tlabel: string,\n\t\tabsolutePath: string,\n\t\tsymbol: string,\n\t\tline?: number,\n\t\tsignal?: AbortSignal,\n\t): Promise<string> {\n\t\tconst session = await this.openSession(absolutePath, signal);\n\t\tif (\"error\" in session) {\n\t\t\treturn session.error;\n\t\t}\n\t\tconst position = findSymbolPosition(session.content, symbol, line);\n\t\tif (!position) {\n\t\t\treturn `Symbol \"${symbol}\" not found in ${this.displayPath(absolutePath)}.`;\n\t\t}\n\t\ttry {\n\t\t\tconst result = await session.client.sendRequest(\n\t\t\t\tmethod,\n\t\t\t\t{\n\t\t\t\t\ttextDocument: { uri: session.uri },\n\t\t\t\t\tposition,\n\t\t\t\t\t...(method === \"textDocument/references\" ? { context: { includeDeclaration: true } } : {}),\n\t\t\t\t},\n\t\t\t\tsignal,\n\t\t\t);\n\t\t\tconst locations = normalizeLocations(result);\n\t\t\tif (locations.length === 0) {\n\t\t\t\treturn `No ${label} found for \"${symbol}\".`;\n\t\t\t}\n\t\t\tconst shown = locations.slice(0, MAX_REFERENCES);\n\t\t\tconst lines = await Promise.all(shown.map((location) => this.formatLocation(location)));\n\t\t\tif (locations.length > shown.length) {\n\t\t\t\tlines.push(`... and ${locations.length - shown.length} more`);\n\t\t\t}\n\t\t\treturn lines.join(\"\\n\");\n\t\t} catch (error) {\n\t\t\treturn this.describeRequestError(absolutePath, error);\n\t\t}\n\t}\n\n\t/** Route a file to its server, read it from disk, and sync it. Returns an error message on failure. */\n\tprivate async openSession(absolutePath: string, signal?: AbortSignal): Promise<DocumentSession> {\n\t\tconst server = this.findServer(absolutePath);\n\t\tif (!server) {\n\t\t\treturn { error: this.noServerMessage(absolutePath) };\n\t\t}\n\t\tlet content: string;\n\t\ttry {\n\t\t\tcontent = await readFile(absolutePath, \"utf-8\");\n\t\t} catch (error) {\n\t\t\treturn {\n\t\t\t\terror: `Could not read ${this.displayPath(absolutePath)}: ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t};\n\t\t}\n\n\t\twhile (!this.disposed) {\n\t\t\tconst failure = this.startFailures.get(server.name);\n\t\t\tif (failure && failure.count >= MAX_START_ATTEMPTS) {\n\t\t\t\treturn { error: `lsp(${server.name}): server unavailable after ${failure.count} failed starts.` };\n\t\t\t}\n\t\t\tconst client = this.getClient(server, absolutePath);\n\t\t\ttry {\n\t\t\t\tconst uri = await client.openDocument(absolutePath, content);\n\t\t\t\tawait this.refreshStale(client, absolutePath);\n\t\t\t\tthis.startFailures.delete(server.name);\n\t\t\t\treturn { client, uri, content };\n\t\t\t} catch (error) {\n\t\t\t\tconst result = await this.handleClientError(server, client, error, signal);\n\t\t\t\tif (result.retry) {\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\terror:\n\t\t\t\t\t\tresult.message ?? `lsp(${server.name}): ${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\n\t\treturn { error: `lsp(${server.name}): LSP manager disposed.` };\n\t}\n\n\tasync rename(\n\t\tabsolutePath: string,\n\t\tsymbol: string,\n\t\tnewName: string,\n\t\tline?: number,\n\t\tsignal?: AbortSignal,\n\t): Promise<string> {\n\t\tconst session = await this.openSession(absolutePath, signal);\n\t\tif (\"error\" in session) {\n\t\t\treturn session.error;\n\t\t}\n\t\tconst position = findSymbolPosition(session.content, symbol, line);\n\t\tif (!position) {\n\t\t\treturn `Symbol \"${symbol}\" not found in ${this.displayPath(absolutePath)}.`;\n\t\t}\n\t\ttry {\n\t\t\tconst result = (await session.client.sendRequest(\n\t\t\t\t\"textDocument/rename\",\n\t\t\t\t{ textDocument: { uri: session.uri }, position, newName },\n\t\t\t\tsignal,\n\t\t\t)) as LspWorkspaceEdit | null;\n\t\t\tif (!result || normalizeWorkspaceEdit(result).length === 0) {\n\t\t\t\treturn `Rename of \"${symbol}\" is not available at this position.`;\n\t\t\t}\n\t\t\tconst { summary } = await this.applyWorkspaceEdit(session.client, result);\n\t\t\treturn `Renamed \"${symbol}\" to \"${newName}\":\\n${summary}`;\n\t\t} catch (error) {\n\t\t\treturn this.describeRequestError(absolutePath, error);\n\t\t}\n\t}\n\n\tasync codeFix(\n\t\tabsolutePath: string,\n\t\toptions: { symbol?: string; line?: number; title?: string; kind?: string },\n\t\tsignal?: AbortSignal,\n\t): Promise<string> {\n\t\tconst session = await this.openSession(absolutePath, signal);\n\t\tif (\"error\" in session) {\n\t\t\treturn session.error;\n\t\t}\n\t\tconst contentLines = session.content.split(\"\\n\");\n\t\tlet range: LspRange;\n\t\tif (options.symbol) {\n\t\t\tconst position = findSymbolPosition(session.content, options.symbol, options.line);\n\t\t\tif (!position) {\n\t\t\t\treturn `Symbol \"${options.symbol}\" not found in ${this.displayPath(absolutePath)}.`;\n\t\t\t}\n\t\t\trange = {\n\t\t\t\tstart: position,\n\t\t\t\tend: { line: position.line, character: position.character + options.symbol.length },\n\t\t\t};\n\t\t} else if (options.line !== undefined && options.line >= 1 && options.line <= contentLines.length) {\n\t\t\tconst lineIndex = options.line - 1;\n\t\t\trange = {\n\t\t\t\tstart: { line: lineIndex, character: 0 },\n\t\t\t\tend: { line: lineIndex, character: contentLines[lineIndex].length },\n\t\t\t};\n\t\t} else {\n\t\t\trange = {\n\t\t\t\tstart: { line: 0, character: 0 },\n\t\t\t\tend: {\n\t\t\t\t\tline: Math.max(0, contentLines.length - 1),\n\t\t\t\t\tcharacter: contentLines[contentLines.length - 1]?.length ?? 0,\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\t// Servers derive quick fixes from the diagnostics passed in the context,\n\t\t// so make sure we have them before asking for code actions.\n\t\tlet published = session.client.getPublishedDiagnostics(absolutePath);\n\t\tif (published.length === 0) {\n\t\t\ttry {\n\t\t\t\tpublished = await session.client.getDiagnostics(\n\t\t\t\t\tabsolutePath,\n\t\t\t\t\tsession.content,\n\t\t\t\t\tthis.config.settleMs,\n\t\t\t\t\tthis.config.firstSettleMs,\n\t\t\t\t\tsignal,\n\t\t\t\t);\n\t\t\t} catch {\n\t\t\t\t// Code actions may still be available without diagnostics context.\n\t\t\t}\n\t\t}\n\t\tconst diagnostics = published.filter((diagnostic) => rangesOverlap(diagnostic.range, range));\n\t\ttry {\n\t\t\tconst result = await session.client.sendRequest(\n\t\t\t\t\"textDocument/codeAction\",\n\t\t\t\t{\n\t\t\t\t\ttextDocument: { uri: session.uri },\n\t\t\t\t\trange,\n\t\t\t\t\tcontext: { diagnostics, ...(options.kind ? { only: [options.kind] } : {}) },\n\t\t\t\t},\n\t\t\t\tsignal,\n\t\t\t);\n\t\t\tconst actions = normalizeCodeActions(result);\n\t\t\tif (actions.length === 0) {\n\t\t\t\treturn \"No code actions available at this position.\";\n\t\t\t}\n\t\t\tconst describe = (action: NormalizedCodeAction): string =>\n\t\t\t\t`- ${action.title}${action.kind ? ` (${action.kind})` : \"\"}`;\n\t\t\tlet chosen: NormalizedCodeAction | undefined;\n\t\t\tif (options.title) {\n\t\t\t\tconst wanted = options.title.toLowerCase();\n\t\t\t\tchosen =\n\t\t\t\t\tactions.find((action) => action.title.toLowerCase() === wanted) ??\n\t\t\t\t\tactions.find((action) => action.title.toLowerCase().includes(wanted));\n\t\t\t\tif (!chosen) {\n\t\t\t\t\treturn `No code action matching \"${options.title}\". Available:\\n${actions.map(describe).join(\"\\n\")}`;\n\t\t\t\t}\n\t\t\t} else if (actions.length === 1) {\n\t\t\t\tchosen = actions[0];\n\t\t\t} else {\n\t\t\t\treturn `Multiple code actions available; rerun with a title to apply one:\\n${actions.map(describe).join(\"\\n\")}`;\n\t\t\t}\n\t\t\treturn await this.applyCodeAction(session.client, chosen, signal);\n\t\t} catch (error) {\n\t\t\treturn this.describeRequestError(absolutePath, error);\n\t\t}\n\t}\n\n\tprivate async applyCodeAction(\n\t\tclient: LspClient,\n\t\taction: NormalizedCodeAction,\n\t\tsignal?: AbortSignal,\n\t): Promise<string> {\n\t\tlet edit = action.edit;\n\t\tif (!edit) {\n\t\t\t// Servers may defer the edit to codeAction/resolve.\n\t\t\ttry {\n\t\t\t\tconst resolved = (await client.sendRequest(\"codeAction/resolve\", action.raw, signal)) as {\n\t\t\t\t\tedit?: LspWorkspaceEdit;\n\t\t\t\t} | null;\n\t\t\t\tedit = resolved?.edit;\n\t\t\t} catch {\n\t\t\t\t// Fall back to the command below.\n\t\t\t}\n\t\t}\n\t\tif (edit && normalizeWorkspaceEdit(edit).length > 0) {\n\t\t\tconst { summary } = await this.applyWorkspaceEdit(client, edit);\n\t\t\treturn `Applied \"${action.title}\":\\n${summary}`;\n\t\t}\n\t\tif (action.command) {\n\t\t\t// Command-based actions apply their edits via workspace/applyEdit.\n\t\t\tthis.serverApplyEditSummaries = [];\n\t\t\tawait client.sendRequest(\n\t\t\t\t\"workspace/executeCommand\",\n\t\t\t\t{ command: action.command.command, arguments: action.command.arguments ?? [] },\n\t\t\t\tsignal,\n\t\t\t);\n\t\t\tconst summaries = this.serverApplyEditSummaries;\n\t\t\tthis.serverApplyEditSummaries = [];\n\t\t\tif (summaries.length > 0) {\n\t\t\t\treturn `Applied \"${action.title}\":\\n${summaries.join(\"\\n\")}`;\n\t\t\t}\n\t\t\treturn `Executed \"${action.title}\" (no workspace edits reported).`;\n\t\t}\n\t\treturn `Code action \"${action.title}\" produced no edits.`;\n\t}\n\n\t/**\n\t * Apply a WorkspaceEdit to disk, re-sync open documents, and notify the\n\t * server about files it does not have open.\n\t */\n\tprivate async applyWorkspaceEdit(\n\t\tclient: LspClient,\n\t\tedit: LspWorkspaceEdit,\n\t): Promise<{ summary: string; changedPaths: string[] }> {\n\t\tconst operations = normalizeWorkspaceEdit(edit);\n\t\tfor (const operation of operations) {\n\t\t\tthis.assertWorkspaceEditOperationInRoot(client, operation);\n\t\t}\n\n\t\tconst lines: string[] = [];\n\t\tconst changedPaths: string[] = [];\n\t\tfor (const operation of operations) {\n\t\t\tif (operation.kind === \"edit\") {\n\t\t\t\tconst path = uriToPath(operation.uri);\n\t\t\t\tawait withFileMutationQueue(path, async () => {\n\t\t\t\t\tconst content = await readFile(path, \"utf-8\").catch(() => \"\");\n\t\t\t\t\tawait writeFile(path, applyTextEdits(content, operation.edits), \"utf-8\");\n\t\t\t\t});\n\t\t\t\tchangedPaths.push(path);\n\t\t\t\tlines.push(\n\t\t\t\t\t`${this.displayPath(path)} (${operation.edits.length} edit${operation.edits.length === 1 ? \"\" : \"s\"})`,\n\t\t\t\t);\n\t\t\t} else if (operation.kind === \"create\") {\n\t\t\t\tconst path = uriToPath(operation.uri);\n\t\t\t\tawait mkdir(dirname(path), { recursive: true });\n\t\t\t\tawait writeFile(path, \"\", { flag: \"a\" });\n\t\t\t\tchangedPaths.push(path);\n\t\t\t\tlines.push(`created ${this.displayPath(path)}`);\n\t\t\t} else if (operation.kind === \"rename\") {\n\t\t\t\tconst oldPath = uriToPath(operation.oldUri);\n\t\t\t\tconst newPath = uriToPath(operation.newUri);\n\t\t\t\tawait mkdir(dirname(newPath), { recursive: true });\n\t\t\t\tawait fsRename(oldPath, newPath);\n\t\t\t\tchangedPaths.push(newPath);\n\t\t\t\tlines.push(`renamed ${this.displayPath(oldPath)} -> ${this.displayPath(newPath)}`);\n\t\t\t} else {\n\t\t\t\tconst path = uriToPath(operation.uri);\n\t\t\t\tawait rm(path, { force: true });\n\t\t\t\tlines.push(`deleted ${this.displayPath(path)}`);\n\t\t\t}\n\t\t}\n\n\t\tconst unopenedPaths: string[] = [];\n\t\tfor (const path of changedPaths) {\n\t\t\tif (client.isDocumentOpen(path)) {\n\t\t\t\tconst content = await readFile(path, \"utf-8\").catch(() => undefined);\n\t\t\t\tif (content !== undefined) {\n\t\t\t\t\tawait client.openDocument(path, content);\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tunopenedPaths.push(path);\n\t\t\t}\n\t\t}\n\t\tclient.notifyFilesChanged(unopenedPaths);\n\t\treturn { summary: lines.join(\"\\n\"), changedPaths };\n\t}\n\n\tprivate assertWorkspaceEditOperationInRoot(client: LspClient, operation: NormalizedWorkspaceOperation): void {\n\t\tif (operation.kind === \"rename\") {\n\t\t\tthis.assertWorkspaceEditPathInRoot(client, uriToPath(operation.oldUri));\n\t\t\tthis.assertWorkspaceEditPathInRoot(client, uriToPath(operation.newUri));\n\t\t\treturn;\n\t\t}\n\t\tthis.assertWorkspaceEditPathInRoot(client, uriToPath(operation.uri));\n\t}\n\n\tprivate assertWorkspaceEditPathInRoot(client: LspClient, absolutePath: string): void {\n\t\tif (!isPathInsideRoot(client.rootDir, absolutePath)) {\n\t\t\tthrow new Error(\n\t\t\t\t`Refusing to apply LSP workspace edit outside workspace root: ${this.displayPath(absolutePath)}`,\n\t\t\t);\n\t\t}\n\t}\n\n\t/** Re-sync open documents that changed on disk outside edit/write (best-effort). */\n\tprivate async refreshStale(client: LspClient, excludePath: string): Promise<void> {\n\t\ttry {\n\t\t\tawait client.refreshStaleDocuments(excludePath);\n\t\t} catch {\n\t\t\t// Staleness refresh must never fail the operation that triggered it.\n\t\t}\n\t}\n\n\tprivate appendSymbolLines(symbols: LspDocumentSymbol[], depth: number, lines: string[]): void {\n\t\tfor (const symbol of symbols) {\n\t\t\tconst range = symbol.selectionRange ?? symbol.location?.range;\n\t\t\tconst line = range ? `:${range.start.line + 1}` : \"\";\n\t\t\tconst kind = SYMBOL_KIND_NAMES[symbol.kind] ?? \"symbol\";\n\t\t\tlines.push(`${\"  \".repeat(depth)}${symbol.name} (${kind})${line}`);\n\t\t\tif (symbol.children && symbol.children.length > 0) {\n\t\t\t\tthis.appendSymbolLines(symbol.children, depth + 1, lines);\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate async formatLocation(location: LspLocation): Promise<string> {\n\t\tconst path = uriToPath(location.uri);\n\t\tconst line = location.range.start.line + 1;\n\t\tconst column = location.range.start.character + 1;\n\t\tlet snippet = \"\";\n\t\ttry {\n\t\t\tconst content = await readFile(path, \"utf-8\");\n\t\t\tconst text = content.split(\"\\n\")[location.range.start.line]?.trim();\n\t\t\tif (text) {\n\t\t\t\tsnippet = `  ${text}`;\n\t\t\t}\n\t\t} catch {\n\t\t\t// Snippets are best-effort.\n\t\t}\n\t\treturn `${this.displayPath(path)}:${line}:${column}${snippet}`;\n\t}\n\n\tprivate noServerMessage(absolutePath: string): string {\n\t\tconst ext = extname(absolutePath) || \"(no extension)\";\n\t\treturn `No language server configured for ${ext} files. Configure one under lsp.servers in settings.`;\n\t}\n\n\tprivate describeRequestError(absolutePath: string, error: unknown): string {\n\t\tconst server = this.findServer(absolutePath);\n\t\tconst name = server?.name ?? \"unknown\";\n\t\treturn `lsp(${name}): ${error instanceof Error ? error.message : String(error)}`;\n\t}\n\n\tprivate displayPath(absolutePath: string): string {\n\t\tconst rel = relative(this.cwd, absolutePath);\n\t\treturn rel && !rel.startsWith(\"..\") && !isAbsolute(rel) ? rel : absolutePath;\n\t}\n\n\tprivate findServer(absolutePath: string): ResolvedLspServerConfig | undefined {\n\t\tconst ext = extname(absolutePath).toLowerCase();\n\t\tif (!ext) {\n\t\t\treturn undefined;\n\t\t}\n\t\treturn this.config.servers.find((server) => server.fileExtensions.includes(ext));\n\t}\n\n\tprivate findRoot(absolutePath: string, rootMarkers: string[]): string {\n\t\t// Markers are priority-ordered: a tsconfig.json anywhere up the tree beats\n\t\t// a closer package.json. This keeps monorepo subpackages rooted at the\n\t\t// directory that actually carries the language configuration.\n\t\tfor (const marker of rootMarkers) {\n\t\t\tlet dir = dirname(absolutePath);\n\t\t\twhile (true) {\n\t\t\t\tif (existsSync(join(dir, marker))) {\n\t\t\t\t\treturn dir;\n\t\t\t\t}\n\t\t\t\tconst parent = dirname(dir);\n\t\t\t\tif (parent === dir) {\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t\tdir = parent;\n\t\t\t}\n\t\t}\n\t\tconst rel = relative(this.cwd, absolutePath);\n\t\tconst isUnderCwd = rel !== \"\" && !rel.startsWith(\"..\") && !rel.includes(\":\");\n\t\treturn isUnderCwd ? this.cwd : dirname(absolutePath);\n\t}\n\n\tprivate getClient(server: ResolvedLspServerConfig, absolutePath: string): LspClient {\n\t\tconst root = this.findRoot(absolutePath, server.rootMarkers);\n\t\tconst key = `${server.name}\\u0000${root}`;\n\t\tthis.lastUsedAt.set(key, Date.now());\n\t\tconst existing = this.clients.get(key);\n\t\tif (existing?.isAlive) {\n\t\t\treturn existing;\n\t\t}\n\t\texisting?.dispose();\n\t\tlet clientRef!: LspClient;\n\t\tconst client = new LspClient({\n\t\t\tserverName: server.name,\n\t\t\tcommand: server.command,\n\t\t\trootDir: root,\n\t\t\tinitializationOptions: server.initializationOptions,\n\t\t\tsettings: server.settings,\n\t\t\ttracer: this.tracer,\n\t\t\tonApplyEdit: async (edit) => {\n\t\t\t\tconst { summary } = await this.applyWorkspaceEdit(clientRef, edit as LspWorkspaceEdit);\n\t\t\t\tthis.serverApplyEditSummaries.push(summary);\n\t\t\t\treturn true;\n\t\t\t},\n\t\t});\n\t\tclientRef = client;\n\t\tthis.clients.set(key, client);\n\t\treturn client;\n\t}\n\n\tprivate async handleClientError(\n\t\tserver: ResolvedLspServerConfig,\n\t\tclient: LspClient,\n\t\terror: unknown,\n\t\tsignal?: AbortSignal,\n\t): Promise<LspClientErrorResult> {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tif (client.isAlive && !client.startFailed) {\n\t\t\t// Request-level failure on a started, healthy server: report it without\n\t\t\t// counting toward the start-failure breaker.\n\t\t\treturn { retry: false, message: `lsp(${server.name}): ${message}` };\n\t\t}\n\n\t\tthis.removeFailedClient(client);\n\t\tconst existingFailure = this.startFailures.get(server.name);\n\t\tif (!this.disposed && !existingFailure?.reported && message.includes(\"ENOENT\")) {\n\t\t\tconst installResult = await this.tryInstallMissingServer(server, signal);\n\t\t\tif (installResult.retry) {\n\t\t\t\treturn { retry: true };\n\t\t\t}\n\t\t\treturn { retry: false, message: this.recordStartFailure(server, message, installResult.message) };\n\t\t}\n\n\t\treturn { retry: false, message: this.recordStartFailure(server, message) };\n\t}\n\n\tprivate removeFailedClient(client: LspClient): void {\n\t\t// Remove and dispose the failed client (this also kills a process stuck\n\t\t// in the handshake) so the next call attempts a genuinely fresh start\n\t\t// instead of replaying the memoized failure.\n\t\tfor (const [key, value] of this.clients) {\n\t\t\tif (value === client) {\n\t\t\t\tthis.clients.delete(key);\n\t\t\t\tthis.lastUsedAt.delete(key);\n\t\t\t}\n\t\t}\n\t\tclient.dispose();\n\t}\n\n\tprivate recordStartFailure(\n\t\tserver: ResolvedLspServerConfig,\n\t\tmessage: string,\n\t\textraMessage?: string,\n\t): string | undefined {\n\t\tconst failure = this.startFailures.get(server.name) ?? { count: 0, reported: false };\n\t\tfailure.count++;\n\t\tthis.startFailures.set(server.name, failure);\n\t\tif (this.disposed || failure.reported) {\n\t\t\treturn undefined;\n\t\t}\n\t\tfailure.reported = true;\n\t\tconst hint = message.includes(\"ENOENT\") ? server.installHint : undefined;\n\t\tconst extra = extraMessage ? `. ${extraMessage}` : \"\";\n\t\treturn `lsp(${server.name}): ${message}${hint ? `. ${hint}` : \"\"}${extra} (further failures for this server will be silent)`;\n\t}\n\n\tprivate async tryInstallMissingServer(\n\t\tserver: ResolvedLspServerConfig,\n\t\tsignal?: AbortSignal,\n\t): Promise<LspInstallAttemptResult> {\n\t\tconst recipe = server.installRecipe;\n\t\tconst interaction = this.hostInteraction;\n\t\tconst existing = this.installAttempts.get(server.name);\n\t\tif (existing) {\n\t\t\treturn existing.catch((error: unknown) => this.createInstallAttemptFailure(error));\n\t\t}\n\t\tif (!recipe || !interaction || this.installPromptsUsed.has(server.name)) {\n\t\t\treturn { retry: false };\n\t\t}\n\n\t\tconst attempt = this.runInstallPrompt(server, recipe, interaction, signal).finally(() => {\n\t\t\tthis.installAttempts.delete(server.name);\n\t\t});\n\t\tthis.installAttempts.set(server.name, attempt);\n\t\treturn attempt.catch((error: unknown) => this.createInstallAttemptFailure(error));\n\t}\n\n\tprivate createInstallAttemptFailure(error: unknown): LspInstallAttemptResult {\n\t\treturn {\n\t\t\tretry: false,\n\t\t\tmessage: `LSP install prompt failed: ${error instanceof Error ? error.message : String(error)}`,\n\t\t};\n\t}\n\n\tprivate async runInstallPrompt(\n\t\tserver: ResolvedLspServerConfig,\n\t\trecipe: LspInstallRecipe,\n\t\tinteraction: HostInteraction,\n\t\tsignal?: AbortSignal,\n\t): Promise<LspInstallAttemptResult> {\n\t\tthis.installPromptsUsed.add(server.name);\n\t\tconst requestId = `lsp-install-${randomUUID()}`;\n\t\tconst decision = await interaction.requestAction(\n\t\t\t{\n\t\t\t\tid: requestId,\n\t\t\t\taction: \"lsp.install_server\",\n\t\t\t\ttitle: `Install ${server.name} language server?`,\n\t\t\t\tmessage: `Volt tried to use LSP for ${server.name}, but ${recipe.binary} is not installed. Install it now and retry diagnostics?`,\n\t\t\t\tconfirmLabel: \"Install\",\n\t\t\t\tcancelLabel: \"Skip\",\n\t\t\t\tcommandPreview: recipe.displayCommand,\n\t\t\t\tblocking: true,\n\t\t\t\tdestructive: false,\n\t\t\t\tmetadata: {\n\t\t\t\t\tserver: server.name,\n\t\t\t\t\tbinary: recipe.binary,\n\t\t\t\t},\n\t\t\t\ttimeoutMs: LSP_INSTALL_REQUEST_TIMEOUT_MS,\n\t\t\t},\n\t\t\t{ signal },\n\t\t);\n\n\t\tif (decision.decision !== \"approved\") {\n\t\t\treturn { retry: false, message: decision.message };\n\t\t}\n\t\tif (signal?.aborted) {\n\t\t\treturn { retry: false, message: \"LSP install cancelled.\" };\n\t\t}\n\n\t\tawait this.emitHostActionUpdate({\n\t\t\tid: requestId,\n\t\t\taction: \"lsp.install_server\",\n\t\t\tstatus: \"running\",\n\t\t\tmessage: `Running ${recipe.displayCommand}`,\n\t\t});\n\t\tlet result: LspInstallCommandResult;\n\t\ttry {\n\t\t\tresult = await this.installRunner(recipe.command, { cwd: this.cwd, signal });\n\t\t} catch (error) {\n\t\t\tconst message = `LSP install failed: ${error instanceof Error ? error.message : String(error)}`;\n\t\t\tawait this.emitHostActionUpdate({\n\t\t\t\tid: requestId,\n\t\t\t\taction: \"lsp.install_server\",\n\t\t\t\tstatus: signal?.aborted ? \"cancelled\" : \"failed\",\n\t\t\t\tmessage,\n\t\t\t});\n\t\t\treturn { retry: false, message };\n\t\t}\n\n\t\tif (result.exitCode !== 0) {\n\t\t\tconst message = this.formatInstallFailure(recipe, result);\n\t\t\tawait this.emitHostActionUpdate({\n\t\t\t\tid: requestId,\n\t\t\t\taction: \"lsp.install_server\",\n\t\t\t\tstatus: \"failed\",\n\t\t\t\tmessage,\n\t\t\t\texitCode: result.exitCode,\n\t\t\t});\n\t\t\treturn { retry: false, message };\n\t\t}\n\n\t\tthis.startFailures.delete(server.name);\n\t\tawait this.emitHostActionUpdate({\n\t\t\tid: requestId,\n\t\t\taction: \"lsp.install_server\",\n\t\t\tstatus: \"completed\",\n\t\t\tmessage: `${server.name} language server installed. Retrying diagnostics.`,\n\t\t\texitCode: result.exitCode,\n\t\t});\n\t\treturn { retry: true };\n\t}\n\n\tprivate formatInstallFailure(recipe: LspInstallRecipe, result: LspInstallCommandResult): string {\n\t\tconst output = result.output.trim();\n\t\tconst summary = `LSP install command failed (${recipe.displayCommand}) with exit code ${result.exitCode ?? \"unknown\"}.`;\n\t\treturn output ? `${summary} Output:\\n${output}` : summary;\n\t}\n\n\tprivate async emitHostActionUpdate(\n\t\tupdate: Parameters<NonNullable<HostInteraction[\"updateAction\"]>>[0],\n\t): Promise<void> {\n\t\ttry {\n\t\t\tawait this.hostInteraction?.updateAction?.(update);\n\t\t} catch {\n\t\t\t// Host action updates are advisory; do not fail the underlying LSP operation.\n\t\t}\n\t}\n\n\tprivate formatDiagnostics(absolutePath: string, diagnostics: LspDiagnostic[]): string | undefined {\n\t\tconst filtered = diagnostics\n\t\t\t.filter((diagnostic) => (diagnostic.severity ?? 1) <= this.config.maxSeverity)\n\t\t\t.sort((a, b) => (a.severity ?? 1) - (b.severity ?? 1) || a.range.start.line - b.range.start.line);\n\t\tif (filtered.length === 0) {\n\t\t\treturn undefined;\n\t\t}\n\t\tconst shown = filtered.slice(0, this.config.maxDiagnostics);\n\t\tconst displayPath = this.displayPath(absolutePath);\n\t\tconst lines = shown.map((diagnostic) => {\n\t\t\tconst severity = SEVERITY_NAMES[diagnostic.severity ?? 1] ?? \"error\";\n\t\t\tconst line = diagnostic.range.start.line + 1;\n\t\t\tconst column = diagnostic.range.start.character + 1;\n\t\t\tconst code =\n\t\t\t\tdiagnostic.code !== undefined\n\t\t\t\t\t? ` [${diagnostic.source ? `${diagnostic.source} ` : \"\"}${diagnostic.code}]`\n\t\t\t\t\t: \"\";\n\t\t\tconst message = diagnostic.message.replace(/\\s+/g, \" \").trim();\n\t\t\treturn `${displayPath}(${line},${column}): ${severity}: ${message}${code}`;\n\t\t});\n\t\tif (filtered.length > shown.length) {\n\t\t\tlines.push(`... and ${filtered.length - shown.length} more`);\n\t\t}\n\t\treturn lines.join(\"\\n\");\n\t}\n}\n"]}