@extension.dev/mcp 4.3.0 → 4.4.0

package/dist/module.js

@@ -12,7 +12,7 @@ import { filterKeysForThisBrowser } from "browser-extension-manifest-fields";
 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 { extensionInstall, extensionUninstall, getManagedBrowsersCacheRoot } from "extension-install";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 var add_feature_namespaceObject = {};
@@ -177,6 +177,12 @@ __webpack_require__.d(storage_namespaceObject, {
     handler: ()=>storage_handler,
     schema: ()=>storage_schema
 });
+var uninstall_browser_namespaceObject = {};
+__webpack_require__.r(uninstall_browser_namespaceObject);
+__webpack_require__.d(uninstall_browser_namespaceObject, {
+    handler: ()=>uninstall_browser_handler,
+    schema: ()=>uninstall_browser_schema
+});
 var wait_namespaceObject = {};
 __webpack_require__.r(wait_namespaceObject);
 __webpack_require__.d(wait_namespaceObject, {
@@ -189,7 +195,7 @@ __webpack_require__.d(whoami_namespaceObject, {
     handler: ()=>whoami_handler,
     schema: ()=>whoami_schema
 });
-var package_namespaceObject = JSON.parse('{"rE":"4.3.0","El":{"OP":"^4.0.8"}}');
+var package_namespaceObject = JSON.parse('{"rE":"4.4.0","El":{"OP":"^4.0.11"}}');
 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.",
@@ -379,9 +385,18 @@ const build_schema = {
                     "chrome",
                     "chromium",
                     "edge",
+                    "brave",
+                    "opera",
+                    "vivaldi",
+                    "yandex",
                     "firefox",
+                    "waterfox",
+                    "librewolf",
+                    "safari",
                     "chromium-based",
-                    "gecko-based"
+                    "gecko-based",
+                    "firefox-based",
+                    "webkit-based"
                 ],
                 default: "chrome",
                 description: "Target browser"
@@ -395,6 +410,30 @@ const build_schema = {
                 type: "boolean",
                 default: false,
                 description: "Include source code zip (required by some stores)"
+            },
+            zipFilename: {
+                type: "string",
+                description: "Custom .zip file name (defaults to name and version)"
+            },
+            polyfill: {
+                type: "boolean",
+                default: false,
+                description: "Apply cross-browser polyfill"
+            },
+            silent: {
+                type: "boolean",
+                default: false,
+                description: "Suppress build output"
+            },
+            mode: {
+                type: "string",
+                enum: [
+                    "development",
+                    "production",
+                    "none"
+                ],
+                default: "production",
+                description: "Bundler mode override (also sets NODE_ENV)"
             }
         },
         required: [
@@ -409,6 +448,18 @@ async function build_handler(args) {
             browser: args.browser ?? "chrome",
             zip: args.zip ?? false,
             zipSource: args.zipSource ?? false,
+            ...args.zipFilename ? {
+                zipFilename: args.zipFilename
+            } : {},
+            ...void 0 !== args.polyfill ? {
+                polyfill: args.polyfill
+            } : {},
+            ...void 0 !== args.silent ? {
+                silent: args.silent
+            } : {},
+            ...args.mode ? {
+                mode: args.mode
+            } : {},
             exitOnError: false
         });
         return JSON.stringify({
@@ -521,6 +572,50 @@ function removeSession(projectPath, browser) {
 function listSessions() {
     return Array.from(process_manager_sessions.values());
 }
+const LAUNCH_FLAG_SCHEMA = {
+    profile: {
+        type: "string",
+        description: 'Browser profile path, or "false" to reuse the default user profile. Omit for a fresh throwaway profile.'
+    },
+    startingUrl: {
+        type: "string",
+        description: "URL the browser opens on launch"
+    },
+    chromiumBinary: {
+        type: "string",
+        description: "Path to a custom Chromium-based binary (overrides browser)"
+    },
+    geckoBinary: {
+        type: "string",
+        description: "Path to a custom Gecko/Firefox binary (overrides browser)"
+    },
+    host: {
+        type: "string",
+        description: "Dev server bind host. Use 0.0.0.0 for Docker or devcontainers. Defaults to 127.0.0.1"
+    },
+    publicHost: {
+        type: "string",
+        description: "Connectable host the browser dials for HMR and reload when it differs from the bind host"
+    },
+    extensions: {
+        type: "array",
+        items: {
+            type: "string"
+        },
+        description: "Companion extension paths or store URLs to load alongside the project"
+    }
+};
+function launchFlagArgs(args) {
+    const cli = [];
+    if (void 0 !== args.profile) cli.push("--profile", args.profile);
+    if (args.startingUrl) cli.push("--starting-url", args.startingUrl);
+    if (args.chromiumBinary) cli.push("--chromium-binary", args.chromiumBinary);
+    if (args.geckoBinary) cli.push("--gecko-binary", args.geckoBinary);
+    if (args.host) cli.push("--host", args.host);
+    if (args.publicHost) cli.push("--public-host", args.publicHost);
+    if (args.extensions?.length) cli.push("--extensions", args.extensions.join(","));
+    return cli;
+}
 const dev_schema = {
     name: "extension_dev",
     description: "Start the extension development server with hot module replacement. Launches a browser with the extension loaded. Returns process info for use with extension_wait and extension_source_inspect.",
@@ -537,9 +632,18 @@ const dev_schema = {
                     "chrome",
                     "chromium",
                     "edge",
+                    "brave",
+                    "opera",
+                    "vivaldi",
+                    "yandex",
                     "firefox",
+                    "waterfox",
+                    "librewolf",
+                    "safari",
                     "chromium-based",
-                    "gecko-based"
+                    "gecko-based",
+                    "firefox-based",
+                    "webkit-based"
                 ],
                 default: "chrome"
             },
@@ -552,6 +656,12 @@ const dev_schema = {
                 default: false,
                 description: "Start dev server without launching browser"
             },
+            polyfill: {
+                type: "boolean",
+                default: true,
+                description: "Apply cross-browser polyfill"
+            },
+            ...LAUNCH_FLAG_SCHEMA,
             allowControl: {
                 type: "boolean",
                 default: false,
@@ -578,6 +688,8 @@ async function dev_handler(args) {
     ];
     if (void 0 !== args.port) cliArgs.push("--port", String(args.port));
     if (args.noBrowser) cliArgs.push("--no-browser");
+    if (false === args.polyfill) cliArgs.push("--polyfill", "false");
+    cliArgs.push(...launchFlagArgs(args));
     if (args.allowControl) cliArgs.push("--allow-control");
     if (args.allowEval) cliArgs.push("--allow-eval");
     const child = spawnExtensionCli(cliArgs, {
@@ -627,9 +739,18 @@ const start_schema = {
                     "chrome",
                     "chromium",
                     "edge",
+                    "brave",
+                    "opera",
+                    "vivaldi",
+                    "yandex",
                     "firefox",
+                    "waterfox",
+                    "librewolf",
+                    "safari",
                     "chromium-based",
-                    "gecko-based"
+                    "gecko-based",
+                    "firefox-based",
+                    "webkit-based"
                 ],
                 default: "chrome"
             },
@@ -637,7 +758,17 @@ const start_schema = {
                 type: "boolean",
                 default: true,
                 description: "Apply cross-browser polyfill"
-            }
+            },
+            port: {
+                type: "number",
+                description: "Server port (0 for auto-assign)"
+            },
+            noBrowser: {
+                type: "boolean",
+                default: false,
+                description: "Build and serve without launching a browser"
+            },
+            ...LAUNCH_FLAG_SCHEMA
         },
         required: [
             "projectPath"
@@ -652,7 +783,10 @@ async function start_handler(args) {
         "--browser",
         browser
     ];
-    if (false === args.polyfill) cliArgs.push("--no-polyfill");
+    if (false === args.polyfill) cliArgs.push("--polyfill", "false");
+    if (void 0 !== args.port) cliArgs.push("--port", String(args.port));
+    if (args.noBrowser) cliArgs.push("--no-browser");
+    cliArgs.push(...launchFlagArgs(args));
     const child = spawnExtensionCli(cliArgs, {
         projectDir: args.projectPath
     });
@@ -698,12 +832,31 @@ const preview_schema = {
                     "chrome",
                     "chromium",
                     "edge",
+                    "brave",
+                    "opera",
+                    "vivaldi",
+                    "yandex",
                     "firefox",
+                    "waterfox",
+                    "librewolf",
+                    "safari",
                     "chromium-based",
-                    "gecko-based"
+                    "gecko-based",
+                    "firefox-based",
+                    "webkit-based"
                 ],
                 default: "chrome"
-            }
+            },
+            port: {
+                type: "number",
+                description: "Server port (0 for auto-assign)"
+            },
+            noBrowser: {
+                type: "boolean",
+                default: false,
+                description: "Serve the preview without launching a browser"
+            },
+            ...LAUNCH_FLAG_SCHEMA
         },
         required: [
             "projectPath"
@@ -718,6 +871,9 @@ async function preview_handler(args) {
         "--browser",
         browser
     ];
+    if (void 0 !== args.port) cliArgs.push("--port", String(args.port));
+    if (args.noBrowser) cliArgs.push("--no-browser");
+    cliArgs.push(...launchFlagArgs(args));
     const child = spawnExtensionCli(cliArgs, {
         projectDir: args.projectPath
     });
@@ -916,13 +1072,23 @@ const CHROMIUM_FAMILY = new Set([
     "chrome",
     "chromium",
     "edge",
+    "brave",
+    "opera",
+    "vivaldi",
+    "yandex",
     "chromium-based"
 ]);
 const GECKO_FAMILY = new Set([
     "firefox",
+    "waterfox",
+    "librewolf",
     "gecko-based",
     "firefox-based"
 ]);
+const WEBKIT_FAMILY = new Set([
+    "safari",
+    "webkit-based"
+]);
 function isChromiumFamily(browser) {
     return CHROMIUM_FAMILY.has(browser);
 }
@@ -2832,7 +2998,7 @@ async function wait_handler(args) {
 }
 const add_feature_schema = {
     name: "extension_add_feature",
-    description: "Add a new feature surface to an existing extension. Generates the required files and updates manifest.json. Sources patterns from the extension.dev template catalog.",
+    description: "Plan a new feature surface for an existing extension. Returns step-by-step instructions, the manifest additions to make, and reference templates from the extension.dev catalog. Does not modify files; apply the returned plan yourself.",
     inputSchema: {
         type: "object",
         properties: {
@@ -3268,6 +3434,57 @@ async function install_browser_handler(args) {
         });
     }
 }
+const uninstall_browser_schema = {
+    name: "extension_uninstall_browser",
+    description: "Remove a managed browser binary from the Extension.js cache. Only touches the managed cache, never system-installed browsers.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            browser: {
+                type: "string",
+                enum: [
+                    "chrome",
+                    "chromium",
+                    "edge",
+                    "firefox"
+                ],
+                description: "Managed browser to remove"
+            },
+            all: {
+                type: "boolean",
+                default: false,
+                description: "Remove every managed browser binary"
+            }
+        },
+        required: []
+    }
+};
+async function uninstall_browser_handler(args) {
+    const start = Date.now();
+    if (!args.browser && !args.all) return JSON.stringify({
+        status: "error",
+        message: "Provide a browser to remove, or set all: true."
+    });
+    try {
+        await extensionUninstall({
+            browser: args.browser,
+            all: args.all
+        });
+        return JSON.stringify({
+            status: "uninstalled",
+            target: args.all ? "all" : args.browser,
+            duration: Date.now() - start,
+            hint: "Use extension_list_browsers to confirm what remains in the managed cache."
+        });
+    } catch (err) {
+        return JSON.stringify({
+            status: "error",
+            target: args.all ? "all" : args.browser,
+            message: err instanceof Error ? err.message : String(err),
+            duration: Date.now() - start
+        });
+    }
+}
 const list_browsers_schema = {
     name: "extension_list_browsers",
     description: "List managed browser binaries installed by the extension.dev platform. Shows what browsers are available in the managed cache without checking system-installed browsers.",
@@ -3341,7 +3558,14 @@ const detect_browsers_schema = {
                         "chrome",
                         "chromium",
                         "edge",
-                        "firefox"
+                        "brave",
+                        "opera",
+                        "vivaldi",
+                        "yandex",
+                        "firefox",
+                        "waterfox",
+                        "librewolf",
+                        "safari"
                     ]
                 },
                 description: "Browsers to check. If omitted, checks all."
