@mcp-b/chrome-devtools-mcp 2.3.1 → 3.0.0-beta.20260529000441

package/build/src/telemetry/persistence.js

@@ -1,53 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import fs from 'node:fs/promises';
-import os from 'node:os';
-import path from 'node:path';
-import process from 'node:process';
-import { logger } from '../logger.js';
-const STATE_FILE_NAME = 'telemetry_state.json';
-function getDataFolder() {
-    const homedir = os.homedir();
-    const { env } = process;
-    const name = 'chrome-devtools-mcp';
-    if (process.platform === 'darwin') {
-        return path.join(homedir, 'Library', 'Application Support', name);
-    }
-    if (process.platform === 'win32') {
-        const localAppData = env.LOCALAPPDATA || path.join(homedir, 'AppData', 'Local');
-        return path.join(localAppData, name, 'Data');
-    }
-    return path.join(env.XDG_DATA_HOME || path.join(homedir, '.local', 'share'), name);
-}
-export class FilePersistence {
-    #dataFolder;
-    constructor(dataFolderOverride) {
-        this.#dataFolder = dataFolderOverride ?? getDataFolder();
-    }
-    async loadState() {
-        try {
-            const filePath = path.join(this.#dataFolder, STATE_FILE_NAME);
-            const content = await fs.readFile(filePath, 'utf-8');
-            return JSON.parse(content);
-        }
-        catch {
-            return {
-                lastActive: '',
-            };
-        }
-    }
-    async saveState(state) {
-        const filePath = path.join(this.#dataFolder, STATE_FILE_NAME);
-        try {
-            await fs.mkdir(this.#dataFolder, { recursive: true });
-            await fs.writeFile(filePath, JSON.stringify(state, null, 2), 'utf-8');
-        }
-        catch (error) {
-            // Ignore errors during state saving to avoid crashing the server
-            logger(`Failed to save telemetry state to ${filePath}:`, error);
-        }
-    }
-}

package/build/src/telemetry/types.js

@@ -1,33 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-// Enums
-export var OsType;
-(function (OsType) {
-    OsType[OsType["OS_TYPE_UNSPECIFIED"] = 0] = "OS_TYPE_UNSPECIFIED";
-    OsType[OsType["OS_TYPE_WINDOWS"] = 1] = "OS_TYPE_WINDOWS";
-    OsType[OsType["OS_TYPE_MACOS"] = 2] = "OS_TYPE_MACOS";
-    OsType[OsType["OS_TYPE_LINUX"] = 3] = "OS_TYPE_LINUX";
-})(OsType || (OsType = {}));
-export var ChromeChannel;
-(function (ChromeChannel) {
-    ChromeChannel[ChromeChannel["CHROME_CHANNEL_UNSPECIFIED"] = 0] = "CHROME_CHANNEL_UNSPECIFIED";
-    ChromeChannel[ChromeChannel["CHROME_CHANNEL_CANARY"] = 1] = "CHROME_CHANNEL_CANARY";
-    ChromeChannel[ChromeChannel["CHROME_CHANNEL_DEV"] = 2] = "CHROME_CHANNEL_DEV";
-    ChromeChannel[ChromeChannel["CHROME_CHANNEL_BETA"] = 3] = "CHROME_CHANNEL_BETA";
-    ChromeChannel[ChromeChannel["CHROME_CHANNEL_STABLE"] = 4] = "CHROME_CHANNEL_STABLE";
-})(ChromeChannel || (ChromeChannel = {}));
-export var McpClient;
-(function (McpClient) {
-    McpClient[McpClient["MCP_CLIENT_UNSPECIFIED"] = 0] = "MCP_CLIENT_UNSPECIFIED";
-    McpClient[McpClient["MCP_CLIENT_CLAUDE_CODE"] = 1] = "MCP_CLIENT_CLAUDE_CODE";
-    McpClient[McpClient["MCP_CLIENT_GEMINI_CLI"] = 2] = "MCP_CLIENT_GEMINI_CLI";
-})(McpClient || (McpClient = {}));
-// IPC types for messages between the main process and the
-// telemetry watchdog process.
-export var WatchdogMessageType;
-(function (WatchdogMessageType) {
-    WatchdogMessageType["LOG_EVENT"] = "log-event";
-})(WatchdogMessageType || (WatchdogMessageType = {}));

package/build/src/telemetry/watchdog/ClearcutSender.js

@@ -1,203 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import crypto from 'node:crypto';
-import { logger } from '../../logger.js';
-const MAX_BUFFER_SIZE = 1000;
-const DEFAULT_CLEARCUT_ENDPOINT = 'https://play.googleapis.com/log?format=json_proto';
-const DEFAULT_FLUSH_INTERVAL_MS = 15 * 60 * 1000;
-const LOG_SOURCE = 2839;
-const CLIENT_TYPE = 47;
-const MIN_RATE_LIMIT_WAIT_MS = 30_000;
-const REQUEST_TIMEOUT_MS = 30_000;
-const SHUTDOWN_TIMEOUT_MS = 5_000;
-const SESSION_ROTATION_INTERVAL_MS = 24 * 60 * 60 * 1000;
-export class ClearcutSender {
-    #appVersion;
-    #osType;
-    #clearcutEndpoint;
-    #flushIntervalMs;
-    #includePidHeader;
-    #sessionId;
-    #sessionCreated;
-    #buffer = [];
-    #flushTimer = null;
-    #isFlushing = false;
-    #timerStarted = false;
-    constructor(config) {
-        this.#appVersion = config.appVersion;
-        this.#osType = config.osType;
-        this.#clearcutEndpoint =
-            config.clearcutEndpoint ?? DEFAULT_CLEARCUT_ENDPOINT;
-        this.#flushIntervalMs =
-            config.forceFlushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
-        this.#includePidHeader = config.includePidHeader ?? false;
-        this.#sessionId = crypto.randomUUID();
-        this.#sessionCreated = Date.now();
-    }
-    enqueueEvent(event) {
-        if (Date.now() - this.#sessionCreated > SESSION_ROTATION_INTERVAL_MS) {
-            this.#sessionId = crypto.randomUUID();
-            this.#sessionCreated = Date.now();
-        }
-        logger('Enqueing telemetry event', JSON.stringify(event, null, 2));
-        this.#addToBuffer({
-            ...event,
-            session_id: this.#sessionId,
-            app_version: this.#appVersion,
-            os_type: this.#osType,
-        });
-        if (!this.#timerStarted) {
-            this.#timerStarted = true;
-            this.#scheduleFlush(this.#flushIntervalMs);
-        }
-    }
-    async sendShutdownEvent() {
-        if (this.#flushTimer) {
-            clearTimeout(this.#flushTimer);
-            this.#flushTimer = null;
-        }
-        const shutdownEvent = {
-            server_shutdown: {},
-        };
-        this.enqueueEvent(shutdownEvent);
-        try {
-            await Promise.race([
-                this.#finalFlush(),
-                new Promise(resolve => setTimeout(resolve, SHUTDOWN_TIMEOUT_MS)),
-            ]);
-            logger('Final flush completed');
-        }
-        catch (error) {
-            logger('Final flush failed:', error);
-        }
-    }
-    async #flush() {
-        if (this.#isFlushing) {
-            return;
-        }
-        if (this.#buffer.length === 0) {
-            this.#scheduleFlush(this.#flushIntervalMs);
-            return;
-        }
-        this.#isFlushing = true;
-        let nextDelayMs = this.#flushIntervalMs;
-        // Optimistically remove events from buffer before sending.
-        // This prevents race conditions where a simultaneous #finalFlush would include these same events.
-        const eventsToSend = [...this.#buffer];
-        this.#buffer = [];
-        try {
-            const result = await this.#sendBatch(eventsToSend);
-            if (result.success) {
-                if (result.nextRequestWaitMs !== undefined) {
-                    nextDelayMs = Math.max(result.nextRequestWaitMs, MIN_RATE_LIMIT_WAIT_MS);
-                }
-            }
-            else if (result.isPermanentError) {
-                logger('Permanent error, dropped batch of', eventsToSend.length, 'events');
-            }
-            else {
-                // Transient error: Requeue events at the front of the buffer
-                // to maintain order and retry them later.
-                this.#buffer = [...eventsToSend, ...this.#buffer];
-            }
-        }
-        catch (error) {
-            // Safety catch for unexpected errors, requeue events
-            this.#buffer = [...eventsToSend, ...this.#buffer];
-            logger('Flush failed unexpectedly:', error);
-        }
-        finally {
-            this.#isFlushing = false;
-            this.#scheduleFlush(nextDelayMs);
-        }
-    }
-    #addToBuffer(event) {
-        if (this.#buffer.length >= MAX_BUFFER_SIZE) {
-            this.#buffer.shift();
-            logger('Telemetry buffer overflow: dropped oldest event');
-        }
-        this.#buffer.push({
-            event,
-            timestamp: Date.now(),
-        });
-    }
-    #scheduleFlush(delayMs) {
-        logger(`Scheduling flush in ${delayMs}`);
-        if (this.#flushTimer) {
-            clearTimeout(this.#flushTimer);
-        }
-        this.#flushTimer = setTimeout(() => {
-            this.#flush().catch(err => {
-                logger('Flush error:', err);
-            });
-        }, delayMs);
-    }
-    async #sendBatch(events) {
-        logger(`Sending batch of ${events.length}`);
-        const requestBody = {
-            log_source: LOG_SOURCE,
-            request_time_ms: Date.now().toString(),
-            client_info: {
-                client_type: CLIENT_TYPE,
-            },
-            log_event: events.map(({ event, timestamp }) => ({
-                event_time_ms: timestamp.toString(),
-                source_extension_json: JSON.stringify(event),
-            })),
-        };
-        const controller = new AbortController();
-        const timeoutId = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
-        try {
-            const response = await fetch(this.#clearcutEndpoint, {
-                method: 'POST',
-                headers: {
-                    'Content-Type': 'application/json',
-                    // Used in E2E tests to confirm that the watchdog process is killed
-                    ...(this.#includePidHeader
-                        ? { 'X-Watchdog-Pid': process.pid.toString() }
-                        : {}),
-                },
-                body: JSON.stringify(requestBody),
-                signal: controller.signal,
-            });
-            clearTimeout(timeoutId);
-            if (response.ok) {
-                const data = (await response.json());
-                return {
-                    success: true,
-                    nextRequestWaitMs: data.next_request_wait_millis,
-                };
-            }
-            const status = response.status;
-            if (status >= 500 || status === 429) {
-                return { success: false };
-            }
-            logger('Telemetry permanent error:', status);
-            return { success: false, isPermanentError: true };
-        }
-        catch {
-            clearTimeout(timeoutId);
-            return { success: false };
-        }
-    }
-    async #finalFlush() {
-        if (this.#buffer.length === 0) {
-            return;
-        }
-        const eventsToSend = [...this.#buffer];
-        await this.#sendBatch(eventsToSend);
-    }
-    stopForTesting() {
-        if (this.#flushTimer) {
-            clearTimeout(this.#flushTimer);
-            this.#flushTimer = null;
-        }
-        this.#timerStarted = false;
-    }
-    get bufferSizeForTesting() {
-        return this.#buffer.length;
-    }
-}

