feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 39
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs%2Fsteel-45efcdf3e5ccffb6e94a86be505b24b7b4ff05d8f1a2978c2a281729af68cb82.yml
-openapi_spec_hash: 9a7724672b05d44888d67b6ed0ffc7ca
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/nen-labs%2Fsteel-725a0defba4d776777ef33053c239c1e41128f48fffe1dd2b27076a353ec8486.yml
+openapi_spec_hash: e02416b4dc63a92be8b82ca5fbc02d73
 config_hash: dce4dea59023b0a00890fa654fbfffb4

api.md

@@ -71,7 +71,7 @@ Methods:
 - <code title="get /v1/sessions">client.sessions.<a href="./src/steel/resources/sessions/sessions.py">list</a>(\*\*<a href="src/steel/types/session_list_params.py">params</a>) -> SyncSessionsCursor[Session]</code>
 - <code title="post /v1/sessions/{sessionId}/computer">client.sessions.<a href="./src/steel/resources/sessions/sessions.py">computer</a>(session_id, \*\*<a href="src/steel/types/session_computer_params.py">params</a>) -> <a href="./src/steel/types/session_computer_response.py">SessionComputerResponse</a></code>
 - <code title="get /v1/sessions/{id}/context">client.sessions.<a href="./src/steel/resources/sessions/sessions.py">context</a>(id) -> <a href="./src/steel/types/session_context.py">SessionContext</a></code>
-- <code title="get /v1/sessions/{id}/events">client.sessions.<a href="./src/steel/resources/sessions/sessions.py">events</a>(id) -> <a href="./src/steel/types/session_events_response.py">SessionEventsResponse</a></code>
+- <code title="get /v1/sessions/{id}/events">client.sessions.<a href="./src/steel/resources/sessions/sessions.py">events</a>(id, \*\*<a href="src/steel/types/session_events_params.py">params</a>) -> <a href="./src/steel/types/session_events_response.py">SessionEventsResponse</a></code>
 - <code title="get /v1/sessions/{id}/live-details">client.sessions.<a href="./src/steel/resources/sessions/sessions.py">live_details</a>(id) -> <a href="./src/steel/types/session_live_details_response.py">SessionLiveDetailsResponse</a></code>
 - <code title="post /v1/sessions/{id}/release">client.sessions.<a href="./src/steel/resources/sessions/sessions.py">release</a>(id) -> <a href="./src/steel/types/session_release_response.py">SessionReleaseResponse</a></code>
 - <code title="post /v1/sessions/release">client.sessions.<a href="./src/steel/resources/sessions/sessions.py">release_all</a>() -> <a href="./src/steel/types/session_release_all_response.py">SessionReleaseAllResponse</a></code>

src/steel/resources/sessions/sessions.py

@@ -15,7 +15,7 @@
     FilesResourceWithStreamingResponse,
     AsyncFilesResourceWithStreamingResponse,
 )
