doc-detective 4.0.2 → 4.1.1

package/dist/common/src/schemas/schemas.json

@@ -36,6 +36,14 @@
               "trim"
             ]
           },
+          "params": {
+            "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "default": {}
+          },
           "statusCodes": {
             "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
             "anyOf": [
@@ -60,6 +68,26 @@
               307,
               308
             ]
+          },
+          "headers": {
+            "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+            "default": {},
+            "anyOf": [
+              {
+                "title": "Request headers (object)",
+                "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                "type": "object",
+                "additionalProperties": {
+                  "type": "string"
+                },
+                "properties": {}
+              },
+              {
+                "title": "Request headers (string)",
+                "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                "type": "string"
+              }
+            ]
           }
         }
       }
@@ -99,6 +127,14 @@
                 "trim"
               ]
             },
+            "params": {
+              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              },
+              "default": {}
+            },
             "statusCodes": {
               "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
               "anyOf": [
@@ -123,6 +159,26 @@
                 307,
                 308
               ]
+            },
+            "headers": {
+              "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+              "default": {},
+              "anyOf": [
+                {
+                  "title": "Request headers (object)",
+                  "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "string"
+                  },
+                  "properties": {}
+                },
+                {
+                  "title": "Request headers (string)",
+                  "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                  "type": "string"
+                }
+              ]
             }
           }
         }
@@ -141,6 +197,13 @@
         "statusCodes": [
           200
         ]
+      },
+      {
+        "url": "/health",
+        "origin": "https://my-app.com",
+        "params": {
+          "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+        }
       }
     ]
   },
@@ -447,6 +510,18 @@
         "type": "string",
         "default": "."
       },
+      "reporters": {
+        "description": "Reporters to use when emitting test results. Built-in reporters: `terminal`, `json`, `html`. Custom reporters registered via `registerReporter()` can also be referenced by name.",
+        "type": "array",
+        "items": {
+          "type": "string",
+          "minLength": 1
+        },
+        "default": [
+          "terminal",
+          "json"
+        ]
+      },
       "recursive": {
         "description": "If `true` searches `input`, `setup`, and `cleanup` paths recursively for test specifications and source files.",
         "type": "boolean",
@@ -474,6 +549,14 @@
         "description": "Default protocol and domain to use for relative URLs.",
         "type": "string"
       },
+      "originParams": {
+        "description": "Query parameters to append to URLs resolved against `origin`. Values support environment variable substitution via `$VAR` syntax. Step-level `params` on `goTo` / `checkLink` are merged on top of these, with step keys winning on collision. WARNING: values are embedded in request URLs and appear verbatim in test results, logs, and reports — avoid putting long-lived secrets here.",
+        "type": "object",
+        "additionalProperties": {
+          "type": "string"
+        },
+        "default": {}
+      },
       "beforeAny": {
         "description": "Path(s) to test specifications to perform before those specified by `input`. Useful for setting up testing environments.",
         "anyOf": [
@@ -1488,6 +1571,14 @@
                                                             "trim"
                                                           ]
                                                         },
+                                                        "params": {
+                                                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                          "type": "object",
+                                                          "additionalProperties": {
+                                                            "type": "string"
+                                                          },
+                                                          "default": {}
+                                                        },
                                                         "statusCodes": {
                                                           "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                           "anyOf": [
@@ -1512,6 +1603,26 @@
                                                             307,
                                                             308
                                                           ]
+                                                        },
+                                                        "headers": {
+                                                          "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                          "default": {},
+                                                          "anyOf": [
+                                                            {
+                                                              "title": "Request headers (object)",
+                                                              "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                              "type": "object",
+                                                              "additionalProperties": {
+                                                                "type": "string"
+                                                              },
+                                                              "properties": {}
+                                                            },
+                                                            {
+                                                              "title": "Request headers (string)",
+                                                              "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                              "type": "string"
+                                                            }
+                                                          ]
                                                         }
                                                       }
                                                     }
@@ -1551,6 +1662,14 @@
                                                               "trim"
                                                             ]
                                                           },
+                                                          "params": {
+                                                            "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                            "type": "object",
+                                                            "additionalProperties": {
+                                                              "type": "string"
+                                                            },
+                                                            "default": {}
+                                                          },
                                                           "statusCodes": {
                                                             "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                             "anyOf": [
@@ -1575,6 +1694,26 @@
                                                               307,
                                                               308
                                                             ]
+                                                          },
+                                                          "headers": {
+                                                            "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                            "default": {},
+                                                            "anyOf": [
+                                                              {
+                                                                "title": "Request headers (object)",
+                                                                "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                                "type": "object",
+                                                                "additionalProperties": {
+                                                                  "type": "string"
+                                                                },
+                                                                "properties": {}
+                                                              },
+                                                              {
+                                                                "title": "Request headers (string)",
+                                                                "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                                "type": "string"
+                                                              }
+                                                            ]
                                                           }
                                                         }
                                                       }
@@ -1593,6 +1732,13 @@
                                                       "statusCodes": [
                                                         200
                                                       ]
+                                                    },
+                                                    {
+                                                      "url": "/health",
+                                                      "origin": "https://my-app.com",
+                                                      "params": {
+                                                        "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                                      }
                                                     }
                                                   ]
                                                 }
@@ -3533,6 +3679,14 @@
                                                             "trim"
                                                           ]
                                                         },
+                                                        "params": {
+                                                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                          "type": "object",
+                                                          "additionalProperties": {
+                                                            "type": "string"
+                                                          },
+                                                          "default": {}
+                                                        },
                                                         "timeout": {
                                                           "type": "integer",
                                                           "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -3705,6 +3859,14 @@
                                                               "trim"
                                                             ]
                                                           },
+                                                          "params": {
+                                                            "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                            "type": "object",
+                                                            "additionalProperties": {
+                                                              "type": "string"
+                                                            },
+                                                            "default": {}
+                                                          },
                                                           "timeout": {
                                                             "type": "integer",
                                                             "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -3854,6 +4016,13 @@
                                                       "url": "/search",
                                                       "origin": "https://www.google.com"
                                                     },
+                                                    {
+                                                      "url": "/dashboard",
+                                                      "origin": "https://my-app.com",
+                                                      "params": {
+                                                        "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                                      }
+                                                    },
                                                     {
                                                       "url": "https://www.example.com",
                                                       "waitUntil": {
@@ -6119,9 +6288,9 @@
                                                   "anyOf": [
                                                     {
                                                       "title": "Screenshot (simple)",
-                                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                       "type": "string",
-                                                      "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                      "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                       "transform": [
                                                         "trim"
                                                       ]
@@ -6132,9 +6301,9 @@
                                                       "properties": {
                                                         "path": {
                                                           "title": "Screenshot (simple)",
-                                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                           "type": "string",
-                                                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                           "transform": [
                                                             "trim"
                                                           ]
@@ -6365,9 +6534,9 @@
                                                     "schemas": {
                                                       "path": {
                                                         "title": "Screenshot (simple)",
-                                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                         "type": "string",
-                                                        "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                        "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                         "transform": [
                                                           "trim"
                                                         ]
@@ -6378,9 +6547,9 @@
                                                         "properties": {
                                                           "path": {
                                                             "title": "Screenshot (simple)",
-                                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                             "type": "string",
-                                                            "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                            "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                             "transform": [
                                                               "trim"
                                                             ]
@@ -6762,6 +6931,12 @@
                                                     "image.png",
                                                     "static/images/image.png",
                                                     "/User/manny/projects/doc-detective/static/images/image.png",
+                                                    "https://example.com/static/images/image.png",
+                                                    {
+                                                      "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                                      "maxVariation": 0.05,
+                                                      "overwrite": "aboveVariation"
+                                                    },
                                                     {
                                                       "path": "image.png",
                                                       "directory": "static/images",
@@ -10111,6 +10286,14 @@
                                               "trim"
                                             ]
                                           },
+                                          "params": {
+                                            "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                            "type": "object",
+                                            "additionalProperties": {
+                                              "type": "string"
+                                            },
+                                            "default": {}
+                                          },
                                           "statusCodes": {
                                             "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                             "anyOf": [
@@ -10135,6 +10318,26 @@
                                               307,
                                               308
                                             ]
+                                          },
+                                          "headers": {
+                                            "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                            "default": {},
+                                            "anyOf": [
+                                              {
+                                                "title": "Request headers (object)",
+                                                "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                "type": "object",
+                                                "additionalProperties": {
+                                                  "type": "string"
+                                                },
+                                                "properties": {}
+                                              },
+                                              {
+                                                "title": "Request headers (string)",
+                                                "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                "type": "string"
+                                              }
+                                            ]
                                           }
                                         }
                                       }
@@ -10174,6 +10377,14 @@
                                                 "trim"
                                               ]
                                             },
+                                            "params": {
+                                              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                              "type": "object",
+                                              "additionalProperties": {
+                                                "type": "string"
+                                              },
+                                              "default": {}
+                                            },
                                             "statusCodes": {
                                               "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                               "anyOf": [
@@ -10198,6 +10409,26 @@
                                                 307,
                                                 308
                                               ]
+                                            },
+                                            "headers": {
+                                              "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                              "default": {},
+                                              "anyOf": [
+                                                {
+                                                  "title": "Request headers (object)",
+                                                  "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                  "type": "object",
+                                                  "additionalProperties": {
+                                                    "type": "string"
+                                                  },
+                                                  "properties": {}
+                                                },
+                                                {
+                                                  "title": "Request headers (string)",
+                                                  "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                  "type": "string"
+                                                }
+                                              ]
                                             }
                                           }
                                         }
@@ -10216,6 +10447,13 @@
                                         "statusCodes": [
                                           200
                                         ]
+                                      },
+                                      {
+                                        "url": "/health",
+                                        "origin": "https://my-app.com",
+                                        "params": {
+                                          "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                        }
                                       }
                                     ]
                                   }
