@extension.dev/mcp 7.0.0 → 9.0.0

package/dist/src/lib/common-schema.d.ts

@@ -0,0 +1,28 @@
+export declare const LAUNCHABLE_BROWSERS: readonly ["chrome", "chromium", "edge", "brave", "opera", "vivaldi", "yandex", "firefox", "waterfox", "librewolf", "safari", "chromium-based", "gecko-based", "firefox-based", "webkit-based"];
+export declare const REAL_BROWSERS: readonly ["chrome", "chromium", "edge", "brave", "opera", "vivaldi", "yandex", "firefox", "waterfox", "librewolf", "safari"];
+export declare const MANAGED_BROWSERS: readonly ["chrome", "chromium", "edge", "firefox"];
+export declare const PROJECT_PATH: {
+    readonly type: "string";
+    readonly description: "Extension project root";
+};
+export declare const SESSION_PROJECT_PATH: {
+    readonly type: "string";
+    readonly description: "Extension project root (needs a live dev session)";
+};
+export declare const SESSION_BROWSER: {
+    readonly type: "string";
+    readonly description: "Session browser; defaults to this project's live session";
+};
+export declare const CALL_TIMEOUT: {
+    readonly type: "number";
+    readonly description: "Command timeout in ms (default 5000)";
+};
+export declare const API_BASE: {
+    readonly type: "string";
+    readonly description: "Platform base URL (default EXTENSION_DEV_API_URL, else https://www.extension.dev)";
+};
+export declare const LAUNCH_BROWSER: {
+    readonly type: "string";
+    readonly enum: readonly ["chrome", "chromium", "edge", "brave", "opera", "vivaldi", "yandex", "firefox", "waterfox", "librewolf", "safari", "chromium-based", "gecko-based", "firefox-based", "webkit-based"];
+    readonly default: "chrome";
+};

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

@@ -1,7 +1,7 @@
 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 description: "Profile path, or \"false\" to reuse the real user profile. Omit for a throwaway one.";
     };
     readonly startingUrl: {
         readonly type: "string";
@@ -9,26 +9,26 @@ export declare const LAUNCH_FLAG_SCHEMA: {
     };
     readonly chromiumBinary: {
         readonly type: "string";
-        readonly description: "Path to a custom Chromium-based binary (overrides browser)";
+        readonly description: "Custom Chromium-based binary (overrides browser)";
     };
     readonly geckoBinary: {
         readonly type: "string";
-        readonly description: "Path to a custom Gecko/Firefox binary (overrides browser)";
+        readonly description: "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 description: "Bind host, default 127.0.0.1. Use 0.0.0.0 in Docker or devcontainers.";
     };
     readonly publicHost: {
         readonly type: "string";
-        readonly description: "Connectable host the browser dials for HMR and reload when it differs from the bind host";
+        readonly description: "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";
+        readonly description: "Extra extension paths or store URLs to load alongside the project";
     };
 };
 export interface LaunchFlagArgs {

package/dist/src/lib/session-identity.d.ts

@@ -0,0 +1,16 @@
+export declare const INSTALL_HEADER = "x-extensiondev-install";
+export declare const SESSION_HEADER = "x-extensiondev-session";
+export declare const TOOL_HEADER = "x-extensiondev-tool";
+export declare const ROTATE_AFTER_MS: number;
+export interface StoredInstallIdentity {
+    version: 1;
+    installId: string;
+    rotatedAt: number;
+}
+export declare function installIdentityDir(): string;
+export declare function installIdentityPath(): string;
+export declare function telemetryDisabled(): boolean;
+export declare function resolveInstallId(now?: number): string;
+export declare function sessionId(): string;
+export declare function resetSessionIdentityForTests(): void;
+export declare function identityHeaders(tool: string): Record<string, string>;

package/dist/src/tools/add-feature.d.ts

@@ -5,8 +5,8 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root";
             };
             feature: {
                 type: string;

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

@@ -0,0 +1,29 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectPath: {
+                readonly type: "string";
+                readonly description: "Extension project root";
+            };
+            browser: {
+                type: string;
+                default: string;
+                description: string;
+            };
+            format: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+        };
+        required: string[];
+    };
+};
+export declare function handler(args: {
+    projectPath: string;
+    browser?: string;
+    format?: string;
+}): Promise<string>;

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

