extension 4.0.16 → 4.0.17

package/dist/extension/browsers/browsers-lib/banner.d.ts

@@ -1,6 +1,4 @@
 import type { BrowserType } from '../browsers-types';
-export declare const BANNER_PRINTED_EVENT = "extensionjs:banner-printed";
-export declare function isBannerPrinted(): boolean;
 type Info = {
     extensionId?: string;
     name?: string;

package/dist/extension/browsers/browsers-lib/messages.d.ts

@@ -4,10 +4,6 @@ export declare function capitalizedBrowserName(browser: Browser): string;
 export declare function creatingUserProfile(profilePath: string): string;
 export declare function browserInstanceExited(browser: Browser): string;
 export declare function cdpClientAttachedToTarget(sessionId: string, targetType: string): string;
-export declare function cdpPendingRejectFailed(message: string): string;
-export declare function cdpFailedToHandleMessage(message: string): string;
-export declare function cdpAutoAttachSetupFailed(message: string): string;
-export declare function cdpProtocolEventHandlerError(message: string): string;
 export declare function bestEffortBannerPrintFailed(message: string): string;
 export declare function firefoxRdpRuntimeCapabilitySummary(state: 'available' | 'unavailable'): string;
 export declare function skippingBrowserLaunchDueToCompileErrors(): string;

package/dist/extension/browsers/browsers-lib/ready-stamp.d.ts

@@ -1,3 +1,10 @@
 export declare function stampReadyRdpPort(extensionOutputPath: string | undefined, rdpPort: number): void;
 export declare function stampReadyExtensionLoadRefused(extensionOutputPath: string | undefined, reason: string): void;
+export declare function stampReadyProfileLocked(extensionOutputPath: string | undefined, details: {
+    message?: string;
+    owner?: {
+        host: string;
+        pid: number;
+    };
+}): void;
 export declare function stampReadyBrowserExited(extensionOutputPath: string | undefined, code: number | null): void;

package/dist/extension/browsers/browsers-lib/shared-utils.d.ts

@@ -18,6 +18,15 @@ export declare function parseEnvBrowserFlags(raw: string | undefined | null): st
 export declare function isHeadlessGuardRequested(env?: NodeJS.ProcessEnv): boolean;
 export declare function mergeChromiumFeatureSwitches(flags: string[]): string[];
 export declare function findAvailablePortNear(startPort: number, maxAttempts?: number, host?: string): Promise<number>;
+export declare const PROFILE_LOCKED_ERROR_CODE = "profile_locked";
+export interface ProfileLockedError extends Error {
+    code: string;
+    profileLockOwner: {
+        host: string;
+        pid: number;
+    };
+}
+export declare function isProfileLockedError(error: unknown): error is ProfileLockedError;
 export declare function prepareChromiumProfileForLaunch(profilePath: string): {
     removedArtifacts: string[];
 };

package/dist/extension/commands/act.d.ts

@@ -3,4 +3,22 @@ export declare function readRecentConsole(projectPath: string, browser: string,
     context?: string;
     tabId?: number;
 }, limit: number): unknown[];
+interface ActResultLike {
+    ok?: boolean;
+    value?: unknown;
+    truncated?: boolean;
+    error?: {
+        name?: unknown;
+        message?: unknown;
+        engine?: unknown;
+    };
+}
+/**
+ * Wrap an act frame in the schema-1 envelope without dropping a key. `value`,
+ * `truncated`, `error.name`, `error.engine`, `error.hint` and any verb
+ * augmentation (`inspect --with-console` merges `console`) are what the MCP
+ * reads today, so they keep their exact place.
+ */
+export declare function buildActEnvelope(command: string, result: ActResultLike): Record<string, unknown>;
 export declare function registerActCommands(program: Command): void;
+export {};

package/dist/extension/commands/build.d.ts

@@ -1,2 +1,2 @@
-import type { Command } from 'commander';
+import { type Command } from 'commander';
 export declare function registerBuildCommand(program: Command): void;