@@ -12156,6 +12394,14 @@
                                               "trim"
                                             ]
                                           },
+                                          "params": {
+                                            "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                            "type": "object",
+                                            "additionalProperties": {
+                                              "type": "string"
+                                            },
+                                            "default": {}
+                                          },
                                           "timeout": {
                                             "type": "integer",
                                             "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -12328,6 +12574,14 @@
                                                 "trim"
                                               ]
                                             },
+                                            "params": {
+                                              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                              "type": "object",
+                                              "additionalProperties": {
+                                                "type": "string"
+                                              },
+                                              "default": {}
+                                            },
                                             "timeout": {
                                               "type": "integer",
                                               "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -12477,6 +12731,13 @@
                                         "url": "/search",
                                         "origin": "https://www.google.com"
                                       },
+                                      {
+                                        "url": "/dashboard",
+                                        "origin": "https://my-app.com",
+                                        "params": {
+                                          "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                        }
+                                      },
                                       {
                                         "url": "https://www.example.com",
                                         "waitUntil": {
@@ -14742,9 +15003,9 @@
                                     "anyOf": [
                                       {
                                         "title": "Screenshot (simple)",
-                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                         "type": "string",
-                                        "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                        "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                         "transform": [
                                           "trim"
                                         ]
@@ -14755,9 +15016,9 @@
                                         "properties": {
                                           "path": {
                                             "title": "Screenshot (simple)",
-                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                             "type": "string",
-                                            "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                            "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                             "transform": [
                                               "trim"
                                             ]
@@ -14988,9 +15249,9 @@
                                       "schemas": {
                                         "path": {
                                           "title": "Screenshot (simple)",
-                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                           "type": "string",
-                                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                           "transform": [
                                             "trim"
                                           ]
@@ -15001,9 +15262,9 @@
                                           "properties": {
                                             "path": {
                                               "title": "Screenshot (simple)",
-                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                               "type": "string",
-                                              "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                              "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                               "transform": [
                                                 "trim"
                                               ]
@@ -15385,6 +15646,12 @@
                                       "image.png",
                                       "static/images/image.png",
                                       "/User/manny/projects/doc-detective/static/images/image.png",
+                                      "https://example.com/static/images/image.png",
+                                      {
+                                        "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                        "maxVariation": 0.05,
+                                        "overwrite": "aboveVariation"
+                                      },
                                       {
                                         "path": "image.png",
                                         "directory": "static/images",
@@ -17798,8 +18065,19 @@
         "loadVariables": ".env",
         "fileTypes": [
           "markdown"
+        ],
+        "reporters": [
+          "terminal",
+          "json",
+          "html"
         ]
       },
+      {
+        "origin": "https://my-app.com",
+        "originParams": {
+          "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+        }
+      },
       {
         "fileTypes": [
           {
@@ -20165,6 +20443,14 @@
               "trim"
             ]
           },
+          "params": {
+            "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "default": {}
+          },
           "timeout": {
             "type": "integer",
             "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -20337,6 +20623,14 @@
                 "trim"
               ]
             },
+            "params": {
+              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+              "type": "object",
+              "additionalProperties": {
+                "type": "string"
+              },
+              "default": {}
+            },
             "timeout": {
               "type": "integer",
               "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -20486,6 +20780,13 @@
         "url": "/search",
         "origin": "https://www.google.com"
       },
+      {
+        "url": "/dashboard",
+        "origin": "https://my-app.com",
+        "params": {
+          "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+        }
+      },
       {
         "url": "https://www.example.com",
         "waitUntil": {
@@ -22106,6 +22407,18 @@
             "type": "string",
             "default": "."
           },
+          "reporters": {
+            "description": "Reporters to use when emitting test results. Built-in reporters: `terminal`, `json`, `html`. Custom reporters registered via `registerReporter()` can also be referenced by name.",
+            "type": "array",
+            "items": {
+              "type": "string",
+              "minLength": 1
+            },
+            "default": [
+              "terminal",
+              "json"
+            ]
+          },
           "recursive": {
             "description": "If `true` searches `input`, `setup`, and `cleanup` paths recursively for test specifications and source files.",
             "type": "boolean",
@@ -22133,6 +22446,14 @@
             "description": "Default protocol and domain to use for relative URLs.",
             "type": "string"
           },
+          "originParams": {
+            "description": "Query parameters to append to URLs resolved against `origin`. Values support environment variable substitution via `$VAR` syntax. Step-level `params` on `goTo` / `checkLink` are merged on top of these, with step keys winning on collision. WARNING: values are embedded in request URLs and appear verbatim in test results, logs, and reports — avoid putting long-lived secrets here.",
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "default": {}
+          },
           "beforeAny": {
             "description": "Path(s) to test specifications to perform before those specified by `input`. Useful for setting up testing environments.",
             "anyOf": [
@@ -23147,6 +23468,14 @@
                                                                 "trim"
                                                               ]
                                                             },
+                                                            "params": {
+                                                              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                              "type": "object",
+                                                              "additionalProperties": {
+                                                                "type": "string"
+                                                              },
+                                                              "default": {}
+                                                            },
                                                             "statusCodes": {
                                                               "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                               "anyOf": [
@@ -23171,6 +23500,26 @@
                                                                 307,
                                                                 308
                                                               ]
+                                                            },
+                                                            "headers": {
+                                                              "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                              "default": {},
+                                                              "anyOf": [
+                                                                {
+                                                                  "title": "Request headers (object)",
+                                                                  "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                                  "type": "object",
+                                                                  "additionalProperties": {
+                                                                    "type": "string"
+                                                                  },
+                                                                  "properties": {}
+                                                                },
+                                                                {
+                                                                  "title": "Request headers (string)",
+                                                                  "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                                  "type": "string"
+                                                                }
+                                                              ]
                                                             }
                                                           }
                                                         }
@@ -23210,6 +23559,14 @@
                                                                   "trim"
                                                                 ]
                                                               },
+                                                              "params": {
+                                                                "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                                "type": "object",
+                                                                "additionalProperties": {
+                                                                  "type": "string"
+                                                                },
+                                                                "default": {}
+                                                              },
                                                               "statusCodes": {
                                                                 "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                                 "anyOf": [
@@ -23234,6 +23591,26 @@
                                                                   307,
                                                                   308
                                                                 ]
+                                                              },
+                                                              "headers": {
+                                                                "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                                "default": {},
+                                                                "anyOf": [
+                                                                  {
+                                                                    "title": "Request headers (object)",
+                                                                    "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                                    "type": "object",
+                                                                    "additionalProperties": {
+                                                                      "type": "string"
+                                                                    },
+                                                                    "properties": {}
+                                                                  },
+                                                                  {
+                                                                    "title": "Request headers (string)",
+                                                                    "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                                    "type": "string"
+                                                                  }
+                                                                ]
                                                               }
                                                             }
                                                           }
@@ -23252,6 +23629,13 @@
                                                           "statusCodes": [
                                                             200
                                                           ]
+                                                        },
+                                                        {
+                                                          "url": "/health",
+                                                          "origin": "https://my-app.com",
+                                                          "params": {
+                                                            "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                                          }
                                                         }
                                                       ]
                                                     }
@@ -25192,6 +25576,14 @@
                                                                 "trim"
                                                               ]
                                                             },
+                                                            "params": {
+                                                              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                              "type": "object",
+                                                              "additionalProperties": {
+                                                                "type": "string"
+                                                              },
+                                                              "default": {}
+                                                            },
                                                             "timeout": {
                                                               "type": "integer",
                                                               "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -25364,6 +25756,14 @@
                                                                   "trim"
                                                                 ]
                                                               },
+                                                              "params": {
+                                                                "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                                "type": "object",
+                                                                "additionalProperties": {
+                                                                  "type": "string"
+                                                                },
+                                                                "default": {}
+                                                              },
                                                               "timeout": {
                                                                 "type": "integer",
                                                                 "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -25513,6 +25913,13 @@
                                                           "url": "/search",
                                                           "origin": "https://www.google.com"
                                                         },
+                                                        {
+                                                          "url": "/dashboard",
+                                                          "origin": "https://my-app.com",
+                                                          "params": {
+                                                            "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                                          }
+                                                        },
                                                         {
                                                           "url": "https://www.example.com",
                                                           "waitUntil": {
@@ -27778,9 +28185,9 @@
                                                       "anyOf": [
                                                         {
                                                           "title": "Screenshot (simple)",
-                                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                           "type": "string",
-                                                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                           "transform": [
                                                             "trim"
                                                           ]
@@ -27791,9 +28198,9 @@
                                                           "properties": {
                                                             "path": {
                                                               "title": "Screenshot (simple)",
-                                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                               "type": "string",
-                                                              "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                              "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                               "transform": [
                                                                 "trim"
                                                               ]
@@ -28024,9 +28431,9 @@
                                                         "schemas": {
                                                           "path": {
                                                             "title": "Screenshot (simple)",
-                                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                             "type": "string",
-                                                            "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                            "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                             "transform": [
                                                               "trim"
                                                             ]
@@ -28037,9 +28444,9 @@
                                                             "properties": {
                                                               "path": {
                                                                 "title": "Screenshot (simple)",
-                                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                                 "type": "string",
-                                                                "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                                "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                                 "transform": [
                                                                   "trim"
                                                                 ]
@@ -28421,6 +28828,12 @@
                                                         "image.png",
                                                         "static/images/image.png",
                                                         "/User/manny/projects/doc-detective/static/images/image.png",
+                                                        "https://example.com/static/images/image.png",
+                                                        {
+                                                          "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                                          "maxVariation": 0.05,
+                                                          "overwrite": "aboveVariation"
+                                                        },
                                                         {
                                                           "path": "image.png",
                                                           "directory": "static/images",
@@ -31770,6 +32183,14 @@
                                                   "trim"
                                                 ]
                                               },
+                                              "params": {
+                                                "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                "type": "object",
+                                                "additionalProperties": {
+                                                  "type": "string"
+                                                },
+                                                "default": {}
+                                              },
                                               "statusCodes": {
                                                 "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                 "anyOf": [
@@ -31794,6 +32215,26 @@
                                                   307,
                                                   308
                                                 ]
+                                              },
+                                              "headers": {
+                                                "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                "default": {},
+                                                "anyOf": [
+                                                  {
+                                                    "title": "Request headers (object)",
+                                                    "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                    "type": "object",
+                                                    "additionalProperties": {
+                                                      "type": "string"
+                                                    },
+                                                    "properties": {}
+                                                  },
+                                                  {
+                                                    "title": "Request headers (string)",
+                                                    "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                    "type": "string"
+                                                  }
+                                                ]
                                               }
                                             }
                                           }
@@ -31833,6 +32274,14 @@
                                                     "trim"
                                                   ]
                                                 },
+                                                "params": {
+                                                  "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                  "type": "object",
+                                                  "additionalProperties": {
+                                                    "type": "string"
+                                                  },
+                                                  "default": {}
+                                                },
                                                 "statusCodes": {
                                                   "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                   "anyOf": [
@@ -31857,6 +32306,26 @@
                                                     307,
                                                     308
                                                   ]
+                                                },
+                                                "headers": {
+                                                  "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                  "default": {},
+                                                  "anyOf": [
+                                                    {
+                                                      "title": "Request headers (object)",
+                                                      "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                      "type": "object",
+                                                      "additionalProperties": {
+                                                        "type": "string"
+                                                      },
+                                                      "properties": {}
+                                                    },
+                                                    {
+                                                      "title": "Request headers (string)",
+                                                      "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                      "type": "string"
+                                                    }
+                                                  ]
                                                 }
                                               }
                                             }
@@ -31875,6 +32344,13 @@
                                             "statusCodes": [
                                               200
                                             ]
+                                          },
+                                          {
+                                            "url": "/health",
+                                            "origin": "https://my-app.com",
+                                            "params": {
+                                              "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                            }
                                           }
                                         ]
                                       }
@@ -33815,6 +34291,14 @@
                                                   "trim"
                                                 ]
                                               },
