doc-detective-common 4.0.2 → 4.1.0

package/dist/index.cjs

@@ -77,6 +77,14 @@ var schemas_default = {
               "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: [
@@ -101,6 +109,26 @@ var schemas_default = {
               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"
+              }
+            ]
           }
         }
       }
@@ -140,6 +168,14 @@ var schemas_default = {
                 "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: [
@@ -164,6 +200,26 @@ var schemas_default = {
                 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"
+                }
+              ]
             }
           }
         }
@@ -182,6 +238,13 @@ var schemas_default = {
         statusCodes: [
           200
         ]
+      },
+      {
+        url: "/health",
+        origin: "https://my-app.com",
+        params: {
+          __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+        }
       }
     ]
   },
@@ -488,6 +551,18 @@ var schemas_default = {
         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",
@@ -515,6 +590,14 @@ var schemas_default = {
         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 \u2014 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: [
@@ -1529,6 +1612,14 @@ var schemas_default = {
                                                             "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: [
@@ -1553,6 +1644,26 @@ var schemas_default = {
                                                             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"
+                                                            }
+                                                          ]
                                                         }
                                                       }
                                                     }
@@ -1592,6 +1703,14 @@ var schemas_default = {
                                                               "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: [
@@ -1616,6 +1735,26 @@ var schemas_default = {
                                                               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"
+                                                              }
+                                                            ]
                                                           }
                                                         }
                                                       }
@@ -1634,6 +1773,13 @@ var schemas_default = {
                                                       statusCodes: [
                                                         200
                                                       ]
+                                                    },
+                                                    {
+                                                      url: "/health",
+                                                      origin: "https://my-app.com",
+                                                      params: {
+                                                        __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                                      }
                                                     }
                                                   ]
                                                 }
@@ -3574,6 +3720,14 @@ var schemas_default = {
                                                             "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.",
@@ -3746,6 +3900,14 @@ var schemas_default = {
                                                               "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.",
@@ -3895,6 +4057,13 @@ var schemas_default = {
                                                       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: {
@@ -6160,9 +6329,9 @@ var schemas_default = {
                                                   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"
                                                       ]
@@ -6173,9 +6342,9 @@ var schemas_default = {
                                                       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"
                                                           ]
@@ -6406,9 +6575,9 @@ var schemas_default = {
                                                     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"
                                                         ]
@@ -6419,9 +6588,9 @@ var schemas_default = {
                                                         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"
                                                             ]
@@ -6803,6 +6972,12 @@ var schemas_default = {
                                                     "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",
@@ -10152,6 +10327,14 @@ var schemas_default = {
                                               "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: [
@@ -10176,6 +10359,26 @@ var schemas_default = {
                                               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"
+                                              }
+                                            ]
                                           }
                                         }
                                       }
@@ -10215,6 +10418,14 @@ var schemas_default = {
                                                 "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: [
@@ -10239,6 +10450,26 @@ var schemas_default = {
                                                 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"
+                                                }
+                                              ]
                                             }
                                           }
                                         }
@@ -10257,6 +10488,13 @@ var schemas_default = {
                                         statusCodes: [
                                           200
                                         ]
+                                      },
+                                      {
+                                        url: "/health",
+                                        origin: "https://my-app.com",
+                                        params: {
+                                          __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                        }
                                       }
                                     ]
                                   }