@@ -3353,8 +3577,21 @@ const ALL_BROWSERS = [
     "chrome",
     "chromium",
     "edge",
-    "firefox"
+    "brave",
+    "opera",
+    "vivaldi",
+    "yandex",
+    "firefox",
+    "waterfox",
+    "librewolf",
+    "safari"
 ];
+const MANAGED_INSTALLABLE = new Set([
+    "chrome",
+    "chromium",
+    "edge",
+    "firefox"
+]);
 const SYSTEM_PATHS = {
     darwin: {
         chrome: [
@@ -3372,6 +3609,33 @@ const SYSTEM_PATHS = {
         firefox: [
             "/Applications/Firefox.app/Contents/MacOS/firefox",
             `${process.env.HOME}/Applications/Firefox.app/Contents/MacOS/firefox`
+        ],
+        brave: [
+            "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
+            `${process.env.HOME}/Applications/Brave Browser.app/Contents/MacOS/Brave Browser`
+        ],
+        opera: [
+            "/Applications/Opera.app/Contents/MacOS/Opera",
+            `${process.env.HOME}/Applications/Opera.app/Contents/MacOS/Opera`
+        ],
+        vivaldi: [
+            "/Applications/Vivaldi.app/Contents/MacOS/Vivaldi",
+            `${process.env.HOME}/Applications/Vivaldi.app/Contents/MacOS/Vivaldi`
+        ],
+        yandex: [
+            "/Applications/Yandex.app/Contents/MacOS/Yandex",
+            `${process.env.HOME}/Applications/Yandex.app/Contents/MacOS/Yandex`
+        ],
+        waterfox: [
+            "/Applications/Waterfox.app/Contents/MacOS/waterfox",
+            `${process.env.HOME}/Applications/Waterfox.app/Contents/MacOS/waterfox`
+        ],
+        librewolf: [
+            "/Applications/LibreWolf.app/Contents/MacOS/librewolf",
+            `${process.env.HOME}/Applications/LibreWolf.app/Contents/MacOS/librewolf`
+        ],
+        safari: [
+            "/Applications/Safari.app/Contents/MacOS/Safari"
         ]
     },
     linux: {
@@ -3394,6 +3658,31 @@ const SYSTEM_PATHS = {
             "/usr/bin/firefox",
             "/snap/bin/firefox",
             "/usr/lib/firefox/firefox"
+        ],
+        brave: [
+            "/usr/bin/brave-browser",
+            "/usr/bin/brave",
+            "/snap/bin/brave"
+        ],
+        opera: [
+            "/usr/bin/opera",
+            "/snap/bin/opera"
+        ],
+        vivaldi: [
+            "/usr/bin/vivaldi",
+            "/usr/bin/vivaldi-stable"
+        ],
+        yandex: [
+            "/usr/bin/yandex-browser",
+            "/usr/bin/yandex-browser-stable"
+        ],
+        waterfox: [
+            "/usr/bin/waterfox",
+            "/opt/waterfox/waterfox"
+        ],
+        librewolf: [
+            "/usr/bin/librewolf",
+            "/opt/librewolf/librewolf"
         ]
     },
     win32: {
@@ -3411,6 +3700,30 @@ const SYSTEM_PATHS = {
         firefox: [
             "C:\\Program Files\\Mozilla Firefox\\firefox.exe",
             "C:\\Program Files (x86)\\Mozilla Firefox\\firefox.exe"
+        ],
+        brave: [
+            "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",
+            "C:\\Program Files (x86)\\BraveSoftware\\Brave-Browser\\Application\\brave.exe"
+        ],
+        opera: [
+            `${process.env.LOCALAPPDATA || ""}\\Programs\\Opera\\opera.exe`,
+            "C:\\Program Files\\Opera\\opera.exe"
+        ],
+        vivaldi: [
+            `${process.env.LOCALAPPDATA || ""}\\Vivaldi\\Application\\vivaldi.exe`,
+            "C:\\Program Files\\Vivaldi\\Application\\vivaldi.exe"
+        ],
+        yandex: [
+            `${process.env.LOCALAPPDATA || ""}\\Yandex\\YandexBrowser\\Application\\browser.exe`,
+            "C:\\Program Files (x86)\\Yandex\\YandexBrowser\\Application\\browser.exe"
+        ],
+        waterfox: [
+            "C:\\Program Files\\Waterfox\\waterfox.exe",
+            "C:\\Program Files (x86)\\Waterfox\\waterfox.exe"
+        ],
+        librewolf: [
+            "C:\\Program Files\\LibreWolf\\librewolf.exe",
+            "C:\\Program Files (x86)\\LibreWolf\\librewolf.exe"
         ]
     }
 };
@@ -3521,7 +3834,8 @@ async function detect_browsers_handler(args) {
         if (node_fs.existsSync(browserDir)) managed.installed.push(browser);
     }
     for (const browser of browsersToCheck){
-        const isGecko = "firefox" === browser;
+        const isGecko = isGeckoFamily(browser);
+        const isWebkit = WEBKIT_FAMILY.has(browser);
         let binaryPath = findManagedBinary(browser);
         let source = "managed";
         if (!binaryPath) {
@@ -3529,14 +3843,14 @@ async function detect_browsers_handler(args) {
             source = binaryPath ? "system" : "not_found";
         }
         let version = null;
-        if (binaryPath) version = await getVersion(binaryPath, browser);
+        if (binaryPath && !isWebkit) version = await getVersion(binaryPath, browser);
         detected.push({
             browser,
             binaryPath,
             source,
-            engine: isGecko ? "gecko" : "chromium",
+            engine: isWebkit ? "webkit" : isGecko ? "gecko" : "chromium",
             version,
-            cdpSupport: !isGecko,
+            cdpSupport: !isGecko && !isWebkit,
             rdpSupport: isGecko
         });
     }
@@ -3549,7 +3863,7 @@ async function detect_browsers_handler(args) {
             available: available.map((d)=>d.browser),
             missing: missing.map((d)=>d.browser)
         },
-        hint: missing.length ? `Missing browser(s): ${missing.map((d)=>d.browser).join(", ")}. Use extension_install_browser to install them.` : "All requested browsers are available."
+        hint: missing.length ? `Missing browser(s): ${missing.map((d)=>d.browser).join(", ")}.${missing.some((d)=>MANAGED_INSTALLABLE.has(d.browser)) ? ` Use extension_install_browser to install ${missing.filter((d)=>MANAGED_INSTALLABLE.has(d.browser)).map((d)=>d.browser).join(", ")}.` : ""}` : "All requested browsers are available."
     });
 }
 const doctor_schema = {
@@ -3700,6 +4014,7 @@ const tools = [
     whoami_namespaceObject,
     logout_namespaceObject,
     install_browser_namespaceObject,
+    uninstall_browser_namespaceObject,
     list_browsers_namespaceObject,
     detect_browsers_namespaceObject,
     doctor_namespaceObject

package/dist/src/lib/browser-family.d.ts

@@ -1,4 +1,5 @@
 export declare const CHROMIUM_FAMILY: ReadonlySet<string>;
 export declare const GECKO_FAMILY: ReadonlySet<string>;
+export declare const WEBKIT_FAMILY: ReadonlySet<string>;
 export declare function isChromiumFamily(browser: string): boolean;
 export declare function isGeckoFamily(browser: string): boolean;

package/dist/src/lib/launch-flags.d.ts

@@ -0,0 +1,43 @@
+export declare const LAUNCH_FLAG_SCHEMA: {
+    readonly profile: {
+        readonly type: "string";
+        readonly description: "Browser profile path, or \"false\" to reuse the default user profile. Omit for a fresh throwaway profile.";
+    };
+    readonly startingUrl: {
+        readonly type: "string";
+        readonly description: "URL the browser opens on launch";
+    };
+    readonly chromiumBinary: {
+        readonly type: "string";
+        readonly description: "Path to a custom Chromium-based binary (overrides browser)";
+    };
+    readonly geckoBinary: {
+        readonly type: "string";
+        readonly description: "Path to a custom Gecko/Firefox binary (overrides browser)";
+    };
+    readonly host: {
+        readonly type: "string";
+        readonly description: "Dev server bind host. Use 0.0.0.0 for Docker or devcontainers. Defaults to 127.0.0.1";
+    };
+    readonly publicHost: {
+        readonly type: "string";
+        readonly description: "Connectable host the browser dials for HMR and reload when it differs from the bind host";
+    };
+    readonly extensions: {
+        readonly type: "array";
+        readonly items: {
+            readonly type: "string";
+        };
+        readonly description: "Companion extension paths or store URLs to load alongside the project";
+    };
+};
+export interface LaunchFlagArgs {
+    profile?: string;
+    startingUrl?: string;
+    chromiumBinary?: string;
+    geckoBinary?: string;
+    host?: string;
+    publicHost?: string;
+    extensions?: string[];
+}
+export declare function launchFlagArgs(args: LaunchFlagArgs): string[];

package/dist/src/tools/build.d.ts

@@ -24,6 +24,26 @@ export declare const schema: {
                 default: boolean;
                 description: string;
             };
+            zipFilename: {
+                type: string;
+                description: string;
+            };
+            polyfill: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            silent: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            mode: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
         };
         required: string[];
     };
@@ -33,4 +53,8 @@ export declare function handler(args: {
     browser?: string;
     zip?: boolean;
     zipSource?: boolean;
+    zipFilename?: string;
+    polyfill?: boolean;
+    silent?: boolean;
+    mode?: "development" | "production" | "none";
 }): Promise<string>;