@extension.dev/mcp 10.4.3 → 10.7.0

package/dist/src/lib/artifacts-api.d.ts

@@ -56,6 +56,8 @@ export type ArtifactsOutcome<T> = {
         message: string;
         status?: number;
     };
+    held?: boolean;
+    body?: unknown;
 };
 export declare function parseArtifactRef(input: string): string | null;
 export declare function wwwRevokeUrl(value: string): string;

package/dist/src/lib/cdp-page-scripts.d.ts

@@ -1,5 +1,6 @@
 export declare const PAGE_HTML_SCRIPT = "(() => {\n        try {\n          const doctype = document.doctype;\n          const dt = doctype\n            ? '<!DOCTYPE ' + doctype.name\n              + (doctype.publicId ? ' PUBLIC \"' + doctype.publicId + '\"' : '')\n              + (doctype.systemId ? ' \"' + doctype.systemId + '\"' : '')\n              + '>'\n            : '';\n          // Include shadow DOM content from extension roots\n          const roots = Array.from(document.querySelectorAll(\n            '#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])'\n          ));\n          if (roots.length) {\n            const clone = document.documentElement.cloneNode(true);\n            const clonedRoots = Array.from(clone.querySelectorAll(\n              '#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])'\n            ));\n            const s = new XMLSerializer();\n            for (let i = 0; i < Math.min(roots.length, clonedRoots.length); i++) {\n              const sr = roots[i].shadowRoot;\n              if (!sr) continue;\n              try {\n                const shadow = Array.from(sr.childNodes).map(n => {\n                  try { return s.serializeToString(n); } catch { return ''; }\n                }).join('');\n                if (shadow) clonedRoots[i].innerHTML = shadow;\n              } catch {}\n            }\n            return dt + '\\n' + clone.outerHTML;\n          }\n          return dt + '\\n' + document.documentElement.outerHTML;\n        } catch (e) { return ''; }\n      })()";
 export declare const PAGE_META_SCRIPT = "(() => {\n        try {\n          return {\n            title: document.title,\n            url: location.href,\n            readyState: document.readyState,\n            viewport: {\n              width: window.innerWidth,\n              height: window.innerHeight,\n              devicePixelRatio: window.devicePixelRatio\n            },\n            frameCount: window.frames.length,\n            scriptCount: document.querySelectorAll('script').length,\n            styleCount: document.querySelectorAll('style,link[rel=\"stylesheet\"]').length\n          };\n        } catch { return {}; }\n      })()";
 export declare const EXTENSION_ROOT_META_SCRIPT = "(() => {\n        try {\n          const readGeneration = (node) => {\n            const raw = node.getAttribute && node.getAttribute('data-extjs-reinject-generation');\n            const parsed = Number(raw);\n            return Number.isFinite(parsed) ? parsed : undefined;\n          };\n          const normalize = (node) => ({\n            tag: node.tagName ? String(node.tagName).toLowerCase() : 'unknown',\n            id: node.id || undefined,\n            key: node.getAttribute ? node.getAttribute('data-extjs-reinject-key') || undefined : undefined,\n            generation: readGeneration(node),\n            status: node.getAttribute ? node.getAttribute('data-extjs-reinject-status') || undefined : undefined\n          });\n          const roots = Array.from(\n            document.querySelectorAll('#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])')\n          ).slice(0, 10).map(normalize);\n          const markers = Array.from(\n            document.querySelectorAll('[data-extjs-reinject-marker=\"true\"]')\n          ).slice(0, 10).map(normalize);\n          if (!roots.length && !markers.length) return null;\n          const generations = [...roots, ...markers]\n            .map(e => e.generation)\n            .filter(g => typeof g === 'number');\n          return {\n            rootCount: roots.length,\n            markerCount: markers.length,\n            latestGeneration: generations.length ? Math.max(...generations) : 0,\n            roots,\n            markers\n          };\n        } catch { return null; }\n      })()";
+export declare const RENDER_EVIDENCE_SCRIPT = "(() => {\n        try {\n          const body = document.body;\n          const roots = document.querySelectorAll(\n            '#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])'\n          );\n          const text = body ? (body.innerText || body.textContent || '') : '';\n          return {\n            readyState: document.readyState,\n            title: document.title,\n            bodyChildCount: body ? body.children.length : 0,\n            bodyElementCount: body ? body.querySelectorAll('*').length : 0,\n            textLength: text.trim().length,\n            extensionRootCount: roots.length\n          };\n        } catch { return null; }\n      })()";
 export declare function probeSelectorsScript(selectors: string[]): string;
 export declare function domSnapshotScript(maxNodes: number): string;

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

