feat: [feat]: add ignoreSelectors to observe()

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 8
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-49b40c7425adba9e67fc102838c5216c45ca1f7ef4c10823c5665fd413538504.yml
-openapi_spec_hash: 6880dc029df2e88dfe8943c0dec5a3a5
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/stagehand-eae8400fade7b2c8329c4148f56de92e147c34c0feecb420c015aab6544a9acc.yml
+openapi_spec_hash: 0a9eff1ac1d464e89cbd9db64709b08a
 config_hash: 1fb12ae9b478488bc1e56bfbdc210b01

src/Stagehand.Tests/Models/Sessions/SessionObserveParamsTest.cs

@@ -20,6 +20,7 @@ public void FieldRoundtrip_Works()
             Instruction = "Find all clickable navigation links",
             Options = new()
             {
+                IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
                 Model = new ModelConfig()
                 {
                     ModelName = "openai/gpt-5.4-mini",
@@ -51,6 +52,7 @@ public void FieldRoundtrip_Works()
         string expectedInstruction = "Find all clickable navigation links";
         SessionObserveParamsOptions expectedOptions = new()
         {
+            IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
             Model = new ModelConfig()
             {
                 ModelName = "openai/gpt-5.4-mini",
@@ -132,6 +134,7 @@ public void OptionalNullableParamsUnsetAreNotSet_Works()
             Instruction = "Find all clickable navigation links",
             Options = new()
             {
+                IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
                 Model = new ModelConfig()
                 {
                     ModelName = "openai/gpt-5.4-mini",
@@ -171,6 +174,7 @@ public void OptionalNullableParamsSetToNullAreSetToNull_Works()
             Instruction = "Find all clickable navigation links",
             Options = new()
             {
+                IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
                 Model = new ModelConfig()
                 {
                     ModelName = "openai/gpt-5.4-mini",
@@ -260,6 +264,7 @@ public void CopyConstructor_Works()
             Instruction = "Find all clickable navigation links",
             Options = new()
             {
+                IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
                 Model = new ModelConfig()
                 {
                     ModelName = "openai/gpt-5.4-mini",
@@ -299,6 +304,7 @@ public void FieldRoundtrip_Works()
     {
         var model = new SessionObserveParamsOptions
         {
+            IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
             Model = new ModelConfig()
             {
                 ModelName = "openai/gpt-5.4-mini",
@@ -323,6 +329,7 @@ public void FieldRoundtrip_Works()
             },
         };
 
+        List<string> expectedIgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"];
         SessionObserveParamsOptionsModel expectedModel = new ModelConfig()
         {
             ModelName = "openai/gpt-5.4-mini",
@@ -346,6 +353,12 @@ public void FieldRoundtrip_Works()
             { "rememberMe", true },
         };
 
+        Assert.NotNull(model.IgnoreSelectors);
+        Assert.Equal(expectedIgnoreSelectors.Count, model.IgnoreSelectors.Count);
+        for (int i = 0; i < expectedIgnoreSelectors.Count; i++)
+        {
+            Assert.Equal(expectedIgnoreSelectors[i], model.IgnoreSelectors[i]);
+        }
         Assert.Equal(expectedModel, model.Model);
         Assert.Equal(expectedSelector, model.Selector);
         Assert.Equal(expectedTimeout, model.Timeout);
@@ -364,6 +377,7 @@ public void SerializationRoundtrip_Works()
     {
         var model = new SessionObserveParamsOptions
         {
+            IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
             Model = new ModelConfig()
             {
                 ModelName = "openai/gpt-5.4-mini",
@@ -402,6 +416,7 @@ public void FieldRoundtripThroughSerialization_Works()
     {
         var model = new SessionObserveParamsOptions
         {
+            IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
             Model = new ModelConfig()
             {
                 ModelName = "openai/gpt-5.4-mini",
@@ -433,6 +448,7 @@ public void FieldRoundtripThroughSerialization_Works()
         );
         Assert.NotNull(deserialized);
 
+        List<string> expectedIgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"];
         SessionObserveParamsOptionsModel expectedModel = new ModelConfig()
         {
             ModelName = "openai/gpt-5.4-mini",
@@ -456,6 +472,12 @@ public void FieldRoundtripThroughSerialization_Works()
             { "rememberMe", true },
         };
 
+        Assert.NotNull(deserialized.IgnoreSelectors);
+        Assert.Equal(expectedIgnoreSelectors.Count, deserialized.IgnoreSelectors.Count);
+        for (int i = 0; i < expectedIgnoreSelectors.Count; i++)
+        {
+            Assert.Equal(expectedIgnoreSelectors[i], deserialized.IgnoreSelectors[i]);
+        }
         Assert.Equal(expectedModel, deserialized.Model);
         Assert.Equal(expectedSelector, deserialized.Selector);
         Assert.Equal(expectedTimeout, deserialized.Timeout);
@@ -474,6 +496,7 @@ public void Validation_Works()
     {
         var model = new SessionObserveParamsOptions
         {
+            IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
             Model = new ModelConfig()
             {
                 ModelName = "openai/gpt-5.4-mini",
@@ -506,6 +529,8 @@ public void OptionalNonNullablePropertiesUnsetAreNotSet_Works()
     {
         var model = new SessionObserveParamsOptions { };
 
+        Assert.Null(model.IgnoreSelectors);
+        Assert.False(model.RawData.ContainsKey("ignoreSelectors"));
         Assert.Null(model.Model);
         Assert.False(model.RawData.ContainsKey("model"));
         Assert.Null(model.Selector);
@@ -530,12 +555,15 @@ public void OptionalNonNullablePropertiesSetToNullAreNotSet_Works()
         var model = new SessionObserveParamsOptions
         {
             // Null should be interpreted as omitted for these properties
+            IgnoreSelectors = null,
             Model = null,
             Selector = null,
             Timeout = null,
             Variables = null,
         };
 
+        Assert.Null(model.IgnoreSelectors);
+        Assert.False(model.RawData.ContainsKey("ignoreSelectors"));
         Assert.Null(model.Model);
         Assert.False(model.RawData.ContainsKey("model"));
         Assert.Null(model.Selector);
@@ -552,6 +580,7 @@ public void OptionalNonNullablePropertiesSetToNullValidation_Works()
         var model = new SessionObserveParamsOptions
         {
             // Null should be interpreted as omitted for these properties
+            IgnoreSelectors = null,
             Model = null,
             Selector = null,
             Timeout = null,
@@ -566,6 +595,7 @@ public void CopyConstructor_Works()
     {
         var model = new SessionObserveParamsOptions
         {
+            IgnoreSelectors = ["nav", ".cookie-banner", "#sidebar-ads"],
             Model = new ModelConfig()
             {
                 ModelName = "openai/gpt-5.4-mini",

src/Stagehand/Models/Sessions/SessionObserveParams.cs

@@ -1,5 +1,6 @@
 using System.Collections.Frozen;
 using System.Collections.Generic;
+using System.Collections.Immutable;
 using System.Diagnostics.CodeAnalysis;
 using System.Net.Http;
 using System.Text;
@@ -229,6 +230,30 @@ public override int GetHashCode()
 )]
 public sealed record class SessionObserveParamsOptions : JsonModel
 {
+    /// <summary>
+    /// Selectors for elements and subtrees that should be excluded from observation
+    /// </summary>
+    public IReadOnlyList<string>? IgnoreSelectors
+    {
+        get
+        {
+            this._rawData.Freeze();
+            return this._rawData.GetNullableStruct<ImmutableArray<string>>("ignoreSelectors");
+        }
+        init
+        {
+            if (value == null)
+            {
+                return;
+            }
+
+            this._rawData.Set<ImmutableArray<string>?>(
+                "ignoreSelectors",
+                value == null ? null : ImmutableArray.ToImmutableArray(value)
+            );
+        }
+    }
+
     /// <summary>
     /// Model configuration object or model name string (e.g., 'openai/gpt-5-nano')
     /// </summary>
@@ -323,6 +348,7 @@ public IReadOnlyDictionary<string, SessionObserveParamsOptionsVariable>? Variabl
     /// <inheritdoc/>
     public override void Validate()
     {
+        _ = this.IgnoreSelectors;
         this.Model?.Validate();
         _ = this.Selector;
         _ = this.Timeout;