release: 3.21.0

.github/workflows/ci.yml

@@ -22,10 +22,10 @@ jobs:
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up .NET
-        uses: actions/setup-dotnet@v3
+        uses: actions/setup-dotnet@55ec9447dda3d1cf6bd587150f3262f30ee10815 # v3.4.2
         with:
           dotnet-version: '8.0.x'
 
@@ -41,10 +41,10 @@ jobs:
     if: (github.event_name == 'push' || github.event.pull_request.head.repo.fork) && (github.event_name != 'push' || github.event.head_commit.message != 'codegen metadata')
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up .NET
-        uses: actions/setup-dotnet@v3
+        uses: actions/setup-dotnet@55ec9447dda3d1cf6bd587150f3262f30ee10815 # v3.4.2
         with:
           dotnet-version: '8.0.x'
 
@@ -57,10 +57,10 @@ jobs:
     runs-on: ${{ github.repository == 'stainless-sdks/stagehand-csharp' && 'depot-windows-2022' || 'windows-latest' }}
     if: github.event_name == 'push' || github.event.pull_request.head.repo.fork
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up .NET
-        uses: actions/setup-dotnet@v5
+        uses: actions/setup-dotnet@c2fa09f4bde5ebb9d1777cf28262a3eb3db3ced7 # v5.2.0
         with:
           dotnet-version: '8.0.x'
 

.github/workflows/publish-nuget.yml

@@ -12,10 +12,10 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
 
       - name: Set up .NET
-        uses: actions/setup-dotnet@v5
+        uses: actions/setup-dotnet@c2fa09f4bde5ebb9d1777cf28262a3eb3db3ced7 # v5.2.0
         with:
           dotnet-version: '8.0.x'
 

.release-please-manifest.json

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

.stats.yml

@@ -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-c7910965e66e73ad8b65b6cc391d431094b2a6c6577c3e9d82feaa8138e74cff.yml
+openapi_spec_hash: 37748bb69c22a9ce721d9b5a5861f964
 config_hash: 1fb12ae9b478488bc1e56bfbdc210b01

CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 3.21.0 (2026-05-29)
+
+Full Changelog: [v3.20.0...v3.21.0](https://github.com/browserbase/stagehand-net/compare/v3.20.0...v3.21.0)
+
+### Features
+
+* [feat]: add `ignoreSelectors` to `observe()` ([37f80f3](https://github.com/browserbase/stagehand-net/commit/37f80f3936fc9a85e6e6079381c41ef4e3793472))
+* [STG-1756] forward Vertex model config ([491fbd8](https://github.com/browserbase/stagehand-net/commit/491fbd8190a86a1a8e9ba41e849753207aa8574c))
+* Add `screenshot` option to Extract ([1dae7c2](https://github.com/browserbase/stagehand-net/commit/1dae7c22aa40af570d387fa871ee10ea4c0b9084))
+* STG-1756 add Vertex auth params to Stagehand spec ([8fa4926](https://github.com/browserbase/stagehand-net/commit/8fa49262dca9eda52850f3226279b7ee97228f39))
+
+
+### Bug Fixes
+
+* **csharp:** update examples for generated model unions ([ebca6e0](https://github.com/browserbase/stagehand-net/commit/ebca6e031e6d7894675cc0502803fb0cbe985219))
+* **internal:** disable default HttpClient timeout as we have our own ([c20c6e0](https://github.com/browserbase/stagehand-net/commit/c20c6e01fb40ff0ab9547bf733f6c735e0949e4e))
+
 ## 3.20.0 (2026-05-06)
 
 Full Changelog: [v3.19.3...v3.20.0](https://github.com/browserbase/stagehand-net/compare/v3.19.3...v3.20.0)

examples/local_browser_playwright_example.cs

@@ -4,7 +4,6 @@
 using System.Threading.Tasks;
 using Stagehand;
 using Stagehand.Models.Sessions;
-using SessionType = Stagehand.Models.Sessions.Type;
 using StagehandAction = Stagehand.Models.Sessions.Action;
 
 namespace Stagehand.Examples
@@ -27,7 +26,7 @@ public static async Task RunAsync()
                     ModelName = "anthropic/claude-sonnet-4-6",
                     Browser = new Browser
                     {
-                        Type = SessionType.Local,
+                        Type = BrowserType.Local,
                         LaunchOptions = new LaunchOptions { Headless = true },
                     },
                 }
@@ -170,7 +169,7 @@ await client.Sessions.Navigate(
                         AgentConfig = new AgentConfig
                         {
                             Model = new AgentConfigModel(
-                                new ModelConfig
+                                new AgentConfigModelGenericModelConfigObject
                                 {
                                     ModelName = "anthropic/claude-opus-4-6",
                                     ApiKey = Environment.GetEnvironmentVariable("MODEL_API_KEY"),

examples/local_server_multiregion_browser_example.cs

@@ -4,7 +4,6 @@
 using System.Threading.Tasks;
 using Stagehand;
 using Stagehand.Models.Sessions;
-using SessionType = Stagehand.Models.Sessions.Type;
 using StagehandAction = Stagehand.Models.Sessions.Action;
 
 namespace Stagehand.Examples
@@ -24,7 +23,7 @@ public static async Task RunAsync()
                 new SessionStartParams
                 {
                     ModelName = "anthropic/claude-sonnet-4-6",
-                    Browser = new Browser { Type = SessionType.Browserbase },
+                    Browser = new Browser { Type = BrowserType.Browserbase },
                     BrowserbaseSessionCreateParams = new BrowserbaseSessionCreateParams
                     {
                         Region = Region.EuCentral1,
@@ -163,7 +162,7 @@ await client.Sessions.Navigate(
                         AgentConfig = new AgentConfig
                         {
                             Model = new AgentConfigModel(
-                                new ModelConfig
+                                new AgentConfigModelGenericModelConfigObject
                                 {
                                     ModelName = "anthropic/claude-opus-4-6",
                                     ApiKey = Environment.GetEnvironmentVariable("MODEL_API_KEY"),

examples/remote_browser_playwright_example.cs

@@ -4,7 +4,6 @@
 using System.Threading.Tasks;
 using Stagehand;
 using Stagehand.Models.Sessions;
-using SessionType = Stagehand.Models.Sessions.Type;
 using StagehandAction = Stagehand.Models.Sessions.Action;
 
 namespace Stagehand.Examples
@@ -24,7 +23,7 @@ public static async Task RunAsync()
                 new SessionStartParams
                 {
                     ModelName = "anthropic/claude-sonnet-4-6",
-                    Browser = new Browser { Type = SessionType.Browserbase },
+                    Browser = new Browser { Type = BrowserType.Browserbase },
                 }
             );
             Console.WriteLine($"Session started: {startResponse.Data.SessionID}");
@@ -165,7 +164,7 @@ await client.Sessions.Navigate(
                         AgentConfig = new AgentConfig
                         {
                             Model = new AgentConfigModel(
-                                new ModelConfig
+                                new AgentConfigModelGenericModelConfigObject
                                 {
                                     ModelName = "anthropic/claude-opus-4-6",
                                     ApiKey = Environment.GetEnvironmentVariable("MODEL_API_KEY"),