Skip to content

release: 3.21.0 #342

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
stainless-app wants to merge 5 commits into
base: main
Choose a base branch
from
Open

release: 3.21.0 #342

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
474fe3e
codegen metadata
stainless-app[bot] May 7, 2026
ce22a97
codegen metadata
stainless-app[bot] May 7, 2026
77be2c2
feat: [feat]: add `ignoreSelectors` to `observe()`
stainless-app[bot] May 7, 2026
fb40f50
fix(client): add missing f-string prefix in file type error message
stainless-app[bot] May 9, 2026
1c34803
release: 3.21.0
stainless-app[bot] May 9, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .release-please-manifest.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "3.20.0"
".": "3.21.0"
}
4 changes: 2 additions & 2 deletions .stats.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 8
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-6f6bfb81d092f30a5e2005328c97d61b9ea36132bb19e9e79e55294b9534ce20.yml
openapi_spec_hash: f3fc1e3688a38dc2c28f7178f7d534e5
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-eae8400fade7b2c8329c4148f56de92e147c34c0feecb420c015aab6544a9acc.yml
openapi_spec_hash: 0a9eff1ac1d464e89cbd9db64709b08a
config_hash: 1fb12ae9b478488bc1e56bfbdc210b01
13 changes: 13 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,18 @@
# Changelog

## 3.21.0 (2026-05-09)

Full Changelog: [v3.20.0...v3.21.0](https://github.com/browserbase/stagehand-python/compare/v3.20.0...v3.21.0)

### Features

* [feat]: add `ignoreSelectors` to `observe()` ([77be2c2](https://github.com/browserbase/stagehand-python/commit/77be2c2463c7b1d0ce6768eecf130adc3ef91149))


### Bug Fixes

* **client:** add missing f-string prefix in file type error message ([fb40f50](https://github.com/browserbase/stagehand-python/commit/fb40f50c2fb3337be84a3f973b8a27a8f53fbfae))

## 3.20.0 (2026-05-06)

Full Changelog: [v3.19.5...v3.20.0](https://github.com/browserbase/stagehand-python/compare/v3.19.5...v3.20.0)
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
[project]
name = "stagehand"
version = "3.20.0"
version = "3.21.0"
description = "The official Python library for the stagehand API"
dynamic = ["readme"]
license = "MIT"
Expand Down
2 changes: 1 addition & 1 deletion src/stagehand/_files.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ async def async_to_httpx_files(files: RequestFiles | None) -> HttpxRequestFiles
elif is_sequence_t(files):
files = [(key, await _async_transform_file(file)) for key, file in files]
else:
raise TypeError("Unexpected file type input {type(files)}, expected mapping or sequence")
raise TypeError(f"Unexpected file type input {type(files)}, expected mapping or sequence")

return files

Expand Down
2 changes: 1 addition & 1 deletion src/stagehand/_version.py
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

__title__ = "stagehand"
__version__ = "3.20.0" # x-release-please-version
__version__ = "3.21.0" # x-release-please-version
4 changes: 4 additions & 0 deletions src/stagehand/types/session_observe_params.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
from typing import Dict, Union, Optional
from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict

from .._types import SequenceNotStr
Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot May 7, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: Custom agent: Prevent direct modifications to stainless codegen'd code outside of src/stagehand/_custom

Directly modified a Stainless-generated SDK file outside src/stagehand/_custom by adding a new public field/import instead of using the allowed custom-code wrapper or hook pattern.

Prompt for AI agents 
Check if this issue is valid — if so, understand the root cause and fix it. At src/stagehand/types/session_observe_params.py, line 8:

<comment>Directly modified a Stainless-generated SDK file outside src/stagehand/_custom by adding a new public field/import instead of using the allowed custom-code wrapper or hook pattern.</comment>

<file context>
@@ -5,6 +5,7 @@
 from typing import Dict, Union, Optional
 from typing_extensions import Literal, Required, Annotated, TypeAlias, TypedDict
 
+from .._types import SequenceNotStr
 from .._utils import PropertyInfo
 from .model_config_param import ModelConfigParam
</file context>
Fix with Cubic

from .._utils import PropertyInfo
from .model_config_param import ModelConfigParam

Expand Down Expand Up @@ -45,6 +46,9 @@ class OptionsVariablesUnionMember3(TypedDict, total=False):


class Options(TypedDict, total=False):
ignore_selectors: Annotated[SequenceNotStr[str], PropertyInfo(alias="ignoreSelectors")]
"""Selectors for elements and subtrees that should be excluded from observation"""

model: OptionsModel
"""Model configuration object or model name string (e.g., 'openai/gpt-5-nano')"""

Expand Down
4 changes: 4 additions & 0 deletions tests/api_resources/test_sessions.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -645,6 +645,7 @@ def test_method_observe_with_all_params_overload_1(self, client: Stagehand) -> N
frame_id="frameId",
instruction="Find all clickable navigation links",
options={
"ignore_selectors": ["nav", ".cookie-banner", "#sidebar-ads"],
"model": {
"model_name": "openai/gpt-5.4-mini",
"api_key": "sk-some-openai-api-key",
Expand Down Expand Up @@ -719,6 +720,7 @@ def test_method_observe_with_all_params_overload_2(self, client: Stagehand) -> N
frame_id="frameId",
instruction="Find all clickable navigation links",
options={
"ignore_selectors": ["nav", ".cookie-banner", "#sidebar-ads"],
"model": {
"model_name": "openai/gpt-5.4-mini",
"api_key": "sk-some-openai-api-key",
Expand Down Expand Up @@ -1579,6 +1581,7 @@ async def test_method_observe_with_all_params_overload_1(self, async_client: Asy
frame_id="frameId",
instruction="Find all clickable navigation links",
options={
"ignore_selectors": ["nav", ".cookie-banner", "#sidebar-ads"],
"model": {
"model_name": "openai/gpt-5.4-mini",
"api_key": "sk-some-openai-api-key",
Expand Down Expand Up @@ -1653,6 +1656,7 @@ async def test_method_observe_with_all_params_overload_2(self, async_client: Asy
frame_id="frameId",
instruction="Find all clickable navigation links",
options={
"ignore_selectors": ["nav", ".cookie-banner", "#sidebar-ads"],
"model": {
"model_name": "openai/gpt-5.4-mini",
"api_key": "sk-some-openai-api-key",
Expand Down
Loading