fix(api): add missing reasoning effort + model enums (#207)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 61
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai-fc5dbc19505b0035f9e7f88868619f4fb519b048bde011f6154f3132d4be71fb.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai-7c699d4503077d06a4a44f52c0c1f902d19a87c766b8be75b97c8dfd484ad4aa.yml

openai-java-core/src/main/kotlin/com/openai/models/BetaAssistantCreateParams.kt

@@ -189,7 +189,7 @@ private constructor(
     fun presencePenalty(): Optional<Double> = body.presencePenalty()
 
     /**
-     * **o1 models only**
+     * **o1 and o3-mini models only**
      *
      * Constrains effort on reasoning for
      * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported
@@ -438,7 +438,7 @@ private constructor(
     fun _presencePenalty(): JsonField<Double> = body._presencePenalty()
 
     /**
-     * **o1 models only**
+     * **o1 and o3-mini models only**
      *
      * Constrains effort on reasoning for
      * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported
@@ -801,7 +801,7 @@ private constructor(
             Optional.ofNullable(presencePenalty.getNullable("presence_penalty"))
 
         /**
-         * **o1 models only**
+         * **o1 and o3-mini models only**
          *
          * Constrains effort on reasoning for
          * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
@@ -1087,7 +1087,7 @@ private constructor(
         fun _presencePenalty(): JsonField<Double> = presencePenalty
 
         /**
-         * **o1 models only**
+         * **o1 and o3-mini models only**
          *
          * Constrains effort on reasoning for
          * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
@@ -2013,18 +2013,29 @@ private constructor(
             }
 
             /**
-             * **o1 models only**
+             * **o1 and o3-mini models only**
              *
              * Constrains effort on reasoning for
              * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
              * supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
              * result in faster responses and fewer tokens used on reasoning in a response.
              */
-            fun reasoningEffort(reasoningEffort: ChatCompletionReasoningEffort) =
-                reasoningEffort(JsonField.of(reasoningEffort))
+            fun reasoningEffort(reasoningEffort: ChatCompletionReasoningEffort?) =
+                reasoningEffort(JsonField.ofNullable(reasoningEffort))
 
             /**
-             * **o1 models only**
+             * **o1 and o3-mini models only**
+             *
+             * Constrains effort on reasoning for
+             * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+             * supported values are `low`, `medium`, and `high`. Reducing reasoning effort can
+             * result in faster responses and fewer tokens used on reasoning in a response.
+             */
+            fun reasoningEffort(reasoningEffort: Optional<ChatCompletionReasoningEffort>) =
+                reasoningEffort(reasoningEffort.orElse(null))
+
+            /**
+             * **o1 and o3-mini models only**
              *
              * Constrains effort on reasoning for
              * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
@@ -3175,19 +3186,30 @@ private constructor(
         }
 
         /**
-         * **o1 models only**
+         * **o1 and o3-mini models only**
          *
          * Constrains effort on reasoning for
          * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
          * supported values are `low`, `medium`, and `high`. Reducing reasoning effort can result in
          * faster responses and fewer tokens used on reasoning in a response.
          */
-        fun reasoningEffort(reasoningEffort: ChatCompletionReasoningEffort) = apply {
+        fun reasoningEffort(reasoningEffort: ChatCompletionReasoningEffort?) = apply {
             body.reasoningEffort(reasoningEffort)
         }
 
         /**
-         * **o1 models only**
+         * **o1 and o3-mini models only**
+         *
+         * Constrains effort on reasoning for
+         * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently
+         * supported values are `low`, `medium`, and `high`. Reducing reasoning effort can result in
+         * faster responses and fewer tokens used on reasoning in a response.
+         */
+        fun reasoningEffort(reasoningEffort: Optional<ChatCompletionReasoningEffort>) =
+            reasoningEffort(reasoningEffort.orElse(null))
+
+        /**
+         * **o1 and o3-mini models only**
          *
          * Constrains effort on reasoning for
          * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently

openai-java-core/src/main/kotlin/com/openai/models/BetaAssistantUpdateParams.kt

@@ -8,7 +8,7 @@ import com.openai.core.JsonField
 import com.openai.errors.OpenAIInvalidDataException
 
 /**
- * **o1 models only**
+ * **o1 and o3-mini models only**
  *
  * Constrains effort on reasoning for
  * [reasoning models](https://platform.openai.com/docs/guides/reasoning). Currently supported values

openai-java-core/src/main/kotlin/com/openai/models/BetaThreadRunCreateParams.kt

@@ -18,6 +18,7 @@ class BetaAssistantCreateParamsTest {
                 Metadata.builder().putAdditionalProperty("foo", JsonValue.from("string")).build()
             )
             .name("name")
+            .reasoningEffort(BetaAssistantCreateParams.ReasoningEffort.LOW)
             .responseFormatAuto()
             .temperature(1.0)
             .toolResources(
@@ -66,6 +67,7 @@ class BetaAssistantCreateParamsTest {
                         .build()
                 )
                 .name("name")
+                .reasoningEffort(BetaAssistantCreateParams.ReasoningEffort.LOW)
                 .responseFormatAuto()
                 .temperature(1.0)
                 .toolResources(
@@ -112,6 +114,7 @@ class BetaAssistantCreateParamsTest {
                 Metadata.builder().putAdditionalProperty("foo", JsonValue.from("string")).build()
             )
         assertThat(body.name()).contains("name")
+        assertThat(body.reasoningEffort()).contains(BetaAssistantCreateParams.ReasoningEffort.LOW)
         assertThat(body.responseFormat()).contains(AssistantResponseFormatOption.ofAuto())
         assertThat(body.temperature()).contains(1.0)
         assertThat(body.toolResources())

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

@@ -17,8 +17,9 @@ class BetaAssistantUpdateParamsTest {
             .metadata(
                 Metadata.builder().putAdditionalProperty("foo", JsonValue.from("string")).build()
             )
-            .model("model")
+            .model(BetaAssistantUpdateParams.Model.O3_MINI)
             .name("name")
+            .reasoningEffort(BetaAssistantUpdateParams.ReasoningEffort.LOW)
             .responseFormatAuto()
             .temperature(1.0)
             .toolResources(
@@ -52,8 +53,9 @@ class BetaAssistantUpdateParamsTest {
                         .putAdditionalProperty("foo", JsonValue.from("string"))
                         .build()
                 )
-                .model("model")
+                .model(BetaAssistantUpdateParams.Model.O3_MINI)
                 .name("name")
+                .reasoningEffort(BetaAssistantUpdateParams.ReasoningEffort.LOW)
                 .responseFormatAuto()
                 .temperature(1.0)
                 .toolResources(
@@ -81,8 +83,9 @@ class BetaAssistantUpdateParamsTest {
             .contains(
                 Metadata.builder().putAdditionalProperty("foo", JsonValue.from("string")).build()
             )
-        assertThat(body.model()).contains("model")
+        assertThat(body.model()).contains(BetaAssistantUpdateParams.Model.O3_MINI)
         assertThat(body.name()).contains("name")
+        assertThat(body.reasoningEffort()).contains(BetaAssistantUpdateParams.ReasoningEffort.LOW)
         assertThat(body.responseFormat()).contains(AssistantResponseFormatOption.ofAuto())
         assertThat(body.temperature()).contains(1.0)
         assertThat(body.toolResources())

openai-java-core/src/main/kotlin/com/openai/models/ChatCompletionReasoningEffort.kt

@@ -41,6 +41,7 @@ class BetaThreadRunCreateParamsTest {
             )
             .model(ChatModel.O3_MINI)
             .parallelToolCalls(true)
+            .reasoningEffort(BetaThreadRunCreateParams.ReasoningEffort.LOW)
             .responseFormatAuto()
             .temperature(1.0)
             .toolChoice(AssistantToolChoiceOption.Auto.NONE)
@@ -90,6 +91,7 @@ class BetaThreadRunCreateParamsTest {
                 )
                 .model(ChatModel.O3_MINI)
                 .parallelToolCalls(true)
+                .reasoningEffort(BetaThreadRunCreateParams.ReasoningEffort.LOW)
                 .responseFormatAuto()
                 .temperature(1.0)
                 .toolChoice(AssistantToolChoiceOption.Auto.NONE)
@@ -156,6 +158,7 @@ class BetaThreadRunCreateParamsTest {
                 )
                 .model(ChatModel.O3_MINI)
                 .parallelToolCalls(true)
+                .reasoningEffort(BetaThreadRunCreateParams.ReasoningEffort.LOW)
                 .responseFormatAuto()
                 .temperature(1.0)
                 .toolChoice(AssistantToolChoiceOption.Auto.NONE)
@@ -201,6 +204,7 @@ class BetaThreadRunCreateParamsTest {
             )
         assertThat(body.model()).contains(ChatModel.O3_MINI)
         assertThat(body.parallelToolCalls()).contains(true)
+        assertThat(body.reasoningEffort()).contains(BetaThreadRunCreateParams.ReasoningEffort.LOW)
         assertThat(body.responseFormat()).contains(AssistantResponseFormatOption.ofAuto())
         assertThat(body.temperature()).contains(1.0)
         assertThat(body.toolChoice())

openai-java-core/src/test/kotlin/com/openai/models/BetaAssistantCreateParamsTest.kt

@@ -40,6 +40,7 @@ class AssistantServiceTest {
                             .build()
                     )
                     .name("name")
+                    .reasoningEffort(BetaAssistantCreateParams.ReasoningEffort.LOW)
                     .responseFormatAuto()
                     .temperature(1.0)
                     .toolResources(
@@ -117,8 +118,9 @@ class AssistantServiceTest {
                             .putAdditionalProperty("foo", JsonValue.from("string"))
                             .build()
                     )
-                    .model("model")
+                    .model(BetaAssistantUpdateParams.Model.O3_MINI)
                     .name("name")
+                    .reasoningEffort(BetaAssistantUpdateParams.ReasoningEffort.LOW)
                     .responseFormatAuto()
                     .temperature(1.0)
                     .toolResources(