release: 0.3.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.2.4"
+  ".": "0.3.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-39cd9547d16412cf0568f6ce2ad8d43805dffe65bde830beeff630b903ae3b38.yml
-openapi_spec_hash: 9cd7c9fefa686f9711392782d948470f
-config_hash: 3c21550e2c94cad4339d3093d794beb0
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-119383e808f394a7676e901bac8b97b6d7402d187d03452fd8d62b31d4085580.yml
+openapi_spec_hash: 8a8d7be19d95f849098690863fe9a71a
+config_hash: 1f709f8775e13029dc60064ef3a94355

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 0.3.0 (2026-01-12)
+
+Full Changelog: [v0.2.4...v0.3.0](https://github.com/browserbase/stagehand-python/compare/v0.2.4...v0.3.0)
+
+### Features
+
+* Removed requiring x-language and x-sdk-version from openapi spec ([618266f](https://github.com/browserbase/stagehand-python/commit/618266f3fe397a2d346fc1f3adaad225db443cdf))
+* Using provider/model syntax in modelName examples within openapi spec ([98d8ab9](https://github.com/browserbase/stagehand-python/commit/98d8ab97cb1115b9cff7f6e831b7dfa98e27f15a))
+
 ## 0.2.4 (2026-01-07)
 
 Full Changelog: [v0.2.3...v0.2.4](https://github.com/browserbase/stagehand-python/compare/v0.2.3...v0.2.4)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stagehand-alpha"
-version = "0.2.4"
+version = "0.3.0"
 description = "The official Python library for the stagehand API"
 dynamic = ["readme"]
 license = "Apache-2.0"

src/stagehand/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "stagehand"
-__version__ = "0.2.4"  # x-release-please-version
+__version__ = "0.3.0"  # x-release-please-version

src/stagehand/types/model_config_param.py

@@ -12,7 +12,7 @@
 
 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')"""
+    """Model name string (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus')"""
 
     api_key: Annotated[str, PropertyInfo(alias="apiKey")]
     """API key for the model provider"""

src/stagehand/types/session_act_params.py

@@ -22,12 +22,6 @@ class SessionActParamsBase(TypedDict, total=False):
 
     options: Options
 
-    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"""
 

src/stagehand/types/session_end_params.py

@@ -14,12 +14,6 @@
 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"""
 

src/stagehand/types/session_execute_params.py

@@ -26,12 +26,6 @@ class SessionExecuteParamsBase(TypedDict, total=False):
     frame_id: Annotated[str, PropertyInfo(alias="frameId")]
     """Target frame ID for the agent"""
 
-    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"""
 

src/stagehand/types/session_extract_params.py

@@ -24,12 +24,6 @@ class SessionExtractParamsBase(TypedDict, total=False):
     schema: Dict[str, object]
     """JSON Schema defining the structure of data to extract"""
 
-    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"""
 

src/stagehand/types/session_navigate_params.py

@@ -23,12 +23,6 @@ class SessionNavigateParams(TypedDict, total=False):
     stream_response: Annotated[bool, PropertyInfo(alias="streamResponse")]
     """Whether to stream the response via SSE"""
 
-    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"""
 

src/stagehand/types/session_observe_params.py

@@ -21,12 +21,6 @@ class SessionObserveParamsBase(TypedDict, total=False):
 
     options: Options
 
-    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"""
 

src/stagehand/types/session_start_params.py

@@ -61,12 +61,6 @@ class SessionStartParams(TypedDict, total=False):
     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"""
-
-    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"""