@opticlm/connector 2.0.0

package/dist/capabilities-CQHv2shL.d.ts

@@ -0,0 +1,379 @@
+/**
+ * Core Data Models for MCP LSP Driver SDK
+ *
+ * These types define how the LLM communicates intent versus
+ * how the IDE executes commands.
+ */
+/**
+ * A Unified Resource Identifier.
+ * Must be a file system path.
+ */
+type UnifiedUri = string;
+/**
+ * 0-based exact coordinate system (Used internally by IDE).
+ */
+interface ExactPosition {
+    /** 0-based line number */
+    line: number;
+    /** 0-based column (character offset) */
+    character: number;
+}
+/**
+ * The fuzzy location provided by the LLM.
+ * Designed to be robust against minor formatting changes or token counting errors.
+ */
+interface FuzzyPosition {
+    /**
+     * The text of the symbol to find (e.g., function name, variable name).
+     */
+    symbolName: string;
+    /**
+     * An approximate line number where the symbol is expected.
+     * 1-based (Human friendly) for LLM input, converted to 0-based internally.
+     */
+    lineHint: number;
+    /**
+     * If the symbol appears multiple times on the line, which occurrence to target?
+     * 0-based index. Defaults to 0 (the first occurrence).
+     * Example: "add(a, a)" -> looking for second 'a' -> orderHint: 1.
+     */
+    orderHint?: number;
+}
+/**
+ * Represents a resolved span of text on disk.
+ */
+interface DiskRange {
+    start: ExactPosition;
+    end: ExactPosition;
+}
+/**
+ * Represents a snippet of code read from disk.
+ */
+interface CodeSnippet {
+    /** The URI of the file containing the snippet */
+    uri: UnifiedUri;
+    /** The range of the snippet in the file */
+    range: DiskRange;
+    /** The actual text read from disk */
+    content: string;
+}
+/**
+ * Represents a proposed change to a file.
+ */
+interface TextEdit {
+    /** The range to replace */
+    range: DiskRange;
+    /** The new text to insert */
+    newText: string;
+}
+/**
+ * Represents a pending edit operation that awaits user approval.
+ */
+interface PendingEditOperation {
+    /** Unique identifier for this operation */
+    id: string;
+    /** The URI of the file to edit */
+    uri: UnifiedUri;
+    /** The list of edits to apply */
+    edits: TextEdit[];
+    /** Optional description of the edit (e.g., "Refactor logic to handle null cases") */
+    description?: string;
+}
+/**
+ * The reason why an edit operation failed.
+ */
+type EditFailureReason = 'UserRejected' | 'IOError' | 'ValidationFailed';
+/**
+ * The result of an edit operation.
+ */
+type EditResult = {
+    success: boolean;
+    message: string;
+};
+/**
+ * Severity level for diagnostics.
+ */
+type DiagnosticSeverity = 'error' | 'warning' | 'information' | 'hint';
+/**
+ * Represents a diagnostic (error, warning, etc.) from the IDE.
+ */
+interface Diagnostic {
+    /** The URI of the file containing the diagnostic */
+    uri: UnifiedUri;
+    /** The range of the diagnostic */
+    range: DiskRange;
+    /** The severity of the diagnostic */
+    severity: DiagnosticSeverity;
+    /** The diagnostic message */
+    message: string;
+    /** Optional source of the diagnostic (e.g., "typescript", "eslint") */
+    source?: string;
+    /** Optional diagnostic code */
+    code?: string | number;
+}
+/**
+ * Symbol kind for outline items.
+ */
+type SymbolKind = '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';
+/**
+ * Represents a symbol in the document outline (e.g., class, function, variable).
+ */
+interface DocumentSymbol {
+    /** The name of the symbol */
+    name: string;
+    /** More detail for this symbol (e.g., signature) */
+    detail?: string;
+    /** The kind of this symbol */
+    kind: SymbolKind;
+    /** The range of the entire symbol (including body) */
+    range: DiskRange;
+    /** The range of the symbol's name */
+    selectionRange: DiskRange;
+    /** Children of this symbol (e.g., methods in a class) */
+    children?: DocumentSymbol[];
+}
+/**
+ * Allowed values for frontmatter properties.
+ */
+type FrontmatterValue = string | string[] | number | number[] | boolean | boolean[] | Date | undefined;
+/**
+ * A frontmatter object mapping property names to values.
+ */
+type Frontmatter = {
+    [key: string]: FrontmatterValue;
+};
+/**
+ * A frontmatter property match from a structure query.
+ */
+interface FrontmatterMatch {
+    /** The path to the document containing the frontmatter */
+    path: UnifiedUri;
+    /** The value of the frontmatter property */
+    value: FrontmatterValue;
+}
+/**
+ * Represents a link between documents (e.g., wiki-style links, imports, references).
+ */
+interface Link {
+    /** The source URI where this link originates from */
+    sourceUri: UnifiedUri;
+    /** The target URI this link points to */
+    targetUri: UnifiedUri;
+    /** Optional subpath within the target (e.g., heading anchor like #section) */
+    subpath?: string;
+    /** The display text of the link (if different from target) */
+    displayText?: string;
+    /** Whether the link target has been resolved to an existing document */
+    resolved: boolean;
+    /** 1-based line number where the link appears */
+    line: number;
+    /** 1-based column where the link starts */
+    column: number;
+}
+
+/**
+ * Capability Providers for MCP LSP Driver SDK
+ *
+ * Each provider interface corresponds to one LSP capability.
+ * Note: All inputs use ExactPosition. The SDK handles Fuzzy -> Exact conversion.
+ */
+
+/**
+ * Provides go-to-definition functionality.
+ */
+interface DefinitionProvider {
+    /**
+     * Returns definition location reading strictly from disk context.
+     *
+     * @param uri - The URI of the file
+     * @param position - The exact position to find the definition for
+     * @returns Array of code snippets representing definition locations
+     */
+    provideDefinition(uri: UnifiedUri, position: ExactPosition): Promise<CodeSnippet[]>;
+    /**
+     * Returns the type definition location for the symbol at the given position.
+     *
+     * @param uri - The URI of the file
+     * @param position - The exact position to find the type definition for
+     * @returns Array of code snippets representing type definition locations
+     */
+    provideTypeDefinition?(uri: UnifiedUri, position: ExactPosition): Promise<CodeSnippet[]>;
+}
+/**
+ * Provides find-references functionality.
+ */
+interface ReferencesProvider {
+    /**
+     * Finds all references to the symbol at the given position.
+     *
+     * @param uri - The URI of the file
+     * @param position - The exact position to find references for
+     * @returns Array of code snippets representing reference locations
+     */
+    provideReferences(uri: UnifiedUri, position: ExactPosition): Promise<CodeSnippet[]>;
+}
+/**
+ * Provides call hierarchy functionality.
+ */
+interface HierarchyProvider {
+    /**
+     * Provides call hierarchy information for the symbol at the given position.
+     *
+     * @param uri - The URI of the file
+     * @param position - The exact position to get call hierarchy for
+     * @param direction - Whether to get incoming or outgoing calls
+     * @returns Array of code snippets representing call hierarchy items
+     */
+    provideCallHierarchy(uri: UnifiedUri, position: ExactPosition, direction: 'incoming' | 'outgoing'): Promise<CodeSnippet[]>;
+}
+/**
+ * Provides diagnostics (errors, warnings) for a file.
+ */
+interface DiagnosticsProvider {
+    /**
+     * Gets diagnostics for a file.
+     *
+     * @param uri - The URI of the file
+     * @returns Array of diagnostics for the file
+     */
+    provideDiagnostics(uri: UnifiedUri): Promise<Diagnostic[]>;
+    /**
+     * Gets diagnostics for all files in the workspace.
+     * If not provided, the workspace diagnostics resource will not be available.
+     *
+     * @returns Array of diagnostics for all files in the workspace
+     */
+    getWorkspaceDiagnostics?(): Promise<Diagnostic[]>;
+    /**
+     * Called by the driver to register a callback for diagnostics changes.
+     * When provided, the diagnostics resources become subscribable.
+     * The plugin should call the registered callback whenever diagnostics change for a URI.
+     *
+     * @param callback - The callback to invoke when diagnostics change
+     */
+    onDiagnosticsChanged?(callback: (uri: UnifiedUri) => void): void;
+}
+/**
+ * Provides document outline (symbols) for a file.
+ */
+interface OutlineProvider {
+    /**
+     * Gets the document symbols (outline) for a file.
+     *
+     * @param uri - The URI of the file
+     * @returns Array of document symbols representing the file's outline
+     */
+    provideDocumentSymbols(uri: UnifiedUri): Promise<DocumentSymbol[]>;
+}
+/**
+ * Search options for global find operations.
+ */
+interface GlobalFindOptions {
+    /** Whether the search is case-sensitive */
+    caseSensitive: boolean;
+    /** Whether to match exact words only */
+    exactMatch: boolean;
+    /** Whether the query is a regular expression */
+    regexMode: boolean;
+}
+/**
+ * A match result from a global find operation.
+ */
+interface GlobalFindMatch {
+    /** The URI of the file containing the match */
+    uri: UnifiedUri;
+    /** 1-based line number of the match */
+    line: number;
+    /** 1-based column of the match */
+    column: number;
+    /** The matching text */
+    matchText: string;
+    /** Context around the match (e.g., the full line) */
+    context: string;
+}
+/**
+ * Provides global find functionality across the workspace.
+ */
+interface GlobalFindProvider {
+    /**
+     * Performs a global find operation across the workspace.
+     *
+     * @param query - The search query
+     * @param options - Search options (case sensitivity, exact match, regex mode)
+     * @returns Array of matches found
+     */
+    globalFind(query: string, options: GlobalFindOptions): Promise<GlobalFindMatch[]>;
+}
+/**
+ * Provides graph/link functionality for document relationships.
+ */
+interface GraphProvider {
+    /**
+     * Gets all links in the workspace.
+     *
+     * @returns Array of all links in the workspace
+     */
+    getLinkStructure(): Promise<Link[]>;
+    /**
+     * Resolves outgoing links from a specific document.
+     *
+     * @param path - The path to the document
+     * @returns Array of outgoing links from the document
+     */
+    resolveOutlinks(path: UnifiedUri): Promise<Link[]>;
+    /**
+     * Resolves incoming links (backlinks) to a specific document.
+     *
+     * @param path - The path to the document
+     * @returns Array of links pointing to this document
+     */
+    resolveBacklinks(path: UnifiedUri): Promise<Link[]>;
+    /**
+     * Adds a link to a document by finding a pattern and replacing it with a link.
+     * Throws an error if the operation fails (e.g., pattern not found).
+     *
+     * @param path - The path to the document to modify
+     * @param pattern - The text pattern to find and replace with a link
+     * @param linkTo - The target URI the link should point to
+     * @throws Error if the link cannot be added
+     */
+    addLink(path: UnifiedUri, pattern: string, linkTo: UnifiedUri): Promise<void>;
+}
+/**
+ * Provides frontmatter functionality for document metadata.
+ */
+interface FrontmatterProvider {
+    /**
+     * Gets the frontmatter structure for a specific property across documents.
+     * If path is provided, searches only that document. Otherwise, searches all documents.
+     *
+     * @param property - The frontmatter property name to search for
+     * @param path - Optional path to limit the search to a specific document
+     * @returns Array of matches containing path and value
+     */
+    getFrontmatterStructure(property: string, path?: UnifiedUri): Promise<FrontmatterMatch[]>;
+    /**
+     * Gets all frontmatter for a specific document.
+     *
+     * @param path - The path to the document
+     * @returns The frontmatter object for the document
+     */
+    getFrontmatter(path: UnifiedUri): Promise<Frontmatter>;
+    /**
+     * Sets a frontmatter property on a document.
+     * Throws an error if the operation fails.
+     *
+     * @param path - The path to the document
+     * @param property - The property name to set
+     * @param value - The value to set
+     * @throws Error if the frontmatter cannot be updated
+     */
+    setFrontmatter(path: UnifiedUri, property: string, value: FrontmatterValue): Promise<void>;
+}
+/**
+ * Callback that gets invoked when diagnostics change.
+ * Used for MCP resource subscription support.
+ */
+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 };

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+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';
+
+interface connectPipeOptions {
+    pipeName: string;
+    connectTimeout?: number;
+}
+interface LspPipeConnection {
+    readonly fileAccess?: FileAccessProvider;
+    readonly edit?: EditProvider;
+    readonly definition?: DefinitionProvider;
+    readonly references?: ReferencesProvider;
+    readonly hierarchy?: HierarchyProvider;
+    readonly diagnostics?: DiagnosticsProvider;
+    readonly outline?: OutlineProvider;
+    readonly globalFind?: GlobalFindProvider;
+    readonly graph?: GraphProvider;
+    readonly frontmatter?: FrontmatterProvider;
+    readonly availableMethods: string[];
+    disconnect(): void;
+}
+declare function connectPipe(options: connectPipeOptions): Promise<LspPipeConnection>;
+
+interface servePipeOptions {
+    pipeName: string;
+    fileAccess: FileAccessProvider;
+    edit?: EditProvider;
+    definition?: DefinitionProvider;
+    references?: ReferencesProvider;
+    hierarchy?: HierarchyProvider;
+    diagnostics?: DiagnosticsProvider;
+    outline?: OutlineProvider;
+    globalFind?: GlobalFindProvider;
+    graph?: GraphProvider;
+    frontmatter?: FrontmatterProvider;
+}
+interface LspPipeServer {
+    readonly pipePath: string;
+    readonly connectionCount: number;
+    close(): Promise<void>;
+}
+declare function servePipe(options: servePipeOptions): Promise<LspPipeServer>;
+
+export { DefinitionProvider, DiagnosticsProvider, EditProvider, FileAccessProvider, FrontmatterProvider, GlobalFindProvider, GraphProvider, HierarchyProvider, type LspPipeConnection, type LspPipeServer, OutlineProvider, ReferencesProvider, connectPipe, type connectPipeOptions, servePipe, type servePipeOptions };

