feat(api): manual updates

stainless-app[bot] · stainless-app[bot] · commit dde1e8b312f7 · 2025-12-19T23:35:59.000Z
diff --git a/.stats.yml b/.stats.yml
@@ -1,4 +1,4 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-f7d6b6489159f611a2bfdc267ce0a6fc0455bed1ffa0c310044baaa5d8381b9b.yml
-openapi_spec_hash: cd88d8068abfde8382da0bed674e440c
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-4fb17cafc413ae3d575e3268602b01d2d0e9ebeb734a41b6086b3353ff0d2523.yml
+openapi_spec_hash: 8d48d8564849246f6f14d900c6c5f60c
 config_hash: 5c69fb596588b8ace08203858518c149
diff --git a/src/stagehand/resources/sessions.py b/src/stagehand/resources/sessions.py
@@ -1028,12 +1028,11 @@ def start(
         browser: session_start_params.Browser | Omit = omit,
         browserbase_session_create_params: session_start_params.BrowserbaseSessionCreateParams | Omit = omit,
         browserbase_session_id: str | Omit = omit,
-        debug_dom: bool | Omit = omit,
         dom_settle_timeout_ms: float | Omit = omit,
         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,
@@ -1054,7 +1053,7 @@ def start(
         Args:
           model_name: Model name to use for AI operations
 
-          act_timeout_ms: Timeout in ms for act operations
+          act_timeout_ms: Timeout in ms for act operations (deprecated, v2 only)
 
           browserbase_session_id: Existing Browserbase session ID to resume
 
@@ -1066,6 +1065,8 @@ def start(
 
           verbose: Logging verbosity level (0=quiet, 1=normal, 2=debug)
 
+          wait_for_captcha_solves: Wait for captcha solves (deprecated, v2 only)
+
           x_language: Client SDK language
 
           x_sdk_version: Version of the Stagehand SDK
@@ -1102,7 +1103,6 @@ def start(
                     "browser": browser,
                     "browserbase_session_create_params": browserbase_session_create_params,
                     "browserbase_session_id": browserbase_session_id,
-                    "debug_dom": debug_dom,
                     "dom_settle_timeout_ms": dom_settle_timeout_ms,
                     "experimental": experimental,
                     "self_heal": self_heal,
@@ -2107,12 +2107,11 @@ async def start(
         browser: session_start_params.Browser | Omit = omit,
         browserbase_session_create_params: session_start_params.BrowserbaseSessionCreateParams | Omit = omit,
         browserbase_session_id: str | Omit = omit,
-        debug_dom: bool | Omit = omit,
         dom_settle_timeout_ms: float | Omit = omit,
         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,
@@ -2133,7 +2132,7 @@ async def start(
         Args:
           model_name: Model name to use for AI operations
 
-          act_timeout_ms: Timeout in ms for act operations
+          act_timeout_ms: Timeout in ms for act operations (deprecated, v2 only)
 
           browserbase_session_id: Existing Browserbase session ID to resume
 
@@ -2145,6 +2144,8 @@ async def start(
 
           verbose: Logging verbosity level (0=quiet, 1=normal, 2=debug)
 
+          wait_for_captcha_solves: Wait for captcha solves (deprecated, v2 only)
+
           x_language: Client SDK language
 
           x_sdk_version: Version of the Stagehand SDK
@@ -2181,7 +2182,6 @@ async def start(
                     "browser": browser,
                     "browserbase_session_create_params": browserbase_session_create_params,
                     "browserbase_session_id": browserbase_session_id,
-                    "debug_dom": debug_dom,
                     "dom_settle_timeout_ms": dom_settle_timeout_ms,
                     "experimental": experimental,
                     "self_heal": self_heal,
diff --git a/src/stagehand/types/__init__.py b/src/stagehand/types/__init__.py
@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-from .action import Action as Action
 from .action_param import ActionParam as ActionParam
 from .stream_event import StreamEvent as StreamEvent
 from .model_config_param import ModelConfigParam as ModelConfigParam
diff --git a/src/stagehand/types/action.py b/src/stagehand/types/action.py
diff --git a/src/stagehand/types/action_param.py b/src/stagehand/types/action_param.py
@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing_extensions import Required, TypedDict
+from typing_extensions import Required, Annotated, TypedDict
 
 from .._types import SequenceNotStr
+from .._utils import PropertyInfo
 
 __all__ = ["ActionParam"]
 
@@ -21,5 +22,8 @@ class ActionParam(TypedDict, total=False):
     arguments: SequenceNotStr[str]
     """Arguments to pass to the method"""
 
+    backend_node_id: Annotated[float, PropertyInfo(alias="backendNodeId")]
+    """Backend node ID for the element"""
+
     method: str
     """The method to execute (click, fill, etc.)"""
diff --git a/src/stagehand/types/model_config_param.py b/src/stagehand/types/model_config_param.py
@@ -3,7 +3,7 @@
 from __future__ import annotations
 
 from typing import Union
-from typing_extensions import Required, Annotated, TypeAlias, TypedDict
+from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
 from .._utils import PropertyInfo
 
@@ -20,5 +20,8 @@ class ModelConfigObject(TypedDict, total=False):
     base_url: Annotated[str, PropertyInfo(alias="baseURL")]
     """Base URL for the model provider"""
 
+    provider: Literal["openai", "anthropic", "google", "microsoft"]
+    """AI provider for the model (or provide a baseURL endpoint instead)"""
+
 
 ModelConfigParam: TypeAlias = Union[str, ModelConfigObject]
diff --git a/src/stagehand/types/session_act_response.py b/src/stagehand/types/session_act_response.py
@@ -4,17 +4,35 @@
 
 from pydantic import Field as FieldInfo
 
-from .action import Action
 from .._models import BaseModel
 
-__all__ = ["SessionActResponse", "Data", "DataResult"]
+__all__ = ["SessionActResponse", "Data", "DataResult", "DataResultAction"]
+
+
+class DataResultAction(BaseModel):
+    """Action object returned by observe and used by act"""
+
+    description: str
+    """Human-readable description of the action"""
+
+    selector: str
+    """CSS selector or XPath for the element"""
+
+    arguments: Optional[List[str]] = None
+    """Arguments to pass to the method"""
+
+    backend_node_id: Optional[float] = FieldInfo(alias="backendNodeId", default=None)
+    """Backend node ID for the element"""
+
+    method: Optional[str] = None
+    """The method to execute (click, fill, etc.)"""
 
 
 class DataResult(BaseModel):
     action_description: str = FieldInfo(alias="actionDescription")
     """Description of the action that was performed"""
 
-    actions: List[Action]
+    actions: List[DataResultAction]
     """List of actions that were executed"""
 
     message: str
diff --git a/src/stagehand/types/session_execute_params.py b/src/stagehand/types/session_execute_params.py
@@ -49,6 +49,9 @@ class AgentConfig(TypedDict, total=False):
     'anthropic/claude-4.5-opus')
     """
 
+    provider: Literal["openai", "anthropic", "google", "microsoft"]
+    """AI provider for the agent (legacy, use model: openai/gpt-5-nano instead)"""
+
     system_prompt: Annotated[str, PropertyInfo(alias="systemPrompt")]
     """Custom system prompt for the agent"""
 
diff --git a/src/stagehand/types/session_observe_response.py b/src/stagehand/types/session_observe_response.py
@@ -4,14 +4,32 @@
 
 from pydantic import Field as FieldInfo
 
-from .action import Action
 from .._models import BaseModel
 
-__all__ = ["SessionObserveResponse", "Data"]
+__all__ = ["SessionObserveResponse", "Data", "DataResult"]
+
+
+class DataResult(BaseModel):
+    """Action object returned by observe and used by act"""
+
+    description: str
+    """Human-readable description of the action"""
+
+    selector: str
+    """CSS selector or XPath for the element"""
+
+    arguments: Optional[List[str]] = None
+    """Arguments to pass to the method"""
+
+    backend_node_id: Optional[float] = FieldInfo(alias="backendNodeId", default=None)
+    """Backend node ID for the element"""
+
+    method: Optional[str] = None
+    """The method to execute (click, fill, etc.)"""
 
 
 class Data(BaseModel):
-    result: List[Action]
+    result: List[DataResult]
 
     action_id: Optional[str] = FieldInfo(alias="actionId", default=None)
     """Action ID for tracking"""
diff --git a/src/stagehand/types/session_start_params.py b/src/stagehand/types/session_start_params.py
@@ -33,7 +33,7 @@ class SessionStartParams(TypedDict, total=False):
     """Model name to use for AI operations"""
 
     act_timeout_ms: Annotated[float, PropertyInfo(alias="actTimeoutMs")]
-    """Timeout in ms for act operations"""
+    """Timeout in ms for act operations (deprecated, v2 only)"""
 
     browser: Browser
 
@@ -44,8 +44,6 @@ class SessionStartParams(TypedDict, total=False):
     browserbase_session_id: Annotated[str, PropertyInfo(alias="browserbaseSessionID")]
     """Existing Browserbase session ID to resume"""
 
-    debug_dom: Annotated[bool, PropertyInfo(alias="debugDom")]
-
     dom_settle_timeout_ms: Annotated[float, PropertyInfo(alias="domSettleTimeoutMs")]
     """Timeout in ms to wait for DOM to settle"""
 
@@ -57,10 +55,11 @@ 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")]
+    """Wait for captcha solves (deprecated, v2 only)"""
 
     x_language: Annotated[Literal["typescript", "python", "playground"], PropertyInfo(alias="x-language")]
     """Client SDK language"""
diff --git a/src/stagehand/types/session_start_response.py b/src/stagehand/types/session_start_response.py
@@ -1,5 +1,7 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+from typing import Optional
+
 from pydantic import Field as FieldInfo
 
 from .._models import BaseModel
@@ -10,12 +12,15 @@
 class Data(BaseModel):
     available: bool
 
-    connect_url: str = FieldInfo(alias="connectUrl")
-    """CDP WebSocket URL for connecting to the Browserbase cloud browser"""
-
     session_id: str = FieldInfo(alias="sessionId")
     """Unique Browserbase session identifier"""
 
+    cdp_url: Optional[str] = FieldInfo(alias="cdpUrl", default=None)
+    """
+    CDP WebSocket URL for connecting to the Browserbase cloud browser (present when
+    available)
+    """
+
 
 class SessionStartResponse(BaseModel):
     data: Data
diff --git a/src/stagehand/types/stream_event.py b/src/stagehand/types/stream_event.py
@@ -32,7 +32,7 @@ class DataStreamEventLogDataOutput(BaseModel):
 class StreamEvent(BaseModel):
     """Server-Sent Event emitted during streaming responses.
 
-    Events are sent as `data: <JSON>\n\n`.
+    Events are sent as `data: <JSON>\n\n`. Key order: data (with status first), type, id.
     """
 
     id: str
diff --git a/tests/api_resources/test_sessions.py b/tests/api_resources/test_sessions.py
@@ -235,6 +235,7 @@ def test_method_execute_with_all_params_overload_1(self, client: Stagehand) -> N
             agent_config={
                 "cua": True,
                 "model": "openai/gpt-5-nano",
+                "provider": "openai",
                 "system_prompt": "systemPrompt",
             },
             execute_options={
@@ -318,6 +319,7 @@ def test_method_execute_with_all_params_overload_2(self, client: Stagehand) -> N
             agent_config={
                 "cua": True,
                 "model": "openai/gpt-5-nano",
+                "provider": "openai",
                 "system_prompt": "systemPrompt",
             },
             execute_options={
@@ -717,7 +719,7 @@ def test_method_start(self, client: Stagehand) -> None:
     def test_method_start_with_all_params(self, client: Stagehand) -> None:
         session = client.sessions.start(
             model_name="gpt-4o",
-            act_timeout_ms=30000,
+            act_timeout_ms=0,
             browser={
                 "cdp_url": "ws://localhost:9222",
                 "launch_options": {
@@ -789,12 +791,11 @@ def test_method_start_with_all_params(self, client: Stagehand) -> None:
                 "user_metadata": {"foo": "bar"},
             },
             browserbase_session_id="browserbaseSessionID",
-            debug_dom=True,
             dom_settle_timeout_ms=5000,
             experimental=True,
             self_heal=True,
             system_prompt="systemPrompt",
-            verbose=1,
+            verbose="1",
             wait_for_captcha_solves=True,
             x_language="typescript",
             x_sdk_version="3.0.6",
@@ -1044,6 +1045,7 @@ async def test_method_execute_with_all_params_overload_1(self, async_client: Asy
             agent_config={
                 "cua": True,
                 "model": "openai/gpt-5-nano",
+                "provider": "openai",
                 "system_prompt": "systemPrompt",
             },
             execute_options={
@@ -1127,6 +1129,7 @@ async def test_method_execute_with_all_params_overload_2(self, async_client: Asy
             agent_config={
                 "cua": True,
                 "model": "openai/gpt-5-nano",
+                "provider": "openai",
                 "system_prompt": "systemPrompt",
             },
             execute_options={
@@ -1526,7 +1529,7 @@ async def test_method_start(self, async_client: AsyncStagehand) -> None:
     async def test_method_start_with_all_params(self, async_client: AsyncStagehand) -> None:
         session = await async_client.sessions.start(
             model_name="gpt-4o",
-            act_timeout_ms=30000,
+            act_timeout_ms=0,
             browser={
                 "cdp_url": "ws://localhost:9222",
                 "launch_options": {
@@ -1598,12 +1601,11 @@ async def test_method_start_with_all_params(self, async_client: AsyncStagehand)
                 "user_metadata": {"foo": "bar"},
             },
             browserbase_session_id="browserbaseSessionID",
-            debug_dom=True,
             dom_settle_timeout_ms=5000,
             experimental=True,
             self_heal=True,
             system_prompt="systemPrompt",
-            verbose=1,
+            verbose="1",
             wait_for_captcha_solves=True,
             x_language="typescript",
             x_sdk_version="3.0.6",
