extension 4.1.31 → 4.1.33

package/dist/cli.cjs

@@ -423,6 +423,7 @@ var __webpack_modules__ = {
         });
     },
     "./browsers/browsers-lib/instance-registry.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var _helpers_messaging__rspack_import_0 = __webpack_require__("./helpers/messaging.ts");
         function _define_property(obj, key, value) {
             if (key in obj) Object.defineProperty(obj, key, {
                 value: value,
@@ -435,7 +436,7 @@ var __webpack_modules__ = {
         }
         class AmbiguousInstanceError extends Error {
             constructor(protocol, instanceId){
-                super(instanceId ? `Cannot resolve the ${protocol.toUpperCase()} port for instance "${instanceId}": it has not registered a port and no fallback was provided. Refusing to fall back to the most recently launched browser to avoid crossing instance streams.` : `Cannot resolve a ${protocol.toUpperCase()} port without an instance id and no fallback was provided. Refusing to fall back to the most recently launched browser to avoid crossing instance streams.`), _define_property(this, "protocol", void 0), _define_property(this, "instanceId", void 0);
+                super(instanceId ? `Cannot resolve the ${protocol.toUpperCase()} port for instance "${instanceId}": it has not registered a port and no fallback was provided. Refusing to fall back to the most recently launched browser to avoid crossing instance streams.` : `Cannot resolve a ${protocol.toUpperCase()} port without an instance id and no fallback was provided. Refusing to fall back to the most recently launched browser to avoid crossing instance streams.`), _define_property(this, "code", _helpers_messaging__rspack_import_0.Lp.E_INSTANCE_AMBIGUOUS), _define_property(this, "protocol", void 0), _define_property(this, "instanceId", void 0);
                 this.name = 'AmbiguousInstanceError';
                 this.protocol = protocol;
                 this.instanceId = instanceId;
@@ -765,6 +766,24 @@ var __webpack_modules__ = {
             const next = 'dev' === command ? 'The dev server is still running but reloads cannot be delivered, restart "extension dev" to relaunch the browser.' : `The ${command} session is over.`;
             return `[browser] ${browser} ${how}. ${next}`;
         }
+        function systemProfileSourceLabel(source) {
+            if ('env' === source.kind) return `${source.name}=true`;
+            if ('config' === source.kind) return 'profile: false in extension.config.js';
+            return '--profile=false';
+        }
+        function systemProfileSourceFix(source) {
+            if ('env' === source.kind) return `unset ${source.name}`;
+            if ('config' === source.kind) return 'remove profile: false from extension.config.js';
+            return 'drop --profile=false';
+        }
+        function geckoSystemProfileRefused(browser, sources) {
+            const name = capitalizedBrowserName(browser);
+            const fixes = sources.map(systemProfileSourceFix).join(' and ');
+            return `${getLoggingPrefix('error')} ${name} can't load the add-on in its own profile, so it was not launched.\n${pintor__rspack_import_8_default().gray('SET BY')} ${sources.map(systemProfileSourceLabel).join(', ')}\nRemote debugging is off in a browser's own profile, and the add-on can only be installed over it.\nTo fix, ${fixes}, then let Extension.js manage the profile or pass ${pintor__rspack_import_8_default().blue('--profile=<path>')} to use a profile of your own.`;
+        }
+        function browserStderrTail(browser, lines) {
+            return `[browser] ${browser} wrote this before it exited:\n${lines.map((line)=>`  ${line}`).join('\n')}`;
+        }
         function browserGoneBeforeReady(browser) {
             return `${getLoggingPrefix('error')} ${capitalizedBrowserName(browser)} exited before the extension loaded, so nothing is running.\nThe dev server keeps watching, but nothing will load until the browser is relaunched. Restart "extension dev".`;
         }
@@ -916,6 +935,12 @@ var __webpack_modules__ = {
         function safariNotYetRegistered(appName) {
             return `${getLoggingPrefix('info')} Safari hasn't picked up ${pintor__rspack_import_8_default().yellow(appName)} yet.\nOpen the app once, then check Safari ▸ Settings ▸ Extensions.`;
         }
+        function safariWebDriverSession(port, sessionId) {
+            return `${getLoggingPrefix('info')} WebDriver session ${pintor__rspack_import_8_default().gray(sessionId)} on port ${pintor__rspack_import_8_default().yellow(String(port))}.\nready.json carries it as ${pintor__rspack_import_8_default().gray('webdriverPort')} and ${pintor__rspack_import_8_default().gray('webdriverSessionId')}, attach to it instead of opening another.`;
+        }
+        function safariWebDriverUnavailable(reason) {
+            return `${getLoggingPrefix('info')} No WebDriver session for this run: ${reason}\nRun ${pintor__rspack_import_8_default().gray('safaridriver --enable')} once and turn on Safari ▸ Settings ▸ Developer ▸ Allow remote automation (Safari ▸ Develop ▸ Allow Remote Automation on older Safari) so tools can read Safari pages.`;
+        }
         function safariRebuilt(appName) {
             return `${getLoggingPrefix('success')} Rebuilt ${pintor__rspack_import_8_default().yellow(appName)}.`;
         }
@@ -1136,17 +1161,20 @@ var __webpack_modules__ = {
             H1: ()=>safariRegenerationDiscards,
             HH: ()=>messageWithoutSenderError,
             HL: ()=>binaryNotExecutable,
+            Hp: ()=>safariWebDriverSession,
             I5: ()=>chromiumForkNotInstalled,
             Ih: ()=>browserNotInstalledError,
             JB: ()=>devChannelSnapshotInUse,
             KP: ()=>safariBuildCalled,
             L: ()=>chromiumManifestLoadBlockers,
             LD: ()=>firefoxDryRunBinary,
+            LT: ()=>browserStderrTail,
             M3: ()=>cdpClientConnected,
             M6: ()=>chromiumExtensionLoadRefused,
             MG: ()=>prettyPuppeteerInstallGuidance,
             MQ: ()=>firefoxFailedToStart,
             MS: ()=>errorConnectingToBrowser,
+            Mm: ()=>geckoSystemProfileRefused,
             N4: ()=>enhancedProcessManagementUnhandledRejection,
             NO: ()=>mv3BackgroundScriptsNotSupportedByChromium,
             NT: ()=>firstRunInstallDeclined,
@@ -1204,6 +1232,7 @@ var __webpack_modules__ = {
             l9: ()=>parsingPacketError,
             lO: ()=>firefoxDryRunArgs,
             l_: ()=>safariConverted,
+            lb: ()=>safariWebDriverUnavailable,
             lk: ()=>firstRunInstallOffer,
             ne: ()=>requireChromiumBinaryForChromiumBased,
             nn: ()=>chromeProcessExited,
@@ -1723,6 +1752,29 @@ var __webpack_modules__ = {
                 (0, _write_json_atomic__rspack_import_3.Z)(readyPath, ready);
             } catch  {}
         }
+        function stampReadyWebDriver(extensionOutputPath, details, runId) {
+            try {
+                if (!extensionOutputPath) return;
+                const readyPath = readyPathFor(extensionOutputPath);
+                if (!node_fs__rspack_import_0.existsSync(readyPath)) return;
+                const ready = JSON.parse(node_fs__rspack_import_0.readFileSync(readyPath, 'utf-8'));
+                if (isForeignRun(ready, runId)) return;
+                const sessionId = String(details?.sessionId || '').trim();
+                const port = details?.port;
+                if ('number' == typeof port && Number.isFinite(port) && sessionId) {
+                    ready.webdriverPort = port;
+                    ready.webdriverSessionId = sessionId;
+                    delete ready.webdriverUnavailableReason;
+                } else {
+                    const reason = String(details?.unavailableReason || '').trim();
+                    if (!reason) return;
+                    delete ready.webdriverPort;
+                    delete ready.webdriverSessionId;
+                    ready.webdriverUnavailableReason = reason;
+                }
+                (0, _write_json_atomic__rspack_import_3.Z)(readyPath, ready);
+            } catch  {}
+        }
         function stampReadyBrowserLaunch(extensionOutputPath, details, runId) {
             try {
                 if (!extensionOutputPath) return;
@@ -1778,6 +1830,18 @@ var __webpack_modules__ = {
             const code = error?.code;
             return 'string' == typeof code && code.startsWith('E_') ? code : void 0;
         }
+        function stampReadyCdpFault(extensionOutputPath, code, detail, runId) {
+            try {
+                if (!extensionOutputPath || !code) return;
+                const readyPath = readyPathFor(extensionOutputPath);
+                if (!node_fs__rspack_import_0.existsSync(readyPath)) return;
+                const ready = JSON.parse(node_fs__rspack_import_0.readFileSync(readyPath, 'utf-8'));
+                if (isForeignRun(ready, runId)) return;
+                ready.cdpFaultCode = code;
+                ready.cdpFaultMessage = String(detail || '').trim() || 'the CDP wire failed after launch';
+                (0, _write_json_atomic__rspack_import_3.Z)(readyPath, ready);
+            } catch  {}
+        }
         function stampReadyExtensionId(extensionOutputPath, extensionId) {
             try {
                 const id = String(extensionId || '').trim();
@@ -1849,8 +1913,10 @@ var __webpack_modules__ = {
             M: ()=>stampReadyBrowserLaunch,
             NE: ()=>launchFailureCode,
             O3: ()=>readyPathFor,
+            QP: ()=>stampReadyCdpFault,
             Uf: ()=>readReadyRunId,
             Wi: ()=>stampReadyBrowserExited,
+            ZC: ()=>stampReadyWebDriver,
             __: ()=>stampReadyRdpPort,
             dT: ()=>describeLaunchFailure,
             dz: ()=>stampReadyBrowserLaunchFailed,
@@ -2032,7 +2098,8 @@ var __webpack_modules__ = {
     "./browsers/browsers-lib/resolve-profile.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         __webpack_require__.d(__webpack_exports__, {
             Md: ()=>normalizeProfileOption,
-            c6: ()=>resolveProfileConfig
+            c6: ()=>resolveProfileConfig,
+            Jv: ()=>systemProfileEnvName
         });
         var external_node_fs_ = __webpack_require__("node:fs");
         var external_node_path_ = __webpack_require__("node:path");
@@ -2040,6 +2107,15 @@ var __webpack_modules__ = {
         var messaging = __webpack_require__("./helpers/messaging.ts");
         var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
         var shared_utils = __webpack_require__("./browsers/browsers-lib/shared-utils.ts");
+        function systemProfileEnvName(env = process.env) {
+            for (const name of [
+                'EXTENSION_USE_SYSTEM_PROFILE',
+                'EXTJS_USE_SYSTEM_PROFILE'
+            ]){
+                const value = env[name];
+                if (value) return 'true' === String(value).toLowerCase().trim() ? name : void 0;
+            }
+        }
         function hasExplicit(rawProfile) {
             return 'string' == typeof rawProfile && rawProfile.trim().length > 0;
         }
@@ -2878,6 +2954,7 @@ var __webpack_modules__ = {
                 extension: opts.extensionsToLoad,
                 browser: opts.browser,
                 profile: opts.profile,
+                profileSource: opts.profileSource,
                 preferences: opts.preferences,
                 browserFlags: opts.browserFlags,
                 startingUrl: opts.startingUrl,
@@ -2945,19 +3022,32 @@ var __webpack_modules__ = {
             };
         }
     },
-    "./browsers/run-chromium/cdp/discovery.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+    "./browsers/run-chromium/cdp/coded-error.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var _helpers_messaging__rspack_import_0 = __webpack_require__("./helpers/messaging.ts");
+        function codedError(code, message) {
+            return Object.assign(new Error(message), {
+                code
+            });
+        }
+        function declaredCode(error) {
+            const code = error?.code;
+            return 'string' == typeof code && Object.prototype.hasOwnProperty.call(_helpers_messaging__rspack_import_0.Lp, code) ? code : void 0;
+        }
         __webpack_require__.d(__webpack_exports__, {
-            z: ()=>checkChromeRemoteDebugging,
-            N: ()=>discoverWebSocketDebuggerUrl
+            A: ()=>codedError,
+            K: ()=>declaredCode
         });
-        const external_node_http_namespaceObject = require("node:http");
-        var external_node_net_ = __webpack_require__("node:net");
-        var messaging = __webpack_require__("./helpers/messaging.ts");
-        var constants = __webpack_require__("./browsers/browsers-lib/constants.ts");
-        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
+    },
+    "./browsers/run-chromium/cdp/discovery.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var node_http__rspack_import_0 = __webpack_require__("node:http");
+        var node_net__rspack_import_1 = __webpack_require__("node:net");
+        var _helpers_messaging__rspack_import_2 = __webpack_require__("./helpers/messaging.ts");
+        var _browsers_lib_constants__rspack_import_3 = __webpack_require__("./browsers/browsers-lib/constants.ts");
+        var _browsers_lib_messages__rspack_import_4 = __webpack_require__("./browsers/browsers-lib/messages.ts");
+        var _coded_error__rspack_import_5 = __webpack_require__("./browsers/run-chromium/cdp/coded-error.ts");
         async function getJson(host, port, path) {
             return new Promise((resolve, reject)=>{
-                const req = external_node_http_namespaceObject.request({
+                const req = node_http__rspack_import_0.request({
                     hostname: host,
                     port,
                     path,
@@ -2974,8 +3064,8 @@ var __webpack_modules__ = {
                     });
                 });
                 req.on('error', (err)=>reject(err));
-                req.setTimeout(constants.C4, ()=>{
-                    req.destroy(new Error(`CDP endpoint timed out: ${path}`));
+                req.setTimeout(_browsers_lib_constants__rspack_import_3.C4, ()=>{
+                    req.destroy((0, _coded_error__rspack_import_5.A)(_helpers_messaging__rspack_import_2.Lp.E_CDP_TIMEOUT, `CDP endpoint timed out: ${path}`));
                 });
                 req.end();
             });
@@ -2985,14 +3075,14 @@ var __webpack_modules__ = {
                 const version = await getJson(host, port, '/json/version');
                 const wsUrl = 'string' == typeof version?.webSocketDebuggerUrl ? version.webSocketDebuggerUrl : void 0;
                 if (wsUrl) {
-                    if (isDev) (0, messaging._w)(messages.Te());
+                    if (isDev) (0, _helpers_messaging__rspack_import_2._w)(_browsers_lib_messages__rspack_import_4.Te());
                     return wsUrl;
                 }
             } catch (error) {
-                if (isDev) (0, messaging.mR)('[CDP] Failed to read /json/version:', String(error?.message || error));
+                if (isDev) (0, _helpers_messaging__rspack_import_2.mR)('[CDP] Failed to read /json/version:', String(error?.message || error));
             }
             const targets = await getJson(host, port, '/json');
-            if (isDev) (0, messaging._w)(messages.FF((targets || []).length || 0));
+            if (isDev) (0, _helpers_messaging__rspack_import_2._w)(_browsers_lib_messages__rspack_import_4.FF((targets || []).length || 0));
             const pageTarget = (targets || []).find((target)=>{
                 const type = String(target?.type || '');
                 const ws = 'string' == typeof target?.webSocketDebuggerUrl ? target.webSocketDebuggerUrl : '';
@@ -3000,14 +3090,14 @@ var __webpack_modules__ = {
             });
             const pageWs = 'string' == typeof pageTarget?.webSocketDebuggerUrl ? pageTarget.webSocketDebuggerUrl : '';
             if (pageWs) {
-                if (isDev) (0, messaging._w)(messages.Te());
+                if (isDev) (0, _helpers_messaging__rspack_import_2._w)(_browsers_lib_messages__rspack_import_4.Te());
                 return pageWs;
             }
-            throw new Error('No CDP WebSocket URL available');
+            throw (0, _coded_error__rspack_import_5.A)(_helpers_messaging__rspack_import_2.Lp.E_CDP_NOT_CONNECTED, 'No CDP WebSocket URL available');
         }
         async function checkChromeRemoteDebugging(port = 9222, host = '127.0.0.1') {
             return new Promise((resolve)=>{
-                const socket = new external_node_net_.Socket();
+                const socket = new node_net__rspack_import_1.Socket();
                 socket.on('connect', ()=>{
                     socket.destroy();
                     resolve(true);
@@ -3023,6 +3113,29 @@ var __webpack_modules__ = {
                 socket.connect(port, host);
             });
         }
+        __webpack_require__.d(__webpack_exports__, {
+            N: ()=>discoverWebSocketDebuggerUrl,
+            z: ()=>checkChromeRemoteDebugging
+        });
+    },
+    "./browsers/run-chromium/cdp/pipe-guard.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        const pipeOwners = new WeakMap();
+        const guardedPipes = new WeakSet();
+        function guardCdpPipe(stream) {
+            if (!stream || 'function' != typeof stream.on) return;
+            if (guardedPipes.has(stream)) return;
+            guardedPipes.add(stream);
+            stream.on('error', (error)=>{
+                pipeOwners.get(stream)?.reportPipeGone(error);
+            });
+        }
+        function claimCdpPipe(stream, owner) {
+            pipeOwners.set(stream, owner);
+        }
+        __webpack_require__.d(__webpack_exports__, {
+            S: ()=>claimCdpPipe,
+            b: ()=>guardCdpPipe
+        });
     },
     "./browsers/run-chromium/chromium-context/index.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         function createChromiumContext() {
@@ -3359,7 +3472,9 @@ var __webpack_modules__ = {
         var runtime_options = __webpack_require__("./browsers/browsers-lib/runtime-options.ts");
         var shared_utils = __webpack_require__("./browsers/browsers-lib/shared-utils.ts");
         var version_probe = __webpack_require__("./browsers/browsers-lib/version-probe.ts");
+        var coded_error = __webpack_require__("./browsers/run-chromium/cdp/coded-error.ts");
         var discovery = __webpack_require__("./browsers/run-chromium/cdp/discovery.ts");
+        var pipe_guard = __webpack_require__("./browsers/run-chromium/cdp/pipe-guard.ts");
         var manifest_readiness = __webpack_require__("./browsers/run-chromium/manifest-readiness.ts");
         var companion_session = __webpack_require__("./browsers/browsers-lib/companion-session.ts");
         var resolve_profile = __webpack_require__("./browsers/browsers-lib/resolve-profile.ts");
@@ -3890,6 +4005,17 @@ var __webpack_modules__ = {
                 code: messaging.Lp.E_BROWSER_BINARY_INVALID
             });
         }
+        function binaryRequiredError() {
+            return Object.assign(new Error(messages.ne()), {
+                code: messaging.Lp.E_BROWSER_BINARY_REQUIRED
+            });
+        }
+        function browserNotFoundError(reason) {
+            return Object.assign(new Error(reason), {
+                code: messaging.Lp.E_BROWSER_NOT_FOUND
+            });
+        }
+        const STDERR_TAIL_LINES = 8;
         class ChromiumLaunchPlugin {
             getExtensionLoadRefusal() {
                 return this.extensionLoadRefused || null;
@@ -3922,6 +4048,11 @@ var __webpack_modules__ = {
                 const outputPath = (0, extension_output_path.W)(compilation, void 0);
                 (0, ready_stamp.dz)(outputPath, (0, ready_stamp.dT)(error), (0, ready_stamp.Uf)(outputPath), (0, ready_stamp.NE)(error));
             }
+            stampCdpFault(compilation, error) {
+                const code = (0, coded_error.K)(error);
+                if (!code) return;
+                (0, ready_stamp.QP)((0, extension_output_path.W)(compilation, void 0), code, (0, ready_stamp.dT)(error), this.closeHandlerContext?.runId);
+            }
             apply(compiler) {
                 const host = compiler;
                 this.logger = 'function' == typeof host?.getInfrastructureLogger ? host.getInfrastructureLogger('ChromiumLaunchPlugin') : {
@@ -3933,8 +4064,8 @@ var __webpack_modules__ = {
                 host.hooks.done.tapPromise('chromium:launch', async (stats)=>{
                     try {
                         const hasErrors = 'function' == typeof stats?.hasErrors ? stats.hasErrors() : !!stats?.compilation?.errors?.length;
-                        if (hasErrors) return void this.logger.info(messages.y7());
                         if (this.didLaunch) return;
+                        if (hasErrors) return void this.logger.info(messages.y7());
                         await this.launchChromium(stats.compilation);
                         this.didLaunch = true;
                         if (!this.didReportReady && !this.extensionLoadRefused && !this.browserGone) (0, messaging._w)((0, ready_message.G)(stats.compilation.options.mode, this.options.browser));
@@ -3958,10 +4089,6 @@ var __webpack_modules__ = {
                 if (inTestRunner && !dryRun) return void logChromiumDryRun(this.options.browser, this.options?.chromiumBinary ? (0, wsl_support.f7)(String(this.options.chromiumBinary)) : 'chromium-mock-binary', []);
                 if (inTestRunner && dryRun) return void this.printDryRunPlan(compilation, this.options?.chromiumBinary ? (0, wsl_support.f7)(String(this.options.chromiumBinary)) : 'chromium-mock-binary');
                 const browser = this.options?.browser;
-                const exitForLaunchFailure = (reason)=>{
-                    this.stampLaunchFailed(compilation, reason);
-                    process.exit(1);
-                };
                 const notInstalledReason = `${String(browser)} isn't installed and no binary was found`;
                 let browserBinaryLocation = null;
                 let printedGuidance = false;
@@ -4182,11 +4309,11 @@ var __webpack_modules__ = {
                                     const guidance = getInstallGuidanceText('edge');
                                     printInstallGuidance(guidance, 'edge');
                                     browserBinaryLocation = null;
-                                    if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Chromium launch failed');
-                                    exitForLaunchFailure(notInstalledReason);
+                                    throw browserNotFoundError(notInstalledReason);
                                 }
                             }
-                        } catch  {
+                        } catch (error) {
+                            if ((0, ready_stamp.NE)(error)) throw error;
                             const guidance = getInstallGuidanceText('edge');
                             const fallback = resolveWslFallback();
                             if (fallback) browserBinaryLocation = fallback;
@@ -4194,15 +4321,11 @@ var __webpack_modules__ = {
                                 printInstallGuidance(guidance, 'edge');
                                 browserBinaryLocation = null;
                             }
-                            if (!browserBinaryLocation) if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Chromium launch failed');
-                            else exitForLaunchFailure(notInstalledReason);
+                            if (!browserBinaryLocation) throw browserNotFoundError(notInstalledReason);
                         }
                         break;
                     case 'chromium-based':
-                        (0, messaging.Gg)(messages.ne());
-                        if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('chromium-based requires --chromium-binary');
-                        exitForLaunchFailure('the chromium-based target needs --chromium-binary <abs-path>');
-                        break;
+                        throw binaryRequiredError();
                     default:
                         browserBinaryLocation = resolveChromeLikeBinary();
                         break;
@@ -4245,8 +4368,7 @@ var __webpack_modules__ = {
                             const forkGuidance = chromiumForkInstallGuidance(browser);
                             this.logger.error(null !== forkGuidance ? messages.I5(browser, forkGuidance) : messages.Ih(browser, browserBinaryLocation || ''));
                         }
-                        if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Browser not installed or binary path not found');
-                        exitForLaunchFailure(notInstalledReason);
+                        throw browserNotFoundError(notInstalledReason);
                     }
                 }
                 let browserVersionLine;
@@ -4371,6 +4493,8 @@ var __webpack_modules__ = {
                     input: child.stdio[4],
                     output: child.stdio[3]
                 } : void 0;
+                (0, pipe_guard.b)(pipeStreams?.input);
+                (0, pipe_guard.b)(pipeStreams?.output);
                 if (enableCdp && !pipeStreams) {
                     let portReady = false;
                     for(let attempt = 0; attempt < 10; attempt++){
@@ -4408,7 +4532,7 @@ var __webpack_modules__ = {
                         const CDP_SETUP_TIMEOUT_MS = 45000;
                         await Promise.race([
                             mod.setupCdpAfterLaunch(compilation, cdpConfig, chromiumConfig, pipeStreams),
-                            new Promise((_, reject)=>setTimeout(()=>reject(new Error(`CDP setup did not complete within ${CDP_SETUP_TIMEOUT_MS / 1000}s. Chrome likely rejected the extension at launch, open chrome://extensions in the dev browser window for the exact error. Common causes: MV3 content_security_policy with 'unsafe-inline', manifest keys Chrome does not support, or manifest references to files missing from the output. Reload/HMR cannot attach until this is fixed.`)), CDP_SETUP_TIMEOUT_MS).unref?.())
+                            new Promise((_, reject)=>setTimeout(()=>reject((0, coded_error.A)(messaging.Lp.E_CDP_TIMEOUT, `CDP setup did not complete within ${CDP_SETUP_TIMEOUT_MS / 1000}s. Chrome likely rejected the extension at launch, open chrome://extensions in the dev browser window for the exact error. Common causes: MV3 content_security_policy with 'unsafe-inline', manifest keys Chrome does not support, or manifest references to files missing from the output. Reload/HMR cannot attach until this is fixed.`)), CDP_SETUP_TIMEOUT_MS).unref?.())
                         ]);
                         if (cdpConfig.extensionLoadRefused) {
                             this.extensionLoadRefused = cdpConfig.extensionLoadRefused;
@@ -4426,6 +4550,7 @@ var __webpack_modules__ = {
                         if ('development' === compilation.options.mode) (0, messaging.Gg)(messages.u1(this.options.browser));
                         return;
                     }
+                    this.stampCdpFault(compilation, error);
                     reportReady();
                 }
             }
@@ -4468,14 +4593,21 @@ var __webpack_modules__ = {
                     });
                     if ((0, messaging._o)()) this.logger.debug?.('[browser] Final Chrome flags:', launchArgs.join(' '));
                     const stderrStream = child.stdio?.[2];
+                    const stderrTail = [];
+                    let pending = '';
+                    const keepStderrLine = (line)=>{
+                        if (!line) return;
+                        stderrTail.push(line);
+                        if (stderrTail.length > STDERR_TAIL_LINES) stderrTail.shift();
+                    };
                     if (stderrStream && 'function' == typeof stderrStream.on) {
-                        let pending = '';
                         stderrStream.on('data', (chunk)=>{
                             pending += String(chunk);
                             let newline;
                             while(-1 !== (newline = pending.indexOf('\n'))){
                                 const line = pending.slice(0, newline).trim();
                                 pending = pending.slice(newline + 1);
+                                keepStderrLine(line);
                                 if (/Failed to load extension|Manifest file is missing or unreadable|Manifest is not valid JSON/i.test(line)) this.logger.error(`[browser] Chrome rejected an extension at launch, reload/HMR cannot attach until this is fixed:\n${line}`);
                             }
                         });
@@ -4488,6 +4620,11 @@ var __webpack_modules__ = {
                             const beforeReady = !this.didReportReady;
                             this.browserGone = true;
                             this.logger.error(messages.NV(this.options.browser, code, signal, this.closeHandlerContext?.command || 'preview'));
+                            if (beforeReady) {
+                                keepStderrLine(pending.trim());
+                                pending = '';
+                                if (stderrTail.length > 0) this.logger.error(messages.LT(this.options.browser, stderrTail));
+                            }
                             (0, ready_stamp.Wi)(this.closeHandlerContext?.extensionOutputPath, code, signal, this.closeHandlerContext?.runId, {
                                 beforeReady
                             });
@@ -4744,6 +4881,7 @@ var __webpack_modules__ = {
         var ready_message = __webpack_require__("./browsers/browsers-lib/ready-message.ts");
         var ready_stamp = __webpack_require__("./browsers/browsers-lib/ready-stamp.ts");
         var resolve_live_pid = __webpack_require__("./browsers/browsers-lib/resolve-live-pid.ts");
+        var resolve_profile = __webpack_require__("./browsers/browsers-lib/resolve-profile.ts");
         var runtime_options = __webpack_require__("./browsers/browsers-lib/runtime-options.ts");
         var shared_utils = __webpack_require__("./browsers/browsers-lib/shared-utils.ts");
         var version_probe = __webpack_require__("./browsers/browsers-lib/version-probe.ts");
@@ -4836,7 +4974,6 @@ var __webpack_modules__ = {
         }
         var external_node_path_ = __webpack_require__("node:path");
         var companion_session = __webpack_require__("./browsers/browsers-lib/companion-session.ts");
-        var resolve_profile = __webpack_require__("./browsers/browsers-lib/resolve-profile.ts");
         const masterPreferences = {
             'browser.aboutwelcome.enabled': false,
             'browser.startup.homepage_override.mstone': 'ignore',
@@ -4986,7 +5123,7 @@ var __webpack_modules__ = {
             if (launchUrl) binaryArgs.push('--url', String(launchUrl));
             const outPath = compilation.options.output?.path || external_node_path_.resolve(process.cwd(), 'dist/firefox');
             const distRoot = external_node_path_.dirname(outPath);
-            const useSystemProfile = 'true' === String(process.env.EXTENSION_USE_SYSTEM_PROFILE || process.env.EXTJS_USE_SYSTEM_PROFILE || '').toLowerCase().trim();
+            const useSystemProfile = Boolean((0, resolve_profile.Jv)());
             const contextDir = compilation?.options?.context || process.cwd();
             const shownPath = (p)=>{
                 try {
@@ -5220,7 +5357,9 @@ var __webpack_modules__ = {
             }
         }
         async function installTemporaryAddon(client, addonsActor, addonPath, openDevTools) {
-            if (!addonsActor) throw new Error(messages.WV('firefox', 'No addonsActor available from Firefox RDP.'));
+            if (!addonsActor) throw Object.assign(new Error(messages.WV('firefox', 'No addonsActor available from Firefox RDP.')), {
+                code: messaging.Lp.E_ADDON_INSTALL
+            });
             const tryInstall = async (pathToUse)=>client.request({
                     to: addonsActor,
                     type: 'installTemporaryAddon',
@@ -5612,7 +5751,7 @@ var __webpack_modules__ = {
                             await new Promise((resolve)=>setTimeout(resolve, RETRY_INTERVAL));
                         } else {
                             const err = error;
-                            (0, messaging.Gg)(messages.dk(this.options.browser, err.stack || String(error)));
+                            (0, messaging.Gg)(messages.dk(this.options.browser, (0, messaging._o)() ? err.stack || err : err));
                             throw err;
                         }
                     }
@@ -5677,7 +5816,9 @@ var __webpack_modules__ = {
                         const outcome = classifyAddonInstallFailure(err);
                         if ('refused' === outcome.status) this.addonInstallRefusalReason = outcome.reason;
                         const message = requestErrorToMessage(err);
-                        throw new Error(messages.WV(this.options.browser, message));
+                        throw Object.assign(new Error(messages.WV(this.options.browser, message)), {
+                            code: (0, ready_stamp.NE)(err) ?? messaging.Lp.E_ADDON_INSTALL
+                        });
                     }
                 }
                 if (primaryUserAddonId) this.derivedExtensionId = primaryUserAddonId;
@@ -5912,6 +6053,23 @@ var __webpack_modules__ = {
                 code: messaging.Lp.E_BROWSER_BINARY_INVALID
             });
         }
+        function systemProfileRefusal(browser, sources) {
+            return Object.assign(new Error(messages.Mm(browser, sources)), {
+                code: messaging.Lp.E_FLAG_NOT_SUPPORTED_HERE
+            });
+        }
+        function systemProfileSources(host) {
+            const sources = [];
+            if (false === (0, resolve_profile.Md)(host.profile)) sources.push({
+                kind: 'config' === host.profileSource ? 'config' : 'flag'
+            });
+            const envName = (0, resolve_profile.Jv)();
+            if (envName) sources.push({
+                kind: 'env',
+                name: envName
+            });
+            return sources;
+        }
         class FirefoxLaunchPlugin {
             get spawnedBrowser() {
                 return null !== this.child;
@@ -5953,12 +6111,12 @@ var __webpack_modules__ = {
                 host.hooks.done.tapAsync('run-firefox:launch', async (stats, done)=>{
                     try {
                         const hasErrors = 'function' == typeof stats?.hasErrors ? stats.hasErrors() : !!stats?.compilation?.errors?.length;
+                        if (this.ctx.didLaunch) return void done();
                         if (hasErrors) {
                             this.ctx.logger?.info?.(messages.y7());
                             done();
                             return;
                         }
-                        if (this.ctx.didLaunch) return void done();
                         await this.launch(stats.compilation, (0, runtime_options.zU)(this.host, stats.compilation.options.mode));
                         if ('development' === stats.compilation.options.mode && !this.host.extensionLoadRefused) this.reportReady('development');
                         this.ctx.didLaunch = true;
@@ -5967,8 +6125,6 @@ var __webpack_modules__ = {
                         const rendered = error instanceof Error ? error.message : String(error);
                         if ((0, messaging.Qi)(rendered)) (0, messaging.Gg)(rendered);
                         else this.ctx.logger?.error?.(messages.MQ(error));
-                        if (process.env.VITEST || process.env.VITEST_WORKER_ID) return void done(error);
-                        process.exit(1);
                     }
                     done();
                 });
@@ -5977,6 +6133,8 @@ var __webpack_modules__ = {
                 const compilationErrors = compilation?.errors || [];
                 if (compilationErrors.length > 0) return void this.ctx.logger?.info?.(messages.y7());
                 if ((0, messaging._o)()) this.ctx.logger?.info?.(messages.A9(this.host.browser));
+                const systemProfile = systemProfileSources(this.host);
+                if (systemProfile.length > 0) throw systemProfileRefusal(this.host.browser, systemProfile);
                 const normalizePath = (value)=>{
                     const normalized = value ? (0, wsl_support.f7)(value) : null;
                     return normalized && external_node_fs_.existsSync(normalized) ? normalized : null;
@@ -5998,19 +6156,16 @@ var __webpack_modules__ = {
                         return 'npx extension install firefox';
                     }
                 };
-                const exitForLaunchFailure = (message)=>{
-                    if (message) (0, messaging.Gg)(message);
-                    this.stampLaunchFailed(message || `${this.host.browser} could not be launched`);
-                    process.exit(1);
-                };
                 const failGeckoBinaryRequirement = ()=>{
                     if (this.host.geckoBinary) throw invalidBinaryPinError(String(this.host.geckoBinary));
-                    return exitForLaunchFailure(messages.jk());
+                    throw Object.assign(new Error(messages.jk()), {
+                        code: messaging.Lp.E_BROWSER_BINARY_REQUIRED
+                    });
                 };
-                const throwOrExitNotInstalled = ()=>{
-                    if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Firefox not installed or binary path not found');
-                    this.stampLaunchFailed(`${this.host.browser} isn't installed and no binary was found`);
-                    process.exit(1);
+                const throwNotInstalled = ()=>{
+                    throw Object.assign(new Error(`${this.host.browser} isn't installed and no binary was found`), {
+                        code: messaging.Lp.E_BROWSER_NOT_FOUND
+                    });
                 };
                 const inTestRunner = Boolean(process.env.VITEST || process.env.VITEST_WORKER_ID);
                 const dryRun = Boolean(this.host.dryRun);
@@ -6018,12 +6173,9 @@ var __webpack_modules__ = {
                 if (inTestRunner && dryRun) return void await this.printDryRunPlan(compilation, options, this.host.geckoBinary ? (0, wsl_support.f7)(String(this.host.geckoBinary)) : 'firefox-mock-binary');
                 if ('librewolf' === this.host.browser) {
                     const remoteDebugging = (0, librewolf_overrides.u5)(external_node_fs_, process.env, process.platform);
-                    if (!remoteDebugging.enabled) {
-                        (0, messaging.Gg)(messages.bC(remoteDebugging.expectedPath));
-                        if (inTestRunner) throw new Error('LibreWolf remote debugging is disabled');
-                        this.stampLaunchFailed('LibreWolf remote debugging is disabled');
-                        process.exit(1);
-                    }
+                    if (!remoteDebugging.enabled) throw Object.assign(new Error(messages.bC(remoteDebugging.expectedPath)), {
+                        code: messaging.Lp.E_BROWSER_CONNECT
+                    });
                 }
                 let browserBinaryLocation = resolveManagedBinary();
                 let skipDetection = Boolean(browserBinaryLocation);
@@ -6107,7 +6259,7 @@ var __webpack_modules__ = {
                             if (wslFallback) browserBinaryLocation = wslFallback;
                             else {
                                 this.printInstallHint(compilation, getInstallGuidanceText());
-                                throwOrExitNotInstalled();
+                                throwNotInstalled();
                             }
                         }
                     }
@@ -6173,7 +6325,7 @@ var __webpack_modules__ = {
                         const reason = error?.extensionLoadRefusedReason;
                         if (!reason) {
                             (0, ready_stamp.__)(this.extensionOutputPath, debugPort);
-                            (0, ready_stamp.dz)(this.extensionOutputPath, (0, ready_stamp.dT)(error), this.launchRunId);
+                            (0, ready_stamp.dz)(this.extensionOutputPath, (0, ready_stamp.dT)(error), this.launchRunId, (0, ready_stamp.NE)(error));
                             throw error;
                         }
                         this.reportAddonLoadRefused(reason);
@@ -6193,19 +6345,11 @@ var __webpack_modules__ = {
                             this.ctx.logger?.info?.(messages.dw(profilePath));
                         }
                     } catch  {}
-                } else {
-                    if ((0, messaging._o)()) this.ctx.logger?.warn?.('[browser] Firefox profile not set; skipping RDP add-on install.');
-                    this.child = await this.spawnFirefoxChild(plan.binary, plan.args, wslFallbackBinary);
-                    (0, ready_stamp.M)(this.extensionOutputPath, {
-                        browserPid: this.child?.pid,
-                        binary: this.child?.spawnfile || plan.binary,
-                        binaryProvenance: this.host.launchBinaryProvenance,
-                        extensionId: this.extensionOutputPath ? (0, banner.MT)(this.extensionOutputPath) : void 0
-                    }, this.launchRunId);
-                    this.wireChildLifecycle();
-                    if (debugPort > 0) (0, ready_stamp.__)(this.extensionOutputPath, debugPort);
-                    this.scheduleWatchTimeout();
-                }
+                } else throw systemProfileRefusal(this.host.browser, [
+                    {
+                        kind: 'flag'
+                    }
+                ]);
             }
             async printDryRunPlan(compilation, options, binaryPath) {
                 const launchConfig = await resolveFirefoxLaunchConfig(compilation, {
@@ -6263,8 +6407,6 @@ var __webpack_modules__ = {
                 if (!child) return;
                 child.on('error', (error)=>{
                     this.ctx.logger?.error?.(messages._D(this.host.browser, error));
-                    if (process.env.VITEST || process.env.VITEST_WORKER_ID) throw new Error('Firefox startup timed out');
-                    process.exit(1);
                 });
                 child.on('close', (code, signal)=>{
                     const expected = (0, process_teardown.Op)(child);
@@ -6507,15 +6649,9 @@ var __webpack_modules__ = {
             Tu: LIBREWOLF_REMOTE_DEBUGGING_LINES
         });
     },
-    "./browsers/run-firefox/rdp/remote-firefox/messaging-client.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-        __webpack_require__.d(__webpack_exports__, {
-            G: ()=>MessagingClient
-        });
-        const external_node_events_namespaceObject = require("node:events");
-        var external_node_events_default = /*#__PURE__*/ __webpack_require__.n(external_node_events_namespaceObject);
-        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
-        var constants = __webpack_require__("./browsers/browsers-lib/constants.ts");
-        const EVALUATION_TIMEOUT_MS = constants.pq;
+    "./browsers/run-firefox/rdp/remote-firefox/evaluate.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        var _browsers_lib_constants__rspack_import_0 = __webpack_require__("./browsers/browsers-lib/constants.ts");
+        const EVALUATION_TIMEOUT_MS = _browsers_lib_constants__rspack_import_0.pq;
         const EVALUATION_TYPES = [
             'evaluateJSAsync',
             'evalWithOptions',
@@ -6527,16 +6663,23 @@ var __webpack_modules__ = {
             const initial = value?.initial;
             return 'string' == typeof initial ? initial : '';
         }
+        class PageThrewError extends Error {
+            constructor(message){
+                super(message);
+                this.name = 'PageThrewError';
+            }
+        }
         function evaluationFailure(reply) {
             if (!reply || 'object' != typeof reply) return;
             const r = reply;
             const message = exceptionText(r.exceptionMessage);
             const threw = true === r.hasException || true === r.topLevelAwaitRejected || void 0 !== r.exception && null !== r.exception || message.length > 0;
             if (!threw) return;
-            return new Error(message || 'The expression threw inside the page');
+            return new PageThrewError(message || 'The expression threw inside the page');
         }
-        function buildEvaluationPayload(tabId, expression, type) {
+        function buildEvaluationPayload(tabId, expression, type, extra) {
             const payload = {
+                ...extra,
                 to: tabId,
                 type,
                 text: expression
@@ -6556,8 +6699,8 @@ var __webpack_modules__ = {
                 if ('function' == typeof client.removeListener) client.removeListener('message', listener);
             };
         }
-        async function requestEvaluation(client, tabId, expression, type) {
-            if ('evaluateJSAsync' !== type) return await client.request(buildEvaluationPayload(tabId, expression, type));
+        async function requestEvaluation(client, tabId, expression, type, extra) {
+            if ('evaluateJSAsync' !== type) return await client.request(buildEvaluationPayload(tabId, expression, type, extra));
             let expectedResultId = '';
             let cleanup = ()=>{};
             let pendingMessage;
@@ -6597,7 +6740,7 @@ var __webpack_modules__ = {
                 }
             });
             try {
-                const response = await client.request(buildEvaluationPayload(tabId, expression, type));
+                const response = await client.request(buildEvaluationPayload(tabId, expression, type, extra));
                 if (response?.type === 'evaluationResult') {
                     cleanup();
                     return response;
@@ -6619,12 +6762,12 @@ var __webpack_modules__ = {
                 throw error;
             }
         }
-        async function evaluate(client, tabId, expression) {
+        async function evaluate(client, tabId, expression, extra) {
             let lastError = null;
             for (const type of EVALUATION_TYPES){
                 let response;
                 try {
-                    response = await requestEvaluation(client, tabId, expression, type);
+                    response = await requestEvaluation(client, tabId, expression, type, extra);
                 } catch (err) {
                     lastError = err;
                     continue;
@@ -6638,6 +6781,20 @@ var __webpack_modules__ = {
             }
             throw lastError || new Error('Failed to evaluate expression');
         }
+        __webpack_require__.d(__webpack_exports__, {
+            K: ()=>PageThrewError,
+            _: ()=>evaluate
+        });
+    },
+    "./browsers/run-firefox/rdp/remote-firefox/messaging-client.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            G: ()=>MessagingClient
+        });
+        const external_node_events_namespaceObject = require("node:events");
+        var external_node_events_default = /*#__PURE__*/ __webpack_require__.n(external_node_events_namespaceObject);
+        var messaging = __webpack_require__("./helpers/messaging.ts");
+        var messages = __webpack_require__("./browsers/browsers-lib/messages.ts");
+        var evaluate = __webpack_require__("./browsers/run-firefox/rdp/remote-firefox/evaluate.ts");
         async function listTabs(transport) {
             const response = await transport.request({
                 to: 'root',
@@ -6653,7 +6810,6 @@ var __webpack_modules__ = {
         }
         var external_node_net_ = __webpack_require__("node:net");
         var external_node_net_default = /*#__PURE__*/ __webpack_require__.n(external_node_net_);
-        var messaging = __webpack_require__("./helpers/messaging.ts");
         function parseRdpFrame(data) {
             const dataString = data.toString();
             const separatorIndex = dataString.indexOf(':');
@@ -6732,12 +6888,24 @@ var __webpack_modules__ = {
             if (emitter.listenerCount('error') > 0) return void emitter.emit('error', error);
             (0, messaging.Gg)(error instanceof Error ? error.message : String(error));
         }
+        function closedError(message) {
+            return Object.assign(new Error(message), {
+                code: messaging.Lp.E_BROWSER_CONNECTION_CLOSED
+            });
+        }
+        function protocolError(message) {
+            return Object.assign(new Error(message), {
+                code: messaging.Lp.E_RDP_PROTOCOL
+            });
+        }
         class RdpTransport extends external_node_events_default() {
             async connect(port, host = '127.0.0.1') {
                 await new Promise((resolve, reject)=>{
                     const timeoutMs = rdpRequestTimeoutMs();
                     const timer = setTimeout(()=>{
-                        this.settleGreeting(new Error(`Firefox sent no RDP greeting on port ${port} within ${timeoutMs}ms`));
+                        this.settleGreeting(Object.assign(new Error(`Firefox sent no RDP greeting on port ${port} within ${timeoutMs}ms`), {
+                            code: messaging.Lp.E_BROWSER_START_TIMEOUT
+                        }));
                         this.onConnectionLost();
                     }, timeoutMs);
                     timer.unref?.();
@@ -6761,8 +6929,8 @@ var __webpack_modules__ = {
                             this.conn = void 0;
                             this.settleGreeting(err);
                         });
-                        c.on('end', this.onConnectionLost.bind(this));
-                        c.on('close', this.onConnectionLost.bind(this));
+                        c.on('end', ()=>this.onConnectionLost());
+                        c.on('close', ()=>this.onConnectionLost());
                         c.on('timeout', this.onTimeout.bind(this));
                     } catch (err) {
                         this.settleGreeting(err);
@@ -6773,7 +6941,7 @@ var __webpack_modules__ = {
                 this.greetingPending?.(error);
             }
             disconnect() {
-                const closed = new Error(messages.qN('firefox'));
+                const closed = closedError(messages.qN('firefox'));
                 this.settleGreeting(closed);
                 const c = this.conn;
                 if (!c) return;
@@ -6816,7 +6984,7 @@ var __webpack_modules__ = {
                 this.pending = this.pending.filter(({ to, payload, deferred })=>{
                     if (this.active.has(to)) return true;
                     if (!this.conn) {
-                        deferred.reject(new Error(messages.Fm('firefox')));
+                        deferred.reject(closedError(messages.Fm('firefox')));
                         return false;
                     }
                     try {
@@ -6829,7 +6997,7 @@ var __webpack_modules__ = {
                 });
             }
             expectReply(to, deferred) {
-                if (this.active.has(to)) throw new Error(messages.cD('firefox', to));
+                if (this.active.has(to)) throw protocolError(messages.cD('firefox', to));
                 const timeoutMs = rdpRequestTimeoutMs();
                 const timer = setTimeout(()=>{
                     const entry = this.active.get(to);
@@ -6855,8 +7023,9 @@ var __webpack_modules__ = {
                 const { remainingData, parsedMessage, error, fatal } = parseRdpFrame(this.incoming);
                 this.incoming = remainingData;
                 if (error) {
-                    surfaceTransportError(this, new Error(messages.l9('firefox', error)));
-                    if (fatal) this.onConnectionLost();
+                    const malformed = protocolError(messages.l9('firefox', error));
+                    surfaceTransportError(this, malformed);
+                    if (fatal) this.onConnectionLost(malformed);
                     return !fatal;
                 }
                 if (!parsedMessage) return false;
@@ -6865,7 +7034,7 @@ var __webpack_modules__ = {
             }
             handleMessage(message) {
                 const from = message.from;
-                if (!from) return void surfaceTransportError(this, new Error(messages.HH('firefox', message)));
+                if (!from) return void surfaceTransportError(this, protocolError(messages.HH('firefox', message)));
                 if (this.greetingPending && isRootGreeting(message)) this.settleGreeting();
                 const entry = isUnsolicitedPacket(message) ? void 0 : this.active.get(from);
                 if (entry) {
@@ -6878,7 +7047,7 @@ var __webpack_modules__ = {
                 }
                 this.emit('message', message);
             }
-            onConnectionLost() {
+            onConnectionLost(cause) {
                 if (this.lost) return;
                 this.lost = true;
                 const c = this.conn;
@@ -6889,8 +7058,8 @@ var __webpack_modules__ = {
                     c.on('error', ()=>{});
                     c.destroy();
                 }
-                const closed = new Error(messages.qN('firefox'));
-                this.settleGreeting(closed);
+                const closed = closedError(messages.qN('firefox'));
+                this.settleGreeting(cause ?? closed);
                 this.rejectAll(closed);
                 this.emit('end');
             }
@@ -6972,7 +7141,9 @@ var __webpack_modules__ = {
                         to
                     });
                 }
-                throw new Error(messages.jP());
+                throw Object.assign(new Error(messages.jP()), {
+                    code: messaging.Lp.E_RDP_PROTOCOL
+                });
             }
             async getTargets() {
                 return await listTabs(this.transport);
@@ -6990,8 +7161,8 @@ var __webpack_modules__ = {
                     return {};
                 }
             }
-            async evaluate(tabId, expression) {
-                return evaluate(this, tabId, expression);
+            async evaluate(tabId, expression, extra) {
+                return (0, evaluate._)(this, tabId, expression, extra);
             }
             constructor(...args){
                 super(...args), messaging_client_define_property(this, "transport", new RdpTransport()), messaging_client_define_property(this, "forwardingSetup", false), messaging_client_define_property(this, "lastPort", null), messaging_client_define_property(this, "reconnecting", false), messaging_client_define_property(this, "disconnectedByUser", false);
@@ -7000,19 +7171,18 @@ var __webpack_modules__ = {
     },
     "./browsers/run-only.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         var node_fs__rspack_import_0 = __webpack_require__("node:fs");
-        var firefox_location2__rspack_import_1 = __webpack_require__("firefox-location2");
-        var _helpers_messaging__rspack_import_2 = __webpack_require__("./helpers/messaging.ts");
-        var _browsers_lib_banner__rspack_import_3 = __webpack_require__("./browsers/browsers-lib/banner.ts");
-        var _browsers_lib_browser_family__rspack_import_4 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
-        var _browsers_lib_messages__rspack_import_5 = __webpack_require__("./browsers/browsers-lib/messages.ts");
-        var _browsers_lib_output_binaries_resolver__rspack_import_6 = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
-        var _browsers_lib_ready_stamp__rspack_import_7 = __webpack_require__("./browsers/browsers-lib/ready-stamp.ts");
-        var _browsers_lib_runtime_options__rspack_import_13 = __webpack_require__("./browsers/browsers-lib/runtime-options.ts");
-        var _browsers_lib_version_probe__rspack_import_8 = __webpack_require__("./browsers/browsers-lib/version-probe.ts");
-        var _run_chromium_chromium_context__rspack_import_11 = __webpack_require__("./browsers/run-chromium/chromium-context/index.ts");
-        var _run_chromium_chromium_launch__rspack_import_9 = __webpack_require__("./browsers/run-chromium/chromium-launch/index.ts");
-        var _run_firefox_firefox_context__rspack_import_12 = __webpack_require__("./browsers/run-firefox/firefox-context/index.ts");
-        var _run_firefox_firefox_launch__rspack_import_10 = __webpack_require__("./browsers/run-firefox/firefox-launch/index.ts");
+        var _helpers_messaging__rspack_import_1 = __webpack_require__("./helpers/messaging.ts");
+        var _browsers_lib_banner__rspack_import_2 = __webpack_require__("./browsers/browsers-lib/banner.ts");
+        var _browsers_lib_browser_family__rspack_import_3 = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
+        var _browsers_lib_messages__rspack_import_4 = __webpack_require__("./browsers/browsers-lib/messages.ts");
+        var _browsers_lib_output_binaries_resolver__rspack_import_5 = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
+        var _browsers_lib_ready_stamp__rspack_import_6 = __webpack_require__("./browsers/browsers-lib/ready-stamp.ts");
+        var _browsers_lib_runtime_options__rspack_import_12 = __webpack_require__("./browsers/browsers-lib/runtime-options.ts");
+        var _browsers_lib_version_probe__rspack_import_7 = __webpack_require__("./browsers/browsers-lib/version-probe.ts");
+        var _run_chromium_chromium_context__rspack_import_10 = __webpack_require__("./browsers/run-chromium/chromium-context/index.ts");
+        var _run_chromium_chromium_launch__rspack_import_8 = __webpack_require__("./browsers/run-chromium/chromium-launch/index.ts");
+        var _run_firefox_firefox_context__rspack_import_11 = __webpack_require__("./browsers/run-firefox/firefox-context/index.ts");
+        var _run_firefox_firefox_launch__rspack_import_9 = __webpack_require__("./browsers/run-firefox/firefox-launch/index.ts");
         function createPreviewCompilationLike(opts) {
             return {
                 options: {
@@ -7080,6 +7250,7 @@ var __webpack_modules__ = {
                 extension: pluginOptions.extension,
                 browser: pluginOptions.browser,
                 profile: pluginOptions.profile,
+                profileSource: opts.profileSource,
                 preferences: pluginOptions.preferences,
                 browserFlags: pluginOptions.browserFlags,
                 startingUrl: pluginOptions.startingUrl,
@@ -7097,21 +7268,23 @@ var __webpack_modules__ = {
                 logTab: pluginOptions.logTab
             };
         }
+        function pinnedBinaryPath(opts) {
+            const pinned = (0, _browsers_lib_browser_family__rspack_import_3.M_)(opts.browser) ? opts.geckoBinary : opts.chromiumBinary;
+            return 'string' == typeof pinned && node_fs__rspack_import_0.existsSync(pinned) ? pinned : void 0;
+        }
         async function resolvePinnedBinaryVersionLine(opts) {
+            const pinned = pinnedBinaryPath(opts);
+            if (!pinned) return;
             try {
-                if ((0, _browsers_lib_browser_family__rspack_import_4.M_)(opts.browser)) {
-                    if (!opts.geckoBinary || !node_fs__rspack_import_0.existsSync(opts.geckoBinary)) return;
-                    return (0, firefox_location2__rspack_import_1.getFirefoxVersion)(opts.geckoBinary) || void 0;
-                }
-                if (!opts.chromiumBinary || !node_fs__rspack_import_0.existsSync(opts.chromiumBinary)) return;
-                return await (0, _browsers_lib_version_probe__rspack_import_8.yO)(opts.chromiumBinary, String(opts.browser)) || void 0;
+                const line = (0, _browsers_lib_browser_family__rspack_import_3.M_)(opts.browser) ? await (0, _browsers_lib_version_probe__rspack_import_7.vE)(pinned) : await (0, _browsers_lib_version_probe__rspack_import_7.yO)(pinned, String(opts.browser));
+                return line || void 0;
             } catch (error) {
-                if ((0, _browsers_lib_version_probe__rspack_import_8.g_)(error)) throw error;
+                if ((0, _browsers_lib_version_probe__rspack_import_7.g_)(error)) throw error;
                 return;
             }
         }
         async function buildPreviewBannerOptions(opts) {
-            const chromiumPinned = !(0, _browsers_lib_browser_family__rspack_import_4.M_)(opts.browser) && 'string' == typeof opts.chromiumBinary && node_fs__rspack_import_0.existsSync(opts.chromiumBinary);
+            const pinned = pinnedBinaryPath(opts);
             return {
                 browser: opts.browser,
                 outPath: opts.outPath,
@@ -7119,17 +7292,17 @@ var __webpack_modules__ = {
                 includeRunId: false,
                 readyPath: opts.readyPath,
                 browserVersionLine: await resolvePinnedBinaryVersionLine(opts),
-                ...chromiumPinned ? {
-                    binaryPath: opts.chromiumBinary,
+                ...pinned ? {
+                    binaryPath: pinned,
                     binaryProvenance: 'pinned'
                 } : {}
             };
         }
         function asLaunchFailure(error, browser, spawned) {
             const message = error instanceof Error ? error.message : String(error);
-            if (spawned || (0, _helpers_messaging__rspack_import_2.Qi)(message)) return error;
-            return Object.assign(new Error((0, _browsers_lib_messages__rspack_import_5.uA)(browser, (0, _browsers_lib_ready_stamp__rspack_import_7.dT)(error))), {
-                code: _helpers_messaging__rspack_import_2.Lp.E_BROWSER_LAUNCH,
+            if (spawned || (0, _helpers_messaging__rspack_import_1.Qi)(message) || (0, _browsers_lib_ready_stamp__rspack_import_6.NE)(error)) return error;
+            return Object.assign(new Error((0, _browsers_lib_messages__rspack_import_4.uA)(browser, (0, _browsers_lib_ready_stamp__rspack_import_6.dT)(error))), {
+                code: _helpers_messaging__rspack_import_1.Lp.E_BROWSER_LAUNCH,
                 cause: error
             });
         }
@@ -7143,21 +7316,21 @@ var __webpack_modules__ = {
             process.once('SIGINT', scheduleExitOnSignal);
             process.once('SIGTERM', scheduleExitOnSignal);
             process.once('SIGHUP', scheduleExitOnSignal);
-            (0, _browsers_lib_ready_stamp__rspack_import_7.Jk)(opts.outPath, opts.readyPath);
+            (0, _browsers_lib_ready_stamp__rspack_import_6.Jk)(opts.outPath, opts.readyPath);
             const compilationLike = createPreviewCompilationLike(opts);
             const previewPluginOptions = buildPreviewPluginOptions(opts);
             let bannerOptions;
             try {
                 bannerOptions = await buildPreviewBannerOptions(opts);
             } catch (error) {
-                (0, _browsers_lib_ready_stamp__rspack_import_7.dz)(opts.outPath, (0, _browsers_lib_ready_stamp__rspack_import_7.dT)(error), (0, _browsers_lib_ready_stamp__rspack_import_7.Uf)(opts.outPath), (0, _browsers_lib_ready_stamp__rspack_import_7.NE)(error));
+                (0, _browsers_lib_ready_stamp__rspack_import_6.dz)(opts.outPath, (0, _browsers_lib_ready_stamp__rspack_import_6.dT)(error), (0, _browsers_lib_ready_stamp__rspack_import_6.Uf)(opts.outPath), (0, _browsers_lib_ready_stamp__rspack_import_6.NE)(error));
                 throw error;
             }
-            (0, _browsers_lib_output_binaries_resolver__rspack_import_6.LB)(compilationLike);
-            if ((0, _browsers_lib_browser_family__rspack_import_4.rG)(opts.browser)) {
-                const ctx = (0, _run_chromium_chromium_context__rspack_import_11.g)();
-                const launcher = new _run_chromium_chromium_launch__rspack_import_9.f(buildPreviewChromiumOptions(opts), ctx);
-                await (0, _browsers_lib_banner__rspack_import_3.MK)(bannerOptions);
+            (0, _browsers_lib_output_binaries_resolver__rspack_import_5.LB)(compilationLike);
+            if ((0, _browsers_lib_browser_family__rspack_import_3.rG)(opts.browser)) {
+                const ctx = (0, _run_chromium_chromium_context__rspack_import_10.g)();
+                const launcher = new _run_chromium_chromium_launch__rspack_import_8.f(buildPreviewChromiumOptions(opts), ctx);
+                await (0, _browsers_lib_banner__rspack_import_2.MK)(bannerOptions);
                 try {
                     await launcher.runOnce(compilationLike, {
                         enableCdpPostLaunch: false,
@@ -7168,12 +7341,12 @@ var __webpack_modules__ = {
                 }
                 return;
             }
-            if ((0, _browsers_lib_browser_family__rspack_import_4.M_)(opts.browser)) {
-                const ctx = (0, _run_firefox_firefox_context__rspack_import_12.D)();
-                const launcher = new _run_firefox_firefox_launch__rspack_import_10.c(buildPreviewFirefoxOptions(opts), ctx);
-                await (0, _browsers_lib_banner__rspack_import_3.MK)(bannerOptions);
+            if ((0, _browsers_lib_browser_family__rspack_import_3.M_)(opts.browser)) {
+                const ctx = (0, _run_firefox_firefox_context__rspack_import_11.D)();
+                const launcher = new _run_firefox_firefox_launch__rspack_import_9.c(buildPreviewFirefoxOptions(opts), ctx);
+                await (0, _browsers_lib_banner__rspack_import_2.MK)(bannerOptions);
                 try {
-                    await launcher.runOnce(compilationLike, (0, _browsers_lib_runtime_options__rspack_import_13.zU)(previewPluginOptions, 'production', {
+                    await launcher.runOnce(compilationLike, (0, _browsers_lib_runtime_options__rspack_import_12.zU)(previewPluginOptions, 'production', {
                         persistProfile: previewPluginOptions.persistProfile,
                         geckoBinary: previewPluginOptions.geckoBinary
                     }));
@@ -7207,6 +7380,62 @@ var __webpack_modules__ = {
             (0, messaging._w)(messages.Aj(xcodebuildCmd));
         }
         var safari_config = __webpack_require__("./browsers/run-safari/safari-launch/safari-config.ts");
+        const RAISE_WAIT_MS = 5000;
+        const QUIT_MS = 3000;
+        const POLL_MS = 250;
+        const raisedApps = new Set();
+        let handlersInstalled = false;
+        function sleep(ms) {
+            return new Promise((resolve)=>setTimeout(resolve, ms));
+        }
+        function processAlive(pid) {
+            try {
+                process.kill(pid, 0);
+                return true;
+            } catch  {
+                return false;
+            }
+        }
+        function terminate(pid) {
+            try {
+                process.kill(pid, 'SIGTERM');
+            } catch  {}
+        }
+        function quitAllOnExit() {
+            for (const pid of raisedApps)terminate(pid);
+        }
+        function quitAllOnSignal() {
+            closeSafariContainerApps();
+        }
+        function installHandlersOnce() {
+            if (handlersInstalled) return;
+            handlersInstalled = true;
+            process.on('SIGINT', quitAllOnSignal);
+            process.on('SIGTERM', quitAllOnSignal);
+            process.on('SIGHUP', quitAllOnSignal);
+            process.on('exit', quitAllOnExit);
+        }
+        async function rememberRaisedContainerApp(tools, appPath, before) {
+            const deadline = Date.now() + RAISE_WAIT_MS;
+            let raised = [];
+            while(Date.now() < deadline){
+                raised = (await tools.listAppPids(appPath)).filter((pid)=>!before.has(pid));
+                if (raised.length > 0) break;
+                await sleep(POLL_MS);
+            }
+            for (const pid of raised)raisedApps.add(pid);
+            if (raised.length > 0) installHandlersOnce();
+            return raised;
+        }
+        async function closeSafariContainerApps() {
+            const pids = [
+                ...raisedApps
+            ];
+            raisedApps.clear();
+            for (const pid of pids)terminate(pid);
+            const deadline = Date.now() + QUIT_MS;
+            while(Date.now() < deadline && pids.some(processAlive))await sleep(POLL_MS);
+        }
         var external_node_child_process_ = __webpack_require__("node:child_process");
         function isMacOS() {
             return 'darwin' === process.platform;
@@ -7272,6 +7501,70 @@ var __webpack_modules__ = {
             const tail = lines.slice(-TOOL_TAIL_LINES).join('\n');
             return tail.length > TOOL_TAIL_BYTES ? tail.slice(-TOOL_TAIL_BYTES) : tail;
         }
+        function isAutomationSafariArgs(args) {
+            const tokens = args.trim().split(/\s+/);
+            const exe = tokens[0] || '';
+            const name = exe.slice(exe.lastIndexOf('/') + 1);
+            return 'Safari' === name && tokens.includes('--automation');
+        }
+        function isContainerAppArgs(appPath, args) {
+            return args.trim().startsWith(`${appPath}/Contents/MacOS/`);
+        }
+        function openAppArgs(target) {
+            return [
+                '-g',
+                target
+            ];
+        }
+        function listPidsWhere(matches) {
+            return new Promise((resolve)=>{
+                const child = (0, external_node_child_process_.spawn)('ps', [
+                    '-axww',
+                    '-o',
+                    'pid=,args='
+                ], {
+                    stdio: [
+                        'ignore',
+                        'pipe',
+                        'ignore'
+                    ]
+                });
+                let out = '';
+                child.stdout?.on('data', (chunk)=>out += String(chunk));
+                child.on('error', ()=>resolve([]));
+                child.on('close', ()=>{
+                    const pids = [];
+                    for (const line of out.split('\n')){
+                        const row = /^\s*(\d+)\s+(.*)$/.exec(line);
+                        if (row && matches(row[2])) pids.push(Number(row[1]));
+                    }
+                    resolve(pids);
+                });
+            });
+        }
+        function spawnWebDriverProcess(bin, args) {
+            return new Promise((resolve)=>{
+                const child = (0, external_node_child_process_.spawn)(bin, args, {
+                    stdio: 'ignore'
+                });
+                const stop = ()=>{
+                    try {
+                        child.kill('SIGTERM');
+                    } catch  {}
+                };
+                child.once('error', (error)=>resolve({
+                        ok: false,
+                        output: String(error),
+                        stop
+                    }));
+                child.once('spawn', ()=>resolve({
+                        ok: true,
+                        pid: child.pid,
+                        output: '',
+                        stop
+                    }));
+            });
+        }
         function runTool(bin, args, opts) {
             const streamOutput = (0, messaging._o)() && !opts?.quiet;
             return new Promise((resolve)=>{
@@ -7328,9 +7621,7 @@ var __webpack_modules__ = {
                 detectToolchain: ()=>detectSafariToolchain(),
                 runConverter: (args)=>runTool('xcrun', args),
                 runXcodebuild: (args)=>runTool('xcodebuild', args),
-                openApp: (target)=>runTool('open', [
-                        target
-                    ]),
+                openApp: (target)=>runTool('open', openAppArgs(target)),
                 openSafari: (binary)=>runTool('open', [
                         '-a',
                         binary
@@ -7343,7 +7634,202 @@ var __webpack_modules__ = {
                         quiet: true
                     });
                     return ok ? output : '';
+                },
+                startWebDriver: (port)=>spawnWebDriverProcess('safaridriver', [
+                        '-p',
+                        String(port)
+                    ]),
+                listAutomationPids: ()=>listPidsWhere(isAutomationSafariArgs),
+                listAppPids: (appPath)=>listPidsWhere((args)=>isContainerAppArgs(appPath, args))
+            };
+        }
+        var external_node_http_ = __webpack_require__("node:http");
+        var external_node_net_ = __webpack_require__("node:net");
+        const DRIVER_READY_MS = 5000;
+        const DRIVER_POLL_MS = 100;
+        const SESSION_CREATE_MS = 30000;
+        const SESSION_CLOSE_MS = 5000;
+        const AUTOMATION_QUIT_MS = 3000;
+        const activeSessions = new Set();
+        const activeDrivers = new Set();
+        let webdriver_handlersInstalled = false;
+        function freePort() {
+            return new Promise((resolve, reject)=>{
+                const server = external_node_net_.createServer();
+                server.unref();
+                server.once('error', reject);
+                server.listen(0, '127.0.0.1', ()=>{
+                    const address = server.address();
+                    const port = 'object' == typeof address && address ? address.port : 0;
+                    server.close(()=>resolve(port));
+                });
+            });
+        }
+        function driverRequest(port, method, pathname, body, timeoutMs) {
+            return new Promise((resolve, reject)=>{
+                const payload = void 0 === body ? '' : JSON.stringify(body);
+                const request = external_node_http_.request({
+                    host: '127.0.0.1',
+                    port,
+                    method,
+                    path: pathname,
+                    headers: {
+                        'Content-Type': 'application/json',
+                        'Content-Length': Buffer.byteLength(payload)
+                    },
+                    timeout: timeoutMs
+                }, (response)=>{
+                    let text = '';
+                    response.setEncoding('utf8');
+                    response.on('data', (chunk)=>text += chunk);
+                    response.on('end', ()=>{
+                        let parsed = {};
+                        try {
+                            parsed = text ? JSON.parse(text) : {};
+                        } catch  {
+                            parsed = {
+                                value: {
+                                    message: text.trim()
+                                }
+                            };
+                        }
+                        resolve({
+                            status: response.statusCode || 0,
+                            body: parsed
+                        });
+                    });
+                });
+                request.on('timeout', ()=>request.destroy(new Error('timed out')));
+                request.on('error', reject);
+                request.end(payload);
+            });
+        }
+        async function waitForDriver(port) {
+            const deadline = Date.now() + DRIVER_READY_MS;
+            let lastError = '';
+            while(Date.now() < deadline){
+                try {
+                    const reply = await driverRequest(port, 'GET', '/status', void 0, 1000);
+                    if (200 === reply.status) return null;
+                    lastError = `HTTP ${reply.status}`;
+                } catch (error) {
+                    lastError = String(error?.message || error);
                 }
+                await new Promise((resolve)=>setTimeout(resolve, DRIVER_POLL_MS));
+            }
+            return `safaridriver did not answer on port ${port} within ${DRIVER_READY_MS}ms (${lastError})`;
+        }
+        function refusalReason(reply) {
+            const value = reply.body?.value;
+            const message = 'string' == typeof value?.message ? value.message.trim() : '';
+            if (message) return message;
+            const error = 'string' == typeof value?.error ? value.error.trim() : '';
+            return error || `safaridriver answered HTTP ${reply.status}`;
+        }
+        function stopAllDriversOnExit() {
+            for (const driver of activeDrivers)driver.stop();
+        }
+        function closeAllOnSignal() {
+            closeSafariWebDriverSessions();
+        }
+        function webdriver_installHandlersOnce() {
+            if (webdriver_handlersInstalled) return;
+            webdriver_handlersInstalled = true;
+            process.on('SIGINT', closeAllOnSignal);
+            process.on('SIGTERM', closeAllOnSignal);
+            process.on('SIGHUP', closeAllOnSignal);
+            process.on('exit', stopAllDriversOnExit);
+        }
+        async function closeSafariWebDriverSessions() {
+            await Promise.all([
+                ...activeSessions
+            ].map((session)=>session.close()));
+        }
+        function webdriver_processAlive(pid) {
+            try {
+                process.kill(pid, 0);
+                return true;
+            } catch  {
+                return false;
+            }
+        }
+        async function quitRaisedAutomation(tools, before) {
+            const raised = (await tools.listAutomationPids()).filter((pid)=>!before.has(pid));
+            for (const pid of raised)try {
+                process.kill(pid, 'SIGTERM');
+            } catch  {}
+            const deadline = Date.now() + AUTOMATION_QUIT_MS;
+            while(Date.now() < deadline && raised.some(webdriver_processAlive))await new Promise((resolve)=>setTimeout(resolve, DRIVER_POLL_MS));
+        }
+        async function openSafariWebDriverSession(tools) {
+            let port;
+            try {
+                port = await freePort();
+            } catch (error) {
+                return {
+                    reason: `no free port for safaridriver: ${String(error)}`
+                };
+            }
+            const before = new Set(await tools.listAutomationPids());
+            const driver = await tools.startWebDriver(port);
+            if (!driver.ok) return {
+                reason: `safaridriver could not start: ${driver.output}`
+            };
+            activeDrivers.add(driver);
+            webdriver_installHandlersOnce();
+            const stopDriver = async ()=>{
+                driver.stop();
+                activeDrivers.delete(driver);
+                await quitRaisedAutomation(tools, before);
+            };
+            const notReady = await waitForDriver(port);
+            if (notReady) {
+                await stopDriver();
+                return {
+                    reason: notReady
+                };
+            }
+            let created;
+            try {
+                created = await driverRequest(port, 'POST', '/session', {
+                    capabilities: {
+                        alwaysMatch: {
+                            browserName: 'safari'
+                        }
+                    }
+                }, SESSION_CREATE_MS);
+            } catch (error) {
+                await stopDriver();
+                return {
+                    reason: `the WebDriver session request failed: ${String(error?.message || error)}`
+                };
+            }
+            const sessionId = created.body?.value?.sessionId;
+            if (200 !== created.status || 'string' != typeof sessionId || !sessionId) {
+                await stopDriver();
+                return {
+                    reason: refusalReason(created)
+                };
+            }
+            let closing = null;
+            const session = {
+                port,
+                sessionId,
+                close: ()=>{
+                    if (closing) return closing;
+                    closing = (async ()=>{
+                        activeSessions.delete(session);
+                        try {
+                            await driverRequest(port, 'DELETE', `/session/${sessionId}`, void 0, SESSION_CLOSE_MS);
+                        } catch  {}
+                        await stopDriver();
+                    })();
+                    return closing;
+                }
+            };
+            activeSessions.add(session);
+            return {
+                session
             };
         }
         function fallbackLogger() {
@@ -7437,6 +7923,24 @@ var __webpack_modules__ = {
                 (0, messaging._w)((0, ready_message.G)('development', String(host.browser)));
             } catch  {}
         }
+        async function holdWebDriverSession(tools, config, logger) {
+            await closeSafariWebDriverSessions();
+            const runId = (0, ready_stamp.Uf)(config.extensionDir);
+            const outcome = await openSafariWebDriverSession(tools);
+            if (outcome.session) {
+                const { port, sessionId } = outcome.session;
+                (0, ready_stamp.ZC)(config.extensionDir, {
+                    port,
+                    sessionId
+                }, runId);
+                logger.info?.(messages.Hp(port, sessionId));
+                return;
+            }
+            (0, ready_stamp.ZC)(config.extensionDir, {
+                unavailableReason: outcome.reason
+            }, runId);
+            logger.info?.(messages.lb(outcome.reason));
+        }
         async function runSafariPipeline(compilation, host, logger, mode) {
             const tools = host.tools || createSafariTools();
             const config = (0, safari_config.F7)(compilation, host);
@@ -7507,7 +8011,9 @@ var __webpack_modules__ = {
             }
             const target = external_node_fs_.existsSync(appPath) ? appPath : (0, safari_config.Gi)(config);
             logger.info?.(messages.fw(target));
+            const appsBefore = new Set(await tools.listAppPids(appPath));
             await tools.openApp(target);
+            if (host.announceDevReady) await rememberRaisedContainerApp(tools, appPath, appsBefore);
             if (config.safariBinary) await tools.openSafari(config.safariBinary);
             const raisedBundleId = config.safariBinary ? 'com.apple.Safari' : config.bundleIdentifier;
             const browserPid = await tools.resolvePid(raisedBundleId);
@@ -7521,7 +8027,10 @@ var __webpack_modules__ = {
             logger.info?.(messages.fO(config.appName, isSigned));
             if (await confirmRegisteredWithSafari(tools, config.bundleIdentifier)) logger.info?.(messages.fd(config.appName));
             else logger.info?.(messages.qY(config.appName));
-            if (host.announceDevReady) await announceSafariDevSession(host, config, appPath);
+            if (host.announceDevReady) {
+                await holdWebDriverSession(tools, config, logger);
+                await announceSafariDevSession(host, config, appPath);
+            }
             return completePackage(config, logger, mode);
         }
         async function packageSafariExtension(host, outputPath, logger, mode = 'full') {
@@ -7837,8 +8346,27 @@ var __webpack_modules__ = {
         });
     },
     "./helpers/messaging.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
-        var pintor__rspack_import_0 = __webpack_require__("pintor");
-        var pintor__rspack_import_0_default = /*#__PURE__*/ __webpack_require__.n(pintor__rspack_import_0);
+        __webpack_require__.d(__webpack_exports__, {
+            Lp: ()=>CODES,
+            Pr: ()=>ENVELOPE,
+            T_: ()=>artifactNoun,
+            QZ: ()=>browserDisplayName,
+            A6: ()=>browserRowValue,
+            Nr: ()=>card,
+            od: ()=>claimCardKey,
+            Sc: ()=>fmt,
+            Qi: ()=>hasChannelPrefix,
+            Gg: ()=>humanError,
+            _w: ()=>humanLine,
+            mR: ()=>humanWarn,
+            VR: ()=>isCardKeyClaimed,
+            _o: ()=>isDebug,
+            Pl: ()=>prefix,
+            UT: ()=>stripChannelPrefix
+        });
+        const external_node_util_namespaceObject = require("node:util");
+        var external_pintor_ = __webpack_require__("pintor");
+        var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
         const GLYPH = '⏵⏵⏵';
         const DEBUG_GLYPH = '···';
         const DEBUG_VALUES = new Set([
@@ -7855,11 +8383,11 @@ var __webpack_modules__ = {
             return DEBUG_VALUES.has(String(raw ?? '').trim().toLowerCase());
         }
         function prefix(type) {
-            if ('error' === type) return pintor__rspack_import_0_default().red(GLYPH);
-            if ('warn' === type) return pintor__rspack_import_0_default().brightYellow(GLYPH);
-            if ('success' === type) return pintor__rspack_import_0_default().green(GLYPH);
-            if ('debug' === type) return pintor__rspack_import_0_default().dim(pintor__rspack_import_0_default().gray(DEBUG_GLYPH));
-            return pintor__rspack_import_0_default().gray(GLYPH);
+            if ('error' === type) return external_pintor_default().red(GLYPH);
+            if ('warn' === type) return external_pintor_default().brightYellow(GLYPH);
+            if ('success' === type) return external_pintor_default().green(GLYPH);
+            if ('debug' === type) return external_pintor_default().dim(external_pintor_default().gray(DEBUG_GLYPH));
+            return external_pintor_default().gray(GLYPH);
         }
         const ANSI_PATTERN = /\[[0-9;]*m/g;
         function hasChannelPrefix(text) {
@@ -7876,7 +8404,7 @@ var __webpack_modules__ = {
             return MACHINE_OUTPUT_VALUES.has(String(process.env.EXTENSION_OUTPUT || '').trim().toLowerCase());
         }
         function humanLine(...parts) {
-            if (isMachineOutput()) return;
+            if (isMachineOutput()) return void process.stderr.write(`${(0, external_node_util_namespaceObject.format)(...parts)}\n`);
             console.log(...parts);
         }
         function humanWarn(...parts) {
@@ -7887,10 +8415,10 @@ var __webpack_modules__ = {
             console.error(...parts);
         }
         const fmt = {
-            heading: (title)=>pintor__rspack_import_0_default().underline(pintor__rspack_import_0_default().blue(title)),
-            label: (key)=>pintor__rspack_import_0_default().gray(key.toUpperCase()),
-            val: (value)=>pintor__rspack_import_0_default().underline(value),
-            code: (value)=>pintor__rspack_import_0_default().blue(value),
+            heading: (title)=>external_pintor_default().underline(external_pintor_default().blue(title)),
+            label: (key)=>external_pintor_default().gray(key.toUpperCase()),
+            val: (value)=>external_pintor_default().underline(value),
+            code: (value)=>external_pintor_default().blue(value),
             bullet: (value)=>`- ${value}`,
             block (title, rows) {
                 const head = fmt.heading(title);
@@ -7914,10 +8442,10 @@ var __webpack_modules__ = {
         function card(input = {}) {
             const version = String(input.version || '').trim();
             const suffix = String(input.suffix || '').trim();
-            const head = ` 🧩 Extension.js` + (version ? ` ${pintor__rspack_import_0_default().gray(version)}` : '') + (suffix ? ` ${suffix}` : '');
+            const head = ` 🧩 Extension.js` + (version ? ` ${external_pintor_default().gray(version)}` : '') + (suffix ? ` ${suffix}` : '');
             const body = (input.rows || []).filter((row)=>String(row.value || '').trim().length > 0).slice(0, MAX_CARD_ROWS).map((row)=>{
                 const label = row.label.padEnd(CARD_LABEL_WIDTH);
-                return `    ${label}${pintor__rspack_import_0_default().gray(String(row.value).trim())}`;
+                return `    ${label}${external_pintor_default().gray(String(row.value).trim())}`;
             });
             return [
                 head,
@@ -8030,7 +8558,6 @@ var __webpack_modules__ = {
             E_CONFIG_LOAD: 'E_CONFIG_LOAD',
             E_MANAGED_DEP_CONFLICT: 'E_MANAGED_DEP_CONFLICT',
             E_TYPES_EMIT: 'E_TYPES_EMIT',
-            E_TSCONFIG_MISSING: 'E_TSCONFIG_MISSING',
             E_OPTIONAL_DEP_UNRESOLVED: 'E_OPTIONAL_DEP_UNRESOLVED',
             E_OPTIONAL_DEP_LOAD: 'E_OPTIONAL_DEP_LOAD',
             E_OPTIONAL_DEP_UNKNOWN: 'E_OPTIONAL_DEP_UNKNOWN',
@@ -8046,11 +8573,9 @@ var __webpack_modules__ = {
             E_CSS_PARSE: 'E_CSS_PARSE',
             E_CSS_PREPROCESSOR_MISSING: 'E_CSS_PREPROCESSOR_MISSING',
             E_CSS_DEAD_REF: 'E_CSS_DEAD_REF',
-            E_INTEGRATION_INSTALL: 'E_INTEGRATION_INSTALL',
             E_POLYFILL_NOT_FOUND: 'E_POLYFILL_NOT_FOUND',
             E_LOCALES_LAYOUT: 'E_LOCALES_LAYOUT',
             E_WAR_INVALID: 'E_WAR_INVALID',
-            E_MATCH_PATTERN_INVALID: 'E_MATCH_PATTERN_INVALID',
             E_BACKGROUND_REQUIRED: 'E_BACKGROUND_REQUIRED',
             E_CONTENT_SCRIPT_SYNTAX: 'E_CONTENT_SCRIPT_SYNTAX',
             E_NO_ENTRYPOINTS: 'E_NO_ENTRYPOINTS',
@@ -8069,7 +8594,6 @@ var __webpack_modules__ = {
             E_BROWSER_START_TIMEOUT: 'E_BROWSER_START_TIMEOUT',
             E_LAUNCH_SKIPPED_COMPILE_ERRORS: 'E_LAUNCH_SKIPPED_COMPILE_ERRORS',
             E_INSTANCE_AMBIGUOUS: 'E_INSTANCE_AMBIGUOUS',
-            E_WSL_INTEROP: 'E_WSL_INTEROP',
             E_EXTENSION_LOAD_REFUSED: 'E_EXTENSION_LOAD_REFUSED',
             E_ADDON_INSTALL: 'E_ADDON_INSTALL',
             E_BROWSER_CONNECT: 'E_BROWSER_CONNECT',
@@ -8081,6 +8605,7 @@ var __webpack_modules__ = {
             E_RDP_PROTOCOL: 'E_RDP_PROTOCOL',
             E_PORT_IN_USE: 'E_PORT_IN_USE',
             E_SESSION_STOPPED: 'E_SESSION_STOPPED',
+            E_SESSION_EXISTS: 'E_SESSION_EXISTS',
             E_LOGS_STREAM_GAP: 'E_LOGS_STREAM_GAP',
             E_BROWSER_INSTALL_PRIVILEGE: 'E_BROWSER_INSTALL_PRIVILEGE',
             E_UNINSTALL_NOOP: 'E_UNINSTALL_NOOP'
@@ -8134,25 +8659,6 @@ var __webpack_modules__ = {
                 }, extras);
             }
         };
-        __webpack_require__.d(__webpack_exports__, {
-            A6: ()=>browserRowValue,
-            Gg: ()=>humanError,
-            Nr: ()=>card,
-            Pl: ()=>prefix,
-            QZ: ()=>browserDisplayName,
-            Qi: ()=>hasChannelPrefix,
-            T_: ()=>artifactNoun,
-            UT: ()=>stripChannelPrefix,
-            VR: ()=>isCardKeyClaimed,
-            _o: ()=>isDebug,
-            _w: ()=>humanLine,
-            mR: ()=>humanWarn,
-            od: ()=>claimCardKey
-        }, {
-            Lp: CODES,
-            Pr: ENVELOPE,
-            Sc: fmt
-        });
     },
     "./helpers/vendors.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         const EMULATOR_BROWSER_TARGET = 'chromium-emulator';
@@ -8283,6 +8789,8 @@ var __webpack_modules__ = {
         });
     },
     "./index.ts" (__unused_rspack_module, __unused_rspack___webpack_exports__, __webpack_require__) {
+        var external_node_fs_ = __webpack_require__("node:fs");
+        var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_);
         const MIN_NODE_MAJOR = 22;
         const MIN_NODE_MINOR = 12;
         const MIN_DENO_MAJOR = 2;
@@ -8326,7 +8834,42 @@ var __webpack_modules__ = {
         function unsupportedNodeVersionMessage(version) {
             return `[Extension.js] Requires Node.js >= ${MIN_NODE_MAJOR}.${MIN_NODE_MINOR} (you are on ${version}). Upgrade Node.js to run the extension CLI.`;
         }
-        function enforceSupportedNodeVersion(version = process.versions.node, bunVersion = detectBunVersion(), denoVersion = detectDenoVersion()) {
+        function wantsJsonOutput(argv) {
+            const inline = argv.find((arg)=>arg.startsWith('--output='));
+            const index = argv.indexOf('--output');
+            const spaced = index >= 0 ? argv[index + 1] : void 0;
+            const value = inline ? inline.slice(9) : spaced;
+            return 'json' === String(value || '').trim().toLowerCase();
+        }
+        function commandFromArgv(argv) {
+            for(let index = 2; index < argv.length; index += 1)if ('--output' === argv[index]) index += 1;
+            else if (!argv[index].startsWith('-')) return argv[index];
+            return 'extension';
+        }
+        function unsupportedNodeVersionFrame(version, argv) {
+            if (!wantsJsonOutput(argv)) return;
+            return {
+                schema: 1,
+                ok: false,
+                command: commandFromArgv(argv),
+                status: 'usage',
+                value: null,
+                error: {
+                    code: 'E_NODE_VERSION',
+                    message: unsupportedNodeVersionMessage(version).replace('[Extension.js] ', ''),
+                    name: 'CliError'
+                },
+                warnings: []
+            };
+        }
+        function writeFrame(frame) {
+            try {
+                external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
+            } catch  {
+                console.log(JSON.stringify(frame));
+            }
+        }
+        function enforceSupportedNodeVersion(version = process.versions.node, bunVersion = detectBunVersion(), denoVersion = detectDenoVersion(), argv = process.argv) {
             if (denoVersion) {
                 if (isSupportedDenoVersion(denoVersion)) return;
                 console.error(unsupportedDenoVersionMessage(denoVersion));
@@ -8341,20 +8884,23 @@ var __webpack_modules__ = {
             }
             if (isSupportedNodeVersion(version)) return;
             console.error(unsupportedNodeVersionMessage(version));
+            const frame = unsupportedNodeVersionFrame(version, argv);
+            if (frame) writeFrame(frame);
             process.exit(1);
         }
         enforceSupportedNodeVersion();
         const external_commander_namespaceObject = require("commander");
-        var external_node_fs_ = __webpack_require__("node:fs");
-        var external_node_fs_default = /*#__PURE__*/ __webpack_require__.n(external_node_fs_);
         var external_node_path_ = __webpack_require__("node:path");
         var external_node_path_default = /*#__PURE__*/ __webpack_require__.n(external_node_path_);
         var browser_family = __webpack_require__("./browsers/browsers-lib/browser-family.ts");
+        var evaluate = __webpack_require__("./browsers/run-firefox/rdp/remote-firefox/evaluate.ts");
         var messaging_client = __webpack_require__("./browsers/run-firefox/rdp/remote-firefox/messaging-client.ts");
         const RESULT_SLOT = '__extjsRdpEval';
         const FRAME_POLL_INTERVAL_MS = 100;
         const RESULT_POLL_INTERVAL_MS = 50;
         const FRAME_WAIT_MS = 2000;
+        const MAX_RESULT_BYTES = 262144;
+        const TRUNCATED_PREVIEW_CHARS = 1024;
         const EXTENSION_DOCUMENT_CONTEXTS = [
             'background',
             'popup',
@@ -8405,17 +8951,27 @@ var __webpack_modules__ = {
   globalThis.${RESULT_SLOT} = slot;
   function settle(next) { if (globalThis.${RESULT_SLOT} === slot) globalThis.${RESULT_SLOT} = next; }
   function encode(value) {
-    if (value === undefined) return {state: "value"};
-    try { return {state: "value", json: JSON.stringify(value)}; }
-    catch (error) { return {state: "value", json: JSON.stringify(String(value))}; }
+    var json;
+    try { json = JSON.stringify(value); }
+    catch (error) { json = JSON.stringify(String(value)); }
+    if (json === undefined) return {state: "value"};
+    if (json.length > ${MAX_RESULT_BYTES}) {
+      return {state: "value", truncated: true, json: JSON.stringify({__type: "truncated", preview: json.slice(0, ${TRUNCATED_PREVIEW_CHARS})})};
+    }
+    return {state: "value", json: json};
+  }
+  function thrown(error) {
+    var message = (error && error.message) || String(error);
+    var name = error && typeof error.name === "string" ? error.name : "";
+    return {state: "throw", message: name && message.indexOf(name + ":") !== 0 ? name + ": " + message : message};
   }
   try {
     Promise.resolve((${expression})).then(
       function (value) { settle(encode(value)); },
-      function (error) { settle({state: "throw", message: (error && error.message) || String(error)}); }
+      function (error) { settle(thrown(error)); }
     );
   } catch (error) {
-    settle({state: "throw", message: (error && error.message) || String(error)});
+    settle(thrown(error));
   }
   return "started";
 })()`;
@@ -8425,6 +8981,9 @@ var __webpack_modules__ = {
   if (slot && slot.state !== "pending") { try { delete globalThis.${RESULT_SLOT}; } catch (error) {} }
   return JSON.stringify(slot);
 })()`;
+        function statementBlock(source) {
+            return `{\n${source}\n}`;
+        }
         function readSettledSlot(raw) {
             if ('string' != typeof raw) return;
             let slot;
@@ -8448,17 +9007,70 @@ var __webpack_modules__ = {
                 ok: true,
                 value: void 0
             };
+            let value = slot.json;
             try {
-                return {
-                    ok: true,
-                    value: JSON.parse(slot.json)
-                };
-            } catch  {
-                return {
-                    ok: true,
-                    value: slot.json
-                };
-            }
+                value = JSON.parse(slot.json);
+            } catch  {}
+            return true === slot.truncated ? {
+                ok: true,
+                value,
+                truncated: true
+            } : {
+                ok: true,
+                value
+            };
+        }
+        async function readWholeString(client, value, limit = 1 / 0) {
+            const grip = value;
+            if (!grip || 'object' != typeof grip || 'longString' !== grip.type) return value;
+            const length = 'number' == typeof grip.length ? grip.length : 0;
+            const reply = await client.request({
+                to: String(grip.actor),
+                type: 'substring',
+                start: 0,
+                end: Math.min(length, limit)
+            });
+            if ('string' != typeof reply?.substring) throw new Error(`Firefox holds a ${length}-character result as a long string and did not hand it over`);
+            return reply.substring;
+        }
+        function capped(value) {
+            const json = JSON.stringify(value);
+            if (void 0 !== json && json.length > MAX_RESULT_BYTES) return {
+                ok: true,
+                truncated: true,
+                value: {
+                    __type: 'truncated',
+                    preview: json.slice(0, TRUNCATED_PREVIEW_CHARS)
+                }
+            };
+            return {
+                ok: true,
+                value
+            };
+        }
+        function readCompletionValue(grip) {
+            if (null === grip || 'object' != typeof grip) return capped(grip);
+            const { type, actor, text } = grip;
+            if ('object' === type && 'string' == typeof actor) return {
+                objectActor: actor
+            };
+            if ('undefined' === type || 'symbol' === type) return {
+                ok: true,
+                value: void 0
+            };
+            if ('BigInt' === type) return {
+                ok: true,
+                value: String(text)
+            };
+            if ('-0' === type) return {
+                ok: true,
+                value: 0
+            };
+            if ('null' === type || 'NaN' === type || 'Infinity' === type || '-Infinity' === type) return {
+                ok: true,
+                value: null
+            };
+            return refuse('Unsupported', `Firefox answered a value of the kind "${String(type)}", which this route cannot read back. Wrap the statements in a function that returns the value`);
         }
         const sleep = (ms)=>new Promise((resolve)=>{
                 const timer = setTimeout(resolve, ms);
@@ -8490,6 +9102,37 @@ var __webpack_modules__ = {
                 watcherActor: watcher.actor
             };
         }
+        async function evaluateStatements(client, consoleActor, source) {
+            let completion;
+            try {
+                completion = await client.evaluate(consoleActor, statementBlock(source));
+            } catch (error) {
+                if (!(error instanceof evaluate.K)) throw error;
+                return refuse('EvalError', error.message);
+            }
+            return readCompletionValue(await readWholeString(client, completion, MAX_RESULT_BYTES + 1));
+        }
+        async function evaluateInConsole(options) {
+            const { client, consoleActor, expression, timeoutMs, where } = options;
+            try {
+                await client.evaluate(consoleActor, startExpression(expression));
+            } catch (error) {
+                if (!(error instanceof evaluate.K)) throw error;
+                if (!/^SyntaxError\b/.test(error.message)) return refuse('EvalError', error.message);
+                const completion = await evaluateStatements(client, consoleActor, expression);
+                if ('ok' in completion) return completion;
+                await client.evaluate(consoleActor, startExpression('_self'), {
+                    selectedObjectActor: completion.objectActor
+                });
+            }
+            const deadline = Date.now() + timeoutMs;
+            for(;;){
+                const settled = readSettledSlot(await readWholeString(client, await client.evaluate(consoleActor, POLL_EXPRESSION)));
+                if (settled) return settled;
+                if (Date.now() >= deadline) return refuse('Timeout', `the expression did not settle in ${where} within ${timeoutMs}ms`);
+                await sleep(RESULT_POLL_INTERVAL_MS);
+            }
+        }
         async function evaluateThroughWatcher(options) {
             const { client, extensionId, context, pagePath, expression, timeoutMs } = options;
             const located = await locateAddonWatcher(client, extensionId);
@@ -8519,14 +9162,13 @@ var __webpack_modules__ = {
                     consoleActor = pickDocumentFrame(frames, context, pagePath);
                 }
                 if (!consoleActor) return refuse('TargetNotFound', 'background' === context ? "the add-on's background document is not running, so there is nothing to evaluate in" : `the ${context} document is not open (open it first: extension open ${context})`);
-                await client.evaluate(consoleActor, startExpression(expression));
-                const resultDeadline = Date.now() + timeoutMs;
-                for(;;){
-                    const settled = readSettledSlot(await client.evaluate(consoleActor, POLL_EXPRESSION));
-                    if (settled) return settled;
-                    if (Date.now() >= resultDeadline) return refuse('Timeout', `the expression did not settle in the ${context} document within ${timeoutMs}ms`);
-                    await sleep(RESULT_POLL_INTERVAL_MS);
-                }
+                return await evaluateInConsole({
+                    client,
+                    consoleActor,
+                    expression,
+                    timeoutMs,
+                    where: `the ${context} document`
+                });
             } finally{
                 stopListening();
                 Promise.resolve(client.request({
@@ -8548,29 +9190,66 @@ var __webpack_modules__ = {
                 });
             });
         }
-        async function evaluateExtensionDocument(options) {
+        async function withDebugger(rdpPort, timeoutMs, run) {
             const client = new messaging_client.G();
             try {
-                const connected = await connectWithin(client, options.rdpPort, options.timeoutMs);
+                const connected = await connectWithin(client, rdpPort, timeoutMs);
                 if ('timeout' === connected) {
                     client.disconnect();
-                    return refuse('Timeout', `the Firefox debugger on port ${options.rdpPort} sent no RDP greeting within ${options.timeoutMs}ms`);
+                    return refuse('Timeout', `the Firefox debugger on port ${rdpPort} sent no RDP greeting within ${timeoutMs}ms`);
                 }
             } catch (error) {
                 client.disconnect();
-                return refuse('Unavailable', `could not reach the Firefox debugger on port ${options.rdpPort}: ${error?.message || 'connection refused'}`);
+                return refuse('Unavailable', `could not reach the Firefox debugger on port ${rdpPort}: ${error?.message || 'connection refused'}`);
             }
             try {
-                return await evaluateThroughWatcher({
-                    ...options,
-                    client: client
-                });
+                return await run(client);
             } catch (error) {
                 return refuse('Unavailable', error?.message || 'the Firefox debugger connection failed mid-evaluation');
             } finally{
                 client.disconnect();
             }
         }
+        async function evaluateExtensionDocument(options) {
+            return await withDebugger(options.rdpPort, options.timeoutMs, (client)=>evaluateThroughWatcher({
+                    ...options,
+                    client
+                }));
+        }
+        function pickTabDescriptor(tabs, url) {
+            const matches = tabs.filter((tab)=>'string' == typeof tab.actor && tab.actor && tab.url === url);
+            return 1 === matches.length ? String(matches[0].actor) : void 0;
+        }
+        async function evaluateThroughTab(options) {
+            const { client, url, expression, timeoutMs } = options;
+            const listed = await client.request({
+                to: 'root',
+                type: 'listTabs'
+            });
+            const descriptor = pickTabDescriptor(listed?.tabs || [], url);
+            if (!descriptor) return;
+            const target = await client.request({
+                to: descriptor,
+                type: 'getTarget'
+            });
+            const consoleActor = target?.frame?.consoleActor;
+            if ('string' != typeof consoleActor || !consoleActor) return;
+            return await evaluateInConsole({
+                client,
+                consoleActor,
+                expression,
+                timeoutMs,
+                where: 'the page'
+            });
+        }
+        async function evaluateTabDocument(options) {
+            const outcome = await withDebugger(options.rdpPort, options.timeoutMs, (client)=>evaluateThroughTab({
+                    ...options,
+                    client
+                }));
+            if (outcome && !outcome.ok && 'Unavailable' === outcome.error.name) return;
+            return outcome;
+        }
         var emulator_session = __webpack_require__("./helpers/emulator-session.ts");
         var external_pintor_ = __webpack_require__("pintor");
         var external_pintor_default = /*#__PURE__*/ __webpack_require__.n(external_pintor_);
@@ -8868,7 +9547,8 @@ var __webpack_modules__ = {
                             ...enforcedProps,
                             ...this.common,
                             app: this.app,
-                            $ip: null
+                            $ip: null,
+                            $geoip_disable: true
                         },
                         distinct_id: this.anonId
                     };
@@ -9018,7 +9698,7 @@ var __webpack_modules__ = {
             return Math.min(Math.max(n, min), max);
         }
         const TEMPLATE_CORPUS_REPO = 'extension-js/examples';
-        const TEMPLATE_CORPUS_REF = '573d5d58174122606e5d6b6b0f2eafd6c02dcbf7';
+        const TEMPLATE_CORPUS_REF = 'd69e46b311c27d11a98d241494023101b337281f';
         const TEMPLATE_CORPUS_SLUGS = [
             'action',
             'action-locales',
@@ -9352,6 +10032,14 @@ var __webpack_modules__ = {
             if (listTemplates().includes(name)) return name;
             if (templateAliasFor(name)) return name;
         }
+        const CREATE_SOURCES = new Set([
+            'cli',
+            'templates'
+        ]);
+        function createSourceTag(value) {
+            const tag = String(value ?? '').trim().toLowerCase();
+            return CREATE_SOURCES.has(tag) ? tag : 'cli';
+        }
         function telemetryCommandContext(command, argv = process.argv) {
             const install = (0, browser_install_outcome.w6)();
             const installContext = install ? {
@@ -9368,9 +10056,9 @@ var __webpack_modules__ = {
                     '--template',
                     '-t'
                 ])),
-                source: readArgValue(argv, [
+                source: createSourceTag(readArgValue(argv, [
                     '--source'
-                ]) || 'cli'
+                ]))
             };
         }
         const consent = resolveTelemetryConsent(process.argv);
@@ -9506,6 +10194,14 @@ var __webpack_modules__ = {
         function parseJsonSafe(filePath) {
             return JSON.parse(external_node_fs_default().readFileSync(filePath, 'utf8'));
         }
+        function runtimeNotFound(message) {
+            return Object.assign(new Error(message), {
+                code: messaging.Lp.E_RUNTIME_NOT_FOUND
+            });
+        }
+        function runtimeNotBuilt(root) {
+            return runtimeNotFound(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
+        }
         function resolveDevelopRootFromDir(dir) {
             try {
                 const packageJsonPath = external_node_path_default().join(dir, 'package.json');
@@ -9574,7 +10270,7 @@ var __webpack_modules__ = {
         }
         function resolveExtensionDevelopRoot(startDir = __dirname) {
             const { root, source } = resolvePreferredDevelopRoot(startDir);
-            if (!root) throw new Error('Unable to locate the extension-develop runtime.');
+            if (!root) throw runtimeNotFound('Unable to locate the extension-develop runtime.');
             process.env.EXTENSION_DEVELOP_ROOT = root;
             if ('workspace' === source) process.env.EXTENSION_CREATE_DEVELOP_ROOT = root;
             return root;
@@ -9601,7 +10297,7 @@ var __webpack_modules__ = {
             const { source } = resolvePreferredDevelopRoot(startDir);
             const distEntry = resolveDevelopDistEntry(root);
             if (distEntry) return importModule(distEntry);
-            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
+            if ('workspace' === source) throw runtimeNotBuilt(root);
             return await import("extension-develop");
         }
         async function loadExtensionDevelopPreviewModule(startDir = __dirname) {
@@ -9611,7 +10307,7 @@ var __webpack_modules__ = {
             if (previewEntry) return importModule(previewEntry);
             const fullEntry = resolveDevelopDistEntry(root);
             if (fullEntry) return importModule(fullEntry);
-            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
+            if ('workspace' === source) throw runtimeNotBuilt(root);
             return await import("extension-develop/preview");
         }
         async function loadExtensionDevelopBridgeModule(startDir = __dirname) {
@@ -9619,7 +10315,7 @@ var __webpack_modules__ = {
             const { source } = resolvePreferredDevelopRoot(startDir);
             const bridgeEntry = resolveDevelopDistEntry(root, 'bridge');
             if (bridgeEntry) return importModule(bridgeEntry);
-            if ('workspace' === source) throw new Error(`Local extension-develop runtime is not built at ${external_node_path_default().join(root, 'dist')}. Run \`pnpm --filter extension-develop compile\` before invoking the local CLI.`);
+            if ('workspace' === source) throw runtimeNotBuilt(root);
             const bridgeSpecifier = 'extension-develop/bridge';
             return await import(bridgeSpecifier);
         }
@@ -10321,9 +11017,13 @@ Cross-browser compatibility
                         ],
                         notes: [
                             'ready.json is written atomically by the build (dev/start) on each compile',
+                            'start with a browser to launch stays on starting, with compiledAt set, until the launch passed its binary checks, so --wait keeps waiting and reports a refused pin as that refusal',
                             'events.ndjson is reset at every run start and appends entries with runId, durationMs and errorCount for that run only, join on runId across runs',
+                            'dev --browser safari holds one safaridriver session beside the app and stamps webdriverPort and webdriverSessionId, or webdriverUnavailableReason when Safari automation is off, attach to that session instead of opening a second',
+                            'a Chromium dev session whose CDP wire failed after launch stays ready and stamps cdpFaultCode and cdpFaultMessage, the ready frame under --output json carries the same fault as a coded warning, reload and HMR cannot attach until it is fixed',
                             '--wait requires a local project path (remote URLs are not supported)',
-                            'consumers should verify pid liveness and recency before trusting a contract'
+                            'consumers should verify pid liveness and recency before trusting a contract',
+                            'a build-failed or compile-failed frame under --output json lists each diagnostic in error.details as {code?, message, file?, line?, column?, severity, name?}, errors first, capped at twenty with truncated: true when cut'
                         ]
                     },
                     dockerAndContainers: {
@@ -10705,7 +11405,7 @@ Cross-browser compatibility
             const rotated = file.replace(/\.ndjson$/, '.1.ndjson');
             console.error(external_pintor_default().dim(external_pintor_default().gray(`… earlier events of this session were rotated to ${rotated} at ${header.startedAt}`)));
         }
-        function writeFrame(frame) {
+        function logs_writeFrame(frame) {
             try {
                 external_node_fs_default().writeSync(1, `${JSON.stringify(frame)}\n`);
             } catch  {
@@ -10723,7 +11423,7 @@ Cross-browser compatibility
                 const tab = parsePositiveInt('--tab', options.tab);
                 if (!tab.ok) {
                     console.error(tab.message);
-                    if ('pretty' !== format) writeFrame(messaging.Pr.fail('logs', 'usage', {
+                    if ('pretty' !== format) logs_writeFrame(messaging.Pr.fail('logs', 'usage', {
                         code: messaging.Lp.E_FLAG_VALUE_INVALID,
                         message: tab.message,
                         name: 'CliError'
@@ -10738,7 +11438,7 @@ Cross-browser compatibility
                 const emulatorRefusal = (0, emulator_session.MC)(bridge, projectPath, browser, 'logs');
                 if (emulatorRefusal) {
                     console.error(emulatorRefusal);
-                    if ('pretty' !== format) writeFrame(messaging.Pr.fail('logs', 'failed', {
+                    if ('pretty' !== format) logs_writeFrame(messaging.Pr.fail('logs', 'failed', {
                         code: messaging.Lp.E_COMMAND_UNSUPPORTED_FOR_TARGET,
                         message: emulatorRefusal,
                         name: 'CliError'
@@ -10752,7 +11452,7 @@ Cross-browser compatibility
                 if (!external_node_fs_default().existsSync(file)) {
                     const message = `No logs found at ${file}. Start a dev session (extension dev) first, or pass --browser to match it.`;
                     console.error(message);
-                    if ('pretty' !== format) writeFrame(messaging.Pr.fail('logs', 'not-found', {
+                    if ('pretty' !== format) logs_writeFrame(messaging.Pr.fail('logs', 'not-found', {
                         code: messaging.Lp.E_LOGS_NOT_FOUND,
                         message,
                         name: 'CliError'
@@ -10779,7 +11479,7 @@ Cross-browser compatibility
         }
         function refuseUsage(format, message) {
             console.error(message);
-            if ('pretty' !== format) writeFrame(messaging.Pr.fail('logs', 'usage', {
+            if ('pretty' !== format) logs_writeFrame(messaging.Pr.fail('logs', 'usage', {
                 code: messaging.Lp.E_INVALID_OPTION,
                 message,
                 name: 'CliError'
@@ -10793,7 +11493,7 @@ Cross-browser compatibility
             if (!ready) {
                 const message = `No active dev session control channel found for ${browser}. Looked at ${sessionReadyPath(bridge, projectPath, browser)}. Run \`extension dev --browser=${browser}\` first.`;
                 console.error(message);
-                if ('pretty' !== format) writeFrame(messaging.Pr.fail('logs', 'not-found', {
+                if ('pretty' !== format) logs_writeFrame(messaging.Pr.fail('logs', 'not-found', {
                     code: messaging.Lp.E_SESSION_NOT_FOUND,
                     message,
                     name: 'CliError'
@@ -10907,6 +11607,14 @@ Cross-browser compatibility
         };
         const CSP_BLOCKED_EVAL = /\bcall to eval\(\)|\bblocked by (?:the )?csp\b|\bextension csp\b|content security policy|content_security_policy|unsafe-eval/i;
         const CSP_BLOCKS_EVAL_HINT = "The extension's own content_security_policy forbids eval in this document, so no expression runs there, 1 + 1 included. Read the document with extension inspect --context <context>, or evaluate in a web page with extension eval --context page --tab <id>.";
+        const CSP_BLOCKS_EVAL_HINT_PAGE = "The page's own Content-Security-Policy forbids eval, so the in-page executor runs no expression in this tab. The extension's policy is not involved. Read the page with extension inspect --context page --tab <id>.";
+        const CSP_BLOCKS_EVAL_HINT_PAGE_GECKO = " Firefox evaluates such a page through its debugger instead when exactly one open tab is on that url, so close the duplicate tab and run it again.";
+        const CSP_BLOCKS_EVAL_HINT_CONTENT = "The extension's own content_security_policy forbids eval in the content-script world of every tab, 1 + 1 included. Evaluate in the page's own world with extension eval --context page --tab <id>, or read the DOM with extension inspect --context content --tab <id>.";
+        function cspBlocksEvalHint(context, browser) {
+            if ('content' === context) return CSP_BLOCKS_EVAL_HINT_CONTENT;
+            if ('page' !== context) return CSP_BLOCKS_EVAL_HINT;
+            return (0, browser_family.M_)(browser) ? CSP_BLOCKS_EVAL_HINT_PAGE + CSP_BLOCKS_EVAL_HINT_PAGE_GECKO : CSP_BLOCKS_EVAL_HINT_PAGE;
+        }
         const URL_REFUSED_HINT_GECKO = "Firefox refuses privileged pages (about:newtab, about:config, about:addons, and chrome:, file:, data: and javascript: urls) from an extension's tabs API. Only web urls and about:blank open this way. Open the extension's own pages by their moz-extension:// url instead.";
         const URL_REFUSED_HINT_CHROMIUM = "Chromium refuses javascript: urls from an extension's tabs API. To run code in a page, use extension eval --context content --tab <id> on a session started with --allow-eval.";
         const URL_REFUSED_HINT_GENERIC = "The browser refuses this url from an extension's tabs API. Web urls and about:blank open on every engine.";
@@ -10917,7 +11625,11 @@ Cross-browser compatibility
         }
         const TAB_NOT_FOUND_HINT = "List the open tabs and their ids with extension inspect --list-tabs, or drop --tab to target the active tab.";
         const GECKO_IDLE_EVENT_PAGE_HINT = "Firefox suspends an MV3 event page when it goes idle, and a suspended page has nothing to evaluate in. Wake the extension first, by opening one of its surfaces or triggering one of its listeners, then evaluate again.";
-        function codeForBridgeError(name, message, refusal) {
+        const BRIDGE_FAULT_NAMES = new Set([
+            'ExecutorError',
+            'TabsError'
+        ]);
+        function codeForBridgeError(name, message, refusal, command) {
             if (refusal && refusal in REFUSAL_TO_CODE) return REFUSAL_TO_CODE[refusal];
             if ('Timeout' === name) return messaging.Lp.E_TIMEOUT;
             if ('Unavailable' === name) return messaging.Lp.E_CONTROL_UNAVAILABLE;
@@ -10930,6 +11642,7 @@ Cross-browser compatibility
             if ('EvalError' === name) return messaging.Lp.E_EVAL;
             if ('InspectError' === name) return messaging.Lp.E_INSPECT;
             if ('StorageError' === name) return messaging.Lp.E_STORAGE;
+            if ('eval' === command && !BRIDGE_FAULT_NAMES.has(name)) return messaging.Lp.E_EVAL;
             return messaging.Lp.E_INTERNAL;
         }
         function statusForCode(code) {
@@ -10940,7 +11653,7 @@ Cross-browser compatibility
             return 'failed';
         }
         function buildActEnvelope(command, result) {
-            const { ok, value, truncated, error, ...extras } = result;
+            const { ok, value, truncated, error, type, cmdId, ...extras } = result;
             const wasTruncated = true === truncated;
             if (ok) return {
                 ...extras,
@@ -10952,7 +11665,7 @@ Cross-browser compatibility
             const name = 'string' == typeof raw.name ? raw.name : 'Error';
             const message = 'string' == typeof raw.message ? raw.message : 'command failed';
             const refusal = 'string' == typeof raw.code ? raw.code : void 0;
-            const code = codeForBridgeError(name, message, refusal);
+            const code = codeForBridgeError(name, message, refusal, 'string' == typeof raw.name ? command : void 0);
             const hint = 'string' == typeof raw.hint ? raw.hint : 'url_refused' === refusal ? urlRefusedHint(raw.engine) : 'tab_not_found' === refusal ? TAB_NOT_FOUND_HINT : code === messaging.Lp.E_CSP_BLOCKS_EVAL ? CSP_BLOCKS_EVAL_HINT : code === messaging.Lp.E_EVAL ? 'The expression threw inside the page. Check the expression itself.' : code === messaging.Lp.E_USER_GESTURE_REQUIRED ? "The browser opens this surface only in response to a click, and refuses to open it any other way. Click the extension in the browser toolbar to open it." : void 0;
             return {
                 ...extras,
@@ -11110,6 +11823,35 @@ Cross-browser compatibility
                 timeoutMs
             });
         }
+        function pickTargetTabUrl(tabs, target) {
+            const withUrl = tabs.filter((tab)=>'string' == typeof tab.url && tab.url.length > 0);
+            if ('number' == typeof target.tabId) return withUrl.find((tab)=>tab.id === target.tabId)?.url;
+            if (target.url) {
+                const wanted = target.url;
+                return (withUrl.find((tab)=>tab.url === wanted) ?? withUrl.find((tab)=>tab.url.includes(wanted)))?.url;
+            }
+            const active = withUrl.filter((tab)=>true === tab.active);
+            return 1 === active.length ? active[0].url : void 0;
+        }
+        async function geckoProtocolPageEval(bridge, projectPath, browser, listTabs, target, expression, timeoutMs) {
+            const ready = bridge.readReadyContractDocument(projectPath, browser);
+            const rdpPort = 'number' == typeof ready?.rdpPort ? ready.rdpPort : 0;
+            if (!rdpPort) return;
+            let tabs;
+            try {
+                tabs = await listTabs();
+            } catch  {
+                return;
+            }
+            const url = pickTargetTabUrl(tabs?.ok && Array.isArray(tabs.value) ? tabs.value : [], target);
+            if (!url) return;
+            return await evaluateTabDocument({
+                rdpPort,
+                url,
+                expression,
+                timeoutMs
+            });
+        }
         async function runCommand(input) {
             const bridge = await loadExtensionDevelopBridgeModule();
             const projectPath = resolveSessionProjectPath(bridge, input.projectPathArg);
@@ -11176,16 +11918,33 @@ Cross-browser compatibility
                     ...outputFrame,
                     code: /timed out/i.test(message) ? messaging.Lp.E_TIMEOUT : messaging.Lp.E_CONTROL_UNAVAILABLE
                 });
+            }
+            const geckoEvalFailed = 'eval' === input.op && result?.ok !== true && (0, browser_family.M_)(browser);
+            try {
+                if (geckoEvalFailed && isExtensionDocumentContext(input.target.context) && (bridgeBlamedTheExtensionCsp(result) || bridgeHadNoExecutor(result))) {
+                    const overProtocol = await geckoProtocolEval(bridge, projectPath, browser, input.target.context, String(input.args?.expression ?? ''), timeoutMs);
+                    if (overProtocol) result = overProtocol;
+                    else if (bridgeHadNoExecutor(result)) {
+                        const raw = result?.error || {};
+                        if ('string' != typeof raw.hint) raw.hint = GECKO_IDLE_EVENT_PAGE_HINT;
+                    }
+                } else if (geckoEvalFailed && 'page' === input.target.context && bridgeBlamedTheExtensionCsp(result)) {
+                    const overProtocol = await geckoProtocolPageEval(bridge, projectPath, browser, ()=>controller.command({
+                            op: 'tabs.query',
+                            target: {
+                                context: 'background'
+                            },
+                            args: {},
+                            timeoutMs
+                        }), input.target, String(input.args?.expression ?? ''), timeoutMs);
+                    if (overProtocol) result = overProtocol;
+                }
             } finally{
                 controller.close();
             }
-            if ('eval' === input.op && result?.ok !== true && (0, browser_family.M_)(browser) && isExtensionDocumentContext(input.target.context) && (bridgeBlamedTheExtensionCsp(result) || bridgeHadNoExecutor(result))) {
-                const overProtocol = await geckoProtocolEval(bridge, projectPath, browser, input.target.context, String(input.args?.expression ?? ''), timeoutMs);
-                if (overProtocol) result = overProtocol;
-                else if (bridgeHadNoExecutor(result)) {
-                    const raw = result?.error || {};
-                    if ('string' != typeof raw.hint) raw.hint = GECKO_IDLE_EVENT_PAGE_HINT;
-                }
+            if ('eval' === input.op && bridgeBlamedTheExtensionCsp(result)) {
+                const raw = result?.error || {};
+                if ('string' != typeof raw.hint) raw.hint = cspBlocksEvalHint(input.target.context, browser);
             }
             if (result?.ok && input.augment) try {
                 Object.assign(result, input.augment(projectPath, browser, result));
@@ -11458,7 +12217,7 @@ Cross-browser compatibility
         function isErrorFramed(err) {
             return Boolean(err && 'object' == typeof err && true === err[FRAMED_FLAG]);
         }
-        function wantsJsonOutput(argv) {
+        function cli_failure_wantsJsonOutput(argv) {
             return 'json' === normalizeOutputFormat(scanArgvValue(argv, '--output'));
         }
         function isCommanderError(err) {
@@ -11535,7 +12294,7 @@ Cross-browser compatibility
             return `${(0, messaging.Pl)('error')} ${label}\n${remedy}`;
         }
         function isUsageCode(code) {
-            return code === messaging.Lp.E_BROWSER_BINARY_INVALID;
+            return code === messaging.Lp.E_BROWSER_BINARY_INVALID || code === messaging.Lp.E_BROWSER_BINARY_REQUIRED || code === messaging.Lp.E_FLAG_NOT_SUPPORTED_HERE;
         }
         function declaredErrorCode(err) {
             const code = err?.code;
@@ -11797,11 +12556,16 @@ Cross-browser compatibility
                     if (summary) summaries.push(summary);
                 } catch (error) {
                     if (!asJson) throw error;
+                    const { diagnostics, truncated } = error ?? {};
                     console.log(JSON.stringify(messaging.Pr.fail('build', 'build-failed', {
                         code: declaredErrorCode(error) ?? messaging.Lp.E_COMPILE,
-                        message: error instanceof Error ? error.message : String(error)
+                        message: error instanceof Error ? error.message : String(error),
+                        ...Array.isArray(diagnostics) && diagnostics.length > 0 ? {
+                            details: diagnostics
+                        } : {}
                     }, {
-                        hint: "Fix the error above and run build again."
+                        hint: "Fix the error above and run build again.",
+                        truncated: true === truncated
                     })));
                     process.exit(1);
                 }
@@ -11810,9 +12574,23 @@ Cross-browser compatibility
                     browsers: built,
                     mode: mode ?? 'production',
                     summaries
+                }, {
+                    warnings: codedWarningsOf(summaries)
                 })));
             });
         }
+        function codedWarningsOf(summaries) {
+            const coded = [];
+            for (const summary of summaries){
+                const warnings = summary?.warnings;
+                if (Array.isArray(warnings)) for (const line of warnings){
+                    if ('string' != typeof line) continue;
+                    const code = line.slice(0, line.indexOf(': '));
+                    if (Object.prototype.hasOwnProperty.call(messaging.Lp, code) && !coded.includes(line)) coded.push(line);
+                }
+            }
+            return coded;
+        }
         const READY_CONTRACT_SCHEMA_VERSION = 2;
         const RECORD_STREAM_COMMANDS = new Set([
             'logs'
@@ -12061,6 +12839,11 @@ Cross-browser compatibility
             if ('string' != typeof code) return;
             return READY_CONTRACT_CODES[code.trim().toLowerCase()];
         }
+        function stampedLaunchFailureCode(ready) {
+            if ('browser_launch_failed' !== ready.code) return;
+            const code = ready.browserLaunchFailedCode;
+            return 'string' == typeof code && Object.prototype.hasOwnProperty.call(messaging.Lp, code) ? code : void 0;
+        }
         function dev_wait_define_property(obj, key, value) {
             if (key in obj) Object.defineProperty(obj, key, {
                 value: value,
@@ -12111,7 +12894,7 @@ Cross-browser compatibility
             const message = error instanceof Error ? error.message : String(error);
             const tagged = error?.code;
             const code = 'string' == typeof tagged && tagged in messaging.Lp ? tagged : messaging.Lp.E_INTERNAL;
-            if (code === messaging.Lp.E_ARGS) return {
+            if (code === messaging.Lp.E_ARGS || code === messaging.Lp.E_REMOTE_URL_UNSUPPORTED) return {
                 code,
                 status: 'usage',
                 message,
@@ -12123,6 +12906,24 @@ Cross-browser compatibility
                 message,
                 hint: 'Pass a browser binary path that exists and runs.'
             };
+            if (code === messaging.Lp.E_BROWSER_BINARY_REQUIRED) return {
+                code,
+                status: 'usage',
+                message,
+                hint: 'Pass --chromium-binary or --gecko-binary with the browser to run.'
+            };
+            if (code === messaging.Lp.E_BROWSER_NOT_FOUND) return {
+                code,
+                status: 'failed',
+                message,
+                hint: 'Install the browser, or pass its binary path to the command.'
+            };
+            if (code === messaging.Lp.E_FLAG_NOT_SUPPORTED_HERE) return {
+                code,
+                status: 'usage',
+                message,
+                hint: 'Let Extension.js manage the profile, or pass --profile=<path>.'
+            };
             if (code === messaging.Lp.E_READY_TIMEOUT) return {
                 code,
                 status: 'timeout',
@@ -12199,8 +13000,7 @@ Cross-browser compatibility
                                 continue;
                             }
                             const detail = payload.message || payload.errors?.[0] || 'unknown error';
-                            const badPin = 'browser_launch_failed' === payload.code && payload.browserLaunchFailedCode === messaging.Lp.E_BROWSER_BINARY_INVALID;
-                            throw new WaitModeError(String(detail), badPin ? messaging.Lp.E_BROWSER_BINARY_INVALID : readyContractErrorCode(payload.code) ?? messaging.Lp.E_READY_ERROR_STATUS);
+                            throw new WaitModeError(String(detail), stampedLaunchFailureCode(payload) ?? readyContractErrorCode(payload.code) ?? messaging.Lp.E_READY_ERROR_STATUS);
                         }
                     }
                 }
@@ -12210,7 +13010,7 @@ Cross-browser compatibility
             throw new WaitModeError(`Timed out waiting for ready contract at ${readyPath} (${options.timeoutMs} ms)${timeoutDetail}`, messaging.Lp.E_READY_TIMEOUT);
         }
         async function runWaitMode(options) {
-            if (isHttpUrl(options.pathOrRemoteUrl)) throw new WaitModeError('--wait requires a local project path (remote URLs are not supported)', messaging.Lp.E_ARGS);
+            if (isHttpUrl(options.pathOrRemoteUrl)) throw new WaitModeError('--wait requires a local project path (remote URLs are not supported)', messaging.Lp.E_REMOTE_URL_UNSUPPORTED);
             const { projectPath, bridge } = await resolveProjectPath(options.pathOrRemoteUrl);
             const timeoutMs = parseWaitTimeoutMs(options.waitTimeout);
             const format = parseWaitFormat(options.waitFormat);
@@ -12978,7 +13778,7 @@ Cross-browser compatibility
                 } catch (err) {
                     const message = String(err?.message || err);
                     if (asJson) console.log(JSON.stringify(messaging.Pr.fail('doctor', 'failed', {
-                        code: messaging.Lp.E_INTERNAL,
+                        code: declaredErrorCode(err) ?? messaging.Lp.E_INTERNAL,
                         message
                     })));
                     else console.error(message);
@@ -13003,6 +13803,7 @@ Cross-browser compatibility
             });
         }
         var output_binaries_resolver = __webpack_require__("./browsers/browsers-lib/output-binaries-resolver.ts");
+        const DEFAULT_INSTALL_TARGET = 'chromium';
         function install_emit(frame) {
             console.log(JSON.stringify(frame));
         }
@@ -13070,10 +13871,10 @@ Cross-browser compatibility
             await exitAfterDrain(1);
         }
         function registerInstallCommand(program) {
-            program.command('install').arguments('[browser-name]').usage('[browser-name] [options]').description(commandDescriptions.install).option(`--browser <${vendors.b_}>`, 'override the positional browser name. Supports comma-separated values and `all`.').option('--where', 'print the resolved managed browser cache root').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').action(async (browserArg, options)=>{
+            program.command('install').argument('[browser-name]', `managed browser to install (default: ${DEFAULT_INSTALL_TARGET})`).usage('[browser-name] [options]').description(commandDescriptions.install).option(`--browser <${vendors.b_}>`, 'override the positional browser name. Supports comma-separated values and `all`.').option('--where', 'print the resolved managed browser cache root').option('--output <pretty|json>', 'result format. Use json for a schema-1 envelope on stdout').action(async (browserArg, options)=>{
                 const asJson = isJsonOutput(options);
                 const named = Boolean(options.browser || browserArg);
-                const selectedBrowser = options.browser || browserArg || 'chromium';
+                const selectedBrowser = options.browser || browserArg || DEFAULT_INSTALL_TARGET;
                 const browserList = (0, vendors.OB)(selectedBrowser);
                 if (!(options.where && !named)) {
                     if (await refuseIfNotManagedTarget('install', browserList, asJson)) return;
@@ -13100,6 +13901,7 @@ Cross-browser compatibility
                 for (const browser of browserList)try {
                     await extensionInstall({
                         browser,
+                        defaulted: !named,
                         locateInstalledBinary: output_binaries_resolver.AG
                     });
                     installed.push(browser);
@@ -13192,8 +13994,14 @@ Cross-browser compatibility
         var run_only = __webpack_require__("./browsers/run-only.ts");
         const PREVIEW_FAILED_CODES = new Set([
             messaging.Lp.E_BROWSER_LAUNCH,
+            messaging.Lp.E_BROWSER_NOT_FOUND,
+            messaging.Lp.E_BROWSER_START_TIMEOUT,
             messaging.Lp.E_BROWSER_CONNECT,
+            messaging.Lp.E_BROWSER_CONNECTION_CLOSED,
+            messaging.Lp.E_RDP_PROTOCOL,
+            messaging.Lp.E_ADDON_INSTALL,
             messaging.Lp.E_CONFIG_LOAD,
+            messaging.Lp.E_RUNTIME_NOT_FOUND,
             messaging.Lp.E_REMOTE_DOWNLOAD,
             messaging.Lp.E_REMOTE_ZIP_INVALID,
             messaging.Lp.E_REMOTE_FETCH_TIMEOUT
@@ -13658,6 +14466,7 @@ Cross-browser compatibility
                 }
                 markCommandSessionStart('start');
                 const { extensionBuild } = await loadExtensionDevelopModule();
+                const noBrowser = await resolveNoBrowser(pathOrRemoteUrl || process.cwd(), 'start');
                 for (const vendor of list){
                     const logsOption = startOptions.logs;
                     const logContextOption = startOptions.logContext;
@@ -13668,6 +14477,7 @@ Cross-browser compatibility
                             browser: vendor,
                             exitOnError: !asJson,
                             metadataCommand: 'start',
+                            launchFollows: !noBrowser,
                             polyfill: explicitCliValue(command, 'polyfill', explicitOptionalBoolean(startOptions.polyfill)),
                             install: startOptions.install,
                             extensions: parseExtensionsList(startOptions.extensions),
@@ -13683,7 +14493,6 @@ Cross-browser compatibility
                         }));
                         process.exit(1);
                     }
-                    const noBrowser = await resolveNoBrowser(pathOrRemoteUrl || process.cwd(), 'start');
                     if (noBrowser) continue;
                     const { extensionPreview } = await loadExtensionDevelopPreviewModule();
                     await extensionPreview(pathOrRemoteUrl, {
@@ -13717,7 +14526,7 @@ Cross-browser compatibility
                     browsers: list,
                     port: null,
                     pid: process.pid,
-                    noBrowser: await resolveNoBrowser(pathOrRemoteUrl || process.cwd(), 'start')
+                    noBrowser
                 }));
             });
         }
@@ -13871,7 +14680,7 @@ Cross-browser compatibility
         }
         function failBeforeParse(argv, humanMessage, code, plainMessage, flag) {
             console.error(humanMessage);
-            if (wantsJsonOutput(argv)) writeStdoutFrame(earlyExitEnvelope(index_resolveCommandFromArgv(argv) || 'extension', code, plainMessage, {
+            if (cli_failure_wantsJsonOutput(argv)) writeStdoutFrame(earlyExitEnvelope(index_resolveCommandFromArgv(argv) || 'extension', code, plainMessage, {
                 flag
             }));
             process.exit(1);
@@ -13948,7 +14757,7 @@ Cross-browser compatibility
         if (process.argv.includes('--ai-help')) runAIHelp();
         else {
             const argv = applyNoBrowserArgvShim(applyOutputAliasArgvShim(process.argv));
-            const asJson = wantsJsonOutput(argv);
+            const asJson = cli_failure_wantsJsonOutput(argv);
             const commandName = index_resolveCommandFromArgv(argv) || 'extension';
             (async ()=>{
                 try {
@@ -13999,6 +14808,9 @@ Cross-browser compatibility
     "node:fs" (module) {
         module.exports = require("node:fs");
     },
+    "node:http" (module) {
+        module.exports = require("node:http");
+    },
     "node:module" (module) {
         module.exports = require("node:module");
     },