kernel 0.72.0__tar.gz → 0.74.0__tar.gz

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

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

{kernel-0.72.0 → kernel-0.74.0}/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.74.0 (2026-07-06)
+
+Full Changelog: [v0.73.0...v0.74.0](https://github.com/kernel/kernel-python-sdk/compare/v0.73.0...v0.74.0)
+
+### Features
+
+* Add order=desc pagination to telemetry event reads ([763baf5](https://github.com/kernel/kernel-python-sdk/commit/763baf59f95e879d8d9f31566a99fb863354009c))
+* Add tablet and mobile viewport presets to pool dashboard ([37971a0](https://github.com/kernel/kernel-python-sdk/commit/37971a00d405787eebee58a3237c7d4963a0a764))
+
+## 0.73.0 (2026-07-01)
+
+Full Changelog: [v0.72.0...v0.73.0](https://github.com/kernel/kernel-python-sdk/compare/v0.72.0...v0.73.0)
+
+### Features
+
+* Add hidden audit-logs export endpoint ([619c672](https://github.com/kernel/kernel-python-sdk/commit/619c6720f986b835393793896bb5ad4b64f8673f))
+
 ## 0.72.0 (2026-06-26)
 
 Full Changelog: [v0.71.0...v0.72.0](https://github.com/kernel/kernel-python-sdk/compare/v0.71.0...v0.72.0)

{kernel-0.72.0 → kernel-0.74.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: kernel
-Version: 0.72.0
+Version: 0.74.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.72.0 → kernel-0.74.0}/api.md

@@ -454,6 +454,7 @@ from kernel.types import AuditLogEntry
 Methods:
 
 - <code title="get /audit-logs">client.audit_logs.<a href="./src/kernel/resources/audit_logs.py">list</a>(\*\*<a href="src/kernel/types/audit_log_list_params.py">params</a>) -> <a href="./src/kernel/types/audit_log_entry.py">SyncPageTokenPagination[AuditLogEntry]</a></code>
+- <code title="get /audit-logs/export/chunk">client.audit_logs.<a href="./src/kernel/resources/audit_logs.py">export_chunk</a>(\*\*<a href="src/kernel/types/audit_log_export_chunk_params.py">params</a>) -> BinaryAPIResponse</code>
 
 # APIKeys
 

{kernel-0.72.0 → kernel-0.74.0}/pyproject.toml

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

{kernel-0.72.0 → kernel-0.74.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.72.0"  # x-release-please-version
+__version__ = "0.74.0"  # x-release-please-version

{kernel-0.72.0 → kernel-0.74.0}/src/kernel/resources/audit_logs.py

@@ -4,19 +4,28 @@ from __future__ import annotations
 
 from typing import Union
 from datetime import datetime
+from typing_extensions import Literal
 
 import httpx
 
-from ..types import audit_log_list_params
+from ..types import audit_log_list_params, audit_log_export_chunk_params
 from .._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
-from .._utils import maybe_transform
+from .._utils import maybe_transform, async_maybe_transform
 from .._compat import cached_property
 from .._resource import SyncAPIResource, AsyncAPIResource
 from .._response import (
+    BinaryAPIResponse,
+    AsyncBinaryAPIResponse,
+    StreamedBinaryAPIResponse,
+    AsyncStreamedBinaryAPIResponse,
     to_raw_response_wrapper,
     to_streamed_response_wrapper,
     async_to_raw_response_wrapper,
+    to_custom_raw_response_wrapper,
     async_to_streamed_response_wrapper,
+    to_custom_streamed_response_wrapper,
+    async_to_custom_raw_response_wrapper,
+    async_to_custom_streamed_response_wrapper,
 )
 from ..pagination import SyncPageTokenPagination, AsyncPageTokenPagination
 from .._base_client import AsyncPaginator, make_request_options
@@ -128,6 +137,91 @@ class AuditLogsResource(SyncAPIResource):
             model=AuditLogEntry,
         )
 
+    def export_chunk(
+        self,
+        *,
+        end: Union[str, datetime],
+        start: Union[str, datetime],
+        auth_strategy: str | Omit = omit,
+        cursor: str | Omit = omit,
+        exclude_method: str | Omit = omit,
+        format: Literal["jsonl", "jsonl.gz"] | Omit = omit,
+        limit: int | Omit = omit,
+        method: str | Omit = omit,
+        search: str | Omit = omit,
+        search_user_id: SequenceNotStr[str] | Omit = omit,
+        service: 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,
+    ) -> BinaryAPIResponse:
+        """
+        Download an organization's audit log records for a time range as a file, for
+        archival, compliance, or offline analysis. For interactive browsing, use GET
+        /audit-logs.
+
+        Args:
+          end: Upper bound (exclusive) for the audit record timestamp.
+
+          start: Lower bound (inclusive) for the audit record timestamp.
+
+          auth_strategy: Filter by authentication strategy.
+
+          cursor: Opaque cursor from X-Next-Cursor for the next chunk of older records.
+
+          exclude_method: Filter out results by HTTP method.
+
+          format: Encoding for the returned chunk.
+
+          limit: Maximum number of records to return in this chunk.
+
+          method: Filter by HTTP method.
+
+          search: Free-text search over path, user ID, email, client IP, and status.
+
+          search_user_id: Additional user IDs to OR into free-text search.
+
+          service: Filter by service name.
+
+          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
+        """
+        extra_headers = {"Accept": "application/octet-stream", **(extra_headers or {})}
+        return self._get(
+            "/audit-logs/export/chunk",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "end": end,
+                        "start": start,
+                        "auth_strategy": auth_strategy,
+                        "cursor": cursor,
+                        "exclude_method": exclude_method,
+                        "format": format,
+                        "limit": limit,
+                        "method": method,
+                        "search": search,
+                        "search_user_id": search_user_id,
+                        "service": service,
+                    },
+                    audit_log_export_chunk_params.AuditLogExportChunkParams,
+                ),
+            ),
+            cast_to=BinaryAPIResponse,
+        )
+
 
 class AsyncAuditLogsResource(AsyncAPIResource):
     """Read audit log records for the authenticated organization."""
@@ -232,6 +326,91 @@ class AsyncAuditLogsResource(AsyncAPIResource):
             model=AuditLogEntry,
         )
 
+    async def export_chunk(
+        self,
+        *,
+        end: Union[str, datetime],
+        start: Union[str, datetime],
+        auth_strategy: str | Omit = omit,
+        cursor: str | Omit = omit,
+        exclude_method: str | Omit = omit,
+        format: Literal["jsonl", "jsonl.gz"] | Omit = omit,
+        limit: int | Omit = omit,
+        method: str | Omit = omit,
+        search: str | Omit = omit,
+        search_user_id: SequenceNotStr[str] | Omit = omit,
+        service: 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,
+    ) -> AsyncBinaryAPIResponse:
+        """
+        Download an organization's audit log records for a time range as a file, for
+        archival, compliance, or offline analysis. For interactive browsing, use GET
+        /audit-logs.
+
+        Args:
+          end: Upper bound (exclusive) for the audit record timestamp.
+
+          start: Lower bound (inclusive) for the audit record timestamp.
+
+          auth_strategy: Filter by authentication strategy.
+
+          cursor: Opaque cursor from X-Next-Cursor for the next chunk of older records.
+
+          exclude_method: Filter out results by HTTP method.
+
+          format: Encoding for the returned chunk.
+
+          limit: Maximum number of records to return in this chunk.
+
+          method: Filter by HTTP method.
+
+          search: Free-text search over path, user ID, email, client IP, and status.
+
+          search_user_id: Additional user IDs to OR into free-text search.
+
+          service: Filter by service name.
+
+          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
+        """
+        extra_headers = {"Accept": "application/octet-stream", **(extra_headers or {})}
+        return await self._get(
+            "/audit-logs/export/chunk",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "end": end,
+                        "start": start,
+                        "auth_strategy": auth_strategy,
+                        "cursor": cursor,
+                        "exclude_method": exclude_method,
+                        "format": format,
+                        "limit": limit,
+                        "method": method,
+                        "search": search,
+                        "search_user_id": search_user_id,
+                        "service": service,
+                    },
+                    audit_log_export_chunk_params.AuditLogExportChunkParams,
+                ),
+            ),
+            cast_to=AsyncBinaryAPIResponse,
+        )
+
 
 class AuditLogsResourceWithRawResponse:
     def __init__(self, audit_logs: AuditLogsResource) -> None:
@@ -240,6 +419,10 @@ class AuditLogsResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             audit_logs.list,
         )
+        self.export_chunk = to_custom_raw_response_wrapper(
+            audit_logs.export_chunk,
+            BinaryAPIResponse,
+        )
 
 
 class AsyncAuditLogsResourceWithRawResponse:
@@ -249,6 +432,10 @@ class AsyncAuditLogsResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             audit_logs.list,
         )