+                                              "params": {
+                                                "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                "type": "object",
+                                                "additionalProperties": {
+                                                  "type": "string"
+                                                },
+                                                "default": {}
+                                              },
                                               "timeout": {
                                                 "type": "integer",
                                                 "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -33987,6 +34471,14 @@
                                                     "trim"
                                                   ]
                                                 },
+                                                "params": {
+                                                  "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                  "type": "object",
+                                                  "additionalProperties": {
+                                                    "type": "string"
+                                                  },
+                                                  "default": {}
+                                                },
                                                 "timeout": {
                                                   "type": "integer",
                                                   "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -34136,6 +34628,13 @@
                                             "url": "/search",
                                             "origin": "https://www.google.com"
                                           },
+                                          {
+                                            "url": "/dashboard",
+                                            "origin": "https://my-app.com",
+                                            "params": {
+                                              "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                            }
+                                          },
                                           {
                                             "url": "https://www.example.com",
                                             "waitUntil": {
@@ -36401,9 +36900,9 @@
                                         "anyOf": [
                                           {
                                             "title": "Screenshot (simple)",
-                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                             "type": "string",
-                                            "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                            "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                             "transform": [
                                               "trim"
                                             ]
@@ -36414,9 +36913,9 @@
                                             "properties": {
                                               "path": {
                                                 "title": "Screenshot (simple)",
-                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                 "type": "string",
-                                                "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                 "transform": [
                                                   "trim"
                                                 ]
@@ -36647,9 +37146,9 @@
                                           "schemas": {
                                             "path": {
                                               "title": "Screenshot (simple)",
-                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                               "type": "string",
-                                              "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                              "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                               "transform": [
                                                 "trim"
                                               ]
@@ -36660,9 +37159,9 @@
                                               "properties": {
                                                 "path": {
                                                   "title": "Screenshot (simple)",
-                                                  "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                  "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                   "type": "string",
-                                                  "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                  "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                   "transform": [
                                                     "trim"
                                                   ]
@@ -37044,6 +37543,12 @@
                                           "image.png",
                                           "static/images/image.png",
                                           "/User/manny/projects/doc-detective/static/images/image.png",
+                                          "https://example.com/static/images/image.png",
+                                          {
+                                            "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                            "maxVariation": 0.05,
+                                            "overwrite": "aboveVariation"
+                                          },
                                           {
                                             "path": "image.png",
                                             "directory": "static/images",
@@ -39457,8 +39962,19 @@
             "loadVariables": ".env",
             "fileTypes": [
               "markdown"
+            ],
+            "reporters": [
+              "terminal",
+              "json",
+              "html"
             ]
           },
+          {
+            "origin": "https://my-app.com",
+            "originParams": {
+              "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+            }
+          },
           {
             "fileTypes": [
               {
@@ -41082,6 +41598,14 @@
                                                     "trim"
                                                   ]
                                                 },
+                                                "params": {
+                                                  "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                  "type": "object",
+                                                  "additionalProperties": {
+                                                    "type": "string"
+                                                  },
+                                                  "default": {}
+                                                },
                                                 "statusCodes": {
                                                   "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                   "anyOf": [
@@ -41106,6 +41630,26 @@
                                                     307,
                                                     308
                                                   ]
+                                                },
+                                                "headers": {
+                                                  "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                  "default": {},
+                                                  "anyOf": [
+                                                    {
+                                                      "title": "Request headers (object)",
+                                                      "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                      "type": "object",
+                                                      "additionalProperties": {
+                                                        "type": "string"
+                                                      },
+                                                      "properties": {}
+                                                    },
+                                                    {
+                                                      "title": "Request headers (string)",
+                                                      "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                      "type": "string"
+                                                    }
+                                                  ]
                                                 }
                                               }
                                             }
@@ -41145,6 +41689,14 @@
                                                       "trim"
                                                     ]
                                                   },
+                                                  "params": {
+                                                    "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                    "type": "object",
+                                                    "additionalProperties": {
+                                                      "type": "string"
+                                                    },
+                                                    "default": {}
+                                                  },
                                                   "statusCodes": {
                                                     "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                     "anyOf": [
@@ -41169,6 +41721,26 @@
                                                       307,
                                                       308
                                                     ]
+                                                  },
+                                                  "headers": {
+                                                    "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                    "default": {},
+                                                    "anyOf": [
+                                                      {
+                                                        "title": "Request headers (object)",
+                                                        "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                        "type": "object",
+                                                        "additionalProperties": {
+                                                          "type": "string"
+                                                        },
+                                                        "properties": {}
+                                                      },
+                                                      {
+                                                        "title": "Request headers (string)",
+                                                        "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                        "type": "string"
+                                                      }
+                                                    ]
                                                   }
                                                 }
                                               }
@@ -41187,6 +41759,13 @@
                                               "statusCodes": [
                                                 200
                                               ]
+                                            },
+                                            {
+                                              "url": "/health",
+                                              "origin": "https://my-app.com",
+                                              "params": {
+                                                "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                              }
                                             }
                                           ]
                                         }
@@ -43127,6 +43706,14 @@
                                                     "trim"
                                                   ]
                                                 },
