doc-detective 4.0.2-dev.9 → 4.1.0

package/dist/index.cjs

@@ -83,6 +83,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: [
@@ -166,6 +174,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: [
@@ -228,6 +244,13 @@ var schemas_default = {
         statusCodes: [
           200
         ]
+      },
+      {
+        url: "/health",
+        origin: "https://my-app.com",
+        params: {
+          __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+        }
       }
     ]
   },
@@ -573,6 +596,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: [
@@ -1587,6 +1618,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: [
@@ -1670,6 +1709,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: [
@@ -1732,6 +1779,13 @@ var schemas_default = {
                                                       statusCodes: [
                                                         200
                                                       ]
+                                                    },
+                                                    {
+                                                      url: "/health",
+                                                      origin: "https://my-app.com",
+                                                      params: {
+                                                        __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                                      }
                                                     }
                                                   ]
                                                 }
@@ -3672,6 +3726,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.",
@@ -3844,6 +3906,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.",
@@ -3993,6 +4063,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: {
@@ -6258,9 +6335,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"
                                                       ]
@@ -6271,9 +6348,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"
                                                           ]
@@ -6504,9 +6581,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"
                                                         ]
@@ -6517,9 +6594,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"
                                                             ]
@@ -6901,6 +6978,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",
@@ -10250,6 +10333,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: [
@@ -10333,6 +10424,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: [
@@ -10395,6 +10494,13 @@ var schemas_default = {
                                         statusCodes: [
                                           200
                                         ]
+                                      },
+                                      {
+                                        url: "/health",
+                                        origin: "https://my-app.com",
+                                        params: {
+                                          __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                        }
                                       }
                                     ]
                                   }
@@ -12335,6 +12441,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.",
@@ -12507,6 +12621,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.",
@@ -12656,6 +12778,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: {
@@ -14921,9 +15050,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"
                                         ]
@@ -14934,9 +15063,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"
                                             ]
@@ -15167,9 +15296,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"
                                           ]
@@ -15180,9 +15309,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"
                                               ]
@@ -15564,6 +15693,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",
@@ -17984,6 +18119,12 @@ var schemas_default = {
           "html"
         ]
       },
+      {
+        origin: "https://my-app.com",
+        originParams: {
+          __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+        }
+      },
       {
         fileTypes: [
           {
@@ -20349,6 +20490,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.",
@@ -20521,6 +20670,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.",
@@ -20670,6 +20827,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: {
@@ -22329,6 +22493,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: [
@@ -23343,6 +23515,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: [
@@ -23426,6 +23606,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: [
@@ -23488,6 +23676,13 @@ var schemas_default = {
                                                           statusCodes: [
                                                             200
                                                           ]
+                                                        },
+                                                        {
+                                                          url: "/health",
+                                                          origin: "https://my-app.com",
+                                                          params: {
+                                                            __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                                          }
                                                         }
                                                       ]
                                                     }
@@ -25428,6 +25623,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.",
@@ -25600,6 +25803,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.",
@@ -25749,6 +25960,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: {
@@ -28014,9 +28232,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"
                                                           ]
@@ -28027,9 +28245,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"
                                                               ]
@@ -28260,9 +28478,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"
                                                             ]
@@ -28273,9 +28491,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"
                                                                 ]
@@ -28657,6 +28875,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",
@@ -32006,6 +32230,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: [
@@ -32089,6 +32321,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: [
@@ -32151,6 +32391,13 @@ var schemas_default = {
                                             statusCodes: [
                                               200
                                             ]
+                                          },
+                                          {
+                                            url: "/health",
+                                            origin: "https://my-app.com",
+                                            params: {
+                                              __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                            }
                                           }
                                         ]
                                       }
@@ -34091,6 +34338,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.",
@@ -34263,6 +34518,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.",
@@ -34412,6 +34675,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: {
@@ -36677,9 +36947,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"
                                             ]
@@ -36690,9 +36960,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"
                                                 ]
@@ -36923,9 +37193,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"
                                               ]
@@ -36936,9 +37206,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"
                                                   ]
@@ -37320,6 +37590,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",
@@ -39740,6 +40016,12 @@ var schemas_default = {
               "html"
             ]
           },
