chore(api): specification cleanup

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 88
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-2d116cda53321baa3479e628512def723207a81eb1cdaebb542bd0555e563bda.yml
-openapi_spec_hash: 809d958fec261a32004a4b026b718793
-config_hash: 5ef02e55671aae1ba9bd62fe4eb0f50f
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-de3e91790d0b9f3ce26d679ac07079880ccc695bd8c878f961c4d577a5025a2e.yml
+openapi_spec_hash: 4b44e3f287583d01fbe7b10cd943254a
+config_hash: 06b9a88561844d60d8efa4eaabf5fa3c

openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt

@@ -813,6 +813,39 @@ private constructor(
         /** Alias for calling [addMessage] with `assistant.toParam()`. */
         fun addMessage(assistant: ChatCompletionMessage) = apply { body.addMessage(assistant) }
 
+        /**
+         * Alias for calling [addMessage] with the following:
+         * ```java
+         * ChatCompletionAssistantMessageParam.builder()
+         *     .content(content)
+         *     .build()
+         * ```
+         */
+        fun addAssistantMessage(content: ChatCompletionAssistantMessageParam.Content?) = apply {
+            body.addAssistantMessage(content)
+        }
+
+        /** Alias for calling [addAssistantMessage] with `content.orElse(null)`. */
+        fun addAssistantMessage(content: Optional<ChatCompletionAssistantMessageParam.Content>) =
+            addAssistantMessage(content.getOrNull())
+
+        /**
+         * Alias for calling [addAssistantMessage] with
+         * `ChatCompletionAssistantMessageParam.Content.ofText(text)`.
+         */
+        fun addAssistantMessage(text: String) = apply { body.addAssistantMessage(text) }
+
+        /**
+         * Alias for calling [addAssistantMessage] with
+         * `ChatCompletionAssistantMessageParam.Content.ofArrayOfContentParts(arrayOfContentParts)`.
+         */
+        fun addAssistantMessageOfArrayOfContentParts(
+            arrayOfContentParts:
+                List<
+                    ChatCompletionAssistantMessageParam.Content.ChatCompletionRequestAssistantMessageContentPart
+                >
+        ) = apply { body.addAssistantMessageOfArrayOfContentParts(arrayOfContentParts) }
+
         /** Alias for calling [addMessage] with `ChatCompletionMessageParam.ofTool(tool)`. */
         fun addMessage(tool: ChatCompletionToolMessageParam) = apply { body.addMessage(tool) }
 
@@ -2816,6 +2849,45 @@ private constructor(
             /** Alias for calling [addMessage] with `assistant.toParam()`. */
             fun addMessage(assistant: ChatCompletionMessage) = addMessage(assistant.toParam())
 
+            /**
+             * Alias for calling [addMessage] with the following:
+             * ```java
+             * ChatCompletionAssistantMessageParam.builder()
+             *     .content(content)
+             *     .build()
+             * ```
+             */
+            fun addAssistantMessage(content: ChatCompletionAssistantMessageParam.Content?) =
+                addMessage(ChatCompletionAssistantMessageParam.builder().content(content).build())
+
+            /** Alias for calling [addAssistantMessage] with `content.orElse(null)`. */
+            fun addAssistantMessage(
+                content: Optional<ChatCompletionAssistantMessageParam.Content>
+            ) = addAssistantMessage(content.getOrNull())
+
+            /**
+             * Alias for calling [addAssistantMessage] with
+             * `ChatCompletionAssistantMessageParam.Content.ofText(text)`.
+             */
+            fun addAssistantMessage(text: String) =
+                addAssistantMessage(ChatCompletionAssistantMessageParam.Content.ofText(text))
+
+            /**
+             * Alias for calling [addAssistantMessage] with
+             * `ChatCompletionAssistantMessageParam.Content.ofArrayOfContentParts(arrayOfContentParts)`.
+             */
+            fun addAssistantMessageOfArrayOfContentParts(
+                arrayOfContentParts:
+                    List<
+                        ChatCompletionAssistantMessageParam.Content.ChatCompletionRequestAssistantMessageContentPart
+                    >
+            ) =
+                addAssistantMessage(
+                    ChatCompletionAssistantMessageParam.Content.ofArrayOfContentParts(
+                        arrayOfContentParts
+                    )
+                )
+
             /** Alias for calling [addMessage] with `ChatCompletionMessageParam.ofTool(tool)`. */
             fun addMessage(tool: ChatCompletionToolMessageParam) =
                 addMessage(ChatCompletionMessageParam.ofTool(tool))

openai-java-core/src/main/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParams.kt

@@ -139,6 +139,28 @@ internal constructor(
             paramsBuilder.addMessage(assistant)
         }
 
+        /** @see ChatCompletionCreateParams.Builder.addAssistantMessage */
+        fun addAssistantMessage(content: ChatCompletionAssistantMessageParam.Content?) = apply {
+            paramsBuilder.addAssistantMessage(content)
+        }
+
+        /** @see ChatCompletionCreateParams.Builder.addAssistantMessage */
+        fun addAssistantMessage(content: Optional<ChatCompletionAssistantMessageParam.Content>) =
+            apply {
+                paramsBuilder.addAssistantMessage(content)
+            }
+
+        /** @see ChatCompletionCreateParams.Builder.addAssistantMessage */
+        fun addAssistantMessage(text: String) = apply { paramsBuilder.addAssistantMessage(text) }
+
+        /** @see ChatCompletionCreateParams.Builder.addAssistantMessageOfArrayOfContentParts */
+        fun addAssistantMessageOfArrayOfContentParts(
+            arrayOfContentParts:
+                List<
+                    ChatCompletionAssistantMessageParam.Content.ChatCompletionRequestAssistantMessageContentPart
+                >
+        ) = apply { paramsBuilder.addAssistantMessageOfArrayOfContentParts(arrayOfContentParts) }
+
         /** @see ChatCompletionCreateParams.Builder.addMessage */
         fun addMessage(tool: ChatCompletionToolMessageParam) = apply {
             paramsBuilder.addMessage(tool)

openai-java-core/src/test/kotlin/com/openai/models/chat/completions/StructuredChatCompletionCreateParamsTest.kt

@@ -68,6 +68,9 @@ internal class StructuredChatCompletionCreateParamsTest {
             ChatCompletionFunctionMessageParam.builder().content(STRING).name(STRING).build()
         private val MESSAGE_PARAM = ChatCompletionMessageParam.ofUser(USER_MESSAGE_PARAM)
 
+        private val ASSISTANT_MESSAGE_PARAM_CONTENT =
+            ChatCompletionAssistantMessageParam.Content.ofText(STRING)
+
         private val DEV_MESSAGE_PARAM_CONTENT =
             ChatCompletionDeveloperMessageParam.Content.ofText(STRING)
         private val SYS_MESSAGE_PARAM_CONTENT =
@@ -119,6 +122,10 @@ internal class StructuredChatCompletionCreateParamsTest {
                 DelegationWriteTestCase("messages", JSON_FIELD),
                 DelegationWriteTestCase("addMessage", MESSAGE_PARAM),
                 DelegationWriteTestCase("addMessage", DEV_MESSAGE_PARAM),
+                DelegationWriteTestCase("addAssistantMessage", ASSISTANT_MESSAGE_PARAM_CONTENT),
+                DelegationWriteTestCase("addAssistantMessage", OPTIONAL),
+                DelegationWriteTestCase("addAssistantMessage", STRING),
+                DelegationWriteTestCase("addAssistantMessageOfArrayOfContentParts", LIST),
                 DelegationWriteTestCase("addDeveloperMessage", DEV_MESSAGE_PARAM_CONTENT),
                 DelegationWriteTestCase("addDeveloperMessage", STRING),
                 DelegationWriteTestCase("addDeveloperMessageOfArrayOfContentParts", LIST),