+                                                "params": {
+                                                  "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                  "type": "object",
+                                                  "additionalProperties": {
+                                                    "type": "string"
+                                                  },
+                                                  "default": {}
+                                                },
                                                 "timeout": {
                                                   "type": "integer",
                                                   "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -43299,6 +43886,14 @@
                                                       "trim"
                                                     ]
                                                   },
+                                                  "params": {
+                                                    "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                    "type": "object",
+                                                    "additionalProperties": {
+                                                      "type": "string"
+                                                    },
+                                                    "default": {}
+                                                  },
                                                   "timeout": {
                                                     "type": "integer",
                                                     "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -43448,6 +44043,13 @@
                                               "url": "/search",
                                               "origin": "https://www.google.com"
                                             },
+                                            {
+                                              "url": "/dashboard",
+                                              "origin": "https://my-app.com",
+                                              "params": {
+                                                "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                              }
+                                            },
                                             {
                                               "url": "https://www.example.com",
                                               "waitUntil": {
@@ -45713,9 +46315,9 @@
                                           "anyOf": [
                                             {
                                               "title": "Screenshot (simple)",
-                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                               "type": "string",
-                                              "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                              "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                               "transform": [
                                                 "trim"
                                               ]
@@ -45726,9 +46328,9 @@
                                               "properties": {
                                                 "path": {
                                                   "title": "Screenshot (simple)",
-                                                  "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                  "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                   "type": "string",
-                                                  "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                  "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                   "transform": [
                                                     "trim"
                                                   ]
@@ -45959,9 +46561,9 @@
                                             "schemas": {
                                               "path": {
                                                 "title": "Screenshot (simple)",
-                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                 "type": "string",
-                                                "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                 "transform": [
                                                   "trim"
                                                 ]
@@ -45972,9 +46574,9 @@
                                                 "properties": {
                                                   "path": {
                                                     "title": "Screenshot (simple)",
-                                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                     "type": "string",
-                                                    "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                    "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                     "transform": [
                                                       "trim"
                                                     ]
@@ -46356,6 +46958,12 @@
                                             "image.png",
                                             "static/images/image.png",
                                             "/User/manny/projects/doc-detective/static/images/image.png",
+                                            "https://example.com/static/images/image.png",
+                                            {
+                                              "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                              "maxVariation": 0.05,
+                                              "overwrite": "aboveVariation"
+                                            },
                                             {
                                               "path": "image.png",
                                               "directory": "static/images",
@@ -49179,6 +49787,14 @@
                                                           "trim"
                                                         ]
                                                       },
+                                                      "params": {
+                                                        "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                        "type": "object",
+                                                        "additionalProperties": {
+                                                          "type": "string"
+                                                        },
+                                                        "default": {}
+                                                      },
                                                       "statusCodes": {
                                                         "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                         "anyOf": [
@@ -49203,6 +49819,26 @@
                                                           307,
                                                           308
                                                         ]
+                                                      },
+                                                      "headers": {
+                                                        "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                        "default": {},
+                                                        "anyOf": [
+                                                          {
+                                                            "title": "Request headers (object)",
+                                                            "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                            "type": "object",
+                                                            "additionalProperties": {
+                                                              "type": "string"
+                                                            },
+                                                            "properties": {}
+                                                          },
+                                                          {
+                                                            "title": "Request headers (string)",
+                                                            "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                            "type": "string"
+                                                          }
+                                                        ]
                                                       }
                                                     }
                                                   }
@@ -49242,6 +49878,14 @@
                                                             "trim"
                                                           ]
                                                         },
+                                                        "params": {
+                                                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                          "type": "object",
+                                                          "additionalProperties": {
+                                                            "type": "string"
+                                                          },
+                                                          "default": {}
+                                                        },
                                                         "statusCodes": {
                                                           "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                           "anyOf": [
@@ -49266,6 +49910,26 @@
                                                             307,
                                                             308
                                                           ]
+                                                        },
+                                                        "headers": {
+                                                          "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                          "default": {},
+                                                          "anyOf": [
+                                                            {
+                                                              "title": "Request headers (object)",
+                                                              "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                              "type": "object",
+                                                              "additionalProperties": {
+                                                                "type": "string"
+                                                              },
+                                                              "properties": {}
+                                                            },
+                                                            {
+                                                              "title": "Request headers (string)",
+                                                              "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                              "type": "string"
+                                                            }
+                                                          ]
                                                         }
                                                       }
                                                     }
@@ -49284,6 +49948,13 @@
                                                     "statusCodes": [
                                                       200
                                                     ]
+                                                  },
+                                                  {
+                                                    "url": "/health",
+                                                    "origin": "https://my-app.com",
+                                                    "params": {
+                                                      "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                                    }
                                                   }
                                                 ]
                                               }
@@ -51224,6 +51895,14 @@
                                                           "trim"
                                                         ]
                                                       },
+                                                      "params": {
+                                                        "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                        "type": "object",
+                                                        "additionalProperties": {
+                                                          "type": "string"
+                                                        },
+                                                        "default": {}
+                                                      },
                                                       "timeout": {
                                                         "type": "integer",
                                                         "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -51396,6 +52075,14 @@
                                                             "trim"
                                                           ]
                                                         },
+                                                        "params": {
+                                                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                          "type": "object",
+                                                          "additionalProperties": {
+                                                            "type": "string"
+                                                          },
+                                                          "default": {}
+                                                        },
                                                         "timeout": {
                                                           "type": "integer",
                                                           "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -51545,6 +52232,13 @@
                                                     "url": "/search",
                                                     "origin": "https://www.google.com"
                                                   },
