Skip to content

feat(api): allow omitted function-call argument event names - #966

Closed
markstuart-oai wants to merge 1 commit into
mainfrom
castiron/promotions/pr-62
Closed

feat(api): allow omitted function-call argument event names#966
markstuart-oai wants to merge 1 commit into
mainfrom
castiron/promotions/pr-62

Conversation

@markstuart-oai

Copy link
Copy Markdown
Contributor

Summary

Function-call argument completion events accept an omitted name; the name accessor returns Optional.

Changes

  • Make name optional on stable and beta function-call argument completion events and their builders.
  • Recompile callers of name() and handle Optional; its return type changes source and binary compatibility.
  • Read the corresponding function-call item's name when a required function name is needed.

Castiron-Internal-PR: openai/openai-java-internal#62
Castiron-Source-SHA: cb386b222ff7aa86293f5e9ac678c20e3851044f
Castiron-Public-Base-SHA: d3191b0
@github-actions

github-actions Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Castiron custom code

✅ No new custom-code files detected.

53 mixed files remain; 0 existing customizations changed; 2 generated baselines changed.

Compared d3191b0db2f4877b691cafd6. Generated baselines verified.

File Result Current custom patch
openai-java-core/src/test/kotlin/com/openai/models/beta/responses/BetaResponsesServerEventTest.kt Generated baseline changed +101 / −0
openai-java-core/src/test/kotlin/com/openai/models/responses/ResponsesServerEventTest.kt Generated baseline changed +101 / −0
51 existing customizations unchanged
  • openai-java-core/src/main/kotlin/com/openai/models/audio/AudioResponseFormat.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/embeddings/Embedding.kt
  • openai-java-core/src/main/kotlin/com/openai/models/embeddings/EmbeddingCreateParams.kt
  • openai-java-core/src/main/kotlin/com/openai/models/responses/ResponseCreateParams.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/ResponseTextConfig.kt
  • openai-java-core/src/main/kotlin/com/openai/models/videos/Video.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsync.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/BetaServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/ResponseServiceAsync.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/ResponseServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/WebhookServiceAsync.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/WebhookServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/audio/TranscriptionServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/chat/ChatCompletionServiceAsync.kt
  • openai-java-core/src/main/kotlin/com/openai/services/async/finetuning/checkpoints/PermissionServiceAsyncImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaService.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/BetaServiceImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/ResponseService.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/ResponseServiceImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/WebhookService.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/WebhookServiceImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/audio/TranscriptionServiceImpl.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/chat/ChatCompletionService.kt
  • openai-java-core/src/main/kotlin/com/openai/services/blocking/finetuning/checkpoints/PermissionServiceImpl.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/CompletionServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/ImageServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/ResponseServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/WebhookServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/audio/TranscriptionServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/beta/ResponseServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/beta/ThreadServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/beta/threads/RunServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/async/chat/ChatCompletionServiceAsyncTest.kt
  • openai-java-core/src/test/kotlin/com/openai/services/blocking/CompletionServiceTest.kt

11 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 33717084147 --repo openai/openai-java \
  --name castiron-custom-code-33717084147-1 --dir /tmp/castiron-custom-code-33717084147-1
git apply --stat /tmp/castiron-custom-code-33717084147-1/custom-code.patch
cat /tmp/castiron-custom-code-33717084147-1/custom-code.patch

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

git fetch --no-tags origin d3191b0db2f456882fd2e2edc3dce126f85505e1 877b691cafd65ea80b06c352221ab1c5bf3e8caf
python3 scripts/castiron/custom_code_report.py report \
  --base d3191b0db2f456882fd2e2edc3dce126f85505e1 \
  --head 877b691cafd65ea80b06c352221ab1c5bf3e8caf --fetch --require-head-hash --public \
  --out /tmp/castiron-custom-code-877b691cafd6
cat /tmp/castiron-custom-code-877b691cafd6/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

@markstuart-oai
markstuart-oai marked this pull request as ready for review September 3, 2026 04:59
@markstuart-oai
markstuart-oai requested a review from a team as a code owner September 3, 2026 04:59
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 3, 2026

