release: 0.3.0 (#265)

stainless-app[bot] · web-flow · commit 16583e0e3452 · 2026-01-12T14:21:59.000-07:00
* feat: Removed requiring x-language and x-sdk-version from openapi spec

* feat: Using provider/model syntax in modelName examples within openapi spec

* release: 0.3.0

---------

Co-authored-by: stainless-app[bot] &lt;142633134+stainless-app[bot]@users.noreply.github.com&gt;
diff --git a/.release-please-manifest.json b/.release-please-manifest.json
@@ -1,3 +1,3 @@
 {
-  ".": "0.2.4"
+  ".": "0.3.0"
 }
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-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
diff --git a/CHANGELOG.md b/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)
diff --git a/pyproject.toml b/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"
diff --git a/src/stagehand/_version.py b/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
diff --git a/src/stagehand/resources/sessions.py b/src/stagehand/resources/sessions.py
diff --git a/src/stagehand/types/model_config_param.py b/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"""
diff --git a/src/stagehand/types/session_act_params.py b/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"""
 
diff --git a/src/stagehand/types/session_end_params.py b/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"""
 
diff --git a/src/stagehand/types/session_execute_params.py b/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"""
 
diff --git a/src/stagehand/types/session_extract_params.py b/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"""
 
diff --git a/src/stagehand/types/session_navigate_params.py b/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"""
 
diff --git a/src/stagehand/types/session_observe_params.py b/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"""
 
diff --git a/src/stagehand/types/session_start_params.py b/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"""
 
diff --git a/tests/api_resources/test_sessions.py b/tests/api_resources/test_sessions.py
diff --git a/tests/test_client.py b/tests/test_client.py

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,3 @@`
`1`	`1`	`{`
`2`		`- ".": "0.2.4"`
	`2`	`+ ".": "0.3.0"`
`3`	`3`	`}`