kernel 0.69.0__tar.gz → 0.70.0__tar.gz

kernel-0.70.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.70.0"
+}

{kernel-0.69.0 → kernel-0.70.0}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.70.0 (2026-06-24)
+
+Full Changelog: [v0.69.0...v0.70.0](https://github.com/kernel/kernel-python-sdk/compare/v0.69.0...v0.70.0)
+
+### Features
+
+* Add GET /browsers/{id}/telemetry/events (read from S2) ([57eb393](https://github.com/kernel/kernel-python-sdk/commit/57eb393ea1eb5fb0d2e5211845f338610198a0fd))
+* Align browser-pool timeout/viewport/fill-rate contract with implementation; reject save_changes on update ([4fddd6b](https://github.com/kernel/kernel-python-sdk/commit/4fddd6bb3f2ccb86ec3cc492311d5fe9c061ba49))
+* api: support per-acquire start_url override on browser pool acquire ([3e11311](https://github.com/kernel/kernel-python-sdk/commit/3e11311f835d558c4fa6ab0c0fb8a9c7e3536a13))
+* **api:** add GET /extensions/{id_or_name}/metadata ([681a8fc](https://github.com/kernel/kernel-python-sdk/commit/681a8fcd7d8ec5c3373a66c81fb405a6844308eb))
+* **api:** resolve GET /org/projects/{id} by ID or name ([52eb598](https://github.com/kernel/kernel-python-sdk/commit/52eb598c7bfd6e696f0d510585439ba5658dc161))
+* Forward replay param through telemetry stream passthrough ([a8001d2](https://github.com/kernel/kernel-python-sdk/commit/a8001d239ae583fa177164e1ce900e767797c853))
+
+
+### Bug Fixes
+
+* don't misroute telemetry/events to the browser VM ([9bcc418](https://github.com/kernel/kernel-python-sdk/commit/9bcc418b4294295c0d8377adfc921c3748d42019))
+
 ## 0.69.0 (2026-06-18)
 
 Full Changelog: [v0.68.0...v0.69.0](https://github.com/kernel/kernel-python-sdk/compare/v0.68.0...v0.69.0)

{kernel-0.69.0 → kernel-0.70.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.69.0
+Version: 0.70.0
 Summary: The official Python library for the kernel API
 Project-URL: Homepage, https://github.com/kernel/kernel-python-sdk
 Project-URL: Repository, https://github.com/kernel/kernel-python-sdk

{kernel-0.69.0 → kernel-0.70.0}/api.md

@@ -146,13 +146,15 @@ from kernel.types.browsers import (
     BrowserTelemetryCategoryConfig,
     BrowserTelemetryConfig,
     BrowserTelemetryEvent,
+    TelemetryEventsResponse,
     TelemetryStreamResponse,
 )
 ```
 
 Methods:
 
-- <code title="get /browsers/{id}/telemetry/stream">client.browsers.telemetry.<a href="./src/kernel/resources/browsers/telemetry.py">stream</a>(id) -> <a href="./src/kernel/types/browsers/telemetry_stream_response.py">TelemetryStreamResponse</a></code>
+- <code title="get /browsers/{id}/telemetry/events">client.browsers.telemetry.<a href="./src/kernel/resources/browsers/telemetry.py">events</a>(id, \*\*<a href="src/kernel/types/browsers/telemetry_events_params.py">params</a>) -> <a href="./src/kernel/types/browsers/telemetry_events_response.py">SyncOffsetPagination[TelemetryEventsResponse]</a></code>
+- <code title="get /browsers/{id}/telemetry/stream">client.browsers.telemetry.<a href="./src/kernel/resources/browsers/telemetry.py">stream</a>(id, \*\*<a href="src/kernel/types/browsers/telemetry_stream_params.py">params</a>) -> <a href="./src/kernel/types/browsers/telemetry_stream_response.py">TelemetryStreamResponse</a></code>
 
 ## Replays
 
@@ -342,7 +344,7 @@ Methods:
 Types:
 
 ```python
-from kernel.types import ExtensionListResponse, ExtensionUploadResponse
+from kernel.types import ExtensionListResponse, ExtensionGetResponse, ExtensionUploadResponse
 ```
 
 Methods:
@@ -351,6 +353,7 @@ Methods:
 - <code title="delete /extensions/{id_or_name}">client.extensions.<a href="./src/kernel/resources/extensions.py">delete</a>(id_or_name) -> None</code>
 - <code title="get /extensions/{id_or_name}">client.extensions.<a href="./src/kernel/resources/extensions.py">download</a>(id_or_name) -> BinaryAPIResponse</code>
 - <code title="get /extensions/from_chrome_store">client.extensions.<a href="./src/kernel/resources/extensions.py">download_from_chrome_store</a>(\*\*<a href="src/kernel/types/extension_download_from_chrome_store_params.py">params</a>) -> BinaryAPIResponse</code>
+- <code title="get /extensions/{id_or_name}/metadata">client.extensions.<a href="./src/kernel/resources/extensions.py">get</a>(id_or_name) -> <a href="./src/kernel/types/extension_get_response.py">ExtensionGetResponse</a></code>
 - <code title="post /extensions">client.extensions.<a href="./src/kernel/resources/extensions.py">upload</a>(\*\*<a href="src/kernel/types/extension_upload_params.py">params</a>) -> <a href="./src/kernel/types/extension_upload_response.py">ExtensionUploadResponse</a></code>
 
 # BrowserPools

{kernel-0.69.0 → kernel-0.70.0}/pyproject.toml

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

{kernel-0.69.0 → kernel-0.70.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.69.0"  # x-release-please-version
+__version__ = "0.70.0"  # x-release-please-version

{kernel-0.69.0 → kernel-0.70.0}/src/kernel/lib/browser_routing/routing.py

@@ -41,7 +41,10 @@ _BROWSER_POOL_RELEASE_PATH = re.compile(r"^/(?:v\d+/)?browser_pools/[^/]+/releas
 def browser_routing_config_from_env() -> BrowserRoutingConfig:
     raw = os.environ.get("KERNEL_BROWSER_ROUTING_SUBRESOURCES")
     if raw is None:
-        return BrowserRoutingConfig(subresources=("curl", "telemetry"))
+        # Path prefixes eligible for direct-to-VM routing. "telemetry/stream" is
+        # the live SSE endpoint (VM); "telemetry/events" is a historical read
+        # served by the control plane (S2) and must NOT be here.
+        return BrowserRoutingConfig(subresources=("curl", "telemetry/stream"))
     if raw.strip() == "":
         return BrowserRoutingConfig()
 
@@ -188,6 +191,21 @@ def _session_id_from_browser_pool_release_request(request: httpx.Request, path:
     return normalized or None
 
 
+def _matches_direct_vm_prefix(tail: str, prefixes: tuple[str, ...]) -> bool:
+    """Whether tail (the path after browsers/{id}/) is covered by an allow prefix,
+    matching on segment boundaries: "telemetry/stream" matches "telemetry/stream"
+    and "telemetry/stream/...", but not "telemetry/events" or "telemetry/streamfoo".
+    Keeps historical control-plane reads (e.g. telemetry/events, served from S2)
+    off the VM.
+    """
+    tail = tail.strip("/")
+    for prefix in prefixes:
+        prefix = prefix.strip("/")
+        if prefix and (tail == prefix or tail.startswith(prefix + "/")):
+            return True
+    return False
+
+
 def rewrite_direct_vm_options(
     options: FinalRequestOptions,
     *,
@@ -199,7 +217,7 @@ def rewrite_direct_vm_options(
         return options
 
     session_id, subresource, suffix = match
-    if subresource not in set(config.subresources):
+    if not _matches_direct_vm_prefix(f"{subresource}{suffix}", config.subresources):
         return options
 
     route = cache.get(session_id)

{kernel-0.69.0 → kernel-0.70.0}/src/kernel/resources/browser_pools.py

@@ -96,7 +96,9 @@ class BrowserPoolsResource(SyncAPIResource):
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -122,7 +124,7 @@ class BrowserPoolsResource(SyncAPIResource):
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -243,7 +245,9 @@ class BrowserPoolsResource(SyncAPIResource):
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -273,7 +277,7 @@ class BrowserPoolsResource(SyncAPIResource):
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -423,6 +427,7 @@ class BrowserPoolsResource(SyncAPIResource):
         *,
         acquire_timeout_seconds: int | Omit = omit,
         name: str | Omit = omit,
+        start_url: str | Omit = omit,
         tags: TagsParam | 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.
@@ -448,6 +453,10 @@ class BrowserPoolsResource(SyncAPIResource):
               project. Applies to this lease only and is cleared when the browser is released
               back to the pool.
 
+          start_url: Optional URL to navigate the acquired browser to. Overrides the pool's start_url
+              for this acquire only. Best-effort: failures to navigate do not fail the
+              acquire.
+
           tags: Optional user-defined key-value tags for the acquired browser session, used to
               find and group sessions later. Applies to this lease only and are cleared when
               the browser is released back to the pool. Up to 50 pairs.
@@ -468,6 +477,7 @@ class BrowserPoolsResource(SyncAPIResource):
                 {
                     "acquire_timeout_seconds": acquire_timeout_seconds,
                     "name": name,
+                    "start_url": start_url,
                     "tags": tags,
                 },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,
@@ -621,7 +631,9 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -647,7 +659,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -768,7 +780,9 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
 
           extensions: List of browser extensions to load into the session. Provide each by id or name.
 
-          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10%.
+          fill_rate_per_minute: Percentage of the pool to fill per minute. Defaults to 10. The cap is 25 for
+              most organizations but can be raised per-organization, so only the lower bound
+              is enforced here.
 
           headless: If true, launches the browser using a headless image. Defaults to false.
 
@@ -798,7 +812,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               mechanisms.
 
           timeout_seconds: Default idle timeout in seconds for browsers acquired from this pool before they
-              are destroyed. Defaults to 600 seconds if not specified
+              are destroyed. Defaults to 600 seconds. Minimum 10, maximum 259200 (72 hours).
 
           viewport: Initial browser window size in pixels with optional refresh rate. If omitted,
               image defaults apply (1920x1080@25). For GPU images, the default is
@@ -948,6 +962,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
         *,
         acquire_timeout_seconds: int | Omit = omit,
         name: str | Omit = omit,
+        start_url: str | Omit = omit,
         tags: TagsParam | 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.
@@ -973,6 +988,10 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               project. Applies to this lease only and is cleared when the browser is released
               back to the pool.
 
+          start_url: Optional URL to navigate the acquired browser to. Overrides the pool's start_url
+              for this acquire only. Best-effort: failures to navigate do not fail the
+              acquire.
+
           tags: Optional user-defined key-value tags for the acquired browser session, used to
               find and group sessions later. Applies to this lease only and are cleared when
               the browser is released back to the pool. Up to 50 pairs.
@@ -993,6 +1012,7 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
                 {
                     "acquire_timeout_seconds": acquire_timeout_seconds,
                     "name": name,
+                    "start_url": start_url,
                     "tags": tags,
                 },
                 browser_pool_acquire_params.BrowserPoolAcquireParams,

kernel-0.70.0/src/kernel/resources/browsers/telemetry.py

@@ -0,0 +1,403 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import List
+from typing_extensions import Literal
+
+import httpx
+
+from ..._types import Body, Omit, Query, Headers, NotGiven, omit, not_given
+from ..._utils import path_template, maybe_transform, strip_not_given, async_maybe_transform
+from ..._compat import cached_property
+from ..._resource import SyncAPIResource, AsyncAPIResource
+from ..._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ..._streaming import Stream, AsyncStream
+from ...pagination import SyncOffsetPagination, AsyncOffsetPagination
+from ..._base_client import AsyncPaginator, make_request_options
+from ...types.browsers import telemetry_events_params, telemetry_stream_params
+from ...types.browsers.telemetry_events_response import TelemetryEventsResponse
+from ...types.browsers.telemetry_stream_response import TelemetryStreamResponse
+
+__all__ = ["TelemetryResource", "AsyncTelemetryResource"]
+
+
+class TelemetryResource(SyncAPIResource):
+    """Stream live telemetry events from a browser session."""
+
+    @cached_property
+    def with_raw_response(self) -> TelemetryResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return TelemetryResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> TelemetryResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#with_streaming_response
+        """
+        return TelemetryResourceWithStreamingResponse(self)
+
+    def events(
+        self,
+        id: str,
+        *,
+        category: List[
+            Literal[
+                "console",
+                "network",
+                "page",
+                "interaction",
+                "control",
+                "connection",
+                "system",
+                "screenshot",
+                "captcha",
+                "monitor",
+            ]
+        ]
+        | Omit = omit,
+        limit: int | Omit = omit,
+        offset: int | Omit = omit,
+        since: str | Omit = omit,
+        until: str | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> SyncOffsetPagination[TelemetryEventsResponse]:
+        """
+        Reads a page of telemetry events for the browser session in ascending sequence
+        order. To page through results, pass the X-Next-Offset value from the previous
+        response as offset and repeat while X-Has-More is true. Returns an empty list
+        when telemetry data is unavailable.
+
+        Args:
+          category: Restrict results to these event categories. Repeat the parameter for multiple
+              values.
+
+          limit: Maximum number of events per page. Defaults to 20.
+
+          offset: Opaque pagination cursor: pass the X-Next-Offset value from the previous
+              response to fetch the next page. When set, paging continues from this cursor and
+              since is ignored, while until still bounds the page. It is not an event's seq
+              field, so do not derive it from the response body.
+
+          since: Start of the window: an RFC-3339 timestamp, or a duration like 5m meaning that
+              long ago. Defaults to 5m. Ignored when offset is set.
+
+          until: End of the window (exclusive): an RFC-3339 timestamp, or a duration like 5m
+              meaning that long ago.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get_api_list(
+            path_template("/browsers/{id}/telemetry/events", id=id),
+            page=SyncOffsetPagination[TelemetryEventsResponse],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "category": category,
+                        "limit": limit,
+                        "offset": offset,
+                        "since": since,
+                        "until": until,
+                    },
+                    telemetry_events_params.TelemetryEventsParams,
+                ),
+            ),
+            model=TelemetryEventsResponse,
+        )
+
+    def stream(
+        self,
+        id: str,
+        *,
+        replay: str | Omit = omit,
+        last_event_id: str | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> Stream[TelemetryStreamResponse]:
+        """Streams browser telemetry events as a server-sent events (SSE) stream.
+
+        The
+        stream closes when the browser session terminates. Each event frame includes an
+        id: field containing a monotonically increasing sequence number; pass it as
+        Last-Event-ID on reconnect to resume without gaps. The event: field is never
+        set; all frames carry JSON in the data: field. A keepalive comment frame is sent
+        every 15 seconds when no events arrive. Returns 404 if the browser session does
+        not exist. If telemetry was not enabled on the session, the stream opens but no
+        events are delivered. Fresh connections only see new events; pass replay=all to
+        start from the oldest retained event instead.
+
+        Args:
+          replay: Pass `all` to start from the oldest retained event instead of only new events;
+              any other value is treated as from-now. The buffer is bounded, so the first
+              event id may be greater than 1 if older events were evicted.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
+        extra_headers = {**strip_not_given({"Last-Event-ID": last_event_id}), **(extra_headers or {})}
+        return self._get(
+            path_template("/browsers/{id}/telemetry/stream", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform({"replay": replay}, telemetry_stream_params.TelemetryStreamParams),
+            ),
+            cast_to=TelemetryStreamResponse,
+            stream=True,
+            stream_cls=Stream[TelemetryStreamResponse],
+        )
+
+
+class AsyncTelemetryResource(AsyncAPIResource):
+    """Stream live telemetry events from a browser session."""
+
+    @cached_property
+    def with_raw_response(self) -> AsyncTelemetryResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#accessing-raw-response-data-eg-headers
+        """
+        return AsyncTelemetryResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncTelemetryResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
+
+        For more information, see https://www.github.com/kernel/kernel-python-sdk#with_streaming_response
+        """
+        return AsyncTelemetryResourceWithStreamingResponse(self)
+
+    def events(
+        self,
+        id: str,
+        *,
+        category: List[
+            Literal[
+                "console",
+                "network",
+                "page",
+                "interaction",
+                "control",
+                "connection",
+                "system",
+                "screenshot",
+                "captcha",
+                "monitor",
+            ]
+        ]
+        | Omit = omit,
+        limit: int | Omit = omit,
+        offset: int | Omit = omit,
+        since: str | Omit = omit,
+        until: str | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AsyncPaginator[TelemetryEventsResponse, AsyncOffsetPagination[TelemetryEventsResponse]]:
+        """
+        Reads a page of telemetry events for the browser session in ascending sequence
+        order. To page through results, pass the X-Next-Offset value from the previous
+        response as offset and repeat while X-Has-More is true. Returns an empty list
+        when telemetry data is unavailable.
+
+        Args:
+          category: Restrict results to these event categories. Repeat the parameter for multiple
+              values.
+
+          limit: Maximum number of events per page. Defaults to 20.
+
+          offset: Opaque pagination cursor: pass the X-Next-Offset value from the previous
+              response to fetch the next page. When set, paging continues from this cursor and
+              since is ignored, while until still bounds the page. It is not an event's seq
+              field, so do not derive it from the response body.
+
+          since: Start of the window: an RFC-3339 timestamp, or a duration like 5m meaning that
+              long ago. Defaults to 5m. Ignored when offset is set.
+
+          until: End of the window (exclusive): an RFC-3339 timestamp, or a duration like 5m
+              meaning that long ago.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get_api_list(
+            path_template("/browsers/{id}/telemetry/events", id=id),
+            page=AsyncOffsetPagination[TelemetryEventsResponse],
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "category": category,
+                        "limit": limit,
+                        "offset": offset,
+                        "since": since,
+                        "until": until,
+                    },
+                    telemetry_events_params.TelemetryEventsParams,
+                ),
+            ),
+            model=TelemetryEventsResponse,
+        )
+
+    async def stream(
+        self,
+        id: str,
+        *,
+        replay: str | Omit = omit,
+        last_event_id: str | 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.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> AsyncStream[TelemetryStreamResponse]:
+        """Streams browser telemetry events as a server-sent events (SSE) stream.
+
+        The
+        stream closes when the browser session terminates. Each event frame includes an
+        id: field containing a monotonically increasing sequence number; pass it as
+        Last-Event-ID on reconnect to resume without gaps. The event: field is never
+        set; all frames carry JSON in the data: field. A keepalive comment frame is sent
+        every 15 seconds when no events arrive. Returns 404 if the browser session does
+        not exist. If telemetry was not enabled on the session, the stream opens but no
+        events are delivered. Fresh connections only see new events; pass replay=all to
+        start from the oldest retained event instead.
+
+        Args:
+          replay: Pass `all` to start from the oldest retained event instead of only new events;
+              any other value is treated as from-now. The buffer is bounded, so the first
+              event id may be greater than 1 if older events were evicted.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        extra_headers = {"Accept": "text/event-stream", **(extra_headers or {})}
+        extra_headers = {**strip_not_given({"Last-Event-ID": last_event_id}), **(extra_headers or {})}
+        return await self._get(
+            path_template("/browsers/{id}/telemetry/stream", id=id),
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform({"replay": replay}, telemetry_stream_params.TelemetryStreamParams),
+            ),
+            cast_to=TelemetryStreamResponse,
+            stream=True,
+            stream_cls=AsyncStream[TelemetryStreamResponse],
+        )
+
+
+class TelemetryResourceWithRawResponse:
+    def __init__(self, telemetry: TelemetryResource) -> None:
+        self._telemetry = telemetry
+
+        self.events = to_raw_response_wrapper(
+            telemetry.events,
+        )
+        self.stream = to_raw_response_wrapper(
+            telemetry.stream,
+        )
+
+
+class AsyncTelemetryResourceWithRawResponse:
+    def __init__(self, telemetry: AsyncTelemetryResource) -> None:
+        self._telemetry = telemetry
+
+        self.events = async_to_raw_response_wrapper(
+            telemetry.events,
+        )
+        self.stream = async_to_raw_response_wrapper(
+            telemetry.stream,
+        )
+
+
+class TelemetryResourceWithStreamingResponse:
+    def __init__(self, telemetry: TelemetryResource) -> None:
+        self._telemetry = telemetry
+
+        self.events = to_streamed_response_wrapper(
+            telemetry.events,
+        )
+        self.stream = to_streamed_response_wrapper(
+            telemetry.stream,
+        )
+
+
+class AsyncTelemetryResourceWithStreamingResponse:
+    def __init__(self, telemetry: AsyncTelemetryResource) -> None:
+        self._telemetry = telemetry
+
+        self.events = async_to_streamed_response_wrapper(
+            telemetry.events,
+        )
+        self.stream = async_to_streamed_response_wrapper(
+            telemetry.stream,
+        )