feat: Update param and response views

stainless-app[bot] · stainless-app[bot] · commit 44b4c5d7ed41 · 2025-08-17T18:06:40.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 26
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browser-use%2Fbrowser-use-d20f308ac3a63b1ea5749dac763fd846481c9723156a5653c1d03669e73d5b5e.yml
-openapi_spec_hash: ccf5babfe92a776213a3e5097a7cd546
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browser-use%2Fbrowser-use-758a1c052b93e7e478fa650c1748f4b466653f44cb26f97fef1314c7a96924df.yml
+openapi_spec_hash: 9e0e99b613f2b9bf3993ac36aa0c7911
 config_hash: 9d52be5177b2ede4cb0633c04f4cc4ef
diff --git a/api.md b/api.md
@@ -64,7 +64,7 @@ from browser_use_sdk.types import SessionStatus, SessionView, SessionListRespons
 
 Methods:
 
-- <code title="get /sessions/{session_id}">client.sessions.<a href="./src/browser_use_sdk/resources/sessions/sessions.py">retrieve</a>(session_id, \*\*<a href="src/browser_use_sdk/types/session_retrieve_params.py">params</a>) -> <a href="./src/browser_use_sdk/types/session_view.py">SessionView</a></code>
+- <code title="get /sessions/{session_id}">client.sessions.<a href="./src/browser_use_sdk/resources/sessions/sessions.py">retrieve</a>(session_id) -> <a href="./src/browser_use_sdk/types/session_view.py">SessionView</a></code>
 - <code title="patch /sessions/{session_id}">client.sessions.<a href="./src/browser_use_sdk/resources/sessions/sessions.py">update</a>(session_id, \*\*<a href="src/browser_use_sdk/types/session_update_params.py">params</a>) -> <a href="./src/browser_use_sdk/types/session_view.py">SessionView</a></code>
 - <code title="get /sessions">client.sessions.<a href="./src/browser_use_sdk/resources/sessions/sessions.py">list</a>(\*\*<a href="src/browser_use_sdk/types/session_list_params.py">params</a>) -> <a href="./src/browser_use_sdk/types/session_list_response.py">SessionListResponse</a></code>
 - <code title="delete /sessions/{session_id}">client.sessions.<a href="./src/browser_use_sdk/resources/sessions/sessions.py">delete</a>(session_id) -> None</code>
diff --git a/src/browser_use_sdk/resources/sessions/sessions.py b/src/browser_use_sdk/resources/sessions/sessions.py
@@ -7,7 +7,7 @@
 
 import httpx
 
-from ...types import SessionStatus, session_list_params, session_update_params, session_retrieve_params
+from ...types import SessionStatus, session_list_params, session_update_params
 from ..._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
 from ..._utils import maybe_transform, async_maybe_transform
 from ..._compat import cached_property