+          {
+            origin: "https://my-app.com",
+            originParams: {
+              __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+            }
+          },
           {
             fileTypes: [
               {
@@ -41363,6 +41645,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: [
@@ -41446,6 +41736,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: [
@@ -41508,6 +41806,13 @@ var schemas_default = {
                                               statusCodes: [
                                                 200
                                               ]
+                                            },
+                                            {
+                                              url: "/health",
+                                              origin: "https://my-app.com",
+                                              params: {
+                                                __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                              }
                                             }
                                           ]
                                         }
@@ -43448,6 +43753,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.",
@@ -43620,6 +43933,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.",
@@ -43769,6 +44090,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: {
@@ -46034,9 +46362,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"
                                               ]
@@ -46047,9 +46375,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"
                                                   ]
@@ -46280,9 +46608,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"
                                                 ]
@@ -46293,9 +46621,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"
                                                     ]
@@ -46677,6 +47005,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",
@@ -49500,6 +49834,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: [
@@ -49583,6 +49925,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: [
@@ -49645,6 +49995,13 @@ var schemas_default = {
                                                     statusCodes: [
                                                       200
                                                     ]
+                                                  },
+                                                  {
+                                                    url: "/health",
+                                                    origin: "https://my-app.com",
+                                                    params: {
+                                                      __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                                    }
                                                   }
                                                 ]
                                               }
@@ -51585,6 +51942,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.",
@@ -51757,6 +52122,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.",
@@ -51906,6 +52279,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: {
@@ -54171,9 +54551,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"
                                                     ]
@@ -54184,9 +54564,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"
                                                         ]
@@ -54417,9 +54797,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"
                                                       ]
@@ -54430,9 +54810,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"
                                                           ]
@@ -54814,6 +55194,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",
@@ -59347,6 +59733,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: [
@@ -59430,6 +59824,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: [
@@ -59492,6 +59894,13 @@ var schemas_default = {
                                               statusCodes: [
                                                 200
                                               ]
+                                            },
+                                            {
+                                              url: "/health",
+                                              origin: "https://my-app.com",
+                                              params: {
+                                                __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                              }
                                             }
                                           ]
                                         }
@@ -61432,6 +61841,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.",
@@ -61604,6 +62021,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.",
@@ -61753,6 +62178,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: {
@@ -64018,9 +64450,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"
                                               ]
@@ -64031,9 +64463,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"
                                                   ]
@@ -64264,9 +64696,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"
                                                 ]
@@ -64277,9 +64709,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"
                                                     ]
@@ -64661,6 +65093,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",
@@ -67484,6 +67922,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: [
@@ -67567,6 +68013,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: [
@@ -67629,6 +68083,13 @@ var schemas_default = {
                                                     statusCodes: [
                                                       200
                                                     ]
+                                                  },
+                                                  {
+                                                    url: "/health",
+                                                    origin: "https://my-app.com",
+                                                    params: {
+                                                      __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                                    }
                                                   }
                                                 ]
                                               }
@@ -69569,6 +70030,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.",
@@ -69741,6 +70210,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.",
@@ -69890,6 +70367,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: {
@@ -72155,9 +72639,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"
                                                     ]
@@ -72168,9 +72652,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"
                                                         ]
@@ -72401,9 +72885,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"
                                                       ]
@@ -72414,9 +72898,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"
                                                           ]
@@ -72798,6 +73282,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",
@@ -76482,9 +76972,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"
         ]
@@ -76495,9 +76985,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"
             ]
@@ -76728,9 +77218,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"
           ]
@@ -76741,9 +77231,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"
               ]
@@ -77125,6 +77615,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",
@@ -78713,6 +79209,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: [
@@ -78796,6 +79300,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: [
@@ -78858,6 +79370,13 @@ var schemas_default = {
                                     statusCodes: [
                                       200
                                     ]
+                                  },
+                                  {
+                                    url: "/health",
+                                    origin: "https://my-app.com",
+                                    params: {
+                                      __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                    }
                                   }
                                 ]
                               }
@@ -80798,6 +81317,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.",
@@ -80970,6 +81497,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.",
@@ -81119,6 +81654,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: {
@@ -83384,9 +83926,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"
                                     ]
@@ -83397,9 +83939,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"
                                         ]
@@ -83630,9 +84172,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"
                                       ]
@@ -83643,9 +84185,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"
                                           ]
@@ -84027,6 +84569,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",
@@ -86850,6 +87398,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: [
@@ -86933,6 +87489,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: [
@@ -86995,6 +87559,13 @@ var schemas_default = {
                                           statusCodes: [
                                             200
                                           ]
+                                        },
+                                        {
+                                          url: "/health",
+                                          origin: "https://my-app.com",
+                                          params: {
+                                            __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                          }
                                         }
                                       ]
                                     }
