chore(api): update realtime specs, build config

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-de3e91790d0b9f3ce26d679ac07079880ccc695bd8c878f961c4d577a5025a2e.yml
-openapi_spec_hash: 4b44e3f287583d01fbe7b10cd943254a
-config_hash: cc92d0be2a0f3c77bfc988082dd0573e
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-82fd6fcb3eea81cbbe09a6f831c82219f1251e1b76474b4c41f424bf277e6a71.yml
+openapi_spec_hash: c8d54bd1ae3d704f6b6f72ffd2f876d8
+config_hash: 3315d58b60faf63b1bee251b81837cda

openai-java-core/src/main/kotlin/com/openai/models/beta/realtime/ConversationItem.kt

@@ -135,8 +135,9 @@ private constructor(
     fun role(): Optional<Role> = role.getOptional("role")
 
     /**
-     * The status of the item (`completed`, `incomplete`). These have no effect on the conversation,
-     * but are accepted for consistency with the `conversation.item.created` event.
+     * The status of the item (`completed`, `incomplete`, `in_progress`). These have no effect on
+     * the conversation, but are accepted for consistency with the `conversation.item.created`
+     * event.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -391,9 +392,9 @@ private constructor(
         fun role(role: JsonField<Role>) = apply { this.role = role }
 
         /**
-         * The status of the item (`completed`, `incomplete`). These have no effect on the
-         * conversation, but are accepted for consistency with the `conversation.item.created`
-         * event.
+         * The status of the item (`completed`, `incomplete`, `in_progress`). These have no effect
+         * on the conversation, but are accepted for consistency with the
+         * `conversation.item.created` event.
          */
         fun status(status: Status) = status(JsonField.of(status))
 
@@ -758,8 +759,9 @@ private constructor(
     }
 
     /**
-     * The status of the item (`completed`, `incomplete`). These have no effect on the conversation,
-     * but are accepted for consistency with the `conversation.item.created` event.
+     * The status of the item (`completed`, `incomplete`, `in_progress`). These have no effect on
+     * the conversation, but are accepted for consistency with the `conversation.item.created`
+     * event.
      */
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
@@ -779,13 +781,16 @@ private constructor(
 
             @JvmField val INCOMPLETE = of("incomplete")
 
+            @JvmField val IN_PROGRESS = of("in_progress")
+
             @JvmStatic fun of(value: String) = Status(JsonField.of(value))
         }
 
         /** An enum containing [Status]'s known values. */
         enum class Known {
             COMPLETED,
             INCOMPLETE,
+            IN_PROGRESS,
         }
 
         /**
@@ -800,6 +805,7 @@ private constructor(
         enum class Value {
             COMPLETED,
             INCOMPLETE,
+            IN_PROGRESS,
             /** An enum member indicating that [Status] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -815,6 +821,7 @@ private constructor(
             when (this) {
                 COMPLETED -> Value.COMPLETED
                 INCOMPLETE -> Value.INCOMPLETE
+                IN_PROGRESS -> Value.IN_PROGRESS
                 else -> Value._UNKNOWN
             }
 
@@ -831,6 +838,7 @@ private constructor(
             when (this) {
                 COMPLETED -> Known.COMPLETED
                 INCOMPLETE -> Known.INCOMPLETE
+                IN_PROGRESS -> Known.IN_PROGRESS
                 else -> throw OpenAIInvalidDataException("Unknown Status: $value")
             }
 

openai-java-core/src/main/kotlin/com/openai/models/beta/realtime/ConversationItemCreatedEvent.kt

@@ -14,6 +14,7 @@ import com.openai.core.checkRequired
 import com.openai.errors.OpenAIInvalidDataException
 import java.util.Collections
 import java.util.Objects
+import java.util.Optional
 import kotlin.jvm.optionals.getOrNull
 
 /**
@@ -30,20 +31,20 @@ class ConversationItemCreatedEvent
 private constructor(
     private val eventId: JsonField<String>,
     private val item: JsonField<ConversationItem>,
-    private val previousItemId: JsonField<String>,
     private val type: JsonValue,
+    private val previousItemId: JsonField<String>,
     private val additionalProperties: MutableMap<String, JsonValue>,
 ) {
 
     @JsonCreator
     private constructor(
         @JsonProperty("event_id") @ExcludeMissing eventId: JsonField<String> = JsonMissing.of(),
         @JsonProperty("item") @ExcludeMissing item: JsonField<ConversationItem> = JsonMissing.of(),
+        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
         @JsonProperty("previous_item_id")
         @ExcludeMissing
         previousItemId: JsonField<String> = JsonMissing.of(),
-        @JsonProperty("type") @ExcludeMissing type: JsonValue = JsonMissing.of(),
-    ) : this(eventId, item, previousItemId, type, mutableMapOf())
+    ) : this(eventId, item, type, previousItemId, mutableMapOf())
 
     /**
      * The unique ID of the server event.
@@ -61,15 +62,6 @@ private constructor(
      */
     fun item(): ConversationItem = item.getRequired("item")
 
-    /**
-     * The ID of the preceding item in the Conversation context, allows the client to understand the
-     * order of the conversation.
-     *
-     * @throws OpenAIInvalidDataException 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 previousItemId(): String = previousItemId.getRequired("previous_item_id")
-
     /**
      * The event type, must be `conversation.item.created`.
      *
@@ -83,6 +75,15 @@ private constructor(
      */
     @JsonProperty("type") @ExcludeMissing fun _type(): JsonValue = type
 
+    /**
+     * The ID of the preceding item in the Conversation context, allows the client to understand the
+     * order of the conversation. Can be `null` if the item has no predecessor.
+     *
+     * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
+     *   server responded with an unexpected value).
+     */
+    fun previousItemId(): Optional<String> = previousItemId.getOptional("previous_item_id")
+
     /**
      * Returns the raw JSON value of [eventId].
      *
@@ -127,7 +128,6 @@ private constructor(
          * ```java
          * .eventId()
          * .item()
-         * .previousItemId()
          * ```
          */
         @JvmStatic fun builder() = Builder()
@@ -138,16 +138,16 @@ private constructor(
 
         private var eventId: JsonField<String>? = null
         private var item: JsonField<ConversationItem>? = null
-        private var previousItemId: JsonField<String>? = null
         private var type: JsonValue = JsonValue.from("conversation.item.created")
+        private var previousItemId: JsonField<String> = JsonMissing.of()
         private var additionalProperties: MutableMap<String, JsonValue> = mutableMapOf()
 
         @JvmSynthetic
         internal fun from(conversationItemCreatedEvent: ConversationItemCreatedEvent) = apply {
             eventId = conversationItemCreatedEvent.eventId
             item = conversationItemCreatedEvent.item
-            previousItemId = conversationItemCreatedEvent.previousItemId
             type = conversationItemCreatedEvent.type
+            previousItemId = conversationItemCreatedEvent.previousItemId
             additionalProperties = conversationItemCreatedEvent.additionalProperties.toMutableMap()
         }
 
@@ -174,11 +174,30 @@ private constructor(
          */
         fun item(item: JsonField<ConversationItem>) = apply { this.item = item }
 
+        /**
+         * Sets the field to an arbitrary JSON value.
+         *
+         * It is usually unnecessary to call this method because the field defaults to the
+         * following:
+         * ```java
+         * JsonValue.from("conversation.item.created")
+         * ```
+         *
+         * This method is primarily for setting the field to an undocumented or not yet supported
+         * value.
+         */
+        fun type(type: JsonValue) = apply { this.type = type }
+
         /**
          * The ID of the preceding item in the Conversation context, allows the client to understand
-         * the order of the conversation.
+         * the order of the conversation. Can be `null` if the item has no predecessor.
          */
-        fun previousItemId(previousItemId: String) = previousItemId(JsonField.of(previousItemId))
+        fun previousItemId(previousItemId: String?) =
+            previousItemId(JsonField.ofNullable(previousItemId))
+
+        /** Alias for calling [Builder.previousItemId] with `previousItemId.orElse(null)`. */
+        fun previousItemId(previousItemId: Optional<String>) =
+            previousItemId(previousItemId.getOrNull())
 
         /**
          * Sets [Builder.previousItemId] to an arbitrary JSON value.
@@ -191,20 +210,6 @@ private constructor(
             this.previousItemId = previousItemId
         }
 
-        /**
-         * Sets the field to an arbitrary JSON value.
-         *
-         * It is usually unnecessary to call this method because the field defaults to the
-         * following:
-         * ```java
-         * JsonValue.from("conversation.item.created")
-         * ```
-         *
-         * This method is primarily for setting the field to an undocumented or not yet supported
-         * value.
-         */
-        fun type(type: JsonValue) = apply { this.type = type }
-
         fun additionalProperties(additionalProperties: Map<String, JsonValue>) = apply {
             this.additionalProperties.clear()
             putAllAdditionalProperties(additionalProperties)
@@ -233,7 +238,6 @@ private constructor(
          * ```java
          * .eventId()
          * .item()
-         * .previousItemId()
          * ```
          *
          * @throws IllegalStateException if any required field is unset.
@@ -242,8 +246,8 @@ private constructor(
             ConversationItemCreatedEvent(
                 checkRequired("eventId", eventId),
                 checkRequired("item", item),
-                checkRequired("previousItemId", previousItemId),
                 type,
+                previousItemId,
                 additionalProperties.toMutableMap(),
             )
     }
@@ -257,12 +261,12 @@ private constructor(
 
         eventId()
         item().validate()
-        previousItemId()
         _type().let {
             if (it != JsonValue.from("conversation.item.created")) {
                 throw OpenAIInvalidDataException("'type' is invalid, received $it")
             }
         }
+        previousItemId()
         validated = true
     }
 
@@ -283,23 +287,23 @@ private constructor(
     internal fun validity(): Int =
         (if (eventId.asKnown().isPresent) 1 else 0) +
             (item.asKnown().getOrNull()?.validity() ?: 0) +
-            (if (previousItemId.asKnown().isPresent) 1 else 0) +
-            type.let { if (it == JsonValue.from("conversation.item.created")) 1 else 0 }
+            type.let { if (it == JsonValue.from("conversation.item.created")) 1 else 0 } +
+            (if (previousItemId.asKnown().isPresent) 1 else 0)
 
     override fun equals(other: Any?): Boolean {
         if (this === other) {
             return true
         }
 
-        return /* spotless:off */ other is ConversationItemCreatedEvent && eventId == other.eventId && item == other.item && previousItemId == other.previousItemId && type == other.type && additionalProperties == other.additionalProperties /* spotless:on */
+        return /* spotless:off */ other is ConversationItemCreatedEvent && eventId == other.eventId && item == other.item && type == other.type && previousItemId == other.previousItemId && additionalProperties == other.additionalProperties /* spotless:on */
     }
 
     /* spotless:off */
-    private val hashCode: Int by lazy { Objects.hash(eventId, item, previousItemId, type, additionalProperties) }
+    private val hashCode: Int by lazy { Objects.hash(eventId, item, type, previousItemId, additionalProperties) }
     /* spotless:on */
 
     override fun hashCode(): Int = hashCode
 
     override fun toString() =
-        "ConversationItemCreatedEvent{eventId=$eventId, item=$item, previousItemId=$previousItemId, type=$type, additionalProperties=$additionalProperties}"
+        "ConversationItemCreatedEvent{eventId=$eventId, item=$item, type=$type, previousItemId=$previousItemId, additionalProperties=$additionalProperties}"
 }

openai-java-core/src/main/kotlin/com/openai/models/beta/realtime/ConversationItemWithReference.kt

@@ -139,8 +139,9 @@ private constructor(
     fun role(): Optional<Role> = role.getOptional("role")
 
     /**
-     * The status of the item (`completed`, `incomplete`). These have no effect on the conversation,
-     * but are accepted for consistency with the `conversation.item.created` event.
+     * The status of the item (`completed`, `incomplete`, `in_progress`). These have no effect on
+     * the conversation, but are accepted for consistency with the `conversation.item.created`
+     * event.
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
      *   server responded with an unexpected value).
@@ -402,9 +403,9 @@ private constructor(
         fun role(role: JsonField<Role>) = apply { this.role = role }
 
         /**
-         * The status of the item (`completed`, `incomplete`). These have no effect on the
-         * conversation, but are accepted for consistency with the `conversation.item.created`
-         * event.
+         * The status of the item (`completed`, `incomplete`, `in_progress`). These have no effect
+         * on the conversation, but are accepted for consistency with the
+         * `conversation.item.created` event.
          */
         fun status(status: Status) = status(JsonField.of(status))
 
@@ -772,8 +773,9 @@ private constructor(
     }
 
     /**
-     * The status of the item (`completed`, `incomplete`). These have no effect on the conversation,
-     * but are accepted for consistency with the `conversation.item.created` event.
+     * The status of the item (`completed`, `incomplete`, `in_progress`). These have no effect on
+     * the conversation, but are accepted for consistency with the `conversation.item.created`
+     * event.
      */
     class Status @JsonCreator private constructor(private val value: JsonField<String>) : Enum {
 
@@ -793,13 +795,16 @@ private constructor(
 
             @JvmField val INCOMPLETE = of("incomplete")
 
+            @JvmField val IN_PROGRESS = of("in_progress")
+
             @JvmStatic fun of(value: String) = Status(JsonField.of(value))
         }
 
         /** An enum containing [Status]'s known values. */
         enum class Known {
             COMPLETED,
             INCOMPLETE,
+            IN_PROGRESS,
         }
 
         /**
@@ -814,6 +819,7 @@ private constructor(
         enum class Value {
             COMPLETED,
             INCOMPLETE,
+            IN_PROGRESS,
             /** An enum member indicating that [Status] was instantiated with an unknown value. */
             _UNKNOWN,
         }
@@ -829,6 +835,7 @@ private constructor(
             when (this) {
                 COMPLETED -> Value.COMPLETED
                 INCOMPLETE -> Value.INCOMPLETE
+                IN_PROGRESS -> Value.IN_PROGRESS
                 else -> Value._UNKNOWN
             }
 
@@ -845,6 +852,7 @@ private constructor(
             when (this) {
                 COMPLETED -> Known.COMPLETED
                 INCOMPLETE -> Known.INCOMPLETE
+                IN_PROGRESS -> Known.IN_PROGRESS
                 else -> throw OpenAIInvalidDataException("Unknown Status: $value")
             }