@extension.dev/mcp 9.0.0 → 10.0.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,53 @@
+import type { ChildProcess } from "node:child_process";
+export interface ProfileLockOwner {
+    host?: string;
+    pid?: number;
+}
+export type BootVerdict = {
+    kind: "alive";
+} | {
+    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;
+    /** 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;
+    warnings: string[];
+}
+export interface PollOptions {
+    child: ChildProcess;
+    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/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,35 @@
+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 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 isEnvelope(frame: unknown): frame is Envelope;

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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@extension.dev/mcp",
   "type": "module",
-  "version": "9.0.0",
+  "version": "10.0.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",
@@ -91,9 +91,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.0.0",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@extension.dev/mcp",
-      "version": "9.0.0",
+      "version": "10.0.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"