This is a refactoring, a follow-up to the introduction of `McpPage.ts`.

Closes #1119

This PR adds an experimental allowlist for the page navigate tool call
(requires `--experimentalNavigationAllowlist`, off by default). The
feature uses a list of URLPatterns to decline navigations that land on
disallowed URLs. If that happens, the client can update the allowlist
and re-try. The purpose of the this feature is to offer additional
guardrails on top of the MCP server. It does not restrict subresources
or JS/iframe navigations in any way. The performance impact is minimized
by turning off interception as soon as the navigation request is done.

This PR adds experimental flag to customize `experimentalScreencast`
that allows specifying a different path to the ffmpeg binary.

Modifies the experimental screencast command to support `.webm` in
addition to `.mp4`. Renamed `path` to `filePath` to align with other
tools.

…ialization (#1877)

Improvements for handling in-page tool responses. In order to
successfully pass an in-page tool response from the page context to the
MCP server, the response needs to be serializable. The code walks the
response object an performs the following changes:

- DOM elements are stashed onto the window object and replaced with an
ID. On the MCP server side this ID is used to map back to the
corresponding UID in the page snapshot generated from the accessibility
tree.
- Circular references are replaced with a string.
- Class instances (which can be complex or non-serializable) are
replaced with a string.
- Functions are replaced with a string.

If the in-page tool response contains DOM elements which are not part of
the page snapshot, a new snapshot is created add the missing elements
are added explicitly.

🤖 I have created a release *beep* *boop*
---


##
[0.23.0](chrome-devtools-mcp-v0.22.0...chrome-devtools-mcp-v0.23.0)
(2026-04-22)


### 🎉 Features

* add an option to customize ffmpeg path
([#1937](#1937))
([b377454](b377454))
* support experimental allowlist for navigate tool calls
([#1935](#1935))
([d502557](d502557))
* support webm format in screencast
([#1934](#1934))
([85b8993](85b8993))


### 📄 Documentation

* clarify resource limitations around the number of tabs
([#1927](#1927))
([42be7c3](42be7c3))


### 🏗️ Refactor

* add support for CLI sessionIds in tests
([#1919](#1919))
([82b67b0](82b67b0))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).