+        self.export_chunk = async_to_custom_raw_response_wrapper(
+            audit_logs.export_chunk,
+            AsyncBinaryAPIResponse,
+        )
 
 
 class AuditLogsResourceWithStreamingResponse:
@@ -258,6 +445,10 @@ class AuditLogsResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             audit_logs.list,
         )
+        self.export_chunk = to_custom_streamed_response_wrapper(
+            audit_logs.export_chunk,
+            StreamedBinaryAPIResponse,
+        )
 
 
 class AsyncAuditLogsResourceWithStreamingResponse:
@@ -267,3 +458,7 @@ class AsyncAuditLogsResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             audit_logs.list,
         )
+        self.export_chunk = async_to_custom_streamed_response_wrapper(
+            audit_logs.export_chunk,
+            AsyncStreamedBinaryAPIResponse,
+        )

{kernel-0.72.0 → kernel-0.74.0}/src/kernel/resources/browser_pools.py

@@ -136,14 +136,14 @@ class BrowserPoolsResource(SyncAPIResource):
               image defaults apply (1920x1080@25). For GPU images, the default is
               1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
               Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
-              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
-              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
-              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
-              Viewports outside this list may exhibit unstable live view or recording
-              behavior. If refresh_rate is not provided, it will be automatically determined
-              based on the resolution (higher resolutions use lower refresh rates to keep
-              bandwidth reasonable).
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For
+              GPU images, recommended presets use one of these resolutions with refresh rates
+              60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800,
+              1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250,
+              768x1024, 800x1600. Viewports outside this list may exhibit unstable live view
+              or recording behavior. If refresh_rate is not provided, it will be automatically
+              determined based on the resolution (higher resolutions use lower refresh rates
+              to keep bandwidth reasonable).
 
           extra_headers: Send extra headers
 