@@ -62,7 +62,6 @@ def retrieve(
         self,
         session_id: str,
         *,
-        include_tasks: bool | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -105,11 +104,7 @@ def retrieve(
         return self._get(
             f"/sessions/{session_id}",
             options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform({"include_tasks": include_tasks}, session_retrieve_params.SessionRetrieveParams),
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
             cast_to=SessionView,
         )
@@ -181,7 +176,6 @@ def list(
         self,
         *,
         filter_by: Optional[SessionStatus] | NotGiven = NOT_GIVEN,
-        include_tasks: bool | NotGiven = NOT_GIVEN,
         page_number: int | NotGiven = NOT_GIVEN,
         page_size: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -232,7 +226,6 @@ def list(
                 query=maybe_transform(
                     {
                         "filter_by": filter_by,
-                        "include_tasks": include_tasks,
                         "page_number": page_number,
                         "page_size": page_size,
                     },
@@ -317,7 +310,6 @@ async def retrieve(
         self,
         session_id: str,
         *,
-        include_tasks: bool | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -360,13 +352,7 @@ async def retrieve(
         return await self._get(
             f"/sessions/{session_id}",
             options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {"include_tasks": include_tasks}, session_retrieve_params.SessionRetrieveParams
-                ),
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
             cast_to=SessionView,
         )
@@ -438,7 +424,6 @@ async def list(
         self,
         *,
         filter_by: Optional[SessionStatus] | NotGiven = NOT_GIVEN,
-        include_tasks: bool | NotGiven = NOT_GIVEN,
         page_number: int | NotGiven = NOT_GIVEN,
         page_size: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -489,7 +474,6 @@ async def list(
                 query=await async_maybe_transform(
                     {
                         "filter_by": filter_by,
-                        "include_tasks": include_tasks,
                         "page_number": page_number,
                         "page_size": page_size,
                     },
diff --git a/src/browser_use_sdk/resources/tasks.py b/src/browser_use_sdk/resources/tasks.py
@@ -281,9 +281,6 @@ def list(
         *,
         filter_by: Optional[Literal["started", "paused", "stopped", "finished", "successful", "unsuccessful"]]
         | NotGiven = NOT_GIVEN,
-        include_output_files: bool | NotGiven = NOT_GIVEN,
-        include_steps: bool | NotGiven = NOT_GIVEN,
-        include_user_uploaded_files: bool | NotGiven = NOT_GIVEN,
         page_number: int | NotGiven = NOT_GIVEN,
         page_size: int | NotGiven = NOT_GIVEN,
         session_id: Optional[str] | NotGiven = NOT_GIVEN,
@@ -340,9 +337,6 @@ def list(
                 query=maybe_transform(
                     {
                         "filter_by": filter_by,
-                        "include_output_files": include_output_files,
-                        "include_steps": include_steps,
-                        "include_user_uploaded_files": include_user_uploaded_files,
                         "page_number": page_number,
                         "page_size": page_size,
                         "session_id": session_id,
@@ -784,9 +778,6 @@ async def list(
         *,
         filter_by: Optional[Literal["started", "paused", "stopped", "finished", "successful", "unsuccessful"]]
         | NotGiven = NOT_GIVEN,
-        include_output_files: bool | NotGiven = NOT_GIVEN,
-        include_steps: bool | NotGiven = NOT_GIVEN,
-        include_user_uploaded_files: bool | NotGiven = NOT_GIVEN,
         page_number: int | NotGiven = NOT_GIVEN,
         page_size: int | NotGiven = NOT_GIVEN,
         session_id: Optional[str] | NotGiven = NOT_GIVEN,
@@ -843,9 +834,6 @@ async def list(
                 query=await async_maybe_transform(
                     {
                         "filter_by": filter_by,
-                        "include_output_files": include_output_files,
-                        "include_steps": include_steps,
-                        "include_user_uploaded_files": include_user_uploaded_files,
                         "page_number": page_number,
                         "page_size": page_size,
                         "session_id": session_id,
diff --git a/src/browser_use_sdk/types/__init__.py b/src/browser_use_sdk/types/__init__.py
@@ -22,7 +22,6 @@
 from .session_list_response import SessionListResponse as SessionListResponse
 from .session_update_params import SessionUpdateParams as SessionUpdateParams
 from .task_get_logs_response import TaskGetLogsResponse as TaskGetLogsResponse
-from .session_retrieve_params import SessionRetrieveParams as SessionRetrieveParams
 from .agent_profile_list_params import AgentProfileListParams as AgentProfileListParams
 from .agent_profile_create_params import AgentProfileCreateParams as AgentProfileCreateParams
 from .agent_profile_list_response import AgentProfileListResponse as AgentProfileListResponse
diff --git a/src/browser_use_sdk/types/session_list_params.py b/src/browser_use_sdk/types/session_list_params.py
@@ -19,8 +19,6 @@ class SessionListParams(TypedDict, total=False):
     STOPPED: Session has been stopped and is no longer active (browser is stopped)
     """
 
-    include_tasks: Annotated[bool, PropertyInfo(alias="includeTasks")]
-
     page_number: Annotated[int, PropertyInfo(alias="pageNumber")]
 
     page_size: Annotated[int, PropertyInfo(alias="pageSize")]
diff --git a/src/browser_use_sdk/types/session_list_response.py b/src/browser_use_sdk/types/session_list_response.py
@@ -7,7 +7,6 @@
 
 from .._models import BaseModel
 from .session_status import SessionStatus
-from .task_item_view import TaskItemView
 
 __all__ = ["SessionListResponse", "Item"]
 
@@ -28,8 +27,6 @@ class Item(BaseModel):
 
     live_url: Optional[str] = FieldInfo(alias="liveUrl", default=None)
 
-    tasks: Optional[List[TaskItemView]] = None
-
 
 class SessionListResponse(BaseModel):
     items: List[Item]
diff --git a/src/browser_use_sdk/types/session_retrieve_params.py b/src/browser_use_sdk/types/session_retrieve_params.py
diff --git a/src/browser_use_sdk/types/task_get_output_file_response.py b/src/browser_use_sdk/types/task_get_output_file_response.py
@@ -8,4 +8,8 @@
 
 
 class TaskGetOutputFileResponse(BaseModel):
+    id: str
+
     download_url: str = FieldInfo(alias="downloadUrl")
+
+    file_name: str = FieldInfo(alias="fileName")
diff --git a/src/browser_use_sdk/types/task_get_user_uploaded_file_response.py b/src/browser_use_sdk/types/task_get_user_uploaded_file_response.py
@@ -8,4 +8,8 @@
 
 
 class TaskGetUserUploadedFileResponse(BaseModel):
+    id: str
+
     download_url: str = FieldInfo(alias="downloadUrl")
+
+    file_name: str = FieldInfo(alias="fileName")
diff --git a/src/browser_use_sdk/types/task_item_view.py b/src/browser_use_sdk/types/task_item_view.py
@@ -1,15 +1,13 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Dict, List, Optional
+from typing import Dict, Optional
 from datetime import datetime
 
 from pydantic import Field as FieldInfo
 
 from .._models import BaseModel
-from .file_view import FileView
 from .llm_model import LlmModel
 from .task_status import TaskStatus
-from .task_step_view import TaskStepView
 
 __all__ = ["TaskItemView"]
 
@@ -44,11 +42,3 @@ class TaskItemView(BaseModel):
     is_success: Optional[bool] = FieldInfo(alias="isSuccess", default=None)
 
     metadata: Optional[Dict[str, object]] = None
-
-    output_files: Optional[List[FileView]] = FieldInfo(alias="outputFiles", default=None)
-
-    session_live_url: Optional[str] = FieldInfo(alias="sessionLiveUrl", default=None)
-
-    steps: Optional[List[TaskStepView]] = None
-
-    user_uploaded_files: Optional[List[FileView]] = FieldInfo(alias="userUploadedFiles", default=None)
diff --git a/src/browser_use_sdk/types/task_list_params.py b/src/browser_use_sdk/types/task_list_params.py
@@ -22,12 +22,6 @@ class TaskListParams(TypedDict, total=False):
     UNSUCCESSFUL: All unsuccessful tasks
     """
 
-    include_output_files: Annotated[bool, PropertyInfo(alias="includeOutputFiles")]
-
-    include_steps: Annotated[bool, PropertyInfo(alias="includeSteps")]
-
-    include_user_uploaded_files: Annotated[bool, PropertyInfo(alias="includeUserUploadedFiles")]
-
     page_number: Annotated[int, PropertyInfo(alias="pageNumber")]
 
     page_size: Annotated[int, PropertyInfo(alias="pageSize")]
diff --git a/src/browser_use_sdk/types/task_view.py b/src/browser_use_sdk/types/task_view.py
@@ -2,6 +2,7 @@
 
 from typing import Dict, List, Optional
 from datetime import datetime
+from typing_extensions import Literal
 
 from pydantic import Field as FieldInfo
 
@@ -11,7 +12,24 @@
 from .task_status import TaskStatus
 from .task_step_view import TaskStepView
 
-__all__ = ["TaskView"]
+__all__ = ["TaskView", "Session"]
+
+
+class Session(BaseModel):
+    id: str
+
+    started_at: datetime = FieldInfo(alias="startedAt")
+
+    status: Literal["active", "stopped"]
+    """Enumeration of possible (browser) session states
+
+    Attributes: ACTIVE: Session is currently active and running (browser is running)
+    STOPPED: Session has been stopped and is no longer active (browser is stopped)
+    """
+
+    finished_at: Optional[datetime] = FieldInfo(alias="finishedAt", default=None)
+
+    live_url: Optional[str] = FieldInfo(alias="liveUrl", default=None)
 
 
 class TaskView(BaseModel):
@@ -23,6 +41,15 @@ class TaskView(BaseModel):
 
     output_files: List[FileView] = FieldInfo(alias="outputFiles")
 
+    session: Session
+    """View model for representing a session that a task belongs to
+
+    Attributes: id: Unique identifier for the session status: Current status of the
+    session live_url: URL where the browser can be viewed live in real-time.
+    started_at: Timestamp when the session was created and started. finished_at:
+    Timestamp when the session was stopped (None if still active).
+    """
+
     session_id: str = FieldInfo(alias="sessionId")
 
     started_at: datetime = FieldInfo(alias="startedAt")
@@ -50,5 +77,3 @@ class TaskView(BaseModel):
     is_success: Optional[bool] = FieldInfo(alias="isSuccess", default=None)
 
     metadata: Optional[Dict[str, object]] = None
-
-    session_live_url: Optional[str] = FieldInfo(alias="sessionLiveUrl", default=None)
diff --git a/tests/api_resources/test_sessions.py b/tests/api_resources/test_sessions.py
diff --git a/tests/api_resources/test_tasks.py b/tests/api_resources/test_tasks.py
