feat: browsers: accept chrome_policy on POST /browsers (KERNEL-1216)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 112
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-982efd191c23737c9e1cdbcbf9237fa2231b9f74e0a25db2870293bdf9951c21.yml
-openapi_spec_hash: eeb27952a4cc939316c24fc0ce2c9e3a
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-e564e74a7aae1744d4aa070a63c387f456c4719a48747dc6229b58a986255b65.yml
+openapi_spec_hash: 62beb1f20708652aaee31bbffb6cfbe9
 config_hash: 08d55086449943a8fec212b870061a3f

src/kernel/resources/browsers/browsers.py

@@ -145,6 +145,7 @@ def with_streaming_response(self) -> BrowsersResourceWithStreamingResponse:
     def create(
         self,
         *,
+        chrome_policy: Dict[str, object] | Omit = omit,
         extensions: Iterable[BrowserExtension] | Omit = omit,
         gpu: bool | Omit = omit,
         headless: bool | Omit = omit,
@@ -168,6 +169,12 @@ def create(
         Create a new browser session from within an action.
 
         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
+              https://chromeenterprise.google/policies/
+
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
           gpu: If true, enables GPU acceleration for the browser session. Requires Start-Up or
@@ -228,6 +235,7 @@ def create(
             "/browsers",
             body=maybe_transform(
                 {
+                    "chrome_policy": chrome_policy,
                     "extensions": extensions,
                     "gpu": gpu,
                     "headless": headless,
@@ -651,6 +659,7 @@ def with_streaming_response(self) -> AsyncBrowsersResourceWithStreamingResponse:
     async def create(
         self,
         *,
+        chrome_policy: Dict[str, object] | Omit = omit,
         extensions: Iterable[BrowserExtension] | Omit = omit,
         gpu: bool | Omit = omit,
         headless: bool | Omit = omit,
@@ -674,6 +683,12 @@ async def create(
         Create a new browser session from within an action.
 
         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
+              https://chromeenterprise.google/policies/
+
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
           gpu: If true, enables GPU acceleration for the browser session. Requires Start-Up or
@@ -734,6 +749,7 @@ async def create(
             "/browsers",
             body=await async_maybe_transform(
                 {
+                    "chrome_policy": chrome_policy,
                     "extensions": extensions,
                     "gpu": gpu,
                     "headless": headless,

src/kernel/types/browser_create_params.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Iterable
+from typing import Dict, Iterable
 from typing_extensions import TypedDict
 
 from .browser_persistence_param import BrowserPersistenceParam
@@ -14,6 +14,15 @@
 
 
 class BrowserCreateParams(TypedDict, total=False):
+    chrome_policy: Dict[str, object]
+    """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
+    https://chromeenterprise.google/policies/
+    """
+
     extensions: Iterable[BrowserExtension]
     """List of browser extensions to load into the session.
 

src/kernel/types/browser_create_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, Optional
 from datetime import datetime
 
 from .profile import Profile
@@ -44,6 +44,13 @@ class BrowserCreateResponse(BaseModel):
     Only available for non-headless browsers.
     """
 
+    chrome_policy: Optional[Dict[str, object]] = None
+    """
+    Custom Chrome enterprise policy overrides that were applied to this browser
+    session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+    names.
+    """
+
     deleted_at: Optional[datetime] = None
     """When the browser session was soft-deleted. Only present for deleted sessions."""
 

src/kernel/types/browser_list_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, Optional
 from datetime import datetime
 
 from .profile import Profile
@@ -44,6 +44,13 @@ class BrowserListResponse(BaseModel):
     Only available for non-headless browsers.
     """
 
+    chrome_policy: Optional[Dict[str, object]] = None
+    """
+    Custom Chrome enterprise policy overrides that were applied to this browser
+    session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+    names.
+    """
+
     deleted_at: Optional[datetime] = None
     """When the browser session was soft-deleted. Only present for deleted sessions."""
 

src/kernel/types/browser_pool_acquire_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, Optional
 from datetime import datetime
 
 from .profile import Profile
@@ -44,6 +44,13 @@ class BrowserPoolAcquireResponse(BaseModel):
     Only available for non-headless browsers.
     """
 
+    chrome_policy: Optional[Dict[str, object]] = None
+    """
+    Custom Chrome enterprise policy overrides that were applied to this browser
+    session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+    names.
+    """
+
     deleted_at: Optional[datetime] = None
     """When the browser session was soft-deleted. Only present for deleted sessions."""
 

src/kernel/types/browser_retrieve_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, Optional
 from datetime import datetime
 
 from .profile import Profile
@@ -44,6 +44,13 @@ class BrowserRetrieveResponse(BaseModel):
     Only available for non-headless browsers.
     """
 
+    chrome_policy: Optional[Dict[str, object]] = None
+    """
+    Custom Chrome enterprise policy overrides that were applied to this browser
+    session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+    names.
+    """
+
     deleted_at: Optional[datetime] = None
     """When the browser session was soft-deleted. Only present for deleted sessions."""
 

src/kernel/types/browser_update_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import Optional
+from typing import Dict, Optional
 from datetime import datetime
 
 from .profile import Profile
@@ -44,6 +44,13 @@ class BrowserUpdateResponse(BaseModel):
     Only available for non-headless browsers.
     """
 
+    chrome_policy: Optional[Dict[str, object]] = None
+    """
+    Custom Chrome enterprise policy overrides that were applied to this browser
+    session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+    names.
+    """
+
     deleted_at: Optional[datetime] = None
     """When the browser session was soft-deleted. Only present for deleted sessions."""
 

src/kernel/types/invocation_list_browsers_response.py

@@ -1,6 +1,6 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing import List, Optional
+from typing import Dict, List, Optional
 from datetime import datetime
 
 from .profile import Profile
@@ -44,6 +44,13 @@ class Browser(BaseModel):
     Only available for non-headless browsers.
     """
 
+    chrome_policy: Optional[Dict[str, object]] = None
+    """
+    Custom Chrome enterprise policy overrides that were applied to this browser
+    session, if any. Echoed back for verification. Keys are Chrome enterprise policy
+    names.
+    """
+
     deleted_at: Optional[datetime] = None
     """When the browser session was soft-deleted. Only present for deleted sessions."""
 

tests/api_resources/test_browsers.py

@@ -36,6 +36,7 @@ def test_method_create(self, client: Kernel) -> None:
     @parametrize
     def test_method_create_with_all_params(self, client: Kernel) -> None:
         browser = client.browsers.create(
+            chrome_policy={"foo": "bar"},
             extensions=[
                 {
                     "id": "id",
@@ -462,6 +463,7 @@ async def test_method_create(self, async_client: AsyncKernel) -> None:
     @parametrize
     async def test_method_create_with_all_params(self, async_client: AsyncKernel) -> None:
         browser = await async_client.browsers.create(
+            chrome_policy={"foo": "bar"},
             extensions=[
                 {
                     "id": "id",