@extension.dev/mcp 5.2.0 → 5.3.1

package/dist/src/__tests__/setup-session-dir.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,4 +1,6 @@
 import type { ProcessInfo } from "./types";
+export declare function removeSessionMarker(projectPath: string, browser: string): void;
+export declare function listSessionMarkers(): ProcessInfo[];
 export declare function registerSession(info: ProcessInfo): void;
 export declare function getSession(projectPath: string, browser: string): ProcessInfo | undefined;
 export declare function removeSession(projectPath: string, browser: string): void;

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

@@ -0,0 +1,72 @@
+export declare const REGISTRY_BASE_DEFAULT = "https://registry.extension.land";
+export declare const CONSOLE_BASE = "https://console.extension.dev";
+export declare function registryBase(): string;
+export interface ProjectRef {
+    workspace: string;
+    project: string;
+}
+/**
+ * Resolve which project registry reads should target: explicit overrides
+ * first, then the stored login's workspace/project slugs. Returns null when
+ * neither names a project (e.g. token came from EXTENSION_DEV_TOKEN and no
+ * login was ever stored).
+ */
+export declare function resolveProjectRef(overrides?: {
+    workspace?: string;
+    project?: string;
+}): ProjectRef | null;
+/** URL of a file under the project's `_extension-dev/` registry directory. */
+export declare function registryFileUrl(ref: ProjectRef, file: string): string;
+/** Console page URL for the project (builds, releases/new, stores, ...). */
+export declare function consoleProjectUrl(ref: ProjectRef | null, page: string): string;
+export type RegistryFetchResult<T> = {
+    ok: true;
+    json: T;
+} | {
+    ok: false;
+    status?: number;
+    message: string;
+};
+/**
+ * Fetch a registry JSON file. Never throws: 404s (private or never-built
+ * projects), network failures, and non-JSON bodies all come back as
+ * `{ok:false}` so callers can degrade honestly instead of crashing the verb.
+ */
+export declare function fetchRegistryJson<T = unknown>(url: string, fetchImpl?: typeof fetch): Promise<RegistryFetchResult<T>>;
+export interface ChannelEntry {
+    channel: string;
+    sha: string;
+    buildId?: string;
+    version?: string;
+    /** ISO timestamp parsed from the channel row when the writer recorded one. */
+    promotedAt?: string;
+    description?: string;
+}
+/**
+ * Normalize the registry's channels.json (a map of channel -> row) into a
+ * list. `promotedAt` is not a first-class field in the file today; the
+ * promote workflow stamps it into the description ("Promoted from X on
+ * <ISO>"), so it is parsed back out when present.
+ */
+export declare function parseChannels(json: unknown): ChannelEntry[];
+export interface BuildIndexItem {
+    sha: string;
+    commit?: string;
+    channel?: string;
+    buildEnv?: string;
+    status?: string;
+    version?: string;
+    message?: string;
+    timestamp?: string;
+    browsers?: string[];
+}
+/** Normalize `_extension-dev/builds/index.json` items (schemaVersion 3). */
+export declare function parseBuildIndex(json: unknown): BuildIndexItem[];
+/**
+ * Derive the project mirror repo's Actions URL from any GitHub run URL the
+ * registry exposes (stores/status.json carries one from the mirror's own
+ * runs: https://github.com/extensiondev/<ownerGithubId>--<projectId>/actions/
+ * runs/<id>). Only trusts the extensiondev org so a user-source-repo run URL
+ * (build.json's runUrl) is never mistaken for the mirror.
+ */
+export declare function mirrorActionsUrlFromRunUrl(runUrl: unknown): string | null;

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

@@ -3,6 +3,12 @@ export interface ResolvedBrowser {
     source: "explicit" | "session" | "contract" | "stale" | "fallback";
 }
 export declare function knownSessionBrowsers(projectPath: string): string[];
+export interface LiveSession {
+    browser: string;
+    pid: number;
+    source: "registry" | "contract";
+}
+export declare function liveProjectSessions(projectPath: string): LiveSession[];
 export declare function deadReadySession(projectPath: string): {
     browser: string;
     pid: number;

package/dist/src/lib/validate-input.d.ts

@@ -4,4 +4,9 @@ export interface InputIssue {
 }
 export declare function normalizeArgAliases(inputSchema: Record<string, unknown>, args: Record<string, unknown>): Record<string, unknown>;
 export declare function validateToolInput(inputSchema: Record<string, unknown>, args: Record<string, unknown>): InputIssue[];
-export declare function inputValidationError(toolName: string, issues: InputIssue[]): string;
+export declare function describeToolArgs(inputSchema: Record<string, unknown>): {
+    required: string[];
+    optional: string[];
+    aliases: Record<string, string[]>;
+};
+export declare function inputValidationError(toolName: string, issues: InputIssue[], inputSchema?: Record<string, unknown>): string;

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

@@ -5,6 +5,11 @@ export declare const schema: {
     inputSchema: {
         type: "object";
         properties: {
+            replace: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
             allowControl: {
                 type: string;
                 default: boolean;
@@ -79,6 +84,7 @@ export declare function handler(args: {
     port?: number;
     noBrowser?: boolean;
     polyfill?: boolean;
+    replace?: boolean;
     allowControl?: boolean;
     allowEval?: boolean;
 } & LaunchFlagArgs): Promise<string>;

package/dist/src/tools/release-list.d.ts

@@ -0,0 +1,22 @@
+export declare const schema: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            workspace: {
+                type: string;
+                description: string;
+            };
+            project: {
+                type: string;
+                description: string;
+            };
+        };
+        required: never[];
+    };
+};
+export declare function handler(args: {
+    workspace?: string;
+    project?: string;
+}): Promise<string>;

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

@@ -21,8 +21,18 @@ export declare const schema: {
         required: never[];
     };
 };
+interface StopOutcome {
+    projectPath: string;
+    browser: string;
+    pid: number | null;
+    stopped: boolean;
+    reaped: number[];
+    detail: string;
+}
+export declare function stopOne(projectPath: string, browser: string): Promise<StopOutcome>;
 export declare function handler(args: {
     projectPath?: string;
     browser?: string;
     all?: boolean;
 }): Promise<string>;
+export {};

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "5.2.0",
-  "description": "MCP server that lets AI agents (Claude Code, Claude Desktop, Cursor, Copilot, Codex) build, run, inspect, and publish browser extensions. 31 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.",
+  "version": "5.3.1",
+  "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": "MIT",
   "author": {

package/server.json

@@ -1,19 +1,19 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
   "name": "io.github.extensiondev/mcp",
-  "description": "Build, run, inspect, and publish browser extensions from any MCP client. 31 tools, 11 browsers.",
+  "description": "Build, run, inspect, and publish browser extensions from any MCP client. 32 tools, 11 browsers.",
   "repository": {
     "url": "https://github.com/extensiondev/mcp",
     "source": "github"
   },
   "websiteUrl": "https://extension.dev",
-  "version": "5.2.0",
+  "version": "5.3.1",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@extension.dev/mcp",
-      "version": "5.2.0",
+      "version": "5.3.1",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"