-from ...types import session_list_params, session_create_params, session_computer_params
+from ...types import session_list_params, session_create_params, session_events_params, session_computer_params
 from ..._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
 from ..._utils import required_args, maybe_transform, async_maybe_transform
 from .captchas import (
@@ -716,6 +716,9 @@ def events(
         self,
         id: str,
         *,
+        compressed: bool | Omit = omit,
+        limit: int | Omit = omit,
+        pointer: 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,
@@ -727,6 +730,12 @@ def events(
         This endpoint allows you to get the recorded session events in the RRWeb format
 
         Args:
+          compressed: Compress the events
+
+          limit: Optional pagination limit
+
+          pointer: Pagination pointer
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -740,7 +749,18 @@ def events(
         return self._get(
             f"/v1/sessions/{id}/events",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "compressed": compressed,
+                        "limit": limit,
+                        "pointer": pointer,
+                    },
+                    session_events_params.SessionEventsParams,
+                ),
             ),
             cast_to=SessionEventsResponse,
         )
@@ -1499,6 +1519,9 @@ async def events(
         self,
         id: str,
         *,
+        compressed: bool | Omit = omit,
+        limit: int | Omit = omit,
+        pointer: 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,
@@ -1510,6 +1533,12 @@ async def events(
         This endpoint allows you to get the recorded session events in the RRWeb format
 
         Args:
+          compressed: Compress the events
+
+          limit: Optional pagination limit
+
+          pointer: Pagination pointer
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -1523,7 +1552,18 @@ async def events(
         return await self._get(
             f"/v1/sessions/{id}/events",
             options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "compressed": compressed,
+                        "limit": limit,
+                        "pointer": pointer,
+                    },
+                    session_events_params.SessionEventsParams,
+                ),
             ),
             cast_to=SessionEventsResponse,
         )

src/steel/types/__init__.py

@@ -19,6 +19,7 @@
 from .profile_list_response import ProfileListResponse as ProfileListResponse
 from .profile_update_params import ProfileUpdateParams as ProfileUpdateParams
 from .session_create_params import SessionCreateParams as SessionCreateParams
+from .session_events_params import SessionEventsParams as SessionEventsParams
 from .credential_list_params import CredentialListParams as CredentialListParams
 from .extension_list_response import ExtensionListResponse as ExtensionListResponse
 from .extension_update_params import ExtensionUpdateParams as ExtensionUpdateParams

src/steel/types/session_events_params.py

@@ -0,0 +1,18 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing_extensions import TypedDict
+
+__all__ = ["SessionEventsParams"]
+
+
+class SessionEventsParams(TypedDict, total=False):
+    compressed: bool
+    """Compress the events"""
+
+    limit: int
+    """Optional pagination limit"""
+
+    pointer: str
+    """Pagination pointer"""

tests/api_resources/test_sessions.py

@@ -747,14 +747,24 @@ def test_path_params_context(self, client: Steel) -> None:
     @parametrize
     def test_method_events(self, client: Steel) -> None:
         session = client.sessions.events(
-            "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        )
+        assert_matches_type(SessionEventsResponse, session, path=["response"])
+
+    @parametrize
+    def test_method_events_with_all_params(self, client: Steel) -> None:
+        session = client.sessions.events(
+            id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            compressed=True,
+            limit=-9007199254740991,
+            pointer="pointer",
         )
         assert_matches_type(SessionEventsResponse, session, path=["response"])
 
     @parametrize
     def test_raw_response_events(self, client: Steel) -> None:
         response = client.sessions.with_raw_response.events(
-            "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
         )
 
         assert response.is_closed is True
@@ -765,7 +775,7 @@ def test_raw_response_events(self, client: Steel) -> None:
     @parametrize
     def test_streaming_response_events(self, client: Steel) -> None:
         with client.sessions.with_streaming_response.events(
-            "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -779,7 +789,7 @@ def test_streaming_response_events(self, client: Steel) -> None:
     def test_path_params_events(self, client: Steel) -> None:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
             client.sessions.with_raw_response.events(
-                "",
+                id="",
             )
 
     @parametrize
@@ -1608,14 +1618,24 @@ async def test_path_params_context(self, async_client: AsyncSteel) -> None:
     @parametrize
     async def test_method_events(self, async_client: AsyncSteel) -> None:
         session = await async_client.sessions.events(
-            "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+        )
+        assert_matches_type(SessionEventsResponse, session, path=["response"])
+
+    @parametrize
+    async def test_method_events_with_all_params(self, async_client: AsyncSteel) -> None:
+        session = await async_client.sessions.events(
+            id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            compressed=True,
+            limit=-9007199254740991,
+            pointer="pointer",
         )
         assert_matches_type(SessionEventsResponse, session, path=["response"])
 
     @parametrize
     async def test_raw_response_events(self, async_client: AsyncSteel) -> None:
         response = await async_client.sessions.with_raw_response.events(
-            "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
         )
 
         assert response.is_closed is True
@@ -1626,7 +1646,7 @@ async def test_raw_response_events(self, async_client: AsyncSteel) -> None:
     @parametrize
     async def test_streaming_response_events(self, async_client: AsyncSteel) -> None:
         async with async_client.sessions.with_streaming_response.events(
-            "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
+            id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
         ) as response:
             assert not response.is_closed
             assert response.http_request.headers.get("X-Stainless-Lang") == "python"
@@ -1640,7 +1660,7 @@ async def test_streaming_response_events(self, async_client: AsyncSteel) -> None
     async def test_path_params_events(self, async_client: AsyncSteel) -> None:
         with pytest.raises(ValueError, match=r"Expected a non-empty value for `id` but received ''"):
             await async_client.sessions.with_raw_response.events(
-                "",
+                id="",
             )
 
     @parametrize