@extension.dev/mcp 4.2.0 → 4.2.1

package/dist/module.js

@@ -9,8 +9,8 @@ import node_os from "node:os";
 import { extensionBuild } from "extension-develop";
 import cross_spawn from "cross-spawn";
 import { filterKeysForThisBrowser } from "browser-extension-manifest-fields";
-import node_net from "node:net";
 import ws from "ws";
+import node_http from "node:http";
 import { clearCredentials, exchangeAndPersist, fetchLoginConfig, pollForToken, publish, readCredentials, resolveApiBase, resolveToken, safeApiBase, startDeviceCode } from "@extension.dev/core";
 import { extensionInstall, getManagedBrowsersCacheRoot } from "extension-install";
 import { execFile } from "node:child_process";
@@ -183,7 +183,7 @@ __webpack_require__.d(whoami_namespaceObject, {
     handler: ()=>whoami_handler,
     schema: ()=>whoami_schema
 });
-var package_namespaceObject = JSON.parse('{"rE":"4.2.0","El":{"OP":"^4.0.8"}}');
+var package_namespaceObject = JSON.parse('{"rE":"4.2.1","El":{"OP":"^4.0.8"}}');
 const create_schema = {
     name: "extension_create",
     description: "Create a new browser extension project from a template in the extension.dev template catalog. Use extension_list_templates to see available options.",
@@ -401,7 +401,8 @@ async function build_handler(args) {
         const summary = await extensionBuild(args.projectPath, {
             browser: args.browser ?? "chrome",
             zip: args.zip ?? false,
-            zipSource: args.zipSource ?? false
+            zipSource: args.zipSource ?? false,
+            exitOnError: false
         });
         return JSON.stringify({
             success: true,
@@ -417,6 +418,10 @@ async function build_handler(args) {
     }
 }
 const PINNED_CLI_VERSION = String(package_namespaceObject.El.OP ?? "latest").replace(/^[\^~]/, "");
+function pinnedCliVersion() {
+    const override = String(process.env.EXTENSION_MCP_CLI_VERSION || "").trim();
+    return override || PINNED_CLI_VERSION;
+}
 function resolveExtensionInvocation(projectDir) {
     if (projectDir) {
         const bin = node_path.join(projectDir, "node_modules", ".bin", "win32" === process.platform ? "extension.cmd" : "extension");
@@ -431,7 +436,7 @@ function resolveExtensionInvocation(projectDir) {
     return {
         command: "npx",
         prefixArgs: [
-            `extension@${PINNED_CLI_VERSION}`
+            `extension@${pinnedCliVersion()}`
         ]
     };
 }
@@ -1571,6 +1576,50 @@ class CDPClient extends CDPConnection {
         return result ?? null;
     }
 }
+async function resolveCdpPort(projectPath, browser, options) {
+    const waitMs = options?.waitMs ?? 20000;
+    const readyPath = node_path.resolve(projectPath, "dist", "extension-js", browser, "ready.json");
+    const deadline = Date.now() + waitMs;
+    let contractSeen = false;
+    for(;;){
+        try {
+            const contract = JSON.parse(node_fs.readFileSync(readyPath, "utf8"));
+            contractSeen = true;
+            if ("number" == typeof contract.cdpPort) return {
+                port: contract.cdpPort,
+                source: "contract"
+            };
+        } catch  {
+            if (!contractSeen) break;
+        }
+        if (Date.now() >= deadline) break;
+        await new Promise((resolve)=>setTimeout(resolve, 500));
+    }
+    if (!contractSeen && await isCdpEndpoint(9222)) return {
+        port: 9222,
+        source: "default-probe"
+    };
+    return null;
+}
+const CDP_PORT_MISSING_HINT = "The session's ready contract has no CDP port (the browser may still be binding its debug port, or was launched without one). Confirm the session with extension_wait, give it a moment, and retry.";
+function isCdpEndpoint(port) {
+    return new Promise((resolve)=>{
+        const req = node_http.get({
+            host: "127.0.0.1",
+            port,
+            path: "/json/version",
+            timeout: 1000
+        }, (res)=>{
+            res.resume();
+            resolve(200 === res.statusCode);
+        });
+        req.on("error", ()=>resolve(false));
+        req.on("timeout", ()=>{
+            req.destroy();
+            resolve(false);
+        });
+    });
+}
 const source_inspect_schema = {
     name: "extension_source_inspect",
     description: "Inspect a running extension's live state via Chrome DevTools Protocol: full HTML (with shadow DOM), DOM structure, content script injection, console messages, and CSS selector queries. Requires an active dev or start session.",
@@ -1632,28 +1681,6 @@ const source_inspect_schema = {
         ]
     }
 };
-async function findCdpPort(projectPath, browser) {
-    const readyPath = node_path.resolve(projectPath, "dist", "extension-js", browser, "ready.json");
-    try {
-        const contract = JSON.parse(node_fs.readFileSync(readyPath, "utf8"));
-        if ("number" == typeof contract.cdpPort) return contract.cdpPort;
-    } catch  {}
-    const defaultPort = 9222;
-    return new Promise((resolve)=>{
-        const socket = new node_net.Socket();
-        socket.setTimeout(1000);
-        socket.on("connect", ()=>{
-            socket.destroy();
-            resolve(defaultPort);
-        });
-        socket.on("error", ()=>resolve(null));
-        socket.on("timeout", ()=>{
-            socket.destroy();
-            resolve(null);
-        });
-        socket.connect(defaultPort, "127.0.0.1");
-    });
-}
 async function source_inspect_handler(args) {
     const browser = args.browser ?? "chrome";
     const include = new Set(args.include ?? [
@@ -1671,11 +1698,12 @@ async function source_inspect_handler(args) {
         error: `Source inspection for ${browser} uses RDP (Remote Debug Protocol). Currently only Chromium CDP is supported.`,
         hint: "Use --browser=chrome for source inspection, or use the CLI: npx extension dev --source"
     });
-    const cdpPort = await findCdpPort(args.projectPath, browser);
-    if (!cdpPort) return JSON.stringify({
+    const resolved = await resolveCdpPort(args.projectPath, browser);
+    if (!resolved) return JSON.stringify({
         error: "No active dev session found. Cannot connect to Chrome DevTools Protocol.",
-        hint: "Start a dev session first with extension_dev, then use extension_wait to confirm it is ready."
+        hint: `Start a dev session first with extension_dev, then use extension_wait to confirm it is ready. ${CDP_PORT_MISSING_HINT}`
     });
+    const cdpPort = resolved.port;
     const cdp = new CDPClient();
     try {
         const allTargets = await CDPClient.discoverTargets(cdpPort);
@@ -1788,16 +1816,27 @@ async function list_extensions_handler(args) {
         error: `Listing extensions for ${browser} uses RDP (Remote Debug Protocol). Currently only Chromium CDP is supported.`,
         hint: "Use --browser=chrome."
     });
-    const cdpPort = await list_extensions_findCdpPort(args.projectPath, browser);
-    if (!cdpPort) return JSON.stringify({
+    const resolved = await resolveCdpPort(args.projectPath, browser);
+    if (!resolved) return JSON.stringify({
         error: "No active dev session found. Cannot connect to Chrome DevTools Protocol.",
-        hint: "Start a dev session first with extension_dev, then use extension_wait to confirm it is ready."
+        hint: `Start a dev session first with extension_dev, then use extension_wait to confirm it is ready. ${CDP_PORT_MISSING_HINT}`
     });
+    const cdpPort = resolved.port;
     const cdp = new CDPClient();
     try {
-        const browserWsUrl = await CDPClient.discoverBrowserWsUrl(cdpPort);
-        await cdp.connect(browserWsUrl);
-        const targets = await cdp.getTargets();
+        let targets = null;
+        let lastError = null;
+        for(let attempt = 0; attempt < 3; attempt++)try {
+            const browserWsUrl = await CDPClient.discoverBrowserWsUrl(cdpPort);
+            await cdp.connect(browserWsUrl);
+            targets = await cdp.getTargets();
+            break;
+        } catch (error) {
+            lastError = error;
+            cdp.disconnect();
+            if (attempt < 2) await new Promise((resolve)=>setTimeout(resolve, 800));
+        }
+        if (!targets) throw lastError;
         const byId = new Map();
         for (const t of targets){
             const url = String(t.url ?? "");
@@ -1849,28 +1888,6 @@ async function list_extensions_handler(args) {
         cdp.disconnect();
     }
 }
-async function list_extensions_findCdpPort(projectPath, browser) {
-    const readyPath = node_path.resolve(projectPath, "dist", "extension-js", browser, "ready.json");
-    try {
-        const contract = JSON.parse(node_fs.readFileSync(readyPath, "utf8"));
-        if ("number" == typeof contract.cdpPort) return contract.cdpPort;
-    } catch  {}
-    const defaultPort = 9222;
-    return new Promise((resolve)=>{
-        const socket = new node_net.Socket();
-        socket.setTimeout(1000);
-        socket.on("connect", ()=>{
-            socket.destroy();
-            resolve(defaultPort);
-        });
-        socket.on("error", ()=>resolve(null));
-        socket.on("timeout", ()=>{
-            socket.destroy();
-            resolve(null);
-        });
-        socket.connect(defaultPort, "127.0.0.1");
-    });
-}
 const CONTROL_WS_PATH = "/extjs-control";
 const LEVEL_ORDER = [
     "error",

package/dist/src/lib/cdp-port.d.ts

@@ -0,0 +1,7 @@
+export declare function resolveCdpPort(projectPath: string, browser: string, options?: {
+    waitMs?: number;
+}): Promise<{
+    port: number;
+    source: "contract" | "default-probe";
+} | null>;
+export declare const CDP_PORT_MISSING_HINT = "The session's ready contract has no CDP port (the browser may still be binding its debug port, or was launched without one). Confirm the session with extension_wait, give it a moment, and retry.";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "description": "MCP server that lets AI agents build, run, inspect, and publish browser extensions. 28 tools for scaffolding, live DOM inspection, log streaming, and store-ready builds across Chrome, Edge, and Firefox.",
   "license": "MIT",
   "author": {
@@ -20,6 +20,7 @@
   "engines": {
     "node": ">=20.18"
   },
+  "packageManager": "pnpm@10.19.0",
   "exports": {
     ".": {
       "types": "./dist/module.d.ts",
@@ -39,6 +40,15 @@
     "CHANGELOG.md",
     "LICENSE"
   ],
+  "scripts": {
+    "clean": "rm -rf dist",
+    "watch": "rslib build --watch",
+    "compile": "rslib build",
+    "build": "pnpm run compile",
+    "start": "node bin/extension-mcp.js",
+    "test": "vitest run",
+    "prepublishOnly": "pnpm run test && pnpm run compile"
+  },
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org"
@@ -77,13 +87,5 @@
     "@types/ws": "^8.18.1",
     "typescript": "6.0.2",
     "vitest": "^4.1.3"
-  },
-  "scripts": {
-    "clean": "rm -rf dist",
-    "watch": "rslib build --watch",
-    "compile": "rslib build",
-    "build": "pnpm run compile",
-    "start": "node bin/extension-mcp.js",
-    "test": "vitest run"
   }
-}
+}