feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-d571232203ef4e00986a3245224267db6f8aaffdad57780f712e0694dc8d9e37.yml
-openapi_spec_hash: d5d635dd7b24a2e1255c6f2a895253ff
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-817d1d4e845b1946dac8ee10fd34b3f533aa36f74ac598582ffb1b0399a5a932.yml
+openapi_spec_hash: 9d856db62b34909fec94743235b3d7be
 config_hash: 88e87ba7021be93d267ecfc8f5e6b891

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

@@ -27,33 +27,44 @@ import java.util.Collections
 import java.util.Objects
 import java.util.Optional
 
+/**
+ * Model name string with provider prefix (e.g., 'openai/gpt-5-nano', 'anthropic/claude-4.5-opus')
+ */
 @JsonDeserialize(using = ModelConfig.Deserializer::class)
 @JsonSerialize(using = ModelConfig.Serializer::class)
 class ModelConfig
 private constructor(
-    private val string: String? = null,
-    private val unionMember1: UnionMember1? = null,
+    private val name: String? = null,
+    private val modelConfigObject: ModelConfigObject? = null,
     private val _json: JsonValue? = null,
 ) {
 
-    fun string(): Optional<String> = Optional.ofNullable(string)
+    /**
+     * Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+     * 'anthropic/claude-4.5-opus')
+     */
+    fun name(): Optional<String> = Optional.ofNullable(name)
 
-    fun unionMember1(): Optional<UnionMember1> = Optional.ofNullable(unionMember1)
+    fun modelConfigObject(): Optional<ModelConfigObject> = Optional.ofNullable(modelConfigObject)
 
-    fun isString(): Boolean = string != null
+    fun isName(): Boolean = name != null
 
-    fun isUnionMember1(): Boolean = unionMember1 != null
+    fun isModelConfigObject(): Boolean = modelConfigObject != null
 
-    fun asString(): String = string.getOrThrow("string")
+    /**
+     * Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+     * 'anthropic/claude-4.5-opus')
+     */
+    fun asName(): String = name.getOrThrow("name")
 
-    fun asUnionMember1(): UnionMember1 = unionMember1.getOrThrow("unionMember1")
+    fun asModelConfigObject(): ModelConfigObject = modelConfigObject.getOrThrow("modelConfigObject")
 
     fun _json(): Optional<JsonValue> = Optional.ofNullable(_json)
 
     fun <T> accept(visitor: Visitor<T>): T =
         when {
-            string != null -> visitor.visitString(string)
-            unionMember1 != null -> visitor.visitUnionMember1(unionMember1)
+            name != null -> visitor.visitName(name)
+            modelConfigObject != null -> visitor.visitModelConfigObject(modelConfigObject)
             else -> visitor.unknown(_json)
         }
 
@@ -66,10 +77,10 @@ private constructor(
 
         accept(
             object : Visitor<Unit> {
-                override fun visitString(string: String) {}
+                override fun visitName(name: String) {}
 
-                override fun visitUnionMember1(unionMember1: UnionMember1) {
-                    unionMember1.validate()
+                override fun visitModelConfigObject(modelConfigObject: ModelConfigObject) {
+                    modelConfigObject.validate()
                 }
             }
         )
@@ -93,9 +104,10 @@ private constructor(
     internal fun validity(): Int =
         accept(
             object : Visitor<Int> {
-                override fun visitString(string: String) = 1
+                override fun visitName(name: String) = 1
 
-                override fun visitUnionMember1(unionMember1: UnionMember1) = unionMember1.validity()
+                override fun visitModelConfigObject(modelConfigObject: ModelConfigObject) =
+                    modelConfigObject.validity()
 
                 override fun unknown(json: JsonValue?) = 0
             }
@@ -106,35 +118,46 @@ private constructor(
             return true
         }
 
-        return other is ModelConfig && string == other.string && unionMember1 == other.unionMember1
+        return other is ModelConfig &&
+            name == other.name &&
+            modelConfigObject == other.modelConfigObject
     }
 
-    override fun hashCode(): Int = Objects.hash(string, unionMember1)
+    override fun hashCode(): Int = Objects.hash(name, modelConfigObject)
 
     override fun toString(): String =
         when {
-            string != null -> "ModelConfig{string=$string}"
-            unionMember1 != null -> "ModelConfig{unionMember1=$unionMember1}"
+            name != null -> "ModelConfig{name=$name}"
+            modelConfigObject != null -> "ModelConfig{modelConfigObject=$modelConfigObject}"
             _json != null -> "ModelConfig{_unknown=$_json}"
             else -> throw IllegalStateException("Invalid ModelConfig")
         }
 
     companion object {
 
-        @JvmStatic fun ofString(string: String) = ModelConfig(string = string)
+        /**
+         * Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+         * 'anthropic/claude-4.5-opus')
+         */
+        @JvmStatic fun ofName(name: String) = ModelConfig(name = name)
 
         @JvmStatic
-        fun ofUnionMember1(unionMember1: UnionMember1) = ModelConfig(unionMember1 = unionMember1)
+        fun ofModelConfigObject(modelConfigObject: ModelConfigObject) =
+            ModelConfig(modelConfigObject = modelConfigObject)
     }
 
     /**
      * An interface that defines how to map each variant of [ModelConfig] to a value of type [T].
      */
     interface Visitor<out T> {
 
-        fun visitString(string: String): T
+        /**
+         * Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+         * 'anthropic/claude-4.5-opus')
+         */
+        fun visitName(name: String): T
 
-        fun visitUnionMember1(unionMember1: UnionMember1): T
+        fun visitModelConfigObject(modelConfigObject: ModelConfigObject): T
 
         /**
          * Maps an unknown variant of [ModelConfig] to a value of type [T].
@@ -157,11 +180,11 @@ private constructor(
 
             val bestMatches =
                 sequenceOf(
-                        tryDeserialize(node, jacksonTypeRef<UnionMember1>())?.let {
-                            ModelConfig(unionMember1 = it, _json = json)
+                        tryDeserialize(node, jacksonTypeRef<ModelConfigObject>())?.let {
+                            ModelConfig(modelConfigObject = it, _json = json)
                         },
                         tryDeserialize(node, jacksonTypeRef<String>())?.let {
-                            ModelConfig(string = it, _json = json)
+                            ModelConfig(name = it, _json = json)
                         },
                     )
                     .filterNotNull()
@@ -187,15 +210,15 @@ private constructor(
             provider: SerializerProvider,
         ) {
             when {
-                value.string != null -> generator.writeObject(value.string)
-                value.unionMember1 != null -> generator.writeObject(value.unionMember1)
+                value.name != null -> generator.writeObject(value.name)
+                value.modelConfigObject != null -> generator.writeObject(value.modelConfigObject)
                 value._json != null -> generator.writeObject(value._json)
                 else -> throw IllegalStateException("Invalid ModelConfig")
             }
         }
     }
 
-    class UnionMember1
+    class ModelConfigObject
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
         private val modelName: JsonField<String>,
@@ -214,18 +237,24 @@ private constructor(
         ) : this(modelName, apiKey, baseUrl, mutableMapOf())
 
         /**
+         * Model name string without prefix (e.g., 'gpt-5-nano', 'claude-4.5-opus')
+         *
          * @throws StagehandInvalidDataException if the JSON field has an unexpected type or is
          *   unexpectedly missing or null (e.g. if the server responded with an unexpected value).
          */
         fun modelName(): String = modelName.getRequired("modelName")
 
         /**
+         * API key for the model provider
+         *
          * @throws StagehandInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
          */
         fun apiKey(): Optional<String> = apiKey.getOptional("apiKey")
 
         /**
+         * Base URL for the model provider
+         *
          * @throws StagehandInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
          */
@@ -267,7 +296,7 @@ private constructor(
         companion object {
 
             /**
-             * Returns a mutable builder for constructing an instance of [UnionMember1].
+             * Returns a mutable builder for constructing an instance of [ModelConfigObject].
              *
              * The following fields are required:
              * ```java
@@ -277,7 +306,7 @@ private constructor(
             @JvmStatic fun builder() = Builder()
         }
 
-        /** A builder for [UnionMember1]. */
+        /** A builder for [ModelConfigObject]. */
         class Builder internal constructor() {
 
             private var modelName: JsonField<String>? = null
@@ -286,13 +315,14 @@ private constructor(
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
-            internal fun from(unionMember1: UnionMember1) = apply {
-                modelName = unionMember1.modelName
-                apiKey = unionMember1.apiKey
-                baseUrl = unionMember1.baseUrl
-                additionalProperties = unionMember1.additionalProperties.toMutableMap()
+            internal fun from(modelConfigObject: ModelConfigObject) = apply {
+                modelName = modelConfigObject.modelName
+                apiKey = modelConfigObject.apiKey
+                baseUrl = modelConfigObject.baseUrl
+                additionalProperties = modelConfigObject.additionalProperties.toMutableMap()
             }
 
+            /** Model name string without prefix (e.g., 'gpt-5-nano', 'claude-4.5-opus') */
             fun modelName(modelName: String) = modelName(JsonField.of(modelName))
 
             /**
@@ -304,6 +334,7 @@ private constructor(
              */
             fun modelName(modelName: JsonField<String>) = apply { this.modelName = modelName }
 
+            /** API key for the model provider */
             fun apiKey(apiKey: String) = apiKey(JsonField.of(apiKey))
 
             /**
@@ -315,6 +346,7 @@ private constructor(
              */
             fun apiKey(apiKey: JsonField<String>) = apply { this.apiKey = apiKey }
 
+            /** Base URL for the model provider */
             fun baseUrl(baseUrl: String) = baseUrl(JsonField.of(baseUrl))
 
             /**
@@ -346,7 +378,7 @@ private constructor(
             }
 
             /**
-             * Returns an immutable instance of [UnionMember1].
+             * Returns an immutable instance of [ModelConfigObject].
              *
              * Further updates to this [Builder] will not mutate the returned instance.
              *
@@ -357,8 +389,8 @@ private constructor(
              *
              * @throws IllegalStateException if any required field is unset.
              */
-            fun build(): UnionMember1 =
-                UnionMember1(
+            fun build(): ModelConfigObject =
+                ModelConfigObject(
                     checkRequired("modelName", modelName),
                     apiKey,
                     baseUrl,
@@ -368,7 +400,7 @@ private constructor(
 
         private var validated: Boolean = false
 
-        fun validate(): UnionMember1 = apply {
+        fun validate(): ModelConfigObject = apply {
             if (validated) {
                 return@apply
             }
@@ -404,7 +436,7 @@ private constructor(
                 return true
             }
 
-            return other is UnionMember1 &&
+            return other is ModelConfigObject &&
                 modelName == other.modelName &&
                 apiKey == other.apiKey &&
                 baseUrl == other.baseUrl &&
@@ -418,6 +450,6 @@ private constructor(
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "UnionMember1{modelName=$modelName, apiKey=$apiKey, baseUrl=$baseUrl, additionalProperties=$additionalProperties}"
+            "ModelConfigObject{modelName=$modelName, apiKey=$apiKey, baseUrl=$baseUrl, additionalProperties=$additionalProperties}"
     }
 }

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

@@ -1133,6 +1133,9 @@ private constructor(
         ) : this(model, timeout, variables, mutableMapOf())
 
         /**
+         * Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+         * 'anthropic/claude-4.5-opus')
+         *
          * @throws StagehandInvalidDataException if the JSON field has an unexpected type (e.g. if
          *   the server responded with an unexpected value).
          */
@@ -1211,6 +1214,10 @@ private constructor(
                 additionalProperties = options.additionalProperties.toMutableMap()
             }
 
+            /**
+             * Model name string with provider prefix (e.g., 'openai/gpt-5-nano',
+             * 'anthropic/claude-4.5-opus')
+             */
             fun model(model: ModelConfig) = model(JsonField.of(model))
 
             /**
@@ -1222,12 +1229,14 @@ private constructor(
              */
             fun model(model: JsonField<ModelConfig>) = apply { this.model = model }
 
-            /** Alias for calling [model] with `ModelConfig.ofString(string)`. */
-            fun model(string: String) = model(ModelConfig.ofString(string))
+            /** Alias for calling [model] with `ModelConfig.ofName(name)`. */
+            fun model(name: String) = model(ModelConfig.ofName(name))
 
-            /** Alias for calling [model] with `ModelConfig.ofUnionMember1(unionMember1)`. */
-            fun model(unionMember1: ModelConfig.UnionMember1) =
-                model(ModelConfig.ofUnionMember1(unionMember1))
+            /**
+             * Alias for calling [model] with `ModelConfig.ofModelConfigObject(modelConfigObject)`.
+             */
+            fun model(modelConfigObject: ModelConfig.ModelConfigObject) =
+                model(ModelConfig.ofModelConfigObject(modelConfigObject))
 
             /** Timeout in ms for the action */
             fun timeout(timeout: Double) = timeout(JsonField.of(timeout))