@@ -295,14 +295,14 @@ class BrowserPoolsResource(SyncAPIResource):
               image defaults apply (1920x1080@25). For GPU images, the default is
               1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
               Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
-              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
-              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
-              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
-              Viewports outside this list may exhibit unstable live view or recording
-              behavior. If refresh_rate is not provided, it will be automatically determined
-              based on the resolution (higher resolutions use lower refresh rates to keep
-              bandwidth reasonable).
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For
+              GPU images, recommended presets use one of these resolutions with refresh rates
+              60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800,
+              1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250,
+              768x1024, 800x1600. Viewports outside this list may exhibit unstable live view
+              or recording behavior. If refresh_rate is not provided, it will be automatically
+              determined based on the resolution (higher resolutions use lower refresh rates
+              to keep bandwidth reasonable).
 
           extra_headers: Send extra headers
 
@@ -684,14 +684,14 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               image defaults apply (1920x1080@25). For GPU images, the default is
               1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
               Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
-              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
-              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
-              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
-              Viewports outside this list may exhibit unstable live view or recording
-              behavior. If refresh_rate is not provided, it will be automatically determined
-              based on the resolution (higher resolutions use lower refresh rates to keep
-              bandwidth reasonable).
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For
+              GPU images, recommended presets use one of these resolutions with refresh rates
+              60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800,
+              1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250,
+              768x1024, 800x1600. Viewports outside this list may exhibit unstable live view
+              or recording behavior. If refresh_rate is not provided, it will be automatically
+              determined based on the resolution (higher resolutions use lower refresh rates
+              to keep bandwidth reasonable).
 
           extra_headers: Send extra headers
 
@@ -843,14 +843,14 @@ class AsyncBrowserPoolsResource(AsyncAPIResource):
               image defaults apply (1920x1080@25). For GPU images, the default is
               1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
               Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
