doc-detective-common 3.1.2-dev.2 → 3.1.2-dev.3

package/src/schemas/output_schemas/resolvedTests_v3.schema.json

@@ -748,10 +748,12 @@
                                     "find",
                                     "goTo",
                                     "httpRequest",
+                                    "loadCookie",
                                     "loadVariables",
                                     "record",
                                     "runCode",
                                     "runShell",
+                                    "saveCookie",
                                     "screenshot",
                                     "stopRecord",
                                     "type",
@@ -770,10 +772,12 @@
                                           "find",
                                           "goTo",
                                           "httpRequest",
+                                          "loadCookie",
                                           "loadVariables",
                                           "record",
                                           "runCode",
                                           "runShell",
+                                          "saveCookie",
                                           "screenshot",
                                           "stopRecord",
                                           "type",
@@ -4535,6 +4539,328 @@
                                               }
                                             ]
                                           },
+                                          {
+                                            "allOf": [
+                                              {
+                                                "type": "object",
+                                                "dynamicDefaults": {
+                                                  "stepId": "uuid"
+                                                },
+                                                "properties": {
+                                                  "$schema": {
+                                                    "description": "JSON Schema for this object.",
+                                                    "type": "string",
+                                                    "enum": [
+                                                      "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json"
+                                                    ]
+                                                  },
+                                                  "stepId": {
+                                                    "type": "string",
+                                                    "description": "ID of the step."
+                                                  },
+                                                  "description": {
+                                                    "type": "string",
+                                                    "description": "Description of the step."
+                                                  },
+                                                  "unsafe": {
+                                                    "type": "boolean",
+                                                    "description": "Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.",
+                                                    "default": false
+                                                  },
+                                                  "outputs": {
+                                                    "type": "object",
+                                                    "description": "Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.",
+                                                    "default": {},
+                                                    "patternProperties": {
+                                                      "^[A-Za-z0-9_]+$": {
+                                                        "type": "string",
+                                                        "description": "Runtime expression for a user-defined output value."
+                                                      }
+                                                    },
+                                                    "title": "Outputs (step)"
+                                                  },
+                                                  "variables": {
+                                                    "type": "object",
+                                                    "description": "Environment variables to set from user-defined expressions.",
+                                                    "default": {},
+                                                    "patternProperties": {
+                                                      "^[A-Za-z0-9_]+$": {
+                                                        "type": "string",
+                                                        "description": "Runtime expression for a user-defined output value."
+                                                      }
+                                                    },
+                                                    "title": "Variables (step)"
+                                                  },
+                                                  "breakpoint": {
+                                                    "type": "boolean",
+                                                    "description": "Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.",
+                                                    "default": false
+                                                  }
+                                                },
+                                                "title": "Common"
+                                              },
+                                              {
+                                                "type": "object",
+                                                "required": [
+                                                  "saveCookie"
+                                                ],
+                                                "properties": {
+                                                  "saveCookie": {
+                                                    "$schema": "http://json-schema.org/draft-07/schema#",
+                                                    "title": "saveCookie",
+                                                    "description": "Save a specific browser cookie to a file or environment variable for later reuse.",
+                                                    "anyOf": [
+                                                      {
+                                                        "type": "string",
+                                                        "title": "Cookie name",
+                                                        "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
+                                                        "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      {
+                                                        "type": "object",
+                                                        "additionalProperties": false,
+                                                        "properties": {
+                                                          "$schema": {
+                                                            "description": "Optional self-describing schema URI for linters",
+                                                            "type": "string",
+                                                            "format": "uri-reference"
+                                                          },
+                                                          "name": {
+                                                            "type": "string",
+                                                            "title": "Cookie name",
+                                                            "description": "Name of the specific cookie to save.",
+                                                            "pattern": "^[A-Za-z0-9_.-]+$",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          },
+                                                          "variable": {
+                                                            "type": "string",
+                                                            "title": "Environment variable name",
+                                                            "description": "Environment variable name to store the cookie as JSON string.",
+                                                            "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          },
+                                                          "path": {
+                                                            "type": "string",
+                                                            "title": "Cookie file path",
+                                                            "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
+                                                            "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          },
+                                                          "directory": {
+                                                            "type": "string",
+                                                            "title": "Directory path",
+                                                            "description": "Directory to save the cookie file. If not specified, uses output directory.",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          },
+                                                          "overwrite": {
+                                                            "type": "boolean",
+                                                            "title": "Overwrite existing file",
+                                                            "description": "Whether to overwrite existing cookie file.",
+                                                            "default": false
+                                                          },
+                                                          "domain": {
+                                                            "type": "string",
+                                                            "title": "Cookie domain",
+                                                            "description": "Specific domain to filter the cookie by (optional).",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          }
+                                                        },
+                                                        "required": [
+                                                          "name"
+                                                        ],
+                                                        "anyOf": [
+                                                          {
+                                                            "required": [
+                                                              "path"
+                                                            ],
+                                                            "not": {
+                                                              "required": [
+                                                                "variable"
+                                                              ]
+                                                            }
+                                                          },
+                                                          {
+                                                            "required": [
+                                                              "variable"
+                                                            ],
+                                                            "not": {
+                                                              "anyOf": [
+                                                                {
+                                                                  "required": [
+                                                                    "path"
+                                                                  ]
+                                                                },
+                                                                {
+                                                                  "required": [
+                                                                    "directory"
+                                                                  ]
+                                                                },
+                                                                {
+                                                                  "required": [
+                                                                    "overwrite"
+                                                                  ]
+                                                                }
+                                                              ]
+                                                            }
+                                                          }
+                                                        ],
+                                                        "title": "Save cookie (detailed)"
+                                                      }
+                                                    ],
+                                                    "components": {
+                                                      "schemas": {
+                                                        "string": {
+                                                          "type": "string",
+                                                          "title": "Cookie name",
+                                                          "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
+                                                          "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                                          "transform": [
+                                                            "trim"
+                                                          ]
+                                                        },
+                                                        "object": {
+                                                          "type": "object",
+                                                          "additionalProperties": false,
+                                                          "properties": {
+                                                            "$schema": {
+                                                              "description": "Optional self-describing schema URI for linters",
+                                                              "type": "string",
+                                                              "format": "uri-reference"
+                                                            },
+                                                            "name": {
+                                                              "type": "string",
+                                                              "title": "Cookie name",
+                                                              "description": "Name of the specific cookie to save.",
+                                                              "pattern": "^[A-Za-z0-9_.-]+$",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            },
+                                                            "variable": {
+                                                              "type": "string",
+                                                              "title": "Environment variable name",
+                                                              "description": "Environment variable name to store the cookie as JSON string.",
+                                                              "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            },
+                                                            "path": {
+                                                              "type": "string",
+                                                              "title": "Cookie file path",
+                                                              "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
+                                                              "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            },
+                                                            "directory": {
+                                                              "type": "string",
+                                                              "title": "Directory path",
+                                                              "description": "Directory to save the cookie file. If not specified, uses output directory.",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            },
+                                                            "overwrite": {
+                                                              "type": "boolean",
+                                                              "title": "Overwrite existing file",
+                                                              "description": "Whether to overwrite existing cookie file.",
+                                                              "default": false
+                                                            },
+                                                            "domain": {
+                                                              "type": "string",
+                                                              "title": "Cookie domain",
+                                                              "description": "Specific domain to filter the cookie by (optional).",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            }
+                                                          },
+                                                          "required": [
+                                                            "name"
+                                                          ],
+                                                          "anyOf": [
+                                                            {
+                                                              "required": [
+                                                                "path"
+                                                              ],
+                                                              "not": {
+                                                                "required": [
+                                                                  "variable"
+                                                                ]
+                                                              }
+                                                            },
+                                                            {
+                                                              "required": [
+                                                                "variable"
+                                                              ],
+                                                              "not": {
+                                                                "anyOf": [
+                                                                  {
+                                                                    "required": [
+                                                                      "path"
+                                                                    ]
+                                                                  },
+                                                                  {
+                                                                    "required": [
+                                                                      "directory"
+                                                                    ]
+                                                                  },
+                                                                  {
+                                                                    "required": [
+                                                                      "overwrite"
+                                                                    ]
+                                                                  }
+                                                                ]
+                                                              }
+                                                            }
+                                                          ],
+                                                          "title": "Save cookie (detailed)"
+                                                        }
+                                                      }
+                                                    },
+                                                    "examples": [
+                                                      "session_token",
+                                                      {
+                                                        "name": "auth_cookie",
+                                                        "path": "auth-cookie.txt"
+                                                      },
+                                                      {
+                                                        "name": "session_token",
+                                                        "variable": "SESSION_TOKEN"
+                                                      },
+                                                      {
+                                                        "name": "user_session",
+                                                        "path": "user-session.txt",
+                                                        "directory": "./test-data",
+                                                        "overwrite": true
+                                                      },
+                                                      {
+                                                        "name": "login_token",
+                                                        "path": "login-token.txt",
+                                                        "domain": "app.example.com"
+                                                      }
+                                                    ]
+                                                  }
+                                                },
+                                                "title": "saveCookie"
+                                              }
+                                            ]
+                                          },
                                           {
                                             "allOf": [
                                               {
@@ -4933,36 +5259,332 @@
                                                 "title": "Common"
                                               },
                                               {
-                                                "title": "wait",
+                                                "title": "loadCookie",
                                                 "type": "object",
                                                 "required": [
-                                                  "wait"
+                                                  "loadCookie"
                                                 ],
                                                 "properties": {
-                                                  "wait": {
+                                                  "loadCookie": {
                                                     "$schema": "http://json-schema.org/draft-07/schema#",
-                                                    "title": "wait",
-                                                    "description": "Pause (in milliseconds) before performing the next action.",
-                                                    "default": 5000,
+                                                    "title": "loadCookie",
+                                                    "description": "Load a specific cookie from a file or environment variable into the browser.",
                                                     "anyOf": [
                                                       {
-                                                        "type": "number",
-                                                        "title": "Wait (simple)"
-                                                      },
-                                                      {
-                                                        "title": "Wait (environment variable)",
                                                         "type": "string",
-                                                        "pattern": "(\\$[A-Za-z0-9_]+)",
+                                                        "title": "Cookie name or file path",
+                                                        "description": "Name of the specific cookie to load from default location, or file path to cookie file.",
+                                                        "pattern": "^[A-Za-z0-9_./\\-]+$",
                                                         "transform": [
                                                           "trim"
                                                         ]
                                                       },
                                                       {
-                                                        "type": "boolean",
-                                                        "title": "Wait (boolean)"
-                                                      }
-                                                    ],
-                                                    "components": {
+                                                        "type": "object",
+                                                        "additionalProperties": false,
+                                                        "required": [
+                                                          "name"
+                                                        ],
+                                                        "anyOf": [
+                                                          {
+                                                            "required": [
+                                                              "path"
+                                                            ],
+                                                            "not": {
+                                                              "required": [
+                                                                "variable"
+                                                              ]
+                                                            }
+                                                          },
+                                                          {
+                                                            "required": [
+                                                              "variable"
+                                                            ],
+                                                            "not": {
+                                                              "anyOf": [
+                                                                {
+                                                                  "required": [
+                                                                    "path"
+                                                                  ]
+                                                                },
+                                                                {
+                                                                  "required": [
+                                                                    "directory"
+                                                                  ]
+                                                                }
+                                                              ]
+                                                            }
+                                                          }
+                                                        ],
+                                                        "properties": {
+                                                          "$schema": {
+                                                            "description": "Optional self-describing schema URI for linters",
+                                                            "type": "string",
+                                                            "format": "uri-reference"
+                                                          },
+                                                          "name": {
+                                                            "type": "string",
+                                                            "title": "Cookie name",
+                                                            "description": "Name of the specific cookie to load.",
+                                                            "pattern": "^[A-Za-z0-9_.-]+$",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          },
+                                                          "variable": {
+                                                            "type": "string",
+                                                            "title": "Environment variable name",
+                                                            "description": "Environment variable name containing the cookie as JSON string.",
+                                                            "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          },
+                                                          "path": {
+                                                            "type": "string",
+                                                            "title": "Cookie file path",
+                                                            "description": "File path to cookie file, relative to directory. Supports Netscape cookie format.",
+                                                            "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          },
+                                                          "directory": {
+                                                            "type": "string",
+                                                            "title": "Directory path",
+                                                            "description": "Directory containing the cookie file.",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          },
+                                                          "domain": {
+                                                            "type": "string",
+                                                            "title": "Cookie domain",
+                                                            "description": "Specific domain to filter the cookie by when loading from multi-cookie file (optional).",
+                                                            "transform": [
+                                                              "trim"
+                                                            ]
+                                                          }
+                                                        },
+                                                        "title": "Load cookie (detailed)"
+                                                      }
+                                                    ],
+                                                    "components": {
+                                                      "schemas": {
+                                                        "string": {
+                                                          "type": "string",
+                                                          "title": "Cookie name or file path",
+                                                          "description": "Name of the specific cookie to load from default location, or file path to cookie file.",
+                                                          "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                                          "transform": [
+                                                            "trim"
+                                                          ]
+                                                        },
+                                                        "object": {
+                                                          "type": "object",
+                                                          "additionalProperties": false,
+                                                          "required": [
+                                                            "name"
+                                                          ],
+                                                          "anyOf": [
+                                                            {
+                                                              "required": [
+                                                                "path"
+                                                              ],
+                                                              "not": {
+                                                                "required": [
+                                                                  "variable"
+                                                                ]
+                                                              }
+                                                            },
+                                                            {
+                                                              "required": [
+                                                                "variable"
+                                                              ],
+                                                              "not": {
+                                                                "anyOf": [
+                                                                  {
+                                                                    "required": [
+                                                                      "path"
+                                                                    ]
+                                                                  },
+                                                                  {
+                                                                    "required": [
+                                                                      "directory"
+                                                                    ]
+                                                                  }
+                                                                ]
+                                                              }
+                                                            }
+                                                          ],
+                                                          "properties": {
+                                                            "$schema": {
+                                                              "description": "Optional self-describing schema URI for linters",
+                                                              "type": "string",
+                                                              "format": "uri-reference"
+                                                            },
+                                                            "name": {
+                                                              "type": "string",
+                                                              "title": "Cookie name",
+                                                              "description": "Name of the specific cookie to load.",
+                                                              "pattern": "^[A-Za-z0-9_.-]+$",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            },
+                                                            "variable": {
+                                                              "type": "string",
+                                                              "title": "Environment variable name",
+                                                              "description": "Environment variable name containing the cookie as JSON string.",
+                                                              "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            },
+                                                            "path": {
+                                                              "type": "string",
+                                                              "title": "Cookie file path",
+                                                              "description": "File path to cookie file, relative to directory. Supports Netscape cookie format.",
+                                                              "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            },
+                                                            "directory": {
+                                                              "type": "string",
+                                                              "title": "Directory path",
+                                                              "description": "Directory containing the cookie file.",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            },
+                                                            "domain": {
+                                                              "type": "string",
+                                                              "title": "Cookie domain",
+                                                              "description": "Specific domain to filter the cookie by when loading from multi-cookie file (optional).",
+                                                              "transform": [
+                                                                "trim"
+                                                              ]
+                                                            }
+                                                          },
+                                                          "title": "Load cookie (detailed)"
+                                                        }
+                                                      }
+                                                    },
+                                                    "examples": [
+                                                      "session_token",
+                                                      "./test-data/auth-session.txt",
+                                                      {
+                                                        "name": "auth_cookie",
+                                                        "variable": "AUTH_COOKIE"
+                                                      },
+                                                      {
+                                                        "name": "session_token",
+                                                        "path": "session-token.txt",
+                                                        "directory": "./test-data"
+                                                      },
+                                                      {
+                                                        "name": "user_session",
+                                                        "path": "saved-cookies.txt",
+                                                        "domain": "app.example.com"
+                                                      }
+                                                    ]
+                                                  }
+                                                }
+                                              }
+                                            ]
+                                          },
+                                          {
+                                            "allOf": [
+                                              {
+                                                "type": "object",
+                                                "dynamicDefaults": {
+                                                  "stepId": "uuid"
+                                                },
+                                                "properties": {
+                                                  "$schema": {
+                                                    "description": "JSON Schema for this object.",
+                                                    "type": "string",
+                                                    "enum": [
+                                                      "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json"
+                                                    ]
+                                                  },
+                                                  "stepId": {
+                                                    "type": "string",
+                                                    "description": "ID of the step."
+                                                  },
+                                                  "description": {
+                                                    "type": "string",
+                                                    "description": "Description of the step."
+                                                  },
+                                                  "unsafe": {
+                                                    "type": "boolean",
+                                                    "description": "Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.",
+                                                    "default": false
+                                                  },
+                                                  "outputs": {
+                                                    "type": "object",
+                                                    "description": "Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.",
+                                                    "default": {},
+                                                    "patternProperties": {
+                                                      "^[A-Za-z0-9_]+$": {
+                                                        "type": "string",
+                                                        "description": "Runtime expression for a user-defined output value."
+                                                      }
+                                                    },
+                                                    "title": "Outputs (step)"
+                                                  },
+                                                  "variables": {
+                                                    "type": "object",
+                                                    "description": "Environment variables to set from user-defined expressions.",
+                                                    "default": {},
+                                                    "patternProperties": {
+                                                      "^[A-Za-z0-9_]+$": {
+                                                        "type": "string",
+                                                        "description": "Runtime expression for a user-defined output value."
+                                                      }
+                                                    },
+                                                    "title": "Variables (step)"
+                                                  },
+                                                  "breakpoint": {
+                                                    "type": "boolean",
+                                                    "description": "Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.",
+                                                    "default": false
+                                                  }
+                                                },
+                                                "title": "Common"
+                                              },
+                                              {
+                                                "title": "wait",
+                                                "type": "object",
+                                                "required": [
+                                                  "wait"
+                                                ],
+                                                "properties": {
+                                                  "wait": {
+                                                    "$schema": "http://json-schema.org/draft-07/schema#",
+                                                    "title": "wait",
+                                                    "description": "Pause (in milliseconds) before performing the next action.",
+                                                    "default": 5000,
+                                                    "anyOf": [
+                                                      {
+                                                        "type": "number",
+                                                        "title": "Wait (simple)"
+                                                      },
+                                                      {
+                                                        "title": "Wait (environment variable)",
+                                                        "type": "string",
+                                                        "pattern": "(\\$[A-Za-z0-9_]+)",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      {
+                                                        "type": "boolean",
+                                                        "title": "Wait (boolean)"
+                                                      }
+                                                    ],
+                                                    "components": {
                                                       "schemas": {
                                                         "string": {
                                                           "title": "Wait (environment variable)",
@@ -5111,6 +5733,27 @@
                                           {
                                             "loadVariables": "variables.env"
                                           },
+                                          {
+                                            "saveCookie": "session_token"
+                                          },
+                                          {
+                                            "saveCookie": {
+                                              "name": "auth_cookie",
+                                              "path": "auth-session.txt",
+                                              "directory": "./test-data",
+                                              "overwrite": true
+                                            }
+                                          },
+                                          {
+                                            "loadCookie": "session_token"
+                                          },
+                                          {
+                                            "loadCookie": {
+                                              "name": "auth_cookie",
+                                              "path": "auth-session.txt",
+                                              "directory": "./test-data"
+                                            }
+                                          },
                                           {
                                             "find": "Find me!"
                                           },
@@ -5984,10 +6627,12 @@
                       "find",
                       "goTo",
                       "httpRequest",
+                      "loadCookie",
                       "loadVariables",
                       "record",
                       "runCode",
                       "runShell",
+                      "saveCookie",
                       "screenshot",
                       "stopRecord",
                       "type",
@@ -6006,10 +6651,12 @@
                             "find",
                             "goTo",
                             "httpRequest",
+                            "loadCookie",
                             "loadVariables",
                             "record",
                             "runCode",
                             "runShell",
+                            "saveCookie",
                             "screenshot",
                             "stopRecord",
                             "type",
@@ -9834,16 +10481,338 @@
                                 {
                                   "type": "object",
                                   "required": [
-                                    "record"
+                                    "saveCookie"
                                   ],
                                   "properties": {
-                                    "record": {
+                                    "saveCookie": {
                                       "$schema": "http://json-schema.org/draft-07/schema#",
-                                      "title": "record",
-                                      "description": "Start recording the current browser viewport. Must be followed by a `stopRecord` step. Only runs in Chrome browsers when they are visible. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                      "title": "saveCookie",
+                                      "description": "Save a specific browser cookie to a file or environment variable for later reuse.",
                                       "anyOf": [
                                         {
-                                          "title": "Record (simple)",
+                                          "type": "string",
+                                          "title": "Cookie name",
+                                          "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
+                                          "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                          "transform": [
+                                            "trim"
+                                          ]
+                                        },
+                                        {
+                                          "type": "object",
+                                          "additionalProperties": false,
+                                          "properties": {
+                                            "$schema": {
+                                              "description": "Optional self-describing schema URI for linters",
+                                              "type": "string",
+                                              "format": "uri-reference"
+                                            },
+                                            "name": {
+                                              "type": "string",
+                                              "title": "Cookie name",
+                                              "description": "Name of the specific cookie to save.",
+                                              "pattern": "^[A-Za-z0-9_.-]+$",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "variable": {
+                                              "type": "string",
+                                              "title": "Environment variable name",
+                                              "description": "Environment variable name to store the cookie as JSON string.",
+                                              "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "path": {
+                                              "type": "string",
+                                              "title": "Cookie file path",
+                                              "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
+                                              "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "directory": {
+                                              "type": "string",
+                                              "title": "Directory path",
+                                              "description": "Directory to save the cookie file. If not specified, uses output directory.",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "overwrite": {
+                                              "type": "boolean",
+                                              "title": "Overwrite existing file",
+                                              "description": "Whether to overwrite existing cookie file.",
+                                              "default": false
+                                            },
+                                            "domain": {
+                                              "type": "string",
+                                              "title": "Cookie domain",
+                                              "description": "Specific domain to filter the cookie by (optional).",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            }
+                                          },
+                                          "required": [
+                                            "name"
+                                          ],
+                                          "anyOf": [
+                                            {
+                                              "required": [
+                                                "path"
+                                              ],
+                                              "not": {
+                                                "required": [
+                                                  "variable"
+                                                ]
+                                              }
+                                            },
+                                            {
+                                              "required": [
+                                                "variable"
+                                              ],
+                                              "not": {
+                                                "anyOf": [
+                                                  {
+                                                    "required": [
+                                                      "path"
+                                                    ]
+                                                  },
+                                                  {
+                                                    "required": [
+                                                      "directory"
+                                                    ]
+                                                  },
+                                                  {
+                                                    "required": [
+                                                      "overwrite"
+                                                    ]
+                                                  }
+                                                ]
+                                              }
+                                            }
+                                          ],
+                                          "title": "Save cookie (detailed)"
+                                        }
+                                      ],
+                                      "components": {
+                                        "schemas": {
+                                          "string": {
+                                            "type": "string",
+                                            "title": "Cookie name",
+                                            "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
+                                            "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                            "transform": [
+                                              "trim"
+                                            ]
+                                          },
+                                          "object": {
+                                            "type": "object",
+                                            "additionalProperties": false,
+                                            "properties": {
+                                              "$schema": {
+                                                "description": "Optional self-describing schema URI for linters",
+                                                "type": "string",
+                                                "format": "uri-reference"
+                                              },
+                                              "name": {
+                                                "type": "string",
+                                                "title": "Cookie name",
+                                                "description": "Name of the specific cookie to save.",
+                                                "pattern": "^[A-Za-z0-9_.-]+$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "variable": {
+                                                "type": "string",
+                                                "title": "Environment variable name",
+                                                "description": "Environment variable name to store the cookie as JSON string.",
+                                                "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "path": {
+                                                "type": "string",
+                                                "title": "Cookie file path",
+                                                "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
+                                                "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "directory": {
+                                                "type": "string",
+                                                "title": "Directory path",
+                                                "description": "Directory to save the cookie file. If not specified, uses output directory.",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "overwrite": {
+                                                "type": "boolean",
+                                                "title": "Overwrite existing file",
+                                                "description": "Whether to overwrite existing cookie file.",
+                                                "default": false
+                                              },
+                                              "domain": {
+                                                "type": "string",
+                                                "title": "Cookie domain",
+                                                "description": "Specific domain to filter the cookie by (optional).",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              }
+                                            },
+                                            "required": [
+                                              "name"
+                                            ],
+                                            "anyOf": [
+                                              {
+                                                "required": [
+                                                  "path"
+                                                ],
+                                                "not": {
+                                                  "required": [
+                                                    "variable"
+                                                  ]
+                                                }
+                                              },
+                                              {
+                                                "required": [
+                                                  "variable"
+                                                ],
+                                                "not": {
+                                                  "anyOf": [
+                                                    {
+                                                      "required": [
+                                                        "path"
+                                                      ]
+                                                    },
+                                                    {
+                                                      "required": [
+                                                        "directory"
+                                                      ]
+                                                    },
+                                                    {
+                                                      "required": [
+                                                        "overwrite"
+                                                      ]
+                                                    }
+                                                  ]
+                                                }
+                                              }
+                                            ],
+                                            "title": "Save cookie (detailed)"
+                                          }
+                                        }
+                                      },
+                                      "examples": [
+                                        "session_token",
+                                        {
+                                          "name": "auth_cookie",
+                                          "path": "auth-cookie.txt"
+                                        },
+                                        {
+                                          "name": "session_token",
+                                          "variable": "SESSION_TOKEN"
+                                        },
+                                        {
+                                          "name": "user_session",
+                                          "path": "user-session.txt",
+                                          "directory": "./test-data",
+                                          "overwrite": true
+                                        },
+                                        {
+                                          "name": "login_token",
+                                          "path": "login-token.txt",
+                                          "domain": "app.example.com"
+                                        }
+                                      ]
+                                    }
+                                  },
+                                  "title": "saveCookie"
+                                }
+                              ]
+                            },
+                            {
+                              "allOf": [
+                                {
+                                  "type": "object",
+                                  "dynamicDefaults": {
+                                    "stepId": "uuid"
+                                  },
+                                  "properties": {
+                                    "$schema": {
+                                      "description": "JSON Schema for this object.",
+                                      "type": "string",
+                                      "enum": [
+                                        "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json"
+                                      ]
+                                    },
+                                    "stepId": {
+                                      "type": "string",
+                                      "description": "ID of the step."
+                                    },
+                                    "description": {
+                                      "type": "string",
+                                      "description": "Description of the step."
+                                    },
+                                    "unsafe": {
+                                      "type": "boolean",
+                                      "description": "Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.",
+                                      "default": false
+                                    },
+                                    "outputs": {
+                                      "type": "object",
+                                      "description": "Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.",
+                                      "default": {},
+                                      "patternProperties": {
+                                        "^[A-Za-z0-9_]+$": {
+                                          "type": "string",
+                                          "description": "Runtime expression for a user-defined output value."
+                                        }
+                                      },
+                                      "title": "Outputs (step)"
+                                    },
+                                    "variables": {
+                                      "type": "object",
+                                      "description": "Environment variables to set from user-defined expressions.",
+                                      "default": {},
+                                      "patternProperties": {
+                                        "^[A-Za-z0-9_]+$": {
+                                          "type": "string",
+                                          "description": "Runtime expression for a user-defined output value."
+                                        }
+                                      },
+                                      "title": "Variables (step)"
+                                    },
+                                    "breakpoint": {
+                                      "type": "boolean",
+                                      "description": "Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.",
+                                      "default": false
+                                    }
+                                  },
+                                  "title": "Common"
+                                },
+                                {
+                                  "type": "object",
+                                  "required": [
+                                    "record"
+                                  ],
+                                  "properties": {
+                                    "record": {
+                                      "$schema": "http://json-schema.org/draft-07/schema#",
+                                      "title": "record",
+                                      "description": "Start recording the current browser viewport. Must be followed by a `stopRecord` step. Only runs in Chrome browsers when they are visible. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                      "anyOf": [
+                                        {
+                                          "title": "Record (simple)",
                                           "type": "string",
                                           "description": "File path of the recording. Supports the `.mp4`, `.webm`, and `.gif` extensions. If not specified, the file name is the ID of the step, and the extension is `.mp4`.",
                                           "pattern": "([A-Za-z0-9_-]*\\.(mp4|webm|gif)$|\\$[A-Za-z0-9_]+)",
@@ -10169,33 +11138,329 @@
                                   "title": "Common"
                                 },
                                 {
-                                  "title": "wait",
+                                  "title": "loadCookie",
                                   "type": "object",
                                   "required": [
-                                    "wait"
+                                    "loadCookie"
                                   ],
                                   "properties": {
-                                    "wait": {
+                                    "loadCookie": {
                                       "$schema": "http://json-schema.org/draft-07/schema#",
-                                      "title": "wait",
-                                      "description": "Pause (in milliseconds) before performing the next action.",
-                                      "default": 5000,
+                                      "title": "loadCookie",
+                                      "description": "Load a specific cookie from a file or environment variable into the browser.",
                                       "anyOf": [
                                         {
-                                          "type": "number",
-                                          "title": "Wait (simple)"
-                                        },
-                                        {
-                                          "title": "Wait (environment variable)",
                                           "type": "string",
-                                          "pattern": "(\\$[A-Za-z0-9_]+)",
+                                          "title": "Cookie name or file path",
+                                          "description": "Name of the specific cookie to load from default location, or file path to cookie file.",
+                                          "pattern": "^[A-Za-z0-9_./\\-]+$",
                                           "transform": [
                                             "trim"
                                           ]
                                         },
                                         {
-                                          "type": "boolean",
-                                          "title": "Wait (boolean)"
+                                          "type": "object",
+                                          "additionalProperties": false,
+                                          "required": [
+                                            "name"
+                                          ],
+                                          "anyOf": [
+                                            {
+                                              "required": [
+                                                "path"
+                                              ],
+                                              "not": {
+                                                "required": [
+                                                  "variable"
+                                                ]
+                                              }
+                                            },
+                                            {
+                                              "required": [
+                                                "variable"
+                                              ],
+                                              "not": {
+                                                "anyOf": [
+                                                  {
+                                                    "required": [
+                                                      "path"
+                                                    ]
+                                                  },
+                                                  {
+                                                    "required": [
+                                                      "directory"
+                                                    ]
+                                                  }
+                                                ]
+                                              }
+                                            }
+                                          ],
+                                          "properties": {
+                                            "$schema": {
+                                              "description": "Optional self-describing schema URI for linters",
+                                              "type": "string",
+                                              "format": "uri-reference"
+                                            },
+                                            "name": {
+                                              "type": "string",
+                                              "title": "Cookie name",
+                                              "description": "Name of the specific cookie to load.",
+                                              "pattern": "^[A-Za-z0-9_.-]+$",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "variable": {
+                                              "type": "string",
+                                              "title": "Environment variable name",
+                                              "description": "Environment variable name containing the cookie as JSON string.",
+                                              "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "path": {
+                                              "type": "string",
+                                              "title": "Cookie file path",
+                                              "description": "File path to cookie file, relative to directory. Supports Netscape cookie format.",
+                                              "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "directory": {
+                                              "type": "string",
+                                              "title": "Directory path",
+                                              "description": "Directory containing the cookie file.",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "domain": {
+                                              "type": "string",
+                                              "title": "Cookie domain",
+                                              "description": "Specific domain to filter the cookie by when loading from multi-cookie file (optional).",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            }
+                                          },
+                                          "title": "Load cookie (detailed)"
+                                        }
+                                      ],
+                                      "components": {
+                                        "schemas": {
+                                          "string": {
+                                            "type": "string",
+                                            "title": "Cookie name or file path",
+                                            "description": "Name of the specific cookie to load from default location, or file path to cookie file.",
+                                            "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                            "transform": [
+                                              "trim"
+                                            ]
+                                          },
+                                          "object": {
+                                            "type": "object",
+                                            "additionalProperties": false,
+                                            "required": [
+                                              "name"
+                                            ],
+                                            "anyOf": [
+                                              {
+                                                "required": [
+                                                  "path"
+                                                ],
+                                                "not": {
+                                                  "required": [
+                                                    "variable"
+                                                  ]
+                                                }
+                                              },
+                                              {
+                                                "required": [
+                                                  "variable"
+                                                ],
+                                                "not": {
+                                                  "anyOf": [
+                                                    {
+                                                      "required": [
+                                                        "path"
+                                                      ]
+                                                    },
+                                                    {
+                                                      "required": [
+                                                        "directory"
+                                                      ]
+                                                    }
+                                                  ]
+                                                }
+                                              }
+                                            ],
+                                            "properties": {
+                                              "$schema": {
+                                                "description": "Optional self-describing schema URI for linters",
+                                                "type": "string",
+                                                "format": "uri-reference"
+                                              },
+                                              "name": {
+                                                "type": "string",
+                                                "title": "Cookie name",
+                                                "description": "Name of the specific cookie to load.",
+                                                "pattern": "^[A-Za-z0-9_.-]+$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "variable": {
+                                                "type": "string",
+                                                "title": "Environment variable name",
+                                                "description": "Environment variable name containing the cookie as JSON string.",
+                                                "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "path": {
+                                                "type": "string",
+                                                "title": "Cookie file path",
+                                                "description": "File path to cookie file, relative to directory. Supports Netscape cookie format.",
+                                                "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "directory": {
+                                                "type": "string",
+                                                "title": "Directory path",
+                                                "description": "Directory containing the cookie file.",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "domain": {
+                                                "type": "string",
+                                                "title": "Cookie domain",
+                                                "description": "Specific domain to filter the cookie by when loading from multi-cookie file (optional).",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              }
+                                            },
+                                            "title": "Load cookie (detailed)"
+                                          }
+                                        }
+                                      },
+                                      "examples": [
+                                        "session_token",
+                                        "./test-data/auth-session.txt",
+                                        {
+                                          "name": "auth_cookie",
+                                          "variable": "AUTH_COOKIE"
+                                        },
+                                        {
+                                          "name": "session_token",
+                                          "path": "session-token.txt",
+                                          "directory": "./test-data"
+                                        },
+                                        {
+                                          "name": "user_session",
+                                          "path": "saved-cookies.txt",
+                                          "domain": "app.example.com"
+                                        }
+                                      ]
+                                    }
+                                  }
+                                }
+                              ]
+                            },
+                            {
+                              "allOf": [
+                                {
+                                  "type": "object",
+                                  "dynamicDefaults": {
+                                    "stepId": "uuid"
+                                  },
+                                  "properties": {
+                                    "$schema": {
+                                      "description": "JSON Schema for this object.",
+                                      "type": "string",
+                                      "enum": [
+                                        "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json"
+                                      ]
+                                    },
+                                    "stepId": {
+                                      "type": "string",
+                                      "description": "ID of the step."
+                                    },
+                                    "description": {
+                                      "type": "string",
+                                      "description": "Description of the step."
+                                    },
+                                    "unsafe": {
+                                      "type": "boolean",
+                                      "description": "Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.",
+                                      "default": false
+                                    },
+                                    "outputs": {
+                                      "type": "object",
+                                      "description": "Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.",
+                                      "default": {},
+                                      "patternProperties": {
+                                        "^[A-Za-z0-9_]+$": {
+                                          "type": "string",
+                                          "description": "Runtime expression for a user-defined output value."
+                                        }
+                                      },
+                                      "title": "Outputs (step)"
+                                    },
+                                    "variables": {
+                                      "type": "object",
+                                      "description": "Environment variables to set from user-defined expressions.",
+                                      "default": {},
+                                      "patternProperties": {
+                                        "^[A-Za-z0-9_]+$": {
+                                          "type": "string",
+                                          "description": "Runtime expression for a user-defined output value."
+                                        }
+                                      },
+                                      "title": "Variables (step)"
+                                    },
+                                    "breakpoint": {
+                                      "type": "boolean",
+                                      "description": "Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.",
+                                      "default": false
+                                    }
+                                  },
+                                  "title": "Common"
+                                },
+                                {
+                                  "title": "wait",
+                                  "type": "object",
+                                  "required": [
+                                    "wait"
+                                  ],
+                                  "properties": {
+                                    "wait": {
+                                      "$schema": "http://json-schema.org/draft-07/schema#",
+                                      "title": "wait",
+                                      "description": "Pause (in milliseconds) before performing the next action.",
+                                      "default": 5000,
+                                      "anyOf": [
+                                        {
+                                          "type": "number",
+                                          "title": "Wait (simple)"
+                                        },
+                                        {
+                                          "title": "Wait (environment variable)",
+                                          "type": "string",
+                                          "pattern": "(\\$[A-Za-z0-9_]+)",
+                                          "transform": [
+                                            "trim"
+                                          ]
+                                        },
+                                        {
+                                          "type": "boolean",
+                                          "title": "Wait (boolean)"
                                         }
                                       ],
                                       "components": {
@@ -10347,6 +11612,27 @@
                             {
                               "loadVariables": "variables.env"
                             },
+                            {
+                              "saveCookie": "session_token"
+                            },
+                            {
+                              "saveCookie": {
+                                "name": "auth_cookie",
+                                "path": "auth-session.txt",
+                                "directory": "./test-data",
+                                "overwrite": true
+                              }
+                            },
+                            {
+                              "loadCookie": "session_token"
+                            },
+                            {
+                              "loadCookie": {
+                                "name": "auth_cookie",
+                                "path": "auth-session.txt",
+                                "directory": "./test-data"
+                              }
+                            },
                             {
                               "find": "Find me!"
                             },
@@ -10595,10 +11881,12 @@
               "find",
               "goTo",
               "httpRequest",
+              "loadCookie",
               "loadVariables",
               "record",
               "runCode",
               "runShell",
+              "saveCookie",
               "screenshot",
               "stopRecord",
               "type",
@@ -15843,30 +17131,352 @@
                                   {
                                     "type": "object",
                                     "required": [
-                                      "record"
+                                      "saveCookie"
                                     ],
                                     "properties": {
-                                      "record": {
+                                      "saveCookie": {
                                         "$schema": "http://json-schema.org/draft-07/schema#",
-                                        "title": "record",
-                                        "description": "Start recording the current browser viewport. Must be followed by a `stopRecord` step. Only runs in Chrome browsers when they are visible. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                        "title": "saveCookie",
+                                        "description": "Save a specific browser cookie to a file or environment variable for later reuse.",
                                         "anyOf": [
                                           {
-                                            "title": "Record (simple)",
                                             "type": "string",
-                                            "description": "File path of the recording. Supports the `.mp4`, `.webm`, and `.gif` extensions. If not specified, the file name is the ID of the step, and the extension is `.mp4`.",
-                                            "pattern": "([A-Za-z0-9_-]*\\.(mp4|webm|gif)$|\\$[A-Za-z0-9_]+)",
+                                            "title": "Cookie name",
+                                            "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
+                                            "pattern": "^[A-Za-z0-9_./\\-]+$",
                                             "transform": [
                                               "trim"
                                             ]
                                           },
                                           {
                                             "type": "object",
+                                            "additionalProperties": false,
                                             "properties": {
-                                              "path": {
+                                              "$schema": {
+                                                "description": "Optional self-describing schema URI for linters",
                                                 "type": "string",
-                                                "description": "File path of the recording. Supports the `.mp4`, `.webm`, and `.gif` extensions. If not specified, the file name is the ID of the step, and the extension is `.mp4`.",
-                                                "pattern": "([A-Za-z0-9_-]*\\.(mp4|webm|gif)$|\\$[A-Za-z0-9_]+)",
+                                                "format": "uri-reference"
+                                              },
+                                              "name": {
+                                                "type": "string",
+                                                "title": "Cookie name",
+                                                "description": "Name of the specific cookie to save.",
+                                                "pattern": "^[A-Za-z0-9_.-]+$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "variable": {
+                                                "type": "string",
+                                                "title": "Environment variable name",
+                                                "description": "Environment variable name to store the cookie as JSON string.",
+                                                "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "path": {
+                                                "type": "string",
+                                                "title": "Cookie file path",
+                                                "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
+                                                "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "directory": {
+                                                "type": "string",
+                                                "title": "Directory path",
+                                                "description": "Directory to save the cookie file. If not specified, uses output directory.",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "overwrite": {
+                                                "type": "boolean",
+                                                "title": "Overwrite existing file",
+                                                "description": "Whether to overwrite existing cookie file.",
+                                                "default": false
+                                              },
+                                              "domain": {
+                                                "type": "string",
+                                                "title": "Cookie domain",
+                                                "description": "Specific domain to filter the cookie by (optional).",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              }
+                                            },
+                                            "required": [
+                                              "name"
+                                            ],
+                                            "anyOf": [
+                                              {
+                                                "required": [
+                                                  "path"
+                                                ],
+                                                "not": {
+                                                  "required": [
+                                                    "variable"
+                                                  ]
+                                                }
+                                              },
+                                              {
+                                                "required": [
+                                                  "variable"
+                                                ],
+                                                "not": {
+                                                  "anyOf": [
+                                                    {
+                                                      "required": [
+                                                        "path"
+                                                      ]
+                                                    },
+                                                    {
+                                                      "required": [
+                                                        "directory"
+                                                      ]
+                                                    },
+                                                    {
+                                                      "required": [
+                                                        "overwrite"
+                                                      ]
+                                                    }
+                                                  ]
+                                                }
+                                              }
+                                            ],
+                                            "title": "Save cookie (detailed)"
+                                          }
+                                        ],
+                                        "components": {
+                                          "schemas": {
+                                            "string": {
+                                              "type": "string",
+                                              "title": "Cookie name",
+                                              "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
+                                              "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "object": {
+                                              "type": "object",
+                                              "additionalProperties": false,
+                                              "properties": {
+                                                "$schema": {
+                                                  "description": "Optional self-describing schema URI for linters",
+                                                  "type": "string",
+                                                  "format": "uri-reference"
+                                                },
+                                                "name": {
+                                                  "type": "string",
+                                                  "title": "Cookie name",
+                                                  "description": "Name of the specific cookie to save.",
+                                                  "pattern": "^[A-Za-z0-9_.-]+$",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                "variable": {
+                                                  "type": "string",
+                                                  "title": "Environment variable name",
+                                                  "description": "Environment variable name to store the cookie as JSON string.",
+                                                  "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                "path": {
+                                                  "type": "string",
+                                                  "title": "Cookie file path",
+                                                  "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
+                                                  "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                "directory": {
+                                                  "type": "string",
+                                                  "title": "Directory path",
+                                                  "description": "Directory to save the cookie file. If not specified, uses output directory.",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                "overwrite": {
+                                                  "type": "boolean",
+                                                  "title": "Overwrite existing file",
+                                                  "description": "Whether to overwrite existing cookie file.",
+                                                  "default": false
+                                                },
+                                                "domain": {
+                                                  "type": "string",
+                                                  "title": "Cookie domain",
+                                                  "description": "Specific domain to filter the cookie by (optional).",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                }
+                                              },
+                                              "required": [
+                                                "name"
+                                              ],
+                                              "anyOf": [
+                                                {
+                                                  "required": [
+                                                    "path"
+                                                  ],
+                                                  "not": {
+                                                    "required": [
+                                                      "variable"
+                                                    ]
+                                                  }
+                                                },
+                                                {
+                                                  "required": [
+                                                    "variable"
+                                                  ],
+                                                  "not": {
+                                                    "anyOf": [
+                                                      {
+                                                        "required": [
+                                                          "path"
+                                                        ]
+                                                      },
+                                                      {
+                                                        "required": [
+                                                          "directory"
+                                                        ]
+                                                      },
+                                                      {
+                                                        "required": [
+                                                          "overwrite"
+                                                        ]
+                                                      }
+                                                    ]
+                                                  }
+                                                }
+                                              ],
+                                              "title": "Save cookie (detailed)"
+                                            }
+                                          }
+                                        },
+                                        "examples": [
+                                          "session_token",
+                                          {
+                                            "name": "auth_cookie",
+                                            "path": "auth-cookie.txt"
+                                          },
+                                          {
+                                            "name": "session_token",
+                                            "variable": "SESSION_TOKEN"
+                                          },
+                                          {
+                                            "name": "user_session",
+                                            "path": "user-session.txt",
+                                            "directory": "./test-data",
+                                            "overwrite": true
+                                          },
+                                          {
+                                            "name": "login_token",
+                                            "path": "login-token.txt",
+                                            "domain": "app.example.com"
+                                          }
+                                        ]
+                                      }
+                                    },
+                                    "title": "saveCookie"
+                                  }
+                                ]
+                              },
+                              {
+                                "allOf": [
+                                  {
+                                    "type": "object",
+                                    "dynamicDefaults": {
+                                      "stepId": "uuid"
+                                    },
+                                    "properties": {
+                                      "$schema": {
+                                        "description": "JSON Schema for this object.",
+                                        "type": "string",
+                                        "enum": [
+                                          "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json"
+                                        ]
+                                      },
+                                      "stepId": {
+                                        "type": "string",
+                                        "description": "ID of the step."
+                                      },
+                                      "description": {
+                                        "type": "string",
+                                        "description": "Description of the step."
+                                      },
+                                      "unsafe": {
+                                        "type": "boolean",
+                                        "description": "Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.",
+                                        "default": false
+                                      },
+                                      "outputs": {
+                                        "type": "object",
+                                        "description": "Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.",
+                                        "default": {},
+                                        "patternProperties": {
+                                          "^[A-Za-z0-9_]+$": {
+                                            "type": "string",
+                                            "description": "Runtime expression for a user-defined output value."
+                                          }
+                                        },
+                                        "title": "Outputs (step)"
+                                      },
+                                      "variables": {
+                                        "type": "object",
+                                        "description": "Environment variables to set from user-defined expressions.",
+                                        "default": {},
+                                        "patternProperties": {
+                                          "^[A-Za-z0-9_]+$": {
+                                            "type": "string",
+                                            "description": "Runtime expression for a user-defined output value."
+                                          }
+                                        },
+                                        "title": "Variables (step)"
+                                      },
+                                      "breakpoint": {
+                                        "type": "boolean",
+                                        "description": "Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.",
+                                        "default": false
+                                      }
+                                    },
+                                    "title": "Common"
+                                  },
+                                  {
+                                    "type": "object",
+                                    "required": [
+                                      "record"
+                                    ],
+                                    "properties": {
+                                      "record": {
+                                        "$schema": "http://json-schema.org/draft-07/schema#",
+                                        "title": "record",
+                                        "description": "Start recording the current browser viewport. Must be followed by a `stopRecord` step. Only runs in Chrome browsers when they are visible. Supported extensions: [ '.mp4', '.webm', '.gif' ]",
+                                        "anyOf": [
+                                          {
+                                            "title": "Record (simple)",
+                                            "type": "string",
+                                            "description": "File path of the recording. Supports the `.mp4`, `.webm`, and `.gif` extensions. If not specified, the file name is the ID of the step, and the extension is `.mp4`.",
+                                            "pattern": "([A-Za-z0-9_-]*\\.(mp4|webm|gif)$|\\$[A-Za-z0-9_]+)",
+                                            "transform": [
+                                              "trim"
+                                            ]
+                                          },
+                                          {
+                                            "type": "object",
+                                            "properties": {
+                                              "path": {
+                                                "type": "string",
+                                                "description": "File path of the recording. Supports the `.mp4`, `.webm`, and `.gif` extensions. If not specified, the file name is the ID of the step, and the extension is `.mp4`.",
+                                                "pattern": "([A-Za-z0-9_-]*\\.(mp4|webm|gif)$|\\$[A-Za-z0-9_]+)",
                                                 "transform": [
                                                   "trim"
                                                 ]
@@ -16178,17 +17788,313 @@
                                     "title": "Common"
                                   },
                                   {
-                                    "title": "wait",
+                                    "title": "loadCookie",
                                     "type": "object",
                                     "required": [
-                                      "wait"
+                                      "loadCookie"
                                     ],
                                     "properties": {
-                                      "wait": {
+                                      "loadCookie": {
                                         "$schema": "http://json-schema.org/draft-07/schema#",
-                                        "title": "wait",
-                                        "description": "Pause (in milliseconds) before performing the next action.",
-                                        "default": 5000,
+                                        "title": "loadCookie",
+                                        "description": "Load a specific cookie from a file or environment variable into the browser.",
+                                        "anyOf": [
+                                          {
+                                            "type": "string",
+                                            "title": "Cookie name or file path",
+                                            "description": "Name of the specific cookie to load from default location, or file path to cookie file.",
+                                            "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                            "transform": [
+                                              "trim"
+                                            ]
+                                          },
+                                          {
+                                            "type": "object",
+                                            "additionalProperties": false,
+                                            "required": [
+                                              "name"
+                                            ],
+                                            "anyOf": [
+                                              {
+                                                "required": [
+                                                  "path"
+                                                ],
+                                                "not": {
+                                                  "required": [
+                                                    "variable"
+                                                  ]
+                                                }
+                                              },
+                                              {
+                                                "required": [
+                                                  "variable"
+                                                ],
+                                                "not": {
+                                                  "anyOf": [
+                                                    {
+                                                      "required": [
+                                                        "path"
+                                                      ]
+                                                    },
+                                                    {
+                                                      "required": [
+                                                        "directory"
+                                                      ]
+                                                    }
+                                                  ]
+                                                }
+                                              }
+                                            ],
+                                            "properties": {
+                                              "$schema": {
+                                                "description": "Optional self-describing schema URI for linters",
+                                                "type": "string",
+                                                "format": "uri-reference"
+                                              },
+                                              "name": {
+                                                "type": "string",
+                                                "title": "Cookie name",
+                                                "description": "Name of the specific cookie to load.",
+                                                "pattern": "^[A-Za-z0-9_.-]+$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "variable": {
+                                                "type": "string",
+                                                "title": "Environment variable name",
+                                                "description": "Environment variable name containing the cookie as JSON string.",
+                                                "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "path": {
+                                                "type": "string",
+                                                "title": "Cookie file path",
+                                                "description": "File path to cookie file, relative to directory. Supports Netscape cookie format.",
+                                                "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "directory": {
+                                                "type": "string",
+                                                "title": "Directory path",
+                                                "description": "Directory containing the cookie file.",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              },
+                                              "domain": {
+                                                "type": "string",
+                                                "title": "Cookie domain",
+                                                "description": "Specific domain to filter the cookie by when loading from multi-cookie file (optional).",
+                                                "transform": [
+                                                  "trim"
+                                                ]
+                                              }
+                                            },
+                                            "title": "Load cookie (detailed)"
+                                          }
+                                        ],
+                                        "components": {
+                                          "schemas": {
+                                            "string": {
+                                              "type": "string",
+                                              "title": "Cookie name or file path",
+                                              "description": "Name of the specific cookie to load from default location, or file path to cookie file.",
+                                              "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                              "transform": [
+                                                "trim"
+                                              ]
+                                            },
+                                            "object": {
+                                              "type": "object",
+                                              "additionalProperties": false,
+                                              "required": [
+                                                "name"
+                                              ],
+                                              "anyOf": [
+                                                {
+                                                  "required": [
+                                                    "path"
+                                                  ],
+                                                  "not": {
+                                                    "required": [
+                                                      "variable"
+                                                    ]
+                                                  }
+                                                },
+                                                {
+                                                  "required": [
+                                                    "variable"
+                                                  ],
+                                                  "not": {
+                                                    "anyOf": [
+                                                      {
+                                                        "required": [
+                                                          "path"
+                                                        ]
+                                                      },
+                                                      {
+                                                        "required": [
+                                                          "directory"
+                                                        ]
+                                                      }
+                                                    ]
+                                                  }
+                                                }
+                                              ],
+                                              "properties": {
+                                                "$schema": {
+                                                  "description": "Optional self-describing schema URI for linters",
+                                                  "type": "string",
+                                                  "format": "uri-reference"
+                                                },
+                                                "name": {
+                                                  "type": "string",
+                                                  "title": "Cookie name",
+                                                  "description": "Name of the specific cookie to load.",
+                                                  "pattern": "^[A-Za-z0-9_.-]+$",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                "variable": {
+                                                  "type": "string",
+                                                  "title": "Environment variable name",
+                                                  "description": "Environment variable name containing the cookie as JSON string.",
+                                                  "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                "path": {
+                                                  "type": "string",
+                                                  "title": "Cookie file path",
+                                                  "description": "File path to cookie file, relative to directory. Supports Netscape cookie format.",
+                                                  "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                "directory": {
+                                                  "type": "string",
+                                                  "title": "Directory path",
+                                                  "description": "Directory containing the cookie file.",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                "domain": {
+                                                  "type": "string",
+                                                  "title": "Cookie domain",
+                                                  "description": "Specific domain to filter the cookie by when loading from multi-cookie file (optional).",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                }
+                                              },
+                                              "title": "Load cookie (detailed)"
+                                            }
+                                          }
+                                        },
+                                        "examples": [
+                                          "session_token",
+                                          "./test-data/auth-session.txt",
+                                          {
+                                            "name": "auth_cookie",
+                                            "variable": "AUTH_COOKIE"
+                                          },
+                                          {
+                                            "name": "session_token",
+                                            "path": "session-token.txt",
+                                            "directory": "./test-data"
+                                          },
+                                          {
+                                            "name": "user_session",
+                                            "path": "saved-cookies.txt",
+                                            "domain": "app.example.com"
+                                          }
+                                        ]
+                                      }
+                                    }
+                                  }
+                                ]
+                              },
+                              {
+                                "allOf": [
+                                  {
+                                    "type": "object",
+                                    "dynamicDefaults": {
+                                      "stepId": "uuid"
+                                    },
+                                    "properties": {
+                                      "$schema": {
+                                        "description": "JSON Schema for this object.",
+                                        "type": "string",
+                                        "enum": [
+                                          "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json"
+                                        ]
+                                      },
+                                      "stepId": {
+                                        "type": "string",
+                                        "description": "ID of the step."
+                                      },
+                                      "description": {
+                                        "type": "string",
+                                        "description": "Description of the step."
+                                      },
+                                      "unsafe": {
+                                        "type": "boolean",
+                                        "description": "Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.",
+                                        "default": false
+                                      },
+                                      "outputs": {
+                                        "type": "object",
+                                        "description": "Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.",
+                                        "default": {},
+                                        "patternProperties": {
+                                          "^[A-Za-z0-9_]+$": {
+                                            "type": "string",
+                                            "description": "Runtime expression for a user-defined output value."
+                                          }
+                                        },
+                                        "title": "Outputs (step)"
+                                      },
+                                      "variables": {
+                                        "type": "object",
+                                        "description": "Environment variables to set from user-defined expressions.",
+                                        "default": {},
+                                        "patternProperties": {
+                                          "^[A-Za-z0-9_]+$": {
+                                            "type": "string",
+                                            "description": "Runtime expression for a user-defined output value."
+                                          }
+                                        },
+                                        "title": "Variables (step)"
+                                      },
+                                      "breakpoint": {
+                                        "type": "boolean",
+                                        "description": "Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.",
+                                        "default": false
+                                      }
+                                    },
+                                    "title": "Common"
+                                  },
+                                  {
+                                    "title": "wait",
+                                    "type": "object",
+                                    "required": [
+                                      "wait"
+                                    ],
+                                    "properties": {
+                                      "wait": {
+                                        "$schema": "http://json-schema.org/draft-07/schema#",
+                                        "title": "wait",
+                                        "description": "Pause (in milliseconds) before performing the next action.",
+                                        "default": 5000,
                                         "anyOf": [
                                           {
                                             "type": "number",
@@ -16356,6 +18262,27 @@
                               {
                                 "loadVariables": "variables.env"
                               },
+                              {
+                                "saveCookie": "session_token"
+                              },
+                              {
+                                "saveCookie": {
+                                  "name": "auth_cookie",
+                                  "path": "auth-session.txt",
+                                  "directory": "./test-data",
+                                  "overwrite": true
+                                }
+                              },
+                              {
+                                "loadCookie": "session_token"
+                              },
+                              {
+                                "loadCookie": {
+                                  "name": "auth_cookie",
+                                  "path": "auth-session.txt",
+                                  "directory": "./test-data"
+                                }
+                              },
                               {
                                 "find": "Find me!"
                               },
@@ -20566,38 +22493,360 @@
                                                 "static/images/image.png",
                                                 "/User/manny/projects/doc-detective/static/images/image.png",
                                                 {
-                                                  "path": "image.png",
-                                                  "directory": "static/images",
-                                                  "maxVariation": 0.1,
-                                                  "overwrite": "aboveVariation",
-                                                  "crop": "#elementToScreenshot"
+                                                  "path": "image.png",
+                                                  "directory": "static/images",
+                                                  "maxVariation": 0.1,
+                                                  "overwrite": "aboveVariation",
+                                                  "crop": "#elementToScreenshot"
+                                                },
+                                                {
+                                                  "path": "image.png",
+                                                  "directory": "static/images",
+                                                  "maxVariation": 0.1,
+                                                  "overwrite": "aboveVariation"
+                                                },
+                                                {
+                                                  "path": "image.png",
+                                                  "directory": "static/images",
+                                                  "maxVariation": 0.1,
+                                                  "overwrite": "aboveVariation",
+                                                  "crop": {
+                                                    "selector": "#elementToScreenshot",
+                                                    "elementText": "Element text",
+                                                    "padding": {
+                                                      "top": 0,
+                                                      "right": 0,
+                                                      "bottom": 0,
+                                                      "left": 0
+                                                    }
+                                                  }
+                                                }
+                                              ]
+                                            }
+                                          },
+                                          "title": "screenshot"
+                                        }
+                                      ]
+                                    },
+                                    {
+                                      "allOf": [
+                                        {
+                                          "type": "object",
+                                          "dynamicDefaults": {
+                                            "stepId": "uuid"
+                                          },
+                                          "properties": {
+                                            "$schema": {
+                                              "description": "JSON Schema for this object.",
+                                              "type": "string",
+                                              "enum": [
+                                                "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json"
+                                              ]
+                                            },
+                                            "stepId": {
+                                              "type": "string",
+                                              "description": "ID of the step."
+                                            },
+                                            "description": {
+                                              "type": "string",
+                                              "description": "Description of the step."
+                                            },
+                                            "unsafe": {
+                                              "type": "boolean",
+                                              "description": "Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.",
+                                              "default": false
+                                            },
+                                            "outputs": {
+                                              "type": "object",
+                                              "description": "Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.",
+                                              "default": {},
+                                              "patternProperties": {
+                                                "^[A-Za-z0-9_]+$": {
+                                                  "type": "string",
+                                                  "description": "Runtime expression for a user-defined output value."
+                                                }
+                                              },
+                                              "title": "Outputs (step)"
+                                            },
+                                            "variables": {
+                                              "type": "object",
+                                              "description": "Environment variables to set from user-defined expressions.",
+                                              "default": {},
+                                              "patternProperties": {
+                                                "^[A-Za-z0-9_]+$": {
+                                                  "type": "string",
+                                                  "description": "Runtime expression for a user-defined output value."
+                                                }
+                                              },
+                                              "title": "Variables (step)"
+                                            },
+                                            "breakpoint": {
+                                              "type": "boolean",
+                                              "description": "Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.",
+                                              "default": false
+                                            }
+                                          },
+                                          "title": "Common"
+                                        },
+                                        {
+                                          "type": "object",
+                                          "required": [
+                                            "saveCookie"
+                                          ],
+                                          "properties": {
+                                            "saveCookie": {
+                                              "$schema": "http://json-schema.org/draft-07/schema#",
+                                              "title": "saveCookie",
+                                              "description": "Save a specific browser cookie to a file or environment variable for later reuse.",
+                                              "anyOf": [
+                                                {
+                                                  "type": "string",
+                                                  "title": "Cookie name",
+                                                  "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
+                                                  "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                {
+                                                  "type": "object",
+                                                  "additionalProperties": false,
+                                                  "properties": {
+                                                    "$schema": {
+                                                      "description": "Optional self-describing schema URI for linters",
+                                                      "type": "string",
+                                                      "format": "uri-reference"
+                                                    },
+                                                    "name": {
+                                                      "type": "string",
+                                                      "title": "Cookie name",
+                                                      "description": "Name of the specific cookie to save.",
+                                                      "pattern": "^[A-Za-z0-9_.-]+$",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    "variable": {
+                                                      "type": "string",
+                                                      "title": "Environment variable name",
+                                                      "description": "Environment variable name to store the cookie as JSON string.",
+                                                      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    "path": {
+                                                      "type": "string",
+                                                      "title": "Cookie file path",
+                                                      "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
+                                                      "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    "directory": {
+                                                      "type": "string",
+                                                      "title": "Directory path",
+                                                      "description": "Directory to save the cookie file. If not specified, uses output directory.",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    "overwrite": {
+                                                      "type": "boolean",
+                                                      "title": "Overwrite existing file",
+                                                      "description": "Whether to overwrite existing cookie file.",
+                                                      "default": false
+                                                    },
+                                                    "domain": {
+                                                      "type": "string",
+                                                      "title": "Cookie domain",
+                                                      "description": "Specific domain to filter the cookie by (optional).",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    }
+                                                  },
+                                                  "required": [
+                                                    "name"
+                                                  ],
+                                                  "anyOf": [
+                                                    {
+                                                      "required": [
+                                                        "path"
+                                                      ],
+                                                      "not": {
+                                                        "required": [
+                                                          "variable"
+                                                        ]
+                                                      }
+                                                    },
+                                                    {
+                                                      "required": [
+                                                        "variable"
+                                                      ],
+                                                      "not": {
+                                                        "anyOf": [
+                                                          {
+                                                            "required": [
+                                                              "path"
+                                                            ]
+                                                          },
+                                                          {
+                                                            "required": [
+                                                              "directory"
+                                                            ]
+                                                          },
+                                                          {
+                                                            "required": [
+                                                              "overwrite"
+                                                            ]
+                                                          }
+                                                        ]
+                                                      }
+                                                    }
+                                                  ],
+                                                  "title": "Save cookie (detailed)"
+                                                }
+                                              ],
+                                              "components": {
+                                                "schemas": {
+                                                  "string": {
+                                                    "type": "string",
+                                                    "title": "Cookie name",
+                                                    "description": "Name of the specific cookie to save. Will be saved to a default file path or environment variable.",
+                                                    "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                                    "transform": [
+                                                      "trim"
+                                                    ]
+                                                  },
+                                                  "object": {
+                                                    "type": "object",
+                                                    "additionalProperties": false,
+                                                    "properties": {
+                                                      "$schema": {
+                                                        "description": "Optional self-describing schema URI for linters",
+                                                        "type": "string",
+                                                        "format": "uri-reference"
+                                                      },
+                                                      "name": {
+                                                        "type": "string",
+                                                        "title": "Cookie name",
+                                                        "description": "Name of the specific cookie to save.",
+                                                        "pattern": "^[A-Za-z0-9_.-]+$",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      "variable": {
+                                                        "type": "string",
+                                                        "title": "Environment variable name",
+                                                        "description": "Environment variable name to store the cookie as JSON string.",
+                                                        "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      "path": {
+                                                        "type": "string",
+                                                        "title": "Cookie file path",
+                                                        "description": "File path to save the cookie, relative to directory. Uses Netscape cookie format.",
+                                                        "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      "directory": {
+                                                        "type": "string",
+                                                        "title": "Directory path",
+                                                        "description": "Directory to save the cookie file. If not specified, uses output directory.",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      "overwrite": {
+                                                        "type": "boolean",
+                                                        "title": "Overwrite existing file",
+                                                        "description": "Whether to overwrite existing cookie file.",
+                                                        "default": false
+                                                      },
+                                                      "domain": {
+                                                        "type": "string",
+                                                        "title": "Cookie domain",
+                                                        "description": "Specific domain to filter the cookie by (optional).",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      }
+                                                    },
+                                                    "required": [
+                                                      "name"
+                                                    ],
+                                                    "anyOf": [
+                                                      {
+                                                        "required": [
+                                                          "path"
+                                                        ],
+                                                        "not": {
+                                                          "required": [
+                                                            "variable"
+                                                          ]
+                                                        }
+                                                      },
+                                                      {
+                                                        "required": [
+                                                          "variable"
+                                                        ],
+                                                        "not": {
+                                                          "anyOf": [
+                                                            {
+                                                              "required": [
+                                                                "path"
+                                                              ]
+                                                            },
+                                                            {
+                                                              "required": [
+                                                                "directory"
+                                                              ]
+                                                            },
+                                                            {
+                                                              "required": [
+                                                                "overwrite"
+                                                              ]
+                                                            }
+                                                          ]
+                                                        }
+                                                      }
+                                                    ],
+                                                    "title": "Save cookie (detailed)"
+                                                  }
+                                                }
+                                              },
+                                              "examples": [
+                                                "session_token",
+                                                {
+                                                  "name": "auth_cookie",
+                                                  "path": "auth-cookie.txt"
+                                                },
+                                                {
+                                                  "name": "session_token",
+                                                  "variable": "SESSION_TOKEN"
                                                 },
                                                 {
-                                                  "path": "image.png",
-                                                  "directory": "static/images",
-                                                  "maxVariation": 0.1,
-                                                  "overwrite": "aboveVariation"
+                                                  "name": "user_session",
+                                                  "path": "user-session.txt",
+                                                  "directory": "./test-data",
+                                                  "overwrite": true
                                                 },
                                                 {
-                                                  "path": "image.png",
-                                                  "directory": "static/images",
-                                                  "maxVariation": 0.1,
-                                                  "overwrite": "aboveVariation",
-                                                  "crop": {
-                                                    "selector": "#elementToScreenshot",
-                                                    "elementText": "Element text",
-                                                    "padding": {
-                                                      "top": 0,
-                                                      "right": 0,
-                                                      "bottom": 0,
-                                                      "left": 0
-                                                    }
-                                                  }
+                                                  "name": "login_token",
+                                                  "path": "login-token.txt",
+                                                  "domain": "app.example.com"
                                                 }
                                               ]
                                             }
                                           },
-                                          "title": "screenshot"
+                                          "title": "saveCookie"
                                         }
                                       ]
                                     },
@@ -20938,6 +23187,302 @@
                                         }
                                       ]
                                     },
+                                    {
+                                      "allOf": [
+                                        {
+                                          "type": "object",
+                                          "dynamicDefaults": {
+                                            "stepId": "uuid"
+                                          },
+                                          "properties": {
+                                            "$schema": {
+                                              "description": "JSON Schema for this object.",
+                                              "type": "string",
+                                              "enum": [
+                                                "https://raw.githubusercontent.com/doc-detective/common/refs/heads/main/dist/schemas/step_v3.schema.json"
+                                              ]
+                                            },
+                                            "stepId": {
+                                              "type": "string",
+                                              "description": "ID of the step."
+                                            },
+                                            "description": {
+                                              "type": "string",
+                                              "description": "Description of the step."
+                                            },
+                                            "unsafe": {
+                                              "type": "boolean",
+                                              "description": "Whether or not the step may be unsafe. Unsafe steps may perform actions that could modify the system or environment in unexpected ways. Unsafe steps are only performed within Docker containers or if unsafe steps are enabled with the `allowUnsafeSteps` config property or the `--allow-unsafe` flag.",
+                                              "default": false
+                                            },
+                                            "outputs": {
+                                              "type": "object",
+                                              "description": "Outputs from step processes and user-defined expressions. Use the `outputs` object to reference outputs in subsequent steps. If a user-defined output matches the key for a step-defined output, the user-defined output takes precedence.",
+                                              "default": {},
+                                              "patternProperties": {
+                                                "^[A-Za-z0-9_]+$": {
+                                                  "type": "string",
+                                                  "description": "Runtime expression for a user-defined output value."
+                                                }
+                                              },
+                                              "title": "Outputs (step)"
+                                            },
+                                            "variables": {
+                                              "type": "object",
+                                              "description": "Environment variables to set from user-defined expressions.",
+                                              "default": {},
+                                              "patternProperties": {
+                                                "^[A-Za-z0-9_]+$": {
+                                                  "type": "string",
+                                                  "description": "Runtime expression for a user-defined output value."
+                                                }
+                                              },
+                                              "title": "Variables (step)"
+                                            },
+                                            "breakpoint": {
+                                              "type": "boolean",
+                                              "description": "Whether or not this step should act as a breakpoint when debugging is enabled. When `true`, execution will pause at this step when debug mode is enabled.",
+                                              "default": false
+                                            }
+                                          },
+                                          "title": "Common"
+                                        },
+                                        {
+                                          "title": "loadCookie",
+                                          "type": "object",
+                                          "required": [
+                                            "loadCookie"
+                                          ],
+                                          "properties": {
+                                            "loadCookie": {
+                                              "$schema": "http://json-schema.org/draft-07/schema#",
+                                              "title": "loadCookie",
+                                              "description": "Load a specific cookie from a file or environment variable into the browser.",
+                                              "anyOf": [
+                                                {
+                                                  "type": "string",
+                                                  "title": "Cookie name or file path",
+                                                  "description": "Name of the specific cookie to load from default location, or file path to cookie file.",
+                                                  "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                                  "transform": [
+                                                    "trim"
+                                                  ]
+                                                },
+                                                {
+                                                  "type": "object",
+                                                  "additionalProperties": false,
+                                                  "required": [
+                                                    "name"
+                                                  ],
+                                                  "anyOf": [
+                                                    {
+                                                      "required": [
+                                                        "path"
+                                                      ],
+                                                      "not": {
+                                                        "required": [
+                                                          "variable"
+                                                        ]
+                                                      }
+                                                    },
+                                                    {
+                                                      "required": [
+                                                        "variable"
+                                                      ],
+                                                      "not": {
+                                                        "anyOf": [
+                                                          {
+                                                            "required": [
+                                                              "path"
+                                                            ]
+                                                          },
+                                                          {
+                                                            "required": [
+                                                              "directory"
+                                                            ]
+                                                          }
+                                                        ]
+                                                      }
+                                                    }
+                                                  ],
+                                                  "properties": {
+                                                    "$schema": {
+                                                      "description": "Optional self-describing schema URI for linters",
+                                                      "type": "string",
+                                                      "format": "uri-reference"
+                                                    },
+                                                    "name": {
+                                                      "type": "string",
+                                                      "title": "Cookie name",
+                                                      "description": "Name of the specific cookie to load.",
+                                                      "pattern": "^[A-Za-z0-9_.-]+$",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    "variable": {
+                                                      "type": "string",
+                                                      "title": "Environment variable name",
+                                                      "description": "Environment variable name containing the cookie as JSON string.",
+                                                      "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    "path": {
+                                                      "type": "string",
+                                                      "title": "Cookie file path",
+                                                      "description": "File path to cookie file, relative to directory. Supports Netscape cookie format.",
+                                                      "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    "directory": {
+                                                      "type": "string",
+                                                      "title": "Directory path",
+                                                      "description": "Directory containing the cookie file.",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    },
+                                                    "domain": {
+                                                      "type": "string",
+                                                      "title": "Cookie domain",
+                                                      "description": "Specific domain to filter the cookie by when loading from multi-cookie file (optional).",
+                                                      "transform": [
+                                                        "trim"
+                                                      ]
+                                                    }
+                                                  },
+                                                  "title": "Load cookie (detailed)"
+                                                }
+                                              ],
+                                              "components": {
+                                                "schemas": {
+                                                  "string": {
+                                                    "type": "string",
+                                                    "title": "Cookie name or file path",
+                                                    "description": "Name of the specific cookie to load from default location, or file path to cookie file.",
+                                                    "pattern": "^[A-Za-z0-9_./\\-]+$",
+                                                    "transform": [
+                                                      "trim"
+                                                    ]
+                                                  },
+                                                  "object": {
+                                                    "type": "object",
+                                                    "additionalProperties": false,
+                                                    "required": [
+                                                      "name"
+                                                    ],
+                                                    "anyOf": [
+                                                      {
+                                                        "required": [
+                                                          "path"
+                                                        ],
+                                                        "not": {
+                                                          "required": [
+                                                            "variable"
+                                                          ]
+                                                        }
+                                                      },
+                                                      {
+                                                        "required": [
+                                                          "variable"
+                                                        ],
+                                                        "not": {
+                                                          "anyOf": [
+                                                            {
+                                                              "required": [
+                                                                "path"
+                                                              ]
+                                                            },
+                                                            {
+                                                              "required": [
+                                                                "directory"
+                                                              ]
+                                                            }
+                                                          ]
+                                                        }
+                                                      }
+                                                    ],
+                                                    "properties": {
+                                                      "$schema": {
+                                                        "description": "Optional self-describing schema URI for linters",
+                                                        "type": "string",
+                                                        "format": "uri-reference"
+                                                      },
+                                                      "name": {
+                                                        "type": "string",
+                                                        "title": "Cookie name",
+                                                        "description": "Name of the specific cookie to load.",
+                                                        "pattern": "^[A-Za-z0-9_.-]+$",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      "variable": {
+                                                        "type": "string",
+                                                        "title": "Environment variable name",
+                                                        "description": "Environment variable name containing the cookie as JSON string.",
+                                                        "pattern": "^[A-Za-z_][A-Za-z0-9_]*$",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      "path": {
+                                                        "type": "string",
+                                                        "title": "Cookie file path",
+                                                        "description": "File path to cookie file, relative to directory. Supports Netscape cookie format.",
+                                                        "pattern": "^(?:[A-Za-z0-9_.-]+\\.(?:txt|cookies)|\\$[A-Za-z_][A-Za-z0-9_]*)$",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      "directory": {
+                                                        "type": "string",
+                                                        "title": "Directory path",
+                                                        "description": "Directory containing the cookie file.",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      },
+                                                      "domain": {
+                                                        "type": "string",
+                                                        "title": "Cookie domain",
+                                                        "description": "Specific domain to filter the cookie by when loading from multi-cookie file (optional).",
+                                                        "transform": [
+                                                          "trim"
+                                                        ]
+                                                      }
+                                                    },
+                                                    "title": "Load cookie (detailed)"
+                                                  }
+                                                }
+                                              },
+                                              "examples": [
+                                                "session_token",
+                                                "./test-data/auth-session.txt",
+                                                {
+                                                  "name": "auth_cookie",
+                                                  "variable": "AUTH_COOKIE"
+                                                },
+                                                {
+                                                  "name": "session_token",
+                                                  "path": "session-token.txt",
+                                                  "directory": "./test-data"
+                                                },
+                                                {
+                                                  "name": "user_session",
+                                                  "path": "saved-cookies.txt",
+                                                  "domain": "app.example.com"
+                                                }
+                                              ]
+                                            }
+                                          }
+                                        }
+                                      ]
+                                    },
                                     {
                                       "allOf": [
                                         {
@@ -21177,6 +23722,27 @@
                                     {
                                       "loadVariables": "variables.env"
                                     },
+                                    {
+                                      "saveCookie": "session_token"
+                                    },
+                                    {
+                                      "saveCookie": {
+                                        "name": "auth_cookie",
+                                        "path": "auth-session.txt",
+                                        "directory": "./test-data",
+                                        "overwrite": true
+                                      }
+                                    },
+                                    {
+                                      "loadCookie": "session_token"
+                                    },
+                                    {
+                                      "loadCookie": {
+                                        "name": "auth_cookie",
+                                        "path": "auth-session.txt",
+                                        "directory": "./test-data"
+                                      }
+                                    },
                                     {
                                       "find": "Find me!"
                                     },