browser-debug-mcp-bridge 1.5.0 → 1.6.0

package/apps/mcp-server/dist/mcp/server.js

@@ -38,9 +38,9 @@ const TOOL_SCHEMAS = {
     },
     get_recent_events: {
         type: 'object',
-        required: ['sessionId'],
         properties: {
             sessionId: { type: 'string' },
+            url: { type: 'string' },
             eventTypes: { type: 'array', items: { type: 'string' } },
             limit: { type: 'number' },
             offset: { type: 'number' },
@@ -48,18 +48,18 @@ const TOOL_SCHEMAS = {
     },
     get_navigation_history: {
         type: 'object',
-        required: ['sessionId'],
         properties: {
             sessionId: { type: 'string' },
+            url: { type: 'string' },
             limit: { type: 'number' },
             offset: { type: 'number' },
         },
     },
     get_console_events: {
         type: 'object',
-        required: ['sessionId'],
         properties: {
             sessionId: { type: 'string' },
+            url: { type: 'string' },
             level: { type: 'string' },
             limit: { type: 'number' },
             offset: { type: 'number' },
@@ -78,6 +78,7 @@ const TOOL_SCHEMAS = {
         type: 'object',
         properties: {
             sessionId: { type: 'string' },
+            url: { type: 'string' },
             errorType: { type: 'string' },
             groupBy: { type: 'string' },
             limit: { type: 'number' },
@@ -143,6 +144,20 @@ const TOOL_SCHEMAS = {
             maxAncestors: { type: 'number' },
         },
     },
+    get_live_console_logs: {
+        type: 'object',
+        required: ['sessionId'],
+        properties: {
+            sessionId: { type: 'string' },
+            url: { type: 'string' },
+            tabId: { type: 'number' },
+            levels: { type: 'array', items: { type: 'string' } },
+            contains: { type: 'string' },
+            sinceTs: { type: 'number' },
+            includeRuntimeErrors: { type: 'boolean' },
+            limit: { type: 'number' },
+        },
+    },
     explain_last_failure: {
         type: 'object',
         required: ['sessionId'],
@@ -208,6 +223,7 @@ const TOOL_DESCRIPTIONS = {
     get_computed_styles: 'Read computed CSS styles for an element',
     get_layout_metrics: 'Read viewport and element layout metrics',
     capture_ui_snapshot: 'Capture redacted UI snapshot (DOM/styles/optional PNG) and persist it',
+    get_live_console_logs: 'Read in-memory live console logs for a connected session',
     explain_last_failure: 'Explain the latest failure timeline',
     get_event_correlation: 'Correlate related events by window',
     list_snapshots: 'List snapshot metadata by session/time/trigger',
@@ -303,6 +319,65 @@ function parseRequestedTypes(value) {
         .map((entry) => mapRequestedEventType(entry));
     return Array.from(new Set(normalized));
 }
+function normalizeRequestedOrigin(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'string') {
+        throw new Error('url must be a string');
+    }
+    try {
+        const parsed = new URL(value);
+        if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+            throw new Error('url must use http:// or https://');
+        }
+        return parsed.origin;
+    }
+    catch {
+        throw new Error('url must be a valid absolute http(s) URL');
+    }
+}
+function ensureSessionOrOriginFilter(sessionId, origin) {
+    if (!sessionId && !origin) {
+        throw new Error('sessionId or url is required');
+    }
+}
+function resolveUrlPrefixFromOrigin(origin) {
+    return origin.endsWith('/') ? origin : origin + '/';
+}
+function appendEventOriginFilter(where, params, origin) {
+    if (!origin) {
+        return;
+    }
+    const prefix = resolveUrlPrefixFromOrigin(origin);
+    where.push(`
+    (
+      origin = ?
+      OR (
+        origin IS NULL AND (
+          json_extract(payload_json, '$.origin') = ?
+          OR json_extract(payload_json, '$.url') = ?
+          OR json_extract(payload_json, '$.url') LIKE ?
+          OR json_extract(payload_json, '$.to') = ?
+          OR json_extract(payload_json, '$.to') LIKE ?
+          OR json_extract(payload_json, '$.href') = ?
+          OR json_extract(payload_json, '$.href') LIKE ?
+          OR json_extract(payload_json, '$.location') = ?
+          OR json_extract(payload_json, '$.location') LIKE ?
+        )
+      )
+    )
+  `);
+    params.push(origin, origin, origin, `${prefix}%`, origin, `${prefix}%`, origin, `${prefix}%`, origin, `${prefix}%`);
+}
+function appendNetworkOriginFilter(where, params, origin) {
+    if (!origin) {
+        return;
+    }
+    const prefix = resolveUrlPrefixFromOrigin(origin);
+    where.push('(origin = ? OR (origin IS NULL AND (url = ? OR url LIKE ?)))');
+    params.push(origin, origin, `${prefix}%`);
+}
 function resolveLastUrl(payload) {
     const candidates = [payload.url, payload.to, payload.href, payload.location];
     for (const candidate of candidates) {
@@ -313,12 +388,17 @@ function resolveLastUrl(payload) {
     return undefined;
 }
 function mapEventRecord(row) {
+    const payload = readJsonPayload(row.payload_json);
     return {
         eventId: row.event_id,
         sessionId: row.session_id,
         timestamp: row.ts,
         type: row.type,
-        payload: readJsonPayload(row.payload_json),
+        tabId: row.tab_id ?? (typeof payload.tabId === 'number' ? payload.tabId : undefined),
+        origin: row.origin
+            ?? (typeof payload.origin === 'string' ? payload.origin : undefined)
+            ?? undefined,
+        payload,
     };
 }
 function classifyNetworkFailure(status, errorClass) {
@@ -528,6 +608,26 @@ function asStringArray(value, maxItems) {
         .filter((entry) => typeof entry === 'string' && entry.length > 0)
         .slice(0, maxItems);
 }
+const LIVE_CONSOLE_LEVELS = new Set(['log', 'info', 'warn', 'error', 'debug', 'trace']);
+function resolveLiveConsoleLevels(value) {
+    const levels = asStringArray(value, 16)
+        .map((entry) => entry.trim().toLowerCase())
+        .filter((entry) => LIVE_CONSOLE_LEVELS.has(entry));
+    return Array.from(new Set(levels));
+}
+function resolveOptionalTabId(value) {
+    if (value === undefined || value === null || value === '') {
+        return undefined;
+    }
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error('tabId must be an integer');
+    }
+    const tabId = Math.floor(value);
+    if (!Number.isInteger(tabId) || tabId < 0) {
+        throw new Error('tabId must be an integer');
+    }
+    return tabId;
+}
 function isLiveSessionDisconnectedMessage(message) {
     const normalized = message.toLowerCase();
     return normalized.includes('no active extension connection')
@@ -713,14 +813,18 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
         get_recent_events: async (input) => {
             const db = getDb();
             const sessionId = getSessionId(input);
-            if (!sessionId) {
-                throw new Error('sessionId is required');
-            }
+            const origin = normalizeRequestedOrigin(input.url);
+            ensureSessionOrOriginFilter(sessionId, origin);
             const limit = resolveLimit(input.limit, DEFAULT_EVENT_LIMIT);
             const offset = resolveOffset(input.offset);
             const requestedTypes = parseRequestedTypes(input.types ?? input.eventTypes);
-            const params = [sessionId];
-            const where = ['session_id = ?'];
+            const params = [];
+            const where = [];
+            if (sessionId) {
+                where.push('session_id = ?');
+                params.push(sessionId);
+            }
+            appendEventOriginFilter(where, params, origin);
             if (requestedTypes.length > 0) {
                 const placeholders = requestedTypes.map(() => '?').join(', ');
                 where.push(`type IN (${placeholders})`);
@@ -728,7 +832,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
             }
             const rows = db
                 .prepare(`
-        SELECT event_id, session_id, ts, type, payload_json
+        SELECT event_id, session_id, ts, type, payload_json, tab_id, origin
         FROM events
         WHERE ${where.join(' AND ')}
         ORDER BY ts DESC
@@ -752,20 +856,26 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
         get_navigation_history: async (input) => {
             const db = getDb();
             const sessionId = getSessionId(input);
-            if (!sessionId) {
-                throw new Error('sessionId is required');
-            }
+            const origin = normalizeRequestedOrigin(input.url);
+            ensureSessionOrOriginFilter(sessionId, origin);
             const limit = resolveLimit(input.limit, DEFAULT_EVENT_LIMIT);
             const offset = resolveOffset(input.offset);
+            const params = [];
+            const where = ["type = 'nav'"];
+            if (sessionId) {
+                where.push('session_id = ?');
+                params.push(sessionId);
+            }
+            appendEventOriginFilter(where, params, origin);
             const rows = db
                 .prepare(`
-        SELECT event_id, session_id, ts, type, payload_json
+        SELECT event_id, session_id, ts, type, payload_json, tab_id, origin
         FROM events
-        WHERE session_id = ? AND type = 'nav'
+        WHERE ${where.join(' AND ')}
         ORDER BY ts DESC
         LIMIT ? OFFSET ?
       `)
-                .all(sessionId, limit + 1, offset);
+                .all(...params, limit + 1, offset);
             const truncated = rows.length > limit;
             return {
                 ...createBaseResponse(sessionId),
@@ -783,23 +893,27 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
         get_console_events: async (input) => {
             const db = getDb();
             const sessionId = getSessionId(input);
-            if (!sessionId) {
-                throw new Error('sessionId is required');
-            }
+            const origin = normalizeRequestedOrigin(input.url);
+            ensureSessionOrOriginFilter(sessionId, origin);
             const level = typeof input.level === 'string' ? input.level : undefined;
             const limit = resolveLimit(input.limit, DEFAULT_EVENT_LIMIT);
             const offset = resolveOffset(input.offset);
-            const params = [sessionId];
-            let levelClause = '';
+            const params = [];
+            const where = ["type = 'console'"];
+            if (sessionId) {
+                where.push('session_id = ?');
+                params.push(sessionId);
+            }
+            appendEventOriginFilter(where, params, origin);
             if (level) {
-                levelClause = "AND json_extract(payload_json, '$.level') = ?";
+                where.push("json_extract(payload_json, '$.level') = ?");
                 params.push(level);
             }
             const rows = db
                 .prepare(`
-        SELECT event_id, session_id, ts, type, payload_json
+        SELECT event_id, session_id, ts, type, payload_json, tab_id, origin
         FROM events
-        WHERE session_id = ? AND type = 'console' ${levelClause}
+        WHERE ${where.join(' AND ')}
         ORDER BY ts DESC
         LIMIT ? OFFSET ?
       `)
@@ -871,6 +985,8 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
         get_network_failures: async (input) => {
             const db = getDb();
             const sessionId = typeof input.sessionId === 'string' ? input.sessionId : undefined;
+            const origin = normalizeRequestedOrigin(input.url);
+            ensureSessionOrOriginFilter(sessionId, origin);
             const groupBy = typeof input.groupBy === 'string' ? input.groupBy : undefined;
             const errorType = typeof input.errorType === 'string' ? input.errorType : undefined;
             const limit = resolveLimit(input.limit, DEFAULT_LIST_LIMIT);
@@ -882,6 +998,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
                 where.push('session_id = ?');
                 params.push(sessionId);
             }
+            appendNetworkOriginFilter(where, params, origin);
             where.push(errorFilter);
             if (errorFilter === 'error_class = ?' && errorType) {
                 params.push(errorType);
@@ -929,7 +1046,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
             }
             const rows = db
                 .prepare(`
-          SELECT request_id, session_id, ts_start, duration_ms, method, url, status, initiator, error_class
+          SELECT request_id, session_id, ts_start, duration_ms, method, url, origin, status, initiator, error_class
           FROM network
           ${whereClause}
           ORDER BY ts_start DESC
@@ -954,6 +1071,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
                     durationMs: row.duration_ms ?? undefined,
                     method: row.method,
                     url: row.url,
+                    origin: row.origin ?? undefined,
                     status: row.status ?? undefined,
                     initiator: row.initiator ?? undefined,
                     errorType: classifyNetworkFailure(row.status, row.error_class),
@@ -974,7 +1092,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
             const offset = resolveOffset(input.offset);
             const rows = db
                 .prepare(`
-          SELECT event_id, session_id, ts, type, payload_json
+          SELECT event_id, session_id, ts, type, payload_json, tab_id, origin
           FROM events
           WHERE session_id = ?
             AND type IN ('ui', 'element_ref')
@@ -1008,7 +1126,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
             const windowMs = lookbackSeconds * 1000;
             const latestErrorEvent = db
                 .prepare(`
-          SELECT event_id, session_id, ts, type, payload_json
+          SELECT event_id, session_id, ts, type, payload_json, tab_id, origin
           FROM events
           WHERE session_id = ?
             AND (type = 'error' OR (type = 'console' AND json_extract(payload_json, '$.level') = 'error'))
@@ -1018,7 +1136,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
                 .get(sessionId);
             const latestNetworkFailure = db
                 .prepare(`
-          SELECT request_id, session_id, ts_start, duration_ms, method, url, status, initiator, error_class
+          SELECT request_id, session_id, ts_start, duration_ms, method, url, origin, status, initiator, error_class
           FROM network
           WHERE session_id = ?
             AND (error_class IS NOT NULL OR COALESCE(status, 0) >= 400)
@@ -1046,7 +1164,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
             const windowEnd = anchorTs + 1_000;
             const eventRows = db
                 .prepare(`
-          SELECT event_id, session_id, ts, type, payload_json
+          SELECT event_id, session_id, ts, type, payload_json, tab_id, origin
           FROM events
           WHERE session_id = ?
             AND ts BETWEEN ? AND ?
@@ -1055,7 +1173,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
                 .all(sessionId, windowStart, windowEnd);
             const networkRows = db
                 .prepare(`
-          SELECT request_id, session_id, ts_start, duration_ms, method, url, status, initiator, error_class
+          SELECT request_id, session_id, ts_start, duration_ms, method, url, origin, status, initiator, error_class
           FROM network
           WHERE session_id = ?
             AND ts_start BETWEEN ? AND ?
@@ -1138,7 +1256,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
             }
             const anchorEvent = db
                 .prepare(`
-          SELECT event_id, session_id, ts, type, payload_json
+          SELECT event_id, session_id, ts, type, payload_json, tab_id, origin
           FROM events
           WHERE session_id = ? AND event_id = ?
           LIMIT 1
@@ -1153,7 +1271,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
             const windowEnd = anchorEvent.ts + windowMs;
             const nearbyEvents = db
                 .prepare(`
-          SELECT event_id, session_id, ts, type, payload_json
+          SELECT event_id, session_id, ts, type, payload_json, tab_id, origin
           FROM events
           WHERE session_id = ?
             AND event_id != ?
@@ -1162,7 +1280,7 @@ export function createV1ToolHandlers(getDb, getSessionConnectionState) {
                 .all(sessionId, eventId, windowStart, windowEnd);
             const nearbyNetworkFailures = db
                 .prepare(`
-          SELECT request_id, session_id, ts_start, duration_ms, method, url, status, initiator, error_class
+          SELECT request_id, session_id, ts_start, duration_ms, method, url, origin, status, initiator, error_class
           FROM network
           WHERE session_id = ?
             AND ts_start BETWEEN ? AND ?
@@ -1551,6 +1669,38 @@ export function createV2ToolHandlers(captureClient) {
                 ...ensureCaptureSuccess(capture, sessionId),
             };
         },
+        get_live_console_logs: async (input) => {
+            const sessionId = getSessionId(input);
+            if (!sessionId) {
+                throw new Error('sessionId is required');
+            }
+            const origin = normalizeRequestedOrigin(input.url);
+            const tabId = resolveOptionalTabId(input.tabId);
+            const levels = resolveLiveConsoleLevels(input.levels);
+            const contains = typeof input.contains === 'string' && input.contains.trim().length > 0
+                ? input.contains.trim()
+                : undefined;
+            const sinceTs = resolveOptionalTimestamp(input.sinceTs);
+            const includeRuntimeErrors = input.includeRuntimeErrors !== false;
+            const limit = resolveLimit(input.limit, DEFAULT_EVENT_LIMIT);
+            const capture = await executeLiveCapture(captureClient, sessionId, 'CAPTURE_GET_LIVE_CONSOLE_LOGS', {
+                origin,
+                tabId,
+                levels,
+                contains,
+                sinceTs,
+                includeRuntimeErrors,
+                limit,
+            }, 3_000);
+            return {
+                ...createBaseResponse(sessionId),
+                limitsApplied: {
+                    maxResults: limit,
+                    truncated: capture.truncated ?? false,
+                },
+                ...ensureCaptureSuccess(capture, sessionId),
+            };
+        },
     };
 }
 function isRecord(value) {