@extension.dev/mcp 4.6.0 → 4.8.0

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

@@ -1,5 +1,6 @@
 export declare function resolveCdpPort(projectPath: string, browser: string, options?: {
     waitMs?: number;
+    graceMs?: number;
 }): Promise<{
     port: number;
     source: "contract" | "default-probe";

package/dist/src/lib/credentials.d.ts

@@ -8,6 +8,8 @@ export interface StoredCredentials {
     expiresAt: number;
     /** Platform base URL the token was minted against. */
     api: string;
+    /** Which device flow minted this token: extension.dev-gated or GitHub-direct. */
+    provider?: "extensiondev" | "github";
 }
 export declare function credentialsPath(): string;
 export declare function readCredentials(): StoredCredentials | null;

package/dist/src/lib/device-flow.d.ts

@@ -0,0 +1,41 @@
+import type { StoredCredentials } from "./credentials";
+type FetchImpl = typeof fetch;
+export interface DeviceCodeStart {
+    deviceCode: string;
+    userCode: string;
+    verificationUri: string;
+    verificationUriComplete: string;
+    interval: number;
+    expiresIn: number;
+}
+export declare function requestDeviceCode(args: {
+    apiBase: string;
+    path: string;
+    project: string;
+    clientName?: string;
+    fetchImpl?: FetchImpl;
+}): Promise<DeviceCodeStart>;
+export type DevicePollResult = {
+    ok: true;
+    creds: StoredCredentials;
+} | {
+    ok: false;
+    reason: "pending" | "denied" | "expired" | "error";
+    message?: string;
+};
+/**
+ * Poll the extension.dev token endpoint until approved or the budget runs out.
+ * The budget is kept under the MCP client request timeout; the tool re-invokes
+ * with the same deviceCode to keep waiting (idempotent), mirroring the GitHub
+ * poll's two-phase contract.
+ */
+export declare function pollDeviceToken(args: {
+    apiBase: string;
+    path: string;
+    project: string;
+    deviceCode: string;
+    interval: number;
+    budgetMs: number;
+    fetchImpl?: FetchImpl;
+}): Promise<DevicePollResult>;
+export {};

package/dist/src/lib/login-flow.d.ts

@@ -17,15 +17,35 @@ export declare function safeApiBase(raw: string): {
     message: string;
 };
 export interface LoginConfig {
+    /**
+     * "extensiondev": the extension.dev-gated device flow (branded /device, GitHub
+     * federated server-side). "github": the legacy GitHub-direct device flow.
+     */
+    provider: "extensiondev" | "github";
     clientId: string;
     scope: string;
+    deviceCodeUrl: string;
+    deviceTokenUrl: string;
+    verificationUri: string;
 }
 /**
- * Resolve the GitHub OAuth client id the device flow authenticates against.
- * EXTENSION_DEV_GITHUB_CLIENT_ID overrides (useful when pointing at a self-
- * hosted platform); otherwise it comes from the platform's public config.
+ * Resolve how the device flow should authenticate. The server's public config
+ * picks the provider (extension.dev-gated once its device endpoints are live,
+ * else GitHub-direct). EXTENSION_DEV_GITHUB_CLIENT_ID forces the GitHub flow
+ * (useful when pointing at a self-hosted platform).
  */
 export declare function fetchLoginConfig(apiBase: string, fetchImpl?: FetchImpl): Promise<LoginConfig>;
+/**
+ * Persist a `{ token, expiresAt, workspaceSlug, projectSlug }` response (the
+ * shape returned by BOTH the GitHub exchange endpoint and the extension.dev
+ * device/token endpoint) to the local credentials file. Records which provider
+ * minted it.
+ */
+export declare function persistTokenResponse(args: {
+    apiBase: string;
+    data: Record<string, unknown>;
+    provider: "extensiondev" | "github";
+}): StoredCredentials;
 /**
  * Trade a verified GitHub user token for a project-scoped access token and
  * write it to the local credentials file. Returns the stored credentials

package/dist/src/lib/validate-input.d.ts

@@ -2,5 +2,6 @@ export interface InputIssue {
     path: string;
     message: string;
 }
+export declare function normalizeArgAliases(inputSchema: Record<string, unknown>, args: Record<string, unknown>): Record<string, unknown>;
 export declare function validateToolInput(inputSchema: Record<string, unknown>, args: Record<string, unknown>): InputIssue[];
 export declare function inputValidationError(toolName: string, issues: InputIssue[]): string;

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

@@ -1,71 +1,34 @@
 export interface DeployToolArgs {
-    projectPath: string;
-    chromeZip?: string;
-    chromeExtensionId?: string;
-    chromePublisherId?: string;
-    firefoxZip?: string;
-    firefoxSourcesZip?: string;
-    firefoxExtensionId?: string;
-    firefoxChannel?: "listed" | "unlisted";
-    edgeZip?: string;
-    edgeProductId?: string;
+    browsers: string[];
+    buildSha: string;
+    channel?: string;
+    version?: string;
     dryRun?: boolean;
-    stagedPublish?: boolean;
-    chromeDeployPercentage?: number;
-    chromeSkipSubmitReview?: boolean;
-    edgeSkipSubmitReview?: boolean;
-    outputJson?: string;
+    api?: string;
 }
-/**
- * Build the extension-deploy argv from tool arguments. Pure and exported so the
- * flag mapping is unit-tested without spawning a process. Never emits a
- * credential flag - secrets come from the environment / .env.submit.
- */
-export declare function buildDeployArgs(args: DeployToolArgs): string[];
 export declare const schema: {
     name: string;
     description: string;
     inputSchema: {
         type: "object";
         properties: {
-            projectPath: {
+            browsers: {
                 type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
                 description: string;
             };
-            chromeZip: {
+            buildSha: {
                 type: string;
                 description: string;
             };
-            chromeExtensionId: {
+            channel: {
                 type: string;
                 description: string;
             };
-            chromePublisherId: {
-                type: string;
-                description: string;
-            };
-            firefoxZip: {
-                type: string;
-                description: string;
-            };
-            firefoxSourcesZip: {
-                type: string;
-                description: string;
-            };
-            firefoxExtensionId: {
-                type: string;
-                description: string;
-            };
-            firefoxChannel: {
-                type: string;
-                enum: string[];
-                description: string;
-            };
-            edgeZip: {
-                type: string;
-                description: string;
-            };
-            edgeProductId: {
+            version: {
                 type: string;
                 description: string;
             };
@@ -74,26 +37,7 @@ export declare const schema: {
                 default: boolean;
                 description: string;
             };
-            stagedPublish: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-            chromeDeployPercentage: {
-                type: string;
-                description: string;
-            };
-            chromeSkipSubmitReview: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-            edgeSkipSubmitReview: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-            outputJson: {
+            api: {
                 type: string;
                 description: string;
             };

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

@@ -13,10 +13,9 @@ export declare const schema: {
                 description: string;
             };
         };
-        required: string[];
     };
 };
 export declare function handler(args: {
-    projectPath: string;
+    projectPath?: string;
     browser?: string;
 }): Promise<string>;

package/dist/src/tools/manifest-validate.d.ts

@@ -8,6 +8,10 @@ export declare const schema: {
                 type: string;
                 description: string;
             };
+            projectPath: {
+                type: string;
+                description: string;
+            };
             browsers: {
                 type: string;
                 items: {
@@ -17,10 +21,11 @@ export declare const schema: {
                 description: string;
             };
         };
-        required: string[];
+        required: never[];
     };
 };
 export declare function handler(args: {
-    manifestPath: string;
+    manifestPath?: string;
+    projectPath?: string;
     browsers?: string[];
 }): Promise<string>;

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

@@ -4,10 +4,6 @@ export declare const schema: {
     inputSchema: {
         type: "object";
         properties: {
-            projectPath: {
-                type: string;
-                description: string;
-            };
             ttlHours: {
                 type: string;
                 description: string;
@@ -21,11 +17,10 @@ export declare const schema: {
                 description: string;
             };
         };
-        required: string[];
+        required: never[];
     };
 };
 export declare function handler(args: {
-    projectPath: string;
     ttlHours?: number;
     buildSha?: string;
     api?: string;

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

@@ -10,7 +10,6 @@ export declare const schema: {
             };
             browser: {
                 type: string;
-                default: string;
                 description: string;
             };
             all: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "4.6.0",
+  "version": "4.8.0",
   "description": "MCP server that lets AI agents (Claude Code, Claude Desktop, Cursor, Copilot, Codex) build, run, inspect, and publish browser extensions. 31 tools for scaffolding, live DOM inspection, log streaming, and store-ready builds across Chrome, Edge, Firefox, Safari, and every Chromium- or Gecko-based browser (Brave, Opera, Vivaldi, Yandex, Waterfox, LibreWolf). Powered by extension.dev and Extension.js.",
   "mcpName": "io.github.extensiondev/mcp",
   "license": "MIT",

package/server.json

@@ -7,13 +7,13 @@
     "source": "github"
   },
   "websiteUrl": "https://extension.dev",
-  "version": "4.6.0",
+  "version": "4.8.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@extension.dev/mcp",
-      "version": "4.6.0",
+      "version": "4.8.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"