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-e6a9dca1a93568e403ac72128d86f30c8c3f1336d4b67017d7e61b1836f10f47.yml
-openapi_spec_hash: ef01e0649bb0e283df0aa81c369649df
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-d571232203ef4e00986a3245224267db6f8aaffdad57780f712e0694dc8d9e37.yml
+openapi_spec_hash: d5d635dd7b24a2e1255c6f2a895253ff
 config_hash: 88e87ba7021be93d267ecfc8f5e6b891

buildSrc/src/main/kotlin/stagehand.publish.gradle.kts

@@ -10,7 +10,7 @@ configure<PublishingExtension> {
 
             pom {
                 name.set("Stagehand API")
-                description.set("Stagehand SDK for AI browser automation [ALPHA].")
+                description.set("Stagehand SDK for AI browser automation [ALPHA]. This API allows clients to\nexecute browser automation tasks remotely on the Browserbase cloud.\n\nAll endpoints except /sessions/start require an active session ID. Responses are\nstreamed using Server-Sent Events (SSE) when the `x-stream-response: true`\nheader is provided.\n\nThis SDK is currently ALPHA software and is not production ready! Please try it\nand give us your feedback, stay tuned for upcoming release announcements!")
                 url.set("https://docs.stagehand.dev")
 
                 licenses {

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

@@ -2,7 +2,6 @@
 
 package com.browserbase.api.models.sessions
 
-import com.browserbase.api.core.Enum
 import com.browserbase.api.core.ExcludeMissing
 import com.browserbase.api.core.JsonField
 import com.browserbase.api.core.JsonMissing
@@ -24,14 +23,14 @@ class SessionActResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val data: JsonField<Data>,
-    private val success: JsonField<Success>,
+    private val success: JsonField<Boolean>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
         @JsonProperty("data") @ExcludeMissing data: JsonField<Data> = JsonMissing.of(),
-        @JsonProperty("success") @ExcludeMissing success: JsonField<Success> = JsonMissing.of(),
+        @JsonProperty("success") @ExcludeMissing success: JsonField<Boolean> = JsonMissing.of(),
     ) : this(data, success, mutableMapOf())
 
     /**
@@ -41,10 +40,12 @@ private constructor(
     fun data(): Data = data.getRequired("data")
 
     /**
+     * Indicates whether the request was successful
+     *
      * @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 success(): Success = success.getRequired("success")
+    fun success(): Boolean = success.getRequired("success")
 
     /**
      * Returns the raw JSON value of [data].
@@ -58,7 +59,7 @@ private constructor(
      *
      * Unlike [success], this method doesn't throw if the JSON field has an unexpected type.
      */
-    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Success> = success
+    @JsonProperty("success") @ExcludeMissing fun _success(): JsonField<Boolean> = success
 
     @JsonAnySetter
     private fun putAdditionalProperty(key: String, value: JsonValue) {
@@ -90,7 +91,7 @@ private constructor(
     class Builder internal constructor() {
 
         private var data: JsonField<Data>? = null
-        private var success: JsonField<Success>? = null
+        private var success: JsonField<Boolean>? = null
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
@@ -110,15 +111,16 @@ private constructor(
          */
         fun data(data: JsonField<Data>) = apply { this.data = data }
 
-        fun success(success: Success) = success(JsonField.of(success))
+        /** Indicates whether the request was successful */
+        fun success(success: Boolean) = success(JsonField.of(success))
 
         /**
          * Sets [Builder.success] to an arbitrary JSON value.
          *
-         * You should usually call [Builder.success] with a well-typed [Success] value instead. This
+         * You should usually call [Builder.success] with a well-typed [Boolean] value instead. This
          * method is primarily for setting the field to an undocumented or not yet supported value.
          */
-        fun success(success: JsonField<Success>) = apply { this.success = success }
+        fun success(success: JsonField<Boolean>) = apply { this.success = success }
 
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
@@ -168,7 +170,7 @@ private constructor(
         }
 
         data().validate()
-        success().validate()
+        success()
         validated = true
     }
 
@@ -187,8 +189,7 @@ private constructor(
      */
     @JvmSynthetic
     internal fun validity(): Int =
-        (data.asKnown().getOrNull()?.validity() ?: 0) +
-            (success.asKnown().getOrNull()?.validity() ?: 0)
+        (data.asKnown().getOrNull()?.validity() ?: 0) + (if (success.asKnown().isPresent) 1 else 0)
 
     class Data
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
@@ -690,124 +691,6 @@ private constructor(
             "Data{result=$result, actionId=$actionId, additionalProperties=$additionalProperties}"
     }
 
-    class Success @JsonCreator private constructor(private val value: JsonField<Boolean>) : Enum {
-
-        /**
-         * Returns this class instance's raw value.
-         *
-         * This is usually only useful if this instance was deserialized from data that doesn't
-         * match any known member, and you want to know that value. For example, if the SDK is on an
-         * older version than the API, then the API may respond with new members that the SDK is
-         * unaware of.
-         */
-        @com.fasterxml.jackson.annotation.JsonValue fun _value(): JsonField<Boolean> = value
-
-        companion object {
-
-            @JvmField val TRUE = of(true)
-
-            @JvmStatic fun of(value: Boolean) = Success(JsonField.of(value))
-        }
-
-        /** An enum containing [Success]'s known values. */
-        enum class Known {
-            TRUE
-        }
-
-        /**
-         * An enum containing [Success]'s known values, as well as an [_UNKNOWN] member.
-         *
-         * An instance of [Success] can contain an unknown value in a couple of cases:
-         * - It was deserialized from data that doesn't match any known member. For example, if the
-         *   SDK is on an older version than the API, then the API may respond with new members that
-         *   the SDK is unaware of.
-         * - It was constructed with an arbitrary value using the [of] method.
-         */
-        enum class Value {
-            TRUE,
-            /** An enum member indicating that [Success] was instantiated with an unknown value. */
-            _UNKNOWN,
-        }
-
-        /**
-         * Returns an enum member corresponding to this class instance's value, or [Value._UNKNOWN]
-         * if the class was instantiated with an unknown value.
-         *
-         * Use the [known] method instead if you're certain the value is always known or if you want
-         * to throw for the unknown case.
-         */
-        fun value(): Value =
-            when (this) {
-                TRUE -> Value.TRUE
-                else -> Value._UNKNOWN
-            }
-
-        /**
-         * Returns an enum member corresponding to this class instance's value.
-         *
-         * Use the [value] method instead if you're uncertain the value is always known and don't
-         * want to throw for the unknown case.
-         *
-         * @throws StagehandInvalidDataException if this class instance's value is a not a known
-         *   member.
-         */
-        fun known(): Known =
-            when (this) {
-                TRUE -> Known.TRUE
-                else -> throw StagehandInvalidDataException("Unknown Success: $value")
-            }
-
-        /**
-         * Returns this class instance's primitive wire representation.
-         *
-         * @throws StagehandInvalidDataException if this class instance's value does not have the
-         *   expected primitive type.
-         */
-        fun asBoolean(): Boolean =
-            _value().asBoolean().orElseThrow {
-                StagehandInvalidDataException("Value is not a Boolean")
-            }
-
-        private var validated: Boolean = false
-
-        fun validate(): Success = apply {
-            if (validated) {
-                return@apply
-            }
-
-            known()
-            validated = true
-        }
-
-        fun isValid(): Boolean =
-            try {
-                validate()
-                true
-            } catch (e: StagehandInvalidDataException) {
-                false
-            }
-
-        /**
-         * Returns a score indicating how many valid values are contained in this object
-         * recursively.
-         *
-         * Used for best match union deserialization.
-         */
-        @JvmSynthetic internal fun validity(): Int = if (value() == Value._UNKNOWN) 0 else 1
-
-        override fun equals(other: Any?): Boolean {
-            if (this === other) {
-                return true
-            }
-
-            return other is Success && value == other.value
-        }
-
-        override fun hashCode() = value.hashCode()
-
-        override fun toString() = value.toString()
-    }
-
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true