@extension.dev/mcp 10.9.0 → 10.10.0

package/dist/src/index.d.ts

@@ -1,3 +1,4 @@
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { version } from "../package.json";
 export { version };
 export interface ToolModule {
@@ -16,5 +17,7 @@ export declare function toolResultFrame(result: string): {
     }>;
     isError?: boolean;
 };
+export declare const SERVER_INSTRUCTIONS: string;
+export declare function createServer(): Server;
 export declare function startServer(): Promise<void>;
 export declare function runCli(cmd: string, args: string[]): Promise<number>;

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

@@ -0,0 +1,16 @@
+export declare const FREE_ALLOWANCE_PHRASE = "counts against your free allowance";
+export interface SpendNarration {
+    spent: string;
+    remains: string;
+    wall: string;
+}
+export declare function allowanceWallUrl(apiHint?: string): string;
+export declare function readPlatformAllowance(body: unknown): {
+    used: number;
+    limit: number;
+} | null;
+export declare function spendNarration(options: {
+    what: string;
+    body?: unknown;
+    api?: string;
+}): SpendNarration;

package/dist/src/lib/analytics-scrub.d.ts

@@ -0,0 +1,3 @@
+export declare function maskRepositoryRef(value: string): string;
+export type ScrubbableProperties = Record<string, string | number | boolean | null>;
+export declare function sanitizeMcpProperties<T extends ScrubbableProperties>(properties: T): T;

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

@@ -0,0 +1,21 @@
+import { type PageTarget } from "./cdp-targets";
+export type ExtensionPageEval = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    message: string;
+    thrown: boolean;
+};
+export declare function matchExtensionPageTargets(targets: PageTarget[], wantedUrl: string): PageTarget[];
+export declare function findExtensionPageTargets(port: number, wantedUrl: string): Promise<PageTarget[]>;
+export declare function evaluateOnExtensionPage(port: number, targetId: string, expression: string): Promise<ExtensionPageEval>;
+export type SidePanelGestureOutcome = {
+    opened: true;
+    targetId: string;
+    url: string;
+} | {
+    opened: false;
+    reason: string;
+};
+export declare function openSidePanelWithSyntheticGesture(port: number, hostUrl: string): Promise<SidePanelGestureOutcome>;

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

@@ -1,6 +1,6 @@
 export declare const ENVELOPE_SCHEMA: 1;
 export declare const DECISION_D6 = "The MCP tool name owns the envelope `command` key; forking the key to `tool` would fork the schema the checksum test pins.";
