feat: EOL persistent browsers: openapi limits

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 113
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-2118a79fa452fad5922776130ea4877059e9568b603ef146171b7bb6a0f8458a.yml
-openapi_spec_hash: 686e8c5855ed88b2944b9d9ec21d22ce
-config_hash: 37661d89120558d34b6cc184292632f2
+configured_endpoints: 112
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-346b1affebf16e7f943bcf4db307a5589fcae636c9147dd0afbe5c02cf12ad30.yml
+openapi_spec_hash: 348df436759d220264f12450919211c3
+config_hash: ae3dea7997fb5d36fa41979f9585ed78

README.md

@@ -203,9 +203,9 @@ from kernel import Kernel
 client = Kernel()
 
 browser = client.browsers.create(
-    persistence={"id": "my-awesome-browser-for-user-1234"},
+    profile={},
 )
-print(browser.persistence)
+print(browser.profile)
 ```
 
 ## File uploads

api.md

@@ -80,7 +80,6 @@ Types:
 
 ```python
 from kernel.types import (
-    BrowserPersistence,
     BrowserPoolRef,
     BrowserUsage,
     Profile,
@@ -98,7 +97,6 @@ Methods:
 - <code title="get /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">retrieve</a>(id, \*\*<a href="src/kernel/types/browser_retrieve_params.py">params</a>) -> <a href="./src/kernel/types/browser_retrieve_response.py">BrowserRetrieveResponse</a></code>
 - <code title="patch /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">update</a>(id, \*\*<a href="src/kernel/types/browser_update_params.py">params</a>) -> <a href="./src/kernel/types/browser_update_response.py">BrowserUpdateResponse</a></code>
 - <code title="get /browsers">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">list</a>(\*\*<a href="src/kernel/types/browser_list_params.py">params</a>) -> <a href="./src/kernel/types/browser_list_response.py">SyncOffsetPagination[BrowserListResponse]</a></code>
-- <code title="delete /browsers">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">delete</a>(\*\*<a href="src/kernel/types/browser_delete_params.py">params</a>) -> None</code>
 - <code title="post /browsers/{id}/curl">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">curl</a>(id, \*\*<a href="src/kernel/types/browser_curl_params.py">params</a>) -> <a href="./src/kernel/types/browser_curl_response.py">BrowserCurlResponse</a></code>
 - <code title="delete /browsers/{id}">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">delete_by_id</a>(id) -> None</code>
 - <code title="post /browsers/{id}/extensions">client.browsers.<a href="./src/kernel/resources/browsers/browsers.py">load_extensions</a>(id, \*\*<a href="src/kernel/types/browser_load_extensions_params.py">params</a>) -> None</code>

src/kernel/resources/browsers/browsers.py

@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import typing_extensions
 from typing import Dict, Mapping, Iterable, Iterator, Optional, AsyncIterator, cast
 from contextlib import contextmanager, asynccontextmanager
 from typing_extensions import Literal
@@ -29,7 +28,6 @@
     browser_curl_params,
     browser_list_params,
     browser_create_params,
-    browser_delete_params,
     browser_update_params,
     browser_retrieve_params,
     browser_load_extensions_params,
@@ -97,7 +95,6 @@
 )
 from ...types.browser_create_response import BrowserCreateResponse
 from ...types.browser_update_response import BrowserUpdateResponse
-from ...types.browser_persistence_param import BrowserPersistenceParam
 from ...types.browser_retrieve_response import BrowserRetrieveResponse
 from ...types.shared_params.browser_profile import BrowserProfile
 from ...types.shared_params.browser_viewport import BrowserViewport
