feat(api): api update

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 103
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/langsmith%2Flangsmith-api-c8cfbe86e6def6ed237572671330ab268d0f4482ca206d46523a504d5202c78a.yml
-openapi_spec_hash: e3c416da737cb6f4fb8945ca8010443d
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/langsmith%2Flangsmith-api-4d7b0427f9ed66e112fcc2f2a3a91e7f2c8113eb6386910c48b52ef7a605b282.yml
+openapi_spec_hash: 601517cba6d1a4f06c494f42f11e3f96
 config_hash: c217b34d458f1b65f260715693d447f9

langsmith-java-core/src/main/kotlin/com/langchain/smith/models/commits/CommitCreateParams.kt

@@ -36,6 +36,12 @@ private constructor(
 
     fun repo(): Optional<String> = Optional.ofNullable(repo)
 
+    /**
+     * @throws LangChainInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun description(): Optional<String> = body.description()
+
     /**
      * This arbitrary value can be deserialized into a custom type using the `convert` method:
      * ```java
@@ -61,6 +67,13 @@ private constructor(
      */
     fun _skipWebhooks(): JsonValue = body._skipWebhooks()
 
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    fun _description(): JsonField<String> = body._description()
+
     /**
      * Returns the raw JSON value of [parentCommit].
      *
@@ -121,12 +134,24 @@ private constructor(
          *
          * This is generally only useful if you are already constructing the body separately.
          * Otherwise, it's more convenient to use the top-level setters instead:
+         * - [description]
          * - [manifest]
          * - [parentCommit]
          * - [skipWebhooks]
          */
         fun body(body: Body) = apply { this.body = body.toBuilder() }
 
+        fun description(description: String) = apply { body.description(description) }
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { body.description(description) }
+
         fun manifest(manifest: JsonValue) = apply { body.manifest(manifest) }
 
         fun parentCommit(parentCommit: String) = apply { body.parentCommit(parentCommit) }
@@ -303,6 +328,7 @@ private constructor(
     class Body
     @JsonCreator(mode = JsonCreator.Mode.DISABLED)
     private constructor(
+        private val description: JsonField<String>,
         private val manifest: JsonValue,
         private val parentCommit: JsonField<String>,
         private val skipWebhooks: JsonValue,
@@ -311,14 +337,23 @@ private constructor(
 
         @JsonCreator
         private constructor(
+            @JsonProperty("description")
+            @ExcludeMissing
+            description: JsonField<String> = JsonMissing.of(),
             @JsonProperty("manifest") @ExcludeMissing manifest: JsonValue = JsonMissing.of(),
             @JsonProperty("parent_commit")
             @ExcludeMissing
             parentCommit: JsonField<String> = JsonMissing.of(),
             @JsonProperty("skip_webhooks")
             @ExcludeMissing
             skipWebhooks: JsonValue = JsonMissing.of(),
-        ) : this(manifest, parentCommit, skipWebhooks, mutableMapOf())
+        ) : this(description, manifest, parentCommit, skipWebhooks, mutableMapOf())
+
+        /**
+         * @throws LangChainInvalidDataException if the JSON field has an unexpected type (e.g. if
+         *   the server responded with an unexpected value).
+         */
+        fun description(): Optional<String> = description.getOptional("description")
 
         /**
          * This arbitrary value can be deserialized into a custom type using the `convert` method:
@@ -345,6 +380,15 @@ private constructor(
          */
         @JsonProperty("skip_webhooks") @ExcludeMissing fun _skipWebhooks(): JsonValue = skipWebhooks
 
+        /**
+         * Returns the raw JSON value of [description].
+         *
+         * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+         */
+        @JsonProperty("description")
+        @ExcludeMissing
+        fun _description(): JsonField<String> = description
+
         /**
          * Returns the raw JSON value of [parentCommit].
          *
@@ -376,19 +420,34 @@ private constructor(
         /** A builder for [Body]. */
         class Builder internal constructor() {
 
+            private var description: JsonField<String> = JsonMissing.of()
             private var manifest: JsonValue = JsonMissing.of()
             private var parentCommit: JsonField<String> = JsonMissing.of()
             private var skipWebhooks: JsonValue = JsonMissing.of()
             private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
             @JvmSynthetic
             internal fun from(body: Body) = apply {
+                description = body.description
                 manifest = body.manifest
                 parentCommit = body.parentCommit
                 skipWebhooks = body.skipWebhooks
                 additionalProperties = body.additionalProperties.toMutableMap()
             }
 
+            fun description(description: String) = description(JsonField.of(description))
+
+            /**
+             * Sets [Builder.description] to an arbitrary JSON value.
+             *
+             * You should usually call [Builder.description] with a well-typed [String] value
+             * instead. This method is primarily for setting the field to an undocumented or not yet
+             * supported value.
+             */
+            fun description(description: JsonField<String>) = apply {
+                this.description = description
+            }
+
             fun manifest(manifest: JsonValue) = apply { this.manifest = manifest }
 
             fun parentCommit(parentCommit: String) = parentCommit(JsonField.of(parentCommit))
@@ -435,7 +494,13 @@ private constructor(
              * Further updates to this [Builder] will not mutate the returned instance.
              */
             fun build(): Body =
-                Body(manifest, parentCommit, skipWebhooks, additionalProperties.toMutableMap())
+                Body(
+                    description,
+                    manifest,
+                    parentCommit,
+                    skipWebhooks,
+                    additionalProperties.toMutableMap(),
+                )
         }
 
         private var validated: Boolean = false
@@ -445,6 +510,7 @@ private constructor(
                 return@apply
             }
 
+            description()
             parentCommit()
             validated = true
         }
@@ -464,28 +530,31 @@ private constructor(
          * Used for best match union deserialization.
          */
         @JvmSynthetic
-        internal fun validity(): Int = (if (parentCommit.asKnown().isPresent) 1 else 0)
+        internal fun validity(): Int =
+            (if (description.asKnown().isPresent) 1 else 0) +
+                (if (parentCommit.asKnown().isPresent) 1 else 0)
 
         override fun equals(other: Any?): Boolean {
             if (this === other) {
                 return true
             }
 
             return other is Body &&
+                description == other.description &&
                 manifest == other.manifest &&
                 parentCommit == other.parentCommit &&
                 skipWebhooks == other.skipWebhooks &&
                 additionalProperties == other.additionalProperties
         }
 
         private val hashCode: Int by lazy {
-            Objects.hash(manifest, parentCommit, skipWebhooks, additionalProperties)
+            Objects.hash(description, manifest, parentCommit, skipWebhooks, additionalProperties)
         }
 
         override fun hashCode(): Int = hashCode
 
         override fun toString() =
-            "Body{manifest=$manifest, parentCommit=$parentCommit, skipWebhooks=$skipWebhooks, additionalProperties=$additionalProperties}"
+            "Body{description=$description, manifest=$manifest, parentCommit=$parentCommit, skipWebhooks=$skipWebhooks, additionalProperties=$additionalProperties}"
     }
 
     override fun equals(other: Any?): Boolean {

langsmith-java-core/src/main/kotlin/com/langchain/smith/models/commits/CommitRetrieveResponse.kt

@@ -22,6 +22,7 @@ class CommitRetrieveResponse
 @JsonCreator(mode = JsonCreator.Mode.DISABLED)
 private constructor(
     private val commitHash: JsonField<String>,
+    private val description: JsonField<String>,
     private val examples: JsonField<List<Example>>,
     private val isDraft: JsonField<Boolean>,
     private val manifest: JsonValue,
@@ -35,6 +36,9 @@ private constructor(
         @JsonProperty("commit_hash")
         @ExcludeMissing
         commitHash: JsonField<String> = JsonMissing.of(),
+        @JsonProperty("description")
+        @ExcludeMissing
+        description: JsonField<String> = JsonMissing.of(),
         @JsonProperty("examples")
         @ExcludeMissing
         examples: JsonField<List<Example>> = JsonMissing.of(),
@@ -44,14 +48,29 @@ private constructor(
         @JsonProperty("model_provider")
         @ExcludeMissing
         modelProvider: JsonField<String> = JsonMissing.of(),
-    ) : this(commitHash, examples, isDraft, manifest, modelConfig, modelProvider, mutableMapOf())
+    ) : this(
+        commitHash,
+        description,
+        examples,
+        isDraft,
+        manifest,
+        modelConfig,
+        modelProvider,
+        mutableMapOf(),
+    )
 
     /**
      * @throws LangChainInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
      */
     fun commitHash(): Optional<String> = commitHash.getOptional("commit_hash")
 
+    /**
+     * @throws LangChainInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun description(): Optional<String> = description.getOptional("description")
+
     /**
      * @throws LangChainInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -93,6 +112,13 @@ private constructor(
      */
     @JsonProperty("commit_hash") @ExcludeMissing fun _commitHash(): JsonField<String> = commitHash
 
+    /**
+     * Returns the raw JSON value of [description].
+     *
+     * Unlike [description], this method doesn't throw if the JSON field has an unexpected type.
+     */
+    @JsonProperty("description") @ExcludeMissing fun _description(): JsonField<String> = description
+
     /**
      * Returns the raw JSON value of [examples].
      *
@@ -138,6 +164,7 @@ private constructor(
     class Builder internal constructor() {
 
         private var commitHash: JsonField<String> = JsonMissing.of()
+        private var description: JsonField<String> = JsonMissing.of()
         private var examples: JsonField<MutableList<Example>>? = null
         private var isDraft: JsonField<Boolean> = JsonMissing.of()
         private var manifest: JsonValue = JsonMissing.of()
@@ -148,6 +175,7 @@ private constructor(
         @JvmSynthetic
         internal fun from(commitRetrieveResponse: CommitRetrieveResponse) = apply {
             commitHash = commitRetrieveResponse.commitHash
+            description = commitRetrieveResponse.description
             examples = commitRetrieveResponse.examples.map { it.toMutableList() }
             isDraft = commitRetrieveResponse.isDraft
             manifest = commitRetrieveResponse.manifest
@@ -167,6 +195,17 @@ private constructor(
          */
         fun commitHash(commitHash: JsonField<String>) = apply { this.commitHash = commitHash }
 
+        fun description(description: String) = description(JsonField.of(description))
+
+        /**
+         * Sets [Builder.description] to an arbitrary JSON value.
+         *
+         * You should usually call [Builder.description] with a well-typed [String] value instead.
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun description(description: JsonField<String>) = apply { this.description = description }
+
         fun examples(examples: List<Example>) = examples(JsonField.of(examples))
 
         /**
@@ -246,6 +285,7 @@ private constructor(
         fun build(): CommitRetrieveResponse =
             CommitRetrieveResponse(
                 commitHash,
+                description,
                 (examples ?: JsonMissing.of()).map { it.toImmutable() },
                 isDraft,
                 manifest,
@@ -263,6 +303,7 @@ private constructor(
         }
 
         commitHash()
+        description()
         examples().ifPresent { it.forEach { it.validate() } }
         isDraft()
         modelProvider()
@@ -285,6 +326,7 @@ private constructor(
     @JvmSynthetic
     internal fun validity(): Int =
         (if (commitHash.asKnown().isPresent) 1 else 0) +
+            (if (description.asKnown().isPresent) 1 else 0) +
             (examples.asKnown().getOrNull()?.sumOf { it.validity().toInt() } ?: 0) +
             (if (isDraft.asKnown().isPresent) 1 else 0) +
             (if (modelProvider.asKnown().isPresent) 1 else 0)
@@ -542,6 +584,7 @@ private constructor(
 
         return other is CommitRetrieveResponse &&
             commitHash == other.commitHash &&
+            description == other.description &&
             examples == other.examples &&
             isDraft == other.isDraft &&
             manifest == other.manifest &&
@@ -553,6 +596,7 @@ private constructor(
     private val hashCode: Int by lazy {
         Objects.hash(
             commitHash,
+            description,
             examples,
             isDraft,
             manifest,
@@ -565,5 +609,5 @@ private constructor(
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "CommitRetrieveResponse{commitHash=$commitHash, examples=$examples, isDraft=$isDraft, manifest=$manifest, modelConfig=$modelConfig, modelProvider=$modelProvider, additionalProperties=$additionalProperties}"
+        "CommitRetrieveResponse{commitHash=$commitHash, description=$description, examples=$examples, isDraft=$isDraft, manifest=$manifest, modelConfig=$modelConfig, modelProvider=$modelProvider, additionalProperties=$additionalProperties}"
 }