claude-ide-bridge 1.1.0

package/dist/extensionClient.d.ts

@@ -0,0 +1,193 @@
+import { WebSocket } from "ws";
+import type { Logger } from "./logger.js";
+/** Thrown when an extension request times out — distinguishable from "no results" (null). */
+export declare class ExtensionTimeoutError extends Error {
+    readonly method: string;
+    constructor(method: string);
+}
+export interface Diagnostic {
+    file: string;
+    line: number;
+    column: number;
+    severity: "error" | "warning" | "information" | "hint";
+    message: string;
+    source?: string;
+    code?: string | number;
+}
+export interface SelectionState {
+    file: string;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+    selectedText: string;
+}
+export interface TabInfo {
+    filePath: string;
+    isActive: boolean;
+    isDirty: boolean;
+    languageId?: string;
+}
+export interface AIComment {
+    file: string;
+    line: number;
+    comment: string;
+    syntax: string;
+    fullLine: string;
+    severity?: "fix" | "todo" | "question" | "warn" | "task";
+}
+export interface DebugState {
+    hasActiveSession: boolean;
+    sessionId?: string;
+    sessionName?: string;
+    sessionType?: string;
+    isPaused: boolean;
+    pausedAt?: {
+        file: string;
+        line: number;
+        column: number;
+    };
+    callStack?: Array<{
+        id: number;
+        name: string;
+        file: string;
+        line: number;
+        column: number;
+    }>;
+    scopes?: Array<{
+        name: string;
+        variables: Array<{
+            name: string;
+            value: string;
+            type: string;
+        }>;
+    }>;
+    breakpoints: Array<{
+        file: string;
+        line: number;
+        condition?: string;
+        enabled: boolean;
+    }>;
+}
+export interface BreakpointSpec {
+    line: number;
+    condition?: string;
+    logMessage?: string;
+    hitCondition?: string;
+}
+export interface DecorationSpec {
+    startLine: number;
+    endLine?: number;
+    message?: string;
+    hoverMessage?: string;
+    style: "info" | "warning" | "error" | "focus" | "strikethrough" | "dim";
+}
+export interface WorkspaceFolder {
+    name: string;
+    path: string;
+    uri: string;
+    index: number;
+}
+export declare class ExtensionClient {
+    private logger;
+    private ws;
+    private connected;
+    private pendingRequests;
+    private nextId;
+    private extensionSuspendedUntil;
+    private extensionFailures;
+    private extensionHalfOpen;
+    latestDiagnostics: Map<string, Diagnostic[]>;
+    latestSelection: SelectionState | null;
+    latestActiveFile: string | null;
+    lastDiagnosticsUpdate: number;
+    latestAIComments: Map<string, AIComment[]>;
+    latestDebugState: DebugState | null;
+    onDiagnosticsChanged: ((file: string, diagnostics: Diagnostic[]) => void) | null;
+    onAICommentsChanged: ((comments: AIComment[]) => void) | null;
+    onFileChanged: ((id: string, type: string, file: string) => void) | null;
+    onExtensionDisconnected: (() => void) | null;
+    onDebugSessionChanged: ((state: DebugState) => void) | null;
+    private diagnosticsListeners;
+    constructor(logger: Logger);
+    /** Invoke a callback safely — log and swallow errors to prevent bridge crash */
+    private safeCallback;
+    handleExtensionConnection(ws: WebSocket): void;
+    private handleNotification;
+    private static readonly MAX_PENDING_REQUESTS;
+    private request;
+    /** Like request() but returns null on disconnect instead of rejecting.
+     *  ExtensionTimeoutError is NOT caught — callers must handle it to distinguish
+     *  timeout from genuine "no results" (null). */
+    private requestOrNull;
+    private rejectAllPending;
+    /** Typed shorthand for requestOrNull — returns T | null without an intermediate variable */
+    private proxy;
+    getDiagnostics(file?: string): Promise<Diagnostic[] | null>;
+    getSelection(): Promise<SelectionState | null>;
+    getOpenFiles(): Promise<TabInfo[] | null>;
+    isDirty(file: string): Promise<boolean | null>;
+    getFileContent(file: string): Promise<unknown>;
+    openFile(file: string, line?: number): Promise<boolean>;
+    saveFile(file: string): Promise<boolean>;
+    closeTab(file: string): Promise<boolean>;
+    getAIComments(): Promise<AIComment[] | null>;
+    goToDefinition(file: string, line: number, column: number, signal?: AbortSignal): Promise<unknown>;
+    findReferences(file: string, line: number, column: number, signal?: AbortSignal): Promise<unknown>;
+    getHover(file: string, line: number, column: number, signal?: AbortSignal): Promise<unknown>;
+    getCodeActions(file: string, startLine: number, startColumn: number, endLine: number, endColumn: number): Promise<unknown>;
+    applyCodeAction(file: string, startLine: number, startColumn: number, endLine: number, endColumn: number, actionTitle: string): Promise<unknown>;
+    renameSymbol(file: string, line: number, column: number, newName: string): Promise<unknown>;
+    searchSymbols(query: string, maxResults?: number): Promise<unknown>;
+    watchFiles(id: string, pattern: string): Promise<unknown>;
+    unwatchFiles(id: string): Promise<unknown>;
+    listTerminals(): Promise<unknown>;
+    getTerminalOutput(name?: string, index?: number, lines?: number): Promise<unknown>;
+    disposeTerminal(name?: string, index?: number): Promise<unknown>;
+    createFile(filePath: string, content?: string, isDirectory?: boolean, overwrite?: boolean, openAfterCreate?: boolean): Promise<unknown>;
+    deleteFile(filePath: string, recursive?: boolean, useTrash?: boolean): Promise<unknown>;
+    renameFile(oldPath: string, newPath: string, overwrite?: boolean): Promise<unknown>;
+    editText(filePath: string, edits: unknown[], save?: boolean): Promise<unknown>;
+    replaceBlock(filePath: string, oldContent: string, newContent: string, save?: boolean): Promise<unknown>;
+    getDocumentSymbols(file: string): Promise<unknown>;
+    getCallHierarchy(file: string, line: number, column: number, direction?: string, maxResults?: number): Promise<unknown>;
+    formatDocument(file: string): Promise<unknown>;
+    fixAllLintErrors(file: string): Promise<unknown>;
+    organizeImports(file: string): Promise<unknown>;
+    createTerminal(name?: string, cwd?: string, env?: Record<string, string>, show?: boolean): Promise<unknown>;
+    sendTerminalCommand(text: string, name?: string, index?: number, addNewline?: boolean): Promise<unknown>;
+    waitForTerminalOutput(pattern: string, name?: string, index?: number, timeoutMs?: number): Promise<unknown>;
+    executeInTerminal(command: string, name?: string, index?: number, timeoutMs?: number, show?: boolean): Promise<unknown>;
+    getDebugState(): Promise<DebugState | null>;
+    evaluateInDebugger(expression: string, frameId?: number, context?: string): Promise<unknown>;
+    setDebugBreakpoints(file: string, breakpoints: BreakpointSpec[]): Promise<unknown>;
+    startDebugging(configName?: string): Promise<unknown>;
+    stopDebugging(): Promise<unknown>;
+    setDecorations(id: string, file: string, decorations: DecorationSpec[]): Promise<unknown>;
+    clearDecorations(id?: string): Promise<unknown>;
+    executeVSCodeCommand(command: string, args?: unknown[]): Promise<unknown>;
+    listVSCodeCommands(filter?: string): Promise<string[] | null>;
+    getWorkspaceSettings(section?: string, target?: string): Promise<unknown>;
+    setWorkspaceSetting(key: string, value: unknown, target?: string): Promise<unknown>;
+    readClipboard(): Promise<unknown>;
+    writeClipboard(text: string): Promise<unknown>;
+    getInlayHints(file: string, startLine: number, endLine: number): Promise<unknown>;
+    getTypeHierarchy(file: string, line: number, column: number, direction?: string, maxResults?: number): Promise<unknown>;
+    listTasks(): Promise<unknown>;
+    runTask(name: string, type?: string, timeoutMs?: number): Promise<unknown>;
+    getWorkspaceFolders(): Promise<WorkspaceFolder[] | null>;
+    getNotebookCells(file: string): Promise<unknown>;
+    runNotebookCell(file: string, cellIndex: number, timeoutMs?: number): Promise<unknown>;
+    getNotebookOutput(file: string, cellIndex: number): Promise<unknown>;
+    getCachedDiagnostics(file?: string): Diagnostic[];
+    addDiagnosticsListener(listener: (file: string, diagnostics: Diagnostic[]) => void): () => void;
+    /** Notify the extension about Claude Code connection state changes */
+    notifyClaudeConnectionState(connected: boolean): void;
+    getCircuitBreakerState(): {
+        suspended: boolean;
+        suspendedUntil: number;
+        failures: number;
+    };
+    isConnected(): boolean;
+    disconnect(): void;
+}