release: 0.57.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.56.0"
+  ".": "0.57.0"
 }

.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

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.57.0 (2026-05-19)
+
+Full Changelog: [v0.56.0...v0.57.0](https://github.com/kernel/kernel-python-sdk/compare/v0.56.0...v0.57.0)
+
+### Features
+
+* browsers: accept chrome_policy on POST /browsers (KERNEL-1216) ([b1807a2](https://github.com/kernel/kernel-python-sdk/commit/b1807a2d690f206e7482f5862acde36e692d07aa))
+
 ## 0.56.0 (2026-05-18)
 
 Full Changelog: [v0.55.0...v0.56.0](https://github.com/kernel/kernel-python-sdk/compare/v0.55.0...v0.56.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.56.0"
+version = "0.57.0"
 description = "The official Python library for the kernel API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/kernel/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "kernel"
-__version__ = "0.56.0"  # x-release-please-version
+__version__ = "0.57.0"  # x-release-please-version

src/kernel/resources/browsers/browsers.py

@@ -152,6 +152,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,
@@ -175,6 +176,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
@@ -235,6 +242,7 @@ def create(
             "/browsers",
             body=maybe_transform(
                 {
+                    "chrome_policy": chrome_policy,
                     "extensions": extensions,
                     "gpu": gpu,
                     "headless": headless,
@@ -716,6 +724,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,
@@ -739,6 +748,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
@@ -799,6 +814,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",