feat: variables for 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%2Fstagehand-573d364768ac1902ee5ed8b2485d3b293bda0ea8ff7898aef1a3fd6be79b594a.yml
-openapi_spec_hash: 107ec840f4330885dd2232a05a66fed7
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-975ca868b31b1e45fb00b31a53d9df1ceec8663f6c2851bf40fdaa84171afadc.yml
+openapi_spec_hash: 37891379e0f47e5c69769fbaa1064dab
 config_hash: 0209737a4ab2a71afececb0ff7459998

stagehand-java-core/src/main/kotlin/com/browserbase/api/models/sessions/SessionActParams.kt

@@ -805,7 +805,8 @@ private constructor(
         fun timeout(): Optional<Double> = timeout.getOptional("timeout")
 
         /**
-         * Variables to substitute in the action instruction
+         * Variables to substitute in the action instruction. Accepts flat primitives or { value,
+         * description? } objects.
          *
          * @throws StagehandInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
@@ -899,7 +900,10 @@ private constructor(
              */
             fun timeout(timeout: JsonField<Double>) = apply { this.timeout = timeout }
 
-            /** Variables to substitute in the action instruction */
+            /**
+             * Variables to substitute in the action instruction. Accepts flat primitives or {
+             * value, description? } objects.
+             */
             fun variables(variables: Variables) = variables(JsonField.of(variables))
 
             /**
@@ -1144,7 +1148,10 @@ private constructor(
             }
         }
 
-        /** Variables to substitute in the action instruction */
+        /**
+         * Variables to substitute in the action instruction. Accepts flat primitives or { value,
+         * description? } objects.
+         */
         class Variables
         @JsonCreator
         private constructor(

stagehand-java-core/src/main/kotlin/com/browserbase/api/models/sessions/SessionExecuteParams.kt

@@ -1686,6 +1686,8 @@ private constructor(
         private val instruction: JsonField<String>,
         private val highlightCursor: JsonField<Boolean>,
         private val maxSteps: JsonField<Double>,
+        private val toolTimeout: JsonField<Double>,
+        private val useSearch: JsonField<Boolean>,
         private val additionalProperties: MutableMap<String, JsonValue>,
     ) {
 
@@ -1697,8 +1699,16 @@ private constructor(
             @JsonProperty("highlightCursor")
             @ExcludeMissing
             highlightCursor: JsonField<Boolean> = JsonMissing.of(),
-            @JsonProperty("maxSteps") @ExcludeMissing maxSteps: JsonField<Double> = JsonMissing.of(),
-        ) : this(instruction, highlightCursor, maxSteps, mutableMapOf())
+            @JsonProperty("maxSteps")
+            @ExcludeMissing
+            maxSteps: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("toolTimeout")
+            @ExcludeMissing
+            toolTimeout: JsonField<Double> = JsonMissing.of(),
+            @JsonProperty("useSearch")
+            @ExcludeMissing
+            useSearch: JsonField<Boolean> = JsonMissing.of(),
+        ) : this(instruction, highlightCursor, maxSteps, toolTimeout, useSearch, mutableMapOf())
 
         /**
          * Natural language instruction for the agent
@@ -1724,6 +1734,22 @@ private constructor(
          */
         fun maxSteps(): Optional<Double> = maxSteps.getOptional("maxSteps")
 
+        /**
+         * Timeout in milliseconds for each agent tool call
+         *
+         * @throws StagehandInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun toolTimeout(): Optional<Double> = toolTimeout.getOptional("toolTimeout")
+
+        /**
+         * Whether to enable the web search tool powered by Browserbase Search API
+         *
+         * @throws StagehandInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun useSearch(): Optional<Boolean> = useSearch.getOptional("useSearch")
+
         /**
          * Returns the raw JSON value of [instruction].
          *
@@ -1750,6 +1776,22 @@ private constructor(
          */
         @JsonProperty("maxSteps") @ExcludeMissing fun _maxSteps(): JsonField<Double> = maxSteps
 
+        /**
+         * Returns the raw JSON value of [toolTimeout].
+         *
+         * Unlike [toolTimeout], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("toolTimeout")
+        @ExcludeMissing
+        fun _toolTimeout(): JsonField<Double> = toolTimeout
+
+        /**
+         * Returns the raw JSON value of [useSearch].
+         *
+         * Unlike [useSearch], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("useSearch") @ExcludeMissing fun _useSearch(): JsonField<Boolean> = useSearch
+
         @JsonAnySetter
         private fun putAdditionalProperty(key: String, value: JsonValue) {
             additionalProperties.put(key, value)
@@ -1781,13 +1823,17 @@ private constructor(
             private var instruction: JsonField<String>? = null
             private var highlightCursor: JsonField<Boolean> = JsonMissing.of()
             private var maxSteps: JsonField<Double> = JsonMissing.of()
+            private var toolTimeout: JsonField<Double> = JsonMissing.of()
+            private var useSearch: JsonField<Boolean> = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(executeOptions: ExecuteOptions) = apply {
                 instruction = executeOptions.instruction
                 highlightCursor = executeOptions.highlightCursor
                 maxSteps = executeOptions.maxSteps
+                toolTimeout = executeOptions.toolTimeout
+                useSearch = executeOptions.useSearch
                 additionalProperties = executeOptions.additionalProperties.toMutableMap()
             }
 
@@ -1832,6 +1878,32 @@ private constructor(
              */
             fun maxSteps(maxSteps: JsonField<Double>) = apply { this.maxSteps = maxSteps }
 
+            /** Timeout in milliseconds for each agent tool call */
+            fun toolTimeout(toolTimeout: Double) = toolTimeout(JsonField.of(toolTimeout))
+
+            /**
+             * Sets [Builder.toolTimeout] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.toolTimeout] with a well-typed [Double] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun toolTimeout(toolTimeout: JsonField<Double>) = apply {
+                this.toolTimeout = toolTimeout
+            }
+
+            /** Whether to enable the web search tool powered by Browserbase Search API */
+            fun useSearch(useSearch: Boolean) = useSearch(JsonField.of(useSearch))
+
+            /**
+             * Sets [Builder.useSearch] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.useSearch] with a well-typed [Boolean] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun useSearch(useSearch: JsonField<Boolean>) = apply { this.useSearch = useSearch }
+
             fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
                 this.additionalProperties.clear()
                 putAllAdditionalProperties(additionalProperties)
@@ -1868,6 +1940,8 @@ private constructor(
                     checkRequired("instruction", instruction),
                     highlightCursor,
                     maxSteps,
+                    toolTimeout,
+                    useSearch,
                     additionalProperties.toMutableMap(),
                 )
         }
@@ -1882,6 +1956,8 @@ private constructor(
             instruction()
             highlightCursor()
             maxSteps()
+            toolTimeout()
+            useSearch()
             validated = true
         }
 
@@ -1903,7 +1979,9 @@ private constructor(
         internal fun validity(): Int =
             (if (instruction.asKnown().isPresent) 1 else 0) +
                 (if (highlightCursor.asKnown().isPresent) 1 else 0) +
-                (if (maxSteps.asKnown().isPresent) 1 else 0)
+                (if (maxSteps.asKnown().isPresent) 1 else 0) +
+                (if (toolTimeout.asKnown().isPresent) 1 else 0) +
+                (if (useSearch.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
@@ -1914,17 +1992,26 @@ private constructor(
                 instruction == other.instruction &&
                 highlightCursor == other.highlightCursor &&
                 maxSteps == other.maxSteps &&
+                toolTimeout == other.toolTimeout &&
+                useSearch == other.useSearch &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(instruction, highlightCursor, maxSteps, additionalProperties)
+            Objects.hash(
+                instruction,
+                highlightCursor,
+                maxSteps,
+                toolTimeout,
+                useSearch,
+                additionalProperties,
+            )
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "ExecuteOptions{instruction=$instruction, highlightCursor=$highlightCursor, maxSteps=$maxSteps, additionalProperties=$additionalProperties}"
+            "ExecuteOptions{instruction=$instruction, highlightCursor=$highlightCursor, maxSteps=$maxSteps, toolTimeout=$toolTimeout, useSearch=$useSearch, additionalProperties=$additionalProperties}"
     }
 
     /** Whether to stream the response via SSE */