@opticlm/connector 2.0.1 → 2.2.0

package/README.md

@@ -4,7 +4,6 @@ Provides an abstract interface that allows LLMs to connect to fact sources such
 
 ## Table of Contents
 
-- [Core Philosophy](#core-philosophy)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
 - [MCP Tools](#mcp-tools)
@@ -28,7 +27,9 @@ pnpm add @opticlm/connector
 
 ## Quick Start
 
-Providers are installed one at a time onto an MCP server using `install()` from `@opticlm/connector/mcp`. Each call registers the tools and resources for that specific provider. Providers that depend on file access (definition, references, hierarchy, edit) receive a `fileAccess` option.
+Providers are installed onto an MCP server using `install()` from `@opticlm/connector/mcp`. Each call registers the tools and resources for that specific provider. Providers that depend on file access (definition, references, hierarchy, edit) receive a `fileAccess` option.
+
+You can pass a single provider or an array of providers of the same type. When an array is given, their results are merged automatically — array-returning methods (e.g. `provideDefinition`) are concatenated, void methods are called on all providers in parallel, and callback registrars (e.g. `onDiagnosticsChanged`) are registered on every provider in the array.
 
 ```typescript
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'
@@ -91,6 +92,10 @@ install(server, definition, { fileAccess })
 install(server, diagnostics, { fileAccess })
 install(server, outline, { fileAccess })
 
+// You can also pass an array to merge multiple providers of the same type:
+// install(server, [definition, anotherDefinition], { fileAccess })
+// install(server, [diagnostics, anotherDiagnostics], { fileAccess })
+
 // 6. Connect to transport (you control the server lifecycle)
 const transport = new StdioServerTransport()
 await server.connect(transport)
@@ -110,6 +115,12 @@ Navigate to the definition of a symbol.
 
 Find all references to a symbol.
 
+### `find_file_references`
+
+Find all references to a file across the workspace (e.g., all files that import or link to the given file).
+
+Only registered when your `ReferencesProvider` implements the optional `provideFileReferences` method.
+
 ### `call_hierarchy`
 
 Get call hierarchy for a function or method.
@@ -170,23 +181,6 @@ install(server, definitionProvider, {
 })
 ```
 
-### Callback reference
-
-| Provider | Tool | Input callback | Output callback |
-|----------|------|----------------|-----------------|
-| `EditProvider` | `apply_edit` | `onEditInput` | `onEditOutput` |
-| `DefinitionProvider` | `goto_definition` | `onDefinitionInput` | `onDefinitionOutput` |
-| `DefinitionProvider` | `goto_type_definition` | `onTypeDefinitionInput` | `onTypeDefinitionOutput` |
-| `ReferencesProvider` | `find_references` | `onReferencesInput` | `onReferencesOutput` |
-| `HierarchyProvider` | `call_hierarchy` | `onCallHierarchyInput` | `onCallHierarchyOutput` |
-| `GlobalFindProvider` | `global_find` | `onGlobalFindInput` | `onGlobalFindOutput` |
-| `GraphProvider` | `get_link_structure` | — | `onLinkStructureOutput` |
-| `GraphProvider` | `add_link` | `onAddLinkInput` | `onAddLinkOutput` |
-| `FrontmatterProvider` | `get_frontmatter_structure` | `onFrontmatterStructureInput` | `onFrontmatterStructureOutput` |
-| `FrontmatterProvider` | `set_frontmatter` | `onSetFrontmatterInput` | `onSetFrontmatterOutput` |
-
-`get_link_structure` has no `onInput` since its input schema is empty. Resource-only providers (`FileAccessProvider`, `DiagnosticsProvider`, `OutlineProvider`) have no callbacks.
-
 ## MCP Resources
 
 The SDK automatically registers resources based on which providers you install:
@@ -355,10 +349,7 @@ const server = await servePipe({
   pipeName: 'my-ide-lsp',
   fileAccess: { /* ... */ },
   definition: { /* ... */ },
-  diagnostics: {
-    provideDiagnostics: async (uri) => { /* ... */ },
-    onDiagnosticsChanged: (callback) => { /* ... */ },
-  },
+  // ...
   // Add only the providers your IDE supports
 })
 // server.pipePath        — the resolved pipe path
@@ -387,8 +378,7 @@ const mcpServer = new McpServer({ name: 'my-mcp', version: '1.0.0' })
 if (conn.fileAccess) install(mcpServer, conn.fileAccess)
 if (conn.definition && conn.fileAccess)
   install(mcpServer, conn.definition, { fileAccess: conn.fileAccess })
-if (conn.diagnostics && conn.fileAccess)
-  install(mcpServer, conn.diagnostics, { fileAccess: conn.fileAccess })
+// ...
 // Install whichever proxy providers are available
 
 // When done:
@@ -429,13 +419,6 @@ const fileAccess = {
 // Providers are automatically created based on server capabilities
 install(server, fileAccess)
 if (lsp.definition) install(server, lsp.definition, { fileAccess })
-if (lsp.references) install(server, lsp.references, { fileAccess })
-if (lsp.hierarchy)  install(server, lsp.hierarchy,  { fileAccess })
-if (lsp.outline)    install(server, lsp.outline,    { fileAccess })
-install(server, {
-  ...lsp.diagnostics,
-  onDiagnosticsChanged: lsp.onDiagnosticsChanged,
-}, { fileAccess })
 
 const transport = new StdioServerTransport()
 await server.connect(transport)
@@ -459,12 +442,7 @@ interface LspClientOptions {
 ### How It Works
 
 1. `start()` spawns the LSP server process and performs the initialize/initialized handshake
-2. The server's `ServerCapabilities` response determines which providers are created:
-   - `definitionProvider` → `lsp.definition`
-   - `referencesProvider` → `lsp.references`
-   - `callHierarchyProvider` → `lsp.hierarchy`
-   - `documentSymbolProvider` → `lsp.outline`
-   - Diagnostics are always available (via `textDocument/publishDiagnostics` notifications)
+2. The server's `ServerCapabilities` response determines which providers are created
 3. Providers that the server does not support remain `undefined`
 4. Documents are automatically opened/closed with the server on demand, with an idle timeout for cleanup
 

package/dist/index.d.ts

@@ -1,7 +1,6 @@
-import { D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, a as DiagnosticsProvider, O as OutlineProvider, G as GlobalFindProvider, b as GraphProvider, F as FrontmatterProvider } from './capabilities-CQHv2shL.js';
-export { C as CodeSnippet, c as Diagnostic, d as DiagnosticSeverity, e as DiskRange, f as DocumentSymbol, E as EditFailureReason, g as EditResult, h as ExactPosition, i as Frontmatter, j as FrontmatterMatch, k as FrontmatterValue, l as FuzzyPosition, m as GlobalFindMatch, n as GlobalFindOptions, L as Link, o as OnDiagnosticsChangedCallback, P as PendingEditOperation, S as SymbolKind, T as TextEdit, U as UnifiedUri } from './capabilities-CQHv2shL.js';
-import { F as FileAccessProvider, E as EditProvider } from './resolver-Cg62Av4_.js';
-export { R as ResolverConfig, S as SymbolResolutionError, a as SymbolResolver } from './resolver-Cg62Av4_.js';
+import { F as FileAccessProvider, E as EditProvider, D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, a as DiagnosticsProvider, O as OutlineProvider, G as GlobalFindProvider, b as GraphProvider, c as FrontmatterProvider } from './interfaces-wSmWeYxt.js';
+export { C as CodeSnippet, d as Diagnostic, e as DiagnosticSeverity, f as DiskRange, g as DocumentSymbol, h as EditFailureReason, i as EditResult, j as ExactPosition, k as Frontmatter, l as FrontmatterMatch, m as FrontmatterValue, n as FuzzyPosition, o as GlobalFindMatch, p as GlobalFindOptions, L as Link, q as OnDiagnosticsChangedCallback, P as PendingEditOperation, S as SymbolKind, T as TextEdit, U as UnifiedUri } from './interfaces-wSmWeYxt.js';
+export { R as ResolverConfig, S as SymbolResolutionError, a as SymbolResolver } from './resolver-CSuvobsJ.js';
 
 interface connectPipeOptions {
     pipeName: string;

package/dist/{capabilities-CQHv2shL.d.ts → interfaces-wSmWeYxt.d.ts}

@@ -211,6 +211,12 @@ interface ReferencesProvider {
      * @returns Array of code snippets representing reference locations
      */
     provideReferences(uri: UnifiedUri, position: ExactPosition): Promise<CodeSnippet[]>;
+    /**
+     * Finds all references to the given file.
+     *
+     * @param uri - The URI of the file
+     */
+    provideFileReferences?(uri: UnifiedUri): Promise<CodeSnippet[]>;
 }
 /**
  * Provides call hierarchy functionality.
@@ -376,4 +382,64 @@ interface FrontmatterProvider {
  */
 type OnDiagnosticsChangedCallback = (uri: UnifiedUri) => void;
 
-export type { CodeSnippet as C, DefinitionProvider as D, EditFailureReason as E, FrontmatterProvider as F, GlobalFindProvider as G, HierarchyProvider as H, Link as L, OutlineProvider as O, PendingEditOperation as P, ReferencesProvider as R, SymbolKind as S, TextEdit as T, UnifiedUri as U, DiagnosticsProvider as a, GraphProvider as b, Diagnostic as c, DiagnosticSeverity as d, DiskRange as e, DocumentSymbol as f, EditResult as g, ExactPosition as h, Frontmatter as i, FrontmatterMatch as j, FrontmatterValue as k, FuzzyPosition as l, GlobalFindMatch as m, GlobalFindOptions as n, OnDiagnosticsChangedCallback as o };
+/**
+ * Infrastructure Interfaces for MCP LSP Driver SDK
+ *
+ * The SDK consumer (Plugin Developer) must implement these interfaces
+ * to bridge the SDK to the specific IDE.
+ */
+
+/**
+ * Provides access to the file system for reading files.
+ * Since the SDK is responsible for resolving FuzzyPosition to ExactPosition,
+ * it needs direct access to read files from the disk.
+ */
+interface FileAccessProvider {
+    /**
+     * Reads the content of a file from the disk (ignoring unsaved IDE buffers).
+     * Used for symbol resolution and context retrieval.
+     *
+     * @param uri - The URI of the file to read
+     * @returns The content of the file as a string
+     * @throws Error if the file cannot be read
+     */
+    readFile(uri: UnifiedUri): Promise<string>;
+    /**
+     * Read children in a directory, exluding git-ignored files, similar to Unix `ls` command
+     * @param relativePath - The path to the folder to read
+     * @returns Array of file/folder paths in the directory
+     */
+    readDirectory(relativePath: UnifiedUri): Promise<string[]>;
+    /**
+     * Called by the driver to register a callback for file changes.
+     * When provided, the files:// resources become subscribable.
+     * The plugin should call the registered callback whenever a file changes.
+     *
+     * @param callback - The callback to invoke when a file changes
+     */
+    onFileChanged?(callback: (uri: UnifiedUri) => void): void;
+}
+/**
+ * Provides edit capabilities for applying changes to files.
+ * At least one of the methods must be implemented.
+ */
+interface EditProvider {
+    /**
+     * Applies edits directly without user interaction.
+     * Use this when user approval is handled elsewhere or not needed.
+     *
+     * @param operation - The pending edit operation to apply
+     * @returns true if applied successfully, false if failed
+     */
+    applyEdits?(operation: PendingEditOperation): Promise<boolean>;
+    /**
+     * Displays a diff view or a confirmation dialog in the IDE.
+     * The user decides whether to apply the edits or discard them.
+     *
+     * @param operation - The pending edit operation to preview
+     * @returns true if applied, false if rejected/cancelled
+     */
+    previewAndApplyEdits?(operation: PendingEditOperation): Promise<boolean>;
+}
+
+export type { CodeSnippet as C, DefinitionProvider as D, EditProvider as E, FileAccessProvider as F, GlobalFindProvider as G, HierarchyProvider as H, Link as L, OutlineProvider as O, PendingEditOperation as P, ReferencesProvider as R, SymbolKind as S, TextEdit as T, UnifiedUri as U, DiagnosticsProvider as a, GraphProvider as b, FrontmatterProvider as c, Diagnostic as d, DiagnosticSeverity as e, DiskRange as f, DocumentSymbol as g, EditFailureReason as h, EditResult as i, ExactPosition as j, Frontmatter as k, FrontmatterMatch as l, FrontmatterValue as m, FuzzyPosition as n, GlobalFindMatch as o, GlobalFindOptions as p, OnDiagnosticsChangedCallback as q };

package/dist/lsp/index.d.ts

@@ -1,6 +1,6 @@
 import { ChildProcess } from 'node:child_process';
 import { ProtocolConnection } from 'vscode-languageserver-protocol/node.js';
-import { D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, O as OutlineProvider, a as DiagnosticsProvider, o as OnDiagnosticsChangedCallback, d as DiagnosticSeverity, C as CodeSnippet, c as Diagnostic$1, f as DocumentSymbol$1, h as ExactPosition, e as DiskRange, S as SymbolKind } from '../capabilities-CQHv2shL.js';
+import { D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, O as OutlineProvider, a as DiagnosticsProvider, F as FileAccessProvider, e as DiagnosticSeverity, C as CodeSnippet, d as Diagnostic$1, g as DocumentSymbol$1, j as ExactPosition, f as DiskRange, S as SymbolKind } from '../interfaces-wSmWeYxt.js';
 import { Location, LocationLink, Diagnostic, DocumentSymbol, SymbolInformation } from 'vscode-languageserver-protocol';
 
 interface LspClientOptions {
@@ -21,15 +21,16 @@ declare class LspClient {
     private openDocuments;
     private diagnosticsCache;
     private diagnosticsListeners;
+    private fileChangedListeners;
     readonly definition: DefinitionProvider | undefined;
     readonly references: ReferencesProvider | undefined;
     readonly hierarchy: HierarchyProvider | undefined;
     readonly outline: OutlineProvider | undefined;
     readonly diagnostics: DiagnosticsProvider | undefined;
+    readonly fileAccess: Pick<FileAccessProvider, 'onFileChanged'>;
     private readonly options;
     constructor(options: LspClientOptions);
     getState(): LspClientState;
-    get onDiagnosticsChanged(): (callback: OnDiagnosticsChangedCallback) => void;
     start(): Promise<void>;
     stop(): Promise<void>;
     notifyFileChanged(sdkPath: string): Promise<void>;
@@ -49,6 +50,7 @@ declare class LspClient {
     private provideDefinition;
     private provideTypeDefinition;
     private provideReferences;
+    private provideFileReferences;
     private provideCallHierarchy;
     private provideDocumentSymbols;
     private provideDiagnostics;

package/dist/lsp/index.js

@@ -1,3 +1,3 @@
-import {spawn}from'child_process';import {InitializedNotification,ShutdownRequest,ExitNotification,StreamMessageReader,StreamMessageWriter,createProtocolConnection,InitializeRequest,CancellationTokenSource,DidOpenTextDocumentNotification,DidCloseTextDocumentNotification}from'vscode-languageserver-protocol/node.js';import D from'path';import {pathToFileURL,fileURLToPath}from'url';function c(o,t){let e=D.resolve(o,t);return pathToFileURL(e).toString()}function u(o,t){let e=fileURLToPath(t);return D.relative(o,e).replace(/\\/g,"/")}function p(o){return {start:{line:o.start.line,character:o.start.character},end:{line:o.end.line,character:o.end.character}}}function R(o){return {line:o.line,character:o.character}}var T={1:"error",2:"warning",3:"information",4:"hint"};function b(o){return T[o??1]??"error"}var O=["file","file","module","namespace","package","class","method","property","field","constructor","enum","interface","function","variable","constant","string","number","boolean","array","object","key","null","enumMember","struct","event","operator","typeParameter"];function P(o){return O[o]??"variable"}function g(o,t,e){return {uri:u(o,t),range:p(e.range),severity:b(e.severity),message:e.message,source:e.source,code:typeof e.code=="object"?String(e.code):e.code??void 0}}function f(o){return {name:o.name,detail:o.detail,kind:P(o.kind),range:p(o.range),selectionRange:p(o.selectionRange),children:o.children?.map(f)}}function C(o,t){return {name:t.name,kind:P(t.kind),range:p(t.location.range),selectionRange:p(t.location.range)}}async function h(o,t,e){if(!t)return [];let i=Array.isArray(t)?t:[t];if(i.length===0)return [];let n=[];for(let s of i){let r="targetUri"in s,a=r?s.targetUri:s.uri,d=r?s.targetRange:s.range,m=u(o,a),l=p(d);try{let S=(await e(m)).split(`
-`).slice(l.start.line,l.end.line+1);n.push({uri:m,range:l,content:S.join(`
-`)});}catch{n.push({uri:m,range:l,content:""});}}return n}var I={".ts":"typescript",".tsx":"typescriptreact",".js":"javascript",".jsx":"javascriptreact",".rs":"rust",".go":"go",".py":"python",".rb":"ruby",".java":"java",".kt":"kotlin",".kts":"kotlin",".c":"c",".h":"c",".cpp":"cpp",".cc":"cpp",".cxx":"cpp",".hpp":"cpp",".cs":"csharp",".swift":"swift",".lua":"lua",".zig":"zig",".json":"json",".yaml":"yaml",".yml":"yaml",".toml":"toml",".xml":"xml",".html":"html",".css":"css",".scss":"scss",".md":"markdown",".sql":"sql",".sh":"shellscript",".bash":"shellscript",".zsh":"shellscript",".ps1":"powershell",".dart":"dart",".ex":"elixir",".exs":"elixir",".erl":"erlang",".hs":"haskell",".ml":"ocaml",".mli":"ocaml",".scala":"scala",".r":"r",".R":"r",".php":"php",".pl":"perl",".vim":"vim"};function w(o){let t=D.extname(o);return I[t]??"plaintext"}var y=class{state="idle";process=null;connection=null;openDocuments=new Map;diagnosticsCache=new Map;diagnosticsListeners=[];definition;references;hierarchy;outline;diagnostics;options;constructor(t){this.options={documentIdleTimeout:3e4,requestTimeout:3e4,...t},this.definition=void 0,this.references=void 0,this.hierarchy=void 0,this.outline=void 0,this.diagnostics=void 0;}getState(){return this.state}get onDiagnosticsChanged(){return t=>{this.diagnosticsListeners.push(t);}}async start(){if(this.state!=="idle")throw new Error(`Cannot start: client is in "${this.state}" state`);this.state="starting";try{let t=this.spawnAndConnect();this.connection=t,t.onClose(()=>{(this.state==="running"||this.state==="starting")&&this.transitionToDead();}),t.listen();let i=(await this.sendInitialize()).capabilities;this.setupProviders(i),t.onNotification("textDocument/publishDiagnostics",n=>{let s=u(this.options.workspacePath,n.uri),r=n.diagnostics.map(a=>g(this.options.workspacePath,n.uri,a));this.diagnosticsCache.set(s,r);for(let a of this.diagnosticsListeners)a(s);}),await t.sendNotification(InitializedNotification.type,{}),this.state="running";}catch(t){throw this.transitionToDead(),t}}async stop(){if(this.state!=="running")return;let t=[...this.openDocuments.keys()].map(e=>this.closeDocument(e));await Promise.all(t);try{await this.connection?.sendRequest(ShutdownRequest.type),await this.connection?.sendNotification(ExitNotification.type);}catch{}this.cleanup();}async notifyFileChanged(t){if(this.state!=="running")return;let e=c(this.options.workspacePath,t);this.openDocuments.get(e)&&(await this.closeDocument(e),await this.ensureDocumentOpen(e));}startWithConnection(t,e){this.connection=t,this.process=e;}async initializeConnection(){let t=this.connection;if(!t)throw new Error("Connection not set");this.state="starting",t.onClose(()=>{(this.state==="running"||this.state==="starting")&&this.transitionToDead();}),t.listen();let i=(await this.sendInitialize()).capabilities;this.setupProviders(i),t.onNotification("textDocument/publishDiagnostics",n=>{let s=u(this.options.workspacePath,n.uri),r=n.diagnostics.map(a=>g(this.options.workspacePath,n.uri,a));this.diagnosticsCache.set(s,r);for(let a of this.diagnosticsListeners)a(s);}),await t.sendNotification(InitializedNotification.type,{}),this.state="running";}spawnAndConnect(){let t=spawn(this.options.command,this.options.args??[],{stdio:["pipe","pipe","pipe"],env:this.options.env?{...process.env,...this.options.env}:process.env});this.process=t,t.on("exit",()=>{(this.state==="running"||this.state==="starting")&&this.transitionToDead();});let e=new StreamMessageReader(t.stdout),i=new StreamMessageWriter(t.stdin);return createProtocolConnection(e,i)}async sendInitialize(){if(!this.connection)throw new Error("No connection");let t={textDocument:{synchronization:{dynamicRegistration:false,didSave:true},definition:{dynamicRegistration:false},references:{dynamicRegistration:false},callHierarchy:{dynamicRegistration:false},documentSymbol:{dynamicRegistration:false,hierarchicalDocumentSymbolSupport:true},publishDiagnostics:{relatedInformation:true}}};return await this.connection.sendRequest(InitializeRequest.type,{processId:process.pid,capabilities:t,rootUri:c(this.options.workspacePath,"."),initializationOptions:this.options.initializationOptions??null})}setupProviders(t){t.definitionProvider&&(this.definition={provideDefinition:(e,i)=>this.provideDefinition(e,i),provideTypeDefinition:(e,i)=>this.provideTypeDefinition(e,i)}),t.referencesProvider&&(this.references={provideReferences:(e,i)=>this.provideReferences(e,i)}),t.callHierarchyProvider&&(this.hierarchy={provideCallHierarchy:(e,i,n)=>this.provideCallHierarchy(e,i,n)}),t.documentSymbolProvider&&(this.outline={provideDocumentSymbols:e=>this.provideDocumentSymbols(e)}),this.diagnostics={provideDiagnostics:e=>this.provideDiagnostics(e),getWorkspaceDiagnostics:()=>this.getWorkspaceDiagnostics()};}assertRunning(){if(this.state!=="running")throw new Error(`Client is not running (state: "${this.state}")`);if(!this.connection)throw new Error("No connection");return this.connection}createTimeout(){let t=new CancellationTokenSource,e,i=new Promise((n,s)=>{e=setTimeout(()=>{t.cancel(),s(new Error("LSP request timed out"));},this.options.requestTimeout);});return {token:t,promise:i,clear:()=>{e&&clearTimeout(e);}}}async sendRequest(t,e){let i=this.assertRunning(),n=this.createTimeout();try{return await Promise.race([i.sendRequest(t,e,n.token.token),n.promise])}finally{n.clear();}}async ensureDocumentOpen(t){let e=this.openDocuments.get(t);if(e){e.closeTimer&&clearTimeout(e.closeTimer),e.closeTimer=this.scheduleDocumentClose(t);return}let i=u(this.options.workspacePath,t),n=await this.options.readFile(i),s=w(i),r={uri:t,version:1,closeTimer:this.scheduleDocumentClose(t)};this.openDocuments.set(t,r),await this.connection?.sendNotification(DidOpenTextDocumentNotification.type,{textDocument:{uri:t,languageId:s,version:r.version,text:n}});}scheduleDocumentClose(t){return setTimeout(()=>{this.closeDocument(t);},this.options.documentIdleTimeout)}async closeDocument(t){let e=this.openDocuments.get(t);if(e&&(e.closeTimer&&clearTimeout(e.closeTimer),this.openDocuments.delete(t),this.connection&&this.state==="running"))try{await this.connection.sendNotification(DidCloseTextDocumentNotification.type,{textDocument:{uri:t}});}catch{}}async provideDefinition(t,e){let i=c(this.options.workspacePath,t);await this.ensureDocumentOpen(i);let n=await this.sendRequest("textDocument/definition",{textDocument:{uri:i},position:{line:e.line,character:e.character}});return h(this.options.workspacePath,n,this.options.readFile)}async provideTypeDefinition(t,e){let i=c(this.options.workspacePath,t);await this.ensureDocumentOpen(i);let n=await this.sendRequest("textDocument/typeDefinition",{textDocument:{uri:i},position:{line:e.line,character:e.character}});return h(this.options.workspacePath,n,this.options.readFile)}async provideReferences(t,e){let i=c(this.options.workspacePath,t);await this.ensureDocumentOpen(i);let n=await this.sendRequest("textDocument/references",{textDocument:{uri:i},position:{line:e.line,character:e.character},context:{includeDeclaration:true}});return h(this.options.workspacePath,n,this.options.readFile)}async provideCallHierarchy(t,e,i){let n=c(this.options.workspacePath,t);await this.ensureDocumentOpen(n);let s=await this.sendRequest("textDocument/prepareCallHierarchy",{textDocument:{uri:n},position:{line:e.line,character:e.character}});if(!s||s.length===0)return [];let r=s[0],a=i==="incoming"?"callHierarchy/incomingCalls":"callHierarchy/outgoingCalls",d=await this.sendRequest(a,{item:r});if(!d||d.length===0)return [];let m=d.map(l=>{let v="from"in l?l.from:l.to;return {uri:v.uri,range:v.selectionRange}});return h(this.options.workspacePath,m,this.options.readFile)}async provideDocumentSymbols(t){let e=c(this.options.workspacePath,t);await this.ensureDocumentOpen(e);let i=await this.sendRequest("textDocument/documentSymbol",{textDocument:{uri:e}});if(!i||i.length===0)return [];let n=i[0];return n&&"range"in n&&"selectionRange"in n?i.map(f):i.map(s=>C(this.options.workspacePath,s))}async provideDiagnostics(t){this.assertRunning();let e=c(this.options.workspacePath,t);await this.ensureDocumentOpen(e);let i=this.diagnosticsCache.get(t);return i||(await new Promise(n=>setTimeout(n,200)),this.diagnosticsCache.get(t)??[])}async getWorkspaceDiagnostics(){this.assertRunning();let t=[];for(let e of this.diagnosticsCache.values())t.push(...e);return t}transitionToDead(){this.state="dead",this.cleanup();}cleanup(){for(let t of this.openDocuments.values())t.closeTimer&&clearTimeout(t.closeTimer);if(this.openDocuments.clear(),this.connection){try{this.connection.dispose();}catch{}this.connection=null;}if(this.process){try{this.process.kill();}catch{}this.process=null;}this.state="dead";}};function _(o){return new y(o)}export{y as LspClient,b as convertDiagnosticSeverity,h as convertLocationsToSnippets,g as convertLspDiagnostic,f as convertLspDocumentSymbol,R as convertLspPosition,p as convertLspRange,C as convertSymbolInformation,P as convertSymbolKind,_ as createLspClient,w as guessLanguageId,u as lspUriToPath,c as pathToLspUri};
+import {spawn}from'child_process';import {InitializedNotification,ShutdownRequest,ExitNotification,StreamMessageReader,StreamMessageWriter,createProtocolConnection,InitializeRequest,CancellationTokenSource,DidOpenTextDocumentNotification,DidCloseTextDocumentNotification}from'vscode-languageserver-protocol/node.js';import D from'path';import {pathToFileURL,fileURLToPath}from'url';function c(o,t){let e=D.resolve(o,t);return pathToFileURL(e).toString()}function u(o,t){let e=fileURLToPath(t);return D.relative(o,e).replace(/\\/g,"/")}function p(o){return {start:{line:o.start.line,character:o.start.character},end:{line:o.end.line,character:o.end.character}}}function R(o){return {line:o.line,character:o.character}}var T={1:"error",2:"warning",3:"information",4:"hint"};function L(o){return T[o??1]??"error"}var U=["file","file","module","namespace","package","class","method","property","field","constructor","enum","interface","function","variable","constant","string","number","boolean","array","object","key","null","enumMember","struct","event","operator","typeParameter"];function P(o){return U[o]??"variable"}function g(o,t,e){return {uri:u(o,t),range:p(e.range),severity:L(e.severity),message:e.message,source:e.source,code:typeof e.code=="object"?String(e.code):e.code??void 0}}function f(o){return {name:o.name,detail:o.detail,kind:P(o.kind),range:p(o.range),selectionRange:p(o.selectionRange),children:o.children?.map(f)}}function C(o,t){return {name:t.name,kind:P(t.kind),range:p(t.location.range),selectionRange:p(t.location.range)}}async function h(o,t,e){if(!t)return [];let i=Array.isArray(t)?t:[t];if(i.length===0)return [];let n=[];for(let s of i){let r="targetUri"in s,a=r?s.targetUri:s.uri,d=r?s.targetRange:s.range,m=u(o,a),l=p(d);try{let b=(await e(m)).split(`
+`).slice(l.start.line,l.end.line+1);n.push({uri:m,range:l,content:b.join(`
+`)});}catch{n.push({uri:m,range:l,content:""});}}return n}var I={".ts":"typescript",".tsx":"typescriptreact",".js":"javascript",".jsx":"javascriptreact",".rs":"rust",".go":"go",".py":"python",".rb":"ruby",".java":"java",".kt":"kotlin",".kts":"kotlin",".c":"c",".h":"c",".cpp":"cpp",".cc":"cpp",".cxx":"cpp",".hpp":"cpp",".cs":"csharp",".swift":"swift",".lua":"lua",".zig":"zig",".json":"json",".yaml":"yaml",".yml":"yaml",".toml":"toml",".xml":"xml",".html":"html",".css":"css",".scss":"scss",".md":"markdown",".sql":"sql",".sh":"shellscript",".bash":"shellscript",".zsh":"shellscript",".ps1":"powershell",".dart":"dart",".ex":"elixir",".exs":"elixir",".erl":"erlang",".hs":"haskell",".ml":"ocaml",".mli":"ocaml",".scala":"scala",".r":"r",".R":"r",".php":"php",".pl":"perl",".vim":"vim"};function w(o){let t=D.extname(o);return I[t]??"plaintext"}var y=class{state="idle";process=null;connection=null;openDocuments=new Map;diagnosticsCache=new Map;diagnosticsListeners=[];fileChangedListeners=[];definition;references;hierarchy;outline;diagnostics;fileAccess;options;constructor(t){this.options={documentIdleTimeout:3e4,requestTimeout:3e4,...t},this.definition=void 0,this.references=void 0,this.hierarchy=void 0,this.outline=void 0,this.diagnostics=void 0,this.fileAccess={onFileChanged:e=>{this.fileChangedListeners.push(e);}};}getState(){return this.state}async start(){if(this.state!=="idle")throw new Error(`Cannot start: client is in "${this.state}" state`);this.state="starting";try{let t=this.spawnAndConnect();this.connection=t,t.onClose(()=>{(this.state==="running"||this.state==="starting")&&this.transitionToDead();}),t.listen();let i=(await this.sendInitialize()).capabilities;this.setupProviders(i),t.onNotification("textDocument/publishDiagnostics",n=>{let s=u(this.options.workspacePath,n.uri),r=n.diagnostics.map(a=>g(this.options.workspacePath,n.uri,a));this.diagnosticsCache.set(s,r);for(let a of this.diagnosticsListeners)a(s);}),await t.sendNotification(InitializedNotification.type,{}),this.state="running";}catch(t){throw this.transitionToDead(),t}}async stop(){if(this.state!=="running")return;let t=[...this.openDocuments.keys()].map(e=>this.closeDocument(e));await Promise.all(t);try{await this.connection?.sendRequest(ShutdownRequest.type),await this.connection?.sendNotification(ExitNotification.type);}catch{}this.cleanup();}async notifyFileChanged(t){if(this.state!=="running")return;let e=c(this.options.workspacePath,t);if(this.openDocuments.get(e)){await this.closeDocument(e),await this.ensureDocumentOpen(e);for(let n of this.fileChangedListeners)n(t);}}startWithConnection(t,e){this.connection=t,this.process=e;}async initializeConnection(){let t=this.connection;if(!t)throw new Error("Connection not set");this.state="starting",t.onClose(()=>{(this.state==="running"||this.state==="starting")&&this.transitionToDead();}),t.listen();let i=(await this.sendInitialize()).capabilities;this.setupProviders(i),t.onNotification("textDocument/publishDiagnostics",n=>{let s=u(this.options.workspacePath,n.uri),r=n.diagnostics.map(a=>g(this.options.workspacePath,n.uri,a));this.diagnosticsCache.set(s,r);for(let a of this.diagnosticsListeners)a(s);}),await t.sendNotification(InitializedNotification.type,{}),this.state="running";}spawnAndConnect(){let t=spawn(this.options.command,this.options.args??[],{stdio:["pipe","pipe","pipe"],env:this.options.env?{...process.env,...this.options.env}:process.env});this.process=t,t.on("exit",()=>{(this.state==="running"||this.state==="starting")&&this.transitionToDead();});let e=new StreamMessageReader(t.stdout),i=new StreamMessageWriter(t.stdin);return createProtocolConnection(e,i)}async sendInitialize(){if(!this.connection)throw new Error("No connection");let t={textDocument:{synchronization:{dynamicRegistration:false,didSave:true},definition:{dynamicRegistration:false},references:{dynamicRegistration:false},callHierarchy:{dynamicRegistration:false},documentSymbol:{dynamicRegistration:false,hierarchicalDocumentSymbolSupport:true},publishDiagnostics:{relatedInformation:true}}};return await this.connection.sendRequest(InitializeRequest.type,{processId:process.pid,capabilities:t,rootUri:c(this.options.workspacePath,"."),initializationOptions:this.options.initializationOptions??null})}setupProviders(t){t.definitionProvider&&(this.definition={provideDefinition:(e,i)=>this.provideDefinition(e,i),provideTypeDefinition:(e,i)=>this.provideTypeDefinition(e,i)}),t.referencesProvider&&(this.references={provideReferences:(e,i)=>this.provideReferences(e,i),provideFileReferences:e=>this.provideFileReferences(e)}),t.callHierarchyProvider&&(this.hierarchy={provideCallHierarchy:(e,i,n)=>this.provideCallHierarchy(e,i,n)}),t.documentSymbolProvider&&(this.outline={provideDocumentSymbols:e=>this.provideDocumentSymbols(e)}),this.diagnostics={provideDiagnostics:e=>this.provideDiagnostics(e),getWorkspaceDiagnostics:()=>this.getWorkspaceDiagnostics(),onDiagnosticsChanged:e=>{this.diagnosticsListeners.push(e);}};}assertRunning(){if(this.state!=="running")throw new Error(`Client is not running (state: "${this.state}")`);if(!this.connection)throw new Error("No connection");return this.connection}createTimeout(){let t=new CancellationTokenSource,e,i=new Promise((n,s)=>{e=setTimeout(()=>{t.cancel(),s(new Error("LSP request timed out"));},this.options.requestTimeout);});return {token:t,promise:i,clear:()=>{e&&clearTimeout(e);}}}async sendRequest(t,e){let i=this.assertRunning(),n=this.createTimeout();try{return await Promise.race([i.sendRequest(t,e,n.token.token),n.promise])}finally{n.clear();}}async ensureDocumentOpen(t){let e=this.openDocuments.get(t);if(e){e.closeTimer&&clearTimeout(e.closeTimer),e.closeTimer=this.scheduleDocumentClose(t);return}let i=u(this.options.workspacePath,t),n=await this.options.readFile(i),s=w(i),r={uri:t,version:1,closeTimer:this.scheduleDocumentClose(t)};this.openDocuments.set(t,r),await this.connection?.sendNotification(DidOpenTextDocumentNotification.type,{textDocument:{uri:t,languageId:s,version:r.version,text:n}});}scheduleDocumentClose(t){return setTimeout(()=>{this.closeDocument(t);},this.options.documentIdleTimeout)}async closeDocument(t){let e=this.openDocuments.get(t);if(e&&(e.closeTimer&&clearTimeout(e.closeTimer),this.openDocuments.delete(t),this.connection&&this.state==="running"))try{await this.connection.sendNotification(DidCloseTextDocumentNotification.type,{textDocument:{uri:t}});}catch{}}async provideDefinition(t,e){let i=c(this.options.workspacePath,t);await this.ensureDocumentOpen(i);let n=await this.sendRequest("textDocument/definition",{textDocument:{uri:i},position:{line:e.line,character:e.character}});return h(this.options.workspacePath,n,this.options.readFile)}async provideTypeDefinition(t,e){let i=c(this.options.workspacePath,t);await this.ensureDocumentOpen(i);let n=await this.sendRequest("textDocument/typeDefinition",{textDocument:{uri:i},position:{line:e.line,character:e.character}});return h(this.options.workspacePath,n,this.options.readFile)}async provideReferences(t,e){let i=c(this.options.workspacePath,t);await this.ensureDocumentOpen(i);let n=await this.sendRequest("textDocument/references",{textDocument:{uri:i},position:{line:e.line,character:e.character},context:{includeDeclaration:true}});return h(this.options.workspacePath,n,this.options.readFile)}async provideFileReferences(t){let e=c(this.options.workspacePath,t);await this.ensureDocumentOpen(e);let i=await this.sendRequest("textDocument/references",{textDocument:{uri:e},position:{line:0,character:0},context:{includeDeclaration:false}});return h(this.options.workspacePath,i,this.options.readFile)}async provideCallHierarchy(t,e,i){let n=c(this.options.workspacePath,t);await this.ensureDocumentOpen(n);let s=await this.sendRequest("textDocument/prepareCallHierarchy",{textDocument:{uri:n},position:{line:e.line,character:e.character}});if(!s||s.length===0)return [];let r=s[0],a=i==="incoming"?"callHierarchy/incomingCalls":"callHierarchy/outgoingCalls",d=await this.sendRequest(a,{item:r});if(!d||d.length===0)return [];let m=d.map(l=>{let v="from"in l?l.from:l.to;return {uri:v.uri,range:v.selectionRange}});return h(this.options.workspacePath,m,this.options.readFile)}async provideDocumentSymbols(t){let e=c(this.options.workspacePath,t);await this.ensureDocumentOpen(e);let i=await this.sendRequest("textDocument/documentSymbol",{textDocument:{uri:e}});if(!i||i.length===0)return [];let n=i[0];return n&&"range"in n&&"selectionRange"in n?i.map(f):i.map(s=>C(this.options.workspacePath,s))}async provideDiagnostics(t){this.assertRunning();let e=c(this.options.workspacePath,t);await this.ensureDocumentOpen(e);let i=this.diagnosticsCache.get(t);return i||(await new Promise(n=>setTimeout(n,200)),this.diagnosticsCache.get(t)??[])}async getWorkspaceDiagnostics(){this.assertRunning();let t=[];for(let e of this.diagnosticsCache.values())t.push(...e);return t}transitionToDead(){this.state="dead",this.cleanup();}cleanup(){for(let t of this.openDocuments.values())t.closeTimer&&clearTimeout(t.closeTimer);if(this.openDocuments.clear(),this.connection){try{this.connection.dispose();}catch{}this.connection=null;}if(this.process){try{this.process.kill();}catch{}this.process=null;}this.state="dead";}};function _(o){return new y(o)}export{y as LspClient,L as convertDiagnosticSeverity,h as convertLocationsToSnippets,g as convertLspDiagnostic,f as convertLspDocumentSymbol,R as convertLspPosition,p as convertLspRange,C as convertSymbolInformation,P as convertSymbolKind,_ as createLspClient,w as guessLanguageId,u as lspUriToPath,c as pathToLspUri};

package/dist/mcp/index.d.ts

@@ -1,7 +1,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
-import { D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, a as DiagnosticsProvider, O as OutlineProvider, G as GlobalFindProvider, b as GraphProvider, F as FrontmatterProvider, g as EditResult, j as FrontmatterMatch, m as GlobalFindMatch, L as Link } from '../capabilities-CQHv2shL.js';
-import { F as FileAccessProvider, E as EditProvider, R as ResolverConfig } from '../resolver-Cg62Av4_.js';
+import { F as FileAccessProvider, E as EditProvider, D as DefinitionProvider, R as ReferencesProvider, H as HierarchyProvider, a as DiagnosticsProvider, O as OutlineProvider, G as GlobalFindProvider, b as GraphProvider, c as FrontmatterProvider, i as EditResult, l as FrontmatterMatch, o as GlobalFindMatch, L as Link } from '../interfaces-wSmWeYxt.js';
+import { R as ResolverConfig } from '../resolver-CSuvobsJ.js';
 
 /**
  * Zod schemas for MCP tool inputs and outputs.
@@ -42,6 +42,9 @@ declare const AddLinkSchema: z.ZodObject<{
     pattern: z.ZodString;
     link_to: z.ZodString;
 }, z.core.$strip>;
+declare const FileReferencesSchema: z.ZodObject<{
+    uri: z.ZodString;
+}, z.core.$strip>;
 declare const GetFrontmatterStructureSchema: z.ZodObject<{
     property: z.ZodString;
     path: z.ZodOptional<z.ZodString>;
@@ -104,6 +107,10 @@ interface ReferencesInstallOptions extends InstallOptions {
     onReferencesInput?: (input: z.infer<typeof FuzzyPositionSchema>) => void;
     /** Called with the result of `find_references`. */
     onReferencesOutput?: (output: SnippetsOutput) => void;
+    /** Called with the raw tool input for `find_file_references`. */
+    onFileReferencesInput?: (input: z.infer<typeof FileReferencesSchema>) => void;
+    /** Called with the result of `find_file_references`. */
+    onFileReferencesOutput?: (output: SnippetsOutput) => void;
 }
 /** Options for installing a {@link HierarchyProvider}. */
 interface HierarchyInstallOptions extends InstallOptions {
@@ -155,21 +162,25 @@ interface FrontmatterInstallOptions extends InstallOptions {
 /**
  * Install a provider's tools and resources onto an MCP server.
  *
+ * Accepts a single provider or an array of providers of the same type. When an array is
+ * passed, their results are merged: array-returning methods are concatenated, void methods
+ * are called on all providers in parallel, and callback registrars are registered on all.
+ *
  * The provider type is detected via duck-typing (checking for characteristic methods).
  * Some providers require `fileAccess` in options:
  * - `DefinitionProvider`, `ReferencesProvider`, `HierarchyProvider` need it for symbol resolution
  * - `EditProvider` needs it for file hash verification
  * - `DiagnosticsProvider`, `OutlineProvider`, `GraphProvider`, `FrontmatterProvider` use it optionally for auto-complete
  */
-declare function install(server: McpServer, provider: FileAccessProvider, options?: InstallOptions): void;
-declare function install(server: McpServer, provider: EditProvider, options?: EditInstallOptions): void;
-declare function install(server: McpServer, provider: DefinitionProvider, options?: DefinitionInstallOptions): void;
-declare function install(server: McpServer, provider: ReferencesProvider, options?: ReferencesInstallOptions): void;
-declare function install(server: McpServer, provider: HierarchyProvider, options?: HierarchyInstallOptions): void;
-declare function install(server: McpServer, provider: DiagnosticsProvider, options?: InstallOptions): void;
-declare function install(server: McpServer, provider: OutlineProvider, options?: InstallOptions): void;
-declare function install(server: McpServer, provider: GlobalFindProvider, options?: GlobalFindInstallOptions): void;
-declare function install(server: McpServer, provider: GraphProvider, options?: GraphInstallOptions): void;
-declare function install(server: McpServer, provider: FrontmatterProvider, options?: FrontmatterInstallOptions): void;
+declare function install(server: McpServer, provider: FileAccessProvider | FileAccessProvider[], options?: InstallOptions): void;
+declare function install(server: McpServer, provider: EditProvider | EditProvider[], options?: EditInstallOptions): void;
+declare function install(server: McpServer, provider: DefinitionProvider | DefinitionProvider[], options?: DefinitionInstallOptions): void;
+declare function install(server: McpServer, provider: ReferencesProvider | ReferencesProvider[], options?: ReferencesInstallOptions): void;
+declare function install(server: McpServer, provider: HierarchyProvider | HierarchyProvider[], options?: HierarchyInstallOptions): void;
+declare function install(server: McpServer, provider: DiagnosticsProvider | DiagnosticsProvider[], options?: InstallOptions): void;
+declare function install(server: McpServer, provider: OutlineProvider | OutlineProvider[], options?: InstallOptions): void;
+declare function install(server: McpServer, provider: GlobalFindProvider | GlobalFindProvider[], options?: GlobalFindInstallOptions): void;
+declare function install(server: McpServer, provider: GraphProvider | GraphProvider[], options?: GraphInstallOptions): void;
+declare function install(server: McpServer, provider: FrontmatterProvider | FrontmatterProvider[], options?: FrontmatterInstallOptions): void;
 
 export { type AnyProvider, type DefinitionInstallOptions, type EditInstallOptions, type FrontmatterInstallOptions, type GlobalFindInstallOptions, type GraphInstallOptions, type HierarchyInstallOptions, type InstallOptions, type ReferencesInstallOptions, install };

package/dist/mcp/index.js

@@ -1,9 +1,9 @@
-import {ResourceTemplate}from'@modelcontextprotocol/sdk/server/mcp.js';import {z}from'zod';var g=class extends Error{constructor(i,a,o){super(`Could not find symbol '${i}' at or near line ${a}. ${o}`);this.symbolName=i;this.lineHint=a;this.reason=o;this.name="SymbolResolutionError";}},w=class{constructor(e,i){this.fs=e;this.lineSearchRadius=i?.lineSearchRadius??2;}lineSearchRadius;async resolvePosition(e,i){let o=(await this.fs.readFile(e)).split(/\r?\n/),n=i.lineHint-1,t=i.orderHint??0,s=this.findSymbolInLine(o[n],i.symbolName,t);if(s!==null)return {line:n,character:s};for(let c=1;c<=this.lineSearchRadius;c++){let l=n-c;if(l>=0){let h=this.findSymbolInLine(o[l],i.symbolName,t);if(h!==null)return {line:l,character:h}}let d=n+c;if(d<o.length){let h=this.findSymbolInLine(o[d],i.symbolName,t);if(h!==null)return {line:d,character:h}}}throw new g(i.symbolName,i.lineHint,`Please verify the file content and try again. Searched lines ${Math.max(1,i.lineHint-this.lineSearchRadius)} to ${Math.min(o.length,i.lineHint+this.lineSearchRadius)}.`)}findSymbolInLine(e,i,a){if(e===void 0||e.length===0)return null;let o=0,n=0;for(;o<e.length;){let t=e.indexOf(i,o);if(t===-1)break;if(n===a)return t;n++,o=t+1;}return null}};var f=r=>({content:[{type:"text",text:JSON.stringify(r??"")}],structuredContent:r});function m(r){if(r.includes(".."))throw new Error('URI could not include ".." operator');return r.replace(/\\/g,"/")}function G(){return `edit-${Date.now()}`}function $(r){return r.length===0?"No diagnostics found.":r.map(e=>{let i=e.range.start.line+1,a=e.severity.toUpperCase(),o=e.source?` [${e.source}]`:"",n=e.code!==void 0?` (${e.code})`:"";return `- **${a}**${o}${n} at line ${i}: ${e.message}`}).join(`
-`)}function D(r,e=0){if(r.length===0&&e===0)return "No symbols found.";let i="  ".repeat(e);return r.map(a=>{let o=a.range.start.line+1,n=a.range.end.line+1,t=o===n?`line ${o}`:`lines ${o}-${n}`,s=a.detail?` - ${a.detail}`:"",c=`${i}- **${a.kind}** \`${a.name}\`${s} (${t})`;return a.children&&a.children.length>0?`${c}
-${D(a.children,e+1)}`:c}).join(`
-`)}var H=new Uint16Array(256);for(let r=0;r<256;r++){let e=r<<8;for(let i=0;i<8;i++)e=e<<1^(e&32768?4129:0);H[r]=e&65535;}function I(r){let e=65535;for(let i=0;i<r.length;i++)e=e<<8&65535^H[(e>>8^r.charCodeAt(i))&255];return (e&255).toString(16).padStart(2,"0")}function C(r){return r.split(/\r?\n/).map((e,i)=>({num:i+1,text:e}))}function M(r){return r.map(e=>`${e.num}:${I(e.text)}|${e.text}`).join(`
-`)}function _(r){let e=r.match(/^(\d+):([0-9a-f]{2})$/);if(!e||!e[1]||!e[2])throw new Error(`Invalid hashline reference "${r}". Expected format: "<line>:<hash>" (e.g., "3:a1")`);return {line:parseInt(e[1],10),hash:e[2]}}var j=z.string().describe("The relative file path"),N=z.string().describe("The text of the symbol to find"),U=z.number().int().positive().describe("Approximate 1-based line number where the symbol is expected"),W=z.number().int().min(0).default(0).describe("0-based index of which occurrence to target if symbol appears multiple times"),E=z.object({uri:j,symbol_name:N,line_hint:U,order_hint:W}),v=z.object({uri:j,start_hash:z.string().describe('Start line reference from hashline output, format "<line>:<hash>" (e.g., "3:a1"). Copy this exactly from the files:// resource output.'),end_hash:z.string().optional().describe('End line reference for multi-line edits (e.g., "5:0e"). The range is inclusive. Omit for single-line edits (defaults to start_hash).'),replace_text:z.string().describe("The new text to replace the entire line range with"),description:z.string().describe("Rationale for the edit")}),J=z.object({uri:z.string().describe("The file URI or path"),symbol_name:N,line_hint:U,order_hint:W,direction:z.enum(["incoming","outgoing"]).describe("Direction of the call hierarchy")}),me=z.string().describe("The search query"),he=z.boolean().default(false).describe("Whether the search is case-sensitive"),fe=z.boolean().default(false).describe("Whether to match exact words only"),ge=z.boolean().default(false).describe("Whether the query is a regular expression"),q=z.object({query:me,case_sensitive:he,exact_match:fe,regex_mode:ge}),B=z.object({path:z.string().describe("The path to the document to modify"),pattern:z.string().describe("The text pattern to find and replace with a link"),link_to:z.string().describe("The target URI the link should point to")}),Q=z.object({property:z.string().describe("The frontmatter property name to search for"),path:z.string().optional().describe("Optional path to limit the search to a specific document. If not provided, searches all documents.")}),K=z.object({path:z.string().describe("The path to the document to modify"),property:z.string().describe("The frontmatter property name to set"),value:z.union([z.string(),z.array(z.string()),z.number(),z.array(z.number()),z.boolean(),z.array(z.boolean()),z.null()]).describe("The value to set. Can be a string, number, boolean, array of these types, or null to remove.")});function ye(r){if(!r)return null;let e=r.match(/^L(\d+)(?:-L(\d+))?$/);if(!e||!e[1])return null;let i=parseInt(e[1],10),a=e[2]?parseInt(e[2],10):i;return i<1||a<i?null:{start:i,end:a}}function V(r){let e=r.indexOf("?");return e===-1?{path:r,params:new URLSearchParams}:{path:r.slice(0,e),params:new URLSearchParams(r.slice(e+1))}}function A(r){return async e=>{let i=e.lastIndexOf("/"),a=i>=0?e.slice(0,i):"",o=i>=0?e.slice(i+1):e;try{let n=await r(a||"."),t=o.toLowerCase();return n.filter(s=>s.toLowerCase().startsWith(t)).map(s=>a?`${a}/${s}`:s)}catch{return []}}}function X(r,e,i,a){r.registerTool("goto_definition",{description:"Navigate to the definition of a symbol.",inputSchema:E,outputSchema:{snippets:z.array(z.object({uri:z.string(),startLine:z.number(),endLine:z.number(),content:z.string()}))}},async o=>{a?.onInput?.(o);try{let n=m(o.uri),t={symbolName:o.symbol_name,lineHint:o.line_hint,orderHint:o.order_hint},s=await i.resolvePosition(n,t),c=(await e.provideDefinition(n,s)).map(l=>({uri:l.uri,startLine:l.range.start.line+1,endLine:l.range.end.line+1,content:l.content}));return a?.onOutput?.({snippets:c}),f({snippets:c})}catch(n){let t=n instanceof g?n.message:`Error: ${n instanceof Error?n.message:String(n)}`;return {content:[{type:"text",text:t}],structuredContent:{error:t},isError:true}}});}function Y(r,e,i,a){let o=e.provideTypeDefinition;o&&r.registerTool("goto_type_definition",{description:"Navigate to the type definition of a symbol.",inputSchema:E,outputSchema:{snippets:z.array(z.object({uri:z.string(),startLine:z.number(),endLine:z.number(),content:z.string()}))}},async n=>{a?.onInput?.(n);try{let t=m(n.uri),s={symbolName:n.symbol_name,lineHint:n.line_hint,orderHint:n.order_hint},c=await i.resolvePosition(t,s),l=(await o(t,c)).map(d=>({uri:d.uri,startLine:d.range.start.line+1,endLine:d.range.end.line+1,content:d.content}));return a?.onOutput?.({snippets:l}),f({snippets:l})}catch(t){let s=t instanceof g?t.message:`Error: ${t instanceof Error?t.message:String(t)}`;return {content:[{type:"text",text:s}],structuredContent:{error:s},isError:true}}});}function Z(r,e,i,a){r.registerTool("find_references",{description:"Find all references to a symbol. Returns a list of locations where the symbol is used.",inputSchema:E,outputSchema:{snippets:z.array(z.object({uri:z.string(),startLine:z.number(),endLine:z.number(),content:z.string()}))}},async o=>{a?.onInput?.(o);try{let n=m(o.uri),t={symbolName:o.symbol_name,lineHint:o.line_hint,orderHint:o.order_hint},s=await i.resolvePosition(n,t),c=(await e.provideReferences(n,s)).map(l=>({uri:l.uri,startLine:l.range.start.line+1,endLine:l.range.end.line+1,content:l.content}));return a?.onOutput?.({snippets:c}),f({snippets:c})}catch(n){let t=n instanceof g?n.message:`Error: ${n instanceof Error?n.message:String(n)}`;return {content:[{type:"text",text:t}],structuredContent:{error:t},isError:true}}});}function ee(r,e,i,a){r.registerTool("call_hierarchy",{description:"Get call hierarchy for a function or method. Shows incoming or outgoing calls.",inputSchema:J,outputSchema:{snippets:z.array(z.object({uri:z.string(),startLine:z.number(),endLine:z.number(),content:z.string()}))}},async o=>{a?.onInput?.(o);try{let n=m(o.uri),t={symbolName:o.symbol_name,lineHint:o.line_hint,orderHint:o.order_hint},s=await i.resolvePosition(n,t),c=(await e.provideCallHierarchy(n,s,o.direction)).map(l=>({uri:l.uri,startLine:l.range.start.line+1,endLine:l.range.end.line+1,content:l.content}));return a?.onOutput?.({snippets:c}),f({snippets:c})}catch(n){let t=n instanceof g?n.message:`Error: ${n instanceof Error?n.message:String(n)}`;return {content:[{type:"text",text:t}],structuredContent:{error:t},isError:true}}});}function te(r,e,i){let a=new ResourceTemplate("diagnostics://{+path}",{list:void 0,complete:i?{path:i}:void 0});if(r.registerResource("diagnostics",a,{description:"Diagnostics (errors, warnings, hints) for a specific file. Use the file path after diagnostics://",mimeType:"text/markdown"},async(o,n)=>{try{let t=n.path,s=m(t),c=await e.provideDiagnostics(s),l=$(c);return {contents:[{uri:`diagnostics://${t}`,mimeType:"text/markdown",text:l}]}}catch(t){let s=`Error: ${t instanceof Error?t.message:String(t)}`;return {contents:[{uri:`diagnostics://${n.path}`,mimeType:"text/markdown",text:s}]}}}),e.getWorkspaceDiagnostics){let o=e.getWorkspaceDiagnostics.bind(e);r.registerResource("workspace-diagnostics","diagnostics://workspace",{description:"All diagnostics (errors, warnings, hints) across the entire workspace",mimeType:"text/markdown"},async()=>{try{let n=await o(),t=new Map;for(let c of n){let l=t.get(c.uri)??[];l.push(c),t.set(c.uri,l);}if(t.size===0)return {contents:[{uri:"diagnostics://workspace",mimeType:"text/markdown",text:"No diagnostics found in workspace."}]};let s=[];for(let[c,l]of t)s.push(`## ${c}
-${$(l)}`);return {contents:[{uri:"diagnostics://workspace",mimeType:"text/markdown",text:s.join(`
+import {ResourceTemplate}from'@modelcontextprotocol/sdk/server/mcp.js';import {z as z$1}from'zod';var g=class extends Error{constructor(i,r,t){super(`Could not find symbol '${i}' at or near line ${r}. ${t}`);this.symbolName=i;this.lineHint=r;this.reason=t;this.name="SymbolResolutionError";}},O=class{constructor(n,i){this.fs=n;this.lineSearchRadius=i?.lineSearchRadius??2;}lineSearchRadius;async resolvePosition(n,i){let t=(await this.fs.readFile(n)).split(/\r?\n/),e=i.lineHint-1,o=i.orderHint??0,s=this.findSymbolInLine(t[e],i.symbolName,o);if(s!==null)return {line:e,character:s};for(let c=1;c<=this.lineSearchRadius;c++){let l=e-c;if(l>=0){let h=this.findSymbolInLine(t[l],i.symbolName,o);if(h!==null)return {line:l,character:h}}let m=e+c;if(m<t.length){let h=this.findSymbolInLine(t[m],i.symbolName,o);if(h!==null)return {line:m,character:h}}}throw new g(i.symbolName,i.lineHint,`Please verify the file content and try again. Searched lines ${Math.max(1,i.lineHint-this.lineSearchRadius)} to ${Math.min(t.length,i.lineHint+this.lineSearchRadius)}.`)}findSymbolInLine(n,i,r){if(n===void 0||n.length===0)return null;let t=0,e=0;for(;t<n.length;){let o=n.indexOf(i,t);if(o===-1)break;if(e===r)return o;e++,t=o+1;}return null}};var f=a=>({content:[{type:"text",text:JSON.stringify(a??"")}],structuredContent:a});function d(a){if(a.includes(".."))throw new Error('URI could not include ".." operator');return a.replace(/\\/g,"/")}function C(){return `edit-${Date.now()}`}function L(a){return a.length===0?"No diagnostics found.":a.map(n=>{let i=n.range.start.line+1,r=n.severity.toUpperCase(),t=n.source?` [${n.source}]`:"",e=n.code!==void 0?` (${n.code})`:"";return `- **${r}**${t}${e} at line ${i}: ${n.message}`}).join(`
+`)}function $(a,n=0){if(a.length===0&&n===0)return "No symbols found.";let i="  ".repeat(n);return a.map(r=>{let t=r.range.start.line+1,e=r.range.end.line+1,o=t===e?`line ${t}`:`lines ${t}-${e}`,s=r.detail?` - ${r.detail}`:"",c=`${i}- **${r.kind}** \`${r.name}\`${s} (${o})`;return r.children&&r.children.length>0?`${c}
+${$(r.children,n+1)}`:c}).join(`
+`)}var H=new Uint16Array(256);for(let a=0;a<256;a++){let n=a<<8;for(let i=0;i<8;i++)n=n<<1^(n&32768?4129:0);H[a]=n&65535;}function k(a){let n=65535;for(let i=0;i<a.length;i++)n=n<<8&65535^H[(n>>8^a.charCodeAt(i))&255];return (n&255).toString(16).padStart(2,"0")}function M(a){return a.split(/\r?\n/).map((n,i)=>({num:i+1,text:n}))}function j(a){return a.map(n=>`${n.num}:${k(n.text)}|${n.text}`).join(`
+`)}function A(a){let n=a.match(/^(\d+):([0-9a-f]{2})$/);if(!n||!n[1]||!n[2])throw new Error(`Invalid hashline reference "${a}". Expected format: "<line>:<hash>" (e.g., "3:a1")`);return {line:parseInt(n[1],10),hash:n[2]}}var _=z$1.string().describe("The relative file path"),N=z$1.string().describe("The text of the symbol to find"),U=z$1.number().int().positive().describe("Approximate 1-based line number where the symbol is expected"),W=z$1.number().int().min(0).default(0).describe("0-based index of which occurrence to target if symbol appears multiple times"),R=z$1.object({uri:_,symbol_name:N,line_hint:U,order_hint:W}),v=z$1.object({uri:_,start_hash:z$1.string().describe('Start line reference from hashline output, format "<line>:<hash>" (e.g., "3:a1"). Copy this exactly from the files:// resource output.'),end_hash:z$1.string().optional().describe('End line reference for multi-line edits (e.g., "5:0e"). The range is inclusive. Omit for single-line edits (defaults to start_hash).'),replace_text:z$1.string().describe("The new text to replace the entire line range with"),description:z$1.string().describe("Rationale for the edit")}),J=z$1.object({uri:z$1.string().describe("The file URI or path"),symbol_name:N,line_hint:U,order_hint:W,direction:z$1.enum(["incoming","outgoing"]).describe("Direction of the call hierarchy")}),he=z$1.string().describe("The search query"),ge=z$1.boolean().default(false).describe("Whether the search is case-sensitive"),ye=z$1.boolean().default(false).describe("Whether to match exact words only"),ve=z$1.boolean().default(false).describe("Whether the query is a regular expression"),q=z$1.object({query:he,case_sensitive:ge,exact_match:ye,regex_mode:ve}),B=z$1.object({path:z$1.string().describe("The path to the document to modify"),pattern:z$1.string().describe("The text pattern to find and replace with a link"),link_to:z$1.string().describe("The target URI the link should point to")}),Q=z$1.object({uri:_}),K=z$1.object({property:z$1.string().describe("The frontmatter property name to search for"),path:z$1.string().optional().describe("Optional path to limit the search to a specific document. If not provided, searches all documents.")}),V=z$1.object({path:z$1.string().describe("The path to the document to modify"),property:z$1.string().describe("The frontmatter property name to set"),value:z$1.union([z$1.string(),z$1.array(z$1.string()),z$1.number(),z$1.array(z$1.number()),z$1.boolean(),z$1.array(z$1.boolean()),z$1.null()]).describe("The value to set. Can be a string, number, boolean, array of these types, or null to remove.")});function Se(a){if(!a)return null;let n=a.match(/^L(\d+)(?:-L(\d+))?$/);if(!n||!n[1])return null;let i=parseInt(n[1],10),r=n[2]?parseInt(n[2],10):i;return i<1||r<i?null:{start:i,end:r}}function X(a){let n=a.indexOf("?");return n===-1?{path:a,params:new URLSearchParams}:{path:a.slice(0,n),params:new URLSearchParams(a.slice(n+1))}}function z(a){return async n=>{let i=n.lastIndexOf("/"),r=i>=0?n.slice(0,i):"",t=i>=0?n.slice(i+1):n;try{let e=await a(r||"."),o=t.toLowerCase();return e.filter(s=>s.toLowerCase().startsWith(o)).map(s=>r?`${r}/${s}`:s)}catch{return []}}}function Y(a,n,i,r){a.registerTool("goto_definition",{description:"Navigate to the definition of a symbol.",inputSchema:R,outputSchema:{snippets:z$1.array(z$1.object({uri:z$1.string(),startLine:z$1.number(),endLine:z$1.number(),content:z$1.string()}))}},async t=>{r?.onInput?.(t);try{let e=d(t.uri),o={symbolName:t.symbol_name,lineHint:t.line_hint,orderHint:t.order_hint},s=await i.resolvePosition(e,o),c=(await n.provideDefinition(e,s)).map(l=>({uri:l.uri,startLine:l.range.start.line+1,endLine:l.range.end.line+1,content:l.content}));return r?.onOutput?.({snippets:c}),f({snippets:c})}catch(e){let o=e instanceof g?e.message:`Error: ${e instanceof Error?e.message:String(e)}`;return {content:[{type:"text",text:o}],structuredContent:{error:o},isError:true}}});}function Z(a,n,i,r){let t=n.provideTypeDefinition;t&&a.registerTool("goto_type_definition",{description:"Navigate to the type definition of a symbol.",inputSchema:R,outputSchema:{snippets:z$1.array(z$1.object({uri:z$1.string(),startLine:z$1.number(),endLine:z$1.number(),content:z$1.string()}))}},async e=>{r?.onInput?.(e);try{let o=d(e.uri),s={symbolName:e.symbol_name,lineHint:e.line_hint,orderHint:e.order_hint},c=await i.resolvePosition(o,s),l=(await t(o,c)).map(m=>({uri:m.uri,startLine:m.range.start.line+1,endLine:m.range.end.line+1,content:m.content}));return r?.onOutput?.({snippets:l}),f({snippets:l})}catch(o){let s=o instanceof g?o.message:`Error: ${o instanceof Error?o.message:String(o)}`;return {content:[{type:"text",text:s}],structuredContent:{error:s},isError:true}}});}function ee(a,n,i,r){a.registerTool("find_references",{description:"Find all references to a symbol. Returns a list of locations where the symbol is used.",inputSchema:R,outputSchema:{snippets:z$1.array(z$1.object({uri:z$1.string(),startLine:z$1.number(),endLine:z$1.number(),content:z$1.string()}))}},async t=>{r?.onInput?.(t);try{let e=d(t.uri),o={symbolName:t.symbol_name,lineHint:t.line_hint,orderHint:t.order_hint},s=await i.resolvePosition(e,o),c=(await n.provideReferences(e,s)).map(l=>({uri:l.uri,startLine:l.range.start.line+1,endLine:l.range.end.line+1,content:l.content}));return r?.onOutput?.({snippets:c}),f({snippets:c})}catch(e){let o=e instanceof g?e.message:`Error: ${e instanceof Error?e.message:String(e)}`;return {content:[{type:"text",text:o}],structuredContent:{error:o},isError:true}}});}function te(a,n,i,r){a.registerTool("call_hierarchy",{description:"Get call hierarchy for a function or method. Shows incoming or outgoing calls.",inputSchema:J,outputSchema:{snippets:z$1.array(z$1.object({uri:z$1.string(),startLine:z$1.number(),endLine:z$1.number(),content:z$1.string()}))}},async t=>{r?.onInput?.(t);try{let e=d(t.uri),o={symbolName:t.symbol_name,lineHint:t.line_hint,orderHint:t.order_hint},s=await i.resolvePosition(e,o),c=(await n.provideCallHierarchy(e,s,t.direction)).map(l=>({uri:l.uri,startLine:l.range.start.line+1,endLine:l.range.end.line+1,content:l.content}));return r?.onOutput?.({snippets:c}),f({snippets:c})}catch(e){let o=e instanceof g?e.message:`Error: ${e instanceof Error?e.message:String(e)}`;return {content:[{type:"text",text:o}],structuredContent:{error:o},isError:true}}});}function re(a,n,i){let r=n.provideFileReferences;r&&a.registerTool("find_file_references",{description:"Find all references to a file across the workspace. Returns locations that import or link to the given file.",inputSchema:Q,outputSchema:{snippets:z$1.array(z$1.object({uri:z$1.string(),startLine:z$1.number(),endLine:z$1.number(),content:z$1.string()}))}},async t=>{i?.onInput?.(t);try{let e=d(t.uri),o=(await r(e)).map(s=>({uri:s.uri,startLine:s.range.start.line+1,endLine:s.range.end.line+1,content:s.content}));return i?.onOutput?.({snippets:o}),f({snippets:o})}catch(e){let o=`Error: ${e instanceof Error?e.message:String(e)}`;return {content:[{type:"text",text:o}],structuredContent:{error:o},isError:true}}});}function ne(a,n,i){let r=new ResourceTemplate("diagnostics://{+path}",{list:void 0,complete:i?{path:i}:void 0});if(a.registerResource("diagnostics",r,{description:"Diagnostics (errors, warnings, hints) for a specific file. Use the file path after diagnostics://",mimeType:"text/markdown"},async(t,e)=>{try{let o=e.path,s=d(o),c=await n.provideDiagnostics(s),l=L(c);return {contents:[{uri:`diagnostics://${o}`,mimeType:"text/markdown",text:l}]}}catch(o){let s=`Error: ${o instanceof Error?o.message:String(o)}`;return {contents:[{uri:`diagnostics://${e.path}`,mimeType:"text/markdown",text:s}]}}}),n.getWorkspaceDiagnostics){let t=n.getWorkspaceDiagnostics.bind(n);a.registerResource("workspace-diagnostics","diagnostics://workspace",{description:"All diagnostics (errors, warnings, hints) across the entire workspace",mimeType:"text/markdown"},async()=>{try{let e=await t(),o=new Map;for(let c of e){let l=o.get(c.uri)??[];l.push(c),o.set(c.uri,l);}if(o.size===0)return {contents:[{uri:"diagnostics://workspace",mimeType:"text/markdown",text:"No diagnostics found in workspace."}]};let s=[];for(let[c,l]of o)s.push(`## ${c}
+${L(l)}`);return {contents:[{uri:"diagnostics://workspace",mimeType:"text/markdown",text:s.join(`
 
-`)}]}}catch(n){return {contents:[{uri:"diagnostics://workspace",mimeType:"text/markdown",text:`Error: ${n instanceof Error?n.message:String(n)}`}]}}});}e.onDiagnosticsChanged&&e.onDiagnosticsChanged(o=>{let n=m(o);r.server.sendResourceUpdated({uri:`diagnostics://${n}`}),e.getWorkspaceDiagnostics&&r.server.sendResourceUpdated({uri:"diagnostics://workspace"});});}function ne(r,e,i){let a=new ResourceTemplate("outline://{+path}",{list:void 0,complete:i?{path:i}:void 0});r.registerResource("outline",a,{description:"Document outline (symbols like classes, functions, variables) for a specific file. Use the file path after outline://",mimeType:"text/markdown"},async(o,n)=>{try{let t=n.path,s=m(t),c=await e.provideDocumentSymbols(s),l=D(c);return {contents:[{uri:`outline://${t}`,mimeType:"text/markdown",text:l}]}}catch(t){let s=`Error: ${t instanceof Error?t.message:String(t)}`;return {contents:[{uri:`outline://${n.path}`,mimeType:"text/markdown",text:s}]}}});}function re(r,e,i,a){let o=e.previewAndApplyEdits?.bind(e)??e.applyEdits?.bind(e);o&&r.registerTool("apply_edit",{description:'Apply a text edit to a file. WORKFLOW: First read the file via the files:// resource to get hashline-formatted content (e.g., "3:a1|  return x"). Then reference lines by their "line:hash" to specify the edit range. The hash verifies the file has not changed since your read \u2014 if it has, the edit is rejected and you must re-read the file. For single-line edits, only start_hash is needed. For multi-line edits, provide both start_hash and end_hash. The edit replaces the entire line range (inclusive) with replace_text. The edit must be approved by the user before being applied.',inputSchema:{uri:v.shape.uri,start_hash:v.shape.start_hash,end_hash:v.shape.end_hash,replace_text:v.shape.replace_text,description:v.shape.description},outputSchema:{success:z.boolean(),message:z.string()}},async n=>{a?.onInput?.(n);try{let t=m(n.uri),s=_(n.start_hash),c=n.end_hash?_(n.end_hash):s,d=(await i(t)).split(/\r?\n/);if(s.line<1||s.line>d.length)throw new Error(`Start line ${s.line} is out of range (file has ${d.length} lines)`);if(c.line<s.line||c.line>d.length)throw new Error(`End line ${c.line} is out of range (file has ${d.length} lines)`);let h=d[s.line-1],b=I(h);if(b!==s.hash)throw new Error(`Hash mismatch at line ${s.line}: expected "${s.hash}", got "${b}". File has changed since last read.`);let P=d[c.line-1],F=I(P);if(F!==c.hash)throw new Error(`Hash mismatch at line ${c.line}: expected "${c.hash}", got "${F}". File has changed since last read.`);let k={start:{line:s.line-1,character:0},end:{line:c.line-1,character:P.length}},T={id:G(),uri:t,edits:[{range:k,newText:n.replace_text}],description:n.description},y=await o(T)?{success:!0,message:"Edit successfully applied and saved."}:{success:!1,message:"Edit rejected by user."};return a?.onOutput?.(y),f(y)}catch(t){let s=`Error: ${t instanceof Error?t.message:String(t)}`;return {content:[{type:"text",text:s}],structuredContent:{success:false,message:s},isError:true}}});}function ie(r,e){let{readFile:i,readDirectory:a}=e,o=new ResourceTemplate("files://{+path}",{list:void 0,complete:{path:A(a)}});r.registerResource("filesystem",o,{description:'Access filesystem resources. For directories: returns children as JSON (git-ignored files excluded). For files: returns content in hashline format where each line is prefixed with "<lineNumber>:<hash>|" (e.g., "1:a3|function hello() {"). The hash is a 2-char hex CRC16 digest of the line content. Use these line:hash references with the apply_edit tool to make edits. Supports line ranges with #L23 or #L23-L30 fragment. Supports regex filtering with ?pattern=<regex> query parameter (matches raw line text, not the hash prefix). Line numbers in the output are always the original file line numbers, even when filtering.'},async(n,t)=>{let s=n.toString();try{let c=t.path,l,d=c,h=c.indexOf("#");h!==-1&&(l=c.slice(h+1),d=c.slice(0,h));let{path:b,params:P}=V(d),{path:F,params:k}=V(l??"");l=l?F:void 0;let T=new URLSearchParams([...P.entries(),...k.entries()]),R=m(b),y=ye(l),z=T.get("pattern");try{let L=await i(R),S=C(L);if(y&&(S=S.filter(O=>O.num>=y.start&&O.num<=y.end)),z){let O=new RegExp(z);S=S.filter(de=>O.test(de.text));}return {contents:[{uri:s,mimeType:"text/plain",text:M(S)}]}}catch{let L=await a(R);return {contents:[{uri:s,mimeType:"application/json",text:JSON.stringify(L)}]}}}catch(c){let l=`Error: ${c instanceof Error?c.message:String(c)}`;return {contents:[{uri:s,mimeType:"text/plain",text:l}]}}}),e.onFileChanged&&e.onFileChanged(n=>{let t=m(n);r.server.sendResourceUpdated({uri:`files://${t}`});});}function oe(r,e,i){r.registerTool("global_find",{description:"Search for text across the entire workspace.",inputSchema:q,outputSchema:{matches:z.array(z.object({uri:z.string(),line:z.number(),column:z.number(),matchText:z.string(),context:z.string()})),count:z.number()}},async a=>{i?.onInput?.(a);try{let o=a.case_sensitive??!1,n=a.exact_match??!1,t=a.regex_mode??!1,s=await e.globalFind(a.query,{caseSensitive:o,exactMatch:n,regexMode:t});return i?.onOutput?.({count:s.length,matches:s}),f({count:s.length,matches:s})}catch(o){let n=`Error: ${o instanceof Error?o.message:String(o)}`;return {content:[{type:"text",text:n}],structuredContent:{error:n},isError:true}}});}function se(r,e,i){let a=new ResourceTemplate("outlinks://{+path}",{list:void 0,complete:i?{path:i}:void 0});r.registerResource("outlinks",a,{description:"Outgoing links from a specific file. Use the file path after outlinks://",mimeType:"application/json"},async(n,t)=>{try{let s=t.path,c=m(s),l=await e.resolveOutlinks(c);return {contents:[{uri:`outlinks://${s}`,mimeType:"application/json",text:JSON.stringify(l,null,2)}]}}catch(s){let c=`Error: ${s instanceof Error?s.message:String(s)}`;return {contents:[{uri:`outlinks://${t.path}`,mimeType:"application/json",text:JSON.stringify({error:c})}]}}});let o=new ResourceTemplate("backlinks://{+path}",{list:void 0,complete:i?{path:i}:void 0});r.registerResource("backlinks",o,{description:"Incoming links (backlinks) to a specific file. Use the file path after backlinks://",mimeType:"application/json"},async(n,t)=>{try{let s=t.path,c=m(s),l=await e.resolveBacklinks(c);return {contents:[{uri:`backlinks://${s}`,mimeType:"application/json",text:JSON.stringify(l,null,2)}]}}catch(s){let c=`Error: ${s instanceof Error?s.message:String(s)}`;return {contents:[{uri:`backlinks://${t.path}`,mimeType:"application/json",text:JSON.stringify({error:c})}]}}});}function ae(r,e,i){r.registerTool("get_link_structure",{description:"Get all links in the workspace, showing relationships between documents.",inputSchema:{},outputSchema:{links:z.array(z.object({sourceUri:z.string(),targetUri:z.string(),subpath:z.string().optional(),displayText:z.string().optional(),resolved:z.boolean(),line:z.number(),column:z.number()}))}},async()=>{try{let a=await e.getLinkStructure();return i?.onOutput?.({links:a}),f({links:a})}catch(a){let o=`Error: ${a instanceof Error?a.message:String(a)}`;return {content:[{type:"text",text:o}],structuredContent:{error:o},isError:true}}});}function ce(r,e,i){r.registerTool("add_link",{description:"Add a link to a document by finding a text pattern and replacing it with a link to the target.",inputSchema:B,outputSchema:{success:z.boolean(),message:z.string().optional()}},async a=>{i?.onInput?.(a);try{let o=m(a.path),n=m(a.link_to);await e.addLink(o,a.pattern,n);let t={success:!0,message:"Link added successfully."};return i?.onOutput?.(t),f(t)}catch(o){let n=`Error: ${o instanceof Error?o.message:String(o)}`;return {content:[{type:"text",text:n}],structuredContent:{success:false,message:n},isError:true}}});}function ue(r,e,i){r.registerTool("get_frontmatter_structure",{description:"Get frontmatter property values across documents. If path is provided, searches only that document. Otherwise, searches all documents.",inputSchema:Q,outputSchema:{matches:z.array(z.object({path:z.string(),value:z.unknown()}))}},async a=>{i?.onInput?.(a);try{let o=a.path?m(a.path):void 0,n=await e.getFrontmatterStructure(a.property,o);return i?.onOutput?.({matches:n}),f({matches:n})}catch(o){let n=`Error: ${o instanceof Error?o.message:String(o)}`;return {content:[{type:"text",text:n}],structuredContent:{error:n},isError:true}}});}function le(r,e,i){r.registerTool("set_frontmatter",{description:"Set a frontmatter property on a document. Use null to remove the property.",inputSchema:K,outputSchema:{success:z.boolean(),message:z.string().optional()}},async a=>{i?.onInput?.(a);try{let o=m(a.path),n=a.value===null?void 0:a.value;await e.setFrontmatter(o,a.property,n);let t={success:!0,message:"Frontmatter updated successfully."};return i?.onOutput?.(t),f(t)}catch(o){let n=`Error: ${o instanceof Error?o.message:String(o)}`;return {content:[{type:"text",text:n}],structuredContent:{success:false,message:n},isError:true}}});}function pe(r,e,i){let a=new ResourceTemplate("frontmatter://{+path}",{list:void 0,complete:i?{path:i}:void 0});r.registerResource("frontmatter",a,{description:"Frontmatter metadata for a specific file. Use the file path after frontmatter://",mimeType:"application/json"},async(o,n)=>{try{let t=n.path,s=m(t),c=await e.getFrontmatter(s);return {contents:[{uri:`frontmatter://${t}`,mimeType:"application/json",text:JSON.stringify(c,null,2)}]}}catch(t){let s=`Error: ${t instanceof Error?t.message:String(t)}`;return {contents:[{uri:`frontmatter://${n.path}`,mimeType:"application/json",text:JSON.stringify({error:s})}]}}});}function $e(r,e,i){let a=i?.fileAccess,o=a?A(a.readDirectory):void 0,n=()=>{if(!a)throw new Error("fileAccess is required in options for providers that need symbol resolution");return new w(a,i?.resolverConfig)};if("readFile"in e&&"readDirectory"in e){ie(r,e);return}if("applyEdits"in e||"previewAndApplyEdits"in e){if(!a)throw new Error("fileAccess is required in options when installing an EditProvider");let t=i;re(r,e,a.readFile,{onInput:t?.onEditInput,onOutput:t?.onEditOutput});return}if("provideDefinition"in e){let t=e,s=i,c=n();X(r,t,c,{onInput:s?.onDefinitionInput,onOutput:s?.onDefinitionOutput}),t.provideTypeDefinition&&Y(r,t,c,{onInput:s?.onTypeDefinitionInput,onOutput:s?.onTypeDefinitionOutput});return}if("provideReferences"in e){let t=i;Z(r,e,n(),{onInput:t?.onReferencesInput,onOutput:t?.onReferencesOutput});return}if("provideCallHierarchy"in e){let t=i;ee(r,e,n(),{onInput:t?.onCallHierarchyInput,onOutput:t?.onCallHierarchyOutput});return}if("provideDiagnostics"in e){te(r,e,o);return}if("provideDocumentSymbols"in e){ne(r,e,o);return}if("globalFind"in e){let t=i;oe(r,e,{onInput:t?.onGlobalFindInput,onOutput:t?.onGlobalFindOutput});return}if("getLinkStructure"in e){let t=e,s=i;ae(r,t,{onOutput:s?.onLinkStructureOutput}),ce(r,t,{onInput:s?.onAddLinkInput,onOutput:s?.onAddLinkOutput}),se(r,t,o);return}if("getFrontmatterStructure"in e){let t=e,s=i;ue(r,t,{onInput:s?.onFrontmatterStructureInput,onOutput:s?.onFrontmatterStructureOutput}),le(r,t,{onInput:s?.onSetFrontmatterInput,onOutput:s?.onSetFrontmatterOutput}),pe(r,t,o);return}}
-export{$e as install};
+`)}]}}catch(e){return {contents:[{uri:"diagnostics://workspace",mimeType:"text/markdown",text:`Error: ${e instanceof Error?e.message:String(e)}`}]}}});}n.onDiagnosticsChanged&&n.onDiagnosticsChanged(t=>{let e=d(t);a.server.sendResourceUpdated({uri:`diagnostics://${e}`}),n.getWorkspaceDiagnostics&&a.server.sendResourceUpdated({uri:"diagnostics://workspace"});});}function ie(a,n,i){let r=new ResourceTemplate("outline://{+path}",{list:void 0,complete:i?{path:i}:void 0});a.registerResource("outline",r,{description:"Document outline (symbols like classes, functions, variables) for a specific file. Use the file path after outline://",mimeType:"text/markdown"},async(t,e)=>{try{let o=e.path,s=d(o),c=await n.provideDocumentSymbols(s),l=$(c);return {contents:[{uri:`outline://${o}`,mimeType:"text/markdown",text:l}]}}catch(o){let s=`Error: ${o instanceof Error?o.message:String(o)}`;return {contents:[{uri:`outline://${e.path}`,mimeType:"text/markdown",text:s}]}}});}function oe(a,n,i,r){let t=n.previewAndApplyEdits?.bind(n)??n.applyEdits?.bind(n);t&&a.registerTool("apply_edit",{description:'Apply a text edit to a file. WORKFLOW: First read the file via the files:// resource to get hashline-formatted content (e.g., "3:a1|  return x"). Then reference lines by their "line:hash" to specify the edit range. The hash verifies the file has not changed since your read \u2014 if it has, the edit is rejected and you must re-read the file. For single-line edits, only start_hash is needed. For multi-line edits, provide both start_hash and end_hash. The edit replaces the entire line range (inclusive) with replace_text. The edit must be approved by the user before being applied.',inputSchema:{uri:v.shape.uri,start_hash:v.shape.start_hash,end_hash:v.shape.end_hash,replace_text:v.shape.replace_text,description:v.shape.description},outputSchema:{success:z$1.boolean(),message:z$1.string()}},async e=>{r?.onInput?.(e);try{let o=d(e.uri),s=A(e.start_hash),c=e.end_hash?A(e.end_hash):s,m=(await i(o)).split(/\r?\n/);if(s.line<1||s.line>m.length)throw new Error(`Start line ${s.line} is out of range (file has ${m.length} lines)`);if(c.line<s.line||c.line>m.length)throw new Error(`End line ${c.line} is out of range (file has ${m.length} lines)`);let h=m[s.line-1],b=k(h);if(b!==s.hash)throw new Error(`Hash mismatch at line ${s.line}: expected "${s.hash}", got "${b}". File has changed since last read.`);let P=m[c.line-1],F=k(P);if(F!==c.hash)throw new Error(`Hash mismatch at line ${c.line}: expected "${c.hash}", got "${F}". File has changed since last read.`);let E={start:{line:s.line-1,character:0},end:{line:c.line-1,character:P.length}},I={id:C(),uri:o,edits:[{range:E,newText:e.replace_text}],description:e.description},y=await t(I)?{success:!0,message:"Edit successfully applied and saved."}:{success:!1,message:"Edit rejected by user."};return r?.onOutput?.(y),f(y)}catch(o){let s=`Error: ${o instanceof Error?o.message:String(o)}`;return {content:[{type:"text",text:s}],structuredContent:{success:false,message:s},isError:true}}});}function se(a,n){let{readFile:i,readDirectory:r}=n,t=new ResourceTemplate("files://{+path}",{list:void 0,complete:{path:z(r)}});a.registerResource("filesystem",t,{description:'Access filesystem resources. For directories: returns children as JSON (git-ignored files excluded). For files: returns content in hashline format where each line is prefixed with "<lineNumber>:<hash>|" (e.g., "1:a3|function hello() {"). The hash is a 2-char hex CRC16 digest of the line content. Use these line:hash references with the apply_edit tool to make edits. Supports line ranges with #L23 or #L23-L30 fragment. Supports regex filtering with ?pattern=<regex> query parameter (matches raw line text, not the hash prefix). Line numbers in the output are always the original file line numbers, even when filtering.'},async(e,o)=>{let s=e.toString();try{let c=o.path,l,m=c,h=c.indexOf("#");h!==-1&&(l=c.slice(h+1),m=c.slice(0,h));let{path:b,params:P}=X(m),{path:F,params:E}=X(l??"");l=l?F:void 0;let I=new URLSearchParams([...P.entries(),...E.entries()]),T=d(b),y=Se(l),G=I.get("pattern");try{let D=await i(T),x=M(D);if(y&&(x=x.filter(w=>w.num>=y.start&&w.num<=y.end)),G){let w=new RegExp(G);x=x.filter(fe=>w.test(fe.text));}return {contents:[{uri:s,mimeType:"text/plain",text:j(x)}]}}catch{let D=await r(T);return {contents:[{uri:s,mimeType:"application/json",text:JSON.stringify(D)}]}}}catch(c){let l=`Error: ${c instanceof Error?c.message:String(c)}`;return {contents:[{uri:s,mimeType:"text/plain",text:l}]}}}),n.onFileChanged&&n.onFileChanged(e=>{let o=d(e);a.server.sendResourceUpdated({uri:`files://${o}`});});}function ae(a,n,i){a.registerTool("global_find",{description:"Search for text across the entire workspace.",inputSchema:q,outputSchema:{matches:z$1.array(z$1.object({uri:z$1.string(),line:z$1.number(),column:z$1.number(),matchText:z$1.string(),context:z$1.string()})),count:z$1.number()}},async r=>{i?.onInput?.(r);try{let t=r.case_sensitive??!1,e=r.exact_match??!1,o=r.regex_mode??!1,s=await n.globalFind(r.query,{caseSensitive:t,exactMatch:e,regexMode:o});return i?.onOutput?.({count:s.length,matches:s}),f({count:s.length,matches:s})}catch(t){let e=`Error: ${t instanceof Error?t.message:String(t)}`;return {content:[{type:"text",text:e}],structuredContent:{error:e},isError:true}}});}function ce(a,n,i){let r=new ResourceTemplate("outlinks://{+path}",{list:void 0,complete:i?{path:i}:void 0});a.registerResource("outlinks",r,{description:"Outgoing links from a specific file. Use the file path after outlinks://",mimeType:"application/json"},async(e,o)=>{try{let s=o.path,c=d(s),l=await n.resolveOutlinks(c);return {contents:[{uri:`outlinks://${s}`,mimeType:"application/json",text:JSON.stringify(l,null,2)}]}}catch(s){let c=`Error: ${s instanceof Error?s.message:String(s)}`;return {contents:[{uri:`outlinks://${o.path}`,mimeType:"application/json",text:JSON.stringify({error:c})}]}}});let t=new ResourceTemplate("backlinks://{+path}",{list:void 0,complete:i?{path:i}:void 0});a.registerResource("backlinks",t,{description:"Incoming links (backlinks) to a specific file. Use the file path after backlinks://",mimeType:"application/json"},async(e,o)=>{try{let s=o.path,c=d(s),l=await n.resolveBacklinks(c);return {contents:[{uri:`backlinks://${s}`,mimeType:"application/json",text:JSON.stringify(l,null,2)}]}}catch(s){let c=`Error: ${s instanceof Error?s.message:String(s)}`;return {contents:[{uri:`backlinks://${o.path}`,mimeType:"application/json",text:JSON.stringify({error:c})}]}}});}function ue(a,n,i){a.registerTool("get_link_structure",{description:"Get all links in the workspace, showing relationships between documents.",inputSchema:{},outputSchema:{links:z$1.array(z$1.object({sourceUri:z$1.string(),targetUri:z$1.string(),subpath:z$1.string().optional(),displayText:z$1.string().optional(),resolved:z$1.boolean(),line:z$1.number(),column:z$1.number()}))}},async()=>{try{let r=await n.getLinkStructure();return i?.onOutput?.({links:r}),f({links:r})}catch(r){let t=`Error: ${r instanceof Error?r.message:String(r)}`;return {content:[{type:"text",text:t}],structuredContent:{error:t},isError:true}}});}function le(a,n,i){a.registerTool("add_link",{description:"Add a link to a document by finding a text pattern and replacing it with a link to the target.",inputSchema:B,outputSchema:{success:z$1.boolean(),message:z$1.string().optional()}},async r=>{i?.onInput?.(r);try{let t=d(r.path),e=d(r.link_to);await n.addLink(t,r.pattern,e);let o={success:!0,message:"Link added successfully."};return i?.onOutput?.(o),f(o)}catch(t){let e=`Error: ${t instanceof Error?t.message:String(t)}`;return {content:[{type:"text",text:e}],structuredContent:{success:false,message:e},isError:true}}});}function pe(a,n,i){a.registerTool("get_frontmatter_structure",{description:"Get frontmatter property values across documents. If path is provided, searches only that document. Otherwise, searches all documents.",inputSchema:K,outputSchema:{matches:z$1.array(z$1.object({path:z$1.string(),value:z$1.unknown()}))}},async r=>{i?.onInput?.(r);try{let t=r.path?d(r.path):void 0,e=await n.getFrontmatterStructure(r.property,t);return i?.onOutput?.({matches:e}),f({matches:e})}catch(t){let e=`Error: ${t instanceof Error?t.message:String(t)}`;return {content:[{type:"text",text:e}],structuredContent:{error:e},isError:true}}});}function de(a,n,i){a.registerTool("set_frontmatter",{description:"Set a frontmatter property on a document. Use null to remove the property.",inputSchema:V,outputSchema:{success:z$1.boolean(),message:z$1.string().optional()}},async r=>{i?.onInput?.(r);try{let t=d(r.path),e=r.value===null?void 0:r.value;await n.setFrontmatter(t,r.property,e);let o={success:!0,message:"Frontmatter updated successfully."};return i?.onOutput?.(o),f(o)}catch(t){let e=`Error: ${t instanceof Error?t.message:String(t)}`;return {content:[{type:"text",text:e}],structuredContent:{success:false,message:e},isError:true}}});}function me(a,n,i){let r=new ResourceTemplate("frontmatter://{+path}",{list:void 0,complete:i?{path:i}:void 0});a.registerResource("frontmatter",r,{description:"Frontmatter metadata for a specific file. Use the file path after frontmatter://",mimeType:"application/json"},async(t,e)=>{try{let o=e.path,s=d(o),c=await n.getFrontmatter(s);return {contents:[{uri:`frontmatter://${o}`,mimeType:"application/json",text:JSON.stringify(c,null,2)}]}}catch(o){let s=`Error: ${o instanceof Error?o.message:String(o)}`;return {contents:[{uri:`frontmatter://${e.path}`,mimeType:"application/json",text:JSON.stringify({error:s})}]}}});}function xe(a){if(a.length<=0)throw new Error("providers array must not be empty");if(a.length===1&&a[0])return a[0];let n=a[0];if(!n)throw new Error("The first item of providers array must be defined");if("readFile"in n&&"readDirectory"in n){let i=a,r={readFile:t=>n.readFile(t),readDirectory:t=>n.readDirectory(t)};return i.some(t=>t.onFileChanged)&&(r.onFileChanged=t=>{for(let e of i)e.onFileChanged?.(t);}),r}if("applyEdits"in n||"previewAndApplyEdits"in n)return n;if("provideDefinition"in n){let i=a,r={async provideDefinition(t,e){return (await Promise.all(i.map(s=>s.provideDefinition(t,e)))).flat()}};return i.some(t=>t.provideTypeDefinition)&&(r.provideTypeDefinition=async(t,e)=>{let o=i.filter(c=>c.provideTypeDefinition);return (await Promise.all(o.map(c=>c.provideTypeDefinition(t,e)))).flat()}),r}if("provideReferences"in n){let i=a,r={async provideReferences(t,e){return (await Promise.all(i.map(s=>s.provideReferences(t,e)))).flat()}};return i.some(t=>t.provideFileReferences)&&(r.provideFileReferences=async t=>{let e=i.filter(s=>s.provideFileReferences);return (await Promise.all(e.map(s=>s.provideFileReferences(t)))).flat()}),r}if("provideCallHierarchy"in n){let i=a;return {async provideCallHierarchy(r,t,e){return (await Promise.all(i.map(s=>s.provideCallHierarchy(r,t,e)))).flat()}}}if("provideDiagnostics"in n){let i=a,r={async provideDiagnostics(t){return (await Promise.all(i.map(o=>o.provideDiagnostics(t)))).flat()}};return i.some(t=>t.getWorkspaceDiagnostics)&&(r.getWorkspaceDiagnostics=async()=>{let t=i.filter(o=>o.getWorkspaceDiagnostics);return (await Promise.all(t.map(o=>o.getWorkspaceDiagnostics()))).flat()}),i.some(t=>t.onDiagnosticsChanged)&&(r.onDiagnosticsChanged=t=>{for(let e of i)e.onDiagnosticsChanged?.(t);}),r}if("provideDocumentSymbols"in n){let i=a;return {async provideDocumentSymbols(r){return (await Promise.all(i.map(e=>e.provideDocumentSymbols(r)))).flat()}}}if("globalFind"in n){let i=a;return {async globalFind(r,t){return (await Promise.all(i.map(o=>o.globalFind(r,t)))).flat()}}}if("getLinkStructure"in n){let i=a;return {async getLinkStructure(){return (await Promise.all(i.map(t=>t.getLinkStructure()))).flat()},async resolveOutlinks(r){return (await Promise.all(i.map(e=>e.resolveOutlinks(r)))).flat()},async resolveBacklinks(r){return (await Promise.all(i.map(e=>e.resolveBacklinks(r)))).flat()},async addLink(r,t,e){await Promise.all(i.map(o=>o.addLink(r,t,e)));}}}if("getFrontmatterStructure"in n){let i=a;return {async getFrontmatterStructure(r,t){return (await Promise.all(i.map(o=>o.getFrontmatterStructure(r,t)))).flat()},async getFrontmatter(r){let t=await Promise.all(i.map(e=>e.getFrontmatter(r)));return Object.assign({},...t)},async setFrontmatter(r,t,e){await Promise.all(i.map(o=>o.setFrontmatter(r,t,e)));}}}return n}function _e(a,n,i){let r=Array.isArray(n)?xe(n):n,t=i?.fileAccess,e=t?z(t.readDirectory):void 0,o=()=>{if(!t)throw new Error("fileAccess is required in options for providers that need symbol resolution");return new O(t,i?.resolverConfig)};if("readFile"in r&&"readDirectory"in r){se(a,r);return}if("applyEdits"in r||"previewAndApplyEdits"in r){if(!t)throw new Error("fileAccess is required in options when installing an EditProvider");let s=i;oe(a,r,t.readFile,{onInput:s?.onEditInput,onOutput:s?.onEditOutput});return}if("provideDefinition"in r){let s=r,c=i,l=o();Y(a,s,l,{onInput:c?.onDefinitionInput,onOutput:c?.onDefinitionOutput}),s.provideTypeDefinition&&Z(a,s,l,{onInput:c?.onTypeDefinitionInput,onOutput:c?.onTypeDefinitionOutput});return}if("provideReferences"in r){let s=r,c=i;ee(a,s,o(),{onInput:c?.onReferencesInput,onOutput:c?.onReferencesOutput}),re(a,s,{onInput:c?.onFileReferencesInput,onOutput:c?.onFileReferencesOutput});return}if("provideCallHierarchy"in r){let s=i;te(a,r,o(),{onInput:s?.onCallHierarchyInput,onOutput:s?.onCallHierarchyOutput});return}if("provideDiagnostics"in r){ne(a,r,e);return}if("provideDocumentSymbols"in r){ie(a,r,e);return}if("globalFind"in r){let s=i;ae(a,r,{onInput:s?.onGlobalFindInput,onOutput:s?.onGlobalFindOutput});return}if("getLinkStructure"in r){let s=r,c=i;ue(a,s,{onOutput:c?.onLinkStructureOutput}),le(a,s,{onInput:c?.onAddLinkInput,onOutput:c?.onAddLinkOutput}),ce(a,s,e);return}if("getFrontmatterStructure"in r){let s=r,c=i;pe(a,s,{onInput:c?.onFrontmatterStructureInput,onOutput:c?.onFrontmatterStructureOutput}),de(a,s,{onInput:c?.onSetFrontmatterInput,onOutput:c?.onSetFrontmatterOutput}),me(a,s,e);return}}
+export{_e as install};

package/dist/resolver-CSuvobsJ.d.ts

@@ -0,0 +1,69 @@
+import { F as FileAccessProvider, U as UnifiedUri, n as FuzzyPosition, j as ExactPosition } from './interfaces-wSmWeYxt.js';
+
+/**
+ * Smart Resolver Logic for MCP LSP Driver SDK
+ *
+ * This is the internal engine of the SDK. It translates the LLM's imprecise
+ * instructions into precise coordinates.
+ */
+
+/**
+ * Configuration options for the SymbolResolver.
+ */
+interface ResolverConfig {
+    /**
+     * Number of lines to scan above and below the lineHint if the symbol
+     * is not found at the exact line. Defaults to 2.
+     */
+    lineSearchRadius?: number;
+}
+/**
+ * Error thrown when a symbol cannot be resolved.
+ */
+declare class SymbolResolutionError extends Error {
+    readonly symbolName: string;
+    readonly lineHint: number;
+    readonly reason: string;
+    constructor(symbolName: string, lineHint: number, reason: string);
+}
+/**
+ * The SymbolResolver translates fuzzy positions (as provided by an LLM)
+ * into exact positions that can be used by the IDE.
+ *
+ * Algorithm:
+ * 1. Read file content via FileAccessProvider.
+ * 2. Split content into lines.
+ * 3. Target the lineHint (converting 1-based to 0-based).
+ * 4. Search for symbolName in that line.
+ *    - If orderHint is 0, find first occurrence.
+ *    - If orderHint is N, find Nth occurrence.
+ * 5. Robustness Fallback:
+ *    - If the line is empty or symbol not found at lineHint,
+ *      scan +/- lineSearchRadius lines to handle minor line shifts.
+ * 6. Return ExactPosition (line, character start index).
+ */
+declare class SymbolResolver {
+    private readonly fs;
+    private readonly lineSearchRadius;
+    constructor(fs: FileAccessProvider, config?: ResolverConfig);
+    /**
+     * Resolves a fuzzy position to an exact position.
+     *
+     * @param uri - The URI of the file
+     * @param fuzzy - The fuzzy position provided by the LLM
+     * @returns The exact position in the file
+     * @throws SymbolResolutionError if the symbol cannot be found
+     */
+    resolvePosition(uri: UnifiedUri, fuzzy: FuzzyPosition): Promise<ExactPosition>;
+    /**
+     * Finds the Nth occurrence of a symbol in a line.
+     *
+     * @param line - The line to search in (may be undefined if out of bounds)
+     * @param symbolName - The symbol to find
+     * @param orderHint - Which occurrence to find (0-based)
+     * @returns The character offset of the symbol, or null if not found
+     */
+    private findSymbolInLine;
+}
+
+export { type ResolverConfig as R, SymbolResolutionError as S, SymbolResolver as a };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opticlm/connector",
-  "version": "2.0.1",
+  "version": "2.2.0",
   "description": "Provides an abstract interface that allows LLMs to connect to fact sources such as LSPs, code diagnostics, symbol definitions/references, links, and frontmatter",
   "type": "module",
   "types": "dist/index.d.ts",
@@ -52,6 +52,7 @@
     "@types/node": "^25",
     "tsup": "^8.5.1",
     "typescript": "^5.9",
+    "nanoid": "^5.1.7",
     "vitest": "^4"
   },
   "engines": {

package/dist/resolver-Cg62Av4_.d.ts

@@ -1,129 +0,0 @@
-import { P as PendingEditOperation, U as UnifiedUri, l as FuzzyPosition, h as ExactPosition } from './capabilities-CQHv2shL.js';
-
-/**
- * Infrastructure Interfaces for MCP LSP Driver SDK
- *
- * The SDK consumer (Plugin Developer) must implement these interfaces
- * to bridge the SDK to the specific IDE.
- */
-
-/**
- * Provides access to the file system for reading files.
- * Since the SDK is responsible for resolving FuzzyPosition to ExactPosition,
- * it needs direct access to read files from the disk.
- */
-interface FileAccessProvider {
-    /**
-     * Reads the content of a file from the disk (ignoring unsaved IDE buffers).
-     * Used for symbol resolution and context retrieval.
-     *
-     * @param uri - The URI of the file to read
-     * @returns The content of the file as a string
-     * @throws Error if the file cannot be read
-     */
-    readFile(uri: UnifiedUri): Promise<string>;
-    /**
-     * Read children in a directory, exluding git-ignored files, similar to Unix `ls` command
-     * @param relativePath - The path to the folder to read
-     * @returns Array of file/folder paths in the directory
-     */
-    readDirectory(relativePath: UnifiedUri): Promise<string[]>;
-    /**
-     * Called by the driver to register a callback for file changes.
-     * When provided, the files:// resources become subscribable.
-     * The plugin should call the registered callback whenever a file changes.
-     *
-     * @param callback - The callback to invoke when a file changes
-     */
-    onFileChanged?(callback: (uri: UnifiedUri) => void): void;
-}
-/**
- * Provides edit capabilities for applying changes to files.
- * At least one of the methods must be implemented.
- */
-interface EditProvider {
-    /**
-     * Applies edits directly without user interaction.
-     * Use this when user approval is handled elsewhere or not needed.
-     *
-     * @param operation - The pending edit operation to apply
-     * @returns true if applied successfully, false if failed
-     */
-    applyEdits?(operation: PendingEditOperation): Promise<boolean>;
-    /**
-     * Displays a diff view or a confirmation dialog in the IDE.
-     * The user decides whether to apply the edits or discard them.
-     *
-     * @param operation - The pending edit operation to preview
-     * @returns true if applied, false if rejected/cancelled
-     */
-    previewAndApplyEdits?(operation: PendingEditOperation): Promise<boolean>;
-}
-
-/**
- * Smart Resolver Logic for MCP LSP Driver SDK
- *
- * This is the internal engine of the SDK. It translates the LLM's imprecise
- * instructions into precise coordinates.
- */
-
-/**
- * Configuration options for the SymbolResolver.
- */
-interface ResolverConfig {
-    /**
-     * Number of lines to scan above and below the lineHint if the symbol
-     * is not found at the exact line. Defaults to 2.
-     */
-    lineSearchRadius?: number;
-}
-/**
- * Error thrown when a symbol cannot be resolved.
- */
-declare class SymbolResolutionError extends Error {
-    readonly symbolName: string;
-    readonly lineHint: number;
-    readonly reason: string;
-    constructor(symbolName: string, lineHint: number, reason: string);
-}
-/**
- * The SymbolResolver translates fuzzy positions (as provided by an LLM)
- * into exact positions that can be used by the IDE.
- *
- * Algorithm:
- * 1. Read file content via FileAccessProvider.
- * 2. Split content into lines.
- * 3. Target the lineHint (converting 1-based to 0-based).
- * 4. Search for symbolName in that line.
- *    - If orderHint is 0, find first occurrence.
- *    - If orderHint is N, find Nth occurrence.
- * 5. Robustness Fallback:
- *    - If the line is empty or symbol not found at lineHint,
- *      scan +/- lineSearchRadius lines to handle minor line shifts.
- * 6. Return ExactPosition (line, character start index).
- */
-declare class SymbolResolver {
-    private readonly fs;
-    private readonly lineSearchRadius;
-    constructor(fs: FileAccessProvider, config?: ResolverConfig);
-    /**
-     * Resolves a fuzzy position to an exact position.
-     *
-     * @param uri - The URI of the file
-     * @param fuzzy - The fuzzy position provided by the LLM
-     * @returns The exact position in the file
-     * @throws SymbolResolutionError if the symbol cannot be found
-     */
-    resolvePosition(uri: UnifiedUri, fuzzy: FuzzyPosition): Promise<ExactPosition>;
-    /**
-     * Finds the Nth occurrence of a symbol in a line.
-     *
-     * @param line - The line to search in (may be undefined if out of bounds)
-     * @param symbolName - The symbol to find
-     * @param orderHint - Which occurrence to find (0-based)
-     * @returns The character offset of the symbol, or null if not found
-     */
-    private findSymbolInLine;
-}
-
-export { type EditProvider as E, type FileAccessProvider as F, type ResolverConfig as R, SymbolResolutionError as S, SymbolResolver as a };