package/dist/extension/commands/create.d.ts

@@ -1,2 +1,7 @@
 import type { Command } from 'commander';
+export declare const CREATE_ERROR_NEEDLES: {
+    readonly E_DESTINATION_NOT_EMPTY: 'already contains files that would be overwritten';
+    readonly E_DESTINATION_NOT_WRITABLE: "Couldn't write to the destination directory";
+    readonly E_TEMPLATE_NOT_FOUND: 'is not in the extension-js/examples catalog';
+};
 export declare function registerCreateCommand(program: Command): void;

package/dist/extension/commands/dev-wait.d.ts

@@ -1,3 +1,4 @@
+import { type ErrorCode } from '../helpers/messaging';
 export type WaitFormat = 'pretty' | 'json';
 export type WaitCommand = 'dev' | 'start';
 export declare const READY_CONTRACT_FRESHNESS_MS = 60000;
@@ -34,6 +35,18 @@ export type RunWaitModeResult = {
         browser: string;
     }>;
 };
+export declare function parseWaitFormat(value?: string): WaitFormat;
+export declare class WaitModeError extends Error {
+    readonly code: ErrorCode;
+    constructor(message: string, code: ErrorCode);
+}
+export interface WaitFailure {
+    code: ErrorCode;
+    status: string;
+    message: string;
+    hint: string;
+}
+export declare function describeWaitError(error: unknown): WaitFailure;
 export declare function isFreshContractPayload(payload: ReadyContractPayload): boolean;
 export declare function runWaitMode(options: RunWaitModeOptions): Promise<RunWaitModeResult>;
 export declare function runDevWaitMode(options: Omit<RunWaitModeOptions, 'command'>): Promise<RunWaitModeResult>;

package/dist/extension/commands/dev.d.ts

@@ -1,2 +1,2 @@
-import type { Command } from 'commander';
+import { type Command } from 'commander';
 export declare function registerDevCommand(program: Command): void;

package/dist/extension/commands/preview.d.ts

@@ -1,2 +1,3 @@
-import type { Command } from 'commander';
+import { type Command } from 'commander';
+export declare const PREVIEW_NOT_FOUND_NEEDLES: readonly ['Preview is run-only', 'Manifest file not found'];
 export declare function registerPreviewCommand(program: Command): void;

package/dist/extension/commands/start.d.ts

@@ -1,2 +1,2 @@
-import type { Command } from 'commander';
+import { type Command } from 'commander';
 export declare function registerStartCommand(program: Command): void;

package/dist/extension/helpers/messages.d.ts

