@extension.dev/mcp 9.0.0 → 10.1.0

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

@@ -1,5 +1,8 @@
 export declare function toMcpSpeak(text: string): string;
-export declare function runActVerb(args: string[], projectPath: string, timeoutMs?: number): Promise<string>;
+export declare function runActVerb(args: string[], projectPath: string, timeoutMs?: number, tool?: string): Promise<string>;
+export declare function addWarning(frame: any, text: unknown): void;
+export declare function actFrameJson(frame: unknown): string;
+export declare function patchValue(frame: any, patch: Record<string, unknown>): void;
 export interface ActArgs {
     projectPath: string;
     browser?: string;

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

@@ -0,0 +1,47 @@
+import type { ChildProcess } from "node:child_process";
+export interface ProfileLockOwner {
+    host?: string;
+    pid?: number;
+}
+export type BootVerdict = {
+    kind: "alive";
+} | {
+    kind: "silent-within-budget";
+} | {
+    kind: "exited";
+    exitCode: number | null;
+    signal: string | null;
+} | {
+    kind: "compile-failed";
+    message?: string;
+    compileErrors: string[];
+} | {
+    kind: "browser-exited";
+    stamp: {
+        code?: string;
+        browserExitCode?: number | null;
+        browserExitedAt?: string;
+    };
+} | {
+    kind: "profile-locked";
+    owner: ProfileLockOwner | null;
+    message?: string;
+    lockedAt?: string;
+};
+export interface BootReading {
+    verdict: BootVerdict;
+    machineContract: boolean;
+    evidenceTail: string;
+    warnings: string[];
+}
+export interface PollOptions {
+    child: ChildProcess;
+    readOutput: () => string;
+    budgetMs: number;
+    since: number;
+    noBrowser?: boolean;
+    intervalMs?: number;
+}
+export declare function readyContractPath(projectPath: string, browser: string): string;
+export declare function speaksMachineContract(contract: unknown): boolean;
+export declare function pollBootVerdict(projectPath: string, browser: string, options: PollOptions): Promise<BootReading>;

package/dist/src/lib/bridge-tabs.d.ts

@@ -3,12 +3,12 @@ export interface BridgeTab {
     url: string;
     title: string;
 }
-export declare function listBridgeTabs(projectPath: string, browser: string, timeout?: number): Promise<{
+export declare function listBridgeTabs(projectPath: string, browser: string, timeout?: number, tool?: string): Promise<{
     tabs: BridgeTab[];
 } | {
     error: string;
 }>;
 export declare function matchTabsByUrl(tabs: BridgeTab[], needle: string): BridgeTab[];
 export declare function pollForBridgeTab(projectPath: string, browser: string, url: string, budgetMs: number): Promise<BridgeTab | null>;
-export declare function navigateToUrlViaBridge(projectPath: string, browser: string, url: string, timeout?: number): Promise<string>;
+export declare function navigateToUrlViaBridge(projectPath: string, browser: string, url: string, timeout?: number, tool?: string): Promise<string>;
 export declare function resolveBridgeBaseUrl(projectPath: string, browser: string, timeout?: number): Promise<string | null>;

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

@@ -0,0 +1,41 @@
+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_AUTH_DENIED" | "E_AUTH_EXPIRED" | "E_AUTH_FAILED" | "E_AUTH_PENDING" | "E_AUTH_REQUIRED" | "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_ENTRYPOINT_MISSING" | "E_FIRST_COMPILE" | "E_INPUT_VALIDATION" | "E_INTERNAL" | "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_PROFILE_LOCKED" | "E_RDP" | "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;
+    message: string;
+    name?: string;
+    engine?: string | null;
+    hint?: string;
+    [key: string]: unknown;
+}
+export interface Envelope {
+    schema: typeof ENVELOPE_SCHEMA;
+    ok: boolean;
+    command: string;
+    status: string;
+    value: unknown;
+    error: EnvelopeError | null;
+    truncated?: boolean;
+    hint?: string;
+    warnings: string[];
+}
+export interface EnvelopeInit {
+    ok: boolean;
+    command: string;
+    status: string;
+    value?: unknown;
+    error?: EnvelopeError | null;
+    truncated?: boolean;
+    hint?: string;
+    warnings?: (string | null | undefined | false)[];
+}
+export declare function envelopeObject(init: EnvelopeInit): Envelope;
+export declare function envelope(init: EnvelopeInit): string;
+export declare function sessionCommandSinceEnvelopeOwnsCommand(contract: {
+    command?: string;
+}): {
+    sessionCommand?: string;
+};
+export declare function isEnvelope(frame: unknown): frame is Envelope;

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

@@ -4,6 +4,8 @@ export interface CliResult {
     stdout: string;
     stderr: string;
 }
+export declare function pinnedCliVersion(): string;
+export declare function exactVersion(spec: string): string;
 export declare function resolveExtensionInvocation(projectDir?: string): {
     command: string;
     prefixArgs: string[];
@@ -16,8 +18,10 @@ export interface SpawnedCli {
     child: ChildProcess;
     logPath: string;
     readOutput: () => string;
+    spawnError?: () => Error | null;
 }
 export declare function spawnExtensionCli(args: string[], options?: {
     cwd?: string;
     projectDir?: string;
 }): SpawnedCli;
+export declare function spawnFailedEnvelope(command: string, spawned: SpawnedCli): Promise<string>;

package/dist/src/lib/legacy-stdout.d.ts

@@ -0,0 +1,7 @@
+/** @deprecated see the module note. */
+export declare function denoiseCliLog(raw: string): string;
+/** @deprecated Replaced by `ready.json` `status:"error"`. */
+export declare function legacyCompileScrape(cleanOutput: string): boolean;
+/** @deprecated Replaced by `ready.json` `code:"profile_locked"`. */
+export declare function legacyProfileLockScrape(cleanOutput: string): boolean;
+export declare const LEGACY_FIDELITY_WARNING = "This session ran a CLI that does not stamp the machine contract, so the boot verdict was read from the dev server's output instead of its ready contract. Diagnostics are less precise: compile errors come back as a text tail rather than a list. Upgrade the project's extension dependency to get the precise verdict.";

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

@@ -17,6 +17,7 @@ export interface LoginConfig {
 export declare function fetchLoginConfig(apiBase: string, fetchImpl?: FetchImpl): Promise<LoginConfig>;
 export declare function persistTokenResponse(args: {
     apiBase: string;
+    project: string;
     data: Record<string, unknown>;
 }): StoredCredentials;
 export {};

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

@@ -1,8 +1,9 @@
 import type { ProcessInfo } from "./types";
-export declare function removeSessionMarker(projectPath: string, browser: string): void;
+export declare function removeSessionMarker(projectPath: string, browser: string, pid?: number): void;
 export declare function listSessionMarkers(): ProcessInfo[];
 export declare function registerSession(info: ProcessInfo): void;
+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;
-export declare function removeSession(projectPath: string, browser: string): void;
+export declare function removeSession(projectPath: string, browser: string, pid?: number): void;
 export declare function listSessions(): ProcessInfo[];

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

@@ -6,7 +6,7 @@ export declare function knownSessionBrowsers(projectPath: string): string[];
 export interface LiveSession {
     browser: string;
     pid: number;
-    source: "registry" | "contract";
+    source: "registry" | "contract" | "marker";
 }
 export declare function liveProjectSessions(projectPath: string): LiveSession[];
 export declare function deadReadySession(projectPath: string): {

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

@@ -0,0 +1,48 @@
+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)";
+            };
+            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: number;
+                description: string;
+            };
+            deepDom: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};

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

