release: 3.22.0

.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "3.21.0"
+  ".": "3.22.0"
 }

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-c7910965e66e73ad8b65b6cc391d431094b2a6c6577c3e9d82feaa8138e74cff.yml
-openapi_spec_hash: 37748bb69c22a9ce721d9b5a5861f964
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-4d0d50b4f18fd74f58aca0b84d6968d1228499f2fa4e5714516f13ff6f820c9d.yml
+openapi_spec_hash: f7b1a869f3e412aea4d4bd42467791bb
 config_hash: 1fb12ae9b478488bc1e56bfbdc210b01

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 3.22.0 (2026-06-09)
+
+Full Changelog: [v3.21.0...v3.22.0](https://github.com/browserbase/stagehand-python/compare/v3.21.0...v3.22.0)
+
+### Features
+
+* [STG-2090] Add Azure Entra model auth support ([2727cc9](https://github.com/browserbase/stagehand-python/commit/2727cc967c63b7e5ecf16e9b503e7ee1b605559a))
+
 ## 3.21.0 (2026-05-29)
 
 Full Changelog: [v3.20.0...v3.21.0](https://github.com/browserbase/stagehand-python/compare/v3.20.0...v3.21.0)

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stagehand"
-version = "3.21.0"
+version = "3.22.0"
 description = "The official Python library for the stagehand API"
 dynamic = ["readme"]
 license = "MIT"

src/stagehand/_version.py

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

src/stagehand/types/session_act_params.py

@@ -19,6 +19,13 @@
     "OptionsModelVertexModelConfigObjectAuthCredentials",
     "OptionsModelVertexModelConfigObjectProviderOptions",
     "OptionsModelVertexModelConfigObjectProviderOptionsVertex",
+    "OptionsModelAzureEntraModelConfigObject",
+    "OptionsModelAzureEntraModelConfigObjectAuth",
+    "OptionsModelAzureEntraModelConfigObjectProviderOptions",
+    "OptionsModelAzureEntraModelConfigObjectProviderOptionsAzure",
+    "OptionsModelAzureAPIKeyModelConfigObject",
+    "OptionsModelAzureAPIKeyModelConfigObjectProviderOptions",
+    "OptionsModelAzureAPIKeyModelConfigObjectProviderOptionsAzure",
     "OptionsModelGenericModelConfigObject",
     "OptionsVariables",
     "OptionsVariablesUnionMember3",
@@ -136,6 +143,112 @@ class OptionsModelVertexModelConfigObject(TypedDict, total=False):
     """Custom headers sent with every request to the model provider"""
 
 
+class OptionsModelAzureEntraModelConfigObjectAuth(TypedDict, total=False):
+    """Azure provider authentication configuration"""
+
+    token: Required[str]
+    """Microsoft Entra ID bearer token for Azure OpenAI"""
+
+    type: Required[Literal["azureEntraId"]]
+    """Use a Microsoft Entra ID bearer token for authentication"""
+
+
+class OptionsModelAzureEntraModelConfigObjectProviderOptionsAzure(TypedDict, total=False):
+    """Azure OpenAI provider-specific settings"""
+
+    api_version: Annotated[str, PropertyInfo(alias="apiVersion")]
+    """Azure OpenAI API version"""
+
+    base_url: Annotated[str, PropertyInfo(alias="baseURL")]
+    """Base URL for the Azure OpenAI provider"""
+
+    headers: Dict[str, str]
+    """Custom headers sent with every request to the Azure OpenAI provider"""
+
+    resource_name: Annotated[str, PropertyInfo(alias="resourceName")]
+    """Azure OpenAI resource name"""
+
+    use_deployment_based_urls: Annotated[bool, PropertyInfo(alias="useDeploymentBasedUrls")]
+    """Whether to use deployment-based Azure OpenAI URLs"""
+
+
+class OptionsModelAzureEntraModelConfigObjectProviderOptions(TypedDict, total=False):
+    """Azure provider-specific model configuration"""
+
+    azure: Required[OptionsModelAzureEntraModelConfigObjectProviderOptionsAzure]
+    """Azure OpenAI provider-specific settings"""
+
+
+class OptionsModelAzureEntraModelConfigObject(TypedDict, total=False):
+    auth: Required[OptionsModelAzureEntraModelConfigObjectAuth]
+    """Azure provider authentication configuration"""
+
+    model_name: Required[Annotated[str, PropertyInfo(alias="modelName")]]
+    """Model name string with provider prefix (e.g., 'openai/gpt-5-nano')"""
+
+    provider: Required[Literal["azure"]]
+    """Azure OpenAI model provider"""
+
+    provider_options: Required[
+        Annotated[OptionsModelAzureEntraModelConfigObjectProviderOptions, PropertyInfo(alias="providerOptions")]
+    ]
+    """Azure provider-specific model configuration"""
+
+    base_url: Annotated[str, PropertyInfo(alias="baseURL")]
+    """Base URL for the model provider"""
+
+    headers: Dict[str, str]
+    """Custom headers sent with every request to the model provider"""
+
+
+class OptionsModelAzureAPIKeyModelConfigObjectProviderOptionsAzure(TypedDict, total=False):
+    """Azure OpenAI provider-specific settings"""
+
+    api_version: Annotated[str, PropertyInfo(alias="apiVersion")]
+    """Azure OpenAI API version"""
+
+    base_url: Annotated[str, PropertyInfo(alias="baseURL")]
+    """Base URL for the Azure OpenAI provider"""
+
+    headers: Dict[str, str]
+    """Custom headers sent with every request to the Azure OpenAI provider"""
+
+    resource_name: Annotated[str, PropertyInfo(alias="resourceName")]
+    """Azure OpenAI resource name"""
+
+    use_deployment_based_urls: Annotated[bool, PropertyInfo(alias="useDeploymentBasedUrls")]
+    """Whether to use deployment-based Azure OpenAI URLs"""
+
+
+class OptionsModelAzureAPIKeyModelConfigObjectProviderOptions(TypedDict, total=False):
+    """Azure provider-specific model configuration"""
+
+    azure: Required[OptionsModelAzureAPIKeyModelConfigObjectProviderOptionsAzure]
+    """Azure OpenAI provider-specific settings"""
+
+
+class OptionsModelAzureAPIKeyModelConfigObject(TypedDict, total=False):
+    model_name: Required[Annotated[str, PropertyInfo(alias="modelName")]]
+    """Model name string with provider prefix (e.g., 'openai/gpt-5-nano')"""
+
+    provider: Required[Literal["azure"]]
+    """Azure OpenAI model provider"""
+
+    provider_options: Required[
+        Annotated[OptionsModelAzureAPIKeyModelConfigObjectProviderOptions, PropertyInfo(alias="providerOptions")]
+    ]
+    """Azure provider-specific model configuration"""
+
+    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"""
+
+    headers: Dict[str, str]
+    """Custom headers sent with every request to the model provider"""
+
+
 class OptionsModelGenericModelConfigObject(TypedDict, total=False):
     model_name: Required[Annotated[str, PropertyInfo(alias="modelName")]]
     """Model name string with provider prefix (e.g., 'openai/gpt-5-nano')"""
@@ -153,7 +266,13 @@ class OptionsModelGenericModelConfigObject(TypedDict, total=False):
     """AI provider for the model (or provide a baseURL endpoint instead)"""
 
 
-OptionsModel: TypeAlias = Union[OptionsModelVertexModelConfigObject, OptionsModelGenericModelConfigObject, str]
+OptionsModel: TypeAlias = Union[
+    OptionsModelVertexModelConfigObject,
+    OptionsModelAzureEntraModelConfigObject,
+    OptionsModelAzureAPIKeyModelConfigObject,
+    OptionsModelGenericModelConfigObject,
+    str,
+]
 
 
 class OptionsVariablesUnionMember3(TypedDict, total=False):