[openai-sdks]

Automated Release PR

4.87.0 (2026-10-20)

Features

• api: add 30-minute cache-write usage counts (#1233) (2f3608a)
• api: add compaction trigger IDs (#1243) (623d448)
• api: add complete JSON property access (#1241) (98eacfb)
• core: add HTTP adapter headers and body accessors (#1245) (04f464e)

Bug Fixes

• api: accept canonical file batch discriminator (#1224) (f886d7a)
• api: accept compaction trigger payload fields (#1226) (caa95e1)
• api: close responses from void-returning calls (#1242) (fc5b772)
• complete WebSocket receives before closing failed transport (#1240) (973fd4e)

Chores

• restore generated budget-checker explanation (#1235) (479972a)

Documentation

• checkpoint generated-code transition after initial merges (#1238) (b79d85f)
• inventory Java custom patches and plan generated-code transition (#1234) (1499ace)

---

This PR was generated with Release Please. See documentation.

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	✅ Completed 2026-10-20T15:59:22.089120Z	82d5574	New commits
🔒 Security Review	✅ Completed 2026-10-20T16:00:12.480137Z	82d5574	New commits

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[github-actions]

Castiron custom code

Evaluated main: 04f464e58affd7066af228f72f276b2152c3d982.

Trusted main policy: 04f464e58affd7066af228f72f276b2152c3d982.

✅ No new custom-code files detected.

97 mixed files remain; 0 existing customizations changed.

Compared 04f464e58aff → 82d5574193da. Generated baselines verified.

97 existing customizations unchanged

• openai-java-core/src/main/kotlin/com/openai/client/OpenAIClientAsyncImpl.kt
• openai-java-core/src/main/kotlin/com/openai/client/OpenAIClientImpl.kt
• openai-java-core/src/main/kotlin/com/openai/models/admin/organization/projects/apikeys/ApiKeyUpdateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/audio/AudioResponseFormat.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/environments/EnvironmentCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuth.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuthCreateParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/agents/vaults/credentials/CredentialAuthRotateParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponse.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseError.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseInjectFailedEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseStreamEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponseToolSearchOutputItemParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/beta/responses/BetaResponsesServerEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionMessageFunctionToolCall.kt
• openai-java-core/src/main/kotlin/com/openai/models/chat/completions/ChatCompletionToolMessageParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/conversations/ConversationCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/conversations/items/ItemCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/embeddings/Embedding.kt
• openai-java-core/src/main/kotlin/com/openai/models/embeddings/EmbeddingCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/live/ResponseItemCreateEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/realtime/RealtimeResponseStatus.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/Response.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseError.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionToolCall.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseFunctionWebSearch.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseInputItem.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseStreamEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseTextConfig.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseToolSearchOutputItemParam.kt
• openai-java-core/src/main/kotlin/com/openai/models/responses/ResponsesServerEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/vectorstores/filebatches/VectorStoreFileBatch.kt
• openai-java-core/src/main/kotlin/com/openai/models/videos/Video.kt
• openai-java-core/src/main/kotlin/com/openai/models/videos/VideoCreateError.kt
• openai-java-core/src/main/kotlin/com/openai/models/webhooks/UnwrapWebhookEvent.kt
• openai-java-core/src/main/kotlin/com/openai/models/webhooks/WebhookEndpointWithSecret.kt
• openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt

57 more in the full report.

A changed generated baseline means this report cannot reliably identify which handwritten lines changed.

Inspect the custom-code diff

Download the exact patch produced by this run (requires repository access):

gh run download 39453404512 --repo openai/openai-java \
  --name castiron-custom-code-39453404512-1 --dir /tmp/castiron-custom-code-39453404512-1
git apply --stat /tmp/castiron-custom-code-39453404512-1/custom-code.patch
cat /tmp/castiron-custom-code-39453404512-1/custom-code.patch

Or reproduce it from an SDK checkout containing the vendored reporter:

git fetch --no-tags origin 04f464e58affd7066af228f72f276b2152c3d982 82d5574193daebcf59310345e2706f2420fac00c
python3 scripts/castiron/custom_code_report.py report \
  --base 04f464e58affd7066af228f72f276b2152c3d982 \
  --head 82d5574193daebcf59310345e2706f2420fac00c --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-82d5574193da
cat /tmp/castiron-custom-code-82d5574193da/custom-code.patch

This is the current full custom patch for mixed files, not an attribution of only the handwritten lines changed by this PR.

Full report and patch

[openai-sdks]

OkTest Summary

✅ 236/236 SDK tests passed in 14.677s for Java SDK PR #1225.

Test results — 42 files

Test	Result	Time
tests/chat-completions-complex-body.test.ts	✅ Passed	184ms
tests/chat-completions-create.test.ts	✅ Passed	465ms
tests/chat-completions-stream.test.ts	✅ Passed	474ms
tests/files-content-binary.test.ts	✅ Passed	249ms
tests/files-create-multipart.test.ts	✅ Passed	375ms
tests/files-list-pagination.test.ts	✅ Passed	266ms
tests/initialize-config.test.ts	✅ Passed	202ms
tests/instance-isolation.test.ts	✅ Passed	168ms
tests/models-list.test.ts	✅ Passed	302ms
tests/responses-background-lifecycle.test.ts	✅ Passed	238ms
tests/responses-body-method-errors.test.ts	✅ Passed	605ms
tests/responses-cancel-timeout.test.ts	✅ Passed	255ms
tests/responses-cancel.test.ts	✅ Passed	233ms
tests/responses-compact-retries.test.ts	✅ Passed	316ms
tests/responses-compact.test.ts	✅ Passed	240ms
tests/responses-create-advanced-stream.test.ts	✅ Passed	762ms
tests/responses-create-advanced.test.ts	✅ Passed	1.535s
tests/responses-create-disconnect.test.ts	✅ Passed	1.187s
tests/responses-create-errors.test.ts	✅ Passed	382ms
tests/responses-create-malformed-api-responses.test.ts	✅ Passed	233ms
tests/responses-create-retries.test.ts	✅ Passed	240ms
tests/responses-create-stream-failures.test.ts	✅ Passed	1.579s
tests/responses-create-stream-timeout.test.ts	✅ Passed	210ms
tests/responses-create-stream-wire.test.ts	✅ Passed	4.538s
tests/responses-create-stream.test.ts	✅ Passed	294ms
tests/responses-create-terminal-states.test.ts	✅ Passed	362ms
tests/responses-create-timeout.test.ts	✅ Passed	274ms
tests/responses-create.test.ts	✅ Passed	335ms
tests/responses-delete.test.ts	✅ Passed	249ms
tests/responses-input-items-errors.test.ts	✅ Passed	353ms
tests/responses-input-items-list.test.ts	✅ Passed	272ms
tests/responses-input-items-options.test.ts	✅ Passed	350ms
tests/responses-input-tokens-count-timeout.test.ts	✅ Passed	316ms
tests/responses-input-tokens-count.test.ts	✅ Passed	236ms
tests/responses-malformed-inputs.test.ts	✅ Passed	3.445s
tests/responses-not-found-errors.test.ts	✅ Passed	369ms
tests/responses-parse.test.ts	✅ Passed	564ms
tests/responses-retrieve-retries.test.ts	✅ Passed	351ms
tests/responses-retrieve.test.ts	✅ Passed	247ms
tests/responses-stored-method-errors.test.ts	✅ Passed	982ms
tests/retry-behavior.test.ts	✅ Passed	3.623s
tests/sdk-error-shape.test.ts	✅ Passed	480ms

View OkTest run #39453260616

_{SDK merge (6f2ff4eab5d4) · head (82d5574193da) · base (04f464e58aff) · OkTest (6c2b4334784c)}

[openai-sdks]

🤖 Created releases:

• v4.87.0

🌻