feat: Allow hot loading profiles into sessions

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 97
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-7427d4bcaba5cad07910da7a222bdd2650b5280e6b889132ed38d230adafb8a5.yml
-openapi_spec_hash: e8e3dc1ae54666d544d1fc848b25e7cf
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-d430a8e3407ceb608d912cabadbcb016b4fcf057ca56b3bbd179ea3b3121b484.yml
+openapi_spec_hash: 8adbf013baf77abacaf04ed067749397
 config_hash: b470456b217bb9502f5212311d395a6f

src/kernel/resources/browsers/browsers.py

@@ -270,22 +270,28 @@ def update(
         self,
         id: str,
         *,
+        profile: BrowserProfile | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
+        viewport: BrowserViewport | 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,
     ) -> BrowserUpdateResponse:
-        """Update a browser session.
+        """
+        Update a browser session.
 
         Args:
-          proxy_id: ID of the proxy to use.
+          profile: Profile to load into the browser session. Only allowed if the session does not
+              already have a profile loaded.
 
-        Omit to leave unchanged, set to empty string to remove
+          proxy_id: ID of the proxy to use. Omit to leave unchanged, set to empty string to remove
               proxy.
 
+          viewport: Viewport configuration to apply to the browser session.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -298,7 +304,14 @@ def update(
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return self._patch(
             f"/browsers/{id}",
-            body=maybe_transform({"proxy_id": proxy_id}, browser_update_params.BrowserUpdateParams),
+            body=maybe_transform(
+                {
+                    "profile": profile,
+                    "proxy_id": proxy_id,
+                    "viewport": viewport,
+                },
+                browser_update_params.BrowserUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -668,22 +681,28 @@ async def update(
         self,
         id: str,
         *,
+        profile: BrowserProfile | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
+        viewport: BrowserViewport | 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,
     ) -> BrowserUpdateResponse:
-        """Update a browser session.
+        """
+        Update a browser session.
 
         Args:
-          proxy_id: ID of the proxy to use.
+          profile: Profile to load into the browser session. Only allowed if the session does not
+              already have a profile loaded.
 
-        Omit to leave unchanged, set to empty string to remove
+          proxy_id: ID of the proxy to use. Omit to leave unchanged, set to empty string to remove
               proxy.
 
+          viewport: Viewport configuration to apply to the browser session.
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -696,7 +715,14 @@ async def update(
             raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
         return await self._patch(
             f"/browsers/{id}",
-            body=await async_maybe_transform({"proxy_id": proxy_id}, browser_update_params.BrowserUpdateParams),
+            body=await async_maybe_transform(
+                {
+                    "profile": profile,
+                    "proxy_id": proxy_id,
+                    "viewport": viewport,
+                },
+                browser_update_params.BrowserUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/kernel/types/browser_update_params.py

@@ -5,12 +5,24 @@
 from typing import Optional
 from typing_extensions import TypedDict
 
+from .shared_params.browser_profile import BrowserProfile
+from .shared_params.browser_viewport import BrowserViewport
+
 __all__ = ["BrowserUpdateParams"]
 
 
 class BrowserUpdateParams(TypedDict, total=False):
+    profile: BrowserProfile
+    """Profile to load into the browser session.
+
+    Only allowed if the session does not already have a profile loaded.
+    """
+
     proxy_id: Optional[str]
     """ID of the proxy to use.
 
     Omit to leave unchanged, set to empty string to remove proxy.
     """
+
+    viewport: BrowserViewport
+    """Viewport configuration to apply to the browser session."""

tests/api_resources/test_browsers.py

@@ -147,7 +147,17 @@ def test_method_update(self, client: Kernel) -> None:
     def test_method_update_with_all_params(self, client: Kernel) -> None:
         browser = client.browsers.update(
             id="htzv5orfit78e1m2biiifpbv",
+            profile={
+                "id": "id",
+                "name": "name",
+                "save_changes": True,
+            },
             proxy_id="proxy_id",
+            viewport={
+                "height": 800,
+                "width": 1280,
+                "refresh_rate": 60,
+            },
         )
         assert_matches_type(BrowserUpdateResponse, browser, path=["response"])
 
@@ -498,7 +508,17 @@ async def test_method_update(self, async_client: AsyncKernel) -> None:
     async def test_method_update_with_all_params(self, async_client: AsyncKernel) -> None:
         browser = await async_client.browsers.update(
             id="htzv5orfit78e1m2biiifpbv",
+            profile={
+                "id": "id",
+                "name": "name",
+                "save_changes": True,
+            },
             proxy_id="proxy_id",
+            viewport={
+                "height": 800,
+                "width": 1280,
+                "refresh_rate": 60,
+            },
         )
         assert_matches_type(BrowserUpdateResponse, browser, path=["response"])