@@ -12197,6 +12435,14 @@ var schemas_default = {
                                               "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.",
@@ -12369,6 +12615,14 @@ var schemas_default = {
                                                 "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.",
@@ -12518,6 +12772,13 @@ var schemas_default = {
                                         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: {
@@ -14783,9 +15044,9 @@ var schemas_default = {
                                     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"
                                         ]
@@ -14796,9 +15057,9 @@ var schemas_default = {
                                         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"
                                             ]
@@ -15029,9 +15290,9 @@ var schemas_default = {
                                       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"
                                           ]
@@ -15042,9 +15303,9 @@ var schemas_default = {
                                           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"
                                               ]
@@ -15426,6 +15687,12 @@ var schemas_default = {
                                       "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",
@@ -17839,8 +18106,19 @@ var schemas_default = {
         loadVariables: ".env",
         fileTypes: [
           "markdown"
+        ],
+        reporters: [
+          "terminal",
+          "json",
+          "html"
         ]
       },
+      {
+        origin: "https://my-app.com",
+        originParams: {
+          __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+        }
+      },
       {
         fileTypes: [
           {
@@ -20206,6 +20484,14 @@ var schemas_default = {
               "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.",
@@ -20378,6 +20664,14 @@ var schemas_default = {
                 "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.",
@@ -20527,6 +20821,13 @@ var schemas_default = {
         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: {
@@ -22147,6 +22448,18 @@ var schemas_default = {
             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",
@@ -22174,6 +22487,14 @@ var schemas_default = {
             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 \u2014 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: [
@@ -23188,6 +23509,14 @@ var schemas_default = {
                                                                 "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: [
@@ -23212,6 +23541,26 @@ var schemas_default = {
                                                                 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"
+                                                                }
+                                                              ]
                                                             }
                                                           }
                                                         }
@@ -23251,6 +23600,14 @@ var schemas_default = {
                                                                   "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: [
@@ -23275,6 +23632,26 @@ var schemas_default = {
                                                                   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"
+                                                                  }
+                                                                ]
                                                               }
                                                             }
                                                           }
@@ -23293,6 +23670,13 @@ var schemas_default = {
                                                           statusCodes: [
                                                             200
                                                           ]
+                                                        },
+                                                        {
+                                                          url: "/health",
+                                                          origin: "https://my-app.com",
+                                                          params: {
+                                                            __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                                          }
                                                         }
                                                       ]
                                                     }
@@ -25233,6 +25617,14 @@ var schemas_default = {
                                                                 "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.",
@@ -25405,6 +25797,14 @@ var schemas_default = {
                                                                   "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.",
@@ -25554,6 +25954,13 @@ var schemas_default = {
                                                           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: {
@@ -27819,9 +28226,9 @@ var schemas_default = {
                                                       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"
                                                           ]
@@ -27832,9 +28239,9 @@ var schemas_default = {
                                                           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"
                                                               ]
@@ -28065,9 +28472,9 @@ var schemas_default = {
                                                         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"
                                                             ]
@@ -28078,9 +28485,9 @@ var schemas_default = {
                                                             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"
                                                                 ]
@@ -28462,6 +28869,12 @@ var schemas_default = {
                                                         "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",
@@ -31811,6 +32224,14 @@ var schemas_default = {
                                                   "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: [
@@ -31835,6 +32256,26 @@ var schemas_default = {
                                                   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"
+                                                  }
+                                                ]
                                               }
                                             }
                                           }
@@ -31874,6 +32315,14 @@ var schemas_default = {
                                                     "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: [
@@ -31898,6 +32347,26 @@ var schemas_default = {
                                                     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"
+                                                    }
+                                                  ]
                                                 }
                                               }
                                             }
@@ -31916,6 +32385,13 @@ var schemas_default = {
                                             statusCodes: [
                                               200
                                             ]
+                                          },
+                                          {
+                                            url: "/health",
+                                            origin: "https://my-app.com",
+                                            params: {
+                                              __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                            }
                                           }
                                         ]
                                       }
@@ -33856,6 +34332,14 @@ var schemas_default = {
                                                   "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.",
@@ -34028,6 +34512,14 @@ var schemas_default = {
                                                     "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.",
@@ -34177,6 +34669,13 @@ var schemas_default = {
                                             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: {
@@ -36442,9 +36941,9 @@ var schemas_default = {
                                         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"
                                             ]
@@ -36455,9 +36954,9 @@ var schemas_default = {
                                             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"
                                                 ]
@@ -36688,9 +37187,9 @@ var schemas_default = {
                                           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"
                                               ]
@@ -36701,9 +37200,9 @@ var schemas_default = {
                                               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"
                                                   ]
@@ -37085,6 +37584,12 @@ var schemas_default = {
                                           "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",
@@ -39498,8 +40003,19 @@ var schemas_default = {
             loadVariables: ".env",
             fileTypes: [
               "markdown"
+            ],
+            reporters: [
+              "terminal",
+              "json",
+              "html"
             ]
           },
+          {
+            origin: "https://my-app.com",
+            originParams: {
+              __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+            }
+          },
           {
             fileTypes: [
               {
@@ -41123,6 +41639,14 @@ var schemas_default = {
                                                     "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: [
@@ -41147,6 +41671,26 @@ var schemas_default = {
                                                     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"
+                                                    }
+                                                  ]
                                                 }
                                               }
                                             }
@@ -41186,6 +41730,14 @@ var schemas_default = {
                                                       "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: [
@@ -41210,6 +41762,26 @@ var schemas_default = {
                                                       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"
+                                                      }
+                                                    ]
                                                   }
                                                 }
                                               }
@@ -41228,6 +41800,13 @@ var schemas_default = {
                                               statusCodes: [
                                                 200
                                               ]
+                                            },
+                                            {
+                                              url: "/health",
+                                              origin: "https://my-app.com",
+                                              params: {
+                                                __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                              }
                                             }
                                           ]
                                         }
@@ -43168,6 +43747,14 @@ var schemas_default = {
                                                     "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.",
@@ -43340,6 +43927,14 @@ var schemas_default = {
                                                       "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.",
@@ -43489,6 +44084,13 @@ var schemas_default = {
                                               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: {
@@ -45754,9 +46356,9 @@ var schemas_default = {
                                           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"
                                               ]
@@ -45767,9 +46369,9 @@ var schemas_default = {
                                               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"
                                                   ]
@@ -46000,9 +46602,9 @@ var schemas_default = {
                                             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"
                                                 ]
@@ -46013,9 +46615,9 @@ var schemas_default = {
                                                 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"
                                                     ]
@@ -46397,6 +46999,12 @@ var schemas_default = {
                                             "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",
@@ -49220,6 +49828,14 @@ var schemas_default = {
                                                           "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: [
@@ -49244,6 +49860,26 @@ var schemas_default = {
                                                           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"
+                                                          }
+                                                        ]
                                                       }
                                                     }
                                                   }
@@ -49283,6 +49919,14 @@ var schemas_default = {
                                                             "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: [
@@ -49307,6 +49951,26 @@ var schemas_default = {
                                                             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"
+                                                            }
+                                                          ]
                                                         }
                                                       }
                                                     }
@@ -49325,6 +49989,13 @@ var schemas_default = {
                                                     statusCodes: [
                                                       200
                                                     ]
+                                                  },
+                                                  {
+                                                    url: "/health",
+                                                    origin: "https://my-app.com",
+                                                    params: {
+                                                      __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                                    }
                                                   }
                                                 ]
                                               }
@@ -51265,6 +51936,14 @@ var schemas_default = {
                                                           "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.",
@@ -51437,6 +52116,14 @@ var schemas_default = {
                                                             "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.",
@@ -51586,6 +52273,13 @@ var schemas_default = {
                                                     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: {
@@ -53851,9 +54545,9 @@ var schemas_default = {
                                                 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"
                                                     ]
@@ -53864,9 +54558,9 @@ var schemas_default = {
                                                     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"
                                                         ]
@@ -54097,9 +54791,9 @@ var schemas_default = {
                                                   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"
                                                       ]
@@ -54110,9 +54804,9 @@ var schemas_default = {
                                                       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"
                                                           ]
@@ -54494,6 +55188,12 @@ var schemas_default = {
                                                   "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",
@@ -59027,6 +59727,14 @@ var schemas_default = {
                                                     "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: [
@@ -59051,6 +59759,26 @@ var schemas_default = {
                                                     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"
+                                                    }
+                                                  ]
                                                 }
                                               }
                                             }
@@ -59090,6 +59818,14 @@ var schemas_default = {
                                                       "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: [
@@ -59114,6 +59850,26 @@ var schemas_default = {
                                                       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"
+                                                      }
+                                                    ]
                                                   }
                                                 }
                                               }
