feat: [AI-2206][apps/api] Surface proxySettings.caCertificates in public SDK & docs

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 27
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-9bab373fc62ce19147560ed3ec29fe09ad59d9a5b406d9ed21a22f15a511d9cb.yml
-openapi_spec_hash: 518fdefff1eabc4bb8a3b54ddf7fa293
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-f39b852755134d01a440f7c37701f6c5397f43d13740d9ba08739cae488382a7.yml
+openapi_spec_hash: de6c25eebe5026d0fb9a4d7a93ec7718
 config_hash: d4b0c534eaf7665ea25168e0e824c9d3

src/browserbase/resources/sessions/sessions.py

@@ -116,6 +116,7 @@ def create(
         keep_alive: bool | Omit = omit,
         project_id: str | Omit = omit,
         proxies: Union[Iterable[session_create_params.ProxiesUnionMember0], bool] | Omit = omit,
+        proxy_settings: session_create_params.ProxySettings | Omit = omit,
         region: Literal["us-west-2", "us-east-1", "eu-central-1", "ap-southeast-1"] | Omit = omit,
         api_timeout: int | Omit = omit,
         user_metadata: Dict[str, object] | Omit = omit,
@@ -144,6 +145,8 @@ def create(
           proxies: Proxy configuration. Can be true for default proxy, or an array of proxy
               configurations.
 
+          proxy_settings: Supplementary proxy settings. Optional.
+
           region: The region where the Session should run.
 
           api_timeout: Duration in seconds after which the session will automatically end. Defaults to
@@ -169,6 +172,7 @@ def create(
                     "keep_alive": keep_alive,
                     "project_id": project_id,
                     "proxies": proxies,
+                    "proxy_settings": proxy_settings,
                     "region": region,
                     "api_timeout": api_timeout,
                     "user_metadata": user_metadata,
@@ -392,6 +396,7 @@ async def create(
         keep_alive: bool | Omit = omit,
         project_id: str | Omit = omit,
         proxies: Union[Iterable[session_create_params.ProxiesUnionMember0], bool] | Omit = omit,
+        proxy_settings: session_create_params.ProxySettings | Omit = omit,
         region: Literal["us-west-2", "us-east-1", "eu-central-1", "ap-southeast-1"] | Omit = omit,
         api_timeout: int | Omit = omit,
         user_metadata: Dict[str, object] | Omit = omit,
@@ -420,6 +425,8 @@ async def create(
           proxies: Proxy configuration. Can be true for default proxy, or an array of proxy
               configurations.
 
+          proxy_settings: Supplementary proxy settings. Optional.
+
           region: The region where the Session should run.
 
           api_timeout: Duration in seconds after which the session will automatically end. Defaults to
@@ -445,6 +452,7 @@ async def create(
                     "keep_alive": keep_alive,
                     "project_id": project_id,
                     "proxies": proxies,
+                    "proxy_settings": proxy_settings,
                     "region": region,
                     "api_timeout": api_timeout,
                     "user_metadata": user_metadata,

src/browserbase/types/session_create_params.py

@@ -5,6 +5,7 @@
 from typing import Dict, Union, Iterable
 from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 
 __all__ = [
@@ -17,6 +18,7 @@
     "ProxiesUnionMember0BrowserbaseProxyConfigGeolocation",
     "ProxiesUnionMember0ExternalProxyConfig",
     "ProxiesUnionMember0NoneProxyConfig",
+    "ProxySettings",
 ]
 
 
@@ -48,6 +50,9 @@ class SessionCreateParams(TypedDict, total=False):
     Can be true for default proxy, or an array of proxy configurations.
     """
 
+    proxy_settings: Annotated[ProxySettings, PropertyInfo(alias="proxySettings")]
+    """Supplementary proxy settings. Optional."""
+
     region: Literal["us-west-2", "us-east-1", "eu-central-1", "ap-southeast-1"]
     """The region where the Session should run."""
 
@@ -201,3 +206,10 @@ class ProxiesUnionMember0NoneProxyConfig(TypedDict, total=False):
     ProxiesUnionMember0ExternalProxyConfig,
     ProxiesUnionMember0NoneProxyConfig,
 ]
+
+
+class ProxySettings(TypedDict, total=False):
+    """Supplementary proxy settings. Optional."""
+
+    ca_certificates: Annotated[SequenceNotStr[str], PropertyInfo(alias="caCertificates")]
+    """The TLS certificate IDs to trust. Optional."""

tests/api_resources/test_sessions.py

@@ -66,6 +66,7 @@ def test_method_create_with_all_params(self, client: Browserbase) -> None:
                     },
                 }
             ],
+            proxy_settings={"ca_certificates": ["182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"]},
             region="us-west-2",
             api_timeout=60,
             user_metadata={"foo": "bar"},
@@ -301,6 +302,7 @@ async def test_method_create_with_all_params(self, async_client: AsyncBrowserbas
                     },
                 }
             ],
+            proxy_settings={"ca_certificates": ["182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"]},
             region="us-west-2",
             api_timeout=60,
             user_metadata={"foo": "bar"},