+                                                  {
+                                                    "url": "/dashboard",
+                                                    "origin": "https://my-app.com",
+                                                    "params": {
+                                                      "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                                    }
+                                                  },
                                                   {
                                                     "url": "https://www.example.com",
                                                     "waitUntil": {
@@ -53810,9 +54504,9 @@
                                                 "anyOf": [
                                                   {
                                                     "title": "Screenshot (simple)",
-                                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                     "type": "string",
-                                                    "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                    "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                     "transform": [
                                                       "trim"
                                                     ]
@@ -53823,9 +54517,9 @@
                                                     "properties": {
                                                       "path": {
                                                         "title": "Screenshot (simple)",
-                                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                         "type": "string",
-                                                        "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                        "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                         "transform": [
                                                           "trim"
                                                         ]
@@ -54056,9 +54750,9 @@
                                                   "schemas": {
                                                     "path": {
                                                       "title": "Screenshot (simple)",
-                                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                       "type": "string",
-                                                      "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                      "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                       "transform": [
                                                         "trim"
                                                       ]
@@ -54069,9 +54763,9 @@
                                                       "properties": {
                                                         "path": {
                                                           "title": "Screenshot (simple)",
-                                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                           "type": "string",
-                                                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                           "transform": [
                                                             "trim"
                                                           ]
@@ -54453,6 +55147,12 @@
                                                   "image.png",
                                                   "static/images/image.png",
                                                   "/User/manny/projects/doc-detective/static/images/image.png",
+                                                  "https://example.com/static/images/image.png",
+                                                  {
+                                                    "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                                    "maxVariation": 0.05,
+                                                    "overwrite": "aboveVariation"
+                                                  },
                                                   {
                                                     "path": "image.png",
                                                     "directory": "static/images",
@@ -58986,6 +59686,14 @@
                                                     "trim"
                                                   ]
                                                 },
+                                                "params": {
+                                                  "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                  "type": "object",
+                                                  "additionalProperties": {
+                                                    "type": "string"
+                                                  },
+                                                  "default": {}
+                                                },
                                                 "statusCodes": {
                                                   "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                   "anyOf": [
@@ -59010,6 +59718,26 @@
                                                     307,
                                                     308
                                                   ]
+                                                },
+                                                "headers": {
+                                                  "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                  "default": {},
+                                                  "anyOf": [
+                                                    {
+                                                      "title": "Request headers (object)",
+                                                      "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                      "type": "object",
+                                                      "additionalProperties": {
+                                                        "type": "string"
+                                                      },
+                                                      "properties": {}
+                                                    },
+                                                    {
+                                                      "title": "Request headers (string)",
+                                                      "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                      "type": "string"
+                                                    }
+                                                  ]
                                                 }
                                               }
                                             }
@@ -59049,6 +59777,14 @@
                                                       "trim"
                                                     ]
                                                   },
+                                                  "params": {
+                                                    "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                    "type": "object",
+                                                    "additionalProperties": {
+                                                      "type": "string"
+                                                    },
+                                                    "default": {}
+                                                  },
                                                   "statusCodes": {
                                                     "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                     "anyOf": [
@@ -59073,6 +59809,26 @@
                                                       307,
                                                       308
                                                     ]
+                                                  },
+                                                  "headers": {
+                                                    "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                    "default": {},
+                                                    "anyOf": [
+                                                      {
+                                                        "title": "Request headers (object)",
+                                                        "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                        "type": "object",
+                                                        "additionalProperties": {
+                                                          "type": "string"
+                                                        },
+                                                        "properties": {}
+                                                      },
+                                                      {
+                                                        "title": "Request headers (string)",
+                                                        "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                        "type": "string"
+                                                      }
+                                                    ]
                                                   }
                                                 }
                                               }
@@ -59091,6 +59847,13 @@
                                               "statusCodes": [
                                                 200
                                               ]
+                                            },
+                                            {
+                                              "url": "/health",
+                                              "origin": "https://my-app.com",
+                                              "params": {
+                                                "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                              }
                                             }
                                           ]
                                         }
@@ -61031,6 +61794,14 @@
                                                     "trim"
                                                   ]
                                                 },
+                                                "params": {
+                                                  "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                  "type": "object",
+                                                  "additionalProperties": {
+                                                    "type": "string"
+                                                  },
+                                                  "default": {}
+                                                },
                                                 "timeout": {
                                                   "type": "integer",
                                                   "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -61203,6 +61974,14 @@
                                                       "trim"
                                                     ]
                                                   },
+                                                  "params": {
+                                                    "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                    "type": "object",
+                                                    "additionalProperties": {
+                                                      "type": "string"
+                                                    },
+                                                    "default": {}
+                                                  },
                                                   "timeout": {
                                                     "type": "integer",
                                                     "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -61352,6 +62131,13 @@
                                               "url": "/search",
                                               "origin": "https://www.google.com"
                                             },
+                                            {
+                                              "url": "/dashboard",
+                                              "origin": "https://my-app.com",
+                                              "params": {
+                                                "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                              }
+                                            },
                                             {
                                               "url": "https://www.example.com",
                                               "waitUntil": {
@@ -63617,9 +64403,9 @@
                                           "anyOf": [
                                             {
                                               "title": "Screenshot (simple)",
-                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                               "type": "string",
-                                              "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                              "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                               "transform": [
                                                 "trim"
                                               ]
@@ -63630,9 +64416,9 @@
                                               "properties": {
                                                 "path": {
                                                   "title": "Screenshot (simple)",
-                                                  "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                  "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                   "type": "string",
-                                                  "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                  "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                   "transform": [
                                                     "trim"
                                                   ]
@@ -63863,9 +64649,9 @@
                                             "schemas": {
                                               "path": {
                                                 "title": "Screenshot (simple)",
-                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                 "type": "string",
-                                                "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                 "transform": [
                                                   "trim"
                                                 ]
@@ -63876,9 +64662,9 @@
                                                 "properties": {
                                                   "path": {
                                                     "title": "Screenshot (simple)",
-                                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                     "type": "string",
-                                                    "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                    "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                     "transform": [
                                                       "trim"
                                                     ]
@@ -64260,6 +65046,12 @@
                                             "image.png",
                                             "static/images/image.png",
                                             "/User/manny/projects/doc-detective/static/images/image.png",
+                                            "https://example.com/static/images/image.png",
+                                            {
+                                              "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                              "maxVariation": 0.05,
+                                              "overwrite": "aboveVariation"
+                                            },
                                             {
                                               "path": "image.png",
                                               "directory": "static/images",
@@ -67083,6 +67875,14 @@
                                                           "trim"
                                                         ]
                                                       },
+                                                      "params": {
+                                                        "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                        "type": "object",
+                                                        "additionalProperties": {
+                                                          "type": "string"
+                                                        },
+                                                        "default": {}
+                                                      },
                                                       "statusCodes": {
                                                         "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                         "anyOf": [
@@ -67107,6 +67907,26 @@
                                                           307,
                                                           308
                                                         ]
+                                                      },
+                                                      "headers": {
+                                                        "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                        "default": {},
+                                                        "anyOf": [
+                                                          {
+                                                            "title": "Request headers (object)",
+                                                            "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                            "type": "object",
+                                                            "additionalProperties": {
+                                                              "type": "string"
+                                                            },
+                                                            "properties": {}
+                                                          },
+                                                          {
+                                                            "title": "Request headers (string)",
+                                                            "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                            "type": "string"
+                                                          }
+                                                        ]
                                                       }
                                                     }
                                                   }
@@ -67146,6 +67966,14 @@
                                                             "trim"
                                                           ]
                                                         },
+                                                        "params": {
+                                                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                          "type": "object",
+                                                          "additionalProperties": {
+                                                            "type": "string"
+                                                          },
+                                                          "default": {}
+                                                        },
                                                         "statusCodes": {
                                                           "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                           "anyOf": [
@@ -67170,6 +67998,26 @@
                                                             307,
                                                             308
                                                           ]
+                                                        },
+                                                        "headers": {
+                                                          "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                          "default": {},
+                                                          "anyOf": [
+                                                            {
+                                                              "title": "Request headers (object)",
+                                                              "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                              "type": "object",
+                                                              "additionalProperties": {
+                                                                "type": "string"
+                                                              },
+                                                              "properties": {}
+                                                            },
+                                                            {
+                                                              "title": "Request headers (string)",
+                                                              "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                              "type": "string"
+                                                            }
+                                                          ]
                                                         }
                                                       }
                                                     }
@@ -67188,6 +68036,13 @@
                                                     "statusCodes": [
                                                       200
                                                     ]
+                                                  },
+                                                  {
+                                                    "url": "/health",
+                                                    "origin": "https://my-app.com",
+                                                    "params": {
+                                                      "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                                    }
                                                   }
                                                 ]
                                               }
@@ -69128,6 +69983,14 @@
                                                           "trim"
                                                         ]
                                                       },
+                                                      "params": {
+                                                        "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                        "type": "object",
+                                                        "additionalProperties": {
+                                                          "type": "string"
+                                                        },
+                                                        "default": {}
+                                                      },
                                                       "timeout": {
                                                         "type": "integer",
                                                         "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -69300,6 +70163,14 @@
                                                             "trim"
                                                           ]
                                                         },
+                                                        "params": {
+                                                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                          "type": "object",
+                                                          "additionalProperties": {
+                                                            "type": "string"
+                                                          },
+                                                          "default": {}
+                                                        },
                                                         "timeout": {
                                                           "type": "integer",
                                                           "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -69449,6 +70320,13 @@
                                                     "url": "/search",
                                                     "origin": "https://www.google.com"
                                                   },
