current viewpoint screenshot and scrolling n screenshot (#2716)

Co-authored-by: lawyzheng <lawyzheng1106@gmail.com>

skyvern/schemas/runs.py

@@ -279,6 +279,10 @@ class TaskRunRequest(BaseModel):
     include_action_history_in_verification: bool | None = Field(
         default=False, description="Whether to include action history when verifying that the task is complete"
     )
+    max_screenshot_scrolling_times: int | None = Field(
+        default=None,
+        description="Scroll down n times to get the merged screenshot of the page after taking an action. When it's None or 0, it takes the current viewpoint screenshot.",
+    )
 
     @field_validator("url", "webhook_url", "totp_url")
     @classmethod
@@ -326,6 +330,10 @@ class WorkflowRunRequest(BaseModel):
         default=None,
         description="ID of a Skyvern browser session to reuse, having it continue from the current screen state",
     )
+    max_screenshot_scrolling_times: int | None = Field(
+        default=None,
+        description="Scroll down n times to get the merged screenshot of the page after taking an action. When it's None or 0, it takes the current viewpoint screenshot.",
+    )
 
     @field_validator("webhook_url", "totp_url")
     @classmethod
@@ -368,9 +376,11 @@ class BaseRunResponse(BaseModel):
         examples=["https://app.skyvern.com/tasks/tsk_123", "https://app.skyvern.com/workflows/wpid_123/wr_123"],
     )
     browser_session_id: str | None = Field(
+        default=None, description="ID of the Skyvern persistent browser session used for this run", examples=["pbs_123"]
+    )
+    max_screenshot_scrolling_times: int | None = Field(
         default=None,
-        description="ID of the Skyvern persistent browser session used for this run",
-        examples=["pbs_123"],
+        description="Scroll down n times to get the merged screenshot of the page after taking an action. When it's NONE or 0, it takes the current view point screenshot.",
     )