@extension.dev/mcp 10.10.10 → 10.10.12

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

@@ -34,6 +34,7 @@ export interface ListedArtifact {
 }
 export interface ArtifactListing {
     artifacts: ListedArtifact[];
+    malformedRows?: number;
     count: number;
     matched: number;
     limit: number;

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

@@ -7,6 +7,8 @@ export type DevToolsPanelOutcome = {
         targetId: string;
         url: string;
     } | null;
+    panelTargetInferred?: boolean;
+    panelFrameCandidates?: number;
     panels: string[];
     reloadedInspected: boolean;
 } | {
@@ -15,6 +17,8 @@ export type DevToolsPanelOutcome = {
     reason: string;
     devtoolsTargetId?: string;
     panels?: string[];
+    registryUnreadable?: string;
+    devtoolsPageLoaded?: boolean;
 };
 export declare function panelIdPrefix(extensionId: string): string;
 export declare function panelTitleFromId(panelId: string, extensionId: string): string;

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

@@ -1,7 +1,16 @@
 import { type PageTarget } from "./cdp-targets";
+type RemoteObject = {
+    type?: string;
+    subtype?: string;
+    objectId?: string;
+    value?: unknown;
+    description?: string;
+    unserializableValue?: string;
+};
 export type ExtensionPageEval = {
     ok: true;
     value: unknown;
+    note?: string;
 } | {
     ok: false;
     message: string;
@@ -10,6 +19,7 @@ export type ExtensionPageEval = {
 };
 export declare function matchExtensionPageTargets(targets: PageTarget[], wantedUrl: string): PageTarget[];
 export declare const WORKER_TARGET_TYPES: Set<string>;
+export declare const BACKGROUND_TARGET_TYPES: Set<string>;
 export type TargetsRead<T> = {
     targets: T[];
 } | {
@@ -39,6 +49,7 @@ export type WorkerWake = {
 export declare function wakeExtensionWorker(port: number, extensionId: string): Promise<WorkerWake>;
 export declare function readExtensionPageTargets(port: number, wantedUrl: string): Promise<TargetsRead<PageTarget>>;
 export declare function findExtensionPageTargets(port: number, wantedUrl: string): Promise<PageTarget[]>;
+export declare function remoteValueNote(result: RemoteObject | undefined): string | undefined;
 export declare function evaluateOnExtensionPage(port: number, targetId: string, expression: string, timeoutMs?: number): Promise<ExtensionPageEval>;
 export type SidePanelGestureOutcome = {
     opened: true;
@@ -49,3 +60,4 @@ export type SidePanelGestureOutcome = {
     reason: string;
 };
 export declare function openSidePanelWithSyntheticGesture(port: number, hostUrl: string, excludeTargetIds?: ReadonlySet<string>): Promise<SidePanelGestureOutcome>;
+export {};

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

@@ -15,7 +15,7 @@ export declare const SESSION_BROWSER: {
 };
 export declare const CALL_TIMEOUT: {
     readonly type: "number";
-    readonly description: "Command timeout in ms (default 5000)";
+    readonly description: "Command timeout in ms. When omitted, the default depends on the route: 30000 through the dev session's control channel, 10000 over the Firefox debugger protocol, and 15000 per command over the Chromium debug port.";
 };
 export declare const API_BASE: {
     readonly type: "string";

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

@@ -1,4 +1,5 @@
 import type { ChildProcess } from "node:child_process";
+export declare function killWindowsTree(pid: number): boolean;
 export interface CliResult {
     code: number | null;
     signal?: NodeJS.Signals | null;

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

@@ -1,5 +1,11 @@
 export type PidState = "alive" | "dead" | "foreign";
 export declare const PLAUSIBLE_SESSION_BINARY: RegExp;
+export interface WindowsProcessRow {
+    pid: number;
+    name: string;
+    commandLine: string;
+}
+export declare function readWindowsProcessTable(): WindowsProcessRow[] | null;
 export declare function processCommand(pid: number): string;
 export declare function pidState(pid: number): PidState;
 export declare function describeForeignPid(pid: number): string;

package/dist/src/lib/process-manager.d.ts

@@ -6,7 +6,7 @@ export declare function readSessionMarkers(): {
     unreadable: string | null;
 };
 export declare function listSessionMarkers(): ProcessInfo[];
-export declare function registerSession(info: ProcessInfo): void;
+export declare function registerSession(info: ProcessInfo): string | null;
 export declare function sessionSinceMs(projectPath: string, browser: string): number | null;
 export declare function getSession(projectPath: string, browser: string): ProcessInfo | undefined;
 export declare function findSessionInfo(projectPath: string, browser: string): ProcessInfo | undefined;

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

@@ -28,6 +28,9 @@ export type RegistryFetchResult<T> = {
     ok: true;
     json: T;
 } | RegistryFetchRefusal;
+export declare function channelsShapeProblem(json: unknown): string | null;
+export declare function buildIndexShapeProblem(json: unknown): string | null;
+export declare function requireShape<T>(read: RegistryFetchResult<T>, problem: (json: unknown) => string | null): RegistryFetchResult<T>;
 export declare function fetchRegistryJson<T = unknown>(url: string, fetchImpl?: typeof fetch, options?: {
     ref?: ProjectRef | null;
     api?: string;

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

@@ -28,7 +28,7 @@ export declare const schema: {
             };
             timeout: {
                 readonly type: "number";
-                readonly description: "Command timeout in ms (default 5000)";
+                readonly description: "Command timeout in ms. When omitted, the default depends on the route: 30000 through the dev session's control channel, 10000 over the Firefox debugger protocol, and 15000 per command over the Chromium debug port.";
             };
         };
         required: string[];

package/dist/src/tools/dom-snapshot.d.ts

@@ -60,7 +60,7 @@ export declare const schema: {
             };
             timeout: {
                 readonly type: "number";
-                readonly description: "Command timeout in ms (default 5000)";
+                readonly description: "Command timeout in ms. When omitted, the default depends on the route: 30000 through the dev session's control channel, 10000 over the Firefox debugger protocol, and 15000 per command over the Chromium debug port.";
             };
         };
         required: string[];

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

@@ -33,7 +33,7 @@ export declare const schema: {
             };
             timeout: {
                 readonly type: "number";
-                readonly description: "Command timeout in ms (default 5000)";
+                readonly description: "Command timeout in ms. When omitted, the default depends on the route: 30000 through the dev session's control channel, 10000 over the Firefox debugger protocol, and 15000 per command over the Chromium debug port.";
             };
         };
         required: string[];

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

@@ -1,5 +1,6 @@
 import { surfaceForExtensionUrl } from "../lib/extension-surfaces";
 export { surfaceForExtensionUrl };
+export declare function matchPatternRegexSource(pattern: string): string;
 export declare function executeScriptExpression(urlFilter: string | undefined, code: string, tabId?: number): string;
 export declare function inspectViaBridge(args: {
     projectPath: string;

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

@@ -1,6 +1,7 @@
 import { readLogEvents as engineReadLogEvents, type LogQuery } from "extension-develop/bridge";
 export { type LogQuery };
 export declare function readLogEvents(projectPath: string, browser: string, query: LogQuery): ReturnType<typeof engineReadLogEvents>;
+export declare function readLogDropped(projectPath: string, browser: string): number;
 export interface LogsArgs {
     projectPath: string;
     browser?: string;

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

@@ -68,7 +68,7 @@ export declare const schema: {
             };
             timeout: {
                 readonly type: "number";
-                readonly description: "Command timeout in ms (default 5000)";
+                readonly description: "Command timeout in ms. When omitted, the default depends on the route: 30000 through the dev session's control channel, 10000 over the Firefox debugger protocol, and 15000 per command over the Chromium debug port.";
             };
         };
         required: string[];

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

@@ -24,7 +24,7 @@ export declare const schema: {
             };
             timeout: {
                 readonly type: "number";
-                readonly description: "Command timeout in ms (default 5000)";
+                readonly description: "Command timeout in ms. When omitted, the default depends on the route: 30000 through the dev session's control channel, 10000 over the Firefox debugger protocol, and 15000 per command over the Chromium debug port.";
             };
         };
         required: string[];

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

@@ -32,6 +32,7 @@ interface StopOutcome {
     pid: number | null;
     stopped: boolean;
     reaped: number[];
+    reapUnconfirmed?: number[];
     detail: string;
     carrierRemoved?: string;
     carrierNote?: string;

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

@@ -32,7 +32,7 @@ export declare const schema: {
             };
             timeout: {
                 readonly type: "number";
-                readonly description: "Command timeout in ms (default 5000)";
+                readonly description: "Command timeout in ms. When omitted, the default depends on the route: 30000 through the dev session's control channel, 10000 over the Firefox debugger protocol, and 15000 per command over the Chromium debug port.";
             };
         };
         required: string[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "10.10.10",
+  "version": "10.10.12",
   "description": "MCP server that lets AI agents (Claude Code, Claude Desktop, Cursor, Copilot, Codex) build, run, inspect, and publish browser extensions. 32 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",
@@ -49,7 +49,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "docs:tools": "node scripts/generate-mcp-tools.mjs",
+    "docs:tools": "WRITE_TOOLS_DOC=1 vitest run src/__tests__/docs-match-the-code.test.ts",
     "clean": "rm -rf dist",
     "readme:clients": "UPDATE_README=1 vitest run src/__tests__/readme-clients.test.ts",
     "watch": "rslib build --watch",
@@ -132,7 +132,11 @@
       "brace-expansion@5": "^5.0.12",
       "nanoid@3": "^3.3.19",
       "devalue@5": "^5.9.2",
-      "postcss-selector-parser@7": "^7.1.6"
+      "postcss-selector-parser@7": "^7.1.6",
+      "proxy-addr@2": "^2.0.8",
+      "source-map-js@1": "^1.2.2",
+      "vue@3": "^3.5.43",
+      "@vue/compiler-sfc@3": "^3.5.43"
     }
   }
 }

package/server.json

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