@extension.dev/mcp 10.10.8 → 10.10.10

package/dist/src/index.d.ts

@@ -1,6 +1,7 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { version } from "../package.json";
 export { version };
+export { renderToolsDoc } from "./lib/docs-tools";
 import { type ServerOptions } from "./lib/tool-policy";
 export interface ToolModule {
     schema: {

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

@@ -1,4 +1,4 @@
-export declare const FREE_ALLOWANCE_PHRASE = "counts against your free allowance";
+export declare const ALLOWANCE_PHRASE = "is metered against your plan's allowance on extension.dev";
 export interface SpendNarration {
     spent: string;
     remains: string;

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

@@ -15,6 +15,10 @@ export type BootVerdict = {
     kind: "compile-failed";
     message?: string;
     compileErrors: string[];
+} | {
+    kind: "boot-failed";
+    code?: string;
+    message?: string;
 } | {
     kind: "browser-exited";
     stamp: {
@@ -43,4 +47,5 @@ export interface PollOptions {
     intervalMs?: number;
 }
 export declare function speaksMachineContract(contract: unknown): boolean;
+export declare function bootFailureHint(code: string | undefined): string;
 export declare function pollBootVerdict(projectPath: string, browser: string, options: PollOptions): Promise<BootReading>;

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

@@ -9,7 +9,9 @@ export declare function listBridgeTabs(projectPath: string, browser: string, tim
     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 pollForBridgeTab(projectPath: string, browser: string, url: string, budgetMs: number): Promise<BridgeTab | null | {
+    unreadable: string;
+}>;
 export interface NavigateTarget {
     tab?: number;
     newTab?: boolean;

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

@@ -3,3 +3,4 @@ export declare const GECKO_FAMILY: ReadonlySet<string>;
 export declare const WEBKIT_FAMILY: ReadonlySet<string>;
 export declare function isChromiumFamily(browser: string): boolean;
 export declare function isGeckoFamily(browser: string): boolean;
+export declare function engineBrowserName(browser: string): string;

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

@@ -1,4 +1,8 @@
 export declare function rememberCarrier(projectPath: string): void;
 export declare function forgetCarrier(projectPath: string): void;
 export declare function carriersPlacedHere(): string[];
+export declare function readRememberedCarriers(): {
+    carriers: string[];
+    unreadable: string | null;
+};
 export declare function rememberedCarriers(): string[];

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

@@ -1,5 +1,10 @@
 export declare const CARRIER_DIR_NAME = "extension-dev-live-preview";
 export declare const CARRIER_EXTENSION_ID = "ibppeifnekhjjjmpjfiobccjlicbmgcb";
+export declare const CARRIER_TRUSTED_ORIGINS: readonly ["https://preview.extension.dev", "https://code.extension.dev", "https://themes.extension.dev"];
+export declare const CARRIER_TRUSTED_LOCAL_HOSTS: readonly ["localhost", "127.0.0.1"];
+export declare const CARRIER_TRUSTED_LOCAL_PORTS: readonly ["3103", "3104", "3110", "3111"];
+export declare const CARRIER_REFUSAL_SENTENCE = "This page is not one the Live Preview carrier answers.";
+export declare const CARRIER_ALLOWED_ORIGINS_SENTENCE: string;
 export declare function carrierPath(projectPath: string): string;
 export declare function isManagedCarrier(projectPath: string): boolean;
 export type CarrierClaim = {
@@ -16,12 +21,16 @@ export type CarrierRemoval = {
     note?: string;
 };
 export declare function removeCarrier(projectPath: string): CarrierRemoval;
-export declare function ensureCarrierIgnored(projectPath: string): string | null;
+export declare function ensureCarrierIgnored(projectPath: string): {
+    entry: string | null;
+    state: "added" | "already-ignored" | "not-a-repo" | "failed";
+};
 export type CarrierMaterialization = {
     loaded: boolean;
     path?: string;
     note: string;
     gitignored?: string;
+    gitignoreNote?: string;
     limitations?: string[];
     graduation?: string;
     bridgeProtocol?: {

package/dist/src/lib/cdp-connection.d.ts

@@ -8,7 +8,7 @@ export declare class CDPConnection {
     disconnect(): void;
     private handleMessage;
     private rejectAllPending;
-    sendCommand(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<unknown>;
+    sendCommand(method: string, params?: Record<string, unknown>, sessionId?: string, timeoutMs?: number): Promise<unknown>;
     getConsoleMessages(): Array<{
         level: string;
         text: string;
@@ -16,5 +16,6 @@ export declare class CDPConnection {
         timestamp: number;
     }>;
     getConsoleSummary(): Record<string, unknown>;
+    resetConsole(): void;
     protected onEvent(handler: (msg: Record<string, unknown>) => void): () => void;
 }

package/dist/src/lib/cdp-devtools.d.ts

@@ -8,6 +8,7 @@ export type DevToolsPanelOutcome = {
         url: string;
     } | null;
     panels: string[];
+    reloadedInspected: boolean;
 } | {
     opened: false;
     stage: "open" | "frontend" | "panel" | "show";

package/dist/src/lib/cdp-extension-page.d.ts

@@ -6,9 +6,20 @@ export type ExtensionPageEval = {
     ok: false;
     message: string;
     thrown: boolean;
+    timedOut?: boolean;
 };
 export declare function matchExtensionPageTargets(targets: PageTarget[], wantedUrl: string): PageTarget[];
 export declare const WORKER_TARGET_TYPES: Set<string>;
+export type TargetsRead<T> = {
+    targets: T[];
+} | {
+    unreadable: string;
+};
+export declare function readExtensionWorkerTargets(port: number, extensionId: string): Promise<TargetsRead<{
+    targetId: string;
+    type: string;
+    url: string;
+}>>;
 export declare function findExtensionWorkerTargets(port: number, extensionId: string): Promise<Array<{
     targetId: string;
     type: string;
@@ -26,8 +37,9 @@ export type WorkerWake = {
     reason: string;
 };
 export declare function wakeExtensionWorker(port: number, extensionId: string): Promise<WorkerWake>;
+export declare function readExtensionPageTargets(port: number, wantedUrl: string): Promise<TargetsRead<PageTarget>>;
 export declare function findExtensionPageTargets(port: number, wantedUrl: string): Promise<PageTarget[]>;
-export declare function evaluateOnExtensionPage(port: number, targetId: string, expression: string): Promise<ExtensionPageEval>;
+export declare function evaluateOnExtensionPage(port: number, targetId: string, expression: string, timeoutMs?: number): Promise<ExtensionPageEval>;
 export type SidePanelGestureOutcome = {
     opened: true;
     targetId: string;
@@ -36,4 +48,4 @@ export type SidePanelGestureOutcome = {
     opened: false;
     reason: string;
 };
-export declare function openSidePanelWithSyntheticGesture(port: number, hostUrl: string): Promise<SidePanelGestureOutcome>;
+export declare function openSidePanelWithSyntheticGesture(port: number, hostUrl: string, excludeTargetIds?: ReadonlySet<string>): Promise<SidePanelGestureOutcome>;

package/dist/src/lib/cdp-page-scripts.d.ts

@@ -1,6 +1,6 @@
 export declare const PAGE_HTML_SCRIPT = "(() => {\n        try {\n          const doctype = document.doctype;\n          const dt = doctype\n            ? '<!DOCTYPE ' + doctype.name\n              + (doctype.publicId ? ' PUBLIC \"' + doctype.publicId + '\"' : '')\n              + (doctype.systemId ? ' \"' + doctype.systemId + '\"' : '')\n              + '>'\n            : '';\n          // Include shadow DOM content from extension roots\n          const roots = Array.from(document.querySelectorAll(\n            '#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])'\n          ));\n          if (roots.length) {\n            const clone = document.documentElement.cloneNode(true);\n            const clonedRoots = Array.from(clone.querySelectorAll(\n              '#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])'\n            ));\n            const s = new XMLSerializer();\n            for (let i = 0; i < Math.min(roots.length, clonedRoots.length); i++) {\n              const sr = roots[i].shadowRoot;\n              if (!sr) continue;\n              try {\n                const shadow = Array.from(sr.childNodes).map(n => {\n                  try { return s.serializeToString(n); } catch { return ''; }\n                }).join('');\n                if (shadow) clonedRoots[i].innerHTML = shadow;\n              } catch {}\n            }\n            return dt + '\\n' + clone.outerHTML;\n          }\n          return dt + '\\n' + document.documentElement.outerHTML;\n        } catch (e) { return ''; }\n      })()";
 export declare const PAGE_META_SCRIPT = "(() => {\n        try {\n          return {\n            title: document.title,\n            url: location.href,\n            readyState: document.readyState,\n            viewport: {\n              width: window.innerWidth,\n              height: window.innerHeight,\n              devicePixelRatio: window.devicePixelRatio\n            },\n            frameCount: window.frames.length,\n            scriptCount: document.querySelectorAll('script').length,\n            styleCount: document.querySelectorAll('style,link[rel=\"stylesheet\"]').length\n          };\n        } catch { return {}; }\n      })()";
-export declare const EXTENSION_ROOT_META_SCRIPT = "(() => {\n        try {\n          const readGeneration = (node) => {\n            const raw = node.getAttribute && node.getAttribute('data-extjs-reinject-generation');\n            const parsed = Number(raw);\n            return Number.isFinite(parsed) ? parsed : undefined;\n          };\n          const normalize = (node) => ({\n            tag: node.tagName ? String(node.tagName).toLowerCase() : 'unknown',\n            id: node.id || undefined,\n            key: node.getAttribute ? node.getAttribute('data-extjs-reinject-key') || undefined : undefined,\n            generation: readGeneration(node),\n            status: node.getAttribute ? node.getAttribute('data-extjs-reinject-status') || undefined : undefined\n          });\n          const roots = Array.from(\n            document.querySelectorAll('#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])')\n          ).slice(0, 10).map(normalize);\n          const markers = Array.from(\n            document.querySelectorAll('[data-extjs-reinject-marker=\"true\"]')\n          ).slice(0, 10).map(normalize);\n          if (!roots.length && !markers.length) return null;\n          const generations = [...roots, ...markers]\n            .map(e => e.generation)\n            .filter(g => typeof g === 'number');\n          return {\n            rootCount: roots.length,\n            markerCount: markers.length,\n            latestGeneration: generations.length ? Math.max(...generations) : 0,\n            roots,\n            markers\n          };\n        } catch { return null; }\n      })()";
-export declare const RENDER_EVIDENCE_SCRIPT = "(() => {\n        try {\n          const body = document.body;\n          const roots = document.querySelectorAll(\n            '#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])'\n          );\n          const text = body ? (body.innerText || body.textContent || '') : '';\n          return {\n            readyState: document.readyState,\n            title: document.title,\n            bodyChildCount: body ? body.children.length : 0,\n            bodyElementCount: body ? body.querySelectorAll('*').length : 0,\n            textLength: text.trim().length,\n            extensionRootCount: roots.length\n          };\n        } catch { return null; }\n      })()";
+export declare const EXTENSION_ROOT_META_SCRIPT = "(() => {\n        try {\n          const readGeneration = (node) => {\n            const raw = node.getAttribute && node.getAttribute('data-extjs-reinject-generation');\n            const parsed = Number(raw);\n            return Number.isFinite(parsed) ? parsed : undefined;\n          };\n          const normalize = (node) => ({\n            tag: node.tagName ? String(node.tagName).toLowerCase() : 'unknown',\n            id: node.id || undefined,\n            key: node.getAttribute ? node.getAttribute('data-extjs-reinject-key') || undefined : undefined,\n            generation: readGeneration(node),\n            status: node.getAttribute ? node.getAttribute('data-extjs-reinject-status') || undefined : undefined\n          });\n          const allRoots = Array.from(\n            document.querySelectorAll('#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])')\n          );\n          const allMarkers = Array.from(\n            document.querySelectorAll('[data-extjs-reinject-marker=\"true\"]')\n          );\n          const roots = allRoots.slice(0, 10).map(normalize);\n          const markers = allMarkers.slice(0, 10).map(normalize);\n          if (!roots.length && !markers.length) return null;\n          const generations = [...roots, ...markers]\n            .map(e => e.generation)\n            .filter(g => typeof g === 'number');\n          return {\n            rootCount: allRoots.length,\n            markerCount: allMarkers.length,\n            listed: { roots: roots.length, markers: markers.length },\n            truncated: allRoots.length > roots.length || allMarkers.length > markers.length,\n            latestGeneration: generations.length ? Math.max(...generations) : 0,\n            roots,\n            markers\n          };\n        } catch { return null; }\n      })()";
+export declare const RENDER_EVIDENCE_SCRIPT = "(() => {\n        try {\n          const body = document.body;\n          const roots = document.querySelectorAll(\n            '#extension-root,[data-extension-root]:not([data-extension-root=\"extension-js-devtools\"])'\n          );\n          const text = body ? (body.innerText || body.textContent || '') : '';\n          const INERT = new Set(['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEMPLATE', 'LINK', 'META']);\n          const VISUAL = new Set(['CANVAS', 'IMG', 'SVG', 'VIDEO', 'IFRAME', 'INPUT', 'TEXTAREA', 'SELECT', 'BUTTON']);\n          let rendered = 0;\n          let visual = 0;\n          if (body) {\n            for (const el of body.querySelectorAll('*')) {\n              const tag = el.tagName.toUpperCase();\n              if (INERT.has(tag) || el.closest('noscript, template')) continue;\n              rendered += 1;\n              if (VISUAL.has(tag)) visual += 1;\n            }\n          }\n          const renderedText = body && typeof body.innerText === 'string' ? body.innerText : '';\n          return {\n            readyState: document.readyState,\n            title: document.title,\n            bodyChildCount: body ? body.children.length : 0,\n            bodyElementCount: body ? body.querySelectorAll('*').length : 0,\n            textLength: text.trim().length,\n            renderedElementCount: rendered,\n            visualElementCount: visual,\n            renderedTextLength: renderedText.trim().length,\n            extensionRootCount: roots.length\n          };\n        } catch { return null; }\n      })()";
 export declare function probeSelectorsScript(selectors: string[]): string;
 export declare function domSnapshotScript(maxNodes: number): string;

package/dist/src/lib/cdp-port.d.ts

@@ -3,7 +3,7 @@ export declare function resolveCdpPort(projectPath: string, browser: string, opt
     graceMs?: number;
 }): Promise<{
     port: number;
-    source: "contract" | "default-probe";
+    source: "contract";
 } | null>;
 export declare function resolveRdpPort(projectPath: string, browser: string, options?: {
     waitMs?: number;

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

@@ -5,8 +5,19 @@ export interface RenderEvidence {
     bodyChildCount?: number;
     bodyElementCount?: number;
     textLength?: number;
+    renderedElementCount?: number;
+    visualElementCount?: number;
+    renderedTextLength?: number;
     extensionRootCount?: number;
 }
+export interface DomSnapshot {
+    nodes: Array<Record<string, unknown>>;
+    totalElements: number;
+    truncated: boolean;
+    maxNodes: number;
+    maxDepth: number;
+}
+export declare function normalizeDomSnapshot(result: unknown, maxNodes: number): DomSnapshot;
 export declare class CDPClient extends CDPConnection {
     static discoverBrowserWsUrl(port: number, host?: string): Promise<string>;
     static discoverBrowserVersion(port: number, host?: string): Promise<string | null>;
@@ -35,8 +46,9 @@ export declare class CDPClient extends CDPConnection {
         selector: string;
         count: number;
         samples: Array<Record<string, unknown>>;
+        error?: string;
     }>>;
-    getDomSnapshot(sessionId: string, maxNodes?: number): Promise<Array<Record<string, unknown>>>;
+    getDomSnapshot(sessionId: string, maxNodes?: number): Promise<DomSnapshot>;
     getRenderEvidence(sessionId: string): Promise<RenderEvidence | null>;
     getExtensionRootMeta(sessionId: string): Promise<Record<string, unknown> | null>;
 }

package/dist/src/lib/create-answer.d.ts

@@ -0,0 +1,20 @@
+export type CreatedProject = {
+    ok: true;
+    projectId: string;
+    workspaceSlug: string;
+    projectSlug: string;
+} | {
+    ok: false;
+    why: string;
+};
+export declare function readCreatedProject(body: unknown): CreatedProject;
+export type CreatedWorkspace = {
+    ok: true;
+    id: string;
+    slug: string;
+} | {
+    ok: false;
+    why: string;
+};
+export declare function readCreatedWorkspace(body: unknown): CreatedWorkspace;
+export declare function answerIsUnknownOutcome(status: number, body: unknown): boolean;

package/dist/src/lib/credential-source.d.ts

@@ -0,0 +1,25 @@
+export interface CredentialRef {
+    workspace: string;
+    project: string;
+}
+export interface TokenClaims extends CredentialRef {
+    expiresAt: number | null;
+}
+export declare function readTokenClaims(token: string): TokenClaims | null;
+export declare function splitRef(name: string): CredentialRef | null;
+export interface ResolvedCredential {
+    token: string;
+    source: "stored" | "env" | "none";
+    ref: CredentialRef | null;
+    refSource: "stored" | "named" | "env-claims" | "none";
+    mismatch: {
+        env: CredentialRef;
+        stored: CredentialRef;
+    } | null;
+    note: string | null;
+}
+export declare function resolveCredential(options?: {
+    project?: string;
+}): ResolvedCredential;
+export declare function credentialProjectRef(selector?: string): CredentialRef | null;
+export declare function laneClosedByServer(err: unknown, code: string): boolean;

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

@@ -17,7 +17,29 @@ export interface CredentialSelector {
     project?: string;
 }
 export declare function credentialKey(workspaceSlug: string, projectSlug: string): string;
+export type CredentialStoreRead = {
+    state: "absent";
+} | {
+    state: "ok";
+    store: CredentialStore;
+} | {
+    state: "unreadable";
+    path: string;
+    reason: string;
+};
+export declare class CredentialStoreUnreadableError extends Error {
+    readonly path: string;
+    readonly reason: string;
+    constructor(file: string, reason: string);
+}
+export declare function inspectCredentialStore(): CredentialStoreRead;
 export declare function readCredentialStore(): CredentialStore | null;
+export declare function credentialStoreProblem(): {
+    path: string;
+    reason: string;
+} | null;
+export declare const TOKEN_TTL_SECONDS: number;
+export declare function tokenExpiry(value: unknown): number;
 export declare const PROJECT_PIN_ENV = "EXTENSION_DEV_PROJECT";
 export declare function pinnedProject(): string;
 export declare function isProjectRef(value: string): boolean;
@@ -28,11 +50,13 @@ export declare function listCredentials(): Array<StoredCredentials & {
     active: boolean;
 }>;
 export declare function writeCredentials(creds: StoredCredentials): string;
+export declare function writeCredentialBatch(batch: StoredCredentials[]): string | null;
 export declare function clearCredentials(selector?: CredentialSelector): {
     cleared: boolean;
     path: string;
     removed: string[];
     remaining: string[];
+    failure?: string;
 };
 export declare function readValidCredentials(nowSeconds?: number, selector?: CredentialSelector): StoredCredentials | null;
 export declare const PROJECT_TOKEN_INPUT: {

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

@@ -13,6 +13,7 @@ export declare function requestDeviceCode(args: {
     apiBase: string;
     path: string;
     project?: string;
+    projects?: string[];
     workspace?: string;
     clientName?: string;
     intent?: DeviceIntent;
@@ -33,11 +34,14 @@ export type DeviceGrantPollResult = {
     ok: false;
     reason: "pending" | "denied" | "expired" | "error";
     message?: string;
+    code?: string;
+    body?: Record<string, unknown>;
 };
 export declare function pollDeviceGrant(args: {
     apiBase: string;
     path: string;
     project?: string;
+    projects?: string[];
     workspace?: string;
     deviceCode: string;
     interval: number;

package/dist/src/lib/docs-tools.d.ts

@@ -0,0 +1,9 @@
+export interface ToolSchemaLike {
+    name: string;
+    description: string;
+    inputSchema: {
+        properties?: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export declare function renderToolsDoc(tools: ToolSchemaLike[]): string;

package/dist/src/lib/engine-manifest-view.d.ts

@@ -0,0 +1 @@
+export declare function engineManifestView(manifest: Record<string, unknown>, browser: string): Record<string, unknown>;

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_APPROVAL_PENDING" | "E_APPROVAL_REJECTED" | "E_APPROVAL_REQUIRED" | "E_AUTH_DENIED" | "E_AUTH_EXPIRED" | "E_AUTH_FAILED" | "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_EVAL" | "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_TOOL_DISABLED" | "E_UNKNOWN_COMMAND" | "E_UNKNOWN_TOOL" | "E_UNSUPPORTED_BROWSER" | "E_WAIT_TIMEOUT";
+export type ErrorCode = "E_AMBIGUOUS_TARGET" | "E_APPROVAL_PENDING" | "E_APPROVAL_REJECTED" | "E_APPROVAL_REQUIRED" | "E_AUTH_DENIED" | "E_AUTH_EXPIRED" | "E_AUTH_FAILED" | "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_BUILD_NOT_FOUND" | "E_BUILD_TIMEOUT" | "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_THEME" | "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_EVAL" | "E_EVAL_DISABLED" | "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_TOOL_DISABLED" | "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/exec.d.ts

@@ -1,6 +1,8 @@
 import type { ChildProcess } from "node:child_process";
 export interface CliResult {
     code: number | null;
+    signal?: NodeJS.Signals | null;
+    timedOut?: boolean;
     stdout: string;
     stderr: string;
 }

package/dist/src/lib/extension-identity.d.ts

@@ -0,0 +1,7 @@
+export declare function unpackedExtensionId(distPath: string): string;
+export interface GuestIdentity {
+    expectedIds: string[];
+    companionIds: Set<string>;
+    source: "contract" | "dist-path" | "none";
+}
+export declare function sessionGuestIdentity(projectPath: string, browser: string): GuestIdentity;

package/dist/src/lib/first-build.d.ts

@@ -0,0 +1,15 @@
+export type FirstBuild = {
+    state: "dispatched";
+} | {
+    state: "withheld";
+    reason: string;
+} | {
+    state: "unsaid";
+};
+export declare function readFirstBuild(body: unknown): FirstBuild;
+export declare function withheldBecause(reason: string): string;
+export declare function firstBuildValue(build: FirstBuild): {
+    dispatched: boolean | null;
+    reason?: string;
+};
+export declare function firstBuildSentence(build: FirstBuild, buildsPageUrl: string): string;

package/dist/src/lib/guest-load-oracle.d.ts

@@ -1,4 +1,4 @@
-export declare function isEngineCompanionUrl(url: string): boolean;
+export declare function isEngineCompanionUrl(url: string, projectPath?: string, browser?: string): boolean;
 export type GuestTarget = {
     id: string;
     type: string;
@@ -9,6 +9,7 @@ export type GuestLoadCheck = {
     loaded: boolean;
     guestTargets: GuestTarget[];
     guestIds: string[];
+    otherExtensionIds?: string[];
     cdpPort?: number;
     reason: string;
 };

package/dist/src/lib/launch-flags.d.ts

@@ -9,11 +9,11 @@ export declare const LAUNCH_FLAG_SCHEMA: {
     };
     readonly chromiumBinary: {
         readonly type: "string";
-        readonly description: "Custom Chromium-based binary (overrides browser)";
+        readonly description: "Custom Chromium-based binary to launch; `browser` still names the target family the engine builds for (chromium-based when none is given).";
     };
     readonly geckoBinary: {
         readonly type: "string";
-        readonly description: "Custom Gecko/Firefox binary (overrides browser)";
+        readonly description: "Custom Gecko/Firefox binary to launch; `browser` still names the target family the engine builds for (gecko-based when none is given).";
     };
     readonly host: {
         readonly type: "string";

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

@@ -1,4 +1,5 @@
 import { type StoredCredentials } from "./credentials";
+import { type BatchCapability } from "./project-batch";
 export declare function tokenTtlNote(workspaceSlug?: string, projectSlug?: string): string;
 type FetchImpl = typeof fetch;
 export declare function resolveApiBase(api?: string): string;
@@ -13,6 +14,7 @@ export interface LoginConfig {
     deviceCodeUrl: string;
     deviceTokenUrl: string;
     verificationUri: string;
+    batch: BatchCapability | null;
 }
 export declare function fetchLoginConfig(apiBase: string, fetchImpl?: FetchImpl): Promise<LoginConfig>;
 export declare function persistTokenResponse(args: {
@@ -20,4 +22,9 @@ export declare function persistTokenResponse(args: {
     project: string;
     data: Record<string, unknown>;
 }): StoredCredentials;
+export declare function persistBatchTokenResponse(args: {
+    apiBase: string;
+    projects: string[];
+    data: Record<string, unknown>;
+}): StoredCredentials[];
 export {};

package/dist/src/lib/match-patterns.d.ts

@@ -1,3 +1,3 @@
 export declare function matchPatternCovers(pattern: string, url: string): boolean;
 export declare function coveringMatches(patterns: string[], url: string): string[];
-export declare function contentScriptsForbidden(url: string): string | null;
+export declare function contentScriptsForbidden(url: string, browser?: string): string | null;

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

@@ -0,0 +1,11 @@
+export declare function engineNodeRange(): {
+    range: string;
+    engine: string;
+} | null;
+export declare function meetsNodeRange(version: string, range: string): boolean | null;
+export declare function nodeCheck(version: string): {
+    check: "node";
+    status: "pass" | "warn" | "fail";
+    detail: string;
+    remediation?: string;
+};

package/dist/src/lib/platform-hold.d.ts

@@ -2,6 +2,7 @@ export declare const PLATFORM_HOLD_CODE = "PLATFORM_NOT_OPEN";
 export declare const PLATFORM_HOLD_HEADER = "x-extensiondev-hold";
 export declare const PLATFORM_HOLD_STATUS = "platform-held";
 export declare const PLATFORM_HOLD_RELAYS_THE_PLATFORM_DATE: boolean;
+export declare const HOLD_STILL_WORKS_SENTENCE = "This does not stop you building. Creating, developing and packaging an extension run on your own machine, need no account and nothing from the platform, and work right now: extension_create scaffolds a project, extension_dev runs it in a real browser with live reload, extension_build produces the store-ready package for every browser you target, and extension_manifest_validate with extension_doctor check it before you ship. What is closed is the part that runs on extension.dev's machines: publishing, promoting a release, submitting to a store, hosting a preview share, requesting an approval, and creating a platform project or workspace.";
 export declare const PLATFORM_HOLD_STILL_WORKS: string[];
 export declare function templatesOrigin(apiHint?: string): string;
 export declare function readPlatformCode(body: unknown): string;

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

@@ -0,0 +1,5 @@
+export type PidState = "alive" | "dead" | "foreign";
+export declare const PLAUSIBLE_SESSION_BINARY: RegExp;
+export declare function processCommand(pid: number): string;
+export declare function pidState(pid: number): PidState;
+export declare function describeForeignPid(pid: number): string;

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

@@ -1,6 +1,10 @@
 import type { ProcessInfo } from "./types";
 export declare function sessionStateDir(): string;
 export declare function removeSessionMarker(projectPath: string, browser: string, pid?: number): void;
+export declare function readSessionMarkers(): {
+    markers: ProcessInfo[];
+    unreadable: string | null;
+};
 export declare function listSessionMarkers(): ProcessInfo[];
 export declare function registerSession(info: ProcessInfo): void;
 export declare function sessionSinceMs(projectPath: string, browser: string): number | null;

package/dist/src/lib/project-batch.d.ts

@@ -0,0 +1,28 @@
+export declare const MAX_BATCH_PROJECTS = 20;
+export declare const MAX_PROJECT_SLUG_LENGTH = 48;
+export declare const MAX_WORKSPACE_SLUG_LENGTH = 64;
+export declare const PLATFORM_CREATES_PER_HOUR = 10;
+export declare const DEFAULT_CREATE_PROJECTS_PER_APPROVAL = 10;
+export interface BatchCapability {
+    createProjectsPerApproval: number;
+    loginProjectsPerApproval: number;
+}
+export declare function readBatchCapability(config: unknown): BatchCapability | null;
+export declare const BATCH_UNSUPPORTED_MESSAGE = "This platform does not advertise batch onboarding, so a list of projects was not sent and no device code was spent.";
+export declare function isExactProjectSlug(slug: string): boolean;
+export interface ProjectBatch {
+    workspace: string;
+    slugs: string[];
+    refs: string[];
+}
+export type ProjectBatchParse = {
+    ok: true;
+    batch: ProjectBatch;
+} | {
+    ok: false;
+    message: string;
+};
+export declare function parseProjectBatch(input: unknown): ProjectBatchParse;
+export declare function sameProjectSet(a: string[], b: string[]): boolean;
+export declare function createRateLimitNote(): string;
+export declare function createCapNote(cap: number): string;

package/dist/src/lib/project-create-batch.d.ts

@@ -0,0 +1,42 @@
+export interface BatchCreateArgs {
+    projects?: unknown;
+    project?: unknown;
+    repo?: unknown;
+    installationId?: string;
+    displayName?: unknown;
+    description?: unknown;
+    installCommand?: string;
+    buildCommand?: string;
+    outputDirectory?: string;
+    browsers?: string[];
+    outputDirectories?: Record<string, unknown>;
+    deviceCode?: string;
+    api?: string;
+}
+interface BatchEntry {
+    ref: string;
+    workspace: string;
+    slug: string;
+    repo: string;
+    owner: string;
+    repoName: string;
+    displayName?: string;
+    description?: string;
+    installCommand?: string;
+    buildCommand?: string;
+    outputDirectory?: string;
+    browsers?: string[];
+    outputDirectories?: Record<string, unknown>;
+}
+export declare function resetBatchCreateSessions(): void;
+export declare function parseBatchCreateArgs(args: BatchCreateArgs): {
+    ok: true;
+    workspace: string;
+    entries: BatchEntry[];
+} | {
+    ok: false;
+    message: string;
+    hint?: string;
+};
+export declare function createProjectBatch(args: BatchCreateArgs): Promise<string>;
+export {};

package/dist/src/lib/project-create-body.d.ts

@@ -0,0 +1,14 @@
+export declare function buildCreateBody(args: {
+    workspace: string;
+    projectSlug: string;
+    owner: string;
+    repoName: string;
+    installationId?: string;
+    displayName?: string;
+    description?: string;
+    installCommand?: string;
+    buildCommand?: string;
+    outputDirectory?: string;
+    browsers?: string[];
+    outputDirectories?: Record<string, unknown>;
+}): Record<string, unknown>;

package/dist/src/lib/project-manifest.d.ts

@@ -1,4 +1,5 @@
 export declare function manifestCandidates(projectPath: string, browser: string): string[];
+export declare function isSourceManifest(file: string, projectPath: string): boolean;
 export interface ReadManifest {
     file: string;
     manifest: Record<string, unknown>;

package/dist/src/lib/promote-outcome.d.ts

@@ -0,0 +1,29 @@
+export interface PromoteNotarization {
+    pending: string[];
+    refused: {
+        browsers: string[];
+        reason: string;
+        upgradeUrl: string;
+    } | null;
+}
+export type PromoteOutcome = {
+    state: "promoted";
+    queuedBrowsers: string[];
+    notarization: PromoteNotarization;
+} | {
+    state: "partial";
+    queuedBrowsers: string[];
+    failedBrowsers: string[];
+    pendingMirrors: string[];
+    githubReleaseFailed: boolean;
+    githubReleaseAssetErrors: string[];
+    notarization: PromoteNotarization;
+} | {
+    state: "unconfirmed";
+    why: string;
+};
+export declare function readPromoteOutcome(body: unknown): PromoteOutcome;
+export declare function notarizationNotes(notarization: PromoteNotarization): string[];
+export declare function partialPromoteWarnings(outcome: Extract<PromoteOutcome, {
+    state: "partial";
+}>, channel: string): string[];

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

@@ -17,6 +17,8 @@ export type PublishResult = {
     error: {
         name: string;
         message: string;
+        code?: string;
+        status?: number;
     };
     held?: boolean;
     body?: unknown;