browserbase · github-actions · Sep 22, 2026
diff --git a/.changeset/eval-frame-snapshot-maps.md b/.changeset/eval-frame-snapshot-maps.md
diff --git a/.changeset/eval-session-ownership.md b/.changeset/eval-session-ownership.md
diff --git a/.changeset/wild-loops-lay.md b/.changeset/wild-loops-lay.md
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -3,6 +3,48 @@
 This changelog covers the public Stagehand TypeScript and Python SDKs. Entries before 4.0.0
 describe the TypeScript SDK.
 
+## TypeScript SDK 4.2.0
+
+### Minor Changes
+
+- [#2916](https://github.com/browserbase/stagehand/pull/2916) [`476658b`](https://github.com/browserbase/stagehand/commit/476658b595b51f8bfbf5d31dc91f4a65c10ddad6) Thanks [@seanmcguire12](https://github.com/seanmcguire12)! - add page level hooks for webmcp tools added and webmcp tools removed events.
+
+### Patch Changes
+
+- [#2892](https://github.com/browserbase/stagehand/pull/2892) [`0210688`](https://github.com/browserbase/stagehand/commit/02106888668925aedbbf354f22b3ddaceb9c1027) Thanks [@miguelg719](https://github.com/miguelg719)! - Release a newly created Browserbase session when initial attachment fails, and support upload retries
+
+## Python SDK 4.2.0
+
+### Minor Changes
+
+- [#2916](https://github.com/browserbase/stagehand/pull/2916) [`476658b`](https://github.com/browserbase/stagehand/commit/476658b595b51f8bfbf5d31dc91f4a65c10ddad6) Thanks [@seanmcguire12](https://github.com/seanmcguire12)! - add page level hooks for webmcp tools added and webmcp tools removed events.
+
+## Extension Runtime 1.1.0
+
+### Minor Changes
+
+- [#2916](https://github.com/browserbase/stagehand/pull/2916) [`476658b`](https://github.com/browserbase/stagehand/commit/476658b595b51f8bfbf5d31dc91f4a65c10ddad6) Thanks [@seanmcguire12](https://github.com/seanmcguire12)! - add page level hooks for webmcp tools added and webmcp tools removed events.
+
+### Patch Changes
+
+- [#2896](https://github.com/browserbase/stagehand/pull/2896) [`7919934`](https://github.com/browserbase/stagehand/commit/7919934c24170482dcfab19b882b557c65d8eb61) Thanks [@miguelg719](https://github.com/miguelg719)! - Snapshot references remain valid across same-origin and out-of-process frame captures
+
+## Go SDK 4.2.0
+
+### Minor Changes
+
+- [#2916](https://github.com/browserbase/stagehand/pull/2916) [`476658b`](https://github.com/browserbase/stagehand/commit/476658b595b51f8bfbf5d31dc91f4a65c10ddad6) Thanks [@seanmcguire12](https://github.com/seanmcguire12)! - add page level hooks for webmcp tools added and webmcp tools removed events.
+
+### Patch Changes
+
+- [#2896](https://github.com/browserbase/stagehand/pull/2896) [`7919934`](https://github.com/browserbase/stagehand/commit/7919934c24170482dcfab19b882b557c65d8eb61) Thanks [@miguelg719](https://github.com/miguelg719)! - Snapshot references remain valid across same-origin and out-of-process frame captures
+
+## Protocol 2.1.0
+
+### Minor Changes
+
+- [#2916](https://github.com/browserbase/stagehand/pull/2916) [`476658b`](https://github.com/browserbase/stagehand/commit/476658b595b51f8bfbf5d31dc91f4a65c10ddad6) Thanks [@seanmcguire12](https://github.com/seanmcguire12)! - add page level hooks for webmcp tools added and webmcp tools removed events.
+
 ## TypeScript SDK 4.1.0
 
 ### Minor Changes

diff --git a/packages/extension/package.json b/packages/extension/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-extension",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "private": true,
   "type": "module",
   "scripts": {

diff --git a/packages/integrations/claude-agent-sdk/package.json b/packages/integrations/claude-agent-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-claude-agent-sdk",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "private": true,
   "description": "Claude Agent SDK harness adapter for Stagehand integrations",
   "files": [

diff --git a/packages/integrations/claude-code/package.json b/packages/integrations/claude-code/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-example-claude-code-facade",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "private": true,
   "type": "module",
   "scripts": {

diff --git a/packages/integrations/codex-sdk/package.json b/packages/integrations/codex-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-codex-sdk",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "private": true,
   "description": "Codex SDK harness adapter for Stagehand integrations",
   "files": [

diff --git a/packages/integrations/codex/package.json b/packages/integrations/codex/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-example-codex-facade",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "private": true,
   "type": "module",
   "scripts": {

diff --git a/packages/integrations/core/package.json b/packages/integrations/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "private": true,
   "description": "Shared integration surfaces for Stagehand V4",
   "bin": {

diff --git a/packages/integrations/cursor-sdk/package.json b/packages/integrations/cursor-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-cursor-sdk",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "private": true,
   "description": "Cursor agent CLI harness adapter for Stagehand integrations",
   "files": [

diff --git a/packages/integrations/deepagents-sdk/package.json b/packages/integrations/deepagents-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-deepagents-sdk",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "private": true,
   "description": "Deep Agents (LangChain) harness adapter for Stagehand integrations",
   "files": [

diff --git a/packages/integrations/eve-sdk/package.json b/packages/integrations/eve-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-eve-sdk",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "private": true,
   "description": "Eve (Vercel) harness adapter for Stagehand integrations",
   "files": [

diff --git a/packages/integrations/eve/package.json b/packages/integrations/eve/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-example-eve-facade",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "private": true,
   "type": "module",
   "scripts": {

diff --git a/packages/integrations/fx-sdk/package.json b/packages/integrations/fx-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-fx-sdk",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "private": true,
   "description": "fx CLI harness adapter for Stagehand integrations",
   "files": [

diff --git a/packages/integrations/mastra-sdk/package.json b/packages/integrations/mastra-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-mastra-sdk",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "private": true,
   "description": "Mastra harness adapter for Stagehand integrations",
   "files": [

diff --git a/packages/integrations/mastra/package.json b/packages/integrations/mastra/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-example-mastra-facade",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "private": true,
   "type": "module",
   "scripts": {

diff --git a/packages/integrations/pi-sdk/package.json b/packages/integrations/pi-sdk/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-pi-sdk",
-  "version": "4.0.2",
+  "version": "4.0.3",
   "private": true,
   "description": "pi (pi-coding-agent) SDK harness adapter for Stagehand integrations",
   "files": [

diff --git a/packages/integrations/pi/package.json b/packages/integrations/pi/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-example-pi-facade",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "private": true,
   "keywords": [
     "pi-package"

diff --git a/packages/integrations/vercel-ai/package.json b/packages/integrations/vercel-ai/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-integrations-example-vercel-ai-facade",
-  "version": "4.0.3",
+  "version": "4.0.4",
   "private": true,
   "type": "module",
   "scripts": {

diff --git a/packages/protocol/package.json b/packages/protocol/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-protocol",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "private": true,
   "type": "module",
   "exports": {

diff --git a/packages/sdk-go/internal/extensionassets/stagehand-extension.zip b/packages/sdk-go/internal/extensionassets/stagehand-extension.zip
diff --git a/packages/sdk-go/package.json b/packages/sdk-go/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-go",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "private": true,
   "description": "Changesets version proxy for the Stagehand Go SDK"
 }
diff --git a/packages/sdk-go/protocol_version.gen.go b/packages/sdk-go/protocol_version.gen.go
diff --git a/packages/sdk-go/sdk_version.gen.go b/packages/sdk-go/sdk_version.gen.go
diff --git a/packages/sdk-python/package.json b/packages/sdk-python/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand-python",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "private": true,
   "description": "Changesets version proxy for the Stagehand Python SDK"
 }
diff --git a/packages/sdk-python/pyproject.toml b/packages/sdk-python/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "stagehand"
-version = "4.1.0"
+version = "4.2.0"
 description = "Browserbase's SDK for building browser agents"
 readme = "README.md"
 requires-python = ">=3.11"

diff --git a/packages/sdk-python/src/stagehand/_generated/protocol_version.py b/packages/sdk-python/src/stagehand/_generated/protocol_version.py
@@ -1,4 +1,4 @@
 """Generated from packages/protocol/package.json. Do not edit."""
 
 PROTOCOL_SEMVER_PATTERN = '^(0|[1-9]\\d*)\\.(0|[1-9]\\d*)\\.(0|[1-9]\\d*)(?:-((?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*)(?:\\.(?:0|[1-9]\\d*|\\d*[A-Za-z-][0-9A-Za-z-]*))*))?(?:\\+([0-9A-Za-z-]+(?:\\.[0-9A-Za-z-]+)*))?$'
-STAGEHAND_PROTOCOL_VERSION = '2.0.0'
+STAGEHAND_PROTOCOL_VERSION = '2.1.0'
diff --git a/packages/sdk-python/uv.lock b/packages/sdk-python/uv.lock
diff --git a/packages/sdk-ts/package.json b/packages/sdk-ts/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@browserbasehq/stagehand",
-  "version": "4.1.0",
+  "version": "4.2.0",
   "description": "Browserbase's SDK for building browser agents",
   "keywords": [
     "ai",