-export type ErrorCode = "E_AMBIGUOUS_TARGET" | "E_APPROVAL_PENDING" | "E_APPROVAL_REJECTED" | "E_APPROVAL_REQUIRED" | "E_AUTH_DENIED" | "E_AUTH_EXPIRED" | "E_AUTH_FAILED" | "E_AUTH_PENDING" | "E_AUTH_REQUIRED" | "E_BAD_HOST_URL" | "E_BAD_MANIFEST" | "E_BAD_REQUEST" | "E_BRIDGE" | "E_BROWSER_EXITED" | "E_BROWSER_INSTALL" | "E_BROWSER_UNINSTALL" | "E_BUILD_FAILED" | "E_CARRIER_IN_DIST" | "E_CDP" | "E_CLI" | "E_COMPILE" | "E_CONFIG" | "E_CONTRACT_ERROR" | "E_CONTROL_CHANNEL" | "E_CONTROL_ENVELOPE" | "E_ENGINE_TOO_OLD" | "E_ENTRYPOINT_MISSING" | "E_FIRST_COMPILE" | "E_INPUT_VALIDATION" | "E_INTERNAL" | "E_INVALID_BUNDLE_ID" | "E_LOGS_MISSING" | "E_MANIFEST_BLOCKING" | "E_MANIFEST_NOT_FOUND" | "E_NAVIGATE_ERROR" | "E_NAVIGATE_FAILED" | "E_NETWORK" | "E_NO_CONTROL_CHANNEL" | "E_NO_DIST" | "E_NO_EXTENSION_ID" | "E_NO_MATCHING_TARGET" | "E_NO_REFERENCE_TEMPLATE" | "E_NO_SESSION" | "E_NO_SURFACE_DOCUMENT" | "E_NO_TARGET" | "E_NOT_ATTACHED" | "E_PARSE" | "E_PLATFORM" | "E_PREVIEW_HOST_UNREACHABLE" | "E_PROFILE_LOCKED" | "E_RDP" | "E_SAFARI_ONLY_OPTION" | "E_SCAFFOLD_FAILED" | "E_SCAFFOLD_INCOMPLETE" | "E_SESSION_EXISTS" | "E_SESSION_EXITED" | "E_STALE_CONTRACT" | "E_SURFACE_DID_NOT_OPEN" | "E_TEMPLATE_FETCH" | "E_TEMPLATE_NOT_FOUND" | "E_UNKNOWN_COMMAND" | "E_UNKNOWN_TOOL" | "E_UNSUPPORTED_BROWSER" | "E_WAIT_TIMEOUT";
+export type ErrorCode = "E_AMBIGUOUS_TARGET" | "E_APPROVAL_PENDING" | "E_APPROVAL_REJECTED" | "E_APPROVAL_REQUIRED" | "E_AUTH_DENIED" | "E_AUTH_EXPIRED" | "E_AUTH_FAILED" | "E_AUTH_PENDING" | "E_AUTH_REQUIRED" | "E_BAD_HOST_URL" | "E_BAD_MANIFEST" | "E_BAD_REQUEST" | "E_BRIDGE" | "E_BROWSER_EXITED" | "E_BROWSER_INSTALL" | "E_BROWSER_UNINSTALL" | "E_BUILD_FAILED" | "E_CARRIER_IN_DIST" | "E_CDP" | "E_CLI" | "E_COMPILE" | "E_CONFIG" | "E_CONTRACT_ERROR" | "E_CONTROL_CHANNEL" | "E_CONTROL_ENVELOPE" | "E_ENGINE_TOO_OLD" | "E_ENTRYPOINT_MISSING" | "E_FIRST_COMPILE" | "E_INPUT_VALIDATION" | "E_INTERNAL" | "E_INVALID_BUNDLE_ID" | "E_LOGS_MISSING" | "E_MANIFEST_BLOCKING" | "E_MANIFEST_NOT_FOUND" | "E_NAVIGATE_ERROR" | "E_NAVIGATE_FAILED" | "E_NETWORK" | "E_NO_CONTROL_CHANNEL" | "E_NO_DIST" | "E_NO_EXTENSION_ID" | "E_NO_MATCHING_TARGET" | "E_NO_REFERENCE_TEMPLATE" | "E_NO_SESSION" | "E_NO_SURFACE_DOCUMENT" | "E_NO_TARGET" | "E_NOT_ATTACHED" | "E_PARSE" | "E_PLATFORM" | "E_PREVIEW_HOST_UNREACHABLE" | "E_PROFILE_LOCKED" | "E_RDP" | "E_SAFARI_ONLY_OPTION" | "E_EVAL" | "E_SCAFFOLD_FAILED" | "E_SCAFFOLD_INCOMPLETE" | "E_SESSION_EXISTS" | "E_SESSION_EXITED" | "E_STALE_CONTRACT" | "E_SURFACE_DID_NOT_OPEN" | "E_TEMPLATE_FETCH" | "E_TEMPLATE_NOT_FOUND" | "E_UNKNOWN_COMMAND" | "E_UNKNOWN_TOOL" | "E_UNSUPPORTED_BROWSER" | "E_WAIT_TIMEOUT";
 export declare const ERROR_CODES: ErrorCode[];
 export interface EnvelopeError {
     code: ErrorCode | string;

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

@@ -14,6 +14,7 @@ export interface PreviewUploadResult {
 export type PreviewUploadOutcome = {
     ok: true;
     data: PreviewUploadResult;
+    body: unknown;
 } | {
     ok: false;
     error: {

package/dist/src/lib/safari-automation.d.ts

@@ -0,0 +1,16 @@
+export interface SafariAutomation {
+    safaridriver: string | null;
+    mcp: boolean;
+    bidi: boolean;
+}
+export declare const SAFARI_MCP_SETTING = "Safari > Settings > Developer > \"Allow remote automation and external agents\"";
+export declare const SAFARI_MCP_ADD_COMMAND = "claude mcp add safari-mcp -- \"/usr/bin/safaridriver\" --mcp";
+export declare function parseSafariDriverHelp(helpText: string): {
+    mcp: boolean;
+    bidi: boolean;
+};
+export declare function safariDriverCandidates(safariBinary: string | null): string[];
+export declare function readSafariDriverHelp(driverPath: string): Promise<string | null>;
+export declare function detectSafariAutomation(safariBinary: string | null): Promise<SafariAutomation>;
+export declare function readSafariVersion(safariBinary: string): Promise<string | null>;
+export declare function safariAutomationHint(automation: SafariAutomation): string;

package/dist/src/lib/template-artifact-source.d.ts

@@ -1,4 +1,4 @@
-export declare const PINNED_COMMIT = "1d04a3d62f4d82ab3f13a3388800d517d1627707";
+export declare const PINNED_COMMIT = "8e2336852b51c0fb71fd03abeca1f5e93a44700e";
 export type TemplateCatalogUtmSource = "mcp" | "mcp-create";
 export declare function templateCatalogUrl(slug: string, utmSource?: TemplateCatalogUtmSource): string;
 export declare function resolvedTemplateCommit(): Promise<string>;

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

@@ -58,6 +58,8 @@ export interface ReadyContract {
     port?: number | null;
     host?: string;
     cdpPort?: number;
+    webdriverPort?: number;
+    webdriverSessionId?: string;
     pid?: number;
     ts?: string;
     compiledAt?: string | null;

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

@@ -0,0 +1,28 @@
+export declare const WEBDRIVER_SESSION_MISSING_HINT = "A Safari page is readable only through a safaridriver session the dev session records in ready.json (webdriverPort and webdriverSessionId), and no Extension.js release opens one today: Safari grants one automation session at a time, so this server never opens its own. What Safari does give you is the dev session's log file, which extension_logs and the log-based assertions read once the extension is enabled; the rest is Web Inspector, attended.";
+export interface WebDriverSessionInfo {
+    port: number;
+    sessionId: string;
+}
+export declare function readWebDriverSession(projectPath: string, browser: string): WebDriverSessionInfo | null;
+export declare function readyExtensionId(projectPath: string, browser: string): string | null;
+export declare class WebDriverClient {
+    readonly info: WebDriverSessionInfo;
+    private readonly fetchFn;
+    private readonly base;
+    constructor(info: WebDriverSessionInfo, fetchFn?: typeof fetch);
+    private call;
+    alive(): Promise<boolean>;
+    currentUrl(): Promise<string | null>;
+    navigate(url: string, timeoutMs?: number): Promise<void>;
+    refresh(timeoutMs?: number): Promise<void>;
+    execute(script: string, args?: unknown[], timeoutMs?: number): Promise<unknown>;
+}
+export interface ExtensionRootReading {
+    roots: number;
+    owners: string[];
+    url: string;
+    title: string;
+}
+export declare const EXTENSION_ROOT_READING_SCRIPT = "\n  const nodes = Array.from(document.querySelectorAll('#extension-root,[data-extension-root]'));\n  return {\n    roots: nodes.length,\n    owners: nodes.map((n) => String(n.getAttribute('data-extjs-reinject-owner') || '')),\n    url: String(location.href),\n    title: String(document.title || '')\n  };\n";
+export declare function readExtensionRoots(client: WebDriverClient): Promise<ExtensionRootReading>;
+export declare function sameDocument(current: string | null, wanted: string): boolean;

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

@@ -38,7 +38,10 @@ export declare const schema: {
         required: string[];
     };
 };
+export declare function chromiumManifestVersion(projectPath: string, browser: string): 2 | 3 | null;
 export declare function resolveDefaultEvalContext(projectPath: string, browser: string): "background" | "page";
+export declare const EXTENSION_PAGE_CONTEXTS: string[];
+export declare function wantsExtensionPageOverCdp(projectPath: string, browser: string, context: string | undefined, url: string | undefined): boolean;
 export declare function handler(args: ActArgs & {
     expression: string;
 }): Promise<string>;

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

@@ -1,4 +1,5 @@
 import { type ActArgs } from "../lib/act";
+export declare const OVERRIDE_SURFACES: string[];
 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;
@@ -56,3 +57,4 @@ export declare function handler(args: ActArgs & {
     url?: string;
     asTab?: boolean;
 }): Promise<string>;
+export declare const E_USER_GESTURE_REQUIRED = "E_USER_GESTURE_REQUIRED";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "10.9.0",
+  "version": "10.10.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",
@@ -91,9 +91,9 @@
     "@modelcontextprotocol/sdk": "^1.12.1",
     "browser-extension-manifest-fields": "^2.2.9",
     "cross-spawn": "^7.0.6",
-    "extension-create": "4.1.2",
-    "extension-develop": "4.1.2",
-    "extension-install": "4.1.2",
+    "extension-create": "4.1.29",
+    "extension-develop": "4.1.29",
+    "extension-install": "4.1.29",
     "ws": "^8.20.0"
   },
   "devDependencies": {

package/server.json

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