@@ -59132,6 +59888,13 @@ var schemas_default = {
                                               statusCodes: [
                                                 200
                                               ]
+                                            },
+                                            {
+                                              url: "/health",
+                                              origin: "https://my-app.com",
+                                              params: {
+                                                __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                              }
                                             }
                                           ]
                                         }
@@ -61072,6 +61835,14 @@ var schemas_default = {
                                                     "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.",
@@ -61244,6 +62015,14 @@ var schemas_default = {
                                                       "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.",
@@ -61393,6 +62172,13 @@ var schemas_default = {
                                               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: {
@@ -63658,9 +64444,9 @@ var schemas_default = {
                                           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"
                                               ]
@@ -63671,9 +64457,9 @@ var schemas_default = {
                                               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"
                                                   ]
@@ -63904,9 +64690,9 @@ var schemas_default = {
                                             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"
                                                 ]
@@ -63917,9 +64703,9 @@ var schemas_default = {
                                                 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"
                                                     ]
@@ -64301,6 +65087,12 @@ var schemas_default = {
                                             "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",
@@ -67124,6 +67916,14 @@ var schemas_default = {
                                                           "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: [
@@ -67148,6 +67948,26 @@ var schemas_default = {
                                                           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"
+                                                          }
+                                                        ]
                                                       }
                                                     }
                                                   }
@@ -67187,6 +68007,14 @@ var schemas_default = {
                                                             "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: [
@@ -67211,6 +68039,26 @@ var schemas_default = {
                                                             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"
+                                                            }
+                                                          ]
                                                         }
                                                       }
                                                     }
