feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 104
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/langsmith%2Flangsmith-api-6486ec380bdcfba6a5cb648f420bb0ce1361f5ee235d15a4633d28a53bace251.yml
-openapi_spec_hash: 4d346676a84f01a09af53b083e152460
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/langsmith%2Flangsmith-api-5897df13cd2d3a65efc44052c7e2fe641bb8172660515fd0cabd250aafce94dd.yml
+openapi_spec_hash: 0b8c2dc1d007b2b331d2248fe6d3b0f4
 config_hash: 95f6a6cccc50b0e616468fc26d25b304

langsmith-java-core/src/main/kotlin/com/langchain/smith/models/annotationqueues/AnnotationQueueRetrieveSizeParams.kt

@@ -2,9 +2,13 @@
 
 package com.langchain.smith.models.annotationqueues
 
+import com.fasterxml.jackson.annotation.JsonCreator
+import com.langchain.smith.core.Enum
+import com.langchain.smith.core.JsonField
 import com.langchain.smith.core.Params
 import com.langchain.smith.core.http.Headers
 import com.langchain.smith.core.http.QueryParams
+import com.langchain.smith.errors.LangChainInvalidDataException
 import java.util.Objects
 import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
@@ -13,12 +17,15 @@ import kotlin.jvm.optionals.getOrNull
 class AnnotationQueueRetrieveSizeParams
 private constructor(
     private val queueId: String?,
+    private val status: Status?,
     private val additionalHeaders: Headers,
     private val additionalQueryParams: QueryParams,
 ) : Params {
 
     fun queueId(): Optional<String> = Optional.ofNullable(queueId)
 
+    fun status(): Optional<Status> = Optional.ofNullable(status)
+
     /** Additional headers to send with the request. */
     fun _additionalHeaders(): Headers = additionalHeaders
 
@@ -42,13 +49,15 @@ private constructor(
     class Builder internal constructor() {
 
         private var queueId: String? = null
+        private var status: Status? = null
         private var additionalHeaders: Headers.Builder = Headers.builder()
         private var additionalQueryParams: QueryParams.Builder = QueryParams.builder()
 
         @JvmSynthetic
         internal fun from(annotationQueueRetrieveSizeParams: AnnotationQueueRetrieveSizeParams) =
             apply {
                 queueId = annotationQueueRetrieveSizeParams.queueId
+                status = annotationQueueRetrieveSizeParams.status
                 additionalHeaders = annotationQueueRetrieveSizeParams.additionalHeaders.toBuilder()
                 additionalQueryParams =
                     annotationQueueRetrieveSizeParams.additionalQueryParams.toBuilder()
@@ -59,6 +68,11 @@ private constructor(
         /** Alias for calling [Builder.queueId] with `queueId.orElse(null)`. */
         fun queueId(queueId: Optional<String>) = queueId(queueId.getOrNull())
 
+        fun status(status: Status?) = apply { this.status = status }
+
+        /** Alias for calling [Builder.status] with `status.orElse(null)`. */
+        fun status(status: Optional<Status>) = status(status.getOrNull())
+
         fun additionalHeaders(additionalHeaders: Headers) = apply {
             this.additionalHeaders.clear()
             putAllAdditionalHeaders(additionalHeaders)
@@ -165,6 +179,7 @@ private constructor(
         fun build(): AnnotationQueueRetrieveSizeParams =
             AnnotationQueueRetrieveSizeParams(
                 queueId,
+                status,
                 additionalHeaders.build(),
                 additionalQueryParams.build(),
             )
@@ -178,7 +193,146 @@ private constructor(
 
     override fun _headers(): Headers = additionalHeaders
 
-    override fun _queryParams(): QueryParams = additionalQueryParams
+    override fun _queryParams(): QueryParams =
+        QueryParams.builder()
+            .apply {
+                status?.let { put("status", it.toString()) }
+                putAll(additionalQueryParams)
+            }
+            .build()
+
+    class Status @JsonCreator private constructor(private val value: JsonField<String>) : 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<String> = value
+
+        companion object {
+
+            @JvmField val NEEDS_MY_REVIEW = of("needs_my_review")
+
+            @JvmField val NEEDS_OTHERS_REVIEW = of("needs_others_review")
+
+            @JvmField val COMPLETED = of("completed")
+
+            @JvmStatic fun of(value: String) = Status(JsonField.of(value))
+        }
+
+        /** An enum containing [Status]'s known values. */
+        enum class Known {
+            NEEDS_MY_REVIEW,
+            NEEDS_OTHERS_REVIEW,
+            COMPLETED,
+        }
+
+        /**
+         * An enum containing [Status]'s known values, as well as an [_UNKNOWN] member.
+         *
+         * An instance of [Status] 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 {
+            NEEDS_MY_REVIEW,
+            NEEDS_OTHERS_REVIEW,
+            COMPLETED,
+            /** An enum member indicating that [Status] 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) {
+                NEEDS_MY_REVIEW -> Value.NEEDS_MY_REVIEW
+                NEEDS_OTHERS_REVIEW -> Value.NEEDS_OTHERS_REVIEW
+                COMPLETED -> Value.COMPLETED
+                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 LangChainInvalidDataException if this class instance's value is a not a known
+         *   member.
+         */
+        fun known(): Known =
+            when (this) {
+                NEEDS_MY_REVIEW -> Known.NEEDS_MY_REVIEW
+                NEEDS_OTHERS_REVIEW -> Known.NEEDS_OTHERS_REVIEW
+                COMPLETED -> Known.COMPLETED
+                else -> throw LangChainInvalidDataException("Unknown Status: $value")
+            }
+
+        /**
+         * Returns this class instance's primitive wire representation.
+         *
+         * This differs from the [toString] method because that method is primarily for debugging
+         * and generally doesn't throw.
+         *
+         * @throws LangChainInvalidDataException if this class instance's value does not have the
+         *   expected primitive type.
+         */
+        fun asString(): String =
+            _value().asString().orElseThrow {
+                LangChainInvalidDataException("Value is not a String")
+            }
+
+        private var validated: Boolean = false
+
+        fun validate(): Status = apply {
+            if (validated) {
+                return@apply
+            }
+
+            known()
+            validated = true
+        }
+
+        fun isValid(): Boolean =
+            try {
+                validate()
+                true
+            } catch (e: LangChainInvalidDataException) {
+                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 Status && value == other.value
+        }
+
+        override fun hashCode() = value.hashCode()
+
+        override fun toString() = value.toString()
+    }
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
@@ -187,12 +341,14 @@ private constructor(
 
         return other is AnnotationQueueRetrieveSizeParams &&
             queueId == other.queueId &&
+            status == other.status &&
             additionalHeaders == other.additionalHeaders &&
             additionalQueryParams == other.additionalQueryParams
     }
 
-    override fun hashCode(): Int = Objects.hash(queueId, additionalHeaders, additionalQueryParams)
+    override fun hashCode(): Int =
+        Objects.hash(queueId, status, additionalHeaders, additionalQueryParams)
 
     override fun toString() =
-        "AnnotationQueueRetrieveSizeParams{queueId=$queueId, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
+        "AnnotationQueueRetrieveSizeParams{queueId=$queueId, status=$status, additionalHeaders=$additionalHeaders, additionalQueryParams=$additionalQueryParams}"
 }