Skip to content

release: 3.2.0 #595

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
wants to merge 9 commits into from
Closed

release: 3.2.0 #595

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
94cdfcd
chore(client): refactor closing / shutdown
stainless-app[bot] Aug 20, 2025
6242da5
chore(internal): support running formatters directly
stainless-app[bot] Aug 20, 2025
9d088c5
feat(api): adding support for /v1/conversations to the API
stainless-app[bot] Aug 21, 2025
fdc5fdd
chore: remove memory upper bound from publishing step
stainless-app[bot] Aug 21, 2025
ee175a9
feat(api): Add connectors support for MCP tool
stainless-app[bot] Aug 21, 2025
557e9ee
chore: add missing delegate methods
TomerAberbach Aug 22, 2025
9e91952
chore(ci): reduce log noise
stainless-app[bot] Aug 22, 2025
7cbc830
fix: update singularization rules
stainless-app[bot] Aug 22, 2025
d748005
release: 3.2.0
stainless-app[bot] Aug 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .github/workflows/create-releases.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -73,7 +73,7 @@ jobs:
export -- GPG_SIGNING_KEY_ID
printenv -- GPG_SIGNING_KEY | gpg --batch --passphrase-fd 3 --import 3<<< "$GPG_SIGNING_PASSWORD"
GPG_SIGNING_KEY_ID="$(gpg --with-colons --list-keys | awk -F : -- '/^pub:/ { getline; print "0x" substr($10, length($10) - 7) }')"
./gradlew publishAndReleaseToMavenCentral -Dorg.gradle.jvmargs="-Xmx8g" --stacktrace -PmavenCentralUsername="$SONATYPE_USERNAME" -PmavenCentralPassword="$SONATYPE_PASSWORD" --no-configuration-cache
./gradlew publishAndReleaseToMavenCentral --stacktrace -PmavenCentralUsername="$SONATYPE_USERNAME" -PmavenCentralPassword="$SONATYPE_PASSWORD" --no-configuration-cache
env:
SONATYPE_USERNAME: ${{ secrets.OPENAI_SONATYPE_USERNAME || secrets.SONATYPE_USERNAME }}
SONATYPE_PASSWORD: ${{ secrets.OPENAI_SONATYPE_PASSWORD || secrets.SONATYPE_PASSWORD }}
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/publish-sonatype.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -60,7 +60,7 @@ jobs:
export -- GPG_SIGNING_KEY_ID
printenv -- GPG_SIGNING_KEY | gpg --batch --passphrase-fd 3 --import 3<<< "$GPG_SIGNING_PASSWORD"
GPG_SIGNING_KEY_ID="$(gpg --with-colons --list-keys | awk -F : -- '/^pub:/ { getline; print "0x" substr($10, length($10) - 7) }')"
./gradlew publishAndReleaseToMavenCentral -Dorg.gradle.jvmargs="-Xmx8g" --stacktrace -PmavenCentralUsername="$SONATYPE_USERNAME" -PmavenCentralPassword="$SONATYPE_PASSWORD" --no-configuration-cache
./gradlew publishAndReleaseToMavenCentral --stacktrace -PmavenCentralUsername="$SONATYPE_USERNAME" -PmavenCentralPassword="$SONATYPE_PASSWORD" --no-configuration-cache
env:
SONATYPE_USERNAME: ${{ secrets.OPENAI_SONATYPE_USERNAME || secrets.SONATYPE_USERNAME }}
SONATYPE_PASSWORD: ${{ secrets.OPENAI_SONATYPE_PASSWORD || secrets.SONATYPE_PASSWORD }}
Expand Down
2 changes: 1 addition & 1 deletion .release-please-manifest.json
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
{
".": "3.1.2"
".": "3.2.0"
}
8 changes: 4 additions & 4 deletions .stats.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
configured_endpoints: 111
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-7ef7a457c3bf05364e66e48c9ca34f31bfef1f6c9b7c15b1812346105e0abb16.yml
openapi_spec_hash: a2b1f5d8fbb62175c93b0ebea9f10063
config_hash: 4870312b04f48fd717ea4151053e7fb9
configured_endpoints: 119
openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/openai%2Fopenai-ddbdf9343316047e8a773c54fb24e4a8d225955e202a1888fde6f9c8898ebf98.yml
openapi_spec_hash: 9802f6dd381558466c897f6e387e06ca
config_hash: fe0ea26680ac2075a6cd66416aefe7db
23 changes: 23 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,28 @@
# Changelog