package/build/src/telemetry/watchdog/main.js

@@ -1,127 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import process from 'node:process';
-import readline from 'node:readline';
-import { parseArgs } from 'node:util';
-import { logger, flushLogs, saveLogsToFile } from '../../logger.js';
-import { WatchdogMessageType } from '../types.js';
-import { ClearcutSender } from './ClearcutSender.js';
-function parseWatchdogArgs() {
-    const { values } = parseArgs({
-        options: {
-            'parent-pid': { type: 'string' },
-            'app-version': { type: 'string' },
-            'os-type': { type: 'string' },
-            'log-file': { type: 'string' },
-            'clearcut-endpoint': { type: 'string' },
-            'clearcut-force-flush-interval-ms': { type: 'string' },
-            'clearcut-include-pid-header': { type: 'boolean' },
-        },
-        strict: true,
-    });
-    // Verify required arguments
-    const parentPid = parseInt(values['parent-pid'] ?? '', 10);
-    const appVersion = values['app-version'];
-    const osType = parseInt(values['os-type'] ?? '', 10);
-    if (isNaN(parentPid) || !appVersion || isNaN(osType)) {
-        console.error('Invalid arguments provided for watchdog process: ', JSON.stringify({ parentPid, appVersion, osType }));
-        process.exit(1);
-    }
-    // Parse Optional Arguments
-    const logFile = values['log-file'];
-    const clearcutEndpoint = values['clearcut-endpoint'];
-    const clearcutIncludePidHeader = values['clearcut-include-pid-header'];
-    let clearcutForceFlushIntervalMs;
-    if (values['clearcut-force-flush-interval-ms']) {
-        const parsed = parseInt(values['clearcut-force-flush-interval-ms'], 10);
-        if (!isNaN(parsed)) {
-            clearcutForceFlushIntervalMs = parsed;
-        }
-    }
-    return {
-        parentPid,
-        appVersion,
-        osType,
-        logFile,
-        clearcutEndpoint,
-        clearcutForceFlushIntervalMs,
-        clearcutIncludePidHeader,
-    };
-}
-function main() {
-    const { parentPid, appVersion, osType, logFile, clearcutEndpoint, clearcutForceFlushIntervalMs, clearcutIncludePidHeader, } = parseWatchdogArgs();
-    let logStream;
-    if (logFile) {
-        logStream = saveLogsToFile(logFile);
-    }
-    const exit = (code) => {
-        if (!logStream) {
-            process.exit(code);
-        }
-        void flushLogs(logStream).finally(() => {
-            process.exit(code);
-        });
-    };
-    logger('Watchdog started', JSON.stringify({
-        pid: process.pid,
-        parentPid,
-        version: appVersion,
-        osType,
-    }, null, 2));
-    const sender = new ClearcutSender({
-        appVersion,
-        osType: osType,
-        clearcutEndpoint,
-        forceFlushIntervalMs: clearcutForceFlushIntervalMs,
-        includePidHeader: clearcutIncludePidHeader,
-    });
-    let isShuttingDown = false;
-    function onParentDeath(reason) {
-        if (isShuttingDown) {
-            return;
-        }
-        isShuttingDown = true;
-        logger(`Parent death detected (${reason}). Sending shutdown event...`);
-        sender
-            .sendShutdownEvent()
-            .then(() => {
-            logger('Shutdown event sent. Exiting.');
-            exit(0);
-        })
-            .catch(err => {
-            logger('Failed to send shutdown event', err);
-            exit(1);
-        });
-    }
-    process.stdin.on('end', () => onParentDeath('stdin end'));
-    process.stdin.on('close', () => onParentDeath('stdin close'));
-    process.on('disconnect', () => onParentDeath('ipc disconnect'));
-    const rl = readline.createInterface({
-        input: process.stdin,
-        terminal: false,
-    });
-    rl.on('line', line => {
-        try {
-            if (!line.trim()) {
-                return;
-            }
-            const msg = JSON.parse(line);
-            if (msg.type === WatchdogMessageType.LOG_EVENT && msg.payload) {
-                sender.enqueueEvent(msg.payload);
-            }
-        }
-        catch (err) {
-            logger('Failed to parse IPC message', err);
-        }
-    });
-}
-try {
-    main();
-}
-catch (err) {
-    console.error('Watchdog fatal error:', err);
-    process.exit(1);
-}

