Chrome DevTools for coding agents
feat: detect network requests inspected in DevTools UI (#477)
Alex Rudenko796aed72b712
diff --git a/docs/tool-reference.md b/docs/tool-reference.mdindex 7e51181b..b9bc6d28 100644--- a/docs/tool-reference.md+++ b/docs/tool-reference.md@@ -255,11 +255,12 @@### `get_network_request`-**Description:** Gets a network request by URL. You can get all requests by calling [`list_network_requests`](#list_network_requests).+**Description:** Gets a network request by reqid. You can get all requests by calling [`list_network_requests`](#list_network_requests).+Get the request currently selected in the DevTools UI by ommitting reqid**Parameters:**-- **reqid** (number) **(required)**: The reqid of a request on the page from the listed network requests+- **reqid** (number) _(optional)_: The reqid of the network request. If omitted, looks up the current request selected in DevTools UI.---diff --git a/src/McpContext.ts b/src/McpContext.tsindex 586c2ba7..ceae3513 100644--- a/src/McpContext.ts+++ b/src/McpContext.ts@@ -337,12 +337,13 @@ export class McpContext implements Context {);});- await this.#detectOpenDevToolsWindows(allPages);+ await this.detectOpenDevToolsWindows();return this.#pages;}- async #detectOpenDevToolsWindows(pages: Page[]) {+ async detectOpenDevToolsWindows() {+ const pages = await this.browser.pages();this.#pageToDevToolsPage = new Map<Page, Page>();for (const devToolsPage of pages) {if (devToolsPage.url().startsWith('devtools://')) {@@ -377,6 +378,45 @@ export class McpContext implements Context {return this.#pageToDevToolsPage.get(page);}+ async getDevToolsData(): Promise<undefined | {requestId?: number}> {+ try {+ const selectedPage = this.getSelectedPage();+ const devtoolsPage = this.getDevToolsPage(selectedPage);+ if (devtoolsPage) {+ const cdpRequestId = await devtoolsPage.evaluate(async () => {+ // @ts-expect-error no types+ const UI = await import('/bundled/ui/legacy/legacy.js');+ // @ts-expect-error no types+ const SDK = await import('/bundled/core/sdk/sdk.js');+ const request = UI.Context.Context.instance().flavor(+ SDK.NetworkRequest.NetworkRequest,+ );+ return request?.requestId();+ });+ if (!cdpRequestId) {+ this.logger('no context request');+ return;+ }+ const request = this.#networkCollector.find(selectedPage, request => {+ // @ts-expect-error id is internal.+ return request.id === cdpRequestId;+ });+ if (!request) {+ this.logger('no collected request for ' + cdpRequestId);+ return;+ }+ return {+ requestId: this.#networkCollector.getIdForResource(request),+ };+ } else {+ this.logger('no devtools page deteched');+ }+ } catch (err) {+ this.logger('error getting devtools data', err);+ }+ return;+ }+/*** Creates a text snapshot of a page.*/diff --git a/src/McpResponse.ts b/src/McpResponse.tsindex 24f2b3f8..6798c90b 100644--- a/src/McpResponse.ts+++ b/src/McpResponse.ts@@ -44,6 +44,7 @@ export class McpResponse implements Response {pagination?: PaginationOptions;resourceTypes?: ResourceType[];includePreservedRequests?: boolean;+ networkRequestIdInDevToolsUI?: number;};#consoleDataOptions?: {include: boolean;@@ -67,6 +68,7 @@ export class McpResponse implements Response {options?: PaginationOptions & {resourceTypes?: ResourceType[];includePreservedRequests?: boolean;+ networkRequestIdInDevToolsUI?: number;},): void {if (!value) {@@ -85,6 +87,7 @@ export class McpResponse implements Response {: undefined,resourceTypes: options?.resourceTypes,includePreservedRequests: options?.includePreservedRequests,+ networkRequestIdInDevToolsUI: options?.networkRequestIdInDevToolsUI,};}@@ -391,6 +394,8 @@ Call ${handleDialog.name} to handle it before continuing.`);getShortDescriptionForRequest(request,context.getNetworkRequestStableId(request),+ context.getNetworkRequestStableId(request) ===+ this.#networkRequestsOptions?.networkRequestIdInDevToolsUI,),);}diff --git a/src/PageCollector.ts b/src/PageCollector.tsindex 8cb43350..22b9c7a8 100644--- a/src/PageCollector.ts+++ b/src/PageCollector.ts@@ -163,16 +163,32 @@ export class PageCollector<T> {throw new Error('No requests found for selected page');}- for (const navigation of navigations) {- for (const collected of navigation) {- if (collected[stableIdSymbol] === stableId) {- return collected;- }- }+ const item = this.find(page, item => item[stableIdSymbol] === stableId);++ if (item) {+ return item;}throw new Error('Request not found for selected page');}++ find(+ page: Page,+ filter: (item: WithSymbolId<T>) => boolean,+ ): WithSymbolId<T> | undefined {+ const navigations = this.storage.get(page);+ if (!navigations) {+ return;+ }++ for (const navigation of navigations) {+ const item = navigation.find(filter);+ if (item) {+ return item;+ }+ }+ return;+ }}export class NetworkCollector extends PageCollector<HTTPRequest> {diff --git a/src/formatters/networkFormatter.ts b/src/formatters/networkFormatter.tsindex 3c1abe58..d3945130 100644--- a/src/formatters/networkFormatter.ts+++ b/src/formatters/networkFormatter.ts@@ -13,9 +13,10 @@ const BODY_CONTEXT_SIZE_LIMIT = 10000;export function getShortDescriptionForRequest(request: HTTPRequest,id: number,+ selectedInDevToolsUI = false,): string {// TODO truncate the URL- return `reqid=${id} ${request.method()} ${request.url()} ${getStatusFromRequest(request)}`;+ return `reqid=${id} ${request.method()} ${request.url()} ${getStatusFromRequest(request)}${selectedInDevToolsUI ? ` [selected in DevTools UI]` : ''}`;}export function getStatusFromRequest(request: HTTPRequest): string {diff --git a/src/main.ts b/src/main.tsindex 3443cecc..9dad338e 100644--- a/src/main.ts+++ b/src/main.ts@@ -129,6 +129,7 @@ function registerTool(tool: ToolDefinition): void {try {logger(`${tool.name} request: ${JSON.stringify(params, null, ' ')}`);const context = await getContext();+ await context.detectOpenDevToolsWindows();const response = new McpResponse();await tool.handler({diff --git a/src/tools/ToolDefinition.ts b/src/tools/ToolDefinition.tsindex 68f29260..8df0f720 100644--- a/src/tools/ToolDefinition.ts+++ b/src/tools/ToolDefinition.ts@@ -55,6 +55,7 @@ export interface Response {options?: PaginationOptions & {resourceTypes?: string[];includePreservedRequests?: boolean;+ networkRequestIdInDevToolsUI?: number;},): void;setIncludeConsoleData(@@ -102,6 +103,7 @@ export type Context = Readonly<{text: string;timeout?: number | undefined;}): Promise<Element>;+ getDevToolsData(): Promise<undefined | {requestId?: number}>;}>;export function defineTool<Schema extends zod.ZodRawShape>(diff --git a/src/tools/network.ts b/src/tools/network.tsindex fe51f72f..1df94550 100644--- a/src/tools/network.ts+++ b/src/tools/network.ts@@ -70,19 +70,22 @@ export const listNetworkRequests = defineTool({'Set to true to return the preserved requests over the last 3 navigations.',),},- handler: async (request, response) => {+ handler: async (request, response, context) => {+ const data = await context.getDevToolsData();response.setIncludeNetworkRequests(true, {pageSize: request.params.pageSize,pageIdx: request.params.pageIdx,resourceTypes: request.params.resourceTypes,includePreservedRequests: request.params.includePreservedRequests,+ networkRequestIdInDevToolsUI: data?.requestId,});},});export const getNetworkRequest = defineTool({name: 'get_network_request',- description: `Gets a network request by URL. You can get all requests by calling ${listNetworkRequests.name}.`,+ description: `Gets a network request by reqid. You can get all requests by calling ${listNetworkRequests.name}.+Get the request currently selected in the DevTools UI by ommitting reqid`,annotations: {category: ToolCategory.NETWORK,readOnlyHint: true,@@ -90,11 +93,23 @@ export const getNetworkRequest = defineTool({schema: {reqid: zod.number()+ .optional().describe(- 'The reqid of a request on the page from the listed network requests',+ 'The reqid of the network request. If omitted, looks up the current request selected in DevTools UI.',),},- handler: async (request, response, _context) => {- response.attachNetworkRequest(request.params.reqid);+ handler: async (request, response, context) => {+ if (request.params.reqid) {+ response.attachNetworkRequest(request.params.reqid);+ } else {+ const data = await context.getDevToolsData();+ if (data?.requestId) {+ response.attachNetworkRequest(data?.requestId);+ } else {+ response.appendResponseLine(+ `Nothing is currently selected in DevTools UI.`,+ );+ }+ }},});diff --git a/tests/formatters/networkFormatter.test.ts b/tests/formatters/networkFormatter.test.tsindex e22b0140..2bd1bbd6 100644--- a/tests/formatters/networkFormatter.test.ts+++ b/tests/formatters/networkFormatter.test.ts@@ -71,6 +71,16 @@ describe('networkFormatter', () => {'reqid=1 GET http://example.com [failed - Error in Network]',);});++ it('marks requests selected in DevTools UI', async () => {+ const request = getMockRequest();+ const result = getShortDescriptionForRequest(request, 1, true);++ assert.equal(+ result,+ 'reqid=1 GET http://example.com [pending] [selected in DevTools UI]',+ );+ });});describe('getFormattedHeaderValue', () => {