Merge remote-tracking branch 'upstream/main'

# Conflicts:
#	.github/workflows/publish-to-npm-on-tag.yml
#	.release-please-manifest.json
#	README.md
#	package-lock.json
#	package.json
#	scripts/post-build.ts
#	server.json
#	src/browser.ts
#	src/main.ts
#	tests/cli.test.ts
#	tsconfig.json

Author: Nima21

.agent/rules/coding.md

@@ -0,0 +1,21 @@
+---
+trigger: always_on
+---
+
+# Instructions
+
+- Use only scripts from `package.json` to run commands.
+- Use `npm run build` to run tsc and test build.
+- Use `npm run test` to build and run tests, run all tests to verify correctness.
+- Use `npm run test path-to-test.ts` to build and run a single test file, for example, `npm run test tests/McpContext.test.ts`.
+- Use `npm run format` to fix formatting and get linting errors.
+
+## Rules for TypeScript
+
+- Do not use `any` type.
+- Do not use `as` keyword for type casting.
+- Do not use `!` operator for type assertion.
+- Do not use `// @ts-ignore` comments.
+- Do not use `// @ts-nocheck` comments.
+- Do not use `// @ts-expect-error` comments.
+- Prefer `for..of` instead of `forEach`.

.claude-plugin/marketplace.json

@@ -9,10 +9,7 @@
   "plugins": [
     {
       "name": "chrome-devtools-mcp",
-      "source": {
-        "source": "github",
-        "repo": "ChromeDevTools/chrome-devtools-mcp"
-      },
+      "source": "./",
       "description": "Reliable automation, in-depth debugging, and performance analysis in Chrome using Chrome DevTools and Puppeteer"
     }
   ]

.github/workflows/convetional-commit.yml .github/workflows/conventional-commit.yml.github/workflows/convetional-commit.yml renamed to .github/workflows/conventional-commit.yml

@@ -1,6 +1,7 @@
 name: 'Conventional Commit'
 
 on:
+  merge_group:
   pull_request_target:
     types:
       # Defaults
@@ -19,6 +20,7 @@ jobs:
     permissions:
       pull-requests: read
     steps:
-      - uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
+      - if: github.event_name != 'merge_group'
+        uses: amannn/action-semantic-pull-request@48f256284bd46cdaab1048c3721360e808335d50 # v6.1.1
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/pre-release.yml

@@ -3,6 +3,7 @@ name: Pre-release
 permissions: read-all
 
 on:
+  workflow_dispatch:
   push:
     branches:
       - release-please-*
@@ -13,20 +14,15 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           cache: npm
           node-version-file: '.nvmrc'
 
-      - name: Install MCP Publisher
-        run: |
-          export OS=$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
-          curl -L "https://github.com/modelcontextprotocol/registry/releases/latest/download/mcp-publisher_${OS}.tar.gz" | tar xz mcp-publisher
-
       - name: Verify server.json
         run: npm run verify-server-json-version

.github/workflows/presubmit.yml

@@ -3,6 +3,7 @@ name: Check code before submitting
 permissions: read-all
 
 on:
+  merge_group:
   push:
     branches:
       - main
@@ -15,12 +16,12 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           cache: npm
           node-version-file: '.nvmrc'
@@ -37,12 +38,12 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           cache: npm
           node-version-file: '.nvmrc'

.github/workflows/publish-to-npm-on-tag.yml

@@ -20,12 +20,12 @@ jobs:
     if: ${{ (github.event_name != 'workflow_dispatch') || (inputs.npm-publish && always()) }}
     steps:
       - name: Check out repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           cache: npm
           node-version-file: '.nvmrc'

.github/workflows/run-tests.yml

@@ -3,6 +3,7 @@ name: Compile and run tests
 permissions: read-all
 
 on:
+  merge_group:
   push:
     branches:
       - main
@@ -26,12 +27,12 @@ jobs:
           - 24
     steps:
       - name: Check out repository
-        uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           cache: npm
           node-version: 22 # build works only with 22+.
@@ -46,7 +47,7 @@ jobs:
           NODE_OPTIONS: '--max_old_space_size=4096'
 
       - name: Set up Node.js
-        uses: actions/setup-node@395ad3262231945c25e8478fd5baf05154b1d79f # v6.1.0
+        uses: actions/setup-node@6044e13b5dc448c55e2357c09f80417699197238 # v6.2.0
         with:
           cache: npm
           node-version: ${{ matrix.node }}
@@ -56,15 +57,10 @@ jobs:
         shell: bash
         run: echo 0 | sudo tee /proc/sys/kernel/apparmor_restrict_unprivileged_userns
 
-      - name: Run tests (node20)
-        if: ${{ matrix.node == '20' }}
-        shell: bash
-        run: npm run test:node20
-
       - name: Run tests
         shell: bash
-        if: ${{ matrix.node != '20' }}
-        run: npm run test:no-build
+        # Retry tests if they fail in the merge queue.
+        run: npm run test:no-build -- ${{ github.event_name == 'merge_group' && '--retry' || '' }}
 
   # Gating job for branch protection.
   test-success:

.gitignore

@@ -7,6 +7,9 @@ yarn-error.log*
 lerna-debug.log*
 .pnpm-debug.log*
 
+trace.json
+trace.json.gz
+
 # Diagnostic reports (https://nodejs.org/api/report.html)
 report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
 

.mcp.json

@@ -0,0 +1,6 @@
+{
+  "chrome-devtools": {
+    "command": "npx",
+    "args": ["chrome-devtools-mcp@latest"]
+  }
+}

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.12.3"
+  ".": "0.17.3"
 }