@extension.dev/mcp 10.0.0 → 10.2.0

package/dist/src/index.d.ts

@@ -7,5 +7,12 @@ export interface ToolModule {
     handler: (args: any) => Promise<string>;
 }
 export declare const tools: ToolModule[];
+export declare function toolResultFrame(result: string): {
+    content: Array<{
+        type: "text";
+        text: string;
+    }>;
+    isError?: boolean;
+};
 export declare function startServer(): Promise<void>;
 export declare function runCli(cmd: string, args: string[]): Promise<number>;

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

@@ -37,6 +37,7 @@ export interface ArtifactListing {
     matched: number;
     limit: number;
     truncated: boolean;
+    truncatedReported: boolean;
     scanned: number;
 }
 export interface ArtifactRevocation {
@@ -56,6 +57,7 @@ export type ArtifactsOutcome<T> = {
     };
 };
 export declare function parseArtifactRef(input: string): string | null;
+export declare function wwwRevokeUrl(value: string): string;
 export declare function listArtifacts(options?: {
     limit?: number;
     liveOnly?: boolean;

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

@@ -5,6 +5,8 @@ export interface ProfileLockOwner {
 }
 export type BootVerdict = {
     kind: "alive";
+} | {
+    kind: "silent-within-budget";
 } | {
     kind: "exited";
     exitCode: number | null;
@@ -28,10 +30,8 @@ export type BootVerdict = {
 };
 export interface BootReading {
     verdict: BootVerdict;
-    /** The CLI stamped a schema-1 ready contract, so no prose was read. */
     machineContract: boolean;
-    /** Denoised session-log tail, evidence of last resort. Never branched on. */
-    output: string;
+    evidenceTail: string;
     warnings: string[];
 }
 export interface PollOptions {
@@ -39,15 +39,8 @@ export interface PollOptions {
     readOutput: () => string;
     budgetMs: number;
     since: number;
-    /** A build-only session never launches a browser, so it has no browser legs. */
     noBrowser?: boolean;
     intervalMs?: number;
 }
-export declare function readyContractPath(projectPath: string, browser: string): string;
 export declare function speaksMachineContract(contract: unknown): boolean;
-/**
- * Poll the dev server's own contract for a boot verdict, and only fall back to
- * reading its output when the contract never lands. Replaces a blind sleep plus
- * a regex over first-party copy.
- */
 export declare function pollBootVerdict(projectPath: string, browser: string, options: PollOptions): Promise<BootReading>;

package/dist/src/lib/carrier-exit.d.ts

@@ -0,0 +1,8 @@
+import { type CarrierRemoval } from "./carrier";
+export type CarrierSweepEntry = CarrierRemoval & {
+    projectPath: string;
+};
+export declare function sweepCarriers(projectPaths: string[]): CarrierSweepEntry[];
+export declare function sweepCarriersPlacedHere(): CarrierSweepEntry[];
+export declare function installCarrierExitCleanup(): void;
+export declare function uninstallCarrierExitCleanup(): void;

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

@@ -0,0 +1,4 @@
+export declare function rememberCarrier(projectPath: string): void;
+export declare function forgetCarrier(projectPath: string): void;
+export declare function carriersPlacedHere(): string[];
+export declare function rememberedCarriers(): string[];

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

@@ -2,6 +2,14 @@ export declare const CARRIER_DIR_NAME = "extension-dev-live-preview";
 export declare const CARRIER_EXTENSION_ID = "ibppeifnekhjjjmpjfiobccjlicbmgcb";
 export declare function carrierPath(projectPath: string): string;
 export declare function isManagedCarrier(projectPath: string): boolean;
+export type CarrierClaim = {
+    ours: true;
+    how: "marker" | "payload" | "partial";
+} | {
+    ours: false;
+    how: "foreign";
+};
+export declare function claimCarrier(target: string): CarrierClaim;
 export type CarrierRemoval = {
     removed: boolean;
     path: string;

package/dist/src/lib/engine-version.d.ts

@@ -0,0 +1,24 @@
+export declare const OUTPUT_JSON_FLOOR: {
+    readonly act: "3.18.1";
+    readonly doctor: "4.0.11";
+    readonly dev: "4.0.17";
+    readonly build: "4.0.17";
+};
+export type OutputJsonCommand = keyof typeof OUTPUT_JSON_FLOOR;
+export declare function parseVersion(text: string): string | null;
+export declare function compareVersions(a: string, b: string): number | null;
+export interface EngineFacts {
+    version: string | null;
+    outputJsonCommands: readonly string[] | null;
+}
+export declare function resetEngineVersionCache(): void;
+export declare function resolvedEngineFacts(projectPath?: string): Promise<EngineFacts>;
+export declare function resolvedEngineVersion(projectPath?: string): Promise<string | null>;
+export interface OutputJsonVerdict {
+    supported: boolean | null;
+    version: string | null;
+    floor: string;
+}
+export declare function outputJsonVerdict(command: OutputJsonCommand, projectPath?: string): Promise<OutputJsonVerdict>;
+export declare function refusedTheOutputFlag(stderr: string): boolean;
+export declare function outputFlagRefusalMessage(command: OutputJsonCommand, cliName: string, projectPath?: string): Promise<string>;

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

@@ -1,5 +1,6 @@
 export declare const ENVELOPE_SCHEMA: 1;
-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 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_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 declare const ERROR_CODES: ErrorCode[];
 export interface EnvelopeError {
     code: ErrorCode | string;
@@ -32,4 +33,9 @@ export interface EnvelopeInit {
 }
 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/guest-load-oracle.d.ts

@@ -1,3 +1,4 @@
+export declare function isEngineCompanionUrl(url: string): boolean;
 export type GuestTarget = {
     id: string;
     type: string;

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

@@ -2,7 +2,7 @@ import { type StoredCredentials } from "./credentials";
 export declare function tokenTtlNote(workspaceSlug?: string, projectSlug?: string): string;
 type FetchImpl = typeof fetch;
 export declare function resolveApiBase(api?: string): string;
-export declare function safeApiBase(raw: string): {
+export declare function safeApiBase(raw: string, callerSupplied?: string): {
     ok: true;
     base: string;
 } | {
@@ -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,10 @@
 import type { ProcessInfo } from "./types";
-export declare function removeSessionMarker(projectPath: string, browser: string): void;
+export declare function sessionStateDir(): string;
+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/server-identity.d.ts

@@ -0,0 +1,16 @@
+export type ServerIdentityAnswer = {
+    kind: "confirmed";
+    login: string;
+    live: boolean;
+} | {
+    kind: "refused";
+} | {
+    kind: "unavailable";
+    detail: string;
+};
+export declare function askServerIdentity(args: {
+    apiBase: string;
+    token: string;
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}): Promise<ServerIdentityAnswer>;

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/lib/session-paths.d.ts

@@ -0,0 +1,12 @@
+export { actionsPath, browserArtifactsDir, buildSummaryPath, eventsPath, logsPath, readyContractPath, sessionArtifactsRootDir, sessionStateDir, } from "extension-develop/bridge";
+export { readReadyContract, type ReadyContractInfo, } from "extension-develop/bridge";
+export declare function sessionPathHint(file: string): string;
+export declare function profilesRootDir(projectPath: string): string;
+export declare function browserProfileRootDir(projectPath: string, browser: string): string;
+export declare const PERSISTED_PROFILE_DIR_NAME = "dev";
+export interface ProfileRemediationInput {
+    projectPath: string;
+    browser: string;
+    profile?: string;
+}
+export declare function profileRemediation(input: ProfileRemediationInput): string;

package/dist/src/lib/share-cors-probe.d.ts

@@ -0,0 +1,17 @@
+type FetchImpl = typeof fetch;
+export interface ShareCorsVerdict {
+    ok: boolean;
+    checkedUrl: string;
+    origin: string;
+    finalUrl: string;
+    finalStatus: number;
+    redirects: number;
+    allowOrigin: string | null;
+    reason: string;
+}
+export declare function probeShareCors(options: {
+    zipUrl: string;
+    origin: string;
+    fetchImpl?: FetchImpl;
+}): Promise<ShareCorsVerdict>;
+export {};

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

@@ -1,4 +1,4 @@
-export declare const PINNED_COMMIT = "2d2ed9668cca002148d9eecd953a08b54d0bad9d";
+export declare const PINNED_COMMIT = "520a8ede767fe1937c7184f4857408caf9c5934f";
 export declare function templateMetaUrls(): Promise<string[]>;
 export declare function stripTemplatePathPrefix(slug: string, relativePath: string): string;
 export declare function templateFileUrls(slug: string, relativePath: string): Promise<string[]>;

package/dist/src/lib/zip-entries.d.ts

@@ -0,0 +1,5 @@
+export interface ZipListing {
+    names: string[];
+    readable: boolean;
+}
+export declare function readZipEntryNames(zipPath: string): ZipListing;

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

@@ -48,10 +48,29 @@ export declare const schema: {
                 default: boolean;
                 description: string;
             };
+            appName: {
+                type: string;
+                description: string;
+            };
+            bundleId: {
+                type: string;
+                description: string;
+            };
+            macOsOnly: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+            forceRegenerate: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
         };
         required: string[];
     };
 };
+export declare const BUNDLE_ID_PATTERN: RegExp;
 export declare function handler(args: {
     projectPath: string;
     browser?: string;
@@ -62,4 +81,8 @@ export declare function handler(args: {
     silent?: boolean;
     mode?: "development" | "production" | "none";
     skipValidation?: boolean;
+    appName?: string;
+    bundleId?: string;
+    macOsOnly?: boolean;
+    forceRegenerate?: boolean;
 }): Promise<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/logs-constants.d.ts

@@ -1,5 +1,5 @@
-export declare const CONTROL_ENVELOPE_VERSION = 1;
-export declare const CONTROL_WS_PATH = "/extjs-control";
+export { CLOSE_BAD_HELLO, CLOSE_BAD_INSTANCE, CLOSE_CONTROL_UNAVAILABLE, CLOSE_SLOW_CONSUMER, CONTROL_ENVELOPE_VERSION, CONTROL_WS_PATH, LOG_EVENT_VERSION, } from "extension-develop/bridge";
+export declare const CLOSE_REFUSAL_FLOOR = 4000;
 export declare const DEFAULT_LIMIT = 200;
 export declare const DEFAULT_FOLLOW_MS = 4000;
 export declare const MIN_FOLLOW_MS = 500;

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

@@ -1,3 +1,5 @@
+import { readLogEvents } from "extension-develop/bridge";
+export { readLogEvents };
 export interface LogsArgs {
     projectPath: string;
     browser?: string;
@@ -11,4 +13,4 @@ export interface LogsArgs {
     followMs?: number;
     limit?: number;
 }
-export declare function makeFilter(args: LogsArgs): (event: any) => boolean;
+export declare function makeFilter(args: LogsArgs): (event: unknown) => boolean;

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

@@ -1,3 +1,11 @@
 import { type LogsArgs } from "./logs-filter";
+import { type ErrorCode } from "../lib/envelope";
 export { schema } from "./logs-schema";
+export interface ControlRefusal {
+    code: ErrorCode;
+    status: string;
+    message: string;
+    hint: string;
+}
+export declare function controlRefusal(closeCode: number, reason: string, url: string, sentVersion: number): ControlRefusal | undefined;
 export declare function handler(args: LogsArgs): Promise<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/dist/src/tools/whoami.d.ts

@@ -1 +1,3 @@
-export declare function readIdentity(): Promise<string>;
+export declare function readIdentity(deps?: {
+    fetchImpl?: typeof fetch;
+}): Promise<string>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "10.0.0",
+  "version": "10.2.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.17",
-    "extension-develop": "4.0.17",
-    "extension-install": "4.0.17",
+    "extension-create": "4.0.20",
+    "extension-develop": "4.0.20",
+    "extension-install": "4.0.20",
     "ws": "^8.20.0"
   },
   "devDependencies": {
@@ -103,6 +101,22 @@
     "@types/node": "^25.2.0",
     "@types/ws": "^8.18.1",
     "typescript": "6.0.2",
+    "vite": "^8.1.5",
     "vitest": "^4.1.3"
+  },
+  "pnpm": {
+    "overrides": {
+      "hono": "^4.12.27",
+      "@hono/node-server": "^2.0.5",
+      "ws@>=8 <8.21.0": "^8.21.0",
+      "form-data@4": "^4.0.6",
+      "js-yaml@4": "^4.3.0",
+      "fast-uri@3": "^3.1.4",
+      "postcss@8": "^8.5.18",
+      "body-parser@2": "^2.3.0",
+      "ip-address@10": "^10.1.1",
+      "qs@6": "^6.15.2",
+      "vite@8": "^8.0.16"
+    }
   }
 }

package/server.json

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