## 3.2.0 (2025-08-22)

Full Changelog: [v3.1.2...v3.2.0](https://github.com/openai/openai-java/compare/v3.1.2...v3.2.0)

### Features

* **api:** Add connectors support for MCP tool ([ee175a9](https://github.com/openai/openai-java/commit/ee175a98a1ed4f1e939c301dd5bf62f10e367c6c))
* **api:** adding support for /v1/conversations to the API ([9d088c5](https://github.com/openai/openai-java/commit/9d088c5d77c450a2e1371a8293e9c05ebf102937))


### Bug Fixes

* update singularization rules ([7cbc830](https://github.com/openai/openai-java/commit/7cbc8305e4da79560969ba365f6f33427688bc50))


### Chores

* add missing delegate methods ([557e9ee](https://github.com/openai/openai-java/commit/557e9ee897e11c95788300922e8094383eb1dd97))
* **ci:** reduce log noise ([9e91952](https://github.com/openai/openai-java/commit/9e9195269a225cdbaba81e2dd6ee26caba407d00))
* **client:** refactor closing / shutdown ([94cdfcd](https://github.com/openai/openai-java/commit/94cdfcdf57225ee606acf51ffe3e0b6a4321f7e6))
* **internal:** support running formatters directly ([6242da5](https://github.com/openai/openai-java/commit/6242da594134e736470c006bc1af6b38ce757705))
* remove memory upper bound from publishing step ([fdc5fdd](https://github.com/openai/openai-java/commit/fdc5fdd3969d2ecc3d6df1546b34167b63074991))

## 3.1.2 (2025-08-20)

Full Changelog: [v3.1.1...v3.1.2](https://github.com/openai/openai-java/compare/v3.1.1...v3.1.2)
Expand Down
14 changes: 7 additions & 7 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,16 @@

<!-- x-release-please-start-version -->

[![Maven Central](https://img.shields.io/maven-central/v/com.openai/openai-java)](https://central.sonatype.com/artifact/com.openai/openai-java/3.1.2)
[![javadoc](https://javadoc.io/badge2/com.openai/openai-java/3.1.2/javadoc.svg)](https://javadoc.io/doc/com.openai/openai-java/3.1.2)
[![Maven Central](https://img.shields.io/maven-central/v/com.openai/openai-java)](https://central.sonatype.com/artifact/com.openai/openai-java/3.2.0)
[![javadoc](https://javadoc.io/badge2/com.openai/openai-java/3.2.0/javadoc.svg)](https://javadoc.io/doc/com.openai/openai-java/3.2.0)

<!-- x-release-please-end -->

The OpenAI Java SDK provides convenient access to the [OpenAI REST API](https://platform.openai.com/docs) from applications written in Java.

<!-- x-release-please-start-version -->

The REST API documentation can be found on [platform.openai.com](https://platform.openai.com/docs). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.openai/openai-java/3.1.2).
The REST API documentation can be found on [platform.openai.com](https://platform.openai.com/docs). Javadocs are available on [javadoc.io](https://javadoc.io/doc/com.openai/openai-java/3.2.0).

<!-- x-release-please-end -->

Expand All @@ -24,7 +24,7 @@ The REST API documentation can be found on [platform.openai.com](https://platfor
### Gradle

```kotlin
implementation("com.openai:openai-java:3.1.2")
implementation("com.openai:openai-java:3.2.0")
```

### Maven
Expand All @@ -33,7 +33,7 @@ implementation("com.openai:openai-java:3.1.2")
<dependency>
<groupId>com.openai</groupId>
<artifactId>openai-java</artifactId>
<version>3.1.2</version>
<version>3.2.0</version>
</dependency>
```

Expand Down Expand Up @@ -1330,7 +1330,7 @@ If you're using Spring Boot, then you can use the SDK's [Spring Boot starter](ht
#### Gradle

```kotlin
implementation("com.openai:openai-java-spring-boot-starter:3.1.2")
implementation("com.openai:openai-java-spring-boot-starter:3.2.0")
```

#### Maven
Expand All @@ -1339,7 +1339,7 @@ implementation("com.openai:openai-java-spring-boot-starter:3.1.2")
<dependency>
<groupId>com.openai</groupId>
<artifactId>openai-java-spring-boot-starter</artifactId>
<version>3.1.2</version>
<version>3.2.0</version>
</dependency>
```

Expand Down
2 changes: 1 addition & 1 deletion build.gradle.kts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ repositories {

allprojects {
group = "com.openai"
version = "3.1.2" // x-release-please-version
version = "3.2.0" // x-release-please-version
}

subprojects {
Expand Down
64 changes: 33 additions & 31 deletions openai-java-client-okhttp/src/main/kotlin/com/openai/client/okhttp/OpenAIOkHttpClient.kt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,8 @@ class OpenAIOkHttpClient private constructor() {
* The executor to use for running [AsyncStreamResponse.Handler] callbacks.
*
* Defaults to a dedicated cached thread pool.
*
* This class takes ownership of the executor and shuts it down, if possible, when closed.
*/
fun streamHandlerExecutor(streamHandlerExecutor: Executor) = apply {
clientOptions.streamHandlerExecutor(streamHandlerExecutor)
Expand Down Expand Up @@ -234,33 +236,33 @@ class OpenAIOkHttpClient private constructor() {

fun putHeader(name: String, value: String) = apply { clientOptions.putHeader(name, value) }

fun putHeaders(name: String, values: Iterable<String>) = apply {
clientOptions.putHeaders(name, values)
fun putheaders(name: String, values: Iterable<String>) = apply {
clientOptions.putheaders(name, values)
}

fun putAllHeaders(headers: Headers) = apply { clientOptions.putAllHeaders(headers) }
fun putAllheaders(headers: Headers) = apply { clientOptions.putAllheaders(headers) }

fun putAllHeaders(headers: Map<String, Iterable<String>>) = apply {
clientOptions.putAllHeaders(headers)
fun putAllheaders(headers: Map<String, Iterable<String>>) = apply {
clientOptions.putAllheaders(headers)
}

fun replaceHeaders(name: String, value: String) = apply {
clientOptions.replaceHeaders(name, value)
fun replaceheaders(name: String, value: String) = apply {
clientOptions.replaceheaders(name, value)
}

fun replaceHeaders(name: String, values: Iterable<String>) = apply {
clientOptions.replaceHeaders(name, values)
fun replaceheaders(name: String, values: Iterable<String>) = apply {
clientOptions.replaceheaders(name, values)
}

fun replaceAllHeaders(headers: Headers) = apply { clientOptions.replaceAllHeaders(headers) }
fun replaceAllheaders(headers: Headers) = apply { clientOptions.replaceAllheaders(headers) }

fun replaceAllHeaders(headers: Map<String, Iterable<String>>) = apply {
clientOptions.replaceAllHeaders(headers)
fun replaceAllheaders(headers: Map<String, Iterable<String>>) = apply {
clientOptions.replaceAllheaders(headers)
}

fun removeHeaders(name: String) = apply { clientOptions.removeHeaders(name) }
fun removeheaders(name: String) = apply { clientOptions.removeheaders(name) }

fun removeAllHeaders(names: Set<String>) = apply { clientOptions.removeAllHeaders(names) }
fun removeAllheaders(names: Set<String>) = apply { clientOptions.removeAllheaders(names) }

fun queryParams(queryParams: QueryParams) = apply { clientOptions.queryParams(queryParams) }

Expand All @@ -272,38 +274,38 @@ class OpenAIOkHttpClient private constructor() {
clientOptions.putQueryParam(key, value)
}

fun putQueryParams(key: String, values: Iterable<String>) = apply {
clientOptions.putQueryParams(key, values)
fun putquery_params(key: String, values: Iterable<String>) = apply {
clientOptions.putquery_params(key, values)
}

fun putAllQueryParams(queryParams: QueryParams) = apply {
clientOptions.putAllQueryParams(queryParams)
fun putAllquery_params(queryParams: QueryParams) = apply {
clientOptions.putAllquery_params(queryParams)
}

fun putAllQueryParams(queryParams: Map<String, Iterable<String>>) = apply {
clientOptions.putAllQueryParams(queryParams)
fun putAllquery_params(queryParams: Map<String, Iterable<String>>) = apply {
clientOptions.putAllquery_params(queryParams)
}

fun replaceQueryParams(key: String, value: String) = apply {
clientOptions.replaceQueryParams(key, value)
fun replacequery_params(key: String, value: String) = apply {
clientOptions.replacequery_params(key, value)
}

fun replaceQueryParams(key: String, values: Iterable<String>) = apply {
clientOptions.replaceQueryParams(key, values)
fun replacequery_params(key: String, values: Iterable<String>) = apply {
clientOptions.replacequery_params(key, values)
}

fun replaceAllQueryParams(queryParams: QueryParams) = apply {
clientOptions.replaceAllQueryParams(queryParams)
fun replaceAllquery_params(queryParams: QueryParams) = apply {
clientOptions.replaceAllquery_params(queryParams)
}

fun replaceAllQueryParams(queryParams: Map<String, Iterable<String>>) = apply {
clientOptions.replaceAllQueryParams(queryParams)
fun replaceAllquery_params(queryParams: Map<String, Iterable<String>>) = apply {
clientOptions.replaceAllquery_params(queryParams)
}

fun removeQueryParams(key: String) = apply { clientOptions.removeQueryParams(key) }
fun removequery_params(key: String) = apply { clientOptions.removequery_params(key) }

fun removeAllQueryParams(keys: Set<String>) = apply {
clientOptions.removeAllQueryParams(keys)
fun removeAllquery_params(keys: Set<String>) = apply {
clientOptions.removeAllquery_params(keys)
}

/**
Expand Down
64 changes: 33 additions & 31 deletions ...ai-java-client-okhttp/src/main/kotlin/com/openai/client/okhttp/OpenAIOkHttpClientAsync.kt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,8 @@ class OpenAIOkHttpClientAsync private constructor() {
* The executor to use for running [AsyncStreamResponse.Handler] callbacks.
*
* Defaults to a dedicated cached thread pool.
*
* This class takes ownership of the executor and shuts it down, if possible, when closed.
*/
fun streamHandlerExecutor(streamHandlerExecutor: Executor) = apply {
clientOptions.streamHandlerExecutor(streamHandlerExecutor)
Expand Down Expand Up @@ -234,33 +236,33 @@ class OpenAIOkHttpClientAsync private constructor() {

fun putHeader(name: String, value: String) = apply { clientOptions.putHeader(name, value) }

fun putHeaders(name: String, values: Iterable<String>) = apply {
clientOptions.putHeaders(name, values)
fun putheaders(name: String, values: Iterable<String>) = apply {
clientOptions.putheaders(name, values)
}

fun putAllHeaders(headers: Headers) = apply { clientOptions.putAllHeaders(headers) }
fun putAllheaders(headers: Headers) = apply { clientOptions.putAllheaders(headers) }

fun putAllHeaders(headers: Map<String, Iterable<String>>) = apply {
clientOptions.putAllHeaders(headers)
fun putAllheaders(headers: Map<String, Iterable<String>>) = apply {
clientOptions.putAllheaders(headers)
}

fun replaceHeaders(name: String, value: String) = apply {
clientOptions.replaceHeaders(name, value)
fun replaceheaders(name: String, value: String) = apply {
clientOptions.replaceheaders(name, value)
}

fun replaceHeaders(name: String, values: Iterable<String>) = apply {
clientOptions.replaceHeaders(name, values)
fun replaceheaders(name: String, values: Iterable<String>) = apply {
clientOptions.replaceheaders(name, values)
}

fun replaceAllHeaders(headers: Headers) = apply { clientOptions.replaceAllHeaders(headers) }
fun replaceAllheaders(headers: Headers) = apply { clientOptions.replaceAllheaders(headers) }

fun replaceAllHeaders(headers: Map<String, Iterable<String>>) = apply {
clientOptions.replaceAllHeaders(headers)
fun replaceAllheaders(headers: Map<String, Iterable<String>>) = apply {
clientOptions.replaceAllheaders(headers)
}

fun removeHeaders(name: String) = apply { clientOptions.removeHeaders(name) }
fun removeheaders(name: String) = apply { clientOptions.removeheaders(name) }

fun removeAllHeaders(names: Set<String>) = apply { clientOptions.removeAllHeaders(names) }
fun removeAllheaders(names: Set<String>) = apply { clientOptions.removeAllheaders(names) }

fun queryParams(queryParams: QueryParams) = apply { clientOptions.queryParams(queryParams) }

Expand All @@ -272,38 +274,38 @@ class OpenAIOkHttpClientAsync private constructor() {
clientOptions.putQueryParam(key, value)
}

fun putQueryParams(key: String, values: Iterable<String>) = apply {
clientOptions.putQueryParams(key, values)
fun putquery_params(key: String, values: Iterable<String>) = apply {
clientOptions.putquery_params(key, values)
}

fun putAllQueryParams(queryParams: QueryParams) = apply {
clientOptions.putAllQueryParams(queryParams)
fun putAllquery_params(queryParams: QueryParams) = apply {
clientOptions.putAllquery_params(queryParams)
}

fun putAllQueryParams(queryParams: Map<String, Iterable<String>>) = apply {
clientOptions.putAllQueryParams(queryParams)
fun putAllquery_params(queryParams: Map<String, Iterable<String>>) = apply {
clientOptions.putAllquery_params(queryParams)
}

fun replaceQueryParams(key: String, value: String) = apply {
clientOptions.replaceQueryParams(key, value)
fun replacequery_params(key: String, value: String) = apply {
clientOptions.replacequery_params(key, value)
}

fun replaceQueryParams(key: String, values: Iterable<String>) = apply {
clientOptions.replaceQueryParams(key, values)
fun replacequery_params(key: String, values: Iterable<String>) = apply {
clientOptions.replacequery_params(key, values)
}

fun replaceAllQueryParams(queryParams: QueryParams) = apply {
clientOptions.replaceAllQueryParams(queryParams)
fun replaceAllquery_params(queryParams: QueryParams) = apply {
clientOptions.replaceAllquery_params(queryParams)
}

fun replaceAllQueryParams(queryParams: Map<String, Iterable<String>>) = apply {
clientOptions.replaceAllQueryParams(queryParams)
fun replaceAllquery_params(queryParams: Map<String, Iterable<String>>) = apply {
clientOptions.replaceAllquery_params(queryParams)
}

fun removeQueryParams(key: String) = apply { clientOptions.removeQueryParams(key) }
fun removequery_params(key: String) = apply { clientOptions.removequery_params(key) }

fun removeAllQueryParams(keys: Set<String>) = apply {
clientOptions.removeAllQueryParams(keys)
fun removeAllquery_params(keys: Set<String>) = apply {
clientOptions.removeAllquery_params(keys)
}

/**
Expand Down
5 changes: 5 additions & 0 deletions openai-java-core/src/main/kotlin/com/openai/client/OpenAIClient.kt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ 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.ConversationService
import com.openai.services.blocking.EmbeddingService
import com.openai.services.blocking.EvalService
import com.openai.services.blocking.FileService
Expand Down Expand Up @@ -91,6 +92,8 @@ interface OpenAIClient {

fun responses(): ResponseService

fun conversations(): ConversationService

fun evals(): EvalService

fun containers(): ContainerService
Expand Down Expand Up @@ -150,6 +153,8 @@ interface OpenAIClient {

fun responses(): ResponseService.WithRawResponse

fun conversations(): ConversationService.WithRawResponse

fun evals(): EvalService.WithRawResponse

fun containers(): ContainerService.WithRawResponse
Expand Down
Loading
Loading