feat: Add executionModel serialization to api client

Author: stainless-app[bot]

.github/workflows/release-doctor.yml

@@ -2,7 +2,7 @@ name: Release Doctor
 on:
   pull_request:
     branches:
-      - main
+      - stainless
   workflow_dispatch:
 
 jobs:

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-43e6dd4ce19381de488d296e9036fea15bfea9a6f946cf8ccf4e02aecc8fb765.yml
-openapi_spec_hash: f736e7a8acea0d73e1031c86ea803246
-config_hash: b375728ccf7d33287335852f4f59c293
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-8fbb3fa8f3a37c1c7408de427fe125aadec49f705e8e30d191601a9b69c4cc41.yml
+openapi_spec_hash: 48b4dfac35a842d7fb0d228caf87544e
+config_hash: 242651c4871c2869ba3c2e3d337505b9

README.md

@@ -28,7 +28,7 @@
   </a>
 </p>
 <!-- prettier-ignore -->
-[![PyPI version](https://img.shields.io/pypi/v/stagehand.svg?label=pypi%20(stable))](https://pypi.org/project/stagehand/)
+[![PyPI version](https://img.shields.io/pypi/v/stagehand-alpha.svg?label=pypi%20(stable))](https://pypi.org/project/stagehand-alpha/)
 
 <p align="center">
 	<a href="https://trendshift.io/repositories/12122" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12122" alt="browserbase%2Fstagehand | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
@@ -606,9 +606,9 @@ session = response.parse()  # get the object that `sessions.start()` would have
 print(session.data)
 ```
 
-These methods return an [`APIResponse`](https://github.com/browserbase/stagehand-python/tree/main/src/stagehand/_response.py) object.
+These methods return an [`APIResponse`](https://github.com/browserbase/stagehand-python/tree/stainless/src/stagehand/_response.py) object.
 
-The async client returns an [`AsyncAPIResponse`](https://github.com/browserbase/stagehand-python/tree/main/src/stagehand/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
+The async client returns an [`AsyncAPIResponse`](https://github.com/browserbase/stagehand-python/tree/stainless/src/stagehand/_response.py) with the same structure, the only difference being `await`able methods for reading the response content.
 
 #### `.with_streaming_response`
 

pyproject.toml

@@ -1,5 +1,5 @@
 [project]
-name = "stagehand"
+name = "stagehand-alpha"
 version = "3.5.0"
 description = "The official Python library for the stagehand API"
 dynamic = ["readme"]
@@ -122,7 +122,7 @@ path = "README.md"
 [[tool.hatch.metadata.hooks.fancy-pypi-readme.substitutions]]
 # replace relative links with absolute links
 pattern = '\[(.+?)\]\(((?!https?://)\S+?)\)'
-replacement = '[\1](https://github.com/browserbase/stagehand-python/tree/main/\g<2>)'
+replacement = '[\1](https://github.com/browserbase/stagehand-python/tree/stainless/\g<2>)'
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

requirements-dev.lock

@@ -6,7 +6,7 @@ annotated-types==0.7.0
 anyio==4.12.0
     # via
     #   httpx
-    #   stagehand
+    #   stagehand-alpha
 backports-asyncio-runner==1.2.0 ; python_full_version < '3.11'
     # via pytest-asyncio
 certifi==2025.11.12
@@ -17,7 +17,7 @@ colorama==0.4.6 ; sys_platform == 'win32'
     # via pytest
 dirty-equals==0.11
 distro==1.9.0
-    # via stagehand
+    # via stagehand-alpha
 dotenv==0.9.9
 exceptiongroup==1.3.1 ; python_full_version < '3.11'
     # via
@@ -32,7 +32,7 @@ httpcore==1.0.9
 httpx==0.28.1
     # via
     #   respx
-    #   stagehand
+    #   stagehand-alpha
 idna==3.11
     # via
     #   anyio
@@ -60,7 +60,7 @@ pathspec==0.12.1
 pluggy==1.6.0
     # via pytest
 pydantic==2.12.5
-    # via stagehand
+    # via stagehand-alpha
 pydantic-core==2.41.5
     # via pydantic
 pygments==2.19.2
@@ -89,7 +89,7 @@ ruff==0.14.7
 six==1.17.0 ; python_full_version < '3.10'
     # via python-dateutil
 sniffio==1.3.1
-    # via stagehand
+    # via stagehand-alpha
 time-machine==2.19.0 ; python_full_version < '3.10'
 time-machine==3.1.0 ; python_full_version >= '3.10'
 tomli==2.3.0 ; python_full_version < '3.11'
@@ -105,7 +105,7 @@ typing-extensions==4.15.0
     #   pydantic-core
     #   pyright
     #   pytest-asyncio
-    #   stagehand
+    #   stagehand-alpha
     #   typing-inspection
 typing-inspection==0.4.2
     # via pydantic

src/stagehand/_streaming.py

@@ -56,7 +56,7 @@ def __stream__(self) -> Iterator[_T]:
 
         try:
             for sse in iterator:
-                if sse.data.startswith('{"data":{"status":"finished"'):
+                if sse.data.startswith("finished"):
                     break
 
                 if sse.data.startswith("error"):
@@ -139,7 +139,7 @@ async def __stream__(self) -> AsyncIterator[_T]:
 
         try:
             async for sse in iterator:
-                if sse.data.startswith('{"data":{"status":"finished"'):
+                if sse.data.startswith("finished"):
                     break
 
                 if sse.data.startswith("error"):

tests/api_resources/test_sessions.py

@@ -225,6 +225,12 @@ def test_method_execute_with_all_params_overload_1(self, client: Stagehand) -> N
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
             agent_config={
                 "cua": True,
+                "execution_model": {
+                    "model_name": "openai/gpt-5-nano",
+                    "api_key": "sk-some-openai-api-key",
+                    "base_url": "https://api.openai.com/v1",
+                    "provider": "openai",
+                },
                 "mode": "cua",
                 "model": {"model_name": "openai/gpt-5-nano"},
                 "provider": "openai",
@@ -308,6 +314,12 @@ def test_method_execute_with_all_params_overload_2(self, client: Stagehand) -> N
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
             agent_config={
                 "cua": True,
+                "execution_model": {
+                    "model_name": "openai/gpt-5-nano",
+                    "api_key": "sk-some-openai-api-key",
+                    "base_url": "https://api.openai.com/v1",
+                    "provider": "openai",
+                },
                 "mode": "cua",
                 "model": {"model_name": "openai/gpt-5-nano"},
                 "provider": "openai",
@@ -1058,6 +1070,12 @@ async def test_method_execute_with_all_params_overload_1(self, async_client: Asy
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
             agent_config={
                 "cua": True,
+                "execution_model": {
+                    "model_name": "openai/gpt-5-nano",
+                    "api_key": "sk-some-openai-api-key",
+                    "base_url": "https://api.openai.com/v1",
+                    "provider": "openai",
+                },
                 "mode": "cua",
                 "model": {"model_name": "openai/gpt-5-nano"},
                 "provider": "openai",
@@ -1141,6 +1159,12 @@ async def test_method_execute_with_all_params_overload_2(self, async_client: Asy
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
             agent_config={
                 "cua": True,
+                "execution_model": {
+                    "model_name": "openai/gpt-5-nano",
+                    "api_key": "sk-some-openai-api-key",
+                    "base_url": "https://api.openai.com/v1",
+                    "provider": "openai",
+                },
                 "mode": "cua",
                 "model": {"model_name": "openai/gpt-5-nano"},
                 "provider": "openai",