feat(api): adding support for browser profiles

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 41
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-a7c1df5070fe59642d7a1f168aa902a468227752bfc930cbf38930f7c205dbb6.yml
-openapi_spec_hash: eab65e39aef4f0a0952b82adeecf6b5b
-config_hash: 5de78bc29ac060562575cb54bb26826c
+configured_endpoints: 46
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel%2Fkernel-e98d46c55826cdf541a9ee0df04ce92806ac6d4d92957ae79f897270b7d85b23.yml
+openapi_spec_hash: 8a1af54fc0a4417165b8a52e6354b685
+config_hash: 043ddc54629c6d8b889123770cb4769f

api.md

@@ -66,6 +66,7 @@ Types:
 ```python
 from kernel.types import (
     BrowserPersistence,
+    Profile,
     BrowserCreateResponse,
     BrowserRetrieveResponse,
     BrowserListResponse,
@@ -161,3 +162,19 @@ Methods:
 Methods:
 
 - <code title="get /browsers/{id}/logs/stream">client.browsers.logs.<a href="./src/kernel/resources/browsers/logs.py">stream</a>(id, \*\*<a href="src/kernel/types/browsers/log_stream_params.py">params</a>) -> <a href="./src/kernel/types/shared/log_event.py">LogEvent</a></code>
+
+# Profiles
+
+Types:
+
+```python
+from kernel.types import ProfileListResponse
+```
+
+Methods:
+
+- <code title="post /profiles">client.profiles.<a href="./src/kernel/resources/profiles.py">create</a>(\*\*<a href="src/kernel/types/profile_create_params.py">params</a>) -> <a href="./src/kernel/types/profile.py">Profile</a></code>
+- <code title="get /profiles/{id_or_name}">client.profiles.<a href="./src/kernel/resources/profiles.py">retrieve</a>(id_or_name) -> <a href="./src/kernel/types/profile.py">Profile</a></code>
+- <code title="get /profiles">client.profiles.<a href="./src/kernel/resources/profiles.py">list</a>() -> <a href="./src/kernel/types/profile_list_response.py">ProfileListResponse</a></code>
+- <code title="delete /profiles/{id_or_name}">client.profiles.<a href="./src/kernel/resources/profiles.py">delete</a>(id_or_name) -> None</code>
+- <code title="get /profiles/{id_or_name}/download">client.profiles.<a href="./src/kernel/resources/profiles.py">download</a>(id_or_name) -> BinaryAPIResponse</code>

src/kernel/_client.py

@@ -21,7 +21,7 @@
 )
 from ._utils import is_given, get_async_library
 from ._version import __version__
-from .resources import apps, deployments, invocations
+from .resources import apps, profiles, deployments, invocations
 from ._streaming import Stream as Stream, AsyncStream as AsyncStream
 from ._exceptions import KernelError, APIStatusError
 from ._base_client import (
@@ -54,6 +54,7 @@ class Kernel(SyncAPIClient):
     apps: apps.AppsResource
     invocations: invocations.InvocationsResource
     browsers: browsers.BrowsersResource
+    profiles: profiles.ProfilesResource
     with_raw_response: KernelWithRawResponse
     with_streaming_response: KernelWithStreamedResponse
 
@@ -139,6 +140,7 @@ def __init__(
         self.apps = apps.AppsResource(self)
         self.invocations = invocations.InvocationsResource(self)
         self.browsers = browsers.BrowsersResource(self)
+        self.profiles = profiles.ProfilesResource(self)
         self.with_raw_response = KernelWithRawResponse(self)
         self.with_streaming_response = KernelWithStreamedResponse(self)
 
@@ -254,6 +256,7 @@ class AsyncKernel(AsyncAPIClient):
     apps: apps.AsyncAppsResource
     invocations: invocations.AsyncInvocationsResource
     browsers: browsers.AsyncBrowsersResource
+    profiles: profiles.AsyncProfilesResource
     with_raw_response: AsyncKernelWithRawResponse
     with_streaming_response: AsyncKernelWithStreamedResponse
 
@@ -339,6 +342,7 @@ def __init__(
         self.apps = apps.AsyncAppsResource(self)
         self.invocations = invocations.AsyncInvocationsResource(self)
         self.browsers = browsers.AsyncBrowsersResource(self)
+        self.profiles = profiles.AsyncProfilesResource(self)
         self.with_raw_response = AsyncKernelWithRawResponse(self)
         self.with_streaming_response = AsyncKernelWithStreamedResponse(self)
 
@@ -455,6 +459,7 @@ def __init__(self, client: Kernel) -> None:
         self.apps = apps.AppsResourceWithRawResponse(client.apps)
         self.invocations = invocations.InvocationsResourceWithRawResponse(client.invocations)
         self.browsers = browsers.BrowsersResourceWithRawResponse(client.browsers)
+        self.profiles = profiles.ProfilesResourceWithRawResponse(client.profiles)
 
 
 class AsyncKernelWithRawResponse:
@@ -463,6 +468,7 @@ def __init__(self, client: AsyncKernel) -> None:
         self.apps = apps.AsyncAppsResourceWithRawResponse(client.apps)
         self.invocations = invocations.AsyncInvocationsResourceWithRawResponse(client.invocations)
         self.browsers = browsers.AsyncBrowsersResourceWithRawResponse(client.browsers)
+        self.profiles = profiles.AsyncProfilesResourceWithRawResponse(client.profiles)
 
 
 class KernelWithStreamedResponse:
@@ -471,6 +477,7 @@ def __init__(self, client: Kernel) -> None:
         self.apps = apps.AppsResourceWithStreamingResponse(client.apps)
         self.invocations = invocations.InvocationsResourceWithStreamingResponse(client.invocations)
         self.browsers = browsers.BrowsersResourceWithStreamingResponse(client.browsers)
+        self.profiles = profiles.ProfilesResourceWithStreamingResponse(client.profiles)
 
 
 class AsyncKernelWithStreamedResponse:
@@ -479,6 +486,7 @@ def __init__(self, client: AsyncKernel) -> None:
         self.apps = apps.AsyncAppsResourceWithStreamingResponse(client.apps)
         self.invocations = invocations.AsyncInvocationsResourceWithStreamingResponse(client.invocations)
         self.browsers = browsers.AsyncBrowsersResourceWithStreamingResponse(client.browsers)
+        self.profiles = profiles.AsyncProfilesResourceWithStreamingResponse(client.profiles)
 
 
 Client = Kernel

src/kernel/resources/__init__.py

@@ -16,6 +16,14 @@
     BrowsersResourceWithStreamingResponse,
     AsyncBrowsersResourceWithStreamingResponse,
 )
+from .profiles import (
+    ProfilesResource,
+    AsyncProfilesResource,
+    ProfilesResourceWithRawResponse,
+    AsyncProfilesResourceWithRawResponse,
+    ProfilesResourceWithStreamingResponse,
+    AsyncProfilesResourceWithStreamingResponse,
+)
 from .deployments import (
     DeploymentsResource,
     AsyncDeploymentsResource,
@@ -58,4 +66,10 @@
     "AsyncBrowsersResourceWithRawResponse",
     "BrowsersResourceWithStreamingResponse",
     "AsyncBrowsersResourceWithStreamingResponse",
+    "ProfilesResource",
+    "AsyncProfilesResource",
+    "ProfilesResourceWithRawResponse",
+    "AsyncProfilesResourceWithRawResponse",
+    "ProfilesResourceWithStreamingResponse",
+    "AsyncProfilesResourceWithStreamingResponse",
 ]

src/kernel/resources/browsers/browsers.py

@@ -98,6 +98,7 @@ def create(
         headless: bool | NotGiven = NOT_GIVEN,
         invocation_id: str | NotGiven = NOT_GIVEN,
         persistence: BrowserPersistenceParam | NotGiven = NOT_GIVEN,
+        profile: browser_create_params.Profile | NotGiven = NOT_GIVEN,
         stealth: bool | NotGiven = NOT_GIVEN,
         timeout_seconds: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -118,6 +119,10 @@ def create(
 
           persistence: Optional persistence configuration for the browser session.
 
+          profile: Profile selection for the browser session. Provide either id or name. If
+              specified, the matching profile will be loaded into the browser session.
+              Profiles must be created beforehand.
+
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
@@ -140,6 +145,7 @@ def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "persistence": persistence,
+                    "profile": profile,
                     "stealth": stealth,
                     "timeout_seconds": timeout_seconds,
                 },
@@ -318,6 +324,7 @@ async def create(
         headless: bool | NotGiven = NOT_GIVEN,
         invocation_id: str | NotGiven = NOT_GIVEN,
         persistence: BrowserPersistenceParam | NotGiven = NOT_GIVEN,
+        profile: browser_create_params.Profile | NotGiven = NOT_GIVEN,
         stealth: bool | NotGiven = NOT_GIVEN,
         timeout_seconds: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -338,6 +345,10 @@ async def create(
 
           persistence: Optional persistence configuration for the browser session.
 
+          profile: Profile selection for the browser session. Provide either id or name. If
+              specified, the matching profile will be loaded into the browser session.
+              Profiles must be created beforehand.
+
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
@@ -360,6 +371,7 @@ async def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "persistence": persistence,
+                    "profile": profile,
                     "stealth": stealth,
                     "timeout_seconds": timeout_seconds,
                 },