@@ -88935,6 +89506,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.",
@@ -89107,6 +89686,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.",
@@ -89256,6 +89843,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: {
@@ -91521,9 +92115,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"
                                           ]
@@ -91534,9 +92128,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"
                                               ]
@@ -91767,9 +92361,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"
                                             ]
@@ -91780,9 +92374,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"
                                                 ]
@@ -92164,6 +92758,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",
@@ -95267,6 +95867,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: [
@@ -95350,6 +95958,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: [
@@ -95412,6 +96028,13 @@ var schemas_default = {
                     statusCodes: [
                       200
                     ]
+                  },
+                  {
+                    url: "/health",
+                    origin: "https://my-app.com",
+                    params: {
+                      __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                    }
                   }
                 ]
               }
@@ -97352,6 +97975,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.",
@@ -97524,6 +98155,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.",
@@ -97673,6 +98312,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: {
@@ -99938,9 +100584,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"
                     ]
@@ -99951,9 +100597,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"
                         ]
@@ -100184,9 +100830,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"
                       ]
@@ -100197,9 +100843,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"
                           ]
@@ -100581,6 +101227,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",
@@ -103757,6 +104409,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: [
@@ -103840,6 +104500,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: [
@@ -103902,6 +104570,13 @@ var schemas_default = {
                           statusCodes: [
                             200
                           ]
+                        },
+                        {
+                          url: "/health",
+                          origin: "https://my-app.com",
+                          params: {
+                            __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                          }
                         }
                       ]
                     }
@@ -105842,6 +106517,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.",
@@ -106014,6 +106697,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.",
@@ -106163,6 +106854,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: {
@@ -108428,9 +109126,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"
                           ]
@@ -108441,9 +109139,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"
                               ]
@@ -108674,9 +109372,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"
                             ]
@@ -108687,9 +109385,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"
                                 ]
@@ -109071,6 +109769,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",
@@ -111894,6 +112598,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: [
@@ -111977,6 +112689,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: [
@@ -112039,6 +112759,13 @@ var schemas_default = {
                                 statusCodes: [
                                   200
                                 ]
+                              },
+                              {
+                                url: "/health",
+                                origin: "https://my-app.com",
+                                params: {
+                                  __clerk_testing_token: "$CLERK_TESTING_TOKEN"
+                                }
                               }
                             ]
                           }
@@ -113979,6 +114706,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.",
@@ -114151,6 +114886,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.",
@@ -114300,6 +115043,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: {
@@ -116565,9 +117315,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"
                                 ]
@@ -116578,9 +117328,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"
                                     ]
@@ -116811,9 +117561,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"
                                   ]
@@ -116824,9 +117574,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"
                                       ]
@@ -117208,6 +117958,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",
@@ -129219,6 +129975,8 @@ var import_node_fs = __toESM(require("node:fs"), 1);
 var import_node_os = __toESM(require("node:os"), 1);
 var import_node_path = __toESM(require("node:path"), 1);
 var import_node_crypto = __toESM(require("node:crypto"), 1);
+var import_promises = __toESM(require("node:dns/promises"), 1);
+var import_node_net = __toESM(require("node:net"), 1);
 var import_axios = __toESM(require("axios"), 1);
 var import_node_child_process = require("node:child_process");
 function isRelativeUrl(url) {
@@ -129229,6 +129987,36 @@ function isRelativeUrl(url) {
     return true;
   }
 }
