@4onstudios/iris-agent 0.1.0

package/dist/api/core/library/lsp/coreLsp.d.ts

@@ -0,0 +1,367 @@
+/**
+ * Core LSP manager for language intelligence.
+ * Connects to language servers via JSON-RPC 2.0 and delegates server startup
+ * to the shared server manager.
+ */
+import { type ChildProcessWithoutNullStreams } from "child_process";
+import { EventEmitter } from "events";
+import type { JsonRpcId, LspMessage, LspPosition, LspSemanticLegend, PendingRequestHandlers } from "./protocol.js";
+declare class LSPClient extends EventEmitter {
+    process: ChildProcessWithoutNullStreams;
+    languageId: string;
+    rootPath: string | null;
+    messageId: number;
+    pendingRequests: Map<JsonRpcId, PendingRequestHandlers>;
+    buffer: Buffer;
+    initialized: boolean;
+    semanticLegend: LspSemanticLegend | null;
+    textDocumentSyncKind: 0 | 1 | 2;
+    constructor(serverProcess: ChildProcessWithoutNullStreams, languageId: string, rootPath?: string | null);
+    setupProcessHandlers(): void;
+    private rejectAllPendingRequests;
+    processBuffer(): void;
+    handleMessage(message: LspMessage): void;
+    private writeMessage;
+    private sendResponse;
+    private sendErrorResponse;
+    private handleServerRequest;
+    sendRequest(method: string, params: unknown): Promise<unknown>;
+    sendNotification(method: string, params: unknown): void;
+    initialize(rootUri: string, capabilities?: Record<string, unknown>): Promise<unknown>;
+    openDocument(uri: string, languageId: string, version: number, text: string): Promise<void>;
+    closeDocument(uri: string): Promise<void>;
+    changeDocument(uri: string, version: number, text: string, range?: {
+        start: LspPosition;
+        end: LspPosition;
+    }): Promise<void>;
+    saveDocument(uri: string, text?: string): Promise<void>;
+    willSaveDocument(uri: string, reason?: number): void;
+    didChangeWorkspaceFolders(added: Array<{
+        uri: string;
+        name: string;
+    }>, removed: Array<{
+        uri: string;
+        name: string;
+    }>): Promise<void>;
+    didChangeConfiguration(settings: Record<string, unknown>): Promise<void>;
+    didChangeWatchedFiles(changes: Array<{
+        uri: string;
+        type: 1 | 2 | 3;
+    }>): Promise<void>;
+    willCreateFiles(files: Array<{
+        uri: string;
+    }>): Promise<unknown>;
+    didCreateFiles(files: Array<{
+        uri: string;
+    }>): Promise<void>;
+    willRenameFiles(files: Array<{
+        oldUri: string;
+        newUri: string;
+    }>): Promise<unknown>;
+    didRenameFiles(files: Array<{
+        oldUri: string;
+        newUri: string;
+    }>): Promise<void>;
+    willDeleteFiles(files: Array<{
+        uri: string;
+    }>): Promise<unknown>;
+    didDeleteFiles(files: Array<{
+        uri: string;
+    }>): Promise<void>;
+    getHover(uri: string, position: LspPosition): Promise<unknown>;
+    getDefinition(uri: string, position: LspPosition): Promise<unknown>;
+    getDeclaration(uri: string, position: LspPosition): Promise<unknown>;
+    getTypeDefinition(uri: string, position: LspPosition): Promise<unknown>;
+    getImplementation(uri: string, position: LspPosition): Promise<unknown>;
+    getReferences(uri: string, position: LspPosition, includeDeclaration?: boolean): Promise<unknown>;
+    getDocumentHighlight(uri: string, position: LspPosition): Promise<unknown>;
+    getMoniker(uri: string, position: LspPosition): Promise<unknown>;
+    getCompletion(uri: string, position: LspPosition): Promise<unknown>;
+    resolveCompletionItem(item: Record<string, unknown>): Promise<unknown>;
+    getDocumentSymbols(uri: string): Promise<unknown>;
+    getFoldingRange(uri: string): Promise<unknown>;
+    getSelectionRange(uri: string, positions: LspPosition[]): Promise<unknown>;
+    getDocumentLinks(uri: string): Promise<unknown>;
+    resolveDocumentLink(link: Record<string, unknown>): Promise<unknown>;
+    getCodeLens(uri: string): Promise<unknown>;
+    resolveCodeLens(codeLens: Record<string, unknown>): Promise<unknown>;
+    getLinkedEditingRange(uri: string, position: LspPosition): Promise<unknown>;
+    getDocumentColors(uri: string): Promise<unknown>;
+    getColorPresentations(uri: string, color: unknown, range: {
+        start: LspPosition;
+        end: LspPosition;
+    }): Promise<unknown>;
+    prepareCallHierarchy(uri: string, position: LspPosition): Promise<unknown>;
+    prepareTypeHierarchy(uri: string, position: LspPosition): Promise<unknown>;
+    getIncomingCalls(item: Record<string, unknown>): Promise<unknown>;
+    getOutgoingCalls(item: Record<string, unknown>): Promise<unknown>;
+    getTypeHierarchySupertypes(item: Record<string, unknown>): Promise<unknown>;
+    getTypeHierarchySubtypes(item: Record<string, unknown>): Promise<unknown>;
+    getInlayHints(uri: string, range: {
+        start: LspPosition;
+        end: LspPosition;
+    }): Promise<unknown>;
+    getInlineValues(uri: string, range: {
+        start: LspPosition;
+        end: LspPosition;
+    }, context?: {
+        frameId?: number;
+        stoppedLocation?: {
+            start: LspPosition;
+            end: LspPosition;
+        };
+    }): Promise<unknown>;
+    getInlineCompletion(uri: string, position: LspPosition, context?: Record<string, unknown>): Promise<unknown>;
+    resolveInlineCompletionItem(item: Record<string, unknown>): Promise<unknown>;
+    getSemanticTokens(uri: string): Promise<unknown>;
+    getSemanticTokensRange(uri: string, range: {
+        start: LspPosition;
+        end: LspPosition;
+    }): Promise<unknown>;
+    getSemanticTokensDelta(uri: string, previousResultId: string): Promise<unknown>;
+    getCodeActions(uri: string, range: {
+        start: LspPosition;
+        end: LspPosition;
+    }, context?: {
+        diagnostics?: unknown[];
+        only?: string[];
+        triggerKind?: number;
+    }): Promise<unknown>;
+    resolveCodeAction(action: Record<string, unknown>): Promise<unknown>;
+    rename(uri: string, position: LspPosition, newName: string): Promise<unknown>;
+    prepareRename(uri: string, position: LspPosition): Promise<unknown>;
+    formatting(uri: string, options: {
+        tabSize: number;
+        insertSpaces: boolean;
+        trimTrailingWhitespace?: boolean;
+        insertFinalNewline?: boolean;
+        trimFinalNewlines?: boolean;
+    }): Promise<unknown>;
+    rangeFormatting(uri: string, range: {
+        start: LspPosition;
+        end: LspPosition;
+    }, options: {
+        tabSize: number;
+        insertSpaces: boolean;
+        trimTrailingWhitespace?: boolean;
+        insertFinalNewline?: boolean;
+        trimFinalNewlines?: boolean;
+    }): Promise<unknown>;
+    onTypeFormatting(uri: string, position: LspPosition, ch: string, options: {
+        tabSize: number;
+        insertSpaces: boolean;
+        trimTrailingWhitespace?: boolean;
+        insertFinalNewline?: boolean;
+        trimFinalNewlines?: boolean;
+    }): Promise<unknown>;
+    workspaceSymbol(query: string): Promise<unknown>;
+    resolveWorkspaceSymbol(symbol: Record<string, unknown>): Promise<unknown>;
+    resolveInlayHint(hint: Record<string, unknown>): Promise<unknown>;
+    willSaveWaitUntil(uri: string, reason?: number): Promise<unknown>;
+    executeCommand(command: string, argumentsList?: unknown[]): Promise<unknown>;
+    signatureHelp(uri: string, position: LspPosition): Promise<unknown>;
+    shutdown(): Promise<void>;
+    kill(): void;
+}
+type LspDiagnostic = {
+    range?: {
+        start?: LspPosition;
+        end?: LspPosition;
+    };
+    severity?: number;
+    code?: string | number;
+    source?: string;
+    message?: string;
+};
+type LspWorkspaceDiagnosticReportResult = {
+    items?: Array<{
+        uri?: string;
+        version?: number | null;
+        kind?: string;
+        resultId?: string;
+        items?: LspDiagnostic[];
+    }>;
+};
+declare class CoreLsp extends EventEmitter {
+    private servers;
+    private pendingSpawns;
+    private unavailableLanguages;
+    private spawnGeneration;
+    private rootPath;
+    private documentVersions;
+    private openDocumentLanguages;
+    private lastDocumentText;
+    private diagnosticsByUri;
+    private documentDiagnosticResultIds;
+    private workspaceDiagnosticResultIds;
+    private semanticTokenSnapshots;
+    constructor();
+    connect(rootPath: string | null): void;
+    setRootPath(rootPath: string | null): void;
+    private resetServersForRootChange;
+    getLanguageId(filePath: string): string | null;
+    spawnServer(languageId: string): Promise<LSPClient | null>;
+    isLanguageUnavailable(languageId: string): boolean;
+    private spawnServerUncached;
+    getClientForFile(filePath: string): Promise<LSPClient | null>;
+    getClientForLanguage(languageId: string): Promise<LSPClient | null>;
+    private ensureDocumentSynced;
+    openDocument(filePath: string, text?: string): Promise<boolean>;
+    changeDocument(filePath: string, text: string): Promise<boolean>;
+    saveDocument(filePath: string): Promise<boolean>;
+    closeDocument(filePath: string): Promise<boolean>;
+    didChangeConfiguration(settings: Record<string, unknown>): Promise<void>;
+    willSaveDocument(filePath: string, reason?: number): void;
+    didChangeWorkspaceFolders(added: Array<{
+        uri: string;
+        name: string;
+    }>, removed: Array<{
+        uri: string;
+        name: string;
+    }>): Promise<void>;
+    didChangeWatchedFiles(changes: Array<{
+        filePath: string;
+        type: 1 | 2 | 3;
+    }>): Promise<void>;
+    willCreateFiles(filePaths: string[]): Promise<unknown[]>;
+    didCreateFiles(filePaths: string[]): Promise<void>;
+    willRenameFiles(changes: Array<{
+        oldFilePath: string;
+        newFilePath: string;
+    }>): Promise<unknown[]>;
+    didRenameFiles(changes: Array<{
+        oldFilePath: string;
+        newFilePath: string;
+    }>): Promise<void>;
+    willDeleteFiles(filePaths: string[]): Promise<unknown[]>;
+    didDeleteFiles(filePaths: string[]): Promise<void>;
+    onDiagnostics(listener: (event: {
+        languageId: string;
+        uri: string;
+        diagnostics: LspDiagnostic[];
+    }) => void): () => void;
+    getDiagnosticsForFile(filePath: string): LspDiagnostic[];
+    getPullDiagnosticsForFile(filePath: string): Promise<{
+        kind: string;
+        resultId: string;
+        items: LspDiagnostic[];
+    }>;
+    getWorkspacePullDiagnostics(languageId?: string): Promise<LspWorkspaceDiagnosticReportResult>;
+    toPosition(line: number, character: number): LspPosition;
+    getHover(filePath: string, line: number, character: number): Promise<unknown>;
+    getDefinition(filePath: string, line: number, character: number, text?: string): Promise<unknown>;
+    getDeclaration(filePath: string, line: number, character: number, text?: string): Promise<unknown>;
+    getTypeDefinition(filePath: string, line: number, character: number): Promise<unknown>;
+    getImplementation(filePath: string, line: number, character: number): Promise<unknown>;
+    getReferences(filePath: string, line: number, character: number, includeDeclaration?: boolean): Promise<unknown>;
+    getDocumentHighlight(filePath: string, line: number, character: number): Promise<unknown>;
+    getMoniker(filePath: string, line: number, character: number): Promise<unknown>;
+    getDocumentSymbols(filePath: string): Promise<unknown>;
+    getCodeLens(filePath: string): Promise<unknown>;
+    getFoldingRange(filePath: string): Promise<unknown>;
+    getSelectionRange(filePath: string, line: number, character: number): Promise<unknown>;
+    getDocumentLinks(filePath: string): Promise<unknown>;
+    getLinkedEditingRange(filePath: string, line: number, character: number): Promise<unknown>;
+    getDocumentColors(filePath: string): Promise<unknown>;
+    getColorPresentations(filePath: string, color: unknown, startLine: number, startCharacter: number, endLine: number, endCharacter: number): Promise<unknown>;
+    prepareCallHierarchy(filePath: string, line: number, character: number): Promise<unknown>;
+    prepareTypeHierarchy(filePath: string, line: number, character: number): Promise<unknown>;
+    getIncomingCalls(item: Record<string, unknown>): Promise<unknown>;
+    getOutgoingCalls(item: Record<string, unknown>): Promise<unknown>;
+    getTypeHierarchySupertypes(item: Record<string, unknown>): Promise<unknown>;
+    getTypeHierarchySubtypes(item: Record<string, unknown>): Promise<unknown>;
+    getInlayHints(filePath: string, startLine: number, startCharacter: number, endLine: number, endCharacter: number): Promise<unknown>;
+    getInlineValues(filePath: string, range: {
+        start: LspPosition;
+        end: LspPosition;
+    }, context?: {
+        frameId?: number;
+        stoppedLocation?: {
+            start: LspPosition;
+            end: LspPosition;
+        };
+    }): Promise<unknown>;
+    getInlineCompletion(filePath: string, line: number, character: number, context?: Record<string, unknown>): Promise<unknown>;
+    resolveInlineCompletionItem(item: Record<string, unknown>, languageId?: string, filePath?: string): Promise<unknown>;
+    getCompletion(filePath: string, line: number, character: number): Promise<unknown>;
+    resolveCompletionItem(item: Record<string, unknown>, languageId?: string, filePath?: string): Promise<unknown>;
+    resolveCodeAction(action: Record<string, unknown>, languageId?: string, filePath?: string): Promise<unknown>;
+    resolveCodeLens(codeLens: Record<string, unknown>, languageId?: string, filePath?: string): Promise<unknown>;
+    resolveDocumentLink(link: Record<string, unknown>, languageId?: string, filePath?: string): Promise<unknown>;
+    resolveWorkspaceSymbol(symbol: Record<string, unknown>, languageId?: string): Promise<unknown>;
+    resolveInlayHint(hint: Record<string, unknown>, languageId?: string, filePath?: string): Promise<unknown>;
+    getSemanticTokensForCode(filePath: string, languageId: string, code: string): Promise<{
+        data: number[];
+        legend: LspSemanticLegend;
+        languageId: string;
+    }>;
+    getSemanticTokensRange(filePath: string, startLine: number, startCharacter: number, endLine: number, endCharacter: number): Promise<{
+        data: number[];
+        legend: LspSemanticLegend;
+        languageId: string;
+    }>;
+    getSemanticTokensFull(filePath: string): Promise<{
+        data: number[];
+        resultId: string;
+        legend: LspSemanticLegend;
+        languageId: string;
+    }>;
+    getSemanticTokensDocumentDelta(filePath: string, previousResultId?: string): Promise<{
+        data: number[];
+        resultId: string;
+        edits: {
+            start: number;
+            deleteCount: number;
+            data?: number[];
+        }[];
+        legend: LspSemanticLegend;
+        languageId: string;
+    }>;
+    getSemanticTokensDelta(filePath: string, languageId: string, code: string, previousResultId?: string): Promise<{
+        data: number[];
+        resultId: string;
+        edits: {
+            start: number;
+            deleteCount: number;
+            data?: number[];
+        }[];
+        legend: LspSemanticLegend;
+        languageId: string;
+    }>;
+    getCodeActions(filePath: string, startLine: number, startCharacter: number, endLine: number, endCharacter: number, context?: {
+        diagnostics?: unknown[];
+        only?: string[];
+        triggerKind?: number;
+    }): Promise<unknown>;
+    renameSymbol(filePath: string, line: number, character: number, newName: string): Promise<unknown>;
+    prepareRename(filePath: string, line: number, character: number): Promise<unknown>;
+    formatDocument(filePath: string, options: {
+        tabSize: number;
+        insertSpaces: boolean;
+        trimTrailingWhitespace?: boolean;
+        insertFinalNewline?: boolean;
+        trimFinalNewlines?: boolean;
+    }): Promise<unknown>;
+    formatRange(filePath: string, startLine: number, startCharacter: number, endLine: number, endCharacter: number, options: {
+        tabSize: number;
+        insertSpaces: boolean;
+        trimTrailingWhitespace?: boolean;
+        insertFinalNewline?: boolean;
+        trimFinalNewlines?: boolean;
+    }): Promise<unknown>;
+    formatOnType(filePath: string, line: number, character: number, ch: string, options: {
+        tabSize: number;
+        insertSpaces: boolean;
+        trimTrailingWhitespace?: boolean;
+        insertFinalNewline?: boolean;
+        trimFinalNewlines?: boolean;
+    }): Promise<unknown>;
+    getWorkspaceSymbols(query: string, languageId?: string): Promise<unknown>;
+    getSignatureHelp(filePath: string, line: number, character: number): Promise<unknown>;
+    executeWorkspaceCommand(command: string, args?: unknown[], languageId?: string, filePath?: string): Promise<unknown>;
+    willSaveWaitUntil(filePath: string, reason?: number): Promise<unknown>;
+    private getClientForResolve;
+    shutdown(): Promise<void>;
+}
+export declare const coreLsp: CoreLsp;
+export default CoreLsp;