package/dist/index.js

@@ -0,0 +1,6 @@
+import {connect,createServer}from'net';import {unlinkSync}from'fs';var v=class{socket;requestHandler;notificationHandler;nextId=1;pending=new Map;buffer="";destroyed=false;constructor(r,e){this.socket=r,this.requestHandler=e?.onRequest,this.notificationHandler=e?.onNotification,r.on("data",i=>this.handleData(i)),r.on("close",()=>this.rejectAll(new Error("Connection closed"))),r.on("error",i=>this.rejectAll(i));}sendRequest(r,e){return this.destroyed?Promise.reject(new Error("Transport destroyed")):new Promise((i,o)=>{let n=this.nextId++;this.pending.set(n,{resolve:i,reject:o});let a={type:"request",id:n,method:r,params:e};this.socket.write(`${JSON.stringify(a)}
+`);})}sendNotification(r,e){if(this.destroyed)return;let i={type:"notification",method:r,params:e};this.socket.write(`${JSON.stringify(i)}
+`);}destroy(){this.destroyed||(this.destroyed=true,this.rejectAll(new Error("Transport destroyed")),this.socket.destroy());}handleData(r){this.buffer+=r.toString();let e=this.buffer.split(`
+`);this.buffer=e.pop()??"";for(let i of e){let o=i.replace(/\r$/,"");if(o)try{let n=JSON.parse(o);this.dispatch(n);}catch{}}}dispatch(r){switch(r.type){case "response":{let e=this.pending.get(r.id);e&&(this.pending.delete(r.id),r.error?e.reject(new Error(r.error.message)):e.resolve(r.result));break}case "request":{this.requestHandler&&this.requestHandler(r.method,r.params).then(e=>{if(this.destroyed)return;let i={type:"response",id:r.id,result:e};this.socket.write(`${JSON.stringify(i)}
+`);}).catch(e=>{if(this.destroyed)return;let i={type:"response",id:r.id,error:{message:e instanceof Error?e.message:String(e)}};this.socket.write(`${JSON.stringify(i)}
+`);});break}case "notification":{this.notificationHandler?.(r.method,r.params);break}}}rejectAll(r){for(let[,e]of this.pending)e.reject(r);this.pending.clear();}};function w(l){return process.platform==="win32"?`\\\\.\\pipe\\${l}`:`/tmp/${l}.sock`}var b=[{providerKey:"fileAccess",methods:["readFile","readDirectory"]},{providerKey:"edit",methods:["applyEdits","previewAndApplyEdits"]},{providerKey:"definition",methods:["provideDefinition"]},{providerKey:"references",methods:["provideReferences"]},{providerKey:"hierarchy",methods:["provideCallHierarchy"]},{providerKey:"diagnostics",methods:["provideDiagnostics","getWorkspaceDiagnostics"]},{providerKey:"outline",methods:["provideDocumentSymbols"]},{providerKey:"globalFind",methods:["globalFind"]},{providerKey:"graph",methods:["getLinkStructure","resolveOutlinks","resolveBacklinks","addLink"]},{providerKey:"frontmatter",methods:["getFrontmatterStructure","getFrontmatter","setFrontmatter"]}];function C(l){let{pipeName:r,connectTimeout:e=5e3}=l,i=w(r);return new Promise((o,n)=>{let a=connect(i),t=false,d=setTimeout(()=>{t||(t=true,a.destroy(),n(new Error(`Connection timeout after ${e}ms`)));},e);a.on("error",s=>{t||(t=true,clearTimeout(d),n(s));}),a.on("connect",()=>{if(clearTimeout(d),t)return;let s,p,c=new v(a,{onNotification:(u,m)=>{u==="onDiagnosticsChanged"&&s&&s(m[0]),u==="onFileChanged"&&p&&p(m[0]);}});c.sendRequest("_handshake",[]).then(u=>{if(t)return;let g=u.methods,f={};for(let{providerKey:P,methods:D}of b){let R=D.filter(h=>g.includes(`${P}.${h}`));if(R.length===0)continue;let y={};for(let h of R)y[h]=(...E)=>c.sendRequest(`${P}.${h}`,E);P==="diagnostics"&&g.includes("onDiagnosticsChanged")&&(y.onDiagnosticsChanged=h=>{s=h;}),P==="fileAccess"&&g.includes("onFileChanged")&&(y.onFileChanged=h=>{p=h;}),f[P]=y;}t=true,o({fileAccess:f.fileAccess,edit:f.edit,definition:f.definition,references:f.references,hierarchy:f.hierarchy,diagnostics:f.diagnostics,outline:f.outline,globalFind:f.globalFind,graph:f.graph,frontmatter:f.frontmatter,availableMethods:g,disconnect(){c.destroy();}});}).catch(u=>{t||(t=true,c.destroy(),n(u instanceof Error?u:new Error(String(u))));});});})}function A(l){let{pipeName:r}=l,e=w(r),i=new Map;for(let{providerKey:t,methods:d}of b){let s=l[t];if(s)for(let p of d){let c=s[p];if(typeof c=="function"){let u=`${t}.${p}`;i.set(u,(...m)=>c.apply(s,m));}}}let o=[...i.keys()];l.diagnostics?.onDiagnosticsChanged&&o.push("onDiagnosticsChanged"),l.fileAccess.onFileChanged&&o.push("onFileChanged");let n=new Set,a=createServer(t=>{let d=new v(t,{onRequest:async(s,p)=>{if(s==="_handshake")return {methods:o};let c=i.get(s);if(!c)throw new Error(`Unknown method: ${s}`);return c(...p)}});n.add(d),t.on("close",()=>n.delete(d));});return l.diagnostics?.onDiagnosticsChanged&&l.diagnostics.onDiagnosticsChanged(t=>{for(let d of n)d.sendNotification("onDiagnosticsChanged",[t]);}),l.fileAccess.onFileChanged&&l.fileAccess.onFileChanged(t=>{for(let d of n)d.sendNotification("onFileChanged",[t]);}),new Promise((t,d)=>{if(process.platform!=="win32")try{unlinkSync(e);}catch{}a.on("error",d),a.listen(e,()=>{a.removeListener("error",d),t({get pipePath(){return e},get connectionCount(){return n.size},async close(){for(let s of n)s.destroy();if(n.clear(),await new Promise((s,p)=>{a.close(c=>{c?p(c):s();});}),process.platform!=="win32")try{unlinkSync(e);}catch{}}});});})}var k=class extends Error{constructor(e,i,o){super(`Could not find symbol '${e}' at or near line ${i}. ${o}`);this.symbolName=e;this.lineHint=i;this.reason=o;this.name="SymbolResolutionError";}},F=class{constructor(r,e){this.fs=r;this.lineSearchRadius=e?.lineSearchRadius??2;}lineSearchRadius;async resolvePosition(r,e){let o=(await this.fs.readFile(r)).split(/\r?\n/),n=e.lineHint-1,a=e.orderHint??0,t=this.findSymbolInLine(o[n],e.symbolName,a);if(t!==null)return {line:n,character:t};for(let d=1;d<=this.lineSearchRadius;d++){let s=n-d;if(s>=0){let c=this.findSymbolInLine(o[s],e.symbolName,a);if(c!==null)return {line:s,character:c}}let p=n+d;if(p<o.length){let c=this.findSymbolInLine(o[p],e.symbolName,a);if(c!==null)return {line:p,character:c}}}throw new k(e.symbolName,e.lineHint,`Please verify the file content and try again. Searched lines ${Math.max(1,e.lineHint-this.lineSearchRadius)} to ${Math.min(o.length,e.lineHint+this.lineSearchRadius)}.`)}findSymbolInLine(r,e,i){if(r===void 0||r.length===0)return null;let o=0,n=0;for(;o<r.length;){let a=r.indexOf(e,o);if(a===-1)break;if(n===i)return a;n++,o=a+1;}return null}};export{k as SymbolResolutionError,F as SymbolResolver,C as connectPipe,A as servePipe};