+function appendQueryParams(url, params) {
+  if (!params || typeof params !== "object" || Array.isArray(params))
+    return url;
+  const entries = Object.entries(params).filter(([, v]) => v !== void 0 && v !== null);
+  if (entries.length === 0)
+    return url;
+  const hashIdx = url.indexOf("#");
+  const fragment = hashIdx >= 0 ? url.slice(hashIdx) : "";
+  const base = hashIdx >= 0 ? url.slice(0, hashIdx) : url;
+  const queryIdx = base.indexOf("?");
+  const pathAndAuthority = queryIdx >= 0 ? base.slice(0, queryIdx) : base;
+  const existingQuery = queryIdx >= 0 ? base.slice(queryIdx + 1) : "";
+  const newKeys = new Set(entries.map(([k]) => k));
+  const preservedSegments = existingQuery ? existingQuery.split("&").filter((segment) => {
+    if (!segment)
+      return false;
+    const eqIdx = segment.indexOf("=");
+    const rawKey = eqIdx >= 0 ? segment.slice(0, eqIdx) : segment;
+    let decodedKey;
+    try {
+      decodedKey = decodeURIComponent(rawKey);
+    } catch {
+      decodedKey = rawKey;
+    }
+    return !newKeys.has(decodedKey);
+  }) : [];
+  const newPairs = entries.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`);
+  const query = [...preservedSegments, ...newPairs].join("&");
+  return pathAndAuthority + (query ? "?" + query : "") + fragment;
+}
 function cleanTemp() {
   const tempDir = import_node_path.default.join(import_node_os.default.tmpdir(), "doc-detective");
   if (import_node_fs.default.existsSync(tempDir)) {
@@ -129243,23 +130031,146 @@ function cleanTemp() {
     });
   }
 }
-async function fetchFile(fileURL) {
+var FETCH_BINARY_DEFAULTS = {
+  responseType: "arraybuffer",
+  timeout: 3e4,
+  maxContentLength: 50 * 1024 * 1024,
+  maxBodyLength: 50 * 1024 * 1024,
+  maxRedirects: 5
+};
+function sanitizeFilesystemName(name, fallback) {
+  if (!name || name === "." || name === "..")
+    return fallback;
+  const cleaned = name.replace(/[\x00-\x1f<>:"/\\|?*]/g, "_");
+  if (!cleaned || /^\.+$/.test(cleaned))
+    return fallback;
+  return cleaned;
+}
+function safeFilenameFromUrl(fileURL, fallback) {
+  let raw;
+  try {
+    raw = new URL(fileURL).pathname;
+  } catch {
+    raw = fileURL;
+  }
+  raw = raw.split("?")[0].split("#")[0];
+  const base = import_node_path.default.basename(raw.replace(/\\/g, "/"));
+  return sanitizeFilesystemName(base, fallback);
+}
+function redactUrlForOutput(value) {
+  try {
+    const url = new URL(value);
+    url.search = "";
+    url.hash = "";
+    return url.toString();
+  } catch {
+    return value.split("?")[0].split("#")[0];
+  }
+}
+function isPrivateOrLoopbackAddress(ip) {
+  if (!ip)
+    return false;
+  if (import_node_net.default.isIPv4(ip)) {
+    const [a, b] = ip.split(".").map(Number);
+    if (a === 10)
+      return true;
+    if (a === 127)
+      return true;
+    if (a === 0)
+      return true;
+    if (a === 169 && b === 254)
+      return true;
+    if (a === 172 && b >= 16 && b <= 31)
+      return true;
+    if (a === 192 && b === 168)
+      return true;
+    if (a === 100 && b >= 64 && b <= 127)
+      return true;
+    return false;
+  }
+  if (import_node_net.default.isIPv6(ip)) {
+    const normalized = ip.toLowerCase();
+    if (normalized === "::1")
+      return true;
+    if (normalized === "::")
+      return true;
+    if (normalized.startsWith("fc") || normalized.startsWith("fd"))
+      return true;
+    if (normalized.startsWith("fe80:"))
+      return true;
+    if (normalized.startsWith("::ffff:")) {
+      return isPrivateOrLoopbackAddress(normalized.replace("::ffff:", ""));
+    }
+    return false;
+  }
+  return false;
+}
+async function assertUrlHostIsPublic(fileURL) {
+  if (process.env.DOC_DETECTIVE_ALLOW_LOCAL_URLS === "true")
+    return;
+  let parsed;
+  try {
+    parsed = new URL(fileURL);
+  } catch {
+    throw new Error(`Invalid URL: ${redactUrlForOutput(fileURL)}`);
+  }
+  if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+    throw new Error(`Unsupported URL scheme (${parsed.protocol}) for ${redactUrlForOutput(fileURL)}`);
+  }
+  const host = parsed.hostname.replace(/^\[|\]$/g, "");
+  if (import_node_net.default.isIP(host)) {
+    if (isPrivateOrLoopbackAddress(host)) {
+      throw new Error(`Refusing to fetch private/loopback address (${host}). Set DOC_DETECTIVE_ALLOW_LOCAL_URLS=true to allow.`);
+    }
+    return;
+  }
+  const lower = host.toLowerCase();
+  if (lower === "localhost" || lower.endsWith(".localhost")) {
+    throw new Error(`Refusing to fetch localhost (${host}). Set DOC_DETECTIVE_ALLOW_LOCAL_URLS=true to allow.`);
+  }
+  let addresses;
   try {
-    const response = await import_axios.default.get(fileURL);
-    if (typeof response.data === "object") {
-      response.data = JSON.stringify(response.data, null, 2);
+    addresses = await import_promises.default.lookup(host, { all: true });
+  } catch (error) {
+    throw new Error(`Couldn't resolve host ${host} for SSRF check: ${error.message}`);
+  }
+  for (const { address } of addresses) {
+    if (isPrivateOrLoopbackAddress(address)) {
+      throw new Error(`Host ${host} resolves to a private/loopback address (${address}); refusing to fetch. Set DOC_DETECTIVE_ALLOW_LOCAL_URLS=true to allow.`);
+    }
+  }
+}
+async function fetchFile(fileURL, opts = {}) {
+  try {
+    if (opts.binary) {
+      await assertUrlHostIsPublic(fileURL);
+    }
+    const response = await import_axios.default.get(fileURL, opts.binary ? FETCH_BINARY_DEFAULTS : void 0);
+    let data;
+    if (opts.binary) {
+      data = Buffer.from(response.data);
+    } else if (typeof response.data === "object") {
+      data = JSON.stringify(response.data, null, 2);
     } else {
-      response.data = response.data.toString();
+      data = response.data.toString();
     }
-    const fileName = fileURL.split("/").pop() || "fetched_file";
-    const hash = import_node_crypto.default.createHash("md5").update(response.data).digest("hex");
+    const fileName = safeFilenameFromUrl(fileURL, "fetched_file");
+    const hash = import_node_crypto.default.createHash("md5").update(data).digest("hex");
     const ddTempDir = import_node_path.default.join(import_node_os.default.tmpdir(), "doc-detective");
     const filePath = import_node_path.default.join(ddTempDir, `${hash}_${fileName}`);
+    const resolvedDir = import_node_path.default.resolve(ddTempDir);
+    const resolvedFile = import_node_path.default.resolve(filePath);
+    if (!resolvedFile.startsWith(resolvedDir + import_node_path.default.sep)) {
+      return {
+        result: "error",
+        message: new Error(`Refusing to write outside temp dir: ${resolvedFile}`)
+      };
+    }
     if (!import_node_fs.default.existsSync(ddTempDir)) {
       import_node_fs.default.mkdirSync(ddTempDir, { recursive: true });
     }
     if (!import_node_fs.default.existsSync(filePath)) {
-      import_node_fs.default.writeFileSync(filePath, response.data);
+      import_node_fs.default.writeFileSync(filePath, data);
     }
     return { result: "success", path: filePath };
   } catch (error) {
@@ -129336,6 +130247,18 @@ function replaceEnvs(stringOrObject) {
   }
   return stringOrObject;
 }
+function timestamp() {
+  let timestamp2 = /* @__PURE__ */ new Date();
+  return `${timestamp2.getFullYear()}${("0" + (timestamp2.getMonth() + 1)).slice(-2)}${("0" + timestamp2.getDate()).slice(-2)}-${("0" + timestamp2.getHours()).slice(-2)}${("0" + timestamp2.getMinutes()).slice(-2)}${("0" + timestamp2.getSeconds()).slice(-2)}`;
+}
+function getOrInitRunTimestamp(config) {
+  if (!config)
+    return timestamp();
+  if (!config.__runTimestamp) {
+    config.__runTimestamp = timestamp();
+  }
+  return config.__runTimestamp;
+}
 async function spawnCommand(cmd, args = [], options = {}) {
   const spawnOptions = {
     shell: true
@@ -129873,11 +130796,17 @@ var defaultFileTypes = {
     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*\\?>",
@@ -129890,7 +130819,11 @@ var defaultFileTypes = {
       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: [
@@ -130353,11 +131286,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*\\?>",
@@ -130370,7 +131309,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: [
@@ -130723,6 +131666,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;
@@ -130982,17 +131928,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);
                 }
               }
             }
@@ -131058,6 +131994,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,
@@ -131096,6 +132038,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;
@@ -132229,7 +133184,10 @@ async function loadHerettoContent(herettoConfig, log3, config, deps) {
     if (herettoConfig.uploadOnChange) {
       log3(config, "debug", `Fetching resource dependencies for ditamap ${scenario.fileId}...`);
       const resourceDependencies = await getResourceDependenciesFn(restClient, scenario.fileId, log3, config);
-      herettoConfig.resourceDependencies = resourceDependencies;
+      herettoConfig.resourceDependencies = {
+        ...resourceDependencies,
+        ...herettoConfig.resourceDependencies || {}
+      };
     }
     log3(config, "debug", `Triggering publishing job for file ${scenario.fileId}...`);
     const job = await triggerPublishingJob(client, scenario.fileId, scenario.scenarioId);
@@ -133716,7 +134674,8 @@ async function goTo({ config, step, driver }) {
   if (typeof step.goTo === "string") {
     step.goTo = { url: step.goTo };
   }
-  if (isRelativeUrl(step.goTo.url)) {
+  const relative = isRelativeUrl(step.goTo.url);
+  if (relative) {
     if (!step.goTo.origin && !config.origin) {
       result.status = "FAIL";
       result.description = "Relative URL provided without origin. Specify an origin in either the step or the config.";
@@ -133728,6 +134687,10 @@ async function goTo({ config, step, driver }) {
     }
     step.goTo.url = step.goTo.origin + step.goTo.url;
   }
+  if (relative) {
+    step.goTo.url = appendQueryParams(step.goTo.url, config.originParams);
+  }
+  step.goTo.url = appendQueryParams(step.goTo.url, step.goTo.params);
   if (step.goTo.url && !step.goTo.url.includes("://"))
     step.goTo.url = "https://" + step.goTo.url;
   const isValidStep = validate({ schemaKey: "step_v3", object: step });
@@ -134296,7 +135259,8 @@ async function checkLink({ config, step }) {
   if (typeof step.checkLink === "string") {
     step.checkLink = { url: step.checkLink };
   }
-  if (isRelativeUrl(step.checkLink.url)) {
+  const relative = isRelativeUrl(step.checkLink.url);
+  if (relative) {
     if (!step.checkLink.origin && !config.origin) {
       result.status = "FAIL";
       result.description = "Relative URL provided without origin. Specify an origin in either the step or the config.";
@@ -134308,6 +135272,10 @@ async function checkLink({ config, step }) {
     }
     step.checkLink.url = step.checkLink.origin + step.checkLink.url;
   }
+  if (relative) {
+    step.checkLink.url = appendQueryParams(step.checkLink.url, config.originParams);
+  }
+  step.checkLink.url = appendQueryParams(step.checkLink.url, step.checkLink.params);
   if (step.checkLink.url && !step.checkLink.url.includes("://"))
     step.checkLink.url = "https://" + step.checkLink.url;
   const isValidStep = validate({ schemaKey: "step_v3", object: step });
@@ -134371,6 +135339,33 @@ async function getPixelmatch() {
   }
   return pixelmatch;
 }
+function clampCropRect(rect, imgW, imgH) {
+  let { x, y, width, height } = rect;
+  if (width > imgW) {
+    x = 0;
+    width = imgW;
+  } else {
+    if (x < 0)
+      x = 0;
+    if (x + width > imgW)
+      x = imgW - width;
+  }
+  if (height > imgH) {
+    y = 0;
+    height = imgH;
+  } else {
+    if (y < 0)
+      y = 0;
+    if (y + height > imgH)
+      y = imgH - height;
+  }
+  return { x, y, width, height };
+}
+function aspectRatiosMatch(a, b) {
+  const ra = a.width / a.height;
+  const rb = b.width / b.height;
+  return Math.abs(ra - rb) / Math.max(ra, rb) <= 0.05;
+}
 async function saveScreenshot({ config, step, driver }) {
   let result = {
     status: "PASS",
@@ -134414,19 +135409,57 @@ async function saveScreenshot({ config, step, driver }) {
     };
   }
   let filePath = step.screenshot.path;
-  const dir = import_node_path8.default.dirname(step.screenshot.path);
-  if (!import_node_fs7.default.existsSync(dir)) {
-    import_node_fs7.default.mkdirSync(dir, { recursive: true });
-  }
   let existFilePath;
-  if (import_node_fs7.default.existsSync(filePath)) {
-    if (step.screenshot.overwrite == "false") {
-      result.status = "SKIPPED";
-      result.description = `File already exists: ${filePath}`;
+  let dir;
+  const isUrlPath = /^https?:\/\//i.test(filePath);
+  const originalUrlPath = isUrlPath ? filePath : void 0;
+  const redactedUrl = isUrlPath ? redactUrlForOutput(filePath) : void 0;
+  if (isUrlPath) {
+    const fetched = await fetchFile(originalUrlPath, { binary: true });
+    if (fetched.result !== "success") {
+      result.status = "FAIL";
+      result.description = `Couldn't fetch remote reference image (${redactedUrl}): ${fetched.message}`;
       return result;
-    } else {
-      existFilePath = filePath;
-      filePath = import_node_path8.default.join(dir, `${step.stepId}_${Date.now()}.png`);
+    }
+    existFilePath = fetched.path;
+    let urlPathname;
+    try {
+      urlPathname = new URL(originalUrlPath).pathname;
+    } catch {
+      urlPathname = originalUrlPath;
+    }
+    const rawBase = import_node_path8.default.basename(urlPathname.split("?")[0].split("#")[0].replace(/\\/g, "/"));
+    const safeBase = sanitizeFilesystemName(rawBase, `${step.stepId}.png`);
+    dir = import_node_path8.default.join(process.cwd(), "doc-detective-runs", getOrInitRunTimestamp(config));
+    if (!import_node_fs7.default.existsSync(dir)) {
+      import_node_fs7.default.mkdirSync(dir, { recursive: true });
+    }
+    const captureId = `${step.stepId || "screenshot"}_${Date.now()}`;
+    filePath = import_node_path8.default.join(dir, `${captureId}_${safeBase}`);
+    const resolvedDir = import_node_path8.default.resolve(dir);
+    const resolvedFile = import_node_path8.default.resolve(filePath);
+    if (!resolvedFile.startsWith(resolvedDir + import_node_path8.default.sep)) {
+      result.status = "FAIL";
+      result.description = `Refusing to write screenshot outside run folder: ${resolvedFile}`;
+      return result;
+    }
+    if (step.screenshot.overwrite !== "false") {
+      log(config, "debug", `Screenshot path is a URL (${redactedUrl}); overwrite is ignored, running comparison only.`);
+    }
+  } else {
+    dir = import_node_path8.default.dirname(step.screenshot.path);
+    if (!import_node_fs7.default.existsSync(dir)) {
+      import_node_fs7.default.mkdirSync(dir, { recursive: true });
+    }
+    if (import_node_fs7.default.existsSync(filePath)) {
+      if (step.screenshot.overwrite == "false") {
+        result.status = "SKIPPED";
+        result.description = `File already exists: ${filePath}`;
+        return result;
+      } else {
+        existFilePath = filePath;
+        filePath = import_node_path8.default.join(dir, `${step.stepId}_${Date.now()}.png`);
+      }
     }
   }
   if (step.screenshot.crop) {
@@ -134553,20 +135586,11 @@ async function saveScreenshot({ config, step, driver }) {
     rect.width = Math.round(rect.width);
     rect.height = Math.round(rect.height);
     const imgMeta = await (0, import_sharp.default)(filePath).metadata();
-    if (rect.x < 0) {
-      rect.width += rect.x;
-      rect.x = 0;
-    }
-    if (rect.y < 0) {
-      rect.height += rect.y;
-      rect.y = 0;
-    }
-    if (rect.x + rect.width > imgMeta.width) {
-      rect.width = imgMeta.width - rect.x;
-    }
-    if (rect.y + rect.height > imgMeta.height) {
-      rect.height = imgMeta.height - rect.y;
-    }
+    const clamped = clampCropRect(rect, imgMeta.width, imgMeta.height);
+    rect.x = clamped.x;
+    rect.y = clamped.y;
+    rect.width = clamped.width;
+    rect.height = clamped.height;
     log(config, "debug", { padded_rect: rect });
     const croppedPath = import_node_path8.default.join(dir, `cropped_${step.stepId || Date.now()}.png`);
     try {
@@ -134587,7 +135611,7 @@ async function saveScreenshot({ config, step, driver }) {
     }
   }
   if (existFilePath) {
-    if (step.screenshot.overwrite == "true") {
+    if (step.screenshot.overwrite == "true" && !isUrlPath) {
       result.description += ` Overwrote existing file.`;
       import_node_fs7.default.renameSync(filePath, existFilePath);
       result.outputs.screenshotPath = existFilePath;
@@ -134599,12 +135623,23 @@ async function saveScreenshot({ config, step, driver }) {
     }
     let fractionalDiff;
     if (step.screenshot.maxVariation != null) {
-      const img1 = import_pngjs.PNG.sync.read(import_node_fs7.default.readFileSync(existFilePath));
-      const img2 = import_pngjs.PNG.sync.read(import_node_fs7.default.readFileSync(filePath));
-      if (Math.round(img1.width / img1.height * 100) / 100 !== Math.round(img2.width / img2.height * 100) / 100) {
+      let img1;
+      let img2;
+      try {
+        img1 = import_pngjs.PNG.sync.read(import_node_fs7.default.readFileSync(existFilePath));
+        img2 = import_pngjs.PNG.sync.read(import_node_fs7.default.readFileSync(filePath));
+      } catch (error) {
+        result.status = "FAIL";
+        result.description = isUrlPath ? `Couldn't decode PNG for comparison. The URL reference (${redactedUrl}) may not be a valid PNG. ${error}` : `Couldn't decode PNG for comparison. ${error}`;
+        if (!isUrlPath && filePath !== existFilePath && import_node_fs7.default.existsSync(filePath)) {
+          import_node_fs7.default.unlinkSync(filePath);
+        }
+        return result;
+      }
+      if (!aspectRatiosMatch(img1, img2)) {
         result.status = "FAIL";
         result.description = `Couldn't compare images. Images have different aspect ratios.`;
-        if (existFilePath && filePath !== existFilePath && import_node_fs7.default.existsSync(filePath)) {
+        if (!isUrlPath && filePath !== existFilePath && import_node_fs7.default.existsSync(filePath)) {
           import_node_fs7.default.unlinkSync(filePath);
         }
         return result;
@@ -134635,25 +135670,35 @@ async function saveScreenshot({ config, step, driver }) {
         fractionalDiff
       });
       if (fractionalDiff > step.screenshot.maxVariation) {
-        if (step.screenshot.overwrite == "aboveVariation") {
+        if (step.screenshot.overwrite == "aboveVariation" && !isUrlPath) {
           import_node_fs7.default.renameSync(filePath, existFilePath);
         }
         result.status = "WARNING";
         result.description += ` The difference between the existing screenshot and new screenshot (${fractionalDiff.toFixed(2)}) is greater than the max accepted variation (${step.screenshot.maxVariation}).`;
-        result.outputs.changed = true;
-        result.outputs.screenshotPath = existFilePath;
-        if (step.screenshot.sourceIntegration) {
-          result.outputs.sourceIntegration = step.screenshot.sourceIntegration;
+        if (isUrlPath) {
+          result.outputs.screenshotPath = filePath;
+          result.outputs.referenceUrl = redactedUrl;
+        } else {
+          result.outputs.changed = true;
+          result.outputs.screenshotPath = existFilePath;
+          if (step.screenshot.sourceIntegration) {
+            result.outputs.sourceIntegration = step.screenshot.sourceIntegration;
+          }
         }
         return result;
       } else {
         result.description += ` Screenshots are within maximum accepted variation: ${fractionalDiff.toFixed(2)}.`;
-        result.outputs.screenshotPath = existFilePath;
-        if (step.screenshot.sourceIntegration) {
-          result.outputs.sourceIntegration = step.screenshot.sourceIntegration;
-        }
-        if (step.screenshot.overwrite != "true") {
-          import_node_fs7.default.unlinkSync(filePath);
+        if (isUrlPath) {
+          result.outputs.screenshotPath = filePath;
+          result.outputs.referenceUrl = redactedUrl;
+        } else {
+          result.outputs.screenshotPath = existFilePath;
+          if (step.screenshot.sourceIntegration) {
+            result.outputs.sourceIntegration = step.screenshot.sourceIntegration;
+          }
+          if (step.screenshot.overwrite != "true") {
+            import_node_fs7.default.unlinkSync(filePath);
+          }
         }
       }
     }
@@ -135162,6 +136207,15 @@ async function loadCookie({ config, step, driver }) {
     const isHttps = currentUrl.startsWith("https://");
     let sameSite = targetCookie.sameSite || "Lax";
     let secure = targetCookie.secure || false;
+    if (typeof sameSite === "string") {
+      const lower = sameSite.toLowerCase();
+      if (lower === "none")
+        sameSite = "None";
+      else if (lower === "strict")
+        sameSite = "Strict";
+      else
+        sameSite = "Lax";
+    }
     if (sameSite === "None") {
       if (isHttps) {
         secure = true;