@@ -67229,6 +68077,13 @@ var schemas_default = {
                                                     statusCodes: [
                                                       200
                                                     ]
+                                                  },
+                                                  {
+                                                    url: "/health",
+                                                    origin: "https://my-app.com",
+                                                    params: {
+                                                      __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                                    }
                                                   }
                                                 ]
                                               }
@@ -69169,6 +70024,14 @@ var schemas_default = {
                                                           "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.",
@@ -69341,6 +70204,14 @@ var schemas_default = {
                                                             "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.",
@@ -69490,6 +70361,13 @@ var schemas_default = {
                                                     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: {
@@ -71755,9 +72633,9 @@ var schemas_default = {
                                                 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"
                                                     ]
@@ -71768,9 +72646,9 @@ var schemas_default = {
                                                     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"
                                                         ]
@@ -72001,9 +72879,9 @@ var schemas_default = {
                                                   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"
                                                       ]
@@ -72014,9 +72892,9 @@ var schemas_default = {
                                                       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"
                                                           ]
@@ -72398,6 +73276,12 @@ var schemas_default = {
                                                   "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",
@@ -76082,9 +76966,9 @@ var schemas_default = {
     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"
         ]
@@ -76095,9 +76979,9 @@ var schemas_default = {
         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"
             ]
@@ -76328,9 +77212,9 @@ var schemas_default = {
       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"
           ]
@@ -76341,9 +77225,9 @@ var schemas_default = {
           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"
               ]
@@ -76725,6 +77609,12 @@ var schemas_default = {
       "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",
@@ -78313,6 +79203,14 @@ var schemas_default = {
                                           "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: [
@@ -78337,6 +79235,26 @@ var schemas_default = {
                                           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"
+                                          }
+                                        ]
                                       }
                                     }
                                   }
@@ -78376,6 +79294,14 @@ var schemas_default = {
                                             "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: [
@@ -78400,6 +79326,26 @@ var schemas_default = {
                                             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"
+                                            }
+                                          ]
                                         }
                                       }
                                     }
@@ -78418,6 +79364,13 @@ var schemas_default = {
                                     statusCodes: [
                                       200
                                     ]
+                                  },
+                                  {
+                                    url: "/health",
+                                    origin: "https://my-app.com",
+                                    params: {
+                                      __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                    }
                                   }
                                 ]
                               }