@@ -0,0 +1,33 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+            project: {
+                type: string;
+                description: string;
+            };
+            deviceCode: {
+                type: string;
+                description: string;
+            };
+            api: {
+                readonly type: "string";
+                readonly description: "Platform base URL (default EXTENSION_DEV_API_URL, else https://www.extension.dev)";
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handler(args: {
+    action?: string;
+    project?: string;
+    deviceCode?: string;
+    api?: string;
+}): Promise<string>;

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

@@ -0,0 +1,39 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            action: {
+                type: string;
+                enum: string[];
+                default: string;
+            };
+            browsers: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: readonly ["chrome", "chromium", "edge", "brave", "opera", "vivaldi", "yandex", "firefox", "waterfox", "librewolf", "safari"];
+                };
+                description: string;
+            };
+            browser: {
+                type: string;
+                enum: readonly ["chrome", "chromium", "edge", "firefox"];
+                description: string;
+            };
+            all: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handler(args: {
+    action?: string;
+    browsers?: string[];
+    browser?: string;
+    all?: boolean;
+}): Promise<string>;

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

@@ -5,14 +5,13 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root";
             };
             browser: {
-                type: string;
-                enum: string[];
-                default: string;
-                description: string;
+                readonly type: "string";
+                readonly enum: readonly ["chrome", "chromium", "edge", "brave", "opera", "vivaldi", "yandex", "firefox", "waterfox", "librewolf", "safari", "chromium-based", "gecko-based", "firefox-based", "webkit-based"];
+                readonly default: "chrome";
             };
             zip: {
                 type: string;

package/dist/src/tools/detect-browsers.d.ts

@@ -1,20 +1 @@
-export declare const schema: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            browsers: {
-                type: string;
-                items: {
-                    type: string;
-                    enum: string[];
-                };
-                description: string;
-            };
-        };
-    };
-};
-export declare function handler(args: {
-    browsers?: string[];
-}): Promise<string>;
+export declare function detectBrowsers(browsers?: string[]): Promise<string>;

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

@@ -27,7 +27,7 @@ export declare const schema: {
             };
             profile: {
                 readonly type: "string";
-                readonly description: "Browser profile path, or \"false\" to reuse the default user profile. Omit for a fresh throwaway profile.";
+                readonly description: "Profile path, or \"false\" to reuse the real user profile. Omit for a throwaway one.";
             };
             startingUrl: {
                 readonly type: "string";
@@ -35,35 +35,35 @@ export declare const schema: {
             };
             chromiumBinary: {
                 readonly type: "string";
-                readonly description: "Path to a custom Chromium-based binary (overrides browser)";
+                readonly description: "Custom Chromium-based binary (overrides browser)";
             };
             geckoBinary: {
                 readonly type: "string";
-                readonly description: "Path to a custom Gecko/Firefox binary (overrides browser)";
+                readonly description: "Custom Gecko/Firefox binary (overrides browser)";
             };
             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 description: "Bind host, default 127.0.0.1. Use 0.0.0.0 in Docker or devcontainers.";
             };
             publicHost: {
                 readonly type: "string";
-                readonly description: "Connectable host the browser dials for HMR and reload when it differs from the bind host";
+                readonly description: "Host the browser dials for HMR and reload when it differs from the bind host";
             };
             extensions: {
                 readonly type: "array";
                 readonly items: {
                     readonly type: "string";
                 };
-                readonly description: "Companion extension paths or store URLs to load alongside the project";
+                readonly description: "Extra extension paths or store URLs to load alongside the project";
             };
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root";
             };
             browser: {
-                type: string;
-                enum: string[];
-                default: string;
+                readonly type: "string";
+                readonly enum: readonly ["chrome", "chromium", "edge", "brave", "opera", "vivaldi", "yandex", "firefox", "waterfox", "librewolf", "safari", "chromium-based", "gecko-based", "firefox-based", "webkit-based"];
+                readonly default: "chrome";
             };
             port: {
                 type: string;

package/dist/src/tools/{dom-inspect.d.ts → dom-snapshot.d.ts}

@@ -6,8 +6,8 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root (needs a live dev session)";
             };
             tab: {
                 type: string;
@@ -55,12 +55,12 @@ export declare const schema: {
                 description: string;
             };
             browser: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Session browser; defaults to this project's live session";
             };
             timeout: {
-                type: string;
-                description: string;
+                readonly type: "number";
+                readonly description: "Command timeout in ms (default 5000)";
             };
         };
         required: string[];

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

@@ -6,8 +6,8 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root (needs a live dev session)";
             };
             expression: {
                 type: string;
@@ -27,12 +27,12 @@ export declare const schema: {
                 description: string;
             };
             browser: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Session browser; defaults to this project's live session";
             };
             timeout: {
-                type: string;
-                description: string;
+                readonly type: "number";
+                readonly description: "Command timeout in ms (default 5000)";
             };
         };
         required: string[];

package/dist/src/tools/get-template-source.d.ts

