@extension.dev/mcp 10.1.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

@@ -42,6 +42,5 @@ export interface PollOptions {
     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/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,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_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 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;

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;
 } | {

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

@@ -1,4 +1,5 @@
 import type { ProcessInfo } from "./types";
+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;

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-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/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/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.1.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",
@@ -89,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": {
@@ -101,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.1.0",
+  "version": "10.2.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@extension.dev/mcp",
-      "version": "10.1.0",
+      "version": "10.2.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"