@@ -1,4 +1,12 @@
 import { CDPConnection } from "./cdp-connection";
+export interface RenderEvidence {
+    readyState?: string;
+    title?: string;
+    bodyChildCount?: number;
+    bodyElementCount?: number;
+    textLength?: number;
+    extensionRootCount?: number;
+}
 export declare class CDPClient extends CDPConnection {
     static discoverBrowserWsUrl(port: number, host?: string): Promise<string>;
     static discoverTargets(port: number, host?: string): Promise<Array<{
@@ -27,5 +35,6 @@ export declare class CDPClient extends CDPConnection {
         samples: Array<Record<string, unknown>>;
     }>>;
     getDomSnapshot(sessionId: string, maxNodes?: number): Promise<Array<Record<string, unknown>>>;
+    getRenderEvidence(sessionId: string): Promise<RenderEvidence | null>;
     getExtensionRootMeta(sessionId: string): Promise<Record<string, unknown> | null>;
 }

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

@@ -13,6 +13,7 @@ export declare function requestDeviceCode(args: {
     path: string;
     project: string;
     clientName?: string;
+    intent?: "login" | "create";
     fetchImpl?: FetchImpl;
 }): Promise<DeviceCodeStart>;
 export type DevicePollResult = {
@@ -23,6 +24,23 @@ export type DevicePollResult = {
     reason: "pending" | "denied" | "expired" | "error";
     message?: string;
 };
+export type DeviceGrantPollResult = {
+    ok: true;
+    data: Record<string, unknown>;
+} | {
+    ok: false;
+    reason: "pending" | "denied" | "expired" | "error";
+    message?: string;
+};
+export declare function pollDeviceGrant(args: {
+    apiBase: string;
+    path: string;
+    project: string;
+    deviceCode: string;
+    interval: number;
+    budgetMs: number;
+    fetchImpl?: FetchImpl;
+}): Promise<DeviceGrantPollResult>;
 export declare function pollDeviceToken(args: {
     apiBase: string;
     path: string;

package/dist/src/lib/match-patterns.d.ts

@@ -0,0 +1,3 @@
+export declare function matchPatternCovers(pattern: string, url: string): boolean;
+export declare function coveringMatches(patterns: string[], url: string): string[];
+export declare function contentScriptsForbidden(url: string): string | null;

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

@@ -0,0 +1,2 @@
+import { type Origins } from "@extension.dev/urls/origins";
+export declare function mcpOrigins(apiHint?: string): Origins;

package/dist/src/lib/platform-hold.d.ts

@@ -0,0 +1,21 @@
+export declare const PLATFORM_HOLD_CODE = "PLATFORM_NOT_OPEN";
+export declare const PLATFORM_HOLD_HEADER = "x-extensiondev-hold";
+export declare const PLATFORM_HOLD_STATUS = "platform-held";
+export declare const PLATFORM_HOLD_RELAYS_THE_PLATFORM_DATE: boolean;
+export declare const PLATFORM_HOLD_STILL_WORKS: string[];
+export declare function templatesOrigin(apiHint?: string): string;
+export declare function readPlatformCode(body: unknown): string;
+export declare function readPlatformMessage(body: unknown): string;
+export declare function sawPlatformHold(res?: {
+    headers?: {
+        get?: (name: string) => string | null;
+    };
+} | null, body?: unknown): boolean;
+export declare function platformHoldMessage(body?: unknown, apiHint?: string): string;
+export declare function platformHoldEnvelope(options: {
+    command: string;
+    name: string;
+    body?: unknown;
+    api?: string;
+    value?: Record<string, unknown>;
+}): string;

package/dist/src/lib/preview-upload.d.ts

@@ -20,6 +20,8 @@ export type PreviewUploadOutcome = {
         name: string;
         message: string;
     };
+    held?: boolean;
+    body?: unknown;
 };
 export declare function collectDistFiles(distDir: string): PreviewUploadFile[];
 export declare function uploadPreview(options: {

package/dist/src/lib/project-manifest.d.ts

@@ -0,0 +1,18 @@
+export declare function manifestCandidates(projectPath: string, browser: string): string[];
+export interface ReadManifest {
+    file: string;
+    manifest: Record<string, unknown>;
+}
+export declare function readBuiltManifest(projectPath: string, browser: string): ReadManifest | null;
+export type BackgroundKind = "service_worker" | "scripts" | "page" | "none";
+export interface DeclaredBackground {
+    kind: BackgroundKind;
+    ref?: string;
+}
+export declare function declaredBackground(manifest: Record<string, unknown>): DeclaredBackground;
+export interface DeclaredContentScript {
+    index: number;
+    matches: string[];
+    js: string[];
+}
+export declare function declaredContentScripts(manifest: Record<string, unknown>): DeclaredContentScript[];

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

@@ -16,6 +16,8 @@ export type PublishResult = {
         name: string;
         message: string;
     };
+    held?: boolean;
+    body?: unknown;
 };
 export declare function publish(options?: PublishOptions): Promise<PublishResult>;
 export {};

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

@@ -1,7 +1,7 @@
 import { type RegistryAccessTokens } from "./registry-access";
-import { type Origins } from "@extension.dev/urls/origins";
+import { mcpOrigins } from "./origins";
 export declare const REGISTRY_BASE_DEFAULT: string;
-export declare function mcpOrigins(apiHint?: string): Origins;
+export { mcpOrigins };
 export declare function consoleBase(apiHint?: string): string;
 export declare function registryBase(): string;
 export interface ProjectRef {
@@ -15,14 +15,18 @@ export declare function resolveProjectRef(overrides?: {
 export declare function registryFileUrl(ref: ProjectRef, file: string): string;
 export declare function consoleProjectUrl(ref: ProjectRef | null, page: string, apiHint?: string): string;
 export declare function userlandProjectUrl(ref: ProjectRef | null, page?: string, apiHint?: string): string;
-export type RegistryFetchResult<T> = {
-    ok: true;
-    json: T;
-} | {
+export interface RegistryFetchRefusal {
     ok: false;
     status?: number;
     message: string;
-};
+    code?: string;
+    held?: boolean;
+    body?: unknown;
+}
+export type RegistryFetchResult<T> = {
+    ok: true;
+    json: T;
+} | RegistryFetchRefusal;
 export declare function fetchRegistryJson<T = unknown>(url: string, fetchImpl?: typeof fetch, options?: {
     ref?: ProjectRef | null;
     api?: string;

package/dist/src/lib/store-md.d.ts

@@ -0,0 +1,11 @@
+export declare const STORE_MD_FILENAME = "STORE.md";
+export interface StoreMdData {
+    firefox?: {
+        approvalNotes?: string;
+        releaseNotes?: string;
+    };
+    edge?: {
+        certificationNotes?: string;
+    };
+}
+export declare function parseStoreMd(content: string): StoreMdData;

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

@@ -0,0 +1,63 @@
+export declare const ASSERT_CONTRACT_NAME = "extension.dev/assert-verdict";
+export declare const ASSERT_CONTRACT_VERSION = 1;
+export declare const OUTCOME_PASS = "pass";
+export declare const OUTCOME_FAIL = "fail";
+export declare const OUTCOME_INCONCLUSIVE = "inconclusive";
+export declare const OUTCOME_SKIPPED = "skipped";
+export type CheckOutcome = typeof OUTCOME_PASS | typeof OUTCOME_FAIL | typeof OUTCOME_INCONCLUSIVE | typeof OUTCOME_SKIPPED;
+export declare const CHECK_OUTCOMES: CheckOutcome[];
+export type CheckSeverity = "fail" | "warn" | "info";
+export type VerdictOutcome = typeof OUTCOME_PASS | typeof OUTCOME_FAIL | typeof OUTCOME_INCONCLUSIVE;
+export interface AssertCheckDeclaration {
+    readonly id: string;
+    readonly since: number;
+    readonly severity: CheckSeverity;
+    readonly title: string;
+    readonly reads: readonly string[];
+    readonly previewCounterpart: string | null;
+    readonly counterpartNote?: string;
+}
+export declare const ASSERT_RETIRED_IDS: readonly string[];
+export declare const ASSERT_CHECKS: readonly AssertCheckDeclaration[];
+export declare function assertCheckById(id: string): AssertCheckDeclaration | null;
+export interface CheckResult {
+    id: string;
+    subject: string | null;
+    since: number;
+    severity: CheckSeverity;
+    outcome: CheckOutcome;
+    detail: string;
+    evidence: Record<string, unknown> | null;
+    settledBy?: string;
+}
+export declare function passCheck(id: string, subject: string | null, detail: string, evidence?: Record<string, unknown>): CheckResult;
+export declare function failCheck(id: string, subject: string | null, detail: string, evidence?: Record<string, unknown>): CheckResult;
+export declare function inconclusiveCheck(id: string, subject: string | null, detail: string, settledBy: string, evidence?: Record<string, unknown>): CheckResult;
+export declare function checkKey(check: CheckResult): string;
+export declare function verdictOutcome(checks: CheckResult[]): VerdictOutcome;
+export interface AssertVerdict {
+    contract: typeof ASSERT_CONTRACT_NAME;
+    contractVersion: number;
+    producer: {
+        name: string;
+        version?: string;
+    } | null;
+    subject: Record<string, unknown> | null;
+    generatedAt: string;
+    outcome: VerdictOutcome;
+    passed: boolean;
+    checks: CheckResult[];
+    failures: string[];
+    inconclusive: string[];
+}
+export interface VerdictInput {
+    checks: CheckResult[];
+    producer?: {
+        name: string;
+        version?: string;
+    };
+    subject?: Record<string, unknown>;
+    generatedAt?: string;
+}
+export declare function assertVerdict(input: VerdictInput): AssertVerdict;
+export declare function verdictSentence(verdict: AssertVerdict): string;

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

@@ -0,0 +1,90 @@
+import { checkKey } from "../lib/verdict";
+export declare const ASSERT_KINDS: string[];
+declare const BACKGROUND = "background-worker-booted";
+declare const SURFACE = "surface-rendered";
+declare const CONTENT_SCRIPT = "content-script-injected";
+declare const STORAGE = "storage-key-present";
+declare const CONSOLE = "console-errors-empty";
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            projectPath: {
+                readonly type: "string";
+                readonly description: "Extension project root (needs a live dev session)";
+            };
+            expect: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            browser: {
+                readonly type: "string";
+                readonly description: "Session browser; defaults to this project's live session";
+            };
+            timeout: {
+                readonly type: "number";
+                readonly description: "Command timeout in ms (default 5000)";
+            };
+        };
+        required: string[];
+    };
+};
+interface BackgroundClause {
+    assert: typeof BACKGROUND;
+    subject: null;
+}
+interface SurfaceClause {
+    assert: typeof SURFACE;
+    subject: string;
+    surface: string;
+    selector?: string;
+    minNodes?: number;
+}
+interface ContentScriptClause {
+    assert: typeof CONTENT_SCRIPT;
+    subject: string;
+    url: string;
+}
+interface StorageClause {
+    assert: typeof STORAGE;
+    subject: string;
+    key: string;
+    area: string;
+    equals?: unknown;
+    hasEquals: boolean;
+    context?: string;
+}
+interface ConsoleClause {
+    assert: typeof CONSOLE;
+    subject: string | null;
+    context?: string[];
+    since?: number;
+    ignore?: string[];
+}
+type Clause = BackgroundClause | SurfaceClause | ContentScriptClause | StorageClause | ConsoleClause;
+interface ParseResult {
+    clauses: Clause[];
+    issues: string[];
+}
+export declare function parseClauses(raw: unknown): ParseResult;
+export declare function renderedFromEvidence(evidence: {
+    bodyElementCount?: number;
+    textLength?: number;
+}): boolean;
+interface StorageRead {
+    shape: "found" | "absent" | "unreadable";
+    value?: unknown;
+}
+export declare function readStorageValue(value: unknown, key: string): StorageRead;
+export declare function handler(args: {
+    projectPath: string;
+    expect: unknown;
+    browser?: string;
+    timeout?: number;
+}): Promise<string>;
+export { checkKey };

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

@@ -1,3 +1,4 @@
+import { type LogQuery } from "./logs-filter";
 export declare const schema: {
     name: string;
     description: string;
@@ -15,7 +16,7 @@ export declare const schema: {
         };
     };
 };
-export declare function recentErrorLogs(projectPath: string, browser: string, max?: number): string[];
+export declare function recentErrorLogs(projectPath: string, browser: string, max?: number, query?: Omit<LogQuery, "level">): string[];
 export declare function handler(args: {
     projectPath?: string;
     browser?: string;

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

@@ -1,5 +1,5 @@
-import { readLogEvents } from "extension-develop/bridge";
-export { readLogEvents };
+import { readLogEvents, type LogQuery } from "extension-develop/bridge";
+export { readLogEvents, type LogQuery };
 export interface LogsArgs {
     projectPath: string;
     browser?: string;

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

@@ -1,6 +1,9 @@
 import { type LogsArgs } from "./logs-filter";
 import { type ErrorCode } from "../lib/envelope";
 export { schema } from "./logs-schema";
+export declare function emptyReason(projectPath: string, browser: string): string | undefined;
+export declare function staleFileNote(projectPath: string, browser: string, eventsRunId: string): string | undefined;
+export declare function readLogRunId(projectPath: string, browser: string): string;
 export interface ControlRefusal {
     code: ErrorCode;
     status: string;

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

@@ -1,5 +1,9 @@
 import { type ActArgs } from "../lib/act";
 export declare function navigateToUrl(projectPath: string, browser: string, url: string, timeout?: number): Promise<string>;
+export declare function resolveExtensionId(projectPath: string, browser: string): Promise<string | null>;
+export declare function surfaceDocument(projectPath: string, browser: string, surface: string): string | null;
+export declare const SURFACE_MANIFEST_KEYS: Record<string, string>;
+export declare function declaredSurfaces(projectPath: string, browser: string): string[] | null;
 export declare function clampPopupBounds(width: number, height: number): {
     width: number;
     height: number;

package/dist/src/tools/project-create.d.ts

@@ -0,0 +1,65 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            project: {
+                type: string;
+                description: string;
+            };
+            repo: {
+                type: string;
+                description: string;
+            };
+            installationId: {
+                type: string;
+                description: string;
+            };
+            displayName: {
+                type: string;
+                description: string;
+            };
+            description: {
+                type: string;
+                description: string;
+            };
+            installCommand: {
+                type: string;
+                default: string;
+                description: string;
+            };
+            buildCommand: {
+                type: string;
+                default: string;
+                description: string;
+            };
+            outputDirectory: {
+                type: string;
+                default: 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: string[];
+    };
+};
+export declare function handler(args: {
+    project: string;
+    repo: string;
+    installationId?: string;
+    displayName?: string;
+    description?: string;
+    installCommand?: string;
+    buildCommand?: string;
+    outputDirectory?: string;
+    deviceCode?: string;
+    api?: string;
+}): Promise<string>;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "10.4.3",
-  "description": "MCP server that lets AI agents (Claude Code, Claude Desktop, Cursor, Copilot, Codex) build, run, inspect, and publish browser extensions. 28 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.",
+  "version": "10.7.0",
+  "description": "MCP server that lets AI agents (Claude Code, Claude Desktop, Cursor, Copilot, Codex) build, run, inspect, and publish browser extensions. 30 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": "Apache-2.0",
   "author": {
@@ -86,6 +86,7 @@
     "extension.js"
   ],
   "dependencies": {
+    "@extension.dev/urls": "^0.8.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "browser-extension-manifest-fields": "^2.2.9",
     "cross-spawn": "^7.0.6",
@@ -95,7 +96,6 @@
     "ws": "^8.20.0"
   },
   "devDependencies": {
-    "@extension.dev/urls": "^0.6.0",
     "@rslib/core": "^0.19.4",
     "@types/cross-spawn": "^6.0.6",
     "@types/node": "^25.2.0",

package/server.json

@@ -1,19 +1,19 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "io.github.extensiondev/mcp",
-  "description": "Build, run, inspect, and publish browser extensions from any MCP client. 28 tools, 11 browsers.",
+  "description": "Build, run, inspect, and publish browser extensions from any MCP client. 30 tools, 11 browsers.",
   "repository": {
     "url": "https://github.com/extensiondev/mcp",
     "source": "github"
   },
   "websiteUrl": "https://extension.dev",
-  "version": "10.4.3",
+  "version": "10.7.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@extension.dev/mcp",
-      "version": "10.4.3",
+      "version": "10.7.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"