@@ -1,25 +1,4 @@
-export declare const schema: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            slug: {
-                type: string;
-                description: string;
-            };
-            files: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handler(args: {
+export declare function readTemplateSource(args: {
     slug: string;
     files?: string[];
 }): Promise<string>;

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

@@ -5,18 +5,42 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
+                readonly type: "string";
+                readonly description: "Extension project root (needs a live dev session)";
+            };
+            url: {
                 type: string;
                 description: string;
             };
+            probe: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            include: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                default: string[];
+                description: string;
+            };
             browser: {
+                readonly type: "string";
+                readonly description: "Session browser; defaults to this project's live session";
+            };
+            maxBytes: {
                 type: string;
-                default: string;
+                default: number;
                 description: string;
             };
-            format: {
+            deepDom: {
                 type: string;
-                enum: string[];
-                default: string;
+                default: boolean;
+                description: string;
             };
         };
         required: string[];
@@ -24,6 +48,10 @@ export declare const schema: {
 };
 export declare function handler(args: {
     projectPath: string;
+    url?: string;
+    probe?: string[];
+    include?: string[];
     browser?: string;
-    format?: string;
+    maxBytes?: number;
+    deepDom?: boolean;
 }): Promise<string>;

package/dist/src/tools/install-browser.d.ts

@@ -1,18 +1 @@
-export declare const schema: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            browser: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handler(args: {
-    browser: string;
-}): Promise<string>;
+export declare function installManagedBrowser(browser: string): Promise<string>;

package/dist/src/tools/list-browsers.d.ts

@@ -1,9 +1 @@
-export declare const schema: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {};
-    };
-};
-export declare function handler(): Promise<string>;
+export declare function listManagedBrowsers(): Promise<string>;

package/dist/src/tools/list-extensions.d.ts

@@ -5,12 +5,12 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root (needs a live dev session)";
             };
             browser: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Session browser; defaults to this project's live session";
             };
         };
         required: string[];

package/dist/src/tools/list-templates.d.ts

@@ -1,38 +1,4 @@
-export declare const schema: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            surface: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            framework: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            tags: {
-                type: string;
-                items: {
-                    type: string;
-                };
-                description: string;
-            };
-            featured: {
-                type: string;
-                description: string;
-            };
-            query: {
-                type: string;
-                description: string;
-            };
-        };
-    };
-};
-export declare function handler(args: {
+export declare function searchTemplates(args: {
     surface?: string;
     framework?: string;
     tags?: string[];

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

@@ -1,26 +1,4 @@
-export declare const schema: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {
-            project: {
-                type: string;
-                description: string;
-            };
-            deviceCode: {
-                type: string;
-                description: string;
-            };
-            api: {
-                type: string;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
-export declare function handler(args: {
+export declare function loginToProject(args: {
     project: string;
     deviceCode?: string;
     api?: string;

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

@@ -1,9 +1 @@
-export declare const schema: {
-    name: string;
-    description: string;
-    inputSchema: {
-        type: "object";
-        properties: {};
-    };
-};
-export declare function handler(): Promise<string>;
+export declare function clearLocalCredentials(): Promise<string>;

package/dist/src/tools/logs-schema.d.ts

@@ -5,8 +5,8 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root (needs a live dev session)";
             };
             browser: {
                 type: string;

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

@@ -12,8 +12,8 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root (needs a live dev session)";
             };
             surface: {
                 type: string;
@@ -34,12 +34,12 @@ export declare const schema: {
                 description: string;
             };
             browser: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Session browser; defaults to this project's live session";
             };
             timeout: {
-                type: string;
-                description: string;
+                readonly type: "number";
+                readonly description: "Command timeout in ms (default 5000)";
             };
         };
         required: string[];

package/dist/src/tools/preview-web.d.ts

@@ -5,12 +5,12 @@ export declare const schema: {
         type: "object";
         properties: {
             projectPath: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Extension project root";
             };
             browser: {
                 type: string;
-                enum: string[];
+                enum: readonly ["chrome", "chromium", "edge", "brave", "opera", "vivaldi", "yandex", "firefox", "waterfox", "librewolf", "safari"];
                 default: string;
                 description: string;
             };
@@ -39,7 +39,7 @@ export declare const schema: {
             };
             openIn: {
                 type: string;
-                enum: string[];
+                enum: readonly ["chrome", "chromium", "edge", "brave", "opera", "vivaldi", "yandex", "firefox", "waterfox", "librewolf", "safari"];
                 description: string;
             };
             share: {

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

@@ -13,8 +13,8 @@ export declare const schema: {
                 description: string;
             };
             api: {
-                type: string;
-                description: string;
+                readonly type: "string";
+                readonly description: "Platform base URL (default EXTENSION_DEV_API_URL, else https://www.extension.dev)";
             };
         };
         required: never[];