feat: Add order=desc pagination to telemetry event reads

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 125
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-ea36e417a5dbc80a7dab65b38bd6c892520929d31363e626a3341436d697a17c.yml
-openapi_spec_hash: fb15f771cbf9c937a4674f23f9a56050
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/kernel/kernel-ebbe079bb2542625826422afd876a3e8b499c579cf45efc5fd50e7982d34df7d.yml
+openapi_spec_hash: db850b61a0d71fe9f4b642df8782d7ae
 config_hash: 06186eb40e0058a2a87ac251fc07415d

src/kernel/resources/browsers/telemetry.py

@@ -70,6 +70,7 @@ def events(
         | Omit = omit,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        order: str | 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.
@@ -79,11 +80,12 @@ def events(
         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.
+        """Reads a page of telemetry events for the browser session.
+
+        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
@@ -96,6 +98,13 @@ def events(
               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.
 
+          order: Read direction. asc (default) reads oldest first, starting from since or the
+              offset cursor. desc reads newest first: each request returns one page of up to
+              limit records ending at the offset cursor (or until, or the newest archived
+              event); combining desc with since is rejected with a 400. In either direction
+              the category filter applies within the page, so a filtered page may be empty
+              while X-Has-More is true.
+
           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.
 
@@ -125,6 +134,7 @@ def events(
                         "category": category,
                         "limit": limit,
                         "offset": offset,
+                        "order": order,
                         "since": since,
                         "until": until,
                     },
@@ -234,6 +244,7 @@ def events(
         | Omit = omit,
         limit: int | Omit = omit,
         offset: int | Omit = omit,
+        order: str | 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.
@@ -243,11 +254,12 @@ def events(
         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.
+        """Reads a page of telemetry events for the browser session.
+
+        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
@@ -260,6 +272,13 @@ def events(
               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.
 
+          order: Read direction. asc (default) reads oldest first, starting from since or the
+              offset cursor. desc reads newest first: each request returns one page of up to
+              limit records ending at the offset cursor (or until, or the newest archived
+              event); combining desc with since is rejected with a 400. In either direction
+              the category filter applies within the page, so a filtered page may be empty
+              while X-Has-More is true.
+
           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.
 
@@ -289,6 +308,7 @@ def events(
                         "category": category,
                         "limit": limit,
                         "offset": offset,
+                        "order": order,
                         "since": since,
                         "until": until,
                     },

src/kernel/types/browsers/telemetry_events_params.py

@@ -39,6 +39,17 @@ class TelemetryEventsParams(TypedDict, total=False):
     field, so do not derive it from the response body.
     """
 
+    order: str
+    """Read direction.
+
+    asc (default) reads oldest first, starting from since or the offset cursor. desc
+    reads newest first: each request returns one page of up to limit records ending
+    at the offset cursor (or until, or the newest archived event); combining desc
+    with since is rejected with a 400. In either direction the category filter
+    applies within the page, so a filtered page may be empty while X-Has-More is
+    true.
+    """
+
     since: str
     """
     Start of the window: an RFC-3339 timestamp, or a duration like 5m meaning that

tests/api_resources/browsers/test_telemetry.py

@@ -34,6 +34,7 @@ def test_method_events_with_all_params(self, client: Kernel) -> None:
             category=["console"],
             limit=1,
             offset=0,
+            order="order",
             since="since",
             until="until",
         )
@@ -146,6 +147,7 @@ async def test_method_events_with_all_params(self, async_client: AsyncKernel) ->
             category=["console"],
             limit=1,
             offset=0,
+            order="order",
             since="since",
             until="until",
         )