feat(api): new streaming helpers for background responses

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 99
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-d51538ac955164de98b0c94a0a4718d96623fe39bf31a1d168be06c93c94e645.yml
-openapi_spec_hash: 33e00a48df8f94c94f46290c489f132b
-config_hash: c42d37618b8628ce7e1c76437db5dd8f
+configured_endpoints: 109
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-fc64d7c2c8f51f750813375356c3f3fdfc7fc1b1b34f19c20a5410279d445d37.yml
+openapi_spec_hash: 618285fc70199ee32b9ebe4bf72f7e4c
+config_hash: c497f6b750cc89c0bf2eefc0bc839c70

openai-java-core/src/main/kotlin/com/openai/client/OpenAIClient.kt

@@ -7,6 +7,7 @@ import com.openai.services.blocking.BatchService
 import com.openai.services.blocking.BetaService
 import com.openai.services.blocking.ChatService
 import com.openai.services.blocking.CompletionService
+import com.openai.services.blocking.ContainerService
 import com.openai.services.blocking.EmbeddingService
 import com.openai.services.blocking.EvalService
 import com.openai.services.blocking.FileService
@@ -80,6 +81,8 @@ interface OpenAIClient {
 
     fun evals(): EvalService
 
+    fun containers(): ContainerService
+
     /**
      * Closes this client, relinquishing any underlying resources.
      *
@@ -127,5 +130,7 @@ interface OpenAIClient {
         fun responses(): ResponseService.WithRawResponse
 
         fun evals(): EvalService.WithRawResponse
+
+        fun containers(): ContainerService.WithRawResponse
     }
 }

openai-java-core/src/main/kotlin/com/openai/client/OpenAIClientAsync.kt

@@ -7,6 +7,7 @@ import com.openai.services.async.BatchServiceAsync
 import com.openai.services.async.BetaServiceAsync
 import com.openai.services.async.ChatServiceAsync
 import com.openai.services.async.CompletionServiceAsync
+import com.openai.services.async.ContainerServiceAsync
 import com.openai.services.async.EmbeddingServiceAsync
 import com.openai.services.async.EvalServiceAsync
 import com.openai.services.async.FileServiceAsync
@@ -80,6 +81,8 @@ interface OpenAIClientAsync {
 
     fun evals(): EvalServiceAsync
 
+    fun containers(): ContainerServiceAsync
+
     /**
      * Closes this client, relinquishing any underlying resources.
      *
@@ -127,5 +130,7 @@ interface OpenAIClientAsync {
         fun responses(): ResponseServiceAsync.WithRawResponse
 
         fun evals(): EvalServiceAsync.WithRawResponse
+
+        fun containers(): ContainerServiceAsync.WithRawResponse
     }
 }

openai-java-core/src/main/kotlin/com/openai/client/OpenAIClientAsyncImpl.kt

@@ -14,6 +14,8 @@ import com.openai.services.async.ChatServiceAsync
 import com.openai.services.async.ChatServiceAsyncImpl
 import com.openai.services.async.CompletionServiceAsync
 import com.openai.services.async.CompletionServiceAsyncImpl
+import com.openai.services.async.ContainerServiceAsync
+import com.openai.services.async.ContainerServiceAsyncImpl
 import com.openai.services.async.EmbeddingServiceAsync
 import com.openai.services.async.EmbeddingServiceAsyncImpl
 import com.openai.services.async.EvalServiceAsync
@@ -110,6 +112,10 @@ class OpenAIClientAsyncImpl(private val clientOptions: ClientOptions) : OpenAICl
 
     private val evals: EvalServiceAsync by lazy { EvalServiceAsyncImpl(clientOptionsWithUserAgent) }
 
+    private val containers: ContainerServiceAsync by lazy {
+        ContainerServiceAsyncImpl(clientOptionsWithUserAgent)
+    }
+
     override fun sync(): OpenAIClient = sync
 
     override fun withRawResponse(): OpenAIClientAsync.WithRawResponse = withRawResponse
@@ -146,6 +152,8 @@ class OpenAIClientAsyncImpl(private val clientOptions: ClientOptions) : OpenAICl
 
     override fun evals(): EvalServiceAsync = evals
 
+    override fun containers(): ContainerServiceAsync = containers
+
     override fun close() = clientOptions.httpClient.close()
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -215,6 +223,10 @@ class OpenAIClientAsyncImpl(private val clientOptions: ClientOptions) : OpenAICl
             EvalServiceAsyncImpl.WithRawResponseImpl(clientOptions)
         }
 
+        private val containers: ContainerServiceAsync.WithRawResponse by lazy {
+            ContainerServiceAsyncImpl.WithRawResponseImpl(clientOptions)
+        }
+
         override fun completions(): CompletionServiceAsync.WithRawResponse = completions
 
         override fun chat(): ChatServiceAsync.WithRawResponse = chat
@@ -246,5 +258,7 @@ class OpenAIClientAsyncImpl(private val clientOptions: ClientOptions) : OpenAICl
         override fun responses(): ResponseServiceAsync.WithRawResponse = responses
 
         override fun evals(): EvalServiceAsync.WithRawResponse = evals
+
+        override fun containers(): ContainerServiceAsync.WithRawResponse = containers
     }
 }

openai-java-core/src/main/kotlin/com/openai/client/OpenAIClientImpl.kt

@@ -14,6 +14,8 @@ import com.openai.services.blocking.ChatService
 import com.openai.services.blocking.ChatServiceImpl
 import com.openai.services.blocking.CompletionService
 import com.openai.services.blocking.CompletionServiceImpl
+import com.openai.services.blocking.ContainerService
+import com.openai.services.blocking.ContainerServiceImpl
 import com.openai.services.blocking.EmbeddingService
 import com.openai.services.blocking.EmbeddingServiceImpl
 import com.openai.services.blocking.EvalService
@@ -98,6 +100,10 @@ class OpenAIClientImpl(private val clientOptions: ClientOptions) : OpenAIClient
 
     private val evals: EvalService by lazy { EvalServiceImpl(clientOptionsWithUserAgent) }
 
+    private val containers: ContainerService by lazy {
+        ContainerServiceImpl(clientOptionsWithUserAgent)
+    }
+
     override fun async(): OpenAIClientAsync = async
 
     override fun withRawResponse(): OpenAIClient.WithRawResponse = withRawResponse
@@ -134,6 +140,8 @@ class OpenAIClientImpl(private val clientOptions: ClientOptions) : OpenAIClient
 
     override fun evals(): EvalService = evals
 
+    override fun containers(): ContainerService = containers
+
     override fun close() = clientOptions.httpClient.close()
 
     class WithRawResponseImpl internal constructor(private val clientOptions: ClientOptions) :
@@ -203,6 +211,10 @@ class OpenAIClientImpl(private val clientOptions: ClientOptions) : OpenAIClient
             EvalServiceImpl.WithRawResponseImpl(clientOptions)
         }
 
+        private val containers: ContainerService.WithRawResponse by lazy {
+            ContainerServiceImpl.WithRawResponseImpl(clientOptions)
+        }
+
         override fun completions(): CompletionService.WithRawResponse = completions
 
         override fun chat(): ChatService.WithRawResponse = chat
@@ -234,5 +246,7 @@ class OpenAIClientImpl(private val clientOptions: ClientOptions) : OpenAIClient
         override fun responses(): ResponseService.WithRawResponse = responses
 
         override fun evals(): EvalService.WithRawResponse = evals
+
+        override fun containers(): ContainerService.WithRawResponse = containers
     }
 }

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

@@ -399,8 +399,8 @@ private constructor(
     fun topP(): Optional<Double> = body.topP()
 
     /**
-     * A unique identifier representing your end-user, which can help OpenAI to monitor and detect
-     * abuse.
+     * A stable identifier for your end-users. Used to boost cache hit rates by better bucketing
+     * similar requests and to help OpenAI detect and prevent abuse.
      * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
      *
      * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -1590,8 +1590,8 @@ private constructor(
         fun topP(topP: JsonField<Double>) = apply { body.topP(topP) }
 
         /**
-         * A unique identifier representing your end-user, which can help OpenAI to monitor and
-         * detect abuse.
+         * A stable identifier for your end-users. Used to boost cache hit rates by better bucketing
+         * similar requests and to help OpenAI detect and prevent abuse.
          * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
          */
         fun user(user: String) = apply { body.user(user) }
@@ -2260,8 +2260,8 @@ private constructor(
         fun topP(): Optional<Double> = topP.getOptional("top_p")
 
         /**
-         * A unique identifier representing your end-user, which can help OpenAI to monitor and
-         * detect abuse.
+         * A stable identifier for your end-users. Used to boost cache hit rates by better bucketing
+         * similar requests and to help OpenAI detect and prevent abuse.
          * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
          *
          * @throws OpenAIInvalidDataException if the JSON field has an unexpected type (e.g. if the
@@ -3587,8 +3587,8 @@ private constructor(
             fun topP(topP: JsonField<Double>) = apply { this.topP = topP }
 
             /**
-             * A unique identifier representing your end-user, which can help OpenAI to monitor and
-             * detect abuse.
+             * A stable identifier for your end-users. Used to boost cache hit rates by better
+             * bucketing similar requests and to help OpenAI detect and prevent abuse.
              * [Learn more](https://platform.openai.com/docs/guides/safety-best-practices#end-user-ids).
              */
             fun user(user: String) = user(JsonField.of(user))