chrome-devtools-mcp 0.26.0 → 1.1.0

package/build/src/third_party/issue-descriptions/genericBackUINavigationWouldSkipAd.md

@@ -0,0 +1,4 @@
+# Back UI Navigation Will Skip Ad
+
+An ad-related entry was found in the session history. If the user navigates back
+via the browser UI, this ad entry will be skipped.

package/build/src/tools/ToolDefinition.js

@@ -30,7 +30,7 @@ export function definePageTool(definition) {
 }
 export const CLOSE_PAGE_ERROR = 'The last open page cannot be closed. It is fine to keep it open.';
 export const pageIdSchema = {
-    pageId: zod.number().optional().describe('Targets a specific page by ID.'),
+    pageId: zod.number().describe('Targets a specific page by ID.'),
 };
 export const timeoutSchema = {
     timeout: zod
@@ -64,7 +64,7 @@ export function geolocationTransform(arg) {
     if (!arg) {
         return undefined;
     }
-    const [latitude, longitude] = arg.split('x').map(Number);
+    const [latitude, longitude] = arg.split(',').map(Number);
     return {
         latitude,
         longitude,

package/build/src/tools/emulation.js

@@ -7,6 +7,26 @@
 import { zod, PredefinedNetworkConditions } from '../third_party/index.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool, geolocationTransform, viewportTransform, } from './ToolDefinition.js';
+function headerStringTransform(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === '') {
+        return {};
+    }
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed !== 'object' ||
+            parsed === null ||
+            Array.isArray(parsed)) {
+            throw new Error('Headers must be a JSON object');
+        }
+        return parsed;
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON for headers: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
 const throttlingOptions = [
     'Offline',
     ...Object.keys(PredefinedNetworkConditions),
@@ -33,7 +53,7 @@ export const emulate = definePageTool({
             .string()
             .optional()
             .transform(geolocationTransform)
-            .describe('Geolocation (`<latitude>x<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.'),
+            .describe('Geolocation (`<latitude>,<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override.'),
         userAgent: zod
             .string()
             .optional()
@@ -47,11 +67,17 @@ export const emulate = definePageTool({
             .optional()
             .transform(viewportTransform)
             .describe(`Emulate device viewports '<width>x<height>x<devicePixelRatio>[,mobile][,touch][,landscape]'. 'touch' and 'mobile' to emulate mobile devices. 'landscape' to emulate landscape mode.`),
+        extraHttpHeaders: zod
+            .string()
+            .optional()
+            .transform(headerStringTransform)
+            .describe('Extra HTTP headers as a JSON string object, e.g. {"X-Custom": "value", "Authorization": "Bearer token"}. Headers are included into every HTTP request originating from the page and persist across navigations until cleared. Pass an empty string to clear all extra headers.'),
     },
     blockedByDialog: true,
-    handler: async (request, _response, context) => {
+    handler: async (request, response, context) => {
         const page = request.page;
         await context.emulate(request.params, page.pptrPage);
+        response.appendResponseLine('Emulation configured successfully');
     },
 });
 //# sourceMappingURL=emulation.js.map

package/build/src/tools/extensions.js

@@ -21,6 +21,7 @@ export const installExtension = defineTool({
     blockedByDialog: false,
     handler: async (request, response, context) => {
         const { path } = request.params;
+        await context.validatePath(path);
         const id = await context.installExtension(path);
         response.appendResponseLine(`Extension installed. Id: ${id}`);
     },
@@ -72,6 +73,7 @@ export const reloadExtension = defineTool({
         if (!extension) {
             throw new Error(`Extension with ID ${id} not found.`);
         }
+        await context.validatePath(extension.path);
         await context.installExtension(extension.path);
         response.appendResponseLine('Extension reloaded.');
     },

package/build/src/tools/input.js

@@ -85,7 +85,7 @@ export const click = definePageTool({
         const aXNode = request.page.getAXNodeByUid(uid);
         const shouldSelectNativeOption = !request.params.dblClick && aXNode?.role === 'option';
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 if (shouldSelectNativeOption &&
                     (await selectNativeSelectOption(handle))) {
                     return;
@@ -97,6 +97,7 @@ export const click = definePageTool({
             response.appendResponseLine(request.params.dblClick
                 ? `Successfully double clicked on the element`
                 : `Successfully clicked on the element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -126,14 +127,15 @@ export const clickAt = definePageTool({
     blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await page.pptrPage.mouse.click(request.params.x, request.params.y, {
-                clickCount: request.params.dblClick ? 2 : 1,
+                count: request.params.dblClick ? 2 : 1,
             });
         });
         response.appendResponseLine(request.params.dblClick
             ? `Successfully double clicked at the coordinates`
             : `Successfully clicked at the coordinates`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -157,10 +159,11 @@ export const hover = definePageTool({
         const uid = request.params.uid;
         const handle = await request.page.getElementByUid(uid);
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 await handle.asLocator().hover();
             });
             response.appendResponseLine(`Successfully hovered over the element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -269,10 +272,11 @@ export const fill = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await fillFormElement(request.params.uid, request.params.value, context, page);
         });
         response.appendResponseLine(`Successfully filled out the element`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -292,13 +296,14 @@ export const typeText = definePageTool({
     blockedByDialog: true,
     handler: async (request, response) => {
         const page = request.page;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             await page.pptrPage.keyboard.type(request.params.text);
             if (request.params.submitKey) {
                 await page.pptrPage.keyboard.press(request.params.submitKey);
             }
         });
         response.appendResponseLine(`Typed text "${request.params.text}${request.params.submitKey ? ` + ${request.params.submitKey}` : ''}"`);
+        response.attachWaitForResult(result);
     },
 });
 export const drag = definePageTool({
@@ -318,12 +323,13 @@ export const drag = definePageTool({
         const fromHandle = await request.page.getElementByUid(request.params.from_uid);
         const toHandle = await request.page.getElementByUid(request.params.to_uid);
         try {
-            await request.page.waitForEventsAfterAction(async () => {
+            const result = await request.page.waitForEventsAfterAction(async () => {
                 await fromHandle.drag(toHandle);
                 await new Promise(resolve => setTimeout(resolve, 50));
                 await toHandle.drop(fromHandle);
             });
             response.appendResponseLine(`Successfully dragged an element`);
+            response.attachWaitForResult(result);
             if (request.params.includeSnapshot) {
                 response.includeSnapshot();
             }
@@ -357,12 +363,14 @@ export const fillForm = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
+        let lastResult = {};
         for (const element of request.params.elements) {
-            await page.waitForEventsAfterAction(async () => {
+            lastResult = await page.waitForEventsAfterAction(async () => {
                 await fillFormElement(element.uid, element.value, context, page);
             });
         }
         response.appendResponseLine(`Successfully filled out the form`);
+        response.attachWaitForResult(lastResult);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }
@@ -385,7 +393,7 @@ export const uploadFile = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const { uid, filePath } = request.params;
-        context.validatePath(filePath);
+        await context.validatePath(filePath);
         const handle = (await request.page.getElementByUid(uid));
         try {
             try {
@@ -434,7 +442,7 @@ export const pressKey = definePageTool({
         const page = request.page;
         const tokens = parseKey(request.params.key);
         const [key, ...modifiers] = tokens;
-        await page.waitForEventsAfterAction(async () => {
+        const result = await page.waitForEventsAfterAction(async () => {
             for (const modifier of modifiers) {
                 await page.pptrPage.keyboard.down(modifier);
             }
@@ -444,6 +452,7 @@ export const pressKey = definePageTool({
             }
         });
         response.appendResponseLine(`Successfully pressed key: ${request.params.key}`);
+        response.attachWaitForResult(result);
         if (request.params.includeSnapshot) {
             response.includeSnapshot();
         }

package/build/src/tools/lighthouse.js

@@ -40,7 +40,7 @@ export const lighthouseAudit = definePageTool({
         ];
         const formats = ['json', 'html'];
         const { mode = 'navigation', device = 'desktop', outputDirPath, } = request.params;
-        context.validatePath(outputDirPath);
+        await context.validatePath(outputDirPath);
         const flags = {
             onlyCategories: categories,
             output: formats,

package/build/src/tools/memory.js

@@ -7,8 +7,8 @@ import { zod } from '../third_party/index.js';
 import { ensureExtension } from '../utils/files.js';
 import { ToolCategory } from './categories.js';
 import { definePageTool, defineTool } from './ToolDefinition.js';
-export const takeMemorySnapshot = definePageTool({
-    name: 'take_memory_snapshot',
+export const takeHeapSnapshot = definePageTool({
+    name: 'take_heapsnapshot',
     description: `Capture a heap snapshot of the currently selected page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.`,
     annotations: {
         category: ToolCategory.MEMORY,
@@ -22,15 +22,15 @@ export const takeMemorySnapshot = definePageTool({
     blockedByDialog: true,
     handler: async (request, response, context) => {
         const page = request.page;
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         await page.pptrPage.captureHeapSnapshot({
             path: ensureExtension(request.params.filePath, '.heapsnapshot'),
         });
         response.appendResponseLine(`Heap snapshot saved to ${request.params.filePath}`);
     },
 });
-export const exploreMemorySnapshot = defineTool({
-    name: 'load_memory_snapshot',
+export const getHeapSnapshotSummary = defineTool({
+    name: 'get_heapsnapshot_summary',
     description: 'Loads a memory heapsnapshot and returns snapshot summary stats.',
     annotations: {
         category: ToolCategory.MEMORY,
@@ -42,14 +42,14 @@ export const exploreMemorySnapshot = defineTool({
     },
     blockedByDialog: false,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         const stats = await context.getHeapSnapshotStats(request.params.filePath);
         const staticData = await context.getHeapSnapshotStaticData(request.params.filePath);
         response.setHeapSnapshotStats(stats, staticData);
     },
 });
-export const getMemorySnapshotDetails = defineTool({
-    name: 'get_memory_snapshot_details',
+export const getHeapSnapshotDetails = defineTool({
+    name: 'get_heapsnapshot_details',
     description: 'Loads a memory heapsnapshot and returns all available information including statistics, static data, and aggregated node information. Supports pagination for aggregates.',
     annotations: {
         category: ToolCategory.MEMORY,
@@ -69,7 +69,7 @@ export const getMemorySnapshotDetails = defineTool({
     },
     blockedByDialog: false,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         const aggregates = await context.getHeapSnapshotAggregates(request.params.filePath);
         response.setHeapSnapshotAggregates(aggregates, {
             pageIdx: request.params.pageIdx,
@@ -77,9 +77,9 @@ export const getMemorySnapshotDetails = defineTool({
         });
     },
 });
-export const getNodesByClass = defineTool({
-    name: 'get_nodes_by_class',
-    description: 'Loads a memory heapsnapshot and returns instances of a specific class with their stable IDs.',
+export const getHeapSnapshotClassNodes = defineTool({
+    name: 'get_heapsnapshot_class_nodes',
+    description: 'Loads a memory heapsnapshot and returns instances of a specific class with their IDs.',
     annotations: {
         category: ToolCategory.MEMORY,
         readOnlyHint: true,
@@ -87,20 +87,42 @@ export const getNodesByClass = defineTool({
     },
     schema: {
         filePath: zod.string().describe('A path to a .heapsnapshot file to read.'),
-        uid: zod
-            .number()
-            .describe('The unique UID for the class, obtained from aggregates listing.'),
+        id: zod.number().describe('The ID for the class, obtained from details.'),
         pageIdx: zod.number().optional().describe('The page index for pagination.'),
         pageSize: zod.number().optional().describe('The page size for pagination.'),
     },
     blockedByDialog: false,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
-        const nodes = await context.getHeapSnapshotNodesByUid(request.params.filePath, request.params.uid);
+        await context.validatePath(request.params.filePath);
+        const nodes = await context.getHeapSnapshotNodesById(request.params.filePath, request.params.id);
         response.setHeapSnapshotNodes(nodes, {
             pageIdx: request.params.pageIdx,
             pageSize: request.params.pageSize,
         });
     },
 });
+export const getHeapSnapshotRetainers = defineTool({
+    name: 'get_heapsnapshot_retainers',
+    description: 'Loads a memory heapsnapshot and returns retainers for a specific node ID.',
+    annotations: {
+        category: ToolCategory.MEMORY,
+        readOnlyHint: true,
+        conditions: ['experimentalMemory'],
+    },
+    blockedByDialog: false,
+    schema: {
+        filePath: zod.string().describe('A path to a .heapsnapshot file to read.'),
+        nodeId: zod.number().describe('The node ID to get retainers for.'),
+        pageIdx: zod.number().optional().describe('The page index for pagination.'),
+        pageSize: zod.number().optional().describe('The page size for pagination.'),
+    },
+    handler: async (request, response, context) => {
+        await context.validatePath(request.params.filePath);
+        const retainers = await context.getHeapSnapshotRetainers(request.params.filePath, request.params.nodeId);
+        response.setHeapSnapshotNodes(retainers, {
+            pageIdx: request.params.pageIdx,
+            pageSize: request.params.pageSize,
+        });
+    },
+});
 //# sourceMappingURL=memory.js.map

package/build/src/tools/network.js

@@ -96,8 +96,8 @@ export const getNetworkRequest = definePageTool({
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.requestFilePath);
-        context.validatePath(request.params.responseFilePath);
+        await context.validatePath(request.params.requestFilePath);
+        await context.validatePath(request.params.responseFilePath);
         if (request.params.reqid) {
             response.attachNetworkRequest(request.params.reqid, {
                 requestFilePath: request.params.requestFilePath,

package/build/src/tools/performance.js

@@ -33,7 +33,7 @@ export const startTrace = definePageTool({
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         if (context.isRunningPerformanceTrace()) {
             response.appendResponseLine('Error: a performance trace is already running. Use performance_stop_trace to stop it. Only one trace can be running at any given time.');
             return;
@@ -78,7 +78,7 @@ export const startTrace = definePageTool({
         }
         if (request.params.autoStop) {
             await new Promise(resolve => setTimeout(resolve, 5_000));
-            await stopTracingAndAppendOutput(page.pptrPage, response, context, request.params.filePath);
+            await stopTracingAndAppendOutput(page, response, context, request.params.filePath);
         }
         else {
             response.appendResponseLine(`The performance trace is being recorded. Use performance_stop_trace to stop it.`);
@@ -97,12 +97,12 @@ export const stopTrace = definePageTool({
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         if (!context.isRunningPerformanceTrace()) {
             return;
         }
         const page = request.page;
-        await stopTracingAndAppendOutput(page.pptrPage, response, context, request.params.filePath);
+        await stopTracingAndAppendOutput(page, response, context, request.params.filePath);
     },
 });
 export const analyzeInsight = definePageTool({
@@ -132,7 +132,7 @@ export const analyzeInsight = definePageTool({
 });
 async function stopTracingAndAppendOutput(page, response, context, filePath) {
     try {
-        const traceEventsBuffer = await page.tracing.stop();
+        const traceEventsBuffer = await page.pptrPage.tracing.stop();
         if (filePath && traceEventsBuffer) {
             let dataToWrite = traceEventsBuffer;
             if (filePath.endsWith('.gz')) {
@@ -150,7 +150,10 @@ async function stopTracingAndAppendOutput(page, response, context, filePath) {
             const file = await context.saveFile(dataToWrite, filePath, filePath.endsWith('.gz') ? '.json.gz' : '.json');
             response.appendResponseLine(`The raw trace data was saved to ${file.filename}.`);
         }
-        const result = await parseRawTraceBuffer(traceEventsBuffer);
+        const result = await parseRawTraceBuffer(traceEventsBuffer, {
+            cpuThrottling: page.cpuThrottlingRate,
+            networkThrottling: page.networkConditions ?? undefined,
+        });
         response.appendResponseLine('The performance trace has been stopped.');
         if (traceResultIsSuccess(result)) {
             if (context.isCruxEnabled()) {

package/build/src/tools/screencast.js

@@ -31,7 +31,7 @@ export const startScreencast = definePageTool(args => ({
     },
     blockedByDialog: false,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         if (context.getScreenRecorder() !== null) {
             response.appendResponseLine('Error: a screencast recording is already in progress. Use screencast_stop to stop it before starting a new one.');
             return;

package/build/src/tools/screenshot.js

@@ -40,7 +40,7 @@ export const screenshot = definePageTool({
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         if (request.params.uid && request.params.fullPage) {
             throw new Error('Providing both "uid" and "fullPage" is not allowed.');
         }

package/build/src/tools/script.js

@@ -32,6 +32,10 @@ Example with arguments: \`(el) => {
                 .describe('The uid of an element on the page from the page content snapshot'))
                 .optional()
                 .describe(`An optional list of arguments to pass to the function.`),
+            filePath: zod
+                .string()
+                .optional()
+                .describe('The absolute or relative path to a file to save the script output to. If omitted, the output is returned inline.'),
             dialogAction: zod
                 .string()
                 .optional()
@@ -48,7 +52,8 @@ Example with arguments: \`(el) => {
         },
         blockedByDialog: true,
         handler: async (request, response, context) => {
-            const { serviceWorkerId, args: uidArgs, function: fnString, pageId, dialogAction, } = request.params;
+            const { serviceWorkerId, args: uidArgs, function: fnString, pageId, dialogAction, filePath, } = request.params;
+            await context.validatePath(filePath);
             if (cliArgs?.categoryExtensions && serviceWorkerId) {
                 if (uidArgs && uidArgs.length > 0) {
                     throw new Error('args (element uids) cannot be used when evaluating in a service worker.');
@@ -57,9 +62,15 @@ Example with arguments: \`(el) => {
                     throw new Error('specify either a pageId or a serviceWorkerId.');
                 }
                 const worker = await getWebWorker(context, serviceWorkerId);
-                await context.getSelectedMcpPage().waitForEventsAfterAction(async () => {
-                    await performEvaluation(worker, fnString, [], response);
+                const result = await context
+                    .getSelectedMcpPage()
+                    .waitForEventsAfterAction(async () => {
+                    await performEvaluation(worker, fnString, [], response, {
+                        filePath,
+                        context,
+                    });
                 }, { handleDialog: dialogAction ?? 'accept' });
+                response.attachWaitForResult(result);
                 return;
             }
             const mcpPage = cliArgs?.experimentalPageIdRouting
@@ -75,9 +86,13 @@ Example with arguments: \`(el) => {
                     args.push(handle);
                 }
                 const evaluatable = await getPageOrFrame(page, frames);
-                await mcpPage.waitForEventsAfterAction(async () => {
-                    await performEvaluation(evaluatable, fnString, args, response);
+                const result = await mcpPage.waitForEventsAfterAction(async () => {
+                    await performEvaluation(evaluatable, fnString, args, response, {
+                        filePath,
+                        context,
+                    });
                 }, { handleDialog: dialogAction ?? 'accept' });
+                response.attachWaitForResult(result);
             }
             finally {
                 void Promise.allSettled(args.map(arg => arg.dispose()));
@@ -85,17 +100,24 @@ Example with arguments: \`(el) => {
         },
     };
 });
-const performEvaluation = async (evaluatable, fnString, args, response) => {
+const performEvaluation = async (evaluatable, fnString, args, response, options) => {
     const fn = await evaluatable.evaluateHandle(`(${fnString})`);
     try {
         const result = await evaluatable.evaluate(async (fn, ...args) => {
             // @ts-expect-error no types for function fn
             return JSON.stringify(await fn(...args));
         }, fn, ...args);
-        response.appendResponseLine('Script ran on page and returned:');
-        response.appendResponseLine('```json');
-        response.appendResponseLine(`${result}`);
-        response.appendResponseLine('```');
+        if (options?.filePath) {
+            const data = new TextEncoder().encode(result ?? 'undefined');
+            const { filename } = await options.context.saveFile(data, options.filePath, '.json');
+            response.appendResponseLine(`Script ran on page. Output saved to ${filename}.`);
+        }
+        else {
+            response.appendResponseLine('Script ran on page and returned:');
+            response.appendResponseLine('```json');
+            response.appendResponseLine(`${result}`);
+            response.appendResponseLine('```');
+        }
     }
     finally {
         void fn.dispose();

package/build/src/tools/snapshot.js

@@ -28,7 +28,7 @@ in the DevTools Elements panel (if any).`,
     },
     blockedByDialog: true,
     handler: async (request, response, context) => {
-        context.validatePath(request.params.filePath);
+        await context.validatePath(request.params.filePath);
         response.includeSnapshot({
             verbose: request.params.verbose ?? false,
             filePath: request.params.filePath,

package/build/src/trace-processing/parse.js

@@ -9,7 +9,7 @@ const engine = DevTools.TraceEngine.TraceModel.Model.createWithAllHandlers();
 export function traceResultIsSuccess(x) {
     return 'parsedTrace' in x;
 }
-export async function parseRawTraceBuffer(buffer) {
+export async function parseRawTraceBuffer(buffer, metadata) {
     engine.resetProcessor();
     if (!buffer) {
         return {
@@ -25,7 +25,7 @@ export async function parseRawTraceBuffer(buffer) {
     try {
         const data = JSON.parse(asString);
         const events = Array.isArray(data) ? data : data.traceEvents;
-        await engine.parse(events);
+        await engine.parse(events, { metadata });
         const parsedTrace = engine.parsedTrace();
         if (!parsedTrace) {
             return {

package/build/src/utils/files.js

@@ -15,4 +15,47 @@ export function ensureExtension(filepath, extension) {
     const ext = path.extname(filepath);
     return filepath.slice(0, filepath.length - ext.length) + extension;
 }
+export async function resolveCanonicalPath(filePath) {
+    const absolutePath = path.resolve(filePath);
+    try {
+        // Get the true canonical path, resolving all symlinks.
+        return await fs.realpath(absolutePath);
+    }
+    catch (err) {
+        if (err &&
+            typeof err === 'object' &&
+            'code' in err &&
+            err.code === 'ENOENT') {
+            // Find the nearest existing ancestor directory on the filesystem.
+            let current = absolutePath;
+            const missingSegments = [];
+            while (true) {
+                const parent = path.dirname(current);
+                if (parent === current) {
+                    // Reached root directory but still couldn't resolve anything.
+                    throw err;
+                }
+                try {
+                    const canonicalParent = await fs.realpath(parent);
+                    return path.join(canonicalParent, path.basename(current), ...missingSegments);
+                }
+                catch (parentErr) {
+                    if (parentErr &&
+                        typeof parentErr === 'object' &&
+                        'code' in parentErr &&
+                        parentErr.code === 'ENOENT') {
+                        missingSegments.unshift(path.basename(current));
+                        current = parent;
+                    }
+                    else {
+                        throw parentErr;
+                    }
+                }
+            }
+        }
+        else {
+            throw err;
+        }
+    }
+}
 //# sourceMappingURL=files.js.map

package/build/src/version.js

@@ -5,6 +5,6 @@
  */
 // If moved update release-please config
 // x-release-please-start-version
-export const VERSION = '0.26.0';
+export const VERSION = '1.1.0';
 // x-release-please-end
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "0.26.0",
+  "version": "1.1.0",
   "description": "MCP server for Chrome DevTools",
   "type": "module",
   "bin": {
@@ -62,7 +62,7 @@
     "@types/yargs": "^17.0.33",
     "@typescript-eslint/eslint-plugin": "^8.43.0",
     "@typescript-eslint/parser": "^8.43.0",
-    "chrome-devtools-frontend": "1.0.1626840",
+    "chrome-devtools-frontend": "1.0.1632065",
     "core-js": "3.49.0",
     "debug": "4.4.3",
     "eslint": "^9.35.0",
@@ -71,8 +71,8 @@
     "globals": "^17.0.0",
     "lighthouse": "13.3.0",
     "prettier": "^3.6.2",
-    "puppeteer": "24.43.0",
-    "rollup": "4.60.3",
+    "puppeteer": "25.1.0",
+    "rollup": "4.60.4",
     "rollup-plugin-cleanup": "^3.2.1",
     "rollup-plugin-license": "^3.6.0",
     "semver": "^7.7.4",
@@ -84,5 +84,8 @@
   },
   "engines": {
     "node": "^20.19.0 || ^22.12.0 || >=23"
+  },
+  "overrides": {
+    "puppeteer-core": "$puppeteer"
   }
 }