@@ -80358,6 +81311,14 @@ var schemas_default = {
                                           "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.",
@@ -80530,6 +81491,14 @@ var schemas_default = {
                                             "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.",
@@ -80679,6 +81648,13 @@ var schemas_default = {
                                     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: {
@@ -82944,9 +83920,9 @@ var schemas_default = {
                                 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"
                                     ]
@@ -82957,9 +83933,9 @@ var schemas_default = {
                                     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"
                                         ]
@@ -83190,9 +84166,9 @@ var schemas_default = {
                                   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"
                                       ]
@@ -83203,9 +84179,9 @@ var schemas_default = {
                                       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"
                                           ]
@@ -83587,6 +84563,12 @@ var schemas_default = {
                                   "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",
@@ -86410,6 +87392,14 @@ var schemas_default = {
                                                 "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: [
@@ -86434,6 +87424,26 @@ var schemas_default = {
                                                 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"
+                                                }
+                                              ]
                                             }
                                           }
                                         }
@@ -86473,6 +87483,14 @@ var schemas_default = {
                                                   "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: [
@@ -86497,6 +87515,26 @@ var schemas_default = {
                                                   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"
+                                                  }
+                                                ]
                                               }
                                             }
                                           }
@@ -86515,6 +87553,13 @@ var schemas_default = {
                                           statusCodes: [
                                             200
                                           ]
+                                        },
+                                        {
+                                          url: "/health",
+                                          origin: "https://my-app.com",
+                                          params: {
+                                            __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                          }
                                         }
                                       ]
                                     }
@@ -88455,6 +89500,14 @@ var schemas_default = {
                                                 "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.",
@@ -88627,6 +89680,14 @@ var schemas_default = {
                                                   "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.",
@@ -88776,6 +89837,13 @@ var schemas_default = {
                                           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: {
@@ -91041,9 +92109,9 @@ var schemas_default = {
                                       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"
                                           ]
@@ -91054,9 +92122,9 @@ var schemas_default = {
                                           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"
                                               ]
@@ -91287,9 +92355,9 @@ var schemas_default = {
                                         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"
                                             ]
@@ -91300,9 +92368,9 @@ var schemas_default = {
                                             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"
                                                 ]
@@ -91684,6 +92752,12 @@ var schemas_default = {
                                         "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",
@@ -94787,6 +95861,14 @@ var schemas_default = {
                           "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: [
@@ -94811,6 +95893,26 @@ var schemas_default = {
                           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"
+                          }
+                        ]
                       }
                     }
                   }
@@ -94850,6 +95952,14 @@ var schemas_default = {
                             "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: [
@@ -94874,6 +95984,26 @@ var schemas_default = {
                             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"
+                            }
+                          ]
                         }
                       }
                     }
@@ -94892,6 +96022,13 @@ var schemas_default = {
                     statusCodes: [
                       200
                     ]
+                  },
+                  {
+                    url: "/health",
+                    origin: "https://my-app.com",
+                    params: {
+                      __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                    }
                   }
                 ]
               }
@@ -96832,6 +97969,14 @@ var schemas_default = {
                           "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.",
@@ -97004,6 +98149,14 @@ var schemas_default = {
                             "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.",
@@ -97153,6 +98306,13 @@ var schemas_default = {
                     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: {
@@ -99418,9 +100578,9 @@ var schemas_default = {
                 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"
                     ]
@@ -99431,9 +100591,9 @@ var schemas_default = {
                     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"
                         ]
@@ -99664,9 +100824,9 @@ var schemas_default = {
                   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"
                       ]
@@ -99677,9 +100837,9 @@ var schemas_default = {
                       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"
                           ]
@@ -100061,6 +101221,12 @@ var schemas_default = {
                   "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",
@@ -103237,6 +104403,14 @@ var schemas_default = {
                                 "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: [
@@ -103261,6 +104435,26 @@ var schemas_default = {
                                 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"
+                                }
+                              ]
                             }
                           }
                         }
@@ -103300,6 +104494,14 @@ var schemas_default = {
                                   "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: [
@@ -103324,6 +104526,26 @@ var schemas_default = {
                                   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"
+                                  }
+                                ]
                               }
                             }
                           }