package/dist/lsp/index.d.ts

@@ -0,0 +1,85 @@
+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 { Location, LocationLink, Diagnostic, DocumentSymbol, SymbolInformation } from 'vscode-languageserver-protocol';
+
+interface LspClientOptions {
+    command: string;
+    args?: string[];
+    workspacePath: string;
+    readFile: (path: string) => Promise<string>;
+    env?: Record<string, string>;
+    initializationOptions?: unknown;
+    documentIdleTimeout?: number;
+    requestTimeout?: number;
+}
+type LspClientState = 'idle' | 'starting' | 'running' | 'dead';
+declare class LspClient {
+    private state;
+    private process;
+    private connection;
+    private openDocuments;
+    private diagnosticsCache;
+    private diagnosticsListeners;
+    readonly definition: DefinitionProvider | undefined;
+    readonly references: ReferencesProvider | undefined;
+    readonly hierarchy: HierarchyProvider | undefined;
+    readonly outline: OutlineProvider | undefined;
+    readonly diagnostics: DiagnosticsProvider | undefined;
+    private readonly options;
+    constructor(options: LspClientOptions);
+    getState(): LspClientState;
+    get onDiagnosticsChanged(): (callback: OnDiagnosticsChangedCallback) => void;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    notifyFileChanged(sdkPath: string): Promise<void>;
+    /** @internal Exposed for testing with mock connections */
+    startWithConnection(connection: ProtocolConnection, process: ChildProcess | null): void;
+    /** @internal Runs initialize handshake and sets up providers */
+    initializeConnection(): Promise<void>;
+    private spawnAndConnect;
+    private sendInitialize;
+    private setupProviders;
+    private assertRunning;
+    private createTimeout;
+    private sendRequest;
+    ensureDocumentOpen(lspUri: string): Promise<void>;
+    private scheduleDocumentClose;
+    private closeDocument;
+    private provideDefinition;
+    private provideTypeDefinition;
+    private provideReferences;
+    private provideCallHierarchy;
+    private provideDocumentSymbols;
+    private provideDiagnostics;
+    private getWorkspaceDiagnostics;
+    private transitionToDead;
+    private cleanup;
+}
+declare function createLspClient(options: LspClientOptions): LspClient;
+
+declare function pathToLspUri(workspacePath: string, sdkPath: string): string;
+declare function lspUriToPath(workspacePath: string, lspUri: string): string;
+declare function convertLspRange(range: {
+    start: {
+        line: number;
+        character: number;
+    };
+    end: {
+        line: number;
+        character: number;
+    };
+}): DiskRange;
+declare function convertLspPosition(pos: {
+    line: number;
+    character: number;
+}): ExactPosition;
+declare function convertDiagnosticSeverity(severity: number | undefined): DiagnosticSeverity;
+declare function convertSymbolKind(kind: number): SymbolKind;
+declare function convertLspDiagnostic(workspacePath: string, uri: string, diag: Diagnostic): Diagnostic$1;
+declare function convertLspDocumentSymbol(symbol: DocumentSymbol): DocumentSymbol$1;
+declare function convertSymbolInformation(_workspacePath: string, info: SymbolInformation): DocumentSymbol$1;
+declare function convertLocationsToSnippets(workspacePath: string, locations: Location | Location[] | LocationLink[] | null | undefined, readFile: (path: string) => Promise<string>): Promise<CodeSnippet[]>;
+declare function guessLanguageId(filePath: string): string;
+
+export { LspClient, type LspClientOptions, convertDiagnosticSeverity, convertLocationsToSnippets, convertLspDiagnostic, convertLspDocumentSymbol, convertLspPosition, convertLspRange, convertSymbolInformation, convertSymbolKind, createLspClient, guessLanguageId, lspUriToPath, pathToLspUri };

package/dist/lsp/index.js

@@ -0,0 +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};