claude-ide-bridge 2.42.2 → 2.45.0

package/dist/extensionClient.js

@@ -24,6 +24,8 @@ export class ExtensionClient {
     extensionSuspendedUntil = 0;
     extensionFailureTimes = []; // timestamps of recent timeouts
     extensionHalfOpen = false;
+    _circuitOpenCount = 0;
+    _lastCircuitOpenedAt = null;
     // State pushed by extension via notifications
     latestDiagnostics = new Map();
     /** Parallel timestamp map — tracks when each file's diagnostics were last updated. */
@@ -566,7 +568,9 @@ export class ExtensionClient {
             const result = await inner;
             // Success — reset circuit breaker and half-open state
             if (this.extensionFailureTimes.length > 0) {
-                this.logger.warn("Extension backoff reset — connection recovered");
+                this.logger.info("Extension backoff reset — connection recovered", {
+                    openCount: this._circuitOpenCount,
+                });
             }
             this.extensionFailureTimes = [];
             this.extensionSuspendedUntil = 0;
@@ -590,7 +594,9 @@ export class ExtensionClient {
                     const capMs = Math.min(1_000 * 2 ** (failures - 1), 60_000);
                     const backoffMs = Math.floor(Math.random() * capMs) + 1;
                     this.extensionSuspendedUntil = now + backoffMs;
-                    this.logger.warn(`Extension circuit open (${failures} failures) — suspending for ${Math.round(backoffMs / 100) / 10}s`);
+                    this._circuitOpenCount++;
+                    this._lastCircuitOpenedAt = new Date();
+                    this.logger.warn(`Extension circuit open (${failures} failures) — suspending for ${Math.round(backoffMs / 100) / 10}s`, { openCount: this._circuitOpenCount });
                     // Fast-fail all other in-flight requests immediately when the circuit
                     // opens. Without this, each queued request waits its own REQUEST_TIMEOUT
                     // (10s) independently, so a tool handler chaining N extension calls
@@ -685,9 +691,14 @@ export class ExtensionClient {
     async isDirty(file) {
         return this.tryRequest("extension/isDirty", { file });
     }
+    // handler returns { content, isDirty, languageId, lineCount, version, source } | { success:false, error } — validatedRequest
     async getFileContent(file) {
-        return this.requestOrNull("extension/getFileContent", { file });
+        return this.validatedRequest("extension/getFileContent", { file }, (r) => {
+            const o = r;
+            return typeof o.content === "string" ? r : null;
+        });
     }
+    // handler returns true (boolean) on success — bare requestOrNull, caller checks === true
     async openFile(file, line) {
         const result = await this.requestOrNull("extension/openFile", {
             file,
@@ -733,60 +744,113 @@ export class ExtensionClient {
         return this.tryRequest("extension/getAIComments");
     }
     // --- LSP Semantic Features ---
+    // handler returns array of { file, line, column, endLine, endColumn } | null — tryRequest
     async goToDefinition(file, line, column, signal) {
-        return this.requestOrNull("extension/goToDefinition", { file, line, column }, undefined, signal);
+        return this.tryRequest("extension/goToDefinition", { file, line, column }, undefined, signal);
     }
+    // handler returns { references: [...], count } — validated
     async findReferences(file, line, column, signal) {
-        return this.requestOrNull("extension/findReferences", { file, line, column }, undefined, signal);
+        return this.validatedRequest("extension/findReferences", { file, line, column }, (r) => {
+            const o = r;
+            return Array.isArray(o.references) ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { found: true, implementations, count } | null — validatedRequest
     async findImplementations(file, line, column, signal) {
-        return this.requestOrNull("extension/findImplementations", { file, line, column }, undefined, signal);
+        return this.validatedRequest("extension/findImplementations", { file, line, column }, (r) => {
+            const o = r;
+            return typeof o.found === "boolean" ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { found: true, locations } | null — validatedRequest
     async goToTypeDefinition(file, line, column, signal) {
-        return this.requestOrNull("extension/goToTypeDefinition", { file, line, column }, undefined, signal);
+        return this.validatedRequest("extension/goToTypeDefinition", { file, line, column }, (r) => {
+            const o = r;
+            return typeof o.found === "boolean" ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { found: true, locations } | null — validatedRequest
     async goToDeclaration(file, line, column, signal) {
-        return this.requestOrNull("extension/goToDeclaration", { file, line, column }, undefined, signal);
+        return this.validatedRequest("extension/goToDeclaration", { file, line, column }, (r) => {
+            const o = r;
+            return typeof o.found === "boolean" ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { contents: string[], range? } | null — validated
     async getHover(file, line, column, signal) {
-        return this.requestOrNull("extension/getHover", { file, line, column }, undefined, signal);
+        return this.validatedRequest("extension/getHover", { file, line, column }, (r) => {
+            const o = r;
+            return Array.isArray(o.contents) ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { actions: [{title, kind?, isPreferred}] } — validated
     async getCodeActions(file, startLine, startColumn, endLine, endColumn, signal) {
-        return this.requestOrNull("extension/getCodeActions", { file, startLine, startColumn, endLine, endColumn }, undefined, signal);
+        return this.validatedRequest("extension/getCodeActions", { file, startLine, startColumn, endLine, endColumn }, (r) => {
+            const o = r;
+            return Array.isArray(o.actions) ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { applied: boolean, title?, command?, error?, available? } — validatedRequest
     async applyCodeAction(file, startLine, startColumn, endLine, endColumn, actionTitle, signal) {
-        return this.requestOrNull("extension/applyCodeAction", { file, startLine, startColumn, endLine, endColumn, actionTitle }, undefined, signal);
+        return this.validatedRequest("extension/applyCodeAction", { file, startLine, startColumn, endLine, endColumn, actionTitle }, (r) => {
+            const o = r;
+            return typeof o.applied === "boolean" ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { title, changes, ... } | { error } — tryRequest (error-obj on failure)
     async previewCodeAction(file, startLine, startColumn, endLine, endColumn, actionTitle, signal) {
-        return this.requestOrNull("extension/previewCodeAction", { file, startLine, startColumn, endLine, endColumn, actionTitle }, 15_000, signal);
+        return this.tryRequest("extension/previewCodeAction", { file, startLine, startColumn, endLine, endColumn, actionTitle }, 15_000, signal);
     }
+    // handler returns { success, newName?, affectedFiles?, totalEdits?, error? } — rich contract, caller needs success field
     async renameSymbol(file, line, column, newName, signal) {
         // Rename can be slow on large projects
-        return this.requestOrNull("extension/renameSymbol", { file, line, column, newName }, 15_000, signal);
+        return this.validatedRequest("extension/renameSymbol", { file, line, column, newName }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
+        }, 15_000, signal);
     }
     async searchSymbols(query, maxResults, signal) {
         return this.requestOrNull("extension/searchSymbols", { query, maxResults }, undefined, signal);
     }
+    // handler returns { canRename: boolean, range?, placeholder?, reason? } — validatedRequest
     async prepareRename(file, line, column, signal) {
-        return this.requestOrNull("extension/prepareRename", { file, line, column }, undefined, signal);
+        return this.validatedRequest("extension/prepareRename", { file, line, column }, (r) => {
+            const o = r;
+            return typeof o.canRename === "boolean" ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { formatted: boolean, editCount? } or { formatted: false, reason? } — validated
     async formatRange(file, startLine, endLine, signal) {
-        return this.requestOrNull("extension/formatRange", { file, startLine, endLine }, undefined, signal);
+        return this.validatedRequest("extension/formatRange", { file, startLine, endLine }, (r) => {
+            const o = r;
+            return typeof o.formatted === "boolean" ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { activeSignature, activeParameter, signatures } | null — tryRequest
     async signatureHelp(file, line, column, signal) {
-        return this.requestOrNull("extension/signatureHelp", { file, line, column }, undefined, signal);
+        return this.tryRequest("extension/signatureHelp", { file, line, column }, undefined, signal);
     }
+    // handler returns { ranges: [...] } — validatedRequest
     async foldingRanges(file, signal) {
-        return this.requestOrNull("extension/foldingRanges", { file }, undefined, signal);
+        return this.validatedRequest("extension/foldingRanges", { file }, (r) => {
+            const o = r;
+            return Array.isArray(o.ranges) ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { ranges: [...] } — validatedRequest
     async selectionRanges(file, line, column, signal) {
-        return this.requestOrNull("extension/selectionRanges", { file, line, column }, undefined, signal);
+        return this.validatedRequest("extension/selectionRanges", { file, line, column }, (r) => {
+            const o = r;
+            return Array.isArray(o.ranges) ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { watching: true, id, pattern } — tryRequest
     async watchFiles(id, pattern) {
-        return this.requestOrNull("extension/watchFiles", { id, pattern });
+        return this.tryRequest("extension/watchFiles", { id, pattern });
     }
+    // handler returns { unwatched: true, id } — tryRequest
     async unwatchFiles(id) {
-        return this.requestOrNull("extension/unwatchFiles", { id });
+        return this.tryRequest("extension/unwatchFiles", { id });
     }
     async captureScreenshot() {
         return this.validatedRequest("extension/captureScreenshot", {}, (r) => {
@@ -797,60 +861,77 @@ export class ExtensionClient {
         });
     }
     // --- Terminal Features ---
+    // handler returns { terminals, count, outputCaptureAvailable } — validatedRequest
     async listTerminals() {
-        return this.requestOrNull("extension/listTerminals");
+        return this.validatedRequest("extension/listTerminals", undefined, (r) => {
+            const o = r;
+            return Array.isArray(o.terminals) ? r : null;
+        });
     }
+    // handler returns { available: boolean, ... } — validatedRequest
     async getTerminalOutput(name, index, lines) {
-        return this.requestOrNull("extension/getTerminalOutput", {
-            name,
-            index,
-            lines,
+        return this.validatedRequest("extension/getTerminalOutput", { name, index, lines }, (r) => {
+            const o = r;
+            return typeof o.available === "boolean" ? r : null;
         });
     }
+    // handler returns { success: boolean, terminalName? } — validatedRequest
     async disposeTerminal(name, index) {
-        return this.requestOrNull("extension/disposeTerminal", { name, index });
+        return this.validatedRequest("extension/disposeTerminal", { name, index }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
+        });
     }
     // --- File Operations ---
+    // handler returns { success: boolean, filePath, isDirectory, created } | { success: false, error } — validatedRequest
     async createFile(filePath, content, isDirectory, overwrite, openAfterCreate) {
-        return this.requestOrNull("extension/createFile", {
-            filePath,
-            content,
-            isDirectory,
-            overwrite,
-            openAfterCreate,
+        return this.validatedRequest("extension/createFile", { filePath, content, isDirectory, overwrite, openAfterCreate }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
         });
     }
+    // handler returns { success: boolean, filePath, deleted } | { success: false, error } — validatedRequest
     async deleteFile(filePath, recursive, useTrash) {
-        return this.requestOrNull("extension/deleteFile", {
-            filePath,
-            recursive,
-            useTrash,
+        return this.validatedRequest("extension/deleteFile", { filePath, recursive, useTrash }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
         });
     }
+    // handler returns { success: boolean, oldPath, newPath, renamed } | { success: false, error } — validatedRequest
     async renameFile(oldPath, newPath, overwrite) {
-        return this.requestOrNull("extension/renameFile", {
-            oldPath,
-            newPath,
-            overwrite,
+        return this.validatedRequest("extension/renameFile", { oldPath, newPath, overwrite }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
         });
     }
     // --- Text Editing ---
+    // handler returns { success: boolean, editCount, saved } | { success: false, error } — validatedRequest
     async editText(filePath, edits, save) {
-        return this.requestOrNull("extension/editText", { filePath, edits, save });
+        return this.validatedRequest("extension/editText", { filePath, edits, save }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
+        });
     }
+    // handler returns { success: boolean, saved, source } | { success: false, error } — validatedRequest
     async replaceBlock(filePath, oldContent, newContent, save) {
-        return this.requestOrNull("extension/replaceBlock", {
-            filePath,
-            oldContent,
-            newContent,
-            save,
+        return this.validatedRequest("extension/replaceBlock", { filePath, oldContent, newContent, save }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
         });
     }
+    // handler returns { symbols: FlatSymbol[], count } — validated
     async getDocumentSymbols(file, signal) {
-        return this.requestOrNull("extension/getDocumentSymbols", { file }, undefined, signal);
+        return this.validatedRequest("extension/getDocumentSymbols", { file }, (r) => {
+            const o = r;
+            return Array.isArray(o.symbols) ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { symbol, incoming?, outgoing? } | null — validated
     async getCallHierarchy(file, line, column, direction, maxResults, signal) {
-        return this.requestOrNull("extension/getCallHierarchy", { file, line, column, direction, maxResults }, 15_000, signal);
+        return this.validatedRequest("extension/getCallHierarchy", { file, line, column, direction, maxResults }, (r) => {
+            const o = r;
+            return typeof o.symbol === "object" && o.symbol !== null ? r : null;
+        }, 15_000, signal);
     }
     // --- Code Actions (format, fix, organize) ---
     async formatDocument(file) {
@@ -864,34 +945,41 @@ export class ExtensionClient {
         // unwraps to null so consumers fall through to their CLI fallback.
         return this.tryRequest("extension/fixAllLintErrors", { file }, 15_000);
     }
+    // handler returns { success: true, actionsApplied } | { error } — tryRequest (error-obj on failure)
     async organizeImports(file) {
-        return this.requestOrNull("extension/organizeImports", { file }, 15_000);
+        return this.tryRequest("extension/organizeImports", { file }, 15_000);
     }
     // --- Terminal Control ---
+    // handler returns { success: true, name, index } — validatedRequest
     async createTerminal(name, cwd, env, show) {
-        return this.requestOrNull("extension/createTerminal", {
-            name,
-            cwd,
-            env,
-            show,
+        return this.validatedRequest("extension/createTerminal", { name, cwd, env, show }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
         });
     }
+    // handler returns { success: boolean, terminalName? } | { success: false, error, availableTerminals } — validatedRequest
     async sendTerminalCommand(text, name, index, addNewline) {
-        return this.requestOrNull("extension/sendTerminalCommand", {
-            text,
-            name,
-            index,
-            addNewline,
+        return this.validatedRequest("extension/sendTerminalCommand", { text, name, index, addNewline }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
         });
     }
+    // handler returns { matched: boolean, matchedLine?, elapsed?, terminalName, timedOut?, error? } — validatedRequest
     async waitForTerminalOutput(pattern, name, index, timeoutMs) {
         const requestTimeout = (timeoutMs ?? 30_000) + 5_000;
-        return this.requestOrNull("extension/waitForTerminalOutput", { pattern, name, index, timeoutMs }, requestTimeout);
+        return this.validatedRequest("extension/waitForTerminalOutput", { pattern, name, index, timeoutMs }, (r) => {
+            const o = r;
+            return typeof o.matched === "boolean" ? r : null;
+        }, requestTimeout);
     }
+    // handler returns { success: boolean, exitCode?, output, terminalName, timedOut?, error? } — validatedRequest
     async executeInTerminal(command, name, index, timeoutMs, show) {
         // Add 5s overhead beyond the command timeout so the bridge doesn't cut the extension off early
         const requestTimeout = (timeoutMs ?? 30_000) + 5_000;
-        return this.requestOrNull("extension/executeInTerminal", { command, name, index, timeoutMs, show }, requestTimeout);
+        return this.validatedRequest("extension/executeInTerminal", { command, name, index, timeoutMs, show }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
+        }, requestTimeout);
     }
     // --- Debug ---
     async getDebugState() {
@@ -899,34 +987,55 @@ export class ExtensionClient {
             ? r
             : null);
     }
+    // handler returns { result, type?, variablesReference? } — validatedRequest
     async evaluateInDebugger(expression, frameId, context, signal) {
-        return this.requestOrNull("extension/evaluateInDebugger", { expression, frameId, context }, 15_000, signal);
+        return this.validatedRequest("extension/evaluateInDebugger", { expression, frameId, context }, (r) => {
+            const o = r;
+            return "result" in o ? r : null;
+        }, 15_000, signal);
     }
+    // handler returns { set: number, file } — validatedRequest
     async setDebugBreakpoints(file, breakpoints, signal) {
-        return this.requestOrNull("extension/setDebugBreakpoints", { file, breakpoints }, undefined, signal);
+        return this.validatedRequest("extension/setDebugBreakpoints", { file, breakpoints }, (r) => {
+            const o = r;
+            return typeof o.set === "number" ? r : null;
+        }, undefined, signal);
     }
+    // handler returns { started: boolean } — validatedRequest
     async startDebugging(configName, signal) {
-        return this.requestOrNull("extension/startDebugging", { configName }, 15_000, signal);
+        return this.validatedRequest("extension/startDebugging", { configName }, (r) => {
+            const o = r;
+            return typeof o.started === "boolean" ? r : null;
+        }, 15_000, signal);
     }
+    // handler returns { stopped: boolean, message? } | { stopped: false, error } — validatedRequest
     async stopDebugging(signal) {
-        return this.requestOrNull("extension/stopDebugging", undefined, undefined, signal);
+        return this.validatedRequest("extension/stopDebugging", undefined, (r) => {
+            const o = r;
+            return typeof o.stopped === "boolean" ? r : null;
+        }, undefined, signal);
     }
     // --- Decorations ---
+    // handler returns { applied: number, editorsUpdated: number } — validatedRequest
     async setDecorations(id, file, decorations) {
-        return this.requestOrNull("extension/setDecorations", {
-            id,
-            file,
-            decorations,
+        return this.validatedRequest("extension/setDecorations", { id, file, decorations }, (r) => {
+            const o = r;
+            return typeof o.applied === "number" ? r : null;
         });
     }
+    // handler returns { cleared: number } — validatedRequest
     async clearDecorations(id) {
-        return this.requestOrNull("extension/clearDecorations", { id });
+        return this.validatedRequest("extension/clearDecorations", { id }, (r) => {
+            const o = r;
+            return typeof o.cleared === "number" ? r : null;
+        });
     }
     // --- VS Code Commands ---
+    // handler returns { result, _warning? } — validatedRequest
     async executeVSCodeCommand(command, args) {
-        return this.requestOrNull("extension/executeVSCodeCommand", {
-            command,
-            args,
+        return this.validatedRequest("extension/executeVSCodeCommand", { command, args }, (r) => {
+            const o = r;
+            return "result" in o ? r : null;
         });
     }
     async listVSCodeCommands(filter) {
@@ -938,57 +1047,86 @@ export class ExtensionClient {
         });
     }
     // --- Workspace Settings ---
+    // handler returns { section, settings } — validatedRequest
     async getWorkspaceSettings(section, target) {
-        return this.requestOrNull("extension/getWorkspaceSettings", {
-            section,
-            target,
+        return this.validatedRequest("extension/getWorkspaceSettings", { section, target }, (r) => {
+            const o = r;
+            return typeof o.settings === "object" && o.settings !== null ? r : null;
         });
     }
+    // handler returns { set: true, key, target } — validatedRequest
     async setWorkspaceSetting(key, value, target) {
-        return this.requestOrNull("extension/setWorkspaceSetting", {
-            key,
-            value,
-            target,
+        return this.validatedRequest("extension/setWorkspaceSetting", { key, value, target }, (r) => {
+            const o = r;
+            return typeof o.set === "boolean" ? r : null;
         });
     }
     // --- Clipboard ---
+    // handler returns { text, byteLength, truncated } — validatedRequest
     async readClipboard() {
-        return this.requestOrNull("extension/readClipboard");
+        return this.validatedRequest("extension/readClipboard", undefined, (r) => {
+            const o = r;
+            return typeof o.text === "string" ? r : null;
+        });
     }
+    // handler returns { written: boolean, byteLength? } | { written: false, error } — validatedRequest
     async writeClipboard(text) {
-        return this.requestOrNull("extension/writeClipboard", { text });
+        return this.validatedRequest("extension/writeClipboard", { text }, (r) => {
+            const o = r;
+            return typeof o.written === "boolean" ? r : null;
+        });
     }
     // --- Inlay Hints ---
+    // handler returns { hints: [...], count, capped? } — validated
     async getInlayHints(file, startLine, endLine) {
-        return this.requestOrNull("extension/getInlayHints", {
-            file,
-            startLine,
-            endLine,
+        return this.validatedRequest("extension/getInlayHints", { file, startLine, endLine }, (r) => {
+            const o = r;
+            return Array.isArray(o.hints) ? r : null;
         });
     }
     // --- Type Hierarchy ---
+    // handler returns { found: boolean, root?, supertypes, subtypes, direction } — validated
     async getTypeHierarchy(file, line, column, direction, maxResults, signal) {
-        return this.requestOrNull("extension/getTypeHierarchy", { file, line, column, direction, maxResults }, 15_000, signal);
+        return this.validatedRequest("extension/getTypeHierarchy", { file, line, column, direction, maxResults }, (r) => {
+            const o = r;
+            return typeof o.found === "boolean" ? r : null;
+        }, 15_000, signal);
     }
     // --- Code Lens ---
+    // handler returns { lenses: [...], count } — validated
     async getCodeLens(file, signal) {
-        return this.requestOrNull("extension/getCodeLens", { file }, undefined, signal);
+        return this.validatedRequest("extension/getCodeLens", { file }, (r) => {
+            const o = r;
+            return Array.isArray(o.lenses) ? r : null;
+        }, undefined, signal);
     }
     // --- Semantic Tokens ---
+    // handler returns { tokens: [...], count, capped, legend: { tokenTypes, tokenModifiers } } — validated
     async getSemanticTokens(file, startLine, endLine, maxTokens, signal) {
-        return this.requestOrNull("extension/getSemanticTokens", { file, startLine, endLine, maxTokens }, 15_000, signal);
+        return this.validatedRequest("extension/getSemanticTokens", { file, startLine, endLine, maxTokens }, (r) => {
+            const o = r;
+            return Array.isArray(o.tokens) ? r : null;
+        }, 15_000, signal);
     }
     // --- Document Links ---
     async getDocumentLinks(file, signal) {
         return this.requestOrNull("extension/getDocumentLinks", { file }, undefined, signal);
     }
     // --- Tasks ---
+    // handler returns { tasks: [...] } — validatedRequest
     async listTasks(type) {
-        return this.requestOrNull("extension/listTasks", type ? { type } : undefined, 15_000);
+        return this.validatedRequest("extension/listTasks", type ? { type } : undefined, (r) => {
+            const o = r;
+            return Array.isArray(o.tasks) ? r : null;
+        }, 15_000);
     }
+    // handler returns { success: boolean, name, exitCode? } | { success: false, error, timedOut? } — validatedRequest
     async runTask(name, type, timeoutMs) {
         const requestTimeout = (timeoutMs ?? 60_000) + 5_000;
-        return this.requestOrNull("extension/runTask", { name, type, timeoutMs }, requestTimeout);
+        return this.validatedRequest("extension/runTask", { name, type, timeoutMs }, (r) => {
+            const o = r;
+            return typeof o.success === "boolean" ? r : null;
+        }, requestTimeout);
     }
     // --- Workspace Folders ---
     async getWorkspaceFolders() {
@@ -1003,13 +1141,16 @@ export class ExtensionClient {
         });
     }
     // --- Notebook ---
+    // handler not yet implemented in extension — bare requestOrNull returns null until implemented
     async getNotebookCells(file) {
         return this.requestOrNull("extension/getNotebookCells", { file });
     }
+    // handler not yet implemented in extension — bare requestOrNull returns null until implemented
     async runNotebookCell(file, cellIndex, timeoutMs) {
         const requestTimeout = (timeoutMs ?? 30_000) + 5_000;
         return this.requestOrNull("extension/runNotebookCell", { file, cellIndex, timeoutMs }, requestTimeout);
     }
+    // handler not yet implemented in extension — bare requestOrNull returns null until implemented
     async getNotebookOutput(file, cellIndex) {
         return this.requestOrNull("extension/getNotebookOutput", {
             file,
@@ -1081,6 +1222,8 @@ export class ExtensionClient {
             suspended: now < this.extensionSuspendedUntil,
             suspendedUntil: this.extensionSuspendedUntil,
             failures: activeFailures.length,
+            openCount: this._circuitOpenCount,
+            lastOpenedAt: this._lastCircuitOpenedAt?.toISOString() ?? null,
         };
     }
     isConnected() {