@@ -103342,6 +104564,13 @@ var schemas_default = {
                           statusCodes: [
                             200
                           ]
+                        },
+                        {
+                          url: "/health",
+                          origin: "https://my-app.com",
+                          params: {
+                            __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                          }
                         }
                       ]
                     }
@@ -105282,6 +106511,14 @@ var schemas_default = {
                                 "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.",
@@ -105454,6 +106691,14 @@ var schemas_default = {
                                   "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.",
@@ -105603,6 +106848,13 @@ var schemas_default = {
                           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: {
@@ -107868,9 +109120,9 @@ var schemas_default = {
                       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"
                           ]
@@ -107881,9 +109133,9 @@ var schemas_default = {
                           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"
                               ]
@@ -108114,9 +109366,9 @@ var schemas_default = {
                         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"
                             ]
@@ -108127,9 +109379,9 @@ var schemas_default = {
                             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"
                                 ]
@@ -108511,6 +109763,12 @@ var schemas_default = {
                         "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",
@@ -111334,6 +112592,14 @@ var schemas_default = {
                                       "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: [
@@ -111358,6 +112624,26 @@ var schemas_default = {
                                       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"
+                                      }
+                                    ]
                                   }
                                 }
                               }
@@ -111397,6 +112683,14 @@ var schemas_default = {
                                         "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: [
@@ -111421,6 +112715,26 @@ var schemas_default = {
                                         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"
+                                        }
+                                      ]
                                     }
                                   }
                                 }
@@ -111439,6 +112753,13 @@ var schemas_default = {
                                 statusCodes: [
                                   200
                                 ]
+                              },
+                              {
+                                url: "/health",
+                                origin: "https://my-app.com",
+                                params: {
+                                  __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                }
                               }
                             ]
                           }