@@ -172,7 +169,6 @@ def create(
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
         kiosk_mode: bool | Omit = omit,
-        persistence: BrowserPersistenceParam | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: str | Omit = omit,
         start_url: str | Omit = omit,
@@ -193,8 +189,7 @@ def create(
         Args:
           chrome_policy: Custom Chrome enterprise policy overrides applied to this browser session. Keys
               are Chrome enterprise policy names; values must match their expected types.
-              Blocked: kernel-managed policies (extensions, proxy, CDP/automation). Ignored
-              when reusing an existing persistent session. See
+              Blocked: kernel-managed policies (extensions, proxy, CDP/automation). See
               https://chromeenterprise.google/policies/
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
@@ -210,8 +205,6 @@ def create(
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
-          persistence: DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles instead.
-
           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.
@@ -267,7 +260,6 @@ def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "kiosk_mode": kiosk_mode,
-                    "persistence": persistence,
                     "profile": profile,
                     "proxy_id": proxy_id,
                     "start_url": start_url,
@@ -453,47 +445,6 @@ def list(
             model=BrowserListResponse,
         )
 
-    @typing_extensions.deprecated("deprecated")
-    def delete(
-        self,
-        *,
-        persistent_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,
-    ) -> None:
-        """DEPRECATED: Use DELETE /browsers/{id} instead.
-
-        Delete a persistent browser
-        session by its persistent_id.
-
-        Args:
-          persistent_id: Persistent browser identifier
-
-          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
-        """
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
-        return self._delete(
-            "/browsers",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform({"persistent_id": persistent_id}, browser_delete_params.BrowserDeleteParams),
-            ),
-            cast_to=NoneType,
-        )
-
     def curl(
         self,
         id: str,
@@ -762,7 +713,6 @@ async def create(
         headless: bool | Omit = omit,
         invocation_id: str | Omit = omit,
         kiosk_mode: bool | Omit = omit,
-        persistence: BrowserPersistenceParam | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: str | Omit = omit,
         start_url: str | Omit = omit,
@@ -783,8 +733,7 @@ async def create(
         Args:
           chrome_policy: Custom Chrome enterprise policy overrides applied to this browser session. Keys
               are Chrome enterprise policy names; values must match their expected types.
-              Blocked: kernel-managed policies (extensions, proxy, CDP/automation). Ignored
-              when reusing an existing persistent session. See
+              Blocked: kernel-managed policies (extensions, proxy, CDP/automation). See
               https://chromeenterprise.google/policies/
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
@@ -800,8 +749,6 @@ async def create(
           kiosk_mode: If true, launches the browser in kiosk mode to hide address bar and tabs in live
               view.
 
-          persistence: DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles instead.
-
           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.
@@ -857,7 +804,6 @@ async def create(
                     "headless": headless,
                     "invocation_id": invocation_id,
                     "kiosk_mode": kiosk_mode,
-                    "persistence": persistence,
                     "profile": profile,
                     "proxy_id": proxy_id,
                     "start_url": start_url,
@@ -1043,49 +989,6 @@ def list(
             model=BrowserListResponse,
         )
 
-    @typing_extensions.deprecated("deprecated")
-    async def delete(
-        self,
-        *,
-        persistent_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,
-    ) -> None:
-        """DEPRECATED: Use DELETE /browsers/{id} instead.
-
-        Delete a persistent browser
-        session by its persistent_id.
-
-        Args:
-          persistent_id: Persistent browser identifier
-
-          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
-        """
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
-        return await self._delete(
-            "/browsers",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {"persistent_id": persistent_id}, browser_delete_params.BrowserDeleteParams
-                ),
-            ),
-            cast_to=NoneType,
-        )
-
     async def curl(
         self,
         id: str,
@@ -1305,11 +1208,6 @@ def __init__(self, browsers: BrowsersResource) -> None:
         self.list = to_raw_response_wrapper(
             browsers.list,
         )
-        self.delete = (  # pyright: ignore[reportDeprecated]
-            to_raw_response_wrapper(
-                browsers.delete,  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.curl = to_raw_response_wrapper(
             browsers.curl,
         )
@@ -1371,11 +1269,6 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
         self.list = async_to_raw_response_wrapper(
             browsers.list,
         )
-        self.delete = (  # pyright: ignore[reportDeprecated]
-            async_to_raw_response_wrapper(
-                browsers.delete,  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.curl = async_to_raw_response_wrapper(
             browsers.curl,
         )
@@ -1437,11 +1330,6 @@ def __init__(self, browsers: BrowsersResource) -> None:
         self.list = to_streamed_response_wrapper(
             browsers.list,
         )
-        self.delete = (  # pyright: ignore[reportDeprecated]
-            to_streamed_response_wrapper(
-                browsers.delete,  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.curl = to_streamed_response_wrapper(
             browsers.curl,
         )
@@ -1503,11 +1391,6 @@ def __init__(self, browsers: AsyncBrowsersResource) -> None:
         self.list = async_to_streamed_response_wrapper(
             browsers.list,
         )
-        self.delete = (  # pyright: ignore[reportDeprecated]
-            async_to_streamed_response_wrapper(
-                browsers.delete,  # pyright: ignore[reportDeprecated],
-            )
-        )
         self.curl = async_to_streamed_response_wrapper(
             browsers.curl,
         )

src/kernel/resources/projects/limits.py

@@ -86,7 +86,6 @@ def update(
         *,
         max_concurrent_invocations: Optional[int] | Omit = omit,
         max_concurrent_sessions: Optional[int] | Omit = omit,
-        max_persistent_sessions: Optional[int] | Omit = omit,
         max_pooled_sessions: Optional[int] | 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.
@@ -108,9 +107,6 @@ def update(
           max_concurrent_sessions: Maximum concurrent browser sessions for this project. Set to 0 to remove the
               cap; omit to leave unchanged.
 
-          max_persistent_sessions: Maximum persistent browser sessions for this project. Set to 0 to remove the
-              cap; omit to leave unchanged.
-
           max_pooled_sessions: Maximum pooled sessions capacity for this project. Set to 0 to remove the cap;
               omit to leave unchanged.
 
@@ -130,7 +126,6 @@ def update(
                 {
                     "max_concurrent_invocations": max_concurrent_invocations,
                     "max_concurrent_sessions": max_concurrent_sessions,
-                    "max_persistent_sessions": max_persistent_sessions,
                     "max_pooled_sessions": max_pooled_sessions,
                 },
                 limit_update_params.LimitUpdateParams,
@@ -205,7 +200,6 @@ async def update(
         *,
         max_concurrent_invocations: Optional[int] | Omit = omit,
         max_concurrent_sessions: Optional[int] | Omit = omit,
-        max_persistent_sessions: Optional[int] | Omit = omit,
         max_pooled_sessions: Optional[int] | 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.
@@ -227,9 +221,6 @@ async def update(
           max_concurrent_sessions: Maximum concurrent browser sessions for this project. Set to 0 to remove the
               cap; omit to leave unchanged.
 
-          max_persistent_sessions: Maximum persistent browser sessions for this project. Set to 0 to remove the
-              cap; omit to leave unchanged.
-
           max_pooled_sessions: Maximum pooled sessions capacity for this project. Set to 0 to remove the cap;
               omit to leave unchanged.
 
@@ -249,7 +240,6 @@ async def update(
                 {
                     "max_concurrent_invocations": max_concurrent_invocations,
                     "max_concurrent_sessions": max_concurrent_sessions,
-                    "max_persistent_sessions": max_persistent_sessions,
                     "max_pooled_sessions": max_pooled_sessions,
                 },
                 limit_update_params.LimitUpdateParams,

src/kernel/types/__init__.py

@@ -26,7 +26,6 @@
 from .proxy_check_params import ProxyCheckParams as ProxyCheckParams
 from .browser_curl_params import BrowserCurlParams as BrowserCurlParams
 from .browser_list_params import BrowserListParams as BrowserListParams
-from .browser_persistence import BrowserPersistence as BrowserPersistence
 from .credential_provider import CredentialProvider as CredentialProvider
 from .profile_list_params import ProfileListParams as ProfileListParams
 from .project_list_params import ProjectListParams as ProjectListParams
@@ -35,7 +34,6 @@
 from .proxy_check_response import ProxyCheckResponse as ProxyCheckResponse
 from .browser_create_params import BrowserCreateParams as BrowserCreateParams
 from .browser_curl_response import BrowserCurlResponse as BrowserCurlResponse
-from .browser_delete_params import BrowserDeleteParams as BrowserDeleteParams
 from .browser_list_response import BrowserListResponse as BrowserListResponse
 from .browser_update_params import BrowserUpdateParams as BrowserUpdateParams
 from .profile_create_params import ProfileCreateParams as ProfileCreateParams
@@ -63,7 +61,6 @@
 from .invocation_follow_params import InvocationFollowParams as InvocationFollowParams
 from .invocation_list_response import InvocationListResponse as InvocationListResponse
 from .invocation_update_params import InvocationUpdateParams as InvocationUpdateParams
-from .browser_persistence_param import BrowserPersistenceParam as BrowserPersistenceParam
 from .browser_retrieve_response import BrowserRetrieveResponse as BrowserRetrieveResponse
 from .extension_upload_response import ExtensionUploadResponse as ExtensionUploadResponse
 from .browser_pool_create_params import BrowserPoolCreateParams as BrowserPoolCreateParams

src/kernel/types/browser_create_params.py

@@ -5,7 +5,6 @@
 from typing import Dict, Iterable, Optional
 from typing_extensions import TypedDict
 
-from .browser_persistence_param import BrowserPersistenceParam
 from .shared_params.browser_profile import BrowserProfile
 from .shared_params.browser_viewport import BrowserViewport
 from .shared_params.browser_extension import BrowserExtension
@@ -19,8 +18,7 @@ class BrowserCreateParams(TypedDict, total=False):
     """Custom Chrome enterprise policy overrides applied to this browser session.
 
     Keys are Chrome enterprise policy names; values must match their expected types.
-    Blocked: kernel-managed policies (extensions, proxy, CDP/automation). Ignored
-    when reusing an existing persistent session. See
+    Blocked: kernel-managed policies (extensions, proxy, CDP/automation). See
     https://chromeenterprise.google/policies/
     """
 
@@ -51,9 +49,6 @@ class BrowserCreateParams(TypedDict, total=False):
     view.
     """
 
-    persistence: BrowserPersistenceParam
-    """DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles instead."""
-
     profile: BrowserProfile
     """Profile selection for the browser session.
 

src/kernel/types/browser_create_response.py

@@ -7,7 +7,6 @@
 from .._models import BaseModel
 from .browser_usage import BrowserUsage
 from .browser_pool_ref import BrowserPoolRef
-from .browser_persistence import BrowserPersistence
 from .shared.browser_viewport import BrowserViewport
 from .browsers.browser_telemetry_config import BrowserTelemetryConfig
 
@@ -64,9 +63,6 @@ class BrowserCreateResponse(BaseModel):
     kiosk_mode: Optional[bool] = None
     """Whether the browser session is running in kiosk mode."""
 
-    persistence: Optional[BrowserPersistence] = None
-    """DEPRECATED: Use timeout_seconds (up to 72 hours) and Profiles instead."""
-
     pool: Optional[BrowserPoolRef] = None
     """Browser pool this session was acquired from, if any."""