anchorbrowser 0.1.0a3__py3-none-any.whl → 0.2.0__py3-none-any.whl

anchorbrowser/resources/sessions/sessions.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+from typing import Mapping, Iterable, cast
 from typing_extensions import Literal
 
 import httpx
@@ -27,10 +28,11 @@ from ...types import (
     session_paste_params,
     session_create_params,
     session_scroll_params,
+    session_upload_file_params,
     session_drag_and_drop_params,
 )
-from ..._types import NOT_GIVEN, Body, Query, Headers, NotGiven
-from ..._utils import maybe_transform, async_maybe_transform
+from ..._types import Body, Omit, Query, Headers, NotGiven, FileTypes, omit, not_given
+from ..._utils import extract_files, maybe_transform, deepcopy_minimal, async_maybe_transform
 from .keyboard import (
     KeyboardResource,
     AsyncKeyboardResource,
@@ -63,6 +65,14 @@ from ..._response import (
     async_to_custom_raw_response_wrapper,
     async_to_custom_streamed_response_wrapper,
 )
+from .agent.agent import (
+    AgentResource,
+    AsyncAgentResource,
+    AgentResourceWithRawResponse,
+    AsyncAgentResourceWithRawResponse,
+    AgentResourceWithStreamingResponse,
+    AsyncAgentResourceWithStreamingResponse,
+)
 from ..._base_client import make_request_options
 from .recordings.recordings import (
     RecordingsResource,
@@ -78,6 +88,9 @@ from ...types.session_paste_response import SessionPasteResponse
 from ...types.session_create_response import SessionCreateResponse
 from ...types.session_scroll_response import SessionScrollResponse
 from ...types.shared.success_response import SuccessResponse
+from ...types.session_retrieve_response import SessionRetrieveResponse
+from ...types.session_list_pages_response import SessionListPagesResponse
+from ...types.session_upload_file_response import SessionUploadFileResponse
 from ...types.session_drag_and_drop_response import SessionDragAndDropResponse
 from ...types.session_retrieve_downloads_response import SessionRetrieveDownloadsResponse
 
@@ -104,6 +117,9 @@ class SessionsResource(SyncAPIResource):
     @cached_property
     def clipboard(self) -> ClipboardResource:
         return ClipboardResource(self._client)
+    @cached_property
+    def agent(self) -> AgentResource:
+        return AgentResource(self._client)
 
     @cached_property
     def with_raw_response(self) -> SessionsResourceWithRawResponse:
@@ -127,14 +143,15 @@ class SessionsResource(SyncAPIResource):
     def create(
         self,
         *,
-        browser: session_create_params.Browser | NotGiven = NOT_GIVEN,
-        session: session_create_params.Session | NotGiven = NOT_GIVEN,
+        browser: session_create_params.Browser | Omit = omit,
+        integrations: Iterable[session_create_params.Integration] | Omit = omit,
+        session: session_create_params.Session | Omit = omit,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionCreateResponse:
         """
         Allocates a new browser session for the user, with optional configurations for
@@ -143,6 +160,9 @@ class SessionsResource(SyncAPIResource):
         Args:
           browser: Browser-specific configurations.
 
+          integrations: Array of integrations to load in the browser session. Integrations must be
+              previously created using the Integrations API.
+
           session: Session-related configurations.
 
           extra_headers: Send extra headers
@@ -158,6 +178,7 @@ class SessionsResource(SyncAPIResource):
             body=maybe_transform(
                 {
                     "browser": browser,
+                    "integrations": integrations,
                     "session": session,
                 },
                 session_create_params.SessionCreateParams,
@@ -168,6 +189,39 @@ class SessionsResource(SyncAPIResource):
             cast_to=SessionCreateResponse,
         )
 
+    def retrieve(
+        self,
+        session_id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SessionRetrieveResponse:
+        """
+        Retrieves detailed information about a specific browser session.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not session_id:
+            raise ValueError(f"Expected a non-empty value for `session_id` but received {session_id!r}")
+        return self._get(
+            f"/v1/sessions/{session_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SessionRetrieveResponse,
+        )
+
     def delete(
         self,
         session_id: str,
@@ -177,7 +231,7 @@ class SessionsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SuccessResponse:
         """
         Deletes the browser session associated with the provided browser session ID.
@@ -211,7 +265,7 @@ class SessionsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionCopyResponse:
         """
         Copies the currently selected text to the clipboard
@@ -243,13 +297,13 @@ class SessionsResource(SyncAPIResource):
         end_y: int,
         start_x: int,
         start_y: int,
-        button: Literal["left", "middle", "right"] | NotGiven = NOT_GIVEN,
+        button: Literal["left", "middle", "right"] | Omit = omit,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionDragAndDropResponse:
         """
         Performs a drag and drop operation from start coordinates to end coordinates
@@ -303,7 +357,7 @@ class SessionsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionGotoResponse:
         """
         Navigates the browser session to the specified URL
@@ -330,6 +384,39 @@ class SessionsResource(SyncAPIResource):
             cast_to=SessionGotoResponse,
         )
 
+    def list_pages(
+        self,
+        session_id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SessionListPagesResponse:
+        """
+        Retrieves a list of pages associated with a specific browser session.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not session_id:
+            raise ValueError(f"Expected a non-empty value for `session_id` but received {session_id!r}")
+        return self._get(
+            f"/v1/sessions/{session_id}/pages",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SessionListPagesResponse,
+        )
+
     def paste(
         self,
         session_id: str,
@@ -340,7 +427,7 @@ class SessionsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionPasteResponse:
         """
         Pastes text at the current cursor position
@@ -376,7 +463,7 @@ class SessionsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionRetrieveDownloadsResponse:
         """Retrieves metadata of files downloaded during a browser session.
 
@@ -411,7 +498,7 @@ class SessionsResource(SyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> BinaryAPIResponse:
         """
         Takes a screenshot of the current browser session and returns it as an image.
@@ -443,14 +530,15 @@ class SessionsResource(SyncAPIResource):
         delta_y: int,
         x: int,
         y: int,
-        delta_x: int | NotGiven = NOT_GIVEN,
-        steps: int | NotGiven = NOT_GIVEN,
+        delta_x: int | Omit = omit,
+        steps: int | Omit = omit,
+        use_os: bool | Omit = omit,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionScrollResponse:
         """
         Performs a scroll action at the specified coordinates
@@ -466,6 +554,8 @@ class SessionsResource(SyncAPIResource):
 
           steps: Number of steps to break the scroll into for smoother scrolling
 
+          use_os: Whether to use the OS scroll or the Playwright scroll
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -485,6 +575,7 @@ class SessionsResource(SyncAPIResource):
                     "y": y,
                     "delta_x": delta_x,
                     "steps": steps,
+                    "use_os": use_os,
                 },
                 session_scroll_params.SessionScrollParams,
             ),
@@ -494,6 +585,54 @@ class SessionsResource(SyncAPIResource):
             cast_to=SessionScrollResponse,
         )
 
+    def upload_file(
+        self,
+        session_id: str,
+        *,
+        file: FileTypes,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SessionUploadFileResponse:
+        """
+        Upload files directly to a browser session for use with web forms and file
+        inputs.
+
+        Files are saved to the session's uploads directory and can be referenced in CDP
+        commands.
+
+        Args:
+          file: File to upload to the browser session
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not session_id:
+            raise ValueError(f"Expected a non-empty value for `session_id` but received {session_id!r}")
+        body = deepcopy_minimal({"file": file})
+        files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
+        return self._post(
+            f"/v1/sessions/{session_id}/uploads",
+            body=maybe_transform(body, session_upload_file_params.SessionUploadFileParams),
+            files=files,
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SessionUploadFileResponse,
+        )
+
 
 class AsyncSessionsResource(AsyncAPIResource):
     @cached_property
@@ -515,6 +654,9 @@ class AsyncSessionsResource(AsyncAPIResource):
     @cached_property
     def clipboard(self) -> AsyncClipboardResource:
         return AsyncClipboardResource(self._client)
+    @cached_property
+    def agent(self) -> AsyncAgentResource:
+        return AsyncAgentResource(self._client)
 
     @cached_property
     def with_raw_response(self) -> AsyncSessionsResourceWithRawResponse:
@@ -538,14 +680,15 @@ class AsyncSessionsResource(AsyncAPIResource):
     async def create(
         self,
         *,
-        browser: session_create_params.Browser | NotGiven = NOT_GIVEN,
-        session: session_create_params.Session | NotGiven = NOT_GIVEN,
+        browser: session_create_params.Browser | Omit = omit,
+        integrations: Iterable[session_create_params.Integration] | Omit = omit,
+        session: session_create_params.Session | Omit = omit,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionCreateResponse:
         """
         Allocates a new browser session for the user, with optional configurations for
@@ -554,6 +697,9 @@ class AsyncSessionsResource(AsyncAPIResource):
         Args:
           browser: Browser-specific configurations.
 
+          integrations: Array of integrations to load in the browser session. Integrations must be
+              previously created using the Integrations API.
+
           session: Session-related configurations.
 
           extra_headers: Send extra headers
@@ -569,6 +715,7 @@ class AsyncSessionsResource(AsyncAPIResource):
             body=await async_maybe_transform(
                 {
                     "browser": browser,
+                    "integrations": integrations,
                     "session": session,
                 },
                 session_create_params.SessionCreateParams,
@@ -579,6 +726,39 @@ class AsyncSessionsResource(AsyncAPIResource):
             cast_to=SessionCreateResponse,
         )
 
+    async def retrieve(
+        self,
+        session_id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SessionRetrieveResponse:
+        """
+        Retrieves detailed information about a specific browser session.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not session_id:
+            raise ValueError(f"Expected a non-empty value for `session_id` but received {session_id!r}")
+        return await self._get(
+            f"/v1/sessions/{session_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SessionRetrieveResponse,
+        )
+
     async def delete(
         self,
         session_id: str,
@@ -588,7 +768,7 @@ class AsyncSessionsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SuccessResponse:
         """
         Deletes the browser session associated with the provided browser session ID.
@@ -622,7 +802,7 @@ class AsyncSessionsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionCopyResponse:
         """
         Copies the currently selected text to the clipboard
@@ -654,13 +834,13 @@ class AsyncSessionsResource(AsyncAPIResource):
         end_y: int,
         start_x: int,
         start_y: int,
-        button: Literal["left", "middle", "right"] | NotGiven = NOT_GIVEN,
+        button: Literal["left", "middle", "right"] | Omit = omit,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionDragAndDropResponse:
         """
         Performs a drag and drop operation from start coordinates to end coordinates
@@ -714,7 +894,7 @@ class AsyncSessionsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionGotoResponse:
         """
         Navigates the browser session to the specified URL
@@ -741,6 +921,39 @@ class AsyncSessionsResource(AsyncAPIResource):
             cast_to=SessionGotoResponse,
         )
 
+    async def list_pages(
+        self,
+        session_id: str,
+        *,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SessionListPagesResponse:
+        """
+        Retrieves a list of pages associated with a specific browser session.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not session_id:
+            raise ValueError(f"Expected a non-empty value for `session_id` but received {session_id!r}")
+        return await self._get(
+            f"/v1/sessions/{session_id}/pages",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SessionListPagesResponse,
+        )
+
     async def paste(
         self,
         session_id: str,
@@ -751,7 +964,7 @@ class AsyncSessionsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionPasteResponse:
         """
         Pastes text at the current cursor position
@@ -787,7 +1000,7 @@ class AsyncSessionsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionRetrieveDownloadsResponse:
         """Retrieves metadata of files downloaded during a browser session.
 
@@ -822,7 +1035,7 @@ class AsyncSessionsResource(AsyncAPIResource):
         extra_headers: Headers | None = None,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> AsyncBinaryAPIResponse:
         """
         Takes a screenshot of the current browser session and returns it as an image.
@@ -854,14 +1067,15 @@ class AsyncSessionsResource(AsyncAPIResource):
         delta_y: int,
         x: int,
         y: int,
-        delta_x: int | NotGiven = NOT_GIVEN,
-        steps: int | NotGiven = NOT_GIVEN,
+        delta_x: int | Omit = omit,
+        steps: int | Omit = omit,
+        use_os: bool | Omit = omit,
         # 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,
         extra_query: Query | None = None,
         extra_body: Body | None = None,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
     ) -> SessionScrollResponse:
         """
         Performs a scroll action at the specified coordinates
@@ -877,6 +1091,8 @@ class AsyncSessionsResource(AsyncAPIResource):
 
           steps: Number of steps to break the scroll into for smoother scrolling
 
+          use_os: Whether to use the OS scroll or the Playwright scroll
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -896,6 +1112,7 @@ class AsyncSessionsResource(AsyncAPIResource):
                     "y": y,
                     "delta_x": delta_x,
                     "steps": steps,
+                    "use_os": use_os,
                 },
                 session_scroll_params.SessionScrollParams,
             ),
@@ -905,6 +1122,54 @@ class AsyncSessionsResource(AsyncAPIResource):
             cast_to=SessionScrollResponse,
         )
 
+    async def upload_file(
+        self,
+        session_id: str,
+        *,
+        file: FileTypes,
+        # 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SessionUploadFileResponse:
+        """
+        Upload files directly to a browser session for use with web forms and file
+        inputs.
+
+        Files are saved to the session's uploads directory and can be referenced in CDP
+        commands.
+
+        Args:
+          file: File to upload to the browser session
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not session_id:
+            raise ValueError(f"Expected a non-empty value for `session_id` but received {session_id!r}")
+        body = deepcopy_minimal({"file": file})
+        files = extract_files(cast(Mapping[str, object], body), paths=[["file"]])
+        # It should be noted that the actual Content-Type header that will be
+        # sent to the server will contain a `boundary` parameter, e.g.
+        # multipart/form-data; boundary=---abc--
+        extra_headers = {"Content-Type": "multipart/form-data", **(extra_headers or {})}
+        return await self._post(
+            f"/v1/sessions/{session_id}/uploads",
+            body=await async_maybe_transform(body, session_upload_file_params.SessionUploadFileParams),
+            files=files,
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=SessionUploadFileResponse,
+        )
+
 
 class SessionsResourceWithRawResponse:
     def __init__(self, sessions: SessionsResource) -> None:
@@ -913,6 +1178,9 @@ class SessionsResourceWithRawResponse:
         self.create = to_raw_response_wrapper(
             sessions.create,
         )
+        self.retrieve = to_raw_response_wrapper(
+            sessions.retrieve,
+        )
         self.delete = to_raw_response_wrapper(
             sessions.delete,
         )
@@ -925,6 +1193,9 @@ class SessionsResourceWithRawResponse:
         self.goto = to_raw_response_wrapper(
             sessions.goto,
         )
+        self.list_pages = to_raw_response_wrapper(
+            sessions.list_pages,
+        )
         self.paste = to_raw_response_wrapper(
             sessions.paste,
         )
@@ -938,6 +1209,9 @@ class SessionsResourceWithRawResponse:
         self.scroll = to_raw_response_wrapper(
             sessions.scroll,
         )
+        self.upload_file = to_raw_response_wrapper(
+            sessions.upload_file,
+        )
 
     @cached_property
     def all(self) -> AllResourceWithRawResponse:
@@ -959,6 +1233,10 @@ class SessionsResourceWithRawResponse:
     def clipboard(self) -> ClipboardResourceWithRawResponse:
         return ClipboardResourceWithRawResponse(self._sessions.clipboard)
 
+    @cached_property
+    def agent(self) -> AgentResourceWithRawResponse:
+        return AgentResourceWithRawResponse(self._sessions.agent)
+
 
 class AsyncSessionsResourceWithRawResponse:
     def __init__(self, sessions: AsyncSessionsResource) -> None:
@@ -967,6 +1245,9 @@ class AsyncSessionsResourceWithRawResponse:
         self.create = async_to_raw_response_wrapper(
             sessions.create,
         )
+        self.retrieve = async_to_raw_response_wrapper(
+            sessions.retrieve,
+        )
         self.delete = async_to_raw_response_wrapper(
             sessions.delete,
         )
@@ -979,6 +1260,9 @@ class AsyncSessionsResourceWithRawResponse:
         self.goto = async_to_raw_response_wrapper(
             sessions.goto,
         )
+        self.list_pages = async_to_raw_response_wrapper(
+            sessions.list_pages,
+        )
         self.paste = async_to_raw_response_wrapper(
             sessions.paste,
         )
@@ -992,6 +1276,9 @@ class AsyncSessionsResourceWithRawResponse:
         self.scroll = async_to_raw_response_wrapper(
             sessions.scroll,
         )
+        self.upload_file = async_to_raw_response_wrapper(
+            sessions.upload_file,
+        )
 
     @cached_property
     def all(self) -> AsyncAllResourceWithRawResponse:
@@ -1013,6 +1300,9 @@ class AsyncSessionsResourceWithRawResponse:
     def clipboard(self) -> AsyncClipboardResourceWithRawResponse:
         return AsyncClipboardResourceWithRawResponse(self._sessions.clipboard)
 
+    @cached_property
+    def agent(self) -> AsyncAgentResourceWithRawResponse:
+        return AsyncAgentResourceWithRawResponse(self._sessions.agent)
 
 class SessionsResourceWithStreamingResponse:
     def __init__(self, sessions: SessionsResource) -> None:
@@ -1021,6 +1311,9 @@ class SessionsResourceWithStreamingResponse:
         self.create = to_streamed_response_wrapper(
             sessions.create,
         )
+        self.retrieve = to_streamed_response_wrapper(
+            sessions.retrieve,
+        )
         self.delete = to_streamed_response_wrapper(
             sessions.delete,
         )
@@ -1033,6 +1326,9 @@ class SessionsResourceWithStreamingResponse:
         self.goto = to_streamed_response_wrapper(
             sessions.goto,
         )
+        self.list_pages = to_streamed_response_wrapper(
+            sessions.list_pages,
+        )
         self.paste = to_streamed_response_wrapper(
             sessions.paste,
         )
@@ -1046,6 +1342,9 @@ class SessionsResourceWithStreamingResponse:
         self.scroll = to_streamed_response_wrapper(
             sessions.scroll,
         )
+        self.upload_file = to_streamed_response_wrapper(
+            sessions.upload_file,
+        )
 
     @cached_property
     def all(self) -> AllResourceWithStreamingResponse:
@@ -1067,6 +1366,9 @@ class SessionsResourceWithStreamingResponse:
     def clipboard(self) -> ClipboardResourceWithStreamingResponse:
         return ClipboardResourceWithStreamingResponse(self._sessions.clipboard)
 
+    @cached_property
+    def agent(self) -> AgentResourceWithStreamingResponse:
+        return AgentResourceWithStreamingResponse(self._sessions.agent)
 
 class AsyncSessionsResourceWithStreamingResponse:
     def __init__(self, sessions: AsyncSessionsResource) -> None:
@@ -1075,6 +1377,9 @@ class AsyncSessionsResourceWithStreamingResponse:
         self.create = async_to_streamed_response_wrapper(
             sessions.create,
         )
+        self.retrieve = async_to_streamed_response_wrapper(
+            sessions.retrieve,
+        )
         self.delete = async_to_streamed_response_wrapper(
             sessions.delete,
         )
@@ -1087,6 +1392,9 @@ class AsyncSessionsResourceWithStreamingResponse:
         self.goto = async_to_streamed_response_wrapper(
             sessions.goto,
         )
+        self.list_pages = async_to_streamed_response_wrapper(
+            sessions.list_pages,
+        )
         self.paste = async_to_streamed_response_wrapper(
             sessions.paste,
         )
@@ -1100,6 +1408,9 @@ class AsyncSessionsResourceWithStreamingResponse:
         self.scroll = async_to_streamed_response_wrapper(
             sessions.scroll,
         )
+        self.upload_file = async_to_streamed_response_wrapper(
+            sessions.upload_file,
+        )
 
     @cached_property
     def all(self) -> AsyncAllResourceWithStreamingResponse:
@@ -1120,3 +1431,7 @@ class AsyncSessionsResourceWithStreamingResponse:
     @cached_property
     def clipboard(self) -> AsyncClipboardResourceWithStreamingResponse:
         return AsyncClipboardResourceWithStreamingResponse(self._sessions.clipboard)
+
+    @cached_property
+    def agent(self) -> AsyncAgentResourceWithStreamingResponse:
+        return AsyncAgentResourceWithStreamingResponse(self._sessions.agent)