@@ -113379,6 +114700,14 @@ var schemas_default = {
                                       "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.",
@@ -113551,6 +114880,14 @@ var schemas_default = {
                                         "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.",
@@ -113700,6 +115037,13 @@ var schemas_default = {
                                 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: {
@@ -115965,9 +117309,9 @@ var schemas_default = {
                             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"
                                 ]
@@ -115978,9 +117322,9 @@ var schemas_default = {
                                 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"
                                     ]
@@ -116211,9 +117555,9 @@ var schemas_default = {
                               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"
                                   ]
@@ -116224,9 +117568,9 @@ var schemas_default = {
                                   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"
                                       ]
@@ -116608,6 +117952,12 @@ var schemas_default = {
                               "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",
@@ -128637,11 +129987,17 @@ var defaultFileTypesBase = {
     inlineStatements: {
       testStart: [
         "<\\?doc-detective\\s+test([\\s\\S]*?)\\?>",
-        "<!--\\s*test([\\s\\S]+?)-->"
+        "<!--\\s*test([\\s\\S]+?)-->",
+        `<data\\s+[^>]*?name=["']doc-detective["'][^>]*?value='test\\s+([^']+?)'[^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`,
+        `<data\\s+[^>]*?name=["']doc-detective["'][^>]*?value="test\\s+([^"]+?)"[^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`,
+        `<data\\s+[^>]*?value='test\\s+([^']+?)'[^>]*?name=["']doc-detective["'][^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`,
+        `<data\\s+[^>]*?value="test\\s+([^"]+?)"[^>]*?name=["']doc-detective["'][^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`
       ],
       testEnd: [
         "<\\?doc-detective\\s+test\\s+end\\s*\\?>",
-        "<!--\\s*test end([\\s\\S]+?)-->"
+        "<!--\\s*test end([\\s\\S]+?)-->",
+        `<data\\s+[^>]*?name=["']doc-detective["'][^>]*?value=["']test end["'][^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`,
+        `<data\\s+[^>]*?value=["']test end["'][^>]*?name=["']doc-detective["'][^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`
       ],
       ignoreStart: [
         "<\\?doc-detective\\s+test\\s+ignore\\s+start\\s*\\?>",
@@ -128654,7 +130010,11 @@ var defaultFileTypesBase = {
       step: [
         "<\\?doc-detective\\s+step\\s+([\\s\\S]*?)\\s*\\?>",
         "<!--\\s*step([\\s\\S]+?)-->",
-        '<data\\s+name="step"\\s*>([\\s\\S]*?)<\\/data>'
+        '<data\\s+name="step"\\s*>([\\s\\S]*?)<\\/data>',
+        `<data\\s+[^>]*?name=["']doc-detective["'][^>]*?value='step\\s+([^']+?)'[^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`,
+        `<data\\s+[^>]*?name=["']doc-detective["'][^>]*?value="step\\s+([^"]+?)"[^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`,
+        `<data\\s+[^>]*?value='step\\s+([^']+?)'[^>]*?name=["']doc-detective["'][^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`,
+        `<data\\s+[^>]*?value="step\\s+([^"]+?)"[^>]*?name=["']doc-detective["'][^>]*?(?:\\/\\s*>|>\\s*<\\/data>)`
       ]
     },
     markup: [
@@ -129007,6 +130367,9 @@ function parseXmlAttributes({ stringifiedObject }) {
 }
 function parseObject({ stringifiedObject }) {
   if (typeof stringifiedObject === "string") {
+    if (/&(?:#\d+|#x[0-9a-fA-F]+|amp|lt|gt|quot|apos);/.test(stringifiedObject)) {
+      stringifiedObject = stringifiedObject.replace(/&#39;|&apos;/g, "'").replace(/&#34;|&quot;/g, '"').replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+    }
     const xmlAttrs = parseXmlAttributes({ stringifiedObject });
     if (xmlAttrs !== null) {
       return xmlAttrs;
@@ -129266,17 +130629,7 @@ async function parseContent({ config = {}, content, filePath = "", fileType }) {
               if (step.screenshot && config._herettoPathMapping) {
                 const herettoIntegration = findHerettoIntegration(config, filePath);
                 if (herettoIntegration) {
-                  if (typeof step.screenshot === "string") {
-                    step.screenshot = { path: step.screenshot };
-                  } else if (typeof step.screenshot === "boolean") {
-                    step.screenshot = {};
-                  }
-                  step.screenshot.sourceIntegration = {
-                    type: "heretto",
-                    integrationName: herettoIntegration,
-                    filePath: step.screenshot.path || "",
-                    contentPath: filePath
-                  };
+                  attachHerettoScreenshotSourceIntegration(step, herettoIntegration, filePath);
                 }
               }
             }
@@ -129342,6 +130695,12 @@ async function parseContent({ config = {}, content, filePath = "", fileType }) {
             endIndex: statement._endIndex
           };
         }
+        if (step.screenshot && config._herettoPathMapping) {
+          const herettoIntegration = findHerettoIntegration(config, filePath);
+          if (herettoIntegration) {
+            attachHerettoScreenshotSourceIntegration(step, herettoIntegration, filePath);
+          }
+        }
         const validation = validate({
           schemaKey: "step_v3",
           object: step,
@@ -129380,6 +130739,19 @@ async function parseContent({ config = {}, content, filePath = "", fileType }) {
   });
   return validatedTests;
 }
+function attachHerettoScreenshotSourceIntegration(step, integrationName, contentPath) {
+  if (typeof step.screenshot === "string") {
+    step.screenshot = { path: step.screenshot };
+  } else if (step.screenshot === null || typeof step.screenshot !== "object" || Array.isArray(step.screenshot)) {
+    step.screenshot = {};
+  }
+  step.screenshot.sourceIntegration = {
+    type: "heretto",
+    integrationName,
+    filePath: step.screenshot.path || "",
+    contentPath
+  };
+}
 function findHerettoIntegration(config, filePath) {
   if (!config._herettoPathMapping)
     return null;