@@ -1,30 +1,192 @@
-export declare const fmt: {
-    heading: (title: string) => string;
-    label: (k: string) => string;
-    val: (v: string) => string;
-    code: (v: string) => string;
-    bullet: (s: string) => string;
-    block(title: string, rows: Array<[string, string]>): string;
-    truncate(input: unknown, max?: number): string;
-};
-export declare const commandDescriptions: {
-    readonly create: 'Creates a new extension from a template (React, TypeScript, Vue, Svelte, etc.)';
-    readonly dev: 'Starts the development server with hot reloading';
-    readonly start: 'Builds and starts the extension in production mode';
-    readonly preview: 'Previews the extension in production mode without building';
-    readonly build: 'Builds the extension for packaging/distribution';
-    readonly logs: 'Prints or streams logs from every context of a running dev session';
-    readonly eval: 'Evaluates an expression in a running extension context (requires --allow-eval)';
-    readonly storage: 'Reads or writes chrome.storage in a running extension (requires --allow-control)';
-    readonly reload: 'Reloads a running extension or tab (requires --allow-control)';
-    readonly open: 'Opens an extension surface: popup, options, sidebar, action, or command (requires --allow-control)';
-    readonly inspect: 'Inspects a page/content DOM via the agent bridge (CDP-free; requires --allow-control)';
-    readonly publish: 'Publishes to extension.dev and prints a shareable URL (requires EXTENSION_DEV_TOKEN)';
-    readonly install: 'Installs a managed browser binary into Extension.js cache';
-    readonly uninstall: 'Removes managed browser binaries from Extension.js cache';
-    readonly telemetry: 'Manage anonymous telemetry consent (enable, disable, or show status)';
-    readonly doctor: 'Diagnoses a dev session: ready contract, control channel, token, executor, browser';
-};
+import { fmt } from './messaging';
+export { fmt };
+export interface CommandArgSpec {
+    readonly name: string;
+    readonly required: boolean;
+    readonly values?: readonly string[];
+    readonly label?: string;
+}
+export interface CommandNoteSpec {
+    readonly usage: string;
+    readonly description: string;
+}
+interface CommandTableEntry {
+    readonly name: string;
+    readonly positionals: readonly CommandArgSpec[];
+    readonly description: string;
+    readonly detail?: string;
+    readonly supportsSourceInspection: boolean;
+    readonly notes?: readonly CommandNoteSpec[];
+}
+export declare function commandArgSignature(positionals: readonly CommandArgSpec[]): string;
+export declare function registeredArgSignature(positionals: readonly CommandArgSpec[]): string;
+declare const COMMAND_TABLE: readonly [{
+    readonly name: 'create';
+    readonly positionals: readonly [{
+        readonly name: 'project-name|project-path';
+        readonly required: true;
+    }];
+    readonly description: 'Create a new extension from a template (React, TypeScript, Vue, Svelte, etc.)';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'dev';
+    readonly positionals: readonly [{
+        readonly name: 'project-path|remote-url';
+        readonly required: false;
+    }];
+    readonly description: 'Start the development server with hot reloading';
+    readonly supportsSourceInspection: true;
+}, {
+    readonly name: 'start';
+    readonly positionals: readonly [{
+        readonly name: 'project-path|remote-url';
+        readonly required: false;
+    }];
+    readonly description: 'Build and start the extension in production mode';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'preview';
+    readonly positionals: readonly [{
+        readonly name: 'project-name';
+        readonly required: false;
+        readonly label: 'project-path|remote-url';
+    }];
+    readonly description: 'Preview the extension in production mode without building';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'build';
+    readonly positionals: readonly [{
+        readonly name: 'project-name';
+        readonly required: false;
+        readonly label: 'project-path|remote-url';
+    }];
+    readonly description: 'Build the extension for packaging and distribution';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'logs';
+    readonly positionals: readonly [{
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Print or stream logs from every context of a running dev session';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'eval';
+    readonly positionals: readonly [{
+        readonly name: 'expression';
+        readonly required: true;
+    }, {
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Evaluate an expression in a running extension context (requires --allow-eval)';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'storage';
+    readonly positionals: readonly [{
+        readonly name: 'action';
+        readonly required: true;
+        readonly values: readonly ["get", "set"];
+    }, {
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Read or write chrome.storage in a running extension (requires --allow-control)';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'reload';
+    readonly positionals: readonly [{
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Reload a running extension or tab (requires --allow-control)';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'open';
+    readonly positionals: readonly [{
+        readonly name: 'surface';
+        readonly required: true;
+        readonly values: readonly ["popup", "options", "sidebar", "action", "command"];
+    }, {
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Open an extension surface: popup, options, sidebar, action, or command (requires --allow-control)';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'inspect';
+    readonly positionals: readonly [{
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Inspect a page or content DOM through the agent bridge (CDP-free; requires --allow-control)';
+    readonly supportsSourceInspection: true;
+}, {
+    readonly name: 'publish';
+    readonly positionals: readonly [{
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Publish to extension.dev and print a shareable URL (requires EXTENSION_DEV_TOKEN)';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'install';
+    readonly positionals: readonly [{
+        readonly name: 'browser-name';
+        readonly required: false;
+    }];
+    readonly description: 'Install a managed browser binary into the Extension.js cache';
+    readonly detail: 'Defaults to chromium when no browser is named.';
+    readonly supportsSourceInspection: false;
+    readonly notes: readonly [{
+        readonly usage: '--browser <chrome|chromium|edge|firefox|chromium-based|gecko-based|firefox-based|all>';
+        readonly description: 'Install multiple browsers, browser families, or all';
+    }, {
+        readonly usage: '--where';
+        readonly description: 'Print the managed browser cache root (or browser install path(s) when a browser name or --browser is provided)';
+    }];
+}, {
+    readonly name: 'uninstall';
+    readonly positionals: readonly [{
+        readonly name: 'browser-name';
+        readonly required: false;
+    }];
+    readonly description: 'Remove managed browser binaries from the Extension.js cache';
+    readonly supportsSourceInspection: false;
+    readonly notes: readonly [{
+        readonly usage: '--all';
+        readonly description: 'Remove every managed browser binary';
+    }, {
+        readonly usage: '--where';
+        readonly description: 'Print the managed browser cache root (or browser install path(s) when --browser/--all is provided)';
+    }];
+}, {
+    readonly name: 'telemetry';
+    readonly positionals: readonly [{
+        readonly name: 'action';
+        readonly required: false;
+        readonly values: readonly ["enable", "disable", "status"];
+    }];
+    readonly description: 'Manage anonymous telemetry consent (enable, disable, or show status)';
+    readonly supportsSourceInspection: false;
+}, {
+    readonly name: 'doctor';
+    readonly positionals: readonly [{
+        readonly name: 'project-path';
+        readonly required: false;
+    }];
+    readonly description: 'Diagnose a dev session: ready contract, control channel, token, executor, browser';
+    readonly supportsSourceInspection: false;
+}];
+export type CommandName = (typeof COMMAND_TABLE)[number]['name'];
+export interface CommandSpec extends CommandTableEntry {
+    readonly name: CommandName;
+    readonly args: string;
+}
+export declare const COMMANDS: readonly CommandSpec[];
+export declare function commandSpec(name: CommandName): CommandSpec;
+export declare const commandDescriptions: Record<CommandName, string>;
+export declare function availableCommandsBlock(): string;
 export declare function unhandledError(err: unknown): string;
 export declare function updateFailed(err: unknown): string;
 export declare function checkUpdates(packageJson: Record<string, unknown>, update: {
@@ -44,7 +206,7 @@ export declare function programAIHelp(): string;
 export type ProgramAIHelpJSON = {
     version: string;
     commands: Array<{
-        name: 'create' | 'dev' | 'start' | 'preview' | 'build' | 'logs' | 'eval' | 'storage' | 'reload' | 'open' | 'inspect' | 'publish' | 'install' | 'uninstall' | 'telemetry' | 'doctor';
+        name: CommandName;
         summary: string;
         supportsSourceInspection: boolean;
     }>;
@@ -85,4 +247,5 @@ export type ProgramAIHelpJSON = {
 export declare function programAIHelpJSON(version: string): ProgramAIHelpJSON;
 export declare function invalidAIHelpFormat(value: string): string;
 export declare function removedNoRunnerFlag(): string;
+export declare function deprecatedOutputAlias(flag: string): string;
 export declare function noBrowserNotSupportedForCommand(command?: string): string;

package/dist/extension/helpers/messaging.d.ts

@@ -0,0 +1,180 @@
+export type Channel = 'info' | 'success' | 'warn' | 'error' | 'debug';
+export declare function isDebug(): boolean;
+export declare function prefix(type: Channel): string;
+export declare const fmt: {
+    heading: (title: string) => string;
+    label: (key: string) => string;
+    val: (value: string) => string;
+    code: (value: string) => string;
+    bullet: (value: string) => string;
+    block(title: string, rows: Array<[string, string]>): string;
+    truncate(input: unknown, max?: number): string;
+};
+export interface CardRow {
+    label: string;
+    value?: string;
+}
+export interface CardInput {
+    version?: string;
+    suffix?: string;
+    rows?: CardRow[];
+}
+export declare function card(input?: CardInput): string;
+export declare function isCardKeyClaimed(key: string): boolean;
+export declare function claimCardKey(key: string): boolean;
+export declare function artifactNoun(browser: string): 'Add-on' | 'Extension';
+export declare const ENVELOPE_SCHEMA = 1;
+export declare const CODES: {
+    readonly E_ARGS: 'E_ARGS';
+    readonly E_PROJECT_NOT_FOUND: 'E_PROJECT_NOT_FOUND';
+    readonly E_MANIFEST_NOT_FOUND: 'E_MANIFEST_NOT_FOUND';
+    readonly E_MANIFEST_INVALID: 'E_MANIFEST_INVALID';
+    readonly E_FIRST_COMPILE: 'E_FIRST_COMPILE';
+    readonly E_COMPILE: 'E_COMPILE';
+    readonly E_BROWSER_NOT_FOUND: 'E_BROWSER_NOT_FOUND';
+    readonly E_BROWSER_LAUNCH: 'E_BROWSER_LAUNCH';
+    readonly E_PROFILE_LOCKED: 'E_PROFILE_LOCKED';
+    readonly E_READY_TIMEOUT: 'E_READY_TIMEOUT';
+    readonly E_SESSION_EXISTS: 'E_SESSION_EXISTS';
+    readonly E_CONTROL_DENIED: 'E_CONTROL_DENIED';
+    readonly E_CONTROL_UNAVAILABLE: 'E_CONTROL_UNAVAILABLE';
+    readonly E_TOKEN_MISSING: 'E_TOKEN_MISSING';
+    readonly E_NETWORK: 'E_NETWORK';
+    readonly E_INTERRUPTED: 'E_INTERRUPTED';
+    readonly E_NOT_IMPLEMENTED: 'E_NOT_IMPLEMENTED';
+    readonly E_INTERNAL: 'E_INTERNAL';
+    readonly E_UNSUPPORTED_BROWSER: 'E_UNSUPPORTED_BROWSER';
+    readonly E_INVALID_OPTION: 'E_INVALID_OPTION';
+    readonly E_PORT_UNAVAILABLE: 'E_PORT_UNAVAILABLE';
+    readonly E_DEPENDENCY_INSTALL: 'E_DEPENDENCY_INSTALL';
+    readonly E_TEMPLATE_NOT_FOUND: 'E_TEMPLATE_NOT_FOUND';
+    readonly E_DESTINATION_NOT_EMPTY: 'E_DESTINATION_NOT_EMPTY';
+    readonly E_DESTINATION_NOT_WRITABLE: 'E_DESTINATION_NOT_WRITABLE';
+    readonly E_BROWSER_DOWNLOAD: 'E_BROWSER_DOWNLOAD';
+    readonly E_SESSION_NOT_FOUND: 'E_SESSION_NOT_FOUND';
+    readonly E_EVAL_REFUSED: 'E_EVAL_REFUSED';
+    readonly E_TARGET_NOT_FOUND: 'E_TARGET_NOT_FOUND';
+    readonly E_TIMEOUT: 'E_TIMEOUT';
+    readonly E_PUBLISH_REJECTED: 'E_PUBLISH_REJECTED';
+    readonly E_AUTH_REQUIRED: 'E_AUTH_REQUIRED';
+    readonly E_SAFARI_TOOLCHAIN: 'E_SAFARI_TOOLCHAIN';
+    readonly E_EVAL: 'E_EVAL';
+    readonly E_INSPECT: 'E_INSPECT';
+    readonly E_STORAGE: 'E_STORAGE';
+    readonly E_LOGS_NOT_FOUND: 'E_LOGS_NOT_FOUND';
+    readonly E_READY_ERROR_STATUS: 'E_READY_ERROR_STATUS';
+    readonly E_COMMAND_UNSUPPORTED_FOR_TARGET: 'E_COMMAND_UNSUPPORTED_FOR_TARGET';
+    readonly E_FLAG_VALUE_INVALID: 'E_FLAG_VALUE_INVALID';
+    readonly E_FLAG_NOT_SUPPORTED_HERE: 'E_FLAG_NOT_SUPPORTED_HERE';
+    readonly E_DEV_SERVER_START: 'E_DEV_SERVER_START';
+    readonly E_DOCTOR_CHECKS_FAILED: 'E_DOCTOR_CHECKS_FAILED';
+    readonly E_TELEMETRY_WRITE: 'E_TELEMETRY_WRITE';
+    readonly E_PREVIEW_NO_DIST: 'E_PREVIEW_NO_DIST';
+    readonly E_BROWSER_UNINSTALL: 'E_BROWSER_UNINSTALL';
+    readonly E_NODE_VERSION: 'E_NODE_VERSION';
+    readonly E_UNKNOWN_COMMAND: 'E_UNKNOWN_COMMAND';
+    readonly E_REMOVED_FLAG: 'E_REMOVED_FLAG';
+    readonly E_BROWSER_NOT_INSTALLABLE: 'E_BROWSER_NOT_INSTALLABLE';
+    readonly E_PARENT_GONE: 'E_PARENT_GONE';
+    readonly E_REMOTE_URL_UNSUPPORTED: 'E_REMOTE_URL_UNSUPPORTED';
+    readonly E_CONFIG_LOAD: 'E_CONFIG_LOAD';
+    readonly E_MANAGED_DEP_CONFLICT: 'E_MANAGED_DEP_CONFLICT';
+    readonly E_TYPES_EMIT: 'E_TYPES_EMIT';
+    readonly E_TSCONFIG_MISSING: 'E_TSCONFIG_MISSING';
+    readonly E_OPTIONAL_DEP_UNRESOLVED: 'E_OPTIONAL_DEP_UNRESOLVED';
+    readonly E_OPTIONAL_DEP_LOAD: 'E_OPTIONAL_DEP_LOAD';
+    readonly E_OPTIONAL_DEP_UNKNOWN: 'E_OPTIONAL_DEP_UNKNOWN';
+    readonly E_COMPANION_EXTENSION_PATH: 'E_COMPANION_EXTENSION_PATH';
+    readonly E_MANIFEST_IN_PUBLIC: 'E_MANIFEST_IN_PUBLIC';
+    readonly E_RUNTIME_NOT_FOUND: 'E_RUNTIME_NOT_FOUND';
+    readonly E_MANIFEST_SHAPE: 'E_MANIFEST_SHAPE';
+    readonly E_MANIFEST_PAGE_MISSING: 'E_MANIFEST_PAGE_MISSING';
+    readonly E_MANIFEST_VERSION_UNSUPPORTED: 'E_MANIFEST_VERSION_UNSUPPORTED';
+    readonly E_MANIFEST_LOAD_BLOCKERS: 'E_MANIFEST_LOAD_BLOCKERS';
+    readonly E_MANIFEST_PERMISSION_MISSING: 'E_MANIFEST_PERMISSION_MISSING';
+    readonly E_MANIFEST_MSG_KEY_MISSING: 'E_MANIFEST_MSG_KEY_MISSING';
+    readonly E_MANIFEST_EMIT: 'E_MANIFEST_EMIT';
+    readonly E_RESTART_REQUIRED: 'E_RESTART_REQUIRED';
+    readonly E_COMPILE_FATAL: 'E_COMPILE_FATAL';
+    readonly E_MODULE_NOT_FOUND: 'E_MODULE_NOT_FOUND';
+    readonly E_ENTRY_NOT_FOUND: 'E_ENTRY_NOT_FOUND';
+    readonly E_ASSET_MISSING: 'E_ASSET_MISSING';
+    readonly E_SCRIPT_DEP_MISSING: 'E_SCRIPT_DEP_MISSING';
+    readonly E_RESERVED_FOLDER: 'E_RESERVED_FOLDER';
+    readonly E_CSS_PARSE: 'E_CSS_PARSE';
+    readonly E_CSS_PREPROCESSOR_MISSING: 'E_CSS_PREPROCESSOR_MISSING';
+    readonly E_CSS_DEAD_REF: 'E_CSS_DEAD_REF';
+    readonly E_INTEGRATION_INSTALL: 'E_INTEGRATION_INSTALL';
+    readonly E_POLYFILL_NOT_FOUND: 'E_POLYFILL_NOT_FOUND';
+    readonly E_LOCALES_LAYOUT: 'E_LOCALES_LAYOUT';
+    readonly E_WAR_INVALID: 'E_WAR_INVALID';
+    readonly E_MATCH_PATTERN_INVALID: 'E_MATCH_PATTERN_INVALID';
+    readonly E_BACKGROUND_REQUIRED: 'E_BACKGROUND_REQUIRED';
+    readonly E_CONTENT_SCRIPT_SYNTAX: 'E_CONTENT_SCRIPT_SYNTAX';
+    readonly E_NO_ENTRYPOINTS: 'E_NO_ENTRYPOINTS';
+    readonly E_REMOTE_RESOURCE_BLOCKED: 'E_REMOTE_RESOURCE_BLOCKED';
+    readonly E_PERF_BUDGET: 'E_PERF_BUDGET';
+    readonly E_ZIP_SKIPPED: 'E_ZIP_SKIPPED';
+    readonly E_ENV_NO_MATCH: 'E_ENV_NO_MATCH';
+    readonly E_REMOTE_FETCH_TIMEOUT: 'E_REMOTE_FETCH_TIMEOUT';
+    readonly E_REMOTE_DOWNLOAD: 'E_REMOTE_DOWNLOAD';
+    readonly E_REMOTE_ZIP_INVALID: 'E_REMOTE_ZIP_INVALID';
+    readonly E_LOCAL_ZIP_NOT_FOUND: 'E_LOCAL_ZIP_NOT_FOUND';
+    readonly E_PROJECT_DOWNLOAD_EMPTY: 'E_PROJECT_DOWNLOAD_EMPTY';
+    readonly E_BROWSER_BINARY_REQUIRED: 'E_BROWSER_BINARY_REQUIRED';
+    readonly E_BROWSER_BINARY_INVALID: 'E_BROWSER_BINARY_INVALID';
+    readonly E_BROWSER_EXITED: 'E_BROWSER_EXITED';
+    readonly E_BROWSER_START_TIMEOUT: 'E_BROWSER_START_TIMEOUT';
+    readonly E_LAUNCH_SKIPPED_COMPILE_ERRORS: 'E_LAUNCH_SKIPPED_COMPILE_ERRORS';
+    readonly E_INSTANCE_AMBIGUOUS: 'E_INSTANCE_AMBIGUOUS';
+    readonly E_WSL_INTEROP: 'E_WSL_INTEROP';
+    readonly E_EXTENSION_LOAD_REFUSED: 'E_EXTENSION_LOAD_REFUSED';
+    readonly E_ADDON_INSTALL: 'E_ADDON_INSTALL';
+    readonly E_BROWSER_CONNECT: 'E_BROWSER_CONNECT';
+    readonly E_BROWSER_CONNECTION_CLOSED: 'E_BROWSER_CONNECTION_CLOSED';
+    readonly E_CDP_NOT_CONNECTED: 'E_CDP_NOT_CONNECTED';
+    readonly E_CDP_TIMEOUT: 'E_CDP_TIMEOUT';
+    readonly E_CDP_OP_FAILED: 'E_CDP_OP_FAILED';
+    readonly E_EXTENSION_ID_UNKNOWN: 'E_EXTENSION_ID_UNKNOWN';
+    readonly E_RDP_PROTOCOL: 'E_RDP_PROTOCOL';
+    readonly E_DEV_SERVER_TIMEOUT: 'E_DEV_SERVER_TIMEOUT';
+    readonly E_PORT_IN_USE: 'E_PORT_IN_USE';
+    readonly E_SESSION_STOPPED: 'E_SESSION_STOPPED';
+    readonly E_LOGS_STREAM_GAP: 'E_LOGS_STREAM_GAP';
+    readonly E_CREATE_DIR: 'E_CREATE_DIR';
+    readonly E_CREATE_WRITE: 'E_CREATE_WRITE';
+    readonly E_CREATE_TESTS_SETUP: 'E_CREATE_TESTS_SETUP';
+    readonly E_GIT_SKIPPED: 'E_GIT_SKIPPED';
+    readonly E_BROWSER_INSTALL_PRIVILEGE: 'E_BROWSER_INSTALL_PRIVILEGE';
+    readonly E_UNINSTALL_NOOP: 'E_UNINSTALL_NOOP';
+};
+export type ErrorCode = (typeof CODES)[keyof typeof CODES];
+export interface EnvelopeError {
+    code: ErrorCode;
+    message: string;
+    name?: string;
+    engine?: string;
+    hint?: string;
+}
+export interface Envelope<T = unknown> {
+    schema: typeof ENVELOPE_SCHEMA;
+    ok: boolean;
+    command: string;
+    status: string;
+    value: T | null;
+    error: EnvelopeError | null;
+    truncated?: boolean;
+    hint?: string;
+    warnings: string[];
+}
+export interface EnvelopeExtras {
+    hint?: string;
+    warnings?: string[];
+    truncated?: boolean;
+    value?: unknown;
+}
+export declare const ENVELOPE: {
+    schema: number;
+    ok<T>(command: string, status: string, value: T, extras?: EnvelopeExtras): Envelope<T>;
+    fail(command: string, status: string, error: EnvelopeError, extras?: EnvelopeExtras): Envelope;
+};

package/dist/extension/helpers/output-flag.d.ts

@@ -0,0 +1,7 @@
+export type OutputFormat = 'pretty' | 'json';
+export declare function warnDeprecatedOutputAlias(flag: string): void;
+export declare function resolveOutputFormat(opts: {
+    output?: string;
+    format?: string;
+    waitFormat?: string;
+}): OutputFormat;

package/dist/extension/helpers/vendors.d.ts

@@ -3,4 +3,4 @@ export declare function isSafariVendor(value: string): boolean;
 export declare function parseOptionalBoolean(value?: string): boolean;
 export declare const vendors: (browser?: Browser | 'all') => string[];
 export declare const installTargets: (browser?: Browser | 'all') => string[];
-export declare function validateVendorsOrExit(vendorsList: string[], onInvalid: (invalid: string, supported: string[]) => void): void;
+export declare function validateVendors(vendorsList: string[], onInvalid: (invalid: string, supported: string[]) => void): boolean;

package/package.json

@@ -38,7 +38,7 @@
     "extension": "./bin/extension.cjs"
   },
   "name": "extension",
-  "version": "4.0.16",
+  "version": "4.0.17",
   "description": "The cross-browser extension framework. Build Chrome, Edge, Firefox, and Safari extensions with no build configuration.",
   "homepage": "https://extension.js.org/",
   "bugs": {
@@ -106,9 +106,9 @@
     "vivaldi-location2": "2.1.0",
     "waterfox-location": "2.1.0",
     "yandex-location": "2.1.0",
-    "extension-create": "4.0.16",
-    "extension-develop": "4.0.16",
-    "extension-install": "4.0.16",
+    "extension-create": "4.0.17",
+    "extension-develop": "4.0.17",
+    "extension-install": "4.0.17",
     "commander": "^15.0.0",
     "pintor": "0.3.0",
     "semver": "^7.7.3",

package/types/index.d.ts

@@ -24,6 +24,7 @@ declare global {
     EXTENSION_PUBLIC_MODE: ExtensionMode
     EXTENSION_PUBLIC_DESCRIPTION_TEXT: string
     EXTENSION_PUBLIC_LLM_API_KEY: string
+    EXTENSION_DEBUG: string
     EXTENSION_AUTHOR_MODE: string
     EXTENSION_PUBLIC_AUTHOR_MODE: string
   }