@greppleai/grip 0.0.0-stage → 0.1.3

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/lsp/config.ts"],"names":[],"mappings":"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","sourcesContent":["import { posix, win32 } from \"node:path\";\nimport { normalizePortablePath, pathApi, pathFlavor, relativeWithin } from \"./portable-path.ts\";\n\nexport type LspJsonValue = null | boolean | number | string | LspJsonValue[] | { [key: string]: LspJsonValue };\n\nexport type LspConfigurationMode = \"merge\" | \"replace\";\n\nexport interface LspDocumentSelector {\n\t/** Language ID sent to the server in textDocument/didOpen. */\n\tlanguageId: string;\n\t/** Workspace-relative glob pattern used to select documents. */\n\tpattern: string;\n\t/** URI scheme to match. Defaults to file. */\n\tscheme?: string;\n}\n\nexport interface LspSpawnTransport {\n\ttype: \"spawn\";\n\tcommand: string;\n\targs?: string[];\n\tenv?: Record<string, string>;\n\tcwd?: string;\n}\n\nexport interface LspTcpTransport {\n\ttype: \"tcp\";\n\thost: string;\n\tport: number;\n}\n\nexport interface LspUnixSocketTransport {\n\ttype: \"unix\";\n\tpath: string;\n}\n\nexport interface LspNamedPipeTransport {\n\ttype: \"pipe\";\n\tpath: string;\n}\n\nexport interface LspProgrammaticTransport {\n\ttype: \"connection\";\n\t/** Host-registered connection factory ID. Functions are never loaded from JSON. */\n\tid: string;\n}\n\nexport type LspTransport =\n\t| LspSpawnTransport\n\t| LspTcpTransport\n\t| LspUnixSocketTransport\n\t| LspNamedPipeTransport\n\t| LspProgrammaticTransport;\n\nexport type LspWorkspaceRoot =\n\t| { type: \"session\" }\n\t| { type: \"fixed\"; path: string }\n\t| {\n\t\t\ttype: \"markers\";\n\t\t\tmarkers: string[];\n\t\t\tfallback?: \"session\" | \"none\";\n\t\t\tstopAt?: string;\n\t  };\n\nexport interface LspPathMapping {\n\t/** Agent-visible filesystem root. Relative roots are resolved against the configuration source. */\n\tagentRoot: string;\n\t/** Absolute file URI for the same root as observed by the language server. */\n\tserverRootUri: string;\n}\n\nexport type LspServerLifecycle = { type: \"managed\" } | { type: \"attached\"; shutdown?: \"disconnect\" | \"protocol\" };\n\nexport interface LspServerTimeouts {\n\t/** Zero disables the corresponding timeout. */\n\tconnectMs?: number;\n\tinitializeMs?: number;\n\trequestMs?: number;\n\tshutdownMs?: number;\n}\n\nexport interface LspClientInfo {\n\tname: string;\n\tversion?: string;\n}\n\nexport type LspTraceValue = \"off\" | \"messages\" | \"verbose\";\n\nexport interface LspServerFeatures {\n\tdiagnostics?: boolean;\n\thover?: boolean;\n\tdefinition?: boolean;\n\treferences?: boolean;\n\trename?: boolean;\n\tcodeActions?: boolean;\n}\n\nexport interface LspConfiguredServer {\n\tid: string;\n\tenabled?: true;\n\tselectors: LspDocumentSelector[];\n\ttransport: LspTransport;\n\tlifecycle: LspServerLifecycle;\n\tworkspace: LspWorkspaceRoot;\n\tpathMappings?: LspPathMapping[];\n\tinitializationOptions?: LspJsonValue;\n\tsettings?: LspJsonValue;\n\tclientInfo?: LspClientInfo;\n\tlocale?: string;\n\ttrace?: LspTraceValue;\n\tfeatures?: LspServerFeatures;\n\tpriority?: number;\n\ttimeouts?: LspServerTimeouts;\n}\n\nexport interface LspDisabledServer {\n\tid: string;\n\tenabled: false;\n}\n\nexport type LspServerEntry = LspConfiguredServer | LspDisabledServer;\n\n/**\n * One externally supplied configuration layer.\n *\n * - An absent layer leaves lower-precedence configuration unchanged.\n * - `merge` (the default) replaces complete server definitions by ID.\n * - `replace` clears lower-precedence servers before applying this layer.\n * - `{ id, enabled: false }` removes a server inherited from a lower layer.\n * - `enabled: false` disables the resolved runtime without discarding server definitions.\n */\nexport interface LspConfigurationLayer {\n\tenabled?: boolean;\n\tmode?: LspConfigurationMode;\n\tservers?: LspServerEntry[];\n}\n\nexport interface ResolvedLspConfiguration {\n\tenabled: boolean;\n\tservers: LspConfiguredServer[];\n}\n\nexport interface LspConfigurationDiagnostic {\n\tseverity: \"error\";\n\tpath: string;\n\tmessage: string;\n}\n\nexport interface ParseLspConfigurationResult {\n\tconfiguration?: LspConfigurationLayer;\n\tdiagnostics: LspConfigurationDiagnostic[];\n}\n\nconst SERVER_KEYS = new Set([\n\t\"id\",\n\t\"enabled\",\n\t\"selectors\",\n\t\"transport\",\n\t\"lifecycle\",\n\t\"workspace\",\n\t\"pathMappings\",\n\t\"initializationOptions\",\n\t\"settings\",\n\t\"clientInfo\",\n\t\"locale\",\n\t\"trace\",\n\t\"features\",\n\t\"priority\",\n\t\"timeouts\",\n]);\nconst FEATURE_KEYS = [\"diagnostics\", \"hover\", \"definition\", \"references\", \"rename\", \"codeActions\"] as const;\nconst TIMEOUT_KEYS = [\"connectMs\", \"initializeMs\", \"requestMs\", \"shutdownMs\"] as const;\n\nexport function parseLspConfiguration(value: unknown): ParseLspConfigurationResult {\n\tconst diagnostics: LspConfigurationDiagnostic[] = [];\n\tconst object = parseObject(value, \"$\", diagnostics);\n\tif (!object) return { diagnostics };\n\trejectUnknownKeys(object, new Set([\"enabled\", \"mode\", \"servers\"]), \"$\", diagnostics);\n\n\tconst enabled = parseOptionalBoolean(object.enabled, \"$.enabled\", diagnostics);\n\tconst mode = parseOptionalEnum(object.mode, [\"merge\", \"replace\"], \"$.mode\", diagnostics);\n\tconst servers = parseServers(object.servers, diagnostics);\n\tif (diagnostics.length > 0) return { diagnostics };\n\n\treturn {\n\t\tconfiguration: {\n\t\t\t...(enabled === undefined ? {} : { enabled }),\n\t\t\t...(mode === undefined ? {} : { mode }),\n\t\t\t...(servers === undefined ? {} : { servers }),\n\t\t},\n\t\tdiagnostics,\n\t};\n}\n\nfunction applyLspServerLayer(servers: Map<string, LspConfiguredServer>, layer: LspConfigurationLayer): void {\n\tif (layer.mode === \"replace\") servers.clear();\n\tfor (const server of layer.servers ?? []) {\n\t\tif (server.enabled === false) servers.delete(server.id);\n\t\telse servers.set(server.id, server);\n\t}\n}\n\n/** Resolve already validated layers from lowest to highest precedence. */\nexport function resolveLspConfiguration(\n\tlayers: readonly (LspConfigurationLayer | undefined)[],\n): ResolvedLspConfiguration {\n\tconst servers = new Map<string, LspConfiguredServer>();\n\tlet enabled = false;\n\tlet hasLayer = false;\n\n\tfor (const layer of layers) {\n\t\tif (!layer) continue;\n\t\tif (!hasLayer) enabled = layer.enabled ?? true;\n\t\thasLayer = true;\n\t\tif (layer.enabled !== undefined) enabled = layer.enabled;\n\t\tapplyLspServerLayer(servers, layer);\n\t}\n\n\treturn { enabled: hasLayer && enabled, servers: [...servers.values()] };\n}\n\nfunction parseServers(value: unknown, diagnostics: LspConfigurationDiagnostic[]): LspServerEntry[] | undefined {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value)) {\n\t\taddError(diagnostics, \"$.servers\", \"must be an array\");\n\t\treturn undefined;\n\t}\n\tconst servers: LspServerEntry[] = [];\n\tconst ids = new Set<string>();\n\tfor (const [index, entry] of value.entries()) {\n\t\tconst path = `$.servers[${index}]`;\n\t\tconst server = parseServer(entry, path, diagnostics);\n\t\tif (!server) continue;\n\t\tif (ids.has(server.id)) addError(diagnostics, `${path}.id`, `duplicates server ID ${JSON.stringify(server.id)}`);\n\t\telse ids.add(server.id);\n\t\tservers.push(server);\n\t}\n\treturn servers;\n}\nfunction validateTransportLifecycle(\n\ttransport: LspTransport | undefined,\n\tlifecycle: LspServerLifecycle | undefined,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): void {\n\tif (!transport || transport.type === \"connection\") return;\n\tconst expectedLifecycle = transport.type === \"spawn\" ? \"managed\" : \"attached\";\n\tif (lifecycle?.type === expectedLifecycle) return;\n\taddError(\n\t\tdiagnostics,\n\t\t`${path}.lifecycle.type`,\n\t\t`must be '${expectedLifecycle}' when transport.type is '${transport.type}'`,\n\t);\n}\nfunction parseServerId(value: unknown, path: string, diagnostics: LspConfigurationDiagnostic[]): string | undefined {\n\tconst id = parseRequiredString(value, `${path}.id`, diagnostics);\n\tif (!id || /^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(id)) return id;\n\taddError(\n\t\tdiagnostics,\n\t\t`${path}.id`,\n\t\t\"must start with an alphanumeric character and contain only letters, numbers, '.', '_' or '-'\",\n\t);\n\treturn id;\n}\nfunction createDisabledServerEntry(\n\tobject: Record<string, unknown>,\n\tid: string | undefined,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspDisabledServer | undefined {\n\trejectUnknownKeys(object, new Set([\"id\", \"enabled\"]), path, diagnostics);\n\tif (!id) return undefined;\n\treturn { id, enabled: false };\n}\n\nfunction parseServer(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspServerEntry | undefined {\n\tconst object = parseObject(value, path, diagnostics);\n\tif (!object) return undefined;\n\tconst id = parseServerId(object.id, path, diagnostics);\n\tconst enabled = parseOptionalBoolean(object.enabled, `${path}.enabled`, diagnostics);\n\tif (enabled === false) return createDisabledServerEntry(object, id, path, diagnostics);\n\trejectUnknownKeys(object, SERVER_KEYS, path, diagnostics);\n\n\tconst selectors = parseSelectors(object.selectors, `${path}.selectors`, diagnostics);\n\tconst transport = parseTransport(object.transport, `${path}.transport`, diagnostics);\n\tconst lifecycle = parseLifecycle(object.lifecycle, `${path}.lifecycle`, diagnostics);\n\tconst workspace = parseWorkspace(object.workspace, `${path}.workspace`, diagnostics);\n\tconst pathMappings = parsePathMappings(object.pathMappings, `${path}.pathMappings`, diagnostics);\n\tconst initializationOptions = parseOptionalJson(\n\t\tobject.initializationOptions,\n\t\t`${path}.initializationOptions`,\n\t\tdiagnostics,\n\t);\n\tconst settings = parseOptionalJson(object.settings, `${path}.settings`, diagnostics);\n\tconst clientInfo = parseClientInfo(object.clientInfo, `${path}.clientInfo`, diagnostics);\n\tconst locale = parseOptionalString(object.locale, `${path}.locale`, diagnostics);\n\tconst trace = parseOptionalEnum(object.trace, [\"off\", \"messages\", \"verbose\"], `${path}.trace`, diagnostics);\n\tconst features = parseFeatures(object.features, `${path}.features`, diagnostics);\n\tconst priority = parseOptionalInteger(object.priority, `${path}.priority`, diagnostics);\n\tconst timeouts = parseTimeouts(object.timeouts, `${path}.timeouts`, diagnostics);\n\n\tvalidateTransportLifecycle(transport, lifecycle, path, diagnostics);\n\tif (!id || !selectors || !transport || !lifecycle || !workspace) return undefined;\n\n\treturn {\n\t\tid,\n\t\t...(enabled === true ? { enabled: true as const } : {}),\n\t\tselectors,\n\t\ttransport,\n\t\tlifecycle,\n\t\tworkspace,\n\t\t...(pathMappings === undefined ? {} : { pathMappings }),\n\t\t...(initializationOptions === undefined ? {} : { initializationOptions }),\n\t\t...(settings === undefined ? {} : { settings }),\n\t\t...(clientInfo === undefined ? {} : { clientInfo }),\n\t\t...(locale === undefined ? {} : { locale }),\n\t\t...(trace === undefined ? {} : { trace }),\n\t\t...(features === undefined ? {} : { features }),\n\t\t...(priority === undefined ? {} : { priority }),\n\t\t...(timeouts === undefined ? {} : { timeouts }),\n\t};\n}\n\nfunction registerSelectorSignature(\n\tsignatures: Set<string>,\n\tsignature: string,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): void {\n\tif (signatures.has(signature)) {\n\t\taddError(diagnostics, path, \"is ambiguous because another selector has the same scheme and pattern\");\n\t}\n\tsignatures.add(signature);\n}\n\nfunction parseSelectors(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspDocumentSelector[] | undefined {\n\tif (!Array.isArray(value) || value.length === 0) {\n\t\taddError(diagnostics, path, \"must be a non-empty array\");\n\t\treturn undefined;\n\t}\n\tconst selectors: LspDocumentSelector[] = [];\n\tconst signatures = new Set<string>();\n\tfor (const [index, entry] of value.entries()) {\n\t\tconst itemPath = `${path}[${index}]`;\n\t\tconst object = parseObject(entry, itemPath, diagnostics);\n\t\tif (!object) continue;\n\t\trejectUnknownKeys(object, new Set([\"languageId\", \"pattern\", \"scheme\"]), itemPath, diagnostics);\n\t\tconst languageId = parseRequiredString(object.languageId, `${itemPath}.languageId`, diagnostics);\n\t\tconst pattern = parseRequiredString(object.pattern, `${itemPath}.pattern`, diagnostics);\n\t\tconst scheme = parseOptionalString(object.scheme, `${itemPath}.scheme`, diagnostics);\n\t\tif (pattern && !isSafeRelativePath(pattern)) {\n\t\t\taddError(diagnostics, `${itemPath}.pattern`, \"must be a workspace-relative pattern without '..' segments\");\n\t\t}\n\t\tif (!languageId || !pattern) continue;\n\t\tconst signature = `${scheme ?? \"file\"}\\u0000${pattern}`;\n\t\tregisterSelectorSignature(signatures, signature, itemPath, diagnostics);\n\t\tselectors.push({ languageId, pattern, ...(scheme === undefined ? {} : { scheme }) });\n\t}\n\treturn selectors;\n}\n\nfunction parseTransport(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspTransport | undefined {\n\tconst object = parseObject(value, path, diagnostics);\n\tif (!object) return undefined;\n\tconst type = parseRequiredString(object.type, `${path}.type`, diagnostics);\n\tswitch (type) {\n\t\tcase \"spawn\":\n\t\t\treturn parseSpawnTransport(object, path, diagnostics);\n\t\tcase \"tcp\":\n\t\t\treturn parseTcpTransport(object, path, diagnostics);\n\t\tcase \"unix\":\n\t\t\treturn parseUnixSocketTransport(object, path, diagnostics);\n\t\tcase \"pipe\":\n\t\t\treturn parseNamedPipeTransport(object, path, diagnostics);\n\t\tcase \"connection\":\n\t\t\treturn parseProgrammaticTransport(object, path, diagnostics);\n\t\tdefault:\n\t\t\tif (type)\n\t\t\t\taddError(diagnostics, `${path}.type`, \"must be one of 'spawn', 'tcp', 'unix', 'pipe', or 'connection'\");\n\t\t\treturn undefined;\n\t}\n}\n\nfunction parseSpawnTransport(\n\tobject: Record<string, unknown>,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspSpawnTransport | undefined {\n\trejectUnknownKeys(object, new Set([\"type\", \"command\", \"args\", \"env\", \"cwd\"]), path, diagnostics);\n\tconst command = parseRequiredString(object.command, `${path}.command`, diagnostics);\n\tconst args = parseOptionalStringArray(object.args, `${path}.args`, diagnostics);\n\tconst env = parseOptionalStringRecord(object.env, `${path}.env`, diagnostics);\n\tconst cwd = parseOptionalString(object.cwd, `${path}.cwd`, diagnostics);\n\treturn command\n\t\t? { type: \"spawn\", command, ...(args ? { args } : {}), ...(env ? { env } : {}), ...(cwd ? { cwd } : {}) }\n\t\t: undefined;\n}\n\nfunction parseTcpTransport(\n\tobject: Record<string, unknown>,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspTcpTransport | undefined {\n\trejectUnknownKeys(object, new Set([\"type\", \"host\", \"port\"]), path, diagnostics);\n\tconst host = parseRequiredString(object.host, `${path}.host`, diagnostics);\n\tconst port = parseOptionalInteger(object.port, `${path}.port`, diagnostics);\n\tif (port === undefined) addError(diagnostics, `${path}.port`, \"is required and must be an integer\");\n\telse if (port < 1 || port > 65535) addError(diagnostics, `${path}.port`, \"must be between 1 and 65535\");\n\treturn host && port !== undefined ? { type: \"tcp\", host, port } : undefined;\n}\n\nfunction parseUnixSocketTransport(\n\tobject: Record<string, unknown>,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspUnixSocketTransport | undefined {\n\trejectUnknownKeys(object, new Set([\"type\", \"path\"]), path, diagnostics);\n\tconst endpointPath = parseRequiredString(object.path, `${path}.path`, diagnostics);\n\tif (endpointPath && !posix.isAbsolute(endpointPath) && !isSafeRelativePath(endpointPath)) {\n\t\taddError(diagnostics, `${path}.path`, \"must be absolute or a safe source-relative Unix socket path\");\n\t}\n\treturn endpointPath ? { type: \"unix\", path: endpointPath } : undefined;\n}\n\nfunction parseNamedPipeTransport(\n\tobject: Record<string, unknown>,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspNamedPipeTransport | undefined {\n\trejectUnknownKeys(object, new Set([\"type\", \"path\"]), path, diagnostics);\n\tconst endpointPath = parseRequiredString(object.path, `${path}.path`, diagnostics);\n\tif (endpointPath && !isAbsoluteNamedPipe(endpointPath)) {\n\t\taddError(diagnostics, `${path}.path`, \"must be an absolute Windows named-pipe path such as \\\\\\\\.\\\\pipe\\\\server\");\n\t}\n\treturn endpointPath ? { type: \"pipe\", path: endpointPath } : undefined;\n}\n\nfunction parseProgrammaticTransport(\n\tobject: Record<string, unknown>,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspProgrammaticTransport | undefined {\n\trejectUnknownKeys(object, new Set([\"type\", \"id\"]), path, diagnostics);\n\tconst id = parseRequiredString(object.id, `${path}.id`, diagnostics);\n\treturn id ? { type: \"connection\", id } : undefined;\n}\nfunction parseLifecycle(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspServerLifecycle | undefined {\n\tconst object = parseObject(value, path, diagnostics);\n\tif (!object) return undefined;\n\tconst type = parseRequiredString(object.type, `${path}.type`, diagnostics);\n\tif (type === \"managed\") {\n\t\trejectUnknownKeys(object, new Set([\"type\"]), path, diagnostics);\n\t\treturn { type };\n\t}\n\tif (type === \"attached\") {\n\t\trejectUnknownKeys(object, new Set([\"type\", \"shutdown\"]), path, diagnostics);\n\t\tconst shutdown = parseOptionalEnum(object.shutdown, [\"disconnect\", \"protocol\"], `${path}.shutdown`, diagnostics);\n\t\treturn { type, ...(shutdown === undefined ? {} : { shutdown }) };\n\t}\n\tif (type) addError(diagnostics, `${path}.type`, \"must be 'managed' or 'attached'\");\n\treturn undefined;\n}\n\nfunction parseWorkspace(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspWorkspaceRoot | undefined {\n\tconst object = parseObject(value, path, diagnostics);\n\tif (!object) return undefined;\n\tconst type = parseRequiredString(object.type, `${path}.type`, diagnostics);\n\tif (type === \"session\") {\n\t\trejectUnknownKeys(object, new Set([\"type\"]), path, diagnostics);\n\t\treturn { type };\n\t}\n\tif (type === \"fixed\") {\n\t\trejectUnknownKeys(object, new Set([\"type\", \"path\"]), path, diagnostics);\n\t\tconst fixedPath = parseRequiredString(object.path, `${path}.path`, diagnostics);\n\t\treturn fixedPath ? { type, path: fixedPath } : undefined;\n\t}\n\tif (type === \"markers\") {\n\t\trejectUnknownKeys(object, new Set([\"type\", \"markers\", \"fallback\", \"stopAt\"]), path, diagnostics);\n\t\tconst markers = parseRequiredUniqueRelativePaths(object.markers, `${path}.markers`, diagnostics);\n\t\tconst fallback = parseOptionalEnum(object.fallback, [\"session\", \"none\"], `${path}.fallback`, diagnostics);\n\t\tconst stopAt = parseOptionalString(object.stopAt, `${path}.stopAt`, diagnostics);\n\t\treturn markers\n\t\t\t? {\n\t\t\t\t\ttype,\n\t\t\t\t\tmarkers,\n\t\t\t\t\t...(fallback === undefined ? {} : { fallback }),\n\t\t\t\t\t...(stopAt === undefined ? {} : { stopAt }),\n\t\t\t\t}\n\t\t\t: undefined;\n\t}\n\tif (type) addError(diagnostics, `${path}.type`, \"must be 'session', 'fixed', or 'markers'\");\n\treturn undefined;\n}\n\ninterface PathMappingParseState {\n\tmappings: LspPathMapping[];\n\tagentRoots: Set<string>;\n\tserverRoots: Set<string>;\n}\n\nfunction parsePathMappingEntry(\n\tentry: unknown,\n\tindex: number,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n\tstate: PathMappingParseState,\n): void {\n\tconst itemPath = `${path}[${index}]`;\n\tconst object = parseObject(entry, itemPath, diagnostics);\n\tif (!object) return;\n\trejectUnknownKeys(object, new Set([\"agentRoot\", \"serverRootUri\"]), itemPath, diagnostics);\n\tconst agentRoot = parseRequiredString(object.agentRoot, `${itemPath}.agentRoot`, diagnostics);\n\tconst serverRootUri = parseRequiredString(object.serverRootUri, `${itemPath}.serverRootUri`, diagnostics);\n\tif (serverRootUri && !isAbsoluteFileUri(serverRootUri)) {\n\t\taddError(\n\t\t\tdiagnostics,\n\t\t\t`${itemPath}.serverRootUri`,\n\t\t\t\"must be an absolute file URI without query or fragment components\",\n\t\t);\n\t}\n\tif (!agentRoot || !serverRootUri) return;\n\n\tconst normalizedAgentRoot = normalizeAgentRoot(agentRoot);\n\tconst normalizedServerRoot = canonicalFileUri(serverRootUri);\n\tif (state.agentRoots.has(normalizedAgentRoot))\n\t\taddError(diagnostics, `${itemPath}.agentRoot`, \"duplicates another mapping root\");\n\tif (normalizedServerRoot && state.serverRoots.has(normalizedServerRoot)) {\n\t\taddError(diagnostics, `${itemPath}.serverRootUri`, \"duplicates another mapping root\");\n\t}\n\tstate.agentRoots.add(normalizedAgentRoot);\n\tif (normalizedServerRoot) state.serverRoots.add(normalizedServerRoot);\n\tstate.mappings.push({ agentRoot, serverRootUri });\n}\n\nfunction validatePathMappingReversibility(\n\tmappings: LspPathMapping[],\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): void {\n\tfor (let index = 0; index < mappings.length; index++) {\n\t\tfor (let previous = 0; previous < index; previous++) {\n\t\t\tif (pathMappingsAreReversible(mappings[previous], mappings[index])) continue;\n\t\t\taddError(\n\t\t\t\tdiagnostics,\n\t\t\t\t`${path}[${index}].agentRoot`,\n\t\t\t\t`overlaps mapping ${previous} without an equivalent server URI relationship`,\n\t\t\t);\n\t\t\taddError(\n\t\t\t\tdiagnostics,\n\t\t\t\t`${path}[${index}].serverRootUri`,\n\t\t\t\t`overlaps mapping ${previous} without an equivalent agent path relationship`,\n\t\t\t);\n\t\t}\n\t}\n}\n\nfunction parsePathMappings(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspPathMapping[] | undefined {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value)) {\n\t\taddError(diagnostics, path, \"must be an array\");\n\t\treturn undefined;\n\t}\n\tconst state: PathMappingParseState = {\n\t\tmappings: [],\n\t\tagentRoots: new Set<string>(),\n\t\tserverRoots: new Set<string>(),\n\t};\n\tfor (const [index, entry] of value.entries()) {\n\t\tparsePathMappingEntry(entry, index, path, diagnostics, state);\n\t}\n\tvalidatePathMappingReversibility(state.mappings, path, diagnostics);\n\treturn state.mappings;\n}\n\nfunction parseClientInfo(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspClientInfo | undefined {\n\tif (value === undefined) return undefined;\n\tconst object = parseObject(value, path, diagnostics);\n\tif (!object) return undefined;\n\trejectUnknownKeys(object, new Set([\"name\", \"version\"]), path, diagnostics);\n\tconst name = parseRequiredString(object.name, `${path}.name`, diagnostics);\n\tconst version = parseOptionalString(object.version, `${path}.version`, diagnostics);\n\treturn name ? { name, ...(version === undefined ? {} : { version }) } : undefined;\n}\n\nfunction parseFeatures(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspServerFeatures | undefined {\n\tif (value === undefined) return undefined;\n\tconst object = parseObject(value, path, diagnostics);\n\tif (!object) return undefined;\n\trejectUnknownKeys(object, new Set(FEATURE_KEYS), path, diagnostics);\n\tconst features: LspServerFeatures = {};\n\tfor (const key of FEATURE_KEYS) {\n\t\tconst setting = parseOptionalBoolean(object[key], `${path}.${key}`, diagnostics);\n\t\tif (setting !== undefined) features[key] = setting;\n\t}\n\treturn features;\n}\n\nfunction parseTimeouts(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspServerTimeouts | undefined {\n\tif (value === undefined) return undefined;\n\tconst object = parseObject(value, path, diagnostics);\n\tif (!object) return undefined;\n\trejectUnknownKeys(object, new Set(TIMEOUT_KEYS), path, diagnostics);\n\tconst timeouts: LspServerTimeouts = {};\n\tfor (const key of TIMEOUT_KEYS) {\n\t\tconst timeout = parseOptionalInteger(object[key], `${path}.${key}`, diagnostics);\n\t\tif (timeout !== undefined) {\n\t\t\tif (timeout < 0) addError(diagnostics, `${path}.${key}`, \"must be zero or a positive integer\");\n\t\t\telse timeouts[key] = timeout;\n\t\t}\n\t}\n\treturn timeouts;\n}\n\ntype LspJsonParseResult = { ok: true; value: LspJsonValue } | { ok: false };\n\nfunction parseOptionalJson(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): LspJsonValue | undefined {\n\tif (value === undefined) return undefined;\n\tconst result = parseJson(value, path, diagnostics, new Set<object>());\n\treturn result.ok ? result.value : undefined;\n}\n\nfunction parseJsonArray(\n\tvalue: unknown[],\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n\tancestors: Set<object>,\n): LspJsonParseResult {\n\tancestors.add(value);\n\tconst output: LspJsonValue[] = [];\n\tlet valid = true;\n\tfor (const [index, item] of value.entries()) {\n\t\tconst parsed = parseJson(item, `${path}[${index}]`, diagnostics, ancestors);\n\t\tif (parsed.ok) output.push(parsed.value);\n\t\telse valid = false;\n\t}\n\tancestors.delete(value);\n\treturn valid ? { ok: true, value: output } : { ok: false };\n}\n\nfunction parseJsonObject(\n\tvalue: object,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n\tancestors: Set<object>,\n): LspJsonParseResult {\n\tancestors.add(value);\n\tconst output: { [key: string]: LspJsonValue } = {};\n\tlet valid = true;\n\tfor (const [key, item] of Object.entries(value)) {\n\t\tconst parsed = parseJson(item, `${path}.${key}`, diagnostics, ancestors);\n\t\tif (parsed.ok) output[key] = parsed.value;\n\t\telse valid = false;\n\t}\n\tancestors.delete(value);\n\treturn valid ? { ok: true, value: output } : { ok: false };\n}\n\nfunction parseJson(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n\tancestors: Set<object>,\n): LspJsonParseResult {\n\tif (value === null || typeof value === \"string\" || typeof value === \"boolean\") return { ok: true, value };\n\tif (typeof value === \"number\") {\n\t\tif (Number.isFinite(value)) return { ok: true, value };\n\t\taddError(diagnostics, path, \"must contain only finite JSON numbers\");\n\t\treturn { ok: false };\n\t}\n\tif (typeof value !== \"object\") {\n\t\taddError(diagnostics, path, \"must be valid JSON data\");\n\t\treturn { ok: false };\n\t}\n\tif (ancestors.has(value)) {\n\t\taddError(diagnostics, path, \"must not contain circular references\");\n\t\treturn { ok: false };\n\t}\n\treturn Array.isArray(value)\n\t\t? parseJsonArray(value, path, diagnostics, ancestors)\n\t\t: parseJsonObject(value, path, diagnostics, ancestors);\n}\n\nfunction parseObject(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): Record<string, unknown> | undefined {\n\tif (typeof value === \"object\" && value !== null && !Array.isArray(value)) return value as Record<string, unknown>;\n\taddError(diagnostics, path, \"must be an object\");\n\treturn undefined;\n}\n\nfunction parseRequiredString(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): string | undefined {\n\tif (typeof value !== \"string\" || value.trim().length === 0) {\n\t\taddError(diagnostics, path, \"is required and must be a non-empty string\");\n\t\treturn undefined;\n\t}\n\treturn value;\n}\n\nfunction parseOptionalString(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): string | undefined {\n\tif (value === undefined) return undefined;\n\treturn parseRequiredString(value, path, diagnostics);\n}\n\nfunction parseOptionalBoolean(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): boolean | undefined {\n\tif (value === undefined) return undefined;\n\tif (typeof value !== \"boolean\") {\n\t\taddError(diagnostics, path, \"must be a boolean\");\n\t\treturn undefined;\n\t}\n\treturn value;\n}\n\nfunction parseOptionalInteger(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): number | undefined {\n\tif (value === undefined) return undefined;\n\tif (!Number.isSafeInteger(value)) {\n\t\taddError(diagnostics, path, \"must be a safe integer\");\n\t\treturn undefined;\n\t}\n\treturn value as number;\n}\n\nfunction parseOptionalEnum<const T extends string>(\n\tvalue: unknown,\n\tallowed: readonly T[],\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): T | undefined {\n\tif (value === undefined) return undefined;\n\tif (typeof value === \"string\" && allowed.includes(value as T)) return value as T;\n\taddError(diagnostics, path, `must be one of ${allowed.map((item) => JSON.stringify(item)).join(\", \")}`);\n\treturn undefined;\n}\n\nfunction parseOptionalStringArray(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): string[] | undefined {\n\tif (value === undefined) return undefined;\n\tif (!Array.isArray(value)) {\n\t\taddError(diagnostics, path, \"must be an array of strings\");\n\t\treturn undefined;\n\t}\n\tconst output: string[] = [];\n\tfor (const [index, item] of value.entries()) {\n\t\tif (typeof item !== \"string\") addError(diagnostics, `${path}[${index}]`, \"must be a string\");\n\t\telse output.push(item);\n\t}\n\treturn output;\n}\n\nfunction parseOptionalStringRecord(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): Record<string, string> | undefined {\n\tif (value === undefined) return undefined;\n\tconst object = parseObject(value, path, diagnostics);\n\tif (!object) return undefined;\n\tconst output: Record<string, string> = {};\n\tfor (const [key, item] of Object.entries(object)) {\n\t\tif (typeof item !== \"string\") addError(diagnostics, `${path}.${key}`, \"must be a string\");\n\t\telse output[key] = item;\n\t}\n\treturn output;\n}\n\nfunction parseRequiredUniqueRelativePaths(\n\tvalue: unknown,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): string[] | undefined {\n\tif (!Array.isArray(value) || value.length === 0) {\n\t\taddError(diagnostics, path, \"must be a non-empty array of relative paths\");\n\t\treturn undefined;\n\t}\n\tconst output: string[] = [];\n\tconst seen = new Set<string>();\n\tfor (const [index, item] of value.entries()) {\n\t\tconst itemPath = `${path}[${index}]`;\n\t\tconst marker = parseRequiredString(item, itemPath, diagnostics);\n\t\tif (!marker) continue;\n\t\tif (!isSafeRelativePath(marker)) addError(diagnostics, itemPath, \"must be a relative path without '..' segments\");\n\t\tif (seen.has(marker)) addError(diagnostics, itemPath, \"duplicates another marker\");\n\t\telse seen.add(marker);\n\t\toutput.push(marker);\n\t}\n\treturn output;\n}\n\nfunction rejectUnknownKeys(\n\tobject: Record<string, unknown>,\n\tallowed: ReadonlySet<string>,\n\tpath: string,\n\tdiagnostics: LspConfigurationDiagnostic[],\n): void {\n\tfor (const key of Object.keys(object)) {\n\t\tif (!allowed.has(key)) addError(diagnostics, `${path}.${key}`, \"is not a recognized property\");\n\t}\n}\n\nfunction isSafeRelativePath(value: string): boolean {\n\tif (posix.isAbsolute(value) || win32.isAbsolute(value)) return false;\n\treturn !value.split(/[\\\\/]/).includes(\"..\");\n}\n\ntype MappingRootDirection = \"left-parent\" | \"right-parent\" | \"equal\";\n\ninterface MappingRootRelation {\n\tdirection: MappingRootDirection;\n\trelative: string;\n\tcaseInsensitive: boolean;\n}\n\nfunction agentRootRelation(left: string, right: string): MappingRootRelation | undefined {\n\tconst leftFlavor = pathFlavor(left);\n\tconst rightFlavor = pathFlavor(right);\n\tif (leftFlavor !== rightFlavor) return undefined;\n\tconst normalizedLeft = normalizePortablePath(left, leftFlavor);\n\tconst normalizedRight = normalizePortablePath(right, rightFlavor);\n\tconst comparableLeft = leftFlavor === \"windows\" ? normalizedLeft.toLowerCase() : normalizedLeft;\n\tconst comparableRight = rightFlavor === \"windows\" ? normalizedRight.toLowerCase() : normalizedRight;\n\tif (comparableLeft === comparableRight) {\n\t\treturn { direction: \"equal\", relative: \"\", caseInsensitive: leftFlavor === \"windows\" };\n\t}\n\tconst fromLeft = relativeWithin(normalizedLeft, normalizedRight);\n\tif (fromLeft !== undefined) {\n\t\treturn {\n\t\t\tdirection: \"left-parent\",\n\t\t\trelative: fromLeft.replace(/\\\\/g, \"/\"),\n\t\t\tcaseInsensitive: leftFlavor === \"windows\",\n\t\t};\n\t}\n\tconst fromRight = relativeWithin(normalizedRight, normalizedLeft);\n\treturn fromRight === undefined\n\t\t? undefined\n\t\t: {\n\t\t\t\tdirection: \"right-parent\",\n\t\t\t\trelative: fromRight.replace(/\\\\/g, \"/\"),\n\t\t\t\tcaseInsensitive: leftFlavor === \"windows\",\n\t\t\t};\n}\n\nfunction serverRootRelation(leftValue: string, rightValue: string): MappingRootRelation | undefined {\n\tif (!canonicalFileUri(leftValue) || !canonicalFileUri(rightValue)) return undefined;\n\tconst left = new URL(leftValue);\n\tconst right = new URL(rightValue);\n\tif (left.hostname.toLowerCase() !== right.hostname.toLowerCase()) return undefined;\n\tconst leftSegments = left.pathname\n\t\t.split(\"/\")\n\t\t.filter(Boolean)\n\t\t.map((segment) => decodeURIComponent(segment));\n\tconst rightSegments = right.pathname\n\t\t.split(\"/\")\n\t\t.filter(Boolean)\n\t\t.map((segment) => decodeURIComponent(segment));\n\tconst caseInsensitive =\n\t\tleft.hostname.length > 0 ||\n\t\tright.hostname.length > 0 ||\n\t\tleftSegments[0]?.endsWith(\":\") === true ||\n\t\trightSegments[0]?.endsWith(\":\") === true;\n\tconst comparable = (segment: string) => (caseInsensitive ? segment.toLowerCase() : segment);\n\tlet shared = 0;\n\twhile (\n\t\tshared < leftSegments.length &&\n\t\tshared < rightSegments.length &&\n\t\tcomparable(leftSegments[shared]) === comparable(rightSegments[shared])\n\t) {\n\t\tshared++;\n\t}\n\tif (shared < Math.min(leftSegments.length, rightSegments.length)) return undefined;\n\tif (leftSegments.length === rightSegments.length) return { direction: \"equal\", relative: \"\", caseInsensitive };\n\treturn leftSegments.length < rightSegments.length\n\t\t? { direction: \"left-parent\", relative: rightSegments.slice(shared).join(\"/\"), caseInsensitive }\n\t\t: { direction: \"right-parent\", relative: leftSegments.slice(shared).join(\"/\"), caseInsensitive };\n}\n\nfunction pathMappingsAreReversible(left: LspPathMapping, right: LspPathMapping): boolean {\n\tconst agent = agentRootRelation(left.agentRoot, right.agentRoot);\n\tconst server = serverRootRelation(left.serverRootUri, right.serverRootUri);\n\tif (!agent || !server) return agent === undefined && server === undefined;\n\tif (agent.direction !== server.direction) return false;\n\treturn agent.caseInsensitive && server.caseInsensitive\n\t\t? agent.relative.toLowerCase() === server.relative.toLowerCase()\n\t\t: agent.relative === server.relative;\n}\n\nfunction normalizeAgentRoot(value: string): string {\n\tconst flavor = pathFlavor(value);\n\tconst api = pathApi(flavor);\n\tconst normalized = normalizePortablePath(value, flavor);\n\tconst root = api.parse(normalized).root;\n\tconst trailingSeparator = flavor === \"windows\" ? /[\\\\/]+$/ : /\\/+$/;\n\tconst withoutTrailingSeparators = normalized === root ? normalized : normalized.replace(trailingSeparator, \"\");\n\treturn flavor === \"windows\" ? withoutTrailingSeparators.toLowerCase() : withoutTrailingSeparators;\n}\n\nfunction isAbsoluteNamedPipe(value: string): boolean {\n\tconst lower = value.toLowerCase();\n\tconst prefixes = [\"\\\\\\\\.\\\\pipe\\\\\", \"\\\\\\\\?\\\\pipe\\\\\"];\n\treturn prefixes.some((prefix) => lower.startsWith(prefix) && value.length > prefix.length);\n}\n\nfunction canonicalFileUri(value: string): string | undefined {\n\tif (!/^file:\\//i.test(value)) return undefined;\n\ttry {\n\t\tconst url = new URL(value);\n\t\tif (url.protocol !== \"file:\" || url.pathname.length === 0 || url.search !== \"\" || url.hash !== \"\")\n\t\t\treturn undefined;\n\t\tconst segments = url.pathname\n\t\t\t.split(\"/\")\n\t\t\t.filter(Boolean)\n\t\t\t.map((segment) => decodeURIComponent(segment));\n\t\tif (segments.some((segment) => segment.includes(\"/\") || segment === \".\" || segment === \"..\")) return undefined;\n\t\tif (url.hostname && segments.length === 0) return undefined;\n\t\tif (segments[0]?.endsWith(\":\") && segments.length === 1 && !url.pathname.endsWith(\"/\")) return undefined;\n\t\tconst driveRoot = segments[0]?.endsWith(\":\") && segments.length === 1;\n\t\turl.pathname = `/${segments.map((segment) => encodeURIComponent(segment)).join(\"/\")}${driveRoot ? \"/\" : \"\"}`;\n\t\turl.hostname = url.hostname.toLowerCase();\n\t\treturn url.toString();\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction isAbsoluteFileUri(value: string): boolean {\n\treturn canonicalFileUri(value) !== undefined;\n}\n\nfunction addError(diagnostics: LspConfigurationDiagnostic[], path: string, message: string): void {\n\tdiagnostics.push({ severity: \"error\", path, message });\n}\n"]}