feat(api): manual updates

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-d571232203ef4e00986a3245224267db6f8aaffdad57780f712e0694dc8d9e37.yml
-openapi_spec_hash: d5d635dd7b24a2e1255c6f2a895253ff
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-817d1d4e845b1946dac8ee10fd34b3f533aa36f74ac598582ffb1b0399a5a932.yml
+openapi_spec_hash: 9d856db62b34909fec94743235b3d7be
 config_hash: 88e87ba7021be93d267ecfc8f5e6b891

src/stagehand/resources/sessions.py

@@ -498,7 +498,7 @@ def start(
         experimental: bool | Omit = omit,
         self_heal: bool | Omit = omit,
         system_prompt: str | Omit = omit,
-        verbose: int | Omit = omit,
+        verbose: Literal[0, 1, 2] | Omit = omit,
         wait_for_captcha_solves: bool | Omit = omit,
         x_language: Literal["typescript", "python", "playground"] | Omit = omit,
         x_sdk_version: str | Omit = omit,
@@ -1044,7 +1044,7 @@ async def start(
         experimental: bool | Omit = omit,
         self_heal: bool | Omit = omit,
         system_prompt: str | Omit = omit,
-        verbose: int | Omit = omit,
+        verbose: Literal[0, 1, 2] | Omit = omit,
         wait_for_captcha_solves: bool | Omit = omit,
         x_language: Literal["typescript", "python", "playground"] | Omit = omit,
         x_sdk_version: str | Omit = omit,

src/stagehand/types/model_config_param.py

@@ -7,15 +7,18 @@
 
 from .._utils import PropertyInfo
 
-__all__ = ["ModelConfigParam", "UnionMember1"]
+__all__ = ["ModelConfigParam", "ModelConfigObject"]
 
 
-class UnionMember1(TypedDict, total=False):
+class ModelConfigObject(TypedDict, total=False):
     model_name: Required[Annotated[str, PropertyInfo(alias="modelName")]]
+    """Model name string without prefix (e.g., 'gpt-5-nano', 'claude-4.5-opus')"""
 
     api_key: Annotated[str, PropertyInfo(alias="apiKey")]
+    """API key for the model provider"""
 
     base_url: Annotated[str, PropertyInfo(alias="baseURL")]
+    """Base URL for the model provider"""
 
 
-ModelConfigParam: TypeAlias = Union[str, UnionMember1]
+ModelConfigParam: TypeAlias = Union[str, ModelConfigObject]

src/stagehand/types/session_act_params.py

@@ -56,6 +56,10 @@ class InputActionInput(TypedDict, total=False):
 
 class Options(TypedDict, total=False):
     model: ModelConfigParam
+    """
+    Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+    'anthropic/claude-4.5-opus')
+    """
 
     timeout: float
     """Timeout in ms for the action"""

src/stagehand/types/session_end_response.py

@@ -1,11 +1,10 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-from typing_extensions import Literal
-
 from .._models import BaseModel
 
 __all__ = ["SessionEndResponse"]
 
 
 class SessionEndResponse(BaseModel):
-    success: Literal[True]
+    success: bool
+    """Indicates whether the request was successful"""

src/stagehand/types/session_execute_params.py

@@ -38,6 +38,10 @@ class AgentConfig(TypedDict, total=False):
     """Enable Computer Use Agent mode"""
 
     model: ModelConfigParam
+    """
+    Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+    'anthropic/claude-4.5-opus')
+    """
 
     system_prompt: Annotated[str, PropertyInfo(alias="systemPrompt")]
     """Custom system prompt for the agent"""

src/stagehand/types/session_extract_params.py

@@ -39,6 +39,10 @@ class SessionExtractParams(TypedDict, total=False):
 
 class Options(TypedDict, total=False):
     model: ModelConfigParam
+    """
+    Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+    'anthropic/claude-4.5-opus')
+    """
 
     selector: str
     """CSS selector to scope extraction to a specific element"""

src/stagehand/types/session_observe_params.py

@@ -36,6 +36,10 @@ class SessionObserveParams(TypedDict, total=False):
 
 class Options(TypedDict, total=False):
     model: ModelConfigParam
+    """
+    Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+    'anthropic/claude-4.5-opus')
+    """
 
     selector: str
     """CSS selector to scope observation to a specific element"""

src/stagehand/types/session_start_params.py

@@ -57,7 +57,7 @@ class SessionStartParams(TypedDict, total=False):
     system_prompt: Annotated[str, PropertyInfo(alias="systemPrompt")]
     """Custom system prompt for AI operations"""
 
-    verbose: int
+    verbose: Literal[0, 1, 2]
     """Logging verbosity level (0=quiet, 1=normal, 2=debug)"""
 
     wait_for_captcha_solves: Annotated[bool, PropertyInfo(alias="waitForCaptchaSolves")]

tests/api_resources/test_sessions.py

@@ -43,7 +43,7 @@ def test_method_act_with_all_params(self, client: Stagehand) -> None:
             input="Click the login button",
             frame_id="frameId",
             options={
-                "model": "string",
+                "model": "openai/gpt-5-nano",
                 "timeout": 30000,
                 "variables": {"username": "john_doe"},
             },
@@ -164,7 +164,7 @@ def test_method_execute_with_all_params(self, client: Stagehand) -> None:
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
             agent_config={
                 "cua": True,
-                "model": "string",
+                "model": "openai/gpt-5-nano",
                 "system_prompt": "systemPrompt",
             },
             execute_options={
@@ -242,7 +242,7 @@ def test_method_extract_with_all_params(self, client: Stagehand) -> None:
             frame_id="frameId",
             instruction="Extract all product names and prices from the page",
             options={
-                "model": "string",
+                "model": "openai/gpt-5-nano",
                 "selector": "#main-content",
                 "timeout": 30000,
             },
@@ -369,7 +369,7 @@ def test_method_observe_with_all_params(self, client: Stagehand) -> None:
             frame_id="frameId",
             instruction="Find all clickable navigation links",
             options={
-                "model": "string",
+                "model": "openai/gpt-5-nano",
                 "selector": "nav",
                 "timeout": 30000,
             },
@@ -562,7 +562,7 @@ async def test_method_act_with_all_params(self, async_client: AsyncStagehand) ->
             input="Click the login button",
             frame_id="frameId",
             options={
-                "model": "string",
+                "model": "openai/gpt-5-nano",
                 "timeout": 30000,
                 "variables": {"username": "john_doe"},
             },
@@ -683,7 +683,7 @@ async def test_method_execute_with_all_params(self, async_client: AsyncStagehand
             id="c4dbf3a9-9a58-4b22-8a1c-9f20f9f9e123",
             agent_config={
                 "cua": True,
-                "model": "string",
+                "model": "openai/gpt-5-nano",
                 "system_prompt": "systemPrompt",
             },
             execute_options={
@@ -761,7 +761,7 @@ async def test_method_extract_with_all_params(self, async_client: AsyncStagehand
             frame_id="frameId",
             instruction="Extract all product names and prices from the page",
             options={
-                "model": "string",
+                "model": "openai/gpt-5-nano",
                 "selector": "#main-content",
                 "timeout": 30000,
             },
@@ -888,7 +888,7 @@ async def test_method_observe_with_all_params(self, async_client: AsyncStagehand
             frame_id="frameId",
             instruction="Find all clickable navigation links",
             options={
-                "model": "string",
+                "model": "openai/gpt-5-nano",
                 "selector": "nav",
                 "timeout": 30000,
             },