chore: bump version to 0.4.2

.github/workflows/update-snapshots.yml

@@ -7,23 +7,50 @@ on:
         description: "Branch to update snapshots on"
         required: true
         default: "main"
-  # Temporary: auto-run on this branch to update snapshots
-  push:
-    branches:
-      - "ochafik/fix-e2e-flaky-tests"
-    paths:
-      - ".github/workflows/update-snapshots.yml"
+  issue_comment:
+    types: [created]
 
 permissions:
   contents: write
+  pull-requests: write
 
 jobs:
   update-snapshots:
+    # Run on workflow_dispatch OR when someone comments "/update-snapshots" on a PR
+    if: >
+      github.event_name == 'workflow_dispatch' ||
+      (github.event.issue.pull_request && contains(github.event.comment.body, '/update-snapshots'))
     runs-on: ubuntu-latest
     steps:
+      - name: Get PR branch
+        if: github.event_name == 'issue_comment'
+        id: pr
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const pr = await github.rest.pulls.get({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              pull_number: context.issue.number
+            });
+            core.setOutput('ref', pr.data.head.ref);
+            core.setOutput('sha', pr.data.head.sha);
+
+      - name: Add reaction to comment
+        if: github.event_name == 'issue_comment'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.reactions.createForIssueComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: context.payload.comment.id,
+              content: 'rocket'
+            });
+
       - uses: actions/checkout@v4
         with:
-          ref: ${{ github.event.inputs.branch || github.ref }}
+          ref: ${{ github.event.inputs.branch || steps.pr.outputs.ref || github.ref }}
           token: ${{ secrets.GITHUB_TOKEN }}
 
       - uses: oven-sh/setup-bun@v2
@@ -45,9 +72,32 @@ jobs:
         run: npx playwright test --update-snapshots --reporter=list
 
       - name: Commit updated snapshots
+        id: commit
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
           git add tests/e2e/**/*.png
-          git diff --staged --quiet || git commit -m "chore: update e2e snapshots [skip ci]"
-          git push
+          if git diff --staged --quiet; then
+            echo "changed=false" >> $GITHUB_OUTPUT
+            echo "No snapshot changes to commit"
+          else
+            git commit -m "chore: update e2e snapshots [skip ci]"
+            git push
+            echo "changed=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Comment on PR
+        if: github.event_name == 'issue_comment'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const changed = '${{ steps.commit.outputs.changed }}' === 'true';
+            const body = changed
+              ? '✅ Snapshots updated and pushed to this branch.'
+              : '✅ No snapshot changes needed - all snapshots are up to date.';
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body
+            });

CONTRIBUTING.md

@@ -79,6 +79,16 @@ npm run test:e2e:update -- --grep "Three.js"
 
 **Note**: Golden screenshots are platform-agnostic. Tests use canvas masking and tolerance thresholds to handle minor cross-platform rendering differences.
 
+#### Updating Snapshots in CI
+
+If E2E tests fail in CI due to screenshot mismatches, you can update snapshots directly from your PR:
+
+1. Comment `/update-snapshots` on the PR
+2. The workflow will update snapshots and push to your branch
+3. A comment will confirm when complete
+
+Alternatively, use the [workflow dispatch](https://github.com/modelcontextprotocol/ext-apps/actions/workflows/update-snapshots.yml) to manually trigger updates for any branch.
+
 ## Code of Conduct
 
 This project follows our [Code of Conduct](CODE_OF_CONDUCT.md). Please review it before contributing.

examples/basic-host/package.json

@@ -1,7 +1,7 @@
 {
   "homepage": "https://github.com/modelcontextprotocol/ext-apps/tree/main/examples/basic-host",
   "name": "@modelcontextprotocol/ext-apps-basic-host",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "scripts": {
     "build": "tsc --noEmit && concurrently \"cross-env INPUT=index.html vite build\" \"cross-env INPUT=sandbox.html vite build\"",
@@ -11,15 +11,15 @@
     "dev": "cross-env NODE_ENV=development concurrently \"npm run watch\" \"npm run serve\""
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
     "zod": "^4.1.13"
   },
   "devDependencies": {
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "@vitejs/plugin-react": "^4.3.4",

examples/basic-server-preact/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-basic-preact",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Basic MCP App Server example using Preact",
   "repository": {
@@ -22,7 +22,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
@@ -33,7 +33,7 @@
     "@preact/preset-vite": "^2.0.0",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
     "typescript": "^5.9.3",

examples/basic-server-react/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-basic-react",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Basic MCP App Server example using React",
   "repository": {
@@ -32,7 +32,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
@@ -43,7 +43,7 @@
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "@vitejs/plugin-react": "^4.3.4",

examples/basic-server-solid/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-basic-solid",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Basic MCP App Server example using Solid",
   "repository": {
@@ -22,7 +22,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
@@ -32,7 +32,7 @@
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
     "typescript": "^5.9.3",

examples/basic-server-svelte/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-basic-svelte",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Basic MCP App Server example using Svelte",
   "repository": {
@@ -22,7 +22,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
@@ -33,7 +33,7 @@
     "@sveltejs/vite-plugin-svelte": "^5.0.0",
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
     "typescript": "^5.9.3",

examples/basic-server-vanillajs/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-basic-vanillajs",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Basic MCP App Server example using vanilla JavaScript",
   "repository": {
@@ -22,7 +22,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
@@ -31,7 +31,7 @@
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
     "typescript": "^5.9.3",

examples/basic-server-vue/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-basic-vue",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Basic MCP App Server example using Vue",
   "repository": {
@@ -22,7 +22,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
@@ -32,7 +32,7 @@
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "@vitejs/plugin-vue": "^5.0.0",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",

examples/budget-allocator-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-budget-allocator",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Budget allocator MCP App Server with interactive visualization",
   "repository": {
@@ -26,7 +26,7 @@
     "serve": "bun --watch main.ts"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "chart.js": "^4.4.0",
     "cors": "^2.8.5",
@@ -36,7 +36,7 @@
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
     "typescript": "^5.9.3",

examples/cohort-heatmap-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-cohort-heatmap",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Cohort heatmap MCP App Server for retention analysis",
   "repository": {
@@ -26,7 +26,7 @@
     "serve": "bun --watch main.ts"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "cors": "^2.8.5",
     "express": "^5.1.0",
@@ -37,7 +37,7 @@
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "@types/react": "^19.2.2",
     "@types/react-dom": "^19.2.2",
     "@vitejs/plugin-react": "^4.3.4",

examples/customer-segmentation-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-customer-segmentation",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Customer segmentation MCP App Server with filtering",
   "repository": {
@@ -26,7 +26,7 @@
     "serve": "bun --watch main.ts"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "chart.js": "^4.4.0",
     "cors": "^2.8.5",
@@ -36,7 +36,7 @@
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "concurrently": "^9.2.1",
     "cross-env": "^10.1.0",
     "typescript": "^5.9.3",

examples/debug-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@modelcontextprotocol/server-debug",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "description": "Debug MCP App Server for testing all SDK capabilities",
   "repository": {
@@ -23,14 +23,14 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@modelcontextprotocol/ext-apps": "^0.4.1",
+    "@modelcontextprotocol/ext-apps": "../..",
     "@modelcontextprotocol/sdk": "^1.24.0",
     "zod": "^4.1.13"
   },
   "devDependencies": {
     "@types/cors": "^2.8.19",
     "@types/express": "^5.0.0",
-    "@types/node": "^22.0.0",
+    "@types/node": "22.10.0",
     "concurrently": "^9.2.1",
     "cors": "^2.8.5",
     "cross-env": "^10.1.0",