release: 0.94.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.93.0"
+  ".": "0.94.0"
 }

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.94.0](https://github.com/kernel/kernel-python-sdk/compare/v0.93.0...v0.94.0) (2026-08-21)
+
+
+### Features
+
+* Mirror the control/platform telemetry split into the public API ([17c38fa](https://github.com/kernel/kernel-python-sdk/commit/17c38fa6c7668a7e2bb1f058d57053d83238263a))
+
 ## [0.93.0](https://github.com/kernel/kernel-python-sdk/compare/v0.92.0...v0.93.0) (2026-08-19)
 
 

api.md

@@ -117,6 +117,8 @@ from kernel.types.browsers import (
     BrowserAPICallEvent,
     BrowserCallStack,
     BrowserCaptchaSolveResultEvent,
+    BrowserCdpCommandEvent,
+    BrowserCdpCommandMethod,
     BrowserCdpConnectEvent,
     BrowserCdpDisconnectEvent,
     BrowserConsoleErrorEvent,
@@ -138,6 +140,7 @@ from kernel.types.browsers import (
     BrowserNetworkLoadingFailedEvent,
     BrowserNetworkRequestEvent,
     BrowserNetworkResponseEvent,
+    BrowserPageCrashedEvent,
     BrowserPageDomContentLoadedEvent,
     BrowserPageLayoutSettledEvent,
     BrowserPageLayoutShiftEvent,
@@ -146,12 +149,15 @@ from kernel.types.browsers import (
     BrowserPageNavigationEvent,
     BrowserPageNavigationSettledEvent,
     BrowserPageTabOpenedEvent,
+    BrowserPlatformAPICallEvent,
     BrowserProxyErrorEvent,
     BrowserServiceCrashedEvent,
     BrowserSystemOomKillEvent,
     BrowserTelemetryCategoriesConfig,
     BrowserTelemetryCategoryConfig,
+    BrowserTelemetryCdpControlConfig,
     BrowserTelemetryConfig,
+    BrowserTelemetryControlConfig,
     BrowserTelemetryEvent,
     BrowserTelemetryExportConfig,
     BrowserTelemetryOtlpExportConfig,

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.93.0"
+version = "0.94.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.93.0"  # x-release-please-version
+__version__ = "0.94.0"  # x-release-please-version

src/kernel/resources/browsers/browsers.py

@@ -208,7 +208,7 @@ def create(
           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
-              Enterprise plan and headless=false.
+              Enterprise plan, headless=false, and region=us-east.
 
           headless: If true, launches the browser using a headless image (no VNC/GUI). Defaults to
               false.
@@ -828,7 +828,7 @@ async def create(
           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
-              Enterprise plan and headless=false.
+              Enterprise plan, headless=false, and region=us-east.
 
           headless: If true, launches the browser using a headless image (no VNC/GUI). Defaults to
               false.

src/kernel/resources/browsers/telemetry.py

@@ -62,6 +62,7 @@ def events(
                 "page",
                 "interaction",
                 "control",
+                "platform",
                 "connection",
                 "system",
                 "screenshot",
@@ -238,6 +239,7 @@ def events(
                 "page",
                 "interaction",
                 "control",
+                "platform",
                 "connection",
                 "system",
                 "screenshot",

src/kernel/resources/proxies.py

@@ -252,7 +252,10 @@ def delete(
     ) -> None:
         """Soft delete a proxy.
 
-        Sessions referencing it are not modified.
+        Session records referencing it are not modified. If egress
+        binding polling is enabled, existing tunnels for active sessions using the proxy
+        are terminated within one polling interval; subsequent connections through the
+        deleted proxy are rejected.
 
         Args:
           extra_headers: Send extra headers
@@ -553,7 +556,10 @@ async def delete(
     ) -> None:
         """Soft delete a proxy.
 
-        Sessions referencing it are not modified.
+        Session records referencing it are not modified. If egress
+        binding polling is enabled, existing tunnels for active sessions using the proxy
+        are terminated within one polling interval; subsequent connections through the
+        deleted proxy are rejected.
 
         Args:
           extra_headers: Send extra headers

src/kernel/types/auth/connection_create_params.py

@@ -175,13 +175,13 @@ class BrowserTelemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool

src/kernel/types/auth/connection_login_params.py

@@ -96,13 +96,13 @@ class BrowserTelemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool

src/kernel/types/auth/connection_update_params.py

@@ -135,13 +135,13 @@ class BrowserTelemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool

src/kernel/types/auth/managed_auth.py

@@ -79,13 +79,13 @@ class BrowserTelemetry(BaseModel):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: Optional[bool] = None

src/kernel/types/auth/managed_auth_browser_config.py

@@ -67,13 +67,13 @@ class Telemetry(BaseModel):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: Optional[bool] = None

src/kernel/types/auth/managed_auth_browser_config_param.py

@@ -69,13 +69,13 @@ class Telemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool

src/kernel/types/browser_create_params.py

@@ -41,7 +41,7 @@ class BrowserCreateParams(TypedDict, total=False):
     gpu: bool
     """If true, enables GPU acceleration for the browser session.
 
-    Requires Start-Up or Enterprise plan and headless=false.
+    Requires Start-Up or Enterprise plan, headless=false, and region=us-east.
     """
 
     headless: bool
@@ -221,13 +221,13 @@ class Telemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool

src/kernel/types/browser_pool_acquire_params.py

@@ -115,13 +115,13 @@ class Telemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool

src/kernel/types/browser_pool_create_params.py

@@ -216,13 +216,13 @@ class Telemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool

src/kernel/types/browser_pool_update_params.py

@@ -226,13 +226,13 @@ class Telemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool

src/kernel/types/browser_update_params.py

@@ -136,13 +136,13 @@ class Telemetry(TypedDict, total=False):
 
     The operational categories (control, connection, system, captcha) are captured
     whenever telemetry is enabled; set one to enabled=false to opt out. The CDP
-    categories (console, network, page, interaction) and screenshot are off by
-    default; set enabled=true to opt in. On create, provided categories layer onto
-    the default set. On update, provided categories merge onto the session's current
-    config; when no telemetry is active this falls back to the default set (matching
-    create). If browser is omitted or empty, the default set is used. A browser
-    config that disables every category stops capture on update and starts no
-    capture on create.
+    categories (console, network, page, interaction), screenshot and platform are
+    off by default; set enabled=true to opt in. On create, provided categories layer
+    onto the default set. On update, provided categories merge onto the session's
+    current config; when no telemetry is active this falls back to the default set
+    (matching create). If browser is omitted or empty, the default set is used. A
+    browser config that disables every category stops capture on update and starts
+    no capture on create.
     """
 
     enabled: bool