feat: Support telemetry enabled request config

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-a0ad160eb0fb11e201e240de8487c12992a474076aeed1c1167ee54ade43edfb.yml
-openapi_spec_hash: 84a7075fddbe17b1446a759e8cc39047
-config_hash: 26beac3050665664d5d74d2bbfe9e808
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-e9c99662d29710f105847d461f8919e06f6aa2e43b0e1a6285d0b137643a7907.yml
+openapi_spec_hash: 4415cb4790c7a5ec892f4e3521217cb4
+config_hash: 27b38657d9a3b33328be930eeb319628

api.md

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

src/kernel/resources/browsers/browsers.py

@@ -99,7 +99,7 @@
 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_config_param import BrowserTelemetryConfigParam
+from ...types.browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
 
 __all__ = ["BrowsersResource", "AsyncBrowsersResource"]
 
@@ -173,7 +173,7 @@ def create(
         proxy_id: str | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
-        telemetry: Optional[BrowserTelemetryConfigParam] | Omit = omit,
+        telemetry: Optional[BrowserTelemetryRequestConfigParam] | 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.
@@ -219,9 +219,11 @@ def create(
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
-          telemetry: Telemetry configuration for the browser session. If provided, telemetry capture
-              starts with the specified category filter when the session is created. If
-              omitted, no telemetry capture is started.
+          telemetry: 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.
 
           timeout_seconds: The number of seconds of inactivity before the browser session is terminated.
               Activity includes CDP connections and live view connections. Defaults to 60
@@ -325,7 +327,7 @@ def update(
         disable_default_proxy: bool | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
-        telemetry: Optional[BrowserTelemetryConfigParam] | Omit = omit,
+        telemetry: Optional[BrowserTelemetryRequestConfigParam] | 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.
@@ -348,9 +350,10 @@ def update(
               proxy.
 
           telemetry: Telemetry configuration. Omit, set to null, or set to an empty object ({}) to
-              leave the existing configuration unchanged (no-op). To enable capture for all
-              categories using VM defaults, set browser to an empty object ({"browser": {}}).
-              To stop capture, set every category's enabled to false.
+              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.
 
           viewport: Viewport configuration to apply to the browser session.
 
@@ -717,7 +720,7 @@ async def create(
         proxy_id: str | Omit = omit,
         start_url: str | Omit = omit,
         stealth: bool | Omit = omit,
-        telemetry: Optional[BrowserTelemetryConfigParam] | Omit = omit,
+        telemetry: Optional[BrowserTelemetryRequestConfigParam] | 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.
@@ -763,9 +766,11 @@ async def create(
           stealth: If true, launches the browser in stealth mode to reduce detection by anti-bot
               mechanisms.
 
-          telemetry: Telemetry configuration for the browser session. If provided, telemetry capture
-              starts with the specified category filter when the session is created. If
-              omitted, no telemetry capture is started.
+          telemetry: 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.
 
           timeout_seconds: The number of seconds of inactivity before the browser session is terminated.
               Activity includes CDP connections and live view connections. Defaults to 60
@@ -869,7 +874,7 @@ async def update(
         disable_default_proxy: bool | Omit = omit,
         profile: BrowserProfile | Omit = omit,
         proxy_id: Optional[str] | Omit = omit,
-        telemetry: Optional[BrowserTelemetryConfigParam] | Omit = omit,
+        telemetry: Optional[BrowserTelemetryRequestConfigParam] | 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.
@@ -892,9 +897,10 @@ async def update(
               proxy.
 
           telemetry: Telemetry configuration. Omit, set to null, or set to an empty object ({}) to
-              leave the existing configuration unchanged (no-op). To enable capture for all
-              categories using VM defaults, set browser to an empty object ({"browser": {}}).
-              To stop capture, set every category's enabled to false.
+              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.
 
           viewport: Viewport configuration to apply to the browser session.
 

src/kernel/types/browser_create_params.py

@@ -8,7 +8,7 @@
 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_config_param import BrowserTelemetryConfigParam
+from .browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
 
 __all__ = ["BrowserCreateParams"]
 
@@ -75,11 +75,13 @@ class BrowserCreateParams(TypedDict, total=False):
     mechanisms.
     """
 
-    telemetry: Optional[BrowserTelemetryConfigParam]
+    telemetry: Optional[BrowserTelemetryRequestConfigParam]
     """Telemetry configuration for the browser session.
 
-    If provided, telemetry capture starts with the specified category filter when
-    the session is created. If omitted, no telemetry capture is started.
+    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.
     """
 
     timeout_seconds: int

src/kernel/types/browser_update_params.py

@@ -7,7 +7,7 @@
 
 from .shared_params.browser_profile import BrowserProfile
 from .shared_params.browser_viewport import BrowserViewport
-from .browsers.browser_telemetry_config_param import BrowserTelemetryConfigParam
+from .browsers.browser_telemetry_request_config_param import BrowserTelemetryRequestConfigParam
 
 __all__ = ["BrowserUpdateParams", "Viewport"]
 
@@ -31,13 +31,14 @@ class BrowserUpdateParams(TypedDict, total=False):
     Omit to leave unchanged, set to empty string to remove proxy.
     """
 
-    telemetry: Optional[BrowserTelemetryConfigParam]
+    telemetry: Optional[BrowserTelemetryRequestConfigParam]
     """Telemetry configuration.
 
     Omit, set to null, or set to an empty object ({}) to leave the existing
-    configuration unchanged (no-op). To enable capture for all categories using VM
-    defaults, set browser to an empty object ({"browser": {}}). To stop capture, set
-    every category's enabled to false.
+    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.
     """
 
     viewport: Viewport

src/kernel/types/browsers/__init__.py

@@ -57,7 +57,6 @@
 from .browser_page_tab_opened_event import BrowserPageTabOpenedEvent as BrowserPageTabOpenedEvent
 from .f_set_file_permissions_params import FSetFilePermissionsParams as FSetFilePermissionsParams
 from .browser_network_response_event import BrowserNetworkResponseEvent as BrowserNetworkResponseEvent
-from .browser_telemetry_config_param import BrowserTelemetryConfigParam as BrowserTelemetryConfigParam
 from .process_stdout_stream_response import ProcessStdoutStreamResponse as ProcessStdoutStreamResponse
 from .browser_interaction_click_event import BrowserInteractionClickEvent as BrowserInteractionClickEvent
 from .browser_page_layout_shift_event import BrowserPageLayoutShiftEvent as BrowserPageLayoutShiftEvent
@@ -83,6 +82,9 @@
 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,
 )

src/kernel/types/browsers/browser_telemetry_config.py

@@ -9,7 +9,7 @@
 
 
 class BrowserTelemetryConfig(BaseModel):
-    """Telemetry configuration for a browser session."""
+    """Active telemetry configuration for a browser session."""
 
     browser: Optional[BrowserTelemetryCategoriesConfig] = None
-    """Per-category enable/disable flags. If omitted, all categories are captured."""
+    """Per-category enable/disable flags."""

src/kernel/types/browsers/browser_telemetry_config_param.py

@@ -0,0 +1,28 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+from .browser_telemetry_categories_config_param import BrowserTelemetryCategoriesConfigParam
+
+__all__ = ["BrowserTelemetryRequestConfigParam"]
+
+
+class BrowserTelemetryRequestConfigParam(TypedDict, total=False):
+    """Telemetry request configuration for a browser session."""
+
+    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. False stops capture on update and starts
+    no capture on create. Cannot be combined with browser category settings.
+    """

src/kernel/types/browsers/browser_telemetry_request_config_param.py

@@ -59,7 +59,8 @@ def test_method_create_with_all_params(self, client: Kernel) -> None:
                     "interaction": {"enabled": True},
                     "network": {"enabled": True},
                     "page": {"enabled": True},
-                }
+                },
+                "enabled": True,
             },
             timeout_seconds=10,
             viewport={
@@ -169,7 +170,8 @@ def test_method_update_with_all_params(self, client: Kernel) -> None:
                     "interaction": {"enabled": True},
                     "network": {"enabled": True},
                     "page": {"enabled": True},
-                }
+                },
+                "enabled": True,
             },
             viewport={
                 "height": 800,
@@ -463,7 +465,8 @@ async def test_method_create_with_all_params(self, async_client: AsyncKernel) ->
                     "interaction": {"enabled": True},
                     "network": {"enabled": True},
                     "page": {"enabled": True},
-                }
+                },
+                "enabled": True,
             },
             timeout_seconds=10,
             viewport={
@@ -573,7 +576,8 @@ async def test_method_update_with_all_params(self, async_client: AsyncKernel) ->
                     "interaction": {"enabled": True},
                     "network": {"enabled": True},
                     "page": {"enabled": True},
-                }
+                },
+                "enabled": True,
             },
             viewport={
                 "height": 800,