Merge pull request #189 from kernel/release-please--branches--main--changes--next

release: 0.121.0

Author: rgarcia

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.120.0"
+  ".": "0.121.0"
 }

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [0.121.0](https://github.com/kernel/kernel-python-sdk/compare/v0.120.0...v0.121.0) (2026-10-07)
+
+
+### Features
+
+* Create and poll 1Password access requests over the 1Password API ([c59f487](https://github.com/kernel/kernel-python-sdk/commit/c59f4871e5dfafd294d9fe9338555d07a6ecd491))
+* Deprecate datacenter proxies in the API ([c34882c](https://github.com/kernel/kernel-python-sdk/commit/c34882c77d247ace0fa23d37da1c3574d21bd1b0))
+
 ## [0.120.0](https://github.com/kernel/kernel-python-sdk/compare/v0.119.0...v0.120.0) (2026-10-06)
 
 

api.md

@@ -120,6 +120,7 @@ from kernel.types import (
     BrowserMemory,
     BrowserMemoryRequest,
     BrowserNetworkConfig,
+    BrowserNetworkUpdate,
     BrowserPoolRef,
     BrowserProxy,
     BrowserProxyConfig,

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.120.0"
+version = "0.121.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.120.0"  # x-release-please-version
+__version__ = "0.121.0"  # x-release-please-version

src/kernel/resources/browsers/browsers.py

@@ -112,6 +112,7 @@
 from ...types.browser_retrieve_response import BrowserRetrieveResponse
 from ...types.browser_proxy_config_param import BrowserProxyConfigParam
 from ...types.browser_network_config_param import BrowserNetworkConfigParam
+from ...types.browser_network_update_param import BrowserNetworkUpdateParam
 from ...types.shared_params.browser_profile import BrowserProfile
 from ...types.shared_params.browser_viewport import BrowserViewport
 from ...types.shared_params.browser_extension import BrowserExtension
@@ -241,7 +242,8 @@ def create(
               the dashboard. Must be unique among active sessions within the project. Can be
               changed later via PATCH /browsers/{id_or_name}.
 
-          network: Network configuration for the browser session. Cannot be changed after creation.
+          network: Network configuration for the browser session. Only allowed_hosts can be changed
+              after creation, with PATCH /browsers/{id_or_name}.
 
           profile: Profile selection for the browser session. Provide either id or name. If
               specified, the matching profile will be loaded into the browser session.
@@ -393,6 +395,7 @@ def update(
         *,
         disable_default_proxy: bool | Omit = omit,
         name: Optional[str] | Omit = omit,
+        network: BrowserNetworkUpdateParam | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy: BrowserProxyConfigParam | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
@@ -418,6 +421,8 @@ def update(
               empty string to clear the name. When set, must be unique among active sessions
               within the project.
 
+          network: Network configuration changes to apply to the running browser session.
+
           profile: Profile to load into the browser session. Only allowed if the session does not
               already have a profile loaded.
 
@@ -464,6 +469,7 @@ def update(
                 {
                     "disable_default_proxy": disable_default_proxy,
                     "name": name,
+                    "network": network,
                     "profile": profile,
                     "proxy": proxy,
                     "proxy_id": proxy_id,
@@ -945,7 +951,8 @@ async def create(
               the dashboard. Must be unique among active sessions within the project. Can be
               changed later via PATCH /browsers/{id_or_name}.
 
-          network: Network configuration for the browser session. Cannot be changed after creation.
+          network: Network configuration for the browser session. Only allowed_hosts can be changed
+              after creation, with PATCH /browsers/{id_or_name}.
 
           profile: Profile selection for the browser session. Provide either id or name. If
               specified, the matching profile will be loaded into the browser session.
@@ -1097,6 +1104,7 @@ async def update(
         *,
         disable_default_proxy: bool | Omit = omit,
         name: Optional[str] | Omit = omit,
+        network: BrowserNetworkUpdateParam | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy: BrowserProxyConfigParam | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
@@ -1122,6 +1130,8 @@ async def update(
               empty string to clear the name. When set, must be unique among active sessions
               within the project.
 
+          network: Network configuration changes to apply to the running browser session.
+
           profile: Profile to load into the browser session. Only allowed if the session does not
               already have a profile loaded.
 
@@ -1168,6 +1178,7 @@ async def update(
                 {
                     "disable_default_proxy": disable_default_proxy,
                     "name": name,
+                    "network": network,
                     "profile": profile,
                     "proxy": proxy,
                     "proxy_id": proxy_id,

src/kernel/resources/proxies.py

@@ -53,7 +53,7 @@ def with_streaming_response(self) -> ProxiesResourceWithStreamingResponse:
     def create(
         self,
         *,
-        type: Literal["datacenter", "isp", "residential", "mobile", "custom"],
+        type: Literal["isp", "residential", "mobile", "custom"],
         bypass_hosts: SequenceNotStr[str] | Omit = omit,
         config: proxy_create_params.Config | Omit = omit,
         name: str | Omit = omit,
@@ -69,12 +69,9 @@ def create(
         Create a new proxy configuration in the resolved project.
 
         Args:
-          type: Proxy type to use. In terms of quality for avoiding bot-detection, from best to
-              worst: `mobile` > `residential` > `isp` > `datacenter`.
-
           bypass_hosts: Hostnames that should bypass the parent proxy and connect directly.
 
-          config: Configuration specific to the selected proxy `type`.
+          config: Configuration for an ISP proxy.
 
           name: Readable name of the proxy.
 
@@ -292,25 +289,25 @@ def check(
         """Run a health check on the proxy to verify it's working.
 
         Optionally specify a URL
-        to test reachability against a specific target. For ISP and datacenter proxies,
-        this reliably tests whether the target site is reachable from the proxy's stable
-        exit IP. For residential and mobile proxies, the exit node varies between
-        requests, so this validates proxy configuration and connectivity rather than
-        guaranteeing site-specific reachability.
+        to test reachability against a specific target. For ISP proxies, this reliably
+        tests whether the target site is reachable from the proxy's stable exit IP. For
+        residential and mobile proxies, the exit node varies between requests, so this
+        validates proxy configuration and connectivity rather than guaranteeing
+        site-specific reachability.
 
         Args:
           url: An optional URL to test reachability against. If provided, the proxy check will
               test connectivity to this URL instead of the default test URLs. Only HTTP and
               HTTPS schemes are allowed, and the URL must resolve to a public IP address. For
-              ISP and datacenter proxies, the exit IP is stable, so a successful check
-              reliably indicates that subsequent browser sessions will reach the target site
-              with the same IP. For residential and mobile proxies, the exit node changes
-              between requests, so a successful check validates proxy configuration but does
-              not guarantee that a subsequent browser session will use the same exit IP or
-              reach the same site — it is useful for verifying credentials and connectivity,
-              not for predicting site-specific behavior. When provided, the check result does
-              not update the proxy's health status, since a failure may indicate a problem
-              with the target site rather than the proxy itself.
+              ISP proxies, the exit IP is stable, so a successful check reliably indicates
+              that subsequent browser sessions will reach the target site with the same IP.
+              For residential and mobile proxies, the exit node changes between requests, so a
+              successful check validates proxy configuration but does not guarantee that a
+              subsequent browser session will use the same exit IP or reach the same site — it
+              is useful for verifying credentials and connectivity, not for predicting
+              site-specific behavior. When provided, the check result does not update the
+              proxy's health status, since a failure may indicate a problem with the target
+              site rather than the proxy itself.
 
           extra_headers: Send extra headers
 
@@ -357,7 +354,7 @@ def with_streaming_response(self) -> AsyncProxiesResourceWithStreamingResponse:
     async def create(
         self,
         *,
-        type: Literal["datacenter", "isp", "residential", "mobile", "custom"],
+        type: Literal["isp", "residential", "mobile", "custom"],
         bypass_hosts: SequenceNotStr[str] | Omit = omit,
         config: proxy_create_params.Config | Omit = omit,
         name: str | Omit = omit,
@@ -373,12 +370,9 @@ async def create(
         Create a new proxy configuration in the resolved project.
 
         Args:
-          type: Proxy type to use. In terms of quality for avoiding bot-detection, from best to
-              worst: `mobile` > `residential` > `isp` > `datacenter`.
-
           bypass_hosts: Hostnames that should bypass the parent proxy and connect directly.
 
-          config: Configuration specific to the selected proxy `type`.
+          config: Configuration for an ISP proxy.
 
           name: Readable name of the proxy.
 
@@ -596,25 +590,25 @@ async def check(
         """Run a health check on the proxy to verify it's working.
 
         Optionally specify a URL
-        to test reachability against a specific target. For ISP and datacenter proxies,
-        this reliably tests whether the target site is reachable from the proxy's stable
-        exit IP. For residential and mobile proxies, the exit node varies between
-        requests, so this validates proxy configuration and connectivity rather than
-        guaranteeing site-specific reachability.
+        to test reachability against a specific target. For ISP proxies, this reliably
+        tests whether the target site is reachable from the proxy's stable exit IP. For
+        residential and mobile proxies, the exit node varies between requests, so this
+        validates proxy configuration and connectivity rather than guaranteeing
+        site-specific reachability.
 
         Args:
           url: An optional URL to test reachability against. If provided, the proxy check will
               test connectivity to this URL instead of the default test URLs. Only HTTP and
               HTTPS schemes are allowed, and the URL must resolve to a public IP address. For
-              ISP and datacenter proxies, the exit IP is stable, so a successful check
-              reliably indicates that subsequent browser sessions will reach the target site
-              with the same IP. For residential and mobile proxies, the exit node changes
-              between requests, so a successful check validates proxy configuration but does
-              not guarantee that a subsequent browser session will use the same exit IP or
-              reach the same site — it is useful for verifying credentials and connectivity,
-              not for predicting site-specific behavior. When provided, the check result does
-              not update the proxy's health status, since a failure may indicate a problem
-              with the target site rather than the proxy itself.
+              ISP proxies, the exit IP is stable, so a successful check reliably indicates
+              that subsequent browser sessions will reach the target site with the same IP.
+              For residential and mobile proxies, the exit node changes between requests, so a
+              successful check validates proxy configuration but does not guarantee that a
+              subsequent browser session will use the same exit IP or reach the same site — it
+              is useful for verifying credentials and connectivity, not for predicting
+              site-specific behavior. When provided, the check result does not update the
+              proxy's health status, since a failure may indicate a problem with the target
+              site rather than the proxy itself.
 
           extra_headers: Send extra headers
 

src/kernel/resources/vaults/items.py

@@ -610,7 +610,6 @@ def perform_operation(
         key: str,
         *,
         id_or_name: str,
-        browser_id: str,
         type: Literal["1pw_create_access_request"],
         goal: str | Omit = omit,
         keywords: SequenceNotStr[str] | Omit = omit,
@@ -645,8 +644,6 @@ def perform_operation(
         leave the outcome unknown; do not automatically retry.
 
         Args:
-          browser_id: Kernel browser session used to invoke the extension.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -663,7 +660,6 @@ def perform_operation(
         key: str,
         *,
         id_or_name: str,
-        browser_id: str,
         type: Literal["1pw_access_request_status"],
         timeout_seconds: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -934,7 +930,6 @@ def perform_operation(
         ["id_or_name", "type"],
         ["id_or_name", "checkout", "type"],
         ["id_or_name", "browser_id", "fields", "type"],
-        ["id_or_name", "browser_id", "type"],
         ["id_or_name", "browser_id", "page_url", "type"],
         ["id_or_name", "access_token", "type"],
         ["id_or_name", "bindings", "browser_id", "input", "page_url", "tool_ref", "type"],
@@ -1789,7 +1784,6 @@ async def perform_operation(
         key: str,
         *,
         id_or_name: str,
-        browser_id: str,
         type: Literal["1pw_create_access_request"],
         goal: str | Omit = omit,
         keywords: SequenceNotStr[str] | Omit = omit,
@@ -1824,8 +1818,6 @@ async def perform_operation(
         leave the outcome unknown; do not automatically retry.
 
         Args:
-          browser_id: Kernel browser session used to invoke the extension.
-
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1842,7 +1834,6 @@ async def perform_operation(
         key: str,
         *,
         id_or_name: str,
-        browser_id: str,
         type: Literal["1pw_access_request_status"],
         timeout_seconds: int | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -2113,7 +2104,6 @@ async def perform_operation(
         ["id_or_name", "type"],
         ["id_or_name", "checkout", "type"],
         ["id_or_name", "browser_id", "fields", "type"],
-        ["id_or_name", "browser_id", "type"],
         ["id_or_name", "browser_id", "page_url", "type"],
         ["id_or_name", "access_token", "type"],
         ["id_or_name", "bindings", "browser_id", "input", "page_url", "tool_ref", "type"],

src/kernel/types/__init__.py

@@ -132,6 +132,7 @@
 from .browser_pool_release_params import BrowserPoolReleaseParams as BrowserPoolReleaseParams
 from .config_registry_list_params import ConfigRegistryListParams as ConfigRegistryListParams
 from .browser_network_config_param import BrowserNetworkConfigParam as BrowserNetworkConfigParam
+from .browser_network_update_param import BrowserNetworkUpdateParam as BrowserNetworkUpdateParam
 from .deployment_retrieve_response import DeploymentRetrieveResponse as DeploymentRetrieveResponse
 from .invocation_retrieve_response import InvocationRetrieveResponse as InvocationRetrieveResponse
 from .audit_log_export_chunk_params import AuditLogExportChunkParams as AuditLogExportChunkParams

src/kernel/types/browser_create_params.py

@@ -74,7 +74,8 @@ class BrowserCreateParams(TypedDict, total=False):
     network: BrowserNetworkConfigParam
     """Network configuration for the browser session.
 
-    Cannot be changed after creation.
+    Only allowed_hosts can be changed after creation, with PATCH
+    /browsers/{id_or_name}.
     """
 
     profile: BrowserProfile