feat: Added optional param to force empty object

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-2c6c017cc9ca1fcfe7b3902edfa64fb0420bdb46b1740c7c862e81e2132d4f7c.yml
-openapi_spec_hash: 220daf7e8f5897909a6c10e3385386e3
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-39cd9547d16412cf0568f6ce2ad8d43805dffe65bde830beeff630b903ae3b38.yml
+openapi_spec_hash: 9cd7c9fefa686f9711392782d948470f
 config_hash: 1f709f8775e13029dc60064ef3a94355

api.md

@@ -20,7 +20,7 @@ from stagehand.types import (
 Methods:
 
 - <code title="post /v1/sessions/{id}/act">client.sessions.<a href="./src/stagehand/resources/sessions.py">act</a>(id, \*\*<a href="src/stagehand/types/session_act_params.py">params</a>) -> <a href="./src/stagehand/types/session_act_response.py">SessionActResponse</a></code>
-- <code title="post /v1/sessions/{id}/end">client.sessions.<a href="./src/stagehand/resources/sessions.py">end</a>(id) -> <a href="./src/stagehand/types/session_end_response.py">SessionEndResponse</a></code>
+- <code title="post /v1/sessions/{id}/end">client.sessions.<a href="./src/stagehand/resources/sessions.py">end</a>(id, \*\*<a href="src/stagehand/types/session_end_params.py">params</a>) -> <a href="./src/stagehand/types/session_end_response.py">SessionEndResponse</a></code>
 - <code title="post /v1/sessions/{id}/agentExecute">client.sessions.<a href="./src/stagehand/resources/sessions.py">execute</a>(id, \*\*<a href="src/stagehand/types/session_execute_params.py">params</a>) -> <a href="./src/stagehand/types/session_execute_response.py">SessionExecuteResponse</a></code>
 - <code title="post /v1/sessions/{id}/extract">client.sessions.<a href="./src/stagehand/resources/sessions.py">extract</a>(id, \*\*<a href="src/stagehand/types/session_extract_params.py">params</a>) -> <a href="./src/stagehand/types/session_extract_response.py">SessionExtractResponse</a></code>
 - <code title="post /v1/sessions/{id}/navigate">client.sessions.<a href="./src/stagehand/resources/sessions.py">navigate</a>(id, \*\*<a href="src/stagehand/types/session_navigate_params.py">params</a>) -> <a href="./src/stagehand/types/session_navigate_response.py">SessionNavigateResponse</a></code>

src/stagehand/resources/sessions.py

@@ -10,6 +10,7 @@
 
 from ..types import (
     session_act_params,
+    session_end_params,
     session_start_params,
     session_execute_params,
     session_extract_params,
@@ -271,6 +272,7 @@ def end(
         self,
         id: str,
         *,
+        _force_body: object | Omit = omit,
         x_language: Literal["typescript", "python", "playground"] | Omit = omit,
         x_sdk_version: str | Omit = omit,
         x_sent_at: Union[str, datetime] | Omit = omit,
@@ -319,6 +321,7 @@ def end(
         }
         return self._post(
             f"/v1/sessions/{id}/end",
+            body=maybe_transform({"_force_body": _force_body}, session_end_params.SessionEndParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -1350,6 +1353,7 @@ async def end(
         self,
         id: str,
         *,
+        _force_body: object | Omit = omit,
         x_language: Literal["typescript", "python", "playground"] | Omit = omit,
         x_sdk_version: str | Omit = omit,
         x_sent_at: Union[str, datetime] | Omit = omit,
@@ -1398,6 +1402,7 @@ async def end(
         }
         return await self._post(
             f"/v1/sessions/{id}/end",
+            body=await async_maybe_transform({"_force_body": _force_body}, session_end_params.SessionEndParams),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),

src/stagehand/types/__init__.py

@@ -6,6 +6,7 @@
 from .stream_event import StreamEvent as StreamEvent
 from .model_config_param import ModelConfigParam as ModelConfigParam
 from .session_act_params import SessionActParams as SessionActParams
+from .session_end_params import SessionEndParams as SessionEndParams
 from .session_act_response import SessionActResponse as SessionActResponse
 from .session_end_response import SessionEndResponse as SessionEndResponse
 from .session_start_params import SessionStartParams as SessionStartParams

src/stagehand/types/session_end_params.py

@@ -0,0 +1,27 @@
+# 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, Annotated, TypedDict
+
+from .._utils import PropertyInfo
+
+__all__ = ["SessionEndParams"]
+
+
+class SessionEndParams(TypedDict, total=False):
+    _force_body: Annotated[object, PropertyInfo(alias="_forceBody")]
+
+    x_language: Annotated[Literal["typescript", "python", "playground"], PropertyInfo(alias="x-language")]
+    """Client SDK language"""
+
+    x_sdk_version: Annotated[str, PropertyInfo(alias="x-sdk-version")]
+    """Version of the Stagehand SDK"""
+
+    x_sent_at: Annotated[Union[str, datetime], PropertyInfo(alias="x-sent-at", format="iso8601")]
+    """ISO timestamp when request was sent"""
+
+    x_stream_response: Annotated[Literal["true", "false"], PropertyInfo(alias="x-stream-response")]
+    """Whether to stream the response via SSE"""

tests/api_resources/test_sessions.py

@@ -174,6 +174,7 @@ def test_method_end(self, client: Stagehand) -> None:
     def test_method_end_with_all_params(self, client: Stagehand) -> None:
         session = client.sessions.end(
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
+            _force_body={},
             x_language="typescript",
             x_sdk_version="3.0.6",
             x_sent_at=parse_datetime("2025-01-15T10:30:00Z"),
@@ -984,6 +985,7 @@ async def test_method_end(self, async_client: AsyncStagehand) -> None:
     async def test_method_end_with_all_params(self, async_client: AsyncStagehand) -> None:
         session = await async_client.sessions.end(
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
+            _force_body={},
             x_language="typescript",
             x_sdk_version="3.0.6",
             x_sent_at=parse_datetime("2025-01-15T10:30:00Z"),