+                                                  {
+                                                    "url": "/dashboard",
+                                                    "origin": "https://my-app.com",
+                                                    "params": {
+                                                      "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                                    }
+                                                  },
                                                   {
                                                     "url": "https://www.example.com",
                                                     "waitUntil": {
@@ -71714,9 +72592,9 @@
                                                 "anyOf": [
                                                   {
                                                     "title": "Screenshot (simple)",
-                                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                     "type": "string",
-                                                    "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                    "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                     "transform": [
                                                       "trim"
                                                     ]
@@ -71727,9 +72605,9 @@
                                                     "properties": {
                                                       "path": {
                                                         "title": "Screenshot (simple)",
-                                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                         "type": "string",
-                                                        "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                        "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                         "transform": [
                                                           "trim"
                                                         ]
@@ -71960,9 +72838,9 @@
                                                   "schemas": {
                                                     "path": {
                                                       "title": "Screenshot (simple)",
-                                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                       "type": "string",
-                                                      "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                      "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                       "transform": [
                                                         "trim"
                                                       ]
@@ -71973,9 +72851,9 @@
                                                       "properties": {
                                                         "path": {
                                                           "title": "Screenshot (simple)",
-                                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                           "type": "string",
-                                                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                           "transform": [
                                                             "trim"
                                                           ]
@@ -72357,6 +73235,12 @@
                                                   "image.png",
                                                   "static/images/image.png",
                                                   "/User/manny/projects/doc-detective/static/images/image.png",
+                                                  "https://example.com/static/images/image.png",
+                                                  {
+                                                    "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                                    "maxVariation": 0.05,
+                                                    "overwrite": "aboveVariation"
+                                                  },
                                                   {
                                                     "path": "image.png",
                                                     "directory": "static/images",
@@ -76041,9 +76925,9 @@
     "anyOf": [
       {
         "title": "Screenshot (simple)",
-        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
         "type": "string",
-        "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+        "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
         "transform": [
           "trim"
         ]
@@ -76054,9 +76938,9 @@
         "properties": {
           "path": {
             "title": "Screenshot (simple)",
-            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
             "type": "string",
-            "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+            "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
             "transform": [
               "trim"
             ]
@@ -76287,9 +77171,9 @@
       "schemas": {
         "path": {
           "title": "Screenshot (simple)",
-          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
           "type": "string",
-          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
           "transform": [
             "trim"
           ]
@@ -76300,9 +77184,9 @@
           "properties": {
             "path": {
               "title": "Screenshot (simple)",
-              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
               "type": "string",
-              "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+              "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
               "transform": [
                 "trim"
               ]
@@ -76684,6 +77568,12 @@
       "image.png",
       "static/images/image.png",
       "/User/manny/projects/doc-detective/static/images/image.png",
+      "https://example.com/static/images/image.png",
+      {
+        "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+        "maxVariation": 0.05,
+        "overwrite": "aboveVariation"
+      },
       {
         "path": "image.png",
         "directory": "static/images",
@@ -78272,6 +79162,14 @@
                                           "trim"
                                         ]
                                       },
+                                      "params": {
+                                        "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                        "type": "object",
+                                        "additionalProperties": {
+                                          "type": "string"
+                                        },
+                                        "default": {}
+                                      },
                                       "statusCodes": {
                                         "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                         "anyOf": [
@@ -78296,6 +79194,26 @@
                                           307,
                                           308
                                         ]
+                                      },
+                                      "headers": {
+                                        "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                        "default": {},
+                                        "anyOf": [
+                                          {
+                                            "title": "Request headers (object)",
+                                            "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                            "type": "object",
+                                            "additionalProperties": {
+                                              "type": "string"
+                                            },
+                                            "properties": {}
+                                          },
+                                          {
+                                            "title": "Request headers (string)",
+                                            "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                            "type": "string"
+                                          }
+                                        ]
                                       }
                                     }
                                   }
@@ -78335,6 +79253,14 @@
                                             "trim"
                                           ]
                                         },
+                                        "params": {
+                                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                          "type": "object",
+                                          "additionalProperties": {
+                                            "type": "string"
+                                          },
+                                          "default": {}
+                                        },
                                         "statusCodes": {
                                           "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                           "anyOf": [
@@ -78359,6 +79285,26 @@
                                             307,
                                             308
                                           ]
+                                        },
+                                        "headers": {
+                                          "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                          "default": {},
+                                          "anyOf": [
+                                            {
+                                              "title": "Request headers (object)",
+                                              "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                              "type": "object",
+                                              "additionalProperties": {
+                                                "type": "string"
+                                              },
+                                              "properties": {}
+                                            },
+                                            {
+                                              "title": "Request headers (string)",
+                                              "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                              "type": "string"
+                                            }
+                                          ]
                                         }
                                       }
                                     }
@@ -78377,6 +79323,13 @@
                                     "statusCodes": [
                                       200
                                     ]
+                                  },
+                                  {
+                                    "url": "/health",
+                                    "origin": "https://my-app.com",
+                                    "params": {
+                                      "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                    }
                                   }
                                 ]
                               }
@@ -80317,6 +81270,14 @@
                                           "trim"
                                         ]
                                       },
+                                      "params": {
+                                        "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                        "type": "object",
+                                        "additionalProperties": {
+                                          "type": "string"
+                                        },
+                                        "default": {}
+                                      },
                                       "timeout": {
                                         "type": "integer",
                                         "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -80489,6 +81450,14 @@
                                             "trim"
                                           ]
                                         },
+                                        "params": {
+                                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                          "type": "object",
+                                          "additionalProperties": {
+                                            "type": "string"
+                                          },
+                                          "default": {}
+                                        },
                                         "timeout": {
                                           "type": "integer",
                                           "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -80638,6 +81607,13 @@
                                     "url": "/search",
                                     "origin": "https://www.google.com"
                                   },
+                                  {
+                                    "url": "/dashboard",
+                                    "origin": "https://my-app.com",
+                                    "params": {
+                                      "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                    }
+                                  },
                                   {
                                     "url": "https://www.example.com",
                                     "waitUntil": {
@@ -82903,9 +83879,9 @@
                                 "anyOf": [
                                   {
                                     "title": "Screenshot (simple)",
-                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                     "type": "string",
-                                    "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                    "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                     "transform": [
                                       "trim"
                                     ]
@@ -82916,9 +83892,9 @@
                                     "properties": {
                                       "path": {
                                         "title": "Screenshot (simple)",
-                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                         "type": "string",
-                                        "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                        "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                         "transform": [
                                           "trim"
                                         ]
@@ -83149,9 +84125,9 @@
                                   "schemas": {
                                     "path": {
                                       "title": "Screenshot (simple)",
-                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                       "type": "string",
-                                      "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                      "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                       "transform": [
                                         "trim"
                                       ]
@@ -83162,9 +84138,9 @@
                                       "properties": {
                                         "path": {
                                           "title": "Screenshot (simple)",
-                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                           "type": "string",
-                                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                           "transform": [
                                             "trim"
                                           ]
@@ -83546,6 +84522,12 @@
                                   "image.png",
                                   "static/images/image.png",
                                   "/User/manny/projects/doc-detective/static/images/image.png",
+                                  "https://example.com/static/images/image.png",
+                                  {
+                                    "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                    "maxVariation": 0.05,
+                                    "overwrite": "aboveVariation"
+                                  },
                                   {
                                     "path": "image.png",
                                     "directory": "static/images",
@@ -86369,6 +87351,14 @@
                                                 "trim"
                                               ]
                                             },
+                                            "params": {
+                                              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                              "type": "object",
+                                              "additionalProperties": {
+                                                "type": "string"
+                                              },
+                                              "default": {}
+                                            },
                                             "statusCodes": {
                                               "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                               "anyOf": [
@@ -86393,6 +87383,26 @@
                                                 307,
                                                 308
                                               ]
+                                            },
+                                            "headers": {
+                                              "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                              "default": {},
+                                              "anyOf": [
+                                                {
+                                                  "title": "Request headers (object)",
+                                                  "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                  "type": "object",
+                                                  "additionalProperties": {
+                                                    "type": "string"
+                                                  },
+                                                  "properties": {}
+                                                },
+                                                {
+                                                  "title": "Request headers (string)",
+                                                  "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                  "type": "string"
+                                                }
+                                              ]
                                             }
                                           }
                                         }
@@ -86432,6 +87442,14 @@
                                                   "trim"
                                                 ]
                                               },
+                                              "params": {
+                                                "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                "type": "object",
+                                                "additionalProperties": {
+                                                  "type": "string"
+                                                },
+                                                "default": {}
+                                              },
                                               "statusCodes": {
                                                 "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                                 "anyOf": [
@@ -86456,6 +87474,26 @@
                                                   307,
                                                   308
                                                 ]
+                                              },
+                                              "headers": {
+                                                "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                                "default": {},
+                                                "anyOf": [
+                                                  {
+                                                    "title": "Request headers (object)",
+                                                    "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                                    "type": "object",
+                                                    "additionalProperties": {
+                                                      "type": "string"
+                                                    },
+                                                    "properties": {}
+                                                  },
+                                                  {
+                                                    "title": "Request headers (string)",
+                                                    "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                                    "type": "string"
+                                                  }
+                                                ]
                                               }
                                             }
                                           }
@@ -86474,6 +87512,13 @@
                                           "statusCodes": [
                                             200
                                           ]
+                                        },
+                                        {
+                                          "url": "/health",
+                                          "origin": "https://my-app.com",
+                                          "params": {
+                                            "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                          }
                                         }
                                       ]
                                     }
@@ -88414,6 +89459,14 @@
                                                 "trim"
                                               ]
                                             },
+                                            "params": {
+                                              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                              "type": "object",
+                                              "additionalProperties": {
+                                                "type": "string"
+                                              },
+                                              "default": {}
+                                            },
                                             "timeout": {
                                               "type": "integer",
                                               "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -88586,6 +89639,14 @@
                                                   "trim"
                                                 ]
                                               },
+                                              "params": {
+                                                "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                                "type": "object",
+                                                "additionalProperties": {
+                                                  "type": "string"
+                                                },
+                                                "default": {}
+                                              },
                                               "timeout": {
                                                 "type": "integer",
                                                 "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -88735,6 +89796,13 @@
                                           "url": "/search",
                                           "origin": "https://www.google.com"
                                         },
+                                        {
+                                          "url": "/dashboard",
+                                          "origin": "https://my-app.com",
+                                          "params": {
+                                            "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                          }
+                                        },
                                         {
                                           "url": "https://www.example.com",
                                           "waitUntil": {
@@ -91000,9 +92068,9 @@
                                       "anyOf": [
                                         {
                                           "title": "Screenshot (simple)",
-                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                           "type": "string",
-                                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                           "transform": [
                                             "trim"
                                           ]
@@ -91013,9 +92081,9 @@
                                           "properties": {
                                             "path": {
                                               "title": "Screenshot (simple)",
-                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                               "type": "string",
-                                              "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                              "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                               "transform": [
                                                 "trim"
                                               ]
@@ -91246,9 +92314,9 @@
                                         "schemas": {
                                           "path": {
                                             "title": "Screenshot (simple)",
-                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                             "type": "string",
-                                            "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                            "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                             "transform": [
                                               "trim"
                                             ]
@@ -91259,9 +92327,9 @@
                                             "properties": {
                                               "path": {
                                                 "title": "Screenshot (simple)",
-                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                                 "type": "string",
-                                                "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                                "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                                 "transform": [
                                                   "trim"
                                                 ]
@@ -91643,6 +92711,12 @@
                                         "image.png",
                                         "static/images/image.png",
                                         "/User/manny/projects/doc-detective/static/images/image.png",
+                                        "https://example.com/static/images/image.png",
+                                        {
+                                          "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                          "maxVariation": 0.05,
+                                          "overwrite": "aboveVariation"
+                                        },
                                         {
                                           "path": "image.png",
                                           "directory": "static/images",
@@ -94746,6 +95820,14 @@
                           "trim"
                         ]
                       },
+                      "params": {
+                        "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                        "type": "object",
+                        "additionalProperties": {
+                          "type": "string"
+                        },
+                        "default": {}
+                      },
                       "statusCodes": {
                         "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                         "anyOf": [
@@ -94770,6 +95852,26 @@
                           307,
                           308
                         ]
+                      },
+                      "headers": {
+                        "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                        "default": {},
+                        "anyOf": [
+                          {
+                            "title": "Request headers (object)",
+                            "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                            "type": "object",
+                            "additionalProperties": {
+                              "type": "string"
+                            },
+                            "properties": {}
+                          },
+                          {
+                            "title": "Request headers (string)",
+                            "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                            "type": "string"
+                          }
+                        ]
                       }
                     }
                   }
@@ -94809,6 +95911,14 @@
                             "trim"
                           ]
                         },
+                        "params": {
+                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                          "type": "object",
+                          "additionalProperties": {
+                            "type": "string"
+                          },
+                          "default": {}
+                        },
                         "statusCodes": {
                           "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                           "anyOf": [
@@ -94833,6 +95943,26 @@
                             307,
                             308
                           ]
+                        },
+                        "headers": {
+                          "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                          "default": {},
+                          "anyOf": [
+                            {
+                              "title": "Request headers (object)",
+                              "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                              "type": "object",
+                              "additionalProperties": {
+                                "type": "string"
+                              },
+                              "properties": {}
+                            },
+                            {
+                              "title": "Request headers (string)",
+                              "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                              "type": "string"
+                            }
+                          ]
                         }
                       }
                     }
@@ -94851,6 +95981,13 @@
                     "statusCodes": [
                       200
                     ]
+                  },
+                  {
+                    "url": "/health",
+                    "origin": "https://my-app.com",
+                    "params": {
+                      "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                    }
                   }
                 ]
               }
@@ -96791,6 +97928,14 @@
                           "trim"
                         ]
                       },
+                      "params": {
+                        "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                        "type": "object",
+                        "additionalProperties": {
+                          "type": "string"
+                        },
+                        "default": {}
+                      },
                       "timeout": {
                         "type": "integer",
                         "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -96963,6 +98108,14 @@
                             "trim"
                           ]
                         },
