doc-detective 4.22.0 → 4.23.0

package/dist/index.cjs

@@ -2549,7 +2549,7 @@ var init_schemas = __esm({
                       ]
                     },
                     browsers: {
-                      description: "Browsers to run tests on.",
+                      description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                       anyOf: [
                         {
                           type: "string",
@@ -2560,7 +2560,7 @@ var init_schemas = __esm({
                             "safari",
                             "webkit"
                           ],
-                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                         },
                         {
                           type: "object",
@@ -2579,7 +2579,7 @@ var init_schemas = __esm({
                                 "safari",
                                 "webkit"
                               ],
-                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                             },
                             explicit: {
                               type: "boolean",
@@ -2639,7 +2639,7 @@ var init_schemas = __esm({
                                   "safari",
                                   "webkit"
                                 ],
-                                $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                               },
                               {
                                 type: "object",
@@ -2658,7 +2658,7 @@ var init_schemas = __esm({
                                       "safari",
                                       "webkit"
                                     ],
-                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                   },
                                   explicit: {
                                     type: "boolean",
@@ -2944,7 +2944,7 @@ var init_schemas = __esm({
                           "safari",
                           "webkit"
                         ],
-                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                       },
                       browser: {
                         type: "object",
@@ -2963,7 +2963,7 @@ var init_schemas = __esm({
                               "safari",
                               "webkit"
                             ],
-                            $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                            $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                           },
                           explicit: {
                             type: "boolean",
@@ -3103,6 +3103,26 @@ var init_schemas = __esm({
                           }
                         }
                       ]
+                    },
+                    {
+                      platforms: "android"
+                    },
+                    {
+                      platforms: [
+                        "windows",
+                        "mac",
+                        "android",
+                        "ios"
+                      ],
+                      browsers: "chrome"
+                    },
+                    {
+                      platforms: "ios",
+                      browsers: "safari",
+                      device: {
+                        name: "test-iphone",
+                        deviceType: "phone"
+                      }
                     }
                   ]
                 }
@@ -87120,7 +87140,7 @@ var init_schemas = __esm({
             ]
           },
           browsers: {
-            description: "Browsers to run tests on.",
+            description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
             anyOf: [
               {
                 type: "string",
@@ -87131,7 +87151,7 @@ var init_schemas = __esm({
                   "safari",
                   "webkit"
                 ],
-                $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
               },
               {
                 type: "object",
@@ -87150,7 +87170,7 @@ var init_schemas = __esm({
                       "safari",
                       "webkit"
                     ],
-                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                   },
                   explicit: {
                     type: "boolean",
@@ -87210,7 +87230,7 @@ var init_schemas = __esm({
                         "safari",
                         "webkit"
                       ],
-                      $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                      $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                     },
                     {
                       type: "object",
@@ -87229,7 +87249,7 @@ var init_schemas = __esm({
                             "safari",
                             "webkit"
                           ],
-                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                         },
                         explicit: {
                           type: "boolean",
@@ -87515,7 +87535,7 @@ var init_schemas = __esm({
                 "safari",
                 "webkit"
               ],
-              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
             },
             browser: {
               type: "object",
@@ -87534,7 +87554,7 @@ var init_schemas = __esm({
                     "safari",
                     "webkit"
                   ],
-                  $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                  $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                 },
                 explicit: {
                   type: "boolean",
@@ -87674,6 +87694,26 @@ var init_schemas = __esm({
                 }
               }
             ]
+          },
+          {
+            platforms: "android"
+          },
+          {
+            platforms: [
+              "windows",
+              "mac",
+              "android",
+              "ios"
+            ],
+            browsers: "chrome"
+          },
+          {
+            platforms: "ios",
+            browsers: "safari",
+            device: {
+              name: "test-iphone",
+              deviceType: "phone"
+            }
           }
         ]
       },
@@ -100011,7 +100051,7 @@ var init_schemas = __esm({
                           ]
                         },
                         browsers: {
-                          description: "Browsers to run tests on.",
+                          description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                           anyOf: [
                             {
                               type: "string",
@@ -100022,7 +100062,7 @@ var init_schemas = __esm({
                                 "safari",
                                 "webkit"
                               ],
-                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                             },
                             {
                               type: "object",
@@ -100041,7 +100081,7 @@ var init_schemas = __esm({
                                     "safari",
                                     "webkit"
                                   ],
-                                  $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                  $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                 },
                                 explicit: {
                                   type: "boolean",
@@ -100101,7 +100141,7 @@ var init_schemas = __esm({
                                       "safari",
                                       "webkit"
                                     ],
-                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                   },
                                   {
                                     type: "object",
@@ -100120,7 +100160,7 @@ var init_schemas = __esm({
                                           "safari",
                                           "webkit"
                                         ],
-                                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                       },
                                       explicit: {
                                         type: "boolean",
@@ -100406,7 +100446,7 @@ var init_schemas = __esm({
                               "safari",
                               "webkit"
                             ],
-                            $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                            $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                           },
                           browser: {
                             type: "object",
@@ -100425,7 +100465,7 @@ var init_schemas = __esm({
                                   "safari",
                                   "webkit"
                                 ],
-                                $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                               },
                               explicit: {
                                 type: "boolean",
@@ -100565,6 +100605,26 @@ var init_schemas = __esm({
                               }
                             }
                           ]
+                        },
+                        {
+                          platforms: "android"
+                        },
+                        {
+                          platforms: [
+                            "windows",
+                            "mac",
+                            "android",
+                            "ios"
+                          ],
+                          browsers: "chrome"
+                        },
+                        {
+                          platforms: "ios",
+                          browsers: "safari",
+                          device: {
+                            name: "test-iphone",
+                            deviceType: "phone"
+                          }
                         }
                       ]
                     }
@@ -184644,7 +184704,7 @@ var init_schemas = __esm({
                                 ]
                               },
                               browsers: {
-                                description: "Browsers to run tests on.",
+                                description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                                 anyOf: [
                                   {
                                     type: "string",
@@ -184655,7 +184715,7 @@ var init_schemas = __esm({
                                       "safari",
                                       "webkit"
                                     ],
-                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                   },
                                   {
                                     type: "object",
@@ -184674,7 +184734,7 @@ var init_schemas = __esm({
                                           "safari",
                                           "webkit"
                                         ],
-                                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                       },
                                       explicit: {
                                         type: "boolean",
@@ -184734,7 +184794,7 @@ var init_schemas = __esm({
                                             "safari",
                                             "webkit"
                                           ],
-                                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                         },
                                         {
                                           type: "object",
@@ -184753,7 +184813,7 @@ var init_schemas = __esm({
                                                 "safari",
                                                 "webkit"
                                               ],
-                                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                             },
                                             explicit: {
                                               type: "boolean",
@@ -185039,7 +185099,7 @@ var init_schemas = __esm({
                                     "safari",
                                     "webkit"
                                   ],
-                                  $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                  $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                 },
                                 browser: {
                                   type: "object",
@@ -185058,7 +185118,7 @@ var init_schemas = __esm({
                                         "safari",
                                         "webkit"
                                       ],
-                                      $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                      $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                     },
                                     explicit: {
                                       type: "boolean",
@@ -185198,6 +185258,26 @@ var init_schemas = __esm({
                                     }
                                   }
                                 ]
+                              },
+                              {
+                                platforms: "android"
+                              },
+                              {
+                                platforms: [
+                                  "windows",
+                                  "mac",
+                                  "android",
+                                  "ios"
+                                ],
+                                browsers: "chrome"
+                              },
+                              {
+                                platforms: "ios",
+                                browsers: "safari",
+                                device: {
+                                  name: "test-iphone",
+                                  deviceType: "phone"
+                                }
                               }
                             ]
                           }
@@ -185486,7 +185566,7 @@ var init_schemas = __esm({
                                           ]
                                         },
                                         browsers: {
-                                          description: "Browsers to run tests on.",
+                                          description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                                           anyOf: [
                                             {
                                               type: "string",
@@ -185497,7 +185577,7 @@ var init_schemas = __esm({
                                                 "safari",
                                                 "webkit"
                                               ],
-                                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                             },
                                             {
                                               type: "object",
@@ -185516,7 +185596,7 @@ var init_schemas = __esm({
                                                     "safari",
                                                     "webkit"
                                                   ],
-                                                  $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                                  $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                                 },
                                                 explicit: {
                                                   type: "boolean",
@@ -185576,7 +185656,7 @@ var init_schemas = __esm({
                                                       "safari",
                                                       "webkit"
                                                     ],
-                                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                                   },
                                                   {
                                                     type: "object",
@@ -185595,7 +185675,7 @@ var init_schemas = __esm({
                                                           "safari",
                                                           "webkit"
                                                         ],
-                                                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                                       },
                                                       explicit: {
                                                         type: "boolean",
@@ -185881,7 +185961,7 @@ var init_schemas = __esm({
                                               "safari",
                                               "webkit"
                                             ],
-                                            $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                            $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                           },
                                           browser: {
                                             type: "object",
@@ -185900,7 +185980,7 @@ var init_schemas = __esm({
                                                   "safari",
                                                   "webkit"
                                                 ],
-                                                $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                                $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                               },
                                               explicit: {
                                                 type: "boolean",
@@ -186040,6 +186120,26 @@ var init_schemas = __esm({
                                               }
                                             }
                                           ]
+                                        },
+                                        {
+                                          platforms: "android"
+                                        },
+                                        {
+                                          platforms: [
+                                            "windows",
+                                            "mac",
+                                            "android",
+                                            "ios"
+                                          ],
+                                          browsers: "chrome"
+                                        },
+                                        {
+                                          platforms: "ios",
+                                          browsers: "safari",
+                                          device: {
+                                            name: "test-iphone",
+                                            deviceType: "phone"
+                                          }
                                         }
                                       ]
                                     }
@@ -228201,7 +228301,7 @@ var init_schemas = __esm({
                                             "safari",
                                             "webkit"
                                           ],
-                                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                         },
                                         explicit: {
                                           type: "boolean",
@@ -270545,7 +270645,7 @@ var init_schemas = __esm({
                                 ]
                               },
                               browsers: {
-                                description: "Browsers to run tests on.",
+                                description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                                 anyOf: [
                                   {
                                     type: "string",
@@ -270556,7 +270656,7 @@ var init_schemas = __esm({
                                       "safari",
                                       "webkit"
                                     ],
-                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                   },
                                   {
                                     type: "object",
@@ -270575,7 +270675,7 @@ var init_schemas = __esm({
                                           "safari",
                                           "webkit"
                                         ],
-                                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                       },
                                       explicit: {
                                         type: "boolean",
@@ -270635,7 +270735,7 @@ var init_schemas = __esm({
                                             "safari",
                                             "webkit"
                                           ],
-                                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                         },
                                         {
                                           type: "object",
@@ -270654,7 +270754,7 @@ var init_schemas = __esm({
                                                 "safari",
                                                 "webkit"
                                               ],
-                                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                             },
                                             explicit: {
                                               type: "boolean",
@@ -270940,7 +271040,7 @@ var init_schemas = __esm({
                                     "safari",
                                     "webkit"
                                   ],
-                                  $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                  $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                 },
                                 browser: {
                                   type: "object",
@@ -270959,7 +271059,7 @@ var init_schemas = __esm({
                                         "safari",
                                         "webkit"
                                       ],
-                                      $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                      $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                     },
                                     explicit: {
                                       type: "boolean",
@@ -271099,6 +271199,26 @@ var init_schemas = __esm({
                                     }
                                   }
                                 ]
+                              },
+                              {
+                                platforms: "android"
+                              },
+                              {
+                                platforms: [
+                                  "windows",
+                                  "mac",
+                                  "android",
+                                  "ios"
+                                ],
+                                browsers: "chrome"
+                              },
+                              {
+                                platforms: "ios",
+                                browsers: "safari",
+                                device: {
+                                  name: "test-iphone",
+                                  deviceType: "phone"
+                                }
                               }
                             ]
                           }
@@ -271387,7 +271507,7 @@ var init_schemas = __esm({
                                           ]
                                         },
                                         browsers: {
-                                          description: "Browsers to run tests on.",
+                                          description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                                           anyOf: [
                                             {
                                               type: "string",
@@ -271398,7 +271518,7 @@ var init_schemas = __esm({
                                                 "safari",
                                                 "webkit"
                                               ],
-                                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                             },
                                             {
                                               type: "object",
@@ -271417,7 +271537,7 @@ var init_schemas = __esm({
                                                     "safari",
                                                     "webkit"
                                                   ],
-                                                  $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                                  $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                                 },
                                                 explicit: {
                                                   type: "boolean",
@@ -271477,7 +271597,7 @@ var init_schemas = __esm({
                                                       "safari",
                                                       "webkit"
                                                     ],
-                                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                                   },
                                                   {
                                                     type: "object",
@@ -271496,7 +271616,7 @@ var init_schemas = __esm({
                                                           "safari",
                                                           "webkit"
                                                         ],
-                                                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                                       },
                                                       explicit: {
                                                         type: "boolean",
@@ -271782,7 +271902,7 @@ var init_schemas = __esm({
                                               "safari",
                                               "webkit"
                                             ],
-                                            $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                            $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                           },
                                           browser: {
                                             type: "object",
@@ -271801,7 +271921,7 @@ var init_schemas = __esm({
                                                   "safari",
                                                   "webkit"
                                                 ],
-                                                $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                                $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                               },
                                               explicit: {
                                                 type: "boolean",
@@ -271941,6 +272061,26 @@ var init_schemas = __esm({
                                               }
                                             }
                                           ]
+                                        },
+                                        {
+                                          platforms: "android"
+                                        },
+                                        {
+                                          platforms: [
+                                            "windows",
+                                            "mac",
+                                            "android",
+                                            "ios"
+                                          ],
+                                          browsers: "chrome"
+                                        },
+                                        {
+                                          platforms: "ios",
+                                          browsers: "safari",
+                                          device: {
+                                            name: "test-iphone",
+                                            deviceType: "phone"
+                                          }
                                         }
                                       ]
                                     }
@@ -314102,7 +314242,7 @@ var init_schemas = __esm({
                                             "safari",
                                             "webkit"
                                           ],
-                                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                         },
                                         explicit: {
                                           type: "boolean",
@@ -359659,7 +359799,7 @@ var init_schemas = __esm({
                       ]
                     },
                     browsers: {
-                      description: "Browsers to run tests on.",
+                      description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                       anyOf: [
                         {
                           type: "string",
@@ -359670,7 +359810,7 @@ var init_schemas = __esm({
                             "safari",
                             "webkit"
                           ],
-                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                         },
                         {
                           type: "object",
@@ -359689,7 +359829,7 @@ var init_schemas = __esm({
                                 "safari",
                                 "webkit"
                               ],
-                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                             },
                             explicit: {
                               type: "boolean",
@@ -359749,7 +359889,7 @@ var init_schemas = __esm({
                                   "safari",
                                   "webkit"
                                 ],
-                                $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                               },
                               {
                                 type: "object",
@@ -359768,7 +359908,7 @@ var init_schemas = __esm({
                                       "safari",
                                       "webkit"
                                     ],
-                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                   },
                                   explicit: {
                                     type: "boolean",
@@ -360054,7 +360194,7 @@ var init_schemas = __esm({
                           "safari",
                           "webkit"
                         ],
-                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                       },
                       browser: {
                         type: "object",
@@ -360073,7 +360213,7 @@ var init_schemas = __esm({
                               "safari",
                               "webkit"
                             ],
-                            $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                            $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                           },
                           explicit: {
                             type: "boolean",
@@ -360213,6 +360353,26 @@ var init_schemas = __esm({
                           }
                         }
                       ]
+                    },
+                    {
+                      platforms: "android"
+                    },
+                    {
+                      platforms: [
+                        "windows",
+                        "mac",
+                        "android",
+                        "ios"
+                      ],
+                      browsers: "chrome"
+                    },
+                    {
+                      platforms: "ios",
+                      browsers: "safari",
+                      device: {
+                        name: "test-iphone",
+                        deviceType: "phone"
+                      }
                     }
                   ]
                 }
@@ -360501,7 +360661,7 @@ var init_schemas = __esm({
                                 ]
                               },
                               browsers: {
-                                description: "Browsers to run tests on.",
+                                description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                                 anyOf: [
                                   {
                                     type: "string",
@@ -360512,7 +360672,7 @@ var init_schemas = __esm({
                                       "safari",
                                       "webkit"
                                     ],
-                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                   },
                                   {
                                     type: "object",
@@ -360531,7 +360691,7 @@ var init_schemas = __esm({
                                           "safari",
                                           "webkit"
                                         ],
-                                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                       },
                                       explicit: {
                                         type: "boolean",
@@ -360591,7 +360751,7 @@ var init_schemas = __esm({
                                             "safari",
                                             "webkit"
                                           ],
-                                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                         },
                                         {
                                           type: "object",
@@ -360610,7 +360770,7 @@ var init_schemas = __esm({
                                                 "safari",
                                                 "webkit"
                                               ],
-                                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                             },
                                             explicit: {
                                               type: "boolean",
@@ -360896,7 +361056,7 @@ var init_schemas = __esm({
                                     "safari",
                                     "webkit"
                                   ],
-                                  $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                  $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                 },
                                 browser: {
                                   type: "object",
@@ -360915,7 +361075,7 @@ var init_schemas = __esm({
                                         "safari",
                                         "webkit"
                                       ],
-                                      $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                      $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                     },
                                     explicit: {
                                       type: "boolean",
@@ -361055,6 +361215,26 @@ var init_schemas = __esm({
                                     }
                                   }
                                 ]
+                              },
+                              {
+                                platforms: "android"
+                              },
+                              {
+                                platforms: [
+                                  "windows",
+                                  "mac",
+                                  "android",
+                                  "ios"
+                                ],
+                                browsers: "chrome"
+                              },
+                              {
+                                platforms: "ios",
+                                browsers: "safari",
+                                device: {
+                                  name: "test-iphone",
+                                  deviceType: "phone"
+                                }
                               }
                             ]
                           }
@@ -403216,7 +403396,7 @@ var init_schemas = __esm({
                                   "safari",
                                   "webkit"
                                 ],
-                                $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                               },
                               explicit: {
                                 type: "boolean",
@@ -487806,7 +487986,7 @@ var init_schemas = __esm({
                       ]
                     },
                     browsers: {
-                      description: "Browsers to run tests on.",
+                      description: "Browsers to run tests on. On a mobile (`android`/`ios`) platform entry, the browser runs on the managed device: `chrome` on Android, `safari` on iOS (other combinations skip the context), and it fills in automatically when omitted. Device browsers don't take desktop display config: authored `window`/`viewport` dimensions and `headless: false` are rejected on mobile entries (the device owns its display \u2014 control it via the device descriptor's `headless`/`deviceType`); `headless: true` matches this schema's default and is ignored.",
                       anyOf: [
                         {
                           type: "string",
@@ -487817,7 +487997,7 @@ var init_schemas = __esm({
                             "safari",
                             "webkit"
                           ],
-                          $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                          $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                         },
                         {
                           type: "object",
@@ -487836,7 +488016,7 @@ var init_schemas = __esm({
                                 "safari",
                                 "webkit"
                               ],
-                              $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                              $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                             },
                             explicit: {
                               type: "boolean",
@@ -487896,7 +488076,7 @@ var init_schemas = __esm({
                                   "safari",
                                   "webkit"
                                 ],
-                                $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                               },
                               {
                                 type: "object",
@@ -487915,7 +488095,7 @@ var init_schemas = __esm({
                                       "safari",
                                       "webkit"
                                     ],
-                                    $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                                    $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                                   },
                                   explicit: {
                                     type: "boolean",
@@ -488201,7 +488381,7 @@ var init_schemas = __esm({
                           "safari",
                           "webkit"
                         ],
-                        $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                        $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                       },
                       browser: {
                         type: "object",
@@ -488220,7 +488400,7 @@ var init_schemas = __esm({
                               "safari",
                               "webkit"
                             ],
-                            $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                            $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                           },
                           explicit: {
                             type: "boolean",
@@ -488360,6 +488540,26 @@ var init_schemas = __esm({
                           }
                         }
                       ]
+                    },
+                    {
+                      platforms: "android"
+                    },
+                    {
+                      platforms: [
+                        "windows",
+                        "mac",
+                        "android",
+                        "ios"
+                      ],
+                      browsers: "chrome"
+                    },
+                    {
+                      platforms: "ios",
+                      browsers: "safari",
+                      device: {
+                        name: "test-iphone",
+                        deviceType: "phone"
+                      }
                     }
                   ]
                 }
@@ -530521,7 +530721,7 @@ var init_schemas = __esm({
                         "safari",
                         "webkit"
                       ],
-                      $comment: "`safari` is just a shortcut for `webkit`. Included for visibility and to reduce questions."
+                      $comment: "On desktop platforms `safari` is a shortcut for the `webkit` engine. On an `ios` platform entry, `safari` means the real Safari browser on the managed simulator (`webkit` is not supported there). On `android`, `chrome` is the supported browser."
                     },
                     explicit: {
                       type: "boolean",
@@ -585495,6 +585695,41 @@ function ensureRuntimePackageJson(runtimeDir) {
     import_node_fs3.default.writeFileSync(pkgPath, RUNTIME_PACKAGE_JSON_CONTENTS, "utf8");
   }
 }
+function recordRuntimeDependencies(runtimeDir, ctx) {
+  try {
+    const pkgPath = import_node_path3.default.join(runtimeDir, "package.json");
+    let pkg;
+    try {
+      pkg = JSON.parse(import_node_fs3.default.readFileSync(pkgPath, "utf8"));
+    } catch {
+      pkg = JSON.parse(RUNTIME_PACKAGE_JSON_CONTENTS);
+    }
+    const prior = pkg.dependencies && typeof pkg.dependencies === "object" ? pkg.dependencies : {};
+    const record = readInstalledRecord(ctx);
+    const names = /* @__PURE__ */ new Set([
+      ...Object.keys(record.npmPackages),
+      ...Object.keys(prior)
+    ]);
+    const deps = {};
+    for (const name of [...names].sort()) {
+      if (!import_node_fs3.default.existsSync(import_node_path3.default.join(runtimeDir, "node_modules", name, "package.json"))) {
+        continue;
+      }
+      let range = null;
+      try {
+        range = getDeclaredVersion(name);
+      } catch {
+        const v = readInstalledVersionFromCache(name, ctx);
+        range = prior[name] ?? (v ? `^${v}` : null);
+      }
+      if (range)
+        deps[name] = range;
+    }
+    pkg.dependencies = deps;
+    import_node_fs3.default.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2), "utf8");
+  } catch {
+  }
+}
 function readInstalledVersionFromCache(name, ctx = {}) {
   const runtimeDir = getRuntimeDir(ctx);
   const candidate = import_node_path3.default.join(runtimeDir, "node_modules", name, "package.json");
@@ -585533,6 +585768,7 @@ async function ensureRuntimeInstalled(packages, options = {}) {
   const specs = toInstall.map((name) => `${name}@${getDeclaredVersion(name)}`);
   const runtimeDir = getRuntimeDir(ctx);
   ensureRuntimePackageJson(runtimeDir);
+  recordRuntimeDependencies(runtimeDir, ctx);
   logger("Installing dependencies\u2026", "info");
   const npmExe = process.platform === "win32" ? "npm.cmd" : "npm";
   const args = [
@@ -585654,6 +585890,7 @@ async function ensureRuntimeInstalled(packages, options = {}) {
     record.npmPackages[name] = { installedVersion, installedAt: now };
   }
   writeInstalledRecord(record, ctx);
+  recordRuntimeDependencies(runtimeDir, ctx);
 }
 var import_node_path3, import_node_fs3, import_node_child_process, import_node_url3, import_node_module, RUNTIME_DEBUG, defaultLogger, requireFromShim, DEFAULT_INSTALL_TIMEOUT_MS, RUNTIME_PACKAGE_JSON_CONTENTS;
 var init_loader = __esm({
@@ -585687,6 +585924,101 @@ var init_loader = __esm({
   }
 });
 
+// dist/core/ptyWatchdog.js
+function defaultCreateWorker(data) {
+  const url = new URL("./ptyProbeWorker.js", importMetaUrl);
+  return new import_node_worker_threads.Worker(url, { workerData: data });
+}
+function probePtyAllocation(opts) {
+  const timeoutMs = opts.timeoutMs ?? PTY_PROBE_TIMEOUT_MS;
+  const createWorker = opts.createWorker ?? defaultCreateWorker;
+  let worker;
+  try {
+    worker = createWorker({ ptyModulePath: opts.ptyModulePath });
+  } catch (error) {
+    return Promise.resolve({
+      outcome: "inconclusive",
+      detail: `worker-unavailable: ${error?.message ?? error}`
+    });
+  }
+  return new Promise((resolve) => {
+    let settled = false;
+    const terminate = () => {
+      try {
+        Promise.resolve(worker.terminate()).catch(() => {
+        });
+      } catch {
+      }
+    };
+    const finish = (outcome, detail) => {
+      if (settled)
+        return;
+      settled = true;
+      clearTimeout(timer);
+      resolve({ outcome, detail });
+    };
+    const timer = setTimeout(() => {
+      terminate();
+      finish("wedged", `no response in ${timeoutMs}ms`);
+    }, timeoutMs);
+    if (typeof timer.unref === "function")
+      timer.unref();
+    worker.on("message", (msg) => {
+      terminate();
+      if (msg && msg.ok === true)
+        finish("healthy");
+      else
+        finish("inconclusive", msg?.error ? String(msg.error) : "probe reported not-ok");
+    });
+    worker.on("error", (err) => {
+      finish("inconclusive", `worker-error: ${err?.message ?? err}`);
+    });
+    worker.on("exit", () => {
+      finish("inconclusive", "worker exited without a result");
+    });
+  });
+}
+async function ensurePtyBackendOnDisk(opts) {
+  const exists = opts.exists ?? import_node_fs4.default.existsSync;
+  const first = opts.resolvePath();
+  if (first && exists(first))
+    return first;
+  try {
+    await opts.reinstall();
+  } catch (error) {
+    const err2 = new Error(`The PTY backend's files are missing from the runtime cache (a JIT install of another dependency previously pruned them \u2014 doc-detective issue #501) and reinstalling failed: ${error?.message ?? error}. Skipping this \`tty\` background process.`);
+    err2.code = "NODE_PTY_UNAVAILABLE";
+    throw err2;
+  }
+  const healed = opts.resolvePath();
+  if (healed && exists(healed))
+    return healed;
+  const err = new Error(`The PTY backend's files are missing from the runtime cache (doc-detective issue #501) and did not materialize after a reinstall. Skipping this \`tty\` background process.`);
+  err.code = "NODE_PTY_UNAVAILABLE";
+  throw err;
+}
+async function assertConptyAllocatable(opts) {
+  const platform = opts.platform ?? process.platform;
+  if (platform !== "win32" || !opts.ptyModulePath)
+    return;
+  const probe = opts.probe ?? probePtyAllocation;
+  const result = await probe({ ptyModulePath: opts.ptyModulePath });
+  if (result.outcome === "wedged") {
+    const err = new Error(`ConPTY allocation is wedged on this Windows environment (${result.detail}). This matches doc-detective issue #501: a native app-surface (NovaWindows) context in the same run can leave the console subsystem unable to allocate a new pseudo-terminal, which otherwise freezes the whole process. Skipping this \`tty\` background process instead of hanging the run.`);
+    err.code = "NODE_PTY_UNAVAILABLE";
+    throw err;
+  }
+}
+var import_node_fs4, import_node_worker_threads, PTY_PROBE_TIMEOUT_MS;
+var init_ptyWatchdog = __esm({
+  "dist/core/ptyWatchdog.js"() {
+    "use strict";
+    import_node_fs4 = __toESM(require("node:fs"), 1);
+    import_node_worker_threads = require("node:worker_threads");
+    PTY_PROBE_TIMEOUT_MS = Number(process.env.DOC_DETECTIVE_PTY_PROBE_TIMEOUT_MS) || 15e3;
+  }
+});
+
 // dist/core/utils.js
 function createAppiumPool(ports) {
   const available = [...ports];
@@ -585874,6 +586206,14 @@ async function spawnPtyBackgroundCommand(cmd, args = [], options = {}) {
     err.code = "NODE_PTY_UNAVAILABLE";
     throw err;
   }
+  const ptyModulePath = await ensurePtyBackendOnDisk({
+    resolvePath: () => resolveHeavyDepPath(PTY_PACKAGE, { cacheDir: options.cacheDir }),
+    reinstall: () => ensureRuntimeInstalled([PTY_PACKAGE], {
+      ctx: { cacheDir: options.cacheDir },
+      force: true
+    })
+  });
+  await assertConptyAllocatable({ ptyModulePath });
   const argstr = args.length ? " " + args.map(quoteShellArg).join(" ") : "";
   const fullCommand = cmd + argstr;
   const isWin = process.platform === "win32";
@@ -586132,18 +586472,18 @@ function appendQueryParams(url, params) {
 }
 function cleanTemp() {
   const tempDir = import_node_path4.default.join(import_node_os2.default.tmpdir(), "doc-detective");
-  if (!import_node_fs4.default.existsSync(tempDir))
+  if (!import_node_fs5.default.existsSync(tempDir))
     return;
-  for (const entry of import_node_fs4.default.readdirSync(tempDir)) {
+  for (const entry of import_node_fs5.default.readdirSync(tempDir)) {
     if (PRESERVED_TEMP_ENTRIES.has(entry))
       continue;
     const curPath = import_node_path4.default.join(tempDir, entry);
     try {
-      const stat = import_node_fs4.default.statSync(curPath);
+      const stat = import_node_fs5.default.statSync(curPath);
       if (stat.isDirectory()) {
-        import_node_fs4.default.rmSync(curPath, { recursive: true, force: true });
+        import_node_fs5.default.rmSync(curPath, { recursive: true, force: true });
       } else {
-        import_node_fs4.default.unlinkSync(curPath);
+        import_node_fs5.default.unlinkSync(curPath);
       }
     } catch {
     }
@@ -586288,11 +586628,11 @@ async function fetchFile(fileURL, opts = {}) {
         message: new Error(`Refusing to write outside temp dir: ${resolvedFile}`)
       };
     }
-    if (!import_node_fs4.default.existsSync(ddTempDir)) {
-      import_node_fs4.default.mkdirSync(ddTempDir, { recursive: true });
+    if (!import_node_fs5.default.existsSync(ddTempDir)) {
+      import_node_fs5.default.mkdirSync(ddTempDir, { recursive: true });
     }
-    if (!import_node_fs4.default.existsSync(filePath)) {
-      import_node_fs4.default.writeFileSync(filePath, data);
+    if (!import_node_fs5.default.existsSync(filePath)) {
+      import_node_fs5.default.writeFileSync(filePath, data);
     }
     return { result: "success", path: filePath };
   } catch (error) {
@@ -586300,7 +586640,7 @@ async function fetchFile(fileURL, opts = {}) {
   }
 }
 async function loadEnvs(envsFile) {
-  const fileExists = import_node_fs4.default.existsSync(envsFile);
+  const fileExists = import_node_fs5.default.existsSync(envsFile);
   if (fileExists) {
     const { default: dotenv } = await import("dotenv");
     dotenv.config({ path: envsFile, override: true });
@@ -586375,7 +586715,7 @@ function commandOnPath(command, env, existsSync2) {
 }
 function evaluateContextRequirements({ requires, deps = {} }) {
   const env = deps.env ?? process.env;
-  const existsSync2 = deps.existsSync ?? import_node_fs4.default.existsSync;
+  const existsSync2 = deps.existsSync ?? import_node_fs5.default.existsSync;
   const platform = deps.platform ?? process.platform;
   const commandExists = deps.commandExists ?? ((command) => commandOnPath(command, env, existsSync2));
   const isObjectForm = requires && typeof requires === "object" && !Array.isArray(requires);
@@ -586446,7 +586786,7 @@ function getOrInitRunTimestamp(config) {
 function getRunOutputDir(config, { create = true } = {}) {
   if (config?.__runOutputDir) {
     if (create)
-      import_node_fs4.default.mkdirSync(config.__runOutputDir, { recursive: true });
+      import_node_fs5.default.mkdirSync(config.__runOutputDir, { recursive: true });
     return config.__runOutputDir;
   }
   let base = String(config?.output || ".");
@@ -586458,11 +586798,11 @@ function getRunOutputDir(config, { create = true } = {}) {
   const runId = getOrInitRunTimestamp(config);
   let dir = import_node_path4.default.join(runsRoot, runId);
   if (create) {
-    import_node_fs4.default.mkdirSync(runsRoot, { recursive: true });
+    import_node_fs5.default.mkdirSync(runsRoot, { recursive: true });
     let suffix = 2;
     for (; ; ) {
       try {
-        import_node_fs4.default.mkdirSync(dir);
+        import_node_fs5.default.mkdirSync(dir);
         break;
       } catch (error) {
         if (error?.code !== "EEXIST")
@@ -586582,11 +586922,11 @@ function llevenshteinDistance(s, t) {
   }
   return arr[t.length][s.length];
 }
-var import_node_fs4, import_node_os2, import_node_path4, import_node_crypto, import_promises, import_node_net, import_axios, import_node_child_process2, BACKGROUND_BUFFER_LIMIT, PTY_PACKAGE, READY_POLL_INTERVAL_MS, PRESERVED_TEMP_ENTRIES, FETCH_BINARY_DEFAULTS;
+var import_node_fs5, import_node_os2, import_node_path4, import_node_crypto, import_promises, import_node_net, import_axios, import_node_child_process2, BACKGROUND_BUFFER_LIMIT, PTY_PACKAGE, READY_POLL_INTERVAL_MS, PRESERVED_TEMP_ENTRIES, FETCH_BINARY_DEFAULTS;
 var init_utils = __esm({
   "dist/core/utils.js"() {
     "use strict";
-    import_node_fs4 = __toESM(require("node:fs"), 1);
+    import_node_fs5 = __toESM(require("node:fs"), 1);
     import_node_os2 = __toESM(require("node:os"), 1);
     import_node_path4 = __toESM(require("node:path"), 1);
     import_node_crypto = __toESM(require("node:crypto"), 1);
@@ -586595,6 +586935,7 @@ var init_utils = __esm({
     import_axios = __toESM(require("axios"), 1);
     import_node_child_process2 = require("node:child_process");
     init_loader();
+    init_ptyWatchdog();
     BACKGROUND_BUFFER_LIMIT = 256 * 1024;
     PTY_PACKAGE = "@homebridge/node-pty-prebuilt-multiarch";
     READY_POLL_INTERVAL_MS = 500;
@@ -586749,12 +587090,12 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
   }
   if (!force && existing && isStillFresh(existing.latestCheckedAt, now)) {
     if (existing.latestKnownVersion === existing.installedVersion) {
-      const path26 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
-      return { path: path26, version: existing.installedVersion, outdated: false };
+      const path27 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
+      return { path: path27, version: existing.installedVersion, outdated: false };
     }
-    const path25 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
+    const path26 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
     logger(`${name} ${existing.installedVersion} installed in ${cacheDir}; "${BROWSER_CHANNELS[name]}" channel is now ${existing.latestKnownVersion}. Run \`doc-detective install browsers ${name} --force\` to update.`, "warn");
-    return { path: path25, version: existing.installedVersion, outdated: true };
+    return { path: path26, version: existing.installedVersion, outdated: true };
   }
   let latest;
   try {
@@ -586762,8 +587103,8 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
   } catch (err) {
     logger(`Channel resolution for ${name} skipped: ${String(err)}`, "debug");
     if (existing) {
-      const path25 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
-      return { path: path25, version: existing.installedVersion, outdated: false };
+      const path26 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
+      return { path: path26, version: existing.installedVersion, outdated: false };
     }
     throw err;
   }
@@ -586774,8 +587115,8 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
       latestCheckedAt: now.toISOString()
     };
     writeInstalledRecord(record, ctx);
-    const path25 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
-    return { path: path25, version: latest, outdated: false };
+    const path26 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
+    return { path: path26, version: latest, outdated: false };
   }
   if (!force && existing) {
     record.browsers[name] = {
@@ -586785,8 +587126,8 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
     };
     writeInstalledRecord(record, ctx);
     logger(`${name} ${existing.installedVersion} installed in ${cacheDir}; "${BROWSER_CHANNELS[name]}" channel is now ${latest}. Run \`doc-detective install browsers ${name} --force\` to update.`, "warn");
-    const path25 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
-    return { path: path25, version: existing.installedVersion, outdated: true };
+    const path26 = await locateExecutable(browsersModule, name, existing.installedVersion, cacheDir, platform);
+    return { path: path26, version: existing.installedVersion, outdated: true };
   }
   logger(`Installing ${name} ${latest} into ${cacheDir}`, "info");
   await browsersModule.install({
@@ -586794,9 +587135,9 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
     buildId: latest,
     cacheDir
   });
-  let path24 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
-  if (name === "chromedriver" && isAllowedDriverPath(path24)) {
-    let verify = await verifyDriverBinary(name, path24, { exec: deps.verifyExec });
+  let path25 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
+  if (name === "chromedriver" && isAllowedDriverPath(path25)) {
+    let verify = await verifyDriverBinary(name, path25, { exec: deps.verifyExec });
     if (!verify.ok) {
       logger(`Installed ${name} ${latest} failed validation (${verify.error}); reinstalling once.`, "warn");
       try {
@@ -586805,11 +587146,11 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
         logger(`Failed to prune broken ${name} ${latest}: ${String(err)}`, "debug");
       }
       await browsersModule.install({ browser: name, buildId: latest, cacheDir });
-      path24 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
-      verify = await verifyDriverBinary(name, path24, { exec: deps.verifyExec });
+      path25 = await locateExecutable(browsersModule, name, latest, cacheDir, platform);
+      verify = await verifyDriverBinary(name, path25, { exec: deps.verifyExec });
     }
     if (!verify.ok) {
-      throw new Error(`${name} ${latest} is present but non-functional after a reinstall (${verify.error}). It may be a partial or corrupt download; delete ${path24} or reinstall.`);
+      throw new Error(`${name} ${latest} is present but non-functional after a reinstall (${verify.error}). It may be a partial or corrupt download; delete ${path25} or reinstall.`);
     }
   }
   if (existing && existing.installedVersion !== latest) {
@@ -586830,7 +587171,7 @@ async function ensureBrowserInstalledImpl(name, options = {}) {
     latestCheckedAt: now.toISOString()
   };
   writeInstalledRecord(record, ctx);
-  return { path: path24, version: latest, outdated: false };
+  return { path: path25, version: latest, outdated: false };
 }
 async function locateExecutable(browsersModule, name, buildId, cacheDir, platform) {
   if (typeof browsersModule.computeExecutablePath === "function") {
@@ -586871,16 +587212,16 @@ function geckodriverBinaryInCache(cacheDir) {
   const binName = process.platform === "win32" ? "geckodriver.exe" : "geckodriver";
   const rootCandidate = import_node_path5.default.join(cacheDir, binName);
   try {
-    if (import_node_fs5.default.existsSync(rootCandidate))
+    if (import_node_fs6.default.existsSync(rootCandidate))
       return rootCandidate;
   } catch {
   }
   try {
-    for (const entry of import_node_fs5.default.readdirSync(cacheDir, { withFileTypes: true })) {
+    for (const entry of import_node_fs6.default.readdirSync(cacheDir, { withFileTypes: true })) {
       if (!entry.isDirectory())
         continue;
       const nested = import_node_path5.default.join(cacheDir, entry.name, binName);
-      if (import_node_fs5.default.existsSync(nested))
+      if (import_node_fs6.default.existsSync(nested))
         return nested;
     }
   } catch {
@@ -586918,8 +587259,8 @@ async function ensureGeckodriver(ctxBag, record, existing, logger) {
     if (!verify.ok) {
       logger(`Downloaded geckodriver failed validation (${verify.error}); re-downloading once.`, "warn");
       try {
-        if (binaryPath && binaryPath !== cacheDir && import_node_fs5.default.existsSync(binaryPath)) {
-          import_node_fs5.default.rmSync(binaryPath, { force: true });
+        if (binaryPath && binaryPath !== cacheDir && import_node_fs6.default.existsSync(binaryPath)) {
+          import_node_fs6.default.rmSync(binaryPath, { force: true });
         }
       } catch {
       }
@@ -586956,12 +587297,12 @@ function getInstalledBrowsers(ctx = {}) {
     latestKnownVersion: entry.latestKnownVersion
   }));
 }
-var import_node_child_process3, import_node_fs5, import_node_path5, DRIVER_VERSION_ARGS, DRIVER_VERIFY_TIMEOUT_MS, ALLOWED_DRIVER_PATH, defaultDriverExec, BROWSER_CHANNELS, FRESHNESS_TTL_MS, RESOLVE_TIMEOUT_MS, RUNTIME_DEBUG2, defaultLogger2, inFlightInstalls, geckodriverEnvQueue;
+var import_node_child_process3, import_node_fs6, import_node_path5, DRIVER_VERSION_ARGS, DRIVER_VERIFY_TIMEOUT_MS, ALLOWED_DRIVER_PATH, defaultDriverExec, BROWSER_CHANNELS, FRESHNESS_TTL_MS, RESOLVE_TIMEOUT_MS, RUNTIME_DEBUG2, defaultLogger2, inFlightInstalls, geckodriverEnvQueue;
 var init_browsers = __esm({
   "dist/runtime/browsers.js"() {
     "use strict";
     import_node_child_process3 = require("node:child_process");
-    import_node_fs5 = __toESM(require("node:fs"), 1);
+    import_node_fs6 = __toESM(require("node:fs"), 1);
     import_node_path5 = __toESM(require("node:path"), 1);
     init_cacheDir();
     init_loader();
@@ -587013,13 +587354,19 @@ function appiumHomeForDriverPath(driverEntry) {
   const idx = driverEntry.lastIndexOf(marker);
   return idx === -1 ? null : driverEntry.slice(0, idx);
 }
+function runtimeHomeHasBrowserDriver(runtimeDir) {
+  const nm = import_node_path6.default.join(runtimeDir, "node_modules");
+  if (!(0, import_node_fs7.existsSync)(import_node_path6.default.join(nm, "appium")))
+    return false;
+  return BROWSER_DRIVER_PACKAGES.some((driver) => (0, import_node_fs7.existsSync)(import_node_path6.default.join(nm, driver)));
+}
 function setAppiumHome(ctx = {}) {
-  const runtimeAppium = import_node_path6.default.join(getRuntimeDir({ cacheDir: ctx.cacheDir }), "node_modules", "appium");
-  if ((0, import_node_fs6.existsSync)(runtimeAppium)) {
-    process.env.APPIUM_HOME = import_node_path6.default.join(getRuntimeDir({ cacheDir: ctx.cacheDir }));
+  const runtimeDir = getRuntimeDir({ cacheDir: ctx.cacheDir });
+  if (runtimeHomeHasBrowserDriver(runtimeDir)) {
+    process.env.APPIUM_HOME = runtimeDir;
     return;
   }
-  for (const driverName of ["appium-chromium-driver", "appium-geckodriver"]) {
+  for (const driverName of BROWSER_DRIVER_PACKAGES) {
     const driverEntry = resolveHeavyDepPath(driverName, {
       cacheDir: ctx.cacheDir
     });
@@ -587033,23 +587380,28 @@ function setAppiumHome(ctx = {}) {
   const pathArray = corePath.split("node_modules");
   let appiumParentPath = pathArray[0];
   for (let i = 1; i < pathArray.length; i++) {
-    if ((0, import_node_fs6.existsSync)(import_node_path6.default.join(appiumParentPath, "node_modules", "appium"))) {
+    if ((0, import_node_fs7.existsSync)(import_node_path6.default.join(appiumParentPath, "node_modules", "appium"))) {
       break;
     }
     appiumParentPath = import_node_path6.default.join(appiumParentPath, "node_modules", pathArray[i]);
   }
   process.env.APPIUM_HOME = appiumParentPath;
 }
-var import_node_path6, import_node_fs6, import_node_url4, __dirname3;
+var import_node_path6, import_node_fs7, import_node_url4, __dirname3, BROWSER_DRIVER_PACKAGES;
 var init_appium = __esm({
   "dist/core/appium.js"() {
     "use strict";
     import_node_path6 = __toESM(require("node:path"), 1);
-    import_node_fs6 = require("node:fs");
+    import_node_fs7 = require("node:fs");
     import_node_url4 = require("node:url");
     init_cacheDir();
     init_loader();
     __dirname3 = import_node_path6.default.dirname((0, import_node_url4.fileURLToPath)(importMetaUrl));
+    BROWSER_DRIVER_PACKAGES = [
+      "appium-chromium-driver",
+      "appium-geckodriver",
+      "appium-safari-driver"
+    ];
   }
 });
 
@@ -587081,7 +587433,7 @@ async function readFile({ fileURLOrPath }) {
     }
   } else {
     try {
-      content = await import_node_fs7.default.promises.readFile(fileURLOrPath, "utf8");
+      content = await import_node_fs8.default.promises.readFile(fileURLOrPath, "utf8");
     } catch (error) {
       if (error.code === "ENOENT") {
         console.warn(`File not found: ${fileURLOrPath}`);
@@ -587155,8 +587507,8 @@ async function resolvePaths({ config, object, filePath, nested = false, objectTy
     if (import_node_path7.default.isAbsolute(relativePath)) {
       return relativePath;
     }
-    const fileExists = import_node_fs7.default.existsSync(filePath2);
-    const isFile = fileExists ? import_node_fs7.default.lstatSync(filePath2).isFile() : import_node_path7.default.parse(filePath2).ext !== "";
+    const fileExists = import_node_fs8.default.existsSync(filePath2);
+    const isFile = fileExists ? import_node_fs8.default.lstatSync(filePath2).isFile() : import_node_path7.default.parse(filePath2).ext !== "";
     const basePath = isFile ? import_node_path7.default.dirname(filePath2) : filePath2;
     return baseType === "file" ? import_node_path7.default.resolve(basePath, relativePath) : import_node_path7.default.resolve(relativePath);
   }
@@ -587235,11 +587587,11 @@ async function resolvePaths({ config, object, filePath, nested = false, objectTy
   }
   return object;
 }
-var import_node_fs7, import_node_path7, import_yaml, import_axios2;
+var import_node_fs8, import_node_path7, import_yaml, import_axios2;
 var init_files = __esm({
   "dist/core/files.js"() {
     "use strict";
-    import_node_fs7 = __toESM(require("node:fs"), 1);
+    import_node_fs8 = __toESM(require("node:fs"), 1);
     import_node_path7 = __toESM(require("node:path"), 1);
     import_yaml = __toESM(require("yaml"), 1);
     import_axios2 = __toESM(require("axios"), 1);
@@ -587263,10 +587615,10 @@ async function getOperation(definition = {}, operationId = "", responseCode = ""
   if (!operationId) {
     throw new Error("OperationId is required.");
   }
-  for (const path24 in definition.paths) {
-    for (const method in definition.paths[path24]) {
-      if (definition.paths[path24][method].operationId === operationId) {
-        const operation = definition.paths[path24][method];
+  for (const path25 in definition.paths) {
+    for (const method in definition.paths[path25]) {
+      if (definition.paths[path25][method].operationId === operationId) {
+        const operation = definition.paths[path25][method];
         if (!server) {
           if (definition.servers && definition.servers.length > 0) {
             server = definition.servers[0].url;
@@ -587274,9 +587626,9 @@ async function getOperation(definition = {}, operationId = "", responseCode = ""
             throw new Error("No server URL provided and no servers defined in the OpenAPI definition.");
           }
         }
-        const example = await compileExample(operation, server + path24, responseCode, exampleKey);
+        const example = await compileExample(operation, server + path25, responseCode, exampleKey);
         const schemas2 = getSchemas(operation, responseCode);
-        return { path: path24, method, definition: operation, schemas: schemas2, example };
+        return { path: path25, method, definition: operation, schemas: schemas2, example };
       }
     }
   }
@@ -587297,15 +587649,15 @@ function getSchemas(definition = {}, responseCode = "") {
   schemas2.response = definition.responses[responseCode].content[Object.keys(definition.responses[responseCode].content)[0]].schema;
   return schemas2;
 }
-async function compileExample(operation = {}, path24 = "", responseCode = "", exampleKey = "") {
+async function compileExample(operation = {}, path25 = "", responseCode = "", exampleKey = "") {
   if (!operation) {
     throw new Error("Operation is required.");
   }
-  if (!path24) {
+  if (!path25) {
     throw new Error("Path is required.");
   }
   let example = {
-    url: path24,
+    url: path25,
     request: { parameters: {}, headers: {}, body: {} },
     response: { headers: {}, body: {} }
   };
@@ -587900,7 +588252,7 @@ async function getBrowserDiagnostics({ config }) {
       const version = await probeSafariVersion(4e3);
       safariApp = version !== null;
       safariVersion = version ?? void 0;
-      safaridriver = import_node_fs8.default.existsSync("/usr/bin/safaridriver");
+      safaridriver = import_node_fs9.default.existsSync("/usr/bin/safaridriver");
     } catch {
       detectionFailed = true;
     }
@@ -587922,12 +588274,12 @@ async function getBrowserDiagnostics({ config }) {
   });
   return { browsers, detectionFailed };
 }
-var import_node_os3, import_node_fs8, import_node_path8, import_node_child_process4, import_node_url5, __dirname4, platformMap, defaultFileTypes, cachedAppsByDir;
+var import_node_os3, import_node_fs9, import_node_path8, import_node_child_process4, import_node_url5, __dirname4, platformMap, defaultFileTypes, cachedAppsByDir;
 var init_config = __esm({
   "dist/core/config.js"() {
     "use strict";
     import_node_os3 = __toESM(require("node:os"), 1);
-    import_node_fs8 = __toESM(require("node:fs"), 1);
+    import_node_fs9 = __toESM(require("node:fs"), 1);
     init_validate();
     init_utils();
     import_node_path8 = __toESM(require("node:path"), 1);
@@ -588377,7 +588729,7 @@ module.exports = __toCommonJS(index_exports);
 init_config();
 
 // dist/core/detectTests.js
-var import_node_fs10 = __toESM(require("node:fs"), 1);
+var import_node_fs11 = __toESM(require("node:fs"), 1);
 var import_node_path10 = __toESM(require("node:path"), 1);
 var import_node_os5 = __toESM(require("node:os"), 1);
 var import_node_crypto3 = __toESM(require("node:crypto"), 1);
@@ -589251,7 +589603,7 @@ init_files();
 init_utils();
 
 // dist/core/integrations/heretto.js
-var import_node_fs9 = __toESM(require("node:fs"), 1);
+var import_node_fs10 = __toESM(require("node:fs"), 1);
 var import_node_path9 = __toESM(require("node:path"), 1);
 var import_node_https = __toESM(require("node:https"), 1);
 var import_node_http = __toESM(require("node:http"), 1);
@@ -589412,11 +589764,11 @@ var HerettoUploader = class {
         return result;
       }
     }
-    if (!import_node_fs9.default.existsSync(localFilePath)) {
+    if (!import_node_fs10.default.existsSync(localFilePath)) {
       result.description = `Local file not found: ${localFilePath}`;
       return result;
     }
-    const fileContent = import_node_fs9.default.readFileSync(localFilePath);
+    const fileContent = import_node_fs10.default.readFileSync(localFilePath);
     const contentType = this.getContentType(localFilePath);
     try {
       await this.uploadFile({
@@ -590190,7 +590542,7 @@ async function pollJobStatus(client, fileId, jobId, log3, config) {
   return null;
 }
 async function downloadAndExtractOutput(client, fileId, jobId, herettoName, log3, config, deps) {
-  const fsModule = deps?.fsModule || import_node_fs9.default;
+  const fsModule = deps?.fsModule || import_node_fs10.default;
   const ZipClass = deps?.ZipClass || import_adm_zip.default;
   const tempDir = import_node_path9.default.join(import_node_os4.default.tmpdir(), "doc-detective");
   const hash = import_node_crypto2.default.createHash("md5").update(`${herettoName}_${jobId}`).digest("hex");
@@ -590425,7 +590777,7 @@ async function isValidSourceFile({ config, files, source }) {
         } else {
           beforePath = import_node_path10.default.resolve(test.before);
         }
-        if (!import_node_fs10.default.existsSync(beforePath)) {
+        if (!import_node_fs11.default.existsSync(beforePath)) {
           log(config, "debug", `${beforePath} is specified to run before a test but isn't a valid file. Skipping ${source}.`);
           return false;
         }
@@ -590437,7 +590789,7 @@ async function isValidSourceFile({ config, files, source }) {
         } else {
           afterPath = import_node_path10.default.resolve(test.after);
         }
-        if (!import_node_fs10.default.existsSync(afterPath)) {
+        if (!import_node_fs11.default.existsSync(afterPath)) {
           log(config, "debug", `${afterPath} is specified to run after a test but isn't a valid file. Skipping ${source}.`);
           return false;
         }
@@ -590455,9 +590807,9 @@ async function processDitaMap({ config, source }) {
   const hash = import_node_crypto3.default.createHash("md5").update(source).digest("hex");
   const tmpBase = import_node_path10.default.join(import_node_os5.default.tmpdir(), "doc-detective");
   const outputDir = import_node_path10.default.join(tmpBase, `ditamap_${hash}`);
-  if (!import_node_fs10.default.existsSync(tmpBase)) {
+  if (!import_node_fs11.default.existsSync(tmpBase)) {
     log(config, "debug", `Creating temp directory: ${tmpBase}`);
-    import_node_fs10.default.mkdirSync(tmpBase, { recursive: true });
+    import_node_fs11.default.mkdirSync(tmpBase, { recursive: true });
   }
   const ditaVersion = await spawnCommand("dita", ["--version"]);
   if (ditaVersion.exitCode !== 0) {
@@ -590564,8 +590916,8 @@ async function qualifyFiles({ config }) {
     let isFile = false;
     let isDir = false;
     try {
-      isFile = import_node_fs10.default.statSync(source).isFile();
-      isDir = import_node_fs10.default.statSync(source).isDirectory();
+      isFile = import_node_fs11.default.statSync(source).isFile();
+      isDir = import_node_fs11.default.statSync(source).isDirectory();
     } catch {
       log(config, "warning", `Cannot access path: ${source}. Skipping.`);
       continue;
@@ -590588,13 +590940,13 @@ async function qualifyFiles({ config }) {
       dirs = [];
       dirs[0] = source;
       for (const dir of dirs) {
-        const objects = import_node_fs10.default.readdirSync(dir);
+        const objects = import_node_fs11.default.readdirSync(dir);
         for (const object of objects) {
           const content = import_node_path10.default.resolve(dir + "/" + object);
           if (content.includes("node_modules"))
             continue;
-          const isFile2 = import_node_fs10.default.statSync(content).isFile();
-          const isDir2 = import_node_fs10.default.statSync(content).isDirectory();
+          const isFile2 = import_node_fs11.default.statSync(content).isFile();
+          const isDir2 = import_node_fs11.default.statSync(content).isDirectory();
           if (isFile2 && await isValidSourceFile({ config, files, source: content })) {
             const resolved2 = import_node_path10.default.resolve(content);
             files.push(resolved2);
@@ -590618,7 +590970,7 @@ async function parseTests({ config, files }) {
     let rawContent;
     if (extension === "json" || extension === "yaml" || extension === "yml") {
       try {
-        rawContent = await import_node_fs10.default.promises.readFile(file, "utf8");
+        rawContent = await import_node_fs11.default.promises.readFile(file, "utf8");
         if (extension === "json") {
           content = JSON.parse(rawContent);
         } else {
@@ -590882,6 +591234,15 @@ var import_node_crypto4 = __toESM(require("node:crypto"), 1);
 init_utils();
 init_openapi();
 init_browserStepKeys();
+
+// dist/core/tests/mobilePlatform.js
+function isMobileTargetPlatform(platform) {
+  if (platform === "android" || platform === "ios")
+    return platform;
+  return null;
+}
+
+// dist/core/resolveTests.js
 function resolveContexts({ contexts, test, config }) {
   log(config, "debug", `Determining required contexts for test: ${test.testId}`);
   const resolvedContexts = [];
@@ -590901,8 +591262,6 @@ function resolveContexts({ contexts, test, config }) {
         if (typeof browser === "string") {
           browser = { name: browser };
         }
-        if (browser.name === "safari")
-          browser.name = "webkit";
         browser.explicit = true;
         return browser;
       });
@@ -590931,8 +591290,9 @@ function resolveContexts({ contexts, test, config }) {
           const staticContext = { ...carry };
           if (platform !== void 0)
             staticContext.platform = platform;
-          if (browser !== void 0)
-            staticContext.browser = browser;
+          if (browser !== void 0) {
+            staticContext.browser = browser.name === "safari" && !isMobileTargetPlatform(platform) ? { ...browser, name: "webkit" } : { ...browser };
+          }
           staticContexts.push(staticContext);
         });
       }
@@ -591091,7 +591451,7 @@ init_utils();
 
 // dist/core/tests.js
 var import_tree_kill3 = __toESM(require("tree-kill"), 1);
-var import_node_fs25 = __toESM(require("node:fs"), 1);
+var import_node_fs26 = __toESM(require("node:fs"), 1);
 init_loader();
 init_browsers();
 init_browserStepKeys();
@@ -591777,7 +592137,7 @@ async function resolveCloseTargets(driver, ref, opts = {}) {
 }
 
 // dist/core/tests/appSurface.js
-var import_node_fs14 = __toESM(require("node:fs"), 1);
+var import_node_fs15 = __toESM(require("node:fs"), 1);
 var import_node_path13 = __toESM(require("node:path"), 1);
 var import_node_child_process8 = require("node:child_process");
 init_loader();
@@ -591789,7 +592149,7 @@ init_utils();
 var import_node_child_process5 = require("node:child_process");
 var import_node_os6 = __toESM(require("node:os"), 1);
 var import_node_path11 = __toESM(require("node:path"), 1);
-var import_node_fs11 = __toESM(require("node:fs"), 1);
+var import_node_fs12 = __toESM(require("node:fs"), 1);
 var import_node_crypto5 = __toESM(require("node:crypto"), 1);
 init_loader();
 init_utils();
@@ -592189,7 +592549,7 @@ async function startXvfb(display, opts = {}) {
     if (proc.exitCode !== null)
       throw new Error(`Xvfb exited early on ${display} (code ${proc.exitCode})`);
     try {
-      if (import_node_fs11.default.statSync(lock).mtimeMs >= startMs)
+      if (import_node_fs12.default.statSync(lock).mtimeMs >= startMs)
         return proc;
     } catch {
     }
@@ -592206,7 +592566,7 @@ async function startXvfb(display, opts = {}) {
 var import_node_child_process7 = require("node:child_process");
 
 // dist/runtime/androidInstaller.js
-var import_node_fs13 = __toESM(require("node:fs"), 1);
+var import_node_fs14 = __toESM(require("node:fs"), 1);
 var import_node_os7 = __toESM(require("node:os"), 1);
 var import_node_path12 = __toESM(require("node:path"), 1);
 var import_node_https2 = __toESM(require("node:https"), 1);
@@ -592214,7 +592574,7 @@ var import_node_child_process6 = require("node:child_process");
 init_cacheDir();
 
 // dist/runtime/androidSdk.js
-var import_node_fs12 = __toESM(require("node:fs"), 1);
+var import_node_fs13 = __toESM(require("node:fs"), 1);
 init_cacheDir();
 function trimTrailingSeparators(s) {
   let end = s.length;
@@ -592258,7 +592618,7 @@ function usable(tools) {
 }
 function detectAndroidSdk(ctx = {}, deps = {}) {
   const env = deps.env ?? process.env;
-  const existsSync2 = deps.existsSync ?? import_node_fs12.default.existsSync;
+  const existsSync2 = deps.existsSync ?? import_node_fs13.default.existsSync;
   const platform = deps.platform ?? process.platform;
   const cacheRoot = safeCacheDir(ctx);
   const cacheAndroidSdk = deps.cacheAndroidSdk ?? (cacheRoot ? joinFor(platform, cacheRoot, "android-sdk") : void 0);
@@ -592408,8 +592768,8 @@ function pickSystemImage(images, { osVersion, abi }) {
   return candidates.length > 0 ? candidates[0].pkg : null;
 }
 function listInstalledSystemImages(sdkRoot, deps = {}) {
-  const existsSync2 = deps.existsSync ?? import_node_fs13.default.existsSync;
-  const readdirSync = deps.readdirSync ?? ((p) => import_node_fs13.default.readdirSync(p));
+  const existsSync2 = deps.existsSync ?? import_node_fs14.default.existsSync;
+  const readdirSync = deps.readdirSync ?? ((p) => import_node_fs14.default.readdirSync(p));
   const base = import_node_path12.default.join(sdkRoot, "system-images");
   if (!existsSync2(base))
     return [];
@@ -592710,7 +593070,7 @@ function realJavaPresent() {
 function androidAvdHome() {
   const home = import_node_path12.default.join(import_node_os7.default.homedir(), ".android", "avd");
   try {
-    import_node_fs13.default.mkdirSync(home, { recursive: true });
+    import_node_fs14.default.mkdirSync(home, { recursive: true });
   } catch {
   }
   return home;
@@ -592744,20 +593104,20 @@ async function realRun(command, args, opts = {}) {
   });
 }
 function realDetectCachedJavaHome(cacheJreRoot) {
-  if (!import_node_fs13.default.existsSync(cacheJreRoot))
+  if (!import_node_fs14.default.existsSync(cacheJreRoot))
     return null;
-  const entries = import_node_fs13.default.readdirSync(cacheJreRoot);
+  const entries = import_node_fs14.default.readdirSync(cacheJreRoot);
   const home = resolveJavaHome(cacheJreRoot, entries, process.platform);
-  return home && import_node_fs13.default.existsSync(javaBinPath(home)) ? home : null;
+  return home && import_node_fs14.default.existsSync(javaBinPath(home)) ? home : null;
 }
 async function realBootstrapJava(cacheJreRoot) {
   const url = jreDownloadUrl();
-  const tmpDir = import_node_fs13.default.mkdtempSync(import_node_path12.default.join(import_node_os7.default.tmpdir(), "dd-jre-"));
+  const tmpDir = import_node_fs14.default.mkdtempSync(import_node_path12.default.join(import_node_os7.default.tmpdir(), "dd-jre-"));
   try {
     const archive = import_node_path12.default.join(tmpDir, jreArchiveFilename());
     await downloadFile(url, archive);
-    import_node_fs13.default.rmSync(cacheJreRoot, { recursive: true, force: true });
-    import_node_fs13.default.mkdirSync(cacheJreRoot, { recursive: true });
+    import_node_fs14.default.rmSync(cacheJreRoot, { recursive: true, force: true });
+    import_node_fs14.default.mkdirSync(cacheJreRoot, { recursive: true });
     await extractZip(archive, cacheJreRoot);
     const home = realDetectCachedJavaHome(cacheJreRoot);
     if (!home) {
@@ -592765,31 +593125,31 @@ async function realBootstrapJava(cacheJreRoot) {
     }
     return home;
   } finally {
-    import_node_fs13.default.rmSync(tmpDir, { recursive: true, force: true });
+    import_node_fs14.default.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 async function realBootstrap(url, destSdkRoot) {
-  const tmpDir = import_node_fs13.default.mkdtempSync(import_node_path12.default.join(import_node_os7.default.tmpdir(), "dd-android-cli-"));
+  const tmpDir = import_node_fs14.default.mkdtempSync(import_node_path12.default.join(import_node_os7.default.tmpdir(), "dd-android-cli-"));
   try {
     const zipPath = import_node_path12.default.join(tmpDir, "cmdline-tools.zip");
     await downloadFile(url, zipPath);
     const extractDir = import_node_path12.default.join(tmpDir, "extracted");
-    import_node_fs13.default.mkdirSync(extractDir, { recursive: true });
+    import_node_fs14.default.mkdirSync(extractDir, { recursive: true });
     await extractZip(zipPath, extractDir);
     const inner = import_node_path12.default.join(extractDir, "cmdline-tools");
-    if (!import_node_fs13.default.existsSync(inner)) {
+    if (!import_node_fs14.default.existsSync(inner)) {
       throw new Error("unexpected command-line tools archive layout (no top-level cmdline-tools/)");
     }
     const dest = import_node_path12.default.join(destSdkRoot, "cmdline-tools", "latest");
-    import_node_fs13.default.mkdirSync(import_node_path12.default.dirname(dest), { recursive: true });
-    import_node_fs13.default.rmSync(dest, { recursive: true, force: true });
+    import_node_fs14.default.mkdirSync(import_node_path12.default.dirname(dest), { recursive: true });
+    import_node_fs14.default.rmSync(dest, { recursive: true, force: true });
     try {
-      import_node_fs13.default.renameSync(inner, dest);
+      import_node_fs14.default.renameSync(inner, dest);
     } catch {
-      import_node_fs13.default.cpSync(inner, dest, { recursive: true });
+      import_node_fs14.default.cpSync(inner, dest, { recursive: true });
     }
   } finally {
-    import_node_fs13.default.rmSync(tmpDir, { recursive: true, force: true });
+    import_node_fs14.default.rmSync(tmpDir, { recursive: true, force: true });
   }
 }
 async function downloadFile(url, dest, redirects = 0) {
@@ -592808,7 +593168,7 @@ async function downloadFile(url, dest, redirects = 0) {
         reject(new Error(`download failed (HTTP ${status}) for ${url}`));
         return;
       }
-      const file = import_node_fs13.default.createWriteStream(dest);
+      const file = import_node_fs14.default.createWriteStream(dest);
       res.pipe(file);
       file.on("finish", () => file.close(() => resolve()));
       file.on("error", reject);
@@ -593083,8 +593443,8 @@ async function hostHasKvm() {
   if (process.platform !== "linux")
     return false;
   try {
-    const fs25 = await import("node:fs");
-    fs25.accessSync("/dev/kvm", fs25.constants.R_OK | fs25.constants.W_OK);
+    const fs26 = await import("node:fs");
+    fs26.accessSync("/dev/kvm", fs26.constants.R_OK | fs26.constants.W_OK);
     return true;
   } catch {
     return false;
@@ -593194,26 +593554,6 @@ function buildAcquireDeviceDeps(sdk, abi, log3) {
   };
 }
 
-// dist/core/tests/mobilePlatform.js
-function isMobileTargetPlatform(platform) {
-  if (platform === "android" || platform === "ios")
-    return platform;
-  return null;
-}
-function mobileContextSkipReason({ platform }) {
-  const roadmap = "docs/design/native-app-surfaces.md";
-  if (platform === "ios") {
-    return {
-      level: "warning",
-      reason: `Skipping context on 'ios': mobile browser testing on iOS lands in phase A5 of the native app roadmap (${roadmap}). Native iOS app tests run on capable macOS hosts.`
-    };
-  }
-  return {
-    level: "warning",
-    reason: `Skipping context on 'android': mobile browser testing on Android lands in phase A5 of the native app roadmap (${roadmap}). Native Android app tests (no browser steps) run today.`
-  };
-}
-
 // dist/core/tests/appSurface.js
 init_validate();
 function classifyAppIdentifier(app) {
@@ -593617,9 +593957,9 @@ function resolveAppSurfaceRef(surface, appSession) {
 function invalidateStaleAppiumManifest(home, driverPackage) {
   const cacheDir = import_node_path13.default.join(home, "node_modules", ".cache", "appium");
   try {
-    const manifest = import_node_fs14.default.readFileSync(import_node_path13.default.join(cacheDir, "extensions.yaml"), "utf8");
+    const manifest = import_node_fs15.default.readFileSync(import_node_path13.default.join(cacheDir, "extensions.yaml"), "utf8");
     if (!manifest.includes(driverPackage)) {
-      import_node_fs14.default.rmSync(cacheDir, { recursive: true, force: true });
+      import_node_fs15.default.rmSync(cacheDir, { recursive: true, force: true });
     }
   } catch {
   }
@@ -594041,7 +594381,87 @@ async function closeAppSurface({ entry, appSession }) {
   } catch {
   }
 }
-async function teardownAppSession(appSession, killServer) {
+function defaultIsAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (error) {
+    return error?.code !== "ESRCH";
+  }
+}
+function defaultForceKill(pid) {
+  try {
+    process.kill(pid, "SIGKILL");
+  } catch {
+  }
+}
+function queryWindowsProcessTable() {
+  return new Promise((resolve, reject) => {
+    const script = 'Get-CimInstance Win32_Process | ForEach-Object { "$($_.ProcessId),$($_.ParentProcessId)" }';
+    (0, import_node_child_process8.execFile)("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", script], { windowsHide: true, timeout: 1e4, maxBuffer: 16 * 1024 * 1024 }, (error, stdout) => {
+      if (error)
+        return reject(error);
+      const rows = [];
+      for (const line of String(stdout).split(/\r?\n/)) {
+        const m = line.trim().match(/^(\d+),(\d+)$/);
+        if (m)
+          rows.push({ pid: Number(m[1]), ppid: Number(m[2]) });
+      }
+      resolve(rows);
+    });
+  });
+}
+async function listWindowsDescendantPids(rootPid, runQuery) {
+  const out = /* @__PURE__ */ new Set();
+  let table;
+  try {
+    table = await runQuery();
+  } catch {
+    return out;
+  }
+  const childrenByParent = /* @__PURE__ */ new Map();
+  for (const { pid, ppid } of table) {
+    const siblings = childrenByParent.get(ppid);
+    if (siblings)
+      siblings.push(pid);
+    else
+      childrenByParent.set(ppid, [pid]);
+  }
+  const stack = [rootPid];
+  while (stack.length) {
+    const parent = stack.pop();
+    for (const child of childrenByParent.get(parent) ?? []) {
+      if (!out.has(child)) {
+        out.add(child);
+        stack.push(child);
+      }
+    }
+  }
+  return out;
+}
+async function snapshotAppServerDescendants(serverPid, tools = {}) {
+  if (process.platform !== "win32" || !serverPid)
+    return /* @__PURE__ */ new Set();
+  const isAlive = tools.isAlive ?? defaultIsAlive;
+  if (!isAlive(serverPid))
+    return /* @__PURE__ */ new Set();
+  if (tools.listDescendants)
+    return tools.listDescendants(serverPid);
+  return listWindowsDescendantPids(serverPid, tools.runQuery ?? queryWindowsProcessTable);
+}
+async function reapConsoleOrphans(pids, tools = {}) {
+  const isAlive = tools.isAlive ?? defaultIsAlive;
+  const forceKill = tools.forceKill ?? defaultForceKill;
+  const reaped = [];
+  for (const pid of pids) {
+    if (isAlive(pid)) {
+      forceKill(pid);
+      reaped.push(pid);
+    }
+  }
+  return reaped;
+}
+async function teardownAppSession(appSession, killServer, tools = {}) {
   if (!appSession)
     return;
   for (const entry of [...appSession.surfaces.values()]) {
@@ -594055,8 +594475,13 @@ async function teardownAppSession(appSession, killServer) {
   }
   appSession.deviceSessions?.clear();
   if (appSession.server) {
-    await killServer(appSession.server.process?.pid);
+    const serverPid = appSession.server.process?.pid;
+    const orphanSnapshot = await snapshotAppServerDescendants(serverPid, tools);
+    await killServer(serverPid);
     appSession.server = void 0;
+    if (orphanSnapshot.size) {
+      await reapConsoleOrphans(orphanSnapshot, tools);
+    }
   }
 }
 
@@ -594449,8 +594874,7 @@ init_loader();
 init_utils();
 
 // dist/core/tests/browserWait.js
-async function waitForNetworkIdle(driver, idleTime, timeout) {
-  const startTime = Date.now();
+async function injectNetworkMonitor(driver) {
   await driver.execute(() => {
     if (!window.__docDetectiveNetworkMonitor) {
       const originalFetch = window.fetch;
@@ -594476,74 +594900,73 @@ async function waitForNetworkIdle(driver, idleTime, timeout) {
       };
     }
   });
+}
+async function cleanupNetworkMonitor(driver) {
+  await driver.execute(() => {
+    if (window.__docDetectiveNetworkMonitor) {
+      if (window.__docDetectiveNetworkMonitor.originalFetch) {
+        window.fetch = window.__docDetectiveNetworkMonitor.originalFetch;
+      }
+      if (window.__docDetectiveNetworkMonitor.originalXHROpen) {
+        XMLHttpRequest.prototype.open = window.__docDetectiveNetworkMonitor.originalXHROpen;
+      }
+      delete window.__docDetectiveNetworkMonitor;
+    }
+  });
+}
+async function waitForNetworkIdle(driver, idleTime, timeout) {
+  const startTime = Date.now();
+  await injectNetworkMonitor(driver);
   await new Promise((resolve) => setTimeout(resolve, 100));
   const initialCheck = await driver.execute(() => {
     const monitor = window.__docDetectiveNetworkMonitor;
+    if (!monitor)
+      return null;
     const now = Date.now();
     return {
       idleFor: now - monitor.lastRequestTime,
       requestCount: monitor.requestCount
     };
   });
-  if (initialCheck.idleFor >= idleTime && initialCheck.requestCount === 0) {
-    await driver.execute(() => {
-      if (window.__docDetectiveNetworkMonitor) {
-        if (window.__docDetectiveNetworkMonitor.originalFetch) {
-          window.fetch = window.__docDetectiveNetworkMonitor.originalFetch;
-        }
-        if (window.__docDetectiveNetworkMonitor.originalXHROpen) {
-          XMLHttpRequest.prototype.open = window.__docDetectiveNetworkMonitor.originalXHROpen;
-        }
-        delete window.__docDetectiveNetworkMonitor;
-      }
-    });
+  if (initialCheck && initialCheck.idleFor >= idleTime && initialCheck.requestCount === 0) {
+    await cleanupNetworkMonitor(driver);
     return;
   }
   try {
+    let needsInject = !initialCheck;
     while (true) {
       if (Date.now() - startTime > timeout) {
-        await driver.execute(() => {
-          if (window.__docDetectiveNetworkMonitor) {
-            if (window.__docDetectiveNetworkMonitor.originalFetch) {
-              window.fetch = window.__docDetectiveNetworkMonitor.originalFetch;
-            }
-            if (window.__docDetectiveNetworkMonitor.originalXHROpen) {
-              XMLHttpRequest.prototype.open = window.__docDetectiveNetworkMonitor.originalXHROpen;
-            }
-            delete window.__docDetectiveNetworkMonitor;
-          }
-        });
         throw new Error("Network idle timeout exceeded");
       }
+      if (needsInject) {
+        await injectNetworkMonitor(driver);
+        needsInject = false;
+      }
       const state = await driver.execute(() => {
         const monitor = window.__docDetectiveNetworkMonitor;
+        if (!monitor)
+          return null;
         const now = Date.now();
         return {
           idleFor: now - monitor.lastRequestTime,
           elapsedTotal: now - monitor.startTime
         };
       });
+      if (state === null || state === void 0) {
+        needsInject = true;
+        await new Promise((resolve) => setTimeout(resolve, 200));
+        continue;
+      }
       if (state.idleFor >= idleTime) {
         break;
       }
       await new Promise((resolve) => setTimeout(resolve, 200));
     }
   } finally {
-    await driver.execute(() => {
-      if (window.__docDetectiveNetworkMonitor) {
-        if (window.__docDetectiveNetworkMonitor.originalFetch) {
-          window.fetch = window.__docDetectiveNetworkMonitor.originalFetch;
-        }
-        if (window.__docDetectiveNetworkMonitor.originalXHROpen) {
-          XMLHttpRequest.prototype.open = window.__docDetectiveNetworkMonitor.originalXHROpen;
-        }
-        delete window.__docDetectiveNetworkMonitor;
-      }
-    });
+    await cleanupNetworkMonitor(driver);
   }
 }
-async function waitForDOMStable(driver, idleTime, timeout) {
-  const startTime = Date.now();
+async function injectDOMMonitor(driver) {
   await driver.execute(() => {
     if (!window.__docDetectiveDOMMonitor) {
       window.__docDetectiveDOMMonitor = {
@@ -594567,37 +594990,47 @@ async function waitForDOMStable(driver, idleTime, timeout) {
       window.__docDetectiveDOMMonitor.observer = observer;
     }
   });
+}
+async function cleanupDOMMonitor(driver) {
+  await driver.execute(() => {
+    if (window.__docDetectiveDOMMonitor?.observer) {
+      window.__docDetectiveDOMMonitor.observer.disconnect();
+    }
+    delete window.__docDetectiveDOMMonitor;
+  });
+}
+async function waitForDOMStable(driver, idleTime, timeout) {
+  const startTime = Date.now();
+  await injectDOMMonitor(driver);
   await new Promise((resolve) => setTimeout(resolve, 100));
   const initialCheck = await driver.execute(() => {
     const monitor = window.__docDetectiveDOMMonitor;
+    if (!monitor)
+      return null;
     const now = Date.now();
     return {
       idleFor: now - monitor.lastMutationTime,
       mutationCount: monitor.mutationCount
     };
   });
-  if (initialCheck.idleFor >= idleTime && initialCheck.mutationCount === 0) {
-    await driver.execute(() => {
-      if (window.__docDetectiveDOMMonitor?.observer) {
-        window.__docDetectiveDOMMonitor.observer.disconnect();
-        delete window.__docDetectiveDOMMonitor;
-      }
-    });
+  if (initialCheck && initialCheck.idleFor >= idleTime && initialCheck.mutationCount === 0) {
+    await cleanupDOMMonitor(driver);
     return;
   }
   try {
+    let needsInject = !initialCheck;
     while (true) {
       if (Date.now() - startTime > timeout) {
-        await driver.execute(() => {
-          if (window.__docDetectiveDOMMonitor?.observer) {
-            window.__docDetectiveDOMMonitor.observer.disconnect();
-            delete window.__docDetectiveDOMMonitor;
-          }
-        });
         throw new Error("DOM stability timeout exceeded");
       }
+      if (needsInject) {
+        await injectDOMMonitor(driver);
+        needsInject = false;
+      }
       const state = await driver.execute(() => {
         const monitor = window.__docDetectiveDOMMonitor;
+        if (!monitor)
+          return null;
         const now = Date.now();
         return {
           idleFor: now - monitor.lastMutationTime,
@@ -594605,28 +595038,23 @@ async function waitForDOMStable(driver, idleTime, timeout) {
           mutationCount: monitor.mutationCount
         };
       });
+      if (state === null || state === void 0) {
+        needsInject = true;
+        await new Promise((resolve) => setTimeout(resolve, 200));
+        continue;
+      }
       if (state.idleFor >= idleTime) {
-        await driver.execute(() => {
-          if (window.__docDetectiveDOMMonitor?.observer) {
-            window.__docDetectiveDOMMonitor.observer.disconnect();
-            delete window.__docDetectiveDOMMonitor;
-          }
-        });
         break;
       }
       await new Promise((resolve) => setTimeout(resolve, 200));
     }
   } catch (error) {
-    await driver.execute(() => {
-      if (window.__docDetectiveDOMMonitor?.observer) {
-        window.__docDetectiveDOMMonitor.observer.disconnect();
-        delete window.__docDetectiveDOMMonitor;
-      }
-    });
+    await cleanupDOMMonitor(driver);
     throw new Error(`DOM stability check failed: ${error.message}`, {
       cause: error
     });
   }
+  await cleanupDOMMonitor(driver);
 }
 
 // dist/core/expressions.js
@@ -594701,11 +595129,11 @@ function hasUnresolvedMetaReference(expression, context) {
   }
   return false;
 }
-function getMetaValue(path24, context) {
+function getMetaValue(path25, context) {
   if (!context) {
     return void 0;
   }
-  const [basePath, jsonPointer] = path24.split("#");
+  const [basePath, jsonPointer] = path25.split("#");
   const resolvedPath = resolvePathTemplateVariables(basePath, context);
   let value = getNestedProperty(context, resolvedPath);
   if (jsonPointer && value) {
@@ -594722,9 +595150,9 @@ function getMetaValue(path24, context) {
   }
   return value;
 }
-function resolvePathTemplateVariables(path24, context) {
+function resolvePathTemplateVariables(path25, context) {
   const templateRegex = /\{\{(\w+)\}\}/g;
-  return path24.replace(templateRegex, (match, varName) => {
+  return path25.replace(templateRegex, (match, varName) => {
     if (context && context.id && varName === "id") {
       return context.id;
     }
@@ -594761,10 +595189,10 @@ async function resolveEmbeddedExpressions(str, context) {
   parts.push(str.slice(lastIdx));
   return parts.join("");
 }
-function getNestedProperty(obj, path24) {
-  if (!obj || !path24)
+function getNestedProperty(obj, path25) {
+  if (!obj || !path25)
     return void 0;
-  const parts = path24.split(".");
+  const parts = path25.split(".");
   let current = obj;
   for (const part of parts) {
     if (current === null || current === void 0)
@@ -595757,7 +596185,7 @@ async function findElement({ config, step, driver, click, appSession }) {
       await finalizeFound({ result });
       if (click) {
         try {
-          await element2.click({ button: "left" });
+          await element2.click();
           result.description += " Clicked element.";
         } catch (error2) {
           result.status = "FAIL";
@@ -595829,9 +596257,12 @@ async function findElement({ config, step, driver, click, appSession }) {
   }
   if (step.find.click || click) {
     try {
-      await element.click({
-        button: step.find.click?.button || "left"
-      });
+      const button = step.find.click?.button || "left";
+      if (button === "left") {
+        await element.click();
+      } else {
+        await element.click({ button });
+      }
       result.description += " Clicked element.";
     } catch (error2) {
       result.status = "FAIL";
@@ -596124,7 +596555,7 @@ async function goTo({ config, step, driver }) {
 init_validate();
 init_utils();
 var import_tree_kill = __toESM(require("tree-kill"), 1);
-var import_node_fs15 = __toESM(require("node:fs"), 1);
+var import_node_fs16 = __toESM(require("node:fs"), 1);
 var import_node_path14 = __toESM(require("node:path"), 1);
 async function runShell({ config, step, driver, processRegistry }) {
   const result = {
@@ -596273,18 +596704,18 @@ async function runShell({ config, step, driver, processRegistry }) {
   }
   if (step.runShell.path) {
     const dir = import_node_path14.default.dirname(step.runShell.path);
-    if (!import_node_fs15.default.existsSync(dir)) {
-      import_node_fs15.default.mkdirSync(dir, { recursive: true });
+    if (!import_node_fs16.default.existsSync(dir)) {
+      import_node_fs16.default.mkdirSync(dir, { recursive: true });
     }
     let filePath = step.runShell.path;
     log(config, "debug", `Saving stdio to file: ${filePath}`);
-    if (!import_node_fs15.default.existsSync(filePath)) {
-      import_node_fs15.default.writeFileSync(filePath, result.outputs.stdio.stdout);
+    if (!import_node_fs16.default.existsSync(filePath)) {
+      import_node_fs16.default.writeFileSync(filePath, result.outputs.stdio.stdout);
     } else {
       if (step.runShell.overwrite == "false") {
         descriptions.push(`Didn't save output. File already exists.`);
       }
-      const existingFile = import_node_fs15.default.readFileSync(filePath, "utf8");
+      const existingFile = import_node_fs16.default.readFileSync(filePath, "utf8");
       const fractionalDiff = calculateFractionalDifference(existingFile, result.outputs.stdio.stdout);
       log(config, "debug", `Fractional difference: ${fractionalDiff}`);
       result.outputs.variation = fractionalDiff;
@@ -596294,13 +596725,13 @@ async function runShell({ config, step, driver, processRegistry }) {
       });
       if (fractionalDiff > step.runShell.maxVariation) {
         if (step.runShell.overwrite == "aboveVariation") {
-          import_node_fs15.default.writeFileSync(filePath, result.outputs.stdio.stdout);
+          import_node_fs16.default.writeFileSync(filePath, result.outputs.stdio.stdout);
           descriptions.push(`Saved output to file.`);
         }
         descriptions.push(`The difference between the existing output and the new output (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.runShell.maxVariation}).`);
       } else {
         if (step.runShell.overwrite == "true") {
-          import_node_fs15.default.writeFileSync(filePath, result.outputs.stdio.stdout);
+          import_node_fs16.default.writeFileSync(filePath, result.outputs.stdio.stdout);
           descriptions.push(`Saved output to file.`);
         }
         descriptions.push(`Saved-file variation (${fractionalDiff.toFixed(2)}) is within the max accepted variation (${step.runShell.maxVariation}).`);
@@ -596499,7 +596930,7 @@ async function checkLink({ config, step }) {
 init_validate();
 init_utils();
 var import_node_path15 = __toESM(require("node:path"), 1);
-var import_node_fs16 = __toESM(require("node:fs"), 1);
+var import_node_fs17 = __toESM(require("node:fs"), 1);
 init_loader();
 var _pngjs = null;
 var _sharp = null;
@@ -596678,8 +597109,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
     const rawBase = import_node_path15.default.basename(urlPathname.split("?")[0].split("#")[0].replace(/\\/g, "/"));
     const safeBase = sanitizeFilesystemName(rawBase, `${step.stepId}.png`);
     dir = import_node_path15.default.join(process.cwd(), "doc-detective-runs", getOrInitRunTimestamp(config));
-    if (!import_node_fs16.default.existsSync(dir)) {
-      import_node_fs16.default.mkdirSync(dir, { recursive: true });
+    if (!import_node_fs17.default.existsSync(dir)) {
+      import_node_fs17.default.mkdirSync(dir, { recursive: true });
     }
     const captureId = `${step.stepId || "screenshot"}_${Date.now()}`;
     filePath = import_node_path15.default.join(dir, `${captureId}_${safeBase}`);
@@ -596695,10 +597126,10 @@ async function saveScreenshot({ config, step, driver, appSession }) {
     }
   } else {
     dir = import_node_path15.default.dirname(step.screenshot.path);
-    if (!import_node_fs16.default.existsSync(dir)) {
-      import_node_fs16.default.mkdirSync(dir, { recursive: true });
+    if (!import_node_fs17.default.existsSync(dir)) {
+      import_node_fs17.default.mkdirSync(dir, { recursive: true });
     }
-    if (import_node_fs16.default.existsSync(filePath)) {
+    if (import_node_fs17.default.existsSync(filePath)) {
       if (step.screenshot.overwrite == "false") {
         result.status = "SKIPPED";
         result.description = `File already exists: ${filePath}`;
@@ -596804,8 +597235,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
   } catch (error) {
     result.status = "FAIL";
     result.description = `Couldn't save screenshot. ${error}`;
-    if (existFilePath && filePath !== existFilePath && import_node_fs16.default.existsSync(filePath)) {
-      import_node_fs16.default.unlinkSync(filePath);
+    if (existFilePath && filePath !== existFilePath && import_node_fs17.default.existsSync(filePath)) {
+      import_node_fs17.default.unlinkSync(filePath);
     }
     return result;
   } finally {
@@ -596868,12 +597299,12 @@ async function saveScreenshot({ config, step, driver, appSession }) {
         width: rect.width,
         height: rect.height
       }).toFile(croppedPath);
-      import_node_fs16.default.renameSync(croppedPath, filePath);
+      import_node_fs17.default.renameSync(croppedPath, filePath);
     } catch (error) {
       result.status = "FAIL";
       result.description = `Couldn't crop image. ${error}`;
-      if (existFilePath && filePath !== existFilePath && import_node_fs16.default.existsSync(filePath)) {
-        import_node_fs16.default.unlinkSync(filePath);
+      if (existFilePath && filePath !== existFilePath && import_node_fs17.default.existsSync(filePath)) {
+        import_node_fs17.default.unlinkSync(filePath);
       }
       return result;
     }
@@ -596881,7 +597312,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
   if (existFilePath) {
     if (step.screenshot.overwrite == "true" && !isUrlPath) {
       result.description += ` Overwrote existing file.`;
-      import_node_fs16.default.renameSync(filePath, existFilePath);
+      import_node_fs17.default.renameSync(filePath, existFilePath);
       result.outputs.screenshotPath = existFilePath;
       result.outputs.changed = true;
       if (step.screenshot.sourceIntegration) {
@@ -596894,13 +597325,13 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       let img1;
       let img2;
       try {
-        img1 = PNG.sync.read(import_node_fs16.default.readFileSync(existFilePath));
-        img2 = PNG.sync.read(import_node_fs16.default.readFileSync(filePath));
+        img1 = PNG.sync.read(import_node_fs17.default.readFileSync(existFilePath));
+        img2 = PNG.sync.read(import_node_fs17.default.readFileSync(filePath));
       } catch (error) {
         result.status = "FAIL";
         result.description = isUrlPath ? `Couldn't decode PNG for comparison. The URL reference (${redactedUrl}) may not be a valid PNG. ${error}` : `Couldn't decode PNG for comparison. ${error}`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs16.default.existsSync(filePath)) {
-          import_node_fs16.default.unlinkSync(filePath);
+        if (!isUrlPath && filePath !== existFilePath && import_node_fs17.default.existsSync(filePath)) {
+          import_node_fs17.default.unlinkSync(filePath);
         }
         return result;
       }
@@ -596912,8 +597343,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
       if (!aspectRatioMatch) {
         result.description = `Couldn't compare images. Images have different aspect ratios.`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs16.default.existsSync(filePath)) {
-          import_node_fs16.default.unlinkSync(filePath);
+        if (!isUrlPath && filePath !== existFilePath && import_node_fs17.default.existsSync(filePath)) {
+          import_node_fs17.default.unlinkSync(filePath);
         }
         return await evaluateApplicable();
       }
@@ -596940,8 +597371,8 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       } catch (error) {
         result.status = "FAIL";
         result.description = `Couldn't load screenshot comparison dependency (pixelmatch). ${error?.message ?? error}`;
-        if (!isUrlPath && filePath !== existFilePath && import_node_fs16.default.existsSync(filePath)) {
-          import_node_fs16.default.unlinkSync(filePath);
+        if (!isUrlPath && filePath !== existFilePath && import_node_fs17.default.existsSync(filePath)) {
+          import_node_fs17.default.unlinkSync(filePath);
         }
         return result;
       }
@@ -596959,7 +597390,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
       });
       if (fractionalDiff > step.screenshot.maxVariation) {
         if (step.screenshot.overwrite == "aboveVariation" && !isUrlPath) {
-          import_node_fs16.default.renameSync(filePath, existFilePath);
+          import_node_fs17.default.renameSync(filePath, existFilePath);
         }
         result.description += ` The difference between the existing screenshot and new screenshot (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.screenshot.maxVariation}).`;
         if (isUrlPath) {
@@ -596984,7 +597415,7 @@ async function saveScreenshot({ config, step, driver, appSession }) {
             result.outputs.sourceIntegration = step.screenshot.sourceIntegration;
           }
           if (step.screenshot.overwrite != "true") {
-            import_node_fs16.default.unlinkSync(filePath);
+            import_node_fs17.default.unlinkSync(filePath);
           }
         }
       }
@@ -597006,7 +597437,7 @@ init_utils();
 var import_node_child_process9 = require("node:child_process");
 var import_node_crypto6 = require("node:crypto");
 var import_node_path16 = __toESM(require("node:path"), 1);
-var import_node_fs17 = __toESM(require("node:fs"), 1);
+var import_node_fs18 = __toESM(require("node:fs"), 1);
 var import_node_os8 = __toESM(require("node:os"), 1);
 async function startRecording({ config, context, step, driver, recordingHost }) {
   let result = {
@@ -597053,10 +597484,10 @@ async function startRecording({ config, context, step, driver, recordingHost })
   let filePath = step.record.path;
   const baseName = import_node_path16.default.basename(filePath, import_node_path16.default.extname(filePath));
   const dir = import_node_path16.default.dirname(step.record.path);
-  if (!import_node_fs17.default.existsSync(dir)) {
-    import_node_fs17.default.mkdirSync(dir, { recursive: true });
+  if (!import_node_fs18.default.existsSync(dir)) {
+    import_node_fs18.default.mkdirSync(dir, { recursive: true });
   }
-  if (import_node_fs17.default.existsSync(filePath) && step.record.overwrite == "false") {
+  if (import_node_fs18.default.existsSync(filePath) && step.record.overwrite == "false") {
     result.status = "SKIPPED";
     result.description = `File already exists: ${filePath}`;
     return result;
@@ -597091,13 +597522,13 @@ async function startRecording({ config, context, step, driver, recordingHost })
     }
     const captureTitle = browserCaptureTitle(context.contextId);
     const downloadDir = browserDownloadDir(context.contextId);
-    if (!import_node_fs17.default.existsSync(downloadDir)) {
-      import_node_fs17.default.mkdirSync(downloadDir, { recursive: true });
+    if (!import_node_fs18.default.existsSync(downloadDir)) {
+      import_node_fs18.default.mkdirSync(downloadDir, { recursive: true });
     }
     const downloadPath = import_node_path16.default.join(downloadDir, `${baseName}.webm`);
-    if (import_node_fs17.default.existsSync(downloadPath)) {
+    if (import_node_fs18.default.existsSync(downloadPath)) {
       try {
-        import_node_fs17.default.unlinkSync(downloadPath);
+        import_node_fs18.default.unlinkSync(downloadPath);
       } catch {
       }
     }
@@ -597228,8 +597659,8 @@ async function startRecording({ config, context, step, driver, recordingHost })
     }
   }
   const tempDir = import_node_path16.default.join(import_node_os8.default.tmpdir(), "doc-detective", "recordings");
-  if (!import_node_fs17.default.existsSync(tempDir))
-    import_node_fs17.default.mkdirSync(tempDir, { recursive: true });
+  if (!import_node_fs18.default.existsSync(tempDir))
+    import_node_fs18.default.mkdirSync(tempDir, { recursive: true });
   const tempPath = import_node_path16.default.join(tempDir, `${safeContextId(context.contextId)}-${baseName}-${(0, import_node_crypto6.randomUUID)().slice(0, 8)}.mkv`);
   let ffmpegPath;
   try {
@@ -597290,7 +597721,7 @@ init_validate();
 init_utils();
 var import_node_child_process10 = require("node:child_process");
 var import_node_path17 = __toESM(require("node:path"), 1);
-var import_node_fs18 = __toESM(require("node:fs"), 1);
+var import_node_fs19 = __toESM(require("node:fs"), 1);
 async function stopRecording({ config, step, driver }) {
   let result = {
     status: "PASS",
@@ -597467,7 +597898,7 @@ async function transcode({ config, sourcePath, targetPath, deleteSource, crop })
       if (code === 0) {
         if (deleteSource && sourcePath !== targetPath) {
           try {
-            import_node_fs18.default.unlinkSync(sourcePath);
+            import_node_fs19.default.unlinkSync(sourcePath);
           } catch {
           }
         }
@@ -597486,7 +597917,7 @@ async function waitForStableFile(filePath, maxSeconds) {
   for (let i = 0; i < deadline; i++) {
     let size = -1;
     try {
-      size = import_node_fs18.default.statSync(filePath).size;
+      size = import_node_fs19.default.statSync(filePath).size;
     } catch {
       size = -1;
     }
@@ -597527,7 +597958,7 @@ async function loadVariables({ step }) {
 init_validate();
 init_utils();
 var import_node_path18 = __toESM(require("node:path"), 1);
-var import_node_fs19 = __toESM(require("node:fs"), 1);
+var import_node_fs20 = __toESM(require("node:fs"), 1);
 async function saveCookie({ config, step, driver }) {
   let result = {
     status: "PASS",
@@ -597594,14 +598025,14 @@ async function saveCookie({ config, step, driver }) {
     if (filePath) {
       const outputDirectory = directory || config.output || process.cwd();
       const fullPath = import_node_path18.default.resolve(outputDirectory, filePath);
-      if (import_node_fs19.default.existsSync(fullPath) && !(overwrite === true || overwrite === "true")) {
+      if (import_node_fs20.default.existsSync(fullPath) && !(overwrite === true || overwrite === "true")) {
         result.status = "FAIL";
         result.description = `File '${fullPath}' already exists and overwrite is not enabled.`;
         return result;
       }
       const dir = import_node_path18.default.dirname(fullPath);
-      if (!import_node_fs19.default.existsSync(dir)) {
-        import_node_fs19.default.mkdirSync(dir, { recursive: true });
+      if (!import_node_fs20.default.existsSync(dir)) {
+        import_node_fs20.default.mkdirSync(dir, { recursive: true });
       }
       if (targetCookie) {
         const netscapeCookie = formatCookieForNetscape(targetCookie);
@@ -597609,11 +598040,11 @@ async function saveCookie({ config, step, driver }) {
 # This is a cookie file saved by Doc Detective
 ${netscapeCookie}
 `;
-        import_node_fs19.default.writeFileSync(fullPath, content, "utf8");
+        import_node_fs20.default.writeFileSync(fullPath, content, "utf8");
         result.description = `Saved cookie '${cookieName}' to '${fullPath}'.`;
         log(config, "debug", `Saved cookie '${cookieName}' to file: ${fullPath}`);
       } else {
-        import_node_fs19.default.writeFileSync(fullPath, "# No cookie data\n", "utf8");
+        import_node_fs20.default.writeFileSync(fullPath, "# No cookie data\n", "utf8");
         result.description = `Created empty cookie file at '${fullPath}'.`;
         log(config, "debug", `Created empty cookie file: ${fullPath}`);
       }
@@ -597641,7 +598072,7 @@ function formatCookieForNetscape(cookie) {
 init_validate();
 init_utils();
 var import_node_path19 = __toESM(require("node:path"), 1);
-var import_node_fs20 = __toESM(require("node:fs"), 1);
+var import_node_fs21 = __toESM(require("node:fs"), 1);
 async function loadCookie({ config, step, driver }) {
   let result = {
     status: "PASS",
@@ -597697,13 +598128,13 @@ async function loadCookie({ config, step, driver }) {
     } else if (filePath) {
       const inputDirectory = directory || config.output || process.cwd();
       const fullPath = import_node_path19.default.resolve(inputDirectory, filePath);
-      if (!import_node_fs20.default.existsSync(fullPath)) {
+      if (!import_node_fs21.default.existsSync(fullPath)) {
         result.status = "FAIL";
         result.description = `Cookie file '${fullPath}' not found`;
         return result;
       }
       try {
-        const fileContent = import_node_fs20.default.readFileSync(fullPath, "utf8");
+        const fileContent = import_node_fs21.default.readFileSync(fullPath, "utf8");
         const cookies = parseNetscapeCookieFile(fileContent);
         if (cookies.length === 0) {
           result.status = "FAIL";
@@ -597869,7 +598300,7 @@ function isDomainCompatible(currentDomain, cookieDomain) {
 // dist/core/tests/httpRequest.js
 init_validate();
 var import_axios5 = __toESM(require("axios"), 1);
-var import_node_fs21 = __toESM(require("node:fs"), 1);
+var import_node_fs22 = __toESM(require("node:fs"), 1);
 var import_node_path20 = __toESM(require("node:path"), 1);
 var import_ajv2 = __toESM(require("ajv"), 1);
 init_openapi();
@@ -597897,9 +598328,9 @@ async function httpRequest({ config, step, openApiDefinitions = [] }) {
       delete step.httpRequest.openApi.definition;
     } else if (openApiDefinitions.length > 0) {
       for (const openApiConfig of openApiDefinitions) {
-        for (const path24 in openApiConfig.definition.paths) {
-          for (const method in openApiConfig.definition.paths[path24]) {
-            if (openApiConfig.definition.paths[path24][method].operationId === step.httpRequest.openApi.operationId) {
+        for (const path25 in openApiConfig.definition.paths) {
+          for (const method in openApiConfig.definition.paths[path25]) {
+            if (openApiConfig.definition.paths[path25][method].operationId === step.httpRequest.openApi.operationId) {
               openApiDefinition = openApiConfig.definition;
               step.httpRequest.openApi = {
                 ...openApiConfig,
@@ -598207,19 +598638,19 @@ async function httpRequest({ config, step, openApiDefinitions = [] }) {
   }
   if (step.httpRequest.path) {
     const dir = import_node_path20.default.dirname(step.httpRequest.path);
-    if (!import_node_fs21.default.existsSync(dir)) {
-      import_node_fs21.default.mkdirSync(dir, { recursive: true });
+    if (!import_node_fs22.default.existsSync(dir)) {
+      import_node_fs22.default.mkdirSync(dir, { recursive: true });
     }
     let filePath = step.httpRequest.path;
     log(config, "debug", `Saving output to file: ${filePath}`);
-    if (!import_node_fs21.default.existsSync(filePath)) {
-      await import_node_fs21.default.promises.writeFile(filePath, JSON.stringify(response.data, null, 2));
+    if (!import_node_fs22.default.existsSync(filePath)) {
+      await import_node_fs22.default.promises.writeFile(filePath, JSON.stringify(response.data, null, 2));
       descriptions.push(`Saved output to file.`);
     } else {
       if (step.httpRequest.overwrite == "false") {
         descriptions.push(`Didn't save output. File already exists.`);
       }
-      const existingFile = import_node_fs21.default.readFileSync(filePath, "utf8");
+      const existingFile = import_node_fs22.default.readFileSync(filePath, "utf8");
       const fractionalDiff = calculateFractionalDifference(existingFile, JSON.stringify(response.data, null, 2));
       log(config, "debug", `Fractional difference: ${fractionalDiff}`);
       result.outputs.variation = fractionalDiff;
@@ -598229,13 +598660,13 @@ async function httpRequest({ config, step, openApiDefinitions = [] }) {
       });
       if (fractionalDiff > step.httpRequest.maxVariation) {
         if (step.httpRequest.overwrite == "aboveVariation") {
-          await import_node_fs21.default.promises.writeFile(filePath, JSON.stringify(response.data, null, 2));
+          await import_node_fs22.default.promises.writeFile(filePath, JSON.stringify(response.data, null, 2));
           descriptions.push(`Saved response to file.`);
         }
         descriptions.push(`The difference between the existing saved response and the new response (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.httpRequest.maxVariation}).`);
       } else {
         if (step.httpRequest.overwrite == "true") {
-          import_node_fs21.default.writeFileSync(filePath, JSON.stringify(response.data, null, 2));
+          import_node_fs22.default.writeFileSync(filePath, JSON.stringify(response.data, null, 2));
           descriptions.push(`Saved response to file.`);
         }
       }
@@ -598248,8 +598679,8 @@ async function httpRequest({ config, step, openApiDefinitions = [] }) {
   result.description = descriptions.join(" ").trim();
   return result;
 }
-function fieldExistsAtPath(obj, path24) {
-  const segments = path24.match(/[^.[\]]+/g);
+function fieldExistsAtPath(obj, path25) {
+  const segments = path25.match(/[^.[\]]+/g);
   if (!segments) {
     return false;
   }
@@ -598437,7 +598868,7 @@ async function clickElement({ config, step, driver, appSession }) {
 // dist/core/tests/runCode.js
 init_validate();
 init_utils();
-var import_node_fs22 = __toESM(require("node:fs"), 1);
+var import_node_fs23 = __toESM(require("node:fs"), 1);
 var import_node_path21 = __toESM(require("node:path"), 1);
 var import_node_os9 = __toESM(require("node:os"), 1);
 function createTempScript(code, language) {
@@ -598465,7 +598896,7 @@ function createTempScript(code, language) {
   const tmpDir = import_node_os9.default.tmpdir();
   const tmpFile = import_node_path21.default.join(tmpDir, `doc-detective-${Date.now()}${extension}`);
   try {
-    import_node_fs22.default.writeFileSync(tmpFile, code);
+    import_node_fs23.default.writeFileSync(tmpFile, code);
   } catch (error) {
     throw new Error(`Failed to create temporary script: ${error.message}`);
   }
@@ -598575,7 +599006,7 @@ async function runCode({ config, step, driver, processRegistry }) {
   } finally {
     if (!deferTempCleanup) {
       try {
-        import_node_fs22.default.unlinkSync(scriptPath);
+        import_node_fs23.default.unlinkSync(scriptPath);
         log(config, "debug", `Removed temporary script: ${scriptPath}`);
       } catch (error) {
         log(config, "warning", `Failed to remove temporary script: ${scriptPath}`);
@@ -598589,7 +599020,7 @@ async function runCode({ config, step, driver, processRegistry }) {
 init_validate();
 init_utils();
 var import_tree_kill2 = __toESM(require("tree-kill"), 1);
-var import_node_fs23 = __toESM(require("node:fs"), 1);
+var import_node_fs24 = __toESM(require("node:fs"), 1);
 async function closeSurface({ config, step, driver, processRegistry, appSession }) {
   const result = {
     status: "PASS",
@@ -598724,7 +599155,7 @@ async function closeSurface({ config, step, driver, processRegistry, appSession
     }
     if (entry.tempPath) {
       try {
-        import_node_fs23.default.unlinkSync(entry.tempPath);
+        import_node_fs24.default.unlinkSync(entry.tempPath);
       } catch {
       }
     }
@@ -598747,6 +599178,106 @@ async function closeSurface({ config, step, driver, processRegistry, appSession
   return result;
 }
 
+// dist/core/tests/mobileBrowser.js
+var import_node_path22 = __toESM(require("node:path"), 1);
+var SUPPORTED_MOBILE_BROWSER = {
+  android: "chrome",
+  ios: "safari"
+};
+var MOBILE_CHROMEDRIVER_DIR = "chromedriver-mobile";
+function defaultMobileBrowserName(platform) {
+  return SUPPORTED_MOBILE_BROWSER[platform];
+}
+function mobileBrowserSupport({ platform, browserName }) {
+  const supported = SUPPORTED_MOBILE_BROWSER[platform];
+  if (browserName === supported)
+    return { supported: true };
+  return {
+    supported: false,
+    reason: `Skipping context: '${browserName}' isn't available on ${platform}. '${supported}' is the supported ${platform} browser \u2014 set browsers: "${supported}" (or omit browsers) on the ${platform} runOn entry.`
+  };
+}
+function mobileBrowserConfigError(browser) {
+  if (!browser)
+    return null;
+  if (browser.headless === false) {
+    return "browser headless is meaningless for a device browser \u2014 the device owns its display. Set headless on the device descriptor (device.headless) instead.";
+  }
+  const authoredDimensions = (value) => value && typeof value === "object" && Object.keys(value).length > 0;
+  if (authoredDimensions(browser.window)) {
+    return "browser window dimensions are fixed by the device's screen and can't be set on a mobile context. Choose a different device (device.deviceType) if you need another size.";
+  }
+  if (authoredDimensions(browser.viewport)) {
+    return "browser viewport dimensions are fixed by the device's screen and can't be set on a mobile context. Choose a different device (device.deviceType) if you need another size.";
+  }
+  return null;
+}
+function mobileBrowserGate({ platform, browser, hasBrowserStep, hasAppStep }) {
+  if (!hasBrowserStep)
+    return { action: "proceed", browserName: null };
+  if (hasAppStep) {
+    return {
+      action: "skip",
+      level: "warning",
+      reason: `Skipping context on '${platform}': mixing native app surfaces and browser steps in one mobile context isn't supported yet \u2014 put the web steps and the app steps in separate tests or contexts. Mobile-web-only and native-app-only contexts both run today.`
+    };
+  }
+  const configError = mobileBrowserConfigError(browser);
+  if (configError) {
+    return {
+      action: "fail",
+      reason: `Mobile context on '${platform}': ${configError}`
+    };
+  }
+  const browserName = browser?.name ?? defaultMobileBrowserName(platform);
+  const support = mobileBrowserSupport({ platform, browserName });
+  if (!support.supported) {
+    return { action: "skip", level: "warning", reason: support.reason };
+  }
+  return { action: "proceed", browserName };
+}
+function buildMobileBrowserCapabilities({ platform, udid, cacheDir, timeout }) {
+  if (platform === "android") {
+    return {
+      platformName: "Android",
+      "appium:automationName": "UiAutomator2",
+      browserName: "Chrome",
+      "appium:udid": udid,
+      "appium:newCommandTimeout": 600,
+      // adb operations can be slow on a cold emulator (same floor as app
+      // sessions).
+      "appium:adbExecTimeout": 12e4,
+      "wdio:enforceWebDriverClassic": true,
+      // On-device chromedriver management: the server downloads a
+      // chromedriver matching the device's Chrome version. Requires the
+      // Appium server to run with
+      // --allow-insecure=uiautomator2:chromedriver_autodownload. The
+      // download lands in the Doc Detective cache so later runs reuse it.
+      "appium:chromedriverAutodownload": true,
+      "appium:chromedriverExecutableDir": import_node_path22.default.join(cacheDir, MOBILE_CHROMEDRIVER_DIR)
+    };
+  }
+  const capabilities = {
+    platformName: "iOS",
+    "appium:automationName": "XCUITest",
+    browserName: "Safari",
+    "appium:udid": udid,
+    "appium:newCommandTimeout": 600,
+    "wdio:enforceWebDriverClassic": true
+  };
+  const effectiveTimeout = timeout ?? 9e5;
+  capabilities["appium:wdaLaunchTimeout"] = Math.max(effectiveTimeout, 12e4);
+  capabilities["appium:wdaConnectionTimeout"] = Math.max(effectiveTimeout, 12e4);
+  const derivedDataPath = process.env.DOC_DETECTIVE_IOS_WDA_DERIVED_DATA_PATH;
+  if (derivedDataPath && derivedDataPath.trim()) {
+    capabilities["appium:derivedDataPath"] = derivedDataPath.trim();
+  }
+  return capabilities;
+}
+
+// dist/core/tests.js
+init_cacheDir();
+
 // dist/core/tests/iosSimulator.js
 var import_node_child_process11 = require("node:child_process");
 function parseSimctlDevices(text) {
@@ -599079,8 +599610,8 @@ function buildAcquireSimulatorDeps(log3) {
 // dist/core/tests/runBrowserScript.js
 init_validate();
 init_utils();
-var import_node_fs24 = __toESM(require("node:fs"), 1);
-var import_node_path22 = __toESM(require("node:path"), 1);
+var import_node_fs25 = __toESM(require("node:fs"), 1);
+var import_node_path23 = __toESM(require("node:path"), 1);
 async function runBrowserScript({ config, step, driver }) {
   const result = {
     status: "PASS",
@@ -599155,16 +599686,16 @@ async function runBrowserScript({ config, step, driver }) {
   }
   if (step.runBrowserScript.path) {
     try {
-      const dir = import_node_path22.default.dirname(step.runBrowserScript.path);
-      if (!import_node_fs24.default.existsSync(dir)) {
-        import_node_fs24.default.mkdirSync(dir, { recursive: true });
+      const dir = import_node_path23.default.dirname(step.runBrowserScript.path);
+      if (!import_node_fs25.default.existsSync(dir)) {
+        import_node_fs25.default.mkdirSync(dir, { recursive: true });
       }
       const filePath = step.runBrowserScript.path;
       log(config, "debug", `Saving script result to file: ${filePath}`);
-      if (!import_node_fs24.default.existsSync(filePath)) {
-        import_node_fs24.default.writeFileSync(filePath, serialized);
+      if (!import_node_fs25.default.existsSync(filePath)) {
+        import_node_fs25.default.writeFileSync(filePath, serialized);
       } else {
-        const existingFile = import_node_fs24.default.readFileSync(filePath, "utf8");
+        const existingFile = import_node_fs25.default.readFileSync(filePath, "utf8");
         const fractionalDiff = calculateFractionalDifference(existingFile, serialized);
         log(config, "debug", `Fractional difference: ${fractionalDiff}`);
         result.outputs.variation = fractionalDiff;
@@ -599174,7 +599705,7 @@ async function runBrowserScript({ config, step, driver }) {
         });
         if (fractionalDiff > step.runBrowserScript.maxVariation) {
           if (step.runBrowserScript.overwrite == "aboveVariation" || step.runBrowserScript.overwrite == "true") {
-            import_node_fs24.default.writeFileSync(filePath, serialized);
+            import_node_fs25.default.writeFileSync(filePath, serialized);
             descriptions.push(`Saved output to file.`);
           } else {
             descriptions.push(`Didn't overwrite the existing file.`);
@@ -599182,7 +599713,7 @@ async function runBrowserScript({ config, step, driver }) {
           descriptions.push(`The difference between the existing output and the new output (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.runBrowserScript.maxVariation}).`);
         } else {
           if (step.runBrowserScript.overwrite == "true") {
-            import_node_fs24.default.writeFileSync(filePath, serialized);
+            import_node_fs25.default.writeFileSync(filePath, serialized);
             descriptions.push(`Saved output to file.`);
           }
         }
@@ -599350,7 +599881,7 @@ async function dragAndDropElement({ config, step, driver }) {
 }
 
 // dist/core/tests.js
-var import_node_path23 = __toESM(require("node:path"), 1);
+var import_node_path24 = __toESM(require("node:path"), 1);
 var import_node_child_process12 = require("node:child_process");
 var import_node_crypto7 = require("node:crypto");
 init_appium();
@@ -599504,7 +600035,7 @@ function getIntegrationConfig(config, sourceIntegration) {
 var import_node_http2 = __toESM(require("node:http"), 1);
 var import_node_https3 = __toESM(require("node:https"), 1);
 var import_node_url6 = require("node:url");
-var __dirname5 = import_node_path23.default.dirname((0, import_node_url6.fileURLToPath)(importMetaUrl));
+var __dirname5 = import_node_path24.default.dirname((0, import_node_url6.fileURLToPath)(importMetaUrl));
 var KNOWN_BROWSERS = ["firefox", "chrome", "safari", "webkit"];
 function killTree(pid, timeoutMs = 5e3) {
   return new Promise((resolve) => {
@@ -599657,7 +600188,12 @@ function isDriverRequired({ test }) {
 }
 function jobDisplayResources(job, ctx) {
   const base = jobExclusiveResources(job, ctx);
-  const attemptsEmulator = job.context?.platform === "android" && !isBrowserRequired({ test: job.context });
+  const attemptsEmulator = job.context?.platform === "android" && mobileBrowserGate({
+    platform: "android",
+    browser: job.context?.browser,
+    hasBrowserStep: isBrowserRequired({ test: job.context }),
+    hasAppStep: isAppDriverRequired({ test: job.context })
+  }).action === "proceed";
   const extra = attemptsEmulator ? ["android-emulator"] : [];
   if (base.length || extra.length)
     return [.../* @__PURE__ */ new Set([...base, ...extra])];
@@ -599714,12 +600250,17 @@ function requiredAndroidOsVersions(context) {
   }).osVersion);
 }
 async function androidContextPreflight({ config, context, clog }) {
-  const hasBrowserStep = isBrowserRequired({ test: context });
-  if (hasBrowserStep) {
-    const { level, reason } = mobileContextSkipReason({
-      platform: "android"
-    });
-    return { ok: false, level, reason };
+  const gate = mobileBrowserGate({
+    platform: "android",
+    browser: context.browser,
+    hasBrowserStep: isBrowserRequired({ test: context }),
+    hasAppStep: isAppDriverRequired({ test: context })
+  });
+  if (gate.action === "skip") {
+    return { ok: false, level: gate.level, reason: gate.reason };
+  }
+  if (gate.action === "fail") {
+    return { ok: false, level: "warning", reason: gate.reason, fail: true };
   }
   try {
     const abi = hostAbi();
@@ -599833,7 +600374,8 @@ async function androidContextPreflight({ config, context, clog }) {
       appiumHome: pre.appiumHome,
       sdkRoot: sdk.sdkRoot,
       deviceDeps,
-      warnings
+      warnings,
+      mobileWebBrowserName: gate.browserName
     };
   } catch (error) {
     return {
@@ -599844,12 +600386,17 @@ async function androidContextPreflight({ config, context, clog }) {
   }
 }
 async function iosContextPreflight({ config, context }) {
-  const hasBrowserStep = isBrowserRequired({ test: context });
-  if (hasBrowserStep) {
-    const { level, reason } = mobileContextSkipReason({
-      platform: "ios"
-    });
-    return { ok: false, level, reason };
+  const gate = mobileBrowserGate({
+    platform: "ios",
+    browser: context.browser,
+    hasBrowserStep: isBrowserRequired({ test: context }),
+    hasAppStep: isAppDriverRequired({ test: context })
+  });
+  if (gate.action === "skip") {
+    return { ok: false, level: gate.level, reason: gate.reason };
+  }
+  if (gate.action === "fail") {
+    return { ok: false, level: "warning", reason: gate.reason, fail: true };
   }
   const pre = await appSurfacePreflight({ config, platform: "ios" });
   if (!pre.ok)
@@ -599884,7 +600431,8 @@ async function iosContextPreflight({ config, context }) {
     ok: true,
     appiumEntry: pre.appiumEntry,
     appiumHome: pre.appiumHome,
-    simulatorDeps
+    simulatorDeps,
+    mobileWebBrowserName: gate.browserName
   };
 }
 function getDefaultBrowser({ runnerDetails }) {
@@ -600089,7 +600637,7 @@ async function runSpecs({ resolvedTests }) {
   const runDir = getRunOutputDir(config, {
     create: runArchivesArtifacts(config, specs)
   });
-  const runId = import_node_path23.default.basename(runDir);
+  const runId = import_node_path24.default.basename(runDir);
   const report = {
     runId,
     runDir,
@@ -600315,7 +600863,7 @@ async function runSpecs({ resolvedTests }) {
       }
       if (entry?.tempPath) {
         try {
-          import_node_fs25.default.unlinkSync(entry.tempPath);
+          import_node_fs26.default.unlinkSync(entry.tempPath);
         } catch {
         }
       }
@@ -600687,6 +601235,8 @@ function selectWarmUpTargets(jobs, runnerDetails) {
       context.steps = [];
     if (!context.platform)
       context.platform = platform;
+    if (isMobileTargetPlatform(context.platform))
+      continue;
     if (!context.browser && isBrowserRequired({ test: context })) {
       context.browser = getDefaultBrowser({ runnerDetails });
     }
@@ -600890,7 +601440,7 @@ function buildAutoRecordStep({ config, spec, test, context }) {
     return null;
   const runDir = getRunOutputDir(config, { create: false });
   const contextSegment = capPathSegment(sanitizeFilesystemName(String(context.contextId ?? ""), "context"));
-  const recordPath = import_node_path23.default.join(runDir, "specs", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), "tests", capPathSegment(sanitizeFilesystemName(String(test.testId ?? ""), "test")), "contexts", contextSegment, "recordings", `${contextSegment}.mp4`);
+  const recordPath = import_node_path24.default.join(runDir, "specs", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), "tests", capPathSegment(sanitizeFilesystemName(String(test.testId ?? ""), "test")), "contexts", contextSegment, "recordings", `${contextSegment}.mp4`);
   return {
     record: { path: recordPath, overwrite: "true", engine: "ffmpeg" },
     description: "Automatic full-context recording",
@@ -600912,7 +601462,7 @@ async function captureAutoScreenshot({ config, driver, spec, test, context, step
     const action = BROWSER_STEP_KEYS.find((key) => typeof step[key] !== "undefined") || "step";
     const sanitizedTestId = sanitizeFilesystemName(String(test.testId ?? ""), "test");
     const runDir = getRunOutputDir(config);
-    const dir = import_node_path23.default.join(runDir, "specs", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), "tests", capPathSegment(sanitizedTestId), "contexts", capPathSegment(sanitizeFilesystemName(String(context.contextId ?? ""), "context")), "screenshots");
+    const dir = import_node_path24.default.join(runDir, "specs", capPathSegment(sanitizeFilesystemName(String(spec.specId ?? ""), "spec")), "tests", capPathSegment(sanitizedTestId), "contexts", capPathSegment(sanitizeFilesystemName(String(context.contextId ?? ""), "context")), "screenshots");
     const stepIdString = sanitizeFilesystemName(String(step.stepId ?? ""), "step");
     const stepRef = capPathSegment(stepIdString.startsWith(`${sanitizedTestId}~`) ? stepIdString.slice(sanitizedTestId.length + 1) : stepIdString);
     const pad = Math.max(2, String(stepCount).length);
@@ -600921,7 +601471,7 @@ async function captureAutoScreenshot({ config, driver, spec, test, context, step
       stepId: `${step.stepId}_auto`,
       description: "Automatic post-step screenshot",
       screenshot: {
-        path: import_node_path23.default.join(dir, fileName),
+        path: import_node_path24.default.join(dir, fileName),
         overwrite: "true"
       }
     };
@@ -600934,7 +601484,7 @@ async function captureAutoScreenshot({ config, driver, spec, test, context, step
       log(config, "warning", `Auto screenshot failed after step ${step.stepId}: ${captureResult.description}`);
       return null;
     }
-    return import_node_path23.default.relative(runDir, screenshotStep.screenshot.path).split(import_node_path23.default.sep).join("/");
+    return import_node_path24.default.relative(runDir, screenshotStep.screenshot.path).split(import_node_path24.default.sep).join("/");
   } catch (error) {
     log(config, "warning", `Auto screenshot failed after step ${step.stepId}: ${error?.message ?? error}`);
     return null;
@@ -600955,7 +601505,7 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
       ...config.integrations.openApi
     ];
   }
-  if (!context.browser && isBrowserRequired({ test: context })) {
+  if (!context.browser && isBrowserRequired({ test: context }) && !isMobileTargetPlatform(context.platform)) {
     context.browser = getDefaultBrowser({ runnerDetails });
   }
   const contextReport = {
@@ -600966,6 +601516,7 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
   };
   metaValues.specs[spec.specId].tests[test.testId].contexts[context.contextId] ??= { steps: {} };
   let appSession;
+  let mobileWebBrowserName;
   const mobileTarget = isMobileTargetPlatform(context.platform);
   if (mobileTarget) {
     const requirementsSkip = contextRequirementsSkipMessage({ context });
@@ -600975,39 +601526,43 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
       contextReport.resultDescription = requirementsSkip;
       return contextReport;
     }
+    const gateOutcome = (pre) => {
+      clog(pre.fail ? "error" : pre.level, pre.reason);
+      contextReport.result = pre.fail ? "FAIL" : "SKIPPED";
+      contextReport.resultDescription = pre.reason;
+      return contextReport;
+    };
+    let gateBrowserName;
     if (mobileTarget === "android") {
       const pre = await androidContextPreflight({ config, context, clog });
-      if (!pre.ok) {
-        clog(pre.level, pre.reason);
-        contextReport.result = "SKIPPED";
-        contextReport.resultDescription = pre.reason;
-        return contextReport;
-      }
+      if (!pre.ok)
+        return gateOutcome(pre);
       appSession = createAppSessionState();
       appSession.appiumEntry = pre.appiumEntry;
       appSession.appiumHome = pre.appiumHome;
-      appSession.defaultDevice = context.device;
       appSession.androidSdkRoot = pre.sdkRoot;
       appSession.androidDeviceRegistry = deviceRegistry;
       appSession.androidDeviceDeps = pre.deviceDeps;
-      contextReport.device = context.device ?? { platform: "android" };
       if (pre.warnings.length)
         contextReport.warnings = pre.warnings;
+      gateBrowserName = pre.mobileWebBrowserName;
     } else {
       const pre = await iosContextPreflight({ config, context });
-      if (!pre.ok) {
-        clog(pre.level, pre.reason);
-        contextReport.result = "SKIPPED";
-        contextReport.resultDescription = pre.reason;
-        return contextReport;
-      }
+      if (!pre.ok)
+        return gateOutcome(pre);
       appSession = createAppSessionState();
       appSession.appiumEntry = pre.appiumEntry;
       appSession.appiumHome = pre.appiumHome;
-      appSession.defaultDevice = context.device;
       appSession.iosSimulatorRegistry = simulatorRegistry;
       appSession.iosSimulatorDeps = pre.simulatorDeps;
-      contextReport.device = context.device ?? { platform: "ios" };
+      gateBrowserName = pre.mobileWebBrowserName;
+    }
+    appSession.defaultDevice = context.device;
+    contextReport.device = context.device ?? { platform: mobileTarget };
+    if (gateBrowserName) {
+      mobileWebBrowserName = gateBrowserName;
+      context.browser = { ...context.browser ?? {}, name: mobileWebBrowserName };
+      contextReport.browser = context.browser;
     }
   }
   if (context.platform === platform) {
@@ -601087,7 +601642,7 @@ async function runContext({ config, spec, test, context, runnerDetails, appiumPo
     policy: fallbackPolicy,
     availableApps
   }) : [];
-  if (driverRequired && candidateEngines.length === 0) {
+  if (driverRequired && !mobileWebBrowserName && candidateEngines.length === 0) {
     const errorMessage = freshInstallRedetected ? freshInstallOutcome === "installed" ? `Skipping context '${requestedBrowserName}' on '${context.platform}': the missing browser dependency was installed but still could not be detected.` : `Skipping context '${requestedBrowserName}' on '${context.platform}': the on-demand install/repair of its browser dependency failed.` : driverSkipDiagnostic({
       requestedName: requestedBrowserName ?? "<none>",
       // driverSkipDiagnostic treats `platform` as the *current* runner
@@ -601120,7 +601675,82 @@ ${JSON.stringify(context, null, 2)}`);
     throw new Error("Browser driver requested but no Appium server pool was created; the pool sizing (browserJobCount) and this context's isBrowserRequired predicate disagreed; this is a bug.");
   }
   try {
-    if (driverRequired) {
+    if (driverRequired && mobileWebBrowserName) {
+      const env = {
+        APPIUM_HOME: appSession.appiumHome
+      };
+      if (appSession.androidSdkRoot) {
+        env.ANDROID_HOME = appSession.androidSdkRoot;
+        env.ANDROID_SDK_ROOT = appSession.androidSdkRoot;
+      }
+      const extraArgs = mobileTarget === "android" ? ["--allow-insecure", "uiautomator2:chromedriver_autodownload"] : [];
+      let acquired;
+      try {
+        const server = await startAppiumServer(appSession.appiumEntry, config, void 0, env, extraArgs);
+        appSession.server = { port: server.port, process: server.process };
+        const desc = normalizeDeviceDescriptor({
+          contextDevice: context.device,
+          platform: mobileTarget
+        });
+        acquired = mobileTarget === "android" ? await acquireDevice({
+          desc,
+          registry: appSession.androidDeviceRegistry,
+          sdkRoot: appSession.androidSdkRoot,
+          deps: appSession.androidDeviceDeps
+        }) : await acquireSimulator({
+          desc,
+          registry: appSession.iosSimulatorRegistry,
+          deps: appSession.iosSimulatorDeps
+        });
+      } catch (error) {
+        const errorMessage = `Skipping context on '${mobileTarget}': couldn't prepare the device for the ${mobileWebBrowserName} session (${error?.message ?? error}). Check the emulator/simulator toolchain (\`doc-detective install ${mobileTarget}\`).`;
+        clog("warning", errorMessage);
+        contextReport.result = "SKIPPED";
+        contextReport.resultDescription = errorMessage;
+        return contextReport;
+      }
+      if ("skip" in acquired) {
+        clog("warning", acquired.skip);
+        contextReport.result = "SKIPPED";
+        contextReport.resultDescription = acquired.skip;
+        return contextReport;
+      }
+      contextReport.device = {
+        ...typeof contextReport.device === "object" ? contextReport.device : {},
+        platform: mobileTarget,
+        name: acquired.entry.name
+      };
+      const capabilities = buildMobileBrowserCapabilities({
+        platform: mobileTarget,
+        udid: acquired.entry.udid,
+        // The resolved cache root (not the raw config field, which is
+        // usually unset) — the chromedriver autodownload dir lives here.
+        cacheDir: getCacheDir({ cacheDir: config?.cacheDir })
+      });
+      try {
+        driver = await driverStart(capabilities, appSession.server.port, 2, {
+          cacheDir: config?.cacheDir
+        });
+      } catch (error) {
+        const hint = mobileTarget === "android" ? " Chrome may not be present on this emulator image \u2014 managed Android mobile-web needs a `google_apis` system image (see `doc-detective install android`)." : " Check that the simulator runtime includes Safari and that WebDriverAgent can build (see `doc-detective install ios`).";
+        const errorMessage = `Skipping context on '${mobileTarget}': couldn't start the ${mobileWebBrowserName} session on device '${acquired.entry.name}' (${error?.message ?? error}).${hint}`;
+        clog("warning", errorMessage);
+        contextReport.result = "SKIPPED";
+        contextReport.resultDescription = errorMessage;
+        return contextReport;
+      }
+      browserSessions = createSessionRegistry({
+        open: async () => {
+          throw new Error("Additional browser sessions aren't supported on a managed device; the device browser is the context's only browser surface.");
+        },
+        isNameTaken: (name) => !!processRegistry?.has(name)
+      });
+      registerSession(browserSessions, {
+        name: String(mobileWebBrowserName).toLowerCase(),
+        engine: String(mobileWebBrowserName).toLowerCase(),
+        driver
+      });
+    } else if (driverRequired) {
       appiumPort = await appiumPool.acquire();
       if (portToDisplay) {
         const display = portToDisplay.get(appiumPort);
@@ -601789,7 +602419,7 @@ async function runStep({ config = {}, context = {}, step, driver, metaValues = {
   }
   return actionResult;
 }
-async function startAppiumServer(appiumEntry, config, display, extraEnv) {
+async function startAppiumServer(appiumEntry, config, display, extraEnv, extraArgs) {
   const port = await findFreePort();
   log(config, "debug", `Starting Appium on port ${port}`);
   const env = display || extraEnv ? {
@@ -601797,9 +602427,9 @@ async function startAppiumServer(appiumEntry, config, display, extraEnv) {
     ...display ? { DISPLAY: display } : {},
     ...extraEnv ?? {}
   } : process.env;
-  const proc = (0, import_node_child_process12.spawn)(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(port)], {
+  const proc = (0, import_node_child_process12.spawn)(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(port), ...extraArgs ?? []], {
     windowsHide: true,
-    cwd: import_node_path23.default.join(__dirname5, "../.."),
+    cwd: import_node_path24.default.join(__dirname5, "../.."),
     env
   });
   proc.on("error", (err) => {
@@ -601946,7 +602576,7 @@ async function getRunner(options = {}) {
   }
   const appium = (0, import_node_child_process12.spawn)(process.execPath, [appiumEntry, "-a", "127.0.0.1", "-p", String(appiumPort)], {
     windowsHide: true,
-    cwd: import_node_path23.default.join(__dirname5, "../..")
+    cwd: import_node_path24.default.join(__dirname5, "../..")
   });
   appium.on("error", (err) => {
     log(config, "warning", `Appium process error: ${err?.stack ?? err?.message ?? String(err)}`);