@@ -1,51 +1,5 @@
-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)";
-            };
-            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: number;
-                description: string;
-            };
-            deepDom: {
-                type: string;
-                default: boolean;
-                description: string;
-            };
-        };
-        required: string[];
-    };
-};
+import { schema } from "./inspect-schema";
+export { schema };
 export declare function handler(args: {
     projectPath: string;
     url?: string;

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

@@ -5,6 +5,7 @@ export interface SubmitToolArgs {
     channel?: string;
     version?: string;
     dryRun?: boolean;
+    projectPath?: string;
     api?: string;
 }
 export declare const schema: {
@@ -38,6 +39,10 @@ export declare const schema: {
                 default: boolean;
                 description: string;
             };
+            projectPath: {
+                type: string;
+                description: string;
+            };
             api: {
                 readonly type: "string";
                 readonly description: "Platform base URL (default EXTENSION_DEV_API_URL, else https://www.extension.dev)";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "9.0.0",
+  "version": "10.1.0",
   "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.",
   "mcpName": "io.github.extensiondev/mcp",
   "license": "Apache-2.0",
@@ -42,9 +42,7 @@
     "server.json",
     "README.md",
     "CHANGELOG.md",
-    "LICENSE",
-    "NOTICE",
-    "TRADEMARK.md"
+    "LICENSE"
   ],
   "scripts": {
     "clean": "rm -rf dist",
@@ -91,9 +89,9 @@
     "@modelcontextprotocol/sdk": "^1.12.1",
     "browser-extension-manifest-fields": "^2.2.9",
     "cross-spawn": "^7.0.6",
-    "extension-create": "4.0.16-canary.1784889479.74e12044",
-    "extension-develop": "4.0.16-canary.1784889479.74e12044",
-    "extension-install": "4.0.16-canary.1784889479.74e12044",
+    "extension-create": "4.0.17",
+    "extension-develop": "4.0.17",
+    "extension-install": "4.0.17",
     "ws": "^8.20.0"
   },
   "devDependencies": {

package/server.json

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