+                        "params": {
+                          "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                          "type": "object",
+                          "additionalProperties": {
+                            "type": "string"
+                          },
+                          "default": {}
+                        },
                         "timeout": {
                           "type": "integer",
                           "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -97112,6 +98265,13 @@
                     "url": "/search",
                     "origin": "https://www.google.com"
                   },
+                  {
+                    "url": "/dashboard",
+                    "origin": "https://my-app.com",
+                    "params": {
+                      "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                    }
+                  },
                   {
                     "url": "https://www.example.com",
                     "waitUntil": {
@@ -99377,9 +100537,9 @@
                 "anyOf": [
                   {
                     "title": "Screenshot (simple)",
-                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                     "type": "string",
-                    "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                    "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                     "transform": [
                       "trim"
                     ]
@@ -99390,9 +100550,9 @@
                     "properties": {
                       "path": {
                         "title": "Screenshot (simple)",
-                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                        "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                         "type": "string",
-                        "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                        "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                         "transform": [
                           "trim"
                         ]
@@ -99623,9 +100783,9 @@
                   "schemas": {
                     "path": {
                       "title": "Screenshot (simple)",
-                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                       "type": "string",
-                      "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                      "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                       "transform": [
                         "trim"
                       ]
@@ -99636,9 +100796,9 @@
                       "properties": {
                         "path": {
                           "title": "Screenshot (simple)",
-                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                           "type": "string",
-                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                           "transform": [
                             "trim"
                           ]
@@ -100020,6 +101180,12 @@
                   "image.png",
                   "static/images/image.png",
                   "/User/manny/projects/doc-detective/static/images/image.png",
+                  "https://example.com/static/images/image.png",
+                  {
+                    "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                    "maxVariation": 0.05,
+                    "overwrite": "aboveVariation"
+                  },
                   {
                     "path": "image.png",
                     "directory": "static/images",
@@ -103196,6 +104362,14 @@
                                 "trim"
                               ]
                             },
+                            "params": {
+                              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                              "type": "object",
+                              "additionalProperties": {
+                                "type": "string"
+                              },
+                              "default": {}
+                            },
                             "statusCodes": {
                               "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                               "anyOf": [
@@ -103220,6 +104394,26 @@
                                 307,
                                 308
                               ]
+                            },
+                            "headers": {
+                              "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                              "default": {},
+                              "anyOf": [
+                                {
+                                  "title": "Request headers (object)",
+                                  "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                  "type": "object",
+                                  "additionalProperties": {
+                                    "type": "string"
+                                  },
+                                  "properties": {}
+                                },
+                                {
+                                  "title": "Request headers (string)",
+                                  "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                  "type": "string"
+                                }
+                              ]
                             }
                           }
                         }
@@ -103259,6 +104453,14 @@
                                   "trim"
                                 ]
                               },
+                              "params": {
+                                "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                "type": "object",
+                                "additionalProperties": {
+                                  "type": "string"
+                                },
+                                "default": {}
+                              },
                               "statusCodes": {
                                 "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                 "anyOf": [
@@ -103283,6 +104485,26 @@
                                   307,
                                   308
                                 ]
+                              },
+                              "headers": {
+                                "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                "default": {},
+                                "anyOf": [
+                                  {
+                                    "title": "Request headers (object)",
+                                    "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                    "type": "object",
+                                    "additionalProperties": {
+                                      "type": "string"
+                                    },
+                                    "properties": {}
+                                  },
+                                  {
+                                    "title": "Request headers (string)",
+                                    "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                    "type": "string"
+                                  }
+                                ]
                               }
                             }
                           }
@@ -103301,6 +104523,13 @@
                           "statusCodes": [
                             200
                           ]
+                        },
+                        {
+                          "url": "/health",
+                          "origin": "https://my-app.com",
+                          "params": {
+                            "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                          }
                         }
                       ]
                     }