-              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
-              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
-              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
-              Viewports outside this list may exhibit unstable live view or recording
-              behavior. If refresh_rate is not provided, it will be automatically determined
-              based on the resolution (higher resolutions use lower refresh rates to keep
-              bandwidth reasonable).
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For
+              GPU images, recommended presets use one of these resolutions with refresh rates
+              60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800,
+              1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250,
+              768x1024, 800x1600. Viewports outside this list may exhibit unstable live view
+              or recording behavior. If refresh_rate is not provided, it will be automatically
+              determined based on the resolution (higher resolutions use lower refresh rates
+              to keep bandwidth reasonable).
 
           extra_headers: Send extra headers
 

{kernel-0.72.0 → kernel-0.74.0}/src/kernel/resources/browsers/browsers.py

@@ -246,14 +246,14 @@ class BrowsersResource(SyncAPIResource):
               image defaults apply (1920x1080@25). For GPU images, the default is
               1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
               Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
-              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
-              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
-              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
-              Viewports outside this list may exhibit unstable live view or recording
-              behavior. If refresh_rate is not provided, it will be automatically determined
-              based on the resolution (higher resolutions use lower refresh rates to keep
-              bandwidth reasonable).
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For
+              GPU images, recommended presets use one of these resolutions with refresh rates
+              60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800,
+              1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250,
+              768x1024, 800x1600. Viewports outside this list may exhibit unstable live view
+              or recording behavior. If refresh_rate is not provided, it will be automatically
+              determined based on the resolution (higher resolutions use lower refresh rates
+              to keep bandwidth reasonable).
 
           extra_headers: Send extra headers
 
@@ -824,14 +824,14 @@ class AsyncBrowsersResource(AsyncAPIResource):
               image defaults apply (1920x1080@25). For GPU images, the default is
               1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
               Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
-              presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
-              800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
-              1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
-              Viewports outside this list may exhibit unstable live view or recording
-              behavior. If refresh_rate is not provided, it will be automatically determined
-              based on the resolution (higher resolutions use lower refresh rates to keep
-              bandwidth reasonable).
+              1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For
+              GPU images, recommended presets use one of these resolutions with refresh rates
+              60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800,
+              1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250,
+              768x1024, 800x1600. Viewports outside this list may exhibit unstable live view
+              or recording behavior. If refresh_rate is not provided, it will be automatically
+              determined based on the resolution (higher resolutions use lower refresh rates
+              to keep bandwidth reasonable).
 
           extra_headers: Send extra headers
 

{kernel-0.72.0 → kernel-0.74.0}/src/kernel/resources/browsers/telemetry.py

@@ -70,6 +70,7 @@ class TelemetryResource(SyncAPIResource):
         | 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 @@ class TelemetryResource(SyncAPIResource):
         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 @@ class TelemetryResource(SyncAPIResource):
               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 @@ class TelemetryResource(SyncAPIResource):
                         "category": category,
                         "limit": limit,
                         "offset": offset,
+                        "order": order,
                         "since": since,
                         "until": until,
                     },
@@ -234,6 +244,7 @@ class AsyncTelemetryResource(AsyncAPIResource):
         | 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 @@ class AsyncTelemetryResource(AsyncAPIResource):
         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 @@ class AsyncTelemetryResource(AsyncAPIResource):
               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 @@ class AsyncTelemetryResource(AsyncAPIResource):
                         "category": category,
                         "limit": limit,
                         "offset": offset,
+                        "order": order,
                         "since": since,
                         "until": until,
                     },

{kernel-0.72.0 → kernel-0.74.0}/src/kernel/types/__init__.py

@@ -90,6 +90,7 @@ from .browser_pool_acquire_params import BrowserPoolAcquireParams as BrowserPool
 from .browser_pool_release_params import BrowserPoolReleaseParams as BrowserPoolReleaseParams
 from .deployment_retrieve_response import DeploymentRetrieveResponse as DeploymentRetrieveResponse
 from .invocation_retrieve_response import InvocationRetrieveResponse as InvocationRetrieveResponse