package/build/src/third_party/devtools-formatter-worker.js

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-// eslint-disable-next-line no-restricted-imports
-import '../../node_modules/chrome-devtools-frontend/front_end/entrypoints/formatter_worker/formatter_worker-entrypoint.js';

package/build/src/third_party/index.js

@@ -1,26 +0,0 @@
-/**
- * @license
- * Copyright 2025 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-import 'core-js/modules/es.promise.with-resolvers.js';
-import 'core-js/modules/es.set.union.v2.js';
-import 'core-js/proposals/iterator-helpers.js';
-export { default as yargs } from 'yargs';
-export { hideBin } from 'yargs/helpers';
-export { default as debug } from 'debug';
-export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-export { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-export { Client } from '@modelcontextprotocol/sdk/client/index.js';
-export { SetLevelRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-export { z as zod } from 'zod';
-export { Locator, PredefinedNetworkConditions, KnownDevices, CDPSessionEvent, } from 'puppeteer-core';
-export { default as puppeteer } from 'puppeteer-core';
-export { PipeTransport } from 'puppeteer-core/internal/node/PipeTransport.js';
-export { resolveDefaultUserDataDir, detectBrowserPlatform, Browser as BrowserEnum, } from '@puppeteer/browsers';
-import { snapshot as snapshotImpl, navigation as navigationImpl, generateReport as generateReportImpl, } from './lighthouse-devtools-mcp-bundle.js';
-export const snapshot = snapshotImpl;
-export const navigation = navigationImpl;
-export const generateReport = generateReportImpl;
-export * as DevTools from '../../node_modules/chrome-devtools-frontend/mcp/mcp.js';