@@ -105241,6 +106470,14 @@
                                 "trim"
                               ]
                             },
+                            "params": {
+                              "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                              "type": "object",
+                              "additionalProperties": {
+                                "type": "string"
+                              },
+                              "default": {}
+                            },
                             "timeout": {
                               "type": "integer",
                               "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -105413,6 +106650,14 @@
                                   "trim"
                                 ]
                               },
+                              "params": {
+                                "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                "type": "object",
+                                "additionalProperties": {
+                                  "type": "string"
+                                },
+                                "default": {}
+                              },
                               "timeout": {
                                 "type": "integer",
                                 "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -105562,6 +106807,13 @@
                           "url": "/search",
                           "origin": "https://www.google.com"
                         },
+                        {
+                          "url": "/dashboard",
+                          "origin": "https://my-app.com",
+                          "params": {
+                            "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                          }
+                        },
                         {
                           "url": "https://www.example.com",
                           "waitUntil": {
@@ -107827,9 +109079,9 @@
                       "anyOf": [
                         {
                           "title": "Screenshot (simple)",
-                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                          "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                           "type": "string",
-                          "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                          "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                           "transform": [
                             "trim"
                           ]
@@ -107840,9 +109092,9 @@
                           "properties": {
                             "path": {
                               "title": "Screenshot (simple)",
-                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                              "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                               "type": "string",
-                              "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                              "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                               "transform": [
                                 "trim"
                               ]
@@ -108073,9 +109325,9 @@
                         "schemas": {
                           "path": {
                             "title": "Screenshot (simple)",
-                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                            "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                             "type": "string",
-                            "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                            "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                             "transform": [
                               "trim"
                             ]
@@ -108086,9 +109338,9 @@
                             "properties": {
                               "path": {
                                 "title": "Screenshot (simple)",
-                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                 "type": "string",
-                                "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                 "transform": [
                                   "trim"
                                 ]
@@ -108470,6 +109722,12 @@
                         "image.png",
                         "static/images/image.png",
                         "/User/manny/projects/doc-detective/static/images/image.png",
+                        "https://example.com/static/images/image.png",
+                        {
+                          "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                          "maxVariation": 0.05,
+                          "overwrite": "aboveVariation"
+                        },
                         {
                           "path": "image.png",
                           "directory": "static/images",
@@ -111293,6 +112551,14 @@
                                       "trim"
                                     ]
                                   },
+                                  "params": {
+                                    "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                    "type": "object",
+                                    "additionalProperties": {
+                                      "type": "string"
+                                    },
+                                    "default": {}
+                                  },
                                   "statusCodes": {
                                     "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                     "anyOf": [
@@ -111317,6 +112583,26 @@
                                       307,
                                       308
                                     ]
+                                  },
+                                  "headers": {
+                                    "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                    "default": {},
+                                    "anyOf": [
+                                      {
+                                        "title": "Request headers (object)",
+                                        "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                        "type": "object",
+                                        "additionalProperties": {
+                                          "type": "string"
+                                        },
+                                        "properties": {}
+                                      },
+                                      {
+                                        "title": "Request headers (string)",
+                                        "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                        "type": "string"
+                                      }
+                                    ]
                                   }
                                 }
                               }
@@ -111356,6 +112642,14 @@
                                         "trim"
                                       ]
                                     },
+                                    "params": {
+                                      "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                      "type": "object",
+                                      "additionalProperties": {
+                                        "type": "string"
+                                      },
+                                      "default": {}
+                                    },
                                     "statusCodes": {
                                       "description": "Accepted status codes. If the specified URL returns a code other than what is specified here, the action fails.",
                                       "anyOf": [
@@ -111380,6 +112674,26 @@
                                         307,
                                         308
                                       ]
+                                    },
+                                    "headers": {
+                                      "description": "Additional HTTP headers to include in the request. Merged on top of Doc Detective's default browser-mimicking headers. Useful for sites behind bot protection or WAFs that allowlist specific headers (for example, a Cloudflare Access service token or a `Cookie` with a `cf_clearance` value).",
+                                      "default": {},
+                                      "anyOf": [
+                                        {
+                                          "title": "Request headers (object)",
+                                          "description": "Headers to include in the HTTP request, in key/value format. Values must be strings.",
+                                          "type": "object",
+                                          "additionalProperties": {
+                                            "type": "string"
+                                          },
+                                          "properties": {}
+                                        },
+                                        {
+                                          "title": "Request headers (string)",
+                                          "description": "Headers to include in the HTTP request, as newline-separated values. For example, `X-Api-Key: abc123\nAuthorization: Bearer token`.",
+                                          "type": "string"
+                                        }
+                                      ]
                                     }
                                   }
                                 }
@@ -111398,6 +112712,13 @@
                                 "statusCodes": [
                                   200
                                 ]
+                              },
+                              {
+                                "url": "/health",
+                                "origin": "https://my-app.com",
+                                "params": {
+                                  "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                }
                               }
                             ]
                           }
@@ -113338,6 +114659,14 @@
                                       "trim"
                                     ]
                                   },
+                                  "params": {
+                                    "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                    "type": "object",
+                                    "additionalProperties": {
+                                      "type": "string"
+                                    },
+                                    "default": {}
+                                  },
                                   "timeout": {
                                     "type": "integer",
                                     "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -113510,6 +114839,14 @@
                                         "trim"
                                       ]
                                     },
+                                    "params": {
+                                      "description": "Query parameters to append to the resolved URL. Merged on top of `originParams` from config; step keys win on collision. If `url` already contains a colliding query key, the value here replaces it. Values support environment variable substitution via `$VAR` syntax. WARNING: values are embedded in the request URL and appear in test results, logs, and reports.",
+                                      "type": "object",
+                                      "additionalProperties": {
+                                        "type": "string"
+                                      },
+                                      "default": {}
+                                    },
                                     "timeout": {
                                       "type": "integer",
                                       "description": "Maximum time in milliseconds to wait for the page to be ready. If exceeded, the goTo action fails.",
@@ -113659,6 +114996,13 @@
                                 "url": "/search",
                                 "origin": "https://www.google.com"
                               },
+                              {
+                                "url": "/dashboard",
+                                "origin": "https://my-app.com",
+                                "params": {
+                                  "__clerk_testing_token": "$CLERK_TESTING_TOKEN"
+                                }
+                              },
                               {
                                 "url": "https://www.example.com",
                                 "waitUntil": {
@@ -115924,9 +117268,9 @@
                             "anyOf": [
                               {
                                 "title": "Screenshot (simple)",
-                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                 "type": "string",
-                                "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                 "transform": [
                                   "trim"
                                 ]
@@ -115937,9 +117281,9 @@
                                 "properties": {
                                   "path": {
                                     "title": "Screenshot (simple)",
-                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                    "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                     "type": "string",
-                                    "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                    "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                     "transform": [
                                       "trim"
                                     ]
@@ -116170,9 +117514,9 @@
                               "schemas": {
                                 "path": {
                                   "title": "Screenshot (simple)",
-                                  "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                  "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                   "type": "string",
-                                  "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                  "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                   "transform": [
                                     "trim"
                                   ]
@@ -116183,9 +117527,9 @@
                                   "properties": {
                                     "path": {
                                       "title": "Screenshot (simple)",
-                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step.",
+                                      "description": "File path of the PNG file. Accepts absolute paths. If not specified, the file name is the ID of the step. If an `http(s)` URL is supplied, the remote image is downloaded and used as a read-only reference for comparison; the new capture is written to a local run-specific folder instead of being uploaded back to the URL.",
                                       "type": "string",
-                                      "pattern": "([A-Za-z0-9_-]*\\.(png|PNG)$|\\$[A-Za-z0-9_]+)",
+                                      "pattern": "^(?:https?:\\/\\/.+\\.(?:png|PNG)(?:\\?.*)?|[A-Za-z]:[\\/\\\\].*\\.(?:png|PNG)|[\\/\\\\]?[A-Za-z0-9_.\\/\\\\-]*\\.(?:png|PNG)|\\$[A-Za-z0-9_]+)$",
                                       "transform": [
                                         "trim"
                                       ]
@@ -116567,6 +117911,12 @@
                               "image.png",
                               "static/images/image.png",
                               "/User/manny/projects/doc-detective/static/images/image.png",
+                              "https://example.com/static/images/image.png",
+                              {
+                                "path": "https://promptless-customer-doc-assets.s3.amazonaws.com/docs-images/request-changes-button-0c851bb3.png",
+                                "maxVariation": 0.05,
+                                "overwrite": "aboveVariation"
+                              },
                               {
                                 "path": "image.png",
                                 "directory": "static/images",