@vibebrowser/mcp 0.2.6 → 0.2.7

package/dist/devtools-fallback.js

@@ -0,0 +1,172 @@
+import { EventEmitter } from 'node:events';
+import { dirname, resolve } from 'node:path';
+import { createRequire } from 'node:module';
+import { readFileSync } from 'node:fs';
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+const TOOLS_REFRESH_TIMEOUT_MS = 6_000;
+const TOOL_CALL_TIMEOUT_MS = 30_000;
+const DEVTOOLS_UNAVAILABLE_PREFIX = 'chrome-devtools backend unavailable';
+const DEVTOOLS_NOT_INSTALLED_MESSAGE = `${DEVTOOLS_UNAVAILABLE_PREFIX}: chrome-devtools-mcp is not installed`;
+function normalizeToolName(value) {
+    return value.replace(/[-\s]/g, '_').toLowerCase();
+}
+function toToolDefinition(input) {
+    return {
+        name: input.name,
+        description: input.description ?? '',
+        inputSchema: {
+            type: 'object',
+            properties: input.inputSchema.properties,
+            required: input.inputSchema.required,
+        },
+    };
+}
+export class DevtoolsFallbackConnection extends EventEmitter {
+    debug;
+    client = null;
+    transport = null;
+    tools = [];
+    available = false;
+    unavailableReason;
+    constructor(debug) {
+        super();
+        this.debug = debug;
+    }
+    async start() {
+        const binaryPath = this.resolveBinaryPath();
+        if (!binaryPath) {
+            this.unavailableReason = DEVTOOLS_NOT_INSTALLED_MESSAGE;
+            this.log(this.unavailableReason);
+            return;
+        }
+        const transport = new StdioClientTransport({
+            command: process.execPath,
+            args: [binaryPath, '--autoConnect'],
+            stderr: this.debug ? 'inherit' : 'pipe',
+        });
+        const client = new Client({
+            name: 'vibebrowser-mcp-devtools-fallback',
+            version: '1.0.0',
+        }, { capabilities: {} });
+        try {
+            await client.connect(transport, { timeout: TOOLS_REFRESH_TIMEOUT_MS });
+            this.client = client;
+            this.transport = transport;
+            this.available = true;
+            this.unavailableReason = undefined;
+            await this.refreshTools(TOOLS_REFRESH_TIMEOUT_MS);
+            this.emit('connected');
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.unavailableReason = `${DEVTOOLS_UNAVAILABLE_PREFIX}: ${message}`;
+            this.log(this.unavailableReason);
+            this.available = false;
+            this.client = null;
+            this.transport = null;
+            this.tools = [];
+            this.emit('unavailable', this.unavailableReason);
+            try {
+                await transport.close();
+            }
+            catch {
+                // ignore cleanup errors
+            }
+        }
+    }
+    async stop() {
+        this.available = false;
+        this.tools = [];
+        if (this.client) {
+            try {
+                await this.client.close();
+            }
+            catch {
+                // ignore shutdown errors
+            }
+            this.client = null;
+        }
+        if (this.transport) {
+            try {
+                await this.transport.close();
+            }
+            catch {
+                // ignore shutdown errors
+            }
+            this.transport = null;
+        }
+    }
+    async refreshTools(timeoutMs = TOOLS_REFRESH_TIMEOUT_MS) {
+        if (!this.client || !this.available) {
+            return this.tools;
+        }
+        try {
+            const listed = await this.client.listTools(undefined, { timeout: timeoutMs });
+            const nextTools = listed.tools.map(toToolDefinition);
+            const previousNames = this.tools.map((tool) => normalizeToolName(tool.name)).join(',');
+            const nextNames = nextTools.map((tool) => normalizeToolName(tool.name)).join(',');
+            this.tools = nextTools;
+            if (previousNames !== nextNames) {
+                this.emit('tools_updated', this.tools);
+            }
+            return this.tools;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.log(`Unable to refresh chrome-devtools tools: ${message}`);
+            return this.tools;
+        }
+    }
+    getTools() {
+        return this.tools;
+    }
+    hasTool(name) {
+        const needle = normalizeToolName(name);
+        return this.tools.some((tool) => normalizeToolName(tool.name) === needle);
+    }
+    async callTool(name, args, timeoutMs = TOOL_CALL_TIMEOUT_MS) {
+        if (!this.client || !this.available) {
+            throw new Error(this.unavailableReason || DEVTOOLS_UNAVAILABLE_PREFIX);
+        }
+        const result = await this.client.callTool({ name, arguments: args }, undefined, { timeout: timeoutMs });
+        const content = Array.isArray(result.content)
+            ? result.content
+            : [{ type: 'text', text: JSON.stringify(result) }];
+        const isError = typeof result.isError === 'boolean' ? result.isError : false;
+        return {
+            success: !isError,
+            isError,
+            content,
+        };
+    }
+    isAvailable() {
+        return this.available;
+    }
+    getUnavailableReason() {
+        return this.unavailableReason;
+    }
+    resolveBinaryPath() {
+        try {
+            const require = createRequire(import.meta.url);
+            const packageJsonPath = require.resolve('chrome-devtools-mcp/package.json');
+            const metadata = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+            const bin = typeof metadata.bin === 'string'
+                ? metadata.bin
+                : metadata.bin?.['chrome-devtools-mcp'] ?? metadata.bin?.['chrome-devtools'];
+            if (!bin) {
+                return undefined;
+            }
+            return resolve(dirname(packageJsonPath), bin);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    log(message) {
+        if (this.debug) {
+            console.error(`[vibebrowser-mcp] ${message}`);
+        }
+    }
+}
+//# sourceMappingURL=devtools-fallback.js.map

package/dist/devtools-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devtools-fallback.js","sourceRoot":"","sources":["../src/devtools-fallback.ts"],"names":[],"mappings":"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"}

package/dist/relay.d.ts

@@ -13,6 +13,11 @@ export declare const EXTENSION_PORT: number;
 export declare const AGENT_PORT: number;
 /**
  * Vibe MCP Relay Server
+ *
+ * Owns exactly one shared chrome-devtools fallback backend process per relay
+ * daemon instance. All connected MCP clients (vibebrowser-mcp and
+ * vibebrowser-cli) route through this relay, so fallback lifecycle and tool
+ * routing stay deterministic across concurrent agents.
  */
 export declare class RelayServer extends EventEmitter {
     private extensionWss;
@@ -24,6 +29,7 @@ export declare class RelayServer extends EventEmitter {
     private requestIdCounter;
     private anonymousSessionCounter;
     private debug;
+    private readonly devtoolsFallback;
     constructor(debug?: boolean);
     /**
      * Start the relay server
@@ -87,6 +93,12 @@ export declare class RelayServer extends EventEmitter {
     private buildSessionsList;
     private getDefaultSession;
     private resolveTargetSession;
+    private parseToolDefinitions;
+    private getToolsForSession;
+    private findExtensionTool;
+    private findFallbackTool;
+    private broadcastDefaultToolsToAgents;
+    private hasConnectedExtensionSession;
     private sendSessionStateToAgent;
     private broadcastSessionState;
     private rejectPendingRequestsForSession;

package/dist/relay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAgBtC,eAAO,MAAM,cAAc,QAAiD,CAAC;AAC7E,eAAO,MAAM,UAAU,QAA6C,CAAC;AAkErE;;GAEG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,iBAAiB,CAAqC;IAC9D,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,KAAK,CAAU;gBAEX,KAAK,GAAE,OAAe;IAKlC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB5B;;OAEG;YACW,oBAAoB;IAoBlC;;OAEG;YACW,gBAAgB;IAoB9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA0CjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA6C7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAwD9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2D1B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;YACW,QAAQ;IAgDtB;;OAEG;IACH,OAAO,CAAC,GAAG;IAiBX,OAAO,CAAC,sBAAsB;IA2C9B,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,+BAA+B;CAiBxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAmBxC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAY3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,OAAe,GAAG,IAAI,CAgB7D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5E"}
+{"version":3,"file":"relay.d.ts","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAsBtC,eAAO,MAAM,cAAc,QAAiD,CAAC;AAC7E,eAAO,MAAM,UAAU,QAA6C,CAAC;AAkErE;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,iBAAiB,CAAqC;IAC9D,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,eAAe,CAA0C;IACjE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,uBAAuB,CAAK;IACpC,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;gBAElD,KAAK,GAAE,OAAe;IAMlC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmC5B;;OAEG;YACW,oBAAoB;IAoBlC;;OAEG;YACW,gBAAgB;IAoB9B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IA2CjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiD7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiE9B;;OAEG;YACW,kBAAkB;IA+KhC;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAUjC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAmB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;YACW,QAAQ;IAiDtB;;OAEG;IACH,OAAO,CAAC,GAAG;IAiBX,OAAO,CAAC,sBAAsB;IA2C9B,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,oBAAoB;IAW5B,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,gBAAgB;IAKxB,OAAO,CAAC,6BAA6B;IAUrC,OAAO,CAAC,4BAA4B;IAIpC,OAAO,CAAC,uBAAuB;IAkB/B,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,+BAA+B;CAiBxC;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAmBxC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,GAAG,IAAI,CAY3C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,OAAe,GAAG,IAAI,CAgB7D;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5E"}

package/dist/relay.js

@@ -13,6 +13,7 @@ import { writeFileSync, readFileSync, existsSync, unlinkSync, mkdirSync } from '
 import { join } from 'path';
 import { homedir } from 'os';
 import { EventEmitter } from 'events';
+import { DevtoolsFallbackConnection } from './devtools-fallback.js';
 function parseEnvPort(name, fallback) {
     const raw = process.env[name];
     if (!raw) {
@@ -24,6 +25,9 @@ function parseEnvPort(name, fallback) {
     }
     return port;
 }
+function normalizeToolName(value) {
+    return value.replace(/[-\s]/g, '_').toLowerCase();
+}
 // Ports (19888/19889 to avoid conflict with Playwriter MCP which uses 19988/19989)
 export const EXTENSION_PORT = parseEnvPort('VIBE_MCP_EXTENSION_PORT', 19889);
 export const AGENT_PORT = parseEnvPort('VIBE_MCP_AGENT_PORT', 19888);
@@ -33,6 +37,11 @@ const PID_FILE = join(VIBE_DIR, 'relay.pid');
 const LOG_FILE = join(VIBE_DIR, 'relay.log');
 /**
  * Vibe MCP Relay Server
+ *
+ * Owns exactly one shared chrome-devtools fallback backend process per relay
+ * daemon instance. All connected MCP clients (vibebrowser-mcp and
+ * vibebrowser-cli) route through this relay, so fallback lifecycle and tool
+ * routing stay deterministic across concurrent agents.
  */
 export class RelayServer extends EventEmitter {
     extensionWss = null;
@@ -44,9 +53,11 @@ export class RelayServer extends EventEmitter {
     requestIdCounter = 0;
     anonymousSessionCounter = 0;
     debug;
+    devtoolsFallback;
     constructor(debug = false) {
         super();
         this.debug = debug;
+        this.devtoolsFallback = new DevtoolsFallbackConnection(debug);
     }
     /**
      * Start the relay server
@@ -60,6 +71,19 @@ export class RelayServer extends EventEmitter {
         await this.startExtensionServer();
         // Start agent WebSocket server
         await this.startAgentServer();
+        await this.devtoolsFallback.start();
+        this.devtoolsFallback.on('tools_updated', () => {
+            this.broadcastDefaultToolsToAgents();
+            this.broadcastSessionState();
+        });
+        this.devtoolsFallback.on('connected', () => {
+            this.broadcastDefaultToolsToAgents();
+            this.broadcastSessionState();
+        });
+        this.devtoolsFallback.on('unavailable', () => {
+            this.broadcastDefaultToolsToAgents();
+            this.broadcastSessionState();
+        });
         // Write PID file
         writeFileSync(PID_FILE, String(process.pid));
         this.log(`Relay started (PID: ${process.pid})`);
@@ -138,6 +162,7 @@ export class RelayServer extends EventEmitter {
             this.broadcastSessionState();
             if (this.extensionSessions.size === 0) {
                 this.broadcastToAgents({ type: 'extension_disconnected' });
+                this.broadcastDefaultToolsToAgents();
             }
         });
         ws.on('error', (error) => {
@@ -158,13 +183,17 @@ export class RelayServer extends EventEmitter {
         this.log(`Agent connected: ${agentId} (total: ${this.agents.size})`);
         this.sendSessionStateToAgent(ws);
         const defaultSession = this.getDefaultSession();
-        if (defaultSession && defaultSession.tools.length > 0) {
-            ws.send(JSON.stringify({ type: 'tools_list', data: defaultSession.tools, sessionId: defaultSession.sessionId }));
+        const tools = this.getToolsForSession(defaultSession);
+        if (tools.length > 0) {
+            ws.send(JSON.stringify({ type: 'tools_list', data: tools, sessionId: defaultSession?.sessionId }));
         }
         ws.on('message', (data) => {
             try {
                 const message = JSON.parse(data.toString());
-                this.handleAgentMessage(agentId, message);
+                this.handleAgentMessage(agentId, message).catch((error) => {
+                    const reason = error instanceof Error ? error.message : String(error);
+                    this.log(`Unhandled agent message failure (${agentId}): ${reason}`);
+                });
             }
             catch (error) {
                 this.log(`Failed to parse agent message: ${error}`);
@@ -207,18 +236,28 @@ export class RelayServer extends EventEmitter {
                 // Forward response to the requesting agent
                 const agent = this.agents.get(pending.agentId);
                 if (agent) {
-                    agent.ws.send(JSON.stringify({
-                        ...message,
-                        sessionId: session.sessionId,
-                        requestId: pending.originalRequestId,
-                    }));
+                    if (message.type === 'tools_list') {
+                        agent.ws.send(JSON.stringify({
+                            type: 'tools_list',
+                            requestId: pending.originalRequestId,
+                            data: this.getToolsForSession(this.extensionSessions.get(pending.sessionId) || null),
+                            sessionId: pending.sessionId,
+                        }));
+                    }
+                    else {
+                        agent.ws.send(JSON.stringify({
+                            ...message,
+                            sessionId: session.sessionId,
+                            requestId: pending.originalRequestId,
+                        }));
+                    }
                 }
                 // For tools_list we still want to cache + broadcast to *other* agents
                 // so they stay in sync, but the requesting agent already got its copy.
                 if (message.type === 'tools_list') {
-                    session.tools = message.data;
+                    session.tools = this.parseToolDefinitions(message.data);
                     this.stopToolsSyncLoop(session);
-                    this.broadcastToAgents({ type: 'tools_list', data: session.tools, sessionId: session.sessionId }, pending.agentId);
+                    this.broadcastDefaultToolsToAgents(pending.agentId);
                     this.broadcastSessionState();
                 }
                 return;
@@ -226,9 +265,9 @@ export class RelayServer extends EventEmitter {
         }
         // Handle unsolicited tools list (e.g. extension announces on connect)
         if (message.type === 'tools_list') {
-            session.tools = message.data;
+            session.tools = this.parseToolDefinitions(message.data);
             this.stopToolsSyncLoop(session);
-            this.broadcastToAgents({ type: 'tools_list', data: session.tools, sessionId: session.sessionId });
+            this.broadcastDefaultToolsToAgents();
             this.broadcastSessionState();
             return;
         }
@@ -238,25 +277,118 @@ export class RelayServer extends EventEmitter {
     /**
      * Handle message from an agent
      */
-    handleAgentMessage(agentId, message) {
-        this.log(`Agent ${agentId} message: ${message.type}`);
-        if (message.type === 'list_sessions') {
+    async handleAgentMessage(agentId, message) {
+        try {
+            this.log(`Agent ${agentId} message: ${message.type}`);
+            if (message.type === 'list_sessions') {
+                const agent = this.agents.get(agentId);
+                if (agent && message.requestId) {
+                    agent.ws.send(JSON.stringify({
+                        type: 'sessions_list',
+                        requestId: message.requestId,
+                        sessions: this.buildSessionsList(),
+                    }));
+                }
+                return;
+            }
+            const requestedSessionId = typeof message.data?.sessionId === 'string' ? message.data.sessionId : undefined;
+            const targetSession = this.resolveTargetSession(requestedSessionId);
             const agent = this.agents.get(agentId);
-            if (agent && message.requestId) {
+            if (!agent || !message.requestId) {
+                return;
+            }
+            if (message.type === 'list_tools') {
+                if (requestedSessionId && !targetSession) {
+                    agent.ws.send(JSON.stringify({
+                        type: 'error',
+                        requestId: message.requestId,
+                        error: `No browser session connected for sessionId=${requestedSessionId}`,
+                    }));
+                    return;
+                }
                 agent.ws.send(JSON.stringify({
-                    type: 'sessions_list',
+                    type: 'tools_list',
                     requestId: message.requestId,
-                    sessions: this.buildSessionsList(),
+                    data: this.getToolsForSession(targetSession),
+                    sessionId: targetSession?.sessionId,
                 }));
+                return;
             }
-            return;
-        }
-        const requestedSessionId = typeof message.data?.sessionId === 'string' ? message.data.sessionId : undefined;
-        const targetSession = this.resolveTargetSession(requestedSessionId);
-        if (!targetSession) {
-            // No extension connected, send error back
-            const agent = this.agents.get(agentId);
-            if (agent && message.requestId) {
+            if (message.type === 'call_tool') {
+                const requestedToolName = message.data?.name;
+                if (typeof requestedToolName !== 'string' || requestedToolName.trim().length === 0) {
+                    agent.ws.send(JSON.stringify({
+                        type: 'error',
+                        requestId: message.requestId,
+                        error: 'Tool name is required',
+                    }));
+                    return;
+                }
+                if (requestedSessionId && !targetSession) {
+                    agent.ws.send(JSON.stringify({
+                        type: 'error',
+                        requestId: message.requestId,
+                        error: `No browser session connected for sessionId=${requestedSessionId}`,
+                    }));
+                    return;
+                }
+                const extensionTool = this.findExtensionTool(targetSession, requestedToolName);
+                if (extensionTool && targetSession) {
+                    const relayRequestId = `relay_${++this.requestIdCounter}`;
+                    const cleanData = message.data ? { ...message.data } : undefined;
+                    if (cleanData && 'sessionId' in cleanData) {
+                        delete cleanData.sessionId;
+                    }
+                    const forwardMessage = {
+                        ...message,
+                        requestId: relayRequestId,
+                        ...(cleanData ? { data: cleanData } : {}),
+                    };
+                    this.pendingRequests.set(relayRequestId, {
+                        agentId,
+                        originalRequestId: message.requestId,
+                        lastSentAt: Date.now(),
+                        forwardMessage,
+                        sessionId: targetSession.sessionId,
+                    });
+                    targetSession.ws.send(JSON.stringify(forwardMessage));
+                    return;
+                }
+                if (!this.hasConnectedExtensionSession() && this.findFallbackTool(requestedToolName)) {
+                    try {
+                        const args = message.data?.arguments && typeof message.data.arguments === 'object'
+                            ? message.data.arguments
+                            : {};
+                        const result = await this.devtoolsFallback.callTool(requestedToolName, args);
+                        agent.ws.send(JSON.stringify({
+                            type: 'tool_result',
+                            requestId: message.requestId,
+                            data: result,
+                            sessionId: targetSession?.sessionId,
+                        }));
+                    }
+                    catch (error) {
+                        const reason = error instanceof Error ? error.message : String(error);
+                        agent.ws.send(JSON.stringify({
+                            type: 'error',
+                            requestId: message.requestId,
+                            error: reason,
+                            sessionId: targetSession?.sessionId,
+                        }));
+                    }
+                    return;
+                }
+                agent.ws.send(JSON.stringify({
+                    type: 'error',
+                    requestId: message.requestId,
+                    error: targetSession
+                        ? `Tool not found: ${requestedToolName}`
+                        : 'No extension connected',
+                }));
+                return;
+            }
+            if (!targetSession) {
+                // No extension connected, send error back
                 agent.ws.send(JSON.stringify({
                     type: 'error',
                     requestId: message.requestId,
@@ -264,31 +396,43 @@ export class RelayServer extends EventEmitter {
                         ? `No browser session connected for sessionId=${requestedSessionId}`
                         : 'No extension connected',
                 }));
+                return;
             }
-            return;
+            // Generate relay request ID
+            const relayRequestId = `relay_${++this.requestIdCounter}`;
+            const cleanData = message.data ? { ...message.data } : undefined;
+            if (cleanData && 'sessionId' in cleanData) {
+                delete cleanData.sessionId;
+            }
+            const forwardMessage = {
+                ...message,
+                requestId: relayRequestId,
+                ...(cleanData ? { data: cleanData } : {}),
+            };
+            // Store pending request mapping so it can be replayed if the extension
+            // swaps sockets mid-flight.
+            this.pendingRequests.set(relayRequestId, {
+                agentId,
+                originalRequestId: message.requestId,
+                lastSentAt: Date.now(),
+                forwardMessage,
+                sessionId: targetSession.sessionId,
+            });
+            // Forward to extension with relay request ID
+            targetSession.ws.send(JSON.stringify(forwardMessage));
         }
-        // Generate relay request ID
-        const relayRequestId = `relay_${++this.requestIdCounter}`;
-        const cleanData = message.data ? { ...message.data } : undefined;
-        if (cleanData && 'sessionId' in cleanData) {
-            delete cleanData.sessionId;
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            this.log(`Failed to handle agent message (${agentId}, ${message.type}): ${reason}`);
+            const agent = this.agents.get(agentId);
+            if (agent && message.requestId && agent.ws.readyState === WebSocket.OPEN) {
+                agent.ws.send(JSON.stringify({
+                    type: 'error',
+                    requestId: message.requestId,
+                    error: `Relay error: ${reason}`,
+                }));
+            }
         }
-        const forwardMessage = {
-            ...message,
-            requestId: relayRequestId,
-            ...(cleanData ? { data: cleanData } : {}),
-        };
-        // Store pending request mapping so it can be replayed if the extension
-        // swaps sockets mid-flight.
-        this.pendingRequests.set(relayRequestId, {
-            agentId,
-            originalRequestId: message.requestId,
-            lastSentAt: Date.now(),
-            forwardMessage,
-            sessionId: targetSession.sessionId,
-        });
-        // Forward to extension with relay request ID
-        targetSession.ws.send(JSON.stringify(forwardMessage));
     }
     /**
      * Request tools list from extension
@@ -400,6 +544,7 @@ export class RelayServer extends EventEmitter {
         }
         this.extensionSessions.clear();
         this.socketToSessionId.clear();
+        await this.devtoolsFallback.stop();
         // Close servers
         if (this.agentWss) {
             this.agentWss.close();
@@ -507,6 +652,46 @@ export class RelayServer extends EventEmitter {
         }
         return this.getDefaultSession();
     }
+    parseToolDefinitions(data) {
+        if (!Array.isArray(data)) {
+            return [];
+        }
+        return data
+            .filter((entry) => Boolean(entry) && typeof entry === 'object' && typeof entry.name === 'string')
+            .map((entry) => entry);
+    }
+    getToolsForSession(session) {
+        if (session) {
+            return [...session.tools];
+        }
+        if (this.hasConnectedExtensionSession()) {
+            return [];
+        }
+        return [...this.devtoolsFallback.getTools()];
+    }
+    findExtensionTool(session, toolName) {
+        if (!session) {
+            return undefined;
+        }
+        const key = normalizeToolName(toolName);
+        return session.tools.find((tool) => normalizeToolName(tool.name) === key);
+    }
+    findFallbackTool(toolName) {
+        const key = normalizeToolName(toolName);
+        return this.devtoolsFallback.getTools().find((tool) => normalizeToolName(tool.name) === key);
+    }
+    broadcastDefaultToolsToAgents(excludeAgentId) {
+        const defaultSession = this.getDefaultSession();
+        const tools = this.getToolsForSession(defaultSession);
+        this.broadcastToAgents({
+            type: 'tools_list',
+            data: tools,
+            sessionId: defaultSession?.sessionId,
+        }, excludeAgentId);
+    }
+    hasConnectedExtensionSession() {
+        return this.getDefaultSession() !== null;
+    }
     sendSessionStateToAgent(ws) {
         const sessions = this.buildSessionsList();
         const defaultSession = this.getDefaultSession();