Feat/selectors

.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

@@ -1,18 +1,16 @@
 {
   "name": "chrome-devtools-plugins",
-  "version": "1.0.0",
+  "version": "0.20.3",
   "description": "Bundled plugins for actuating and debugging the Chrome browser.",
+  "repository": "https://github.com/ChromeDevTools/chrome-devtools-mcp",
   "owner": {
     "name": "Chrome DevTools Team",
     "email": "devtools-dev@chromium.org"
   },
   "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"
     }
   ]

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "chrome-devtools-mcp",
-  "version": "latest",
+  "version": "0.20.3",
   "description": "Reliable automation, in-depth debugging, and performance analysis in Chrome using Chrome DevTools and Puppeteer",
   "mcpServers": {
     "chrome-devtools": {

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

.github/ISSUE_TEMPLATE/01-bug.yml

@@ -34,12 +34,12 @@ body:
     attributes:
       label: MCP configuration
 
-  - id: node-version
+  - id: chrome-devtools-mcp-version
     type: input
     attributes:
-      label: Node version
-      description: >
-        Please verify you have the minimal supported version listed in the README.md
+      label: Chrome DevTools MCP version
+    validations:
+      required: true
 
   - id: chrome-version
     type: input
@@ -61,13 +61,21 @@ body:
     attributes:
       label: Chat log
 
+  - id: node-version
+    type: input
+    attributes:
+      label: Node version
+      description: >
+        Please verify you have the minimal supported version listed in the README.md
+
   - id: operating-system
     type: dropdown
     attributes:
       label: Operating system
       description: What supported operating system are you running?
       options:
         - Windows
+        - Windows Subsystem for Linux (WSL)
         - macOS
         - Linux
 

.github/ISSUE_TEMPLATE/02-feature.yml

@@ -3,7 +3,7 @@ description: Suggest an idea for for chrome-devtools-mcp
 title: '<short description of the feature request>'
 type: 'Feature'
 labels:
-  - enhancement
+  - feature
 body:
   - id: description
     type: textarea

.github/ISSUE_TEMPLATE/03-task.yml

@@ -0,0 +1,17 @@
+name: Task
+description: Work tracking for mainainers only!
+title: '[Task]:'
+type: 'Task'
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ### This issue type should be used only by mainainers!
+        Task are to track small non user facing issue or improvements. 
+        The issue will be closed if it does not follow those rules.
+  - type: textarea
+    attributes:
+      label: 'Task to do:'
+    id: task
+    validations:
+      required: true

.github/dependabot.yml

@@ -10,23 +10,30 @@ updates:
     groups:
       dependencies:
         dependency-type: production
-        exclude-patterns:
-          - 'puppeteer*'
-          - 'chrome-devtools-frontend'
         patterns:
           - '*'
       dev-dependencies:
         dependency-type: development
         exclude-patterns:
           - 'puppeteer*'
+          - 'chrome-devtools-frontend'
+          - '@modelcontextprotocol/sdk'
+          - 'yargs'
+          - 'debug'
+          - 'core-js'
         patterns:
           - '*'
-      puppeteer:
-        patterns:
-          - 'puppeteer*'
-      chrome-devtools-frontend:
+      # breaks often so better to roll separetely.
+      bundled-devtools:
         patterns:
           - 'chrome-devtools-frontend'
+      bundled:
+        patterns:
+          - 'puppeteer*'
+          - '@modelcontextprotocol/sdk'
+          - 'yargs'
+          - 'debug'
+          - 'core-js'
   - package-ecosystem: github-actions
     directory: /
     schedule:

.github/workflows/convetional-commit.yml → .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,30 +3,42 @@ name: Pre-release
 permissions: read-all
 
 on:
+  workflow_dispatch:
   push:
     branches:
       - release-please-*
 
 jobs:
   pre-release:
-    name: 'Verify MCP server schema unchanged'
+    name: 'Verify artifacts before release'
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           cache: npm
           node-version-file: '.nvmrc'
+          registry-url: 'https://registry.npmjs.org'
 
-      - 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
+      # Ensure npm 11.5.1 or later is installed
+      - name: Update npm
+        run: npm install -g npm@latest
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build and bundle
+        run: npm run bundle
+        env:
+          NODE_ENV: 'production'
 
       - name: Verify server.json
         run: npm run verify-server-json-version
+
+      - name: Verify npm package
+        run: npm run verify-npm-package

.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@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           cache: npm
           node-version-file: '.nvmrc'
@@ -37,28 +38,28 @@ jobs:
 
     steps:
       - name: Check out repository
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           cache: npm
           node-version-file: '.nvmrc'
 
       - name: Install dependencies
         run: npm ci
 
-      - name: Generate documents
-        run: npm run docs
+      - name: Generate
+        run: npm run gen
 
-      - name: Check if autogenerated docs differ
+      - name: Check if autogenerated code and docs are out of date
         run: |
           diff_file=$(mktemp doc_diff_XXXXXX)
           git diff --color > $diff_file
           if [[ -s $diff_file ]]; then
-            echo "Please update the documentation by running 'npm run generate-docs'. The following was the diff"
+            echo "Please update the documentation by running 'npm run gen'. The following was the diff"
             cat $diff_file
             rm $diff_file
             exit 1

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

@@ -25,12 +25,12 @@ jobs:
     if: ${{ (github.event_name != 'workflow_dispatch') || (inputs.npm-publish && always()) }}
     steps:
       - name: Check out repository
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           cache: npm
           node-version-file: '.nvmrc'
@@ -43,8 +43,8 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Build
-        run: npm run build
+      - name: Build and bundle
+        run: npm run bundle
         env:
           NODE_ENV: 'production'
 
@@ -58,12 +58,12 @@ jobs:
     if: ${{ (github.event_name != 'workflow_dispatch' && needs.publish-to-npm.result == 'success') || (inputs.mcp-publish && always()) }}
     steps:
       - name: Check out repository
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           cache: npm
           node-version-file: '.nvmrc'
@@ -76,8 +76,8 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Build
-        run: npm run build
+      - name: Build and bundle
+        run: npm run bundle
         env:
           NODE_ENV: 'production'
 

.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@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
         with:
           fetch-depth: 2
 
       - name: Set up Node.js
-        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           cache: npm
           node-version: 22 # build works only with 22+.
@@ -41,10 +42,12 @@ jobs:
         run: npm ci
 
       - name: Build
-        run: npm run build
+        run: npm run bundle
+        env:
+          NODE_OPTIONS: '--max_old_space_size=4096'
 
       - name: Set up Node.js
-        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
         with:
           cache: npm
           node-version: ${{ matrix.node }}
@@ -54,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
+        # 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: