release: 0.58.0

.release-please-manifest.json

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

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 112
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-e9c99662d29710f105847d461f8919e06f6aa2e43b0e1a6285d0b137643a7907.yml
-openapi_spec_hash: 4415cb4790c7a5ec892f4e3521217cb4
-config_hash: 27b38657d9a3b33328be930eeb319628
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-0a186c486b56f555cab374ea5f2adbef2d718b5c9190a48c862f0fdf1232324f.yml
+openapi_spec_hash: fad386b8e8712e6639ed9689e9dfc070
+config_hash: 5dde8b5de321a7bb96f695a69eb21c23

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.58.0 (2026-05-26)
+
+Full Changelog: [v0.57.0...v0.58.0](https://github.com/kernel/kernel-python-sdk/compare/v0.57.0...v0.58.0)
+
+### Features
+
+* Support telemetry enabled request config and fix SDK metadata ([a1054a6](https://github.com/kernel/kernel-python-sdk/commit/a1054a6b72e79e0fffc88b1b46661683a8a953b8))
+
 ## 0.57.0 (2026-05-26)
 
 Full Changelog: [v0.57.0...v0.57.0](https://github.com/kernel/kernel-python-sdk/compare/v0.57.0...v0.57.0)

api.md

@@ -137,7 +137,6 @@ from kernel.types.browsers import (
     BrowserTelemetryCategoryConfig,
     BrowserTelemetryConfig,
     BrowserTelemetryEvent,
-    BrowserTelemetryRequestConfig,
     TelemetryStreamResponse,
 )
 ```

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "kernel"
-version = "0.57.0"
+version = "0.58.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.57.0"  # x-release-please-version
+__version__ = "0.58.0"  # x-release-please-version

src/kernel/resources/browsers/browsers.py

@@ -99,7 +99,6 @@
 from ...types.shared_params.browser_profile import BrowserProfile
 from ...types.shared_params.browser_viewport import BrowserViewport
 from ...types.shared_params.browser_extension import BrowserExtension
-from ...types.browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
 
 __all__ = ["BrowsersResource", "AsyncBrowsersResource"]
 
@@ -173,7 +172,7 @@ def create(
         proxy_id: str | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
-        telemetry: Optional[BrowserTelemetryRequestConfigParam] | Omit = omit,
+        telemetry: Optional[browser_create_params.Telemetry] | Omit = omit,
         timeout_seconds: int | Omit = omit,
         viewport: BrowserViewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -327,7 +326,7 @@ def update(
         disable_default_proxy: bool | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
-        telemetry: Optional[BrowserTelemetryRequestConfigParam] | Omit = omit,
+        telemetry: Optional[browser_update_params.Telemetry] | Omit = omit,
         viewport: browser_update_params.Viewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -720,7 +719,7 @@ async def create(
         proxy_id: str | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
-        telemetry: Optional[BrowserTelemetryRequestConfigParam] | Omit = omit,
+        telemetry: Optional[browser_create_params.Telemetry] | Omit = omit,
         timeout_seconds: int | Omit = omit,
         viewport: BrowserViewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -874,7 +873,7 @@ async def update(
         disable_default_proxy: bool | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
-        telemetry: Optional[BrowserTelemetryRequestConfigParam] | Omit = omit,
+        telemetry: Optional[browser_update_params.Telemetry] | Omit = omit,
         viewport: browser_update_params.Viewport | Omit = omit,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.

src/kernel/types/browser_create_params.py

@@ -8,9 +8,9 @@
 from .shared_params.browser_profile import BrowserProfile
 from .shared_params.browser_viewport import BrowserViewport
 from .shared_params.browser_extension import BrowserExtension
-from .browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
+from .browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
 
-__all__ = ["BrowserCreateParams"]
+__all__ = ["BrowserCreateParams", "Telemetry"]
 
 
 class BrowserCreateParams(TypedDict, total=False):
@@ -75,7 +75,7 @@ class BrowserCreateParams(TypedDict, total=False):
     mechanisms.
     """
 
-    telemetry: Optional[BrowserTelemetryRequestConfigParam]
+    telemetry: Optional[Telemetry]
     """Telemetry configuration for the browser session.
 
     Set enabled to true to start capture using VM defaults, or provide browser
@@ -108,3 +108,26 @@ class BrowserCreateParams(TypedDict, total=False):
     based on the resolution (higher resolutions use lower refresh rates to keep
     bandwidth reasonable).
     """
+
+
+class Telemetry(TypedDict, total=False):
+    """Telemetry configuration for the browser session.
+
+    Set enabled to true to start capture using VM defaults, or provide browser category settings. If omitted, null, set to an empty object ({}), set to enabled: false without browser category settings, or all four categories are explicitly disabled, capture is not started.
+    """
+
+    browser: BrowserTelemetryCategoriesConfigParam
+    """Per-category enable/disable flags.
+
+    If enabled is true and browser is omitted or empty, the VM default category set
+    is used. Explicitly disabling all four categories stops capture on update and
+    starts no capture on create.
+    """
+
+    enabled: bool
+    """Request shortcut for browser telemetry capture.
+
+    True enables capture using VM defaults unless browser category settings are
+    provided. False stops capture on update and starts no capture on create.
+    enabled=false cannot be combined with browser category settings.
+    """

src/kernel/types/browser_update_params.py

@@ -7,9 +7,9 @@
 
 from .shared_params.browser_profile import BrowserProfile
 from .shared_params.browser_viewport import BrowserViewport
-from .browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
+from .browsers.browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
 
-__all__ = ["BrowserUpdateParams", "Viewport"]
+__all__ = ["BrowserUpdateParams", "Telemetry", "Viewport"]
 
 
 class BrowserUpdateParams(TypedDict, total=False):
@@ -31,7 +31,7 @@ class BrowserUpdateParams(TypedDict, total=False):
     Omit to leave unchanged, set to empty string to remove proxy.
     """
 
-    telemetry: Optional[BrowserTelemetryRequestConfigParam]
+    telemetry: Optional[Telemetry]
     """Telemetry configuration.
 
     Omit, set to null, or set to an empty object ({}) to leave the existing
@@ -45,6 +45,29 @@ class BrowserUpdateParams(TypedDict, total=False):
     """Viewport configuration to apply to the browser session."""
 
 
+class Telemetry(TypedDict, total=False):
+    """Telemetry configuration.
+
+    Omit, set to null, or set to an empty object ({}) to leave the existing configuration unchanged. Set enabled to true to enable capture using VM defaults. Set enabled to false to stop capture. Provide browser category settings for per-category updates. Explicitly disabling all four categories also stops capture.
+    """
+
+    browser: BrowserTelemetryCategoriesConfigParam
+    """Per-category enable/disable flags.
+
+    If enabled is true and browser is omitted or empty, the VM default category set
+    is used. Explicitly disabling all four categories stops capture on update and
+    starts no capture on create.
+    """
+
+    enabled: bool
+    """Request shortcut for browser telemetry capture.
+
+    True enables capture using VM defaults unless browser category settings are
+    provided. False stops capture on update and starts no capture on create.
+    enabled=false cannot be combined with browser category settings.
+    """
+
+
 class Viewport(BrowserViewport, total=False):
     """Viewport configuration to apply to the browser session."""
 

src/kernel/types/browsers/__init__.py

@@ -82,9 +82,6 @@
 from .browser_monitor_reconnect_failed_event import (
     BrowserMonitorReconnectFailedEvent as BrowserMonitorReconnectFailedEvent,
 )
-from .browser_telemetry_request_config_param import (
-    BrowserTelemetryRequestConfigParam as BrowserTelemetryRequestConfigParam,
-)
 from .browser_telemetry_category_config_param import (
     BrowserTelemetryCategoryConfigParam as BrowserTelemetryCategoryConfigParam,
 )