+from .audit_log_export_chunk_params import AuditLogExportChunkParams as AuditLogExportChunkParams
 from .browser_pool_acquire_response import BrowserPoolAcquireResponse as BrowserPoolAcquireResponse
 from .credential_totp_code_response import CredentialTotpCodeResponse as CredentialTotpCodeResponse
 from .browser_load_extensions_params import BrowserLoadExtensionsParams as BrowserLoadExtensionsParams

kernel-0.74.0/src/kernel/types/audit_log_export_chunk_params.py

@@ -0,0 +1,47 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from datetime import datetime
+from typing_extensions import Literal, Required, Annotated, TypedDict
+
+from .._types import SequenceNotStr
+from .._utils import PropertyInfo
+
+__all__ = ["AuditLogExportChunkParams"]
+
+
+class AuditLogExportChunkParams(TypedDict, total=False):
+    end: Required[Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]]
+    """Upper bound (exclusive) for the audit record timestamp."""
+
+    start: Required[Annotated[Union[str, datetime], PropertyInfo(format="iso8601")]]
+    """Lower bound (inclusive) for the audit record timestamp."""
+
+    auth_strategy: str
+    """Filter by authentication strategy."""
+
+    cursor: str
+    """Opaque cursor from X-Next-Cursor for the next chunk of older records."""
+
+    exclude_method: str
+    """Filter out results by HTTP method."""
+
+    format: Literal["jsonl", "jsonl.gz"]
+    """Encoding for the returned chunk."""
+
+    limit: int
+    """Maximum number of records to return in this chunk."""
+
+    method: str
+    """Filter by HTTP method."""
+
+    search: str
+    """Free-text search over path, user ID, email, client IP, and status."""
+
+    search_user_id: SequenceNotStr[str]
+    """Additional user IDs to OR into free-text search."""
+
+    service: str
+    """Filter by service name."""

{kernel-0.72.0 → kernel-0.74.0}/src/kernel/types/browser_create_params.py

@@ -114,14 +114,14 @@ class BrowserCreateParams(TypedDict, total=False):
     image defaults apply (1920x1080@25). For GPU images, the default is
     1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
     Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
-    presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
-    800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
-    1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
-    Viewports outside this list may exhibit unstable live view or recording
-    behavior. If refresh_rate is not provided, it will be automatically determined
-    based on the resolution (higher resolutions use lower refresh rates to keep
-    bandwidth reasonable).
+    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For
+    GPU images, recommended presets use one of these resolutions with refresh rates
+    60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800,
+    1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250,
+    768x1024, 800x1600. Viewports outside this list may exhibit unstable live view
+    or recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """
 
 

{kernel-0.72.0 → kernel-0.74.0}/src/kernel/types/browser_create_response.py

@@ -103,12 +103,12 @@ class BrowserCreateResponse(BaseModel):
     image defaults apply (1920x1080@25). For GPU images, the default is
     1920x1080@60. Arbitrary viewport dimensions and refresh rates are accepted.
     Known-good presets include: 2560x1440@10, 1920x1080@25, 1920x1200@25,
-    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60. For GPU images, recommended
-    presets use one of these resolutions with refresh rates 60, 30, 25, or 10:
-    800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800, 1280x720, 1368x768,
-    1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250, 768x1024, 800x1600.
-    Viewports outside this list may exhibit unstable live view or recording
-    behavior. If refresh_rate is not provided, it will be automatically determined
-    based on the resolution (higher resolutions use lower refresh rates to keep
-    bandwidth reasonable).
+    1440x900@25, 1280x800@60, 1024x768@60, 1200x800@60, 768x1024@60, 390x844@60. For
+    GPU images, recommended presets use one of these resolutions with refresh rates
+    60, 30, 25, or 10: 800x600, 960x720, 1024x576, 1024x768, 1152x648, 1200x800,
+    1280x720, 1368x768, 1440x900, 1600x900, 1920x1080, 1920x1200, 390x844, 360x250,
+    768x1024, 800x1600. Viewports outside this list may exhibit unstable live view
+    or recording behavior. If refresh_rate is not provided, it will be automatically
+    determined based on the resolution (higher resolutions use lower refresh rates
+    to keep bandwidth reasonable).
     """