Copy link
Copy Markdown

Codex Review Summary

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

Review Status Commit Review trigger
📝 Code Review Completed 2026-09-03T05:02:17.675657Z 877b691 Draft marked ready
🔒 Security Review Completed 2026-09-03T05:02:57.451050Z 877b691 Draft marked ready
ℹ️ 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.

@openai-sdks

openai-sdks Bot commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

OkTest Summary

237/237 SDK tests passed in 15.748s for Java SDK PR #966.

Test results — 42 files
Test Result Time
tests/chat-completions-complex-body.test.ts ✅ Passed 443ms
tests/chat-completions-create.test.ts ✅ Passed 462ms
tests/chat-completions-stream.test.ts ✅ Passed 294ms
tests/files-content-binary.test.ts ✅ Passed 500ms
tests/files-create-multipart.test.ts ✅ Passed 274ms
tests/files-list-pagination.test.ts ✅ Passed 333ms
tests/initialize-config.test.ts ✅ Passed 294ms
tests/instance-isolation.test.ts ✅ Passed 139ms
tests/models-list.test.ts ✅ Passed 188ms
tests/responses-background-lifecycle.test.ts ✅ Passed 237ms
tests/responses-body-method-errors.test.ts ✅ Passed 421ms
tests/responses-cancel-timeout.test.ts ✅ Passed 190ms
tests/responses-cancel.test.ts ✅ Passed 271ms
tests/responses-compact-retries.test.ts ✅ Passed 394ms
tests/responses-compact.test.ts ✅ Passed 333ms
tests/responses-create-advanced-stream.test.ts ✅ Passed 543ms
tests/responses-create-advanced.test.ts ✅ Passed 1.018s
tests/responses-create-disconnect.test.ts ✅ Passed 1.021s
tests/responses-create-errors.test.ts ✅ Passed 322ms
tests/responses-create-malformed-api-responses.test.ts ✅ Passed 145ms
tests/responses-create-retries.test.ts ✅ Passed 312ms
tests/responses-create-stream-failures.test.ts ✅ Passed 156ms
tests/responses-create-stream-timeout.test.ts ✅ Passed 193ms
tests/responses-create-stream-wire.test.ts ✅ Passed 6.119s
tests/responses-create-stream.test.ts ✅ Passed 86ms
tests/responses-create-terminal-states.test.ts ✅ Passed 275ms
tests/responses-create-timeout.test.ts ✅ Passed 193ms
tests/responses-create.test.ts ✅ Passed 250ms
tests/responses-delete.test.ts ✅ Passed 154ms
tests/responses-input-items-errors.test.ts ✅ Passed 237ms
tests/responses-input-items-list.test.ts ✅ Passed 458ms
tests/responses-input-items-options.test.ts ✅ Passed 92ms
tests/responses-input-tokens-count-timeout.test.ts ✅ Passed 176ms
tests/responses-input-tokens-count.test.ts ✅ Passed 284ms
tests/responses-malformed-inputs.test.ts ✅ Passed 5.389s
tests/responses-not-found-errors.test.ts ✅ Passed 314ms
tests/responses-parse.test.ts ✅ Passed 711ms
tests/responses-retrieve-retries.test.ts ✅ Passed 952ms
tests/responses-retrieve.test.ts ✅ Passed 242ms
tests/responses-stored-method-errors.test.ts ✅ Passed 915ms
tests/retry-behavior.test.ts ✅ Passed 3.381s
tests/sdk-error-shape.test.ts ✅ Passed 397ms

View OkTest run #33717063170

SDK merge (c1b3415e0cac) · head (877b691cafd6) · base (d3191b0db2f4) · OkTest (2b1bdfd25e98)

@sylvesterkaczmarek sylvesterkaczmarek left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changing name() from String to Optional<String> is a JVM binary break: code compiled against the current SDK looks for name()Ljava/lang/String; and will get NoSuchMethodError after upgrading, even when name is present. Could we preserve the old accessor and add an optional one, or otherwise stage this as a breaking release?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants