Missing `name` field in Realtime function-call event in OpenAPI spec breaks generated SDK models
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 45/100
- issue の種類
- バグ
- 明瞭さ
- おおむね明確
- 活発さ
- 停滞
- 技術スタック
- java, openapi
- 領域
- api, documentation
調査の方向性
リンク先の Realtime API リファレンスをコンテキストとして使用し、まず response.function_call_arguments.done Realtime イベントの OpenAPI スキーマとドキュメントを確認してください。イベントに name が文字列として含まれていることを確認し、その後、影響を受ける Java SDK モデルを再生成して、生成されたモデルがサーバーの payload を表していることを検証してください。
索引モデルが issue の本文から書いたものです。
説明
Summary
The Realtime API returns a name field in the response.function_call_arguments.done event payload, but this field is not documented and not present in the OpenAPI spec. Because the Java SDK is generated from the spec, the resulting model does not include the field, causing incomplete deserialization and forcing manual workarounds.
This is a Bug + Spec fix + Enhancement issue.
Impacted Endpoint / Event
response.function_call_arguments.done (Realtime API)
Docs reference:https://platform.openai.com/docs/api-reference/realtime-server-events/response/function_call_arguments/done
Current Docs & Spec Behavior
Docs example (no name field):
{
"event_id": "event_5556",
"type": "response.function_call_arguments.done",
"response_id": "resp_002",
"item_id": "fc_001",
"output_index": 0,
"call_id": "call_001",
"arguments": "{\"location\": \"San Francisco\"}"
}
Actual Server Behavior
Actual Realtime events include a name field, for example:
{
"type": "response.function_call_arguments.done",
"name": "getWeather",
...
}
Expectation
The OpenAPI spec and documentation should include the name field so that SDK models (including Java) correctly represent function-calling data.
Impact / Severity
Severity: B — Major (workaround possible but painful)
Consequences:
Generated models are incomplete
Function name context is lost
Cannot rely on strongly-typed SDK
Cannot round-trip Realtime function-calling data via SDK
Workaround
Currently working around this by parsing raw JSON event payloads.
Root Cause
Spec / docs mismatch → incorrect OpenAPI → incorrect SDK generation.
Proposed Fix
Add
name: stringto theresponse.function_call_arguments.*events in the OpenAPI specification and documentationRegenerate affected SDKs (Java + others)
Environment
Component | Value -- | -- SDK | openai-java v4.16.1 Java | 21 OS | Windows 11Type of Issue
Bug
Spec / Documentation
Enhancement (generated SDK)
Why Combined
Fixing the spec resolves the SDK issue automatically without needing separate work.
Closing Note
This issue makes Realtime function-calling harder to use via strongly-typed models. Aligning the spec/docs with server behavior would resolve the bug and improve developer ergonomics across generator-based SDKs.
Thanks! 🙏
- 主要言語
- Kotlin
- スター
- 1.5k
- フォーク
- 266
- 平均マージ
- 8時間 18分
- マージ済み PR（30日）
- 142
環境構築
このプロジェクトの開発コンテナを、あなたの GitHub アカウントでブラウザ上に起動します。
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートなし
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
openai/openai-java のほかの issue
-
HttpRequest.url() logs spaces in path segments as literal plus signs対応中かも @sylvesterkaczmarek が 52 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
openai/openai-java#886 · コメント 2 件 ·
メンテナーはふだん 1 日以内に返信
-
Make diarized transcription duration and task optional対応中かも @wskr00 が 83 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
openai/openai-java#802 · コメント 2 件 · リアクション 3 件 ·
メンテナーはふだん 1 日以内に返信
-
AsyncStreamResponse can hang when the subscriber executor rejects work対応中かも @sylvesterkaczmarek が 35 日前に担当しました。 オープン
難易度 3/5 1〜2日 初心者へのやさしさ 74/100
openai/openai-java#973 ·
メンテナーはふだん 1 日以内に返信
-
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
openai/openai-java#956 ·
メンテナーはふだん 1 日以内に返信
-
Async internal plumbing bypasses both `dispatcherExecutorService` and `streamHandlerExecutor`, forcing a hop through `ForkJoinPool.commonPool()`対応中かも @sylvesterkaczmarek が 29 日前に担当しました。 オープン
難易度 5/5 1週間以上 初心者へのやさしさ 35/100
openai/openai-java#952 ·
メンテナーはふだん 1 日以内に返信
openai/openai-java の issue をすべて見る
似ている issue
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 66/100
partiql/partiql-lang-kotlin#1972 ·
-
afk-ok area:data-quality importer size:S
難易度 2/5 1〜3時間 初心者へのやさしさ 82/100
enorm-labs/event-junkie#3027 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
-
難易度 2/5 1〜3時間 初心者へのやさしさ 62/100
メンテナーはふだん 1 日以内に返信
-
bug
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
libre-tube/LibreTube#8854 ·
メンテナーはふだん 1 日以内に返信